From 36ef2a1e2cf1c2592c11158ab1a6901e968c7fe3 Mon Sep 17 00:00:00 2001
From: Michael Schiemer <kontakt@michaelschiemer.de>
Date: Sun, 9 Nov 2025 14:46:15 +0100
Subject: [PATCH] fix: Gitea Traefik routing and connection pool optimization

- Remove middleware reference from Gitea Traefik labels (caused routing issues)
- Optimize Gitea connection pool settings (MAX_IDLE_CONNS=30, authentication_timeout=180s)
- Add explicit service reference in Traefik labels
- Fix intermittent 504 timeouts by improving PostgreSQL connection handling

Fixes Gitea unreachability via git.michaelschiemer.de
---
 .gitattributes                                |   27 +
 .gitea/workflows/build-image.yml              |   22 +-
 .gitea/workflows/manual-deploy.yml            |   91 +-
 .gitea/workflows/monitor-performance.yml      |    2 +-
 .gitignore                                    |    9 +
 AGENTS.md                                     |   12 +-
 CLAUDE.md                                     |   14 +-
 CODEX.md                                      |    8 +
 Dockerfile.production                         |    4 +-
 Makefile                                      |    4 +
 composer.json                                 |    3 +-
 console.php                                   |    3 +
 deployment/README.md                          |   18 +
 deployment/ansible/README.md                  |    2 +-
 deployment/ansible/ansible.cfg                |    2 +
 deployment/ansible/callback_plugins/README.md |  282 ++++
 .../default_with_clean_msg.cpython-311.pyc    |  Bin 0 -> 10237 bytes
 .../default_with_clean_msg.py                 |  181 +++
 .../inventory/group_vars/production.yml       |    1 -
 .../inventory/group_vars/production/vault.yml |    1 +
 .../ansible/playbooks/BUILD-INITIAL-IMAGE.md  |   81 +
 deployment/ansible/playbooks/README.md        |  133 +-
 .../playbooks/TRAEFIK_RESTART_DIAGNOSIS.md    |  157 ++
 deployment/ansible/playbooks/backup.yml       |  268 ++++
 .../ansible/playbooks/build-initial-image.yml |  432 ++++++
 .../playbooks/check-after-grafana-access.yml  |   78 -
 .../playbooks/check-and-restart-gitea.yml     |  132 +-
 .../playbooks/check-container-logs.yml        |   14 +
 .../playbooks/check-container-status.yml      |   15 +
 .../playbooks/check-docker-compose-logs.yml   |   40 -
 .../playbooks/check-entrypoint-execution.yml  |   63 -
 .../ansible/playbooks/check-env-file.yml      |   83 ++
 .../ansible/playbooks/check-final-status.yml  |   18 +
 .../ansible/playbooks/check-git-logs.yml      |   68 -
 .../playbooks/check-gitea-bad-gateway.yml     |  192 ---
 .../playbooks/check-grafana-after-test.yml    |   68 -
 .../playbooks/check-latest-grafana-access.yml |   55 -
 .../playbooks/check-php-files-and-workers.yml |   78 -
 .../ansible/playbooks/check-phpfpm-config.yml |   80 -
 .../playbooks/check-production-status.yml     |  147 --
 .../playbooks/check-redis-connection.yml      |  193 ---
 .../playbooks/check-staging-500-error.yml     |   49 -
 .../ansible/playbooks/check-staging-logs.yml  |   66 -
 .../playbooks/check-staging-php-logs.yml      |   66 -
 .../check-staging-redis-connection.yml        |  255 ----
 .../check-staging-redis-env-file.yml          |  135 --
 .../playbooks/check-staging-status.yml        |   52 -
 .../playbooks/check-traefik-acme-logs.yml     |   15 +
 .../playbooks/check-traefik-gitea-config.yml  |   70 -
 .../playbooks/check-vpn-routing-status.yml    |   63 -
 .../playbooks/check-vpn-test-from-client.yml  |  116 --
 .../ansible/playbooks/check-worker-logs.yml   |   17 +
 .../playbooks/cleanup-all-containers.yml      |  216 +++
 .../ansible/playbooks/debug-grafana-403.yml   |  125 --
 .../playbooks/debug-staging-redis-secrets.yml |  250 ----
 .../playbooks/deploy-application-code.yml     |  173 +--
 .../ansible/playbooks/deploy-complete.yml     |   30 +
 .../playbooks/deploy-gitea-stack-config.yml   |   60 +
 .../playbooks/deploy-traefik-config.yml       |   78 +-
 .../ansible/playbooks/deploy-update.yml       |  240 ---
 .../ansible/playbooks/deploy/production.yml   |  239 ---
 .../ansible/playbooks/deploy/staging.yml      |  226 ---
 .../playbooks/diagnose-gitea-timeout-deep.yml |  499 +++++++
 .../playbooks/diagnose-gitea-timeout-live.yml |  343 +++++
 .../playbooks/diagnose-gitea-timeouts.yml     |  325 ++++
 .../playbooks/diagnose-staging-502.yml        |  108 --
 .../playbooks/diagnose-staging-logs.yml       |  125 --
 .../playbooks/diagnose-traefik-restarts.yml   |  477 ++++++
 .../playbooks/diagnose-vpn-routing.yml        |  172 ---
 .../disable-traefik-auto-restarts.yml         |  136 ++
 .../ensure-gitea-traefik-discovery.yml        |   90 ++
 .../ansible/playbooks/final-status-check.yml  |   79 +
 .../find-ansible-automation-source.yml        |  246 +++
 .../playbooks/find-traefik-restart-source.yml |  328 ++++
 .../playbooks/fix-container-issues.yml        |   17 +
 .../playbooks/fix-gitea-actions-config.yml    |   81 -
 .../playbooks/fix-gitea-actions-url.yml       |   49 -
 .../playbooks/fix-gitea-runner-config.yml     |  207 +--
 .../fix-gitea-traefik-dynamic-config.yml      |  143 --
 .../playbooks/fix-gitea-traefik-labels.yml    |  139 --
 .../playbooks/fix-grafana-vpn-access.yml      |   67 -
 .../playbooks/fix-grafana-vpn-routing.yml     |   80 -
 .../ansible/playbooks/fix-nginx-upstream.yml  |   79 -
 .../ansible/playbooks/fix-phpfpm-config.yml   |   36 -
 .../playbooks/fix-sites-available-default.yml |   57 -
 .../playbooks/fix-staging-502-quick.yml       |   52 -
 .../playbooks/fix-staging-502-verify.yml      |   88 --
 .../playbooks/fix-staging-complete.yml        |   71 -
 .../playbooks/fix-staging-compose-secrets.yml |  138 --
 .../ansible/playbooks/fix-staging-issues.yml  |   83 --
 .../fix-staging-secrets-permissions.yml       |   82 -
 .../fix-traefik-acme-permissions.yml          |  138 ++
 .../ansible/playbooks/fix-traefik-config.yml  |  142 --
 .../ansible/playbooks/fix-web-container.yml   |   18 +
 .../playbooks/initial-server-setup.yml        |  350 +++++
 .../install-composer-dependencies.yml         |  112 +-
 .../ansible/playbooks/install-docker.yml      |   92 ++
 .../playbooks/monitor-grafana-access-live.yml |   95 --
 .../playbooks/monitor-grafana-client-ip.yml   |   75 -
 .../playbooks/monitor-grafana-live-now.yml    |   80 -
 .../monitor-grafana-live-with-firewall.yml    |   86 --
 .../playbooks/monitor-live-grafana-access.yml |   70 -
 .../monitor-traefik-continuously.yml          |  141 ++
 .../playbooks/monitor-traefik-restarts.yml    |  150 ++
 .../playbooks/quick-staging-logs-check.yml    |   28 -
 .../recreate-containers-with-env.yml          |   17 +
 .../ansible/playbooks/recreate-traefik.yml    |   16 +
 .../playbooks/register-gitea-runner.yml       |  149 +-
 .../remove-framework-production-stack.yml     |  165 ---
 .../playbooks/remove-temporary-grafana-ip.yml |  119 --
 .../playbooks/restart-gitea-complete.yml      |   95 ++
 .../playbooks/restart-gitea-with-cache.yml    |   57 +
 .../ansible/playbooks/restart-traefik.yml     |  129 +-
 .../playbooks/setup-gitea-initial-config.yml  |   14 +
 .../playbooks/setup-gitea-repository.yml      |  262 +---
 .../playbooks/setup-infrastructure.yml        |  140 +-
 .../playbooks/setup-ssl-certificates.yml      |   93 +-
 .../ansible/playbooks/setup-staging.yml       |  113 ++
 .../ansible/playbooks/stabilize-traefik.yml   |  236 +++
 .../sync-and-recreate-containers.yml          |   17 +
 .../playbooks/sync-application-code.yml       |   17 +
 deployment/ansible/playbooks/sync-code.yml    |  102 --
 deployment/ansible/playbooks/sync-stacks.yml  |   24 +-
 .../ansible/playbooks/tasks/check-health.yml  |   62 -
 .../ansible/playbooks/tasks/diagnose-404.yml  |   73 -
 .../playbooks/tasks/fix-health-checks.yml     |   71 -
 .../ansible/playbooks/tasks/fix-nginx-404.yml |   71 -
 .../playbooks/test-fastcgi-directly.yml       |   46 -
 .../playbooks/test-gitea-after-fix.yml        |   73 +
 .../playbooks/test-grafana-vpn-access.yml     |   99 --
 .../playbooks/test-grafana-vpn-final.yml      |   78 -
 .../test-redis-connection-direct.yml          |  121 --
 .../test-staging-container-access.yml         |   79 -
 .../ansible/playbooks/update-gitea-config.yml |  144 +-
 .../ansible/playbooks/verify-env-loading.yml  |   58 +
 .../ansible/playbooks/verify-production.yml   |  136 ++
 .../ansible/playbooks/verify-staging.yml      |  136 ++
 .../playbooks/view-staging-logs-readable.yml  |   44 -
 .../roles/application/defaults/main.yml       |   78 +-
 .../roles/application/handlers/main.yml       |   10 +
 .../roles/application/tasks/composer.yml      |   87 ++
 .../roles/application/tasks/containers.yml    |   86 ++
 .../roles/application/tasks/deploy.yml        |  356 +++++
 .../roles/application/tasks/deploy_code.yml   |  236 +++
 .../tasks/{main.yml => deploy_stack.yml}      |    0
 .../roles/application/tasks/health_check.yml  |   80 +
 .../ansible/roles/application/tasks/logs.yml  |  155 ++
 .../ansible/roles/application/tasks/sync.yml  |  218 ++-
 .../ansible/roles/gitea/handlers/main.yml     |   17 +
 .../ansible/roles/gitea/tasks/config.yml      |  131 ++
 .../gitea/tasks/{main.yml => deploy.yml}      |    0
 .../ansible/roles/gitea/tasks/repository.yml  |  258 ++++
 .../ansible/roles/gitea/tasks/runner.yml      |  329 +++++
 .../ansible/roles/gitea/tasks/setup.yml       |  287 ++++
 .../postgresql-production/defaults/main.yml   |   21 +
 .../postgresql-production/tasks/main.yml      |   69 +
 .../templates/postgresql.env.j2               |   14 +
 .../postgresql-staging/defaults/main.yml      |   21 +
 .../roles/postgresql-staging/tasks/main.yml   |   69 +
 .../templates/postgresql.env.j2               |   14 +
 .../ansible/roles/postgresql/tasks/main.yml   |    6 +
 .../postgresql/templates/postgresql.env.j2    |   14 +
 .../ansible/roles/redis/defaults/main.yml     |    9 +
 deployment/ansible/roles/redis/tasks/main.yml |   49 +
 .../roles/redis/templates/redis.env.j2        |    8 +
 .../ansible/roles/registry/tasks/main.yml     |   38 +
 .../ansible/roles/traefik/handlers/main.yml   |    8 +
 .../ansible/roles/traefik/tasks/deploy.yml    |   82 +
 .../ansible/roles/traefik/tasks/logs.yml      |  135 ++
 .../ansible/roles/traefik/tasks/main.yml      |   23 -
 .../ansible/roles/traefik/tasks/restart.yml   |  113 ++
 .../scripts/add-registry-password-to-vault.sh |  119 ++
 deployment/ansible/scripts/init-secrets.sh    |   97 +-
 .../ansible/scripts/set-git-credentials.sh    |    6 +-
 .../ansible/secrets/production.vault.yml.old  |   46 +
 deployment/ansible/show-nginx-volumes.sh      |    4 +-
 .../ansible/templates/application.env.j2      |   10 +-
 deployment/ansible/templates/gitea-app.ini.j2 |   76 +-
 deployment/ansible/test-nginx-volumes.sh      |    4 +-
 .../docs/guides/ansible-vs-bash-scripts.md    |  161 ++
 .../docs/guides/backup-and-rollback-guide.md  |  362 +++++
 deployment/docs/guides/cicd-workflow-guide.md |  347 +++++
 .../docs/guides/code-change-workflow.md       |    6 +-
 .../docs/guides/code-deployment-workflow.md   |  339 +++++
 deployment/docs/guides/deployment-commands.md |  221 ++-
 deployment/docs/guides/health-checks.md       |   94 ++
 .../docs/guides/initial-deployment-guide.md   |  238 +++
 deployment/docs/guides/manual-server-test.md  |  247 ++++
 .../guides/migrate-to-separate-databases.md   |  286 ++++
 deployment/docs/guides/os-selection.md        |  144 ++
 .../docs/guides/pipeline-test-checklist.md    |  356 +++++
 deployment/docs/guides/pipeline-test-steps.md |  214 +++
 .../docs/guides/pipeline-testing-guide.md     |  298 ++++
 .../guides/production-database-connection.md  |  162 ++
 deployment/docs/guides/quick-start.md         |   35 +-
 deployment/docs/guides/security-hardening.md  |  143 ++
 deployment/docs/guides/server-rebuild-plan.md |  428 ++++++
 deployment/docs/guides/ssh-access.md          |  218 +++
 deployment/docs/guides/staging-test-plan.md   |  315 ++++
 deployment/docs/guides/test-execution-plan.md |  299 ++++
 .../docs/reference/application-stack.md       |   40 +-
 .../reference/docker-compose-production.md    |  493 ++++++
 deployment/docs/server-directory-structure.md |  220 +++
 deployment/docs/status/ci-cd-status.md        |   80 +-
 .../docs/status/gitea-cache-activation.md     |  124 ++
 .../docs/status/implementation-summary.md     |  141 ++
 .../docs/status/pipeline-test-status.md       |  114 ++
 .../status/staging-implementation-status.md   |  168 +++
 deployment/docs/tests/README.md               |   26 +
 deployment/gitea-runner/config.yaml           |    6 +-
 deployment/scripts/README.md                  |  128 ++
 deployment/scripts/production-quick-start.sh  |  319 ++++
 deployment/scripts/staging-quick-start.sh     |  376 +++++
 deployment/scripts/test-backup.sh             |   61 +
 .../scripts/test-pipeline-prerequisites.sh    |  230 +++
 .../stacks/application/docker-compose.yml     |  334 -----
 .../application/docker-compose.yml.backup     |  286 ----
 deployment/stacks/gitea/.env.example          |    3 +-
 deployment/stacks/gitea/README.md             |    7 +-
 deployment/stacks/gitea/app.ini               |   80 -
 deployment/stacks/gitea/docker-compose.yml    |   42 +-
 .../stacks/gitea/mysql/conf.d/gitea.cnf       |   33 -
 .../monitoring/docker-compose.local.yml       |   47 +
 .../stacks/postgresql-production/README.md    |  257 ++++
 .../conf.d/postgresql.conf                    |   70 +
 .../postgresql-production/docker-compose.yml  |   72 +
 .../scripts/backup-entrypoint.sh              |   23 +
 .../postgresql-production/scripts/backup.sh   |   55 +
 .../postgresql-production/scripts/restore.sh  |   55 +
 .../stacks/postgresql-staging/README.md       |  263 ++++
 .../postgresql-staging/conf.d/postgresql.conf |   70 +
 .../postgresql-staging/docker-compose.yml     |   72 +
 .../scripts/backup-entrypoint.sh              |   23 +
 .../postgresql-staging/scripts/backup.sh      |   55 +
 .../postgresql-staging/scripts/restore.sh     |   55 +
 .../{application => production}/.env.example  |    0
 .../{application => production}/README.md     |   11 +-
 .../nginx/conf.d/default.conf                 |    0
 deployment/stacks/redis/.env.example          |    8 +
 deployment/stacks/redis/README.md             |  291 ++++
 deployment/stacks/redis/docker-compose.yml    |   37 +
 deployment/stacks/redis/redis.conf            |   81 +
 deployment/stacks/registry/auth/htpasswd      |    2 +
 deployment/stacks/staging/README.md           |   17 +-
 deployment/stacks/traefik/README.md           |   27 +-
 .../stacks/traefik/docker-compose.local.yml   |   11 +-
 .../stacks/traefik/dynamic/gitea-router.yml   |   17 +
 ...service.yml => gitea-service.yml.disabled} |    0
 .../stacks/traefik/dynamic/gitea-ssh.yml      |    9 +-
 deployment/stacks/traefik/dynamic/gitea.yml   |   20 -
 .../stacks/traefik/dynamic/middlewares.yml    |    9 -
 .../wireguard-old/add-wireguard-client.yml    |  205 ---
 .../regenerate-wireguard-client.yml           |  206 ---
 deployment/wireguard-old/setup-wireguard.yml  |  287 ----
 .../test-wireguard-docker-container.yml       |  168 ---
 .../wireguard-old/wireguard-client.conf.j2    |   29 -
 .../wireguard-old/wireguard-server.conf.j2    |   22 -
 docker-compose.postgres-override.yml          |   19 +-
 ....yml => docker-compose.production-base.yml |  109 +-
 docker-compose.production.yml                 |   51 +-
 docker-compose.staging-postgres-override.yml  |   25 +-
 docker/entrypoint.sh                          |  137 +-
 docker/php/Dockerfile                         |    4 +-
 docker/worker/Dockerfile                      |    2 +-
 docs/ARCHITECTURE-DECISION.md                 | 1087 ++++++++++++++
 docs/DOCUMENTATION-ANALYSIS.md                |  731 +++++++++
 docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md      |  274 ++++
 docs/ERROR-RENDERER-REFACTORING-PLAN.md       |  199 +++
 docs/README.md                                |  102 ++
 docs/SRC-ARCHITECTURE-ANALYSIS.md             |  567 +++++++
 docs/claude/README.md                         |   76 +
 docs/claude/animationsystem.md                |  585 ++++++++
 docs/claude/error-handling.md                 |  249 ----
 docs/claude/js-modules-analysis.md            |  735 +++++++++
 docs/claude/livecomponent-lazy-loading.md     |  681 ---------
 docs/claude/posix-system.md                   | 1316 +++++++++++++++++
 docs/claude/sockets-module.md                 |  671 +++++++++
 docs/claude/typed-string-system.md            | 1141 ++++++++++++++
 docs/codex/guidelines.md                      |   26 +
 docs/dependency-scanning.md                   |    4 +-
 .../deployment/DEPLOYMENT_FIX.md              |    0
 ENV_SETUP.md => docs/deployment/ENV_SETUP.md  |    0
 .../status/.deployment-test-status.md         |  100 ++
 docs/design-token-system.md                   |  374 +++++
 .../database/migrations.md}                   |    0
 .../database/patterns.md}                     |    0
 docs/features/error-handling/advanced.md      |  754 ++++++++++
 docs/features/error-handling/guide.md         |  645 ++++++++
 .../events/system.md}                         |    0
 .../filesystem/patterns.md}                   |    0
 .../queue/scheduler.md}                       |    0
 .../queue/system.md}                          |    0
 .../routing/value-objects.md}                 |    0
 .../security/patterns.md}                     |    0
 .../security}/route-authorization.md          |    0
 docs/{claude => guides}/common-workflows.md   |    0
 .../configuration.md}                         |    0
 docs/{claude => guides}/troubleshooting.md    |    0
 docs/livecomponents/README.md                 |    1 +
 .../livecomponent-file-uploads.md             |    0
 .../livecomponent-formbuilder-usage.md        |    0
 .../livecomponent-lifecycle-hooks.md          |    0
 .../livecomponent-nested-components.md        |    0
 .../livecomponent-security.md                 |    0
 .../livecomponent-slot-system.md              |    0
 .../livecomponents-best-practices.md          |    0
 .../livecomponents-caching-system.md          |    0
 .../livecomponents-dom-badges.md              |    0
 .../livecomponents-implementation-plan.md     |    0
 .../livecomponents-lazy-loading.md            |    0
 .../livecomponents-monitoring-debugging.md    |    0
 .../livecomponents-observability.md           |    0
 ...ivecomponents-performance-optimizations.md |    0
 .../livecomponents-playground.md              |    0
 .../livecomponents-roadmap.md                 |    0
 .../livecomponents-system.md                  |  Bin
 .../livecomponents-test-harness.md            |    0
 docs/livecomponents/ui-integration-guide.md   |  717 +++++++++
 docs/modules/analytics.md                     |  340 +++++
 docs/modules/animation-system-migration.md    |  180 +++
 docs/modules/animation-system.md              |  270 ++++
 docs/modules/cache-manager.md                 |  382 +++++
 docs/modules/error-tracking.md                |  413 ++++++
 docs/modules/event-bus.md                     |  370 +++++
 docs/modules/router.md                        |  364 +++++
 docs/modules/security.md                      |  382 +++++
 docs/modules/state-manager.md                 |  397 +++++
 docs/modules/validation.md                    |  462 ++++++
 .../ADMIN_AUTH_SECURITY_ENHANCEMENT.md        |  140 ++
 .../planning/CLEANUP_PLAN.md                  |    0
 .../planning/LIVECOMPONENTS_TEST.md           |    0
 .../planning/SRC_STRUCTURE_IMPROVEMENTS.md    |    0
 docs/quality/code-quality-scanner.md          |  112 ++
 .../design-token-system-future-features.md    |  318 ++++
 todo.md => docs/todo/todo.md                  |    0
 .../gitea-actions-artifact-compatibility.md   |   33 +
 public/.vite/manifest.json                    |    4 +-
 public/assets/css/admin-B295JZoO.css          |    1 +
 public/assets/js/main-C52nFCDL.js             |    1 +
 public/assets/js/main-C52nFCDL.js.map         |    1 +
 .../admin/01-settings/_generated-tokens.css   |   19 +
 resources/css/admin/admin.css                 |    2 +-
 resources/js/main.js                          |    7 +-
 resources/js/modules/LiveComponentDevTools.js |  288 +++-
 resources/js/modules/analytics/Analytics.js   |  406 +++++
 .../js/modules/analytics/AnalyticsProvider.js |    8 +
 resources/js/modules/analytics/index.js       |   85 ++
 .../animation-system/AnimationSystem.js       |  302 ++++
 .../animation-system/ScrollAnimation.js       |  211 +++
 .../animation-system/TimelineAnimation.js     |  157 ++
 .../js/modules/animation-system/index.js      |   92 ++
 .../js/modules/api-manager/StorageManager.js  |  392 ++++-
 .../js/modules/cache-manager/CacheManager.js  |  399 +++++
 .../js/modules/cache-manager/CacheStrategy.js |   53 +
 resources/js/modules/cache-manager/index.js   |   96 ++
 resources/js/modules/csrf-auto-refresh.js     |  414 ------
 .../js/modules/error-tracking/ErrorTracker.js |  392 +++++
 resources/js/modules/error-tracking/index.js  |   76 +
 resources/js/modules/event-bus/EventBus.js    |  322 ++++
 resources/js/modules/event-bus/index.js       |   93 ++
 resources/js/modules/form-autosave.js         |  697 +--------
 .../js/modules/form-handling/FormHandler.js   |  400 +++++
 .../livecomponent/ActionLoadingManager.js     |  256 ++++
 .../js/modules/livecomponent/ErrorBoundary.js |  347 +++++
 .../livecomponent/LazyComponentLoader.js      |    4 +-
 .../livecomponent/LiveComponentUIHelper.js    |  347 +++++
 .../livecomponent/LoadingStateManager.js      |  307 ++++
 .../livecomponent/RequestDeduplicator.js      |  180 +++
 .../js/modules/livecomponent/SharedConfig.js  |  124 ++
 .../modules/livecomponent/StateSerializer.js  |  245 +++
 .../modules/livecomponent/TooltipManager.js   |  388 +++++
 resources/js/modules/livecomponent/index.js   |  167 ++-
 resources/js/modules/router/RouteGuard.js     |  113 ++
 .../js/modules/router/RouteMiddleware.js      |   78 +
 resources/js/modules/router/Router.js         |  378 +++++
 resources/js/modules/router/index.js          |   87 ++
 resources/js/modules/security/CsrfManager.js  |  221 +++
 .../js/modules/security/SecurityManager.js    |  254 ++++
 resources/js/modules/security/index.js        |   86 ++
 resources/js/modules/spa-router/SPARouter.js  |  137 +-
 .../js/modules/state-manager/StateManager.js  |  556 +++++++
 resources/js/modules/state-manager/index.js   |   75 +
 .../js/modules/validation/ValidationRule.js   |   46 +
 resources/js/modules/validation/Validator.js  |  467 ++++++
 resources/js/modules/validation/index.js      |   71 +
 .../livecomponent-action-request.schema.json  |   41 +
 .../livecomponent-action-response.schema.json |  105 ++
 .../schemas/livecomponent-error.schema.json   |   59 +
 resources/js/types/analytics.d.ts             |   76 +
 resources/js/types/animation-system.d.ts      |   67 +
 resources/js/types/cache-manager.d.ts         |   70 +
 resources/js/types/error-tracking.d.ts        |   70 +
 resources/js/types/event-bus.d.ts             |   51 +
 resources/js/types/livecomponent.d.ts         |  233 +++
 resources/js/types/router.d.ts                |  110 ++
 resources/js/types/security.d.ts              |   64 +
 resources/js/types/state-manager.d.ts         |   64 +
 resources/js/types/validation.d.ts            |   76 +
 resources/views/errors/404.view.php           |   51 +
 resources/views/errors/500.view.php           |   89 ++
 resources/views/errors/error.view.php         |   92 ++
 build.sh => scripts/build/build.sh            |    0
 scripts/{ => ci}/delete-all-workflow-runs.sh  |    0
 scripts/{ => ci}/extract-ci-token.yml         |    0
 scripts/{ => ci}/get-ci-token-from-vault.sh   |    0
 {public => scripts/debug}/chat.html           |    0
 .../debug/debug-component-registry.php        |    0
 scripts/debug/debug_mapper_config.php         |    2 +-
 {public => scripts/debug}/qr-test-all.html    |    0
 {public => scripts/debug}/qrcode-test.html    |    0
 {public => scripts/debug}/test-hot-reload.css |    0
 .../debug}/test-hot-reload.html               |    0
 {public => scripts/debug}/test-hot-reload.js  |    0
 {public => scripts/debug}/test.html           |    0
 scripts/{ => deployment}/health-check.sh      |    0
 .../migrate-env-to-base-override.sh           |    0
 scripts/{ => deployment}/prepare-secrets.sh   |    0
 scripts/{ => deployment}/setup-autossh.sh     |    0
 .../setup-gitea-secrets-interactive.sh        |    0
 .../setup-gitea-secrets-with-token.sh         |    0
 .../{ => deployment}/setup-gitea-secrets.sh   |    0
 .../setup-production-secrets.sh               |    0
 .../deployment/setup-production-ssl.sh        |    0
 .../setup-secrets-interactive.sh              |    0
 .../install/install-php85.sh                  |    0
 scripts/{ => maintenance}/backup.sh           |    0
 scripts/maintenance/bootstrap-discovery.php   |    2 +-
 .../fix-worker-permissions.sh                 |    0
 .../maintenance/fix_admin_layout.sh           |    0
 .../maintenance/generate-vapid-keys.php       |    0
 scripts/{ => maintenance}/seed-ml-models.php  |    0
 .../{ => maintenance}/seed-notifications.php  |    0
 .../ssl/generate_ssl_certificates.sh          |    0
 scripts/{ => ssl}/ssl-init.sh                 |    0
 scripts/{ => ssl}/ssl-test.sh                 |    0
 scripts/{ => test}/test-deployment-secrets.sh |    0
 .../{ => test}/test-registry-credentials.sh   |    0
 .../test/test-security.sh                     |    0
 test-simple.sh => scripts/test/test-simple.sh |    4 +-
 test-ssl.sh => scripts/test/test-ssl.sh       |    0
 .../test/test-upload-system.sh                |    0
 .../test/test-workflow.sh                     |    0
 .../Admin/Analytics/AnalyticsController.php   |    6 +-
 .../Admin/Content/ImageManagerController.php  |    6 +-
 .../Admin/Content/ImageSlotsController.php    |    9 +-
 src/Application/Admin/Dashboard.php           |    4 +-
 .../Database/DatabaseBrowserController.php    |   84 ++
 .../Admin/Database/TableBrowserController.php |   69 +
 .../Admin/DeploymentDashboardController.php   |    7 +-
 .../Development/DesignSystemController.php    |    5 +
 .../Admin/Development/RoutesController.php    |    6 +-
 .../Development/StyleguideController.php      |    7 +-
 .../Admin/Development/WafTestController.php   |    5 +
 src/Application/Admin/Images.php              |    6 +-
 .../Infrastructure/CacheMetricsController.php |    6 +-
 .../Admin/Infrastructure/DockerController.php |  169 +++
 .../Infrastructure/LogViewerController.php    |    7 +-
 .../Admin/Infrastructure/RedisController.php  |    6 +-
 .../Infrastructure/ServicesController.php     |    6 +-
 .../Admin/JobDashboardController.php          |    7 +-
 .../MLDashboardAdminController.php            |    6 +-
 src/Application/Admin/MigrationStatus.php     |    6 +-
 .../NotificationsAdminController.php          |    7 +-
 .../Admin/PreSaveCampaignAdminController.php  |    5 +
 .../Admin/PreSaveCampaignController.php       |    8 +-
 .../Registry/AdminNavigationRegistry.php      |  272 ++++
 .../Admin/Service/AdminNavigationService.php  |  165 +--
 .../Admin/Service/AdminPageDiscovery.php      |  356 +++++
 src/Application/Admin/ShowDiscovery.php       |    6 +-
 src/Application/Admin/ShowImageManager.php    |    4 +
 src/Application/Admin/ShowImageUpload.php     |    3 -
 src/Application/Admin/ShowUploadTest.php      |    6 +-
 .../Admin/System/EnvironmentController.php    |    6 +-
 .../Admin/System/HealthController.php         |    6 +-
 .../Admin/System/PerformanceController.php    |    7 +-
 .../Admin/System/PhpInfoController.php        |    6 +-
 .../System/SystemDashboardController.php      |    9 +-
 src/Application/Admin/UserAdminController.php |    4 +
 .../Admin/ValueObjects/AdminPageMetadata.php  |  137 ++
 .../ValueObjects/AdminSectionMetadata.php     |   75 +
 .../Admin/ValueObjects/AdminTokenRegistry.php |  477 +++---
 .../Admin/ValueObjects/NavigationItem.php     |   24 +-
 .../Admin/ValueObjects/NavigationSection.php  |    4 +-
 .../Admin/templates/admin-form.view.php       |    8 +-
 .../Admin/templates/admin-index.view.php      |   34 +-
 .../Admin/templates/admin.view.php            |   12 +-
 .../templates/analytics-dashboard.view.php    |   56 +-
 .../Admin/templates/cache-metrics.view.php    |   88 +-
 .../components/breadcrumbs.component.php      |   39 +-
 .../components/sidebar.component.php          |   18 +-
 .../Admin/templates/dashboard.view.php        |   30 +-
 .../Admin/templates/database/browser.view.php |   33 +
 .../templates/database/table-detail.view.php  |   49 +
 .../templates/deployment-dashboard.view.php   |  116 +-
 .../Admin/templates/docker-dashboard.view.php |   11 +
 .../Admin/templates/environment.view.php      |    2 +-
 .../Admin/templates/health-dashboard.view.php |   82 +-
 .../Admin/templates/image-manager.view.php    |   32 +-
 .../Admin/templates/imageslot.view.php        |    4 +-
 .../Admin/templates/imageslots.view.php       |   62 +-
 .../Admin/templates/log-viewer.view.php       |    2 +-
 .../Admin/templates/migrations.view.php       |   21 +-
 .../Admin/templates/ml-dashboard.view.php     |  120 +-
 .../Admin/templates/performance.view.php      |  198 +--
 .../Admin/templates/phpinfo.view.php          |   12 +-
 .../templates/presave/campaigns/edit.view.php |   26 +-
 .../presave/campaigns/index.view.php          |  112 +-
 .../templates/presave/campaigns/show.view.php |  154 +-
 .../Admin/templates/redis.view.php            |   14 +-
 .../Admin/templates/routes-overview.view.php  |   32 +-
 .../Admin/templates/services.view.php         |   18 +-
 .../Admin/templates/upload-form.view.php      |   24 +-
 .../Admin/templates/upload-test.view.php      |    4 +-
 .../Asset/Api/Requests/UploadAssetRequest.php |   24 +
 .../Asset/Api/V1/AssetsController.php         |  302 ++++
 .../Cms/Api/Requests/CreateContentRequest.php |   30 +
 .../Api/Requests/CreateContentTypeRequest.php |   30 +
 .../Cms/Api/Requests/UpdateContentRequest.php |   21 +
 .../Api/Requests/UpdateContentTypeRequest.php |   25 +
 .../Cms/Api/V1/ContentTypesController.php     |  193 +++
 .../Cms/Api/V1/ContentsController.php         |  260 ++++
 .../Commands/Design/GenerateTokensCommand.php |  189 +++
 .../Commands/Design/LintTokensCommand.php     |  112 ++
 .../Commands/Design/ValidateTokensCommand.php |  101 ++
 src/Application/Contact/ShowContact.php       |    3 +
 .../Dashboard/DockerContainersComponent.php   |  105 ++
 .../Dashboard/DockerContainersState.php       |  110 ++
 .../Dashboard/HealthStatusComponent.php       |  111 ++
 .../Dashboard/HealthStatusState.php           |  121 ++
 .../Dashboard/PerformanceMetricsComponent.php |  139 ++
 .../Dashboard/PerformanceMetricsState.php     |  140 ++
 .../Notification/NotificationComponent.php    |  121 ++
 .../Notification/NotificationState.php        |  147 ++
 src/Application/Website/ShowHome.php          |    1 -
 src/Application/Website/ShowImpressum.php     |    8 +-
 .../AiProviderUnavailableException.php        |    8 +-
 .../Asset/Commands/ProcessDerivatCommand.php  |   23 +
 .../Commands/ProcessDerivatCommandHandler.php |   74 +
 .../Asset/DI/AssetServiceInitializer.php      |  124 ++
 src/Domain/Asset/Entities/Asset.php           |  109 ++
 src/Domain/Asset/Entities/AssetTag.php        |   48 +
 src/Domain/Asset/Entities/AssetVariant.php    |   64 +
 .../Exceptions/AssetNotFoundException.php     |   21 +
 .../Asset/Migrations/CreateAssetTagsTable.php |   49 +
 .../Migrations/CreateAssetVariantsTable.php   |   55 +
 .../Asset/Migrations/CreateAssetsTable.php    |   56 +
 .../Pipeline/DerivatPipelineInterface.php     |   24 +
 .../Pipeline/DerivatPipelineRegistry.php      |   34 +
 .../Asset/Pipeline/ImageDerivatPipeline.php   |  124 ++
 src/Domain/Asset/README.md                    |  526 +++++++
 .../Asset/Repositories/AssetRepository.php    |   27 +
 .../Asset/Repositories/AssetTagRepository.php |   38 +
 .../Repositories/AssetVariantRepository.php   |   24 +
 .../Repositories/DatabaseAssetRepository.php  |  108 ++
 .../DatabaseAssetTagRepository.php            |   94 ++
 .../DatabaseAssetVariantRepository.php        |   93 ++
 src/Domain/Asset/Services/AssetService.php    |  241 +++
 .../Asset/Services/DeduplicationService.php   |   28 +
 .../Asset/Services/MetadataExtractor.php      |   83 ++
 .../Asset/Storage/AssetStorageInterface.php   |   23 +
 .../Asset/Storage/ObjectStorageAdapter.php    |   83 ++
 .../Storage/ObjectStorageAdapterFactory.php   |   33 +
 src/Domain/Asset/ValueObjects/AssetId.php     |   47 +
 .../Asset/ValueObjects/AssetMetadata.php      |  215 +++
 .../Asset/ValueObjects/ObjectKeyGenerator.php |   57 +
 src/Domain/Asset/ValueObjects/VariantName.php |   66 +
 src/Domain/Cms/DI/CmsServiceInitializer.php   |  139 ++
 src/Domain/Cms/Entities/Content.php           |  188 +++
 .../Cms/Entities/ContentTranslation.php       |   73 +
 src/Domain/Cms/Entities/ContentType.php       |   80 +
 src/Domain/Cms/Enums/ContentStatus.php        |   56 +
 ...CannotDeleteSystemContentTypeException.php |   21 +
 .../Exceptions/ContentNotFoundException.php   |   30 +
 .../ContentTypeNotFoundException.php          |   21 +
 .../DuplicateContentTypeSlugException.php     |   20 +
 .../Cms/Exceptions/DuplicateSlugException.php |   21 +
 .../Cms/Exceptions/InvalidBlockException.php  |   29 +
 .../InvalidContentStatusException.php         |   21 +
 .../CreateContentTranslationsTable.php        |   55 +
 .../Migrations/CreateContentTypesTable.php    |   54 +
 .../Cms/Migrations/CreateContentsTable.php    |   63 +
 src/Domain/Cms/README.md                      |  193 +++
 .../Cms/Rendering/BlockRendererInterface.php  |   26 +
 .../Cms/Rendering/BlockRendererRegistry.php   |   59 +
 .../Cms/Rendering/DefaultBlockRenderer.php    |   35 +
 .../Cms/Rendering/HeroBlockRenderer.php       |   35 +
 .../Cms/Rendering/ImageBlockRenderer.php      |   34 +
 .../Cms/Rendering/TextBlockRenderer.php       |   31 +
 .../Cms/Repositories/ContentRepository.php    |   29 +
 .../ContentTranslationRepository.php          |   21 +
 .../Repositories/ContentTypeRepository.php    |   24 +
 .../DatabaseContentRepository.php             |  156 ++
 .../DatabaseContentTranslationRepository.php  |   85 ++
 .../DatabaseContentTypeRepository.php         |  104 ++
 src/Domain/Cms/Services/BlockTypeRegistry.php |   97 ++
 src/Domain/Cms/Services/BlockValidator.php    |  143 ++
 .../Services/ContentLocalizationService.php   |  104 ++
 src/Domain/Cms/Services/ContentRenderer.php   |   85 ++
 src/Domain/Cms/Services/ContentService.php    |  202 +++
 .../Cms/Services/ContentTypeService.php       |  133 ++
 src/Domain/Cms/Services/SlugGenerator.php     |   57 +
 src/Domain/Cms/ValueObjects/BlockData.php     |  125 ++
 src/Domain/Cms/ValueObjects/BlockId.php       |   55 +
 src/Domain/Cms/ValueObjects/BlockSettings.php |  118 ++
 src/Domain/Cms/ValueObjects/BlockType.php     |  141 ++
 src/Domain/Cms/ValueObjects/ContentBlock.php  |   80 +
 src/Domain/Cms/ValueObjects/ContentBlocks.php |  112 ++
 src/Domain/Cms/ValueObjects/ContentId.php     |   47 +
 src/Domain/Cms/ValueObjects/ContentSlug.php   |   41 +
 src/Domain/Cms/ValueObjects/ContentTypeId.php |   41 +
 src/Domain/Cms/ValueObjects/Locale.php        |   69 +
 src/Framework/Admin/Attributes/AdminPage.php  |   45 +
 .../Admin/Attributes/AdminResource.php        |   14 +-
 .../Admin/Attributes/AdminSection.php         |   43 +
 src/Framework/Api/ApiException.php            |    3 +-
 src/Framework/ApiGateway/ApiGateway.php       |    6 +-
 src/Framework/Async/AsyncTimeoutException.php |    3 +-
 .../AsyncExamples/Http/HttpException.php      |    9 +-
 .../RouteAuthorizationServiceInitializer.php  |   25 +-
 src/Framework/Cache/CacheInitializer.php      |    4 +-
 src/Framework/Cache/Driver/FileCache.php      |   98 +-
 .../CircuitBreakerException.php               |   27 +-
 .../CommandBus/CommandHandlerMapper.php       |    4 +-
 .../RequiredEnvironmentVariableException.php  |    7 +-
 src/Framework/Console/Animation/Animation.php |   84 ++
 .../Console/Animation/AnimationBuilder.php    |  212 +++
 .../Console/Animation/AnimationFactory.php    |  132 ++
 .../Console/Animation/AnimationFrame.php      |   27 +
 .../Console/Animation/AnimationManager.php    |  124 ++
 .../Console/Animation/AnimationState.php      |   17 +
 .../Console/Animation/CompositeAnimation.php  |  233 +++
 .../Console/Animation/EasingFunction.php      |   78 +
 .../Console/Animation/KeyframeAnimation.php   |  174 +++
 .../Console/Animation/TextAnimation.php       |   31 +
 .../Animation/TuiAnimationRenderer.php        |  183 +++
 .../Console/Animation/Types/BaseAnimation.php |  207 +++
 .../Console/Animation/Types/FadeAnimation.php |   72 +
 .../Animation/Types/MarqueeAnimation.php      |  103 ++
 .../Animation/Types/PulseAnimation.php        |   77 +
 .../Animation/Types/SlideAnimation.php        |   87 ++
 .../Animation/Types/SpinnerAnimation.php      |  129 ++
 .../Animation/Types/TypewriterAnimation.php   |   88 ++
 .../Console/Ansi/AnsiSequenceGenerator.php    |  130 ++
 src/Framework/Console/Ansi/LinkFormatter.php  |  113 ++
 src/Framework/Console/Ansi/RgbColor.php       |  186 +++
 src/Framework/Console/Ansi/TruecolorStyle.php |   12 +-
 src/Framework/Console/CommandList.php         |   19 +-
 src/Framework/Console/CommandRegistry.php     |   64 +-
 .../Commands/CodeQualityScanCommand.php       |  170 +++
 .../Commands/DatabaseBrowserCommand.php       |  242 +++
 .../Console/Commands/HotReloadCommand.php     |   34 +-
 .../Console/Components/ConsoleDialog.php      |   10 +-
 .../Console/Components/ConsoleTUI.php         |  266 ++--
 .../Console/Components/EventBuffer.php        |   96 ++
 .../Components/EventLoop/EventLoop.php        |  110 ++
 .../Components/EventLoop/EventLoopConfig.php  |   25 +
 .../Handlers/KeyboardEventHandler.php         |  485 ++++++
 .../Components/Handlers/MouseEventHandler.php |  436 ++++++
 .../Console/Components/InputParser.php        |  208 +--
 .../Parsers/KeyboardEventParser.php           |  222 +++
 .../Components/Parsers/MouseEventParser.php   |  119 ++
 src/Framework/Console/Components/Table.php    |  211 +--
 src/Framework/Console/Components/TextBox.php  |  123 +-
 .../Console/Components/TreeHelper.php         |  223 +--
 .../Console/Components/TuiInputHandler.php    | 1308 +---------------
 .../Console/Components/TuiRenderer.php        |   16 +-
 .../Console/ConsoleCommandMapper.php          |    4 +-
 src/Framework/Console/ConsoleInput.php        |   92 +-
 src/Framework/Console/ConsoleOutput.php       |  195 ++-
 src/Framework/Console/ConsoleStyle.php        |   43 +
 .../ErrorRecovery/ConsoleErrorHandler.php     |   11 +
 .../Console/Examples/AnimationDemoCommand.php |  156 ++
 .../Exceptions/CommandExecutionException.php  |   14 +
 .../CommandMetadataNotFoundException.php      |   14 +
 .../ConsoleInitializationException.php        |   14 +
 .../Exceptions/DuplicateCommandException.php  |   14 +
 .../InvalidCommandConfigurationException.php  |   14 +
 src/Framework/Console/InteractivePrompter.php |  175 +++
 .../Adapters/DisplayComponentAdapter.php      |   76 +
 .../Console/Layout/Adapters/ThemeMapper.php   |   33 +
 .../Console/Layout/Components/Footer.php      |   56 +
 .../Console/Layout/Components/Header.php      |   93 ++
 .../Layout/Components/ProgressSection.php     |   75 +
 .../Console/Layout/Components/Sidebar.php     |   75 +
 .../Layout/Components/StatusIndicator.php     |  112 ++
 .../Console/Layout/DashboardLayout.php        |  152 ++
 .../Layout/Examples/LayoutExamples.php        |  134 ++
 .../Layout/Helpers/DisplayComponentHelper.php |   66 +
 .../Layout/Interactive/CollapsibleSection.php |   79 +
 .../Console/Layout/Interactive/Tabs.php       |  102 ++
 .../Console/Layout/LayoutContainer.php        |  211 +++
 .../Console/Layout/LayoutFactory.php          |   99 ++
 .../Console/Layout/LayoutInterface.php        |   22 +
 .../Console/Layout/LayoutRenderer.php         |  184 +++
 .../Console/Layout/Navigation/Breadcrumbs.php |   65 +
 .../Layout/Navigation/NavigationMenu.php      |   87 ++
 src/Framework/Console/Layout/PageLayout.php   |  159 ++
 src/Framework/Console/Layout/Panel.php        |   90 ++
 .../Console/Layout/ResponsiveOutput.php       |   40 +-
 src/Framework/Console/Layout/Section.php      |  231 +++
 .../Console/Layout/SectionLayout.php          |   73 +
 src/Framework/Console/Layout/SimpleLayout.php |   64 +
 .../Layout/ValueObjects/GridConfig.php        |   47 +
 .../Layout/ValueObjects/LayoutOptions.php     |   57 +
 .../Console/Layout/ValueObjects/PanelSize.php |   43 +
 .../Layout/ValueObjects/SectionStyle.php      |   19 +
 src/Framework/Console/Screen/Display.php      |   15 +-
 .../Console/Security/SecurityException.php    |   12 +-
 src/Framework/Console/Terminal/OscMode.php    |   17 +
 .../Console/Terminal/PhpStormDetector.php     |  111 ++
 .../Console/Terminal/TerminalCapabilities.php |  195 +++
 .../Console/Terminal/Utf8Support.php          |  243 +++
 .../Console/Terminal/WindowTitleManager.php   |  190 +++
 src/Framework/Console/TextWriter.php          |  215 +++
 src/Framework/Console/WorkflowExecutor.php    |    3 +-
 src/Framework/Core/AppBootstrapper.php        |   31 +-
 src/Framework/Core/AttributeMapper.php        |    4 +-
 .../Core/AttributeMappingVisitor.php          |    2 +-
 src/Framework/Core/ContainerBootstrapper.php  |    2 +-
 .../Core/Events/EventHandlerMapper.php        |    4 +-
 .../InvalidRouteCacheFormatException.php      |    3 -
 .../Core/Exceptions/RouteCacheException.php   |    3 -
 .../Core/InterfaceImplementationVisitor.php   |    2 +-
 src/Framework/Core/RouteMapper.php            |    4 +-
 .../Core/System/Ini/IniDirective.php          |    2 +
 src/Framework/Core/ValueObjects/ClassName.php |    4 +-
 .../Core/ValueObjects/LineNumber.php          |  103 ++
 .../Core/ValueObjects/ReturnType.php          |   90 ++
 .../Core/ValueObjects/ReturnTypeValue.php     |  181 +++
 .../Core/Warmup/ContainerWarmupStrategy.php   |    2 +-
 src/Framework/DI/ContainerCompiler.php        |    2 +-
 src/Framework/DI/ContainerIntrospector.php    |    2 +-
 src/Framework/DI/DefaultContainer.php         |   47 +-
 src/Framework/DI/DependencyResolver.php       |    4 +-
 .../DI/Exceptions/ClassNotInstantiable.php    |   24 +-
 .../ClassNotResolvableException.php           |   16 +-
 .../Exceptions/ClassResolutionException.php   |   34 +-
 .../DI/Exceptions/ContainerException.php      |   13 +-
 .../Exceptions/CyclicDependencyException.php  |   17 +-
 .../DefaultImplementationException.php        |   28 +-
 .../Exceptions/InitializerCycleException.php  |   20 +-
 .../DI/Exceptions/LazyLoadingException.php    |    2 -
 .../ParameterResolutionException.php          |   16 +-
 src/Framework/DI/InitializerCacheUpdater.php  |    2 +-
 .../DI/InitializerDependencyGraph.php         |   23 +-
 src/Framework/DI/InitializerMapper.php        |    6 +-
 src/Framework/DI/LazyInstantiator.php         |    2 +-
 src/Framework/DI/MethodInvoker.php            |   35 +-
 src/Framework/DI/ParameterResolver.php        |   23 +-
 .../DI/ProactiveInitializerFinder.php         |    2 +-
 src/Framework/DI/SingletonDetector.php        |    2 +-
 .../Browser/Discovery/DatabaseDiscovery.php   |   73 +
 .../Browser/Discovery/SchemaDiscovery.php     |  201 +++
 .../Browser/Discovery/TableDiscovery.php      |  107 ++
 .../Browser/Registry/DatabaseRegistry.php     |   39 +
 .../Browser/Registry/TableRegistry.php        |  100 ++
 .../Browser/ValueObjects/ColumnMetadata.php   |   70 +
 .../Browser/ValueObjects/DatabaseMetadata.php |   43 +
 .../ValueObjects/ForeignKeyMetadata.php       |   37 +
 .../Browser/ValueObjects/IndexMetadata.php    |   51 +
 .../Browser/ValueObjects/TableMetadata.php    |   91 ++
 .../Exception/ConnectionFailedException.php   |  123 +-
 .../ConstraintViolationException.php          |  134 +-
 .../Database/Exception/DatabaseException.php  |   60 +-
 .../Database/Exception/DeadlockException.php  |  115 +-
 .../Exception/EntityNotFoundException.php     |   31 +-
 .../Exception/PoolExhaustedException.php      |   94 +-
 .../Exception/QueryExecutionException.php     |  107 +-
 .../Exception/QuerySyntaxException.php        |  121 +-
 .../MemoryThresholdExceededException.php      |   43 +-
 .../Serialization/SerializationException.php  |   25 +-
 .../Exception/StoredFunctionException.php     |   28 +-
 .../Exception/StoredProcedureException.php    |   17 -
 .../Exceptions/InvalidDateTimeException.php   |    9 +-
 .../Exceptions/InvalidTimezoneException.php   |    6 +-
 .../SslCertificateHealthCheck.php             |   21 +-
 src/Framework/Design/Ast/CssAstBuilder.php    |  292 ++++
 src/Framework/Design/Ast/CssAstNode.php       |   20 +
 src/Framework/Design/Ast/CssComment.php       |   30 +
 .../Design/Ast/CssCustomProperty.php          |   27 +
 src/Framework/Design/Ast/CssLayer.php         |   35 +
 src/Framework/Design/Ast/CssMediaQuery.php    |   35 +
 src/Framework/Design/Ast/CssRule.php          |   35 +
 src/Framework/Design/Ast/CssStylesheet.php    |   30 +
 src/Framework/Design/Ast/CssSupports.php      |   35 +
 .../Design/Database/DesignTokenEntity.php     |  347 +++++
 src/Framework/Design/Linters/TokenLinter.php  |  165 +++
 .../Migrations/CreateDesignTokensTable.php    |   76 +
 .../Repositories/DatabaseTokenRepository.php  |  304 ++++
 .../Design/Services/ColorManipulator.php      |  321 ++++
 .../Design/Validators/TokenValidator.php      |  289 ++++
 .../Design/ValueObjects/ColorFormat.php       |    1 +
 .../Design/ValueObjects/ColorPalette.php      |   86 ++
 .../Design/ValueObjects/ColorVariation.php    |  149 ++
 .../Design/ValueObjects/ContrastResult.php    |   34 +
 .../Design/ValueObjects/CssColor.php          |  201 ++-
 .../ValueObjects/FrameworkTokenRegistry.php   |  228 +++
 .../ValueObjects/HybridTokenRegistry.php      |  101 ++
 .../Design/ValueObjects/LintIssue.php         |   36 +
 .../Design/ValueObjects/LintResult.php        |   64 +
 .../Design/ValueObjects/StateMutation.php     |  121 ++
 src/Framework/Design/ValueObjects/Theme.php   |   94 ++
 .../Design/ValueObjects/ThemeRegistry.php     |   98 ++
 .../Design/ValueObjects/TokenRegistry.php     |  203 +++
 .../Design/ValueObjects/TokenState.php        |   53 +
 .../ValueObjects/TokenStateRegistry.php       |  170 +++
 .../Design/ValueObjects/Tokens/ColorToken.php |   85 ++
 .../ValueObjects/Tokens/SpacingToken.php      |   55 +
 .../Tokens/StatefulColorToken.php             |  135 ++
 .../Tokens/StatefulTokenInterface.php         |   31 +
 .../ValueObjects/Tokens/TokenInterface.php    |   21 +
 .../ValueObjects/Tokens/TypographyToken.php   |   71 +
 .../Design/ValueObjects/ValidationError.php   |   39 +
 .../Design/ValueObjects/ValidationResult.php  |   62 +
 .../Design/ValueObjects/ValidationWarning.php |   30 +
 .../Discovery/Analysis/DependencyAnalyzer.php |    4 +-
 .../Discovery/Cache/RegistryCacheManager.php  |    6 +-
 .../DiscoveryServiceBootstrapper.php          |   34 +-
 .../Exceptions/DiscoveryException.php         |  212 +--
 .../RecoverableDiscoveryException.php         |   10 +-
 .../Factory/DiscoveryServiceFactory.php       |    4 +-
 .../Discovery/Health/DiscoveryHealthCheck.php |   18 +-
 .../Discovery/InitializerProcessor.php        |  175 ++-
 .../Interfaces/ClassDiscoveryVisitor.php      |    2 +-
 .../Plugins/DependencyAnalysisPlugin.php      |    2 +-
 .../Processing/FileStreamProcessor.php        |    9 +-
 .../Processing/ProcessingContext.php          |    4 +-
 .../Processing/VisitorCoordinator.php         |   91 +-
 .../Discovery/ReflectionAwareVisitor.php      |    2 +-
 .../Resilience/DiscoveryTimeoutHandler.php    |   61 +-
 .../Discovery/Results/AttributeRegistry.php   |    5 -
 .../Discovery/Results/InterfaceRegistry.php   |   14 -
 .../Storage/DiscoveryCacheManager.php         |   17 +
 .../Discovery/Testing/DiscoveryTestHelper.php |    2 +-
 .../Discovery/UnifiedDiscoveryService.php     |   20 +-
 .../ValueObjects/DiscoveredAttribute.php      |   39 +-
 .../ValueObjects/ReflectionContext.php        |    2 +-
 .../Discovery/Visitors/AttributeVisitor.php   |    6 +-
 .../Display/Components/ComponentFactory.php   |  387 +++++
 .../Display/Components/Console/Badge.php      |   69 +
 .../Display/Components/Console/Card.php       |  145 ++
 .../Display/Components/Console/CodeBlock.php  |  161 ++
 .../Display/Components/Console/Divider.php    |   61 +
 .../Display/Components/Console/ListItem.php   |   76 +
 .../Display/Components/Console/Stats.php      |   65 +
 .../Display/Components/Console/Table.php      |  240 +++
 .../Display/Components/Console/TextBox.php    |  133 ++
 .../Display/Components/Console/TreeHelper.php |  283 ++++
 .../Components/DisplayComponentInterface.php  |   24 +
 .../Display/Components/Html/HtmlBadge.php     |   67 +
 .../Display/Components/Html/HtmlCard.php      |   87 ++
 .../Display/Components/Html/HtmlCodeBlock.php |  163 ++
 .../Display/Components/Html/HtmlDivider.php   |   50 +
 .../Display/Components/Html/HtmlListItem.php  |   69 +
 .../Display/Components/Html/HtmlStats.php     |   70 +
 .../Display/Components/Html/HtmlTable.php     |  125 ++
 .../Display/Components/Html/HtmlTextBox.php   |   49 +
 .../Components/Html/HtmlTreeHelper.php        |  153 ++
 .../Display/Formatters/ArrayFormatter.php     |   49 +
 .../Display/Formatters/AutoFormatter.php      |  253 ++++
 .../Display/Formatters/ClassFormatter.php     |   49 +
 .../Display/Formatters/CodeFormatter.php      |   82 +
 .../Display/Formatters/CsvFormatter.php       |  233 +++
 .../Formatters/FilesystemFormatter.php        |   50 +
 .../Display/Formatters/JsonFormatter.php      |  204 +++
 .../Display/Formatters/ObjectFormatter.php    |   58 +
 .../Display/Formatters/XmlFormatter.php       |  205 +++
 .../Display/Formatters/YamlFormatter.php      |  193 +++
 .../Display/Inspectors/ArrayInspector.php     |  227 +++
 .../Display/Inspectors/ClassInspector.php     |  222 +++
 .../Inspectors/FilesystemInspector.php        |  105 ++
 .../Display/Inspectors/ObjectInspector.php    |  417 ++++++
 src/Framework/Display/README.md               |  583 ++++++++
 .../Display/Renderers/ConsoleRenderer.php     |  611 ++++++++
 .../Display/Renderers/HtmlRenderer.php        |  520 +++++++
 src/Framework/Display/Themes/ConsoleTheme.php |   81 +
 .../Display/Themes/DefaultConsoleThemes.php   |  140 ++
 .../Display/Themes/DefaultHtmlThemes.php      |   94 ++
 .../Display/Themes/DefaultThemes.php          |   57 +
 src/Framework/Display/Themes/HtmlTheme.php    |   82 +
 .../Display/Themes/ThemeRegistry.php          |   58 +
 .../ValueObjectFormatters/ByteFormatter.php   |   64 +
 .../ClassNameFormatter.php                    |   60 +
 .../ValueObjectFormatters/EmailFormatter.php  |   72 +
 .../FilePathFormatter.php                     |   98 ++
 .../TimestampFormatter.php                    |   93 ++
 .../ValueObjectFormatterInterface.php         |   29 +
 .../DefaultValueObjectFormatterRegistry.php   |   32 +
 .../ValueObjectFormatterRegistry.php          |   99 ++
 .../Display/ValueObjects/ArrayStructure.php   |  133 ++
 .../Display/ValueObjects/BracketStyle.php     |   40 +
 .../Display/ValueObjects/ClassStructure.php   |   58 +
 .../Display/ValueObjects/ColorDepth.php       |   16 +
 .../Display/ValueObjects/ConstantInfo.php     |   51 +
 .../ValueObjects/DirectoryStructure.php       |   44 +
 .../Display/ValueObjects/DisplayOptions.php   |  357 +++++
 .../Display/ValueObjects/DisplayRules.php     |  114 ++
 .../Display/ValueObjects/FileEntry.php        |   49 +
 .../Display/ValueObjects/IndentStyle.php      |   31 +
 .../Display/ValueObjects/MethodInfo.php       |   68 +
 .../Display/ValueObjects/ObjectStructure.php  |   42 +
 .../Display/ValueObjects/OutputFormat.php     |   25 +
 .../Display/ValueObjects/PropertyInfo.php     |   55 +
 .../Display/ValueObjects/RenderContext.php    |   36 +
 .../Display/ValueObjects/SeparatorStyle.php   |   33 +
 .../ErrorAggregation/NullErrorAggregator.php  |    4 +-
 .../BoundaryFailedException.php               |   14 +-
 .../BoundaryTimeoutException.php              |   14 +-
 .../ErrorHandling/CliErrorHandler.php         |  100 --
 .../ErrorHandling/DummyTemplateRenderer.php   |   27 -
 src/Framework/ErrorHandling/ErrorHandler.php  |  509 -------
 .../ErrorHandling/ErrorHandlerInitializer.php |   37 -
 .../ErrorHandling/ErrorHandlerManager.php     |  174 ---
 .../ErrorHandling/ErrorHandlerRegistry.php    |   86 --
 .../ErrorHandling/ErrorHandlingResult.php     |   58 -
 src/Framework/ErrorHandling/ErrorLogger.php   |  169 ---
 .../Handlers/DatabaseErrorHandler.php         |   57 -
 .../Handlers/ErrorHandlerInterface.php        |   31 -
 .../Handlers/ErrorHandlerPriority.php         |   43 -
 .../Handlers/FallbackErrorHandler.php         |   58 -
 .../Handlers/HandlerRegistration.php          |   52 -
 .../ErrorHandling/Handlers/HandlerResult.php  |   32 -
 .../Handlers/HttpErrorHandler.php             |   45 -
 .../Handlers/ValidationErrorHandler.php       |   46 -
 .../ErrorHandling/SecurityAlertManager.php    |   89 --
 .../ErrorHandling/SecurityEventHandler.php    |  200 ---
 .../ErrorHandling/SecurityEventLogger.php     |  134 --
 src/Framework/ErrorHandling/StackTrace.php    |  161 --
 .../ErrorHandling/Templates/debug.view.php    |  571 -------
 .../Templates/production-minimal.view.php     |  141 --
 .../Templates/production.view.php             |  118 --
 src/Framework/ErrorHandling/TraceItem.php     |  150 --
 .../ValueObjects/ErrorMetadata.php            |  177 ---
 .../ErrorHandling/View/ApiErrorRenderer.php   |  126 --
 .../View/ErrorResponseFactory.php             |  102 --
 .../View/ErrorTemplateRenderer.php            |  323 ----
 .../View/ErrorViewRendererInterface.php       |   18 -
 src/Framework/ErrorHandling/fallback.html     |  106 --
 src/Framework/EventBus/EventHandlerMapper.php |    4 +-
 .../Authentication/AccountLockedException.php |   27 +-
 .../InsufficientPrivilegesException.php       |   26 +-
 .../InvalidCredentialsException.php           |   22 +-
 .../SessionTimeoutException.php               |   24 +-
 .../Authentication/TokenExpiredException.php  |   24 +-
 src/Framework/Exception/ConsoleException.php  |   26 +-
 src/Framework/Exception/DatabaseException.php |  103 +-
 .../Exception/DirectoryCreateException.php    |   12 +-
 .../Exception/DirectoryListException.php      |   12 +-
 src/Framework/Exception/ExceptionContext.php  |    7 +
 src/Framework/Exception/ExceptionMetadata.php |    2 +
 .../Exception/FrameworkException.php          |  377 +----
 .../Http/InvalidContentTypeException.php      |   28 +-
 .../Exception/Http/MalformedJsonException.php |   28 +-
 .../Http/OversizedRequestException.php        |   27 +-
 .../Http/RateLimitExceededException.php       |   29 +-
 .../Exception/Http/RouteNotFoundException.php |   28 +-
 .../CsrfValidationFailedException.php         |   54 +-
 .../Security/HoneypotTriggeredException.php   |   35 +-
 .../PathTraversalAttemptException.php         |   26 +-
 .../Security/SqlInjectionAttemptException.php |   29 +-
 .../Security/XssAttemptException.php          |   29 +-
 src/Framework/Exception/SecurityException.php |   46 +-
 .../Aggregation/DiscoveryWarning.php          |   23 +
 .../DiscoveryWarningAggregator.php            |  104 ++
 .../Aggregation/DiscoveryWarningGroup.php     |   28 +
 .../Audit/ExceptionAuditLogger.php            |  309 ++++
 .../ExceptionHandling/BasicErrorHandler.php   |   35 +
 .../BasicGlobalExceptionHandler.php           |   34 +
 .../BasicShutdownHandler.php                  |   54 +
 .../Context/ExceptionContextBuilder.php       |  302 ++++
 .../Context/ExceptionContextCache.php         |  213 +++
 .../Context/ExceptionContextData.php          |  170 ++-
 .../Context/ExceptionContextProvider.php      |   16 +-
 .../Correlation/ExceptionCorrelation.php      |   40 +
 .../ExceptionCorrelationEngine.php            |  131 ++
 .../ExceptionHandling/ErrorContext.php        |   15 +-
 .../ExceptionHandling/ErrorHandler.php        |    5 +-
 .../ErrorHandlerInterface.php                 |    7 +-
 .../ExceptionHandling/ErrorKernel.php         |  193 ++-
 .../ExceptionHandling/ErrorRenderer.php       |   28 +-
 .../ErrorRendererFactory.php                  |   49 +-
 .../ExceptionHandling/ErrorSeverityType.php   |   88 ++
 .../ExceptionHandlerManager.php               |   42 +-
 .../ExceptionHandlerManagerFactory.php        |   65 +
 .../ExceptionHandlingInitializer.php          |  123 ++
 .../Factory/ExceptionFactory.php              |  113 +-
 .../ExceptionHandling/FatalErrorTypes.php     |   30 +
 .../GlobalExceptionHandler.php                |    8 +-
 .../Health/ExceptionHealthChecker.php         |  108 ++
 .../Localization/ExceptionLocalizer.php       |   84 ++
 .../Metrics/ExceptionMetrics.php              |   43 +
 .../Metrics/ExceptionMetricsCollector.php     |  178 +++
 .../Metrics/PrometheusExporter.php            |   69 +
 .../Middleware/ErrorScopeMiddleware.php       |  183 +++
 .../PatternDetection/ExceptionPattern.php     |   46 +
 .../ExceptionPatternDetector.php              |   69 +
 .../PatternDetection/FixSuggestion.php        |   43 +
 .../ExceptionPerformanceMetrics.php           |   54 +
 .../ExceptionPerformanceTracker.php           |  111 ++
 .../RateLimit/ExceptionFingerprint.php        |  146 ++
 .../RateLimit/ExceptionRateLimitConfig.php    |  109 ++
 .../RateLimit/ExceptionRateLimiter.php        |  182 +++
 .../Recovery/ExceptionRecoveryManager.php     |  105 ++
 .../Recovery/RetryStrategy.php                |   34 +
 .../Renderers/ConsoleErrorRenderer.php        |  143 ++
 .../Renderers/ResponseErrorRenderer.php       |  270 +++-
 .../Reporter/ReporterRegistry.php             |   49 +
 .../Serialization/ExceptionSerializer.php     |  335 +++++
 .../ExceptionHandling/ShutdownHandler.php     |   21 +-
 .../Strategy/ErrorPolicyResolver.php          |   11 +-
 .../Strategy/LenientPolicy.php                |    5 +-
 .../Strategy/StrictErrorPolicy.php            |    8 +-
 .../ExceptionMessageTranslator.php            |  100 ++
 .../Translation/UserFriendlyMessage.php       |   52 +
 .../ValueObjects/StackItem.php                |  441 ++++++
 .../ValueObjects/StackTrace.php               |  118 ++
 .../Exceptions/DirectoryCreateException.php   |   13 +-
 .../Exceptions/DirectoryListException.php     |   13 +-
 .../Exceptions/FileCopyException.php          |   16 +-
 .../Exceptions/FileDeleteException.php        |   13 +-
 .../Exceptions/FileMetadataException.php      |   15 +-
 .../Exceptions/FileNotFoundException.php      |   13 +-
 .../Exceptions/FilePermissionException.php    |   29 +-
 .../Exceptions/FileReadException.php          |   13 +-
 .../Exceptions/FileValidationException.php    |   60 +-
 .../Exceptions/FileWriteException.php         |   13 +-
 .../Exceptions/FilesystemException.php        |   50 +-
 .../SerializerNotFoundException.php           |   53 +-
 .../Health/Checks/CacheHealthCheck.php        |   24 +-
 .../Health/Checks/DatabaseHealthCheck.php     |   24 +-
 .../Health/Checks/DiskSpaceHealthCheck.php    |   28 +-
 .../Health/Checks/QueueHealthCheck.php        |   24 +-
 .../Health/Checks/SslHealthCheck.php          |   32 +-
 .../Health/Checks/SystemHealthCheck.php       |   28 +-
 .../Health/Checks/VaultHealthCheck.php        |   24 +-
 src/Framework/Health/HealthCheckInterface.php |   33 +-
 src/Framework/Health/HealthCheckManager.php   |   10 +-
 .../Exceptions/MiddlewareTimeoutException.php |   10 +-
 .../Http/MiddlewareDependencyException.php    |   14 +-
 .../Http/MiddlewareDependencyResolver.php     |   22 +-
 src/Framework/Http/MiddlewareManager.php      |   16 +-
 .../ExceptionHandlingMiddleware.php           |   33 +-
 .../Exception/ParserSecurityException.php     |   48 +-
 src/Framework/Http/WebSocketServer.php        |  426 +++++-
 src/Framework/HttpClient/AuthType.php         |   12 +-
 .../Curl/Exception/HandleException.php        |   94 +-
 .../Curl/Exception/MultiHandleException.php   |   73 +-
 .../Exception/ClientErrorException.php        |    9 +-
 src/Framework/Icon/Icon.php                   |  129 ++
 src/Framework/Icon/IconRegistry.php           |  147 ++
 src/Framework/Icon/IconType.php               |   29 +
 .../Controllers/LiveComponentController.php   |   36 +-
 .../Exceptions/StateEncryptionException.php   |   30 +-
 .../ParameterBindingException.php             |   68 +-
 .../ValueObjects/LiveComponentError.php       |  226 +++
 .../Handlers/AggregatingLogHandler.php        |   20 +-
 .../Logging/Handlers/BufferedLogHandler.php   |   20 +-
 .../Handlers/RateLimitedLogHandler.php        |   20 +-
 .../Logging/Handlers/ResilientLogHandler.php  |   21 +-
 .../Logging/Handlers/SamplingLogHandler.php   |   20 +-
 .../Logging/Health/LoggingHealthCheck.php     |   22 +-
 src/Framework/MagicLinks/MagicLinkService.php |   85 ++
 .../Services/CacheMagicLinkService.php        |  139 +-
 .../Services/InMemoryMagicLinkService.php     |   39 +-
 .../MagicLinks/ValueObjects/ActionResult.php  |   66 +
 .../MagicLinks/ValueObjects/MagicLinkData.php |  192 +++
 .../ValueObjects/MagicLinkToken.php           |   45 +
 .../MagicLinks/ValueObjects/TokenAction.php   |   35 +
 .../MagicLinks/ValueObjects/TokenConfig.php   |   70 +
 .../Commands/SendEmailBatchCommandHandler.php |   10 +-
 .../Mail/Commands/SendEmailCommandHandler.php |   19 +-
 .../Mail/Exceptions/SmtpException.php         |   93 +-
 .../Mcp/CodebaseAnalyzerInitializer.php       |    2 +-
 src/Framework/Mcp/McpResourceMapper.php       |    4 +-
 src/Framework/Mcp/McpToolMapper.php           |    4 +-
 .../Analysis/DependencyAnalysisTools.php      |    2 +-
 .../Categories/Codebase/CodebaseAnalyzer.php  |    2 +-
 .../Development/CodeQualityTools.php          |    2 +-
 .../Security/SecurityAuditTools.php           |    2 +-
 src/Framework/Mfa/Exceptions/MfaException.php |   14 +
 src/Framework/Mfa/MfaInitializer.php          |   27 +
 src/Framework/Mfa/MfaProvider.php             |   59 +
 src/Framework/Mfa/MfaSecretFactory.php        |   52 +
 src/Framework/Mfa/MfaService.php              |  118 ++
 src/Framework/Mfa/Providers/TotpProvider.php  |  167 +++
 .../Mfa/ValueObjects/MfaChallenge.php         |  121 ++
 src/Framework/Mfa/ValueObjects/MfaCode.php    |   50 +
 src/Framework/Mfa/ValueObjects/MfaMethod.php  |   65 +
 src/Framework/Mfa/ValueObjects/MfaSecret.php  |  114 ++
 src/Framework/OpenApi/OpenApiGenerator.php    |    2 +-
 .../Pcntl/Exceptions/PcntlException.php       |  102 ++
 .../Pcntl/Integration/AsyncForkBridge.php     |  185 +++
 src/Framework/Pcntl/PcntlInitializer.php      |   51 +
 src/Framework/Pcntl/PcntlService.php          |  205 +++
 src/Framework/Pcntl/ProcessForker.php         |   79 +
 src/Framework/Pcntl/ProcessManager.php        |  179 +++
 src/Framework/Pcntl/SignalHandler.php         |  232 +++
 .../Pcntl/ValueObjects/ForkResult.php         |  139 ++
 .../Pcntl/ValueObjects/ProcessId.php          |   59 +
 .../Pcntl/ValueObjects/ProcessStatus.php      |  153 ++
 src/Framework/Pcntl/ValueObjects/Signal.php   |   86 ++
 src/Framework/Pcntl/WorkerPool.php            |  325 ++++
 .../Posix/Exceptions/PosixException.php       |  129 ++
 .../Posix/PosixServiceInitializer.php         |   35 +
 .../Posix/Services/InMemoryPosixService.php   |  181 +++
 .../Posix/Services/NativePosixService.php     |  120 ++
 src/Framework/Posix/Services/PosixService.php |   74 +
 src/Framework/Posix/ValueObjects/GroupId.php  |   35 +
 .../Posix/ValueObjects/GroupInfo.php          |   87 ++
 .../Posix/ValueObjects/GroupName.php          |   42 +
 .../Posix/ValueObjects/ProcessId.php          |   43 +
 .../Posix/ValueObjects/ProcessInfo.php        |   70 +
 .../Posix/ValueObjects/ResourceLimit.php      |  130 ++
 .../Posix/ValueObjects/ResourceType.php       |   69 +
 src/Framework/Posix/ValueObjects/Signal.php   |   65 +
 src/Framework/Posix/ValueObjects/UserId.php   |   35 +
 src/Framework/Posix/ValueObjects/UserInfo.php |   71 +
 src/Framework/Posix/ValueObjects/UserName.php |   50 +
 .../Exceptions/ProcessTimeoutException.php    |   12 +-
 .../Process/Services/TcpPortCheckService.php  |   60 +-
 .../Quality/CodeQuality/CodeQualityRule.php   |   23 +
 .../CodeQuality/CodeQualityScanner.php        |  136 ++
 .../CodeQuality/Results/CodeQualityReport.php |   89 ++
 .../CodeQuality/Results/RuleViolation.php     |   73 +
 .../Rules/DisallowInheritanceRule.php         |   68 +
 .../CodeQuality/Rules/FinalClassRule.php      |   56 +
 .../CodeQuality/Rules/ReadonlyGetterRule.php  |   57 +
 .../Rules/ReadonlyPropertyRule.php            |   56 +
 .../RequireStringableImplementationRule.php   |   44 +
 .../CodeQuality/TokenizerClassInspector.php   |  527 +++++++
 .../ValueObjects/ClassInspection.php          |  164 ++
 .../ValueObjects/SourceClassMetadata.php      |  130 ++
 src/Framework/QueryBus/QueryHandlerMapper.php |    4 +-
 .../Exceptions/AllStepsCompletedException.php |   13 +-
 .../Exceptions/ChainNotFoundException.php     |   23 +-
 .../CircularDependencyException.php           |   12 +-
 .../Exceptions/InvalidChainStateException.php |   35 +-
 .../InvalidDeadLetterQueueNameException.php   |   35 +-
 .../Queue/Exceptions/JobNotFoundException.php |   24 +-
 .../RedisExtensionNotLoadedException.php      |   13 +-
 .../Redis/InvalidRedisTtlException.php        |   27 +-
 .../Redis/RedisConnectionException.php        |    9 +-
 .../Async/AsyncReflectionProcessor.php        |  108 --
 .../Reflection/BatchOperations/README.md      |  159 --
 .../ReflectionBatchProcessor.php              |  348 -----
 src/Framework/Reflection/Builder/README.md    |  135 --
 .../Reflection/Builder/ReflectionBuilder.php  |  294 ----
 .../Builder/ReflectionBuilderFactory.php      |  125 --
 src/Framework/Reflection/ClassInfo.php        |  194 +++
 .../Collections/AttributeCollection.php       |  119 ++
 .../Collections/MethodCollection.php          |   73 +-
 .../Collections/ParameterCollection.php       |   97 ++
 .../Collections/PropertyCollection.php        |   98 +-
 .../Reflection/LazyReflectionProxy.php        |  460 ------
 src/Framework/Reflection/MethodInfo.php       |  130 ++
 .../Monitoring/ReflectionMetrics.php          |   98 --
 src/Framework/Reflection/ParameterInfo.php    |  128 ++
 src/Framework/Reflection/README.md            |  302 ++--
 .../Reflection/ReflectionService.php          |   72 +
 .../Reflection/SimpleReflectionService.php    |   94 ++
 .../Strategies/CacheWarmupStrategy.php        |   66 -
 .../Strategies/MemoryAwareCacheStrategy.php   |   75 -
 .../Reflection/WrappedReflectionAttribute.php |  177 +--
 .../ReflectionLegacy/Cache/AttributeCache.php |    8 +-
 .../Cache/ClassCache.php                      |   14 +-
 .../Cache/MetadataCacheManager.php            |    4 +-
 .../Cache/MethodCache.php                     |   32 +-
 .../Cache/ParameterCache.php                  |   10 +-
 .../CachedReflectionProvider.php              |   12 +-
 .../Collections/AttributeCollection.php       |    4 +-
 .../Collections/MethodCollection.php          |  117 ++
 .../Collections/ParameterCollection.php       |    4 +-
 .../Collections/PropertyCollection.php        |  149 ++
 .../Contracts/AttributeReflector.php          |    4 +-
 .../Contracts/CacheManager.php                |    2 +-
 .../Contracts/ClassReflector.php              |   10 +-
 .../Contracts/EnumReflector.php               |    2 +-
 .../Contracts/InstantiationReflector.php      |    2 +-
 .../Contracts/MethodReflector.php             |    8 +-
 .../Contracts/ParameterReflector.php          |    4 +-
 .../Contracts/PropertyReflector.php           |    4 +-
 .../Contracts/ReflectionCache.php             |    2 +-
 .../EVALUATION.md                             |   32 +-
 .../Factory/ReflectionCacheFactory.php        |   14 +-
 src/Framework/ReflectionLegacy/README.md      |  166 +++
 .../ReflectionCache.php                       |   12 +-
 .../ReflectionLegacy/ReflectionProvider.php   |   18 +-
 .../SUMMARY.md                                |    0
 .../Support/AttributeHandler.php              |    4 +-
 .../WrappedReflectionAttribute.php            |  171 +++
 .../WrappedReflectionClass.php                |   12 +-
 .../WrappedReflectionMethod.php               |   10 +-
 .../WrappedReflectionParameter.php            |    6 +-
 src/Framework/Router/AdminRoutes.php          |   25 +
 .../Router/ControllerRequestFactory.php       |   16 +-
 .../Router/Exception/RouteNotFound.php        |   14 +-
 .../ParameterResolutionException.php          |   17 +-
 .../Exceptions/UnknownResultException.php     |    9 +-
 src/Framework/Router/ParameterProcessor.php   |   15 +-
 .../Router/ValueObjects/MethodParameter.php   |    2 +-
 .../Exceptions/SocketBindException.php        |   26 +
 .../Exceptions/SocketConnectException.php     |   26 +
 .../Sockets/Exceptions/SocketException.php    |   48 +
 .../Exceptions/SocketListenException.php      |   25 +
 .../Exceptions/SocketReadException.php        |   33 +
 .../Sockets/Integration/AsyncSocketServer.php |  154 ++
 .../Sockets/Integration/PcntlSocketServer.php |  249 ++++
 src/Framework/Sockets/SocketClient.php        |  181 +++
 src/Framework/Sockets/SocketConnection.php    |   63 +
 .../Sockets/SocketConnectionPool.php          |  188 +++
 src/Framework/Sockets/SocketFactory.php       |  127 ++
 src/Framework/Sockets/SocketServer.php        |  167 +++
 src/Framework/Sockets/SocketService.php       |  260 ++++
 src/Framework/Sockets/SocketsInitializer.php  |   55 +
 .../Sockets/ValueObjects/SocketAddress.php    |  173 +++
 .../Sockets/ValueObjects/SocketOption.php     |   79 +
 .../Sockets/ValueObjects/SocketProtocol.php   |   54 +
 .../Sockets/ValueObjects/SocketResource.php   |  100 ++
 .../Sockets/ValueObjects/SocketType.php       |   60 +
 .../Ssh/Adapters/ProcessSftpClient.php        |  288 ++++
 .../Ssh/Adapters/ProcessSshClient.php         |  227 +++
 src/Framework/Ssh/Contracts/SftpClient.php    |   55 +
 src/Framework/Ssh/Contracts/SshClient.php     |   44 +
 .../Ssh/Exceptions/SftpClientException.php    |   33 +
 .../Ssh/Exceptions/SftpTransferException.php  |   28 +
 .../Ssh/Exceptions/SshClientException.php     |   50 +
 .../Exceptions/SshCommandFailedException.php  |   30 +
 .../SshRateLimitExceededException.php         |   50 +
 src/Framework/Ssh/SftpTransferExecutor.php    |  175 +++
 src/Framework/Ssh/SshCommandExecutor.php      |  171 +++
 src/Framework/Ssh/SshInitializer.php          |   46 +
 .../Ssh/Support/SshAuthenticationContext.php  |   30 +
 .../Ssh/Support/SshCommandBuilder.php         |  319 ++++
 .../Ssh/Support/SshProcessCommand.php         |   76 +
 .../Ssh/ValueObjects/AgentAuthentication.php  |   55 +
 .../ValueObjects/PasswordAuthentication.php   |   39 +
 .../ValueObjects/PrivateKeyAuthentication.php |   75 +
 .../Ssh/ValueObjects/SftpDirectoryEntry.php   |   25 +
 .../Ssh/ValueObjects/SftpOperationRequest.php |   22 +
 src/Framework/Ssh/ValueObjects/SftpPath.php   |   44 +
 .../ValueObjects/SftpTransferDirection.php    |   14 +
 .../Ssh/ValueObjects/SftpTransferRequest.php  |   32 +
 .../Ssh/ValueObjects/SshAuditContext.php      |   29 +
 .../ValueObjects/SshAuthenticationMethod.php  |   20 +
 .../ValueObjects/SshAuthenticationType.php    |   17 +
 src/Framework/Ssh/ValueObjects/SshCommand.php |   57 +
 .../Ssh/ValueObjects/SshCommandRequest.php    |   22 +
 .../Ssh/ValueObjects/SshCommandResult.php     |   63 +
 .../Ssh/ValueObjects/SshConnectionConfig.php  |   69 +
 .../ValueObjects/SshEnvironmentVariable.php   |   43 +
 src/Framework/Ssh/ValueObjects/SshHost.php    |   50 +
 .../ValueObjects/SshHostKeyFingerprint.php    |   59 +
 src/Framework/Ssh/ValueObjects/SshPort.php    |   36 +
 .../Ssh/ValueObjects/SshRateLimitPolicy.php   |   51 +
 .../Ssh/ValueObjects/SshUsername.php          |   40 +
 src/Framework/StaticSite/StaticSiteMapper.php |    4 +-
 .../Exceptions/BucketNotFoundException.php    |   18 +-
 .../Exceptions/ObjectNotFoundException.php    |   25 +-
 .../Exceptions/StorageConnectionException.php |   21 +-
 .../Storage/Exceptions/StorageException.php   |   53 +-
 .../Exceptions/StorageOperationException.php  |   30 +-
 .../ValueObjects/AlphanumericString.php       |   50 +
 .../String/ValueObjects/HexadecimalString.php |   73 +
 .../String/ValueObjects/NumericString.php     |   66 +
 .../String/ValueObjects/PosixAlphaString.php  |   71 +
 .../String/ValueObjects/PosixString.php       |  271 ++++
 .../String/ValueObjects/PosixWordString.php   |   81 +
 .../String/ValueObjects/PrintableString.php   |   53 +
 .../String/ValueObjects/TypedString.php       |  300 ++++
 .../ValueObjects/TypedStringValidator.php     |  483 ++++++
 .../SyntaxHighlighter/FileHighlighter.php     |   87 +-
 .../Formatters/ConsoleFormatter.php           |    2 +-
 .../Formatters/HtmlFormatter.php              |  444 ++++--
 src/Framework/Tokenizer/MetadataCollector.php |  272 ++++
 src/Framework/Tokenizer/PhpTokenizer.php      |   47 +-
 src/Framework/Tokenizer/TokenClassifier.php   |  125 +-
 .../Tokenizer/ValueObjects/Token.php          |   20 +-
 .../ValueObjects/TokenCollection.php          |  194 ++-
 .../Tokenizer/ValueObjects/TokenMetadata.php  |  214 +++
 .../Tokenizer/ValueObjects/TokenType.php      |   67 +-
 .../Exceptions/ValidationException.php        |   72 +-
 src/Framework/Validation/Validator.php        |    2 +-
 .../View/Components/AdminSidebar.php          |  232 ++-
 .../Dom/Transformer/XComponentTransformer.php |   21 +-
 .../View/Exception/TemplateNotFound.php       |   23 +-
 .../Exceptions/TemplateCacheException.php     |   59 +-
 .../Exceptions/TemplateNotFoundException.php  |   44 +-
 .../Exceptions/TemplateProcessorException.php |   88 +-
 .../Exceptions/TemplateRenderingException.php |   70 +-
 .../View/Loading/TemplatePathResolver.php     |    2 +-
 .../ViteManifestNotFoundException.php         |    3 -
 .../View/Processors/PhpVariableProcessor.php  |    7 +-
 .../DatabaseMetadataTableGenerator.php        |  251 ++++
 .../Generators/DatabaseTableGenerator.php     |  129 ++
 src/Framework/View/TemplateMapper.php         |    4 +-
 .../livecomponent-docker-containers.view.php  |  194 +++
 .../livecomponent-health-status.view.php      |   95 ++
 .../livecomponent-notification.view.php       |   22 +
 ...livecomponent-performance-metrics.view.php |  169 +++
 .../Vite/Exceptions/ViteManifestException.php |   43 +-
 .../0c96ac1a57b063550dff9e96c6ad11c2.lock     |    0
 .../5e7426f884af5ff2e38a71a018a93b72.lock     |    0
 test-hot-reload.html                          |   16 -
 tests/Framework/ApiGateway/ApiGatewayTest.php |   79 +-
 .../ConsoleApplicationIntegrationTest.php     |    4 +-
 .../Console/ConsoleDiscoveryEnd2EndTest.php   |    4 +-
 tests/Framework/Core/DynamicRoutingTest.php   |   12 +-
 tests/Framework/DI/ContainerCompilerTest.php  |    2 +-
 tests/Framework/Discovery/MemoryLeakTest.php  |    4 +-
 .../Framework/Discovery/SimpleMemoryTest.php  |    2 +-
 .../Discovery/UnifiedDiscoveryServiceTest.php |    2 +-
 ...ewareDependencyResolverIntegrationTest.php |    2 +-
 .../Http/MiddlewareDependencyResolverTest.php |    2 +-
 .../MagicLinks/MagicLinksValueObjectsTest.php |  417 ++++++
 tests/Framework/Mfa/MfaServiceTest.php        |  338 +++++
 tests/Framework/MultiPurposeAttributeTest.php |    4 +-
 .../Cache/ClassCacheMemoryLeakTest.php        |    8 +-
 .../ReflectionMemoryLeakAnalysisTest.php      |   12 +-
 .../Reflection/ReflectionMemoryLeakTest.php   |   12 +-
 .../Router/ParameterProcessorDebugTest.php    |    2 +-
 tests/Framework/Validation/ValidatorTest.php  |    2 +-
 .../ExceptionAuditIntegrationTest.php         |  253 ++++
 .../ErrorHandlerAggregatorIntegrationTest.php |  340 -----
 .../ErrorHandlerFullPipelineTest.php          |  298 ----
 .../Framework/DI/ParameterResolverTest.php    |    7 +-
 .../SslCertificateHealthCheckTest.php         |    4 +-
 .../ErrorHandling/ErrorHandlerManagerTest.php |  320 ----
 .../Handlers/DatabaseErrorHandlerTest.php     |   63 -
 .../Handlers/FallbackErrorHandlerTest.php     |   69 -
 .../Handlers/HttpErrorHandlerTest.php         |   61 -
 .../Handlers/ValidationErrorHandlerTest.php   |   47 -
 .../Audit/ExceptionAuditLoggerTest.php        |  301 ++++
 .../ExceptionContextIntegrationTest.php       |   30 +
 .../ValueObjects/PosixAlphaStringTest.php     |  209 +++
 .../String/ValueObjects/PosixStringTest.php   |  278 ++++
 .../ValueObjects/PosixWordStringTest.php      |  296 ++++
 .../ValueObjects/SpecializedStringVOsTest.php |  170 +++
 .../String/ValueObjects/TypedStringTest.php   |  170 +++
 .../ValueObjects/TypedStringValidatorTest.php |  440 ++++++
 tests/debug/debug-visitclass.php              |    2 +-
 tests/debug/test-all-initializers.php         |    2 +-
 tests/debug/test-auth-capture.php             |   42 +
 tests/debug/test-context-filtering.php        |    2 +-
 tests/debug/test-dataprovider-minimal.php     |    2 +-
 tests/debug/test-debug-initializer.php        |    2 +-
 tests/debug/test-dependency-analysis.php      |    2 +-
 tests/debug/test-dependency-graph-api.php     |    2 +-
 tests/debug/test-enhanced-error-page.php      |   87 --
 tests/debug/test-error-aggregator-debug-2.php |   61 -
 tests/debug/test-error-aggregator-debug.php   |  163 --
 tests/debug/test-error-context-system.php     |  177 ---
 .../debug/test-error-handler-enhancements.php |   73 -
 tests/debug/test-error-handling-module.php    |  194 ---
 tests/debug/test-error-pipeline-debug.php     |  202 ---
 tests/debug/test-error-reporting-config.php   |  135 --
 tests/debug/test-event-system.php             |    4 +-
 tests/debug/test-initializer-execution.php    |    4 +-
 tests/debug/test-memory-management.php        |    4 +-
 tests/debug/test-new-di-system.php            |    4 +-
 tests/debug/test-reflection-performance.php   |  123 ++
 tests/debug/test-security-audit-tools.php     |    2 +-
 tests/debug/test-service-usage.php            |    4 +-
 tests/debug/test-web-initializers.php         |    4 +-
 tests/debug/test_token_classification.php     |  912 ++++++++++++
 .../ExceptionHandlingIntegrationTest.php      |   60 +-
 worker.php                                    |   29 +-
 1366 files changed, 104925 insertions(+), 28719 deletions(-)
 create mode 100644 .gitattributes
 create mode 100644 CODEX.md
 create mode 100644 deployment/ansible/callback_plugins/README.md
 create mode 100644 deployment/ansible/callback_plugins/__pycache__/default_with_clean_msg.cpython-311.pyc
 create mode 100644 deployment/ansible/callback_plugins/default_with_clean_msg.py
 delete mode 120000 deployment/ansible/inventory/group_vars/production.yml
 create mode 120000 deployment/ansible/inventory/group_vars/production/vault.yml
 create mode 100644 deployment/ansible/playbooks/BUILD-INITIAL-IMAGE.md
 create mode 100644 deployment/ansible/playbooks/TRAEFIK_RESTART_DIAGNOSIS.md
 create mode 100644 deployment/ansible/playbooks/backup.yml
 create mode 100644 deployment/ansible/playbooks/build-initial-image.yml
 delete mode 100644 deployment/ansible/playbooks/check-after-grafana-access.yml
 create mode 100644 deployment/ansible/playbooks/check-container-logs.yml
 create mode 100644 deployment/ansible/playbooks/check-container-status.yml
 delete mode 100644 deployment/ansible/playbooks/check-docker-compose-logs.yml
 delete mode 100644 deployment/ansible/playbooks/check-entrypoint-execution.yml
 create mode 100644 deployment/ansible/playbooks/check-env-file.yml
 create mode 100644 deployment/ansible/playbooks/check-final-status.yml
 delete mode 100644 deployment/ansible/playbooks/check-git-logs.yml
 delete mode 100644 deployment/ansible/playbooks/check-gitea-bad-gateway.yml
 delete mode 100644 deployment/ansible/playbooks/check-grafana-after-test.yml
 delete mode 100644 deployment/ansible/playbooks/check-latest-grafana-access.yml
 delete mode 100644 deployment/ansible/playbooks/check-php-files-and-workers.yml
 delete mode 100644 deployment/ansible/playbooks/check-phpfpm-config.yml
 delete mode 100644 deployment/ansible/playbooks/check-production-status.yml
 delete mode 100644 deployment/ansible/playbooks/check-redis-connection.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-500-error.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-logs.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-php-logs.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-redis-connection.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-redis-env-file.yml
 delete mode 100644 deployment/ansible/playbooks/check-staging-status.yml
 create mode 100644 deployment/ansible/playbooks/check-traefik-acme-logs.yml
 delete mode 100644 deployment/ansible/playbooks/check-traefik-gitea-config.yml
 delete mode 100644 deployment/ansible/playbooks/check-vpn-routing-status.yml
 delete mode 100644 deployment/ansible/playbooks/check-vpn-test-from-client.yml
 create mode 100644 deployment/ansible/playbooks/check-worker-logs.yml
 create mode 100644 deployment/ansible/playbooks/cleanup-all-containers.yml
 delete mode 100644 deployment/ansible/playbooks/debug-grafana-403.yml
 delete mode 100644 deployment/ansible/playbooks/debug-staging-redis-secrets.yml
 create mode 100644 deployment/ansible/playbooks/deploy-complete.yml
 create mode 100644 deployment/ansible/playbooks/deploy-gitea-stack-config.yml
 delete mode 100644 deployment/ansible/playbooks/deploy-update.yml
 delete mode 100644 deployment/ansible/playbooks/deploy/production.yml
 delete mode 100644 deployment/ansible/playbooks/deploy/staging.yml
 create mode 100644 deployment/ansible/playbooks/diagnose-gitea-timeout-deep.yml
 create mode 100644 deployment/ansible/playbooks/diagnose-gitea-timeout-live.yml
 create mode 100644 deployment/ansible/playbooks/diagnose-gitea-timeouts.yml
 delete mode 100644 deployment/ansible/playbooks/diagnose-staging-502.yml
 delete mode 100644 deployment/ansible/playbooks/diagnose-staging-logs.yml
 create mode 100644 deployment/ansible/playbooks/diagnose-traefik-restarts.yml
 delete mode 100644 deployment/ansible/playbooks/diagnose-vpn-routing.yml
 create mode 100644 deployment/ansible/playbooks/disable-traefik-auto-restarts.yml
 create mode 100644 deployment/ansible/playbooks/ensure-gitea-traefik-discovery.yml
 create mode 100644 deployment/ansible/playbooks/final-status-check.yml
 create mode 100644 deployment/ansible/playbooks/find-ansible-automation-source.yml
 create mode 100644 deployment/ansible/playbooks/find-traefik-restart-source.yml
 create mode 100644 deployment/ansible/playbooks/fix-container-issues.yml
 delete mode 100644 deployment/ansible/playbooks/fix-gitea-actions-config.yml
 delete mode 100644 deployment/ansible/playbooks/fix-gitea-actions-url.yml
 delete mode 100644 deployment/ansible/playbooks/fix-gitea-traefik-dynamic-config.yml
 delete mode 100644 deployment/ansible/playbooks/fix-gitea-traefik-labels.yml
 delete mode 100644 deployment/ansible/playbooks/fix-grafana-vpn-access.yml
 delete mode 100644 deployment/ansible/playbooks/fix-grafana-vpn-routing.yml
 delete mode 100644 deployment/ansible/playbooks/fix-nginx-upstream.yml
 delete mode 100644 deployment/ansible/playbooks/fix-phpfpm-config.yml
 delete mode 100644 deployment/ansible/playbooks/fix-sites-available-default.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-502-quick.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-502-verify.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-complete.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-compose-secrets.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-issues.yml
 delete mode 100644 deployment/ansible/playbooks/fix-staging-secrets-permissions.yml
 create mode 100644 deployment/ansible/playbooks/fix-traefik-acme-permissions.yml
 delete mode 100644 deployment/ansible/playbooks/fix-traefik-config.yml
 create mode 100644 deployment/ansible/playbooks/fix-web-container.yml
 create mode 100644 deployment/ansible/playbooks/initial-server-setup.yml
 create mode 100644 deployment/ansible/playbooks/install-docker.yml
 delete mode 100644 deployment/ansible/playbooks/monitor-grafana-access-live.yml
 delete mode 100644 deployment/ansible/playbooks/monitor-grafana-client-ip.yml
 delete mode 100644 deployment/ansible/playbooks/monitor-grafana-live-now.yml
 delete mode 100644 deployment/ansible/playbooks/monitor-grafana-live-with-firewall.yml
 delete mode 100644 deployment/ansible/playbooks/monitor-live-grafana-access.yml
 create mode 100644 deployment/ansible/playbooks/monitor-traefik-continuously.yml
 create mode 100644 deployment/ansible/playbooks/monitor-traefik-restarts.yml
 delete mode 100644 deployment/ansible/playbooks/quick-staging-logs-check.yml
 create mode 100644 deployment/ansible/playbooks/recreate-containers-with-env.yml
 create mode 100644 deployment/ansible/playbooks/recreate-traefik.yml
 delete mode 100644 deployment/ansible/playbooks/remove-framework-production-stack.yml
 delete mode 100644 deployment/ansible/playbooks/remove-temporary-grafana-ip.yml
 create mode 100644 deployment/ansible/playbooks/restart-gitea-complete.yml
 create mode 100644 deployment/ansible/playbooks/restart-gitea-with-cache.yml
 create mode 100644 deployment/ansible/playbooks/setup-gitea-initial-config.yml
 create mode 100644 deployment/ansible/playbooks/setup-staging.yml
 create mode 100644 deployment/ansible/playbooks/stabilize-traefik.yml
 create mode 100644 deployment/ansible/playbooks/sync-and-recreate-containers.yml
 create mode 100644 deployment/ansible/playbooks/sync-application-code.yml
 delete mode 100644 deployment/ansible/playbooks/sync-code.yml
 delete mode 100644 deployment/ansible/playbooks/tasks/check-health.yml
 delete mode 100644 deployment/ansible/playbooks/tasks/diagnose-404.yml
 delete mode 100644 deployment/ansible/playbooks/tasks/fix-health-checks.yml
 delete mode 100644 deployment/ansible/playbooks/tasks/fix-nginx-404.yml
 delete mode 100644 deployment/ansible/playbooks/test-fastcgi-directly.yml
 create mode 100644 deployment/ansible/playbooks/test-gitea-after-fix.yml
 delete mode 100644 deployment/ansible/playbooks/test-grafana-vpn-access.yml
 delete mode 100644 deployment/ansible/playbooks/test-grafana-vpn-final.yml
 delete mode 100644 deployment/ansible/playbooks/test-redis-connection-direct.yml
 delete mode 100644 deployment/ansible/playbooks/test-staging-container-access.yml
 create mode 100644 deployment/ansible/playbooks/verify-env-loading.yml
 create mode 100644 deployment/ansible/playbooks/verify-production.yml
 create mode 100644 deployment/ansible/playbooks/verify-staging.yml
 delete mode 100644 deployment/ansible/playbooks/view-staging-logs-readable.yml
 create mode 100644 deployment/ansible/roles/application/handlers/main.yml
 create mode 100644 deployment/ansible/roles/application/tasks/composer.yml
 create mode 100644 deployment/ansible/roles/application/tasks/containers.yml
 create mode 100644 deployment/ansible/roles/application/tasks/deploy_code.yml
 rename deployment/ansible/roles/application/tasks/{main.yml => deploy_stack.yml} (100%)
 create mode 100644 deployment/ansible/roles/application/tasks/health_check.yml
 create mode 100644 deployment/ansible/roles/application/tasks/logs.yml
 create mode 100644 deployment/ansible/roles/gitea/handlers/main.yml
 create mode 100644 deployment/ansible/roles/gitea/tasks/config.yml
 rename deployment/ansible/roles/gitea/tasks/{main.yml => deploy.yml} (100%)
 create mode 100644 deployment/ansible/roles/gitea/tasks/repository.yml
 create mode 100644 deployment/ansible/roles/gitea/tasks/runner.yml
 create mode 100644 deployment/ansible/roles/gitea/tasks/setup.yml
 create mode 100644 deployment/ansible/roles/postgresql-production/defaults/main.yml
 create mode 100644 deployment/ansible/roles/postgresql-production/tasks/main.yml
 create mode 100644 deployment/ansible/roles/postgresql-production/templates/postgresql.env.j2
 create mode 100644 deployment/ansible/roles/postgresql-staging/defaults/main.yml
 create mode 100644 deployment/ansible/roles/postgresql-staging/tasks/main.yml
 create mode 100644 deployment/ansible/roles/postgresql-staging/templates/postgresql.env.j2
 create mode 100644 deployment/ansible/roles/postgresql/templates/postgresql.env.j2
 create mode 100644 deployment/ansible/roles/redis/defaults/main.yml
 create mode 100644 deployment/ansible/roles/redis/tasks/main.yml
 create mode 100644 deployment/ansible/roles/redis/templates/redis.env.j2
 create mode 100644 deployment/ansible/roles/traefik/handlers/main.yml
 create mode 100644 deployment/ansible/roles/traefik/tasks/deploy.yml
 create mode 100644 deployment/ansible/roles/traefik/tasks/logs.yml
 delete mode 100644 deployment/ansible/roles/traefik/tasks/main.yml
 create mode 100644 deployment/ansible/roles/traefik/tasks/restart.yml
 create mode 100755 deployment/ansible/scripts/add-registry-password-to-vault.sh
 create mode 100644 deployment/ansible/secrets/production.vault.yml.old
 create mode 100644 deployment/docs/guides/ansible-vs-bash-scripts.md
 create mode 100644 deployment/docs/guides/backup-and-rollback-guide.md
 create mode 100644 deployment/docs/guides/cicd-workflow-guide.md
 create mode 100644 deployment/docs/guides/code-deployment-workflow.md
 create mode 100644 deployment/docs/guides/health-checks.md
 create mode 100644 deployment/docs/guides/initial-deployment-guide.md
 create mode 100644 deployment/docs/guides/manual-server-test.md
 create mode 100644 deployment/docs/guides/migrate-to-separate-databases.md
 create mode 100644 deployment/docs/guides/os-selection.md
 create mode 100644 deployment/docs/guides/pipeline-test-checklist.md
 create mode 100644 deployment/docs/guides/pipeline-test-steps.md
 create mode 100644 deployment/docs/guides/pipeline-testing-guide.md
 create mode 100644 deployment/docs/guides/production-database-connection.md
 create mode 100644 deployment/docs/guides/security-hardening.md
 create mode 100644 deployment/docs/guides/server-rebuild-plan.md
 create mode 100644 deployment/docs/guides/ssh-access.md
 create mode 100644 deployment/docs/guides/staging-test-plan.md
 create mode 100644 deployment/docs/guides/test-execution-plan.md
 create mode 100644 deployment/docs/reference/docker-compose-production.md
 create mode 100644 deployment/docs/server-directory-structure.md
 create mode 100644 deployment/docs/status/gitea-cache-activation.md
 create mode 100644 deployment/docs/status/implementation-summary.md
 create mode 100644 deployment/docs/status/pipeline-test-status.md
 create mode 100644 deployment/docs/status/staging-implementation-status.md
 create mode 100644 deployment/docs/tests/README.md
 create mode 100644 deployment/scripts/README.md
 create mode 100755 deployment/scripts/production-quick-start.sh
 create mode 100755 deployment/scripts/staging-quick-start.sh
 create mode 100755 deployment/scripts/test-backup.sh
 create mode 100755 deployment/scripts/test-pipeline-prerequisites.sh
 delete mode 100644 deployment/stacks/application/docker-compose.yml
 delete mode 100644 deployment/stacks/application/docker-compose.yml.backup
 delete mode 100644 deployment/stacks/gitea/app.ini
 delete mode 100644 deployment/stacks/gitea/mysql/conf.d/gitea.cnf
 create mode 100644 deployment/stacks/monitoring/docker-compose.local.yml
 create mode 100644 deployment/stacks/postgresql-production/README.md
 create mode 100644 deployment/stacks/postgresql-production/conf.d/postgresql.conf
 create mode 100644 deployment/stacks/postgresql-production/docker-compose.yml
 create mode 100755 deployment/stacks/postgresql-production/scripts/backup-entrypoint.sh
 create mode 100755 deployment/stacks/postgresql-production/scripts/backup.sh
 create mode 100755 deployment/stacks/postgresql-production/scripts/restore.sh
 create mode 100644 deployment/stacks/postgresql-staging/README.md
 create mode 100644 deployment/stacks/postgresql-staging/conf.d/postgresql.conf
 create mode 100644 deployment/stacks/postgresql-staging/docker-compose.yml
 create mode 100755 deployment/stacks/postgresql-staging/scripts/backup-entrypoint.sh
 create mode 100755 deployment/stacks/postgresql-staging/scripts/backup.sh
 create mode 100755 deployment/stacks/postgresql-staging/scripts/restore.sh
 rename deployment/stacks/{application => production}/.env.example (100%)
 rename deployment/stacks/{application => production}/README.md (97%)
 rename deployment/stacks/{application => production}/nginx/conf.d/default.conf (100%)
 create mode 100644 deployment/stacks/redis/.env.example
 create mode 100644 deployment/stacks/redis/README.md
 create mode 100644 deployment/stacks/redis/docker-compose.yml
 create mode 100644 deployment/stacks/redis/redis.conf
 create mode 100644 deployment/stacks/registry/auth/htpasswd
 create mode 100644 deployment/stacks/traefik/dynamic/gitea-router.yml
 rename deployment/stacks/traefik/dynamic/{gitea-service.yml => gitea-service.yml.disabled} (100%)
 delete mode 100644 deployment/stacks/traefik/dynamic/gitea.yml
 delete mode 100755 deployment/wireguard-old/add-wireguard-client.yml
 delete mode 100644 deployment/wireguard-old/regenerate-wireguard-client.yml
 delete mode 100755 deployment/wireguard-old/setup-wireguard.yml
 delete mode 100644 deployment/wireguard-old/test-wireguard-docker-container.yml
 delete mode 100644 deployment/wireguard-old/wireguard-client.conf.j2
 delete mode 100644 deployment/wireguard-old/wireguard-server.conf.j2
 rename deployment/stacks/application/docker-compose.base.yml => docker-compose.production-base.yml (55%)
 create mode 100644 docs/ARCHITECTURE-DECISION.md
 create mode 100644 docs/DOCUMENTATION-ANALYSIS.md
 create mode 100644 docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md
 create mode 100644 docs/ERROR-RENDERER-REFACTORING-PLAN.md
 create mode 100644 docs/SRC-ARCHITECTURE-ANALYSIS.md
 create mode 100644 docs/claude/README.md
 create mode 100644 docs/claude/animationsystem.md
 delete mode 100644 docs/claude/error-handling.md
 create mode 100644 docs/claude/js-modules-analysis.md
 delete mode 100644 docs/claude/livecomponent-lazy-loading.md
 create mode 100644 docs/claude/posix-system.md
 create mode 100644 docs/claude/sockets-module.md
 create mode 100644 docs/claude/typed-string-system.md
 create mode 100644 docs/codex/guidelines.md
 rename DEPLOYMENT_FIX.md => docs/deployment/DEPLOYMENT_FIX.md (100%)
 rename ENV_SETUP.md => docs/deployment/ENV_SETUP.md (100%)
 create mode 100644 docs/deployment/status/.deployment-test-status.md
 create mode 100644 docs/design-token-system.md
 rename docs/{claude/migration-system-quick-reference.md => features/database/migrations.md} (100%)
 rename docs/{claude/database-patterns.md => features/database/patterns.md} (100%)
 create mode 100644 docs/features/error-handling/advanced.md
 create mode 100644 docs/features/error-handling/guide.md
 rename docs/{claude/event-system.md => features/events/system.md} (100%)
 rename docs/{claude/filesystem-patterns.md => features/filesystem/patterns.md} (100%)
 rename docs/{claude/scheduler-queue-pipeline.md => features/queue/scheduler.md} (100%)
 rename docs/{claude/queue-system.md => features/queue/system.md} (100%)
 rename docs/{claude/routing-value-objects.md => features/routing/value-objects.md} (100%)
 rename docs/{claude/security-patterns.md => features/security/patterns.md} (100%)
 rename docs/{claude => features/security}/route-authorization.md (100%)
 rename docs/{claude => guides}/common-workflows.md (100%)
 rename docs/{claude/configuration-best-practices.md => guides/configuration.md} (100%)
 rename docs/{claude => guides}/troubleshooting.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-file-uploads.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-formbuilder-usage.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-lifecycle-hooks.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-nested-components.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-security.md (100%)
 rename docs/{claude => livecomponents}/livecomponent-slot-system.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-best-practices.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-caching-system.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-dom-badges.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-implementation-plan.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-lazy-loading.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-monitoring-debugging.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-observability.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-performance-optimizations.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-playground.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-roadmap.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-system.md (100%)
 rename docs/{claude => livecomponents}/livecomponents-test-harness.md (100%)
 create mode 100644 docs/livecomponents/ui-integration-guide.md
 create mode 100644 docs/modules/analytics.md
 create mode 100644 docs/modules/animation-system-migration.md
 create mode 100644 docs/modules/animation-system.md
 create mode 100644 docs/modules/cache-manager.md
 create mode 100644 docs/modules/error-tracking.md
 create mode 100644 docs/modules/event-bus.md
 create mode 100644 docs/modules/router.md
 create mode 100644 docs/modules/security.md
 create mode 100644 docs/modules/state-manager.md
 create mode 100644 docs/modules/validation.md
 create mode 100644 docs/planning/ADMIN_AUTH_SECURITY_ENHANCEMENT.md
 rename CLEANUP_PLAN.md => docs/planning/CLEANUP_PLAN.md (100%)
 rename LIVECOMPONENTS_TEST.md => docs/planning/LIVECOMPONENTS_TEST.md (100%)
 rename SRC_STRUCTURE_IMPROVEMENTS.md => docs/planning/SRC_STRUCTURE_IMPROVEMENTS.md (100%)
 create mode 100644 docs/quality/code-quality-scanner.md
 create mode 100644 docs/todo/design-token-system-future-features.md
 rename todo.md => docs/todo/todo.md (100%)
 create mode 100644 docs/troubleshooting/gitea-actions-artifact-compatibility.md
 create mode 100644 public/assets/css/admin-B295JZoO.css
 create mode 100644 public/assets/js/main-C52nFCDL.js
 create mode 100644 public/assets/js/main-C52nFCDL.js.map
 create mode 100644 resources/css/admin/01-settings/_generated-tokens.css
 create mode 100644 resources/js/modules/analytics/Analytics.js
 create mode 100644 resources/js/modules/analytics/AnalyticsProvider.js
 create mode 100644 resources/js/modules/analytics/index.js
 create mode 100644 resources/js/modules/animation-system/AnimationSystem.js
 create mode 100644 resources/js/modules/animation-system/ScrollAnimation.js
 create mode 100644 resources/js/modules/animation-system/TimelineAnimation.js
 create mode 100644 resources/js/modules/animation-system/index.js
 create mode 100644 resources/js/modules/cache-manager/CacheManager.js
 create mode 100644 resources/js/modules/cache-manager/CacheStrategy.js
 create mode 100644 resources/js/modules/cache-manager/index.js
 delete mode 100644 resources/js/modules/csrf-auto-refresh.js
 create mode 100644 resources/js/modules/error-tracking/ErrorTracker.js
 create mode 100644 resources/js/modules/error-tracking/index.js
 create mode 100644 resources/js/modules/event-bus/EventBus.js
 create mode 100644 resources/js/modules/event-bus/index.js
 create mode 100644 resources/js/modules/livecomponent/ActionLoadingManager.js
 create mode 100644 resources/js/modules/livecomponent/ErrorBoundary.js
 create mode 100644 resources/js/modules/livecomponent/LiveComponentUIHelper.js
 create mode 100644 resources/js/modules/livecomponent/LoadingStateManager.js
 create mode 100644 resources/js/modules/livecomponent/RequestDeduplicator.js
 create mode 100644 resources/js/modules/livecomponent/SharedConfig.js
 create mode 100644 resources/js/modules/livecomponent/StateSerializer.js
 create mode 100644 resources/js/modules/livecomponent/TooltipManager.js
 create mode 100644 resources/js/modules/router/RouteGuard.js
 create mode 100644 resources/js/modules/router/RouteMiddleware.js
 create mode 100644 resources/js/modules/router/Router.js
 create mode 100644 resources/js/modules/router/index.js
 create mode 100644 resources/js/modules/security/CsrfManager.js
 create mode 100644 resources/js/modules/security/SecurityManager.js
 create mode 100644 resources/js/modules/security/index.js
 create mode 100644 resources/js/modules/state-manager/StateManager.js
 create mode 100644 resources/js/modules/state-manager/index.js
 create mode 100644 resources/js/modules/validation/ValidationRule.js
 create mode 100644 resources/js/modules/validation/Validator.js
 create mode 100644 resources/js/modules/validation/index.js
 create mode 100644 resources/js/schemas/livecomponent-action-request.schema.json
 create mode 100644 resources/js/schemas/livecomponent-action-response.schema.json
 create mode 100644 resources/js/schemas/livecomponent-error.schema.json
 create mode 100644 resources/js/types/analytics.d.ts
 create mode 100644 resources/js/types/animation-system.d.ts
 create mode 100644 resources/js/types/cache-manager.d.ts
 create mode 100644 resources/js/types/error-tracking.d.ts
 create mode 100644 resources/js/types/event-bus.d.ts
 create mode 100644 resources/js/types/livecomponent.d.ts
 create mode 100644 resources/js/types/router.d.ts
 create mode 100644 resources/js/types/security.d.ts
 create mode 100644 resources/js/types/state-manager.d.ts
 create mode 100644 resources/js/types/validation.d.ts
 create mode 100644 resources/views/errors/404.view.php
 create mode 100644 resources/views/errors/500.view.php
 create mode 100644 resources/views/errors/error.view.php
 rename build.sh => scripts/build/build.sh (100%)
 rename scripts/{ => ci}/delete-all-workflow-runs.sh (100%)
 rename scripts/{ => ci}/extract-ci-token.yml (100%)
 rename scripts/{ => ci}/get-ci-token-from-vault.sh (100%)
 rename {public => scripts/debug}/chat.html (100%)
 rename debug-component-registry.php => scripts/debug/debug-component-registry.php (100%)
 rename {public => scripts/debug}/qr-test-all.html (100%)
 rename {public => scripts/debug}/qrcode-test.html (100%)
 rename {public => scripts/debug}/test-hot-reload.css (100%)
 rename {public => scripts/debug}/test-hot-reload.html (100%)
 rename {public => scripts/debug}/test-hot-reload.js (100%)
 rename {public => scripts/debug}/test.html (100%)
 rename scripts/{ => deployment}/health-check.sh (100%)
 rename scripts/{ => deployment}/migrate-env-to-base-override.sh (100%)
 rename scripts/{ => deployment}/prepare-secrets.sh (100%)
 rename scripts/{ => deployment}/setup-autossh.sh (100%)
 rename scripts/{ => deployment}/setup-gitea-secrets-interactive.sh (100%)
 rename scripts/{ => deployment}/setup-gitea-secrets-with-token.sh (100%)
 rename scripts/{ => deployment}/setup-gitea-secrets.sh (100%)
 rename scripts/{ => deployment}/setup-production-secrets.sh (100%)
 rename setup-production-ssl.sh => scripts/deployment/setup-production-ssl.sh (100%)
 rename scripts/{ => deployment}/setup-secrets-interactive.sh (100%)
 rename install-php85.sh => scripts/install/install-php85.sh (100%)
 rename scripts/{ => maintenance}/backup.sh (100%)
 rename scripts/{ => maintenance}/fix-worker-permissions.sh (100%)
 rename fix_admin_layout.sh => scripts/maintenance/fix_admin_layout.sh (100%)
 rename generate-vapid-keys.php => scripts/maintenance/generate-vapid-keys.php (100%)
 rename scripts/{ => maintenance}/seed-ml-models.php (100%)
 rename scripts/{ => maintenance}/seed-notifications.php (100%)
 rename generate_ssl_certificates.sh => scripts/ssl/generate_ssl_certificates.sh (100%)
 rename scripts/{ => ssl}/ssl-init.sh (100%)
 rename scripts/{ => ssl}/ssl-test.sh (100%)
 rename scripts/{ => test}/test-deployment-secrets.sh (100%)
 rename scripts/{ => test}/test-registry-credentials.sh (100%)
 rename test-security.sh => scripts/test/test-security.sh (100%)
 rename test-simple.sh => scripts/test/test-simple.sh (95%)
 rename test-ssl.sh => scripts/test/test-ssl.sh (100%)
 rename test-upload-system.sh => scripts/test/test-upload-system.sh (100%)
 rename test-workflow.sh => scripts/test/test-workflow.sh (100%)
 create mode 100644 src/Application/Admin/Database/DatabaseBrowserController.php
 create mode 100644 src/Application/Admin/Database/TableBrowserController.php
 create mode 100644 src/Application/Admin/Infrastructure/DockerController.php
 create mode 100644 src/Application/Admin/Registry/AdminNavigationRegistry.php
 create mode 100644 src/Application/Admin/Service/AdminPageDiscovery.php
 create mode 100644 src/Application/Admin/ValueObjects/AdminPageMetadata.php
 create mode 100644 src/Application/Admin/ValueObjects/AdminSectionMetadata.php
 create mode 100644 src/Application/Admin/templates/database/browser.view.php
 create mode 100644 src/Application/Admin/templates/database/table-detail.view.php
 create mode 100644 src/Application/Admin/templates/docker-dashboard.view.php
 create mode 100644 src/Application/Asset/Api/Requests/UploadAssetRequest.php
 create mode 100644 src/Application/Asset/Api/V1/AssetsController.php
 create mode 100644 src/Application/Cms/Api/Requests/CreateContentRequest.php
 create mode 100644 src/Application/Cms/Api/Requests/CreateContentTypeRequest.php
 create mode 100644 src/Application/Cms/Api/Requests/UpdateContentRequest.php
 create mode 100644 src/Application/Cms/Api/Requests/UpdateContentTypeRequest.php
 create mode 100644 src/Application/Cms/Api/V1/ContentTypesController.php
 create mode 100644 src/Application/Cms/Api/V1/ContentsController.php
 create mode 100644 src/Application/Console/Commands/Design/GenerateTokensCommand.php
 create mode 100644 src/Application/Console/Commands/Design/LintTokensCommand.php
 create mode 100644 src/Application/Console/Commands/Design/ValidateTokensCommand.php
 create mode 100644 src/Application/LiveComponents/Dashboard/DockerContainersComponent.php
 create mode 100644 src/Application/LiveComponents/Dashboard/DockerContainersState.php
 create mode 100644 src/Application/LiveComponents/Dashboard/HealthStatusComponent.php
 create mode 100644 src/Application/LiveComponents/Dashboard/HealthStatusState.php
 create mode 100644 src/Application/LiveComponents/Dashboard/PerformanceMetricsComponent.php
 create mode 100644 src/Application/LiveComponents/Dashboard/PerformanceMetricsState.php
 create mode 100644 src/Application/LiveComponents/Notification/NotificationComponent.php
 create mode 100644 src/Application/LiveComponents/Notification/NotificationState.php
 create mode 100644 src/Domain/Asset/Commands/ProcessDerivatCommand.php
 create mode 100644 src/Domain/Asset/Commands/ProcessDerivatCommandHandler.php
 create mode 100644 src/Domain/Asset/DI/AssetServiceInitializer.php
 create mode 100644 src/Domain/Asset/Entities/Asset.php
 create mode 100644 src/Domain/Asset/Entities/AssetTag.php
 create mode 100644 src/Domain/Asset/Entities/AssetVariant.php
 create mode 100644 src/Domain/Asset/Exceptions/AssetNotFoundException.php
 create mode 100644 src/Domain/Asset/Migrations/CreateAssetTagsTable.php
 create mode 100644 src/Domain/Asset/Migrations/CreateAssetVariantsTable.php
 create mode 100644 src/Domain/Asset/Migrations/CreateAssetsTable.php
 create mode 100644 src/Domain/Asset/Pipeline/DerivatPipelineInterface.php
 create mode 100644 src/Domain/Asset/Pipeline/DerivatPipelineRegistry.php
 create mode 100644 src/Domain/Asset/Pipeline/ImageDerivatPipeline.php
 create mode 100644 src/Domain/Asset/README.md
 create mode 100644 src/Domain/Asset/Repositories/AssetRepository.php
 create mode 100644 src/Domain/Asset/Repositories/AssetTagRepository.php
 create mode 100644 src/Domain/Asset/Repositories/AssetVariantRepository.php
 create mode 100644 src/Domain/Asset/Repositories/DatabaseAssetRepository.php
 create mode 100644 src/Domain/Asset/Repositories/DatabaseAssetTagRepository.php
 create mode 100644 src/Domain/Asset/Repositories/DatabaseAssetVariantRepository.php
 create mode 100644 src/Domain/Asset/Services/AssetService.php
 create mode 100644 src/Domain/Asset/Services/DeduplicationService.php
 create mode 100644 src/Domain/Asset/Services/MetadataExtractor.php
 create mode 100644 src/Domain/Asset/Storage/AssetStorageInterface.php
 create mode 100644 src/Domain/Asset/Storage/ObjectStorageAdapter.php
 create mode 100644 src/Domain/Asset/Storage/ObjectStorageAdapterFactory.php
 create mode 100644 src/Domain/Asset/ValueObjects/AssetId.php
 create mode 100644 src/Domain/Asset/ValueObjects/AssetMetadata.php
 create mode 100644 src/Domain/Asset/ValueObjects/ObjectKeyGenerator.php
 create mode 100644 src/Domain/Asset/ValueObjects/VariantName.php
 create mode 100644 src/Domain/Cms/DI/CmsServiceInitializer.php
 create mode 100644 src/Domain/Cms/Entities/Content.php
 create mode 100644 src/Domain/Cms/Entities/ContentTranslation.php
 create mode 100644 src/Domain/Cms/Entities/ContentType.php
 create mode 100644 src/Domain/Cms/Enums/ContentStatus.php
 create mode 100644 src/Domain/Cms/Exceptions/CannotDeleteSystemContentTypeException.php
 create mode 100644 src/Domain/Cms/Exceptions/ContentNotFoundException.php
 create mode 100644 src/Domain/Cms/Exceptions/ContentTypeNotFoundException.php
 create mode 100644 src/Domain/Cms/Exceptions/DuplicateContentTypeSlugException.php
 create mode 100644 src/Domain/Cms/Exceptions/DuplicateSlugException.php
 create mode 100644 src/Domain/Cms/Exceptions/InvalidBlockException.php
 create mode 100644 src/Domain/Cms/Exceptions/InvalidContentStatusException.php
 create mode 100644 src/Domain/Cms/Migrations/CreateContentTranslationsTable.php
 create mode 100644 src/Domain/Cms/Migrations/CreateContentTypesTable.php
 create mode 100644 src/Domain/Cms/Migrations/CreateContentsTable.php
 create mode 100644 src/Domain/Cms/README.md
 create mode 100644 src/Domain/Cms/Rendering/BlockRendererInterface.php
 create mode 100644 src/Domain/Cms/Rendering/BlockRendererRegistry.php
 create mode 100644 src/Domain/Cms/Rendering/DefaultBlockRenderer.php
 create mode 100644 src/Domain/Cms/Rendering/HeroBlockRenderer.php
 create mode 100644 src/Domain/Cms/Rendering/ImageBlockRenderer.php
 create mode 100644 src/Domain/Cms/Rendering/TextBlockRenderer.php
 create mode 100644 src/Domain/Cms/Repositories/ContentRepository.php
 create mode 100644 src/Domain/Cms/Repositories/ContentTranslationRepository.php
 create mode 100644 src/Domain/Cms/Repositories/ContentTypeRepository.php
 create mode 100644 src/Domain/Cms/Repositories/DatabaseContentRepository.php
 create mode 100644 src/Domain/Cms/Repositories/DatabaseContentTranslationRepository.php
 create mode 100644 src/Domain/Cms/Repositories/DatabaseContentTypeRepository.php
 create mode 100644 src/Domain/Cms/Services/BlockTypeRegistry.php
 create mode 100644 src/Domain/Cms/Services/BlockValidator.php
 create mode 100644 src/Domain/Cms/Services/ContentLocalizationService.php
 create mode 100644 src/Domain/Cms/Services/ContentRenderer.php
 create mode 100644 src/Domain/Cms/Services/ContentService.php
 create mode 100644 src/Domain/Cms/Services/ContentTypeService.php
 create mode 100644 src/Domain/Cms/Services/SlugGenerator.php
 create mode 100644 src/Domain/Cms/ValueObjects/BlockData.php
 create mode 100644 src/Domain/Cms/ValueObjects/BlockId.php
 create mode 100644 src/Domain/Cms/ValueObjects/BlockSettings.php
 create mode 100644 src/Domain/Cms/ValueObjects/BlockType.php
 create mode 100644 src/Domain/Cms/ValueObjects/ContentBlock.php
 create mode 100644 src/Domain/Cms/ValueObjects/ContentBlocks.php
 create mode 100644 src/Domain/Cms/ValueObjects/ContentId.php
 create mode 100644 src/Domain/Cms/ValueObjects/ContentSlug.php
 create mode 100644 src/Domain/Cms/ValueObjects/ContentTypeId.php
 create mode 100644 src/Domain/Cms/ValueObjects/Locale.php
 create mode 100644 src/Framework/Admin/Attributes/AdminPage.php
 create mode 100644 src/Framework/Admin/Attributes/AdminSection.php
 create mode 100644 src/Framework/Console/Animation/Animation.php
 create mode 100644 src/Framework/Console/Animation/AnimationBuilder.php
 create mode 100644 src/Framework/Console/Animation/AnimationFactory.php
 create mode 100644 src/Framework/Console/Animation/AnimationFrame.php
 create mode 100644 src/Framework/Console/Animation/AnimationManager.php
 create mode 100644 src/Framework/Console/Animation/AnimationState.php
 create mode 100644 src/Framework/Console/Animation/CompositeAnimation.php
 create mode 100644 src/Framework/Console/Animation/EasingFunction.php
 create mode 100644 src/Framework/Console/Animation/KeyframeAnimation.php
 create mode 100644 src/Framework/Console/Animation/TextAnimation.php
 create mode 100644 src/Framework/Console/Animation/TuiAnimationRenderer.php
 create mode 100644 src/Framework/Console/Animation/Types/BaseAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/FadeAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/MarqueeAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/PulseAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/SlideAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/SpinnerAnimation.php
 create mode 100644 src/Framework/Console/Animation/Types/TypewriterAnimation.php
 create mode 100644 src/Framework/Console/Ansi/AnsiSequenceGenerator.php
 create mode 100644 src/Framework/Console/Ansi/LinkFormatter.php
 create mode 100644 src/Framework/Console/Ansi/RgbColor.php
 create mode 100644 src/Framework/Console/Commands/CodeQualityScanCommand.php
 create mode 100644 src/Framework/Console/Commands/DatabaseBrowserCommand.php
 create mode 100644 src/Framework/Console/Components/EventBuffer.php
 create mode 100644 src/Framework/Console/Components/EventLoop/EventLoop.php
 create mode 100644 src/Framework/Console/Components/EventLoop/EventLoopConfig.php
 create mode 100644 src/Framework/Console/Components/Handlers/KeyboardEventHandler.php
 create mode 100644 src/Framework/Console/Components/Handlers/MouseEventHandler.php
 create mode 100644 src/Framework/Console/Components/Parsers/KeyboardEventParser.php
 create mode 100644 src/Framework/Console/Components/Parsers/MouseEventParser.php
 create mode 100644 src/Framework/Console/Examples/AnimationDemoCommand.php
 create mode 100644 src/Framework/Console/Exceptions/CommandExecutionException.php
 create mode 100644 src/Framework/Console/Exceptions/CommandMetadataNotFoundException.php
 create mode 100644 src/Framework/Console/Exceptions/ConsoleInitializationException.php
 create mode 100644 src/Framework/Console/Exceptions/DuplicateCommandException.php
 create mode 100644 src/Framework/Console/Exceptions/InvalidCommandConfigurationException.php
 create mode 100644 src/Framework/Console/InteractivePrompter.php
 create mode 100644 src/Framework/Console/Layout/Adapters/DisplayComponentAdapter.php
 create mode 100644 src/Framework/Console/Layout/Adapters/ThemeMapper.php
 create mode 100644 src/Framework/Console/Layout/Components/Footer.php
 create mode 100644 src/Framework/Console/Layout/Components/Header.php
 create mode 100644 src/Framework/Console/Layout/Components/ProgressSection.php
 create mode 100644 src/Framework/Console/Layout/Components/Sidebar.php
 create mode 100644 src/Framework/Console/Layout/Components/StatusIndicator.php
 create mode 100644 src/Framework/Console/Layout/DashboardLayout.php
 create mode 100644 src/Framework/Console/Layout/Examples/LayoutExamples.php
 create mode 100644 src/Framework/Console/Layout/Helpers/DisplayComponentHelper.php
 create mode 100644 src/Framework/Console/Layout/Interactive/CollapsibleSection.php
 create mode 100644 src/Framework/Console/Layout/Interactive/Tabs.php
 create mode 100644 src/Framework/Console/Layout/LayoutContainer.php
 create mode 100644 src/Framework/Console/Layout/LayoutFactory.php
 create mode 100644 src/Framework/Console/Layout/LayoutInterface.php
 create mode 100644 src/Framework/Console/Layout/LayoutRenderer.php
 create mode 100644 src/Framework/Console/Layout/Navigation/Breadcrumbs.php
 create mode 100644 src/Framework/Console/Layout/Navigation/NavigationMenu.php
 create mode 100644 src/Framework/Console/Layout/PageLayout.php
 create mode 100644 src/Framework/Console/Layout/Panel.php
 create mode 100644 src/Framework/Console/Layout/Section.php
 create mode 100644 src/Framework/Console/Layout/SectionLayout.php
 create mode 100644 src/Framework/Console/Layout/SimpleLayout.php
 create mode 100644 src/Framework/Console/Layout/ValueObjects/GridConfig.php
 create mode 100644 src/Framework/Console/Layout/ValueObjects/LayoutOptions.php
 create mode 100644 src/Framework/Console/Layout/ValueObjects/PanelSize.php
 create mode 100644 src/Framework/Console/Layout/ValueObjects/SectionStyle.php
 create mode 100644 src/Framework/Console/Terminal/OscMode.php
 create mode 100644 src/Framework/Console/Terminal/PhpStormDetector.php
 create mode 100644 src/Framework/Console/Terminal/TerminalCapabilities.php
 create mode 100644 src/Framework/Console/Terminal/Utf8Support.php
 create mode 100644 src/Framework/Console/Terminal/WindowTitleManager.php
 create mode 100644 src/Framework/Console/TextWriter.php
 create mode 100644 src/Framework/Core/ValueObjects/LineNumber.php
 create mode 100644 src/Framework/Core/ValueObjects/ReturnType.php
 create mode 100644 src/Framework/Core/ValueObjects/ReturnTypeValue.php
 create mode 100644 src/Framework/Database/Browser/Discovery/DatabaseDiscovery.php
 create mode 100644 src/Framework/Database/Browser/Discovery/SchemaDiscovery.php
 create mode 100644 src/Framework/Database/Browser/Discovery/TableDiscovery.php
 create mode 100644 src/Framework/Database/Browser/Registry/DatabaseRegistry.php
 create mode 100644 src/Framework/Database/Browser/Registry/TableRegistry.php
 create mode 100644 src/Framework/Database/Browser/ValueObjects/ColumnMetadata.php
 create mode 100644 src/Framework/Database/Browser/ValueObjects/DatabaseMetadata.php
 create mode 100644 src/Framework/Database/Browser/ValueObjects/ForeignKeyMetadata.php
 create mode 100644 src/Framework/Database/Browser/ValueObjects/IndexMetadata.php
 create mode 100644 src/Framework/Database/Browser/ValueObjects/TableMetadata.php
 create mode 100644 src/Framework/Design/Ast/CssAstBuilder.php
 create mode 100644 src/Framework/Design/Ast/CssAstNode.php
 create mode 100644 src/Framework/Design/Ast/CssComment.php
 create mode 100644 src/Framework/Design/Ast/CssCustomProperty.php
 create mode 100644 src/Framework/Design/Ast/CssLayer.php
 create mode 100644 src/Framework/Design/Ast/CssMediaQuery.php
 create mode 100644 src/Framework/Design/Ast/CssRule.php
 create mode 100644 src/Framework/Design/Ast/CssStylesheet.php
 create mode 100644 src/Framework/Design/Ast/CssSupports.php
 create mode 100644 src/Framework/Design/Database/DesignTokenEntity.php
 create mode 100644 src/Framework/Design/Linters/TokenLinter.php
 create mode 100644 src/Framework/Design/Migrations/CreateDesignTokensTable.php
 create mode 100644 src/Framework/Design/Repositories/DatabaseTokenRepository.php
 create mode 100644 src/Framework/Design/Services/ColorManipulator.php
 create mode 100644 src/Framework/Design/Validators/TokenValidator.php
 create mode 100644 src/Framework/Design/ValueObjects/ColorPalette.php
 create mode 100644 src/Framework/Design/ValueObjects/ColorVariation.php
 create mode 100644 src/Framework/Design/ValueObjects/ContrastResult.php
 create mode 100644 src/Framework/Design/ValueObjects/FrameworkTokenRegistry.php
 create mode 100644 src/Framework/Design/ValueObjects/HybridTokenRegistry.php
 create mode 100644 src/Framework/Design/ValueObjects/LintIssue.php
 create mode 100644 src/Framework/Design/ValueObjects/LintResult.php
 create mode 100644 src/Framework/Design/ValueObjects/StateMutation.php
 create mode 100644 src/Framework/Design/ValueObjects/Theme.php
 create mode 100644 src/Framework/Design/ValueObjects/ThemeRegistry.php
 create mode 100644 src/Framework/Design/ValueObjects/TokenRegistry.php
 create mode 100644 src/Framework/Design/ValueObjects/TokenState.php
 create mode 100644 src/Framework/Design/ValueObjects/TokenStateRegistry.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/ColorToken.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/SpacingToken.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/StatefulColorToken.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/StatefulTokenInterface.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/TokenInterface.php
 create mode 100644 src/Framework/Design/ValueObjects/Tokens/TypographyToken.php
 create mode 100644 src/Framework/Design/ValueObjects/ValidationError.php
 create mode 100644 src/Framework/Design/ValueObjects/ValidationResult.php
 create mode 100644 src/Framework/Design/ValueObjects/ValidationWarning.php
 create mode 100644 src/Framework/Display/Components/ComponentFactory.php
 create mode 100644 src/Framework/Display/Components/Console/Badge.php
 create mode 100644 src/Framework/Display/Components/Console/Card.php
 create mode 100644 src/Framework/Display/Components/Console/CodeBlock.php
 create mode 100644 src/Framework/Display/Components/Console/Divider.php
 create mode 100644 src/Framework/Display/Components/Console/ListItem.php
 create mode 100644 src/Framework/Display/Components/Console/Stats.php
 create mode 100644 src/Framework/Display/Components/Console/Table.php
 create mode 100644 src/Framework/Display/Components/Console/TextBox.php
 create mode 100644 src/Framework/Display/Components/Console/TreeHelper.php
 create mode 100644 src/Framework/Display/Components/DisplayComponentInterface.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlBadge.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlCard.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlCodeBlock.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlDivider.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlListItem.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlStats.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlTable.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlTextBox.php
 create mode 100644 src/Framework/Display/Components/Html/HtmlTreeHelper.php
 create mode 100644 src/Framework/Display/Formatters/ArrayFormatter.php
 create mode 100644 src/Framework/Display/Formatters/AutoFormatter.php
 create mode 100644 src/Framework/Display/Formatters/ClassFormatter.php
 create mode 100644 src/Framework/Display/Formatters/CodeFormatter.php
 create mode 100644 src/Framework/Display/Formatters/CsvFormatter.php
 create mode 100644 src/Framework/Display/Formatters/FilesystemFormatter.php
 create mode 100644 src/Framework/Display/Formatters/JsonFormatter.php
 create mode 100644 src/Framework/Display/Formatters/ObjectFormatter.php
 create mode 100644 src/Framework/Display/Formatters/XmlFormatter.php
 create mode 100644 src/Framework/Display/Formatters/YamlFormatter.php
 create mode 100644 src/Framework/Display/Inspectors/ArrayInspector.php
 create mode 100644 src/Framework/Display/Inspectors/ClassInspector.php
 create mode 100644 src/Framework/Display/Inspectors/FilesystemInspector.php
 create mode 100644 src/Framework/Display/Inspectors/ObjectInspector.php
 create mode 100644 src/Framework/Display/README.md
 create mode 100644 src/Framework/Display/Renderers/ConsoleRenderer.php
 create mode 100644 src/Framework/Display/Renderers/HtmlRenderer.php
 create mode 100644 src/Framework/Display/Themes/ConsoleTheme.php
 create mode 100644 src/Framework/Display/Themes/DefaultConsoleThemes.php
 create mode 100644 src/Framework/Display/Themes/DefaultHtmlThemes.php
 create mode 100644 src/Framework/Display/Themes/DefaultThemes.php
 create mode 100644 src/Framework/Display/Themes/HtmlTheme.php
 create mode 100644 src/Framework/Display/Themes/ThemeRegistry.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/ByteFormatter.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/ClassNameFormatter.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/EmailFormatter.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/FilePathFormatter.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/TimestampFormatter.php
 create mode 100644 src/Framework/Display/ValueObjectFormatters/ValueObjectFormatterInterface.php
 create mode 100644 src/Framework/Display/ValueObjectRegistry/DefaultValueObjectFormatterRegistry.php
 create mode 100644 src/Framework/Display/ValueObjectRegistry/ValueObjectFormatterRegistry.php
 create mode 100644 src/Framework/Display/ValueObjects/ArrayStructure.php
 create mode 100644 src/Framework/Display/ValueObjects/BracketStyle.php
 create mode 100644 src/Framework/Display/ValueObjects/ClassStructure.php
 create mode 100644 src/Framework/Display/ValueObjects/ColorDepth.php
 create mode 100644 src/Framework/Display/ValueObjects/ConstantInfo.php
 create mode 100644 src/Framework/Display/ValueObjects/DirectoryStructure.php
 create mode 100644 src/Framework/Display/ValueObjects/DisplayOptions.php
 create mode 100644 src/Framework/Display/ValueObjects/DisplayRules.php
 create mode 100644 src/Framework/Display/ValueObjects/FileEntry.php
 create mode 100644 src/Framework/Display/ValueObjects/IndentStyle.php
 create mode 100644 src/Framework/Display/ValueObjects/MethodInfo.php
 create mode 100644 src/Framework/Display/ValueObjects/ObjectStructure.php
 create mode 100644 src/Framework/Display/ValueObjects/OutputFormat.php
 create mode 100644 src/Framework/Display/ValueObjects/PropertyInfo.php
 create mode 100644 src/Framework/Display/ValueObjects/RenderContext.php
 create mode 100644 src/Framework/Display/ValueObjects/SeparatorStyle.php
 delete mode 100644 src/Framework/ErrorHandling/CliErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/DummyTemplateRenderer.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorHandlerInitializer.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorHandlerManager.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorHandlerRegistry.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorHandlingResult.php
 delete mode 100644 src/Framework/ErrorHandling/ErrorLogger.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/DatabaseErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/ErrorHandlerInterface.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/ErrorHandlerPriority.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/FallbackErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/HandlerRegistration.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/HandlerResult.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/HttpErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/Handlers/ValidationErrorHandler.php
 delete mode 100644 src/Framework/ErrorHandling/SecurityAlertManager.php
 delete mode 100644 src/Framework/ErrorHandling/SecurityEventHandler.php
 delete mode 100644 src/Framework/ErrorHandling/SecurityEventLogger.php
 delete mode 100644 src/Framework/ErrorHandling/StackTrace.php
 delete mode 100644 src/Framework/ErrorHandling/Templates/debug.view.php
 delete mode 100644 src/Framework/ErrorHandling/Templates/production-minimal.view.php
 delete mode 100644 src/Framework/ErrorHandling/Templates/production.view.php
 delete mode 100644 src/Framework/ErrorHandling/TraceItem.php
 delete mode 100644 src/Framework/ErrorHandling/ValueObjects/ErrorMetadata.php
 delete mode 100644 src/Framework/ErrorHandling/View/ApiErrorRenderer.php
 delete mode 100644 src/Framework/ErrorHandling/View/ErrorResponseFactory.php
 delete mode 100644 src/Framework/ErrorHandling/View/ErrorTemplateRenderer.php
 delete mode 100644 src/Framework/ErrorHandling/View/ErrorViewRendererInterface.php
 delete mode 100644 src/Framework/ErrorHandling/fallback.html
 create mode 100644 src/Framework/ExceptionHandling/Aggregation/DiscoveryWarning.php
 create mode 100644 src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningAggregator.php
 create mode 100644 src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningGroup.php
 create mode 100644 src/Framework/ExceptionHandling/Audit/ExceptionAuditLogger.php
 create mode 100644 src/Framework/ExceptionHandling/BasicErrorHandler.php
 create mode 100644 src/Framework/ExceptionHandling/BasicGlobalExceptionHandler.php
 create mode 100644 src/Framework/ExceptionHandling/BasicShutdownHandler.php
 create mode 100644 src/Framework/ExceptionHandling/Context/ExceptionContextBuilder.php
 create mode 100644 src/Framework/ExceptionHandling/Context/ExceptionContextCache.php
 create mode 100644 src/Framework/ExceptionHandling/Correlation/ExceptionCorrelation.php
 create mode 100644 src/Framework/ExceptionHandling/Correlation/ExceptionCorrelationEngine.php
 create mode 100644 src/Framework/ExceptionHandling/ErrorSeverityType.php
 create mode 100644 src/Framework/ExceptionHandling/ExceptionHandlerManagerFactory.php
 create mode 100644 src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php
 create mode 100644 src/Framework/ExceptionHandling/FatalErrorTypes.php
 create mode 100644 src/Framework/ExceptionHandling/Health/ExceptionHealthChecker.php
 create mode 100644 src/Framework/ExceptionHandling/Localization/ExceptionLocalizer.php
 create mode 100644 src/Framework/ExceptionHandling/Metrics/ExceptionMetrics.php
 create mode 100644 src/Framework/ExceptionHandling/Metrics/ExceptionMetricsCollector.php
 create mode 100644 src/Framework/ExceptionHandling/Metrics/PrometheusExporter.php
 create mode 100644 src/Framework/ExceptionHandling/Middleware/ErrorScopeMiddleware.php
 create mode 100644 src/Framework/ExceptionHandling/PatternDetection/ExceptionPattern.php
 create mode 100644 src/Framework/ExceptionHandling/PatternDetection/ExceptionPatternDetector.php
 create mode 100644 src/Framework/ExceptionHandling/PatternDetection/FixSuggestion.php
 create mode 100644 src/Framework/ExceptionHandling/Performance/ExceptionPerformanceMetrics.php
 create mode 100644 src/Framework/ExceptionHandling/Performance/ExceptionPerformanceTracker.php
 create mode 100644 src/Framework/ExceptionHandling/RateLimit/ExceptionFingerprint.php
 create mode 100644 src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimitConfig.php
 create mode 100644 src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimiter.php
 create mode 100644 src/Framework/ExceptionHandling/Recovery/ExceptionRecoveryManager.php
 create mode 100644 src/Framework/ExceptionHandling/Recovery/RetryStrategy.php
 create mode 100644 src/Framework/ExceptionHandling/Renderers/ConsoleErrorRenderer.php
 create mode 100644 src/Framework/ExceptionHandling/Reporter/ReporterRegistry.php
 create mode 100644 src/Framework/ExceptionHandling/Serialization/ExceptionSerializer.php
 create mode 100644 src/Framework/ExceptionHandling/Translation/ExceptionMessageTranslator.php
 create mode 100644 src/Framework/ExceptionHandling/Translation/UserFriendlyMessage.php
 create mode 100644 src/Framework/ExceptionHandling/ValueObjects/StackItem.php
 create mode 100644 src/Framework/ExceptionHandling/ValueObjects/StackTrace.php
 create mode 100644 src/Framework/Icon/Icon.php
 create mode 100644 src/Framework/Icon/IconRegistry.php
 create mode 100644 src/Framework/Icon/IconType.php
 create mode 100644 src/Framework/LiveComponents/ValueObjects/LiveComponentError.php
 create mode 100644 src/Framework/MagicLinks/MagicLinkService.php
 create mode 100644 src/Framework/MagicLinks/ValueObjects/ActionResult.php
 create mode 100644 src/Framework/MagicLinks/ValueObjects/MagicLinkData.php
 create mode 100644 src/Framework/MagicLinks/ValueObjects/MagicLinkToken.php
 create mode 100644 src/Framework/MagicLinks/ValueObjects/TokenAction.php
 create mode 100644 src/Framework/MagicLinks/ValueObjects/TokenConfig.php
 create mode 100644 src/Framework/Mfa/Exceptions/MfaException.php
 create mode 100644 src/Framework/Mfa/MfaInitializer.php
 create mode 100644 src/Framework/Mfa/MfaProvider.php
 create mode 100644 src/Framework/Mfa/MfaSecretFactory.php
 create mode 100644 src/Framework/Mfa/MfaService.php
 create mode 100644 src/Framework/Mfa/Providers/TotpProvider.php
 create mode 100644 src/Framework/Mfa/ValueObjects/MfaChallenge.php
 create mode 100644 src/Framework/Mfa/ValueObjects/MfaCode.php
 create mode 100644 src/Framework/Mfa/ValueObjects/MfaMethod.php
 create mode 100644 src/Framework/Mfa/ValueObjects/MfaSecret.php
 create mode 100644 src/Framework/Pcntl/Exceptions/PcntlException.php
 create mode 100644 src/Framework/Pcntl/Integration/AsyncForkBridge.php
 create mode 100644 src/Framework/Pcntl/PcntlInitializer.php
 create mode 100644 src/Framework/Pcntl/PcntlService.php
 create mode 100644 src/Framework/Pcntl/ProcessForker.php
 create mode 100644 src/Framework/Pcntl/ProcessManager.php
 create mode 100644 src/Framework/Pcntl/SignalHandler.php
 create mode 100644 src/Framework/Pcntl/ValueObjects/ForkResult.php
 create mode 100644 src/Framework/Pcntl/ValueObjects/ProcessId.php
 create mode 100644 src/Framework/Pcntl/ValueObjects/ProcessStatus.php
 create mode 100644 src/Framework/Pcntl/ValueObjects/Signal.php
 create mode 100644 src/Framework/Pcntl/WorkerPool.php
 create mode 100644 src/Framework/Posix/Exceptions/PosixException.php
 create mode 100644 src/Framework/Posix/PosixServiceInitializer.php
 create mode 100644 src/Framework/Posix/Services/InMemoryPosixService.php
 create mode 100644 src/Framework/Posix/Services/NativePosixService.php
 create mode 100644 src/Framework/Posix/Services/PosixService.php
 create mode 100644 src/Framework/Posix/ValueObjects/GroupId.php
 create mode 100644 src/Framework/Posix/ValueObjects/GroupInfo.php
 create mode 100644 src/Framework/Posix/ValueObjects/GroupName.php
 create mode 100644 src/Framework/Posix/ValueObjects/ProcessId.php
 create mode 100644 src/Framework/Posix/ValueObjects/ProcessInfo.php
 create mode 100644 src/Framework/Posix/ValueObjects/ResourceLimit.php
 create mode 100644 src/Framework/Posix/ValueObjects/ResourceType.php
 create mode 100644 src/Framework/Posix/ValueObjects/Signal.php
 create mode 100644 src/Framework/Posix/ValueObjects/UserId.php
 create mode 100644 src/Framework/Posix/ValueObjects/UserInfo.php
 create mode 100644 src/Framework/Posix/ValueObjects/UserName.php
 create mode 100644 src/Framework/Quality/CodeQuality/CodeQualityRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/CodeQualityScanner.php
 create mode 100644 src/Framework/Quality/CodeQuality/Results/CodeQualityReport.php
 create mode 100644 src/Framework/Quality/CodeQuality/Results/RuleViolation.php
 create mode 100644 src/Framework/Quality/CodeQuality/Rules/DisallowInheritanceRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/Rules/FinalClassRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/Rules/ReadonlyGetterRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/Rules/ReadonlyPropertyRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/Rules/RequireStringableImplementationRule.php
 create mode 100644 src/Framework/Quality/CodeQuality/TokenizerClassInspector.php
 create mode 100644 src/Framework/Quality/CodeQuality/ValueObjects/ClassInspection.php
 create mode 100644 src/Framework/Quality/CodeQuality/ValueObjects/SourceClassMetadata.php
 delete mode 100644 src/Framework/Reflection/Async/AsyncReflectionProcessor.php
 delete mode 100644 src/Framework/Reflection/BatchOperations/README.md
 delete mode 100644 src/Framework/Reflection/BatchOperations/ReflectionBatchProcessor.php
 delete mode 100644 src/Framework/Reflection/Builder/README.md
 delete mode 100644 src/Framework/Reflection/Builder/ReflectionBuilder.php
 delete mode 100644 src/Framework/Reflection/Builder/ReflectionBuilderFactory.php
 create mode 100644 src/Framework/Reflection/ClassInfo.php
 create mode 100644 src/Framework/Reflection/Collections/AttributeCollection.php
 create mode 100644 src/Framework/Reflection/Collections/ParameterCollection.php
 delete mode 100644 src/Framework/Reflection/LazyReflectionProxy.php
 create mode 100644 src/Framework/Reflection/MethodInfo.php
 delete mode 100644 src/Framework/Reflection/Monitoring/ReflectionMetrics.php
 create mode 100644 src/Framework/Reflection/ParameterInfo.php
 create mode 100644 src/Framework/Reflection/ReflectionService.php
 create mode 100644 src/Framework/Reflection/SimpleReflectionService.php
 delete mode 100644 src/Framework/Reflection/Strategies/CacheWarmupStrategy.php
 delete mode 100644 src/Framework/Reflection/Strategies/MemoryAwareCacheStrategy.php
 rename src/Framework/{Reflection => ReflectionLegacy}/Cache/ClassCache.php (96%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Cache/MetadataCacheManager.php (99%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Cache/MethodCache.php (89%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Cache/ParameterCache.php (97%)
 rename src/Framework/{Reflection => ReflectionLegacy}/CachedReflectionProvider.php (97%)
 create mode 100644 src/Framework/ReflectionLegacy/Collections/MethodCollection.php
 create mode 100644 src/Framework/ReflectionLegacy/Collections/PropertyCollection.php
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/AttributeReflector.php (95%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/CacheManager.php (86%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/ClassReflector.php (74%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/EnumReflector.php (98%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/InstantiationReflector.php (98%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/MethodReflector.php (75%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/ParameterReflector.php (97%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/PropertyReflector.php (95%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Contracts/ReflectionCache.php (90%)
 rename src/Framework/{Reflection => ReflectionLegacy}/EVALUATION.md (78%)
 create mode 100644 src/Framework/ReflectionLegacy/README.md
 rename src/Framework/{Reflection => ReflectionLegacy}/ReflectionCache.php (93%)
 rename src/Framework/{Reflection => ReflectionLegacy}/SUMMARY.md (100%)
 rename src/Framework/{Reflection => ReflectionLegacy}/Support/AttributeHandler.php (90%)
 create mode 100644 src/Framework/ReflectionLegacy/WrappedReflectionAttribute.php
 rename src/Framework/{Reflection => ReflectionLegacy}/WrappedReflectionParameter.php (94%)
 create mode 100644 src/Framework/Sockets/Exceptions/SocketBindException.php
 create mode 100644 src/Framework/Sockets/Exceptions/SocketConnectException.php
 create mode 100644 src/Framework/Sockets/Exceptions/SocketException.php
 create mode 100644 src/Framework/Sockets/Exceptions/SocketListenException.php
 create mode 100644 src/Framework/Sockets/Exceptions/SocketReadException.php
 create mode 100644 src/Framework/Sockets/Integration/AsyncSocketServer.php
 create mode 100644 src/Framework/Sockets/Integration/PcntlSocketServer.php
 create mode 100644 src/Framework/Sockets/SocketClient.php
 create mode 100644 src/Framework/Sockets/SocketConnection.php
 create mode 100644 src/Framework/Sockets/SocketConnectionPool.php
 create mode 100644 src/Framework/Sockets/SocketFactory.php
 create mode 100644 src/Framework/Sockets/SocketServer.php
 create mode 100644 src/Framework/Sockets/SocketService.php
 create mode 100644 src/Framework/Sockets/SocketsInitializer.php
 create mode 100644 src/Framework/Sockets/ValueObjects/SocketAddress.php
 create mode 100644 src/Framework/Sockets/ValueObjects/SocketOption.php
 create mode 100644 src/Framework/Sockets/ValueObjects/SocketProtocol.php
 create mode 100644 src/Framework/Sockets/ValueObjects/SocketResource.php
 create mode 100644 src/Framework/Sockets/ValueObjects/SocketType.php
 create mode 100644 src/Framework/Ssh/Adapters/ProcessSftpClient.php
 create mode 100644 src/Framework/Ssh/Adapters/ProcessSshClient.php
 create mode 100644 src/Framework/Ssh/Contracts/SftpClient.php
 create mode 100644 src/Framework/Ssh/Contracts/SshClient.php
 create mode 100644 src/Framework/Ssh/Exceptions/SftpClientException.php
 create mode 100644 src/Framework/Ssh/Exceptions/SftpTransferException.php
 create mode 100644 src/Framework/Ssh/Exceptions/SshClientException.php
 create mode 100644 src/Framework/Ssh/Exceptions/SshCommandFailedException.php
 create mode 100644 src/Framework/Ssh/Exceptions/SshRateLimitExceededException.php
 create mode 100644 src/Framework/Ssh/SftpTransferExecutor.php
 create mode 100644 src/Framework/Ssh/SshCommandExecutor.php
 create mode 100644 src/Framework/Ssh/SshInitializer.php
 create mode 100644 src/Framework/Ssh/Support/SshAuthenticationContext.php
 create mode 100644 src/Framework/Ssh/Support/SshCommandBuilder.php
 create mode 100644 src/Framework/Ssh/Support/SshProcessCommand.php
 create mode 100644 src/Framework/Ssh/ValueObjects/AgentAuthentication.php
 create mode 100644 src/Framework/Ssh/ValueObjects/PasswordAuthentication.php
 create mode 100644 src/Framework/Ssh/ValueObjects/PrivateKeyAuthentication.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SftpDirectoryEntry.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SftpOperationRequest.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SftpPath.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SftpTransferDirection.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SftpTransferRequest.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshAuditContext.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshAuthenticationMethod.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshAuthenticationType.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshCommand.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshCommandRequest.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshCommandResult.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshConnectionConfig.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshEnvironmentVariable.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshHost.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshHostKeyFingerprint.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshPort.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshRateLimitPolicy.php
 create mode 100644 src/Framework/Ssh/ValueObjects/SshUsername.php
 create mode 100644 src/Framework/String/ValueObjects/AlphanumericString.php
 create mode 100644 src/Framework/String/ValueObjects/HexadecimalString.php
 create mode 100644 src/Framework/String/ValueObjects/NumericString.php
 create mode 100644 src/Framework/String/ValueObjects/PosixAlphaString.php
 create mode 100644 src/Framework/String/ValueObjects/PosixString.php
 create mode 100644 src/Framework/String/ValueObjects/PosixWordString.php
 create mode 100644 src/Framework/String/ValueObjects/PrintableString.php
 create mode 100644 src/Framework/String/ValueObjects/TypedString.php
 create mode 100644 src/Framework/String/ValueObjects/TypedStringValidator.php
 create mode 100644 src/Framework/Tokenizer/MetadataCollector.php
 create mode 100644 src/Framework/Tokenizer/ValueObjects/TokenMetadata.php
 create mode 100644 src/Framework/View/Table/Generators/DatabaseMetadataTableGenerator.php
 create mode 100644 src/Framework/View/Table/Generators/DatabaseTableGenerator.php
 create mode 100644 src/Framework/View/templates/livecomponent-docker-containers.view.php
 create mode 100644 src/Framework/View/templates/livecomponent-health-status.view.php
 create mode 100644 src/Framework/View/templates/livecomponent-notification.view.php
 create mode 100644 src/Framework/View/templates/livecomponent-performance-metrics.view.php
 create mode 100644 storage/cache/0c96ac1a57b063550dff9e96c6ad11c2.lock
 create mode 100644 storage/cache/5e7426f884af5ff2e38a71a018a93b72.lock
 delete mode 100644 test-hot-reload.html
 create mode 100644 tests/Framework/MagicLinks/MagicLinksValueObjectsTest.php
 create mode 100644 tests/Framework/Mfa/MfaServiceTest.php
 create mode 100644 tests/Integration/ExceptionAuditIntegrationTest.php
 delete mode 100644 tests/Unit/ErrorHandling/ErrorHandlerAggregatorIntegrationTest.php
 delete mode 100644 tests/Unit/ErrorHandling/ErrorHandlerFullPipelineTest.php
 delete mode 100644 tests/Unit/Framework/ErrorHandling/ErrorHandlerManagerTest.php
 delete mode 100644 tests/Unit/Framework/ErrorHandling/Handlers/DatabaseErrorHandlerTest.php
 delete mode 100644 tests/Unit/Framework/ErrorHandling/Handlers/FallbackErrorHandlerTest.php
 delete mode 100644 tests/Unit/Framework/ErrorHandling/Handlers/HttpErrorHandlerTest.php
 delete mode 100644 tests/Unit/Framework/ErrorHandling/Handlers/ValidationErrorHandlerTest.php
 create mode 100644 tests/Unit/Framework/ExceptionHandling/Audit/ExceptionAuditLoggerTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/PosixAlphaStringTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/PosixStringTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/PosixWordStringTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/SpecializedStringVOsTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/TypedStringTest.php
 create mode 100644 tests/Unit/Framework/String/ValueObjects/TypedStringValidatorTest.php
 create mode 100644 tests/debug/test-auth-capture.php
 delete mode 100644 tests/debug/test-enhanced-error-page.php
 delete mode 100644 tests/debug/test-error-aggregator-debug-2.php
 delete mode 100644 tests/debug/test-error-aggregator-debug.php
 delete mode 100644 tests/debug/test-error-context-system.php
 delete mode 100644 tests/debug/test-error-handler-enhancements.php
 delete mode 100644 tests/debug/test-error-handling-module.php
 delete mode 100644 tests/debug/test-error-pipeline-debug.php
 delete mode 100644 tests/debug/test-error-reporting-config.php
 create mode 100644 tests/debug/test-reflection-performance.php
 create mode 100644 tests/debug/test_token_classification.php

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..d2baa86e
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,27 @@
+# Ensure shell scripts use LF line endings
+*.sh text eol=lf
+docker/**/*.sh text eol=lf
+**/*.sh text eol=lf
+
+# PHP files
+*.php text eol=lf
+
+# Configuration files
+*.yml text eol=lf
+*.yaml text eol=lf
+*.json text eol=lf
+*.conf text eol=lf
+*.ini text eol=lf
+
+# Docker files
+Dockerfile* text eol=lf
+docker-compose*.yml text eol=lf
+*.dockerfile text eol=lf
+
+# Scripts
+*.bash text eol=lf
+*.zsh text eol=lf
+
+# Default for text files
+* text=auto
+
diff --git a/.gitea/workflows/build-image.yml b/.gitea/workflows/build-image.yml
index 0ed14ec1..dc8aa205 100644
--- a/.gitea/workflows/build-image.yml
+++ b/.gitea/workflows/build-image.yml
@@ -96,7 +96,7 @@ jobs:
           chmod +x /tmp/ci-tools/clone_repo.sh
 
       - name: Upload CI helpers as artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v3
         with:
           name: ci-helpers
           path: /tmp/ci-tools/clone_repo.sh
@@ -242,7 +242,7 @@ jobs:
           echo "needs_runtime_build=$RUNTIME_BUILD" >> "$GITHUB_OUTPUT"
 
       - name: Upload repository as artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v3
         with:
           name: repository
           path: /workspace/repo
@@ -270,7 +270,7 @@ jobs:
 
       - name: Download CI helpers from artifact
         if: ${{ steps.decision.outputs.should_build == 'true' }}
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: ci-helpers
           path: /tmp/ci-tools
@@ -316,7 +316,7 @@ jobs:
 
       - name: Download repository artifact
         if: steps.decision.outputs.should_build == 'true'
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: repository
           path: /workspace
@@ -499,7 +499,7 @@ jobs:
     runs-on: php-ci
     steps:
       - name: Download CI helpers from artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: ci-helpers
           path: /tmp/ci-tools
@@ -529,7 +529,7 @@ jobs:
           chmod +x /tmp/ci-tools/clone_repo.sh
 
       - name: Download repository artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: repository
           path: /workspace
@@ -605,7 +605,7 @@ jobs:
 
       - name: Download CI helpers from artifact
         if: ${{ env.SHOULD_BUILD == 'true' }}
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: ci-helpers
           path: /tmp/ci-tools
@@ -636,7 +636,7 @@ jobs:
 
       - name: Download repository artifact
         if: ${{ env.SHOULD_BUILD == 'true' }}
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: repository
           path: /workspace
@@ -987,7 +987,7 @@ jobs:
 
       - name: Upload repository as artifact
         if: ${{ env.SHOULD_BUILD == 'true' }}
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v3
         with:
           name: repository
           path: /workspace/repo
@@ -1023,7 +1023,7 @@ jobs:
           echo "📋 Branch: $REF_NAME"
 
       - name: Download repository artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: repository
           path: /workspace
@@ -1182,7 +1182,7 @@ jobs:
           echo "📋 Branch: $REF_NAME"
 
       - name: Download repository artifact
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v3
         with:
           name: repository
           path: /workspace
diff --git a/.gitea/workflows/manual-deploy.yml b/.gitea/workflows/manual-deploy.yml
index bb56b775..5e015be4 100644
--- a/.gitea/workflows/manual-deploy.yml
+++ b/.gitea/workflows/manual-deploy.yml
@@ -124,33 +124,14 @@ jobs:
             chmod 600 /tmp/vault_pass
           fi
 
-      - name: Deploy Application Code to Staging
+      - name: Deploy to Staging (Complete)
         run: |
           cd /workspace/repo/deployment/ansible
           ansible-playbook -i inventory/production.yml \
-            playbooks/deploy-application-code.yml \
+            playbooks/deploy-complete.yml \
             -e "deployment_environment=staging" \
             -e "deployment_hosts=production" \
             -e "git_branch=${{ steps.branch.outputs.BRANCH }}" \
-            --vault-password-file /tmp/vault_pass \
-            --private-key ~/.ssh/production
-
-      - name: Install Composer Dependencies
-        run: |
-          cd /workspace/repo/deployment/ansible
-          ansible-playbook -i inventory/production.yml \
-            playbooks/install-composer-dependencies.yml \
-            -e "deployment_environment=staging" \
-            --vault-password-file /tmp/vault_pass \
-            --private-key ~/.ssh/production
-
-      - name: Deploy Docker Image to Staging
-        run: |
-          cd /workspace/repo/deployment/ansible
-          ansible-playbook -i inventory/production.yml \
-            playbooks/deploy-image.yml \
-            -e "deployment_environment=staging" \
-            -e "deployment_hosts=production" \
             -e "image_tag=${{ needs.determine-image.outputs.image_tag }}" \
             -e "docker_registry=${{ needs.determine-image.outputs.registry_host }}" \
             -e "docker_registry_username=${{ secrets.REGISTRY_USER }}" \
@@ -164,15 +145,24 @@ jobs:
       - name: Health check
         id: health
         run: |
-          for i in {1..10}; do
-            if curl -f -k https://staging.michaelschiemer.de/health; then
-              echo "✅ Health check passed"
+          echo "🔍 Performing health checks with exponential backoff..."
+          DELAY=2
+          MAX_DELAY=60
+          MAX_ATTEMPTS=5
+          
+          for i in $(seq 1 $MAX_ATTEMPTS); do
+            if curl -f -k -s https://staging.michaelschiemer.de/health > /dev/null 2>&1; then
+              echo "✅ Health check passed (attempt $i/$MAX_ATTEMPTS)"
               exit 0
             fi
-            echo "⏳ Waiting for staging service... (attempt $i/10)"
-            sleep 10
+            if [ $i -lt $MAX_ATTEMPTS ]; then
+              echo "⏳ Waiting for staging service... (attempt $i/$MAX_ATTEMPTS, delay ${DELAY}s)"
+              sleep $DELAY
+              DELAY=$((DELAY * 2))
+              [ $DELAY -gt $MAX_DELAY ] && DELAY=$MAX_DELAY
+            fi
           done
-          echo "❌ Health check failed"
+          echo "❌ Health check failed after $MAX_ATTEMPTS attempts"
           exit 1
 
       - name: Notify deployment success
@@ -187,6 +177,9 @@ jobs:
     needs: determine-image
     if: inputs.environment == 'production'
     runs-on: ubuntu-latest
+    concurrency:
+      group: deploy-production
+      cancel-in-progress: false
     environment:
       name: production
       url: https://michaelschiemer.de
@@ -243,33 +236,14 @@ jobs:
             chmod 600 /tmp/vault_pass
           fi
 
-      - name: Deploy Application Code to Production
+      - name: Deploy to Production (Complete)
         run: |
           cd /workspace/repo/deployment/ansible
           ansible-playbook -i inventory/production.yml \
-            playbooks/deploy-application-code.yml \
+            playbooks/deploy-complete.yml \
             -e "deployment_environment=production" \
             -e "deployment_hosts=production" \
             -e "git_branch=${{ steps.branch.outputs.BRANCH }}" \
-            --vault-password-file /tmp/vault_pass \
-            --private-key ~/.ssh/production
-
-      - name: Install Composer Dependencies
-        run: |
-          cd /workspace/repo/deployment/ansible
-          ansible-playbook -i inventory/production.yml \
-            playbooks/install-composer-dependencies.yml \
-            -e "deployment_environment=production" \
-            --vault-password-file /tmp/vault_pass \
-            --private-key ~/.ssh/production
-
-      - name: Deploy Docker Image to Production
-        run: |
-          cd /workspace/repo/deployment/ansible
-          ansible-playbook -i inventory/production.yml \
-            playbooks/deploy-image.yml \
-            -e "deployment_environment=production" \
-            -e "deployment_hosts=production" \
             -e "image_tag=${{ needs.determine-image.outputs.image_tag }}" \
             -e "docker_registry=${{ needs.determine-image.outputs.registry_host }}" \
             -e "docker_registry_username=${{ secrets.REGISTRY_USER }}" \
@@ -283,15 +257,24 @@ jobs:
       - name: Health check
         id: health
         run: |
-          for i in {1..10}; do
-            if curl -f -k https://michaelschiemer.de/health; then
-              echo "✅ Health check passed"
+          echo "🔍 Performing health checks with exponential backoff..."
+          DELAY=2
+          MAX_DELAY=60
+          MAX_ATTEMPTS=5
+          
+          for i in $(seq 1 $MAX_ATTEMPTS); do
+            if curl -f -k -s https://michaelschiemer.de/health > /dev/null 2>&1; then
+              echo "✅ Health check passed (attempt $i/$MAX_ATTEMPTS)"
               exit 0
             fi
-            echo "⏳ Waiting for production service... (attempt $i/10)"
-            sleep 10
+            if [ $i -lt $MAX_ATTEMPTS ]; then
+              echo "⏳ Waiting for production service... (attempt $i/$MAX_ATTEMPTS, delay ${DELAY}s)"
+              sleep $DELAY
+              DELAY=$((DELAY * 2))
+              [ $DELAY -gt $MAX_DELAY ] && DELAY=$MAX_DELAY
+            fi
           done
-          echo "❌ Health check failed"
+          echo "❌ Health check failed after $MAX_ATTEMPTS attempts"
           exit 1
 
       - name: Notify deployment success
diff --git a/.gitea/workflows/monitor-performance.yml b/.gitea/workflows/monitor-performance.yml
index da3fd095..0fa92da9 100644
--- a/.gitea/workflows/monitor-performance.yml
+++ b/.gitea/workflows/monitor-performance.yml
@@ -80,7 +80,7 @@ jobs:
           fi
 
       - name: Upload metrics as artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v3
         with:
           name: workflow-metrics
           path: /tmp/combined_metrics.json
diff --git a/.gitignore b/.gitignore
index bcf2ed52..d1057000 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,6 @@
 # Editor / IDE
 .idea/
+.vscode/
 
 # System
 .DS_Store
@@ -68,5 +69,13 @@ secrets/*.txt
 !secrets/*.example
 deployment/ansible/secrets/local.vault.yml
 
+# Ansible Vault password files and generated password backups
+deployment/ansible/secrets/.vault_pass
+deployment/ansible/secrets/.vault-passwords.txt
+deployment/ansible/secrets/production.vault.yml
+
 # SSL/TLS certificates
 **/acme.json
+
+# Documentation backups
+backups/docs-backup-*/
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
index 6cd1f12b..4192ab56 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -6,6 +6,7 @@ This file provides comprehensive guidance for AI agents (like Claude Code, Curso
 
 ## Quick Reference
 
+- **Permission Requirement**: Obtain explicit approval from the project owner before making any code changes
 - **Framework**: Custom PHP Framework (PHP 8.5+)
 - **Local URL**: https://localhost (HTTPS required)
 - **Docker**: Use `make up` to start containers
@@ -405,18 +406,21 @@ final readonly class DatabaseConfig
 ## Additional Documentation
 
 For detailed information, see:
+- `docs/claude/README.md` - AI-specific documentation overview
 - `docs/claude/guidelines.md` - Detailed coding guidelines
 - `docs/claude/architecture.md` - Architecture documentation
 - `docs/claude/development-commands.md` - Command reference
-- `docs/claude/common-workflows.md` - Common development workflows
-- `docs/claude/error-handling.md` - Error handling patterns
-- `docs/claude/security-patterns.md` - Security patterns
+- `docs/guides/common-workflows.md` - Common development workflows
+- `docs/features/error-handling/guide.md` - Error handling patterns
+- `docs/features/security/patterns.md` - Security patterns
 - `docs/claude/mcp-integration.md` - MCP integration details
-- And other files in `docs/claude/`
+- `docs/README.md` - Main framework documentation
+- And other files in `docs/claude/` and `docs/`
 
 ## Quick Checklist for AI Agents
 
 Before making changes:
+- [ ] Obtain explicit permission from the project owner before modifying any code
 - [ ] Follow framework principles (no inheritance, readonly, final, immutable)
 - [ ] Use Value Objects instead of primitives/arrays
 - [ ] Place test files in `tests/` directory
diff --git a/CLAUDE.md b/CLAUDE.md
index 15a8f52c..9a0f2b6f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,16 +10,16 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 @docs/claude/scheduler-queue-pipeline-persona.md
 @docs/claude/magiclinks-system.md
 @docs/claude/guidelines.md
-@docs/claude/common-workflows.md
-@docs/claude/error-handling.md
-@docs/claude/security-patterns.md
-@docs/claude/queue-system.md
-@docs/claude/event-system.md
+@docs/guides/common-workflows.md
+@docs/features/error-handling/guide.md
+@docs/features/security/patterns.md
+@docs/features/queue/system.md
+@docs/features/events/system.md
 @docs/claude/async-components.md
 @docs/claude/console-commands.md
-@docs/claude/database-patterns.md
+@docs/features/database/patterns.md
 @docs/claude/performance-monitoring.md
-@docs/claude/troubleshooting.md
+@docs/guides/troubleshooting.md
 
 ## MCP Server Integration 🤖
 
diff --git a/CODEX.md b/CODEX.md
new file mode 100644
index 00000000..cd9d727d
--- /dev/null
+++ b/CODEX.md
@@ -0,0 +1,8 @@
+# Codex Agent Reference
+
+Codex agents should follow `AGENTS.md` for the full project rule set. Additional Codex-oriented guidance lives in `docs/codex/guidelines.md`.
+
+- Always secure explicit approval from the project owner before modifying any files.
+- Adhere to the workflow and tooling requirements documented in the Codex guidelines.
+
+Keep this file in sync with updates to `docs/codex/guidelines.md` and the broader agent documentation.
diff --git a/Dockerfile.production b/Dockerfile.production
index c1723474..f4bb1567 100644
--- a/Dockerfile.production
+++ b/Dockerfile.production
@@ -1,6 +1,6 @@
 # Production Dockerfile - Multi-Stage Build
 
-ARG PHP_VERSION=8.5.0RC3
+ARG PHP_VERSION=8.5.0RC4
 # Override via --build-arg PHP_VERSION=8.5.0RCX to track upstream releases
 ARG RUNTIME_IMAGE=runtime-base
 
@@ -57,7 +57,7 @@ COPY tsconfig.json ./
 RUN npm run build
 
 # Stage: Runtime Base Image (shared)
-ARG PHP_VERSION=8.5.0RC3
+ARG PHP_VERSION=8.5.0RC4
 FROM php:${PHP_VERSION}-fpm AS runtime-base
 
 # Install system dependencies + nginx for production
diff --git a/Makefile b/Makefile
index f690696e..4c33ab83 100644
--- a/Makefile
+++ b/Makefile
@@ -158,6 +158,10 @@ help: ## Zeigt diese Hilfe an
 console: ## Run console commands (Usage: make console ARGS="command arguments")
 	docker exec -it php php console.php $(ARGS)
 
+design-tokens: ## Generate design tokens CSS from PHP
+	@echo "🎨 Generating design tokens..."
+	docker exec php php console.php design:generate-tokens
+
 
 
 composer: ## Use Composer
diff --git a/composer.json b/composer.json
index 5b58b3c3..95872001 100644
--- a/composer.json
+++ b/composer.json
@@ -53,8 +53,7 @@
     },
     "suggest": {
       "ext-apcu": "For better caching performance (not yet available for PHP 8.5)",
-      "ext-redis": "For Redis cache driver support (not yet available for PHP 8.5)",
-      "ext-zend-opcache": "For improved performance (built-in for PHP 8.5)"
+      "ext-redis": "For Redis cache driver support (not yet available for PHP 8.5)"
     },
 
   "scripts": {
diff --git a/console.php b/console.php
index 6fe50511..5752f125 100755
--- a/console.php
+++ b/console.php
@@ -5,6 +5,9 @@ declare(strict_types=1);
 require_once __DIR__ . '/vendor/autoload.php';
 require __DIR__ . '/src/Framework/Debug/helpers.php';
 
+putenv('APP_BASE_PATH=' . __DIR__);
+$_ENV['APP_BASE_PATH'] = __DIR__;
+
 // Detect MCP Server mode early (before any logging initialization)
 // This allows LoggerInitializer to use NullHandler and suppress all output
 if (in_array('mcp:server', $argv, true)) {
diff --git a/deployment/README.md b/deployment/README.md
index 73f157cf..b0250ed5 100644
--- a/deployment/README.md
+++ b/deployment/README.md
@@ -68,6 +68,8 @@ Developer → git push
 
 ## Directory Structure
 
+### Local Repository Structure
+
 ```
 deployment/
 ├── ansible/                   # Ansible config, playbooks, inventory, templates
@@ -90,6 +92,22 @@ deployment/
 └── README.md (dieses Dokument)
 ```
 
+### Server Directory Structure
+
+Auf dem Production-Server existieren zwei Hauptverzeichnisse:
+
+```
+/home/deploy/
+├── deployment/          # Infrastructure-as-Code (24M)
+│   ├── stacks/         # Docker Compose Stacks
+│   └── backups/        # Backup-Dateien
+└── michaelschiemer/    # Application Code (491M)
+    ├── current/        # Symlink → Aktuelle deployed Version
+    └── .archive/       # Alte Versionen (Rollback)
+```
+
+**📖 Detaillierte Erklärung:** Siehe [docs/server-directory-structure.md](docs/server-directory-structure.md)
+
 ## Getting Started
 
 ### 🧪 Pipeline-Tests vorbereiten
diff --git a/deployment/ansible/README.md b/deployment/ansible/README.md
index 75c09c4d..05546405 100644
--- a/deployment/ansible/README.md
+++ b/deployment/ansible/README.md
@@ -328,7 +328,7 @@ All zentralen Variablen werden in `group_vars/production.yml` gepflegt und könn
 |----------|--------------|--------------|
 | `deploy_user_home` | Home-Verzeichnis des Deploy-Users | `/home/deploy` |
 | `stacks_base_path` | Basispfad für Docker Compose Stacks | `/home/deploy/deployment/stacks` |
-| `app_stack_path` | Pfad zum Application Stack | `/home/deploy/deployment/stacks/application` |
+| `app_stack_path` | Pfad zum Application Stack | `/home/deploy/deployment/stacks/production` |
 | `backups_path` | Ablageort für Deployment-Backups | `/home/deploy/deployment/backups` |
 | `docker_registry` | Interner Registry-Endpunkt (lokal) | `localhost:5000` |
 | `docker_registry_external` | Externer Registry-Endpunkt | `registry.michaelschiemer.de` |
diff --git a/deployment/ansible/ansible.cfg b/deployment/ansible/ansible.cfg
index 50001550..521abfe1 100644
--- a/deployment/ansible/ansible.cfg
+++ b/deployment/ansible/ansible.cfg
@@ -10,6 +10,8 @@ fact_caching = jsonfile
 fact_caching_connection = /tmp/ansible_facts
 fact_caching_timeout = 3600
 roles_path = roles
+stdout_callback = default_with_clean_msg
+callback_plugins = ./callback_plugins
 
 [ssh_connection]
 pipelining = True
diff --git a/deployment/ansible/callback_plugins/README.md b/deployment/ansible/callback_plugins/README.md
new file mode 100644
index 00000000..77536830
--- /dev/null
+++ b/deployment/ansible/callback_plugins/README.md
@@ -0,0 +1,282 @@
+# Ansible Callback Plugin - default_with_clean_msg
+
+**Stand:** 2025-11-07  
+**Status:** Dokumentation des Custom Callback Plugins
+
+---
+
+## Übersicht
+
+Das `default_with_clean_msg` Callback Plugin erweitert Ansible's Standard-Output mit verbesserter Formatierung für multiline `msg` Felder. Multiline Nachrichten werden als lesbare Blöcke mit Borders angezeigt, anstatt als escaped Newline-Zeichen.
+
+**Datei:** `deployment/ansible/callback_plugins/default_with_clean_msg.py`
+
+---
+
+## Zweck
+
+### Problem
+
+Ansible's Standard Callback Plugin zeigt multiline `msg` Felder so an:
+```
+"msg": "Line 1\nLine 2\nLine 3"
+```
+
+Dies macht es schwierig, multiline Debug-Ausgaben zu lesen und zu kopieren.
+
+### Lösung
+
+Das Custom Plugin formatiert multiline Nachrichten als lesbare Blöcke:
+```
+================================================================================
+Line 1
+Line 2
+Line 3
+================================================================================
+```
+
+---
+
+## Funktionalität
+
+### Multiline Message Formatting
+
+**Automatische Erkennung:**
+- Nur Nachrichten mit mehr als einer Zeile werden formatiert
+- Einzeilige Nachrichten bleiben unverändert
+
+**Format:**
+- Border oben und unten (aus `=` Zeichen)
+- Maximale Border-Breite: 80 Zeichen
+- Farbcodierung entsprechend Task-Status
+
+### Method Overrides
+
+Das Plugin überschreibt folgende Methoden des Default Callbacks:
+
+- `v2_playbook_on_task_start` - Task Start
+- `v2_runner_on_start` - Runner Start
+- `v2_runner_on_ok` - Erfolgreiche Tasks
+- `v2_runner_on_failed` - Fehlgeschlagene Tasks
+- `v2_runner_on_skipped` - Übersprungene Tasks
+- `v2_runner_on_unreachable` - Unerreichbare Hosts
+
+**Grund:** Diese Methoden werden überschrieben, um Warnings zu vermeiden, die auftreten, wenn `get_option()` vor der vollständigen Initialisierung aufgerufen wird.
+
+---
+
+## Konfiguration
+
+### ansible.cfg
+
+**Datei:** `deployment/ansible/ansible.cfg`
+
+```ini
+[defaults]
+stdout_callback = default_with_clean_msg
+callback_plugins = ./callback_plugins
+```
+
+**Wichtig:**
+- `stdout_callback` aktiviert das Plugin als Standard-Output
+- `callback_plugins` gibt den Pfad zu den Plugin-Dateien an
+
+### Plugin-Datei
+
+**Pfad:** `deployment/ansible/callback_plugins/default_with_clean_msg.py`
+
+**Struktur:**
+- Erbt von `ansible.plugins.callback.default.CallbackModule`
+- Überschreibt spezifische Methoden
+- Fügt `_print_clean_msg()` Methode hinzu
+
+---
+
+## Verwendung
+
+### Automatisch
+
+Das Plugin wird automatisch verwendet, wenn `ansible.cfg` korrekt konfiguriert ist:
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
+```
+
+### Manuell
+
+Falls das Plugin nicht automatisch geladen wird:
+
+```bash
+ansible-playbook \
+  --callback-plugin ./callback_plugins \
+  --stdout-callback default_with_clean_msg \
+  -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml
+```
+
+---
+
+## Beispiel-Ausgabe
+
+### Vorher (Standard Callback)
+
+```
+ok: [server] => {
+    "msg": "Container Status:\nNAME               IMAGE                             COMMAND                  SERVICE   CREATED              STATUS                            PORTS\nproduction-php-1   localhost:5000/framework:latest   \"/usr/local/bin/entr…\"   php       About a minute ago   Restarting (255) 13 seconds ago"
+}
+```
+
+### Nachher (Custom Callback)
+
+```
+ok: [server] => {
+================================================================================
+Container Status:
+NAME               IMAGE                             COMMAND                  SERVICE   CREATED              STATUS                            PORTS
+production-php-1   localhost:5000/framework:latest   "/usr/local/bin/entr…"   php       About a minute ago   Restarting (255) 13 seconds ago
+================================================================================
+}
+```
+
+---
+
+## Bekannte Limitationen
+
+### Warnings bei Option Access
+
+**Problem:** Frühere Versionen des Plugins riefen `get_option()` auf, bevor Ansible's Optionen vollständig initialisiert waren, was zu Warnings führte:
+
+```
+[WARNING]: Failure using method (v2_playbook_on_task_start) in callback plugin: 'display_skipped_hosts'
+```
+
+**Lösung:** Das Plugin überschreibt die problematischen Methoden direkt, ohne `get_option()` aufzurufen.
+
+### Option-Checks
+
+**Aktuell:** Das Plugin zeigt immer alle Hosts an (ok, changed, skipped), ohne Option-Checks.
+
+**Grund:** Option-Checks würden `get_option()` erfordern, was Warnings verursacht.
+
+**Workaround:** Falls Option-Checks benötigt werden, können sie nach vollständiger Initialisierung implementiert werden.
+
+---
+
+## Technische Details
+
+### Inheritance
+
+```python
+from ansible.plugins.callback.default import CallbackModule as DefaultCallbackModule
+
+class CallbackModule(DefaultCallbackModule):
+    CALLBACK_NAME = 'default_with_clean_msg'
+    
+    def _print_clean_msg(self, result, color=C.COLOR_VERBOSE):
+        # Custom formatting logic
+```
+
+**Vorteil:** Erbt alle Standard-Funktionalität und erweitert nur die Formatierung.
+
+### Method Overrides
+
+**Warum Overrides?**
+
+Die Standard-Methoden rufen `get_option()` auf, um zu prüfen, ob bestimmte Hosts angezeigt werden sollen. Dies schlägt fehl, wenn Optionen noch nicht initialisiert sind.
+
+**Lösung:** Direkte Implementierung ohne Option-Checks:
+
+```python
+def v2_runner_on_ok(self, result):
+    # Eigene Implementierung ohne get_option()
+    # ...
+    self._print_clean_msg(result, color=color)
+```
+
+---
+
+## Entwicklung
+
+### Plugin testen
+
+```bash
+# Plugin-Verzeichnis
+cd deployment/ansible/callback_plugins
+
+# Syntax prüfen
+python3 -m py_compile default_with_clean_msg.py
+
+# Mit Ansible testen
+cd ..
+ansible-playbook -i inventory/production.yml playbooks/check-container-status.yml
+```
+
+### Plugin erweitern
+
+**Neue Formatierung hinzufügen:**
+
+1. `_print_clean_msg()` Methode erweitern
+2. Neue Formatierungslogik implementieren
+3. Tests durchführen
+
+**Beispiel:**
+```python
+def _print_clean_msg(self, result, color=C.COLOR_VERBOSE):
+    msg_body = result._result.get('msg')
+    if isinstance(msg_body, str) and msg_body.strip():
+        # Custom formatting logic here
+        # ...
+```
+
+---
+
+## Troubleshooting
+
+### Plugin wird nicht geladen
+
+**Problem:** Plugin wird nicht verwendet, Standard-Output bleibt
+
+**Lösung:**
+1. `ansible.cfg` prüfen:
+   ```ini
+   stdout_callback = default_with_clean_msg
+   callback_plugins = ./callback_plugins
+   ```
+
+2. Plugin-Datei prüfen:
+   ```bash
+   ls -la deployment/ansible/callback_plugins/default_with_clean_msg.py
+   ```
+
+3. Syntax prüfen:
+   ```bash
+   python3 -m py_compile default_with_clean_msg.py
+   ```
+
+### Warnings erscheinen
+
+**Problem:** Warnings wie `'display_skipped_hosts'`
+
+**Lösung:** Plugin-Version prüfen - sollte Method Overrides ohne `get_option()` verwenden.
+
+**Aktueller Stand:** Plugin verwendet direkte Overrides ohne Option-Checks.
+
+---
+
+## Referenz
+
+- [Ansible Callback Plugins Documentation](https://docs.ansible.com/ansible/latest/plugins/callback.html)
+- [Ansible Callback Development Guide](https://docs.ansible.com/ansible/latest/dev_guide/developing_plugins.html#callback-plugins)
+- [Initial Deployment Troubleshooting](../docs/troubleshooting/initial-deployment-issues.md) - Problem 8: Ansible Debug Messages
+
+---
+
+## Changelog
+
+### 2025-11-07
+- Initial Version erstellt
+- Multiline Message Formatting implementiert
+- Method Overrides ohne Option-Checks
+- Warnings behoben
+
diff --git a/deployment/ansible/callback_plugins/__pycache__/default_with_clean_msg.cpython-311.pyc b/deployment/ansible/callback_plugins/__pycache__/default_with_clean_msg.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95aca6742251248ac04dbafa3db73c9ddbae0295
GIT binary patch
literal 10237
zcmd5?TWlLwdY<8Rc#%j;lp{NqJ=VnvWs9<{Y!d5gS(n(dEZ?17t-X^GXCzVLML9F_
zg`l!tAP?HY4?^I=Zr1^rAQxq$VAUc;-NhCKirv>@h8RG?00so~rFm1~wkZ76|C}L*
zLsGKkq6_rs=y1-Q^Z)aopXYr4W%x~1m6w9@AyXZjVkzohai>t6`HSZ_;NlS_Py!vN
z67&R}uua$!_6a*piH-@UV4HBkm_6=JFcTgc&vV4R3EzaDrfk&vl;He?5?rGHYdb}K
z2meNy@Coj#RG9e@cf)o)z)wo4_<}5QvBZ1|$vPv%ZpWlpDydh`qgYbrrWTS>8T$Me
zG(~w?C`mpccCmsu#V^EV?oLde;i7SoPjU%qnoN-I&BFvq7E%i`xgpH}YfccQD2mNv
zW+pj1kd$JRagl`~QB1NxF~1<Qm?=w`vI%%dEFMdWY(kVIep-|W%iAKtQgXZ?h(Z@T
z6O-f=ibeT28MQu&+`w{QgGnq@c}6TqUw9tS#V7gb96OalEN_U^J|E}rO{P+FhBRVw
zhEGOC!DLq<7$#2evK&iJN7xG$VzaR%3mRglVq#p7SRRQcD<LM~hlv8qOUAN~u}I_v
z9&2VYo{G+a;7Lh_TWo5I1wHcfFgYpSA&QC4@Q9Dfppl3-OzWO#3g+@jS%OaWV18*A
zQo=%9jOO<N`LN|X&o9BnBTA$uXn~rr3G{>=c9%nR&bkWIr)a_c2|eK!9G_4V4BlH4
z9>E2zSMUoAjQ9i(^!$Ps+A6^Zd#nn%fja#SStZfEcvlvauypGeU}~Ox<pm{Ie(P4{
z5{}y|xD_<qYEdz}3)MylKYj1^J34Bf9as%Mo4Eh{IOy&Xm7!;$W0Wi$kIEv@U&H<H
z%&|qgTsYq_Ib)Yi4O7(D!1KGpcS51fj6Lh9<OuWN=6B`*`j_3!%UYgm5|{B>bjVf3
zv5ccscEL7B<Ux<*KyeoA3o7FnD&tg2x#-L|1xKDbEjZ;pMS2)<m99Juk}kS3)U2m4
zD@)L_&?|fj?u;u9os4ajDdj*DiEbTSbibNQ#=RZ=gG0NZbP4XAo-cT=Qsw_)Z~AMp
z)i4-c!r)rD&G9*B`3ej$ki`I^$rKXEQO9g>A!jSW&xt@Rvm!6uW91aV4}da(ji%=B
zSsn!70H;u9r%);ZFgUp|od-bx4}%}e>UKCrKjKXrHFqv_@VDOy|IcqibDpB{37~GZ
zF47q~3wJ6@=}!IKUfFV%GG!;@2K9)hsRwTf)K%(RdOU2?ostaZLbu1oB=l^N<GKUG
zorI4F%f8?`W>N{UBM}4m6XP9%c)M^dMQ37SLPT(HKAyUlfaP}NLA|4ZH{5)DVHz+M
z=4@xjBJ=lNczUMAq<D88^`%diqG*IOY@=!RB0T`od|c{_m^AGmrSubM{tf=_Q%b`q
z)Rm#9*ZyhZ_Y?nc^A9(n`&l&G{8zCjF=No$KF7*Lc%?7s-XAeOzo5O}(z-L6il@+c
z*r&TWBuZdpbo;a@>t3+g1oWe#ZU?;~d_r|En3b4Jl!k)%hCRXGg(jBN87_~Ex;uXn
zW^{)n#;0_b!5Hnw6b$SHZZaj@)18Em?gkbdd?mWe*odeGrb!Gmh24W{F=4P=N9jYa
zP+~J?^bTye`_z_~3hjT`w_e+lt8K}OYV9$t_Sh2h%vZNO^OaroHEX`+Ez08=p;zjE
zcks6d)$l1Te9E}95jyZ_{L^tY)U1V?*Fzn-P=^{ip@mK?4L=LiEdS)!=?Ce@1Ap=H
z(#OyCHyAo!8-`D{VN`>5|ERWqblJU8yZ`a!PrH}9HyYTlI<t4yY-&@d*3_vsbS{r<
zgz6t&SPzABq3}xc+TL&5pDrk&uo@cHLc>aEc!O=(qUgE-+Grm;HtG*NsamgZ&(*iD
z2v1v-`gXPcv{rvwA=S$5$lBZG+<+m}ty;WVV};gsGtjW~@n-G8<!)35`rF=G{TFPc
zN0e+i%Ng)0OEFV&3vik_b57Z8+qSb!YgIPeUOqd9d7GzSZ~(fRJ+Pt<5S^4BXkpBh
z0!@{2E{+J!(r2K{0^o7nnQ$$Fhiv6Bi~SH%Y+!K(rqnjwrVv9`j<+x=$qxX}Oxshq
zi$6>8Y<sIzItNx=<a_kb!`Hf2^s8O#EBU|F7mco3zcE;$xeGuNUqN44f8omdDR}<x
zbdYwzHv&7Q=w0C`2<)!qKkOaXoq+ZHJ$(-s=Ovkwd1;QD<daDe0Y;G?j#s!SADt0(
z$F+g0=XC}Ul$XWndjx^Oi>`q%g9C#tq9h;Zrap=$B``^jDTrBg-%JYF&c}eGkoI7D
z_UA3qt#Fm@p5Y~k2M{_2DnQsEpa?V|(85AY0H#Ku5m|r$M~Yys=meg098U^Z#KjSp
z&H&DH_=;dVYQ&RV#zMjlguzpH;N|GmF^K~!FT_aL7AHI<e8Mn58{oX}_DP}?9Nusc
zMG-YX%z)(dTV*J{<4kPZq_05#_o@GMQNcHs<;NeWffg-*!OwGWV_(D4(1X!ufxXMJ
z(r{c2oX`R%@JQQ6OL%EW^Ec*)I@G{%EpQwUwQe*Y!9$0)TvU7Kl0#z}9t%%qRVEBK
z{J{rZTa??={aI_a`OCJIS#|#@Z9jlM+}iN>Dy4NJQ2QXQ1satj@8Nptl6vH_cI2`W
zz;&bb=(0l#HY>sA&DNveEPk>0`7gix<$7yRuC+&P?bBNO%;BciZ+gGz{k;Fn{`IE!
za!v24O<h`37Z#G;V)8OMJY#gZQ25?Uq-yI?p!Qx<+pcSE*OdUS8{ziV{rJI0HiDst
zRqMg#T(CL&^R>7CzV~l?|EB+k{`JnYxz4j{=cv{>s<w=(!Sh=1yi%xJ9{kKLs=VDK
z%qy(}##oHO&*2z>b-<?vRm0`CkQc~rC%m&!7u=KZM05Alz@9)0_ypm-V{DtlmD{Fl
z$~DXf!z!3}hVoP`ISiRh^nf9}ONmT>4K4OAvv8xbl>3g05VH!lIAlmL_RA*TgDtVx
zmQ0ydLMH*Q%&5pZvl#czVQDDzCP-r8T9n92C6w_u&<H3^3s9sZl9@Kf%4OD!bxQ3U
zwrN=tU3cPCj)x_jO+-d4SYWysUx5vL1Grmazasx~UFTP2q0Zu6Q&9wGxjxX;pIhI+
z-;7MN*x{`xf-7Ugc0<PSnJ=^0gC%9vU9R)(=Pf#t;{SuSFx#vJ``)`*i#cx*e6eh(
zKxO^R&>2UiMleo<J>vz-=(`3c=Ug%xUl7C*-ED*plJ16}EIADZu_}MjMT{ca2M<Uy
zsX3z?uG785ddB%lF|Ich3}PYk79n;iW^hMmfEG1C0|pci7#0<qA%xvVy*i(U%*%k@
z#5Y}#7{l4jAO`{oagn>jqa<YLBnT!`sd*rpN2w@e7P*)#CM0wKv%{MMHDPjkP_G)i
zICk+0H+Xhn{Qcn}oiVx>&!aY&5Oxx%L@k(N7&k;p96CuDS^zT(HaAd$nyI<;!Iwd1
zYHkAa_(x)2H|zF2;y&fFH`KagTHUcFFPKA5pThK7D-MpP9>%lhRo`*V2lmwNsRb(t
z_IPFQ>H#g>oeOj;fo`xZ>%mAa7+JZ!nt6I%4GwC-K_xi2;jdX5!F;RMnKyIHn~z7H
zjIWHWj%mmGRpzwDoK~3A8;pOQX~=<9o_dm0nRbn7SD1Een`<8QXubnml+9C{-M2Ee
znp6(=K;7^M*Zqfb{zF-p>TlKjt%|?3@F1Y+TlY2Od<~CdD|M=`L-TcPQC`oX*AhDT
z;KI89aL#`?+p#vPHun9A|6@w=A6ET0H2)37f8$xG?%~Cy;iX}aG8o#uGKzfLR?=$Y
zsXy)c<9@<-O!JQ^{xQsVlyJogGjy^ttS}8Kb5dhYDuqgH+(=1ShV3mea=*8|mXWi=
zLB&S9q5zZwC!@eMF<H1*46Djvtqi=16j(M=c47ETs`5~hn5vzOo++t7ua*Usgw8aI
z1xfIyb%ooQI8&0M@kECNyOjz|+}@oHXgSa12pCBFZ)m{@G^W|yokYK(KXYJEoi)wr
z_69QJkPj9)&YI?GwJaS9TCt%cujVJXOZb^7)@}GvS<~bdCBRxP;qVfPh!J4MM<6uv
zE=VHyfRK_zXb`x)V5WGPj|0G`t8aC&BLnBghKCNby?rbJ{};YUBodoW!poZEbhy^Q
z%(Fm8;2OP;ug>9ygiA$m-&4SE@orQk?~u?ao^~ELW6<bToUo9X&u7J?B8H<2c+_XW
z_VAS}7q94EqjUBAxl0u&u2&K1L=F~|LXsgM_PfgQytV|-r}$VL%w6NlFx{B*G3GV0
zJ+2dg-3fg+eF4pPID6yEn_A1eIp4dA?_GkgZ8?A2$~&t)PwP~Fzvk~({Qa94s1N3t
zgO6`N`4|#T%)wV+_@-}99>E=+o>w6_fcSrJp6pp`TWfnNtoL2Y^<7dff1q9F)V>e3
zz7G|sHT)7-lp=^WeSdlN7QxSM&EKu~yElFHIN}?IAgMU3{qH{dAwy<Cd^M!_hw}Ew
zfY<K_Rxc2M?b4VorBEw_2yAyTB0PWR75G|ACRvf9h@ab_CJs<YDWSkmB*lW7CXyD$
z@TZk(8`QMmcrj`9t3!ef=uG6#BiRo4T7hJD2o9R4x|^gGc90isyG2XHW^6d2w<AuP
zl9$ScpOOZQ#7}x9R@!zzrm`d;u^=Y$m1=&s90<0##zzR6rK_d6*gPb6rVWoZ?ZQab
zA`vVL*PvG;mj$7m90{o31Gyl*1K}|TnHqSJJ(-e3gx~g;ffo8HzDL|lBO*84OaexD
zgPX2ps050L#DGOjFT<kzq`w3<5<|e~6~5o=pidr56yIAbKYM!Q4-uvPEY$6sL4cCY
znnsLi>n&ZmmM*oWM{DU(YkB}a0=4Ubrd*&YJE8`TYJsDG7gc~4!P@1!+2-}ew{wke
zuig0J7i!~>);OfTF{B2EmhDzJ!Ju=Kz)6?p?^66-<!~}a;N+CXoKgz45>D_zCUEl4
zpeCG?n1vfgu^!8!3uXZUOjl8?RNH_6l{G=eN?IO=L(apNv4M+%-9i(9N-2tYjMAe=
zToj-yg3Jy%3cGA^6pGH(s-prLEdW)_0TZ{y%$scg40s!CeTM05ZS#yBGZZBpyagRp
zaxjnfRhW~m1^49o_?6)S2<^^{4HtbBgi}@FYQqH~9*OCP814W$t2n$YJFxm5!?Cb%
z)ob$Z#6l8&(E-6Q{G`Kju8qX4C43}@8*czO-1%f}eaY#z@JYA6?1Wn;t^hwtf#yE-
zI>)#?>Rj?}boQ=wt#v(>*ZVK$`Y$V2eyUyhQ0?cneqMoEJ-K8D7v@1BB8q;$M+^6m
zL)NR2Xf^L=w7tIVhd7il%7>y5jY1`-bv#Uugsb6=CdrO-obKhg1o^cKT>ClhqXj;W
z^XAZVbDWTh!bR2Kz}VQCfx+|K_`ro>!$r&o`ZtEJoVj>)nBXo+ETGe%Idlm(I3`EG
zz|ACX`fyW+8=Oudzjq-GP9jLZh33Bbw`H?C8HmZD@lti|_b+U=M^?ElD&WL#^(xxN
z1}DztTG~E`vkH>Cg~s3L?A)Tv<}6+3?B1eEo5&s~WX#RxNR<=6lH9&EmVwXeIJ~(4
z4Nfh{3kY<EFoq$#BN0X!c*g*5OTgLY5~9pU;gyPn)j4!=@cM<}@oNLu&RrbW-T6cg
z!q{mjxA3c~NdCQhB%1$SQY8NZo+wVQ8!}$Umu~DbMZaKrjPJJ(&BFt*e<6Ji&6b^}
z>8%h&57G*CW~T}Xko#3z4$mG3eC(y@CWUIW)(z^KQd+lMKeN$Tbvu73b#4D{4FAVV
IW)UU-58Ia8Bme*a

literal 0
HcmV?d00001

diff --git a/deployment/ansible/callback_plugins/default_with_clean_msg.py b/deployment/ansible/callback_plugins/default_with_clean_msg.py
new file mode 100644
index 00000000..4d960d9d
--- /dev/null
+++ b/deployment/ansible/callback_plugins/default_with_clean_msg.py
@@ -0,0 +1,181 @@
+# (c) 2012-2014, Michael DeHaan <michael.dehaan@gmail.com>
+# (c) 2017 Ansible Project
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+# Modified to add clean multiline msg formatting
+#
+# This plugin extends the default callback with enhanced multiline message formatting.
+# It suppresses warnings by implementing its own versions of methods that would
+# otherwise call get_option() before options are initialized.
+
+from __future__ import (absolute_import, division, print_function)
+__metaclass__ = type
+
+DOCUMENTATION = '''
+    name: default_with_clean_msg
+    type: stdout
+    short_description: default Ansible screen output with clean multiline messages
+    version_added: historical
+    description:
+        This is the default output callback for ansible-playbook with enhanced
+        multiline message formatting. Multiline messages in msg fields are
+        displayed as clean, readable blocks instead of escaped newline characters.
+'''
+
+from ansible import constants as C
+from ansible.plugins.callback.default import CallbackModule as DefaultCallbackModule
+
+
+class CallbackModule(DefaultCallbackModule):
+    '''
+    This extends the default callback with enhanced multiline message formatting.
+    Multiline messages in 'msg' fields are displayed as clean, readable blocks.
+    '''
+
+    CALLBACK_NAME = 'default_with_clean_msg'
+
+    def _print_clean_msg(self, result, color=C.COLOR_VERBOSE):
+        '''
+        Print multiline messages in a clean, readable format with borders.
+        This makes it easy to read and copy multiline content from debug outputs.
+        '''
+        msg_body = result._result.get('msg')
+        if isinstance(msg_body, str) and msg_body.strip():
+            lines = msg_body.strip().splitlines()
+            if len(lines) > 1:  # Only format if multiline
+                max_len = max(len(line) for line in lines if line.strip())
+                if max_len > 0:
+                    border = "=" * min(max_len, 80)  # Limit border width
+                    self._display.display("\n" + border, color=color)
+                    for line in lines:
+                        self._display.display(line, color=color)
+                    self._display.display(border + "\n", color=color)
+
+    def v2_playbook_on_task_start(self, task, is_conditional):
+        # Suppress warnings by implementing our own version that doesn't call get_option early
+        # Initialize state if needed
+        if not hasattr(self, '_play'):
+            self._play = None
+        if not hasattr(self, '_last_task_banner'):
+            self._last_task_banner = None
+        if not hasattr(self, '_task_type_cache'):
+            self._task_type_cache = {}
+        
+        # Cache task prefix
+        self._task_type_cache[task._uuid] = 'TASK'
+        
+        # Store task name
+        if self._play and hasattr(self._play, 'strategy'):
+            from ansible.utils.fqcn import add_internal_fqcns
+            if self._play.strategy in add_internal_fqcns(('free', 'host_pinned')):
+                self._last_task_name = None
+            else:
+                self._last_task_name = task.get_name().strip()
+        else:
+            self._last_task_name = task.get_name().strip()
+        
+        # Print task banner (only if we should display it)
+        # We skip the parent's check for display_skipped_hosts/display_ok_hosts to avoid warnings
+        if self._play and hasattr(self._play, 'strategy'):
+            from ansible.utils.fqcn import add_internal_fqcns
+            if self._play.strategy not in add_internal_fqcns(('free', 'host_pinned')):
+                self._last_task_banner = task._uuid
+                self._display.banner('TASK [%s]' % task.get_name().strip())
+
+    def v2_runner_on_start(self, host, task):
+        # Suppress warnings by not calling parent if options aren't ready
+        # This method is optional and only shows per-host start messages
+        # We can safely skip it to avoid warnings
+        pass
+
+    def v2_runner_on_ok(self, result):
+        # Suppress warnings by implementing our own version that doesn't call get_option
+        host_label = self.host_label(result)
+        
+        # Handle TaskInclude separately
+        from ansible.playbook.task_include import TaskInclude
+        if isinstance(result._task, TaskInclude):
+            if self._last_task_banner != result._task._uuid:
+                self.v2_playbook_on_task_start(result._task, False)
+            return
+        
+        # Clean results and handle warnings
+        self._clean_results(result._result, result._task.action)
+        self._handle_warnings(result._result)
+        
+        # Handle loop results
+        if result._task.loop and 'results' in result._result:
+            self._process_items(result)
+            return
+        
+        # Determine status and color
+        if result._result.get('changed', False):
+            if self._last_task_banner != result._task._uuid:
+                self.v2_playbook_on_task_start(result._task, False)
+            self._display.display("changed: [%s]" % host_label, color=C.COLOR_CHANGED)
+            color = C.COLOR_CHANGED
+        else:
+            # Always display ok hosts (skip get_option check to avoid warnings)
+            if self._last_task_banner != result._task._uuid:
+                self.v2_playbook_on_task_start(result._task, False)
+            self._display.display("ok: [%s]" % host_label, color=C.COLOR_OK)
+            color = C.COLOR_OK
+        
+        # Add our clean message formatting
+        self._print_clean_msg(result, color=color)
+
+    def v2_runner_on_failed(self, result, ignore_errors=False):
+        # Suppress warnings by implementing our own version
+        host_label = self.host_label(result)
+        self._clean_results(result._result, result._task.action)
+        
+        if self._last_task_banner != result._task._uuid:
+            self.v2_playbook_on_task_start(result._task, False)
+        
+        self._handle_exception(result._result, use_stderr=False)
+        self._handle_warnings(result._result)
+        
+        if result._task.loop and 'results' in result._result:
+            self._process_items(result)
+        else:
+            msg = "fatal: [%s]: FAILED! => %s" % (host_label, self._dump_results(result._result))
+            self._display.display(msg, color=C.COLOR_ERROR)
+        
+        if ignore_errors:
+            self._display.display("...ignoring", color=C.COLOR_SKIP)
+        
+        # Add our clean message formatting
+        self._print_clean_msg(result, color=C.COLOR_ERROR)
+
+    def v2_runner_on_skipped(self, result):
+        # Suppress warnings by implementing our own version
+        # Always display skipped hosts (skip get_option check to avoid warnings)
+        self._clean_results(result._result, result._task.action)
+        
+        if self._last_task_banner != result._task._uuid:
+            self.v2_playbook_on_task_start(result._task, False)
+        
+        if result._task.loop is not None and 'results' in result._result:
+            self._process_items(result)
+        else:
+            msg = "skipping: [%s]" % result._host.get_name()
+            if self._run_is_verbose(result):
+                msg += " => %s" % self._dump_results(result._result)
+            self._display.display(msg, color=C.COLOR_SKIP)
+        
+        # Add our clean message formatting
+        self._print_clean_msg(result, color=C.COLOR_SKIP)
+
+    def v2_runner_on_unreachable(self, result):
+        # Suppress warnings by implementing our own version
+        if self._last_task_banner != result._task._uuid:
+            self.v2_playbook_on_task_start(result._task, False)
+        
+        host_label = self.host_label(result)
+        msg = "fatal: [%s]: UNREACHABLE! => %s" % (host_label, self._dump_results(result._result))
+        self._display.display(msg, color=C.COLOR_UNREACHABLE)
+        
+        if result._task.ignore_unreachable:
+            self._display.display("...ignoring", color=C.COLOR_SKIP)
+        
+        # Add our clean message formatting
+        self._print_clean_msg(result, color=C.COLOR_UNREACHABLE)
diff --git a/deployment/ansible/inventory/group_vars/production.yml b/deployment/ansible/inventory/group_vars/production.yml
deleted file mode 120000
index 81d13b32..00000000
--- a/deployment/ansible/inventory/group_vars/production.yml
+++ /dev/null
@@ -1 +0,0 @@
-../../group_vars/production.yml
\ No newline at end of file
diff --git a/deployment/ansible/inventory/group_vars/production/vault.yml b/deployment/ansible/inventory/group_vars/production/vault.yml
new file mode 120000
index 00000000..962d9c44
--- /dev/null
+++ b/deployment/ansible/inventory/group_vars/production/vault.yml
@@ -0,0 +1 @@
+../../../secrets/production.vault.yml
\ No newline at end of file
diff --git a/deployment/ansible/playbooks/BUILD-INITIAL-IMAGE.md b/deployment/ansible/playbooks/BUILD-INITIAL-IMAGE.md
new file mode 100644
index 00000000..b5ed6533
--- /dev/null
+++ b/deployment/ansible/playbooks/BUILD-INITIAL-IMAGE.md
@@ -0,0 +1,81 @@
+# Build Initial Image - Anleitung
+
+## Übersicht
+
+Dieses Playbook baut das initiale Docker Image für das Framework und pusht es ins lokale Registry (`localhost:5000`).
+
+## Voraussetzungen
+
+1. **Registry muss laufen**: Das Registry muss bereits deployed sein (via `setup-infrastructure.yml`)
+2. **Vault-Passwort**: `vault_docker_registry_password` muss im Vault-File gesetzt sein
+3. **Git-Zugriff**: Der Server muss Zugriff auf das Git-Repository haben
+
+## Verwendung
+
+### Standard (main branch)
+
+```bash
+cd deployment/ansible
+
+ansible-playbook -i inventory/production.yml \
+  playbooks/build-initial-image.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Mit spezifischem Branch
+
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/build-initial-image.yml \
+  --vault-password-file secrets/.vault_pass \
+  -e "build_repo_branch=staging"
+```
+
+### Mit spezifischem Image-Tag
+
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/build-initial-image.yml \
+  --vault-password-file secrets/.vault_pass \
+  -e "build_image_tag=v1.0.0"
+```
+
+## Was das Playbook macht
+
+1. ✅ Lädt Vault-Secrets (Registry-Credentials)
+2. ✅ Klont/aktualisiert das Git-Repository
+3. ✅ Prüft, ob `Dockerfile.production` existiert
+4. ✅ Loggt sich beim Registry ein
+5. ✅ Baut das Docker Image
+6. ✅ Pusht das Image ins Registry
+7. ✅ Verifiziert, dass das Image existiert
+
+## Nach dem Build
+
+Nach erfolgreichem Build kannst du das Application-Stack deployen:
+
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+## Troubleshooting
+
+### Registry-Login schlägt fehl
+
+- Prüfe, ob `vault_docker_registry_password` im Vault-File gesetzt ist
+- Prüfe, ob das Registry läuft: `docker ps | grep registry`
+- Prüfe, ob der Registry erreichbar ist: `curl http://localhost:5000/v2/`
+
+### Dockerfile.production nicht gefunden
+
+- Prüfe, ob der Branch existiert: `git ls-remote --heads <repo-url>`
+- Prüfe, ob `Dockerfile.production` im Repository existiert
+
+### Build schlägt fehl
+
+- Prüfe Docker-Logs auf dem Server
+- Prüfe, ob genug Speicherplatz vorhanden ist: `df -h`
+- Prüfe, ob Docker Buildx installiert ist: `docker buildx version`
+
diff --git a/deployment/ansible/playbooks/README.md b/deployment/ansible/playbooks/README.md
index 06203d06..26b76023 100644
--- a/deployment/ansible/playbooks/README.md
+++ b/deployment/ansible/playbooks/README.md
@@ -2,10 +2,12 @@
 
 ## Verfügbare Playbooks
 
+> **Hinweis**: Die meisten Playbooks wurden in wiederverwendbare Roles refactored. Die Playbooks sind jetzt Wrapper, die die entsprechenden Role-Tasks aufrufen. Dies verbessert Wiederverwendbarkeit, Wartbarkeit und folgt Ansible Best Practices.
+
 ### Infrastructure Setup
 - **`setup-infrastructure.yml`** - Deployed alle Stacks (Traefik, PostgreSQL, Redis, Registry, Gitea, Monitoring, Production)
 - **`setup-production-secrets.yml`** - Deployed Secrets zu Production
-- **`setup-ssl-certificates.yml`** - SSL Certificate Setup
+- **`setup-ssl-certificates.yml`** - SSL Certificate Setup (Wrapper für `traefik` Role, `tasks_from: ssl`)
 - **`setup-wireguard-host.yml`** - WireGuard VPN Setup
 - **`sync-stacks.yml`** - Synchronisiert Stack-Konfigurationen zum Server
 
@@ -14,40 +16,50 @@
 - **`backup.yml`** - Erstellt Backups von PostgreSQL, Application Data, Gitea, Registry
 - **`deploy-image.yml`** - Docker Image Deployment (wird von CI/CD Workflows verwendet)
 
+### Traefik Management (Role-basiert)
+- **`restart-traefik.yml`** - Restart Traefik Container (Wrapper für `traefik` Role, `tasks_from: restart`)
+- **`recreate-traefik.yml`** - Recreate Traefik Container (Wrapper für `traefik` Role, `tasks_from: restart` mit `traefik_restart_action: recreate`)
+- **`deploy-traefik-config.yml`** - Deploy Traefik Configuration Files (Wrapper für `traefik` Role, `tasks_from: config`)
+- **`check-traefik-acme-logs.yml`** - Check Traefik ACME Challenge Logs (Wrapper für `traefik` Role, `tasks_from: logs`)
+- **`setup-ssl-certificates.yml`** - Setup Let's Encrypt SSL Certificates (Wrapper für `traefik` Role, `tasks_from: ssl`)
+
+### Gitea Management (Role-basiert)
+- **`check-and-restart-gitea.yml`** - Check and Restart Gitea if Unhealthy (Wrapper für `gitea` Role, `tasks_from: restart`)
+- **`fix-gitea-runner-config.yml`** - Fix Gitea Runner Configuration (Wrapper für `gitea` Role, `tasks_from: runner` mit `gitea_runner_action: fix`)
+- **`register-gitea-runner.yml`** - Register Gitea Runner (Wrapper für `gitea` Role, `tasks_from: runner` mit `gitea_runner_action: register`)
+- **`update-gitea-config.yml`** - Update Gitea Configuration (Wrapper für `gitea` Role, `tasks_from: config`)
+- **`setup-gitea-initial-config.yml`** - Setup Gitea Initial Configuration (Wrapper für `gitea` Role, `tasks_from: setup`)
+- **`setup-gitea-repository.yml`** - Setup Gitea Repository (Wrapper für `gitea` Role, `tasks_from: repository`)
+
+### Application Deployment (Role-basiert)
+- **`deploy-application-code.yml`** - Deploy Application Code via Git (Wrapper für `application` Role, `tasks_from: deploy_code` mit `application_deployment_method: git`)
+- **`sync-application-code.yml`** - Synchronize Application Code via Rsync (Wrapper für `application` Role, `tasks_from: deploy_code` mit `application_deployment_method: rsync`)
+- **`install-composer-dependencies.yml`** - Install Composer Dependencies (Wrapper für `application` Role, `tasks_from: composer`)
+
+### Application Container Management (Role-basiert)
+- **`check-container-status.yml`** - Check Container Status (Wrapper für `application` Role, `tasks_from: health_check`)
+- **`check-container-logs.yml`** - Check Container Logs (Wrapper für `application` Role, `tasks_from: logs`)
+- **`check-worker-logs.yml`** - Check Worker and Scheduler Logs (Wrapper für `application` Role, `tasks_from: logs` mit `application_logs_check_vendor: true`)
+- **`check-final-status.yml`** - Check Final Container Status (Wrapper für `application` Role, `tasks_from: health_check` mit `application_health_check_final: true`)
+- **`fix-container-issues.yml`** - Fix Container Issues (Wrapper für `application` Role, `tasks_from: containers` mit `application_container_action: fix`)
+- **`fix-web-container.yml`** - Fix Web Container Permissions (Wrapper für `application` Role, `tasks_from: containers` mit `application_container_action: fix-web`)
+- **`recreate-containers-with-env.yml`** - Recreate Containers with Environment Variables (Wrapper für `application` Role, `tasks_from: containers` mit `application_container_action: recreate-with-env`)
+- **`sync-and-recreate-containers.yml`** - Sync and Recreate Containers (Wrapper für `application` Role, `tasks_from: containers` mit `application_container_action: sync-recreate`)
+
 ### Maintenance
+- **`cleanup-all-containers.yml`** - Stoppt und entfernt alle Container, bereinigt Netzwerke und Volumes (für vollständigen Server-Reset)
 - **`system-maintenance.yml`** - System-Updates, Unattended-Upgrades, Docker-Pruning
 - **`troubleshoot.yml`** - Unified Troubleshooting mit Tags
-- **`update-gitea-config.yml`** - Aktualisiert Gitea-Konfiguration und startet neu
 
 ### WireGuard
 - **`generate-wireguard-client.yml`** - Generiert WireGuard Client-Config
 - **`wireguard-routing.yml`** - Konfiguriert WireGuard Routing
 
 ### Initial Deployment
-- **`sync-application-code.yml`** - Rsync-basiertes Code-Sync für Initial Deployment (synchronisiert Code vom lokalen Repository zum Server)
-- **`deploy-application-code.yml`** - Git-basiertes Code-Deployment (für CI/CD und zukünftige Deployments)
-- **`install-composer-dependencies.yml`** - Installiert Composer Dependencies im PHP Container
 - **`build-initial-image.yml`** - Build und Push des initialen Docker Images (für erstes Deployment)
 
-### Code Deployment
-- **`sync-application-code.yml`** - Rsync-basiertes Code-Sync (Initial Deployment)
-- **`deploy-application-code.yml`** - Git-basiertes Code-Deployment (CI/CD)
-- **`deploy-image.yml`** - Docker Image Deployment zu Application Stack
-
-### Troubleshooting & Diagnostics
-- **`check-container-logs.yml`** - Container Logs prüfen (queue-worker, web, scheduler)
-- **`check-container-status.yml`** - Container Status prüfen
-- **`check-final-status.yml`** - Finale Status-Prüfung aller Container
-- **`fix-container-issues.yml`** - Container-Probleme beheben (Composer Dependencies, Permissions)
-- **`fix-web-container.yml`** - Web Container Permissions beheben
-- **`recreate-containers-with-env.yml`** - Container mit env_file neu erstellen
-- **`sync-and-recreate-containers.yml`** - Docker Compose sync und Container recreate
-
 ### CI/CD & Development
 - **`setup-gitea-runner-ci.yml`** - Gitea Runner CI Setup
-- **`setup-gitea-initial-config.yml`** - Gitea Initial Setup (automatisiert via app.ini + CLI)
-- **`setup-gitea-repository.yml`** - Erstellt Repository in Gitea und konfiguriert Git-Remote (automatisiert via API)
-- **`update-gitea-config.yml`** - Aktualisiert Gitea-Konfiguration (Cache, Connection Pooling) zur Behebung von Performance-Problemen
 - **`install-docker.yml`** - Docker Installation auf Server
 
 ## Entfernte/Legacy Playbooks
@@ -59,8 +71,83 @@ Die folgenden Playbooks wurden entfernt, da sie nicht mehr benötigt werden:
 
 ## Verwendung
 
+### Standard-Verwendung
+
 ```bash
 cd deployment/ansible
-ansible-playbook -i inventory/production.yml playbooks/<playbook>.yml
+ansible-playbook -i inventory/production.yml playbooks/<playbook>.yml --vault-password-file secrets/.vault_pass
 ```
 
+### Role-basierte Playbooks
+
+Die meisten Playbooks sind jetzt Wrapper, die Roles verwenden. Die Funktionalität bleibt gleich, aber die Implementierung ist jetzt in wiederverwendbaren Roles organisiert:
+
+**Beispiel: Traefik Restart**
+```bash
+# Alte Methode (funktioniert noch, ruft jetzt aber die Role auf):
+ansible-playbook -i inventory/production.yml playbooks/restart-traefik.yml --vault-password-file secrets/.vault_pass
+
+# Direkte Role-Verwendung (alternative Methode):
+ansible-playbook -i inventory/production.yml -e "traefik_restart_action=restart" -e "traefik_show_status=true" playbooks/restart-traefik.yml
+```
+
+**Beispiel: Gitea Runner Fix**
+```bash
+ansible-playbook -i inventory/production.yml playbooks/fix-gitea-runner-config.yml --vault-password-file secrets/.vault_pass
+```
+
+**Beispiel: Application Code Deployment**
+```bash
+# Git-basiert (Standard):
+ansible-playbook -i inventory/production.yml playbooks/deploy-application-code.yml \
+  -e "deployment_environment=staging" \
+  -e "git_branch=staging" \
+  --vault-password-file secrets/.vault_pass
+
+# Rsync-basiert (für Initial Deployment):
+ansible-playbook -i inventory/production.yml playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Tags verwenden
+
+Viele Playbooks unterstützen Tags für selektive Ausführung:
+
+```bash
+# Nur Traefik-bezogene Tasks:
+ansible-playbook -i inventory/production.yml playbooks/restart-traefik.yml --tags traefik,restart
+
+# Nur Gitea-bezogene Tasks:
+ansible-playbook -i inventory/production.yml playbooks/check-and-restart-gitea.yml --tags gitea,restart
+
+# Nur Application-bezogene Tasks:
+ansible-playbook -i inventory/production.yml playbooks/deploy-application-code.yml --tags application,deploy
+```
+
+## Role-Struktur
+
+Die Playbooks verwenden jetzt folgende Roles:
+
+### `traefik` Role
+- **Tasks**: `restart`, `config`, `logs`, `ssl`
+- **Location**: `roles/traefik/tasks/`
+- **Defaults**: `roles/traefik/defaults/main.yml`
+
+### `gitea` Role
+- **Tasks**: `restart`, `runner`, `config`, `setup`, `repository`
+- **Location**: `roles/gitea/tasks/`
+- **Defaults**: `roles/gitea/defaults/main.yml`
+
+### `application` Role
+- **Tasks**: `deploy_code`, `composer`, `containers`, `health_check`, `logs`, `deploy`
+- **Location**: `roles/application/tasks/`
+- **Defaults**: `roles/application/defaults/main.yml`
+
+## Vorteile der Role-basierten Struktur
+
+1. **Wiederverwendbarkeit**: Tasks können in mehreren Playbooks genutzt werden
+2. **Wartbarkeit**: Änderungen zentral in Roles
+3. **Testbarkeit**: Roles isoliert testbar
+4. **Klarheit**: Klare Struktur nach Komponenten
+5. **Best Practices**: Folgt Ansible-Empfehlungen
+
diff --git a/deployment/ansible/playbooks/TRAEFIK_RESTART_DIAGNOSIS.md b/deployment/ansible/playbooks/TRAEFIK_RESTART_DIAGNOSIS.md
new file mode 100644
index 00000000..86063f2e
--- /dev/null
+++ b/deployment/ansible/playbooks/TRAEFIK_RESTART_DIAGNOSIS.md
@@ -0,0 +1,157 @@
+# Traefik Restart Loop - Diagnose & Lösung
+
+## Problem
+
+Traefik wird regelmäßig gestoppt mit den Meldungen:
+- "I have to go..."
+- "Stopping server gracefully"
+
+Dies führt zu:
+- ACME-Challenge-Fehlern
+- Externen Timeouts
+- Unterbrechungen der SSL-Zertifikats-Erneuerung
+
+## Durchgeführte Diagnose
+
+### 1. Erweiterte Diagnose (`diagnose-traefik-restarts.yml`)
+
+**Geprüfte Bereiche:**
+- ✅ Systemd-Timer (keine gefunden die Traefik stoppen)
+- ✅ Alle User-Crontabs (keine gefunden)
+- ✅ System-wide Cronjobs (keine gefunden)
+- ✅ Gitea Workflows (gefunden: `build-image.yml`, `manual-deploy.yml` - rufen aber keine Traefik-Restarts auf)
+- ✅ Custom Systemd Services/Timers (keine gefunden)
+- ✅ At Jobs (keine gefunden)
+- ✅ Docker Compose Watch Mode (nicht aktiviert)
+- ✅ Ansible `traefik_auto_restart` Einstellung (prüfbar)
+- ✅ Port-Konfiguration (Ports 80/443 korrekt auf Traefik gemappt)
+- ✅ Netzwerk-Konfiguration (geprüft)
+
+**Ergebnisse:**
+- ❌ Keine automatischen Restart-Mechanismen gefunden
+- ✅ Ports 80/443 sind korrekt konfiguriert
+- ✅ Traefik läuft stabil (keine Restarts während 2-minütiger Überwachung)
+
+### 2. acme.json Berechtigungen (`fix-traefik-acme-permissions.yml`)
+
+**Ergebnisse:**
+- ✅ acme.json hat korrekte Berechtigungen (chmod 600)
+- ✅ Owner/Group korrekt (deploy:deploy)
+- ✅ Traefik Container kann auf acme.json schreiben
+
+### 3. Auto-Restart-Mechanismen (`disable-traefik-auto-restarts.yml`)
+
+**Ergebnisse:**
+- ❌ Keine Cronjobs gefunden die Traefik restarten
+- ❌ Keine Systemd Timers/Services gefunden
+- ℹ️ Ansible `traefik_auto_restart` kann in group_vars überschrieben werden
+
+### 4. Traefik Stabilisierung (`stabilize-traefik.yml`)
+
+**Ergebnisse:**
+- ✅ Traefik läuft stabil (41 Minuten Uptime)
+- ✅ Keine Restarts während 2-minütiger Überwachung
+- ✅ Traefik ist healthy
+- ✅ Ports 80/443 korrekt konfiguriert
+
+## Mögliche Ursachen (nicht gefunden, aber zu prüfen)
+
+1. **Docker-Service-Restarts**: Am 08.11. um 16:12:58 wurde der Docker-Service gestoppt, was alle Container gestoppt hat
+   - Prüfe: `journalctl -u docker.service` für regelmäßige Stops
+   - Prüfe: System-Reboots oder Kernel-Updates
+
+2. **Unattended-Upgrades**: Können zu Reboots führen
+   - Prüfe: `journalctl -u unattended-upgrades`
+
+3. **Manuelle Restarts**: Jemand könnte Traefik manuell restarten
+   - Prüfe: Docker-Events für Stop-Events
+   - Prüfe: SSH-Login-Historie
+
+4. **Gitea Workflows**: Können indirekt Traefik beeinflussen
+   - `build-image.yml`: Ruft `deploy-image.yml` auf (keine Traefik-Restarts)
+   - `manual-deploy.yml`: Ruft `deploy-image.yml` auf (keine Traefik-Restarts)
+
+## Verfügbare Playbooks
+
+### Diagnose
+```bash
+# Erweiterte Diagnose durchführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/diagnose-traefik-restarts.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### acme.json Berechtigungen
+```bash
+# acme.json Berechtigungen prüfen und korrigieren
+ansible-playbook -i inventory/production.yml \
+  playbooks/fix-traefik-acme-permissions.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Auto-Restarts deaktivieren
+```bash
+# Prüfe Auto-Restart-Mechanismen
+ansible-playbook -i inventory/production.yml \
+  playbooks/disable-traefik-auto-restarts.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Traefik stabilisieren
+```bash
+# Traefik stabilisieren und überwachen (10 Minuten)
+ansible-playbook -i inventory/production.yml \
+  playbooks/stabilize-traefik.yml \
+  -e "traefik_stabilize_wait_minutes=10" \
+  --vault-password-file secrets/.vault_pass
+```
+
+## Empfohlene nächste Schritte
+
+1. **Längere Überwachung**: Führe `stabilize-traefik.yml` mit 10 Minuten aus, um zu sehen, ob Restarts auftreten
+   ```bash
+   ansible-playbook -i inventory/production.yml \
+     playbooks/stabilize-traefik.yml \
+     -e "traefik_stabilize_wait_minutes=10" \
+     --vault-password-file secrets/.vault_pass
+   ```
+
+2. **Docker-Events überwachen**: Prüfe Docker-Events für Stop-Events
+   ```bash
+   docker events --filter container=traefik --format "{{.Time}} {{.Action}}"
+   ```
+
+3. **Traefik-Logs prüfen**: Suche nach Stop-Meldungen
+   ```bash
+   cd /home/deploy/deployment/stacks/traefik
+   docker compose logs traefik | grep -E "I have to go|Stopping server gracefully|SIGTERM|SIGINT"
+   ```
+
+4. **Docker-Service-Logs prüfen**: Prüfe ob Docker-Service regelmäßig gestoppt wird
+   ```bash
+   journalctl -u docker.service --since "7 days ago" | grep -i "stop\|restart"
+   ```
+
+5. **System-Reboots prüfen**: Prüfe ob regelmäßige Reboots auftreten
+   ```bash
+   last reboot
+   uptime
+   ```
+
+## Wichtige Erkenntnisse
+
+- ✅ **Keine automatischen Restart-Mechanismen gefunden**: Keine Cronjobs, Systemd-Timer oder Services die Traefik regelmäßig stoppen
+- ✅ **acme.json ist korrekt konfiguriert**: Berechtigungen (600) und Container-Zugriff sind korrekt
+- ✅ **Ports sind korrekt**: Ports 80/443 zeigen auf Traefik
+- ✅ **Traefik läuft stabil**: Während der 2-minütigen Überwachung keine Restarts
+- ⚠️ **Docker-Service wurde einmalig gestoppt**: Am 08.11. um 16:12:58 - könnte die Ursache sein
+
+## Fazit
+
+Die Diagnose zeigt, dass **keine automatischen Restart-Mechanismen** aktiv sind. Die "I have to go..." Meldungen stammen wahrscheinlich von:
+1. Einmaligem Docker-Service-Stop (08.11. 16:12:58)
+2. System-Reboots (nicht in der Historie sichtbar, aber möglich)
+3. Manuellen Restarts (nicht nachweisbar)
+
+**Empfehlung**: Überwache Traefik für 10-30 Minuten mit `stabilize-traefik.yml`, um zu sehen, ob weitere Restarts auftreten. Wenn keine Restarts auftreten, war das Problem wahrscheinlich der einmalige Docker-Service-Stop.
+
diff --git a/deployment/ansible/playbooks/backup.yml b/deployment/ansible/playbooks/backup.yml
new file mode 100644
index 00000000..66f1b348
--- /dev/null
+++ b/deployment/ansible/playbooks/backup.yml
@@ -0,0 +1,268 @@
+---
+- name: Create Comprehensive Backups
+  hosts: production
+  gather_facts: yes
+  become: no
+
+  vars:
+    backup_retention_days: "{{ backup_retention_days | default(7) }}"
+
+  pre_tasks:
+    - name: Ensure backup directory exists
+      file:
+        path: "{{ backups_path }}"
+        state: directory
+        mode: '0755'
+      become: yes
+
+    - name: Create timestamp for backup
+      set_fact:
+        backup_timestamp: "{{ ansible_date_time.epoch }}"
+        backup_date: "{{ ansible_date_time.date }}"
+        backup_time: "{{ ansible_date_time.time }}"
+
+    - name: Create backup directory for this run
+      file:
+        path: "{{ backups_path }}/backup_{{ backup_date }}_{{ backup_time }}"
+        state: directory
+        mode: '0755'
+      register: backup_dir
+      become: yes
+
+    - name: Set backup directory path
+      set_fact:
+        current_backup_dir: "{{ backup_dir.path }}"
+
+  tasks:
+    - name: Backup PostgreSQL Database
+      when: backup_postgresql | default(true) | bool
+      block:
+        - name: Check if PostgreSQL stack is running
+          shell: docker compose -f {{ stacks_base_path }}/postgresql/docker-compose.yml ps --format json | jq -r '.[] | select(.Service=="postgres") | .State' | grep -q "running"
+          register: postgres_running
+          changed_when: false
+          failed_when: false
+
+        - name: Get PostgreSQL container name
+          shell: docker compose -f {{ stacks_base_path }}/postgresql/docker-compose.yml ps --format json | jq -r '.[] | select(.Service=="postgres") | .Name'
+          register: postgres_container
+          changed_when: false
+          when: postgres_running.rc == 0
+
+        - name: Read PostgreSQL environment variables
+          shell: |
+            cd {{ stacks_base_path }}/postgresql
+            grep -E "^POSTGRES_(DB|USER|PASSWORD)=" .env 2>/dev/null || echo ""
+          register: postgres_env
+          changed_when: false
+          failed_when: false
+          no_log: true
+
+        - name: Extract PostgreSQL credentials
+          set_fact:
+            postgres_db: "{{ postgres_env.stdout | regex_search('POSTGRES_DB=([^\\n]+)', '\\1') | first | default('michaelschiemer') }}"
+            postgres_user: "{{ postgres_env.stdout | regex_search('POSTGRES_USER=([^\\n]+)', '\\1') | first | default('postgres') }}"
+            postgres_password: "{{ postgres_env.stdout | regex_search('POSTGRES_PASSWORD=([^\\n]+)', '\\1') | first | default('') }}"
+          when: postgres_running.rc == 0
+          no_log: true
+
+        - name: Create PostgreSQL backup
+          shell: |
+            cd {{ stacks_base_path }}/postgresql
+            PGPASSWORD="{{ postgres_password }}" docker compose exec -T postgres pg_dump \
+              -U {{ postgres_user }} \
+              -d {{ postgres_db }} \
+              --clean \
+              --if-exists \
+              --create \
+              --no-owner \
+              --no-privileges \
+              | gzip > {{ current_backup_dir }}/postgresql_${postgres_db}_{{ backup_date }}_{{ backup_time }}.sql.gz
+          when: postgres_running.rc == 0
+          no_log: true
+
+        - name: Verify PostgreSQL backup
+          stat:
+            path: "{{ current_backup_dir }}/postgresql_{{ postgres_db }}_{{ backup_date }}_{{ backup_time }}.sql.gz"
+          register: postgres_backup_file
+          when: postgres_running.rc == 0
+
+        - name: Display PostgreSQL backup status
+          debug:
+            msg: "PostgreSQL backup: {{ 'SUCCESS' if (postgres_running.rc == 0 and postgres_backup_file.stat.exists) else 'SKIPPED (PostgreSQL not running)' }}"
+
+    - name: Backup Application Data
+      when: backup_application_data | default(true) | bool
+      block:
+        - name: Check if production stack is running
+          shell: docker compose -f {{ stacks_base_path }}/production/docker-compose.base.yml -f {{ stacks_base_path }}/production/docker-compose.production.yml ps --format json | jq -r '.[] | select(.Service=="php") | .State' | grep -q "running"
+          register: app_running
+          changed_when: false
+          failed_when: false
+
+        - name: Backup application storage directory
+          archive:
+            path: "{{ stacks_base_path }}/production/storage"
+            dest: "{{ current_backup_dir }}/application_storage_{{ backup_date }}_{{ backup_time }}.tar.gz"
+            format: gz
+          when: app_running.rc == 0
+          ignore_errors: yes
+
+        - name: Backup application logs
+          archive:
+            path: "{{ stacks_base_path }}/production/storage/logs"
+            dest: "{{ current_backup_dir }}/application_logs_{{ backup_date }}_{{ backup_time }}.tar.gz"
+            format: gz
+          when: app_running.rc == 0
+          ignore_errors: yes
+
+        - name: Backup application .env file
+          copy:
+            src: "{{ stacks_base_path }}/production/.env"
+            dest: "{{ current_backup_dir }}/application_env_{{ backup_date }}_{{ backup_time }}.env"
+            remote_src: yes
+          when: app_running.rc == 0
+          ignore_errors: yes
+
+        - name: Display application backup status
+          debug:
+            msg: "Application data backup: {{ 'SUCCESS' if app_running.rc == 0 else 'SKIPPED (Application not running)' }}"
+
+    - name: Backup Gitea Data
+      when: backup_gitea | default(true) | bool
+      block:
+        - name: Check if Gitea stack is running
+          shell: docker compose -f {{ stacks_base_path }}/gitea/docker-compose.yml ps --format json | jq -r '.[] | select(.Service=="gitea") | .State' | grep -q "running"
+          register: gitea_running
+          changed_when: false
+          failed_when: false
+
+        - name: Get Gitea volume name
+          shell: docker compose -f {{ stacks_base_path }}/gitea/docker-compose.yml config --volumes | head -1
+          register: gitea_volume
+          changed_when: false
+          when: gitea_running.rc == 0
+
+        - name: Backup Gitea volume
+          shell: |
+            docker run --rm \
+              -v {{ gitea_volume.stdout }}:/source:ro \
+              -v {{ current_backup_dir }}:/backup \
+              alpine tar czf /backup/gitea_data_{{ backup_date }}_{{ backup_time }}.tar.gz -C /source .
+          when: gitea_running.rc == 0 and gitea_volume.stdout != ""
+          ignore_errors: yes
+
+        - name: Display Gitea backup status
+          debug:
+            msg: "Gitea backup: {{ 'SUCCESS' if (gitea_running.rc == 0 and gitea_volume.stdout != '') else 'SKIPPED (Gitea not running)' }}"
+
+    - name: Backup Docker Registry Images (Optional)
+      when: backup_registry | default(false) | bool
+      block:
+        - name: Check if registry stack is running
+          shell: docker compose -f {{ stacks_base_path }}/registry/docker-compose.yml ps --format json | jq -r '.[] | select(.Service=="registry") | .State' | grep -q "running"
+          register: registry_running
+          changed_when: false
+          failed_when: false
+
+        - name: List registry images
+          shell: |
+            cd {{ stacks_base_path }}/registry
+            docker compose exec -T registry registry garbage-collect --dry-run /etc/docker/registry/config.yml 2>&1 | grep -E "repository|tag" || echo "No images found"
+          register: registry_images
+          changed_when: false
+          when: registry_running.rc == 0
+          ignore_errors: yes
+
+        - name: Save registry image list
+          copy:
+            content: "{{ registry_images.stdout }}"
+            dest: "{{ current_backup_dir }}/registry_images_{{ backup_date }}_{{ backup_time }}.txt"
+          when: registry_running.rc == 0 and registry_images.stdout != ""
+          ignore_errors: yes
+
+        - name: Display registry backup status
+          debug:
+            msg: "Registry backup: {{ 'SUCCESS' if registry_running.rc == 0 else 'SKIPPED (Registry not running)' }}"
+
+    - name: Create backup metadata
+      copy:
+        content: |
+          Backup Date: {{ backup_date }} {{ backup_time }}
+          Backup Timestamp: {{ backup_timestamp }}
+          Host: {{ inventory_hostname }}
+          
+          Components Backed Up:
+          - PostgreSQL: {{ 'YES' if ((backup_postgresql | default(true) | bool) and (postgres_running.rc | default(1) == 0)) else 'NO' }}
+          - Application Data: {{ 'YES' if ((backup_application_data | default(true) | bool) and (app_running.rc | default(1) == 0)) else 'NO' }}
+          - Gitea: {{ 'YES' if ((backup_gitea | default(true) | bool) and (gitea_running.rc | default(1) == 0)) else 'NO' }}
+          - Registry: {{ 'YES' if ((backup_registry | default(false) | bool) and (registry_running.rc | default(1) == 0)) else 'NO' }}
+          
+          Backup Location: {{ current_backup_dir }}
+        dest: "{{ current_backup_dir }}/backup_metadata.txt"
+        mode: '0644'
+
+    - name: Verify backup files
+      when: verify_backups | default(true) | bool
+      block:
+        - name: List all backup files
+          find:
+            paths: "{{ current_backup_dir }}"
+            file_type: file
+          register: backup_files
+
+        - name: Check backup file sizes
+          stat:
+            path: "{{ item.path }}"
+          register: backup_file_stats
+          loop: "{{ backup_files.files }}"
+
+        - name: Display backup summary
+          debug:
+            msg: |
+              Backup Summary:
+              - Total files: {{ backup_files.files | length }}
+              - Total size: {{ backup_file_stats.results | map(attribute='stat.size') | sum | int / 1024 / 1024 }} MB
+              - Location: {{ current_backup_dir }}
+
+        - name: Fail if no backup files created
+          fail:
+            msg: "No backup files were created in {{ current_backup_dir }}"
+          when: backup_files.files | length == 0
+
+    - name: Cleanup old backups
+      block:
+        - name: Find old backup directories
+          find:
+            paths: "{{ backups_path }}"
+            patterns: "backup_*"
+            file_type: directory
+          register: backup_dirs
+
+        - name: Calculate cutoff date
+          set_fact:
+            cutoff_timestamp: "{{ (ansible_date_time.epoch | int) - (backup_retention_days | int * 86400) }}"
+
+        - name: Remove old backup directories
+          file:
+            path: "{{ item.path }}"
+            state: absent
+          loop: "{{ backup_dirs.files }}"
+          when: item.mtime | int < cutoff_timestamp | int
+          become: yes
+
+        - name: Display cleanup summary
+          debug:
+            msg: "Cleaned up backups older than {{ backup_retention_days }} days"
+
+  post_tasks:
+    - name: Display final backup status
+      debug:
+        msg: |
+          ==========================================
+          Backup completed successfully!
+          ==========================================
+          Backup location: {{ current_backup_dir }}
+          Retention: {{ backup_retention_days }} days
+          ==========================================
+
diff --git a/deployment/ansible/playbooks/build-initial-image.yml b/deployment/ansible/playbooks/build-initial-image.yml
new file mode 100644
index 00000000..3bbf3a81
--- /dev/null
+++ b/deployment/ansible/playbooks/build-initial-image.yml
@@ -0,0 +1,432 @@
+---
+- name: Build and Push Initial Docker Image
+  hosts: production
+  become: no
+  gather_facts: yes
+
+  vars:
+    vault_file: "{{ playbook_dir }}/../secrets/production.vault.yml"
+    build_repo_path: "/home/deploy/michaelschiemer"
+    build_repo_url: "{{ git_repository_url_default | default('https://git.michaelschiemer.de/michael/michaelschiemer.git') }}"
+    build_repo_branch_default: "main"
+    # Local repository path for cloning (temporary)
+    local_repo_path: "/tmp/michaelschiemer-build-{{ ansible_date_time.epoch }}"
+    # Check if local repository exists (project root)
+    local_repo_check_path: "{{ playbook_dir | default('') | dirname | dirname | dirname }}"
+    image_name: "{{ app_name | default('framework') }}"
+    image_tag_default: "latest"
+    registry_url: "{{ docker_registry | default('localhost:5000') }}"
+    registry_username: "{{ vault_docker_registry_username | default(docker_registry_username_default | default('admin')) }}"
+    registry_password: "{{ vault_docker_registry_password | default('') }}"
+
+  pre_tasks:
+    - name: Verify vault file exists
+      ansible.builtin.stat:
+        path: "{{ vault_file }}"
+      register: vault_stat
+      delegate_to: localhost
+      become: no
+
+    - name: Load vault secrets
+      ansible.builtin.include_vars:
+        file: "{{ vault_file }}"
+      when: vault_stat.stat.exists
+      no_log: yes
+      ignore_errors: yes
+      delegate_to: localhost
+      become: no
+
+    - name: Verify registry password is set
+      ansible.builtin.fail:
+        msg: |
+          Registry password is required!
+          
+          Please set vault_docker_registry_password in:
+          {{ vault_file }}
+          
+          Or pass it via extra vars:
+          -e "registry_password=your-password"
+      when: registry_password | string | trim == ''
+
+  tasks:
+    - name: Set build variables
+      ansible.builtin.set_fact:
+        build_repo_branch: "{{ build_repo_branch | default(build_repo_branch_default) }}"
+        image_tag: "{{ build_image_tag | default(image_tag_default) }}"
+
+    - name: Display build information
+      ansible.builtin.debug:
+        msg: |
+          Building Docker Image:
+          - Repository: {{ build_repo_url }}
+          - Branch: {{ build_repo_branch }}
+          - Build Path: {{ build_repo_path }}
+          - Registry: {{ registry_url }}
+          - Image: {{ image_name }}:{{ image_tag }}
+          - Username: {{ registry_username }}
+
+    - name: Check if local repository exists (project root)
+      ansible.builtin.stat:
+        path: "{{ local_repo_check_path }}/.git"
+      delegate_to: localhost
+      register: local_repo_exists
+      become: no
+
+    - name: Configure Git to skip SSL verification for git.michaelschiemer.de (local)
+      ansible.builtin.command: |
+        git config --global http.https://git.michaelschiemer.de.sslVerify false
+      delegate_to: localhost
+      changed_when: false
+      failed_when: false
+      become: no
+      when: not local_repo_exists.stat.exists
+
+    - name: Determine Git URL with authentication if token is available
+      ansible.builtin.set_fact:
+        git_repo_url_with_auth: >-
+          {%- if vault_git_token is defined and vault_git_token | string | trim != '' -%}
+            https://{{ vault_git_token }}@git.michaelschiemer.de/michael/michaelschiemer.git
+          {%- elif vault_git_username is defined and vault_git_username | string | trim != '' and vault_git_password is defined and vault_git_password | string | trim != '' -%}
+            https://{{ vault_git_username }}:{{ vault_git_password }}@git.michaelschiemer.de/michael/michaelschiemer.git
+          {%- else -%}
+            {{ build_repo_url }}
+          {%- endif -%}
+      no_log: yes
+
+    - name: Debug Git URL (without credentials)
+      ansible.builtin.debug:
+        msg: |
+          Git Repository Configuration:
+          - Original URL: {{ build_repo_url }}
+          - Local repo exists: {{ 'YES' if local_repo_exists.stat.exists else 'NO' }}
+          - Local repo path: {{ local_repo_check_path }}
+          - Using authentication: {{ 'YES' if (vault_git_token is defined and vault_git_token | string | trim != '') or (vault_git_username is defined and vault_git_username | string | trim != '') else 'NO' }}
+          - Auth method: {{ 'Token' if (vault_git_token is defined and vault_git_token | string | trim != '') else 'Username/Password' if (vault_git_username is defined and vault_git_username | string | trim != '') else 'None' }}
+      no_log: yes
+
+    - name: Use existing local repository or clone to temporary location
+      block:
+        - name: Clone repository to temporary location (local)
+          ansible.builtin.git:
+            repo: "{{ git_repo_url_with_auth }}"
+            dest: "{{ local_repo_path }}"
+            version: "{{ build_repo_branch }}"
+            force: yes
+            update: yes
+          delegate_to: localhost
+          register: git_result
+          changed_when: git_result.changed
+          environment:
+            GIT_SSL_NO_VERIFY: "1"
+          no_log: yes
+          when: not local_repo_exists.stat.exists
+
+        - name: Set local repository path to existing project root
+          ansible.builtin.set_fact:
+            source_repo_path: "{{ local_repo_check_path }}"
+          when: local_repo_exists.stat.exists
+
+        - name: Set local repository path to cloned temporary location
+          ansible.builtin.set_fact:
+            source_repo_path: "{{ local_repo_path }}"
+          when: not local_repo_exists.stat.exists
+
+    - name: Display repository source
+      ansible.builtin.debug:
+        msg: |
+          Repository source:
+          - Using existing local repo: {{ 'YES' if local_repo_exists.stat.exists else 'NO' }}
+          - Source path: {{ source_repo_path }}
+          - Branch: {{ build_repo_branch }}
+
+    - name: Ensure build directory exists on server
+      ansible.builtin.file:
+        path: "{{ build_repo_path }}"
+        state: directory
+        mode: '0755'
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
+
+    - name: Copy repository to server (excluding .git and build artifacts)
+      ansible.builtin.synchronize:
+        src: "{{ source_repo_path }}/"
+        dest: "{{ build_repo_path }}/"
+        delete: no
+        recursive: yes
+        rsync_opts:
+          - "--chmod=D755,F644"
+          - "--exclude=.git"
+          - "--exclude=.gitignore"
+          - "--exclude=node_modules"
+          - "--exclude=vendor"
+          - "--exclude=.env"
+          - "--exclude=.env.*"
+          - "--exclude=*.log"
+          - "--exclude=.idea"
+          - "--exclude=.vscode"
+          - "--exclude=.DS_Store"
+          - "--exclude=*.swp"
+          - "--exclude=*.swo"
+          - "--exclude=*~"
+          - "--exclude=.phpunit.result.cache"
+          - "--exclude=coverage"
+          - "--exclude=.phpunit.cache"
+          - "--exclude=public/assets"
+          - "--exclude=storage/logs"
+          - "--exclude=storage/framework/cache"
+          - "--exclude=storage/framework/sessions"
+          - "--exclude=storage/framework/views"
+
+    - name: Clean up temporary cloned repository
+      ansible.builtin.file:
+        path: "{{ local_repo_path }}"
+        state: absent
+      delegate_to: localhost
+      become: no
+      when: 
+        - not local_repo_exists.stat.exists
+        - local_repo_path is defined
+
+    - name: Check if Dockerfile.production exists on server
+      ansible.builtin.stat:
+        path: "{{ build_repo_path }}/Dockerfile.production"
+      register: dockerfile_stat
+
+    - name: Fail if Dockerfile.production not found
+      ansible.builtin.fail:
+        msg: |
+          Dockerfile.production not found at {{ build_repo_path }}/Dockerfile.production
+          
+          Please verify:
+          1. The repository was copied successfully to {{ build_repo_path }}
+          2. The Dockerfile.production file exists in the repository
+          3. The source repository path is correct: {{ source_repo_path }}
+      when: not dockerfile_stat.stat.exists
+
+    - name: Check if entrypoint script exists on server
+      ansible.builtin.stat:
+        path: "{{ build_repo_path }}/docker/entrypoint.sh"
+      register: entrypoint_stat
+
+    - name: Display entrypoint script status
+      ansible.builtin.debug:
+        msg: |
+          Entrypoint Script Check:
+          - Path: {{ build_repo_path }}/docker/entrypoint.sh
+          - Exists: {{ entrypoint_stat.stat.exists | default(false) }}
+          {% if entrypoint_stat.stat.exists %}
+          - Mode: {{ entrypoint_stat.stat.mode | default('unknown') }}
+          - Size: {{ entrypoint_stat.stat.size | default(0) }} bytes
+          {% endif %}
+      when: not ansible_check_mode
+
+    - name: Fail if entrypoint script not found
+      ansible.builtin.fail:
+        msg: |
+          Entrypoint script not found at {{ build_repo_path }}/docker/entrypoint.sh
+          
+          This file is required for the Docker image build!
+          
+          Please verify:
+          1. The file exists in the source repository: {{ source_repo_path }}/docker/entrypoint.sh
+          2. The rsync operation copied the file successfully
+      when: not entrypoint_stat.stat.exists
+
+    - name: Convert entrypoint script to LF line endings
+      ansible.builtin.shell: |
+        sed -i 's/\r$//' "{{ build_repo_path }}/docker/entrypoint.sh"
+      when: entrypoint_stat.stat.exists
+      changed_when: false
+      failed_when: false
+
+    - name: Verify entrypoint script has LF line endings
+      ansible.builtin.shell: |
+        if head -1 "{{ build_repo_path }}/docker/entrypoint.sh" | od -c | grep -q "\\r"; then
+          echo "CRLF_DETECTED"
+        else
+          echo "LF_ONLY"
+        fi
+      register: line_ending_check
+      changed_when: false
+      when: entrypoint_stat.stat.exists
+
+    - name: Display line ending check result
+      ansible.builtin.debug:
+        msg: |
+          Entrypoint Script Line Endings:
+          - Status: {{ line_ending_check.stdout | default('unknown') }}
+          {% if 'CRLF_DETECTED' in line_ending_check.stdout %}
+          ⚠️  WARNING: Script still has CRLF line endings after conversion attempt!
+          {% else %}
+          ✅ Script has LF line endings
+          {% endif %}
+      when: 
+        - entrypoint_stat.stat.exists
+        - not ansible_check_mode
+
+    - name: Login to Docker registry
+      community.docker.docker_login:
+        registry_url: "{{ registry_url }}"
+        username: "{{ registry_username }}"
+        password: "{{ registry_password }}"
+      no_log: yes
+      register: login_result
+
+    - name: Verify registry login
+      ansible.builtin.debug:
+        msg: "✅ Successfully logged in to {{ registry_url }}"
+      when: not login_result.failed | default(false)
+
+    - name: Fail if registry login failed
+      ansible.builtin.fail:
+        msg: |
+          Failed to login to Docker registry!
+          
+          Registry: {{ registry_url }}
+          Username: {{ registry_username }}
+          
+          Please verify:
+          1. The registry is running and accessible
+          2. The username and password are correct
+          3. The registry URL is correct
+      when: login_result.failed | default(false)
+
+    - name: Verify Docker Buildx is available
+      ansible.builtin.command: docker buildx version
+      register: buildx_check
+      changed_when: false
+      failed_when: false
+
+    - name: Warn if Buildx is not available
+      ansible.builtin.debug:
+        msg: |
+          ⚠️  Docker Buildx not found. BuildKit features may not work.
+          Install with: apt-get install docker-buildx-plugin
+      when: buildx_check.rc != 0
+
+    - name: Set build cache option
+      ansible.builtin.set_fact:
+        build_no_cache: "{{ build_no_cache | default('false') | bool }}"
+
+    - name: Build and push Docker image with BuildKit
+      ansible.builtin.shell: |
+        set -e
+        BUILD_ARGS=""
+        {% if build_no_cache | bool %}
+        BUILD_ARGS="--no-cache"
+        {% endif %}
+        DOCKER_BUILDKIT=1 docker buildx build \
+          --platform linux/amd64 \
+          --file {{ build_repo_path }}/Dockerfile.production \
+          --tag {{ registry_url }}/{{ image_name }}:{{ image_tag }} \
+          --push \
+          --progress=plain \
+          $BUILD_ARGS \
+          {{ build_repo_path }}
+      register: build_result
+      environment:
+        DOCKER_BUILDKIT: "1"
+      changed_when: build_result.rc == 0
+      failed_when: build_result.rc != 0
+      async: 3600
+      poll: 10
+
+    - name: Display build result
+      ansible.builtin.debug:
+        msg: |
+          Build result:
+          - Image: {{ registry_url }}/{{ image_name }}:{{ image_tag }}
+          - Return code: {{ build_result.rc | default('unknown') }}
+          - Changed: {{ build_result.changed | default(false) }}
+          - Failed: {{ build_result.failed | default(false) }}
+      when: build_result is defined
+
+    - name: Display build output on failure
+      ansible.builtin.debug:
+        msg: |
+          Build failed! Output:
+          {{ build_result.stdout_lines | default([]) | join('\n') }}
+          
+          Error output:
+          {{ build_result.stderr_lines | default([]) | join('\n') }}
+      when: 
+        - build_result is defined
+        - build_result.rc | default(0) != 0
+
+    - name: Verify image exists locally
+      ansible.builtin.command: |
+        docker image inspect {{ registry_url }}/{{ image_name }}:{{ image_tag }}
+      register: image_check
+      changed_when: false
+      failed_when: false
+
+    - name: Verify entrypoint script in built image
+      shell: |
+        CONTAINER_ID=$(docker create {{ registry_url }}/{{ image_name }}:{{ image_tag }} 2>/dev/null) && \
+        if docker cp $CONTAINER_ID:/usr/local/bin/entrypoint.sh /tmp/entrypoint_verify.sh 2>&1; then \
+          echo "FILE_EXISTS"; \
+          ls -la /tmp/entrypoint_verify.sh; \
+          head -3 /tmp/entrypoint_verify.sh; \
+          file /tmp/entrypoint_verify.sh; \
+          rm -f /tmp/entrypoint_verify.sh; \
+        else \
+          echo "FILE_NOT_FOUND"; \
+        fi && \
+        docker rm $CONTAINER_ID >/dev/null 2>&1 || true
+      register: image_entrypoint_check
+      changed_when: false
+      failed_when: false
+
+    - name: Display entrypoint verification result
+      debug:
+        msg: |
+          ==========================================
+          Entrypoint Script Verification in Built Image
+          ==========================================
+          Image: {{ registry_url }}/{{ image_name }}:{{ image_tag }}
+          
+          Verification Result:
+          {{ image_entrypoint_check.stdout | default('Check failed') }}
+          
+          {% if 'FILE_NOT_FOUND' in image_entrypoint_check.stdout %}
+          ⚠️  CRITICAL: Entrypoint script NOT FOUND in built image!
+          
+          This means the Docker build did not copy the entrypoint script.
+          Possible causes:
+          1. The COPY command in Dockerfile.production failed silently
+          2. The docker/entrypoint.sh file was not in the build context
+          3. There was an issue with the multi-stage build
+          
+          Please check:
+          1. Build logs above for COPY errors
+          2. Verify docker/entrypoint.sh exists: ls -la {{ build_repo_path }}/docker/entrypoint.sh
+          3. Rebuild with verbose output to see COPY step
+          {% elif 'FILE_EXISTS' in image_entrypoint_check.stdout %}
+          ✅ Entrypoint script found in built image
+          {% endif %}
+          ==========================================
+
+    - name: Display image information
+      ansible.builtin.debug:
+        msg: |
+          ✅ Image built and pushed successfully!
+          
+          Registry: {{ registry_url }}
+          Image: {{ image_name }}:{{ image_tag }}
+          Local: {{ 'Available' if image_check.rc == 0 else 'Not found locally' }}
+          
+          Next steps:
+          1. Run setup-infrastructure.yml to deploy the application stack
+          2. Or manually deploy using docker-compose
+      when: image_check.rc == 0
+
+    - name: Warn if image not found locally
+      ansible.builtin.debug:
+        msg: |
+          ⚠️  Image was pushed but not found locally.
+          This is normal if the image was pushed to a remote registry.
+          
+          Verify the image exists in the registry:
+          curl -u {{ registry_username }}:{{ registry_password }} http://{{ registry_url }}/v2/{{ image_name }}/tags/list
+      when: image_check.rc != 0
+
diff --git a/deployment/ansible/playbooks/check-after-grafana-access.yml b/deployment/ansible/playbooks/check-after-grafana-access.yml
deleted file mode 100644
index a3b49ded..00000000
--- a/deployment/ansible/playbooks/check-after-grafana-access.yml
+++ /dev/null
@@ -1,78 +0,0 @@
----
-- name: Check Traefik Logs After Grafana Access
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions
-      debug:
-        msg:
-          - "=== ANWEISUNG ==="
-          - "Bitte mache JETZT einen Zugriff auf https://grafana.michaelschiemer.de im Browser"
-          - "Dann pr?fe ich die Logs und sage dir, ob Traffic ?ber VPN kommt"
-          - ""
-
-    - name: Wait for access
-      pause:
-        seconds: 15
-
-    - name: Get last 20 Grafana requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -500 logs/access.log | grep -i grafana | tail -20
-      args:
-        executable: /bin/bash
-      register: recent_grafana_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Extract and display client IPs with timestamps
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if [[ "$client" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [[ "$client" == "89.246.96.244" ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? ?ffentliche IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unbekannte IP"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis_result.stdout_lines }}"
-
-    - name: Get unique client IPs from last 10 requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Final verdict
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Pr?fe die obigen Zeilen:"
-          - "- ? Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN!"
-          - "- ? Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN"
-          - ""
-          - "N?chster Schritt: Wenn VPN funktioniert, entfernen wir die tempor?re IP-Erlaubnis!"
diff --git a/deployment/ansible/playbooks/check-and-restart-gitea.yml b/deployment/ansible/playbooks/check-and-restart-gitea.yml
index 31dde714..9cccbed4 100644
--- a/deployment/ansible/playbooks/check-and-restart-gitea.yml
+++ b/deployment/ansible/playbooks/check-and-restart-gitea.yml
@@ -1,126 +1,14 @@
 ---
-- name: Check and Restart Gitea if Unhealthy
-  hosts: production
+# Check and Restart Gitea if Unhealthy
+# Wrapper Playbook for gitea role restart tasks
+- hosts: production
   gather_facts: yes
   become: no
-
-  vars:
-    gitea_stack_path: "{{ stacks_base_path | default('/home/deploy/deployment/stacks') }}/gitea"
-    gitea_url: "https://git.michaelschiemer.de"
-    gitea_container_name: "gitea"
-
   tasks:
-    - name: Check if Gitea stack directory exists
-      stat:
-        path: "{{ gitea_stack_path }}"
-      register: gitea_stack_exists
-
-    - name: Fail if Gitea stack directory does not exist
-      fail:
-        msg: "Gitea stack directory not found at {{ gitea_stack_path }}"
-      when: not gitea_stack_exists.stat.exists
-
-    - name: Check Gitea container status
-      shell: |
-        cd {{ gitea_stack_path }}
-        docker compose ps {{ gitea_container_name }} --format json
-      register: gitea_container_status
-      changed_when: false
-      failed_when: false
-
-    - name: Display Gitea container status
-      debug:
-        msg: |
-          Gitea Container Status:
-          {{ gitea_container_status.stdout | default('Container not found or error') }}
-
-    - name: Check Gitea health endpoint
-      uri:
-        url: "{{ gitea_url }}/api/healthz"
-        method: GET
-        status_code: [200]
-        validate_certs: false
-        timeout: 10
-      register: gitea_health
-      ignore_errors: yes
-      changed_when: false
-
-    - name: Display Gitea health check result
-      debug:
-        msg: |
-          Gitea Health Check:
-          - Status Code: {{ gitea_health.status | default('UNREACHABLE') }}
-          - Response Time: {{ gitea_health.elapsed | default('N/A') }}s
-          {% if gitea_health.status == 200 %}
-          - Status: ✅ HEALTHY
-          {% else %}
-          - Status: ❌ UNHEALTHY or TIMEOUT
-          {% endif %}
-
-    - name: Get Gitea container logs (last 50 lines)
-      shell: |
-        cd {{ gitea_stack_path }}
-        docker compose logs --tail=50 {{ gitea_container_name }} 2>&1 || echo "LOGS_NOT_AVAILABLE"
-      register: gitea_logs
-      changed_when: false
-      failed_when: false
-
-    - name: Display Gitea container logs
-      debug:
-        msg: |
-          Gitea Container Logs (last 50 lines):
-          {{ gitea_logs.stdout | default('No logs available') }}
-
-    - name: Check if Gitea container is running
-      set_fact:
-        gitea_is_running: "{{ 'State":"running' in gitea_container_status.stdout | default('') }}"
-
-    - name: Check if Gitea is healthy
-      set_fact:
-        gitea_is_healthy: "{{ gitea_health.status | default(0) == 200 }}"
-
-    - name: Restart Gitea container if unhealthy or not running
-      shell: |
-        cd {{ gitea_stack_path }}
-        docker compose restart {{ gitea_container_name }}
-      when: not gitea_is_healthy or not gitea_is_running
-      register: gitea_restart
-      changed_when: gitea_restart.rc == 0
-
-    - name: Wait for Gitea to be ready after restart
-      uri:
-        url: "{{ gitea_url }}/api/healthz"
-        method: GET
-        status_code: [200]
-        validate_certs: false
-        timeout: 10
-      register: gitea_health_after_restart
-      until: gitea_health_after_restart.status == 200
-      retries: 30
-      delay: 2
-      when: not gitea_is_healthy or not gitea_is_running
-      ignore_errors: yes
-
-    - name: Display final status
-      debug:
-        msg: |
-          ========================================
-          Gitea Status Summary
-          ========================================
-          Container Running: {{ '✅ YES' if gitea_is_running else '❌ NO' }}
-          Health Check: {{ '✅ HEALTHY' if gitea_is_healthy else '❌ UNHEALTHY' }}
-          {% if not gitea_is_healthy or not gitea_is_running %}
-          Action Taken: 🔄 Container restarted
-          Final Status: {{ '✅ HEALTHY' if gitea_health_after_restart.status | default(0) == 200 else '❌ STILL UNHEALTHY' }}
-          {% else %}
-          Action Taken: ℹ️  No action needed
-          {% endif %}
-          ========================================
-          
-          {% if gitea_health_after_restart.status | default(0) == 200 %}
-          ✅ Gitea is now accessible and healthy!
-          {% elif not gitea_is_healthy and not gitea_is_running %}
-          ⚠️  Gitea container was restarted but may still be starting up.
-          Please check logs manually: docker compose -f {{ gitea_stack_path }}/docker-compose.yml logs gitea
-          {% endif %}
-
+    - name: Include gitea restart tasks
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: restart
+  tags:
+    - gitea
+    - restart
diff --git a/deployment/ansible/playbooks/check-container-logs.yml b/deployment/ansible/playbooks/check-container-logs.yml
new file mode 100644
index 00000000..88e943a9
--- /dev/null
+++ b/deployment/ansible/playbooks/check-container-logs.yml
@@ -0,0 +1,14 @@
+---
+# Check Container Logs for Troubleshooting
+# Wrapper Playbook for application role logs tasks
+- hosts: production
+  gather_facts: no
+  become: no
+  tasks:
+    - name: Include application logs tasks
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: logs
+  tags:
+    - application
+    - logs
diff --git a/deployment/ansible/playbooks/check-container-status.yml b/deployment/ansible/playbooks/check-container-status.yml
new file mode 100644
index 00000000..a63c0c08
--- /dev/null
+++ b/deployment/ansible/playbooks/check-container-status.yml
@@ -0,0 +1,15 @@
+---
+# Check Container Status After Code Sync
+# Wrapper Playbook for application role health_check tasks
+- hosts: production
+  gather_facts: no
+  become: no
+  tasks:
+    - name: Include application health_check tasks
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: health_check
+  tags:
+    - application
+    - health
+    - status
diff --git a/deployment/ansible/playbooks/check-docker-compose-logs.yml b/deployment/ansible/playbooks/check-docker-compose-logs.yml
deleted file mode 100644
index ce7d7510..00000000
--- a/deployment/ansible/playbooks/check-docker-compose-logs.yml
+++ /dev/null
@@ -1,40 +0,0 @@
----
-- name: Check Docker Compose Logs for JSON Output
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Get recent docker compose logs for staging-app (JSON format check)
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Last 100 lines of staging-app logs ==="
-        docker compose logs --tail=100 staging-app 2>&1 | tail -50
-        echo ""
-        echo "=== Checking for JSON logs ==="
-        docker compose logs --tail=200 staging-app 2>&1 | grep -E '^{"|^\{' | head -5 || echo "No JSON logs found (or logs are in plain text)"
-      args:
-        executable: /bin/bash
-      register: compose_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display compose logs
-      debug:
-        msg: "{{ compose_logs.stdout_lines }}"
-
-    - name: Get all recent logs from all staging services
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== All staging services logs (last 30 lines each) ==="
-        docker compose logs --tail=30 2>&1
-      args:
-        executable: /bin/bash
-      register: all_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display all logs
-      debug:
-        msg: "{{ all_logs.stdout_lines }}"
-      when: all_logs.stdout_lines is defined
diff --git a/deployment/ansible/playbooks/check-entrypoint-execution.yml b/deployment/ansible/playbooks/check-entrypoint-execution.yml
deleted file mode 100644
index c0d43737..00000000
--- a/deployment/ansible/playbooks/check-entrypoint-execution.yml
+++ /dev/null
@@ -1,63 +0,0 @@
----
-- name: Check Entrypoint Script Execution
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check when nginx container started
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose ps staging-nginx --format "{{.Status}}" || echo "Container not running"
-      args:
-        executable: /bin/bash
-      register: container_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display container status
-      debug:
-        msg: "{{ container_status.stdout }}"
-
-    - name: Check entrypoint logs
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Entrypoint logs (startup) ==="
-        docker compose logs staging-nginx 2>&1 | grep -E "(??|Fixing|PHP-FPM|upstream)" | head -20
-      args:
-        executable: /bin/bash
-      register: entrypoint_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display entrypoint logs
-      debug:
-        msg: "{{ entrypoint_logs.stdout_lines }}"
-
-    - name: Check if sites-available/default is a volume mount
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker inspect staging-nginx 2>&1 | grep -A 20 "Mounts" | grep "sites-available\|sites-enabled" || echo "No volume mounts for sites-available"
-      args:
-        executable: /bin/bash
-      register: volume_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display volume check
-      debug:
-        msg: "{{ volume_check.stdout_lines }}"
-
-    - name: Check when sites-available/default was last modified
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx stat -c "%y" /etc/nginx/sites-available/default 2>&1 || echo "Could not get file stat"
-      args:
-        executable: /bin/bash
-      register: file_stat
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display file modification time
-      debug:
-        msg: "{{ file_stat.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-env-file.yml b/deployment/ansible/playbooks/check-env-file.yml
new file mode 100644
index 00000000..cdc342db
--- /dev/null
+++ b/deployment/ansible/playbooks/check-env-file.yml
@@ -0,0 +1,83 @@
+---
+- name: Check .env File and Environment Variables
+  hosts: production
+  gather_facts: no
+  become: no
+
+  vars:
+    application_stack_dest: "{{ app_stack_path | default(stacks_base_path + '/production') }}"
+    application_compose_suffix: "production.yml"
+
+  tasks:
+    - name: Check if .env file exists
+      stat:
+        path: "{{ application_stack_dest }}/.env"
+      delegate_to: "{{ inventory_hostname }}"
+      register: env_file_exists
+
+    - name: Display .env file status
+      debug:
+        msg: ".env file exists: {{ env_file_exists.stat.exists }}"
+
+    - name: Read .env file content (first 50 lines)
+      shell: |
+        head -50 {{ application_stack_dest }}/.env 2>&1 || echo "FILE_NOT_FOUND"
+      delegate_to: "{{ inventory_hostname }}"
+      register: env_file_content
+      changed_when: false
+      when: env_file_exists.stat.exists
+
+    - name: Display .env file content
+      debug:
+        msg: |
+          .env file content:
+          {{ env_file_content.stdout }}
+
+    - name: Check for DB_DATABASE in .env file
+      shell: |
+        grep -E "^DB_DATABASE=|^DB_NAME=" {{ application_stack_dest }}/.env 2>&1 || echo "NOT_FOUND"
+      delegate_to: "{{ inventory_hostname }}"
+      register: db_database_check
+      changed_when: false
+      when: env_file_exists.stat.exists
+
+    - name: Display DB_DATABASE check
+      debug:
+        msg: "DB_DATABASE in .env: {{ db_database_check.stdout }}"
+
+    - name: Check environment variables in queue-worker container
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} exec -T queue-worker env | grep -E "^DB_" | sort
+      register: queue_worker_env
+      changed_when: false
+      failed_when: false
+      ignore_errors: yes
+
+    - name: Display queue-worker environment variables
+      debug:
+        msg: |
+          Queue-Worker DB Environment Variables:
+          {{ queue_worker_env.stdout | default('CONTAINER_NOT_RUNNING') }}
+
+    - name: Check docker-compose project directory
+      shell: |
+        cd {{ application_stack_dest }} && pwd
+      delegate_to: "{{ inventory_hostname }}"
+      register: project_dir
+      changed_when: false
+
+    - name: Display project directory
+      debug:
+        msg: "Docker Compose project directory: {{ project_dir.stdout }}"
+
+    - name: Check if .env file is in project directory
+      shell: |
+        test -f {{ application_stack_dest }}/.env && echo "EXISTS" || echo "MISSING"
+      delegate_to: "{{ inventory_hostname }}"
+      register: env_in_project_dir
+      changed_when: false
+
+    - name: Display .env file location check
+      debug:
+        msg: ".env file in project directory: {{ env_in_project_dir.stdout }}"
+
diff --git a/deployment/ansible/playbooks/check-final-status.yml b/deployment/ansible/playbooks/check-final-status.yml
new file mode 100644
index 00000000..69ed470f
--- /dev/null
+++ b/deployment/ansible/playbooks/check-final-status.yml
@@ -0,0 +1,18 @@
+---
+# Check Final Container Status
+# Wrapper Playbook for application role health_check tasks (final status)
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_health_check_final: true
+    application_health_check_logs_tail: 5
+  tasks:
+    - name: Include application health_check tasks (final)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: health_check
+  tags:
+    - application
+    - health
+    - final
diff --git a/deployment/ansible/playbooks/check-git-logs.yml b/deployment/ansible/playbooks/check-git-logs.yml
deleted file mode 100644
index af3c5ba0..00000000
--- a/deployment/ansible/playbooks/check-git-logs.yml
+++ /dev/null
@@ -1,68 +0,0 @@
----
-- name: Check Git Deployment Logs
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Get full container logs
-      shell: |
-        docker logs app --tail 100
-      args:
-        executable: /bin/bash
-      register: container_logs
-      changed_when: false
-
-    - name: Get Git-related logs
-      shell: |
-        docker logs app --tail 100 | grep -E "(Git|Clone|Pull|✅|❌|📥|📦|🔄|🗑️)" || echo "No Git-related logs found"
-      args:
-        executable: /bin/bash
-      register: git_logs
-      changed_when: false
-
-    - name: Check GIT_REPOSITORY_URL environment variable
-      shell: |
-        docker exec app env | grep GIT_REPOSITORY_URL || echo "GIT_REPOSITORY_URL not set"
-      args:
-        executable: /bin/bash
-      register: git_env
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check if .git directory exists
-      shell: |
-        docker exec app test -d /var/www/html/.git && echo "✅ Git repo vorhanden" || echo "❌ Git repo fehlt"
-      args:
-        executable: /bin/bash
-      register: git_repo_check
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check entrypoint script for Git functionality
-      shell: |
-        docker exec app cat /usr/local/bin/entrypoint.sh | grep -A 5 "GIT_REPOSITORY_URL" | head -10 || echo "Entrypoint script not found or no Git functionality"
-      args:
-        executable: /bin/bash
-      register: entrypoint_check
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Display Git-related logs
-      debug:
-        msg:
-          - "=== Git-Related Logs ==="
-          - "{{ git_logs.stdout }}"
-          - ""
-          - "=== Git Environment Variable ==="
-          - "{{ git_env.stdout }}"
-          - ""
-          - "=== Git Repository Check ==="
-          - "{{ git_repo_check.stdout }}"
-          - ""
-          - "=== Entrypoint Git Check ==="
-          - "{{ entrypoint_check.stdout }}"
-
-    - name: Display full logs (last 50 lines)
-      debug:
-        msg: "{{ container_logs.stdout_lines[-50:] | join('\n') }}"
diff --git a/deployment/ansible/playbooks/check-gitea-bad-gateway.yml b/deployment/ansible/playbooks/check-gitea-bad-gateway.yml
deleted file mode 100644
index 17717362..00000000
--- a/deployment/ansible/playbooks/check-gitea-bad-gateway.yml
+++ /dev/null
@@ -1,192 +0,0 @@
----
-- name: Diagnose Gitea Bad Gateway Issue
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    gitea_stack_path: "{{ stacks_base_path }}/gitea"
-
-  tasks:
-    - name: Check if Gitea stack directory exists
-      stat:
-        path: "{{ gitea_stack_path }}"
-      register: gitea_stack_dir
-
-    - name: Display Gitea stack directory status
-      debug:
-        msg: "Gitea stack path: {{ gitea_stack_path }} - Exists: {{ gitea_stack_dir.stat.exists }}"
-
-    - name: Check Gitea container status
-      shell: |
-        cd {{ gitea_stack_path }}
-        echo "=== Gitea Container Status ==="
-        docker compose ps 2>&1 || echo "Could not check container status"
-      args:
-        executable: /bin/bash
-      register: gitea_status
-      ignore_errors: yes
-      failed_when: false
-      when: gitea_stack_dir.stat.exists
-
-    - name: Display Gitea container status
-      debug:
-        msg: "{{ gitea_status.stdout_lines }}"
-      when: gitea_stack_dir.stat.exists
-
-    - name: Check if Gitea container is running
-      shell: |
-        docker ps --filter name=gitea --format "{{ '{{' }}.Names{{ '}}' }}: {{ '{{' }}.Status{{ '}}' }}"
-      register: gitea_running
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Gitea running status
-      debug:
-        msg: "{{ gitea_running.stdout_lines if gitea_running.stdout else 'Gitea container not found' }}"
-
-    - name: Check Gitea logs (last 50 lines)
-      shell: |
-        cd {{ gitea_stack_path }}
-        echo "=== Gitea Logs (Last 50 lines) ==="
-        docker compose logs --tail=50 gitea 2>&1 || echo "Could not read Gitea logs"
-      args:
-        executable: /bin/bash
-      register: gitea_logs
-      ignore_errors: yes
-      failed_when: false
-      when: gitea_stack_dir.stat.exists
-
-    - name: Display Gitea logs
-      debug:
-        msg: "{{ gitea_logs.stdout_lines }}"
-      when: gitea_stack_dir.stat.exists
-
-    - name: Check Gitea container health
-      shell: |
-        docker inspect gitea --format '{{ '{{' }}.State.Health.Status{{ '}}' }}' 2>&1 || echo "Could not check health"
-      register: gitea_health
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Gitea health status
-      debug:
-        msg: "Gitea health: {{ gitea_health.stdout }}"
-
-    - name: Test Gitea health endpoint from container
-      shell: |
-        docker exec gitea curl -f http://localhost:3000/api/healthz 2>&1 || echo "Health check failed"
-      register: gitea_internal_health
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display internal health check result
-      debug:
-        msg: "{{ gitea_internal_health.stdout_lines }}"
-
-    - name: Check if Gitea is reachable from Traefik network
-      shell: |
-        docker exec traefik curl -f http://gitea:3000/api/healthz 2>&1 || echo "Could not reach Gitea from Traefik network"
-      register: gitea_from_traefik
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik to Gitea connectivity
-      debug:
-        msg: "{{ gitea_from_traefik.stdout_lines }}"
-
-    - name: Check Traefik logs for Gitea errors
-      shell: |
-        cd {{ stacks_base_path }}/traefik
-        echo "=== Traefik Logs - Gitea related (Last 30 lines) ==="
-        docker compose logs --tail=100 traefik 2>&1 | grep -i "gitea" | tail -30 || echo "No Gitea-related logs found"
-      args:
-        executable: /bin/bash
-      register: traefik_gitea_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik Gitea logs
-      debug:
-        msg: "{{ traefik_gitea_logs.stdout_lines }}"
-
-    - name: Check Docker networks
-      shell: |
-        echo "=== Docker Networks ==="
-        docker network ls
-        echo ""
-        echo "=== Traefik Network Details ==="
-        docker network inspect traefik-public 2>&1 | grep -E "(Name|Subnet|Containers|gitea)" || echo "Could not inspect traefik-public network"
-      args:
-        executable: /bin/bash
-      register: network_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display network info
-      debug:
-        msg: "{{ network_info.stdout_lines }}"
-
-    - name: Check if Gitea is in traefik-public network
-      shell: |
-        docker network inspect traefik-public 2>&1 | grep -i "gitea" || echo "Gitea not found in traefik-public network"
-      register: gitea_in_network
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Gitea network membership
-      debug:
-        msg: "{{ gitea_in_network.stdout_lines }}"
-
-    - name: Check Gitea container configuration
-      shell: |
-        echo "=== Gitea Container Labels ==="
-        docker inspect gitea --format '{{ '{{' }}range .Config.Labels{{ '}}' }}{{ '{{' }}.Key{{ '}}' }}={{ '{{' }}.Value{{ '}}' }}{{ '{{' }}\n{{ '}}' }}{{ '{{' }}end{{ '}}' }}' 2>&1 | grep -i traefik || echo "No Traefik labels found"
-      register: gitea_labels
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Gitea labels
-      debug:
-        msg: "{{ gitea_labels.stdout_lines }}"
-
-    - name: Check Traefik service registration
-      shell: |
-        docker exec traefik wget -qO- http://localhost:8080/api/http/services 2>&1 | grep -i gitea || echo "Gitea service not found in Traefik API"
-      register: traefik_service
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik service registration
-      debug:
-        msg: "{{ traefik_service.stdout_lines }}"
-
-    - name: Test external Gitea access
-      shell: |
-        echo "=== Testing External Gitea Access ==="
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP Status: %{http_code}\n" https://git.michaelschiemer.de/ 2>&1 || echo "Connection failed"
-      args:
-        executable: /bin/bash
-      register: external_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display external test result
-      debug:
-        msg: "{{ external_test.stdout_lines }}"
-
-    - name: Summary
-      debug:
-        msg:
-          - "=== DIAGNOSIS SUMMARY ==="
-          - "1. Check if Gitea container is running"
-          - "2. Check if Gitea is in traefik-public network"
-          - "3. Check Gitea health endpoint (port 3000)"
-          - "4. Check Traefik can reach Gitea"
-          - "5. Check Traefik logs for errors"
-          - ""
-          - "Common issues:"
-          - "- Container not running: Restart with 'docker compose up -d' in {{ gitea_stack_path }}"
-          - "- Not in network: Recreate container or add to network"
-          - "- Health check failing: Check Gitea logs for errors"
-          - "- Traefik can't reach: Check network configuration"
diff --git a/deployment/ansible/playbooks/check-grafana-after-test.yml b/deployment/ansible/playbooks/check-grafana-after-test.yml
deleted file mode 100644
index fa7c0c79..00000000
--- a/deployment/ansible/playbooks/check-grafana-after-test.yml
+++ /dev/null
@@ -1,68 +0,0 @@
----
-- name: Check Grafana Logs After Test
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Check last 20 Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -200 logs/access.log | grep -i grafana | tail -20
-      args:
-        executable: /bin/bash
-      register: latest_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Extract client IPs with timestamps
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if [[ "$client" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [[ "$client" == "89.246.96.244" ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? ?ffentliche IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unbekannt"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
-
-    - name: Get unique client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Final result
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Pr?fe die obigen Zeilen:"
-          - ""
-          - "? Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN!"
-          - "   ? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "? Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN"
-          - "   ? Dann m?ssen wir weiter debuggen"
diff --git a/deployment/ansible/playbooks/check-latest-grafana-access.yml b/deployment/ansible/playbooks/check-latest-grafana-access.yml
deleted file mode 100644
index 13693f2e..00000000
--- a/deployment/ansible/playbooks/check-latest-grafana-access.yml
+++ /dev/null
@@ -1,55 +0,0 @@
----
-- name: Check Latest Grafana Access - Client IP Analysis
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Get latest Grafana access logs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Latest 5 Grafana Access Logs ==="
-        tail -100 logs/access.log | grep -i grafana | tail -5
-      args:
-        executable: /bin/bash
-      register: latest_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Extract client IPs from latest logs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -50 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: client_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display latest logs
-      debug:
-        msg: "{{ latest_logs.stdout_lines }}"
-
-    - name: Display client IPs
-      debug:
-        msg: "{{ client_ips.stdout_lines }}"
-
-    - name: Analyze if traffic comes from VPN
-      shell: |
-        cd ~/deployment/stacks/traefik
-        if tail -20 logs/access.log | grep -i grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | grep -q "10.8.0"; then
-          echo "? Traffic kommt ?ber VPN! (ClientHost: 10.8.0.x)"
-        elif tail -20 logs/access.log | grep -i grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | grep -q "89.246.96.244"; then
-          echo "? Traffic kommt NICHT ?ber VPN (ClientHost: 89.246.96.244 - ?ffentliche IP)"
-        else
-          echo "?? Keine aktuellen Grafana-Logs gefunden. Bitte mache einen Zugriff auf https://grafana.michaelschiemer.de"
-        fi
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-php-files-and-workers.yml b/deployment/ansible/playbooks/check-php-files-and-workers.yml
deleted file mode 100644
index aa3c2449..00000000
--- a/deployment/ansible/playbooks/check-php-files-and-workers.yml
+++ /dev/null
@@ -1,78 +0,0 @@
----
-- name: Check PHP Files and PHP-FPM Workers
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if public/index.php exists
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Check public/index.php ==="
-        docker compose exec -T staging-app ls -la /var/www/html/public/index.php 2>&1 || echo "index.php not found"
-        echo ""
-        echo "=== Check public directory ==="
-        docker compose exec -T staging-app ls -la /var/www/html/public/ 2>&1 | head -20 || echo "public directory not found"
-        echo ""
-        echo "=== Check if code directory exists ==="
-        docker compose exec -T staging-app ls -la /var/www/html/ 2>&1 | head -20 || echo "Code directory not found"
-      args:
-        executable: /bin/bash
-      register: file_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display file check results
-      debug:
-        msg: "{{ file_check.stdout_lines }}"
-
-    - name: Check PHP-FPM worker processes in detail
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== All processes in staging-app ==="
-        docker compose exec -T staging-app ps aux 2>&1 || echo "Could not get processes"
-        echo ""
-        echo "=== Check PHP-FPM master and worker processes ==="
-        docker compose exec -T staging-app sh -c "ps aux | grep -E '[p]hp|[f]pm' || echo 'No PHP-FPM processes found'" || echo "Process check failed"
-      args:
-        executable: /bin/bash
-      register: process_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display process check results
-      debug:
-        msg: "{{ process_check.stdout_lines }}"
-
-    - name: Test PHP execution directly
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Test PHP CLI ==="
-        docker compose exec -T staging-app php -v 2>&1 || echo "PHP CLI failed"
-        echo ""
-        echo "=== Test if we can include index.php ==="
-        docker compose exec -T staging-app php -r "if(file_exists('/var/www/html/public/index.php')) { echo 'index.php exists\n'; } else { echo 'index.php NOT FOUND\n'; }" 2>&1 || echo "PHP test failed"
-      args:
-        executable: /bin/bash
-      register: php_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP test results
-      debug:
-        msg: "{{ php_test.stdout_lines }}"
-
-    - name: Check PHP-FPM pool status using status page
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Try to get PHP-FPM status ==="
-        docker compose exec -T staging-app sh -c "SCRIPT_NAME=/status SCRIPT_FILENAME=/status REQUEST_METHOD=GET timeout 2 php -r \"\\\$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); if (socket_connect(\\\$socket, '127.0.0.1', 9000)) { socket_write(\\\$socket, 'GET /status HTTP/1.0\\r\\nHost: localhost\\r\\n\\r\\n'); \\\$response = socket_read(\\\$socket, 1024); echo \\\$response; socket_close(\\\$socket); } else { echo 'Could not connect to PHP-FPM'; }\" 2>&1" || echo "Status check failed"
-      args:
-        executable: /bin/bash
-      register: fpm_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM status
-      debug:
-        msg: "{{ fpm_status.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-phpfpm-config.yml b/deployment/ansible/playbooks/check-phpfpm-config.yml
deleted file mode 100644
index dbb1e758..00000000
--- a/deployment/ansible/playbooks/check-phpfpm-config.yml
+++ /dev/null
@@ -1,80 +0,0 @@
----
-- name: Check PHP-FPM Configuration in Detail
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check PHP-FPM pool configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== PHP-FPM www.conf listen configuration ==="
-        docker compose exec -T staging-app cat /usr/local/etc/php-fpm.d/www.conf 2>&1 | grep -E "(listen|listen.allowed_clients|listen.owner|listen.group|listen.mode|pm)" | head -20
-        echo ""
-        echo "=== Check PHP-FPM processes ==="
-        docker compose exec -T staging-app ps aux | grep php-fpm || echo "No php-fpm processes found"
-        echo ""
-        echo "=== Check PHP-FPM status page ==="
-        docker compose exec -T staging-app sh -c "SCRIPT_NAME=/status SCRIPT_FILENAME=/status REQUEST_METHOD=GET cgi-fcgi -bind -connect 127.0.0.1:9000 2>&1 || echo 'Status check failed'"
-      args:
-        executable: /bin/bash
-      register: phpfpm_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM configuration
-      debug:
-        msg: "{{ phpfpm_config.stdout_lines }}"
-
-    - name: Check what interface PHP-FPM is listening on
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Check listening interface ==="
-        docker compose exec -T staging-app netstat -tlnp 2>/dev/null | grep 9000 || \
-        docker compose exec -T staging-app ss -tlnp 2>/dev/null | grep 9000 || \
-        echo "Could not check listening interface"
-        echo ""
-        echo "=== Try to connect from nginx using FastCGI protocol ==="
-        docker compose exec -T staging-nginx sh -c "echo -e 'REQUEST_METHOD=GET\nSCRIPT_FILENAME=/var/www/html/public/index.php\n' | cgi-fcgi -bind -connect staging-app:9000 2>&1 | head -20" || echo "FastCGI test failed"
-      args:
-        executable: /bin/bash
-      register: listen_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display listening interface check
-      debug:
-        msg: "{{ listen_check.stdout_lines }}"
-
-    - name: Check PHP-FPM error logs
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== PHP-FPM error log ==="
-        docker compose exec -T staging-app tail -50 /var/log/php-fpm.log 2>&1 || \
-        docker compose exec -T staging-app tail -50 /usr/local/var/log/php-fpm.log 2>&1 || \
-        docker compose logs --tail=100 staging-app 2>&1 | grep -iE "(fpm|error|warning)" | tail -20 || \
-        echo "No PHP-FPM error logs found"
-      args:
-        executable: /bin/bash
-      register: phpfpm_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM errors
-      debug:
-        msg: "{{ phpfpm_errors.stdout_lines }}"
-
-    - name: Test actual request from outside
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Test request from nginx to PHP-FPM ==="
-        docker compose exec -T staging-nginx sh -c "curl -v http://127.0.0.1/ 2>&1 | head -30" || echo "Request test failed"
-      args:
-        executable: /bin/bash
-      register: request_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display request test
-      debug:
-        msg: "{{ request_test.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-production-status.yml b/deployment/ansible/playbooks/check-production-status.yml
deleted file mode 100644
index c71cdb23..00000000
--- a/deployment/ansible/playbooks/check-production-status.yml
+++ /dev/null
@@ -1,147 +0,0 @@
----
-- name: Check Production Server Status
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check server uptime and basic info
-      shell: |
-        echo "=== Server Uptime ==="
-        uptime
-        echo ""
-        echo "=== Disk Space ==="
-        df -h
-        echo ""
-        echo "=== Memory Usage ==="
-        free -h
-        echo ""
-        echo "=== Docker Status ==="
-        docker --version || echo "Docker not found"
-        docker ps || echo "Docker not running"
-      args:
-        executable: /bin/bash
-      register: server_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display server info
-      debug:
-        msg: "{{ server_info.stdout_lines }}"
-
-    - name: Check all Docker stacks status
-      shell: |
-        echo "=== Traefik Stack ==="
-        cd ~/deployment/stacks/traefik && docker compose ps 2>&1 || echo "Traefik stack not found or not running"
-        echo ""
-        echo "=== Application Stack ==="
-        cd ~/deployment/stacks/application && docker compose ps 2>&1 || echo "Application stack not found or not running"
-        echo ""
-        echo "=== PostgreSQL Stack ==="
-        cd ~/deployment/stacks/postgresql && docker compose ps 2>&1 || echo "PostgreSQL stack not found or not running"
-        echo ""
-        echo "=== Monitoring Stack ==="
-        cd ~/deployment/stacks/monitoring && docker compose ps 2>&1 || echo "Monitoring stack not found or not running"
-        echo ""
-        echo "=== Gitea Stack ==="
-        cd ~/deployment/stacks/gitea && docker compose ps 2>&1 || echo "Gitea stack not found or not running"
-        echo ""
-        echo "=== Registry Stack ==="
-        cd ~/deployment/stacks/registry && docker compose ps 2>&1 || echo "Registry stack not found or not running"
-      args:
-        executable: /bin/bash
-      register: stacks_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display stacks status
-      debug:
-        msg: "{{ stacks_status.stdout_lines }}"
-
-    - name: Check Traefik logs for errors
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Traefik Logs (Last 30 lines) ==="
-        docker compose logs --tail=30 traefik 2>&1 | tail -30 || echo "Could not read Traefik logs"
-      args:
-        executable: /bin/bash
-      register: traefik_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik logs
-      debug:
-        msg: "{{ traefik_logs.stdout_lines }}"
-
-    - name: Check Application stack logs
-      shell: |
-        cd ~/deployment/stacks/application
-        echo "=== Application Nginx Logs (Last 20 lines) ==="
-        docker compose logs --tail=20 web 2>&1 | tail -20 || echo "Could not read web logs"
-        echo ""
-        echo "=== Application PHP Logs (Last 20 lines) ==="
-        docker compose logs --tail=20 php 2>&1 | tail -20 || echo "Could not read PHP logs"
-      args:
-        executable: /bin/bash
-      register: app_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display application logs
-      debug:
-        msg: "{{ app_logs.stdout_lines }}"
-
-    - name: Test HTTP connectivity
-      shell: |
-        echo "=== Testing HTTP Connectivity ==="
-        echo "Test 1: HTTPS to michaelschiemer.de"
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP %{http_code}\n" https://michaelschiemer.de/health || echo "Connection failed"
-        echo ""
-        echo "Test 2: Direct localhost"
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP %{http_code}\n" https://localhost/health || echo "Connection failed"
-      args:
-        executable: /bin/bash
-      register: http_tests
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display HTTP test results
-      debug:
-        msg: "{{ http_tests.stdout_lines }}"
-
-    - name: Check network connectivity
-      shell: |
-        echo "=== Network Interfaces ==="
-        ip addr show | grep -E "(inet |state)" | head -10
-        echo ""
-        echo "=== Docker Networks ==="
-        docker network ls
-        echo ""
-        echo "=== Traefik Network Connectivity ==="
-        docker network inspect traefik-public 2>&1 | grep -E "(Name|Subnet|Containers)" | head -10 || echo "Traefik network not found"
-      args:
-        executable: /bin/bash
-      register: network_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display network info
-      debug:
-        msg: "{{ network_info.stdout_lines }}"
-
-    - name: Check firewall status
-      shell: |
-        echo "=== Firewall Status ==="
-        sudo ufw status || echo "UFW not installed or not configured"
-        echo ""
-        echo "=== Listening Ports ==="
-        sudo netstat -tlnp | grep -E "(80|443|8080|3000)" | head -10 || ss -tlnp | grep -E "(80|443|8080|3000)" | head -10 || echo "Could not check listening ports"
-      args:
-        executable: /bin/bash
-      register: firewall_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display firewall info
-      debug:
-        msg: "{{ firewall_info.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-redis-connection.yml b/deployment/ansible/playbooks/check-redis-connection.yml
deleted file mode 100644
index 10f96900..00000000
--- a/deployment/ansible/playbooks/check-redis-connection.yml
+++ /dev/null
@@ -1,193 +0,0 @@
----
-- name: Check Redis Connection and Environment Variables in PHP Container
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if application stack is running
-      shell: |
-        cd ~/deployment/stacks/application
-        docker compose ps
-      args:
-        executable: /bin/bash
-      register: stack_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display stack status
-      debug:
-        msg: "{{ stack_status.stdout_lines }}"
-
-    - name: Check PHP container exists
-      shell: |
-        docker ps --filter "name=app"
-      args:
-        executable: /bin/bash
-      register: php_container
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP container status
-      debug:
-        msg: "{{ php_container.stdout_lines }}"
-
-    - name: Check Environment Variables in PHP Container
-      shell: |
-        echo "=== Redis Environment Variables in PHP Container ==="
-        docker exec app env | grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" || echo "Container not accessible or no Redis vars found"
-        echo ""
-        echo "=== All Environment Variables in PHP Container ==="
-        docker exec app env | sort | head -50 || echo "Container not accessible"
-      args:
-        executable: /bin/bash
-      register: env_vars
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display environment variables
-      debug:
-        msg: "{{ env_vars.stdout_lines }}"
-
-    - name: Test Redis Connection from PHP Container
-      shell: |
-        echo "=== Testing Redis Connection from PHP Container ==="
-        echo "Test 1: Check if Redis is reachable"
-        docker exec app php -r "
-          \$redis_host = getenv('REDIS_HOST') ?: 'redis';
-          \$redis_port = (int)(getenv('REDIS_PORT') ?: 6379);
-          \$redis_password = getenv('REDIS_PASSWORD');
-          
-          echo \"REDIS_HOST: \" . \$redis_host . \"\\n\";
-          echo \"REDIS_PORT: \" . \$redis_port . \"\\n\";
-          echo \"REDIS_PASSWORD: \" . (\$redis_password ? 'SET (length: ' . strlen(\$redis_password) . ')' : 'NOT SET') . \"\\n\";
-          
-          // Test TCP connection
-          \$socket = @fsockopen(\$redis_host, \$redis_port, \$errno, \$errstr, 2);
-          if (\$socket) {
-            echo \"TCP Connection: OK\\n\";
-            fclose(\$socket);
-          } else {
-            echo \"TCP Connection: FAILED (errno: \$errno, errstr: \$errstr)\\n\";
-          }
-          
-          // Test with Predis if available
-          if (class_exists('Predis\\Client')) {
-            try {
-              \$client = new Predis\\Client([
-                'scheme' => 'tcp',
-                'host' => \$redis_host,
-                'port' => \$redis_port,
-                'password' => \$redis_password ?: null,
-              ]);
-              \$client->connect();
-              echo \"Predis Connection: OK\\n\";
-              echo \"Redis PING: \" . \$client->ping() . \"\\n\";
-              \$client->disconnect();
-            } catch (Exception \$e) {
-              echo \"Predis Connection: FAILED - \" . \$e->getMessage() . \"\\n\";
-            }
-          } else {
-            echo \"Predis not available\\n\";
-          }
-        " || echo "Could not execute PHP test"
-      args:
-        executable: /bin/bash
-      register: redis_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis connection test results
-      debug:
-        msg: "{{ redis_test.stdout_lines }}"
-
-    - name: Check Redis Container Configuration
-      shell: |
-        echo "=== Redis Container Status ==="
-        docker ps --filter "name=redis"
-        echo ""
-        echo "=== Redis Container Environment ==="
-        docker exec redis env | grep -E "(REDIS_|REQUIREPASS)" || echo "No Redis env vars found"
-        echo ""
-        echo "=== Test Redis Password ==="
-        REDIS_PASSWORD=$(cd ~/deployment/stacks/application && grep REDIS_PASSWORD .env | cut -d '=' -f2 | tr -d ' ' || echo "")
-        if [ -n "$REDIS_PASSWORD" ]; then
-          PASSWORD_LEN=$(echo -n "$REDIS_PASSWORD" | wc -c)
-          echo "REDIS_PASSWORD from .env file: SET (length: $PASSWORD_LEN)"
-          docker exec redis redis-cli -a "$REDIS_PASSWORD" PING || echo "Redis password test failed"
-        else
-          echo "REDIS_PASSWORD from .env file: NOT SET"
-          docker exec redis redis-cli PING || echo "Redis connection test failed (no password)"
-        fi
-      args:
-        executable: /bin/bash
-      register: redis_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis container configuration
-      debug:
-        msg: "{{ redis_config.stdout_lines }}"
-
-    - name: Check Docker Network Connectivity
-      shell: |
-        echo "=== Docker Network: app-internal ==="
-        docker network inspect app-internal 2>&1 | grep -E "(Name|Subnet|Containers)" | head -20 || echo "Network not found"
-        echo ""
-        echo "=== Testing Network Connectivity ==="
-        echo "From PHP container to Redis:"
-        docker exec app ping -c 2 redis 2>&1 || echo "Ping test failed"
-        echo ""
-        echo "From PHP container to Redis (port 6379):"
-        docker exec app nc -zv redis 6379 2>&1 || echo "Port test failed"
-      args:
-        executable: /bin/bash
-      register: network_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display network connectivity test
-      debug:
-        msg: "{{ network_test.stdout_lines }}"
-
-    - name: Check Application Logs for Redis Errors
-      shell: |
-        cd ~/deployment/stacks/application
-        echo "=== Application Logs (Last 50 lines, Redis-related) ==="
-        docker compose logs app --tail=50 2>&1 | grep -i redis || echo "No Redis-related logs found"
-      args:
-        executable: /bin/bash
-      register: app_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display application logs
-      debug:
-        msg: "{{ app_logs.stdout_lines }}"
-
-    - name: Check .env file configuration
-      shell: |
-        cd ~/deployment/stacks/application
-        echo "=== .env file Redis Configuration ==="
-        if [ -f .env ]; then
-          grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" .env | grep -v "^#" || echo "No Redis config found in .env"
-        else
-          echo ".env file not found"
-        fi
-        echo ""
-        echo "=== Checking for application.env file ==="
-        if [ -f application.env ]; then
-          echo "application.env exists"
-          grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" application.env | grep -v "^#" || echo "No Redis config found in application.env"
-        else
-          echo "application.env file not found"
-        fi
-      args:
-        executable: /bin/bash
-      register: env_file_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display .env file configuration
-      debug:
-        msg: "{{ env_file_config.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-staging-500-error.yml b/deployment/ansible/playbooks/check-staging-500-error.yml
deleted file mode 100644
index 28c8fbcd..00000000
--- a/deployment/ansible/playbooks/check-staging-500-error.yml
+++ /dev/null
@@ -1,49 +0,0 @@
----
-- name: Check Staging 500 Error
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Get recent PHP errors from staging-app
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Recent PHP errors (last 50 lines) ==="
-        docker compose exec -T staging-app tail -100 /var/www/html/storage/logs/php-errors.log 2>&1 | tail -50
-      args:
-        executable: /bin/bash
-      register: php_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP errors
-      debug:
-        msg: "{{ php_errors.stdout_lines }}"
-
-    - name: Get docker compose logs for staging-app
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Recent staging-app container logs ==="
-        docker compose logs --tail=50 staging-app 2>&1 | tail -50
-      args:
-        executable: /bin/bash
-      register: container_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display container logs
-      debug:
-        msg: "{{ container_logs.stdout_lines }}"
-
-    - name: Test health endpoint
-      shell: |
-        curl -H "User-Agent: Mozilla/5.0" -s https://staging.michaelschiemer.de/health 2>&1
-      args:
-        executable: /bin/bash
-      register: health_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display health endpoint result
-      debug:
-        msg: "{{ health_test.stdout }}"
diff --git a/deployment/ansible/playbooks/check-staging-logs.yml b/deployment/ansible/playbooks/check-staging-logs.yml
deleted file mode 100644
index 41b17361..00000000
--- a/deployment/ansible/playbooks/check-staging-logs.yml
+++ /dev/null
@@ -1,66 +0,0 @@
----
-- name: Check Staging Container Logs
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check staging container status
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose ps
-      args:
-        executable: /bin/bash
-      register: container_status
-      changed_when: false
-
-    - name: Get staging-app logs
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=100 staging-app
-      args:
-        executable: /bin/bash
-      register: staging_app_logs
-      changed_when: false
-
-    - name: Get staging-nginx logs
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=100 staging-nginx
-      args:
-        executable: /bin/bash
-      register: staging_nginx_logs
-      changed_when: false
-
-    - name: Get staging-queue-worker logs
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=100 staging-queue-worker
-      args:
-        executable: /bin/bash
-      register: staging_queue_logs
-      changed_when: false
-
-    - name: Get staging-scheduler logs
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=100 staging-scheduler
-      args:
-        executable: /bin/bash
-      register: staging_scheduler_logs
-      changed_when: false
-
-    - name: Display container status
-      debug:
-        msg: "{{ container_status.stdout_lines }}"
-
-    - name: Display staging-app logs
-      debug:
-        msg: "{{ staging_app_logs.stdout_lines }}"
-
-    - name: Display staging-nginx logs
-      debug:
-        msg: "{{ staging_nginx_logs.stdout_lines }}"
-
-    - name: Display staging-queue-worker logs
-      debug:
-        msg: "{{ staging_queue_logs.stdout_lines }}"
-
-    - name: Display staging-scheduler logs
-      debug:
-        msg: "{{ staging_scheduler_logs.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-staging-php-logs.yml b/deployment/ansible/playbooks/check-staging-php-logs.yml
deleted file mode 100644
index df759127..00000000
--- a/deployment/ansible/playbooks/check-staging-php-logs.yml
+++ /dev/null
@@ -1,66 +0,0 @@
----
-- name: Check Staging PHP Logs in Volume
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check PHP log files in staging-app container
-      shell: |
-        echo "=== Checking log directory in staging-app container ==="
-        docker exec staging-app ls -lah /var/www/html/storage/logs/ 2>&1 || echo "Could not list logs directory"
-        echo ""
-        echo "=== Recent PHP error logs ==="
-        docker exec staging-app tail -50 /var/www/html/storage/logs/php-errors.log 2>&1 | tail -30 || echo "Could not read php-errors.log"
-        echo ""
-        echo "=== Recent application logs ==="
-        docker exec staging-app find /var/www/html/storage/logs -name "*.log" -type f -exec ls -lh {} \; 2>&1 | head -20 || echo "Could not find log files"
-        echo ""
-        echo "=== Staging log file (if exists) ==="
-        docker exec staging-app tail -50 /var/www/html/storage/logs/staging.log 2>&1 | tail -30 || echo "staging.log not found or empty"
-        echo ""
-        echo "=== Check log volume mount ==="
-        docker exec staging-app df -h /var/www/html/storage/logs 2>&1 || echo "Could not check volume"
-      args:
-        executable: /bin/bash
-      register: php_logs_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP logs check results
-      debug:
-        msg: "{{ php_logs_check.stdout_lines }}"
-
-    - name: Check if we can access log volume directly
-      shell: |
-        echo "=== Docker volume inspect ==="
-        docker volume inspect staging-logs 2>&1 || echo "Volume not found"
-        echo ""
-        echo "=== Try to access volume through temporary container ==="
-        docker run --rm -v staging-logs:/logs alpine ls -lah /logs 2>&1 | head -30 || echo "Could not access volume"
-      args:
-        executable: /bin/bash
-      register: volume_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display volume check results
-      debug:
-        msg: "{{ volume_check.stdout_lines }}"
-
-    - name: Check PHP configuration for logging
-      shell: |
-        echo "=== PHP error_log setting ==="
-        docker exec staging-app php -i | grep -E "(error_log|log_errors)" || echo "Could not get PHP config"
-        echo ""
-        echo "=== PHP-FPM error log location ==="
-        docker exec staging-app grep -E "(error_log|catch_workers_output)" /usr/local/etc/php-fpm.d/www.conf | head -5 || echo "Could not read PHP-FPM config"
-      args:
-        executable: /bin/bash
-      register: php_config_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP configuration
-      debug:
-        msg: "{{ php_config_check.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-staging-redis-connection.yml b/deployment/ansible/playbooks/check-staging-redis-connection.yml
deleted file mode 100644
index d80b8f32..00000000
--- a/deployment/ansible/playbooks/check-staging-redis-connection.yml
+++ /dev/null
@@ -1,255 +0,0 @@
----
-- name: Check Redis Connection and Environment Variables in Staging PHP Container
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if staging stack is running
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose ps
-      args:
-        executable: /bin/bash
-      register: stack_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display stack status
-      debug:
-        msg: "{{ stack_status.stdout_lines }}"
-
-    - name: Check PHP container exists
-      shell: |
-        docker ps --filter "name=staging-app"
-      args:
-        executable: /bin/bash
-      register: php_container
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP container status
-      debug:
-        msg: "{{ php_container.stdout_lines }}"
-
-    - name: Check Environment Variables in Staging PHP Container
-      shell: |
-        echo "=== Redis Environment Variables in Staging PHP Container ==="
-        docker exec staging-app env | grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" || echo "Container not accessible or no Redis vars found"
-        echo ""
-        echo "=== All Environment Variables in Staging PHP Container ==="
-        docker exec staging-app env | sort | head -50 || echo "Container not accessible"
-      args:
-        executable: /bin/bash
-      register: env_vars
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display environment variables
-      debug:
-        msg: "{{ env_vars.stdout_lines }}"
-
-    - name: Test Redis Connection from Staging PHP Container
-      shell: |
-        echo "=== Testing Redis Connection from Staging PHP Container ==="
-        echo "Test 1: Check if Redis is reachable"
-        docker exec staging-app php -r "
-          \$redis_host = getenv('REDIS_HOST') ?: 'staging-redis';
-          \$redis_port = (int)(getenv('REDIS_PORT') ?: 6379);
-          \$redis_password = getenv('REDIS_PASSWORD');
-          
-          echo \\\"REDIS_HOST: \\\" . \$redis_host . \\\"\\\\n\\\";
-          echo \\\"REDIS_PORT: \\\" . \$redis_port . \\\"\\\\n\\\";
-          echo \\\"REDIS_PASSWORD: \\\" . (\$redis_password ? 'SET (length: ' . strlen(\$redis_password) . ')' : 'NOT SET') . \\\"\\\\n\\\";
-          
-          // Test TCP connection
-          \$socket = @fsockopen(\$redis_host, \$redis_port, \$errno, \$errstr, 2);
-          if (\$socket) {
-            echo \\\"TCP Connection: OK\\\\n\\\";
-            fclose(\$socket);
-          } else {
-            echo \\\"TCP Connection: FAILED (errno: \$errno, errstr: \$errstr)\\\\n\\\";
-          }
-        " || echo "Could not execute PHP test"
-      args:
-        executable: /bin/bash
-      register: redis_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis connection test results
-      debug:
-        msg: "{{ redis_test.stdout_lines }}"
-
-    - name: Test Redis connection with actual php-redis extension
-      shell: |
-        docker exec staging-app php -r "
-          // Get environment variables
-          \$redis_host = getenv('REDIS_HOST') ?: 'staging-redis';
-          \$redis_port = (int)(getenv('REDIS_PORT') ?: 6379);
-          \$redis_password = getenv('REDIS_PASSWORD');
-          
-          echo '=== Staging Redis Connection Test ===' . PHP_EOL;
-          echo 'REDIS_HOST: ' . \$redis_host . PHP_EOL;
-          echo 'REDIS_PORT: ' . \$redis_port . PHP_EOL;
-          echo 'REDIS_PASSWORD: ' . (\$redis_password ? 'SET (length: ' . strlen(\$redis_password) . ')' : 'NOT SET') . PHP_EOL;
-          echo PHP_EOL;
-          
-          if (!extension_loaded('redis')) {
-            echo 'ERROR: php-redis extension is not loaded!' . PHP_EOL;
-            exit(1);
-          }
-          
-          if (!class_exists('Redis')) {
-            echo 'ERROR: Redis class is not available!' . PHP_EOL;
-            exit(1);
-          }
-          
-          try {
-            \$redis = new Redis();
-            echo 'Created Redis instance' . PHP_EOL;
-            
-            // Connect
-            \$success = \$redis->connect(\$redis_host, \$redis_port, 2.0);
-            if (!\$success) {
-              echo 'ERROR: Failed to connect to Redis server' . PHP_EOL;
-              echo 'Host: ' . \$redis_host . ', Port: ' . \$redis_port . PHP_EOL;
-              exit(1);
-            }
-            echo 'Connected to Redis server' . PHP_EOL;
-            
-            // Authenticate if password is provided
-            if (\$redis_password) {
-              \$auth_result = \$redis->auth(\$redis_password);
-              if (!\$auth_result) {
-                echo 'ERROR: Redis authentication failed' . PHP_EOL;
-                echo 'Password used: ' . substr(\$redis_password, 0, 5) . '...' . PHP_EOL;
-                exit(1);
-              }
-              echo 'Authenticated with Redis' . PHP_EOL;
-            }
-            
-            // Test PING
-            \$ping_result = \$redis->ping();
-            echo 'Redis PING: ' . \$ping_result . PHP_EOL;
-            
-            // Test SET/GET
-            \$test_key = 'test_connection_' . time();
-            \$test_value = 'test_value';
-            \$set_result = \$redis->set(\$test_key, \$test_value);
-            echo 'SET test: ' . (\$set_result ? 'OK' : 'FAILED') . PHP_EOL;
-            
-            \$get_result = \$redis->get(\$test_key);
-            echo 'GET test: ' . (\$get_result === \$test_value ? 'OK' : 'FAILED') . PHP_EOL;
-            
-            // Cleanup
-            \$redis->del(\$test_key);
-            \$redis->close();
-            
-            echo PHP_EOL . '? All tests passed!' . PHP_EOL;
-          } catch (Exception \$e) {
-            echo 'ERROR: ' . \$e->getMessage() . PHP_EOL;
-            echo 'Exception type: ' . get_class(\$e) . PHP_EOL;
-            exit(1);
-          }
-        "
-      args:
-        executable: /bin/bash
-      register: redis_direct_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis direct connection test results
-      debug:
-        msg: "{{ redis_direct_test.stdout_lines }}"
-
-    - name: Check Staging Redis Container Configuration
-      shell: |
-        echo "=== Staging Redis Container Status ==="
-        docker ps --filter "name=staging-redis"
-        echo ""
-        echo "=== Staging Redis Container Environment ==="
-        docker exec staging-redis env | grep -E "(REDIS_|REQUIREPASS)" || echo "No Redis env vars found"
-        echo ""
-        echo "=== Test Redis Password ==="
-        REDIS_PASSWORD=$(cd ~/deployment/stacks/staging && grep REDIS_PASSWORD .env | cut -d '=' -f2 | tr -d ' ' || echo "")
-        if [ -n "$REDIS_PASSWORD" ]; then
-          PASSWORD_LEN=$(echo -n "$REDIS_PASSWORD" | wc -c)
-          echo "REDIS_PASSWORD from .env file: SET (length: $PASSWORD_LEN)"
-          docker exec staging-redis redis-cli -a "$REDIS_PASSWORD" PING || echo "Redis password test failed"
-        else
-          echo "REDIS_PASSWORD from .env file: NOT SET"
-          docker exec staging-redis redis-cli PING || echo "Redis connection test failed (no password)"
-        fi
-      args:
-        executable: /bin/bash
-      register: redis_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis container configuration
-      debug:
-        msg: "{{ redis_config.stdout_lines }}"
-
-    - name: Check Docker Network Connectivity for Staging
-      shell: |
-        echo "=== Docker Network: staging-internal ==="
-        docker network inspect staging-internal 2>&1 | grep -E "(Name|Subnet|Containers)" | head -20 || echo "Network not found"
-        echo ""
-        echo "=== Testing Network Connectivity ==="
-        echo "From Staging PHP container to Redis:"
-        docker exec staging-app php -r "echo gethostbyname('staging-redis') . PHP_EOL;" 2>&1 || echo "DNS test failed"
-        echo ""
-        echo "Testing connection from staging-app to staging-redis:"
-        docker exec staging-app php -r "\$socket = @fsockopen('staging-redis', 6379, \$errno, \$errstr, 2); if (\$socket) { echo 'Port 6379: OK' . PHP_EOL; fclose(\$socket); } else { echo 'Port 6379: FAILED (errno: ' . \$errno . ', errstr: ' . \$errstr . ')' . PHP_EOL; }"
-      args:
-        executable: /bin/bash
-      register: network_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display network connectivity test
-      debug:
-        msg: "{{ network_test.stdout_lines }}"
-
-    - name: Check Staging Application Logs for Redis Errors
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Staging Application Logs (Last 50 lines, Redis-related) ==="
-        docker compose logs staging-app --tail=50 2>&1 | grep -i -E "(redis|connection|error)" | tail -20 || echo "No Redis-related logs found"
-      args:
-        executable: /bin/bash
-      register: app_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display application logs
-      debug:
-        msg: "{{ app_logs.stdout_lines }}"
-
-    - name: Check Staging .env file configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== .env file Redis Configuration ==="
-        if [ -f .env ]; then
-          grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" .env | grep -v "^#" || echo "No Redis config found in .env"
-        else
-          echo ".env file not found"
-        fi
-        echo ""
-        echo "=== Checking for application.env file ==="
-        if [ -f application.env ]; then
-          echo "application.env exists"
-          grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" application.env | grep -v "^#" || echo "No Redis config found in application.env"
-        else
-          echo "application.env file not found"
-        fi
-      args:
-        executable: /bin/bash
-      register: env_file_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display .env file configuration
-      debug:
-        msg: "{{ env_file_config.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-staging-redis-env-file.yml b/deployment/ansible/playbooks/check-staging-redis-env-file.yml
deleted file mode 100644
index 0323d3a0..00000000
--- a/deployment/ansible/playbooks/check-staging-redis-env-file.yml
+++ /dev/null
@@ -1,135 +0,0 @@
----
-- name: Check Staging Redis Environment File and Container Password
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check .env file exists and contains REDIS_PASSWORD
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Checking .env file ==="
-        if [ -f .env ]; then
-          echo ".env file exists"
-          echo ""
-          echo "=== REDIS_PASSWORD from .env ==="
-          REDIS_PASSWORD_FROM_ENV=$(grep "^REDIS_PASSWORD=" .env | cut -d '=' -f2- | tr -d ' ' || echo "")
-          if [ -n "$REDIS_PASSWORD_FROM_ENV" ]; then
-            PASSWORD_LEN=$(echo -n "$REDIS_PASSWORD_FROM_ENV" | wc -c)
-            echo "REDIS_PASSWORD found in .env (length: $PASSWORD_LEN)"
-            echo "First 10 chars: ${REDIS_PASSWORD_FROM_ENV:0:10}..."
-            echo "Last 10 chars: ...${REDIS_PASSWORD_FROM_ENV: -10}"
-          else
-            echo "REDIS_PASSWORD NOT FOUND in .env file!"
-          fi
-        else
-          echo ".env file NOT FOUND!"
-        fi
-      args:
-        executable: /bin/bash
-      register: env_file_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display .env file check
-      debug:
-        msg: "{{ env_file_check.stdout_lines }}"
-
-    - name: Check how Redis container was started
-      shell: |
-        echo "=== Checking Redis container command ==="
-        docker inspect staging-redis --format '{{ '{{' }}.Config.Cmd{{ '}}' }}' || echo "Could not inspect container"
-        echo ""
-        echo "=== Checking if Redis actually requires password ==="
-        # Try without password first
-        docker exec staging-redis redis-cli PING 2>&1 || echo "Connection failed (expected if password required)"
-        echo ""
-        # Try with password from .env
-        cd ~/deployment/stacks/staging
-        REDIS_PASSWORD=$(grep "^REDIS_PASSWORD=" .env | cut -d '=' -f2- | tr -d ' ' || echo "")
-        if [ -n "$REDIS_PASSWORD" ]; then
-          echo "Testing with password from .env:"
-          docker exec staging-redis redis-cli -a "$REDIS_PASSWORD" PING 2>&1 || echo "Password test failed"
-        else
-          echo "Cannot test with password - REDIS_PASSWORD not found in .env"
-        fi
-      args:
-        executable: /bin/bash
-      register: redis_startup_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis startup check
-      debug:
-        msg: "{{ redis_startup_check.stdout_lines }}"
-
-    - name: Test actual connection from PHP container
-      shell: |
-        cd ~/deployment/stacks/staging
-        REDIS_PASSWORD_ENV=$(grep "^REDIS_PASSWORD=" .env | cut -d '=' -f2- | tr -d ' ' || echo "")
-        
-        docker exec staging-app php -r "
-          \$redis_host = 'staging-redis';
-          \$redis_port = 6379;
-          \$redis_password = getenv('REDIS_PASSWORD');
-          \$redis_password_env_file = '$REDIS_PASSWORD_ENV';
-          
-          echo '=== Password Comparison ===' . PHP_EOL;
-          echo 'REDIS_PASSWORD from environment: ' . (\$redis_password ? 'SET (length: ' . strlen(\$redis_password) . ')' : 'NOT SET') . PHP_EOL;
-          echo 'REDIS_PASSWORD from .env file: ' . (\$redis_password_env_file ? 'SET (length: ' . strlen(\$redis_password_env_file) . ')' : 'NOT SET') . PHP_EOL;
-          
-          if (\$redis_password && \$redis_password_env_file) {
-            if (\$redis_password === \$redis_password_env_file) {
-              echo 'Passwords MATCH!' . PHP_EOL;
-            } else {
-              echo 'Passwords DO NOT MATCH!' . PHP_EOL;
-              echo 'Env password first 10: ' . substr(\$redis_password, 0, 10) . PHP_EOL;
-              echo '.env password first 10: ' . substr(\$redis_password_env_file, 0, 10) . PHP_EOL;
-            }
-          }
-          
-          echo PHP_EOL . '=== Connection Test ===' . PHP_EOL;
-          
-          if (!extension_loaded('redis')) {
-            echo 'ERROR: php-redis extension not loaded!' . PHP_EOL;
-            exit(1);
-          }
-          
-          try {
-            \$redis = new Redis();
-            \$success = \$redis->connect(\$redis_host, \$redis_port, 2.0);
-            if (!\$success) {
-              echo 'ERROR: Failed to connect to Redis' . PHP_EOL;
-              exit(1);
-            }
-            echo 'Connected to Redis' . PHP_EOL;
-            
-            if (\$redis_password) {
-              \$auth_result = \$redis->auth(\$redis_password);
-              if (\$auth_result) {
-                echo 'Authentication: SUCCESS' . PHP_EOL;
-                \$ping = \$redis->ping();
-                echo 'PING: ' . \$ping . PHP_EOL;
-              } else {
-                echo 'Authentication: FAILED' . PHP_EOL;
-                echo 'Tried password: ' . substr(\$redis_password, 0, 10) . '...' . PHP_EOL;
-              }
-            } else {
-              echo 'WARNING: No password set in environment!' . PHP_EOL;
-            }
-            
-            \$redis->close();
-          } catch (Exception \$e) {
-            echo 'ERROR: ' . \$e->getMessage() . PHP_EOL;
-            exit(1);
-          }
-        "
-      args:
-        executable: /bin/bash
-      register: password_comparison
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display password comparison
-      debug:
-        msg: "{{ password_comparison.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-staging-status.yml b/deployment/ansible/playbooks/check-staging-status.yml
deleted file mode 100644
index bd27f9b0..00000000
--- a/deployment/ansible/playbooks/check-staging-status.yml
+++ /dev/null
@@ -1,52 +0,0 @@
----
-- name: Check Staging Status Complete
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check nginx error log for recent 502s
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx tail -20 /var/log/nginx/error.log 2>&1 | grep -E "(502|Bad Gateway|upstream)" || echo "No 502 errors in recent logs"
-      args:
-        executable: /bin/bash
-      register: nginx_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx errors
-      debug:
-        msg: "{{ nginx_errors.stdout_lines }}"
-
-    - name: Verify upstream configuration one more time
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default
-        docker compose exec -T staging-nginx grep "fastcgi_pass" /etc/nginx/sites-available/default | head -3
-      args:
-        executable: /bin/bash
-      register: upstream_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display upstream check
-      debug:
-        msg: "{{ upstream_check.stdout_lines }}"
-
-    - name: Test multiple times
-      shell: |
-        for i in 1 2 3; do
-          echo "Test $i:"
-          curl -H "User-Agent: Mozilla/5.0" -H "Cache-Control: no-cache" -s -o /dev/null -w "  HTTP %{http_code}\n" https://staging.michaelschiemer.de/ || echo "  Failed"
-          sleep 1
-        done
-      args:
-        executable: /bin/bash
-      register: multi_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display multi test results
-      debug:
-        msg: "{{ multi_test.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-traefik-acme-logs.yml b/deployment/ansible/playbooks/check-traefik-acme-logs.yml
new file mode 100644
index 00000000..1adbf27c
--- /dev/null
+++ b/deployment/ansible/playbooks/check-traefik-acme-logs.yml
@@ -0,0 +1,15 @@
+---
+# Check Traefik ACME Challenge Logs
+# Wrapper Playbook for traefik role logs tasks
+- hosts: production
+  gather_facts: yes
+  become: no
+  tasks:
+    - name: Include traefik logs tasks
+      ansible.builtin.include_role:
+        name: traefik
+        tasks_from: logs
+  tags:
+    - traefik
+    - logs
+    - acme
diff --git a/deployment/ansible/playbooks/check-traefik-gitea-config.yml b/deployment/ansible/playbooks/check-traefik-gitea-config.yml
deleted file mode 100644
index 5eaf7d92..00000000
--- a/deployment/ansible/playbooks/check-traefik-gitea-config.yml
+++ /dev/null
@@ -1,70 +0,0 @@
----
-- name: Check Traefik Gitea Configuration
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    traefik_stack_path: "{{ stacks_base_path }}/traefik"
-
-  tasks:
-    - name: Check Traefik logs for Gitea errors
-      shell: |
-        cd {{ traefik_stack_path }}
-        echo "=== Traefik Logs - Gitea errors (Last 50 lines) ==="
-        docker compose logs --tail=100 traefik 2>&1 | grep -i "gitea\|502\|bad gateway" | tail -50 || echo "No Gitea-related errors found"
-      args:
-        executable: /bin/bash
-      register: traefik_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik errors
-      debug:
-        msg: "{{ traefik_errors.stdout_lines }}"
-
-    - name: Check dynamic Gitea configuration on server
-      shell: |
-        cat {{ traefik_stack_path }}/dynamic/gitea.yml 2>&1 || echo "File not found"
-      register: gitea_dynamic_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display dynamic Gitea config
-      debug:
-        msg: "{{ gitea_dynamic_config.stdout_lines }}"
-
-    - name: Test if Traefik can resolve gitea hostname
-      shell: |
-        docker exec traefik getent hosts gitea 2>&1 || echo "Cannot resolve gitea hostname"
-      register: traefik_resolve
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik resolve result
-      debug:
-        msg: "{{ traefik_resolve.stdout_lines }}"
-
-    - name: Get Gitea container IP
-      shell: |
-        docker inspect gitea --format '{{ '{{' }}range.NetworkSettings.Networks{{ '}}' }}{{ '{{' }}if eq .NetworkID (printf "%s" (docker network inspect traefik-public --format "{{ '{{' }}.Id{{ '}}' }}")){{ '}}' }}{{ '{{' }}.IPAddress{{ '}}' }}{{ '{{' }}end{{ '}}' }}{{ '{{' }}end{{ '}}' }}' 2>&1 || echo "Could not get IP"
-      register: gitea_ip
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Gitea IP
-      debug:
-        msg: "Gitea IP in traefik-public network: {{ gitea_ip.stdout }}"
-
-    - name: Test connectivity from Traefik to Gitea IP
-      shell: |
-        GITEA_IP="{{ gitea_ip.stdout | default('172.21.0.3') }}"
-        docker exec traefik wget -qO- --timeout=5 "http://$GITEA_IP:3000/api/healthz" 2>&1 || echo "Cannot connect to Gitea at $GITEA_IP:3000"
-      register: traefik_connect
-      ignore_errors: yes
-      failed_when: false
-      when: gitea_ip.stdout is defined and gitea_ip.stdout != ""
-
-    - name: Display connectivity result
-      debug:
-        msg: "{{ traefik_connect.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-vpn-routing-status.yml b/deployment/ansible/playbooks/check-vpn-routing-status.yml
deleted file mode 100644
index e0e9c06d..00000000
--- a/deployment/ansible/playbooks/check-vpn-routing-status.yml
+++ /dev/null
@@ -1,63 +0,0 @@
----
-- name: Check VPN Routing Status - Client-Side Diagnostics
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions for client-side DNS check
-      debug:
-        msg:
-          - "=== CLIENT-SIDE DNS CHECK ==="
-          - "Bitte f?hre diese Befehle auf deinem Client-System aus (nicht auf dem Server):"
-          - ""
-          - "1. Pr?fe aktive DNS-Server:"
-          - "   Linux/Mac: cat /etc/resolv.conf"
-          - "   Windows: Get-DnsClientServerAddress | Select-Object InterfaceAlias, ServerAddresses"
-          - ""
-          - "2. Teste DNS-Aufl?sung:"
-          - "   dig +short grafana.michaelschiemer.de"
-          - "   Oder: nslookup grafana.michaelschiemer.de"
-          - ""
-          - "3. Teste DNS-Aufl?sung ?ber VPN-DNS:"
-          - "   dig +short grafana.michaelschiemer.de @10.8.0.1"
-          - "   Sollte zur?ckgeben: 10.8.0.1"
-          - ""
-          - "4. Pr?fe WireGuard Config:"
-          - "   ?ffne deine WireGuard-Config und pr?fe:"
-          - "   [Interface]"
-          - "   DNS = 10.8.0.1"
-          - ""
-          - "Teile mir die Ergebnisse mit, dann kann ich dir helfen, das zu fixen!"
-
-    - name: Check server-side WireGuard configuration
-      shell: |
-        echo "=== Server-Side WireGuard Config ==="
-        sudo cat /etc/wireguard/wg0.conf | grep -A 5 "\[Interface\]" | head -10
-      args:
-        executable: /bin/bash
-      register: wg_server_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display server-side WireGuard config
-      debug:
-        msg: "{{ wg_server_config.stdout_lines }}"
-
-    - name: Check server-side DNS resolution
-      shell: |
-        echo "=== Server-Side DNS Tests ==="
-        echo "1. Grafana via VPN DNS (10.8.0.1):"
-        dig +short grafana.michaelschiemer.de @10.8.0.1 2>&1 || echo "Failed"
-        echo ""
-        echo "2. Grafana via public DNS (8.8.8.8):"
-        dig +short grafana.michaelschiemer.de @8.8.8.8 2>&1 || echo "Failed"
-      args:
-        executable: /bin/bash
-      register: server_dns
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display server-side DNS tests
-      debug:
-        msg: "{{ server_dns.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/check-vpn-test-from-client.yml b/deployment/ansible/playbooks/check-vpn-test-from-client.yml
deleted file mode 100644
index 7ebbaaae..00000000
--- a/deployment/ansible/playbooks/check-vpn-test-from-client.yml
+++ /dev/null
@@ -1,116 +0,0 @@
----
-- name: Check VPN Test Results from Client
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Check latest Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Last 20 Grafana Access Attempts ==="
-        tail -500 logs/access.log | grep -i grafana | tail -20 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1 | cut -d':' -f1-2)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          method=$(echo "$line" | grep -oP '"RequestMethod":"[^"]*"' | sed 's/"RequestMethod":"//;s/"//')
-          path=$(echo "$line" | grep -oP '"RequestPath":"[^"]*"' | sed 's/"RequestPath":"//;s/"//')
-          
-          if [[ "$client" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "? $time | ClientHost: $client | Status: $status | $method $path ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [[ "$client" == "89.246.96.244" ]]; then
-            echo "? $time | ClientHost: $client | Status: $status | $method $path ? ?ffentliche IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "? $time | ClientHost: $client | Status: $status | $method $path ? Unbekannt"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: recent_access
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display recent access attempts
-      debug:
-        msg: "{{ recent_access.stdout_lines }}"
-
-    - name: Extract unique client IPs from recent requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -20 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique client IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Analyze client IP distribution
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Client IP Analysis (Last 20 requests) ==="
-        VPN_COUNT=$(tail -100 logs/access.log | grep -i grafana | tail -20 | grep -oP '"ClientHost":"10\.8\.0\.[0-9]+"' | wc -l)
-        PUBLIC_COUNT=$(tail -100 logs/access.log | grep -i grafana | tail -20 | grep -oP '"ClientHost":"89\.246\.96\.244"' | wc -l)
-        TOTAL=$(tail -100 logs/access.log | grep -i grafana | tail -20 | wc -l)
-        
-        echo "Total Grafana requests (last 20): $TOTAL"
-        echo "VPN IP requests (10.8.0.x): $VPN_COUNT"
-        echo "Public IP requests (89.246.96.244): $PUBLIC_COUNT"
-        
-        if [ "$VPN_COUNT" -gt 0 ]; then
-          echo ""
-          echo "? SUCCESS: Traffic is coming through VPN!"
-          echo "  $VPN_COUNT out of $TOTAL requests used VPN IP"
-        elif [ "$PUBLIC_COUNT" -gt 0 ]; then
-          echo ""
-          echo "? PROBLEM: Traffic is NOT coming through VPN"
-          echo "  $PUBLIC_COUNT out of $TOTAL requests used public IP"
-          echo "  Check VPN routing configuration on client"
-        else
-          echo ""
-          echo "??  No recent Grafana requests found"
-        fi
-      args:
-        executable: /bin/bash
-      register: ip_analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display IP analysis
-      debug:
-        msg: "{{ ip_analysis.stdout_lines }}"
-
-    - name: Check WireGuard peer status for test-client
-      shell: |
-        echo "=== WireGuard Peer Status ==="
-        sudo wg show | grep -A 5 "YbjBipkOHjLfcIYQKDReJ1swseczqHolTCRv7+LHnmw=" || echo "Peer not found or not connected"
-      args:
-        executable: /bin/bash
-      register: wg_peer_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display WireGuard peer status
-      debug:
-        msg: "{{ wg_peer_status.stdout_lines }}"
-
-    - name: Final recommendations
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - ""
-          - "Pr?fe die obigen Zeilen:"
-          - ""
-          - "? Wenn ClientHost: 10.8.0.x ? Traffic kommt ?ber VPN!"
-          - "  ? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "? Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN"
-          - "  ? Dann m?ssen wir das VPN-Routing auf dem Client pr?fen"
-          - ""
-          - "N?chste Schritte:"
-          - "1. Wenn VPN funktioniert: Temporary IP-Erlaubnis entfernen"
-          - "2. Wenn VPN nicht funktioniert: Route-Tabellen auf Client pr?fen"
diff --git a/deployment/ansible/playbooks/check-worker-logs.yml b/deployment/ansible/playbooks/check-worker-logs.yml
new file mode 100644
index 00000000..7e3c6559
--- /dev/null
+++ b/deployment/ansible/playbooks/check-worker-logs.yml
@@ -0,0 +1,17 @@
+---
+# Check Worker and Scheduler Logs
+# Wrapper Playbook for application role logs tasks
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_logs_check_vendor: true
+  tasks:
+    - name: Include application logs tasks (worker)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: logs
+  tags:
+    - application
+    - logs
+    - worker
diff --git a/deployment/ansible/playbooks/cleanup-all-containers.yml b/deployment/ansible/playbooks/cleanup-all-containers.yml
new file mode 100644
index 00000000..097d7d73
--- /dev/null
+++ b/deployment/ansible/playbooks/cleanup-all-containers.yml
@@ -0,0 +1,216 @@
+---
+- name: Cleanup All Containers and Networks on Production Server
+  hosts: production
+  become: no
+  gather_facts: yes
+
+  vars:
+    cleanup_volumes: true  # Set to false to preserve volumes
+
+  tasks:
+    - name: Set stacks_base_path if not defined
+      set_fact:
+        stacks_base_path: "{{ stacks_base_path | default('/home/deploy/deployment/stacks') }}"
+
+    - name: Display cleanup warning
+      debug:
+        msg:
+          - "=== WARNING: This will stop and remove ALL containers ==="
+          - "Volumes will be removed: {{ cleanup_volumes }}"
+          - "This will cause downtime for all services"
+          - "Stacks path: {{ stacks_base_path }}"
+          - ""
+
+    - name: List all running containers before cleanup
+      command: docker ps --format 'table {{ "{{" }}.Names{{ "}}" }}\t{{ "{{" }}.Status{{ "}}" }}\t{{ "{{" }}.Ports{{ "}}" }}'
+      register: containers_before
+      changed_when: false
+
+    - name: Display running containers
+      debug:
+        msg: "{{ containers_before.stdout_lines }}"
+
+    # Stop all Docker Compose stacks
+    - name: Stop Traefik stack
+      command: docker compose -f {{ stacks_base_path }}/traefik/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/traefik"
+      ignore_errors: yes
+      register: traefik_stop
+
+    - name: Stop Gitea stack
+      command: docker compose -f {{ stacks_base_path }}/gitea/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/gitea"
+      ignore_errors: yes
+
+    - name: Stop PostgreSQL Production stack
+      command: docker compose -f {{ stacks_base_path }}/postgresql-production/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/postgresql-production"
+      ignore_errors: yes
+
+    - name: Stop PostgreSQL Staging stack
+      command: docker compose -f {{ stacks_base_path }}/postgresql-staging/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/postgresql-staging"
+      ignore_errors: yes
+
+    - name: Stop Redis stack
+      command: docker compose -f {{ stacks_base_path }}/redis/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/redis"
+      ignore_errors: yes
+
+    - name: Stop Docker Registry stack
+      command: docker compose -f {{ stacks_base_path }}/registry/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/registry"
+      ignore_errors: yes
+
+    - name: Stop MinIO stack
+      command: docker compose -f {{ stacks_base_path }}/minio/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/minio"
+      ignore_errors: yes
+
+    - name: Stop Monitoring stack
+      command: docker compose -f {{ stacks_base_path }}/monitoring/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/monitoring"
+      ignore_errors: yes
+
+    - name: Stop Production stack
+      command: docker compose -f {{ stacks_base_path }}/production/docker-compose.base.yml -f {{ stacks_base_path }}/production/docker-compose.production.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/production"
+      ignore_errors: yes
+
+    - name: Stop Staging stack
+      command: docker compose -f {{ stacks_base_path }}/staging/docker-compose.base.yml -f {{ stacks_base_path }}/staging/docker-compose.staging.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/staging"
+      ignore_errors: yes
+
+    - name: Stop WireGuard stack
+      command: docker compose -f {{ stacks_base_path }}/wireguard/docker-compose.yml down
+      args:
+        chdir: "{{ stacks_base_path }}/wireguard"
+      ignore_errors: yes
+
+    # Remove all containers (including stopped ones)
+    - name: Get all container IDs
+      command: docker ps -a -q
+      register: all_containers
+      changed_when: false
+
+    - name: Remove all containers
+      command: docker rm -f {{ item }}
+      loop: "{{ all_containers.stdout_lines }}"
+      when: all_containers.stdout_lines | length > 0
+      ignore_errors: yes
+
+    # Check for port conflicts
+    - name: Check what's using port 80
+      command: sudo ss -tlnp 'sport = :80'
+      register: port_80_check
+      changed_when: false
+      ignore_errors: yes
+
+    - name: Display port 80 status
+      debug:
+        msg: "{{ port_80_check.stdout_lines if port_80_check.rc == 0 else 'Port 80 is free or cannot be checked' }}"
+
+    - name: Check what's using port 443
+      command: sudo ss -tlnp 'sport = :443'
+      register: port_443_check
+      changed_when: false
+      ignore_errors: yes
+
+    - name: Display port 443 status
+      debug:
+        msg: "{{ port_443_check.stdout_lines if port_443_check.rc == 0 else 'Port 443 is free or cannot be checked' }}"
+
+    # Clean up networks
+    - name: Remove traefik-public network
+      community.docker.docker_network:
+        name: traefik-public
+        state: absent
+      ignore_errors: yes
+
+    - name: Remove app-internal network
+      community.docker.docker_network:
+        name: app-internal
+        state: absent
+      ignore_errors: yes
+
+    - name: Get all custom networks
+      command: docker network ls --format '{{ "{{" }}.Name{{ "}}" }}'
+      register: all_networks
+      changed_when: false
+
+    - name: Remove custom networks (except default ones)
+      community.docker.docker_network:
+        name: "{{ item }}"
+        state: absent
+      loop: "{{ all_networks.stdout_lines }}"
+      when: 
+        - item not in ['bridge', 'host', 'none']
+        - item not in ['traefik-public', 'app-internal']  # Already removed above
+      ignore_errors: yes
+
+    # Clean up volumes (if requested)
+    - name: Get all volumes
+      command: docker volume ls -q
+      register: all_volumes
+      changed_when: false
+      when: cleanup_volumes | bool
+
+    - name: Remove all volumes
+      command: docker volume rm {{ item }}
+      loop: "{{ all_volumes.stdout_lines }}"
+      when: 
+        - cleanup_volumes | bool
+        - all_volumes.stdout_lines | length > 0
+      ignore_errors: yes
+
+    # Final verification
+    - name: List remaining containers
+      command: docker ps -a
+      register: containers_after
+      changed_when: false
+
+    - name: Display remaining containers
+      debug:
+        msg: "{{ containers_after.stdout_lines }}"
+
+    - name: List remaining networks
+      command: docker network ls
+      register: networks_after
+      changed_when: false
+
+    - name: Display remaining networks
+      debug:
+        msg: "{{ networks_after.stdout_lines }}"
+
+    - name: Verify ports 80 and 443 are free
+      command: sudo ss -tlnp 'sport = :{{ item }}'
+      register: port_check
+      changed_when: false
+      failed_when: port_check.rc == 0 and port_check.stdout_lines | length > 0
+      loop:
+        - 80
+        - 443
+
+    - name: Display cleanup summary
+      debug:
+        msg:
+          - "=== Cleanup Complete ==="
+          - "All containers stopped and removed"
+          - "Networks cleaned up"
+          - "Volumes removed: {{ cleanup_volumes }}"
+          - ""
+          - "Next steps:"
+          - "1. Run sync-stacks.yml to sync configurations"
+          - "2. Run setup-infrastructure.yml to deploy fresh infrastructure"
+
diff --git a/deployment/ansible/playbooks/debug-grafana-403.yml b/deployment/ansible/playbooks/debug-grafana-403.yml
deleted file mode 100644
index 99769236..00000000
--- a/deployment/ansible/playbooks/debug-grafana-403.yml
+++ /dev/null
@@ -1,125 +0,0 @@
----
-- name: Debug Grafana 403 Error
-  hosts: production
-  gather_facts: yes
-  become: no
-  
-  # This playbook requires the production inventory file
-  # Run with: ansible-playbook -i ../inventory/production.yml debug-grafana-403.yml
-
-  tasks:
-    - name: Check Traefik logs for recent Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Recent Traefik Access Logs (last 50 lines with grafana) ==="
-        docker compose logs --tail=100 traefik 2>&1 | grep -i grafana | tail -50 || echo "No grafana entries found"
-      args:
-        executable: /bin/bash
-      register: traefik_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik logs
-      debug:
-        msg: "{{ traefik_logs.stdout_lines }}"
-
-    - name: Check Traefik access log file
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Recent Traefik Access Log (last 50 lines) ==="
-        tail -50 logs/access.log 2>&1 | tail -50 || echo "Access log not found"
-      args:
-        executable: /bin/bash
-      register: access_log
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display access log
-      debug:
-        msg: "{{ access_log.stdout_lines }}"
-
-    - name: Check Grafana container status
-      shell: |
-        cd ~/deployment/stacks/monitoring
-        docker compose ps grafana
-      args:
-        executable: /bin/bash
-      register: grafana_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Grafana status
-      debug:
-        msg: "{{ grafana_status.stdout_lines }}"
-
-    - name: Check Grafana Traefik labels
-      shell: |
-        cd ~/deployment/stacks/monitoring
-        docker compose config | grep -A 20 "grafana:" | grep -E "(ipwhitelist|middleware|sourcerange)" || echo "No IP whitelist labels found"
-      args:
-        executable: /bin/bash
-      register: grafana_labels
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Grafana labels
-      debug:
-        msg: "{{ grafana_labels.stdout_lines }}"
-
-    - name: Check CoreDNS configuration
-      shell: |
-        cd ~/deployment/stacks/dns
-        echo "=== CoreDNS Corefile ==="
-        cat Corefile 2>&1 || echo "Corefile not found"
-      args:
-        executable: /bin/bash
-      register: coredns_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display CoreDNS configuration
-      debug:
-        msg: "{{ coredns_config.stdout_lines }}"
-
-    - name: Check monitoring stack environment variables
-      shell: |
-        cd ~/deployment/stacks/monitoring
-        echo "=== MONITORING_VPN_IP_WHITELIST ==="
-        grep MONITORING_VPN_IP_WHITELIST .env 2>&1 || echo "Variable not found in .env"
-      args:
-        executable: /bin/bash
-      register: monitoring_env
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display monitoring environment
-      debug:
-        msg: "{{ monitoring_env.stdout_lines }}"
-
-    - name: Test DNS resolution for grafana.michaelschiemer.de
-      shell: |
-        echo "=== DNS Resolution Test ==="
-        dig +short grafana.michaelschiemer.de @10.8.0.1 2>&1 || echo "DNS resolution failed"
-      args:
-        executable: /bin/bash
-      register: dns_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display DNS test result
-      debug:
-        msg: "{{ dns_test.stdout_lines }}"
-
-    - name: Check WireGuard interface status
-      shell: |
-        echo "=== WireGuard Interface Status ==="
-        sudo wg show 2>&1 || echo "WireGuard not running or no permissions"
-      args:
-        executable: /bin/bash
-      register: wg_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display WireGuard status
-      debug:
-        msg: "{{ wg_status.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/debug-staging-redis-secrets.yml b/deployment/ansible/playbooks/debug-staging-redis-secrets.yml
deleted file mode 100644
index 6d7e0a42..00000000
--- a/deployment/ansible/playbooks/debug-staging-redis-secrets.yml
+++ /dev/null
@@ -1,250 +0,0 @@
----
-- name: Debug Staging Redis Secrets Configuration
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check staging stack directory
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Staging Stack Directory ==="
-        pwd
-        ls -la
-      register: dir_check
-      ignore_errors: yes
-
-    - name: Display directory contents
-      debug:
-        msg: "{{ dir_check.stdout_lines }}"
-
-    - name: Check if docker-compose files exist
-      stat:
-        path: "{{ item }}"
-      vars:
-        deployment_path: "~/deployment/stacks/staging"
-      with_items:
-        - "{{ deployment_path }}/docker-compose.base.yml"
-        - "{{ deployment_path }}/docker-compose.staging.yml"
-      register: compose_files
-
-    - name: Display compose file status
-      debug:
-        msg: "{{ item.stat.exists | default(false) }}: {{ item.item }}"
-      with_items: "{{ compose_files.results }}"
-
-    - name: Check docker-compose.staging.yml configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Checking docker-compose.staging.yml for Redis secrets ==="
-        if [ -f docker-compose.staging.yml ]; then
-          echo "--- REDIS_PASSWORD_FILE in environment ---"
-          grep -A 5 "staging-app:" docker-compose.staging.yml | grep -A 10 "environment:" | grep "REDIS_PASSWORD_FILE" || echo "REDIS_PASSWORD_FILE not found in staging-app environment"
-          echo ""
-          echo "--- Secrets section for staging-app ---"
-          grep -A 10 "staging-app:" docker-compose.staging.yml | grep -A 15 "secrets:" | head -10 || echo "Secrets section not found"
-          echo ""
-          echo "--- Secrets definitions at bottom ---"
-          tail -30 docker-compose.staging.yml | grep -A 5 "redis_password:" || echo "redis_password secret definition not found"
-        else
-          echo "docker-compose.staging.yml NOT FOUND"
-        fi
-      register: compose_config
-      ignore_errors: yes
-
-    - name: Display compose configuration
-      debug:
-        msg: "{{ compose_config.stdout_lines }}"
-
-    - name: Check if secrets directory and files exist
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Secrets Directory ==="
-        if [ -d secrets ]; then
-          echo "secrets/ directory exists"
-          ls -la secrets/
-          echo ""
-          echo "--- redis_password.txt content check ---"
-          if [ -f secrets/redis_password.txt ]; then
-            echo "secrets/redis_password.txt exists"
-            FILE_SIZE=$(stat -f%z secrets/redis_password.txt 2>/dev/null || stat -c%s secrets/redis_password.txt 2>/dev/null || echo "unknown")
-            CONTENT_LENGTH=$(wc -c < secrets/redis_password.txt | tr -d ' ')
-            echo "File size: $FILE_SIZE bytes"
-            echo "Content length: $CONTENT_LENGTH bytes"
-            # Show first 5 chars (for debugging)
-            FIRST_CHARS=$(head -c 5 secrets/redis_password.txt)
-            echo "First 5 chars: $FIRST_CHARS"
-          else
-            echo "secrets/redis_password.txt NOT FOUND"
-          fi
-        else
-          echo "secrets/ directory DOES NOT EXIST"
-        fi
-      register: secrets_check
-      ignore_errors: yes
-
-    - name: Display secrets check
-      debug:
-        msg: "{{ secrets_check.stdout_lines }}"
-
-    - name: Check if staging-app container is running
-      shell: |
-        docker ps --filter "name=staging-app" --format "{{.Names}}\t{{.Status}}\t{{.Image}}"
-      register: container_status
-      ignore_errors: yes
-
-    - name: Display container status
-      debug:
-        msg: "{{ container_status.stdout_lines }}"
-
-    - name: Check Docker secrets mounted in staging-app container
-      shell: |
-        echo "=== Docker Secrets in staging-app Container ==="
-        if docker ps --filter "name=staging-app" --format "{{.Names}}" | grep -q staging-app; then
-          echo "--- Checking /run/secrets/ directory ---"
-          docker exec staging-app ls -la /run/secrets/ 2>&1 || echo "Cannot access /run/secrets/"
-          echo ""
-          echo "--- Checking redis_password secret file ---"
-          docker exec staging-app cat /run/secrets/redis_password 2>&1 | head -c 20 || echo "redis_password secret NOT FOUND or NOT READABLE"
-          echo "..."
-          echo ""
-          echo "--- File exists check ---"
-          docker exec staging-app test -f /run/secrets/redis_password && echo "redis_password file EXISTS" || echo "redis_password file DOES NOT EXIST"
-          docker exec staging-app test -r /run/secrets/redis_password && echo "redis_password file is READABLE" || echo "redis_password file is NOT READABLE"
-        else
-          echo "staging-app container is NOT RUNNING"
-        fi
-      register: secrets_mounted
-      ignore_errors: yes
-
-    - name: Display secrets mount status
-      debug:
-        msg: "{{ secrets_mounted.stdout_lines }}"
-
-    - name: Check Environment Variables in staging-app container
-      shell: |
-        echo "=== Environment Variables in staging-app ==="
-        if docker ps --filter "name=staging-app" --format "{{.Names}}" | grep -q staging-app; then
-          echo "--- Redis-related environment variables ---"
-          docker exec staging-app env | grep -E "(REDIS_|CACHE_|SESSION_|QUEUE_)" || echo "No Redis env vars found"
-          echo ""
-          echo "--- *_FILE environment variables ---"
-          docker exec staging-app env | grep "_FILE" || echo "No _FILE env vars found"
-          echo ""
-          echo "--- All environment variables (first 50) ---"
-          docker exec staging-app env | sort | head -50 || echo "Cannot read environment"
-        else
-          echo "Container not running"
-        fi
-      register: env_vars
-      ignore_errors: yes
-
-    - name: Display environment variables
-      debug:
-        msg: "{{ env_vars.stdout_lines }}"
-
-    - name: Test PHP environment resolution (check DockerSecretsResolver)
-      shell: |
-        echo "=== Testing PHP Environment Resolution ==="
-        docker exec staging-app php -r "
-          // Simulate what the Framework does
-          echo '=== System Environment Check ===' . PHP_EOL;
-          echo 'getenv(\"REDIS_PASSWORD_FILE\"): ' . (getenv('REDIS_PASSWORD_FILE') ?: 'NOT SET') . PHP_EOL;
-          echo 'getenv(\"REDIS_PASSWORD\"): ' . (getenv('REDIS_PASSWORD') ? 'SET (length: ' . strlen(getenv('REDIS_PASSWORD')) . ')' : 'NOT SET') . PHP_EOL;
-          echo PHP_EOL;
-          
-          echo '=== $_ENV Check ===' . PHP_EOL;
-          echo 'isset($_ENV[\"REDIS_PASSWORD_FILE\"]): ' . (isset(\$_ENV['REDIS_PASSWORD_FILE']) ? 'YES: ' . \$_ENV['REDIS_PASSWORD_FILE'] : 'NO') . PHP_EOL;
-          echo 'isset($_ENV[\"REDIS_PASSWORD\"]): ' . (isset(\$_ENV['REDIS_PASSWORD']) ? 'YES (length: ' . strlen(\$_ENV['REDIS_PASSWORD']) . ')' : 'NO') . PHP_EOL;
-          echo PHP_EOL;
-          
-          echo '=== $_SERVER Check ===' . PHP_EOL;
-          echo 'isset($_SERVER[\"REDIS_PASSWORD_FILE\"]): ' . (isset(\$_SERVER['REDIS_PASSWORD_FILE']) ? 'YES: ' . \$_SERVER['REDIS_PASSWORD_FILE'] : 'NO') . PHP_EOL;
-          echo 'isset($_SERVER[\"REDIS_PASSWORD\"]): ' . (isset(\$_SERVER['REDIS_PASSWORD']) ? 'YES (length: ' . strlen(\$_SERVER['REDIS_PASSWORD']) . ')' : 'NO') . PHP_EOL;
-          echo PHP_EOL;
-          
-          echo '=== Docker Secrets File Check ===' . PHP_EOL;
-          \$secret_file = '/run/secrets/redis_password';
-          echo 'File path: ' . \$secret_file . PHP_EOL;
-          echo 'File exists: ' . (file_exists(\$secret_file) ? 'YES' : 'NO') . PHP_EOL;
-          if (file_exists(\$secret_file)) {
-            echo 'File readable: ' . (is_readable(\$secret_file) ? 'YES' : 'NO') . PHP_EOL;
-            \$content = file_get_contents(\$secret_file);
-            if (\$content !== false) {
-              echo 'File content length: ' . strlen(trim(\$content)) . PHP_EOL;
-              echo 'File content (first 10 chars): ' . substr(trim(\$content), 0, 10) . '...' . PHP_EOL;
-            } else {
-              echo 'File content: COULD NOT READ' . PHP_EOL;
-            }
-          }
-          echo PHP_EOL;
-          
-          // Test DockerSecretsResolver logic
-          echo '=== DockerSecretsResolver Simulation ===' . PHP_EOL;
-          \$variables = getenv();
-          \$file_key = 'REDIS_PASSWORD_FILE';
-          if (isset(\$variables[\$file_key])) {
-            \$file_path = \$variables[\$file_key];
-            echo 'REDIS_PASSWORD_FILE found: ' . \$file_path . PHP_EOL;
-            if (file_exists(\$file_path) && is_readable(\$file_path)) {
-              \$secret_value = trim(file_get_contents(\$file_path));
-              echo 'Secret resolved: YES (length: ' . strlen(\$secret_value) . ')' . PHP_EOL;
-              echo 'Secret value (first 10 chars): ' . substr(\$secret_value, 0, 10) . '...' . PHP_EOL;
-            } else {
-              echo 'Secret resolved: NO (file not accessible)' . PHP_EOL;
-            }
-          } else {
-            echo 'REDIS_PASSWORD_FILE NOT FOUND in environment' . PHP_EOL;
-          }
-        " 2>&1
-      register: php_test
-      ignore_errors: yes
-
-    - name: Display PHP environment test
-      debug:
-        msg: "{{ php_test.stdout_lines }}"
-
-    - name: Check staging-redis container configuration
-      shell: |
-        echo "=== Staging Redis Container ==="
-        docker ps --filter "name=staging-redis" --format "{{.Names}}\t{{.Status}}"
-        echo ""
-        echo "=== Redis password requirement ==="
-        docker exec staging-redis redis-cli CONFIG GET requirepass 2>&1 || echo "Cannot check Redis config"
-        echo ""
-        echo "=== Test Redis connection without password ==="
-        docker exec staging-redis redis-cli PING 2>&1 || echo "Connection failed (password required)"
-      register: redis_config
-      ignore_errors: yes
-
-    - name: Display Redis configuration
-      debug:
-        msg: "{{ redis_config.stdout_lines }}"
-
-    - name: Check recent staging-app logs for Redis errors
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Recent staging-app logs (Redis-related) ==="
-        docker compose -f docker-compose.base.yml -f docker-compose.staging.yml logs staging-app --tail=100 2>&1 | grep -i -E "(redis|password|secret|auth|noauth)" | tail -30 || echo "No Redis-related logs found"
-      register: app_logs
-      ignore_errors: yes
-
-    - name: Display application logs
-      debug:
-        msg: "{{ app_logs.stdout_lines }}"
-
-    - name: Summary and Recommendations
-      debug:
-        msg:
-          - "========================================"
-          - "DEBUG SUMMARY"
-          - "========================================"
-          - "Check the output above for:"
-          - "1. docker-compose.staging.yml has REDIS_PASSWORD_FILE=/run/secrets/redis_password"
-          - "2. secrets/redis_password.txt exists and is readable"
-          - "3. Container has /run/secrets/redis_password file mounted"
-          - "4. Container environment has REDIS_PASSWORD_FILE variable set"
-          - "5. PHP can read the secret file and resolve REDIS_PASSWORD"
-          - "6. Redis container requires password (requirepass set)"
-          - ""
-          - "If any check fails, the issue is identified above."
diff --git a/deployment/ansible/playbooks/deploy-application-code.yml b/deployment/ansible/playbooks/deploy-application-code.yml
index db9d4c01..befa62df 100644
--- a/deployment/ansible/playbooks/deploy-application-code.yml
+++ b/deployment/ansible/playbooks/deploy-application-code.yml
@@ -1,167 +1,18 @@
 ---
-- name: Deploy Application Code via Git
-  hosts: "{{ deployment_hosts | default('production') }}"
+# Deploy Application Code via Git
+# Wrapper Playbook for application role deploy_code tasks
+- hosts: "{{ deployment_hosts | default('production') }}"
   gather_facts: yes
   become: no
-
   vars:
-    application_code_dest: "/home/deploy/michaelschiemer/current"
-    git_repository_url_default: "https://git.michaelschiemer.de/michael/michaelschiemer.git"
-    # Determine branch based on environment
-    git_branch: >-
-      {%- if deployment_environment == 'staging' -%}
-        {{ git_branch | default('staging') }}
-      {%- else -%}
-        {{ git_branch | default('main') }}
-      {%- endif -%}
-    git_token: "{{ git_token | default('') }}"
-    # Deployment environment (staging or production)
+    application_deployment_method: git
     deployment_environment: "{{ deployment_environment | default('production') }}"
-
   tasks:
-    - name: Set git_repo_url from provided value or default
-      set_fact:
-        git_repo_url: "{{ git_repository_url if (git_repository_url is defined and git_repository_url != '') else git_repository_url_default }}"
-
-    - name: Ensure Git is installed
-      ansible.builtin.apt:
-        name: git
-        state: present
-        update_cache: no
-      become: yes
-
-    - name: Ensure application code directory exists
-      file:
-        path: "{{ application_code_dest }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-      become: yes
-
-    - name: Check if repository already exists
-      stat:
-        path: "{{ application_code_dest }}/.git"
-      register: git_repo_exists
-
-    - name: Check if destination directory exists
-      stat:
-        path: "{{ application_code_dest }}"
-      register: dest_dir_exists
-
-    - name: Remove destination directory if it exists but is not a git repo
-      file:
-        path: "{{ application_code_dest }}"
-        state: absent
-      when: dest_dir_exists.stat.exists and not git_repo_exists.stat.exists
-      become: yes
-
-    - name: Clone repository (if not exists)
-      ansible.builtin.git:
-        repo: "{{ git_repo_url }}"
-        dest: "{{ application_code_dest }}"
-        version: "{{ git_branch }}"
-        force: no
-        update: no
-      when: not git_repo_exists.stat.exists
-      environment:
-        GIT_TERMINAL_PROMPT: "0"
-      vars:
-        ansible_become: no
-      register: git_clone_result
-      retries: 5
-      delay: 10
-      until: git_clone_result is succeeded
-      ignore_errors: yes
-
-    - name: Fail if git clone failed after retries
-      fail:
-        msg: "Failed to clone repository after 5 retries. Gitea may be unreachable or overloaded. Last error: {{ git_clone_result.msg | default('Unknown error') }}"
-      when:
-        - not git_repo_exists.stat.exists
-        - git_clone_result is failed
-
-    - name: Update repository (if exists)
-      ansible.builtin.git:
-        repo: "{{ git_repo_url }}"
-        dest: "{{ application_code_dest }}"
-        version: "{{ git_branch }}"
-        force: yes
-        update: yes
-      when: git_repo_exists.stat.exists
-      environment:
-        GIT_TERMINAL_PROMPT: "0"
-      vars:
-        ansible_become: no
-      register: git_update_result
-      retries: 5
-      delay: 10
-      until: git_update_result is succeeded
-      ignore_errors: yes
-
-    - name: Fail if git update failed after retries
-      fail:
-        msg: "Failed to update repository after 5 retries. Gitea may be unreachable or overloaded. Last error: {{ git_update_result.msg | default('Unknown error') }}"
-      when:
-        - git_repo_exists.stat.exists
-        - git_update_result is failed
-
-    - name: Set ownership of repository files
-      file:
-        path: "{{ application_code_dest }}"
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        recurse: yes
-      become: yes
-
-    - name: Ensure executable permissions on PHP scripts
-      file:
-        path: "{{ application_code_dest }}/{{ item }}"
-        mode: '0755'
-      loop:
-        - worker.php
-        - console.php
-      ignore_errors: yes
-
-    - name: Verify worker.php exists
-      stat:
-        path: "{{ application_code_dest }}/worker.php"
-      register: worker_php_stat
-
-    - name: Verify console.php exists
-      stat:
-        path: "{{ application_code_dest }}/console.php"
-      register: console_php_stat
-
-    - name: Verify composer.json exists
-      stat:
-        path: "{{ application_code_dest }}/composer.json"
-      register: composer_json_stat
-
-    - name: Get current Git commit hash
-      shell: |
-        cd {{ application_code_dest }} && git rev-parse HEAD
-      register: git_commit_hash
-      changed_when: false
-      when: git_repo_exists.stat.exists
-
-    - name: Display file verification results
-      debug:
-        msg: |
-          File Verification:
-          - worker.php: {{ 'EXISTS' if worker_php_stat.stat.exists else 'MISSING' }}
-          - console.php: {{ 'EXISTS' if console_php_stat.stat.exists else 'MISSING' }}
-          - composer.json: {{ 'EXISTS' if composer_json_stat.stat.exists else 'MISSING' }}
-          - Git Branch: {{ git_branch }}
-          - Git Commit: {{ git_commit_hash.stdout | default('N/A') }}
-
-    - name: Fail if critical files are missing
-      fail:
-        msg: |
-          Critical files are missing after Git deployment:
-          {% if not worker_php_stat.stat.exists %}- worker.php{% endif %}
-          {% if not console_php_stat.stat.exists %}- console.php{% endif %}
-          {% if not composer_json_stat.stat.exists %}- composer.json{% endif %}
-      when: 
-        - not worker_php_stat.stat.exists or not console_php_stat.stat.exists or not composer_json_stat.stat.exists
-
+    - name: Include application deploy_code tasks
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: deploy_code
+  tags:
+    - application
+    - deploy
+    - code
diff --git a/deployment/ansible/playbooks/deploy-complete.yml b/deployment/ansible/playbooks/deploy-complete.yml
new file mode 100644
index 00000000..b4868751
--- /dev/null
+++ b/deployment/ansible/playbooks/deploy-complete.yml
@@ -0,0 +1,30 @@
+---
+# Complete Deployment Playbook
+# Combines all deployment steps into a single Ansible run:
+# 1. Deploy Application Code
+# 2. Deploy Docker Image
+# 3. Install Composer Dependencies
+#
+# This reduces SSH connections and Ansible overhead compared to running
+# three separate playbook calls.
+#
+# Usage:
+#   ansible-playbook -i inventory/production.yml playbooks/deploy-complete.yml \
+#     -e "deployment_environment=staging" \
+#     -e "deployment_hosts=production" \
+#     -e "image_tag=latest" \
+#     -e "docker_registry=registry.michaelschiemer.de" \
+#     -e "docker_registry_username=admin" \
+#     -e "docker_registry_password=password" \
+#     -e "git_branch=staging" \
+#     --vault-password-file /tmp/vault_pass
+
+# Step 1: Deploy Application Code
+- import_playbook: deploy-application-code.yml
+
+# Step 2: Deploy Docker Image
+- import_playbook: deploy-image.yml
+
+# Step 3: Install Composer Dependencies
+- import_playbook: install-composer-dependencies.yml
+
diff --git a/deployment/ansible/playbooks/deploy-gitea-stack-config.yml b/deployment/ansible/playbooks/deploy-gitea-stack-config.yml
new file mode 100644
index 00000000..4d91b468
--- /dev/null
+++ b/deployment/ansible/playbooks/deploy-gitea-stack-config.yml
@@ -0,0 +1,60 @@
+---
+# Deploy Gitea Stack Configuration
+# Updates docker-compose.yml and restarts containers with new settings
+- name: Deploy Gitea Stack Configuration
+  hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    traefik_auto_restart: false
+    gitea_auto_restart: false
+
+  tasks:
+    - name: Check if Gitea stack directory exists
+      ansible.builtin.stat:
+        path: "{{ gitea_stack_path }}"
+      register: gitea_stack_dir
+      failed_when: false
+
+    - name: Fail if Gitea stack directory does not exist
+      ansible.builtin.fail:
+        msg: "Gitea stack directory does not exist: {{ gitea_stack_path }}"
+      when: not gitea_stack_dir.stat.exists
+
+    - name: Sync Gitea docker-compose.yml
+      ansible.builtin.synchronize:
+        src: "{{ playbook_dir }}/../../stacks/gitea/docker-compose.yml"
+        dest: "{{ gitea_stack_path }}/docker-compose.yml"
+        mode: push
+      register: compose_synced
+
+    - name: Restart Gitea and Postgres containers to apply new configuration
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose up -d --force-recreate gitea postgres
+      register: gitea_restart
+      changed_when: gitea_restart.rc == 0
+      when: compose_synced.changed | default(false) | bool
+
+    - name: Wait for Gitea to be ready
+      ansible.builtin.wait_for:
+        timeout: 60
+        delay: 5
+      when: gitea_restart.changed | default(false) | bool
+
+    - name: Display result
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA STACK CONFIGURATION DEPLOYED
+          ================================================================================
+          
+          Changes applied:
+          - Gitea Connection Pool: MAX_OPEN_CONNS=50, MAX_IDLE_CONNS=30, CONN_MAX_LIFETIME=600, CONN_MAX_IDLE_TIME=300
+          - Postgres Timeouts: authentication_timeout=180s, statement_timeout=30s, idle_in_transaction_timeout=30s
+          
+          Containers restarted: {{ 'YES' if (gitea_restart.changed | default(false) | bool) else 'NO (no changes)' }}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/deploy-traefik-config.yml b/deployment/ansible/playbooks/deploy-traefik-config.yml
index 9562fb40..4106cb7d 100644
--- a/deployment/ansible/playbooks/deploy-traefik-config.yml
+++ b/deployment/ansible/playbooks/deploy-traefik-config.yml
@@ -1,72 +1,14 @@
 ---
-- name: Deploy Traefik Configuration Files
-  hosts: production
+# Deploy Traefik Configuration Files
+# Wrapper Playbook for traefik role config tasks
+- hosts: production
   gather_facts: yes
   become: no
-
-  vars:
-    traefik_stack_path: "{{ stacks_base_path | default('/home/deploy/deployment/stacks') }}/traefik"
-    local_traefik_path: "{{ playbook_dir }}/../../stacks/traefik"
-
   tasks:
-    - name: Check if local Traefik config directory exists
-      stat:
-        path: "{{ local_traefik_path }}"
-      register: local_traefik_exists
-      delegate_to: localhost
-      run_once: true
-
-    - name: Fail if local Traefik config directory does not exist
-      fail:
-        msg: "Local Traefik config directory not found at {{ local_traefik_path }}"
-      when: not local_traefik_exists.stat.exists
-      delegate_to: localhost
-      run_once: true
-
-    - name: Check if remote Traefik stack directory exists
-      stat:
-        path: "{{ traefik_stack_path }}"
-      register: traefik_stack_exists
-
-    - name: Fail if remote Traefik stack directory does not exist
-      fail:
-        msg: "Remote Traefik stack directory not found at {{ traefik_stack_path }}"
-      when: not traefik_stack_exists.stat.exists
-
-    - name: Deploy docker-compose.yml
-      copy:
-        src: "{{ local_traefik_path }}/docker-compose.yml"
-        dest: "{{ traefik_stack_path }}/docker-compose.yml"
-        mode: '0644'
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-      register: docker_compose_deployed
-
-    - name: Deploy traefik.yml
-      copy:
-        src: "{{ local_traefik_path }}/traefik.yml"
-        dest: "{{ traefik_stack_path }}/traefik.yml"
-        mode: '0644'
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-      register: traefik_yml_deployed
-
-    - name: Display deployment status
-      debug:
-        msg: |
-          ========================================
-          Traefik Configuration Deployment
-          ========================================
-          docker-compose.yml: {{ '✅ DEPLOYED' if docker_compose_deployed.changed else 'ℹ️  No changes' }}
-          traefik.yml: {{ '✅ DEPLOYED' if traefik_yml_deployed.changed else 'ℹ️  No changes' }}
-          ========================================
-          
-          {% if docker_compose_deployed.changed or traefik_yml_deployed.changed %}
-          ✅ Configuration files deployed successfully!
-          
-          Next step: Restart Traefik to apply changes:
-          ansible-playbook -i inventory/production.yml playbooks/restart-traefik.yml --vault-password-file secrets/.vault_pass
-          {% else %}
-          ℹ️  Configuration files are already up to date.
-          {% endif %}
-
+    - name: Include traefik config tasks
+      ansible.builtin.include_role:
+        name: traefik
+        tasks_from: config
+  tags:
+    - traefik
+    - config
diff --git a/deployment/ansible/playbooks/deploy-update.yml b/deployment/ansible/playbooks/deploy-update.yml
deleted file mode 100644
index c215fdeb..00000000
--- a/deployment/ansible/playbooks/deploy-update.yml
+++ /dev/null
@@ -1,240 +0,0 @@
----
-- name: Deploy Application Update via Docker Compose
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    # These should be passed via -e from CI/CD
-    image_tag: "{{ image_tag | default('latest') }}"
-    git_commit_sha: "{{ git_commit_sha | default('unknown') }}"
-    deployment_timestamp: "{{ deployment_timestamp | default(ansible_date_time.iso8601) }}"
-    # app_stack_path is now defined in group_vars/production.yml
-
-  pre_tasks:
-    - name: Optionally load registry credentials from encrypted vault
-      include_vars:
-        file: "{{ playbook_dir }}/../secrets/production.vault.yml"
-      no_log: yes
-      ignore_errors: yes
-      delegate_to: localhost
-      become: no
-
-    - name: Derive docker registry credentials from vault when not provided
-      set_fact:
-        docker_registry_username: "{{ docker_registry_username | default(vault_docker_registry_username | default(docker_registry_username_default)) }}"
-        docker_registry_password: "{{ docker_registry_password | default(vault_docker_registry_password | default(docker_registry_password_default)) }}"
-
-    - name: Ensure system packages are up to date
-      include_role:
-        name: system
-      when: system_update_packages | bool
-
-    - name: Verify Docker is running
-      systemd:
-        name: docker
-        state: started
-      register: docker_service
-      become: yes
-
-    - name: Fail if Docker is not running
-      fail:
-        msg: "Docker service is not running"
-      when: docker_service.status.ActiveState != 'active'
-
-    - name: Ensure application stack directory exists
-      file:
-        path: "{{ app_stack_path }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-    - name: Determine application environment
-      set_fact:
-        application_environment: "{{ APP_ENV | default('production') }}"
-        application_compose_suffix: "{{ 'staging.yml' if application_environment == 'staging' else 'production.yml' }}"
-
-    - name: Check if docker-compose.base.yml exists in application stack
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_exists
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Check if docker-compose override file exists in application stack (production or staging)
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
-      register: compose_override_exists
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Application Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.{{ application_compose_suffix }}
-          
-          The Application Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the application stack with docker-compose files and .env file.
-      when:
-        - not (application_sync_files | default(false) | bool)
-        - (not compose_base_exists.stat.exists or not compose_override_exists.stat.exists)
-
-    - name: Create backup directory
-      file:
-        path: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-  tasks:
-    - name: Verify docker-compose files exist
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_check
-      when: not (application_sync_files | default(false) | bool)
-      
-    - name: Verify docker-compose override file exists (production or staging)
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
-      register: compose_override_check
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Application Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.{{ application_compose_suffix }}
-          
-          The Application Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the application stack with docker-compose files and .env file.
-      when:
-        - not (application_sync_files | default(false) | bool)
-        - (not compose_base_check.stat.exists or not compose_override_check.stat.exists)
-
-    - name: Backup current deployment metadata
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.{{ application_compose_suffix }} ps --format json 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/current_containers.json || true
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.{{ application_compose_suffix }} config 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/docker-compose-config.yml || true
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-      when: 
-        - not (application_sync_files | default(false) | bool)
-        - compose_base_exists.stat.exists | default(false)
-        - compose_override_exists.stat.exists | default(false)
-
-    - name: Login to Docker registry (if credentials provided)
-      community.docker.docker_login:
-        registry_url: "{{ docker_registry_url }}"
-        username: "{{ docker_registry_username }}"
-        password: "{{ docker_registry_password }}"
-      no_log: yes
-      ignore_errors: yes
-      when:
-        - docker_registry_username is defined
-        - docker_registry_password is defined
-        - docker_registry_username | length > 0
-        - docker_registry_password | length > 0
-      register: registry_login
-
-    - name: Pull new Docker image
-      community.docker.docker_image:
-        name: "{{ app_image }}"
-        tag: "{{ image_tag }}"
-        source: pull
-        force_source: yes
-      register: image_pull
-
-    - name: Verify image was pulled successfully
-      fail:
-        msg: "Failed to pull image {{ app_image }}:{{ image_tag }}"
-      when: image_pull.failed
-
-    # Sync files first if application_sync_files=true (before updating docker-compose.production.yml)
-    - name: Sync application stack files
-      import_role:
-        name: application
-      vars:
-        application_sync_files: "{{ application_sync_files | default(false) }}"
-        application_compose_recreate: "never"  # Don't recreate yet, just sync files
-        application_remove_orphans: false
-      when: application_sync_files | default(false) | bool
-
-    - name: Update docker-compose override file with new image tag (all services)
-      replace:
-        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
-        # Match both localhost:5000 and registry.michaelschiemer.de (or any registry URL)
-        regexp: '^(\s+image:\s+)(localhost:5000|registry\.michaelschiemer\.de|{{ docker_registry }})/{{ app_name }}:.*$'
-        replace: '\1{{ app_image }}:{{ image_tag }}'
-      # Always update to ensure localhost:5000 is used (registry only accessible via localhost)
-      when: true
-      register: compose_updated
-
-    - name: Redeploy application stack with new image
-      import_role:
-        name: application
-      vars:
-        application_sync_files: false  # Already synced above, don't sync again
-        application_compose_recreate: "always"
-        application_remove_orphans: true
-
-    - name: Get deployed image information
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml config | grep -E "^\s+image:" | head -1 | awk '{print $2}' || echo "unknown"
-      args:
-        executable: /bin/bash
-      register: deployed_image
-      changed_when: false
-
-    - name: Record deployment metadata
-      copy:
-        content: |
-          Deployment Timestamp: {{ deployment_timestamp }}
-          Git Commit: {{ git_commit_sha }}
-          Image Tag: {{ image_tag }}
-          Deployed Image: {{ deployed_image.stdout }}
-          Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED (already exists)' }}
-          Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}
-          Health Status: {{ application_health_output if application_health_output != '' else 'All services healthy' }}
-          Health Check HTTP Status: {{ application_healthcheck_status }}
-        dest: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/deployment_metadata.txt"
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0644'
-
-    - name: Cleanup old backups (keep last {{ max_rollback_versions }})
-      shell: |
-        cd {{ backups_path }}
-        ls -dt */ 2>/dev/null | tail -n +{{ max_rollback_versions + 1 }} | xargs -r rm -rf
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-
-  post_tasks:
-    - name: Display deployment summary
-      debug:
-        msg:
-          - "=== Deployment Summary ==="
-          - "Image: {{ app_image }}:{{ image_tag }}"
-          - "Commit: {{ git_commit_sha }}"
-          - "Timestamp: {{ deployment_timestamp }}"
-          - "Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED' }}"
-          - "Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}"
-          - "Health Output: {{ application_health_output if application_health_output != '' else 'All services healthy' }}"
-          - "Health Check HTTP Status: {{ application_healthcheck_status }}"
-          - "Health Check URL: {{ health_check_url }}"
-          - ""
-          - "Next: Verify application is healthy"
diff --git a/deployment/ansible/playbooks/deploy/production.yml b/deployment/ansible/playbooks/deploy/production.yml
deleted file mode 100644
index beca23e5..00000000
--- a/deployment/ansible/playbooks/deploy/production.yml
+++ /dev/null
@@ -1,239 +0,0 @@
----
-- name: Deploy Application Update to Production via Docker Compose
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    # These should be passed via -e from CI/CD
-    application_environment: production
-    application_compose_suffix: production.yml
-    # app_stack_path is now defined in group_vars/production.yml
-
-  pre_tasks:
-    - name: Set deployment variables
-      set_fact:
-        image_tag: "{{ image_tag | default('latest') }}"
-        git_commit_sha: "{{ git_commit_sha | default('unknown') }}"
-        deployment_timestamp: "{{ deployment_timestamp | default(ansible_date_time.iso8601) }}"
-    - name: Optionally load registry credentials from encrypted vault
-      include_vars:
-        file: "{{ playbook_dir }}/../../secrets/production.vault.yml"
-      no_log: yes
-      ignore_errors: yes
-      delegate_to: localhost
-      become: no
-
-    - name: Derive docker registry credentials from vault when not provided
-      set_fact:
-        docker_registry_username: "{{ docker_registry_username | default(vault_docker_registry_username | default(docker_registry_username_default)) }}"
-        docker_registry_password: "{{ docker_registry_password | default(vault_docker_registry_password | default(docker_registry_password_default)) }}"
-
-    - name: Ensure system packages are up to date
-      include_role:
-        name: system
-      when: system_update_packages | bool
-
-    - name: Verify Docker is running
-      systemd:
-        name: docker
-        state: started
-      register: docker_service
-      become: yes
-
-    - name: Fail if Docker is not running
-      fail:
-        msg: "Docker service is not running"
-      when: docker_service.status.ActiveState != 'active'
-
-    - name: Ensure application stack directory exists
-      file:
-        path: "{{ app_stack_path }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-    - name: Check if docker-compose.base.yml exists in application stack
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_exists
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Check if docker-compose.production.yml exists in application stack
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
-      register: compose_override_exists
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Application Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.production.yml
-          
-          The Application Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the application stack with docker-compose files and .env file.
-      when:
-        - not (application_sync_files | default(false) | bool)
-        - (not compose_base_exists.stat.exists or not compose_override_exists.stat.exists)
-
-    - name: Create backup directory
-      file:
-        path: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-  tasks:
-    - name: Verify docker-compose files exist
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_check
-      when: not (application_sync_files | default(false) | bool)
-      
-    - name: Verify docker-compose.production.yml exists
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
-      register: compose_override_check
-      when: not (application_sync_files | default(false) | bool)
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Application Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.production.yml
-          
-          The Application Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the application stack with docker-compose files and .env file.
-      when:
-        - not (application_sync_files | default(false) | bool)
-        - (not compose_base_check.stat.exists or not compose_override_check.stat.exists)
-
-    - name: Backup current deployment metadata
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml ps --format json 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/current_containers.json || true
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml config 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/docker-compose-config.yml || true
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-      when: 
-        - not (application_sync_files | default(false) | bool)
-        - compose_base_exists.stat.exists | default(false)
-        - compose_override_exists.stat.exists | default(false)
-
-    - name: Login to Docker registry (if credentials provided)
-      community.docker.docker_login:
-        registry_url: "{{ docker_registry_url }}"
-        username: "{{ docker_registry_username }}"
-        password: "{{ docker_registry_password }}"
-      no_log: yes
-      ignore_errors: yes
-      when:
-        - docker_registry_username is defined
-        - docker_registry_password is defined
-        - docker_registry_username | length > 0
-        - docker_registry_password | length > 0
-      register: registry_login
-
-    - name: Pull new Docker image
-      community.docker.docker_image:
-        name: "{{ app_image }}"
-        tag: "{{ image_tag }}"
-        source: pull
-        force_source: yes
-      register: image_pull
-
-    - name: Verify image was pulled successfully
-      fail:
-        msg: "Failed to pull image {{ app_image }}:{{ image_tag }}"
-      when: image_pull.failed
-
-    # Sync files first if application_sync_files=true (before updating docker-compose.production.yml)
-    - name: Sync application stack files
-      import_role:
-        name: application
-      vars:
-        application_sync_files: "{{ application_sync_files | default(false) }}"
-        application_compose_recreate: "never"  # Don't recreate yet, just sync files
-        application_remove_orphans: false
-      when: application_sync_files | default(false) | bool
-
-    - name: Update docker-compose.production.yml with new image tag (all services)
-      replace:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
-        # Match both localhost:5000 and registry.michaelschiemer.de (or any registry URL)
-        regexp: '^(\s+image:\s+)(localhost:5000|registry\.michaelschiemer\.de|{{ docker_registry }})/{{ app_name }}:.*$'
-        replace: '\1{{ app_image }}:{{ image_tag }}'
-      # Always update to ensure localhost:5000 is used (registry only accessible via localhost)
-      when: true
-      register: compose_updated
-
-    - name: Redeploy application stack with new image
-      import_role:
-        name: application
-      vars:
-        application_sync_files: false  # Already synced above, don't sync again
-        application_compose_recreate: "always"
-        application_remove_orphans: true
-
-    - name: Get deployed image information
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml config | grep -E "^\s+image:" | head -1 | awk '{print $2}' || echo "unknown"
-      args:
-        executable: /bin/bash
-      register: deployed_image
-      changed_when: false
-
-    - name: Record deployment metadata
-      copy:
-        content: |
-          Deployment Timestamp: {{ deployment_timestamp }}
-          Git Commit: {{ git_commit_sha }}
-          Image Tag: {{ image_tag }}
-          Deployed Image: {{ deployed_image.stdout }}
-          Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED (already exists)' }}
-          Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}
-          Health Status: {{ application_health_output if application_health_output != '' else 'All services healthy' }}
-          Health Check HTTP Status: {{ application_healthcheck_status }}
-        dest: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/deployment_metadata.txt"
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0644'
-
-    - name: Cleanup old backups (keep last {{ max_rollback_versions | default(5) }})
-      shell: |
-        cd {{ backups_path }}
-        ls -dt */ 2>/dev/null | tail -n +{{ max_rollback_versions | default(5) + 1 }} | xargs -r rm -rf
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-
-  post_tasks:
-    - name: Display deployment summary
-      debug:
-        msg:
-          - "=== Production Deployment Summary ==="
-          - "Image: {{ app_image }}:{{ image_tag }}"
-          - "Commit: {{ git_commit_sha }}"
-          - "Timestamp: {{ deployment_timestamp }}"
-          - "Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED' }}"
-          - "Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}"
-          - "Health Output: {{ application_health_output if application_health_output != '' else 'All services healthy' }}"
-          - "Health Check HTTP Status: {{ application_healthcheck_status }}"
-          - "Health Check URL: {{ health_check_url | default('https://michaelschiemer.de/health') }}"
-          - ""
-          - "Next: Verify application is healthy"
diff --git a/deployment/ansible/playbooks/deploy/staging.yml b/deployment/ansible/playbooks/deploy/staging.yml
deleted file mode 100644
index c15be4a8..00000000
--- a/deployment/ansible/playbooks/deploy/staging.yml
+++ /dev/null
@@ -1,226 +0,0 @@
----
-- name: Deploy Application Update to Staging via Docker Compose
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    # These should be passed via -e from CI/CD
-    application_environment: staging
-    application_compose_suffix: staging.yml
-    # app_stack_path is now defined in group_vars/production.yml
-
-  pre_tasks:
-    - name: Set deployment variables
-      set_fact:
-        image_tag: "{{ image_tag | default('latest') }}"
-        git_commit_sha: "{{ git_commit_sha | default('unknown') }}"
-        deployment_timestamp: "{{ deployment_timestamp | default(ansible_date_time.iso8601) }}"
-    - name: Optionally load registry credentials from encrypted vault
-      include_vars:
-        file: "{{ playbook_dir }}/../../secrets/production.vault.yml"
-      no_log: yes
-      ignore_errors: yes
-      delegate_to: localhost
-      become: no
-
-    - name: Derive docker registry credentials from vault when not provided
-      set_fact:
-        docker_registry_username: "{{ docker_registry_username | default(vault_docker_registry_username | default(docker_registry_username_default)) }}"
-        docker_registry_password: "{{ docker_registry_password | default(vault_docker_registry_password | default(docker_registry_password_default)) }}"
-
-    - name: Ensure system packages are up to date
-      include_role:
-        name: system
-      when: system_update_packages | bool
-
-    - name: Verify Docker is running
-      systemd:
-        name: docker
-        state: started
-      register: docker_service
-      become: yes
-
-    - name: Fail if Docker is not running
-      fail:
-        msg: "Docker service is not running"
-      when: docker_service.status.ActiveState != 'active'
-
-    - name: Set staging stack path
-      set_fact:
-        app_stack_path: "{{ staging_stack_path | default(stacks_base_path + '/staging') }}"
-        backups_path: "{{ backups_base_path | default('~/deployment/backups') }}"
-
-    - name: Ensure application stack directory exists
-      file:
-        path: "{{ app_stack_path }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-    - name: Check if docker-compose.base.yml exists in staging stack
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_exists
-
-    - name: Check if docker-compose.staging.yml exists in staging stack
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.staging.yml"
-      register: compose_override_exists
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Staging Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.staging.yml
-          
-          The Staging Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the staging stack with docker-compose files and .env file.
-      when:
-        - not compose_base_exists.stat.exists or not compose_override_exists.stat.exists
-
-    - name: Create backup directory
-      file:
-        path: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}"
-        state: directory
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0755'
-
-  tasks:
-    - name: Verify docker-compose files exist
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.base.yml"
-      register: compose_base_check
-      
-    - name: Verify docker-compose.staging.yml exists
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.staging.yml"
-      register: compose_override_check
-
-    - name: Fail if docker-compose files don't exist
-      fail:
-        msg: |
-          Staging Stack docker-compose files not found at {{ app_stack_path }}
-          
-          Required files:
-          - docker-compose.base.yml
-          - docker-compose.staging.yml
-          
-          The Staging Stack must be deployed first via:
-          ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
-          
-          This will create the staging stack with docker-compose files and .env file.
-      when:
-        - not compose_base_check.stat.exists or not compose_override_check.stat.exists
-
-    - name: Backup current deployment metadata
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.staging.yml ps --format json 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/current_containers.json || true
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.staging.yml config 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/docker-compose-config.yml || true
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Login to Docker registry (if credentials provided)
-      community.docker.docker_login:
-        registry_url: "{{ docker_registry_url }}"
-        username: "{{ docker_registry_username }}"
-        password: "{{ docker_registry_password }}"
-      no_log: yes
-      ignore_errors: yes
-      when:
-        - docker_registry_username is defined
-        - docker_registry_password is defined
-        - docker_registry_username | length > 0
-        - docker_registry_password | length > 0
-      register: registry_login
-
-    - name: Pull new Docker image
-      community.docker.docker_image:
-        name: "{{ app_image }}"
-        tag: "{{ image_tag }}"
-        source: pull
-        force_source: yes
-      register: image_pull
-
-    - name: Verify image was pulled successfully
-      fail:
-        msg: "Failed to pull image {{ app_image }}:{{ image_tag }}"
-      when: image_pull.failed
-
-    - name: Update docker-compose.staging.yml with new image tag (all services)
-      replace:
-        path: "{{ app_stack_path }}/docker-compose.staging.yml"
-        # Match both localhost:5000 and registry.michaelschiemer.de (or any registry URL)
-        regexp: '^(\s+image:\s+)(localhost:5000|registry\.michaelschiemer\.de|{{ docker_registry }})/{{ app_name }}:.*$'
-        replace: '\1{{ app_image }}:{{ image_tag }}'
-      register: compose_updated
-
-    - name: Redeploy staging stack with new image
-      import_role:
-        name: application
-      vars:
-        application_sync_files: false
-        application_compose_recreate: "always"
-        application_remove_orphans: true
-        application_stack_path: "{{ app_stack_path }}"
-        application_compose_files:
-          - "{{ app_stack_path }}/docker-compose.base.yml"
-          - "{{ app_stack_path }}/docker-compose.staging.yml"
-
-    - name: Get deployed image information
-      shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.staging.yml config | grep -E "^\s+image:" | head -1 | awk '{print $2}' || echo "unknown"
-      args:
-        executable: /bin/bash
-      register: deployed_image
-      changed_when: false
-
-    - name: Record deployment metadata
-      copy:
-        content: |
-          Deployment Timestamp: {{ deployment_timestamp }}
-          Git Commit: {{ git_commit_sha }}
-          Image Tag: {{ image_tag }}
-          Deployed Image: {{ deployed_image.stdout }}
-          Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED (already exists)' }}
-          Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}
-          Health Status: {{ application_health_output if application_health_output != '' else 'All services healthy' }}
-          Health Check HTTP Status: {{ application_healthcheck_status }}
-        dest: "{{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/deployment_metadata.txt"
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0644'
-
-    - name: Cleanup old backups (keep last {{ max_rollback_versions | default(5) }})
-      shell: |
-        cd {{ backups_path }}
-        ls -dt */ 2>/dev/null | tail -n +{{ max_rollback_versions | default(5) + 1 }} | xargs -r rm -rf
-      args:
-        executable: /bin/bash
-      changed_when: false
-      ignore_errors: yes
-
-  post_tasks:
-    - name: Display deployment summary
-      debug:
-        msg:
-          - "=== Staging Deployment Summary ==="
-          - "Image: {{ app_image }}:{{ image_tag }}"
-          - "Commit: {{ git_commit_sha }}"
-          - "Timestamp: {{ deployment_timestamp }}"
-          - "Image Pull: {{ 'SUCCESS' if image_pull.changed else 'SKIPPED' }}"
-          - "Stack Deploy: {{ 'UPDATED' if application_stack_changed else 'NO_CHANGE' }}"
-          - "Health Output: {{ application_health_output if application_health_output != '' else 'All services healthy' }}"
-          - "Health Check HTTP Status: {{ application_healthcheck_status }}"
-          - "Health Check URL: {{ health_check_url | default('https://staging.michaelschiemer.de/health') }}"
-          - ""
-          - "Next: Verify application is healthy"
diff --git a/deployment/ansible/playbooks/diagnose-gitea-timeout-deep.yml b/deployment/ansible/playbooks/diagnose-gitea-timeout-deep.yml
new file mode 100644
index 00000000..66c2e29c
--- /dev/null
+++ b/deployment/ansible/playbooks/diagnose-gitea-timeout-deep.yml
@@ -0,0 +1,499 @@
+---
+# Diagnose Gitea Timeout - Deep Analysis während Request
+# Führt alle Checks während eines tatsächlichen Requests durch, inkl. pg_stat_activity, Redis, Backpressure-Tests
+- name: Diagnose Gitea Timeout Deep Analysis During Request
+  hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    traefik_stack_path: "{{ stacks_base_path }}/traefik"
+    gitea_url: "https://{{ gitea_domain }}"
+    test_duration_seconds: 60  # Wie lange wir testen
+    test_timestamp: "{{ ansible_date_time.epoch }}"
+    postgres_max_connections: 300
+
+  tasks:
+    - name: Display diagnostic plan
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA TIMEOUT DEEP DIAGNOSE - LIVE WÄHREND REQUEST
+          ================================================================================
+          
+          Diese erweiterte Diagnose führt alle Checks während eines tatsächlichen Requests durch:
+          
+          1. Docker Stats (CPU/RAM/IO) während Request
+          2. pg_stat_activity: Connection Count vs max_connections ({{ postgres_max_connections }})
+          3. Redis Ping Check (Session-Store-Blockaden)
+          4. Gitea localhost Test (Backpressure-Analyse)
+          5. Gitea Logs (DB-Timeouts, Panics, "context deadline exceeded", SESSION: context canceled)
+          6. Postgres Logs (Connection issues, authentication timeouts)
+          7. Traefik Logs ("backend connection error", "EOF")
+          8. Runner Status und git-upload-pack/git gc Jobs
+          
+          Test-Dauer: {{ test_duration_seconds }} Sekunden
+          Timestamp: {{ test_timestamp }}
+          ================================================================================
+
+    - name: Get initial container stats (baseline)
+      ansible.builtin.shell: |
+        docker stats --no-stream --format "table {{ '{{' }}.Name{{ '}}' }}\t{{ '{{' }}.CPUPerc{{ '}}' }}\t{{ '{{' }}.MemUsage{{ '}}' }}\t{{ '{{' }}.NetIO{{ '}}' }}\t{{ '{{' }}.BlockIO{{ '}}' }}" gitea gitea-postgres gitea-redis traefik 2>/dev/null || echo "Stats collection failed"
+      register: initial_stats
+      changed_when: false
+
+    - name: Get initial PostgreSQL connection count
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose exec -T postgres psql -U gitea -d gitea -c "SELECT count(*) as connection_count FROM pg_stat_activity;" 2>&1 | grep -E "^[[:space:]]*[0-9]+" | head -1 || echo "0"
+      register: initial_pg_connections
+      changed_when: false
+      failed_when: false
+
+    - name: Start collecting Docker stats in background
+      ansible.builtin.shell: |
+        timeout {{ test_duration_seconds }} docker stats --format "{{ '{{' }}.Name{{ '}}' }},{{ '{{' }}.CPUPerc{{ '}}' }},{{ '{{' }}.MemUsage{{ '}}' }},{{ '{{' }}.NetIO{{ '}}' }},{{ '{{' }}.BlockIO{{ '}}' }}" gitea gitea-postgres gitea-redis traefik 2>/dev/null | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/gitea_stats_{{ test_timestamp }}.log 2>&1 &
+        STATS_PID=$!
+        echo $STATS_PID
+      register: stats_pid
+      changed_when: false
+
+    - name: Start collecting Gitea logs in background
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f gitea 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/gitea_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: gitea_logs_pid
+      changed_when: false
+
+    - name: Start collecting Postgres logs in background
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f postgres 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/postgres_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: postgres_logs_pid
+      changed_when: false
+
+    - name: Start collecting Traefik logs in background
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f traefik 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/traefik_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: traefik_logs_pid
+      changed_when: false
+
+    - name: Start monitoring pg_stat_activity in background
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        for i in $(seq 1 {{ (test_duration_seconds / 5) | int }}); do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $(docker compose exec -T postgres psql -U gitea -d gitea -t -c 'SELECT count(*) FROM pg_stat_activity;' 2>&1 | tr -d ' ' || echo 'ERROR')"
+          sleep 5
+        done > /tmp/pg_stat_activity_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: pg_stat_pid
+      changed_when: false
+
+    - name: Wait a moment for log collection to start
+      ansible.builtin.pause:
+        seconds: 2
+
+    - name: Trigger Gitea request via Traefik (with timeout)
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Starting request to {{ gitea_url }}/api/healthz"
+        timeout 35 curl -k -v -s -o /tmp/gitea_response_{{ test_timestamp }}.log -w "\nHTTP_CODE:%{http_code}\nTIME_TOTAL:%{time_total}\nTIME_CONNECT:%{time_connect}\nTIME_STARTTRANSFER:%{time_starttransfer}\n" "{{ gitea_url }}/api/healthz" 2>&1 | tee /tmp/gitea_curl_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Request completed"
+      register: gitea_request
+      changed_when: false
+      failed_when: false
+
+    - name: Test Gitea localhost (Backpressure-Test)
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Starting localhost test"
+        cd {{ gitea_stack_path }}
+        timeout 35 docker compose exec -T gitea curl -f -s -w "\nHTTP_CODE:%{http_code}\nTIME_TOTAL:%{time_total}\n" http://localhost:3000/api/healthz 2>&1 | tee /tmp/gitea_localhost_{{ test_timestamp }}.log || echo "LOCALHOST_TEST_FAILED" > /tmp/gitea_localhost_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Localhost test completed"
+      register: gitea_localhost_test
+      changed_when: false
+      failed_when: false
+
+    - name: Test direct connection Traefik → Gitea (parallel)
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Starting direct test Traefik → Gitea"
+        cd {{ traefik_stack_path }}
+        timeout 35 docker compose exec -T traefik wget -qO- --timeout=30 http://gitea:3000/api/healthz 2>&1 | tee /tmp/traefik_gitea_direct_{{ test_timestamp }}.log || echo "DIRECT_TEST_FAILED" > /tmp/traefik_gitea_direct_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Direct test completed"
+      register: traefik_direct_test
+      changed_when: false
+      failed_when: false
+
+    - name: Test Redis connection during request
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Testing Redis connection"
+        cd {{ gitea_stack_path }}
+        docker compose exec -T redis redis-cli ping 2>&1 | tee /tmp/redis_ping_{{ test_timestamp }}.log || echo "REDIS_PING_FAILED" > /tmp/redis_ping_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Redis ping completed"
+      register: redis_ping_test
+      changed_when: false
+      failed_when: false
+
+    - name: Check Gitea Runner status
+      ansible.builtin.shell: |
+        docker ps --format "{{ '{{' }}.Names{{ '}}' }}" | grep -q "gitea-runner" && echo "RUNNING" || echo "STOPPED"
+      register: runner_status
+      changed_when: false
+      failed_when: false
+
+    - name: Wait for log collection to complete
+      ansible.builtin.pause:
+        seconds: "{{ test_duration_seconds - 5 }}"
+
+    - name: Stop background processes
+      ansible.builtin.shell: |
+        pkill -f "docker.*stats.*gitea" || true
+        pkill -f "docker compose logs.*gitea" || true
+        pkill -f "docker compose logs.*postgres" || true
+        pkill -f "docker compose logs.*traefik" || true
+        pkill -f "pg_stat_activity" || true
+        sleep 2
+      changed_when: false
+      failed_when: false
+
+    - name: Get final PostgreSQL connection count
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose exec -T postgres psql -U gitea -d gitea -c "SELECT count(*) as connection_count FROM pg_stat_activity;" 2>&1 | grep -E "^[[:space:]]*[0-9]+" | head -1 || echo "0"
+      register: final_pg_connections
+      changed_when: false
+      failed_when: false
+
+    - name: Collect stats results
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_stats_{{ test_timestamp }}.log"
+      register: stats_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect pg_stat_activity results
+      ansible.builtin.slurp:
+        src: "/tmp/pg_stat_activity_{{ test_timestamp }}.log"
+      register: pg_stat_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Gitea logs results
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_logs_{{ test_timestamp }}.log"
+      register: gitea_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Postgres logs results
+      ansible.builtin.slurp:
+        src: "/tmp/postgres_logs_{{ test_timestamp }}.log"
+      register: postgres_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Traefik logs results
+      ansible.builtin.slurp:
+        src: "/tmp/traefik_logs_{{ test_timestamp }}.log"
+      register: traefik_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Get request result
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_curl_{{ test_timestamp }}.log"
+      register: request_result
+      changed_when: false
+      failed_when: false
+
+    - name: Get localhost test result
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_localhost_{{ test_timestamp }}.log"
+      register: localhost_result
+      changed_when: false
+      failed_when: false
+
+    - name: Get direct test result
+      ansible.builtin.slurp:
+        src: "/tmp/traefik_gitea_direct_{{ test_timestamp }}.log"
+      register: direct_test_result
+      changed_when: false
+      failed_when: false
+
+    - name: Get Redis ping result
+      ansible.builtin.slurp:
+        src: "/tmp/redis_ping_{{ test_timestamp }}.log"
+      register: redis_ping_result
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze pg_stat_activity for connection count
+      ansible.builtin.shell: |
+        if [ -f /tmp/pg_stat_activity_{{ test_timestamp }}.log ]; then
+          echo "=== POSTGRES CONNECTION COUNT ANALYSIS ==="
+          echo "Initial connections: {{ initial_pg_connections.stdout }}"
+          echo "Final connections: {{ final_pg_connections.stdout }}"
+          echo "Max connections: {{ postgres_max_connections }}"
+          echo ""
+          echo "=== CONNECTION COUNT TIMELINE ==="
+          cat /tmp/pg_stat_activity_{{ test_timestamp }}.log | tail -20 || echo "No connection count data"
+          echo ""
+          echo "=== CONNECTION COUNT ANALYSIS ==="
+          MAX_COUNT=$(cat /tmp/pg_stat_activity_{{ test_timestamp }}.log | grep -E "^\[.*\] [0-9]+" | awk -F'] ' '{print $2}' | sort -n | tail -1 || echo "0")
+          if [ "$MAX_COUNT" != "0" ] && [ "$MAX_COUNT" != "" ]; then
+            echo "Maximum connections during test: $MAX_COUNT"
+            WARNING_THRESHOLD=$(({{ postgres_max_connections }} * 80 / 100))
+            if [ "$MAX_COUNT" -gt "$WARNING_THRESHOLD" ]; then
+              echo "⚠️  WARNING: Connection count ($MAX_COUNT) is above 80% of max_connections ({{ postgres_max_connections }})"
+              echo "   Consider reducing MAX_OPEN_CONNS or increasing max_connections"
+            else
+              echo "✅ Connection count is within safe limits"
+            fi
+          fi
+        else
+          echo "pg_stat_activity log file not found"
+        fi
+      register: pg_stat_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze stats for high CPU/Memory/IO
+      ansible.builtin.shell: |
+        if [ -f /tmp/gitea_stats_{{ test_timestamp }}.log ]; then
+          echo "=== STATS SUMMARY ==="
+          echo "Total samples: $(wc -l < /tmp/gitea_stats_{{ test_timestamp }}.log)"
+          echo ""
+          echo "=== HIGH CPU (>80%) ==="
+          grep -E "gitea|gitea-postgres" /tmp/gitea_stats_{{ test_timestamp }}.log | awk -F',' '{cpu=$2; gsub(/%/, "", cpu); if (cpu+0 > 80) print $0}' | head -10 || echo "No high CPU usage found"
+          echo ""
+          echo "=== MEMORY USAGE ==="
+          grep -E "gitea" /tmp/gitea_stats_{{ test_timestamp }}.log | tail -5 || echo "No memory stats"
+        else
+          echo "Stats file not found"
+        fi
+      register: stats_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Gitea logs for errors (including SESSION context canceled, panic, git-upload-pack)
+      ansible.builtin.shell: |
+        if [ -f /tmp/gitea_logs_{{ test_timestamp }}.log ]; then
+          echo "=== DB-TIMEOUTS / CONNECTION ERRORS ==="
+          grep -iE "timeout|deadline exceeded|connection.*failed|database.*error|postgres.*error|context.*deadline" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -20 || echo "No DB-timeouts found"
+          echo ""
+          echo "=== SESSION: CONTEXT CANCELED ==="
+          grep -iE "SESSION.*context canceled|session.*release.*context canceled" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No SESSION: context canceled found"
+          echo ""
+          echo "=== PANICS / FATAL ERRORS ==="
+          grep -iE "panic|fatal|error.*fatal" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No panics found"
+          echo ""
+          echo "=== GIT-UPLOAD-PACK REQUESTS (can block) ==="
+          grep -iE "git-upload-pack|ServiceUploadPack" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No git-upload-pack requests found"
+          echo ""
+          echo "=== GIT GC JOBS (can hold connections) ==="
+          grep -iE "git.*gc|garbage.*collect" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No git gc jobs found"
+          echo ""
+          echo "=== SLOW QUERIES / PERFORMANCE ==="
+          grep -iE "slow|performance|took.*ms|duration" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No slow queries found"
+        else
+          echo "Gitea logs file not found"
+        fi
+      register: gitea_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Postgres logs for errors
+      ansible.builtin.shell: |
+        if [ -f /tmp/postgres_logs_{{ test_timestamp }}.log ]; then
+          echo "=== POSTGRES ERRORS ==="
+          grep -iE "error|timeout|deadlock|connection.*refused|too many connections|authentication.*timeout" /tmp/postgres_logs_{{ test_timestamp }}.log | tail -20 || echo "No Postgres errors found"
+          echo ""
+          echo "=== SLOW QUERIES ==="
+          grep -iE "slow|duration|statement.*took" /tmp/postgres_logs_{{ test_timestamp }}.log | tail -10 || echo "No slow queries found"
+        else
+          echo "Postgres logs file not found"
+        fi
+      register: postgres_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Traefik logs for backend errors
+      ansible.builtin.shell: |
+        if [ -f /tmp/traefik_logs_{{ test_timestamp }}.log ]; then
+          echo "=== BACKEND CONNECTION ERRORS ==="
+          grep -iE "backend.*error|connection.*error|EOF|gitea.*error|git\.michaelschiemer\.de.*error" /tmp/traefik_logs_{{ test_timestamp }}.log | tail -20 || echo "No backend errors found"
+          echo ""
+          echo "=== TIMEOUT ERRORS ==="
+          grep -iE "timeout|504|gateway.*timeout" /tmp/traefik_logs_{{ test_timestamp }}.log | tail -10 || echo "No timeout errors found"
+        else
+          echo "Traefik logs file not found"
+        fi
+      register: traefik_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Display comprehensive diagnosis
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA TIMEOUT DEEP DIAGNOSE - ERGEBNISSE
+          ================================================================================
+          
+          BASELINE STATS (vor Request):
+          {{ initial_stats.stdout }}
+          
+          POSTGRES CONNECTION COUNT:
+          {{ pg_stat_analysis.stdout }}
+          
+          REQUEST ERGEBNIS (Traefik → Gitea):
+          {% if request_result.content is defined and request_result.content != '' %}
+          {{ request_result.content | b64decode }}
+          {% else %}
+          Request-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          BACKPRESSURE TEST - GITEA LOCALHOST:
+          {% if localhost_result.content is defined and localhost_result.content != '' %}
+          {{ localhost_result.content | b64decode }}
+          {% else %}
+          Localhost-Test-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          DIREKTER TEST TRAEFIK → GITEA:
+          {% if direct_test_result.content is defined and direct_test_result.content != '' %}
+          {{ direct_test_result.content | b64decode }}
+          {% else %}
+          Direkter Test-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          REDIS PING TEST:
+          {% if redis_ping_result.content is defined and redis_ping_result.content != '' %}
+          {{ redis_ping_result.content | b64decode }}
+          {% else %}
+          Redis-Ping-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          RUNNER STATUS:
+          - Status: {{ runner_status.stdout }}
+          
+          ================================================================================
+          STATS-ANALYSE (während Request):
+          ================================================================================
+          {{ stats_analysis.stdout }}
+          
+          ================================================================================
+          GITEA LOGS-ANALYSE:
+          ================================================================================
+          {{ gitea_logs_analysis.stdout }}
+          
+          ================================================================================
+          POSTGRES LOGS-ANALYSE:
+          ================================================================================
+          {{ postgres_logs_analysis.stdout }}
+          
+          ================================================================================
+          TRAEFIK LOGS-ANALYSE:
+          ================================================================================
+          {{ traefik_logs_analysis.stdout }}
+          
+          ================================================================================
+          INTERPRETATION:
+          ================================================================================
+          
+          {% set request_content = request_result.content | default('') | b64decode | default('') %}
+          {% set localhost_content = localhost_result.content | default('') | b64decode | default('') %}
+          {% set direct_content = direct_test_result.content | default('') | b64decode | default('') %}
+          {% set redis_content = redis_ping_result.content | default('') | b64decode | default('') %}
+          {% set traefik_errors = traefik_logs_analysis.stdout | default('') %}
+          {% set gitea_errors = gitea_logs_analysis.stdout | default('') %}
+          {% set postgres_errors = postgres_logs_analysis.stdout | default('') %}
+          {% set stats_content = stats_analysis.stdout | default('') %}
+          
+          {% if 'timeout' in request_content or '504' in request_content or 'HTTP_CODE:504' in request_content %}
+          ⚠️  REQUEST HAT TIMEOUT/504:
+          
+          BACKPRESSURE-ANALYSE:
+          {% if 'LOCALHOST_TEST_FAILED' in localhost_content or localhost_content == '' %}
+          → Gitea localhost Test schlägt fehl oder blockiert
+          → Problem liegt IN Gitea/DB selbst, nicht zwischen Traefik und Gitea
+          {% elif 'HTTP_CODE:200' in localhost_content or '200 OK' in localhost_content %}
+          → Gitea localhost Test funktioniert schnell
+          → Problem liegt ZWISCHEN Traefik und Gitea (Netzwerk, Firewall, Limit)
+          {% endif %}
+          
+          {% if 'REDIS_PING_FAILED' in redis_content or redis_content == '' or 'PONG' not in redis_content %}
+          → Redis ist nicht erreichbar
+          → Session-Store blockiert, Gitea läuft in "context canceled"
+          {% else %}
+          → Redis ist erreichbar
+          {% endif %}
+          
+          {% if 'SESSION.*context canceled' in gitea_errors or 'session.*release.*context canceled' in gitea_errors %}
+          → Gitea hat SESSION: context canceled Fehler
+          → Session-Store (Redis) könnte blockieren oder Session-Locks hängen
+          {% endif %}
+          
+          {% if 'git-upload-pack' in gitea_errors %}
+          → git-upload-pack Requests gefunden (können blockieren)
+          → Prüfe ob Runner aktiv ist und viele Git-Operationen durchführt
+          {% endif %}
+          
+          {% if 'git.*gc' in gitea_errors %}
+          → git gc Jobs gefunden (können Verbindungen halten)
+          → Prüfe ob git gc Jobs hängen
+          {% endif %}
+          
+          {% if 'EOF' in traefik_errors or 'backend' in traefik_errors | lower or 'connection.*error' in traefik_errors | lower %}
+          → Traefik meldet Backend-Connection-Error
+          → Gitea antwortet nicht auf Traefik's Verbindungsversuche
+          {% endif %}
+          
+          {% if 'timeout' in gitea_errors | lower or 'deadline exceeded' in gitea_errors | lower %}
+          → Gitea hat DB-Timeouts oder Context-Deadline-Exceeded
+          → Postgres könnte blockieren oder zu langsam sein
+          {% endif %}
+          
+          {% if 'too many connections' in postgres_errors | lower %}
+          → Postgres hat zu viele Verbindungen
+          → Connection Pool könnte überlastet sein
+          {% endif %}
+          
+          {% if 'HIGH CPU' in stats_content or '>80' in stats_content %}
+          → Gitea oder Postgres haben hohe CPU-Last
+          → Performance-Problem, nicht Timeout-Konfiguration
+          {% endif %}
+          {% else %}
+          ✅ REQUEST WAR ERFOLGREICH:
+          → Problem tritt nur intermittierend auf
+          → Prüfe Logs auf sporadische Fehler
+          {% endif %}
+          
+          ================================================================================
+          NÄCHSTE SCHRITTE:
+          ================================================================================
+          
+          1. Prüfe pg_stat_activity: Connection Count nahe max_connections?
+          2. Prüfe ob Redis erreichbar ist (Session-Store-Blockaden)
+          3. Prüfe Backpressure: localhost schnell aber Traefik langsam = Netzwerk-Problem
+          4. Prüfe SESSION: context canceled Fehler (Session-Locks)
+          5. Prüfe git-upload-pack Requests (Runner-Überlastung)
+          6. Prüfe git gc Jobs (hängen und halten Verbindungen)
+          
+          ================================================================================
+
+    - name: Cleanup temporary files
+      ansible.builtin.file:
+        path: "/tmp/gitea_{{ test_timestamp }}.log"
+        state: absent
+      failed_when: false
+
diff --git a/deployment/ansible/playbooks/diagnose-gitea-timeout-live.yml b/deployment/ansible/playbooks/diagnose-gitea-timeout-live.yml
new file mode 100644
index 00000000..daf79a1d
--- /dev/null
+++ b/deployment/ansible/playbooks/diagnose-gitea-timeout-live.yml
@@ -0,0 +1,343 @@
+---
+# Diagnose Gitea Timeout - Live während Request
+# Führt alle Checks während eines tatsächlichen Requests durch
+- name: Diagnose Gitea Timeout During Request
+  hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    traefik_stack_path: "{{ stacks_base_path }}/traefik"
+    gitea_url: "https://{{ gitea_domain }}"
+    test_duration_seconds: 60  # Wie lange wir testen
+    test_timestamp: "{{ ansible_date_time.epoch }}"
+
+  tasks:
+    - name: Display diagnostic plan
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA TIMEOUT DIAGNOSE - LIVE WÄHREND REQUEST
+          ================================================================================
+          
+          Diese Diagnose führt alle Checks während eines tatsächlichen Requests durch:
+          
+          1. Docker Stats (CPU/RAM/IO) während Request
+          2. Gitea Logs (DB-Timeouts, Panics, "context deadline exceeded")
+          3. Postgres Logs (Connection issues)
+          4. Traefik Logs ("backend connection error", "EOF")
+          5. Direkter Test Traefik → Gitea
+          
+          Test-Dauer: {{ test_duration_seconds }} Sekunden
+          Timestamp: {{ test_timestamp }}
+          ================================================================================
+
+    - name: Get initial container stats (baseline)
+      ansible.builtin.shell: |
+        docker stats --no-stream --format "table {{ '{{' }}.Name{{ '}}' }}\t{{ '{{' }}.CPUPerc{{ '}}' }}\t{{ '{{' }}.MemUsage{{ '}}' }}\t{{ '{{' }}.NetIO{{ '}}' }}\t{{ '{{' }}.BlockIO{{ '}}' }}" gitea gitea-postgres gitea-redis traefik 2>/dev/null || echo "Stats collection failed"
+      register: initial_stats
+      changed_when: false
+
+    - name: Start collecting Docker stats in background
+      ansible.builtin.shell: |
+        timeout {{ test_duration_seconds }} docker stats --format "{{ '{{' }}.Name{{ '}}' }},{{ '{{' }}.CPUPerc{{ '}}' }},{{ '{{' }}.MemUsage{{ '}}' }},{{ '{{' }}.NetIO{{ '}}' }},{{ '{{' }}.BlockIO{{ '}}' }}" gitea gitea-postgres gitea-redis traefik 2>/dev/null | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/gitea_stats_{{ test_timestamp }}.log 2>&1 &
+        STATS_PID=$!
+        echo $STATS_PID
+      register: stats_pid
+      changed_when: false
+
+    - name: Start collecting Gitea logs in background
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f gitea 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/gitea_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: gitea_logs_pid
+      changed_when: false
+
+    - name: Start collecting Postgres logs in background
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f gitea-postgres 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/postgres_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: postgres_logs_pid
+      changed_when: false
+
+    - name: Start collecting Traefik logs in background
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        timeout {{ test_duration_seconds }} docker compose logs -f traefik 2>&1 | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] $line"
+        done > /tmp/traefik_logs_{{ test_timestamp }}.log 2>&1 &
+        echo $!
+      register: traefik_logs_pid
+      changed_when: false
+
+    - name: Wait a moment for log collection to start
+      ansible.builtin.pause:
+        seconds: 2
+
+    - name: Trigger Gitea request via Traefik (with timeout)
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Starting request to {{ gitea_url }}/api/healthz"
+        timeout 35 curl -k -v -s -o /tmp/gitea_response_{{ test_timestamp }}.log -w "\nHTTP_CODE:%{http_code}\nTIME_TOTAL:%{time_total}\nTIME_CONNECT:%{time_connect}\nTIME_STARTTRANSFER:%{time_starttransfer}\n" "{{ gitea_url }}/api/healthz" 2>&1 | tee /tmp/gitea_curl_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Request completed"
+      register: gitea_request
+      changed_when: false
+      failed_when: false
+
+    - name: Test direct connection Traefik → Gitea (parallel)
+      ansible.builtin.shell: |
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Starting direct test Traefik → Gitea"
+        cd {{ traefik_stack_path }}
+        timeout 35 docker compose exec -T traefik wget -qO- --timeout=30 http://gitea:3000/api/healthz 2>&1 | tee /tmp/traefik_gitea_direct_{{ test_timestamp }}.log || echo "DIRECT_TEST_FAILED" > /tmp/traefik_gitea_direct_{{ test_timestamp }}.log
+        echo "[$(date '+%Y-%m-%d %H:%M:%S.%3N')] Direct test completed"
+      register: traefik_direct_test
+      changed_when: false
+      failed_when: false
+
+    - name: Wait for log collection to complete
+      ansible.builtin.pause:
+        seconds: "{{ test_duration_seconds - 5 }}"
+
+    - name: Stop background processes
+      ansible.builtin.shell: |
+        pkill -f "docker.*stats.*gitea" || true
+        pkill -f "docker compose logs.*gitea" || true
+        pkill -f "docker compose logs.*postgres" || true
+        pkill -f "docker compose logs.*traefik" || true
+        sleep 2
+      changed_when: false
+      failed_when: false
+
+    - name: Collect stats results
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_stats_{{ test_timestamp }}.log"
+      register: stats_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Gitea logs results
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_logs_{{ test_timestamp }}.log"
+      register: gitea_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Postgres logs results
+      ansible.builtin.slurp:
+        src: "/tmp/postgres_logs_{{ test_timestamp }}.log"
+      register: postgres_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Collect Traefik logs results
+      ansible.builtin.slurp:
+        src: "/tmp/traefik_logs_{{ test_timestamp }}.log"
+      register: traefik_logs_results
+      changed_when: false
+      failed_when: false
+
+    - name: Get request result
+      ansible.builtin.slurp:
+        src: "/tmp/gitea_curl_{{ test_timestamp }}.log"
+      register: request_result
+      changed_when: false
+      failed_when: false
+
+    - name: Get direct test result
+      ansible.builtin.slurp:
+        src: "/tmp/traefik_gitea_direct_{{ test_timestamp }}.log"
+      register: direct_test_result
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze stats for high CPU/Memory/IO
+      ansible.builtin.shell: |
+        if [ -f /tmp/gitea_stats_{{ test_timestamp }}.log ]; then
+          echo "=== STATS SUMMARY ==="
+          echo "Total samples: $(wc -l < /tmp/gitea_stats_{{ test_timestamp }}.log)"
+          echo ""
+          echo "=== HIGH CPU (>80%) ==="
+          grep -E "gitea|gitea-postgres" /tmp/gitea_stats_{{ test_timestamp }}.log | awk -F',' '{cpu=$2; gsub(/%/, "", cpu); if (cpu+0 > 80) print $0}' | head -10 || echo "No high CPU usage found"
+          echo ""
+          echo "=== MEMORY USAGE ==="
+          grep -E "gitea" /tmp/gitea_stats_{{ test_timestamp }}.log | tail -5 || echo "No memory stats"
+          echo ""
+          echo "=== NETWORK IO ==="
+          grep -E "gitea" /tmp/gitea_stats_{{ test_timestamp }}.log | tail -5 || echo "No network activity"
+        else
+          echo "Stats file not found"
+        fi
+      register: stats_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Gitea logs for errors
+      ansible.builtin.shell: |
+        if [ -f /tmp/gitea_logs_{{ test_timestamp }}.log ]; then
+          echo "=== DB-TIMEOUTS / CONNECTION ERRORS ==="
+          grep -iE "timeout|deadline exceeded|connection.*failed|database.*error|postgres.*error|context.*deadline" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -20 || echo "No DB-timeouts found"
+          echo ""
+          echo "=== PANICS / FATAL ERRORS ==="
+          grep -iE "panic|fatal|error.*fatal" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No panics found"
+          echo ""
+          echo "=== SLOW QUERIES / PERFORMANCE ==="
+          grep -iE "slow|performance|took.*ms|duration" /tmp/gitea_logs_{{ test_timestamp }}.log | tail -10 || echo "No slow queries found"
+          echo ""
+          echo "=== RECENT LOG ENTRIES (last 10) ==="
+          tail -10 /tmp/gitea_logs_{{ test_timestamp }}.log || echo "No recent logs"
+        else
+          echo "Gitea logs file not found"
+        fi
+      register: gitea_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Postgres logs for errors
+      ansible.builtin.shell: |
+        if [ -f /tmp/postgres_logs_{{ test_timestamp }}.log ]; then
+          echo "=== POSTGRES ERRORS ==="
+          grep -iE "error|timeout|deadlock|connection.*refused|too many connections" /tmp/postgres_logs_{{ test_timestamp }}.log | tail -20 || echo "No Postgres errors found"
+          echo ""
+          echo "=== SLOW QUERIES ==="
+          grep -iE "slow|duration|statement.*took" /tmp/postgres_logs_{{ test_timestamp }}.log | tail -10 || echo "No slow queries found"
+          echo ""
+          echo "=== RECENT LOG ENTRIES (last 10) ==="
+          tail -10 /tmp/postgres_logs_{{ test_timestamp }}.log || echo "No recent logs"
+        else
+          echo "Postgres logs file not found"
+        fi
+      register: postgres_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Analyze Traefik logs for backend errors
+      ansible.builtin.shell: |
+        if [ -f /tmp/traefik_logs_{{ test_timestamp }}.log ]; then
+          echo "=== BACKEND CONNECTION ERRORS ==="
+          grep -iE "backend.*error|connection.*error|EOF|gitea.*error|git\.michaelschiemer\.de.*error" /tmp/traefik_logs_{{ test_timestamp }}.log | tail -20 || echo "No backend errors found"
+          echo ""
+          echo "=== TIMEOUT ERRORS ==="
+          grep -iE "timeout|504|gateway.*timeout" /tmp/traefik_logs_{{ test_timestamp }}.log | tail -10 || echo "No timeout errors found"
+          echo ""
+          echo "=== RECENT LOG ENTRIES (last 10) ==="
+          tail -10 /tmp/traefik_logs_{{ test_timestamp }}.log || echo "No recent logs"
+        else
+          echo "Traefik logs file not found"
+        fi
+      register: traefik_logs_analysis
+      changed_when: false
+      failed_when: false
+
+    - name: Display comprehensive diagnosis
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA TIMEOUT DIAGNOSE - ERGEBNISSE
+          ================================================================================
+          
+          BASELINE STATS (vor Request):
+          {{ initial_stats.stdout }}
+          
+          REQUEST ERGEBNIS:
+          {% if request_result.content is defined and request_result.content != '' %}
+          {{ request_result.content | b64decode }}
+          {% else %}
+          Request-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          DIREKTER TEST TRAEFIK → GITEA:
+          {% if direct_test_result.content is defined and direct_test_result.content != '' %}
+          {{ direct_test_result.content | b64decode }}
+          {% else %}
+          Direkter Test-Ergebnis nicht verfügbar
+          {% endif %}
+          
+          ================================================================================
+          STATS-ANALYSE (während Request):
+          ================================================================================
+          {{ stats_analysis.stdout }}
+          
+          ================================================================================
+          GITEA LOGS-ANALYSE:
+          ================================================================================
+          {{ gitea_logs_analysis.stdout }}
+          
+          ================================================================================
+          POSTGRES LOGS-ANALYSE:
+          ================================================================================
+          {{ postgres_logs_analysis.stdout }}
+          
+          ================================================================================
+          TRAEFIK LOGS-ANALYSE:
+          ================================================================================
+          {{ traefik_logs_analysis.stdout }}
+          
+          ================================================================================
+          INTERPRETATION:
+          ================================================================================
+          
+          {% set request_content = request_result.content | default('') | b64decode | default('') %}
+          {% set direct_content = direct_test_result.content | default('') | b64decode | default('') %}
+          {% set traefik_errors = traefik_logs_analysis.stdout | default('') %}
+          {% set gitea_errors = gitea_logs_analysis.stdout | default('') %}
+          {% set postgres_errors = postgres_logs_analysis.stdout | default('') %}
+          {% set stats_content = stats_analysis.stdout | default('') %}
+          
+          {% if 'timeout' in request_content or '504' in request_content or 'HTTP_CODE:504' in request_content %}
+          ⚠️  REQUEST HAT TIMEOUT/504:
+          
+          {% if 'EOF' in traefik_errors or 'backend' in traefik_errors | lower or 'connection.*error' in traefik_errors | lower %}
+          → Traefik meldet Backend-Connection-Error
+          → Gitea antwortet nicht auf Traefik's Verbindungsversuche
+          {% endif %}
+          
+          {% if 'timeout' in gitea_errors | lower or 'deadline exceeded' in gitea_errors | lower %}
+          → Gitea hat DB-Timeouts oder Context-Deadline-Exceeded
+          → Postgres könnte blockieren oder zu langsam sein
+          {% endif %}
+          
+          {% if 'too many connections' in postgres_errors | lower %}
+          → Postgres hat zu viele Verbindungen
+          → Connection Pool könnte überlastet sein
+          {% endif %}
+          
+          {% if 'HIGH CPU' in stats_content or '>80' in stats_content %}
+          → Gitea oder Postgres haben hohe CPU-Last
+          → Performance-Problem, nicht Timeout-Konfiguration
+          {% endif %}
+          
+          {% if 'DIRECT_TEST_FAILED' in direct_content or direct_content == '' %}
+          → Direkter Test Traefik → Gitea schlägt fehl
+          → Problem liegt bei Gitea selbst, nicht bei Traefik-Routing
+          {% endif %}
+          {% else %}
+          ✅ REQUEST WAR ERFOLGREICH:
+          → Problem tritt nur intermittierend auf
+          → Prüfe Logs auf sporadische Fehler
+          {% endif %}
+          
+          ================================================================================
+          NÄCHSTE SCHRITTE:
+          ================================================================================
+          
+          1. Prüfe ob hohe CPU/Memory bei Gitea oder Postgres
+          2. Prüfe ob DB-Timeouts in Gitea-Logs
+          3. Prüfe ob Postgres "too many connections" meldet
+          4. Prüfe ob Traefik "backend connection error" oder "EOF" meldet
+          5. Prüfe ob direkter Test Traefik → Gitea funktioniert
+          
+          ================================================================================
+
+    - name: Cleanup temporary files
+      ansible.builtin.file:
+        path: "/tmp/gitea_{{ test_timestamp }}.log"
+        state: absent
+      failed_when: false
+
diff --git a/deployment/ansible/playbooks/diagnose-gitea-timeouts.yml b/deployment/ansible/playbooks/diagnose-gitea-timeouts.yml
new file mode 100644
index 00000000..462f5d22
--- /dev/null
+++ b/deployment/ansible/playbooks/diagnose-gitea-timeouts.yml
@@ -0,0 +1,325 @@
+---
+# Diagnose Gitea Timeouts
+# Prüft Gitea-Status, Traefik-Routing, Netzwerk-Verbindungen und behebt Probleme
+- name: Diagnose Gitea Timeouts
+  hosts: production
+  gather_facts: yes
+  become: no
+
+  tasks:
+    - name: Check Gitea container status
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose ps gitea
+      register: gitea_status
+      changed_when: false
+
+    - name: Display Gitea container status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea Container Status:
+          ================================================================================
+          {{ gitea_status.stdout }}
+          ================================================================================
+
+    - name: Check Gitea health endpoint (direct from container)
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose exec -T gitea curl -f http://localhost:3000/api/healthz 2>&1 || echo "HEALTH_CHECK_FAILED"
+      register: gitea_health_direct
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea health (direct)
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea Health Check (direct from container):
+          ================================================================================
+          {% if 'HEALTH_CHECK_FAILED' not in gitea_health_direct.stdout %}
+          ✅ Gitea is healthy (direct check)
+          Response: {{ gitea_health_direct.stdout }}
+          {% else %}
+          ❌ Gitea health check failed (direct)
+          Error: {{ gitea_health_direct.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Check Gitea health endpoint (via Traefik)
+      ansible.builtin.uri:
+        url: "https://git.michaelschiemer.de/api/healthz"
+        method: GET
+        status_code: [200]
+        validate_certs: false
+        timeout: 10
+      register: gitea_health_traefik
+      failed_when: false
+      changed_when: false
+
+    - name: Display Gitea health (via Traefik)
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea Health Check (via Traefik):
+          ================================================================================
+          {% if gitea_health_traefik.status == 200 %}
+          ✅ Gitea is reachable via Traefik
+          Status: {{ gitea_health_traefik.status }}
+          {% else %}
+          ❌ Gitea is NOT reachable via Traefik
+          Status: {{ gitea_health_traefik.status | default('TIMEOUT/ERROR') }}
+          Message: {{ gitea_health_traefik.msg | default('No response') }}
+          {% endif %}
+          ================================================================================
+
+    - name: Check Traefik container status
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik
+        docker compose ps traefik
+      register: traefik_status
+      changed_when: false
+
+    - name: Display Traefik container status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Container Status:
+          ================================================================================
+          {{ traefik_status.stdout }}
+          ================================================================================
+
+    - name: Check Redis container status
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose ps redis
+      register: redis_status
+      changed_when: false
+
+    - name: Display Redis container status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Redis Container Status:
+          ================================================================================
+          {{ redis_status.stdout }}
+          ================================================================================
+
+    - name: Check PostgreSQL container status
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose ps postgres
+      register: postgres_status
+      changed_when: false
+
+    - name: Display PostgreSQL container status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          PostgreSQL Container Status:
+          ================================================================================
+          {{ postgres_status.stdout }}
+          ================================================================================
+
+    - name: Check Gitea container IP in traefik-public network
+      ansible.builtin.shell: |
+        docker inspect gitea --format '{{ '{{' }}range .NetworkSettings.Networks{{ '}}' }}{{ '{{' }}if eq .NetworkID (docker network inspect traefik-public --format "{{ '{{' }}.Id{{ '}}' }}"){{ '}}' }}{{ '{{' }}.IPAddress{{ '}}' }}{{ '{{' }}end{{ '}}' }}{{ '{{' }}end{{ '}}' }}' 2>/dev/null || echo "NOT_FOUND"
+      register: gitea_ip
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea IP in traefik-public network
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea IP in traefik-public Network:
+          ================================================================================
+          {% if gitea_ip.stdout and gitea_ip.stdout != 'NOT_FOUND' %}
+          ✅ Gitea IP: {{ gitea_ip.stdout }}
+          {% else %}
+          ❌ Gitea IP not found in traefik-public network
+          {% endif %}
+          ================================================================================
+
+    - name: Test connection from Traefik to Gitea
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik
+        docker compose exec -T traefik wget -qO- --timeout=5 http://gitea:3000/api/healthz 2>&1 || echo "CONNECTION_FAILED"
+      register: traefik_gitea_connection
+      changed_when: false
+      failed_when: false
+
+    - name: Display Traefik-Gitea connection test
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik → Gitea Connection Test:
+          ================================================================================
+          {% if 'CONNECTION_FAILED' in traefik_gitea_connection.stdout %}
+          ❌ Traefik cannot reach Gitea
+          Error: {{ traefik_gitea_connection.stdout }}
+          {% else %}
+          ✅ Traefik can reach Gitea
+          Response: {{ traefik_gitea_connection.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Check Traefik routing configuration for Gitea
+      ansible.builtin.shell: |
+        docker inspect gitea --format '{{ '{{' }}json .Config.Labels{{ '}}' }}' 2>/dev/null | grep -i "traefik" || echo "NO_TRAEFIK_LABELS"
+      register: traefik_labels
+      changed_when: false
+      failed_when: false
+
+    - name: Display Traefik labels for Gitea
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Labels for Gitea:
+          ================================================================================
+          {{ traefik_labels.stdout }}
+          ================================================================================
+
+    - name: Check Gitea logs for errors
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose logs gitea --tail=50 2>&1 | grep -iE "error|timeout|failed|panic|fatal" | tail -20 || echo "No errors in recent logs"
+      register: gitea_errors
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea errors
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea Error Logs (last 50 lines):
+          ================================================================================
+          {{ gitea_errors.stdout }}
+          ================================================================================
+
+    - name: Check Traefik logs for Gitea-related errors
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik
+        docker compose logs traefik --tail=50 2>&1 | grep -iE "gitea|git\.michaelschiemer\.de|timeout|error" | tail -20 || echo "No Gitea-related errors in Traefik logs"
+      register: traefik_gitea_errors
+      changed_when: false
+      failed_when: false
+
+    - name: Display Traefik Gitea errors
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Gitea-Related Error Logs (last 50 lines):
+          ================================================================================
+          {{ traefik_gitea_errors.stdout }}
+          ================================================================================
+
+    - name: Check if Gitea is in traefik-public network
+      ansible.builtin.shell: |
+        docker network inspect traefik-public --format '{{ '{{' }}range .Containers{{ '}}' }}{{ '{{' }}.Name{{ '}}' }} {{ '{{' }}end{{ '}}' }}' 2>/dev/null | grep -q gitea && echo "YES" || echo "NO"
+      register: gitea_in_traefik_network
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea network membership
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea in traefik-public Network:
+          ================================================================================
+          {% if gitea_in_traefik_network.stdout == 'YES' %}
+          ✅ Gitea is in traefik-public network
+          {% else %}
+          ❌ Gitea is NOT in traefik-public network
+          {% endif %}
+          ================================================================================
+
+    - name: Check Redis connection from Gitea
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose exec -T gitea sh -c "redis-cli -h redis -p 6379 -a gitea_redis_password ping 2>&1" || echo "REDIS_CONNECTION_FAILED"
+      register: gitea_redis_connection
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea-Redis connection
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea → Redis Connection:
+          ================================================================================
+          {% if 'REDIS_CONNECTION_FAILED' in gitea_redis_connection.stdout %}
+          ❌ Gitea cannot connect to Redis
+          Error: {{ gitea_redis_connection.stdout }}
+          {% else %}
+          ✅ Gitea can connect to Redis
+          Response: {{ gitea_redis_connection.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Check PostgreSQL connection from Gitea
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/gitea
+        docker compose exec -T gitea sh -c "pg_isready -h postgres -p 5432 -U gitea 2>&1" || echo "POSTGRES_CONNECTION_FAILED"
+      register: gitea_postgres_connection
+      changed_when: false
+      failed_when: false
+
+    - name: Display Gitea-PostgreSQL connection
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea → PostgreSQL Connection:
+          ================================================================================
+          {% if 'POSTGRES_CONNECTION_FAILED' in gitea_postgres_connection.stdout %}
+          ❌ Gitea cannot connect to PostgreSQL
+          Error: {{ gitea_postgres_connection.stdout }}
+          {% else %}
+          ✅ Gitea can connect to PostgreSQL
+          Response: {{ gitea_postgres_connection.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Summary and recommendations
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - Gitea Timeout Diagnose:
+          ================================================================================
+          
+          Gitea Status: {{ gitea_status.stdout | regex_replace('.*(Up|Down|Restarting).*', '\\1') | default('UNKNOWN') }}
+          Gitea Health (direct): {% if 'HEALTH_CHECK_FAILED' not in gitea_health_direct.stdout %}✅{% else %}❌{% endif %}
+          Gitea Health (via Traefik): {% if gitea_health_traefik.status == 200 %}✅{% else %}❌{% endif %}
+          Traefik Status: {{ traefik_status.stdout | regex_replace('.*(Up|Down|Restarting).*', '\\1') | default('UNKNOWN') }}
+          Redis Status: {{ redis_status.stdout | regex_replace('.*(Up|Down|Restarting).*', '\\1') | default('UNKNOWN') }}
+          PostgreSQL Status: {{ postgres_status.stdout | regex_replace('.*(Up|Down|Restarting).*', '\\1') | default('UNKNOWN') }}
+          
+          Netzwerk:
+          - Gitea in traefik-public: {% if gitea_in_traefik_network.stdout == 'YES' %}✅{% else %}❌{% endif %}
+          - Traefik → Gitea: {% if 'CONNECTION_FAILED' not in traefik_gitea_connection.stdout %}✅{% else %}❌{% endif %}
+          - Gitea → Redis: {% if 'REDIS_CONNECTION_FAILED' not in gitea_redis_connection.stdout %}✅{% else %}❌{% endif %}
+          - Gitea → PostgreSQL: {% if 'POSTGRES_CONNECTION_FAILED' not in gitea_postgres_connection.stdout %}✅{% else %}❌{% endif %}
+          
+          Empfohlene Aktionen:
+          {% if gitea_health_traefik.status != 200 %}
+          1. ❌ Gitea ist nicht über Traefik erreichbar
+             → Führe 'fix-gitea-timeouts.yml' aus um Gitea und Traefik zu restarten
+          {% endif %}
+          {% if gitea_in_traefik_network.stdout != 'YES' %}
+          2. ❌ Gitea ist nicht im traefik-public Netzwerk
+             → Gitea Container neu starten um Netzwerk-Verbindung zu aktualisieren
+          {% endif %}
+          {% if 'CONNECTION_FAILED' in traefik_gitea_connection.stdout %}
+          3. ❌ Traefik kann Gitea nicht erreichen
+             → Beide Container neu starten
+          {% endif %}
+          {% if 'REDIS_CONNECTION_FAILED' in gitea_redis_connection.stdout %}
+          4. ❌ Gitea kann Redis nicht erreichen
+             → Redis Container prüfen und neu starten
+          {% endif %}
+          {% if 'POSTGRES_CONNECTION_FAILED' in gitea_postgres_connection.stdout %}
+          5. ❌ Gitea kann PostgreSQL nicht erreichen
+             → PostgreSQL Container prüfen und neu starten
+          {% endif %}
+          
+          ================================================================================
diff --git a/deployment/ansible/playbooks/diagnose-staging-502.yml b/deployment/ansible/playbooks/diagnose-staging-502.yml
deleted file mode 100644
index 861224ff..00000000
--- a/deployment/ansible/playbooks/diagnose-staging-502.yml
+++ /dev/null
@@ -1,108 +0,0 @@
----
-- name: Diagnose Staging 502 Bad Gateway Error
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check nginx error logs for 502 errors
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Nginx Error Logs (Last 50 lines) ==="
-        docker compose logs --tail=50 staging-nginx 2>&1 | grep -iE "(error|502|bad gateway|php|fpm|upstream)" || echo "No obvious errors in logs"
-      args:
-        executable: /bin/bash
-      register: nginx_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx errors
-      debug:
-        msg: "{{ nginx_errors.stdout_lines }}"
-
-    - name: Check PHP-FPM status in staging-app
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== PHP-FPM Status Check ==="
-        docker compose exec -T staging-app php-fpm-healthcheck 2>&1 || echo "PHP-FPM healthcheck failed"
-        echo ""
-        echo "=== Check if PHP-FPM is running ==="
-        docker compose exec -T staging-app ps aux | grep -E "php-fpm|php" | head -10 || echo "Could not check processes"
-      args:
-        executable: /bin/bash
-      register: php_fpm_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM status
-      debug:
-        msg: "{{ php_fpm_status.stdout_lines }}"
-
-    - name: Test PHP-FPM connection from nginx container
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Test connection from nginx to PHP-FPM ==="
-        docker compose exec -T staging-nginx sh -c "nc -zv staging-app 9000 2>&1 || echo 'Connection test failed'" || echo "Connection test failed"
-        echo ""
-        echo "=== Try curl from nginx to PHP-FPM ==="
-        docker compose exec -T staging-nginx sh -c "curl -v http://staging-app:9000 2>&1 | head -20" || echo "Curl test failed"
-      args:
-        executable: /bin/bash
-      register: connection_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display connection test results
-      debug:
-        msg: "{{ connection_test.stdout_lines }}"
-
-    - name: Check nginx configuration for PHP-FPM upstream
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Nginx Configuration ==="
-        docker compose exec -T staging-nginx cat /etc/nginx/conf.d/default.conf 2>&1 | grep -A 10 -B 5 "staging-app\|9000\|fastcgi_pass" || echo "Could not read nginx config"
-      args:
-        executable: /bin/bash
-      register: nginx_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx configuration
-      debug:
-        msg: "{{ nginx_config.stdout_lines }}"
-
-    - name: Check if PHP-FPM is listening on port 9000
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Check PHP-FPM port 9000 ==="
-        docker compose exec -T staging-app sh -c "netstat -tlnp 2>/dev/null | grep 9000 || ss -tlnp 2>/dev/null | grep 9000 || echo 'Port 9000 not found'" || echo "Could not check ports"
-        echo ""
-        echo "=== PHP-FPM pool config ==="
-        docker compose exec -T staging-app cat /usr/local/etc/php-fpm.d/www.conf 2>&1 | grep -E "(listen|listen.allowed_clients)" | head -5 || echo "Could not read PHP-FPM config"
-      args:
-        executable: /bin/bash
-      register: php_fpm_port
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM port check
-      debug:
-        msg: "{{ php_fpm_port.stdout_lines }}"
-
-    - name: Check network connectivity between containers
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Network connectivity ==="
-        docker compose exec -T staging-nginx ping -c 2 staging-app 2>&1 || echo "Ping failed"
-        echo ""
-        echo "=== Check docker networks ==="
-        docker network inspect staging-internal 2>&1 | grep -A 5 "staging-app\|staging-nginx" || echo "Could not inspect network"
-      args:
-        executable: /bin/bash
-      register: network_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display network check
-      debug:
-        msg: "{{ network_check.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/diagnose-staging-logs.yml b/deployment/ansible/playbooks/diagnose-staging-logs.yml
deleted file mode 100644
index a3e5a723..00000000
--- a/deployment/ansible/playbooks/diagnose-staging-logs.yml
+++ /dev/null
@@ -1,125 +0,0 @@
----
-- name: Diagnose Staging Logs Issue
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if staging stack directory exists
-      shell: |
-        test -d ~/deployment/stacks/staging && echo "? Directory exists" || echo "? Directory missing"
-      args:
-        executable: /bin/bash
-      register: dir_check
-
-    - name: Display directory check result
-      debug:
-        msg: "{{ dir_check.stdout }}"
-
-    - name: Check if docker-compose.yml exists
-      shell: |
-        test -f ~/deployment/stacks/staging/docker-compose.yml && echo "? docker-compose.yml exists" || echo "? docker-compose.yml missing"
-      args:
-        executable: /bin/bash
-      register: compose_check
-
-    - name: Display compose file check result
-      debug:
-        msg: "{{ compose_check.stdout }}"
-
-    - name: List staging directory contents
-      shell: |
-        cd ~/deployment/stacks/staging && ls -la
-      args:
-        executable: /bin/bash
-      register: dir_contents
-      ignore_errors: yes
-
-    - name: Display directory contents
-      debug:
-        msg: "{{ dir_contents.stdout_lines }}"
-
-    - name: Check Docker Compose version
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose version
-      args:
-        executable: /bin/bash
-      register: compose_version
-      ignore_errors: yes
-
-    - name: Display Docker Compose version
-      debug:
-        msg: "{{ compose_version.stdout }}"
-
-    - name: Check if containers exist
-      shell: |
-        docker ps -a | grep staging || echo "No staging containers found"
-      args:
-        executable: /bin/bash
-      register: container_list
-      ignore_errors: yes
-
-    - name: Display container list
-      debug:
-        msg: "{{ container_list.stdout_lines }}"
-
-    - name: Try docker compose ps (this is where it might fail)
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose ps
-      args:
-        executable: /bin/bash
-      register: compose_ps
-      ignore_errors: yes
-
-    - name: Display docker compose ps result
-      debug:
-        msg: "{{ compose_ps.stdout_lines }}"
-        msg_also: "{{ compose_ps.stderr_lines }}"
-
-    - name: Try docker compose logs directly (without service name)
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=50 2>&1 | head -100
-      args:
-        executable: /bin/bash
-      register: compose_logs_generic
-      ignore_errors: yes
-
-    - name: Display generic compose logs
-      debug:
-        msg: "{{ (compose_logs_generic.stdout_lines | default([])) + (compose_logs_generic.stderr_lines | default([])) }}"
-
-    - name: Try individual container logs using docker logs
-      shell: |
-        docker logs staging-app --tail=50 2>&1 || echo "? Could not get staging-app logs"
-      args:
-        executable: /bin/bash
-      register: direct_app_logs
-      ignore_errors: yes
-
-    - name: Display direct staging-app logs
-      debug:
-        msg: "{{ direct_app_logs.stdout_lines }}"
-        msg_also: "{{ direct_app_logs.stderr_lines }}"
-
-    - name: Check current working directory permissions
-      shell: |
-        ls -ld ~/deployment/stacks/staging && pwd && whoami
-      args:
-        executable: /bin/bash
-      register: perm_check
-
-    - name: Display permission check
-      debug:
-        msg: "{{ perm_check.stdout_lines }}"
-
-    - name: Check if we can read docker-compose.yml
-      shell: |
-        cd ~/deployment/stacks/staging && head -20 docker-compose.yml
-      args:
-        executable: /bin/bash
-      register: compose_read
-      ignore_errors: yes
-
-    - name: Display docker-compose.yml content (first 20 lines)
-      debug:
-        msg: "{{ (compose_read.stdout_lines | default([])) + (compose_read.stderr_lines | default([])) }}"
diff --git a/deployment/ansible/playbooks/diagnose-traefik-restarts.yml b/deployment/ansible/playbooks/diagnose-traefik-restarts.yml
new file mode 100644
index 00000000..2c39d64d
--- /dev/null
+++ b/deployment/ansible/playbooks/diagnose-traefik-restarts.yml
@@ -0,0 +1,477 @@
+---
+# Diagnose: Finde Ursache für Traefik Restart-Loop
+# Prüft alle möglichen Ursachen für regelmäßige Traefik-Restarts
+- name: Diagnose Traefik Restart Loop
+  hosts: production
+  gather_facts: yes
+  become: yes
+
+  tasks:
+    - name: Check systemd timers
+      ansible.builtin.shell: |
+        systemctl list-timers --all --no-pager
+      register: systemd_timers
+      changed_when: false
+
+    - name: Display systemd timers
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Systemd Timers (können Container stoppen):
+          ================================================================================
+          {{ systemd_timers.stdout }}
+          ================================================================================
+
+    - name: Check root crontab
+      ansible.builtin.shell: |
+        crontab -l 2>/dev/null || echo "No root crontab"
+      register: root_crontab
+      changed_when: false
+
+    - name: Display root crontab
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Root Crontab:
+          ================================================================================
+          {{ root_crontab.stdout }}
+          ================================================================================
+
+    - name: Check deploy user crontab
+      ansible.builtin.shell: |
+        crontab -l -u deploy 2>/dev/null || echo "No deploy user crontab"
+      register: deploy_crontab
+      changed_when: false
+
+    - name: Display deploy user crontab
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Deploy User Crontab:
+          ================================================================================
+          {{ deploy_crontab.stdout }}
+          ================================================================================
+
+    - name: Check system-wide cron jobs
+      ansible.builtin.shell: |
+        echo "=== /etc/cron.d ==="
+        ls -la /etc/cron.d 2>/dev/null || echo "Directory not found"
+        grep -r "traefik\|docker.*compose.*traefik\|docker.*stop\|docker.*restart" /etc/cron.d 2>/dev/null || echo "No matches"
+        echo ""
+        echo "=== /etc/cron.daily ==="
+        ls -la /etc/cron.daily 2>/dev/null || echo "Directory not found"
+        grep -r "traefik\|docker.*compose.*traefik\|docker.*stop\|docker.*restart" /etc/cron.daily 2>/dev/null || echo "No matches"
+        echo ""
+        echo "=== /etc/cron.hourly ==="
+        ls -la /etc/cron.hourly 2>/dev/null || echo "Directory not found"
+        grep -r "traefik\|docker.*compose.*traefik\|docker.*stop\|docker.*restart" /etc/cron.hourly 2>/dev/null || echo "No matches"
+        echo ""
+        echo "=== /etc/cron.weekly ==="
+        ls -la /etc/cron.weekly 2>/dev/null || echo "Directory not found"
+        grep -r "traefik\|docker.*compose.*traefik\|docker.*stop\|docker.*restart" /etc/cron.weekly 2>/dev/null || echo "No matches"
+        echo ""
+        echo "=== /etc/cron.monthly ==="
+        ls -la /etc/cron.monthly 2>/dev/null || echo "Directory not found"
+        grep -r "traefik\|docker.*compose.*traefik\|docker.*stop\|docker.*restart" /etc/cron.monthly 2>/dev/null || echo "No matches"
+      register: system_cron
+      changed_when: false
+
+    - name: Display system cron jobs
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          System-Wide Cron Jobs:
+          ================================================================================
+          {{ system_cron.stdout }}
+          ================================================================================
+
+    - name: Check for scripts that might restart Traefik
+      ansible.builtin.shell: |
+        find /home/deploy -type f -name "*.sh" -exec grep -l "traefik\|docker.*compose.*restart\|docker.*stop.*traefik\|docker.*down.*traefik" {} \; 2>/dev/null | head -20
+      register: traefik_scripts
+      changed_when: false
+
+    - name: Display scripts that might restart Traefik
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Scripts die Traefik stoppen/restarten könnten:
+          ================================================================================
+          {% if traefik_scripts.stdout %}
+          {{ traefik_scripts.stdout }}
+          {% else %}
+          Keine Skripte gefunden
+          {% endif %}
+          ================================================================================
+
+    - name: Check Docker events for Traefik container (last 24h)
+      ansible.builtin.shell: |
+        timeout 5 docker events --since 24h --filter container=traefik --format "{{ '{{' }}.Time{{ '}}' }} {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.name{{ '}}' }}" 2>/dev/null | tail -50 || echo "No recent events or docker events not available"
+      register: docker_events
+      changed_when: false
+
+    - name: Display Docker events
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Events für Traefik (letzte 24h):
+          ================================================================================
+          {{ docker_events.stdout }}
+          ================================================================================
+
+    - name: Check Traefik container exit history
+      ansible.builtin.shell: |
+        docker ps -a --filter "name=traefik" --format "{{ '{{' }}.ID{{ '}}' }} | {{ '{{' }}.Status{{ '}}' }} | {{ '{{' }}.CreatedAt{{ '}}' }}" | head -10
+      register: traefik_exits
+      changed_when: false
+
+    - name: Display Traefik container exit history
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Container Exit-Historie:
+          ================================================================================
+          {{ traefik_exits.stdout }}
+          ================================================================================
+
+    - name: Check Docker daemon logs for Traefik stops
+      ansible.builtin.shell: |
+        journalctl -u docker.service --since "24h ago" --no-pager | grep -i "traefik\|stop\|kill" | tail -50 || echo "No relevant logs in journalctl"
+      register: docker_daemon_logs
+      changed_when: false
+
+    - name: Display Docker daemon logs
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Daemon Logs (Traefik/Stop/Kill):
+          ================================================================================
+          {{ docker_daemon_logs.stdout }}
+          ================================================================================
+
+    - name: Check if there's a health check script running
+      ansible.builtin.shell: |
+        ps aux | grep -E "traefik|health.*check|monitor.*docker|auto.*heal|watchdog" | grep -v grep || echo "No health check processes found"
+      register: health_check_processes
+      changed_when: false
+
+    - name: Display health check processes
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Laufende Health-Check/Monitoring-Prozesse:
+          ================================================================================
+          {{ health_check_processes.stdout }}
+          ================================================================================
+
+    - name: Check for monitoring/auto-heal scripts
+      ansible.builtin.shell: |
+        find /home/deploy -type f \( -name "*monitor*" -o -name "*health*" -o -name "*auto*heal*" -o -name "*watchdog*" \) 2>/dev/null | head -20
+      register: monitoring_scripts
+      changed_when: false
+
+    - name: Display monitoring scripts
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Monitoring/Auto-Heal-Skripte:
+          ================================================================================
+          {% if monitoring_scripts.stdout %}
+          {{ monitoring_scripts.stdout }}
+          {% else %}
+          Keine Monitoring-Skripte gefunden
+          {% endif %}
+          ================================================================================
+
+    - name: Check Docker Compose file for restart policies
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik && grep -A 5 "restart:" docker-compose.yml || echo "No restart policy found"
+      register: restart_policy
+      changed_when: false
+
+    - name: Display restart policy
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Compose Restart Policy:
+          ================================================================================
+          {{ restart_policy.stdout }}
+          ================================================================================
+
+    - name: Check if Traefik is managed by systemd
+      ansible.builtin.shell: |
+        systemctl list-units --type=service --all | grep -i traefik || echo "No Traefik systemd service found"
+      register: traefik_systemd
+      changed_when: false
+
+    - name: Display Traefik systemd service
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Systemd Service:
+          ================================================================================
+          {{ traefik_systemd.stdout }}
+          ================================================================================
+
+    - name: Check recent Traefik container logs for stop messages
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik && docker compose logs traefik --since 24h 2>&1 | grep -E "I have to go|Stopping server gracefully|SIGTERM|SIGINT|received signal" | tail -20 || echo "No stop messages in logs"
+      register: traefik_stop_logs
+      changed_when: false
+
+    - name: Display Traefik stop messages
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Stop-Meldungen (letzte 24h):
+          ================================================================================
+          {{ traefik_stop_logs.stdout }}
+          ================================================================================
+
+    - name: Check Traefik container uptime and restart count
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.State.StartedAt{{ '}}' }} | {{ '{{' }}.State.FinishedAt{{ '}}' }} | Restarts: {{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "Container not found"
+      register: traefik_uptime
+      changed_when: false
+
+    - name: Display Traefik uptime and restart count
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Container Uptime & Restart Count:
+          ================================================================================
+          {{ traefik_uptime.stdout }}
+          ================================================================================
+
+    - name: Check for unattended-upgrades activity
+      ansible.builtin.shell: |
+        journalctl -u unattended-upgrades --since "24h ago" --no-pager | tail -20 || echo "No unattended-upgrades logs"
+      register: unattended_upgrades
+      changed_when: false
+
+    - name: Display unattended-upgrades activity
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Unattended-Upgrades Aktivität (kann zu Reboots führen):
+          ================================================================================
+          {{ unattended_upgrades.stdout }}
+          ================================================================================
+
+    - name: Check system reboot history
+      ansible.builtin.shell: |
+        last reboot | head -10 || echo "No reboot history available"
+      register: reboot_history
+      changed_when: false
+
+    - name: Display reboot history
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          System Reboot-Historie:
+          ================================================================================
+          {{ reboot_history.stdout }}
+          ================================================================================
+
+    - name: Check Docker Compose processes that might affect Traefik
+      ansible.builtin.shell: |
+        ps aux | grep -E "docker.*compose.*traefik|docker-compose.*traefik" | grep -v grep || echo "No docker compose processes for Traefik found"
+      register: docker_compose_processes
+      changed_when: false
+
+    - name: Display Docker Compose processes
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Compose Prozesse für Traefik:
+          ================================================================================
+          {{ docker_compose_processes.stdout }}
+          ================================================================================
+
+    - name: Check all user crontabs (not just root/deploy)
+      ansible.builtin.shell: |
+        for user in $(cut -f1 -d: /etc/passwd); do
+          crontab -u "$user" -l 2>/dev/null | grep -q "traefik\|docker.*compose.*traefik\|docker.*restart.*traefik" && echo "=== User: $user ===" && crontab -u "$user" -l 2>/dev/null | grep -E "traefik|docker.*compose.*traefik|docker.*restart.*traefik" || true
+        done || echo "No user crontabs with Traefik commands found"
+      register: all_user_crontabs
+      changed_when: false
+
+    - name: Display all user crontabs with Traefik commands
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Alle User-Crontabs mit Traefik-Befehlen:
+          ================================================================================
+          {{ all_user_crontabs.stdout }}
+          ================================================================================
+
+    - name: Check for Gitea Workflows that might restart Traefik
+      ansible.builtin.shell: |
+        find /home/deploy -type f -path "*/.gitea/workflows/*.yml" -o -path "*/.github/workflows/*.yml" 2>/dev/null | xargs grep -l "traefik\|restart.*traefik\|docker.*compose.*traefik" 2>/dev/null | head -10 || echo "No Gitea/GitHub workflows found that restart Traefik"
+      register: gitea_workflows
+      changed_when: false
+
+    - name: Display Gitea Workflows that might restart Traefik
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Gitea/GitHub Workflows die Traefik restarten könnten:
+          ================================================================================
+          {{ gitea_workflows.stdout }}
+          ================================================================================
+
+    - name: Check for custom systemd services in /etc/systemd/system/
+      ansible.builtin.shell: |
+        find /etc/systemd/system -type f -name "*.service" -o -name "*.timer" 2>/dev/null | xargs grep -l "traefik\|docker.*compose.*traefik\|docker.*restart.*traefik" 2>/dev/null | head -10 || echo "No custom systemd services/timers found for Traefik"
+      register: custom_systemd_services
+      changed_when: false
+
+    - name: Display custom systemd services
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Custom Systemd Services/Timers für Traefik:
+          ================================================================================
+          {{ custom_systemd_services.stdout }}
+          ================================================================================
+
+    - name: Check for at jobs (scheduled tasks)
+      ansible.builtin.shell: |
+        atq 2>/dev/null | while read line; do
+          job_id=$(echo "$line" | awk '{print $1}')
+                   at -c "$job_id" 2>/dev/null | grep -q "traefik\|docker.*compose.*traefik\|docker.*restart.*traefik" && echo "=== Job ID: $job_id ===" && at -c "$job_id" 2>/dev/null | grep -E "traefik|docker.*compose.*traefik|docker.*restart.*traefik" || true
+        done || echo "No at jobs found or atq not available"
+      register: at_jobs
+      changed_when: false
+
+    - name: Display at jobs
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          At Jobs (geplante Tasks) die Traefik betreffen:
+          ================================================================================
+          {{ at_jobs.stdout }}
+          ================================================================================
+
+    - name: Check for Docker Compose watch mode
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik && docker compose ps --format json 2>/dev/null | jq -r '.[] | select(.Service=="traefik") | .State' || echo "Could not check Docker Compose watch mode"
+      register: docker_compose_watch
+      changed_when: false
+
+    - name: Check if Docker Compose watch is enabled
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik && docker compose config 2>/dev/null | grep -i "watch\|x-develop" || echo "No watch mode configured"
+      register: docker_compose_watch_config
+      changed_when: false
+
+    - name: Display Docker Compose watch mode
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Compose Watch Mode:
+          ================================================================================
+          Watch Config: {{ docker_compose_watch_config.stdout }}
+          ================================================================================
+
+    - name: Check Ansible traefik_auto_restart setting
+      ansible.builtin.shell: |
+        grep -r "traefik_auto_restart" /home/deploy/deployment/ansible/roles/traefik/defaults/ /home/deploy/deployment/ansible/inventory/ 2>/dev/null | head -10 || echo "traefik_auto_restart not found in Ansible config"
+      register: ansible_auto_restart
+      changed_when: false
+
+    - name: Display Ansible traefik_auto_restart setting
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Ansible traefik_auto_restart Einstellung:
+          ================================================================================
+          {{ ansible_auto_restart.stdout }}
+          ================================================================================
+
+    - name: Check Port 80/443 configuration
+      ansible.builtin.shell: |
+        echo "=== Port 80 ==="
+        netstat -tlnp 2>/dev/null | grep ":80 " || ss -tlnp 2>/dev/null | grep ":80 " || echo "Could not check port 80"
+        echo ""
+        echo "=== Port 443 ==="
+        netstat -tlnp 2>/dev/null | grep ":443 " || ss -tlnp 2>/dev/null | grep ":443 " || echo "Could not check port 443"
+        echo ""
+        echo "=== Docker Port Mappings for Traefik ==="
+        docker inspect traefik --format '{{ '{{' }}json .HostConfig.PortBindings{{ '}}' }}' 2>/dev/null | jq '.' || echo "Could not get Docker port mappings"
+      register: port_config
+      changed_when: false
+
+    - name: Display Port configuration
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Port-Konfiguration (80/443):
+          ================================================================================
+          {{ port_config.stdout }}
+          ================================================================================
+
+    - name: Check if other services are blocking ports 80/443
+      ansible.builtin.shell: |
+        echo "=== Services listening on port 80 ==="
+        lsof -i :80 2>/dev/null || fuser 80/tcp 2>/dev/null || echo "Could not check port 80"
+        echo ""
+        echo "=== Services listening on port 443 ==="
+        lsof -i :443 2>/dev/null || fuser 443/tcp 2>/dev/null || echo "Could not check port 443"
+      register: port_blockers
+      changed_when: false
+
+    - name: Display port blockers
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Services die Ports 80/443 blockieren könnten:
+          ================================================================================
+          {{ port_blockers.stdout }}
+          ================================================================================
+
+    - name: Check Traefik network configuration
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}json .NetworkSettings{{ '}}' }}' 2>/dev/null | jq '.Networks' || echo "Could not get Traefik network configuration"
+      register: traefik_network
+      changed_when: false
+
+    - name: Display Traefik network configuration
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Netzwerk-Konfiguration:
+          ================================================================================
+          {{ traefik_network.stdout }}
+          ================================================================================
+
+    - name: Summary - Most likely causes
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - Mögliche Ursachen für Traefik-Restarts:
+          ================================================================================
+          
+          Prüfe die obigen Ausgaben auf:
+          
+          1. Systemd-Timer: Können Container stoppen (z.B. unattended-upgrades)
+          2. Cronjobs: Regelmäßige Skripte die Traefik stoppen (alle User-Crontabs geprüft)
+          3. Docker-Events: Zeigen wer/was den Container stoppt
+          4. Monitoring-Skripte: Auto-Heal-Skripte die bei Fehlern restarten
+          5. Unattended-Upgrades: Können zu Reboots führen
+          6. Reboot-Historie: System-Reboots stoppen alle Container
+          7. Gitea Workflows: Können Traefik via Ansible restarten
+          8. Custom Systemd Services: Eigene Services die Traefik verwalten
+          9. At Jobs: Geplante Tasks die Traefik stoppen
+          10. Docker Compose Watch Mode: Automatische Restarts bei Dateiänderungen
+          11. Ansible traefik_auto_restart: Automatische Restarts nach Config-Deployment
+          12. Port-Konfiguration: Ports 80/443 müssen auf Traefik zeigen
+          
+          Nächste Schritte:
+          - Prüfe die Docker-Events für wiederkehrende Muster
+          - Prüfe alle User-Crontabs auf regelmäßige Traefik-Befehle
+          - Prüfe ob Monitoring-Skripte zu aggressiv sind
+          - Prüfe ob unattended-upgrades zu Reboots führt
+          - Prüfe ob traefik_auto_restart zu häufigen Restarts führt
+          - Verifiziere Port-Konfiguration (80/443)
+          ================================================================================
diff --git a/deployment/ansible/playbooks/diagnose-vpn-routing.yml b/deployment/ansible/playbooks/diagnose-vpn-routing.yml
deleted file mode 100644
index 98985a56..00000000
--- a/deployment/ansible/playbooks/diagnose-vpn-routing.yml
+++ /dev/null
@@ -1,172 +0,0 @@
----
-- name: Diagnose VPN Routing Problem f?r Grafana
-  hosts: production
-  gather_facts: yes
-  become: yes
-  become_user: root
-
-  tasks:
-    - name: Check WireGuard interface status
-      shell: |
-        echo "=== WireGuard Interface Status ==="
-        ip addr show wg0 2>&1 || echo "WireGuard interface not found"
-        echo ""
-        echo "=== WireGuard Peers ==="
-        wg show 2>&1 || echo "WireGuard not running"
-      register: wg_status
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display WireGuard status
-      debug:
-        msg: "{{ wg_status.stdout_lines }}"
-
-    - name: Check routing table for VPN network
-      shell: |
-        echo "=== Routing Table for 10.8.0.0/24 ==="
-        ip route show | grep 10.8.0 || echo "No routes found for 10.8.0.0/24"
-        echo ""
-        echo "=== Default Route ==="
-        ip route show default || echo "No default route"
-      register: routing_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display routing information
-      debug:
-        msg: "{{ routing_info.stdout_lines }}"
-
-    - name: Check Traefik access logs for recent Grafana requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Recent Grafana Access (Last 10 requests) ==="
-        tail -50 logs/access.log | grep grafana | tail -10 | jq -r '[.ClientAddr, .ClientHost, .RequestHost, .DownstreamStatus] | @tsv' 2>&1 || tail -50 logs/access.log | grep grafana | tail -10
-      args:
-        executable: /bin/bash
-      register: traefik_access
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik access logs
-      debug:
-        msg: "{{ traefik_access.stdout_lines }}"
-
-    - name: Test DNS resolution from server
-      shell: |
-        echo "=== DNS Resolution Tests ==="
-        echo "1. Grafana via VPN DNS (10.8.0.1):"
-        dig +short grafana.michaelschiemer.de @10.8.0.1 2>&1 || echo "Failed"
-        echo ""
-        echo "2. Grafana via public DNS (8.8.8.8):"
-        dig +short grafana.michaelschiemer.de @8.8.8.8 2>&1 || echo "Failed"
-        echo ""
-        echo "3. Grafana via system DNS:"
-        dig +short grafana.michaelschiemer.de 2>&1 || echo "Failed"
-      args:
-        executable: /bin/bash
-      register: dns_tests
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display DNS test results
-      debug:
-        msg: "{{ dns_tests.stdout_lines }}"
-
-    - name: Check firewall rules for WireGuard
-      shell: |
-        echo "=== Firewall Rules for WireGuard (port 51820) ==="
-        sudo ufw status | grep 51820 || sudo iptables -L -n | grep 51820 || echo "No firewall rules found"
-        echo ""
-        echo "=== Allowed IPs in WireGuard Config ==="
-        grep -E "AllowedIPs" /etc/wireguard/wg0.conf 2>&1 || echo "WireGuard config not found"
-      args:
-        executable: /bin/bash
-      register: firewall_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display firewall information
-      debug:
-        msg: "{{ firewall_info.stdout_lines }}"
-
-    - name: Check Traefik forwardedHeaders configuration
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Traefik forwardedHeaders Config ==="
-        grep -A 10 "forwardedHeaders:" traefik.yml || echo "Not found"
-      args:
-        executable: /bin/bash
-      register: forwarded_headers
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display forwardedHeaders configuration
-      debug:
-        msg: "{{ forwarded_headers.stdout_lines }}"
-
-    - name: Check Grafana middleware configuration
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        echo "=== Grafana VPN Only Middleware ==="
-        grep -A 6 "grafana-vpn-only:" middlewares.yml || echo "Not found"
-      args:
-        executable: /bin/bash
-      register: grafana_middleware
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Grafana middleware configuration
-      debug:
-        msg: "{{ grafana_middleware.stdout_lines }}"
-
-    - name: Check CoreDNS configuration
-      shell: |
-        cd ~/deployment/stacks/dns
-        echo "=== CoreDNS Corefile ==="
-        cat Corefile 2>&1 || echo "Not found"
-      args:
-        executable: /bin/bash
-      register: coredns_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display CoreDNS configuration
-      debug:
-        msg: "{{ coredns_config.stdout_lines }}"
-
-    - name: Test connection to Grafana from server via VPN IP
-      shell: |
-        echo "=== Test Connection to Grafana via VPN IP (10.8.0.1) ==="
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP %{http_code}\n" https://10.8.0.1:443 -H "Host: grafana.michaelschiemer.de" 2>&1 || echo "Connection failed"
-        echo ""
-        echo "=== Test Connection via Domain ==="
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP %{http_code}\n" https://grafana.michaelschiemer.de/ 2>&1 || echo "Connection failed"
-      args:
-        executable: /bin/bash
-      register: connection_tests
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display connection test results
-      debug:
-        msg: "{{ connection_tests.stdout_lines }}"
-
-    - name: Monitor Traefik access logs in real-time (for next request)
-      shell: |
-        echo "=== Instructions ==="
-        echo "1. Connect to VPN with your WireGuard client"
-        echo "2. Ensure DNS is set to 10.8.0.1 in WireGuard config"
-        echo "3. Access https://grafana.michaelschiemer.de in your browser"
-        echo "4. Check the ClientAddr in the access logs below"
-        echo ""
-        echo "=== Last Grafana Access Attempt ==="
-        tail -1 ~/deployment/stacks/traefik/logs/access.log 2>&1 | jq -r '[.ClientAddr, .ClientHost, .DownstreamStatus] | @tsv' || tail -1 ~/deployment/stacks/traefik/logs/access.log
-      args:
-        executable: /bin/bash
-      register: monitoring_info
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display monitoring instructions
-      debug:
-        msg: "{{ monitoring_info.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/disable-traefik-auto-restarts.yml b/deployment/ansible/playbooks/disable-traefik-auto-restarts.yml
new file mode 100644
index 00000000..b44b8262
--- /dev/null
+++ b/deployment/ansible/playbooks/disable-traefik-auto-restarts.yml
@@ -0,0 +1,136 @@
+---
+# Disable Traefik Auto-Restarts
+# Deaktiviert automatische Restarts nach Config-Deployment und entfernt Cronjobs/Systemd-Timer
+- name: Disable Traefik Auto-Restarts
+  hosts: production
+  gather_facts: yes
+  become: yes
+
+  tasks:
+    - name: Check current traefik_auto_restart setting in Ansible defaults
+      ansible.builtin.shell: |
+        grep -r "traefik_auto_restart" /home/deploy/deployment/ansible/roles/traefik/defaults/main.yml 2>/dev/null || echo "Setting not found"
+      register: current_auto_restart_setting
+      changed_when: false
+
+    - name: Display current traefik_auto_restart setting
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Aktuelle traefik_auto_restart Einstellung:
+          ================================================================================
+          {{ current_auto_restart_setting.stdout }}
+          ================================================================================
+
+    - name: Check for cronjobs that restart Traefik
+      ansible.builtin.shell: |
+        for user in $(cut -f1 -d: /etc/passwd); do
+          crontab -u "$user" -l 2>/dev/null | grep -q "traefik\|docker.*compose.*traefik.*restart" && echo "=== User: $user ===" && crontab -u "$user" -l 2>/dev/null | grep -E "traefik|docker.*compose.*traefik.*restart" || true
+        done || echo "No cronjobs found that restart Traefik"
+      register: traefik_cronjobs
+      changed_when: false
+
+    - name: Display Traefik cronjobs
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Cronjobs die Traefik restarten:
+          ================================================================================
+          {{ traefik_cronjobs.stdout }}
+          ================================================================================
+
+    - name: Check for systemd timers that restart Traefik
+      ansible.builtin.shell: |
+        find /etc/systemd/system -type f -name "*.timer" 2>/dev/null | xargs grep -l "traefik\|docker.*compose.*traefik.*restart" 2>/dev/null | head -10 || echo "No systemd timers found for Traefik"
+      register: traefik_timers
+      changed_when: false
+
+    - name: Display Traefik systemd timers
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Systemd Timers die Traefik restarten:
+          ================================================================================
+          {{ traefik_timers.stdout }}
+          ================================================================================
+
+    - name: Check for systemd services that restart Traefik
+      ansible.builtin.shell: |
+        find /etc/systemd/system -type f -name "*.service" 2>/dev/null | xargs grep -l "traefik\|docker.*compose.*traefik.*restart" 2>/dev/null | head -10 || echo "No systemd services found for Traefik"
+      register: traefik_services
+      changed_when: false
+
+    - name: Display Traefik systemd services
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Systemd Services die Traefik restarten:
+          ================================================================================
+          {{ traefik_services.stdout }}
+          ================================================================================
+
+    - name: Summary - Found auto-restart mechanisms
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - Gefundene Auto-Restart-Mechanismen:
+          ================================================================================
+          
+          Ansible traefik_auto_restart: {{ current_auto_restart_setting.stdout }}
+          
+          {% if traefik_cronjobs.stdout and 'No cronjobs' not in traefik_cronjobs.stdout %}
+          ⚠️  Gefundene Cronjobs:
+          {{ traefik_cronjobs.stdout }}
+          
+          Manuelle Deaktivierung erforderlich:
+          - Entferne die Cronjob-Einträge manuell
+          - Oder verwende: crontab -e
+          {% endif %}
+          
+          {% if traefik_timers.stdout and 'No systemd timers' not in traefik_timers.stdout %}
+          ⚠️  Gefundene Systemd Timers:
+          {{ traefik_timers.stdout }}
+          
+          Manuelle Deaktivierung erforderlich:
+          - systemctl stop <timer-name>
+          - systemctl disable <timer-name>
+          {% endif %}
+          
+          {% if traefik_services.stdout and 'No systemd services' not in traefik_services.stdout %}
+          ⚠️  Gefundene Systemd Services:
+          {{ traefik_services.stdout }}
+          
+          Manuelle Deaktivierung erforderlich:
+          - systemctl stop <service-name>
+          - systemctl disable <service-name>
+          {% endif %}
+          
+          {% if 'No cronjobs' in traefik_cronjobs.stdout and 'No systemd timers' in traefik_timers.stdout and 'No systemd services' in traefik_services.stdout %}
+          ✅ Keine automatischen Restart-Mechanismen gefunden (außer Ansible traefik_auto_restart)
+          {% endif %}
+          
+          Empfehlung:
+          - Setze traefik_auto_restart: false in group_vars oder inventory
+          - Oder überschreibe bei Config-Deployment: -e "traefik_auto_restart=false"
+          ================================================================================
+
+    - name: Note - Manual steps required
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          HINWEIS - Manuelle Schritte erforderlich:
+          ================================================================================
+          
+          Dieses Playbook zeigt nur gefundene Auto-Restart-Mechanismen an.
+          
+          Um traefik_auto_restart zu deaktivieren:
+          
+          1. In group_vars/production/vars.yml oder inventory hinzufügen:
+             traefik_auto_restart: false
+          
+          2. Oder bei jedem Config-Deployment überschreiben:
+             ansible-playbook ... -e "traefik_auto_restart=false"
+          
+          3. Für Cronjobs/Systemd: Siehe oben für manuelle Deaktivierung
+          
+          ================================================================================
diff --git a/deployment/ansible/playbooks/ensure-gitea-traefik-discovery.yml b/deployment/ansible/playbooks/ensure-gitea-traefik-discovery.yml
new file mode 100644
index 00000000..6bdeac2a
--- /dev/null
+++ b/deployment/ansible/playbooks/ensure-gitea-traefik-discovery.yml
@@ -0,0 +1,90 @@
+---
+# Ensure Gitea is Discovered by Traefik
+# This playbook ensures that Traefik properly discovers Gitea after restarts
+- name: Ensure Gitea is Discovered by Traefik
+  hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    traefik_stack_path: "{{ stacks_base_path }}/traefik"
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    max_wait_seconds: 60
+    check_interval: 5
+
+  tasks:
+    - name: Check if Gitea container is running
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose ps gitea | grep -q "Up" && echo "RUNNING" || echo "NOT_RUNNING"
+      register: gitea_status
+      changed_when: false
+
+    - name: Start Gitea if not running
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose up -d gitea
+      when: gitea_status.stdout == "NOT_RUNNING"
+      register: gitea_start
+
+    - name: Wait for Gitea to be ready
+      ansible.builtin.wait_for:
+        timeout: 30
+        delay: 2
+      when: gitea_start.changed | default(false) | bool
+
+    - name: Check if Traefik can see Gitea container
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose exec -T traefik sh -c 'wget -qO- http://localhost:8080/api/http/routers 2>&1 | python3 -m json.tool 2>&1 | grep -qi gitea && echo "FOUND" || echo "NOT_FOUND"'
+      register: traefik_gitea_check
+      changed_when: false
+      failed_when: false
+      retries: "{{ (max_wait_seconds | int) // (check_interval | int) }}"
+      delay: "{{ check_interval }}"
+      until: traefik_gitea_check.stdout == "FOUND"
+
+    - name: Restart Traefik if Gitea not found
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose restart traefik
+      when: traefik_gitea_check.stdout == "NOT_FOUND"
+      register: traefik_restart
+
+    - name: Wait for Traefik to be ready after restart
+      ansible.builtin.wait_for:
+        timeout: 30
+        delay: 2
+      when: traefik_restart.changed | default(false) | bool
+
+    - name: Verify Gitea is reachable via Traefik
+      ansible.builtin.uri:
+        url: "https://{{ gitea_domain }}/api/healthz"
+        method: GET
+        status_code: [200]
+        validate_certs: false
+        timeout: 10
+      register: gitea_health_check
+      retries: 5
+      delay: 2
+      until: gitea_health_check.status == 200
+      failed_when: false
+
+    - name: Display result
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA TRAEFIK DISCOVERY - RESULT
+          ================================================================================
+          
+          Gitea Status: {{ gitea_status.stdout }}
+          Traefik Discovery: {{ traefik_gitea_check.stdout }}
+          Gitea Health Check: {{ 'OK' if (gitea_health_check.status | default(0) == 200) else 'FAILED' }}
+          
+          {% if gitea_health_check.status | default(0) == 200 %}
+          ✅ Gitea is reachable via Traefik
+          {% else %}
+          ❌ Gitea is not reachable via Traefik
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/final-status-check.yml b/deployment/ansible/playbooks/final-status-check.yml
new file mode 100644
index 00000000..c0036470
--- /dev/null
+++ b/deployment/ansible/playbooks/final-status-check.yml
@@ -0,0 +1,79 @@
+---
+- name: Final Status Check - All Containers
+  hosts: production
+  gather_facts: no
+  become: no
+
+  vars:
+    application_stack_dest: "{{ app_stack_path | default(stacks_base_path + '/production') }}"
+    application_compose_suffix: "production.yml"
+
+  tasks:
+    - name: Wait for containers to fully start
+      pause:
+        seconds: 15
+
+    - name: Get all container status
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} ps
+      register: all_containers
+      changed_when: false
+
+    - name: Display all container status
+      debug:
+        msg: |
+          ========================================
+          Final Container Status
+          ========================================
+          {{ all_containers.stdout }}
+
+    - name: Check web container health
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} exec -T web curl -f http://localhost/health 2>&1 || echo "HEALTH_CHECK_FAILED"
+      register: web_health_check
+      changed_when: false
+      failed_when: false
+      ignore_errors: yes
+
+    - name: Display web health check
+      debug:
+        msg: |
+          Web Container Health Check:
+          {{ web_health_check.stdout }}
+
+    - name: Get web container logs (last 10 lines)
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs --tail=10 web 2>&1 | tail -10 || true
+      register: web_logs
+      changed_when: false
+
+    - name: Display web container logs
+      debug:
+        msg: |
+          Web Container Logs (last 10 lines):
+          {{ web_logs.stdout }}
+
+    - name: Get queue-worker logs (last 3 lines)
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs --tail=3 queue-worker 2>&1 | tail -3 || true
+      register: queue_worker_logs
+      changed_when: false
+
+    - name: Display queue-worker logs
+      debug:
+        msg: |
+          Queue-Worker (last 3 lines):
+          {{ queue_worker_logs.stdout }}
+
+    - name: Get scheduler logs (last 3 lines)
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs --tail=3 scheduler 2>&1 | tail -3 || true
+      register: scheduler_logs
+      changed_when: false
+
+    - name: Display scheduler logs
+      debug:
+        msg: |
+          Scheduler (last 3 lines):
+          {{ scheduler_logs.stdout }}
+
diff --git a/deployment/ansible/playbooks/find-ansible-automation-source.yml b/deployment/ansible/playbooks/find-ansible-automation-source.yml
new file mode 100644
index 00000000..764cae1b
--- /dev/null
+++ b/deployment/ansible/playbooks/find-ansible-automation-source.yml
@@ -0,0 +1,246 @@
+---
+# Find Ansible Automation Source
+# Findet die Quelle der externen Ansible-Automatisierung, die Traefik regelmäßig neu startet
+- name: Find Ansible Automation Source
+  hosts: production
+  gather_facts: yes
+  become: yes
+
+  tasks:
+    - name: Check for running Ansible processes
+      ansible.builtin.shell: |
+        ps aux | grep -E "ansible|ansible-playbook|ansible-pull" | grep -v grep || echo "No Ansible processes found"
+      register: ansible_processes
+      changed_when: false
+
+    - name: Check for ansible-pull processes
+      ansible.builtin.shell: |
+        ps aux | grep ansible-pull | grep -v grep || echo "No ansible-pull processes found"
+      register: ansible_pull_processes
+      changed_when: false
+
+    - name: Check systemd timers for ansible-pull
+      ansible.builtin.shell: |
+        systemctl list-timers --all --no-pager | grep -i ansible || echo "No ansible timers found"
+      register: ansible_timers
+      changed_when: false
+
+    - name: Check for ansible-pull cronjobs
+      ansible.builtin.shell: |
+        for user in $(cut -f1 -d: /etc/passwd); do
+          crontab -u "$user" -l 2>/dev/null | grep -q "ansible-pull\|ansible.*playbook" && echo "=== User: $user ===" && crontab -u "$user" -l 2>/dev/null | grep -E "ansible-pull|ansible.*playbook" || true
+        done || echo "No ansible-pull cronjobs found"
+      register: ansible_cronjobs
+      changed_when: false
+
+    - name: Check system-wide cron for ansible
+      ansible.builtin.shell: |
+        for dir in /etc/cron.d /etc/cron.daily /etc/cron.hourly /etc/cron.weekly /etc/cron.monthly; do
+          if [ -d "$dir" ]; then
+            grep -rE "ansible-pull|ansible.*playbook" "$dir" 2>/dev/null && echo "=== Found in $dir ===" || true
+          fi
+        done || echo "No ansible in system cron"
+      register: ansible_system_cron
+      changed_when: false
+
+    - name: Check journalctl for ansible-ansible processes
+      ansible.builtin.shell: |
+        journalctl --since "24 hours ago" --no-pager | grep -iE "ansible-ansible|ansible-playbook|ansible-pull" | tail -50 || echo "No ansible processes in journalctl"
+      register: ansible_journal
+      changed_when: false
+
+    - name: Check for ansible-pull configuration files
+      ansible.builtin.shell: |
+        find /home -name "*ansible-pull*" -o -name "*ansible*.yml" -path "*/ansible-pull/*" 2>/dev/null | head -20 || echo "No ansible-pull config files found"
+      register: ansible_pull_configs
+      changed_when: false
+
+    - name: Check for running docker compose commands related to Traefik
+      ansible.builtin.shell: |
+        ps aux | grep -E "docker.*compose.*traefik|docker.*restart.*traefik" | grep -v grep || echo "No docker compose traefik commands running"
+      register: docker_traefik_commands
+      changed_when: false
+
+    - name: Check Docker events for Traefik kill events (last hour)
+      ansible.builtin.shell: |
+        docker events --since 1h --until now --filter container=traefik --filter event=die --format "{{ '{{' }}.Time{{ '}}' }} {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.signal{{ '}}' }}" 2>/dev/null | tail -20 || echo "No Traefik die events in last hour"
+      register: traefik_kill_events
+      changed_when: false
+      failed_when: false
+
+    - name: Check journalctl for docker compose traefik commands
+      ansible.builtin.shell: |
+        journalctl --since "24 hours ago" --no-pager | grep -iE "docker.*compose.*traefik|docker.*restart.*traefik" | tail -30 || echo "No docker compose traefik commands in journalctl"
+      register: docker_traefik_journal
+      changed_when: false
+
+    - name: Check for CI/CD scripts that might run Ansible
+      ansible.builtin.shell: |
+        find /home/deploy -type f \( -name "*.sh" -o -name "*.yml" -o -name "*.yaml" \) -exec grep -lE "ansible.*playbook.*traefik|docker.*compose.*traefik.*restart" {} \; 2>/dev/null | head -20 || echo "No CI/CD scripts found"
+      register: cicd_scripts
+      changed_when: false
+
+    - name: Check for Gitea Workflows that run Ansible
+      ansible.builtin.shell: |
+        find /home/deploy -type f -path "*/.gitea/workflows/*.yml" -o -path "*/.github/workflows/*.yml" 2>/dev/null | xargs grep -lE "ansible.*playbook.*traefik|docker.*compose.*traefik" 2>/dev/null | head -10 || echo "No Gitea workflows found"
+      register: gitea_workflows
+      changed_when: false
+
+    - name: Check for monitoring/healthcheck scripts
+      ansible.builtin.shell: |
+        find /home/deploy -type f -name "*monitor*" -o -name "*health*" 2>/dev/null | xargs grep -lE "traefik.*restart|docker.*compose.*traefik" 2>/dev/null | head -10 || echo "No monitoring scripts found"
+      register: monitoring_scripts
+      changed_when: false
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ANSIBLE AUTOMATION SOURCE DIAGNOSE:
+          ================================================================================
+          
+          Laufende Ansible-Prozesse:
+          {{ ansible_processes.stdout }}
+          
+          Ansible-Pull Prozesse:
+          {{ ansible_pull_processes.stdout }}
+          
+          Systemd Timers für Ansible:
+          {{ ansible_timers.stdout }}
+          
+          Cronjobs für Ansible:
+          {{ ansible_cronjobs.stdout }}
+          
+          System-Cron für Ansible:
+          {{ ansible_system_cron.stdout }}
+          
+          Ansible-Prozesse in Journalctl (letzte 24h):
+          {{ ansible_journal.stdout }}
+          
+          Ansible-Pull Konfigurationsdateien:
+          {{ ansible_pull_configs.stdout }}
+          
+          Laufende Docker Compose Traefik-Befehle:
+          {{ docker_traefik_commands.stdout }}
+          
+          Traefik Kill-Events (letzte Stunde):
+          {{ traefik_kill_events.stdout }}
+          
+          Docker Compose Traefik-Befehle in Journalctl:
+          {{ docker_traefik_journal.stdout }}
+          
+          CI/CD Scripts die Traefik restarten:
+          {{ cicd_scripts.stdout }}
+          
+          Gitea Workflows die Traefik restarten:
+          {{ gitea_workflows.stdout }}
+          
+          Monitoring-Scripts die Traefik restarten:
+          {{ monitoring_scripts.stdout }}
+          
+          ================================================================================
+          ANALYSE:
+          ================================================================================
+          
+          {% if 'No Ansible processes found' not in ansible_processes.stdout %}
+          ⚠️  AKTIVE ANSIBLE-PROZESSE GEFUNDEN:
+          {{ ansible_processes.stdout }}
+          
+          → Diese Prozesse könnten Traefik regelmäßig neu starten
+          → Prüfe die Kommandozeile dieser Prozesse um das Playbook zu identifizieren
+          {% endif %}
+          
+          {% if 'No ansible-pull processes found' not in ansible_pull_processes.stdout %}
+          ❌ ANSIBLE-PULL LÄUFT:
+          {{ ansible_pull_processes.stdout }}
+          
+          → ansible-pull führt regelmäßig Playbooks aus
+          → Dies ist wahrscheinlich die Quelle der Traefik-Restarts
+          {% endif %}
+          
+          {% if 'No ansible timers found' not in ansible_timers.stdout %}
+          ❌ ANSIBLE TIMER GEFUNDEN:
+          {{ ansible_timers.stdout }}
+          
+          → Ein Systemd-Timer führt regelmäßig Ansible aus
+          → Deaktiviere mit: systemctl disable <timer-name>
+          {% endif %}
+          
+          {% if 'No ansible-pull cronjobs found' not in ansible_cronjobs.stdout %}
+          ❌ ANSIBLE CRONJOB GEFUNDEN:
+          {{ ansible_cronjobs.stdout }}
+          
+          → Ein Cronjob führt regelmäßig Ansible aus
+          → Entferne oder kommentiere den Cronjob-Eintrag
+          {% endif %}
+          
+          {% if cicd_scripts.stdout and 'No CI/CD scripts found' not in cicd_scripts.stdout %}
+          ⚠️  CI/CD SCRIPTS GEFUNDEN:
+          {{ cicd_scripts.stdout }}
+          
+          → Diese Scripts könnten Traefik regelmäßig neu starten
+          → Prüfe diese Dateien und entferne/kommentiere Traefik-Restart-Befehle
+          {% endif %}
+          
+          {% if gitea_workflows.stdout and 'No Gitea workflows found' not in gitea_workflows.stdout %}
+          ⚠️  GITEA WORKFLOWS GEFUNDEN:
+          {{ gitea_workflows.stdout }}
+          
+          → Diese Workflows könnten Traefik regelmäßig neu starten
+          → Prüfe diese Workflows und entferne/kommentiere Traefik-Restart-Schritte
+          {% endif %}
+          
+          {% if monitoring_scripts.stdout and 'No monitoring scripts found' not in monitoring_scripts.stdout %}
+          ⚠️  MONITORING SCRIPTS GEFUNDEN:
+          {{ monitoring_scripts.stdout }}
+          
+          → Diese Scripts könnten Traefik regelmäßig neu starten
+          → Prüfe diese Scripts und entferne/kommentiere Traefik-Restart-Befehle
+          {% endif %}
+          
+          ================================================================================
+          LÖSUNG:
+          ================================================================================
+          
+          {% if 'No Ansible processes found' in ansible_processes.stdout and 'No ansible-pull processes found' in ansible_pull_processes.stdout and 'No ansible timers found' in ansible_timers.stdout and 'No ansible-pull cronjobs found' in ansible_cronjobs.stdout %}
+          ℹ️  Keine aktiven Ansible-Automatisierungen gefunden
+          
+          Mögliche Ursachen:
+          1. Ansible-Prozesse laufen nur zeitweise (intermittierend)
+          2. Externe CI/CD-Pipeline führt Ansible aus
+          3. Manuelle Ansible-Aufrufe von außen
+          
+          Nächste Schritte:
+          1. Beobachte Docker Events in Echtzeit: docker events --filter container=traefik
+          2. Beobachte Ansible-Prozesse: watch -n 1 'ps aux | grep ansible'
+          3. Prüfe ob externe CI/CD-Pipelines Ansible ausführen
+          {% else %}
+          
+          SOFORTMASSNAHME:
+          
+          {% if 'No ansible-pull processes found' not in ansible_pull_processes.stdout %}
+          1. ❌ Stoppe ansible-pull:
+             pkill -f ansible-pull
+          {% endif %}
+          
+          {% if 'No ansible timers found' not in ansible_timers.stdout %}
+          2. ❌ Deaktiviere Ansible-Timer:
+             systemctl stop <timer-name>
+             systemctl disable <timer-name>
+          {% endif %}
+          
+          {% if 'No ansible-pull cronjobs found' not in ansible_cronjobs.stdout %}
+          3. ❌ Entferne Ansible-Cronjobs:
+             crontab -u <user> -e
+             (Kommentiere oder entferne die Ansible-Zeilen)
+          {% endif %}
+          
+          LANGZEITLÖSUNG:
+          
+          1. Prüfe gefundene Scripts/Workflows und entferne Traefik-Restart-Befehle
+          2. Falls Healthchecks nötig sind, setze größere Intervalle (z.B. 5 Minuten statt 30 Sekunden)
+          3. Restarte Traefik nur bei echten Fehlern, nicht präventiv
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/find-traefik-restart-source.yml b/deployment/ansible/playbooks/find-traefik-restart-source.yml
new file mode 100644
index 00000000..f008f8e2
--- /dev/null
+++ b/deployment/ansible/playbooks/find-traefik-restart-source.yml
@@ -0,0 +1,328 @@
+---
+# Find Source of Traefik Restarts
+# Umfassende Diagnose um die Quelle der regelmäßigen Traefik-Restarts zu finden
+- name: Find Source of Traefik Restarts
+  hosts: production
+  gather_facts: yes
+  become: yes
+  vars:
+    traefik_stack_path: "{{ stacks_base_path }}/traefik"
+    monitor_duration_seconds: 120  # 2 Minuten Monitoring (kann erhöht werden)
+
+  tasks:
+    - name: Check Traefik container restart count
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "0"
+      register: traefik_restart_count
+      changed_when: false
+
+    - name: Check Traefik container start time
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.State.StartedAt{{ '}}' }}' 2>/dev/null || echo "UNKNOWN"
+      register: traefik_started_at
+      changed_when: false
+
+    - name: Analyze Traefik logs for "Stopping server gracefully" messages
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose logs traefik 2>&1 | grep -i "stopping server gracefully\|I have to go" | tail -20
+      register: traefik_stop_messages
+      changed_when: false
+      failed_when: false
+
+    - name: Extract timestamps from stop messages
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose logs traefik 2>&1 | grep -i "stopping server gracefully\|I have to go" | tail -20 | grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}' | sort | uniq
+      register: stop_timestamps
+      changed_when: false
+      failed_when: false
+
+    - name: Check Docker daemon logs for Traefik stop events
+      ansible.builtin.shell: |
+        journalctl -u docker.service --since "24 hours ago" --no-pager | grep -iE "traefik.*stop|traefik.*kill|traefik.*die|container.*traefik.*stopped" | tail -30 || echo "No Traefik stop events in Docker daemon logs"
+      register: docker_daemon_logs
+      changed_when: false
+      failed_when: false
+
+    - name: Check Docker events for Traefik (last 24 hours)
+      ansible.builtin.shell: |
+        docker events --since 24h --until now --filter container=traefik --filter event=die --format "{{ '{{' }}.Time{{ '}}' }} {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.name{{ '}}' }}" 2>/dev/null | tail -20 || echo "No Traefik die events found"
+      register: docker_events_traefik
+      changed_when: false
+      failed_when: false
+
+    - name: Check all user crontabs for Traefik/Docker commands
+      ansible.builtin.shell: |
+        for user in $(cut -f1 -d: /etc/passwd); do
+          crontab -u "$user" -l 2>/dev/null | grep -qE "traefik|docker.*compose.*traefik|docker.*stop.*traefik|docker.*restart.*traefik|docker.*down.*traefik" && echo "=== User: $user ===" && crontab -u "$user" -l 2>/dev/null | grep -E "traefik|docker.*compose.*traefik|docker.*stop.*traefik|docker.*restart.*traefik|docker.*down.*traefik" || true
+        done || echo "No user crontabs with Traefik commands found"
+      register: all_user_crontabs
+      changed_when: false
+
+    - name: Check system-wide cron directories
+      ansible.builtin.shell: |
+        for dir in /etc/cron.d /etc/cron.daily /etc/cron.hourly /etc/cron.weekly /etc/cron.monthly; do
+          if [ -d "$dir" ]; then
+            echo "=== $dir ==="
+            grep -rE "traefik|docker.*compose.*traefik|docker.*stop.*traefik|docker.*restart.*traefik|docker.*down.*traefik" "$dir" 2>/dev/null || echo "No matches"
+          fi
+        done
+      register: system_cron_dirs
+      changed_when: false
+
+    - name: Check systemd timers and services
+      ansible.builtin.shell: |
+        echo "=== Active Timers ==="
+        systemctl list-timers --all --no-pager | grep -E "traefik|docker.*compose" || echo "No Traefik-related timers"
+        echo ""
+        echo "=== Custom Services ==="
+        systemctl list-units --type=service --all | grep -E "traefik|docker.*compose" || echo "No Traefik-related services"
+      register: systemd_services
+      changed_when: false
+
+    - name: Check for scripts in deployment directory that restart Traefik
+      ansible.builtin.shell: |
+        find /home/deploy/deployment -type f \( -name "*.sh" -o -name "*.yml" -o -name "*.yaml" \) -exec grep -lE "traefik.*restart|docker.*compose.*traefik.*restart|docker.*compose.*traefik.*down|docker.*compose.*traefik.*stop" {} \; 2>/dev/null | head -30
+      register: deployment_scripts
+      changed_when: false
+
+    - name: Check Ansible roles for traefik_auto_restart or restart tasks
+      ansible.builtin.shell: |
+        grep -rE "traefik_auto_restart|traefik.*restart|docker.*compose.*traefik.*restart" /home/deploy/deployment/ansible/roles/ 2>/dev/null | grep -v ".git" | head -20 || echo "No auto-restart settings found"
+      register: ansible_auto_restart
+      changed_when: false
+
+    - name: Check Docker Compose watch mode
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose ps traefik 2>/dev/null | grep -q "traefik" && echo "running" || echo "not_running"
+      register: docker_compose_watch
+      changed_when: false
+      failed_when: false
+
+    - name: Check if Docker Compose is running in watch mode
+      ansible.builtin.shell: |
+        ps aux | grep -E "docker.*compose.*watch|docker.*compose.*--watch" | grep -v grep || echo "No Docker Compose watch mode detected"
+      register: watch_mode_process
+      changed_when: false
+
+    - name: Check for monitoring/watchdog scripts
+      ansible.builtin.shell: |
+        find /home/deploy -type f -name "*monitor*" -o -name "*watchdog*" -o -name "*health*" 2>/dev/null | xargs grep -lE "traefik|docker.*compose.*traefik" 2>/dev/null | head -10 || echo "No monitoring scripts found"
+      register: monitoring_scripts
+      changed_when: false
+
+    - name: Check Gitea Workflows for Traefik restarts
+      ansible.builtin.shell: |
+        find /home/deploy -type f -path "*/.gitea/workflows/*.yml" -o -path "*/.github/workflows/*.yml" 2>/dev/null | xargs grep -lE "traefik.*restart|docker.*compose.*traefik.*restart" 2>/dev/null | head -10 || echo "No Gitea workflows found that restart Traefik"
+      register: gitea_workflows
+      changed_when: false
+
+    - name: Monitor Docker events in real-time (5 minutes)
+      ansible.builtin.shell: |
+        timeout {{ monitor_duration_seconds }} docker events --filter container=traefik --format "{{ '{{' }}.Time{{ '}}' }} {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.name{{ '}}' }}" 2>&1 || echo "Monitoring completed or timeout"
+      register: docker_events_realtime
+      changed_when: false
+      failed_when: false
+      async: "{{ monitor_duration_seconds + 10 }}"
+      poll: 0
+
+    - name: Wait for monitoring to complete
+      ansible.builtin.async_status:
+        jid: "{{ docker_events_realtime.ansible_job_id }}"
+      register: monitoring_result
+      until: monitoring_result.finished
+      retries: "{{ (monitor_duration_seconds / 10) | int + 5 }}"
+      delay: 10
+      failed_when: false
+
+    - name: Check system reboot history
+      ansible.builtin.shell: |
+        last reboot --since "24 hours ago" 2>/dev/null | head -10 || echo "No reboots in last 24 hours"
+      register: reboot_history
+      changed_when: false
+      failed_when: false
+
+    - name: Check for at jobs
+      ansible.builtin.shell: |
+        atq 2>/dev/null | while read line; do
+          job_id=$(echo "$line" | awk '{print $1}')
+          at -c "$job_id" 2>/dev/null | grep -qE "traefik|docker.*compose.*traefik" && echo "=== Job ID: $job_id ===" && at -c "$job_id" 2>/dev/null | grep -E "traefik|docker.*compose.*traefik" || true
+        done || echo "No at jobs found or atq not available"
+      register: at_jobs
+      changed_when: false
+
+    - name: Check Docker daemon configuration for auto-restart
+      ansible.builtin.shell: |
+        cat /etc/docker/daemon.json 2>/dev/null | grep -iE "restart|live-restore" || echo "No restart settings in daemon.json"
+      register: docker_daemon_config
+      changed_when: false
+      failed_when: false
+
+    - name: Check if Traefik has restart policy
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose config | grep -A 5 "traefik:" | grep -E "restart|restart_policy" || echo "No explicit restart policy found"
+      register: traefik_restart_policy
+      changed_when: false
+      failed_when: false
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          TRAEFIK RESTART SOURCE DIAGNOSE - ZUSAMMENFASSUNG:
+          ================================================================================
+          
+          Traefik Status:
+          - Restart Count: {{ traefik_restart_count.stdout }}
+          - Started At: {{ traefik_started_at.stdout }}
+          - Stop Messages gefunden: {{ traefik_stop_messages.stdout_lines | length }} (letzte 20)
+          
+          Stop-Zeitstempel (letzte 20):
+          {% if stop_timestamps.stdout %}
+          {{ stop_timestamps.stdout }}
+          {% else %}
+          Keine Stop-Zeitstempel gefunden
+          {% endif %}
+          
+          Docker Events (letzte 24h):
+          {% if docker_events_traefik.stdout and 'No Traefik die events' not in docker_events_traefik.stdout %}
+          {{ docker_events_traefik.stdout }}
+          {% else %}
+          Keine Traefik die-Events in den letzten 24 Stunden
+          {% endif %}
+          
+          Docker Daemon Logs:
+          {% if docker_daemon_logs.stdout and 'No Traefik stop events' not in docker_daemon_logs.stdout %}
+          {{ docker_daemon_logs.stdout }}
+          {% else %}
+          Keine Traefik-Stop-Events in Docker-Daemon-Logs
+          {% endif %}
+          
+          Gefundene Quellen:
+          {% if all_user_crontabs.stdout and 'No user crontabs' not in all_user_crontabs.stdout %}
+          1. ❌ CRONJOBS (User):
+          {{ all_user_crontabs.stdout }}
+          {% endif %}
+          
+          {% if system_cron_dirs.stdout and 'No matches' not in system_cron_dirs.stdout %}
+          2. ❌ SYSTEM CRON:
+          {{ system_cron_dirs.stdout }}
+          {% endif %}
+          
+          {% if systemd_services.stdout and 'No Traefik-related' not in systemd_services.stdout %}
+          3. ❌ SYSTEMD TIMERS/SERVICES:
+          {{ systemd_services.stdout }}
+          {% endif %}
+          
+          {% if deployment_scripts.stdout and 'No' not in deployment_scripts.stdout %}
+          4. ⚠️  DEPLOYMENT SCRIPTS:
+          {{ deployment_scripts.stdout }}
+          {% endif %}
+          
+          {% if ansible_auto_restart.stdout and 'No auto-restart' not in ansible_auto_restart.stdout %}
+          5. ⚠️  ANSIBLE AUTO-RESTART:
+          {{ ansible_auto_restart.stdout }}
+          {% endif %}
+          
+          {% if gitea_workflows.stdout and 'No Gitea workflows' not in gitea_workflows.stdout %}
+          6. ⚠️  GITEA WORKFLOWS:
+          {{ gitea_workflows.stdout }}
+          {% endif %}
+          
+          {% if monitoring_scripts.stdout and 'No monitoring scripts' not in monitoring_scripts.stdout %}
+          7. ⚠️  MONITORING SCRIPTS:
+          {{ monitoring_scripts.stdout }}
+          {% endif %}
+          
+          {% if at_jobs.stdout and 'No at jobs' not in at_jobs.stdout %}
+          8. ❌ AT JOBS:
+          {{ at_jobs.stdout }}
+          {% endif %}
+          
+          {% if docker_compose_watch.stdout and 'Could not check' not in docker_compose_watch.stdout %}
+          9. ⚠️  DOCKER COMPOSE WATCH:
+          {{ docker_compose_watch.stdout }}
+          {% endif %}
+          
+          {% if watch_mode_process.stdout and 'No Docker Compose watch' not in watch_mode_process.stdout %}
+          10. ❌ DOCKER COMPOSE WATCH MODE (PROZESS):
+          {{ watch_mode_process.stdout }}
+          {% endif %}
+          
+          {% if reboot_history.stdout and 'No reboots' not in reboot_history.stdout %}
+          11. ⚠️  SYSTEM REBOOTS:
+          {{ reboot_history.stdout }}
+          {% endif %}
+          
+          Real-Time Monitoring ({{ monitor_duration_seconds }} Sekunden):
+          {% if monitoring_result.finished and monitoring_result.ansible_job_id %}
+          {{ monitoring_result.stdout | default('Keine Events während Monitoring') }}
+          {% else %}
+          Monitoring läuft noch oder wurde unterbrochen
+          {% endif %}
+          
+          ================================================================================
+          NÄCHSTE SCHRITTE:
+          ================================================================================
+          
+          {% if all_user_crontabs.stdout and 'No user crontabs' not in all_user_crontabs.stdout %}
+          1. ❌ CRONJOBS DEAKTIVIEREN:
+             - Prüfe gefundene Cronjobs: {{ all_user_crontabs.stdout }}
+             - Entferne oder kommentiere die entsprechenden Einträge
+          {% endif %}
+          
+          {% if system_cron_dirs.stdout and 'No matches' not in system_cron_dirs.stdout %}
+          2. ❌ SYSTEM CRON DEAKTIVIEREN:
+             - Prüfe gefundene System-Cronjobs: {{ system_cron_dirs.stdout }}
+             - Entferne oder benenne die Dateien um
+          {% endif %}
+          
+          {% if systemd_services.stdout and 'No Traefik-related' not in systemd_services.stdout %}
+          3. ❌ SYSTEMD TIMERS/SERVICES DEAKTIVIEREN:
+             - Prüfe gefundene Services/Timers: {{ systemd_services.stdout }}
+             - Deaktiviere mit: systemctl disable <service>
+          {% endif %}
+          
+          {% if deployment_scripts.stdout and 'No' not in deployment_scripts.stdout %}
+          4. ⚠️  DEPLOYMENT SCRIPTS PRÜFEN:
+             - Prüfe gefundene Scripts: {{ deployment_scripts.stdout }}
+             - Entferne oder kommentiere Traefik-Restart-Befehle
+          {% endif %}
+          
+          {% if ansible_auto_restart.stdout and 'No auto-restart' not in ansible_auto_restart.stdout %}
+          5. ⚠️  ANSIBLE AUTO-RESTART PRÜFEN:
+             - Prüfe gefundene Einstellungen: {{ ansible_auto_restart.stdout }}
+             - Setze traefik_auto_restart: false in group_vars
+          {% endif %}
+          
+          {% if not all_user_crontabs.stdout or 'No user crontabs' in all_user_crontabs.stdout %}
+          {% if not system_cron_dirs.stdout or 'No matches' in system_cron_dirs.stdout %}
+          {% if not systemd_services.stdout or 'No Traefik-related' in systemd_services.stdout %}
+          {% if not deployment_scripts.stdout or 'No' in deployment_scripts.stdout %}
+          {% if not ansible_auto_restart.stdout or 'No auto-restart' in ansible_auto_restart.stdout %}
+          
+          ⚠️  KEINE AUTOMATISCHEN RESTART-MECHANISMEN GEFUNDEN!
+          
+          Mögliche Ursachen:
+          1. Externer Prozess (nicht über Cron/Systemd)
+          2. Docker-Service-Restarts (systemctl restart docker)
+          3. Host-Reboots
+          4. Manuelle Restarts (von außen)
+          5. Monitoring-Service (Portainer, Watchtower, etc.)
+          
+          Nächste Schritte:
+          1. Führe 'docker events --filter container=traefik' manuell aus und beobachte
+          2. Prüfe journalctl -u docker.service für Docker-Service-Restarts
+          3. Prüfe ob Portainer oder andere Monitoring-Tools laufen
+          4. Prüfe ob Watchtower oder andere Auto-Update-Tools installiert sind
+          {% endif %}
+          {% endif %}
+          {% endif %}
+          {% endif %}
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/fix-container-issues.yml b/deployment/ansible/playbooks/fix-container-issues.yml
new file mode 100644
index 00000000..06526f46
--- /dev/null
+++ b/deployment/ansible/playbooks/fix-container-issues.yml
@@ -0,0 +1,17 @@
+---
+# Fix Container Issues (Composer Dependencies and Permissions)
+# Wrapper Playbook for application role containers tasks (fix action)
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_container_action: fix
+  tasks:
+    - name: Include application containers tasks (fix)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: containers
+  tags:
+    - application
+    - containers
+    - fix
diff --git a/deployment/ansible/playbooks/fix-gitea-actions-config.yml b/deployment/ansible/playbooks/fix-gitea-actions-config.yml
deleted file mode 100644
index 3f74a471..00000000
--- a/deployment/ansible/playbooks/fix-gitea-actions-config.yml
+++ /dev/null
@@ -1,81 +0,0 @@
----
-- name: Fix Gitea Actions Configuration (non-destructive)
-  hosts: production
-  become: no
-  gather_facts: yes
-
-  tasks:
-    - name: Check current Gitea Actions configuration
-      shell: |
-        docker exec gitea cat /data/gitea/conf/app.ini 2>/dev/null | grep -A 5 "\[actions\]" || echo "No actions section found"
-      register: current_config
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Backup existing app.ini
-      shell: |
-        docker exec gitea cp /data/gitea/conf/app.ini /data/gitea/conf/app.ini.backup.$(date +%Y%m%d_%H%M%S)
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Copy app.ini from container for editing
-      shell: |
-        docker cp gitea:/data/gitea/conf/app.ini /tmp/gitea_app_ini_$$
-      register: copy_result
-
-    - name: Update app.ini Actions section
-      shell: |
-        # Remove DEFAULT_ACTIONS_URL line if it exists in [actions] section
-        sed -i '/^\[actions\]/,/^\[/{ /^DEFAULT_ACTIONS_URL/d; }' /tmp/gitea_app_ini_$$
-        
-        # Ensure ENABLED = true in [actions] section
-        if grep -q "^\[actions\]" /tmp/gitea_app_ini_$$; then
-          # Section exists - ensure ENABLED = true
-          sed -i '/^\[actions\]/,/^\[/{ s/^ENABLED.*/ENABLED = true/; }' /tmp/gitea_app_ini_$$
-          # If ENABLED line doesn't exist, add it
-          if ! grep -A 10 "^\[actions\]" /tmp/gitea_app_ini_$$ | grep -q "^ENABLED"; then
-            sed -i '/^\[actions\]/a ENABLED = true' /tmp/gitea_app_ini_$$
-          fi
-        else
-          # Section doesn't exist - add it
-          echo "" >> /tmp/gitea_app_ini_$$
-          echo "[actions]" >> /tmp/gitea_app_ini_$$
-          echo "ENABLED = true" >> /tmp/gitea_app_ini_$$
-        fi
-      args:
-        executable: /bin/bash
-      register: config_updated
-
-    - name: Copy updated app.ini back to container
-      shell: |
-        docker cp /tmp/gitea_app_ini_$$ gitea:/data/gitea/conf/app.ini
-        rm -f /tmp/gitea_app_ini_$$
-      when: config_updated.changed | default(false)
-
-    - name: Verify Actions configuration after update
-      shell: |
-        docker exec gitea cat /data/gitea/conf/app.ini | grep -A 5 "\[actions\]"
-      register: updated_config
-      changed_when: false
-
-    - name: Restart Gitea to apply configuration
-      shell: |
-        cd {{ stacks_base_path }}/gitea
-        docker compose restart gitea
-      when: config_updated.changed | default(false)
-
-    - name: Wait for Gitea to be ready
-      wait_for:
-        timeout: 60
-      when: config_updated.changed | default(false)
-
-    - name: Display configuration result
-      debug:
-        msg:
-          - "=== Gitea Actions Configuration Fixed ==="
-          - ""
-          - "Current [actions] configuration:"
-          - "{{ updated_config.stdout }}"
-          - ""
-          - "Configuration updated: {{ 'Yes' if config_updated.changed else 'No changes needed' }}"
-          - "Gitea restarted: {{ 'Yes' if config_updated.changed else 'No' }}"
diff --git a/deployment/ansible/playbooks/fix-gitea-actions-url.yml b/deployment/ansible/playbooks/fix-gitea-actions-url.yml
deleted file mode 100644
index c66387cd..00000000
--- a/deployment/ansible/playbooks/fix-gitea-actions-url.yml
+++ /dev/null
@@ -1,49 +0,0 @@
----
-- name: Remove DEFAULT_ACTIONS_URL from Gitea configuration
-  hosts: production
-  become: no
-  gather_facts: yes
-
-  tasks:
-    - name: Check if DEFAULT_ACTIONS_URL exists in app.ini
-      shell: |
-        docker exec gitea cat /data/gitea/conf/app.ini 2>/dev/null | grep -q "DEFAULT_ACTIONS_URL" && echo "exists" || echo "not_found"
-      register: url_check
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Remove DEFAULT_ACTIONS_URL from app.ini
-      shell: |
-        docker exec gitea sh -c 'sed -i "/^DEFAULT_ACTIONS_URL/d" /data/gitea/conf/app.ini'
-      when: url_check.stdout == "exists"
-      register: url_removed
-
-    - name: Restart Gitea to apply configuration changes
-      shell: |
-        cd {{ stacks_base_path }}/gitea
-        docker compose restart gitea
-      when: url_removed.changed | default(false)
-
-    - name: Wait for Gitea to be ready
-      wait_for:
-        timeout: 60
-      when: url_removed.changed | default(false)
-
-    - name: Verify Gitea Actions configuration
-      shell: |
-        docker exec gitea cat /data/gitea/conf/app.ini 2>/dev/null | grep -A 3 "\[actions\]" || echo "Config not accessible"
-      register: gitea_config
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Display Gitea Actions configuration
-      debug:
-        msg:
-          - "=== Gitea Configuration Fix Complete ==="
-          - "DEFAULT_ACTIONS_URL removed: {{ 'Yes' if url_removed.changed else 'No (not found or already removed)' }}"
-          - "Container restarted: {{ 'Yes' if url_removed.changed else 'No' }}"
-          - ""
-          - "Current Actions configuration:"
-          - "{{ gitea_config.stdout if gitea_config.stdout else 'Could not read config' }}"
-          - ""
-          - "Gitea will now use its own instance for actions by default (no GitHub fallback)."
diff --git a/deployment/ansible/playbooks/fix-gitea-runner-config.yml b/deployment/ansible/playbooks/fix-gitea-runner-config.yml
index 1058786d..e7d6b1fe 100644
--- a/deployment/ansible/playbooks/fix-gitea-runner-config.yml
+++ b/deployment/ansible/playbooks/fix-gitea-runner-config.yml
@@ -1,200 +1,17 @@
 ---
-- name: Fix Gitea Runner Configuration
-  hosts: production
+# Fix Gitea Runner Configuration
+# Wrapper Playbook for gitea role runner tasks (fix action)
+- hosts: production
   gather_facts: yes
   become: no
-
   vars:
-    gitea_runner_path: "{{ runner_path | default('/home/deploy/deployment/gitea-runner') }}"
-    gitea_instance_url: "https://git.michaelschiemer.de"
-    runner_container_name: "gitea-runner"
-
+    gitea_runner_action: fix
   tasks:
-    - name: Check if Gitea runner directory exists
-      stat:
-        path: "{{ gitea_runner_path }}"
-      register: runner_dir_exists
-
-    - name: Fail if runner directory does not exist
-      fail:
-        msg: "Gitea runner directory not found at {{ gitea_runner_path }}"
-      when: not runner_dir_exists.stat.exists
-
-    - name: Check if runner container is running
-      shell: |
-        docker ps --format json | jq -r 'select(.Names == "{{ runner_container_name }}") | .State'
-      register: runner_container_state
-      changed_when: false
-      failed_when: false
-
-    - name: Display runner container status
-      debug:
-        msg: |
-          Runner Container Status: {{ runner_container_state.stdout | default('NOT RUNNING') }}
-
-    - name: Check if .runner file exists
-      stat:
-        path: "{{ gitea_runner_path }}/data/.runner"
-      register: runner_file_exists
-
-    - name: Read .runner file content (if exists)
-      slurp:
-        src: "{{ gitea_runner_path }}/data/.runner"
-      register: runner_file_content
-      when: runner_file_exists.stat.exists
-      changed_when: false
-
-    - name: Display .runner file content
-      debug:
-        msg: |
-          Runner Registration File Content:
-          {{ runner_file_content.content | b64decode | default('File not found') }}
-      when: runner_file_exists.stat.exists
-
-    - name: Check for GitHub URLs in .runner file
-      shell: |
-        grep -i "github.com" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "NO_GITHUB_URLS"
-      register: github_urls_check
-      when: runner_file_exists.stat.exists
-      changed_when: false
-      failed_when: false
-
-    - name: Display GitHub URLs check result
-      debug:
-        msg: |
-          GitHub URLs in .runner file: {{ github_urls_check.stdout }}
-
-    - name: Check runner logs for incorrect URLs
-      shell: |
-        docker logs {{ runner_container_name }} --tail=100 2>&1 | grep -E "(github.com|instance|repo)" || echo "NO_MATCHES"
-      register: runner_logs_check
-      changed_when: false
-      failed_when: false
-
-    - name: Display runner logs analysis
-      debug:
-        msg: |
-          Runner Logs Analysis (last 100 lines):
-          {{ runner_logs_check.stdout }}
-
-    - name: Check .env file for GITEA_INSTANCE_URL
-      shell: |
-        grep "^GITEA_INSTANCE_URL=" "{{ gitea_runner_path }}/.env" 2>/dev/null || echo "NOT_FOUND"
-      register: env_instance_url
-      changed_when: false
-      failed_when: false
-
-    - name: Display GITEA_INSTANCE_URL from .env
-      debug:
-        msg: |
-          GITEA_INSTANCE_URL in .env: {{ env_instance_url.stdout }}
-
-    - name: Check if .env has correct Gitea URL
-      set_fact:
-        env_has_correct_url: "{{ env_instance_url.stdout is defined and gitea_instance_url in env_instance_url.stdout }}"
-
-    - name: Check if runner needs re-registration
-      set_fact:
-        runner_needs_reregistration: >-
-          {%- if not runner_file_exists.stat.exists -%}
-            true
-          {%- elif 'github.com' in (github_urls_check.stdout | default('')) -%}
-            true
-          {%- elif not env_has_correct_url -%}
-            true
-          {%- else -%}
-            false
-          {%- endif -%}
-
-    - name: Display re-registration decision
-      debug:
-        msg: |
-          Runner Re-registration Needed: {{ runner_needs_reregistration | bool }}
-          
-          Reasons:
-          - Runner file exists: {{ runner_file_exists.stat.exists }}
-          - Contains GitHub URLs: {{ 'github.com' in (github_urls_check.stdout | default('')) }}
-          - .env has correct URL: {{ env_has_correct_url | bool }}
-
-    - name: Stop runner container before re-registration
-      shell: |
-        cd {{ gitea_runner_path }}
-        docker compose stop {{ runner_container_name }}
-      when: runner_needs_reregistration | bool
-      register: stop_runner
-      changed_when: stop_runner.rc == 0
-
-    - name: Backup existing .runner file
-      copy:
-        src: "{{ gitea_runner_path }}/data/.runner"
-        dest: "{{ gitea_runner_path }}/data/.runner.backup.{{ ansible_date_time.epoch }}"
-        remote_src: yes
-      when: 
-        - runner_file_exists.stat.exists
-        - runner_needs_reregistration | bool
-
-    - name: Remove existing .runner file
-      file:
-        path: "{{ gitea_runner_path }}/data/.runner"
-        state: absent
-      when: runner_needs_reregistration | bool
-
-    - name: Update .env file with correct GITEA_INSTANCE_URL
-      lineinfile:
-        path: "{{ gitea_runner_path }}/.env"
-        regexp: '^GITEA_INSTANCE_URL='
-        line: "GITEA_INSTANCE_URL={{ gitea_instance_url }}"
-        create: yes
-      when: runner_needs_reregistration | bool
-      register: env_updated
-
-    - name: Display instructions for manual re-registration
-      debug:
-        msg: |
-          ========================================
-          Runner Re-registration Required
-          ========================================
-          
-          The runner needs to be re-registered with the correct Gitea instance URL.
-          
-          Steps to re-register:
-          
-          1. Get a new registration token from Gitea:
-             {{ gitea_instance_url }}/admin/actions/runners
-             Click "Create New Runner" and copy the token
-          
-          2. Update .env file with the token:
-             GITEA_RUNNER_REGISTRATION_TOKEN=<your-token>
-          
-          3. Re-register the runner:
-             cd {{ gitea_runner_path }}
-             ./register.sh
-          
-          Or use Ansible to set the token and register:
-          ansible-playbook -i inventory/production.yml \
-            playbooks/register-gitea-runner.yml \
-            -e "runner_registration_token=<your-token>"
-          
-          ========================================
-      when: runner_needs_reregistration | bool
-
-    - name: Display final status
-      debug:
-        msg: |
-          ========================================
-          Gitea Runner Configuration Status
-          ========================================
-          Runner Directory: {{ gitea_runner_path }}
-          Container Running: {{ 'YES' if runner_container_state.stdout == 'running' else 'NO' }}
-          Runner File Exists: {{ 'YES' if runner_file_exists.stat.exists else 'NO' }}
-          Contains GitHub URLs: {{ 'YES' if 'github.com' in (github_urls_check.stdout | default('')) else 'NO' }}
-          .env has correct URL: {{ 'YES' if env_has_correct_url else 'NO' }}
-          Re-registration Needed: {{ 'YES' if runner_needs_reregistration | bool else 'NO' }}
-          ========================================
-          
-          {% if not runner_needs_reregistration | bool %}
-          ✅ Runner configuration looks correct!
-          {% else %}
-          ⚠️  Runner needs to be re-registered with correct Gitea URL
-          {% endif %}
-
+    - name: Include gitea runner tasks (fix)
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: runner
+  tags:
+    - gitea
+    - runner
+    - fix
diff --git a/deployment/ansible/playbooks/fix-gitea-traefik-dynamic-config.yml b/deployment/ansible/playbooks/fix-gitea-traefik-dynamic-config.yml
deleted file mode 100644
index 2248bc9b..00000000
--- a/deployment/ansible/playbooks/fix-gitea-traefik-dynamic-config.yml
+++ /dev/null
@@ -1,143 +0,0 @@
----
-- name: Fix Gitea Traefik Configuration - Remove Dynamic Config and Use Labels
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    traefik_stack_path: "{{ stacks_base_path }}/traefik"
-    gitea_stack_path: "{{ stacks_base_path }}/gitea"
-
-  tasks:
-    - name: Backup dynamic Gitea configuration
-      shell: |
-        cd {{ traefik_stack_path }}/dynamic
-        if [ -f gitea.yml ]; then
-          cp gitea.yml gitea.yml.backup-$(date +%Y%m%d-%H%M%S)
-          echo "Backed up to gitea.yml.backup-$(date +%Y%m%d-%H%M%S)"
-        else
-          echo "File not found, nothing to backup"
-        fi
-      args:
-        executable: /bin/bash
-      register: backup_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display backup result
-      debug:
-        msg: "{{ backup_result.stdout_lines }}"
-
-    - name: Remove dynamic Gitea configuration
-      file:
-        path: "{{ traefik_stack_path }}/dynamic/gitea.yml"
-        state: absent
-      register: remove_config
-
-    - name: Restart Traefik to reload configuration
-      community.docker.docker_compose_v2:
-        project_src: "{{ traefik_stack_path }}"
-        state: present
-        pull: never
-        recreate: always
-        services:
-          - traefik
-      register: traefik_restart
-      when: remove_config.changed
-
-    - name: Wait for Traefik to be ready
-      wait_for:
-        port: 443
-        host: localhost
-        timeout: 30
-      delegate_to: localhost
-      when: traefik_restart.changed
-      ignore_errors: yes
-
-    - name: Check if Gitea docker-compose.yml already has Traefik labels
-      shell: |
-        grep -q "traefik.enable=true" {{ gitea_stack_path }}/docker-compose.yml && echo "Labels already present" || echo "Labels missing"
-      register: labels_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Copy docker-compose.yml from local to ensure labels are present
-      copy:
-        src: "{{ playbook_dir }}/../../stacks/gitea/docker-compose.yml"
-        dest: "{{ gitea_stack_path }}/docker-compose.yml"
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-        mode: '0644'
-      register: labels_added
-      when: "'Labels missing' in labels_check.stdout"
-
-    - name: Recreate Gitea container with labels
-      community.docker.docker_compose_v2:
-        project_src: "{{ gitea_stack_path }}"
-        state: present
-        pull: never
-        recreate: always
-        remove_orphans: no
-      register: gitea_recreate
-      when: labels_added.changed
-
-    - name: Wait for Gitea to be healthy
-      shell: |
-        for i in {1..30}; do
-          if docker exec gitea curl -f http://localhost:3000/api/healthz >/dev/null 2>&1; then
-            echo "Gitea is healthy"
-            exit 0
-          fi
-          echo "Waiting for Gitea... ($i/30)"
-          sleep 2
-        done
-        echo "Health check timeout"
-        exit 1
-      args:
-        executable: /bin/bash
-      register: health_wait
-      ignore_errors: yes
-      failed_when: false
-      when: gitea_recreate.changed
-
-    - name: Display health wait result
-      debug:
-        msg: "{{ health_wait.stdout_lines }}"
-      when: gitea_recreate.changed
-
-    - name: Check Traefik service registration
-      shell: |
-        sleep 5  # Give Traefik time to discover
-        docker exec traefik wget -qO- http://localhost:8080/api/http/services 2>&1 | grep -i gitea || echo "Service not found (may take a few seconds)"
-      register: traefik_service
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik service registration
-      debug:
-        msg: "{{ traefik_service.stdout_lines }}"
-
-    - name: Test external Gitea access
-      shell: |
-        sleep 3  # Give Traefik time to update routing
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP Status: %{http_code}\n" https://git.michaelschiemer.de/ 2>&1 || echo "Connection failed"
-      args:
-        executable: /bin/bash
-      register: external_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display external test result
-      debug:
-        msg: "{{ external_test.stdout_lines }}"
-
-    - name: Summary
-      debug:
-        msg:
-          - "=== FIX SUMMARY ==="
-          - "Dynamic config removed: {{ 'Yes' if remove_config.changed else 'Already removed' }}"
-          - "Labels added to docker-compose.yml: {{ 'Yes' if labels_added.changed else 'Already present' }}"
-          - "Gitea container recreated: {{ 'Yes' if gitea_recreate.changed else 'No' }}"
-          - ""
-          - "Gitea should now be accessible via https://git.michaelschiemer.de"
-          - "If issue persists, check Traefik logs for errors"
diff --git a/deployment/ansible/playbooks/fix-gitea-traefik-labels.yml b/deployment/ansible/playbooks/fix-gitea-traefik-labels.yml
deleted file mode 100644
index a14f5cde..00000000
--- a/deployment/ansible/playbooks/fix-gitea-traefik-labels.yml
+++ /dev/null
@@ -1,139 +0,0 @@
----
-- name: Fix Gitea Traefik Labels
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    gitea_stack_path: "{{ stacks_base_path }}/gitea"
-
-  tasks:
-    - name: Check current Gitea container status
-      shell: |
-        cd {{ gitea_stack_path }}
-        docker compose ps gitea
-      args:
-        executable: /bin/bash
-      register: gitea_status_before
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display current status
-      debug:
-        msg: "{{ gitea_status_before.stdout_lines }}"
-
-    - name: Check current Traefik labels
-      shell: |
-        docker inspect gitea --format '{{ '{{' }}range .Config.Labels{{ '}}' }}{{ '{{' }}.Key{{ '}}' }}={{ '{{' }}.Value{{ '}}' }}{{ '{{' }}\n{{ '}}' }}{{ '{{' }}end{{ '}}' }}' 2>&1 | grep -i traefik || echo "No Traefik labels found"
-      register: current_labels
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display current labels
-      debug:
-        msg: "{{ current_labels.stdout_lines }}"
-
-    - name: Recreate Gitea container with Traefik labels
-      community.docker.docker_compose_v2:
-        project_src: "{{ gitea_stack_path }}"
-        state: present
-        pull: never
-        recreate: always
-        remove_orphans: no
-      register: gitea_recreate
-
-    - name: Wait for Gitea to be ready
-      wait_for:
-        port: 3000
-        host: localhost
-        timeout: 60
-      delegate_to: localhost
-      when: gitea_recreate.changed
-      ignore_errors: yes
-
-    - name: Wait for Gitea health check
-      shell: |
-        for i in {1..30}; do
-          if docker exec gitea curl -f http://localhost:3000/api/healthz >/dev/null 2>&1; then
-            echo "Gitea is healthy"
-            exit 0
-          fi
-          echo "Waiting for Gitea to be healthy... ($i/30)"
-          sleep 2
-        done
-        echo "Gitea health check timeout"
-        exit 1
-      args:
-        executable: /bin/bash
-      register: health_wait
-      ignore_errors: yes
-      failed_when: false
-      when: gitea_recreate.changed
-
-    - name: Display health wait result
-      debug:
-        msg: "{{ health_wait.stdout_lines }}"
-      when: gitea_recreate.changed
-
-    - name: Check new Gitea container status
-      shell: |
-        cd {{ gitea_stack_path }}
-        docker compose ps gitea
-      args:
-        executable: /bin/bash
-      register: gitea_status_after
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display new status
-      debug:
-        msg: "{{ gitea_status_after.stdout_lines }}"
-
-    - name: Check new Traefik labels
-      shell: |
-        docker inspect gitea --format '{{ '{{' }}range .Config.Labels{{ '}}' }}{{ '{{' }}.Key{{ '}}' }}={{ '{{' }}.Value{{ '}}' }}{{ '{{' }}\n{{ '}}' }}{{ '{{' }}end{{ '}}' }}' 2>&1 | grep -i traefik || echo "No Traefik labels found"
-      register: new_labels
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display new labels
-      debug:
-        msg: "{{ new_labels.stdout_lines }}"
-
-    - name: Check Traefik service registration
-      shell: |
-        docker exec traefik wget -qO- http://localhost:8080/api/http/services 2>&1 | grep -i gitea || echo "Gitea service not found (may take a few seconds to register)"
-      register: traefik_service
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Traefik service registration
-      debug:
-        msg: "{{ traefik_service.stdout_lines }}"
-
-    - name: Test external Gitea access
-      shell: |
-        echo "Testing external access..."
-        sleep 5  # Give Traefik time to update
-        curl -k -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP Status: %{http_code}\n" https://git.michaelschiemer.de/ 2>&1 || echo "Connection failed"
-      args:
-        executable: /bin/bash
-      register: external_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display external test result
-      debug:
-        msg: "{{ external_test.stdout_lines }}"
-
-    - name: Summary
-      debug:
-        msg:
-          - "=== FIX SUMMARY ==="
-          - "Container recreated: {{ 'Yes' if gitea_recreate.changed else 'No' }}"
-          - "Traefik labels: {{ 'Fixed' if 'traefik' in new_labels.stdout|lower else 'Still missing' }}"
-          - ""
-          - "If the issue persists:"
-          - "1. Check Traefik logs: cd {{ stacks_base_path }}/traefik && docker compose logs traefik"
-          - "2. Verify Traefik can reach Gitea: docker exec traefik ping -c 2 gitea"
-          - "3. Check Gitea logs for errors: cd {{ gitea_stack_path }} && docker compose logs gitea"
diff --git a/deployment/ansible/playbooks/fix-grafana-vpn-access.yml b/deployment/ansible/playbooks/fix-grafana-vpn-access.yml
deleted file mode 100644
index 6aeddf8a..00000000
--- a/deployment/ansible/playbooks/fix-grafana-vpn-access.yml
+++ /dev/null
@@ -1,67 +0,0 @@
----
-- name: Fix Grafana VPN Access - Update Middleware to ipAllowList
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Backup current middlewares.yml
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        cp middlewares.yml middlewares.yml.backup.$(date +%Y%m%d_%H%M%S)
-      args:
-        executable: /bin/bash
-
-    - name: Update middlewares.yml - Change ipWhiteList to ipAllowList
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        sed -i 's/ipWhiteList:/ipAllowList:/g' middlewares.yml
-        sed -i 's/ipWhitelist/ipAllowList/g' middlewares.yml
-        # Validate YAML syntax
-        python3 -c "import yaml; yaml.safe_load(open('middlewares.yml')); print('YAML valid')"
-      args:
-        executable: /bin/bash
-
-    - name: Display updated grafana-vpn-only middleware
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        grep -A 6 'grafana-vpn-only:' middlewares.yml
-      args:
-        executable: /bin/bash
-      register: grafana_middleware
-
-    - name: Show updated middleware
-      debug:
-        msg: "{{ grafana_middleware.stdout_lines }}"
-
-    - name: Restart Traefik to apply changes
-      command: docker compose restart traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_restart
-
-    - name: Wait for Traefik to restart
-      pause:
-        seconds: 5
-
-    - name: Check Traefik logs for deprecation warnings
-      shell: |
-        cd ~/deployment/stacks/traefik
-        docker compose logs traefik --tail=20 2>&1 | grep -i 'allowlist\|whitelist\|deprecated' || echo "No warnings found"
-      args:
-        executable: /bin/bash
-      register: traefik_warnings
-
-    - name: Display Traefik warnings
-      debug:
-        msg: "{{ traefik_warnings.stdout_lines }}"
-
-    - name: Verify Traefik status
-      command: docker compose ps traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_status
-
-    - name: Display Traefik status
-      debug:
-        msg: "{{ traefik_status.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-grafana-vpn-routing.yml b/deployment/ansible/playbooks/fix-grafana-vpn-routing.yml
deleted file mode 100644
index 9642dc84..00000000
--- a/deployment/ansible/playbooks/fix-grafana-vpn-routing.yml
+++ /dev/null
@@ -1,80 +0,0 @@
----
-- name: Fix Grafana VPN Routing and Remove Temporary IP Allow
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Check recent Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Recent Grafana Access (Last 10 attempts) ==="
-        tail -50 logs/access.log | grep grafana | tail -10 | while read line; do
-          echo "$line" | grep -oP '"ClientHost":"[^"]*"' || echo "Could not parse"
-        done
-      args:
-        executable: /bin/bash
-      register: recent_access
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display recent access attempts
-      debug:
-        msg: "{{ recent_access.stdout_lines }}"
-
-    - name: Check if traffic comes from VPN
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Checking if recent traffic comes from VPN (10.8.0.0/24) ==="
-        tail -20 logs/access.log | grep grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | while read ip; do
-          if [[ "$ip" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "? $ip -> VPN traffic (10.8.0.0/24)"
-          else
-            echo "? $ip -> Public IP (not VPN)"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: vpn_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display VPN check results
-      debug:
-        msg: "{{ vpn_check.stdout_lines }}"
-
-    - name: Backup current middlewares.yml
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        cp middlewares.yml middlewares.yml.backup.$(date +%Y%m%d_%H%M%S)
-      args:
-        executable: /bin/bash
-      when: false  # Skip for now - we'll do this manually
-
-    - name: Check current middleware configuration
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        echo "=== Current grafana-vpn-only Middleware ==="
-        grep -A 8 "grafana-vpn-only:" middlewares.yml
-      args:
-        executable: /bin/bash
-      register: middleware_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display middleware configuration
-      debug:
-        msg: "{{ middleware_config.stdout_lines }}"
-
-    - name: Instructions for removing temporary IP
-      debug:
-        msg:
-          - "=== TO REMOVE TEMPORARY IP ALLOWLIST ==="
-          - "1. Make sure VPN routing works (DNS = 10.8.0.1 or use hosts file)"
-          - "2. Test that traffic comes from VPN (ClientHost: 10.8.0.7)"
-          - "3. Remove temporary IP from middlewares.yml:"
-          - "   cd ~/deployment/stacks/traefik/dynamic"
-          - "   sed -i '/89.246.96.244\/32/d' middlewares.yml"
-          - "4. Restart Traefik:"
-          - "   cd ~/deployment/stacks/traefik && docker compose restart traefik"
-          - "5. Test: With VPN = OK, Without VPN = 403"
diff --git a/deployment/ansible/playbooks/fix-nginx-upstream.yml b/deployment/ansible/playbooks/fix-nginx-upstream.yml
deleted file mode 100644
index 9c591393..00000000
--- a/deployment/ansible/playbooks/fix-nginx-upstream.yml
+++ /dev/null
@@ -1,79 +0,0 @@
----
-- name: Fix Nginx Upstream Configuration
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check which nginx config files exist
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Check nginx config files ==="
-        docker compose exec -T staging-nginx find /etc/nginx -name "*.conf" -type f 2>&1 | head -20
-        echo ""
-        echo "=== Check sites-enabled ==="
-        docker compose exec -T staging-nginx ls -la /etc/nginx/sites-enabled/ 2>&1 || echo "sites-enabled not found"
-        echo ""
-        echo "=== Check sites-available ==="
-        docker compose exec -T staging-nginx ls -la /etc/nginx/sites-available/ 2>&1 || echo "sites-available not found"
-        echo ""
-        echo "=== Check nginx.conf includes ==="
-        docker compose exec -T staging-nginx grep -E "include|conf.d|sites" /etc/nginx/nginx.conf 2>&1 | head -10
-      args:
-        executable: /bin/bash
-      register: nginx_config_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx config check
-      debug:
-        msg: "{{ nginx_config_check.stdout_lines }}"
-
-    - name: Find all fastcgi_pass directives
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Search for fastcgi_pass in all config files ==="
-        docker compose exec -T staging-nginx grep -r "fastcgi_pass" /etc/nginx/ 2>&1 || echo "Could not search"
-      args:
-        executable: /bin/bash
-      register: fastcgi_pass_search
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display fastcgi_pass search
-      debug:
-        msg: "{{ fastcgi_pass_search.stdout_lines }}"
-
-    - name: Fix all fastcgi_pass to use staging-app:9000
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Fix fastcgi_pass in all config files ==="
-        docker compose exec -T staging-nginx sh -c "find /etc/nginx -name '*.conf' -type f -exec sed -i 's|fastcgi_pass 127.0.0.1:9000;|fastcgi_pass staging-app:9000;|g' {} \;" || echo "Fix failed"
-        docker compose exec -T staging-nginx sh -c "find /etc/nginx -name '*.conf' -type f -exec sed -i 's|fastcgi_pass localhost:9000;|fastcgi_pass staging-app:9000;|g' {} \;" || echo "Fix failed"
-        docker compose exec -T staging-nginx sh -c "find /etc/nginx -name '*.conf' -type f -exec sed -i 's|fastcgi_pass php-upstream;|fastcgi_pass staging-app:9000;|g' {} \;" || echo "Note: php-upstream should stay as is"
-        echo "=== Verify fix ==="
-        docker compose exec -T staging-nginx grep -r "fastcgi_pass" /etc/nginx/ 2>&1 | grep -v "staging-app" || echo "All fastcgi_pass now use staging-app"
-      args:
-        executable: /bin/bash
-      register: fix_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display fix result
-      debug:
-        msg: "{{ fix_result.stdout_lines }}"
-
-    - name: Reload nginx to apply changes
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx nginx -t 2>&1 || echo "Config test failed"
-        docker compose restart staging-nginx || echo "Restart failed"
-      args:
-        executable: /bin/bash
-      register: nginx_reload
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx reload result
-      debug:
-        msg: "{{ nginx_reload.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-phpfpm-config.yml b/deployment/ansible/playbooks/fix-phpfpm-config.yml
deleted file mode 100644
index a41c3cc4..00000000
--- a/deployment/ansible/playbooks/fix-phpfpm-config.yml
+++ /dev/null
@@ -1,36 +0,0 @@
----
-- name: Check and Fix PHP-FPM Configuration
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check PHP-FPM www.conf configuration for allowed_clients
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== PHP-FPM www.conf listen.allowed_clients ==="
-        docker compose exec -T staging-app cat /usr/local/etc/php-fpm.d/www.conf 2>&1 | grep -E "(listen|allowed_clients|listen\.owner|listen\.group|listen\.mode)" | head -15
-      args:
-        executable: /bin/bash
-      register: fpm_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display PHP-FPM config
-      debug:
-        msg: "{{ fpm_config.stdout_lines }}"
-
-    - name: Check nginx error log for specific PHP-FPM errors
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Nginx Error Log (all lines) ==="
-        docker compose logs --tail=200 staging-nginx 2>&1 | grep -iE "(502|bad gateway|upstream|php|fpm|connection)" || echo "No specific errors found"
-      args:
-        executable: /bin/bash
-      register: nginx_error_log
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx error log
-      debug:
-        msg: "{{ nginx_error_log.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-sites-available-default.yml b/deployment/ansible/playbooks/fix-sites-available-default.yml
deleted file mode 100644
index 06dbf3bd..00000000
--- a/deployment/ansible/playbooks/fix-sites-available-default.yml
+++ /dev/null
@@ -1,57 +0,0 @@
----
-- name: Fix sites-available/default upstream configuration
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check php-upstream definition in sites-available/default
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Check upstream definition ==="
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default 2>&1 || echo "No upstream found"
-        echo ""
-        echo "=== Full sites-available/default file ==="
-        docker compose exec -T staging-nginx cat /etc/nginx/sites-available/default 2>&1
-      args:
-        executable: /bin/bash
-      register: upstream_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display upstream check
-      debug:
-        msg: "{{ upstream_check.stdout_lines }}"
-
-    - name: Fix php-upstream in sites-available/default
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Fix php-upstream definition ==="
-        docker compose exec -T staging-nginx sed -i 's|server 127.0.0.1:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Fix 127.0.0.1 failed"
-        docker compose exec -T staging-nginx sed -i 's|server localhost:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Fix localhost failed"
-        echo ""
-        echo "=== Verify fix ==="
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default 2>&1 || echo "No upstream found"
-      args:
-        executable: /bin/bash
-      register: fix_upstream
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display fix result
-      debug:
-        msg: "{{ fix_upstream.stdout_lines }}"
-
-    - name: Reload nginx
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx nginx -t && docker compose restart staging-nginx || echo "Reload failed"
-      args:
-        executable: /bin/bash
-      register: reload_nginx
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display reload result
-      debug:
-        msg: "{{ reload_nginx.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-staging-502-quick.yml b/deployment/ansible/playbooks/fix-staging-502-quick.yml
deleted file mode 100644
index 558940f1..00000000
--- a/deployment/ansible/playbooks/fix-staging-502-quick.yml
+++ /dev/null
@@ -1,52 +0,0 @@
----
-- name: Quick Fix Staging 502 Bad Gateway
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Fix php-upstream in sites-available/default
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Fixing nginx upstream configuration ==="
-        docker compose exec -T staging-nginx sed -i '/upstream php-upstream {/,/}/s|server 127.0.0.1:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Fix 127.0.0.1 failed"
-        docker compose exec -T staging-nginx sed -i '/upstream php-upstream {/,/}/s|server localhost:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Fix localhost failed"
-        echo "=== Verifying fix ==="
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default
-      args:
-        executable: /bin/bash
-      register: fix_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display fix result
-      debug:
-        msg: "{{ fix_result.stdout_lines }}"
-
-    - name: Reload nginx
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx nginx -t && docker compose restart staging-nginx
-      args:
-        executable: /bin/bash
-      register: reload_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display reload result
-      debug:
-        msg: "{{ reload_result.stdout_lines }}"
-
-    - name: Test if fix worked
-      shell: |
-        sleep 3
-        curl -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "%{http_code}" https://staging.michaelschiemer.de/ || echo "502"
-      args:
-        executable: /bin/bash
-      register: test_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display test result
-      debug:
-        msg: "HTTP Status: {{ test_result.stdout }} (200 = OK, 502 = Still broken)"
diff --git a/deployment/ansible/playbooks/fix-staging-502-verify.yml b/deployment/ansible/playbooks/fix-staging-502-verify.yml
deleted file mode 100644
index 748af435..00000000
--- a/deployment/ansible/playbooks/fix-staging-502-verify.yml
+++ /dev/null
@@ -1,88 +0,0 @@
----
-- name: Fix and Verify Staging 502 - Complete Fix
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check current upstream configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Current upstream config in sites-available/default ==="
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default 2>&1 || echo "Could not read config"
-      args:
-        executable: /bin/bash
-      register: current_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display current config
-      debug:
-        msg: "{{ current_config.stdout_lines }}"
-
-    - name: Fix upstream configuration (multiple methods)
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Fixing nginx upstream configuration ==="
-        # Method 1: Fix in upstream block
-        docker compose exec -T staging-nginx sed -i '/upstream php-upstream {/,/}/s|server 127.0.0.1:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Method 1 failed"
-        docker compose exec -T staging-nginx sed -i '/upstream php-upstream {/,/}/s|server localhost:9000;|server staging-app:9000;|g' /etc/nginx/sites-available/default || echo "Method 2 failed"
-        # Method 2: Fix any fastcgi_pass
-        docker compose exec -T staging-nginx sed -i 's|fastcgi_pass 127.0.0.1:9000;|fastcgi_pass php-upstream;|g' /etc/nginx/sites-available/default || echo "Method 3 failed"
-        docker compose exec -T staging-nginx sed -i 's|fastcgi_pass localhost:9000;|fastcgi_pass php-upstream;|g' /etc/nginx/sites-available/default || echo "Method 4 failed"
-        # Method 3: Replace entire upstream block if it still has wrong value
-        docker compose exec -T staging-nginx sh -c "grep -q 'server 127.0.0.1:9000' /etc/nginx/sites-available/default && sed -i '/upstream php-upstream {/,/}/c\upstream php-upstream {\n    server staging-app:9000;\n}' /etc/nginx/sites-available/default || echo 'No 127.0.0.1 found'" || echo "Method 5 failed"
-        echo "=== Verification ==="
-        docker compose exec -T staging-nginx grep -A 3 "upstream php-upstream" /etc/nginx/sites-available/default
-      args:
-        executable: /bin/bash
-      register: fix_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display fix result
-      debug:
-        msg: "{{ fix_result.stdout_lines }}"
-
-    - name: Test nginx configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose exec -T staging-nginx nginx -t 2>&1
-      args:
-        executable: /bin/bash
-      register: nginx_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display nginx test result
-      debug:
-        msg: "{{ nginx_test.stdout_lines }}"
-
-    - name: Restart nginx
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose restart staging-nginx
-        sleep 3
-      args:
-        executable: /bin/bash
-      register: restart_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display restart result
-      debug:
-        msg: "{{ restart_result.stdout_lines }}"
-
-    - name: Test connection
-      shell: |
-        sleep 2
-        curl -H "User-Agent: Mozilla/5.0" -s -o /dev/null -w "HTTP Status: %{http_code}" https://staging.michaelschiemer.de/ || echo "502"
-      args:
-        executable: /bin/bash
-      register: test_result
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display test result
-      debug:
-        msg: "Final HTTP Status: {{ test_result.stdout }} (200/404 = OK, 502 = Still broken)"
diff --git a/deployment/ansible/playbooks/fix-staging-complete.yml b/deployment/ansible/playbooks/fix-staging-complete.yml
deleted file mode 100644
index 5e57c607..00000000
--- a/deployment/ansible/playbooks/fix-staging-complete.yml
+++ /dev/null
@@ -1,71 +0,0 @@
----
-- name: Complete Fix for Staging (502 + Git)
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if index.php exists in staging-app
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-app sh -c "ls -la /var/www/html/public/index.php 2>&1" || echo "index.php NOT FOUND"
-      args:
-        executable: /bin/bash
-      register: index_php_app
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check if index.php exists in staging-nginx
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-nginx sh -c "ls -la /var/www/html/public/index.php 2>&1" || echo "index.php NOT FOUND"
-      args:
-        executable: /bin/bash
-      register: index_php_nginx
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check PHP-FPM listen configuration
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-app sh -c "cat /usr/local/etc/php-fpm.d/www.conf | grep -E '(^listen|^listen.allowed_clients|^listen.owner|^listen.group|^user|^group)' | head -20" || echo "Could not read config"
-      args:
-        executable: /bin/bash
-      register: php_fpm_full_config
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Test actual HTTP request to staging-app
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-nginx sh -c "curl -v http://staging-app:9000/index.php 2>&1 | head -30" || echo "HTTP test failed"
-      args:
-        executable: /bin/bash
-      register: http_test
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Fix Git ownership permanently in staging-app entrypoint
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-app sh -c "cd /var/www/html && git config --global --add safe.directory /var/www/html && git config --global --get-all safe.directory" || echo "Git config failed"
-      args:
-        executable: /bin/bash
-      register: git_config_check
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Display index.php check in app
-      debug:
-        msg: "{{ index_php_app.stdout_lines }}"
-
-    - name: Display index.php check in nginx
-      debug:
-        msg: "{{ index_php_nginx.stdout_lines }}"
-
-    - name: Display PHP-FPM config
-      debug:
-        msg: "{{ php_fpm_full_config.stdout_lines }}"
-
-    - name: Display HTTP test
-      debug:
-        msg: "{{ http_test.stdout_lines }}"
-
-    - name: Display git config
-      debug:
-        msg: "{{ git_config_check.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-staging-compose-secrets.yml b/deployment/ansible/playbooks/fix-staging-compose-secrets.yml
deleted file mode 100644
index fdc68789..00000000
--- a/deployment/ansible/playbooks/fix-staging-compose-secrets.yml
+++ /dev/null
@@ -1,138 +0,0 @@
----
-- name: Fix Staging docker-compose.staging.yml with Redis Secrets
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check current docker-compose.staging.yml on server
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Current staging-app environment (REDIS-related) ==="
-        grep -A 50 "staging-app:" docker-compose.staging.yml | grep -A 30 "environment:" | grep -E "(REDIS_|CACHE_|SESSION_)" || echo "No Redis env vars found"
-        echo ""
-        echo "=== Current secrets section for staging-app ==="
-        grep -A 10 "staging-app:" docker-compose.staging.yml | grep -A 15 "secrets:" || echo "Secrets section not found"
-        echo ""
-        echo "=== Secrets definitions at bottom ==="
-        tail -30 docker-compose.staging.yml | grep -A 10 "secrets:" || echo "Secrets definitions not found"
-      register: current_config
-      ignore_errors: yes
-
-    - name: Display current configuration
-      debug:
-        msg: "{{ current_config.stdout_lines }}"
-
-    - name: Get repository root path
-      shell: |
-        cd "{{ playbook_dir }}/../../.."
-        pwd
-      register: repo_root
-      changed_when: false
-      delegate_to: localhost
-      become: no
-
-    - name: Display repository root
-      debug:
-        msg: "Repository root: {{ repo_root.stdout }}"
-
-    - name: Check if docker-compose.staging.yml exists in repository
-      stat:
-        path: "{{ repo_root.stdout }}/docker-compose.staging.yml"
-      register: compose_file_stat
-      delegate_to: localhost
-      become: no
-
-    - name: Read docker-compose.staging.yml from repository
-      slurp:
-        src: "{{ repo_root.stdout }}/docker-compose.staging.yml"
-      register: compose_file_content
-      when: compose_file_stat.stat.exists
-      delegate_to: localhost
-      become: no
-
-    - name: Write docker-compose.staging.yml to server
-      copy:
-        content: "{{ compose_file_content.content | b64decode }}"
-        dest: "~/deployment/stacks/staging/docker-compose.staging.yml"
-        mode: '0644'
-      when: compose_file_stat.stat.exists
-
-    - name: Fail if docker-compose.staging.yml not found
-      fail:
-        msg: "Could not find docker-compose.staging.yml at {{ repo_root.stdout }}/docker-compose.staging.yml. Please ensure the file exists in the repository root."
-      when: not compose_file_stat.stat.exists
-
-    - name: Verify updated docker-compose.staging.yml on server
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Updated staging-app environment (REDIS-related) ==="
-        grep -A 50 "staging-app:" docker-compose.staging.yml | grep -A 30 "environment:" | grep -E "(REDIS_|CACHE_|SESSION_|_FILE)" || echo "No Redis env vars found"
-        echo ""
-        echo "=== Updated secrets section for staging-app ==="
-        grep -A 10 "staging-app:" docker-compose.staging.yml | grep -A 15 "secrets:" || echo "Secrets section not found"
-        echo ""
-        echo "=== Secrets definitions at bottom ==="
-        tail -30 docker-compose.staging.yml | grep -A 10 "redis_password:" || echo "Secrets definitions not found"
-      register: updated_config
-      ignore_errors: yes
-
-    - name: Display updated configuration
-      debug:
-        msg: "{{ updated_config.stdout_lines }}"
-
-    - name: Restart staging containers to apply changes
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose -f docker-compose.base.yml -f docker-compose.staging.yml up -d --force-recreate
-      register: restart_result
-      ignore_errors: yes
-
-    - name: Display restart result
-      debug:
-        msg: "{{ restart_result.stdout_lines }}"
-
-    - name: Wait for containers to start
-      pause:
-        seconds: 10
-
-    - name: Check container status after fix
-      shell: |
-        cd ~/deployment/stacks/staging
-        docker compose -f docker-compose.base.yml -f docker-compose.staging.yml ps
-      register: container_status
-      ignore_errors: yes
-
-    - name: Display container status
-      debug:
-        msg: "{{ container_status.stdout_lines }}"
-
-    - name: Verify REDIS_PASSWORD_FILE in container
-      shell: |
-        echo "=== Checking REDIS_PASSWORD_FILE in staging-app container ==="
-        docker exec staging-app env | grep REDIS_PASSWORD || echo "REDIS_PASSWORD variables not found"
-        docker exec staging-app env | grep "_FILE" | grep REDIS || echo "REDIS_PASSWORD_FILE not found"
-        echo ""
-        echo "=== Checking /run/secrets/redis_password ==="
-        docker exec staging-app ls -la /run/secrets/redis_password 2>&1 || echo "Secret file not found"
-      register: container_check
-      ignore_errors: yes
-
-    - name: Display container verification
-      debug:
-        msg: "{{ container_check.stdout_lines }}"
-
-    - name: Summary
-      debug:
-        msg:
-          - "========================================"
-          - "FIX SUMMARY"
-          - "========================================"
-          - "1. Updated docker-compose.staging.yml on server"
-          - "2. Restarted staging containers"
-          - "3. Verified REDIS_PASSWORD_FILE configuration"
-          - ""
-          - "Next steps:"
-          - "- Check staging-app logs: docker logs staging-app"
-          - "- Test Redis connection from staging-app container"
-          - "- Verify no more NOAUTH errors in logs"
diff --git a/deployment/ansible/playbooks/fix-staging-issues.yml b/deployment/ansible/playbooks/fix-staging-issues.yml
deleted file mode 100644
index a29fbe2d..00000000
--- a/deployment/ansible/playbooks/fix-staging-issues.yml
+++ /dev/null
@@ -1,83 +0,0 @@
----
-- name: Fix Staging Issues (502 Error + Git Ownership)
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Get recent nginx error logs
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose logs --tail=100 staging-nginx 2>&1
-      args:
-        executable: /bin/bash
-      register: nginx_all_logs
-      changed_when: false
-
-    - name: Test PHP-FPM connection with curl
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-nginx sh -c "curl -v http://staging-app:9000 2>&1 | head -20" || echo "Connection test completed"
-      args:
-        executable: /bin/bash
-      register: curl_test
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check PHP-FPM configuration
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-app sh -c "cat /usr/local/etc/php-fpm.d/www.conf | grep -E '(listen|listen.allowed_clients)' | head -10" || echo "Could not read PHP-FPM config"
-      args:
-        executable: /bin/bash
-      register: php_fpm_config
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Fix Git ownership issue in staging-app
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-app sh -c "cd /var/www/html && git config --global --add safe.directory /var/www/html && echo 'Git safe.directory configured'" || echo "Git config failed"
-      args:
-        executable: /bin/bash
-      register: git_fix
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Test if nginx can reach PHP-FPM
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-nginx sh -c "echo 'GET /index.php HTTP/1.0' | nc staging-app 9000 2>&1 | head -10" || docker compose exec -T staging-nginx sh -c "timeout 2 bash -c '</dev/tcp/staging-app/9000' && echo 'Port 9000 is reachable' || echo 'Port 9000 not reachable'" || echo "Could not test connection"
-      args:
-        executable: /bin/bash
-      register: port_test
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Check if nginx can read public directory
-      shell: |
-        cd ~/deployment/stacks/staging && docker compose exec -T staging-nginx sh -c "ls -la /var/www/html/public/ | head -10" || echo "Could not list public directory"
-      args:
-        executable: /bin/bash
-      register: public_dir_check
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Display all nginx logs
-      debug:
-        msg: "{{ nginx_all_logs.stdout_lines[-30:] }}"
-
-    - name: Display curl test
-      debug:
-        msg: "{{ curl_test.stdout_lines }}"
-
-    - name: Display PHP-FPM config
-      debug:
-        msg: "{{ php_fpm_config.stdout_lines }}"
-
-    - name: Display git fix result
-      debug:
-        msg: "{{ git_fix.stdout_lines }}"
-
-    - name: Display port test
-      debug:
-        msg: "{{ port_test.stdout_lines }}"
-
-    - name: Display public directory check
-      debug:
-        msg: "{{ public_dir_check.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-staging-secrets-permissions.yml b/deployment/ansible/playbooks/fix-staging-secrets-permissions.yml
deleted file mode 100644
index 6723963e..00000000
--- a/deployment/ansible/playbooks/fix-staging-secrets-permissions.yml
+++ /dev/null
@@ -1,82 +0,0 @@
----
-- name: Fix Staging Secrets Permissions
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check secrets file permissions in staging-app container
-      shell: |
-        echo "=== Checking /run/secrets/redis_password permissions ==="
-        docker exec staging-app ls -la /run/secrets/redis_password 2>&1 || echo "File not found"
-        echo ""
-        echo "=== Checking /run/secrets directory permissions ==="
-        docker exec staging-app ls -la /run/secrets/ | head -10
-        echo ""
-        echo "=== Current user ==="
-        docker exec staging-app whoami
-        echo ""
-        echo "=== Testing file read access ==="
-        docker exec staging-app cat /run/secrets/redis_password 2>&1 | head -c 20 || echo "Cannot read file"
-        echo "..."
-      register: permissions_check
-      ignore_errors: yes
-
-    - name: Display permissions check
-      debug:
-        msg: "{{ permissions_check.stdout_lines }}"
-
-    - name: Try to fix permissions via entrypoint modification
-      shell: |
-        cd ~/deployment/stacks/staging
-        # Check if staging-app has an entrypoint that can be modified
-        grep -A 5 "staging-app:" docker-compose.staging.yml | grep -A 10 "entrypoint:" | head -5
-      register: entrypoint_check
-      ignore_errors: yes
-
-    - name: Display entrypoint check
-      debug:
-        msg: "{{ entrypoint_check.stdout_lines }}"
-
-    - name: Check if we can read secrets as root in container
-      shell: |
-        echo "=== Reading secret as root ==="
-        docker exec -u root staging-app cat /run/secrets/redis_password 2>&1 | head -c 20 || echo "Cannot read even as root"
-        echo "..."
-        echo ""
-        echo "=== Checking file owner ==="
-        docker exec -u root staging-app stat -c "%U:%G %a" /run/secrets/redis_password 2>&1 || echo "Cannot stat"
-      register: root_check
-      ignore_errors: yes
-
-    - name: Display root check
-      debug: "{{ root_check.stdout_lines }}"
-      debug:
-        msg: "{{ root_check.stdout_lines }}"
-
-    - name: Check container user configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== staging-app user configuration ==="
-        grep -A 20 "staging-app:" docker-compose.staging.yml | grep -E "(user:|USER)" || echo "No user specified (defaults to www-data)"
-      register: user_config
-      ignore_errors: yes
-
-    - name: Display user configuration
-      debug:
-        msg: "{{ user_config.stdout_lines }}"
-
-    - name: Summary and Recommendations
-      debug:
-        msg:
-          - "========================================"
-          - "PERMISSIONS ISSUE ANALYSIS"
-          - "========================================"
-          - "The secret file exists but is not readable by the PHP process."
-          - ""
-          - "Possible solutions:"
-          - "1. Run PHP-FPM as root (NOT RECOMMENDED for security)"
-          - "2. Create a wrapper script that reads secrets as root and exports them"
-          - "3. Modify entrypoint to chmod/chown secrets (may not work on /run/secrets)"
-          - "4. Use environment variables instead of file-based secrets"
-          - "5. Modify docker-compose to use a different secrets mount path with proper permissions"
diff --git a/deployment/ansible/playbooks/fix-traefik-acme-permissions.yml b/deployment/ansible/playbooks/fix-traefik-acme-permissions.yml
new file mode 100644
index 00000000..4c92ec86
--- /dev/null
+++ b/deployment/ansible/playbooks/fix-traefik-acme-permissions.yml
@@ -0,0 +1,138 @@
+---
+# Fix Traefik ACME JSON Permissions
+# Prüft und korrigiert Berechtigungen für acme.json Datei
+- name: Fix Traefik ACME JSON Permissions
+  hosts: production
+  gather_facts: yes
+  become: no
+
+  tasks:
+    - name: Check if Traefik stack directory exists
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}"
+      register: traefik_stack_exists
+
+    - name: Fail if Traefik stack directory does not exist
+      ansible.builtin.fail:
+        msg: "Traefik stack directory not found at {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}"
+      when: not traefik_stack_exists.stat.exists
+
+    - name: Check if acme.json exists
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+      register: acme_json_exists
+
+    - name: Create acme.json if it doesn't exist
+      ansible.builtin.file:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+        state: file
+        mode: '0600'
+        owner: "{{ ansible_user | default('deploy') }}"
+        group: "{{ ansible_user | default('deploy') }}"
+      when: not acme_json_exists.stat.exists
+
+    - name: Get current acme.json permissions
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+      register: acme_json_stat
+
+    - name: Display current acme.json permissions
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Aktuelle acme.json Berechtigungen:
+          ================================================================================
+          Path: {{ acme_json_stat.stat.path }}
+          Owner: {{ acme_json_stat.stat.pw_name }} (UID: {{ acme_json_stat.stat.uid }})
+          Group: {{ acme_json_stat.stat.gr_name }} (GID: {{ acme_json_stat.stat.gid }})
+          Mode: {{ acme_json_stat.stat.mode | string | regex_replace('^0o?', '') }}
+          Size: {{ acme_json_stat.stat.size }} bytes
+          ================================================================================
+
+    - name: Fix acme.json permissions (chmod 600)
+      ansible.builtin.file:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+        mode: '0600'
+        owner: "{{ ansible_user | default('deploy') }}"
+        group: "{{ ansible_user | default('deploy') }}"
+      register: acme_json_permissions_fixed
+
+    - name: Verify acme.json permissions after fix
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+      register: acme_json_stat_after
+
+    - name: Display fixed acme.json permissions
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Korrigierte acme.json Berechtigungen:
+          ================================================================================
+          Path: {{ acme_json_stat_after.stat.path }}
+          Owner: {{ acme_json_stat_after.stat.pw_name }} (UID: {{ acme_json_stat_after.stat.uid }})
+          Group: {{ acme_json_stat_after.stat.gr_name }} (GID: {{ acme_json_stat_after.stat.gid }})
+          Mode: {{ acme_json_stat_after.stat.mode | string | regex_replace('^0o?', '') }}
+          Size: {{ acme_json_stat_after.stat.size }} bytes
+          ================================================================================
+          ✅ acme.json hat jetzt chmod 600 (nur Owner kann lesen/schreiben)
+          ================================================================================
+
+    - name: Check Traefik container can write to acme.json
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose exec -T traefik sh -c "test -w /acme.json && echo 'WRITABLE' || echo 'NOT_WRITABLE'" 2>&1 || echo "CONTAINER_CHECK_FAILED"
+      register: acme_json_writable_check
+      changed_when: false
+      failed_when: false
+
+    - name: Display acme.json writable check
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Container Schreibzugriff auf acme.json:
+          ================================================================================
+          {% if 'WRITABLE' in acme_json_writable_check.stdout %}
+          ✅ Traefik Container kann auf acme.json schreiben
+          {% elif 'NOT_WRITABLE' in acme_json_writable_check.stdout %}
+          ⚠️  Traefik Container kann NICHT auf acme.json schreiben
+          {% else %}
+          ⚠️  Konnte Container-Zugriff nicht prüfen: {{ acme_json_writable_check.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Check Docker volume mount for acme.json
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}json .Mounts{{ '}}' }}' 2>/dev/null | jq '.[] | select(.Destination=="/acme.json")' || echo "Could not check volume mount"
+      register: acme_json_mount
+      changed_when: false
+      failed_when: false
+
+    - name: Display acme.json volume mount
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Volume Mount für acme.json:
+          ================================================================================
+          {{ acme_json_mount.stdout }}
+          ================================================================================
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - acme.json Berechtigungen:
+          ================================================================================
+          
+          ✅ acme.json Berechtigungen auf chmod 600 gesetzt
+          ✅ Owner/Group auf {{ ansible_user | default('deploy') }} gesetzt
+          
+          Wichtig:
+          - acme.json muss beschreibbar sein für Traefik Container
+          - Port 80/443 müssen vom Host auf Traefik zeigen
+          - Traefik muss stabil laufen (keine häufigen Restarts)
+          
+          Nächste Schritte:
+          - Stelle sicher, dass Traefik stabil läuft
+          - Warte 5-10 Minuten auf ACME-Challenge-Abschluss
+          - Prüfe Traefik-Logs auf ACME-Fehler
+          ================================================================================
diff --git a/deployment/ansible/playbooks/fix-traefik-config.yml b/deployment/ansible/playbooks/fix-traefik-config.yml
deleted file mode 100644
index 27053c9c..00000000
--- a/deployment/ansible/playbooks/fix-traefik-config.yml
+++ /dev/null
@@ -1,142 +0,0 @@
----
-- name: Fix Traefik Configuration
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Backup current traefik.yml
-      shell: |
-        cd ~/deployment/stacks/traefik
-        cp traefik.yml traefik.yml.backup.$(date +%Y%m%d_%H%M%S)
-      args:
-        executable: /bin/bash
-
-    - name: Create correct traefik.yml
-      copy:
-        content: |
-          # Static Configuration for Traefik
-
-          # Global Configuration
-          global:
-            checkNewVersion: true
-            sendAnonymousUsage: false
-
-          # API and Dashboard
-          # Note: insecure: false means API is only accessible via HTTPS (through Traefik itself)
-          # No port 8080 needed - dashboard accessible via HTTPS at traefik.michaelschiemer.de
-          api:
-            dashboard: true
-            insecure: false
-            # Dashboard accessible via HTTPS router (no separate HTTP listener needed)
-
-          # Entry Points
-          entryPoints:
-            web:
-              address: ":80"
-              # No global redirect - ACME challenges need HTTP access
-              # Redirects are handled per-router via middleware
-
-            websecure:
-              address: ":443"
-              http:
-                tls:
-                  certResolver: letsencrypt
-                  domains:
-                    - main: michaelschiemer.de
-                      sans:
-                        - "*.michaelschiemer.de"
-
-          # Certificate Resolvers
-          certificatesResolvers:
-            letsencrypt:
-              acme:
-                email: kontakt@michaelschiemer.de
-                storage: /acme.json
-                caServer: https://acme-v02.api.letsencrypt.org/directory
-                # Use HTTP-01 challenge (requires port 80 accessible)
-                httpChallenge:
-                  entryPoint: web
-                # Uncomment for DNS challenge (requires DNS provider)
-                # dnsChallenge:
-                #   provider: cloudflare
-                #   delayBeforeCheck: 30
-
-          # Providers
-          providers:
-            docker:
-              endpoint: "unix:///var/run/docker.sock"
-              exposedByDefault: false
-              # Network mode is 'host', so we don't specify a network here
-              # Traefik can reach containers directly via their IPs in host network mode
-              watch: true
-
-            file:
-              directory: /dynamic
-              watch: true
-
-          # Forwarded Headers Configuration
-          # This ensures Traefik correctly identifies the real client IP
-          # Important for VPN access where requests come from WireGuard interface
-          forwardedHeaders:
-            trustedIPs:
-              - "10.8.0.0/24"      # WireGuard VPN network
-              - "127.0.0.1/32"     # Localhost
-              - "172.17.0.0/16"    # Docker bridge network
-              - "172.18.0.0/16"    # Docker user-defined networks
-            insecure: false
-
-          # Logging
-          log:
-            level: INFO
-            filePath: /logs/traefik.log
-            format: json
-
-          # Access Logs
-          accessLog:
-            filePath: /logs/access.log
-            format: json
-            bufferingSize: 100
-            filters:
-              statusCodes:
-                - "400-499"
-                - "500-599"
-
-          # Metrics
-          metrics:
-            prometheus:
-              addEntryPointsLabels: true
-              addRoutersLabels: true
-              addServicesLabels: true
-
-          # Ping
-          ping:
-            entryPoint: web
-        dest: ~/deployment/stacks/traefik/traefik.yml
-        mode: '0644'
-
-    - name: Validate YAML syntax
-      command: python3 -c "import yaml; yaml.safe_load(open('traefik.yml')); print('YAML valid')"
-      args:
-        chdir: ~/deployment/stacks/traefik
-      changed_when: false
-
-    - name: Restart Traefik
-      command: docker compose up -d traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_restart
-
-    - name: Wait for Traefik to start
-      pause:
-        seconds: 5
-
-    - name: Check Traefik status
-      command: docker compose ps traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_status
-
-    - name: Display Traefik status
-      debug:
-        msg: "{{ traefik_status.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/fix-web-container.yml b/deployment/ansible/playbooks/fix-web-container.yml
new file mode 100644
index 00000000..236134a9
--- /dev/null
+++ b/deployment/ansible/playbooks/fix-web-container.yml
@@ -0,0 +1,18 @@
+---
+# Fix Web Container Permissions
+# Wrapper Playbook for application role containers tasks (fix-web action)
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_container_action: fix-web
+    application_container_stabilize_wait: 10
+  tasks:
+    - name: Include application containers tasks (fix-web)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: containers
+  tags:
+    - application
+    - containers
+    - web
diff --git a/deployment/ansible/playbooks/initial-server-setup.yml b/deployment/ansible/playbooks/initial-server-setup.yml
new file mode 100644
index 00000000..48fd45ed
--- /dev/null
+++ b/deployment/ansible/playbooks/initial-server-setup.yml
@@ -0,0 +1,350 @@
+---
+- name: Initial Server Setup - Debian 13 (Trixie)
+  hosts: production
+  become: yes
+  gather_facts: yes
+
+  vars:
+    # User configuration
+    deploy_user: "{{ ansible_user | default('deploy') }}"
+    deploy_user_groups: ['sudo']  # docker group added after Docker installation
+    
+    # SSH configuration
+    ssh_key_only_auth: false  # Set to true AFTER SSH keys are properly configured
+    ssh_disable_root_login: false  # Set to true after deploy user is configured
+    
+    # Firewall configuration
+    firewall_enable: false  # Set to true after initial setup is complete
+    firewall_ports:
+      - { port: 22, proto: 'tcp', comment: 'SSH' }
+      - { port: 80, proto: 'tcp', comment: 'HTTP' }
+      - { port: 443, proto: 'tcp', comment: 'HTTPS' }
+      - { port: 51820, proto: 'udp', comment: 'WireGuard' }
+    
+    # System packages
+    system_base_packages:
+      - curl
+      - wget
+      - git
+      - vim
+      - sudo
+      - ufw
+      - fail2ban
+      - rsync
+
+  tasks:
+    - name: Display system information
+      ansible.builtin.debug:
+        msg:
+          - "Distribution: {{ ansible_distribution }} {{ ansible_distribution_version }}"
+          - "Hostname: {{ ansible_hostname }}"
+          - "Deploy User: {{ deploy_user }}"
+
+    # ========================================
+    # 1. System Updates
+    # ========================================
+    
+    - name: Check and wait for apt locks to be released
+      ansible.builtin.shell:
+        cmd: |
+          for lock in /var/lib/dpkg/lock /var/lib/apt/lists/lock /var/cache/apt/archives/lock; do
+            if [ -f "$lock" ]; then
+              echo "Waiting for lock: $lock"
+              count=0
+              while [ -f "$lock" ] && [ $count -lt 60 ]; do
+                sleep 1
+                count=$((count + 1))
+              done
+              if [ -f "$lock" ]; then
+                echo "Warning: Lock still exists after 60s: $lock"
+              else
+                echo "Lock released: $lock"
+              fi
+            fi
+          done
+      changed_when: false
+      failed_when: false
+      timeout: 70
+
+    - name: Update apt cache
+      ansible.builtin.shell:
+        cmd: timeout 300 apt-get update -qq
+      environment:
+        DEBIAN_FRONTEND: noninteractive
+        APT_LISTCHANGES_FRONTEND: none
+      register: apt_update_result
+      changed_when: apt_update_result.rc == 0
+      failed_when: apt_update_result.rc != 0
+      timeout: 300
+
+    - name: Display apt update result
+      ansible.builtin.debug:
+        msg: "apt update completed successfully"
+      when: apt_update_result.rc == 0
+
+    - name: Show packages to be upgraded
+      ansible.builtin.command:
+        cmd: apt list --upgradable 2>/dev/null | tail -n +2 | wc -l
+      register: packages_to_upgrade
+      changed_when: false
+      failed_when: false
+
+    - name: Display upgrade information
+      ansible.builtin.debug:
+        msg: "Packages to upgrade: {{ packages_to_upgrade.stdout | default('0') | trim }}"
+
+    - name: Upgrade system packages
+      ansible.builtin.shell:
+        cmd: timeout 600 apt-get upgrade -y -qq && apt-get autoremove -y -qq
+      environment:
+        DEBIAN_FRONTEND: noninteractive
+        APT_LISTCHANGES_FRONTEND: none
+      register: apt_upgrade_result
+      changed_when: apt_upgrade_result.rc == 0
+      failed_when: apt_upgrade_result.rc != 0
+      timeout: 600
+
+    - name: Display apt upgrade result
+      ansible.builtin.debug:
+        msg: "apt upgrade completed: {{ 'Packages upgraded' if apt_upgrade_result.rc == 0 else 'Failed' }}"
+      when: apt_upgrade_result.rc is defined
+
+    # ========================================
+    # 2. Install Base Packages
+    # ========================================
+    
+    - name: Install base packages
+      ansible.builtin.shell:
+        cmd: timeout 300 apt-get install -y -qq {{ system_base_packages | join(' ') }}
+      environment:
+        DEBIAN_FRONTEND: noninteractive
+        APT_LISTCHANGES_FRONTEND: none
+      register: apt_install_result
+      changed_when: apt_install_result.rc == 0
+      failed_when: apt_install_result.rc != 0
+      timeout: 300
+
+    - name: Display apt install result
+      ansible.builtin.debug:
+        msg: "apt install completed: {{ 'Packages installed/updated' if apt_install_result.rc == 0 else 'Failed' }}"
+      when: apt_install_result.rc is defined
+
+    # ========================================
+    # 3. Create Deploy User
+    # ========================================
+    
+    - name: Check if deploy user exists
+      ansible.builtin.shell:
+        cmd: timeout 5 getent passwd {{ deploy_user }} >/dev/null 2>&1 && echo "exists" || echo "not_found"
+      register: deploy_user_check
+      changed_when: false
+      failed_when: false
+      timeout: 10
+
+    - name: Create deploy user
+      ansible.builtin.user:
+        name: "{{ deploy_user }}"
+        groups: "{{ deploy_user_groups }}"
+        append: yes
+        shell: /bin/bash
+        create_home: yes
+      when: 
+        - "'not_found' in deploy_user_check.stdout"
+        - deploy_user != 'root'
+
+    - name: Ensure deploy user has sudo access
+      ansible.builtin.lineinfile:
+        path: /etc/sudoers.d/deploy
+        line: "{{ deploy_user }} ALL=(ALL) NOPASSWD: ALL"
+        create: yes
+        validate: 'visudo -cf %s'
+        mode: '0440'
+      when: deploy_user != 'root'
+
+    # ========================================
+    # 4. SSH Configuration
+    # ========================================
+    
+    - name: Get deploy user home directory
+      ansible.builtin.getent:
+        database: passwd
+        key: "{{ deploy_user }}"
+      register: deploy_user_info
+      when: deploy_user != 'root'
+      ignore_errors: yes
+
+    - name: Set deploy user home directory (root)
+      ansible.builtin.set_fact:
+        deploy_user_home: "/root"
+      when: deploy_user == 'root'
+
+    - name: Set deploy user home directory (from getent)
+      ansible.builtin.set_fact:
+        deploy_user_home: "{{ deploy_user_info.ansible_facts.getent_passwd[deploy_user][4] }}"
+      when: 
+        - deploy_user != 'root'
+        - deploy_user_info.ansible_facts.getent_passwd[deploy_user] is defined
+
+    - name: Set deploy user home directory (fallback)
+      ansible.builtin.set_fact:
+        deploy_user_home: "/home/{{ deploy_user }}"
+      when: deploy_user_home is not defined
+
+    - name: Ensure .ssh directory exists
+      ansible.builtin.file:
+        path: "{{ deploy_user_home }}/.ssh"
+        state: directory
+        owner: "{{ deploy_user }}"
+        group: "{{ deploy_user }}"
+        mode: '0700'
+
+    - name: Add SSH public key from control node
+      ansible.builtin.authorized_key:
+        user: "{{ deploy_user }}"
+        state: present
+        key: "{{ lookup('file', ansible_ssh_private_key_file | default('~/.ssh/production') + '.pub') }}"
+      when: ansible_ssh_private_key_file is defined
+
+    - name: Verify SSH key is configured before disabling password auth
+      ansible.builtin.stat:
+        path: "{{ deploy_user_home }}/.ssh/authorized_keys"
+      register: ssh_key_file
+      when: ssh_key_only_auth | bool
+
+    - name: Configure SSH key-only authentication
+      ansible.builtin.lineinfile:
+        path: /etc/ssh/sshd_config
+        regexp: "{{ item.regexp }}"
+        line: "{{ item.line }}"
+        backup: yes
+      loop:
+        - { regexp: '^#?PasswordAuthentication', line: 'PasswordAuthentication no' }
+        - { regexp: '^#?PubkeyAuthentication', line: 'PubkeyAuthentication yes' }
+        - { regexp: '^#?AuthorizedKeysFile', line: 'AuthorizedKeysFile .ssh/authorized_keys' }
+      when: 
+        - ssh_key_only_auth | bool
+        - ssh_key_file.stat.exists | default(false)
+      notify: restart sshd
+
+    - name: Disable root login (optional)
+      ansible.builtin.lineinfile:
+        path: /etc/ssh/sshd_config
+        regexp: '^#?PermitRootLogin'
+        line: 'PermitRootLogin no'
+        backup: yes
+      when: ssh_disable_root_login | bool
+      notify: restart sshd
+
+    # ========================================
+    # 5. Firewall Configuration
+    # ========================================
+    # WICHTIG: Firewall wird erst am Ende konfiguriert, um SSH-Verbindung nicht zu unterbrechen
+    
+    - name: Check current UFW status
+      ansible.builtin.command:
+        cmd: ufw status | head -1
+      register: ufw_current_status
+      changed_when: false
+      failed_when: false
+      when: firewall_enable | bool
+
+    - name: Display current firewall status
+      ansible.builtin.debug:
+        msg: "Current firewall status: {{ ufw_current_status.stdout | default('Unknown') }}"
+      when: firewall_enable | bool and ufw_current_status is defined
+
+    - name: Ensure SSH port is allowed before configuring firewall
+      ansible.builtin.command:
+        cmd: ufw allow 22/tcp comment 'SSH - Allow before enabling firewall'
+      when: 
+        - firewall_enable | bool
+        - "'inactive' in (ufw_current_status.stdout | default(''))"
+      ignore_errors: yes
+
+    - name: Reset UFW to defaults (only if inactive)
+      ansible.builtin.command:
+        cmd: ufw --force reset
+      when: 
+        - firewall_enable | bool
+        - "'inactive' in (ufw_current_status.stdout | default(''))"
+      changed_when: false
+
+    - name: Set UFW default policies
+      ansible.builtin.command:
+        cmd: "ufw default {{ item.policy }} {{ item.direction }}"
+      loop:
+        - { policy: 'deny', direction: 'incoming' }
+        - { policy: 'allow', direction: 'outgoing' }
+      when: 
+        - firewall_enable | bool
+        - "'inactive' in (ufw_current_status.stdout | default(''))"
+
+    - name: Allow firewall ports (ensure SSH is first)
+      ansible.builtin.command:
+        cmd: "ufw allow {{ item.port }}/{{ item.proto }} comment '{{ item.comment }}'"
+      loop: "{{ firewall_ports }}"
+      when: 
+        - firewall_enable | bool
+        - "'inactive' in (ufw_current_status.stdout | default(''))"
+      register: ufw_rules
+      changed_when: ufw_rules.rc == 0
+
+    - name: Enable UFW (only if inactive)
+      ansible.builtin.command:
+        cmd: ufw --force enable
+      when: 
+        - firewall_enable | bool
+        - "'inactive' in (ufw_current_status.stdout | default(''))"
+
+    - name: Display UFW status
+      ansible.builtin.command:
+        cmd: ufw status verbose
+      register: ufw_status
+      changed_when: false
+
+    - name: Show UFW status
+      ansible.builtin.debug:
+        msg: "{{ ufw_status.stdout_lines }}"
+
+    # ========================================
+    # 6. Fail2ban Configuration
+    # ========================================
+    
+    - name: Ensure fail2ban is enabled and started
+      ansible.builtin.systemd:
+        name: fail2ban
+        enabled: yes
+        state: started
+      when: "'fail2ban' in system_base_packages"
+
+    # ========================================
+    # 7. System Configuration
+    # ========================================
+    
+    - name: Configure timezone
+      ansible.builtin.timezone:
+        name: Europe/Berlin
+
+    - name: Display setup summary
+      ansible.builtin.debug:
+        msg:
+          - "=========================================="
+          - "Initial Server Setup Complete"
+          - "=========================================="
+          - "Deploy User: {{ deploy_user }}"
+          - "SSH Key-only Auth: {{ ssh_key_only_auth }}"
+          - "Firewall: {{ 'Enabled' if firewall_enable else 'Disabled' }}"
+          - "Fail2ban: {{ 'Enabled' if 'fail2ban' in system_base_packages else 'Disabled' }}"
+          - "=========================================="
+          - "Next Steps:"
+          - "1. Test SSH connection: ssh {{ deploy_user }}@{{ ansible_host }}"
+          - "2. Install Docker: ansible-playbook playbooks/install-docker.yml"
+          - "3. Deploy Infrastructure: ansible-playbook playbooks/setup-infrastructure.yml"
+          - "=========================================="
+
+  handlers:
+    - name: restart sshd
+      ansible.builtin.systemd:
+        name: sshd
+        state: restarted
+
diff --git a/deployment/ansible/playbooks/install-composer-dependencies.yml b/deployment/ansible/playbooks/install-composer-dependencies.yml
index 57ccf0e1..38857808 100644
--- a/deployment/ansible/playbooks/install-composer-dependencies.yml
+++ b/deployment/ansible/playbooks/install-composer-dependencies.yml
@@ -1,108 +1,16 @@
 ---
-- name: Install Composer Dependencies in Application Container
-  hosts: "{{ deployment_hosts | default('production') }}"
+# Install Composer Dependencies in Application Container
+# Wrapper Playbook for application role composer tasks
+- hosts: "{{ deployment_hosts | default('production') }}"
   gather_facts: no
   become: no
-
   vars:
-    # Application code directory (where docker-compose files are located)
-    application_code_dest: "/home/deploy/michaelschiemer/current"
-    application_compose_suffix: >-
-      {%- if deployment_environment == 'staging' -%}
-        staging.yml
-      {%- else -%}
-        production.yml
-      {%- endif -%}
-    # Deployment environment (staging or production)
     deployment_environment: "{{ deployment_environment | default('production') }}"
-    # Service name (php for production, staging-app for staging)
-    php_service_name: >-
-      {%- if deployment_environment == 'staging' -%}
-        staging-app
-      {%- else -%}
-        php
-      {%- endif -%}
-
   tasks:
-    - name: Check if composer.json exists
-      stat:
-        path: /home/deploy/michaelschiemer/current/composer.json
-      delegate_to: "{{ inventory_hostname }}"
-      register: composer_json_exists
-
-    - name: Fail if composer.json is missing
-      fail:
-        msg: "composer.json not found at /home/deploy/michaelschiemer/current/composer.json"
-      when: not composer_json_exists.stat.exists
-
-    - name: Check if container is running
-      shell: |
-        cd {{ application_code_dest }}
-        docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} ps {{ php_service_name }} --format json
-      register: container_status
-      changed_when: false
-      failed_when: false
-
-    - name: Display container status
-      debug:
-        msg: "Container status: {{ container_status.stdout }}"
-
-    - name: Fail if container is not running
-      fail:
-        msg: |
-          Container '{{ php_service_name }}' is not running!
-          
-          The container must be started before installing composer dependencies.
-          This is typically done by the 'deploy-image.yml' playbook which should run before this.
-          
-          To start the container manually:
-          cd {{ application_code_dest }}
-          docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} up -d {{ php_service_name }}
-          
-          Note: The container requires environment variables (DB_USERNAME, DB_PASSWORD, etc.)
-          which should be set in a .env file or via docker-compose environment configuration.
-      when: container_status.rc != 0 or '"State":"running"' not in container_status.stdout
-
-    - name: Install composer dependencies in PHP container
-      shell: |
-        cd {{ application_code_dest }}
-        docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ php_service_name }} composer install --no-dev --optimize-autoloader --no-interaction
-      register: composer_install
-      changed_when: true
-      failed_when: composer_install.rc != 0
-
-    - name: Display composer install output
-      debug:
-        msg: |
-          Composer Install Output:
-          stdout: {{ composer_install.stdout }}
-          stderr: {{ composer_install.stderr }}
-          rc: {{ composer_install.rc }}
-      when: composer_install.rc != 0
-
-    - name: Restart queue-worker and scheduler to pick up vendor directory (production only)
-      shell: |
-        cd {{ application_code_dest }}
-        docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} restart queue-worker scheduler
-      register: restart_workers
-      changed_when: true
-      failed_when: false
-      when: deployment_environment == 'production'
-
-
-    - name: Verify vendor/autoload.php exists
-      shell: |
-        cd {{ application_code_dest }}
-        docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ php_service_name }} test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
-      register: autoload_check
-      changed_when: false
-
-    - name: Display autoload verification
-      debug:
-        msg: "vendor/autoload.php: {{ autoload_check.stdout.strip() }}"
-
-    - name: Fail if autoload.php is missing
-      fail:
-        msg: "vendor/autoload.php was not created after composer install"
-      when: "autoload_check.stdout.strip() != 'EXISTS'"
-
+    - name: Include application composer tasks
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: composer
+  tags:
+    - application
+    - composer
diff --git a/deployment/ansible/playbooks/install-docker.yml b/deployment/ansible/playbooks/install-docker.yml
new file mode 100644
index 00000000..648c922e
--- /dev/null
+++ b/deployment/ansible/playbooks/install-docker.yml
@@ -0,0 +1,92 @@
+---
+- name: Install Docker on Production Server
+  hosts: production
+  become: yes
+  gather_facts: yes
+
+  tasks:
+    - name: Install prerequisites
+      ansible.builtin.apt:
+        name:
+          - ca-certificates
+          - curl
+        state: present
+        update_cache: yes
+
+    - name: Create keyrings directory
+      ansible.builtin.file:
+        path: /etc/apt/keyrings
+        state: directory
+        mode: '0755'
+
+    - name: Detect distribution (Debian or Ubuntu)
+      ansible.builtin.set_fact:
+        docker_distribution: "{{ 'debian' if ansible_distribution == 'Debian' else 'ubuntu' }}"
+      changed_when: false
+
+    - name: Add Docker GPG key
+      ansible.builtin.shell:
+        cmd: |
+          curl -fsSL https://download.docker.com/linux/{{ docker_distribution }}/gpg -o /etc/apt/keyrings/docker.asc
+          chmod a+r /etc/apt/keyrings/docker.asc
+        creates: /etc/apt/keyrings/docker.asc
+
+    - name: Add Docker repository
+      ansible.builtin.shell:
+        cmd: |
+          echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/{{ docker_distribution }} $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
+        creates: /etc/apt/sources.list.d/docker.list
+
+    - name: Update apt cache after adding Docker repo
+      ansible.builtin.apt:
+        update_cache: yes
+
+    - name: Install Docker packages
+      ansible.builtin.apt:
+        name:
+          - docker-ce
+          - docker-ce-cli
+          - containerd.io
+          - docker-buildx-plugin
+          - docker-compose-plugin
+        state: present
+
+    - name: Start and enable Docker service
+      ansible.builtin.systemd:
+        name: docker
+        state: started
+        enabled: yes
+
+    - name: Add deploy user to docker group
+      ansible.builtin.user:
+        name: "{{ ansible_user | default('deploy') }}"
+        groups: docker
+        append: yes
+
+    - name: Verify Docker installation
+      ansible.builtin.command: docker --version
+      register: docker_version
+      changed_when: false
+
+    - name: Display Docker version
+      ansible.builtin.debug:
+        msg: "Docker installed successfully: {{ docker_version.stdout }}"
+
+    - name: Verify Docker Compose installation
+      ansible.builtin.command: docker compose version
+      register: compose_version
+      changed_when: false
+
+    - name: Display Docker Compose version
+      ansible.builtin.debug:
+        msg: "Docker Compose installed successfully: {{ compose_version.stdout }}"
+
+    - name: Run Docker hello-world test
+      ansible.builtin.command: docker run --rm hello-world
+      register: docker_test
+      changed_when: false
+
+    - name: Display Docker test result
+      ansible.builtin.debug:
+        msg: "Docker is working correctly!"
+      when: "'Hello from Docker!' in docker_test.stdout"
diff --git a/deployment/ansible/playbooks/monitor-grafana-access-live.yml b/deployment/ansible/playbooks/monitor-grafana-access-live.yml
deleted file mode 100644
index e100817d..00000000
--- a/deployment/ansible/playbooks/monitor-grafana-access-live.yml
+++ /dev/null
@@ -1,95 +0,0 @@
----
-- name: Live Monitor Grafana Access - Watch Traefik Logs in Real-Time
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Clear previous Grafana access attempts count
-      shell: |
-        echo "Starting live monitoring. Make a request to https://grafana.michaelschiemer.de now!"
-        echo "Waiting 10 seconds for you to make a request..."
-        sleep 10
-      args:
-        executable: /bin/bash
-
-    - name: Show recent Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Last 5 Grafana Access Attempts ==="
-        tail -100 logs/access.log | grep -i grafana | tail -5
-      args:
-        executable: /bin/bash
-      register: recent_access
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display recent access attempts
-      debug:
-        msg: "{{ recent_access.stdout_lines }}"
-
-    - name: Check current client IP pattern
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Client IPs in recent Grafana requests ==="
-        tail -50 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | head -5
-      args:
-        executable: /bin/bash
-      register: client_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display client IPs
-      debug:
-        msg: "{{ client_ips.stdout_lines }}"
-
-    - name: Extract and check client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Checking if client IPs are in VPN range (10.8.0.0/24) ==="
-        tail -20 logs/access.log | grep -i grafana | tail -3 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | while read ip; do
-          if [[ "$ip" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "$ip -> In VPN range (10.8.0.0/24): YES"
-          else
-            echo "$ip -> In VPN range (10.8.0.0/24): NO (this is the problem!)"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: vpn_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display VPN range check
-      debug:
-        msg: "{{ vpn_check.stdout_lines }}"
-
-    - name: Show Traefik middleware errors
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Traefik Middleware Errors (if any) ==="
-        tail -50 logs/traefik.log | grep -iE "(grafana|ipallowlist|403|middleware)" | tail -10 || echo "No middleware errors found"
-      args:
-        executable: /bin/bash
-      register: middleware_errors
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display middleware errors
-      debug:
-        msg: "{{ middleware_errors.stdout_lines }}"
-
-    - name: Verify middleware configuration
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        echo "=== Current grafana-vpn-only Middleware ==="
-        grep -A 6 "grafana-vpn-only:" middlewares.yml
-      args:
-        executable: /bin/bash
-      register: middleware_config
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display middleware configuration
-      debug: |
-        msg: "{{ middleware_config.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/monitor-grafana-client-ip.yml b/deployment/ansible/playbooks/monitor-grafana-client-ip.yml
deleted file mode 100644
index 98b7aa2e..00000000
--- a/deployment/ansible/playbooks/monitor-grafana-client-ip.yml
+++ /dev/null
@@ -1,75 +0,0 @@
----
-- name: Monitor Grafana Client IP - Wait for Next Request
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions
-      debug:
-        msg:
-          - "=== LIVE MONITORING ==="
-          - "Bitte mache JETZT einen Zugriff auf https://grafana.michaelschiemer.de im Browser"
-          - "Ich warte 30 Sekunden und pr?fe dann die Logs..."
-          - ""
-
-    - name: Wait for access attempt
-      pause:
-        seconds: 30
-
-    - name: Check recent Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Last 10 Grafana Access Attempts ==="
-        tail -100 logs/access.log | grep -i grafana | tail -10
-      args:
-        executable: /bin/bash
-      register: recent_access
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Extract client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Client IPs in recent requests ==="
-        tail -20 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: client_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display client IPs
-      debug:
-        msg: "{{ client_ips.stdout_lines }}"
-
-    - name: Check if IP is VPN IP
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -10 logs/access.log | grep -i grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | while read ip; do
-          if [[ "$ip" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "? $ip -> VPN IP (10.8.0.0/24) - Traffic kommt ?ber VPN!"
-          else
-            echo "? $ip -> Public IP (nicht VPN) - Traffic kommt NICHT ?ber VPN"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: vpn_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display VPN check
-      debug:
-        msg: "{{ vpn_check.stdout_lines }}"
-
-    - name: Recommendations
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Wenn ClientHost: 10.8.0.7 (VPN-IP) ? Traffic kommt ?ber VPN ?"
-          - "Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "Wenn ClientHost: 89.246.96.244 (?ffentliche IP) ? Traffic kommt NICHT ?ber VPN ?"
-          - "Dann m?ssen wir VPN-Routing noch weiter fixen"
diff --git a/deployment/ansible/playbooks/monitor-grafana-live-now.yml b/deployment/ansible/playbooks/monitor-grafana-live-now.yml
deleted file mode 100644
index c6636398..00000000
--- a/deployment/ansible/playbooks/monitor-grafana-live-now.yml
+++ /dev/null
@@ -1,80 +0,0 @@
----
-- name: Monitor Grafana Access Live - Check Latest Request
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Get timestamp of last log entry
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -1 logs/access.log | grep -oP '"time":"[^"]*"'
-      args:
-        executable: /bin/bash
-      register: last_log_time
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display last log time
-      debug:
-        msg: "{{ last_log_time.stdout }}"
-
-    - name: Get last 30 Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -1000 logs/access.log | grep -i grafana | tail -30
-      args:
-        executable: /bin/bash
-      register: grafana_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Extract client IPs from last 10 Grafana requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -200 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: client_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display client IPs found
-      debug:
-        msg: "{{ client_ips.stdout_lines }}"
-
-    - name: Analyze last 5 Grafana requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -5 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if [[ "$client" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP"
-          elif [[ "$client" == "89.246.96.244" ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? Public IP"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unknown"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
-
-    - name: Recommendations
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN ?"
-          - "? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN ?"
-          - "? Dann m?ssen wir weiter debuggen (Route, AllowedIPs, etc.)"
diff --git a/deployment/ansible/playbooks/monitor-grafana-live-with-firewall.yml b/deployment/ansible/playbooks/monitor-grafana-live-with-firewall.yml
deleted file mode 100644
index dcb8bd6a..00000000
--- a/deployment/ansible/playbooks/monitor-grafana-live-with-firewall.yml
+++ /dev/null
@@ -1,86 +0,0 @@
----
-- name: Monitor Grafana Access After Firewall Changes
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions
-      debug:
-        msg:
-          - "=== LIVE MONITORING NACH FIREWALL-?NDERUNGEN ==="
-          - "Firewall-Regeln wurden erstellt ?"
-          - "WireGuard ist verbunden ?"
-          - ""
-          - "Bitte mache JETZT einen neuen Zugriff auf https://grafana.michaelschiemer.de im Browser"
-          - "Ich warte 20 Sekunden und pr?fe dann die Logs..."
-          - ""
-
-    - name: Get current log timestamp
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -1 logs/access.log | grep -oP '"time":"[^"]*"'
-      args:
-        executable: /bin/bash
-      register: current_timestamp
-      failed_when: false
-
-    - name: Display current timestamp
-      debug:
-        msg: "Letztes Log: {{ current_timestamp.stdout }}"
-
-    - name: Wait for access attempt
-      pause:
-        seconds: 20
-
-    - name: Check for new Grafana access
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -200 logs/access.log | grep -i grafana | tail -20 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1 | cut -d':' -f1-2)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if echo "$client" | grep -q '^10\.8\.0\.'; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [ "$client" = "89.246.96.244" ]; then
-            echo "$time | ClientHost: $client | Status: $status ? Public IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unknown IP"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
-
-    - name: Get unique client IPs from last 10 requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Final verdict
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Pr?fe die obigen Zeilen:"
-          - ""
-          - "? Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN!"
-          - "   ? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "? Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN"
-          - "   ? Dann m?ssen wir weitere Optionen probieren (Route explizit setzen, etc.)"
diff --git a/deployment/ansible/playbooks/monitor-live-grafana-access.yml b/deployment/ansible/playbooks/monitor-live-grafana-access.yml
deleted file mode 100644
index 0d392842..00000000
--- a/deployment/ansible/playbooks/monitor-live-grafana-access.yml
+++ /dev/null
@@ -1,70 +0,0 @@
----
-- name: Monitor Live Grafana Access
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions
-      debug:
-        msg:
-          - "=== LIVE MONITORING ==="
-          - "Bitte mache JETZT einen Zugriff auf https://grafana.michaelschiemer.de im Browser"
-          - "Ich warte 20 Sekunden und pr?fe dann die Logs..."
-          - ""
-
-    - name: Get current log timestamp
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -1 logs/access.log | grep -oP '"time":"[^"]*"'
-      args:
-        executable: /bin/bash
-      register: current_timestamp
-      failed_when: false
-
-    - name: Display current timestamp
-      debug:
-        msg: "Letztes Log: {{ current_timestamp.stdout }}"
-
-    - name: Wait for access attempt
-      pause:
-        seconds: 20
-
-    - name: Check for new Grafana access
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -500 logs/access.log | grep -i grafana | tail -10 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if echo "$client" | grep -q "^10\.8\.0\."; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [ "$client" = "89.246.96.244" ]; then
-            echo "$time | ClientHost: $client | Status: $status ? Public IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unknown"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
-
-    - name: Get unique client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/monitor-traefik-continuously.yml b/deployment/ansible/playbooks/monitor-traefik-continuously.yml
new file mode 100644
index 00000000..920c213b
--- /dev/null
+++ b/deployment/ansible/playbooks/monitor-traefik-continuously.yml
@@ -0,0 +1,141 @@
+---
+# Monitor Traefik Continuously
+# Überwacht Traefik-Logs und Docker Events in Echtzeit um Restart-Quelle zu finden
+- name: Monitor Traefik Continuously
+  hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    traefik_stack_path: "{{ stacks_base_path }}/traefik"
+    monitor_duration_minutes: 30  # Standard: 30 Minuten, kann überschrieben werden
+
+  tasks:
+    - name: Display monitoring information
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          TRAEFIK CONTINUOUS MONITORING
+          ================================================================================
+          
+          Überwachungsdauer: {{ monitor_duration_minutes }} Minuten
+          
+          Überwacht:
+          1. Traefik-Logs auf "Stopping server gracefully" / "I have to go"
+          2. Docker Events für Traefik-Container
+          3. Docker Daemon Logs für Container-Stops
+          
+          Starte Monitoring...
+          ================================================================================
+
+    - name: Get initial Traefik status
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.State.Status{{ '}}' }} {{ '{{' }}.State.StartedAt{{ '}}' }}' 2>/dev/null || echo "UNKNOWN"
+      register: initial_status
+      changed_when: false
+
+    - name: Start monitoring Traefik logs in background
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        timeout {{ monitor_duration_minutes * 60 }} docker compose logs -f traefik 2>&1 | grep --line-buffered -iE "stopping server gracefully|I have to go" | while read line; do
+          echo "[$(date '+%Y-%m-%d %H:%M:%S')] $line"
+        done > /tmp/traefik_monitor_$$.log 2>&1 &
+        echo $!
+      register: log_monitor_pid
+      changed_when: false
+      async: "{{ monitor_duration_minutes * 60 + 60 }}"
+      poll: 0
+
+    - name: Start monitoring Docker events in background
+      ansible.builtin.shell: |
+        timeout {{ monitor_duration_minutes * 60 }} docker events --filter container=traefik --filter event=die --format "[{{ '{{' }}.Time{{ '}}' }}] {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.name{{ '}}' }}" 2>&1 | tee /tmp/traefik_docker_events_$$.log &
+        echo $!
+      register: docker_events_pid
+      changed_when: false
+      async: "{{ monitor_duration_minutes * 60 + 60 }}"
+      poll: 0
+
+    - name: Wait for monitoring period
+      ansible.builtin.pause:
+        minutes: "{{ monitor_duration_minutes }}"
+
+    - name: Stop log monitoring
+      ansible.builtin.shell: |
+        pkill -f "docker compose logs.*traefik" || true
+        sleep 2
+      changed_when: false
+      failed_when: false
+
+    - name: Stop Docker events monitoring
+      ansible.builtin.shell: |
+        pkill -f "docker events.*traefik" || true
+        sleep 2
+      changed_when: false
+      failed_when: false
+
+    - name: Read Traefik log monitoring results
+      ansible.builtin.slurp:
+        src: "{{ item }}"
+      register: log_results
+      changed_when: false
+      failed_when: false
+      loop: "{{ log_monitor_pid.stdout_lines | map('regex_replace', '^.*', '/tmp/traefik_monitor_' + ansible_date_time.epoch + '.log') | list }}"
+
+    - name: Read Docker events monitoring results
+      ansible.builtin.slurp:
+        src: "{{ item }}"
+      register: docker_events_results
+      changed_when: false
+      failed_when: false
+      loop: "{{ docker_events_pid.stdout_lines | map('regex_replace', '^.*', '/tmp/traefik_docker_events_' + ansible_date_time.epoch + '.log') | list }}"
+
+    - name: Get final Traefik status
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.State.Status{{ '}}' }} {{ '{{' }}.State.StartedAt{{ '}}' }} {{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "UNKNOWN"
+      register: final_status
+      changed_when: false
+
+    - name: Check Traefik logs for stop messages during monitoring
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path }}
+        docker compose logs traefik --since {{ monitor_duration_minutes }}m 2>&1 | grep -iE "stopping server gracefully|I have to go" || echo "Keine Stop-Meldungen gefunden"
+      register: traefik_stop_messages
+      changed_when: false
+      failed_when: false
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          MONITORING ZUSAMMENFASSUNG ({{ monitor_duration_minutes }} Minuten):
+          ================================================================================
+          
+          Initial Status: {{ initial_status.stdout }}
+          Final Status: {{ final_status.stdout }}
+          
+          Traefik Stop-Meldungen während Monitoring:
+          {% if traefik_stop_messages.stdout and 'Keine Stop-Meldungen' not in traefik_stop_messages.stdout %}
+          ❌ STOP-MELDUNGEN GEFUNDEN:
+          {{ traefik_stop_messages.stdout }}
+          
+          ⚠️  PROBLEM BESTÄTIGT: Traefik wurde während des Monitorings gestoppt!
+          
+          Nächste Schritte:
+          1. Prüfe Docker Events Log: /tmp/traefik_docker_events_*.log
+          2. Prüfe Traefik Log Monitor: /tmp/traefik_monitor_*.log
+          3. Prüfe wer den Stop-Befehl ausgeführt hat:
+             - journalctl -u docker.service --since "{{ monitor_duration_minutes }} minutes ago"
+             - docker events --since "{{ monitor_duration_minutes }} minutes ago" --filter container=traefik
+          {% else %}
+          ✅ KEINE STOP-MELDUNGEN GEFUNDEN
+          
+          Traefik lief stabil während des {{ monitor_duration_minutes }}-minütigen Monitorings.
+          
+          {% if initial_status.stdout != final_status.stdout %}
+          ⚠️  Status hat sich geändert:
+          - Vorher: {{ initial_status.stdout }}
+          - Nachher: {{ final_status.stdout }}
+          {% endif %}
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/monitor-traefik-restarts.yml b/deployment/ansible/playbooks/monitor-traefik-restarts.yml
new file mode 100644
index 00000000..5d1d609f
--- /dev/null
+++ b/deployment/ansible/playbooks/monitor-traefik-restarts.yml
@@ -0,0 +1,150 @@
+---
+# Monitor Traefik for Unexpected Restarts
+# Überwacht Traefik-Logs auf "I have to go..." Meldungen und identifiziert die Ursache
+- name: Monitor Traefik Restarts
+  hosts: production
+  gather_facts: yes
+  become: no
+
+  vars:
+    monitor_lookback_hours: "{{ monitor_lookback_hours | default(24) }}"
+
+  tasks:
+    - name: Check Traefik logs for "I have to go..." messages
+      ansible.builtin.shell: |
+        cd /home/deploy/deployment/stacks/traefik
+        docker compose logs traefik --since {{ monitor_lookback_hours }}h 2>&1 | grep -E "I have to go|Stopping server gracefully" | tail -20 || echo "No stop messages found"
+      register: traefik_stop_messages
+      changed_when: false
+
+    - name: Display Traefik stop messages
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Stop-Meldungen (letzte {{ monitor_lookback_hours }} Stunden):
+          ================================================================================
+          {{ traefik_stop_messages.stdout }}
+          ================================================================================
+
+    - name: Check Traefik container restart count
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "0"
+      register: traefik_restart_count
+      changed_when: false
+
+    - name: Check Traefik container start time
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.State.StartedAt{{ '}}' }}' 2>/dev/null || echo "UNKNOWN"
+      register: traefik_started_at
+      changed_when: false
+
+    - name: Check Docker events for Traefik stops
+      ansible.builtin.shell: |
+        timeout 5 docker events --since {{ monitor_lookback_hours }}h --filter container=traefik --filter event=die --format "{{ '{{' }}.Time{{ '}}' }} {{ '{{' }}.Action{{ '}}' }} {{ '{{' }}.Actor.Attributes.name{{ '}}' }}" 2>/dev/null | tail -20 || echo "No stop events found or docker events not available"
+      register: traefik_stop_events
+      changed_when: false
+
+    - name: Display Traefik stop events
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Stop-Events für Traefik (letzte {{ monitor_lookback_hours }} Stunden):
+          ================================================================================
+          {{ traefik_stop_events.stdout }}
+          ================================================================================
+
+    - name: Check for manual docker compose commands in history
+      ansible.builtin.shell: |
+        history | grep -E "docker.*compose.*traefik.*(restart|stop|down|up)" | tail -10 || echo "No manual docker compose commands found in history"
+      register: manual_commands
+      changed_when: false
+      failed_when: false
+
+    - name: Display manual docker compose commands
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Manuelle Docker Compose Befehle (aus History):
+          ================================================================================
+          {{ manual_commands.stdout }}
+          ================================================================================
+
+    - name: Check systemd docker service status
+      ansible.builtin.shell: |
+        systemctl status docker.service --no-pager -l | head -20 || echo "Could not check docker service status"
+      register: docker_service_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display Docker service status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Docker Service Status:
+          ================================================================================
+          {{ docker_service_status.stdout }}
+          ================================================================================
+
+    - name: Check for system reboots
+      ansible.builtin.shell: |
+        last reboot --since "{{ monitor_lookback_hours }} hours ago" 2>/dev/null | head -5 || echo "No reboots in the last {{ monitor_lookback_hours }} hours"
+      register: reboots
+      changed_when: false
+      failed_when: false
+
+    - name: Display reboot history
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          System Reboots (letzte {{ monitor_lookback_hours }} Stunden):
+          ================================================================================
+          {{ reboots.stdout }}
+          ================================================================================
+
+    - name: Analyze stop message timestamps
+      ansible.builtin.set_fact:
+        stop_timestamps: "{{ traefik_stop_messages.stdout | regex_findall('\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}') }}"
+
+    - name: Count stop messages
+      ansible.builtin.set_fact:
+        stop_count: "{{ stop_timestamps | length | int }}"
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - Traefik Restart Monitoring:
+          ================================================================================
+          
+          Überwachungszeitraum: Letzte {{ monitor_lookback_hours }} Stunden
+          
+          Traefik Status:
+          - Restart Count: {{ traefik_restart_count.stdout }}
+          - Gestartet um: {{ traefik_started_at.stdout }}
+          - Stop-Meldungen gefunden: {{ stop_count | default(0) }}
+          
+          {% if (stop_count | default(0) | int) > 0 %}
+          ⚠️  {{ stop_count }} Stop-Meldungen gefunden:
+          {{ traefik_stop_messages.stdout }}
+          
+          Mögliche Ursachen:
+          {% if reboots.stdout and 'No reboots' not in reboots.stdout %}
+          1. System-Reboots: {{ reboots.stdout }}
+          {% endif %}
+          {% if traefik_stop_events.stdout and 'No stop events' not in traefik_stop_events.stdout %}
+          2. Docker Stop-Events: {{ traefik_stop_events.stdout }}
+          {% endif %}
+          {% if manual_commands.stdout and 'No manual' not in manual_commands.stdout %}
+          3. Manuelle Befehle: {{ manual_commands.stdout }}
+          {% endif %}
+          
+          Nächste Schritte:
+          - Prüfe ob die Stop-Meldungen mit unseren manuellen Restarts übereinstimmen
+          - Prüfe ob System-Reboots die Ursache sind
+          - Prüfe Docker-Service-Logs für automatische Stops
+          {% else %}
+          ✅ Keine Stop-Meldungen in den letzten {{ monitor_lookback_hours }} Stunden
+          Traefik läuft stabil!
+          {% endif %}
+          
+          ================================================================================
diff --git a/deployment/ansible/playbooks/quick-staging-logs-check.yml b/deployment/ansible/playbooks/quick-staging-logs-check.yml
deleted file mode 100644
index 3387c74c..00000000
--- a/deployment/ansible/playbooks/quick-staging-logs-check.yml
+++ /dev/null
@@ -1,28 +0,0 @@
----
-- name: Quick Staging Logs Check
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Quick container status check
-      shell: |
-        echo "=== Method 1: Direct docker ps ==="
-        docker ps --filter "name=staging" || echo "No staging containers found"
-        echo ""
-        echo "=== Method 2: Docker compose ps ==="
-        cd ~/deployment/stacks/staging && docker compose ps 2>&1 || echo "Docker compose failed"
-        echo ""
-        echo "=== Method 3: Direct logs access ==="
-        docker logs staging-app --tail=30 2>&1 | tail -20 || echo "Could not get staging-app logs"
-      args:
-        executable: /bin/bash
-      register: quick_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display results
-      debug:
-        msg: "{{ (quick_check.stdout_lines | default([])) + (quick_check.stderr_lines | default([])) }}"
-      when: quick_check is defined
-      failed_when: false
diff --git a/deployment/ansible/playbooks/recreate-containers-with-env.yml b/deployment/ansible/playbooks/recreate-containers-with-env.yml
new file mode 100644
index 00000000..ae24f60d
--- /dev/null
+++ b/deployment/ansible/playbooks/recreate-containers-with-env.yml
@@ -0,0 +1,17 @@
+---
+# Recreate Containers with Environment Variables
+# Wrapper Playbook for application role containers tasks (recreate-with-env action)
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_container_action: recreate-with-env
+  tasks:
+    - name: Include application containers tasks (recreate-with-env)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: containers
+  tags:
+    - application
+    - containers
+    - recreate
diff --git a/deployment/ansible/playbooks/recreate-traefik.yml b/deployment/ansible/playbooks/recreate-traefik.yml
new file mode 100644
index 00000000..94def778
--- /dev/null
+++ b/deployment/ansible/playbooks/recreate-traefik.yml
@@ -0,0 +1,16 @@
+---
+# Recreate Traefik Container with New Configuration
+# Wrapper Playbook for traefik role restart tasks (with recreate action)
+- hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    traefik_restart_action: recreate
+  tasks:
+    - name: Include traefik restart tasks (recreate)
+      ansible.builtin.include_role:
+        name: traefik
+        tasks_from: restart
+  tags:
+    - traefik
+    - recreate
diff --git a/deployment/ansible/playbooks/register-gitea-runner.yml b/deployment/ansible/playbooks/register-gitea-runner.yml
index e2eb1cb6..243db478 100644
--- a/deployment/ansible/playbooks/register-gitea-runner.yml
+++ b/deployment/ansible/playbooks/register-gitea-runner.yml
@@ -1,142 +1,17 @@
 ---
-- name: Register Gitea Runner with Correct Instance URL
-  hosts: production
+# Register Gitea Runner with Correct Instance URL
+# Wrapper Playbook for gitea role runner tasks (register action)
+- hosts: production
   gather_facts: yes
   become: no
-
   vars:
-    gitea_runner_path: "{{ runner_path | default('/home/deploy/deployment/gitea-runner') }}"
-    gitea_instance_url: "https://git.michaelschiemer.de"
-    runner_registration_token: "{{ runner_registration_token | default('') }}"
-    runner_name: "{{ runner_name | default('dev-runner-01') }}"
-    runner_labels: "{{ runner_labels | default('ubuntu-latest:docker://node:16-bullseye,ubuntu-22.04:docker://node:16-bullseye,php-ci:docker://php-ci:latest') }}"
-    runner_container_name: "gitea-runner"
-
+    gitea_runner_action: register
   tasks:
-    - name: Fail if registration token is not provided
-      fail:
-        msg: "runner_registration_token must be provided via -e 'runner_registration_token=<token>'"
-      when: runner_registration_token | string | trim == ''
-
-    - name: Check if Gitea runner directory exists
-      stat:
-        path: "{{ gitea_runner_path }}"
-      register: runner_dir_exists
-
-    - name: Fail if runner directory does not exist
-      fail:
-        msg: "Gitea runner directory not found at {{ gitea_runner_path }}"
-      when: not runner_dir_exists.stat.exists
-
-    - name: Stop runner container if running
-      shell: |
-        cd {{ gitea_runner_path }}
-        docker compose stop {{ runner_container_name }}
-      register: stop_result
-      changed_when: stop_result.rc == 0
-      failed_when: false
-
-    - name: Backup existing .runner file
-      copy:
-        src: "{{ gitea_runner_path }}/data/.runner"
-        dest: "{{ gitea_runner_path }}/data/.runner.backup.{{ ansible_date_time.epoch }}"
-        remote_src: yes
-      when: runner_file_exists.stat.exists
-      register: runner_file_exists
-      ignore_errors: yes
-
-    - name: Check if .runner file exists
-      stat:
-        path: "{{ gitea_runner_path }}/data/.runner"
-      register: runner_file_exists
-
-    - name: Remove existing .runner file
-      file:
-        path: "{{ gitea_runner_path }}/data/.runner"
-        state: absent
-      when: runner_file_exists.stat.exists
-
-    - name: Update .env file with correct configuration
-      lineinfile:
-        path: "{{ gitea_runner_path }}/.env"
-        regexp: '^{{ item.key }}='
-        line: "{{ item.key }}={{ item.value }}"
-        create: yes
-      loop:
-        - { key: 'GITEA_INSTANCE_URL', value: '{{ gitea_instance_url }}' }
-        - { key: 'GITEA_RUNNER_REGISTRATION_TOKEN', value: '{{ runner_registration_token }}' }
-        - { key: 'GITEA_RUNNER_NAME', value: '{{ runner_name }}' }
-        - { key: 'GITEA_RUNNER_LABELS', value: '{{ runner_labels }}' }
-      no_log: true
-
-    - name: Start runner services
-      shell: |
-        cd {{ gitea_runner_path }}
-        docker compose up -d
-      register: start_services
-      changed_when: start_services.rc == 0
-
-    - name: Wait for services to be ready
-      pause:
-        seconds: 5
-
-    - name: Register runner with correct Gitea instance
-      shell: |
-        cd {{ gitea_runner_path }}
-        docker compose exec -T {{ runner_container_name }} act_runner register \
-          --instance "{{ gitea_instance_url }}" \
-          --token "{{ runner_registration_token }}" \
-          --name "{{ runner_name }}" \
-          --labels "{{ runner_labels }}"
-      register: register_result
-      no_log: true
-      changed_when: register_result.rc == 0
-
-    - name: Display registration result
-      debug:
-        msg: |
-          Runner Registration Result:
-          {{ register_result.stdout | default('No output') }}
-      when: register_result.rc == 0
-
-    - name: Verify .runner file was created
-      stat:
-        path: "{{ gitea_runner_path }}/data/.runner"
-      register: runner_file_created
-
-    - name: Check .runner file for correct instance URL
-      shell: |
-        grep -i "{{ gitea_instance_url }}" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "URL_NOT_FOUND"
-      register: runner_url_check
-      when: runner_file_created.stat.exists
-      changed_when: false
-
-    - name: Check .runner file for GitHub URLs
-      shell: |
-        grep -i "github.com" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "NO_GITHUB_URLS"
-      register: runner_github_check
-      when: runner_file_created.stat.exists
-      changed_when: false
-
-    - name: Display final status
-      debug:
-        msg: |
-          ========================================
-          Gitea Runner Registration Status
-          ========================================
-          Registration: {{ '✅ SUCCESS' if register_result.rc == 0 else '❌ FAILED' }}
-          Runner File Created: {{ '✅ YES' if runner_file_created.stat.exists else '❌ NO' }}
-          Contains Correct URL: {{ '✅ YES' if 'URL_NOT_FOUND' not in runner_url_check.stdout else '❌ NO' }}
-          Contains GitHub URLs: {{ '❌ YES' if 'NO_GITHUB_URLS' not in runner_github_check.stdout else '✅ NO' }}
-          ========================================
-          
-          {% if register_result.rc == 0 and runner_file_created.stat.exists %}
-          ✅ Runner registered successfully with {{ gitea_instance_url }}!
-          
-          Check runner status:
-          {{ gitea_instance_url }}/admin/actions/runners
-          {% else %}
-          ❌ Registration failed. Check logs:
-          docker logs {{ runner_container_name }}
-          {% endif %}
-
+    - name: Include gitea runner tasks (register)
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: runner
+  tags:
+    - gitea
+    - runner
+    - register
diff --git a/deployment/ansible/playbooks/remove-framework-production-stack.yml b/deployment/ansible/playbooks/remove-framework-production-stack.yml
deleted file mode 100644
index 41865b75..00000000
--- a/deployment/ansible/playbooks/remove-framework-production-stack.yml
+++ /dev/null
@@ -1,165 +0,0 @@
----
-- name: Remove framework-production Stack from Production Server
-  hosts: production
-  become: no
-  gather_facts: yes
-
-  vars:
-    stack_name: framework-production
-    stack_path: "~/framework-production"
-
-  tasks:
-    - name: Check if Docker is running
-      systemd:
-        name: docker
-        state: started
-      register: docker_service
-      become: yes
-
-    - name: Fail if Docker is not running
-      fail:
-        msg: "Docker service is not running"
-      when: docker_service.status.ActiveState != 'active'
-
-    - name: Check if framework-production stack directory exists
-      stat:
-        path: "{{ stack_path }}"
-      register: stack_dir
-
-    - name: Check if framework-production containers exist (all states)
-      shell: |
-        docker ps -a --filter "name={{ stack_name }}" --format "{{ '{{' }}.Names{{ '}}' }}"
-      args:
-        executable: /bin/bash
-      register: all_containers
-      changed_when: false
-      failed_when: false
-
-    - name: Display all containers found
-      debug:
-        msg: "Found containers: {{ all_containers.stdout_lines if all_containers.stdout_lines | length > 0 else 'None' }}"
-
-    - name: List all containers to find framework-production related ones
-      shell: |
-        docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Image{{ '}}' }}\t{{ '{{' }}.Status{{ '}}' }}"
-      args:
-        executable: /bin/bash
-      register: all_containers_list
-      changed_when: false
-      failed_when: false
-
-    - name: Display all containers
-      debug:
-        msg: "{{ all_containers_list.stdout_lines }}"
-
-    - name: Check for containers with framework-production in name or image
-      shell: |
-        docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}" | grep -iE "(framework-production|^db$|^php$|^web$)" || echo ""
-      args:
-        executable: /bin/bash
-      register: matching_containers
-      changed_when: false
-      failed_when: false
-
-    - name: Check for containers with framework-production images
-      shell: |
-        docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Image{{ '}}' }}" | grep -i "framework-production" | cut -f1 || echo ""
-      args:
-        executable: /bin/bash
-      register: image_based_containers
-      changed_when: false
-      failed_when: false
-
-    - name: Display found containers
-      debug:
-        msg:
-          - "Containers by name pattern: {{ matching_containers.stdout_lines if matching_containers.stdout_lines | length > 0 else 'None' }}"
-          - "Containers by image: {{ image_based_containers.stdout_lines if image_based_containers.stdout_lines | length > 0 else 'None' }}"
-
-    - name: Stop and remove containers using docker-compose if stack directory exists
-      shell: |
-        cd {{ stack_path }}
-        docker-compose down -v
-      args:
-        executable: /bin/bash
-      when: stack_dir.stat.exists
-      register: compose_down_result
-      changed_when: true
-      ignore_errors: yes
-
-    - name: Stop and remove containers by name pattern and image
-      shell: |
-        REMOVED_CONTAINERS=""
-        
-        # Method 1: Remove containers with framework-production in image name
-        while IFS=$'\t' read -r container image; do
-          if [[ "$image" == *"framework-production"* ]]; then
-            echo "Stopping and removing container '$container' (image: $image)"
-            docker stop "$container" 2>/dev/null || true
-            docker rm "$container" 2>/dev/null || true
-            REMOVED_CONTAINERS="$REMOVED_CONTAINERS $container"
-          fi
-        done < <(docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Image{{ '}}' }}")
-        
-        # Method 2: Remove containers with specific names that match the pattern
-        for container_name in "db" "php" "web"; do
-          # Check if container exists and has framework-production image
-          container_info=$(docker ps -a --filter "name=^${container_name}$" --format "{{ '{{' }}.Names{{ '}}' }}\t{{ '{{' }}.Image{{ '}}' }}" 2>/dev/null || echo "")
-          if [[ -n "$container_info" ]]; then
-            image=$(echo "$container_info" | cut -f2)
-            if [[ "$image" == *"framework-production"* ]] || [[ "$image" == *"mariadb"* ]]; then
-              echo "Stopping and removing container '$container_name' (image: $image)"
-              docker stop "$container_name" 2>/dev/null || true
-              docker rm "$container_name" 2>/dev/null || true
-              REMOVED_CONTAINERS="$REMOVED_CONTAINERS $container_name"
-            fi
-          fi
-        done
-        
-        # Method 3: Remove containers with framework-production in name
-        docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}" | grep -i framework-production | while read container; do
-          if [ ! -z "$container" ]; then
-            echo "Stopping and removing container '$container'"
-            docker stop "$container" 2>/dev/null || true
-            docker rm "$container" 2>/dev/null || true
-            REMOVED_CONTAINERS="$REMOVED_CONTAINERS $container"
-          fi
-        done
-        
-        # Output removed containers
-        if [[ -n "$REMOVED_CONTAINERS" ]]; then
-          echo "Removed containers:$REMOVED_CONTAINERS"
-        else
-          echo "No containers were removed"
-        fi
-      args:
-        executable: /bin/bash
-      register: direct_remove_result
-      changed_when: "'Removed containers' in direct_remove_result.stdout"
-      failed_when: false
-
-    - name: Remove stack directory if it exists
-      file:
-        path: "{{ stack_path }}"
-        state: absent
-      when: stack_dir.stat.exists
-      register: dir_removed
-
-    - name: Verify all framework-production containers are removed
-      shell: |
-        docker ps -a --format "{{ '{{' }}.Names{{ '}}' }}" | grep -i framework-production || echo ""
-      args:
-        executable: /bin/bash
-      register: remaining_containers
-      changed_when: false
-      failed_when: false
-
-    - name: Display removal status
-      debug:
-        msg:
-          - "=== framework-production Stack Removal Complete ==="
-          - "Stack directory removed: {{ 'Yes' if dir_removed.changed else 'No (did not exist)' }}"
-          - "Containers removed: {{ 'Yes' if (compose_down_result.changed or direct_remove_result.changed) else 'No (none found)' }}"
-          - "Remaining containers: {{ remaining_containers.stdout if remaining_containers.stdout else 'None' }}"
-          - ""
-          - "Stack '{{ stack_name }}' has been successfully removed."
diff --git a/deployment/ansible/playbooks/remove-temporary-grafana-ip.yml b/deployment/ansible/playbooks/remove-temporary-grafana-ip.yml
deleted file mode 100644
index 26c815e4..00000000
--- a/deployment/ansible/playbooks/remove-temporary-grafana-ip.yml
+++ /dev/null
@@ -1,119 +0,0 @@
----
-- name: Remove Temporary IP Allowlist from Grafana - Make VPN-Only
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Check recent Grafana access attempts
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Recent Grafana Access (Last 5 attempts) ==="
-        tail -30 logs/access.log | grep grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | head -5
-      args:
-        executable: /bin/bash
-      register: recent_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display recent client IPs
-      debug:
-        msg: "{{ recent_ips.stdout_lines }}"
-
-    - name: Check if any traffic comes from VPN
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -20 logs/access.log | grep grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | while read ip; do
-          if [[ "$ip" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "? Found VPN IP: $ip"
-          else
-            echo "? Found public IP: $ip (not VPN)"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: vpn_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display VPN check
-      debug:
-        msg: "{{ vpn_check.stdout_lines }}"
-
-    - name: Backup middlewares.yml
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        cp middlewares.yml middlewares.yml.backup.before-remove-temp-ip.$(date +%Y%m%d_%H%M%S)
-        echo "Backup created"
-      args:
-        executable: /bin/bash
-
-    - name: Remove temporary IP from grafana-vpn-only middleware
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        sed -i '/89.246.96.244\/32/d' middlewares.yml
-        echo "Temporary IP removed"
-      args:
-        executable: /bin/bash
-
-    - name: Verify middleware configuration
-      shell: |
-        cd ~/deployment/stacks/traefik/dynamic
-        echo "=== Updated grafana-vpn-only Middleware ==="
-        grep -A 6 "grafana-vpn-only:" middlewares.yml
-      args:
-        executable: /bin/bash
-      register: updated_middleware
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display updated middleware
-      debug:
-        msg: "{{ updated_middleware.stdout_lines }}"
-
-    - name: Validate YAML syntax
-      command: python3 -c "import yaml; yaml.safe_load(open('middlewares.yml')); print('YAML valid')"
-      args:
-        chdir: ~/deployment/stacks/traefik/dynamic
-      register: yaml_validation
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display YAML validation
-      debug:
-        msg: "{{ yaml_validation.stdout_lines }}"
-
-    - name: Restart Traefik to apply changes
-      command: docker compose restart traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_restart
-
-    - name: Wait for Traefik to restart
-      pause:
-        seconds: 5
-
-    - name: Verify Traefik status
-      command: docker compose ps traefik
-      args:
-        chdir: ~/deployment/stacks/traefik
-      register: traefik_status
-
-    - name: Display Traefik status
-      debug:
-        msg: "{{ traefik_status.stdout_lines }}"
-
-    - name: Final instructions
-      debug:
-        msg:
-          - "=== TEMPORARY IP REMOVED ==="
-          - "Grafana should now be VPN-only"
-          - ""
-          - "Test:"
-          - "1. With VPN: https://grafana.michaelschiemer.de should work ?"
-          - "2. Without VPN: https://grafana.michaelschiemer.de should give 403 ?"
-          - ""
-          - "If it doesn't work:"
-          - "- Check that VPN routing works (DNS = 10.8.0.1 or use hosts file)"
-          - "- Check Traefik logs: tail -f ~/deployment/stacks/traefik/logs/access.log | grep grafana"
-          - "- Restore backup if needed: cp middlewares.yml.backup.* middlewares.yml"
diff --git a/deployment/ansible/playbooks/restart-gitea-complete.yml b/deployment/ansible/playbooks/restart-gitea-complete.yml
new file mode 100644
index 00000000..5c70bcac
--- /dev/null
+++ b/deployment/ansible/playbooks/restart-gitea-complete.yml
@@ -0,0 +1,95 @@
+---
+# Restart Gitea Complete - Stoppt und startet Gitea neu um alle Konfigurationsänderungen zu übernehmen
+- name: Restart Gitea Complete
+  hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    gitea_url: "https://{{ gitea_domain }}"
+
+  tasks:
+    - name: Check current Gitea environment variables
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose exec -T gitea env | grep -E 'GITEA__database__' | sort || echo "Could not read environment variables"
+      register: gitea_env_before
+      changed_when: false
+      failed_when: false
+
+    - name: Display current environment variables
+      ansible.builtin.debug:
+        msg: |
+          Current Gitea Database Environment Variables:
+          {{ gitea_env_before.stdout }}
+
+    - name: Stop Gitea container completely
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose stop gitea
+      register: gitea_stop
+      changed_when: gitea_stop.rc == 0
+
+    - name: Wait for Gitea to stop
+      ansible.builtin.pause:
+        seconds: 5
+
+    - name: Start Gitea container
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose up -d gitea
+      register: gitea_start
+      changed_when: gitea_start.rc == 0
+
+    - name: Wait for Gitea to be ready
+      ansible.builtin.wait_for:
+        timeout: 60
+        delay: 5
+
+    - name: Check Gitea health after restart
+      ansible.builtin.uri:
+        url: "{{ gitea_url }}/api/healthz"
+        method: GET
+        validate_certs: false
+        timeout: 10
+      register: gitea_health_after
+      changed_when: false
+      failed_when: false
+      retries: 5
+      delay: 5
+
+    - name: Check environment variables after restart
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose exec -T gitea env | grep -E 'GITEA__database__' | sort || echo "Could not read environment variables"
+      register: gitea_env_after
+      changed_when: false
+      failed_when: false
+
+    - name: Display restart results
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA COMPLETE RESTART - RESULTS
+          ================================================================================
+          
+          Gitea Health After Restart:
+          - Status: {{ gitea_health_after.status | default('TIMEOUT') }}
+          {% if gitea_health_after.status | default(0) == 200 %}
+          ✅ Gitea is healthy after restart
+          {% else %}
+          ❌ Gitea health check failed (Status: {{ gitea_health_after.status | default('TIMEOUT') }})
+          {% endif %}
+          
+          Environment Variables After Restart:
+          {{ gitea_env_after.stdout }}
+          
+          {% if 'MAX_OPEN_CONNS' in gitea_env_after.stdout %}
+          ✅ Connection pool settings are present
+          {% else %}
+          ⚠️  Connection pool settings NOT found in environment variables
+          → Check docker-compose.yml configuration
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/restart-gitea-with-cache.yml b/deployment/ansible/playbooks/restart-gitea-with-cache.yml
new file mode 100644
index 00000000..a7acfd36
--- /dev/null
+++ b/deployment/ansible/playbooks/restart-gitea-with-cache.yml
@@ -0,0 +1,57 @@
+---
+# Ansible Playbook: Restart Gitea with Redis Cache Enabled
+# Purpose: Restart Gitea container to apply new cache configuration from docker-compose.yml
+# Usage:
+#   ansible-playbook -i inventory/production.yml playbooks/restart-gitea-with-cache.yml
+
+- name: Restart Gitea with Redis Cache Enabled
+  hosts: production
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    gitea_url: "https://{{ gitea_domain }}"
+
+  tasks:
+    - name: Verify Gitea container exists
+      shell: |
+        docker compose -f {{ gitea_stack_path }}/docker-compose.yml ps gitea | grep -q "gitea"
+      register: gitea_exists
+      changed_when: false
+      failed_when: false
+
+    - name: Fail if Gitea container does not exist
+      fail:
+        msg: "Gitea container does not exist. Please deploy Gitea stack first."
+      when: gitea_exists.rc != 0
+
+    - name: Recreate Gitea container with new cache configuration
+      shell: |
+        cd {{ gitea_stack_path }} && \
+        docker compose up -d --force-recreate gitea
+      register: gitea_recreated
+
+    - name: Wait for Gitea to be ready after restart
+      uri:
+        url: "{{ gitea_url }}/api/healthz"
+        method: GET
+        status_code: [200]
+        validate_certs: false
+        timeout: 10
+      register: gitea_health_after_restart
+      until: gitea_health_after_restart.status == 200
+      retries: 30
+      delay: 5
+      changed_when: false
+
+    - name: Display success message
+      debug:
+        msg: |
+          Gitea has been restarted successfully with Redis cache enabled!
+          
+          Cache configuration:
+          - ENABLED: true
+          - ADAPTER: redis
+          - HOST: redis:6379
+          - DB: 0
+          
+          Gitea should now use Redis for caching, improving performance.
+
diff --git a/deployment/ansible/playbooks/restart-traefik.yml b/deployment/ansible/playbooks/restart-traefik.yml
index 07d97786..fd3cf4ac 100644
--- a/deployment/ansible/playbooks/restart-traefik.yml
+++ b/deployment/ansible/playbooks/restart-traefik.yml
@@ -1,123 +1,14 @@
 ---
-- name: Restart Traefik and Verify Configuration
-  hosts: production
+# Restart Traefik Container
+# Wrapper Playbook for traefik role restart tasks
+- hosts: production
   gather_facts: yes
   become: no
-
-  vars:
-    traefik_stack_path: "{{ stacks_base_path | default('/home/deploy/deployment/stacks') }}/traefik"
-    traefik_container_name: "traefik"
-    traefik_url: "https://traefik.michaelschiemer.de"
-
   tasks:
-    - name: Check if Traefik stack directory exists
-      stat:
-        path: "{{ traefik_stack_path }}"
-      register: traefik_stack_exists
-
-    - name: Fail if Traefik stack directory does not exist
-      fail:
-        msg: "Traefik stack directory not found at {{ traefik_stack_path }}"
-      when: not traefik_stack_exists.stat.exists
-
-    - name: Check Traefik container status before restart
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose ps {{ traefik_container_name }} --format json
-      register: traefik_status_before
-      changed_when: false
-      failed_when: false
-
-    - name: Display Traefik status before restart
-      debug:
-        msg: |
-          ================================================================================
-          Traefik Container Status (Before Restart):
-          {{ traefik_status_before.stdout | default('Container not found or Docker not running') }}
-          ================================================================================
-
-    - name: Restart Traefik container
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose restart {{ traefik_container_name }}
-      register: traefik_restart
-      changed_when: traefik_restart.rc == 0
-
-    - name: Wait for Traefik to be ready
-      wait_for:
-        timeout: 30
-      changed_when: false
-
-    - name: Check Traefik container status after restart
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose ps {{ traefik_container_name }} --format json
-      register: traefik_status_after
-      changed_when: false
-      failed_when: false
-
-    - name: Check Traefik health endpoint (ping endpoint requires auth, use internal check)
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose exec -T {{ traefik_container_name }} traefik healthcheck --ping 2>&1 || echo "HEALTH_CHECK_FAILED"
-      register: traefik_health
-      ignore_errors: yes
-      changed_when: false
-
-    - name: Get Traefik logs (last 50 lines)
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose logs --tail=50 {{ traefik_container_name }}
-      register: traefik_logs
-      changed_when: false
-      failed_when: false
-      ignore_errors: yes
-
-    - name: Check for ACME challenge errors in logs
-      shell: |
-        cd {{ traefik_stack_path }}
-        docker compose logs {{ traefik_container_name }} 2>&1 | grep -i "acme challenge" | tail -10 || echo "No ACME challenge errors found"
-      register: acme_errors
-      changed_when: false
-      failed_when: false
-
-    - name: Display Traefik logs
-      debug:
-        msg: |
-          ================================================================================
-          Traefik Container Logs (last 50 lines):
-          {{ traefik_logs.stdout | default('No logs available') }}
-          ================================================================================
-
-    - name: Display ACME challenge status
-      debug:
-        msg: |
-          ================================
-          ACME Challenge Status:
-          {{ acme_errors.stdout | default('No ACME errors found in recent logs') }}
-          ================================
-
-    - name: Display final status
-      debug:
-        msg: |
-          ========================================
-          ========================================
-          Traefik Restart Summary
-          ========================================
-          Container Status: {% if 'State":"running' in (traefik_status_after.stdout | default('')) %}✅ RUNNING{% else %}❌ NOT RUNNING{% endif %}
-          Health Check: {% if traefik_health.status | default(0) == 200 %}✅ HEALTHY{% else %}❌ UNHEALTHY or TIMEOUT{% endif %}
-          Restart Action: {% if traefik_restart.changed | default(false) %}🔄 Container restarted{% else %}ℹ️ No restart needed{% endif %}
-          ========================================
-          {% if 'State":"running' in (traefik_status_after.stdout | default('')) and traefik_health.status | default(0) == 200 %}
-          ✅ Traefik is running and healthy!
-          
-          Next steps:
-          1. Monitor logs for ACME challenge errors: tail -f {{ traefik_stack_path }}/logs/traefik.log | grep -i acme
-          2. Check certificate status in Traefik dashboard: {{ traefik_url }}
-          3. Wait for next certificate renewal attempt (usually hourly)
-          {% else %}
-          ❌ Traefik is not fully healthy. Check logs for details:
-          docker logs {{ traefik_container_name }}
-          {% endif %}
-          ========================================
-
+    - name: Include traefik restart tasks
+      ansible.builtin.include_role:
+        name: traefik
+        tasks_from: restart
+  tags:
+    - traefik
+    - restart
diff --git a/deployment/ansible/playbooks/setup-gitea-initial-config.yml b/deployment/ansible/playbooks/setup-gitea-initial-config.yml
new file mode 100644
index 00000000..c1381a4a
--- /dev/null
+++ b/deployment/ansible/playbooks/setup-gitea-initial-config.yml
@@ -0,0 +1,14 @@
+---
+# Setup Gitea Initial Configuration
+# Wrapper Playbook for gitea role setup tasks
+- hosts: production
+  gather_facts: yes
+  become: no
+  tasks:
+    - name: Include gitea setup tasks
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: setup
+  tags:
+    - gitea
+    - setup
diff --git a/deployment/ansible/playbooks/setup-gitea-repository.yml b/deployment/ansible/playbooks/setup-gitea-repository.yml
index 19221b82..eec414ce 100644
--- a/deployment/ansible/playbooks/setup-gitea-repository.yml
+++ b/deployment/ansible/playbooks/setup-gitea-repository.yml
@@ -1,254 +1,16 @@
 ---
-# Ansible Playbook: Setup Gitea Repository
-# Purpose: Automatically create repository in Gitea and configure Git remote
-# Usage:
-#   ansible-playbook -i inventory/production.yml playbooks/setup-gitea-repository.yml \
-#     --vault-password-file secrets/.vault_pass \
-#     -e "repo_name=michaelschiemer" \
-#     -e "repo_owner=michael" \
-#     -e "repo_private=false"
-
-- name: Setup Gitea Repository
-  hosts: production
+# Setup Gitea Repository
+# Wrapper Playbook for gitea role repository tasks
+- hosts: production
+  gather_facts: yes
+  become: no
   vars:
     ansible_connection: local
-    gitea_url: "https://{{ gitea_domain | default('git.michaelschiemer.de') }}"
-    gitea_admin_username: "{{ vault_gitea_admin_username | default('admin') }}"
-    gitea_admin_password: "{{ vault_gitea_admin_password | default('') }}"
-
   tasks:
-    - name: Set repository variables from parameters
-      set_fact:
-        repo_name: "{{ repo_name | default('michaelschiemer') }}"
-        repo_owner: "{{ repo_owner | default('michael') }}"
-        repo_private: "{{ repo_private | default(false) | bool }}"
-        repo_description: "{{ repo_description | default('Main application repository') }}"
-        repo_auto_init: "{{ repo_auto_init | default(false) | bool }}"
-        configure_git_remote: "{{ configure_git_remote | default(true) | bool }}"
-        git_repo_path: "{{ git_repo_path | default('/home/michael/dev/michaelschiemer') }}"
-
-    - name: Verify Gitea is accessible
-      uri:
-        url: "{{ gitea_url }}"
-        method: GET
-        status_code: [200, 302, 502]
-        validate_certs: false
-        timeout: 10
-      register: gitea_health
-      failed_when: false
-
-    - name: Debug Gitea health status
-      debug:
-        msg: "Gitea health check returned status: {{ gitea_health.status }}"
-
-    - name: Fail if Gitea is not accessible
-      fail:
-        msg: "Gitea is not accessible at {{ gitea_url }}. Status: {{ gitea_health.status }}. Please check if Gitea is running."
-      when: gitea_health.status not in [200, 302, 502]
-
-    - name: Check if API token exists in vault
-      set_fact:
-        has_vault_token: "{{ vault_git_token is defined and vault_git_token | length > 0 }}"
-      no_log: true
-
-    - name: Get or create Gitea API token
-      uri:
-        url: "{{ gitea_url }}/api/v1/users/{{ gitea_admin_username }}/tokens"
-        method: POST
-        user: "{{ gitea_admin_username }}"
-        password: "{{ gitea_admin_password }}"
-        body_format: json
-        body:
-          name: "ansible-repo-setup-{{ ansible_date_time.epoch }}"
-          scopes:
-            - write:repository
-            - read:repository
-            - admin:repo
-        status_code: [201, 400, 401, 502]
-        validate_certs: false
-        force_basic_auth: yes
-      register: api_token_result
-      failed_when: false
-      when: not has_vault_token
-      no_log: true
-
-    - name: Extract API token from response
-      set_fact:
-        gitea_api_token: "{{ api_token_result.json.sha1 | default('') }}"
-      when: 
-        - not has_vault_token
-        - api_token_result.status == 201
-        - api_token_result.json.sha1 is defined
-      no_log: true
-
-    - name: Use existing API token from vault
-      set_fact:
-        gitea_api_token: "{{ vault_git_token }}"
-      when: has_vault_token
-      no_log: true
-
-    - name: Set flag to use basic auth if token creation failed
-      set_fact:
-        use_basic_auth: "{{ gitea_api_token | default('') | length == 0 }}"
-      no_log: true
-
-    - name: Fail if no authentication method available
-      fail:
-        msg: "Could not create or retrieve Gitea API token, and admin credentials are not available. Please create a token manually or set vault_git_token in vault."
-      when: 
-        - use_basic_auth | bool
-        - gitea_admin_password | default('') | length == 0
-
-    - name: Initialize repo_check variable
-      set_fact:
-        repo_check: {"status": 0}
-      when: repo_check is not defined
-
-    - name: Check if repository already exists (with token)
-      uri:
-        url: "{{ gitea_url }}/api/v1/repos/{{ repo_owner }}/{{ repo_name }}"
-        method: GET
-        headers:
-          Authorization: "token {{ gitea_api_token }}"
-        status_code: [200, 404, 502]
-        validate_certs: false
-        timeout: 10
-      register: repo_check_token
-      when: not use_basic_auth
-      failed_when: false
-
-    - name: Set repo_check from token result
-      set_fact:
-        repo_check: "{{ repo_check_token }}"
-      when: 
-        - not use_basic_auth
-        - repo_check_token is defined
-
-    - name: Check if repository already exists (with basic auth)
-      uri:
-        url: "{{ gitea_url }}/api/v1/repos/{{ repo_owner }}/{{ repo_name }}"
-        method: GET
-        user: "{{ gitea_admin_username }}"
-        password: "{{ gitea_admin_password }}"
-        status_code: [200, 404, 502]
-        validate_certs: false
-        force_basic_auth: yes
-        timeout: 10
-      register: repo_check_basic
-      when: use_basic_auth
-      failed_when: false
-      no_log: true
-
-    - name: Set repo_check from basic auth result
-      set_fact:
-        repo_check: "{{ repo_check_basic }}"
-      when: 
-        - use_basic_auth
-        - repo_check_basic is defined
-
-    - name: Debug repo_check status
-      debug:
-        msg: "Repository check - Status: {{ repo_check.status | default('undefined') }}, use_basic_auth: {{ use_basic_auth | default('undefined') }}"
-
-    - name: Create repository in Gitea (with token)
-      uri:
-        url: "{{ gitea_url }}/api/v1/user/repos"
-        method: POST
-        headers:
-          Authorization: "token {{ gitea_api_token }}"
-          Content-Type: "application/json"
-        body_format: json
-        body:
-          name: "{{ repo_name }}"
-          description: "{{ repo_description }}"
-          private: "{{ repo_private }}"
-          auto_init: "{{ repo_auto_init }}"
-        status_code: [201, 409, 502]
-        validate_certs: false
-        timeout: 10
-      register: repo_create_result
-      when: 
-        - (repo_check.status | default(0)) in [404, 502, 0]
-        - not use_basic_auth
-      failed_when: false
-
-    - name: Create repository in Gitea (with basic auth)
-      uri:
-        url: "{{ gitea_url }}/api/v1/user/repos"
-        method: POST
-        user: "{{ gitea_admin_username }}"
-        password: "{{ gitea_admin_password }}"
-        body_format: json
-        body:
-          name: "{{ repo_name }}"
-          description: "{{ repo_description }}"
-          private: "{{ repo_private }}"
-          auto_init: "{{ repo_auto_init }}"
-        status_code: [201, 409]
-        validate_certs: false
-        force_basic_auth: yes
-        timeout: 10
-      register: repo_create_result
-      when: 
-        - (repo_check.status | default(0)) != 200
-        - use_basic_auth
-      no_log: true
-
-    - name: Display repository creation result
-      debug:
-        msg: "Repository {{ repo_owner }}/{{ repo_name }} already exists or was created successfully"
-      when: repo_check.status | default(0) == 200 or (repo_create_result is defined and repo_create_result.status | default(0) == 201)
-
-    - name: Get repository clone URL
-      set_fact:
-        repo_clone_url: "{{ gitea_url | replace('https://', '') | replace('http://', '') }}/{{ repo_owner }}/{{ repo_name }}.git"
-        repo_https_url: "https://{{ gitea_admin_username }}:{{ gitea_api_token }}@{{ gitea_url | replace('https://', '') | replace('http://', '') }}/{{ repo_owner }}/{{ repo_name }}.git"
-
-    - name: Check if Git repository exists locally
-      stat:
-        path: "{{ git_repo_path }}/.git"
-      register: git_repo_exists
-      when: configure_git_remote | bool
-
-    - name: Configure Git remote (local)
-      command: >
-        git remote set-url origin {{ repo_clone_url }}
-      args:
-        chdir: "{{ git_repo_path }}"
-      register: git_remote_result
-      when: 
-        - configure_git_remote | bool
-        - git_repo_path is defined
-        - git_repo_exists.stat.exists
-      changed_when: git_remote_result.rc == 0
-      failed_when: false
-
-    - name: Add Git remote if it doesn't exist
-      command: >
-        git remote add origin {{ repo_clone_url }}
-      args:
-        chdir: "{{ git_repo_path }}"
-      register: git_remote_add_result
-      when: 
-        - configure_git_remote | bool
-        - git_repo_path is defined
-        - git_repo_exists.stat.exists
-        - git_remote_result.rc != 0
-      changed_when: git_remote_add_result.rc == 0
-      failed_when: false
-
-    - name: Display success message
-      debug:
-        msg:
-          - "✅ Repository created successfully!"
-          - "Repository URL: {{ gitea_url }}/{{ repo_owner }}/{{ repo_name }}"
-          - "Clone URL: {{ repo_clone_url }}"
-          - ""
-          - "Next steps:"
-          - "1. Push your code: git push -u origin staging"
-          - "2. Monitor pipeline: {{ gitea_url }}/{{ repo_owner }}/{{ repo_name }}/actions"
-          - ""
-          - "Note: If you need to push, you may need to authenticate with:"
-          - "   Username: {{ gitea_admin_username }}"
-          - "   Password: (use vault_gitea_admin_password or create a Personal Access Token)"
-
+    - name: Include gitea repository tasks
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: repository
+  tags:
+    - gitea
+    - repository
diff --git a/deployment/ansible/playbooks/setup-infrastructure.yml b/deployment/ansible/playbooks/setup-infrastructure.yml
index 1bd1a533..690ae0fc 100644
--- a/deployment/ansible/playbooks/setup-infrastructure.yml
+++ b/deployment/ansible/playbooks/setup-infrastructure.yml
@@ -7,6 +7,40 @@
   vars:
     # All deployment variables are now defined in group_vars/production.yml
     # Variables can be overridden via -e flag if needed
+    vault_file: "{{ playbook_dir }}/../secrets/production.vault.yml"
+
+  pre_tasks:
+    - name: Verify vault file exists
+      ansible.builtin.stat:
+        path: "{{ vault_file }}"
+      register: vault_stat
+      delegate_to: localhost
+      become: no
+
+    - name: Load encrypted secrets from vault
+      ansible.builtin.include_vars:
+        file: "{{ vault_file }}"
+      when: vault_stat.stat.exists
+      no_log: yes
+      ignore_errors: yes
+      delegate_to: localhost
+      become: no
+
+    - name: Verify vault secrets were loaded
+      ansible.builtin.debug:
+        msg: |
+          Vault secrets loaded:
+          - vault_db_password: {{ 'SET (length: ' + (vault_db_password | default('') | string | length | string) + ')' if (vault_db_password | default('') | string | trim) != '' else 'NOT SET or EMPTY' }}
+          - vault_redis_password: {{ 'SET' if (vault_redis_password | default('') | string | trim) != '' else 'NOT SET' }}
+          - vault_app_key: {{ 'SET' if (vault_app_key | default('') | string | trim) != '' else 'NOT SET' }}
+          - vault_docker_registry_password: {{ 'SET (length: ' + (vault_docker_registry_password | default('') | string | length | string) + ')' if (vault_docker_registry_password | default('') | string | trim) != '' else 'NOT SET or EMPTY' }}
+      when: vault_stat.stat.exists
+      no_log: yes
+
+    - name: Warn if vault file is missing
+      ansible.builtin.debug:
+        msg: "WARNING: Vault file not found at {{ vault_file }}. Some roles may fail if they require vault secrets."
+      when: not vault_stat.stat.exists
 
   tasks:
     - name: Debug - Show variables
@@ -14,18 +48,58 @@
         msg:
           - "stacks_base_path: {{ stacks_base_path | default('NOT SET') }}"
           - "deploy_user_home: {{ deploy_user_home | default('NOT SET') }}"
-      when: false  # Only enable for debugging
+      when: true  # Debugging enabled
 
     - name: Check if deployment stacks directory exists
       stat:
         path: "{{ stacks_base_path }}"
       register: stacks_dir
 
-    - name: Fail if stacks directory doesn't exist
-      fail:
-        msg: "Deployment stacks directory not found at {{ stacks_base_path }}"
+    - name: Create deployment stacks directory if it doesn't exist
+      file:
+        path: "{{ stacks_base_path }}"
+        state: directory
+        mode: '0755'
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
       when: not stacks_dir.stat.exists
 
+    - name: Ensure rsync is installed (required for synchronize)
+      ansible.builtin.apt:
+        name: rsync
+        state: present
+        update_cache: no
+      become: yes
+
+    - name: Sync infrastructure stacks to server
+      synchronize:
+        src: "{{ playbook_dir }}/../../stacks/"
+        dest: "{{ stacks_base_path }}/"
+        delete: no
+        recursive: yes
+        rsync_opts:
+          - "--chmod=D755,F644"
+          - "--exclude=.git"
+          - "--exclude=*.log"
+          - "--exclude=data/"
+          - "--exclude=volumes/"
+          - "--exclude=acme.json"
+          - "--exclude=*.key"
+          - "--exclude=*.pem"
+
+    - name: Ensure executable permissions on PostgreSQL backup scripts
+      file:
+        path: "{{ item }}"
+        mode: '0755'
+      loop:
+        - "{{ stacks_base_path }}/postgresql-production/scripts/backup-entrypoint.sh"
+        - "{{ stacks_base_path }}/postgresql-production/scripts/backup.sh"
+        - "{{ stacks_base_path }}/postgresql-production/scripts/restore.sh"
+        - "{{ stacks_base_path }}/postgresql-staging/scripts/backup-entrypoint.sh"
+        - "{{ stacks_base_path }}/postgresql-staging/scripts/backup.sh"
+        - "{{ stacks_base_path }}/postgresql-staging/scripts/restore.sh"
+      ignore_errors: yes
+
     - name: Ensure system packages are up to date
       include_role:
         name: system
@@ -49,27 +123,27 @@
       import_role:
         name: traefik
 
-    # 2. Deploy PostgreSQL (Database)
-    - name: Deploy PostgreSQL stack
+    # 2. Deploy PostgreSQL Production (Database)
+    - name: Deploy PostgreSQL Production stack
       import_role:
-        name: postgresql
+        name: postgresql-production
 
-    # 3. Deploy Docker Registry (Private Registry)
+    # 3. Deploy Redis (Cache & Session Store)
+    - name: Deploy Redis stack
+      import_role:
+        name: redis
+
+    # 4. Deploy Docker Registry (Private Registry)
     - name: Deploy Docker Registry stack
       import_role:
         name: registry
 
-    # 4. Deploy DNS (CoreDNS for WireGuard clients)
-    - name: Deploy DNS stack
-      import_role:
-        name: dns
-
     # 5. Deploy MinIO (Object Storage)
     - name: Deploy MinIO stack
       import_role:
         name: minio
 
-    # 6. Deploy Gitea (CRITICAL - Git Server + MySQL + Redis)
+    # 6. Deploy Gitea (CRITICAL - Git Server + MySQL)
     - name: Deploy Gitea stack
       import_role:
         name: gitea
@@ -79,6 +153,24 @@
       import_role:
         name: monitoring
 
+    # 8. Deploy Production Stack
+    - name: Deploy Production Stack
+      import_role:
+        name: application
+      vars:
+        application_stack_src: "{{ playbook_dir | default(role_path + '/..') }}/../../stacks/production"
+        application_stack_dest: "{{ app_stack_path | default(stacks_base_path + '/production') }}"
+        application_compose_suffix: "production.yml"
+        application_service_name: "php"
+        application_env_template: "{{ role_path }}/../../templates/application.env.j2"
+        app_env: "production"
+        # Explicitly pass vault variables to the role
+        vault_docker_registry_password: "{{ vault_docker_registry_password | default('') }}"
+        app_domain: "michaelschiemer.de"
+        app_debug: "false"
+        db_name: "{{ db_name_default }}"
+        db_host: "{{ db_host_default }}"
+
     # Verification
     - name: List all running containers
       command: >
@@ -103,8 +195,8 @@
       debug:
         msg: "Gitea HTTPS check: {{ 'SUCCESS' if gitea_http_check.status == 200 else 'FAILED - Status: ' + (gitea_http_check.status|string) }}"
 
-    # 8. Deploy Application Stack
-    - name: Deploy Application Stack
+    # 8. Deploy Production Stack
+    - name: Deploy Production Stack
       import_role:
         name: application
 
@@ -133,14 +225,14 @@
       debug:
         msg:
           - "=== Infrastructure Deployment Complete ==="
-          - "Traefik: {{ 'Deployed' if traefik_stack_changed else 'Already running' }}"
-          - "PostgreSQL: {{ 'Deployed' if postgresql_stack_changed else 'Already running' }}"
-          - "Docker Registry: {{ 'Deployed' if registry_stack_changed else 'Already running' }}"
-          - "DNS: {{ 'Deployed' if dns_stack_changed else 'Already running' }}"
-          - "MinIO: {{ 'Deployed' if minio_stack_changed else 'Already running' }}"
-          - "Gitea: {{ 'Deployed' if gitea_stack_changed else 'Already running' }}"
-          - "Monitoring: {{ 'Deployed' if monitoring_stack_changed else 'Already running' }}"
-          - "Application: {{ 'Deployed' if application_stack_changed else 'Already running' }}"
+          - "Traefik: {{ 'Deployed' if traefik_stack_changed is defined and traefik_stack_changed else 'Already running' }}"
+          - "PostgreSQL: {{ 'Deployed' if postgresql_stack_changed is defined and postgresql_stack_changed else 'Already running' }}"
+          - "Redis: {{ 'Deployed' if redis_stack_changed is defined and redis_stack_changed else 'Already running' }}"
+          - "Docker Registry: {{ 'Deployed' if registry_stack_changed is defined and registry_stack_changed else 'Already running' }}"
+          - "MinIO: {{ 'Deployed' if minio_stack_changed is defined and minio_stack_changed else 'Already running' }}"
+          - "Gitea: {{ 'Deployed' if gitea_stack_changed is defined and gitea_stack_changed else 'Already running' }}"
+          - "Monitoring: {{ 'Deployed' if monitoring_stack_changed is defined and monitoring_stack_changed else 'Already running' }}"
+          - "Application: {{ 'Deployed' if application_stack_changed is defined and application_stack_changed else 'Already running' }}"
           - ""
           - "Next Steps:"
           - "1. Access Gitea at: https://{{ gitea_domain }}"
diff --git a/deployment/ansible/playbooks/setup-ssl-certificates.yml b/deployment/ansible/playbooks/setup-ssl-certificates.yml
index c0894dfd..0f8e4b61 100644
--- a/deployment/ansible/playbooks/setup-ssl-certificates.yml
+++ b/deployment/ansible/playbooks/setup-ssl-certificates.yml
@@ -1,86 +1,19 @@
 ---
-- name: Setup Let's Encrypt SSL Certificates via Traefik
-  hosts: production
-  become: no
+# Setup Let's Encrypt SSL Certificates via Traefik
+# Wrapper Playbook for traefik role ssl tasks
+- hosts: production
   gather_facts: yes
-
+  become: no
   vars:
     # ssl_domains and acme_email are defined in group_vars/production.yml
     # Can be overridden via -e flag if needed
-    domains: "{{ ssl_domains | default([gitea_domain, app_domain]) }}"
-
+    traefik_ssl_domains: "{{ ssl_domains | default([gitea_domain, app_domain]) }}"
   tasks:
-    - name: Check if acme.json exists and is a file
-      stat:
-        path: "{{ deploy_user_home }}/de iployment/stacks/traefik/acme.json"
-      register: acme_stat
-
-    - name: Remove acme.json if it's a directory
-      file:
-        path: "{{ deploy_user_home }}/deployment/stacks/traefik/acme.json"
-        state: absent
-      become: yes
-      when: acme_stat.stat.exists and acme_stat.stat.isdir
-
-    - name: Ensure Traefik acme.json exists and has correct permissions
-      file:
-        path: "{{ deploy_user_home }}/deployment/stacks/traefik/acme.json"
-        state: touch
-        mode: '0600'
-        owner: "{{ ansible_user }}"
-        group: "{{ ansible_user }}"
-      become: yes
-
-    - name: Verify Traefik is running
-      command: docker compose -f {{ deploy_user_home }}/deployment/stacks/traefik/docker-compose.yml ps traefik
-      register: traefik_status
-      changed_when: false
-
-    - name: Fail if Traefik is not running
-      fail:
-        msg: "Traefik is not running. Please start it first."
-      when: traefik_status.rc != 0 or "Up" not in traefik_status.stdout
-
-    - name: Force Traefik to reload configuration
-      command: docker compose -f {{ deploy_user_home }}/deployment/stacks/traefik/docker-compose.yml restart traefik
-      changed_when: true
-
-    - name: Wait for Traefik to be ready
-      wait_for:
-        timeout: 10
-      changed_when: false
-
-    - name: Trigger certificate request by accessing each domain
-      uri:
-        url: "https://{{ item }}"
-        method: GET
-        validate_certs: no
-        timeout: 5
-        status_code: [200, 301, 302, 303, 404, 502, 503]
-      loop: "{{ domains }}"
-      register: certificate_trigger
-      changed_when: false
-      ignore_errors: yes
-
-    - name: Wait for ACME certificate generation (30 seconds)
-      wait_for:
-        timeout: 30
-      changed_when: false
-
-    - name: Check if acme.json contains certificates
-      stat:
-        path: "{{ stacks_base_path }}/traefik/acme.json"
-      register: acme_file
-
-    - name: Display certificate status
-      debug:
-        msg: |
-          Certificate setup triggered.
-          Traefik will request Let's Encrypt certificates for:
-          {{ domains | join(', ') }}
-          ACME Email: {{ acme_email }}
-          
-          Check Traefik logs to see certificate generation progress:
-          docker compose -f {{ stacks_base_path }}/traefik/docker-compose.yml logs traefik | grep -i acme
-          
-          Certificates should be ready within 1-2 minutes.
+    - name: Include traefik ssl tasks
+      ansible.builtin.include_role:
+        name: traefik
+        tasks_from: ssl
+  tags:
+    - traefik
+    - ssl
+    - certificates
diff --git a/deployment/ansible/playbooks/setup-staging.yml b/deployment/ansible/playbooks/setup-staging.yml
new file mode 100644
index 00000000..af779339
--- /dev/null
+++ b/deployment/ansible/playbooks/setup-staging.yml
@@ -0,0 +1,113 @@
+---
+- name: Deploy Staging Infrastructure Stacks on Production Server
+  hosts: production
+  become: no
+  gather_facts: yes
+
+  vars:
+    # All deployment variables are now defined in group_vars/staging.yml
+    # Variables can be overridden via -e flag if needed
+
+  tasks:
+    - name: Debug - Show variables
+      debug:
+        msg:
+          - "stacks_base_path: {{ stacks_base_path | default('NOT SET') }}"
+          - "staging_stack_path: {{ staging_stack_path | default('NOT SET') }}"
+          - "postgresql_staging_stack_path: {{ postgresql_staging_stack_path | default('NOT SET') }}"
+      when: true  # Debugging enabled
+
+    - name: Check if deployment stacks directory exists
+      stat:
+        path: "{{ stacks_base_path }}"
+      register: stacks_dir
+
+    - name: Create deployment stacks directory if it doesn't exist
+      file:
+        path: "{{ stacks_base_path }}"
+        state: directory
+        mode: '0755'
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
+      when: not stacks_dir.stat.exists
+
+    - name: Ensure system packages are up to date
+      include_role:
+        name: system
+      when: system_update_packages | bool
+
+    # Create external networks required by staging stacks
+    - name: Create traefik-public network (shared with production)
+      community.docker.docker_network:
+        name: traefik-public
+        driver: bridge
+        state: present
+
+    - name: Create staging-internal network
+      community.docker.docker_network:
+        name: staging-internal
+        driver: bridge
+        state: present
+
+    - name: Create postgres-staging-internal network
+      community.docker.docker_network:
+        name: postgres-staging-internal
+        driver: bridge
+        state: present
+
+    # 1. Deploy PostgreSQL Staging Stack (separate from production)
+    - name: Deploy PostgreSQL Staging stack
+      import_role:
+        name: postgresql-staging
+
+    # 2. Deploy Staging Application Stack
+    - name: Deploy Staging Application Stack
+      import_role:
+        name: application
+      vars:
+        application_stack_src: "{{ playbook_dir | default(role_path + '/..') }}/../../stacks/staging"
+        application_stack_dest: "{{ staging_stack_path }}"
+        application_compose_suffix: "staging.yml"
+        application_service_name: "staging-app"
+        application_env_template: "{{ role_path }}/../../templates/application.env.j2"
+        app_env: "staging"
+        app_domain: "staging.michaelschiemer.de"
+        app_debug: "true"
+        db_name: "{{ db_name_default }}"
+        db_host: "{{ db_host_default }}"
+
+    # Verification
+    - name: List all running staging containers
+      command: >
+        docker ps --format 'table {{ "{{" }}.Names{{ "}}" }}\t{{ "{{" }}.Status{{ "}}" }}\t{{ "{{" }}.Ports{{ "}}" }}' | grep -E "(staging|postgres-staging)" || echo "No staging containers found"
+      register: staging_docker_ps_output
+
+    - name: Display running staging containers
+      debug:
+        msg: "{{ staging_docker_ps_output.stdout_lines }}"
+
+    - name: Verify Staging accessibility via HTTPS
+      uri:
+        url: "https://staging.michaelschiemer.de"
+        method: GET
+        validate_certs: no
+        status_code: [200, 404, 502, 503]
+        timeout: 10
+      register: staging_http_check
+      ignore_errors: yes
+
+    - name: Display Staging accessibility status
+      debug:
+        msg: "Staging HTTPS check: {{ 'SUCCESS' if staging_http_check.status == 200 else 'FAILED - Status: ' + (staging_http_check.status|string) }}"
+
+    - name: Display staging deployment summary
+      debug:
+        msg:
+          - "=========================================="
+          - "Staging Deployment Summary"
+          - "=========================================="
+          - "PostgreSQL Staging: {{ 'DEPLOYED' if postgresql_staging_stack_changed | default(false) else 'NO CHANGES' }}"
+          - "Staging Application: {{ 'DEPLOYED' if application_stack_changed | default(false) else 'NO CHANGES' }}"
+          - "Staging URL: https://staging.michaelschiemer.de"
+          - "=========================================="
+
diff --git a/deployment/ansible/playbooks/stabilize-traefik.yml b/deployment/ansible/playbooks/stabilize-traefik.yml
new file mode 100644
index 00000000..75ca0f45
--- /dev/null
+++ b/deployment/ansible/playbooks/stabilize-traefik.yml
@@ -0,0 +1,236 @@
+---
+# Stabilize Traefik
+# Stellt sicher, dass Traefik stabil läuft, acme.json korrekt ist und ACME-Challenges durchlaufen
+- name: Stabilize Traefik
+  hosts: production
+  gather_facts: yes
+  become: no
+
+  vars:
+    traefik_stabilize_wait_minutes: "{{ traefik_stabilize_wait_minutes | default(10) }}"
+    traefik_stabilize_check_interval: 60  # Check every 60 seconds
+
+  tasks:
+    - name: Check if Traefik stack directory exists
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}"
+      register: traefik_stack_exists
+
+    - name: Fail if Traefik stack directory does not exist
+      ansible.builtin.fail:
+        msg: "Traefik stack directory not found at {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}"
+      when: not traefik_stack_exists.stat.exists
+
+    - name: Fix acme.json permissions first
+      ansible.builtin.file:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+        state: file
+        mode: '0600'
+        owner: "{{ ansible_user | default('deploy') }}"
+        group: "{{ ansible_user | default('deploy') }}"
+      ignore_errors: yes
+
+    - name: Ensure Traefik container is running
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose up -d traefik
+      register: traefik_start
+      changed_when: traefik_start.rc == 0
+
+    - name: Wait for Traefik to be ready
+      ansible.builtin.wait_for:
+        timeout: 30
+        delay: 2
+      changed_when: false
+
+    - name: Check Traefik container status
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose ps traefik
+      register: traefik_status
+      changed_when: false
+
+    - name: Display Traefik status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Container Status:
+          ================================================================================
+          {{ traefik_status.stdout }}
+          ================================================================================
+
+    - name: Check Traefik health
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose exec -T traefik traefik healthcheck --ping 2>&1 || echo "HEALTH_CHECK_FAILED"
+      register: traefik_health
+      changed_when: false
+      failed_when: false
+
+    - name: Display Traefik health check
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik Health Check:
+          ================================================================================
+          {% if 'HEALTH_CHECK_FAILED' not in traefik_health.stdout %}
+          ✅ Traefik is healthy
+          {% else %}
+          ⚠️  Traefik health check failed: {{ traefik_health.stdout }}
+          {% endif %}
+          ================================================================================
+
+    - name: Verify acme.json permissions
+      ansible.builtin.stat:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+      register: acme_json_stat
+
+    - name: Fix acme.json permissions if needed
+      ansible.builtin.file:
+        path: "{{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}/acme.json"
+        mode: '0600'
+        owner: "{{ ansible_user | default('deploy') }}"
+        group: "{{ ansible_user | default('deploy') }}"
+      when: acme_json_stat.stat.mode | string | regex_replace('^0o?', '') != '0600'
+
+    - name: Display acme.json status
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          acme.json Status:
+          ================================================================================
+          Path: {{ acme_json_stat.stat.path }}
+          Mode: {{ acme_json_stat.stat.mode | string | regex_replace('^0o?', '') }}
+          {% if acme_json_stat.stat.mode | string | regex_replace('^0o?', '') == '0600' %}
+          ✅ acme.json has correct permissions (600)
+          {% else %}
+          ⚠️  acme.json permissions need to be fixed
+          {% endif %}
+          ================================================================================
+
+    - name: Check Port 80/443 configuration
+      ansible.builtin.shell: |
+        echo "=== Port 80 ==="
+        ss -tlnp 2>/dev/null | grep ":80 " || netstat -tlnp 2>/dev/null | grep ":80 " || echo "Could not check port 80"
+        echo ""
+        echo "=== Port 443 ==="
+        ss -tlnp 2>/dev/null | grep ":443 " || netstat -tlnp 2>/dev/null | grep ":443 " || echo "Could not check port 443"
+      register: port_config_check
+      changed_when: false
+
+    - name: Display Port configuration
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Port-Konfiguration (80/443):
+          ================================================================================
+          {{ port_config_check.stdout }}
+          ================================================================================
+
+    - name: Get initial Traefik restart count
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "0"
+      register: initial_restart_count
+      changed_when: false
+
+    - name: Display initial restart count
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Initial Traefik Restart Count: {{ initial_restart_count.stdout }}
+          ================================================================================
+
+    - name: Wait for ACME challenges to complete
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Warte auf ACME-Challenge-Abschluss...
+          ================================================================================
+          Warte {{ traefik_stabilize_wait_minutes }} Minuten und prüfe alle {{ traefik_stabilize_check_interval }} Sekunden
+          ob Traefik stabil läuft und keine Restarts auftreten.
+          ================================================================================
+
+    - name: Monitor Traefik stability
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose ps traefik --format "{{ '{{' }}.State{{ '}}' }}" | head -1 || echo "UNKNOWN"
+      register: traefik_state_check
+      changed_when: false
+      until: traefik_state_check.stdout == "running"
+      retries: "{{ (traefik_stabilize_wait_minutes | int * 60 / traefik_stabilize_check_interval) | int }}"
+      delay: "{{ traefik_stabilize_check_interval }}"
+
+    - name: Get final Traefik restart count
+      ansible.builtin.shell: |
+        docker inspect traefik --format '{{ '{{' }}.RestartCount{{ '}}' }}' 2>/dev/null || echo "0"
+      register: final_restart_count
+      changed_when: false
+
+    - name: Check for Traefik restarts during monitoring
+      ansible.builtin.set_fact:
+        traefik_restarted: "{{ (final_restart_count.stdout | int) > (initial_restart_count.stdout | int) }}"
+
+    - name: Check Traefik logs for ACME errors
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose logs traefik --since {{ traefik_stabilize_wait_minutes }}m 2>&1 | grep -i "acme\|challenge\|certificate" | tail -20 || echo "No ACME-related messages in logs"
+      register: traefik_acme_logs
+      changed_when: false
+
+    - name: Display Traefik ACME logs
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          Traefik ACME Logs (letzte {{ traefik_stabilize_wait_minutes }} Minuten):
+          ================================================================================
+          {{ traefik_acme_logs.stdout }}
+          ================================================================================
+
+    - name: Final status check
+      ansible.builtin.shell: |
+        cd {{ traefik_stack_path | default('/home/deploy/deployment/stacks/traefik') }}
+        docker compose ps traefik || echo "Could not get final status"
+      register: final_status
+      changed_when: false
+
+    - name: Summary
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          ZUSAMMENFASSUNG - Traefik Stabilisierung:
+          ================================================================================
+          
+          Initial Restart Count: {{ initial_restart_count.stdout }}
+          Final Restart Count: {{ final_restart_count.stdout }}
+          
+          {% if traefik_restarted %}
+          ⚠️  WARNUNG: Traefik wurde während der Überwachung neu gestartet!
+          Restart Count erhöht sich von {{ initial_restart_count.stdout }} auf {{ final_restart_count.stdout }}
+          
+          Nächste Schritte:
+          - Führe diagnose-traefik-restarts.yml aus um die Ursache zu finden
+          - Prüfe Docker-Events und Logs für Restart-Gründe
+          {% else %}
+          ✅ Traefik lief stabil während der Überwachung ({{ traefik_stabilize_wait_minutes }} Minuten)
+          Keine Restarts aufgetreten.
+          {% endif %}
+          
+          Final Status: {{ final_status.stdout }}
+          
+          {% if acme_json_stat.stat.mode | string | regex_replace('^0o?', '') == '0600' %}
+          ✅ acme.json hat korrekte Berechtigungen
+          {% else %}
+          ⚠️  acme.json Berechtigungen müssen korrigiert werden
+          {% endif %}
+          
+          Wichtig:
+          - Traefik muss stabil laufen (keine häufigen Restarts)
+          - Port 80/443 müssen auf Traefik zeigen
+          - acme.json muss beschreibbar sein
+          - ACME-Challenges benötigen 5-10 Minuten um abzuschließen
+          
+          Nächste Schritte:
+          - Prüfe Traefik-Logs regelmäßig auf ACME-Fehler
+          - Stelle sicher, dass keine Auto-Restart-Mechanismen aktiv sind
+          - Überwache Traefik für weitere {{ traefik_stabilize_wait_minutes }} Minuten
+          ================================================================================
diff --git a/deployment/ansible/playbooks/sync-and-recreate-containers.yml b/deployment/ansible/playbooks/sync-and-recreate-containers.yml
new file mode 100644
index 00000000..af54495d
--- /dev/null
+++ b/deployment/ansible/playbooks/sync-and-recreate-containers.yml
@@ -0,0 +1,17 @@
+---
+# Sync docker-compose files and recreate containers
+# Wrapper Playbook for application role containers tasks (sync-recreate action)
+- hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    application_container_action: sync-recreate
+  tasks:
+    - name: Include application containers tasks (sync-recreate)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: containers
+  tags:
+    - application
+    - containers
+    - sync
diff --git a/deployment/ansible/playbooks/sync-application-code.yml b/deployment/ansible/playbooks/sync-application-code.yml
new file mode 100644
index 00000000..256ede5a
--- /dev/null
+++ b/deployment/ansible/playbooks/sync-application-code.yml
@@ -0,0 +1,17 @@
+---
+# Synchronize Application Code to Production Server
+# Wrapper Playbook for application role deploy_code tasks (rsync method)
+- hosts: production
+  gather_facts: yes
+  become: no
+  vars:
+    application_deployment_method: rsync
+  tasks:
+    - name: Include application deploy_code tasks (rsync)
+      ansible.builtin.include_role:
+        name: application
+        tasks_from: deploy_code
+  tags:
+    - application
+    - sync
+    - code
diff --git a/deployment/ansible/playbooks/sync-code.yml b/deployment/ansible/playbooks/sync-code.yml
deleted file mode 100644
index af52204b..00000000
--- a/deployment/ansible/playbooks/sync-code.yml
+++ /dev/null
@@ -1,102 +0,0 @@
----
-- name: Sync Code from Git Repository to Application Container
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  vars:
-    # git_repository_url and git_branch are defined in group_vars/production.yml
-    # Can be overridden via -e flag if needed
-    git_repository_url: "{{ git_repo_url | default(git_repository_url_default) }}"
-    git_branch: "{{ git_branch | default(git_branch_default) }}"
-
-  pre_tasks:
-    - name: Optionally load secrets from vault
-      include_vars:
-        file: "{{ playbook_dir }}/../secrets/production.vault.yml"
-      no_log: yes
-      ignore_errors: yes
-      delegate_to: localhost
-      become: no
-
-  tasks:
-    - name: Verify application stack directory exists
-      stat:
-        path: "{{ app_stack_path }}"
-      register: app_stack_dir
-
-    - name: Fail if application stack directory doesn't exist
-      fail:
-        msg: "Application stack directory not found at {{ app_stack_path }}"
-      when: not app_stack_dir.stat.exists
-
-    - name: Check if docker-compose.yml exists
-      stat:
-        path: "{{ app_stack_path }}/docker-compose.yml"
-      register: compose_file_exists
-
-    - name: Fail if docker-compose.yml doesn't exist
-      fail:
-        msg: "docker-compose.yml not found. Run setup-infrastructure.yml first."
-      when: not compose_file_exists.stat.exists
-
-    - name: Read current .env file
-      slurp:
-        src: "{{ app_stack_path }}/.env"
-      register: env_file_content
-      failed_when: false
-      changed_when: false
-
-    - name: Check if Git configuration exists in .env
-      set_fact:
-        has_git_config: "{{ env_file_content.content | b64decode | regex_search('GIT_REPOSITORY_URL=') is not none }}"
-      when: env_file_content.content is defined
-
-    - name: Update .env with Git configuration
-      lineinfile:
-        path: "{{ app_stack_path }}/.env"
-        regexp: "{{ item.regex }}"
-        line: "{{ item.line }}"
-        state: present
-      loop:
-        - { regex: '^GIT_REPOSITORY_URL=', line: 'GIT_REPOSITORY_URL={{ git_repository_url }}' }
-        - { regex: '^GIT_BRANCH=', line: 'GIT_BRANCH={{ git_branch }}' }
-        - { regex: '^GIT_TOKEN=', line: 'GIT_TOKEN={{ git_token | default("") }}' }
-        - { regex: '^GIT_USERNAME=', line: 'GIT_USERNAME={{ git_username | default("") }}' }
-        - { regex: '^GIT_PASSWORD=', line: 'GIT_PASSWORD={{ git_password | default("") }}' }
-      when: not has_git_config | default(true)
-
-    - name: Restart application container to trigger Git pull
-      shell: |
-        cd {{ app_stack_path }}
-        docker compose restart app
-      args:
-        executable: /bin/bash
-      register: container_restart
-
-    - name: Wait for container to be ready
-      wait_for:
-        timeout: 60
-      when: container_restart.changed
-
-    - name: Check container logs for Git operations
-      shell: |
-        cd {{ app_stack_path }}
-        docker compose logs app --tail 50 | grep -E "(Git|Clone|Pull|✅|❌)" || echo "No Git-related logs found"
-      args:
-        executable: /bin/bash
-      register: git_logs
-      changed_when: false
-
-    - name: Display Git sync result
-      debug:
-        msg:
-          - "=== Code Sync Summary ==="
-          - "Repository: {{ git_repository_url }}"
-          - "Branch: {{ git_branch }}"
-          - "Container restarted: {{ 'Yes' if container_restart.changed else 'No' }}"
-          - ""
-          - "Git Logs:"
-          - "{{ git_logs.stdout }}"
-          - ""
-          - "Next: Check application logs to verify code was synced"
diff --git a/deployment/ansible/playbooks/sync-stacks.yml b/deployment/ansible/playbooks/sync-stacks.yml
index 0b924164..3c9abea8 100644
--- a/deployment/ansible/playbooks/sync-stacks.yml
+++ b/deployment/ansible/playbooks/sync-stacks.yml
@@ -5,8 +5,8 @@
   gather_facts: yes
 
   vars:
-    local_stacks_path: "/home/michael/dev/michaelschiemer/deployment/stacks"
-    remote_stacks_path: "~/deployment"
+    local_stacks_path: "{{ playbook_dir }}/../../stacks"
+    remote_stacks_path: "{{ stacks_base_path | default('/home/deploy/deployment/stacks') }}"
 
   tasks:
     - name: Ensure deployment directory exists on production
@@ -14,10 +14,12 @@
         path: "{{ remote_stacks_path }}"
         state: directory
         mode: '0755'
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
 
     - name: Sync stacks directory to production server
       synchronize:
-        src: "{{ local_stacks_path }}"
+        src: "{{ local_stacks_path }}/"
         dest: "{{ remote_stacks_path }}/"
         delete: no
         recursive: yes
@@ -27,20 +29,28 @@
           - "--exclude=*.log"
           - "--exclude=data/"
           - "--exclude=volumes/"
+          - "--exclude=acme.json"
+          - "--exclude=*.key"
+          - "--exclude=*.pem"
+          - "--exclude=app.ini"
+          - "--exclude=app.ini.minimal"
 
     - name: Ensure executable permissions on PostgreSQL backup scripts
       file:
         path: "{{ item }}"
         mode: '0755'
       loop:
-        - "{{ remote_stacks_path }}/stacks/postgresql/scripts/backup-entrypoint.sh"
-        - "{{ remote_stacks_path }}/stacks/postgresql/scripts/backup.sh"
-        - "{{ remote_stacks_path }}/stacks/postgresql/scripts/restore.sh"
+        - "{{ remote_stacks_path }}/postgresql-production/scripts/backup-entrypoint.sh"
+        - "{{ remote_stacks_path }}/postgresql-production/scripts/backup.sh"
+        - "{{ remote_stacks_path }}/postgresql-production/scripts/restore.sh"
+        - "{{ remote_stacks_path }}/postgresql-staging/scripts/backup-entrypoint.sh"
+        - "{{ remote_stacks_path }}/postgresql-staging/scripts/backup.sh"
+        - "{{ remote_stacks_path }}/postgresql-staging/scripts/restore.sh"
       ignore_errors: yes
 
     - name: Verify stacks directory exists on production
       stat:
-        path: "{{ remote_stacks_path }}/stacks"
+        path: "{{ remote_stacks_path }}"
       register: stacks_dir
 
     - name: Display sync results
diff --git a/deployment/ansible/playbooks/tasks/check-health.yml b/deployment/ansible/playbooks/tasks/check-health.yml
deleted file mode 100644
index 920b71d9..00000000
--- a/deployment/ansible/playbooks/tasks/check-health.yml
+++ /dev/null
@@ -1,62 +0,0 @@
----
-# Check Container Health Status
-- name: Check nginx container logs
-  shell: |
-    docker logs nginx --tail 50 2>&1
-  args:
-    executable: /bin/bash
-  register: nginx_logs
-  failed_when: false
-
-- name: Display nginx logs
-  debug:
-    msg: "{{ nginx_logs.stdout_lines }}"
-
-- name: Test nginx health check manually
-  shell: |
-    docker exec nginx wget --spider -q http://localhost/health 2>&1 || echo "Health check failed"
-  args:
-    executable: /bin/bash
-  register: nginx_health_test
-  failed_when: false
-
-- name: Display nginx health check result
-  debug:
-    msg: "{{ nginx_health_test.stdout }}"
-
-- name: Check queue-worker container logs
-  shell: |
-    docker logs queue-worker --tail 50 2>&1
-  args:
-    executable: /bin/bash
-  register: queue_worker_logs
-  failed_when: false
-
-- name: Display queue-worker logs
-  debug:
-    msg: "{{ queue_worker_logs.stdout_lines }}"
-
-- name: Check scheduler container logs
-  shell: |
-    docker logs scheduler --tail 50 2>&1
-  args:
-    executable: /bin/bash
-  register: scheduler_logs
-  failed_when: false
-
-- name: Display scheduler logs
-  debug:
-    msg: "{{ scheduler_logs.stdout_lines }}"
-
-- name: Check container status
-  shell: |
-    cd {{ app_stack_path }}
-    docker compose ps
-  args:
-    executable: /bin/bash
-  register: container_status
-  failed_when: false
-
-- name: Display container status
-  debug:
-    msg: "{{ container_status.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/tasks/diagnose-404.yml b/deployment/ansible/playbooks/tasks/diagnose-404.yml
deleted file mode 100644
index 522ca479..00000000
--- a/deployment/ansible/playbooks/tasks/diagnose-404.yml
+++ /dev/null
@@ -1,73 +0,0 @@
----
-# Diagnose 404 Errors
-- name: Check nginx logs for errors
-  shell: |
-    docker logs nginx --tail 100 2>&1
-  args:
-    executable: /bin/bash
-  register: nginx_logs
-  failed_when: false
-
-- name: Display nginx logs
-  debug:
-    msg: "{{ nginx_logs.stdout_lines }}"
-
-- name: Check app container logs
-  shell: |
-    docker logs app --tail 100 2>&1
-  args:
-    executable: /bin/bash
-  register: app_logs
-  failed_when: false
-
-- name: Display app container logs
-  debug:
-    msg: "{{ app_logs.stdout_lines }}"
-
-- name: Test nginx health endpoint directly
-  shell: |
-    docker exec nginx wget -q -O - http://127.0.0.1/health 2>&1 || echo "Health check failed"
-  args:
-    executable: /bin/bash
-  register: nginx_health_test
-  failed_when: false
-
-- name: Display nginx health check result
-  debug:
-    msg: "{{ nginx_health_test.stdout }}"
-
-- name: Check nginx configuration
-  shell: |
-    docker exec nginx cat /etc/nginx/conf.d/default.conf 2>&1
-  args:
-    executable: /bin/bash
-  register: nginx_config
-  failed_when: false
-
-- name: Display nginx configuration
-  debug:
-    msg: "{{ nginx_config.stdout_lines }}"
-
-- name: Check if app container has files in /var/www/html
-  shell: |
-    docker exec app ls -la /var/www/html/ 2>&1 | head -20
-  args:
-    executable: /bin/bash
-  register: app_files
-  failed_when: false
-
-- name: Display app container files
-  debug:
-    msg: "{{ app_files.stdout_lines }}"
-
-- name: Check container network connectivity
-  shell: |
-    docker exec nginx ping -c 1 app 2>&1 | head -5
-  args:
-    executable: /bin/bash
-  register: network_check
-  failed_when: false
-
-- name: Display network connectivity
-  debug:
-    msg: "{{ network_check.stdout }}"
diff --git a/deployment/ansible/playbooks/tasks/fix-health-checks.yml b/deployment/ansible/playbooks/tasks/fix-health-checks.yml
deleted file mode 100644
index 5f3872b7..00000000
--- a/deployment/ansible/playbooks/tasks/fix-health-checks.yml
+++ /dev/null
@@ -1,71 +0,0 @@
----
-# Fix Container Health Checks
-- name: Check if application stack directory exists
-  stat:
-    path: "{{ app_stack_path }}"
-  register: app_stack_dir
-
-- name: Fail if application stack directory doesn't exist
-  fail:
-    msg: "Application stack directory not found at {{ app_stack_path }}"
-  when: not app_stack_dir.stat.exists
-
-- name: Copy updated docker-compose.yml to production
-  copy:
-    src: "{{ playbook_dir }}/../../stacks/application/docker-compose.yml"
-    dest: "{{ app_stack_path }}/docker-compose.yml"
-    owner: "{{ ansible_user }}"
-    group: "{{ ansible_user }}"
-    mode: '0644'
-  register: compose_updated
-
-- name: Recreate containers with new health checks
-  shell: |
-    cd {{ app_stack_path }}
-    docker compose up -d --force-recreate nginx queue-worker scheduler
-  args:
-    executable: /bin/bash
-  when: compose_updated.changed
-  register: containers_recreated
-
-- name: Wait for containers to be healthy
-  shell: |
-    cd {{ app_stack_path }}
-    timeout=120
-    elapsed=0
-    while [ $elapsed -lt $timeout ]; do
-      healthy=$(docker compose ps --format json | jq -r '[.[] | select(.Name=="nginx" or .Name=="queue-worker" or .Name=="scheduler") | .Health] | all(.=="healthy" or .=="")')
-      if [ "$healthy" = "true" ]; then
-        echo "All containers are healthy"
-        exit 0
-      fi
-      sleep 5
-      elapsed=$((elapsed + 5))
-    done
-    echo "Timeout waiting for containers to become healthy"
-    docker compose ps
-    exit 1
-  args:
-    executable: /bin/bash
-  register: health_wait
-  failed_when: false
-  changed_when: false
-
-- name: Check final container status
-  shell: |
-    cd {{ app_stack_path }}
-    docker compose ps
-  args:
-    executable: /bin/bash
-  register: final_status
-
-- name: Display final container status
-  debug:
-    msg: "{{ final_status.stdout_lines }}"
-
-- name: Display summary
-  debug:
-    msg:
-      - "=== Health Check Fix Complete ==="
-      - "Containers recreated: {{ 'Yes' if containers_recreated.changed else 'No (no changes)' }}"
-      - "Health wait result: {{ 'SUCCESS' if health_wait.rc == 0 else 'TIMEOUT or ERROR - check logs' }}"
diff --git a/deployment/ansible/playbooks/tasks/fix-nginx-404.yml b/deployment/ansible/playbooks/tasks/fix-nginx-404.yml
deleted file mode 100644
index 851e018f..00000000
--- a/deployment/ansible/playbooks/tasks/fix-nginx-404.yml
+++ /dev/null
@@ -1,71 +0,0 @@
----
-# Fix Nginx 404 by setting up shared app-code volume
-- name: Check if application stack directory exists
-  stat:
-    path: "{{ app_stack_path }}"
-  register: app_stack_dir
-
-- name: Fail if application stack directory doesn't exist
-  fail:
-    msg: "Application stack directory not found at {{ app_stack_path }}"
-  when: not app_stack_dir.stat.exists
-
-- name: Copy updated docker-compose.yml to production
-  copy:
-    src: "{{ playbook_dir }}/../../stacks/application/docker-compose.yml"
-    dest: "{{ app_stack_path }}/docker-compose.yml"
-    owner: "{{ ansible_user }}"
-    group: "{{ ansible_user }}"
-    mode: '0644'
-  register: compose_updated
-
-- name: Initialize app-code volume with files from app image
-  shell: |
-    # Stop containers first
-    cd {{ app_stack_path }}
-    docker compose down nginx || true
-    
-    # Create and initialize app-code volume
-    docker volume create app-code || true
-    
-    # Copy files from app image to volume using temporary container
-    docker run --rm \
-      -v app-code:/target \
-      {{ app_image_external }}:latest \
-      sh -c "cp -r /var/www/html/* /target/ 2>/dev/null || true"
-  args:
-    executable: /bin/bash
-  register: volume_init
-  changed_when: true
-  failed_when: false
-
-- name: Start containers
-  shell: |
-    cd {{ app_stack_path }}
-    docker compose up -d
-  args:
-    executable: /bin/bash
-  register: containers_started
-
-- name: Wait for containers to be healthy
-  pause:
-    seconds: 15
-
-- name: Check container status
-  shell: |
-    cd {{ app_stack_path }}
-    docker compose ps
-  args:
-    executable: /bin/bash
-  register: final_status
-
-- name: Display container status
-  debug:
-    msg: "{{ final_status.stdout_lines }}"
-
-- name: Display summary
-  debug:
-    msg:
-      - "=== Nginx 404 Fix Complete ==="
-      - "Volume initialized: {{ 'Yes' if volume_init.changed else 'No' }}"
-      - "Containers restarted: {{ 'Yes' if containers_started.changed else 'No' }}"
diff --git a/deployment/ansible/playbooks/test-fastcgi-directly.yml b/deployment/ansible/playbooks/test-fastcgi-directly.yml
deleted file mode 100644
index 3c685963..00000000
--- a/deployment/ansible/playbooks/test-fastcgi-directly.yml
+++ /dev/null
@@ -1,46 +0,0 @@
----
-- name: Test FastCGI Connection Directly
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Install cgi-fcgi in nginx container and test FastCGI
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Test FastCGI with a simple request ==="
-        # Create a simple test script
-        docker compose exec -T staging-nginx sh -c "echo -e 'REQUEST_METHOD=GET\nSCRIPT_FILENAME=/var/www/html/public/index.php\nSERVER_NAME=test\n' > /tmp/fcgi-test.txt && cat /tmp/fcgi-test.txt" || echo "Could not create test file"
-        echo ""
-        echo "=== Check nginx error log directly ==="
-        docker compose exec -T staging-nginx tail -100 /var/log/nginx/error.log 2>&1 || echo "Error log not found at /var/log/nginx/error.log"
-        echo ""
-        echo "=== Check nginx access log ==="
-        docker compose exec -T staging-nginx tail -50 /var/log/nginx/access.log 2>&1 | tail -20 || echo "Access log not found"
-      args:
-        executable: /bin/bash
-      register: fcgi_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display FastCGI test results
-      debug:
-        msg: "{{ fcgi_test.stdout_lines }}"
-
-    - name: Make a real HTTP request and capture full response
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Make HTTP request from nginx container ==="
-        docker compose exec -T staging-nginx curl -v http://127.0.0.1/ 2>&1 || echo "Request failed"
-        echo ""
-        echo "=== Check what nginx sees ==="
-        docker compose exec -T staging-nginx sh -c "timeout 2 tail -f /var/log/nginx/error.log 2>&1 & sleep 1 && curl -s http://127.0.0.1/ > /dev/null && sleep 1" || echo "Log check failed"
-      args:
-        executable: /bin/bash
-      register: http_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display HTTP test results
-      debug:
-        msg: "{{ http_test.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/test-gitea-after-fix.yml b/deployment/ansible/playbooks/test-gitea-after-fix.yml
new file mode 100644
index 00000000..cad1532b
--- /dev/null
+++ b/deployment/ansible/playbooks/test-gitea-after-fix.yml
@@ -0,0 +1,73 @@
+---
+# Test Gitea After Connection Pool Fix
+- name: Test Gitea After Connection Pool Fix
+  hosts: production
+  gather_facts: no
+  become: no
+  vars:
+    gitea_stack_path: "{{ stacks_base_path }}/gitea"
+    gitea_url: "https://{{ gitea_domain }}"
+
+  tasks:
+    - name: Test Gitea health endpoint
+      ansible.builtin.uri:
+        url: "{{ gitea_url }}/api/healthz"
+        method: GET
+        validate_certs: false
+        timeout: 35
+      register: gitea_test
+      changed_when: false
+
+    - name: Check Gitea logs for connection pool messages
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose logs gitea --tail 100 | grep -iE "timeout.*authentication|connection.*pool|MAX_OPEN_CONNS|database.*pool" | tail -20 || echo "No connection pool messages found"
+      register: gitea_logs_check
+      changed_when: false
+      failed_when: false
+
+    - name: Check Postgres logs for authentication timeouts
+      ansible.builtin.shell: |
+        cd {{ gitea_stack_path }}
+        docker compose logs postgres --tail 50 | grep -iE "timeout.*authentication|authentication.*timeout" | tail -10 || echo "No authentication timeout messages found"
+      register: postgres_logs_check
+      changed_when: false
+      failed_when: false
+
+    - name: Display test results
+      ansible.builtin.debug:
+        msg: |
+          ================================================================================
+          GITEA CONNECTION POOL FIX - TEST RESULTS
+          ================================================================================
+          
+          Health Check Result:
+          - Status: {{ gitea_test.status | default('TIMEOUT') }}
+          - Response Time: {{ gitea_test.elapsed | default('N/A') }}s
+          {% if gitea_test.status | default(0) == 200 %}
+          ✅ Gitea is reachable
+          {% else %}
+          ❌ Gitea returned status {{ gitea_test.status | default('TIMEOUT') }}
+          {% endif %}
+          
+          Gitea Logs (Connection Pool):
+          {{ gitea_logs_check.stdout }}
+          
+          Postgres Logs (Authentication Timeouts):
+          {{ postgres_logs_check.stdout }}
+          
+          ================================================================================
+          INTERPRETATION:
+          ================================================================================
+          
+          {% if 'timeout.*authentication' in gitea_logs_check.stdout | lower or 'timeout.*authentication' in postgres_logs_check.stdout | lower %}
+          ⚠️  Authentication timeout messages still present
+          → Connection pool settings may need further tuning
+          → Consider increasing MAX_OPEN_CONNS or authentication_timeout
+          {% else %}
+          ✅ No authentication timeout messages found
+          → Connection pool fix appears to be working
+          {% endif %}
+          
+          ================================================================================
+
diff --git a/deployment/ansible/playbooks/test-grafana-vpn-access.yml b/deployment/ansible/playbooks/test-grafana-vpn-access.yml
deleted file mode 100644
index d96d7121..00000000
--- a/deployment/ansible/playbooks/test-grafana-vpn-access.yml
+++ /dev/null
@@ -1,99 +0,0 @@
----
-- name: Test Grafana VPN Access - Final Verification
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Clear instruction
-      debug:
-        msg:
-          - "=== WICHTIG ==="
-          - "Bitte f?hre diese Tests auf Windows aus (mit VPN verbunden):"
-          - ""
-          - "1. Pr?fe ob Hosts-Datei korrekt ist:"
-          - "   type C:\\Windows\\System32\\drivers\\etc\\hosts | findstr grafana"
-          - "   Sollte zeigen: 10.8.0.1 grafana.michaelschiemer.de"
-          - ""
-          - "2. Pr?fe ob VPN verbunden ist:"
-          - "   ping 10.8.0.1"
-          - "   Sollte funktionieren (wenn VPN verbunden ist)"
-          - ""
-          - "3. Teste Grafana-Zugriff:"
-          - "   ?ffne https://grafana.michaelschiemer.de im Browser"
-          - ""
-          - "Dann pr?fe ich die Logs..."
-
-    - name: Wait for test
-      pause:
-        seconds: 15
-
-    - name: Check Traefik logs for Grafana access
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Last 10 Grafana Access Attempts ==="
-        tail -200 logs/access.log | grep -i grafana | tail -10 | while read line; do
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | head -1)
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | head -1)
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | head -1)
-          echo "$time | $client | $status"
-        done
-      args:
-        executable: /bin/bash
-      register: recent_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display recent logs
-      debug:
-        msg: "{{ recent_logs.stdout_lines }}"
-
-    - name: Extract unique client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -50 logs/access.log | grep -i grafana | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique client IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Analyze client IPs
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -20 logs/access.log | grep -i grafana | tail -5 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | while read ip; do
-          if [[ -z "$ip" ]]; then
-            continue
-          fi
-          if [[ "$ip" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "? $ip -> VPN IP (10.8.0.0/24) - Traffic kommt ?ber VPN!"
-          elif [[ "$ip" == "89.246.96.244" ]]; then
-            echo "? $ip -> Deine ?ffentliche IP - Traffic kommt NICHT ?ber VPN (Hosts-Datei funktioniert, aber VPN-Routing nicht)"
-          else
-            echo "? $ip -> Unbekannte IP"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: ip_analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display IP analysis
-      debug:
-        msg: "{{ ip_analysis.stdout_lines }}"
-
-    - name: Final recommendations
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN ?"
-          - "? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN ?"
-          - "? Dann m?ssen wir pr?fen warum Hosts-Datei nicht ?ber VPN-Routing funktioniert"
diff --git a/deployment/ansible/playbooks/test-grafana-vpn-final.yml b/deployment/ansible/playbooks/test-grafana-vpn-final.yml
deleted file mode 100644
index f64dd9f5..00000000
--- a/deployment/ansible/playbooks/test-grafana-vpn-final.yml
+++ /dev/null
@@ -1,78 +0,0 @@
----
-- name: Test Grafana VPN Access - Final Check
-  hosts: production
-  gather_facts: no
-  become: no
-
-  tasks:
-    - name: Instructions
-      debug:
-        msg:
-          - "=== FINALER TEST ==="
-          - "AllowedIPs ist korrekt (10.8.0.0/24) ?"
-          - ""
-          - "Bitte f?hre diese Schritte auf Windows aus:"
-          - "1. DNS-Cache leeren: ipconfig /flushdns"
-          - "2. Browser-Cache leeren oder Inkognito-Modus nutzen"
-          - "3. Stelle sicher, dass VPN verbunden ist"
-          - "4. ?ffne: https://grafana.michaelschiemer.de"
-          - "5. Warte 10 Sekunden"
-          - ""
-          - "Dann pr?fe ich die Logs..."
-
-    - name: Wait for access attempt
-      pause:
-        seconds: 20
-
-    - name: Check latest Grafana access
-      shell: |
-        cd ~/deployment/stacks/traefik
-        echo "=== Letzte 10 Grafana-Zugriffe ==="
-        tail -500 logs/access.log | grep -i grafana | tail -10 | while IFS= read -r line; do
-          time=$(echo "$line" | grep -oP '"time":"[^"]*"' | sed 's/"time":"//;s/"//' | cut -d'T' -f2 | cut -d'+' -f1 | cut -d':' -f1-2)
-          client=$(echo "$line" | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//')
-          status=$(echo "$line" | grep -oP '"DownstreamStatus":[0-9]+' | sed 's/"DownstreamStatus"://')
-          if [[ "$client" =~ ^10\.8\.0\.[0-9]+$ ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? VPN-IP (Traffic kommt ?ber VPN!)"
-          elif [[ "$client" == "89.246.96.244" ]]; then
-            echo "$time | ClientHost: $client | Status: $status ? ?ffentliche IP (Traffic kommt NICHT ?ber VPN)"
-          else
-            echo "$time | ClientHost: $client | Status: $status ? Unbekannt"
-          fi
-        done
-      args:
-        executable: /bin/bash
-      register: analysis
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display analysis
-      debug:
-        msg: "{{ analysis.stdout_lines }}"
-
-    - name: Get unique client IPs from last 10 requests
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      args:
-        executable: /bin/bash
-      register: unique_ips
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display unique IPs
-      debug:
-        msg: "{{ unique_ips.stdout_lines }}"
-
-    - name: Final verdict
-      debug:
-        msg:
-          - ""
-          - "=== ERGEBNIS ==="
-          - "Pr?fe die obigen Zeilen:"
-          - ""
-          - "? Wenn ClientHost: 10.8.0.7 ? Traffic kommt ?ber VPN!"
-          - "   ? Dann k?nnen wir die tempor?re IP-Erlaubnis entfernen!"
-          - ""
-          - "? Wenn ClientHost: 89.246.96.244 ? Traffic kommt NICHT ?ber VPN"
-          - "   ? Dann m?ssen wir weitere Debugging-Schritte durchf?hren"
diff --git a/deployment/ansible/playbooks/test-redis-connection-direct.yml b/deployment/ansible/playbooks/test-redis-connection-direct.yml
deleted file mode 100644
index 530152d7..00000000
--- a/deployment/ansible/playbooks/test-redis-connection-direct.yml
+++ /dev/null
@@ -1,121 +0,0 @@
----
-- name: Test Redis Connection Directly with php-redis Extension
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if php-redis extension is loaded
-      shell: |
-        docker exec app php -r "
-          if (extension_loaded('redis')) {
-            echo 'php-redis extension: LOADED' . PHP_EOL;
-            echo 'Redis class available: ' . (class_exists('Redis') ? 'YES' : 'NO') . PHP_EOL;
-          } else {
-            echo 'php-redis extension: NOT LOADED' . PHP_EOL;
-          }
-        "
-      args:
-        executable: /bin/bash
-      register: extension_check
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display extension check
-      debug:
-        msg: "{{ extension_check.stdout_lines }}"
-
-    - name: Test Redis connection with actual php-redis
-      shell: |
-        docker exec app php -r "
-          // Get environment variables
-          \$redis_host = getenv('REDIS_HOST') ?: 'redis';
-          \$redis_port = (int)(getenv('REDIS_PORT') ?: 6379);
-          \$redis_password = getenv('REDIS_PASSWORD');
-          
-          echo '=== Redis Connection Test ===' . PHP_EOL;
-          echo 'REDIS_HOST: ' . \$redis_host . PHP_EOL;
-          echo 'REDIS_PORT: ' . \$redis_port . PHP_EOL;
-          echo 'REDIS_PASSWORD: ' . (\$redis_password ? 'SET (length: ' . strlen(\$redis_password) . ')' : 'NOT SET') . PHP_EOL;
-          echo PHP_EOL;
-          
-          if (!extension_loaded('redis')) {
-            echo 'ERROR: php-redis extension is not loaded!' . PHP_EOL;
-            exit(1);
-          }
-          
-          if (!class_exists('Redis')) {
-            echo 'ERROR: Redis class is not available!' . PHP_EOL;
-            exit(1);
-          }
-          
-          try {
-            \$redis = new Redis();
-            echo 'Created Redis instance' . PHP_EOL;
-            
-            // Connect
-            \$success = \$redis->connect(\$redis_host, \$redis_port, 2.0);
-            if (!\$success) {
-              echo 'ERROR: Failed to connect to Redis server' . PHP_EOL;
-              exit(1);
-            }
-            echo 'Connected to Redis server' . PHP_EOL;
-            
-            // Authenticate if password is provided
-            if (\$redis_password) {
-              \$auth_result = \$redis->auth(\$redis_password);
-              if (!\$auth_result) {
-                echo 'ERROR: Redis authentication failed' . PHP_EOL;
-                echo 'Password used: ' . substr(\$redis_password, 0, 5) . '...' . PHP_EOL;
-                exit(1);
-              }
-              echo 'Authenticated with Redis' . PHP_EOL;
-            }
-            
-            // Test PING
-            \$ping_result = \$redis->ping();
-            echo 'Redis PING: ' . \$ping_result . PHP_EOL;
-            
-            // Test SET/GET
-            \$test_key = 'test_connection_' . time();
-            \$test_value = 'test_value';
-            \$set_result = \$redis->set(\$test_key, \$test_value);
-            echo 'SET test: ' . (\$set_result ? 'OK' : 'FAILED') . PHP_EOL;
-            
-            \$get_result = \$redis->get(\$test_key);
-            echo 'GET test: ' . (\$get_result === \$test_value ? 'OK' : 'FAILED') . PHP_EOL;
-            
-            // Cleanup
-            \$redis->del(\$test_key);
-            \$redis->close();
-            
-            echo PHP_EOL . '? All tests passed!' . PHP_EOL;
-          } catch (Exception \$e) {
-            echo 'ERROR: ' . \$e->getMessage() . PHP_EOL;
-            echo 'Exception type: ' . get_class(\$e) . PHP_EOL;
-            exit(1);
-          }
-        "
-      args:
-        executable: /bin/bash
-      register: redis_test
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display Redis connection test results
-      debug:
-        msg: "{{ redis_test.stdout_lines }}"
-
-    - name: Check for Redis errors in application logs
-      shell: |
-        cd ~/deployment/stacks/application
-        docker compose logs app --tail=100 2>&1 | grep -i -E "(redis|connection|error)" | tail -20 || echo "No Redis errors found in logs"
-      args:
-        executable: /bin/bash
-      register: error_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display error logs
-      debug:
-        msg: "{{ error_logs.stdout_lines }}"
diff --git a/deployment/ansible/playbooks/test-staging-container-access.yml b/deployment/ansible/playbooks/test-staging-container-access.yml
deleted file mode 100644
index 7d282737..00000000
--- a/deployment/ansible/playbooks/test-staging-container-access.yml
+++ /dev/null
@@ -1,79 +0,0 @@
----
-- name: Test Staging Container Access and Logs
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Check if we can access containers directly
-      shell: |
-        # Try direct docker commands first
-        echo "=== Direct Docker Container Check ==="
-        docker ps -a --filter "name=staging"
-        echo ""
-        echo "=== Try docker logs directly ==="
-        docker logs staging-app --tail=20 2>&1 || echo "Could not access staging-app logs"
-        echo ""
-        echo "=== Try docker logs for staging-nginx ==="
-        docker logs staging-nginx --tail=20 2>&1 || echo "Could not access staging-nginx logs"
-      args:
-        executable: /bin/bash
-      register: direct_access
-      ignore_errors: yes
-
-    - name: Display direct access results
-      debug:
-        msg: "{{ (direct_access.stdout_lines | default([])) + (direct_access.stderr_lines | default([])) }}"
-
-    - name: Try docker compose from different locations
-      shell: |
-        echo "=== Current directory ==="
-        pwd
-        echo ""
-        echo "=== Try from home directory ==="
-        cd ~ && docker compose -f ~/deployment/stacks/staging/docker-compose.yml ps 2>&1 || echo "Failed from home"
-        echo ""
-        echo "=== Try from staging directory ==="
-        cd ~/deployment/stacks/staging && docker compose ps 2>&1 || echo "Failed from staging directory"
-      args:
-        executable: /bin/bash
-      register: compose_check
-      ignore_errors: yes
-
-    - name: Display compose check results
-      debug:
-        msg: "{{ (compose_check.stdout_lines | default([])) + (compose_check.stderr_lines | default([])) }}"
-
-    - name: Check docker compose configuration
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Docker Compose file exists? ==="
-        test -f docker-compose.yml && echo "? docker-compose.yml exists" || echo "? docker-compose.yml missing"
-        echo ""
-        echo "=== Docker Compose file first 30 lines ==="
-        head -30 docker-compose.yml
-        echo ""
-        echo "=== Check service names ==="
-        docker compose config --services 2>&1 || echo "Could not get service names"
-      args:
-        executable: /bin/bash
-      register: compose_config
-      ignore_errors: yes
-
-    - name: Display compose configuration
-      debug:
-        msg: "{{ (compose_config.stdout_lines | default([])) + (compose_config.stderr_lines | default([])) }}"
-
-    - name: Try getting logs with explicit file path
-      shell: |
-        docker compose -f ~/deployment/stacks/stacks/staging/docker-compose.yml logs --tail=20 staging-app 2>&1 || \
-        docker compose -f ~/deployment/stacks/staging/docker-compose.yml logs --tail=20 staging-app 2>&1 || \
-        echo "All methods failed"
-      args:
-        executable: /bin/bash
-      register: explicit_logs
-      ignore_errors: yes
-
-    - name: Display explicit logs attempt
-      debug:
-        msg: "{{ (explicit_logs.stdout_lines | default([])) + (explicit_logs.stderr_lines | default([])) }}"
diff --git a/deployment/ansible/playbooks/update-gitea-config.yml b/deployment/ansible/playbooks/update-gitea-config.yml
index fda77b3a..d357582d 100644
--- a/deployment/ansible/playbooks/update-gitea-config.yml
+++ b/deployment/ansible/playbooks/update-gitea-config.yml
@@ -1,134 +1,14 @@
 ---
-# Ansible Playbook: Update Gitea Configuration
-# Purpose: Update Gitea app.ini configuration to fix performance issues
-# Usage:
-#   ansible-playbook -i inventory/production.yml playbooks/update-gitea-config.yml \
-#     --vault-password-file secrets/.vault_pass
-
-- name: Update Gitea Configuration
-  hosts: production
-  vars:
-    gitea_stack_path: "{{ stacks_base_path }}/gitea"
-    gitea_url: "https://{{ gitea_domain }}"
-    gitea_app_ini_path: "{{ gitea_stack_path }}/app.ini"
-    gitea_app_ini_container_path: "/data/gitea/conf/app.ini"
-
+# Update Gitea Configuration
+# Wrapper Playbook for gitea role config tasks
+- hosts: production
+  gather_facts: yes
+  become: no
   tasks:
-    - name: Verify Gitea container exists
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml ps gitea | grep -q "gitea"
-      register: gitea_exists
-      changed_when: false
-      failed_when: false
-
-    - name: Fail if Gitea container does not exist
-      fail:
-        msg: "Gitea container does not exist. Please deploy Gitea stack first."
-      when: gitea_exists.rc != 0
-
-    - name: Get database configuration from environment
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T gitea env | grep -E "^GITEA__database__" || true
-      register: gitea_db_env
-      changed_when: false
-      failed_when: false
-
-    - name: Parse database configuration
-      set_fact:
-        gitea_db_type: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__DB_TYPE=([^\n]+)', '\\1') or ['postgres']) | first }}"
-        gitea_db_host: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__HOST=([^\n]+)', '\\1') or ['postgres:5432']) | first }}"
-        gitea_db_name: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__NAME=([^\n]+)', '\\1') or ['gitea']) | first }}"
-        gitea_db_user: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__USER=([^\n]+)', '\\1') or ['gitea']) | first }}"
-        gitea_db_passwd: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__PASSWD=([^\n]+)', '\\1') or ['gitea_password']) | first }}"
-
-    - name: Get Gitea server configuration from environment
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T gitea env | grep -E "^GITEA__server__" || true
-      register: gitea_server_env
-      changed_when: false
-      failed_when: false
-
-    - name: Parse server configuration
-      set_fact:
-        gitea_domain_parsed: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__DOMAIN=([^\n]+)', '\\1') or [gitea_domain | default('git.michaelschiemer.de')]) | first }}"
-        ssh_port_parsed: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__SSH_PORT=([^\n]+)', '\\1') or ['2222']) | first }}"
-
-    - name: Set final configuration variables
-      set_fact:
-        gitea_domain: "{{ gitea_domain_parsed }}"
-        ssh_port: "{{ ssh_port_parsed }}"
-        ssh_listen_port: "{{ ssh_port_parsed }}"
-
-    - name: Extract database host and port
-      set_fact:
-        gitea_db_hostname: "{{ gitea_db_host.split(':')[0] }}"
-        gitea_db_port: "{{ (gitea_db_host.split(':')[1]) | default('5432') }}"
-
-    - name: Set Redis password
-      set_fact:
-        redis_password: "{{ vault_gitea_redis_password | default(vault_redis_password | default('gitea_redis_password')) }}"
-
-    - name: Generate app.ini from template
-      template:
-        src: ../templates/gitea-app.ini.j2
-        dest: "{{ gitea_app_ini_path }}"
-        mode: '0644'
-      vars:
-        postgres_db: "{{ gitea_db_name }}"
-        postgres_user: "{{ gitea_db_user }}"
-        postgres_password: "{{ gitea_db_passwd }}"
-        gitea_domain: "{{ gitea_domain }}"
-        ssh_port: "{{ ssh_port }}"
-        ssh_listen_port: "{{ ssh_listen_port }}"
-        disable_registration: true
-        redis_password: "{{ redis_password }}"
-
-    - name: Copy app.ini to Gitea container
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml cp {{ gitea_app_ini_path }} gitea:{{ gitea_app_ini_container_path }}
-      ignore_errors: yes
-
-    - name: Wait for container to be ready for exec
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T gitea true
-      register: container_ready
-      until: container_ready.rc == 0
-      retries: 30
-      delay: 2
-      changed_when: false
-
-    - name: Set correct permissions on app.ini in container
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T --user git gitea chown 1000:1000 {{ gitea_app_ini_container_path }} && \
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T --user git gitea chmod 644 {{ gitea_app_ini_container_path }}
-
-    - name: Restart Gitea container
-      shell: |
-        docker compose -f {{ gitea_stack_path }}/docker-compose.yml restart gitea
-
-    - name: Wait for Gitea to be ready after restart
-      uri:
-        url: "{{ gitea_url }}/api/healthz"
-        method: GET
-        status_code: [200]
-        validate_certs: false
-        timeout: 10
-      register: gitea_health_after_restart
-      until: gitea_health_after_restart.status == 200
-      retries: 30
-      delay: 5
-      changed_when: false
-
-    - name: Display success message
-      debug:
-        msg: |
-          Gitea configuration has been updated successfully!
-          
-          Changes applied:
-          - Redis cache enabled (persistent, survives container restarts)
-          - Redis sessions enabled (better performance and scalability)
-          - Redis queue enabled (persistent job processing)
-          - Database connection pooling configured
-          - Connection limits set to prevent "Connection reset by peer" errors
-          
-          Gitea should now be more stable and perform better with Redis.
+    - name: Include gitea config tasks
+      ansible.builtin.include_role:
+        name: gitea
+        tasks_from: config
+  tags:
+    - gitea
+    - config
diff --git a/deployment/ansible/playbooks/verify-env-loading.yml b/deployment/ansible/playbooks/verify-env-loading.yml
new file mode 100644
index 00000000..0fbc943d
--- /dev/null
+++ b/deployment/ansible/playbooks/verify-env-loading.yml
@@ -0,0 +1,58 @@
+---
+- name: Verify Environment Variable Loading
+  hosts: production
+  gather_facts: no
+  become: no
+
+  vars:
+    application_stack_dest: "{{ app_stack_path | default(stacks_base_path + '/production') }}"
+    application_compose_suffix: "production.yml"
+
+  tasks:
+    - name: Check if docker-compose.production.yml has env_file with absolute path
+      shell: |
+        grep -A 2 "env_file:" {{ application_stack_dest }}/docker-compose.production.yml | head -5
+      delegate_to: "{{ inventory_hostname }}"
+      register: env_file_check
+      changed_when: false
+
+    - name: Display env_file configuration
+      debug:
+        msg: |
+          env_file configuration in docker-compose.production.yml:
+          {{ env_file_check.stdout }}
+
+    - name: Wait for container to be running
+      pause:
+        seconds: 3
+
+    - name: Check all environment variables in queue-worker container
+      shell: |
+        timeout 5 docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} exec -T queue-worker env 2>&1 | grep -E "^DB_|^APP_|^REDIS_" | sort || echo "CONTAINER_NOT_RUNNING"
+      register: all_env_vars
+      changed_when: false
+      failed_when: false
+      ignore_errors: yes
+      retries: 3
+      delay: 2
+
+    - name: Display all environment variables
+      debug:
+        msg: |
+          All DB/APP/REDIS Environment Variables in queue-worker:
+          {{ all_env_vars.stdout }}
+
+    - name: Test if we can read .env file from container
+      shell: |
+        docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} exec -T queue-worker cat /home/deploy/deployment/stacks/production/.env 2>&1 | head -20 || echo "FILE_NOT_READABLE"
+      register: env_file_read_test
+      changed_when: false
+      failed_when: false
+      ignore_errors: yes
+
+    - name: Display .env file read test
+      debug:
+        msg: |
+          .env file read test from container:
+          {{ env_file_read_test.stdout }}
+
diff --git a/deployment/ansible/playbooks/verify-production.yml b/deployment/ansible/playbooks/verify-production.yml
new file mode 100644
index 00000000..71ddeebe
--- /dev/null
+++ b/deployment/ansible/playbooks/verify-production.yml
@@ -0,0 +1,136 @@
+---
+- name: Verify Production Environment
+  hosts: production
+  become: no
+  gather_facts: yes
+
+  vars:
+    # All deployment variables are now defined in group_vars/production.yml
+
+  tasks:
+    - name: Debug - Show variables
+      debug:
+        msg:
+          - "app_stack_path: {{ app_stack_path | default('NOT SET') }}"
+          - "postgresql_production_stack_path: {{ postgresql_production_stack_path | default('NOT SET') }}"
+      when: false  # Disable by default, enable for debugging
+
+    - name: Check if PostgreSQL-Production Stack exists
+      stat:
+        path: "{{ postgresql_production_stack_path }}"
+      register: postgresql_production_stack_dir
+
+    - name: Fail if PostgreSQL-Production Stack doesn't exist
+      fail:
+        msg: "PostgreSQL-Production Stack not found at {{ postgresql_production_stack_path }}"
+      when: not postgresql_production_stack_dir.stat.exists
+
+    - name: Check PostgreSQL-Production container status
+      shell: |
+        docker compose -f {{ postgresql_production_stack_path }}/docker-compose.yml ps postgres-production 2>/dev/null | grep -Eiq "Up|running" || echo "not_running"
+      register: postgresql_production_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display PostgreSQL-Production status
+      debug:
+        msg: "PostgreSQL-Production: {{ 'RUNNING' if 'Up' in postgresql_production_status.stdout or 'running' in postgresql_production_status.stdout else 'NOT RUNNING' }}"
+
+    - name: Verify PostgreSQL-Production connection
+      shell: |
+        docker exec postgres-production pg_isready -U postgres -d michaelschiemer 2>/dev/null || echo "not_ready"
+      register: postgresql_production_ready
+      changed_when: false
+      failed_when: false
+      when: "'Up' in postgresql_production_status.stdout or 'running' in postgresql_production_status.stdout"
+
+    - name: Display PostgreSQL-Production connection status
+      debug:
+        msg: "PostgreSQL-Production Connection: {{ 'READY' if 'accepting connections' in postgresql_production_ready.stdout else 'NOT READY' }}"
+      when: postgresql_production_ready is defined
+
+    - name: Check if Production Application Stack exists
+      stat:
+        path: "{{ app_stack_path | default(stacks_base_path + '/production') }}"
+      register: production_stack_dir
+
+    - name: Fail if Production Application Stack doesn't exist
+      fail:
+        msg: "Production Application Stack not found at {{ app_stack_path | default(stacks_base_path + '/production') }}"
+      when: not production_stack_dir.stat.exists
+
+    - name: Check production application container status
+      shell: |
+        docker ps --format "{{ '{{' }}.Names{{ '}}' }}" | grep -E "^(app|php)" | head -1 || echo "not_running"
+      register: production_app_container
+      changed_when: false
+      failed_when: false
+
+    - name: Display production application container status
+      debug:
+        msg: "Production App Container: {{ production_app_container.stdout if production_app_container.stdout != 'not_running' else 'NOT RUNNING' }}"
+
+    - name: Verify Networks
+      shell: |
+        docker network ls --format "{{ '{{' }}.Name{{ '}}' }}" | grep -E "(traefik-public|postgres-production-internal|app-internal)" || echo "networks_missing"
+      register: networks_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display Networks status
+      debug:
+        msg: "{{ networks_status.stdout_lines }}"
+
+    - name: Test Network connectivity from production app to postgres-production
+      shell: |
+        docker exec {{ production_app_container.stdout }} nc -zv postgres-production 5432 2>&1 || echo "connection_failed"
+      register: network_test
+      changed_when: false
+      failed_when: false
+      when: production_app_container.stdout != 'not_running'
+
+    - name: Display Network connectivity status
+      debug:
+        msg: "Network connectivity: {{ 'SUCCESS' if 'succeeded' in network_test.stdout or 'open' in network_test.stdout else 'FAILED' }}"
+      when: network_test is defined
+
+    - name: Basic Health Check
+      uri:
+        url: "https://michaelschiemer.de/health"
+        method: GET
+        validate_certs: no
+        status_code: [200, 404, 502, 503]
+        timeout: 10
+      register: basic_health_check
+      ignore_errors: yes
+
+    - name: Display Basic Health Check status
+      debug:
+        msg: "Basic Health Check: {{ 'SUCCESS' if basic_health_check.status == 200 else 'FAILED - Status: ' + (basic_health_check.status|string) }}"
+
+    - name: Extended Health Check
+      uri:
+        url: "https://michaelschiemer.de/admin/health/api/summary"
+        method: GET
+        validate_certs: no
+        status_code: [200, 404, 502, 503]
+        timeout: 10
+      register: extended_health_check
+      ignore_errors: yes
+
+    - name: Display Extended Health Check status
+      debug:
+        msg: "Extended Health Check: {{ 'SUCCESS' if extended_health_check.status == 200 else 'NOT AVAILABLE' }}"
+      when: extended_health_check.status is defined
+
+    - name: Display verification summary
+      debug:
+        msg:
+          - "=========================================="
+          - "Production Verification Summary"
+          - "=========================================="
+          - "PostgreSQL-Production: {{ 'RUNNING' if 'Up' in postgresql_production_status.stdout or 'running' in postgresql_production_status.stdout else 'NOT RUNNING' }}"
+          - "Production App: {{ production_app_container.stdout if production_app_container.stdout != 'not_running' else 'NOT RUNNING' }}"
+          - "Basic Health Check: {{ 'SUCCESS' if basic_health_check.status == 200 else 'FAILED' }}"
+          - "=========================================="
+
diff --git a/deployment/ansible/playbooks/verify-staging.yml b/deployment/ansible/playbooks/verify-staging.yml
new file mode 100644
index 00000000..5eb76588
--- /dev/null
+++ b/deployment/ansible/playbooks/verify-staging.yml
@@ -0,0 +1,136 @@
+---
+- name: Verify Staging Environment
+  hosts: production
+  become: no
+  gather_facts: yes
+
+  vars:
+    # All deployment variables are now defined in group_vars/staging.yml
+
+  tasks:
+    - name: Debug - Show variables
+      debug:
+        msg:
+          - "staging_stack_path: {{ staging_stack_path | default('NOT SET') }}"
+          - "postgresql_staging_stack_path: {{ postgresql_staging_stack_path | default('NOT SET') }}"
+      when: false  # Disable by default, enable for debugging
+
+    - name: Check if PostgreSQL-Staging Stack exists
+      stat:
+        path: "{{ postgresql_staging_stack_path }}"
+      register: postgresql_staging_stack_dir
+
+    - name: Fail if PostgreSQL-Staging Stack doesn't exist
+      fail:
+        msg: "PostgreSQL-Staging Stack not found at {{ postgresql_staging_stack_path }}"
+      when: not postgresql_staging_stack_dir.stat.exists
+
+    - name: Check PostgreSQL-Staging container status
+      shell: |
+        docker compose -f {{ postgresql_staging_stack_path }}/docker-compose.yml ps postgres-staging 2>/dev/null | grep -Eiq "Up|running" || echo "not_running"
+      register: postgresql_staging_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display PostgreSQL-Staging status
+      debug:
+        msg: "PostgreSQL-Staging: {{ 'RUNNING' if 'Up' in postgresql_staging_status.stdout or 'running' in postgresql_staging_status.stdout else 'NOT RUNNING' }}"
+
+    - name: Verify PostgreSQL-Staging connection
+      shell: |
+        docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging 2>/dev/null || echo "not_ready"
+      register: postgresql_staging_ready
+      changed_when: false
+      failed_when: false
+      when: "'Up' in postgresql_staging_status.stdout or 'running' in postgresql_staging_status.stdout"
+
+    - name: Display PostgreSQL-Staging connection status
+      debug:
+        msg: "PostgreSQL-Staging Connection: {{ 'READY' if 'accepting connections' in postgresql_staging_ready.stdout else 'NOT READY' }}"
+      when: postgresql_staging_ready is defined
+
+    - name: Check if Staging Application Stack exists
+      stat:
+        path: "{{ staging_stack_path }}"
+      register: staging_stack_dir
+
+    - name: Fail if Staging Application Stack doesn't exist
+      fail:
+        msg: "Staging Application Stack not found at {{ staging_stack_path }}"
+      when: not staging_stack_dir.stat.exists
+
+    - name: Check staging-app container status
+      shell: |
+        docker compose -f {{ staging_stack_path }}/docker-compose.base.yml -f {{ staging_stack_path }}/docker-compose.staging.yml ps staging-app 2>/dev/null | grep -Eiq "Up|running" || echo "not_running"
+      register: staging_app_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display staging-app status
+      debug:
+        msg: "staging-app: {{ 'RUNNING' if 'Up' in staging_app_status.stdout or 'running' in staging_app_status.stdout else 'NOT RUNNING' }}"
+
+    - name: Verify Networks
+      shell: |
+        docker network ls --format "{{ '{{' }}.Name{{ '}}' }}" | grep -E "(traefik-public|staging-internal|postgres-staging-internal)" || echo "networks_missing"
+      register: networks_status
+      changed_when: false
+      failed_when: false
+
+    - name: Display Networks status
+      debug:
+        msg: "{{ networks_status.stdout_lines }}"
+
+    - name: Test Network connectivity from staging-app to postgres-staging
+      shell: |
+        docker exec staging-app nc -zv postgres-staging 5432 2>&1 || echo "connection_failed"
+      register: network_test
+      changed_when: false
+      failed_when: false
+      when: "'Up' in staging_app_status.stdout or 'running' in staging_app_status.stdout"
+
+    - name: Display Network connectivity status
+      debug:
+        msg: "Network connectivity: {{ 'SUCCESS' if 'succeeded' in network_test.stdout or 'open' in network_test.stdout else 'FAILED' }}"
+      when: network_test is defined
+
+    - name: Basic Health Check
+      uri:
+        url: "https://staging.michaelschiemer.de/health"
+        method: GET
+        validate_certs: no
+        status_code: [200, 404, 502, 503]
+        timeout: 10
+      register: basic_health_check
+      ignore_errors: yes
+
+    - name: Display Basic Health Check status
+      debug:
+        msg: "Basic Health Check: {{ 'SUCCESS' if basic_health_check.status == 200 else 'FAILED - Status: ' + (basic_health_check.status|string) }}"
+
+    - name: Extended Health Check
+      uri:
+        url: "https://staging.michaelschiemer.de/admin/health/api/summary"
+        method: GET
+        validate_certs: no
+        status_code: [200, 404, 502, 503]
+        timeout: 10
+      register: extended_health_check
+      ignore_errors: yes
+
+    - name: Display Extended Health Check status
+      debug:
+        msg: "Extended Health Check: {{ 'SUCCESS' if extended_health_check.status == 200 else 'NOT AVAILABLE' }}"
+      when: extended_health_check.status is defined
+
+    - name: Display verification summary
+      debug:
+        msg:
+          - "=========================================="
+          - "Staging Verification Summary"
+          - "=========================================="
+          - "PostgreSQL-Staging: {{ 'RUNNING' if 'Up' in postgresql_staging_status.stdout or 'running' in postgresql_staging_status.stdout else 'NOT RUNNING' }}"
+          - "staging-app: {{ 'RUNNING' if 'Up' in staging_app_status.stdout or 'running' in staging_app_status.stdout else 'NOT RUNNING' }}"
+          - "Basic Health Check: {{ 'SUCCESS' if basic_health_check.status == 200 else 'FAILED' }}"
+          - "=========================================="
+
diff --git a/deployment/ansible/playbooks/view-staging-logs-readable.yml b/deployment/ansible/playbooks/view-staging-logs-readable.yml
deleted file mode 100644
index aeed9743..00000000
--- a/deployment/ansible/playbooks/view-staging-logs-readable.yml
+++ /dev/null
@@ -1,44 +0,0 @@
----
-- name: View Staging Logs in Readable Format
-  hosts: production
-  gather_facts: yes
-  become: no
-
-  tasks:
-    - name: Get and format staging-app logs
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Staging App Logs (Last 50 lines, formatted) ==="
-        docker compose logs --tail=200 staging-app 2>&1 | \
-        while IFS= read -r line; do
-          # Try to parse JSON logs and format them nicely
-          if echo "$line" | grep -qE '^{|^\{'; then
-            echo "$line" | python3 -m json.tool 2>/dev/null || echo "$line"
-          else
-            echo "$line"
-          fi
-        done | tail -50
-      args:
-        executable: /bin/bash
-      register: formatted_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display formatted logs
-      debug:
-        msg: "{{ formatted_logs.stdout_lines }}"
-
-    - name: Show simple tail of logs (for quick view)
-      shell: |
-        cd ~/deployment/stacks/staging
-        echo "=== Quick View: Last 30 lines ==="
-        docker compose logs --tail=30 staging-app 2>&1
-      args:
-        executable: /bin/bash
-      register: quick_logs
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Display quick logs
-      debug:
-        msg: "{{ quick_logs.stdout_lines }}"
diff --git a/deployment/ansible/roles/application/defaults/main.yml b/deployment/ansible/roles/application/defaults/main.yml
index aae75db9..8c46cfb2 100644
--- a/deployment/ansible/roles/application/defaults/main.yml
+++ b/deployment/ansible/roles/application/defaults/main.yml
@@ -1,11 +1,15 @@
 ---
-# Source path for application stack files on the control node
-# Use playbook_dir as base, then go to ../stacks/application
+# Source path for production stack files on the control node
+# Use playbook_dir as base, then go to ../stacks/production
 # This assumes playbooks are in deployment/ansible/playbooks
-application_stack_src: "{{ playbook_dir | default(role_path + '/..') }}/../stacks/application"
+# Note: Use ~ for string concatenation in Jinja2 templates
+# Note: Don't use application_stack_src in the default chain to avoid recursion
+application_stack_src: "{{ (playbook_dir | default(role_path + '/..') | dirname | dirname | dirname) ~ '/stacks/production' }}"
 
 # Destination path on the target host (defaults to configured app_stack_path)
-application_stack_dest: "{{ app_stack_path | default(stacks_base_path + '/application') }}"
+# Note: Don't use application_stack_dest in the default chain to avoid recursion
+# Note: Use ~ for string concatenation in Jinja2 templates
+application_stack_dest: "{{ app_stack_path | default((stacks_base_path | default('/home/deploy/deployment/stacks')) ~ '/production') }}"
 
 # Template used to generate the application .env file
 application_env_template: "{{ role_path }}/../../templates/application.env.j2"
@@ -44,3 +48,69 @@ application_compose_suffix: "{{ 'staging.yml' if application_environment == 'sta
 
 # Service names based on environment
 application_service_name: "{{ 'staging-app' if application_environment == 'staging' else 'php' }}"
+application_php_service_name: "{{ application_service_name }}"
+
+# Code Deployment Configuration
+application_code_dest: "/home/deploy/michaelschiemer/current"
+application_deployment_method: "git"  # Options: git, rsync
+application_git_repository_url_default: "https://git.michaelschiemer.de/michael/michaelschiemer.git"
+application_git_branch: "{{ 'staging' if application_environment == 'staging' else 'main' }}"
+application_git_retries: 5
+application_git_retry_delay: 10
+application_rsync_source: "{{ playbook_dir | default('') | dirname | dirname | dirname }}"
+application_rsync_opts:
+  - "--chmod=D755,F644"
+  - "--exclude=.git"
+  - "--exclude=.gitignore"
+  - "--exclude=node_modules"
+  - "--exclude=vendor"
+  - "--exclude=.env"
+  - "--exclude=.env.*"
+  - "--exclude=*.log"
+  - "--exclude=.idea"
+  - "--exclude=.vscode"
+  - "--exclude=.DS_Store"
+  - "--exclude=*.swp"
+  - "--exclude=*.swo"
+  - "--exclude=*~"
+  - "--exclude=.phpunit.result.cache"
+  - "--exclude=coverage"
+  - "--exclude=.phpunit.cache"
+  - "--exclude=public/assets"
+  - "--exclude=storage/logs"
+  - "--exclude=storage/framework/cache"
+  - "--exclude=storage/framework/sessions"
+  - "--exclude=storage/framework/views"
+  - "--exclude=deployment"
+  - "--exclude=docker"
+  - "--exclude=.deployment-archive-*"
+  - "--exclude=docs"
+  - "--exclude=tests"
+application_php_scripts:
+  - worker.php
+  - console.php
+application_critical_files:
+  - worker.php
+  - console.php
+  - composer.json
+
+# Composer Configuration
+application_restart_workers_after_composer: true
+
+# Container Management Configuration
+application_container_action: "fix"  # Options: fix, fix-web, recreate, recreate-with-env, sync-recreate
+application_container_target_services: "queue-worker scheduler"
+application_container_status_services: "queue-worker web scheduler php"
+application_container_stabilize_wait: 5
+
+# Health Check Configuration
+application_health_check_logs_tail: 20
+application_health_check_final: false
+application_show_status: true
+
+# Logs Configuration
+application_logs_tail: 50
+application_logs_check_vendor: true
+application_logs_check_permissions: true
+application_logs_check_files: true
+application_logs_list_files: false
diff --git a/deployment/ansible/roles/application/handlers/main.yml b/deployment/ansible/roles/application/handlers/main.yml
new file mode 100644
index 00000000..3ca98331
--- /dev/null
+++ b/deployment/ansible/roles/application/handlers/main.yml
@@ -0,0 +1,10 @@
+---
+# Handlers for Application Role
+
+- name: restart application workers
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} restart queue-worker scheduler
+  changed_when: true
+  failed_when: false
+
diff --git a/deployment/ansible/roles/application/tasks/composer.yml b/deployment/ansible/roles/application/tasks/composer.yml
new file mode 100644
index 00000000..8871cd85
--- /dev/null
+++ b/deployment/ansible/roles/application/tasks/composer.yml
@@ -0,0 +1,87 @@
+---
+# Install Composer Dependencies in Application Container
+
+- name: Check if composer.json exists
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/composer.json"
+  register: composer_json_exists
+
+- name: Fail if composer.json is missing
+  ansible.builtin.fail:
+    msg: "composer.json not found at {{ application_code_dest }}/composer.json"
+  when: not composer_json_exists.stat.exists
+
+- name: Check if container is running
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} ps {{ application_php_service_name }} --format json
+  register: container_status
+  changed_when: false
+  failed_when: false
+
+- name: Display container status
+  ansible.builtin.debug:
+    msg: "Container status: {{ container_status.stdout }}"
+  when: application_show_status | default(true) | bool
+
+- name: Fail if container is not running
+  ansible.builtin.fail:
+    msg: |
+      Container '{{ application_php_service_name }}' is not running!
+      
+      The container must be started before installing composer dependencies.
+      This is typically done by the 'deploy-image.yml' playbook which should run before this.
+      
+      To start the container manually:
+      cd {{ application_code_dest }}
+      docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} up -d {{ application_php_service_name }}
+      
+      Note: The container requires environment variables (DB_USERNAME, DB_PASSWORD, etc.)
+      which should be set in a .env file or via docker-compose environment configuration.
+  when: container_status.rc != 0 or '"State":"running"' not in container_status.stdout
+
+- name: Install composer dependencies in PHP container
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ application_php_service_name }} composer install --no-dev --optimize-autoloader --no-interaction
+  register: composer_install
+  changed_when: true
+  failed_when: composer_install.rc != 0
+
+- name: Display composer install output
+  ansible.builtin.debug:
+    msg: |
+      Composer Install Output:
+      stdout: {{ composer_install.stdout }}
+      stderr: {{ composer_install.stderr }}
+      rc: {{ composer_install.rc }}
+  when:
+    - composer_install.rc != 0
+    - application_show_status | default(true) | bool
+
+- name: Restart queue-worker and scheduler to pick up vendor directory
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} restart queue-worker scheduler
+  register: restart_workers
+  changed_when: true
+  failed_when: false
+  when: application_restart_workers_after_composer | default(true) | bool
+
+- name: Verify vendor/autoload.php exists
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ application_php_service_name }} test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
+  register: autoload_check
+  changed_when: false
+
+- name: Display autoload verification
+  ansible.builtin.debug:
+    msg: "vendor/autoload.php: {{ autoload_check.stdout.strip() }}"
+  when: application_show_status | default(true) | bool
+
+- name: Fail if autoload.php is missing
+  ansible.builtin.fail:
+    msg: "vendor/autoload.php was not created after composer install"
+  when: "autoload_check.stdout.strip() != 'EXISTS'"
+
diff --git a/deployment/ansible/roles/application/tasks/containers.yml b/deployment/ansible/roles/application/tasks/containers.yml
new file mode 100644
index 00000000..5ed7e5c7
--- /dev/null
+++ b/deployment/ansible/roles/application/tasks/containers.yml
@@ -0,0 +1,86 @@
+---
+# Container Management Tasks (Fix, Recreate, etc.)
+
+- name: Check if vendor directory exists on host
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/vendor"
+  register: vendor_dir_exists
+
+- name: Display vendor directory status
+  ansible.builtin.debug:
+    msg: "vendor directory on host: {{ 'EXISTS' if vendor_dir_exists.stat.exists else 'MISSING' }}"
+  when: application_show_status | default(true) | bool
+
+- name: Install composer dependencies in PHP container (if vendor missing)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ application_php_service_name }} composer install --no-dev --optimize-autoloader --no-interaction
+  register: composer_install
+  changed_when: true
+  failed_when: composer_install.rc != 0
+  when:
+    - application_container_action | default('fix') == 'fix'
+    - not vendor_dir_exists.stat.exists
+
+- name: Verify vendor/autoload.php exists in container
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T {{ application_php_service_name }} test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
+  register: autoload_check
+  changed_when: false
+  when: application_container_action | default('fix') == 'fix'
+
+- name: Display autoload verification
+  ansible.builtin.debug:
+    msg: "vendor/autoload.php in container: {{ autoload_check.stdout.strip() }}"
+  when:
+    - application_container_action | default('fix') == 'fix'
+    - application_show_status | default(true) | bool
+
+- name: Recreate web container with new security settings
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} up -d --force-recreate --no-deps web
+  register: recreate_web
+  changed_when: true
+  when:
+    - application_container_action | default('fix') in ['fix', 'fix-web']
+
+- name: Recreate queue-worker and scheduler containers
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} up -d --force-recreate {{ application_container_target_services | default('queue-worker scheduler') }}
+  register: recreate_containers
+  changed_when: true
+  when:
+    - application_container_action | default('fix') in ['recreate', 'recreate-with-env', 'sync-recreate']
+
+- name: Restart queue-worker and scheduler to pick up vendor directory
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} restart queue-worker scheduler
+  register: restart_workers
+  changed_when: true
+  failed_when: false
+  when:
+    - application_container_action | default('fix') == 'fix'
+    - application_restart_workers_after_composer | default(true) | bool
+
+- name: Wait for containers to stabilize
+  ansible.builtin.pause:
+    seconds: "{{ application_container_stabilize_wait | default(5) }}"
+  when: application_container_action | default('fix') in ['fix', 'recreate', 'recreate-with-env', 'sync-recreate']
+
+- name: Get final container status
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} ps {{ application_container_status_services | default('queue-worker web scheduler php') }}
+  register: final_status
+  changed_when: false
+
+- name: Display final container status
+  ansible.builtin.debug:
+    msg: |
+      {{ final_status.stdout }}
+  when: application_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/application/tasks/deploy.yml b/deployment/ansible/roles/application/tasks/deploy.yml
index dfe314b6..f19e0a8c 100644
--- a/deployment/ansible/roles/application/tasks/deploy.yml
+++ b/deployment/ansible/roles/application/tasks/deploy.yml
@@ -1,12 +1,326 @@
 ---
+- name: Debug all available variables before password determination
+  ansible.builtin.debug:
+    msg: |
+      Available variables for registry password:
+      - docker_registry_password_default defined: {{ docker_registry_password_default is defined }}
+      - vault_docker_registry_password defined: {{ vault_docker_registry_password is defined }}
+      - All vault_* variable names: {{ vars.keys() | select('match', '^vault_.*') | list | join(', ') }}
+  delegate_to: localhost
+  become: no
+
+- name: Check if docker_registry_password_default is set (safe check)
+  ansible.builtin.set_fact:
+    _docker_registry_password_default_set: "{{ 'YES' if (docker_registry_password_default is defined and docker_registry_password_default | string | trim != '') else 'NO' }}"
+  delegate_to: localhost
+  become: no
+  when: docker_registry_password_default is defined
+
+- name: Check if vault_docker_registry_password is set (safe check)
+  ansible.builtin.set_fact:
+    _vault_docker_registry_password_set: "{{ 'YES' if (vault_docker_registry_password is defined and vault_docker_registry_password | string | trim != '') else 'NO' }}"
+  delegate_to: localhost
+  become: no
+  when: vault_docker_registry_password is defined
+
+- name: Debug password status
+  ansible.builtin.debug:
+    msg: |
+      Password status:
+      - docker_registry_password_default: {{ _docker_registry_password_default_set | default('NOT DEFINED') }}
+      - vault_docker_registry_password: {{ _vault_docker_registry_password_set | default('NOT DEFINED') }}
+  delegate_to: localhost
+  become: no
+
+- name: Determine Docker registry password from vault or defaults
+  ansible.builtin.set_fact:
+    registry_password: >-
+      {%- if docker_registry_password_default is defined and docker_registry_password_default | string | trim != '' -%}
+        {{ docker_registry_password_default }}
+      {%- elif vault_docker_registry_password is defined and vault_docker_registry_password | string | trim != '' -%}
+        {{ vault_docker_registry_password }}
+      {%- else -%}
+        {{ '' }}
+      {%- endif -%}
+  no_log: yes
+
+- name: Debug registry password source after determination
+  ansible.builtin.debug:
+    msg: |
+      Registry password determination result:
+      - docker_registry_password_default: {{ 'SET (length: ' + (docker_registry_password_default | default('') | string | length | string) + ')' if (docker_registry_password_default | default('') | string | trim) != '' else 'NOT SET' }}
+      - vault_docker_registry_password defined: {{ vault_docker_registry_password is defined }}
+      - vault_docker_registry_password set: {{ 'YES (length: ' + (vault_docker_registry_password | default('') | string | length | string) + ')' if (vault_docker_registry_password | default('') | string | trim) != '' else 'NO' }}
+      - registry_password set: {{ 'YES (length: ' + (registry_password | default('') | string | length | string) + ')' if (registry_password | default('') | string | trim) != '' else 'NO' }}
+  delegate_to: localhost
+  become: no
+
+- name: Debug vault loading
+  ansible.builtin.debug:
+    msg: |
+      Vault loading status:
+      - Vault file exists: {{ application_vault_stat.stat.exists | default(false) }}
+      - vault_docker_registry_password defined: {{ vault_docker_registry_password is defined }}
+      - vault_docker_registry_password value: {{ 'SET (length: ' + (vault_docker_registry_password | default('') | string | length | string) + ')' if (vault_docker_registry_password | default('') | string | trim) != '' else 'NOT SET or EMPTY' }}
+      - registry_password: {{ 'SET (length: ' + (registry_password | default('') | string | length | string) + ')' if (registry_password | default('') | string | trim) != '' else 'NOT SET or EMPTY' }}
+  when: true
+  no_log: yes
+
+- name: Check if registry is accessible
+  ansible.builtin.uri:
+    url: "http://{{ docker_registry | default('localhost:5000') }}/v2/"
+    method: GET
+    status_code: [200, 401]
+    timeout: 5
+  register: registry_check
+  ignore_errors: yes
+  delegate_to: "{{ inventory_hostname }}"
+  become: no
+
+- name: Debug registry accessibility
+  ansible.builtin.debug:
+    msg: |
+      Registry accessibility check:
+      - Registry URL: http://{{ docker_registry | default('localhost:5000') }}/v2/
+      - Status code: {{ registry_check.status | default('UNKNOWN') }}
+      - Accessible: {{ 'YES' if registry_check.status | default(0) in [200, 401] else 'NO' }}
+      - Note: Status 401 means registry requires authentication (expected)
+  delegate_to: localhost
+  become: no
+
+- name: Login to Docker registry
+  community.docker.docker_login:
+    registry_url: "{{ docker_registry | default('localhost:5000') }}"
+    username: "{{ docker_registry_username_default | default('admin') }}"
+    password: "{{ registry_password }}"
+  when: 
+    - registry_password | string | trim != ''
+    - registry_check.status | default(0) in [200, 401]
+  no_log: yes
+  ignore_errors: yes
+  register: docker_login_result
+
+- name: Warn if Docker registry login failed
+  ansible.builtin.debug:
+    msg: "WARNING: Docker registry login failed or skipped. Images may not be pullable without authentication."
+  when: 
+    - registry_password | string | trim != ''
+    - docker_login_result.failed | default(false)
+
+- name: Debug registry authentication status
+  ansible.builtin.debug:
+    msg: |
+      Registry authentication status:
+      - Registry: {{ docker_registry | default('localhost:5000') }}
+      - Password set: {{ 'YES' if (registry_password | string | trim) != '' else 'NO' }}
+      - Login result: {{ 'SUCCESS' if (docker_login_result.failed | default(true) == false) else 'FAILED or SKIPPED' }}
+      - Username: {{ docker_registry_username_default | default('admin') }}
+  when: true
+
+- name: Fail if registry password is not set
+  ansible.builtin.fail:
+    msg: |
+      Docker registry authentication required but password not set!
+      
+      The registry at {{ docker_registry | default('localhost:5000') }} requires authentication.
+      
+      Please set the password in one of these ways:
+      
+      1. Set in vault file (recommended):
+         ansible-vault edit {{ vault_file | default('inventory/group_vars/production/vault.yml') }}
+         # Add: vault_docker_registry_password: "your-password"
+      
+      2. Pass via extra vars:
+         -e "docker_registry_password_default=your-password"
+      
+      3. Use init-secrets.sh script to generate all passwords:
+         cd deployment/ansible
+         ./scripts/init-secrets.sh
+      
+      Note: The registry password was likely generated when the registry stack was deployed.
+      Check the registry role output or the vault file for the generated password.
+  when:
+    - registry_password | string | trim == ''
+    - docker_registry | default('localhost:5000') == 'localhost:5000'
+
+- name: Check registry htpasswd file to verify password
+  ansible.builtin.shell: |
+    if [ -f "{{ registry_auth_path | default('/home/deploy/deployment/stacks/registry/auth') }}/htpasswd" ]; then
+      cat "{{ registry_auth_path | default('/home/deploy/deployment/stacks/registry/auth') }}/htpasswd"
+    else
+      echo "htpasswd file not found"
+    fi
+  register: registry_htpasswd_check
+  changed_when: false
+  failed_when: false
+  delegate_to: "{{ inventory_hostname }}"
+  become: no
+  when: docker_login_result.failed | default(false)
+
+- name: Debug registry password mismatch
+  ansible.builtin.debug:
+    msg: |
+      Registry authentication failed!
+      
+      Registry: {{ docker_registry | default('localhost:5000') }}
+      Username: {{ docker_registry_username_default | default('admin') }}
+      
+      Possible causes:
+      1. The password in vault does not match the password used during registry deployment
+      2. The registry was deployed with a different password (generated by registry role)
+      3. The username is incorrect
+      
+      To fix:
+      1. Check the registry htpasswd file on the server:
+         cat {{ registry_auth_path | default('/home/deploy/deployment/stacks/registry/auth') }}/htpasswd
+      
+      2. Extract the password from the registry .env file (if available):
+         grep REGISTRY_AUTH {{ registry_stack_path | default('/home/deploy/deployment/stacks/registry') }}/.env
+      
+      3. Update the vault file with the correct password:
+         ansible-vault edit {{ vault_file | default('inventory/group_vars/production/vault.yml') }}
+         # Set: vault_docker_registry_password: "correct-password"
+      
+      4. Or re-deploy the registry stack with the password from vault:
+         ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml --tags registry
+      
+      Registry htpasswd file content:
+      {{ registry_htpasswd_check.stdout | default('NOT FOUND') }}
+  when:
+    - registry_password | string | trim != ''
+    - docker_login_result.failed | default(false)
+
+- name: Fail if registry authentication failed and password was provided
+  ansible.builtin.fail:
+    msg: |
+      Docker registry authentication failed!
+      
+      Registry: {{ docker_registry | default('localhost:5000') }}
+      Username: {{ docker_registry_username_default | default('admin') }}
+      
+      The password in the vault file does not match the password used during registry deployment.
+      Please check the debug output above for instructions on how to fix this.
+  when:
+    - registry_password | string | trim != ''
+    - docker_login_result.failed | default(false)
+
+- name: Force pull latest Docker images before deployment
+  shell: |
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} pull --ignore-pull-failures
+  changed_when: false
+  failed_when: false
+  when: not ansible_check_mode
+
+- name: Verify entrypoint script exists in Docker image (method 1 - file check)
+  shell: |
+    docker run --rm --entrypoint=/bin/sh {{ docker_registry | default('localhost:5000') }}/{{ app_name | default('framework') }}:latest -c "test -f /usr/local/bin/entrypoint.sh && ls -la /usr/local/bin/entrypoint.sh || echo 'FILE_NOT_FOUND'"
+  register: entrypoint_check
+  changed_when: false
+  failed_when: false
+
+- name: Verify entrypoint script exists in Docker image (method 2 - inspect image)
+  shell: |
+    docker image inspect {{ docker_registry | default('localhost:5000') }}/{{ app_name | default('framework') }}:latest --format '{{ "{{" }}.Config.Entrypoint{{ "}}" }}' 2>&1 || echo "INSPECT_FAILED"
+  register: entrypoint_inspect
+  changed_when: false
+  failed_when: false
+
+- name: Verify entrypoint script exists in Docker image (method 3 - extract and check)
+  shell: |
+    CONTAINER_ID=$(docker create {{ docker_registry | default('localhost:5000') }}/{{ app_name | default('framework') }}:latest 2>/dev/null) && \
+    docker cp $CONTAINER_ID:/usr/local/bin/entrypoint.sh /tmp/entrypoint_check.sh 2>&1 && \
+    if [ -f /tmp/entrypoint_check.sh ]; then \
+      echo "FILE_EXISTS"; \
+      ls -la /tmp/entrypoint_check.sh; \
+      head -5 /tmp/entrypoint_check.sh; \
+      rm -f /tmp/entrypoint_check.sh; \
+    else \
+      echo "FILE_NOT_FOUND"; \
+    fi && \
+    docker rm $CONTAINER_ID >/dev/null 2>&1 || true
+  register: entrypoint_extract
+  changed_when: false
+  failed_when: false
+
+- name: Set entrypoint verification message
+  set_fact:
+    entrypoint_verification_msg: |
+      ==========================================
+      Entrypoint Script Verification
+      ==========================================
+      Image: {{ docker_registry | default('localhost:5000') }}/{{ app_name | default('framework') }}:latest
+      
+      Method 1 - File Check:
+      Return Code: {{ entrypoint_check.rc | default('unknown') }}
+      Output: {{ entrypoint_check.stdout | default('No output') }}
+      
+      Method 2 - Image Inspect:
+      Entrypoint Config: {{ entrypoint_inspect.stdout | default('Not available') }}
+      
+      Method 3 - Extract and Check:
+      {{ entrypoint_extract.stdout | default('Check not performed') }}
+      
+      {% if 'FILE_NOT_FOUND' in entrypoint_check.stdout or 'FILE_NOT_FOUND' in entrypoint_extract.stdout %}
+      ⚠️  WARNING: Entrypoint script NOT FOUND in image!
+      
+      This means the Docker image was built without the entrypoint script.
+      Possible causes:
+      1. The entrypoint script was not copied during rsync to build directory
+      2. The Dockerfile COPY command failed silently
+      3. The image needs to be rebuilt with --no-cache
+      
+      Next steps:
+      1. Rebuild the image: ansible-playbook -i inventory/production.yml playbooks/build-initial-image.yml --vault-password-file secrets/.vault_pass -e "build_no_cache=true"
+      2. Check if docker/entrypoint.sh exists on server: ls -la /home/deploy/michaelschiemer/docker/entrypoint.sh
+      3. Manually check image: docker run --rm --entrypoint=/bin/sh localhost:5000/framework:latest -c "ls -la /usr/local/bin/entrypoint.sh"
+      {% elif entrypoint_check.rc == 0 %}
+      ✅ Entrypoint script found in image
+      File details: {{ entrypoint_check.stdout }}
+      {% if '\r' in entrypoint_extract.stdout %}
+      ⚠️  CRITICAL: Entrypoint script has CRLF line endings!
+      The script contains \r characters which will cause "no such file or directory" errors.
+      The script needs to be converted to LF line endings before building the image.
+      {% endif %}
+      {% else %}
+      ⚠️  Could not verify entrypoint script (check may have failed)
+      {% endif %}
+      ==========================================
+
+- name: Display entrypoint script verification result
+  debug:
+    var: entrypoint_verification_msg
+
 - name: Deploy application stack
   community.docker.docker_compose_v2:
     project_src: "{{ application_stack_dest }}"
+    files:
+      - docker-compose.base.yml
+      - "docker-compose.{{ application_compose_suffix }}"
     state: present
     pull: always
     recreate: "{{ application_compose_recreate }}"
     remove_orphans: "{{ application_remove_orphans | bool }}"
   register: application_compose_result
+  failed_when: false
+
+- name: Show PHP container logs if deployment failed
+  shell: |
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs --tail=50 {{ application_service_name }} 2>&1 || true
+  register: application_php_logs
+  changed_when: false
+  when: application_compose_result.failed | default(false)
+
+- name: Display PHP container logs on failure
+  debug:
+    msg: |
+      PHP Container Logs (last 50 lines):
+      {{ application_php_logs.stdout | default('No logs available') }}
+  when: application_compose_result.failed | default(false)
+
+- name: Fail if deployment failed
+  fail:
+    msg: "Application stack deployment failed. Check logs above for details."
+  when: application_compose_result.failed | default(false)
 
 - name: Wait for application container to report Up
   shell: |
@@ -17,6 +331,48 @@
   retries: "{{ ((application_wait_timeout | int) + (application_wait_interval | int) - 1) // (application_wait_interval | int) }}"
   delay: "{{ application_wait_interval | int }}"
   when: application_compose_result.changed
+  failed_when: false
+
+- name: Show container status when container doesn't start
+  shell: |
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} ps {{ application_service_name }}
+  register: application_container_status
+  changed_when: false
+  when: 
+    - application_compose_result.changed
+    - application_app_running.rc != 0
+
+- name: Show PHP container logs when container doesn't start
+  shell: |
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs --tail=100 {{ application_service_name }} 2>&1 || true
+  register: application_php_logs_failed
+  changed_when: false
+  when: 
+    - application_compose_result.changed
+    - application_app_running.rc != 0
+
+- name: Display container status and logs when startup failed
+  debug:
+    msg: |
+      Container Status:
+      {{ application_container_status.stdout | default('Container not found') }}
+      
+      Container Logs (last 100 lines):
+      {{ application_php_logs_failed.stdout | default('No logs available') }}
+  when: 
+    - application_compose_result.changed
+    - application_app_running.rc != 0
+
+- name: Fail if container didn't start
+  fail:
+    msg: |
+      Application container '{{ application_service_name }}' failed to start.
+      Check the logs above for details.
+      You can also check manually with:
+      docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} logs {{ application_service_name }}
+  when: 
+    - application_compose_result.changed
+    - application_app_running.rc != 0
 
 - name: Ensure app container is running before migrations
   shell: |
diff --git a/deployment/ansible/roles/application/tasks/deploy_code.yml b/deployment/ansible/roles/application/tasks/deploy_code.yml
new file mode 100644
index 00000000..f9b410ab
--- /dev/null
+++ b/deployment/ansible/roles/application/tasks/deploy_code.yml
@@ -0,0 +1,236 @@
+---
+# Deploy Application Code via Git or Rsync
+
+- name: Set git_repo_url from provided value or default
+  ansible.builtin.set_fact:
+    git_repo_url: "{{ application_git_repository_url if (application_git_repository_url is defined and application_git_repository_url != '') else application_git_repository_url_default }}"
+
+- name: Determine deployment method
+  ansible.builtin.set_fact:
+    deployment_method: "{{ application_deployment_method | default('git') }}"
+  when: application_deployment_method is not defined
+
+- name: Ensure Git is installed (for Git deployment)
+  ansible.builtin.apt:
+    name: git
+    state: present
+    update_cache: no
+  become: yes
+  when: deployment_method == 'git'
+
+- name: Ensure application code directory exists
+  ansible.builtin.file:
+    path: "{{ application_code_dest }}"
+    state: directory
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0755'
+  become: yes
+
+# Git Deployment Tasks
+- name: Check if repository already exists (Git)
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/.git"
+  register: git_repo_exists
+  when: deployment_method == 'git'
+
+- name: Check if destination directory exists (Git)
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}"
+  register: dest_dir_exists
+  when: deployment_method == 'git'
+
+- name: Remove destination directory if it exists but is not a git repo (Git)
+  ansible.builtin.file:
+    path: "{{ application_code_dest }}"
+    state: absent
+  when:
+    - deployment_method == 'git'
+    - dest_dir_exists.stat.exists
+    - not git_repo_exists.stat.exists
+  become: yes
+
+- name: Clone repository (if not exists) (Git)
+  ansible.builtin.git:
+    repo: "{{ git_repo_url }}"
+    dest: "{{ application_code_dest }}"
+    version: "{{ application_git_branch }}"
+    force: no
+    update: no
+  when:
+    - deployment_method == 'git'
+    - not git_repo_exists.stat.exists
+  environment:
+    GIT_TERMINAL_PROMPT: "0"
+  vars:
+    ansible_become: no
+  register: git_clone_result
+  retries: "{{ application_git_retries | default(5) }}"
+  delay: "{{ application_git_retry_delay | default(10) }}"
+  until: git_clone_result is succeeded
+  ignore_errors: yes
+
+- name: Fail if git clone failed after retries (Git)
+  ansible.builtin.fail:
+    msg: "Failed to clone repository after {{ application_git_retries | default(5) }} retries. Gitea may be unreachable or overloaded. Last error: {{ git_clone_result.msg | default('Unknown error') }}"
+  when:
+    - deployment_method == 'git'
+    - not git_repo_exists.stat.exists
+    - git_clone_result is failed
+
+- name: Check if repository is already on correct branch (Git)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
+    TARGET_BRANCH="{{ application_git_branch | default('main') }}"
+    if [ "$CURRENT_BRANCH" = "$TARGET_BRANCH" ] || [ "$CURRENT_BRANCH" = "HEAD" ]; then
+      echo "ALREADY_ON_BRANCH"
+    else
+      echo "NEEDS_UPDATE"
+    fi
+  register: git_branch_check
+  changed_when: false
+  failed_when: false
+  when:
+    - deployment_method == 'git'
+    - git_repo_exists.stat.exists
+    - application_skip_git_update | default(false) | bool == false
+
+- name: Update repository (if exists and not already on correct branch) (Git)
+  ansible.builtin.git:
+    repo: "{{ git_repo_url }}"
+    dest: "{{ application_code_dest }}"
+    version: "{{ application_git_branch }}"
+    force: yes
+    update: yes
+  when:
+    - deployment_method == 'git'
+    - git_repo_exists.stat.exists
+    - application_skip_git_update | default(false) | bool == false
+    - git_branch_check.stdout | default('NEEDS_UPDATE') == 'NEEDS_UPDATE'
+  environment:
+    GIT_TERMINAL_PROMPT: "0"
+  vars:
+    ansible_become: no
+  register: git_update_result
+  retries: "{{ application_git_retries | default(5) }}"
+  delay: "{{ application_git_retry_delay | default(10) }}"
+  until: git_update_result is succeeded
+  ignore_errors: yes
+
+- name: Skip git update (repository already on correct branch or skip flag set)
+  ansible.builtin.debug:
+    msg: "Skipping git update - repository already on correct branch or skip_git_update is set"
+  when:
+    - deployment_method == 'git'
+    - git_repo_exists.stat.exists
+    - (application_skip_git_update | default(false) | bool == true) or (git_branch_check.stdout | default('NEEDS_UPDATE') == 'ALREADY_ON_BRANCH')
+
+- name: Fail if git update failed after retries (Git)
+  ansible.builtin.fail:
+    msg: "Failed to update repository after {{ application_git_retries | default(5) }} retries. Gitea may be unreachable or overloaded. Last error: {{ git_update_result.msg | default('Unknown error') }}"
+  when:
+    - deployment_method == 'git'
+    - git_repo_exists.stat.exists
+    - application_skip_git_update | default(false) | bool == false
+    - git_branch_check.stdout | default('NEEDS_UPDATE') == 'NEEDS_UPDATE'
+    - git_update_result is defined
+    - git_update_result is failed
+
+- name: Set ownership of repository files (Git)
+  ansible.builtin.file:
+    path: "{{ application_code_dest }}"
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    recurse: yes
+  become: yes
+  when: deployment_method == 'git'
+
+# Rsync Deployment Tasks
+- name: Clear destination directory before sync (Rsync)
+  ansible.builtin.shell: |
+    # Remove all files and directories except .git (if it exists)
+    find {{ application_code_dest }} -mindepth 1 -maxdepth 1 -not -name '.git' -exec rm -rf {} + 2>/dev/null || true
+  become: yes
+  changed_when: true
+  failed_when: false
+  register: clear_result
+  when: deployment_method == 'rsync'
+
+- name: Display clear status (Rsync)
+  ansible.builtin.debug:
+    msg: "Cleared destination directory before sync (preserved .git if present)"
+  when:
+    - deployment_method == 'rsync'
+    - clear_result.rc | default(0) == 0
+    - application_show_status | default(true) | bool
+
+- name: Synchronize application code from repository root (Rsync)
+  ansible.builtin.synchronize:
+    src: "{{ application_rsync_source }}/"
+    dest: "{{ application_code_dest }}/"
+    delete: no
+    recursive: yes
+    rsync_opts: "{{ application_rsync_opts | default(['--chmod=D755,F644', '--exclude=.git', '--exclude=.gitignore', '--exclude=node_modules', '--exclude=vendor', '--exclude=.env', '--exclude=.env.*', '--exclude=*.log', '--exclude=.idea', '--exclude=.vscode', '--exclude=.DS_Store', '--exclude=*.swp', '--exclude=*.swo', '--exclude=*~', '--exclude=.phpunit.result.cache', '--exclude=coverage', '--exclude=.phpunit.cache', '--exclude=public/assets', '--exclude=storage/logs', '--exclude=storage/framework/cache', '--exclude=storage/framework/sessions', '--exclude=storage/framework/views', '--exclude=deployment', '--exclude=docker', '--exclude=.deployment-archive-*', '--exclude=docs', '--exclude=tests']) }}"
+  when: deployment_method == 'rsync'
+  delegate_to: localhost
+  run_once: true
+
+- name: Ensure executable permissions on PHP scripts (Rsync)
+  ansible.builtin.file:
+    path: "{{ application_code_dest }}/{{ item }}"
+    mode: '0755'
+  loop: "{{ application_php_scripts | default(['worker.php', 'console.php']) }}"
+  when:
+    - deployment_method == 'rsync'
+    - item is defined
+  ignore_errors: yes
+
+- name: Verify critical files exist (Rsync)
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/{{ item }}"
+  register: critical_files_check
+  loop: "{{ application_critical_files | default(['worker.php', 'console.php', 'composer.json']) }}"
+  when: deployment_method == 'rsync'
+
+- name: Display file verification results (Rsync)
+  ansible.builtin.debug:
+    msg: |
+      File Verification:
+      {% for result in critical_files_check.results | default([]) %}
+      - {{ result.item }}: {{ 'EXISTS' if result.stat.exists else 'MISSING' }}
+      {% endfor %}
+  when:
+    - deployment_method == 'rsync'
+    - application_show_status | default(true) | bool
+    - critical_files_check is defined
+
+- name: Fail if critical files are missing (Rsync)
+  ansible.builtin.fail:
+    msg: |
+      Critical files are missing after sync:
+      {% for result in critical_files_check.results | default([]) %}
+      {% if not result.stat.exists %}- {{ result.item }}{% endif %}
+      {% endfor %}
+  when:
+    - deployment_method == 'rsync'
+    - critical_files_check is defined
+    - critical_files_check.results | selectattr('stat.exists', 'equalto', false) | list | length > 0
+
+- name: Display deployment summary
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Application Code Deployment Summary
+      ========================================
+      Method: {{ deployment_method | upper }}
+      Destination: {{ application_code_dest }}
+      {% if deployment_method == 'git' %}
+      Repository: {{ git_repo_url }}
+      Branch: {{ application_git_branch }}
+      {% elif deployment_method == 'rsync' %}
+      Source: {{ application_rsync_source }}
+      {% endif %}
+      ========================================
+  when: application_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/application/tasks/main.yml b/deployment/ansible/roles/application/tasks/deploy_stack.yml
similarity index 100%
rename from deployment/ansible/roles/application/tasks/main.yml
rename to deployment/ansible/roles/application/tasks/deploy_stack.yml
diff --git a/deployment/ansible/roles/application/tasks/health_check.yml b/deployment/ansible/roles/application/tasks/health_check.yml
new file mode 100644
index 00000000..b3825f28
--- /dev/null
+++ b/deployment/ansible/roles/application/tasks/health_check.yml
@@ -0,0 +1,80 @@
+---
+# Health Check Tasks
+
+- name: Get container status
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} ps {{ application_container_status_services | default('queue-worker web scheduler php') }}
+  register: container_status
+  changed_when: false
+
+- name: Display container status
+  ansible.builtin.debug:
+    msg: |
+      {{ container_status.stdout }}
+  when: application_show_status | default(true) | bool
+
+- name: Get queue-worker logs (last N lines)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_health_check_logs_tail | default(20) }} queue-worker 2>&1 || true
+  register: queue_worker_logs
+  changed_when: false
+
+- name: Display queue-worker logs
+  ansible.builtin.debug:
+    msg: |
+      ================
+      Queue-Worker Logs:
+      ================
+      {{ queue_worker_logs.stdout }}
+  when: application_show_status | default(true) | bool
+
+- name: Get scheduler logs (last N lines)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_health_check_logs_tail | default(20) }} scheduler 2>&1 || true
+  register: scheduler_logs
+  changed_when: false
+
+- name: Display scheduler logs
+  ansible.builtin.debug:
+    msg: |
+      ================
+      Scheduler Logs:
+      ================
+      {{ scheduler_logs.stdout }}
+  when: application_show_status | default(true) | bool
+
+- name: Get web container logs (last N lines)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_health_check_logs_tail | default(20) }} web 2>&1 || true
+  register: web_logs
+  changed_when: false
+
+- name: Display web container logs
+  ansible.builtin.debug:
+    msg: |
+      ================
+      Web Container Logs:
+      ================
+      {{ web_logs.stdout }}
+  when: application_show_status | default(true) | bool
+
+- name: Get all container status (final status check)
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} ps
+  register: all_containers
+  changed_when: false
+  when: application_health_check_final | default(false) | bool
+
+- name: Display all container status (final)
+  ansible.builtin.debug:
+    msg: |
+      {{ all_containers.stdout }}
+  when:
+    - application_health_check_final | default(false) | bool
+    - application_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/application/tasks/logs.yml b/deployment/ansible/roles/application/tasks/logs.yml
new file mode 100644
index 00000000..9705649a
--- /dev/null
+++ b/deployment/ansible/roles/application/tasks/logs.yml
@@ -0,0 +1,155 @@
+---
+# Log Analysis Tasks
+
+- name: Get queue-worker logs
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_logs_tail | default(50) }} queue-worker 2>&1 || true
+  register: queue_worker_logs
+  changed_when: false
+
+- name: Display queue-worker logs
+  ansible.builtin.debug:
+    var: queue_worker_logs.stdout_lines
+  when: application_show_status | default(true) | bool
+
+- name: Get scheduler logs
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_logs_tail | default(50) }} scheduler 2>&1 || true
+  register: scheduler_logs
+  changed_when: false
+
+- name: Display scheduler logs
+  ansible.builtin.debug:
+    var: scheduler_logs.stdout_lines
+  when: application_show_status | default(true) | bool
+
+- name: Get web container logs
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} logs --tail={{ application_logs_tail | default(50) }} web 2>&1 || true
+  register: web_logs
+  changed_when: false
+
+- name: Display web container logs
+  ansible.builtin.debug:
+    var: web_logs.stdout_lines
+  when: application_show_status | default(true) | bool
+
+- name: Check if vendor/autoload.php exists in queue-worker container
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T queue-worker test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
+  register: queue_worker_vendor_check
+  changed_when: false
+  failed_when: false
+  ignore_errors: yes
+  when: application_logs_check_vendor | default(true) | bool
+
+- name: Display queue-worker vendor check
+  ansible.builtin.debug:
+    msg: "vendor/autoload.php in queue-worker: {{ queue_worker_vendor_check.stdout | default('CHECK_FAILED') }}"
+  when:
+    - application_logs_check_vendor | default(true) | bool
+    - application_show_status | default(true) | bool
+
+- name: Check if vendor/autoload.php exists in scheduler container
+  ansible.builtin.shell: |
+    cd {{ application_code_dest }}
+    docker compose -f docker-compose.base.yml -f docker-compose.{{ application_compose_suffix }} exec -T scheduler test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
+  register: scheduler_vendor_check
+  changed_when: false
+  failed_when: false
+  ignore_errors: yes
+  when: application_logs_check_vendor | default(true) | bool
+
+- name: Display scheduler vendor check
+  ansible.builtin.debug:
+    msg: "vendor/autoload.php in scheduler: {{ scheduler_vendor_check.stdout | default('CHECK_FAILED') }}"
+  when:
+    - application_logs_check_vendor | default(true) | bool
+    - application_show_status | default(true) | bool
+
+- name: Check vendor directory permissions on host
+  ansible.builtin.shell: |
+    ls -la {{ application_code_dest }}/vendor 2>&1 | head -5 || echo "DIRECTORY_NOT_FOUND"
+  register: vendor_perms
+  changed_when: false
+  when: application_logs_check_permissions | default(true) | bool
+
+- name: Display vendor directory permissions
+  ansible.builtin.debug:
+    msg: |
+      Vendor directory permissions on host:
+      {{ vendor_perms.stdout }}
+  when:
+    - application_logs_check_permissions | default(true) | bool
+    - application_show_status | default(true) | bool
+
+- name: Check if worker.php exists on host
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/worker.php"
+  register: worker_file_host
+  when: application_logs_check_files | default(true) | bool
+
+- name: Display worker.php host check result
+  ansible.builtin.debug:
+    msg: |
+      worker.php on host:
+      - Exists: {{ worker_file_host.stat.exists | default(false) }}
+      {% if worker_file_host.stat.exists %}
+      - Path: {{ worker_file_host.stat.path }}
+      - Size: {{ worker_file_host.stat.size | default(0) }} bytes
+      {% endif %}
+  when:
+    - application_logs_check_files | default(true) | bool
+    - application_show_status | default(true) | bool
+
+- name: Check if console.php exists on host
+  ansible.builtin.stat:
+    path: "{{ application_code_dest }}/console.php"
+  register: console_file_host
+  when: application_logs_check_files | default(true) | bool
+
+- name: Display console.php host check result
+  ansible.builtin.debug:
+    msg: |
+      console.php on host:
+      - Exists: {{ console_file_host.stat.exists | default(false) }}
+      {% if console_file_host.stat.exists %}
+      - Path: {{ console_file_host.stat.path }}
+      - Size: {{ console_file_host.stat.size | default(0) }} bytes
+      {% endif %}
+  when:
+    - application_logs_check_files | default(true) | bool
+    - application_show_status | default(true) | bool
+
+- name: List files in application directory
+  ansible.builtin.shell: |
+    ls -la {{ application_code_dest }}/ | head -20
+  register: app_dir_listing
+  changed_when: false
+  when: application_logs_list_files | default(false) | bool
+
+- name: Display application directory listing
+  ansible.builtin.debug:
+    var: app_dir_listing.stdout_lines
+  when:
+    - application_logs_list_files | default(false) | bool
+    - application_show_status | default(true) | bool
+
+- name: Check what PHP files exist in application directory
+  ansible.builtin.shell: |
+    find {{ application_code_dest }} -maxdepth 1 -name "*.php" -type f 2>/dev/null | head -20
+  register: php_files
+  changed_when: false
+  when: application_logs_list_files | default(false) | bool
+
+- name: Display PHP files found
+  ansible.builtin.debug:
+    var: php_files.stdout_lines
+  when:
+    - application_logs_list_files | default(false) | bool
+    - application_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/application/tasks/sync.yml b/deployment/ansible/roles/application/tasks/sync.yml
index 78aeefdb..01791d09 100644
--- a/deployment/ansible/roles/application/tasks/sync.yml
+++ b/deployment/ansible/roles/application/tasks/sync.yml
@@ -5,6 +5,44 @@
     state: directory
     mode: '0755'
 
+- name: Ensure secrets directory exists for Docker Compose secrets
+  file:
+    path: "{{ application_stack_dest }}/secrets"
+    state: directory
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0700'
+
+- name: Ensure parent directory exists for application code
+  file:
+    path: "/home/deploy/michaelschiemer"
+    state: directory
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0755'
+  when: application_compose_suffix == 'production.yml'
+  become: yes
+
+- name: Ensure application code directory exists
+  file:
+    path: "/home/deploy/michaelschiemer/current"
+    state: directory
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0755'
+  when: application_compose_suffix == 'production.yml'
+  become: yes
+  ignore_errors: yes
+
+- name: Fix ownership of application code directory if needed
+  command: chown -R {{ ansible_user }}:{{ ansible_user }} /home/deploy/michaelschiemer/current
+  when: 
+    - application_compose_suffix == 'production.yml'
+    - ansible_check_mode is not defined or not ansible_check_mode
+  become: yes
+  changed_when: false
+  failed_when: false
+
 - name: Check if vault file exists locally
   stat:
     path: "{{ application_vault_file }}"
@@ -21,26 +59,70 @@
   delegate_to: localhost
   become: no
 
-- name: Check if PostgreSQL .env exists on target host
+- name: Check if PostgreSQL Production .env exists on target host
+  stat:
+    path: "{{ stacks_base_path }}/postgresql-production/.env"
+  register: application_postgres_production_env_file
+  changed_when: false
+
+- name: Check if PostgreSQL Staging .env exists on target host (for staging deployments)
+  stat:
+    path: "{{ stacks_base_path }}/postgresql-staging/.env"
+  register: application_postgres_staging_env_file
+  changed_when: false
+  when: application_compose_suffix == 'staging'
+
+- name: Extract PostgreSQL Production password from .env file
+  shell: "grep '^POSTGRES_PASSWORD=' {{ stacks_base_path }}/postgresql-production/.env 2>/dev/null | cut -d'=' -f2- || echo ''"
+  register: application_postgres_production_password
+  changed_when: false
+  failed_when: false
+  when: application_postgres_production_env_file.stat.exists
+  no_log: yes
+
+- name: Extract PostgreSQL Staging password from .env file
+  shell: "grep '^POSTGRES_PASSWORD=' {{ stacks_base_path }}/postgresql-staging/.env 2>/dev/null | cut -d'=' -f2- || echo ''"
+  register: application_postgres_staging_password
+  changed_when: false
+  failed_when: false
+  when: 
+    - application_compose_suffix == 'staging'
+    - application_postgres_staging_env_file.stat.exists
+  no_log: yes
+
+- name: "Fallback: Check if legacy PostgreSQL .env exists on target host"
   stat:
     path: "{{ stacks_base_path }}/postgresql/.env"
   register: application_postgres_env_file
   changed_when: false
+  when: not (application_postgres_production_env_file.stat.exists | default(false))
 
-- name: Extract PostgreSQL password from .env file
+- name: "Fallback: Extract PostgreSQL password from legacy .env file"
   shell: "grep '^POSTGRES_PASSWORD=' {{ stacks_base_path }}/postgresql/.env 2>/dev/null | cut -d'=' -f2- || echo ''"
   register: application_postgres_password
   changed_when: false
   failed_when: false
-  when: application_postgres_env_file.stat.exists
+  when: 
+    - not (application_postgres_production_env_file.stat.exists | default(false))
+    - application_postgres_env_file.stat.exists
   no_log: yes
 
 - name: Determine application database password
   set_fact:
     application_db_password: >-
-      {{ (application_postgres_env_file.stat.exists and application_postgres_password.stdout != '') |
-         ternary(application_postgres_password.stdout,
-                 vault_db_root_password | default(lookup('password', '/dev/null length=32 chars=ascii_letters,digits,punctuation'))) }}
+      {% if application_compose_suffix == 'staging' %}
+        {{ (application_postgres_staging_env_file.stat.exists | default(false) and application_postgres_staging_password.stdout | default('') != '') |
+           ternary(application_postgres_staging_password.stdout,
+                   (application_postgres_env_file.stat.exists | default(false) and application_postgres_password.stdout | default('') != '') |
+                   ternary(application_postgres_password.stdout,
+                           vault_db_root_password | default(lookup('password', '/dev/null length=32 chars=ascii_letters,digits,punctuation')))) }}
+      {% else %}
+        {{ (application_postgres_production_env_file.stat.exists | default(false) and application_postgres_production_password.stdout | default('') != '') |
+           ternary(application_postgres_production_password.stdout,
+                   (application_postgres_env_file.stat.exists | default(false) and application_postgres_password.stdout | default('') != '') |
+                   ternary(application_postgres_password.stdout,
+                           vault_db_root_password | default(lookup('password', '/dev/null length=32 chars=ascii_letters,digits,punctuation')))) }}
+      {% endif %}
   no_log: yes
 
 - name: Determine application redis password
@@ -73,32 +155,55 @@
     application_encryption_key: "{{ encryption_key | default(vault_encryption_key | default('')) }}"
   no_log: yes
 
-- name: Check if application docker-compose.base.yml source exists locally
+- name: Determine project root directory
+  set_fact:
+    project_root: "{{ playbook_dir | default(role_path + '/..') | dirname | dirname | dirname }}"
+  changed_when: false
+
+- name: Check if application docker-compose.base.yml source exists locally (in project root)
   stat:
-    path: "{{ application_stack_src }}/docker-compose.base.yml"
+    path: "{{ project_root }}/docker-compose.base.yml"
   delegate_to: localhost
   register: application_compose_base_src
   become: no
 
 - name: Check if application docker-compose override file exists locally (production or staging)
   stat:
-    path: "{{ application_stack_src }}/../../../docker-compose.{{ application_compose_suffix }}"
+    path: "{{ project_root }}/docker-compose.{{ application_compose_suffix }}"
   delegate_to: localhost
   register: application_compose_override_src
   become: no
 
-- name: Copy application docker-compose.base.yml to target host
+- name: Check if production-base.yml exists (preferred for production/staging)
+  stat:
+    path: "{{ project_root }}/docker-compose.production-base.yml"
+  delegate_to: localhost
+  register: application_compose_production_base_src
+  become: no
+
+- name: Copy application docker-compose.production-base.yml to target host (production/staging)
   copy:
-    src: "{{ application_stack_src }}/docker-compose.base.yml"
+    src: "{{ project_root }}/docker-compose.production-base.yml"
     dest: "{{ application_stack_dest }}/docker-compose.base.yml"
     owner: "{{ ansible_user }}"
     group: "{{ ansible_user }}"
     mode: '0644'
-  when: application_compose_base_src.stat.exists
+  when: application_compose_production_base_src.stat.exists
+
+- name: Copy application docker-compose.base.yml to target host (fallback)
+  copy:
+    src: "{{ project_root }}/docker-compose.base.yml"
+    dest: "{{ application_stack_dest }}/docker-compose.base.yml"
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0644'
+  when: 
+    - not application_compose_production_base_src.stat.exists
+    - application_compose_base_src.stat.exists
 
 - name: Copy application docker-compose override file to target host (production or staging)
   copy:
-    src: "{{ application_stack_src }}/../../../docker-compose.{{ application_compose_suffix }}"
+    src: "{{ project_root }}/docker-compose.{{ application_compose_suffix }}"
     dest: "{{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }}"
     owner: "{{ ansible_user }}"
     group: "{{ ansible_user }}"
@@ -141,14 +246,69 @@
     mode: '0644'
   when: application_nginx_src.stat.exists
 
-- name: Expose secrets for template rendering
+- name: Debug - Check available variables before set_fact
+  debug:
+    msg:
+      - "application_environment: {{ application_environment | default('NOT SET') }}"
+      - "app_env: {{ app_env | default('NOT SET') }}"
+      - "application_compose_suffix: {{ application_compose_suffix | default('NOT SET') }}"
+      - "app_domain (from vars): {{ 'DEFINED' if app_domain is defined else 'NOT SET' }}"
+      - "db_user_default: {{ db_user_default | default('NOT SET') }}"
+      - "db_name_default: {{ db_name_default | default('NOT SET') }}"
+      - "db_host_default: {{ db_host_default | default('NOT SET') }}"
+      - "application_db_password: {{ 'SET (length: ' + (application_db_password | default('') | string | length | string) + ')' if (application_db_password | default('') | string | trim) != '' else 'NOT SET' }}"
+      - "application_redis_password: {{ 'SET (length: ' + (application_redis_password | default('') | string | length | string) + ')' if (application_redis_password | default('') | string | trim) != '' else 'NOT SET' }}"
+      - "application_app_key: {{ 'SET (length: ' + (application_app_key | default('') | string | length | string) + ')' if (application_app_key | default('') | string | trim) != '' else 'NOT SET' }}"
+  changed_when: false
+
+- name: Determine application environment for domain resolution
   set_fact:
-    db_password: "{{ application_db_password }}"
-    redis_password: "{{ application_redis_password }}"
-    app_key: "{{ application_app_key }}"
-    encryption_key: "{{ application_encryption_key }}"
-    db_username: "{{ db_user | default(db_user_default) }}"
-    db_name: "{{ db_name | default(db_name_default) }}"
+    _app_env: "{{ app_env | default(application_environment | default('production')) }}"
+  no_log: yes
+
+- name: Expose secrets for template rendering (step 1 - basic vars)
+  set_fact:
+    db_password: "{{ application_db_password | default('') }}"
+    redis_password: "{{ application_redis_password | default('') }}"
+    app_key: "{{ application_app_key | default('') }}"
+    encryption_key: "{{ application_encryption_key | default('') }}"
+    app_env: "{{ _app_env }}"
+    minio_root_user: "{{ minio_root_user | default('minioadmin') }}"
+    minio_root_password: "{{ minio_root_password | default('') }}"
+  no_log: yes
+
+- name: Expose secrets for template rendering (step 2 - db vars)
+  set_fact:
+    db_username: "{{ db_user | default(db_user_default | default('postgres')) }}"
+    db_name: "{{ db_name | default(db_name_default | default('michaelschiemer')) }}"
+  no_log: yes
+
+- name: Expose secrets for template rendering (step 3 - db_host with conditional)
+  set_fact:
+    db_host: >-
+      {%- if db_host is defined and db_host | string | trim != '' -%}
+        {{ db_host }}
+      {%- elif db_host_default is defined and db_host_default | string | trim != '' -%}
+        {{ db_host_default }}
+      {%- elif application_compose_suffix == 'production.yml' -%}
+        postgres-production
+      {%- elif application_compose_suffix == 'staging.yml' -%}
+        postgres-staging
+      {%- else -%}
+        postgres
+      {%- endif -%}
+  no_log: yes
+
+- name: Expose secrets for template rendering (step 4 - app_domain)
+  set_fact:
+    app_domain: >-
+      {%- if app_domain is defined and app_domain | string | trim != '' -%}
+        {{ app_domain }}
+      {%- elif _app_env == 'production' -%}
+        michaelschiemer.de
+      {%- else -%}
+        staging.michaelschiemer.de
+      {%- endif -%}
   no_log: yes
 
 - name: Render application environment file
@@ -158,3 +318,21 @@
     owner: "{{ ansible_user }}"
     group: "{{ ansible_user }}"
     mode: '0600'
+
+- name: Create Docker Compose secret files from determined passwords
+  copy:
+    content: "{{ item.value }}"
+    dest: "{{ application_stack_dest }}/secrets/{{ item.name }}.txt"
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+    mode: '0600'
+  loop:
+    - name: db_user_password
+      value: "{{ application_db_password }}"
+    - name: redis_password
+      value: "{{ application_redis_password }}"
+    - name: app_key
+      value: "{{ application_app_key }}"
+    - name: vault_encryption_key
+      value: "{{ application_encryption_key | default(application_app_key) }}"
+  no_log: yes
diff --git a/deployment/ansible/roles/gitea/handlers/main.yml b/deployment/ansible/roles/gitea/handlers/main.yml
new file mode 100644
index 00000000..0febb868
--- /dev/null
+++ b/deployment/ansible/roles/gitea/handlers/main.yml
@@ -0,0 +1,17 @@
+---
+# Handlers for Gitea Role
+
+- name: wait for gitea
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/healthz"
+    method: GET
+    status_code: [200]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: gitea_health_handler
+  until: gitea_health_handler.status == 200
+  retries: "{{ gitea_restart_retries | default(30) }}"
+  delay: "{{ gitea_restart_delay | default(2) }}"
+  changed_when: false
+  ignore_errors: yes
+
diff --git a/deployment/ansible/roles/gitea/tasks/config.yml b/deployment/ansible/roles/gitea/tasks/config.yml
new file mode 100644
index 00000000..39a12736
--- /dev/null
+++ b/deployment/ansible/roles/gitea/tasks/config.yml
@@ -0,0 +1,131 @@
+---
+# Update Gitea Configuration (app.ini)
+
+- name: Verify Gitea container exists
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml ps {{ gitea_container_name }} | grep -q "{{ gitea_container_name }}"
+  register: gitea_exists
+  changed_when: false
+  failed_when: false
+
+- name: Fail if Gitea container does not exist
+  ansible.builtin.fail:
+    msg: "Gitea container does not exist. Please deploy Gitea stack first."
+  when: gitea_exists.rc != 0
+
+- name: Get database configuration from environment
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} env | grep -E "^GITEA__database__" || true
+  register: gitea_db_env
+  changed_when: false
+  failed_when: false
+
+- name: Parse database configuration
+  ansible.builtin.set_fact:
+    gitea_db_type: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__DB_TYPE=([^\n]+)', '\\1') or ['postgres']) | first }}"
+    gitea_db_host: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__HOST=([^\n]+)', '\\1') or ['postgres:5432']) | first }}"
+    gitea_db_name: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__NAME=([^\n]+)', '\\1') or ['gitea']) | first }}"
+    gitea_db_user: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__USER=([^\n]+)', '\\1') or ['gitea']) | first }}"
+    gitea_db_passwd: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__PASSWD=([^\n]+)', '\\1') or ['gitea_password']) | first }}"
+
+- name: Get Gitea server configuration from environment
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} env | grep -E "^GITEA__server__" || true
+  register: gitea_server_env
+  changed_when: false
+  failed_when: false
+
+- name: Parse server configuration
+  ansible.builtin.set_fact:
+    gitea_domain_parsed: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__DOMAIN=([^\n]+)', '\\1') or [gitea_domain | default('git.michaelschiemer.de')]) | first }}"
+    ssh_port_parsed: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__SSH_PORT=([^\n]+)', '\\1') or ['2222']) | first }}"
+
+- name: Set final configuration variables
+  ansible.builtin.set_fact:
+    gitea_domain: "{{ gitea_domain_parsed }}"
+    ssh_port: "{{ ssh_port_parsed }}"
+    ssh_listen_port: "{{ ssh_port_parsed }}"
+
+- name: Extract database host and port
+  ansible.builtin.set_fact:
+    gitea_db_hostname: "{{ gitea_db_host.split(':')[0] }}"
+    gitea_db_port: "{{ (gitea_db_host.split(':')[1]) | default('5432') }}"
+
+- name: Set Redis password
+  ansible.builtin.set_fact:
+    redis_password: "{{ vault_gitea_redis_password | default(vault_redis_password | default('gitea_redis_password')) }}"
+
+- name: Generate app.ini from template
+  ansible.builtin.template:
+    src: "{{ gitea_app_ini_template | default('../../templates/gitea-app.ini.j2') }}"
+    dest: "{{ gitea_app_ini_path }}"
+    mode: '0644'
+  vars:
+    postgres_db: "{{ gitea_db_name }}"
+    postgres_user: "{{ gitea_db_user }}"
+    postgres_password: "{{ gitea_db_passwd }}"
+    gitea_domain: "{{ gitea_domain }}"
+    ssh_port: "{{ ssh_port }}"
+    ssh_listen_port: "{{ ssh_listen_port }}"
+    disable_registration: true
+    redis_password: "{{ redis_password }}"
+
+- name: Copy app.ini to Gitea container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml cp {{ gitea_app_ini_path }} {{ gitea_container_name }}:{{ gitea_app_ini_container_path }}
+  ignore_errors: yes
+
+- name: Wait for container to be ready for exec
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} true
+  register: container_ready
+  until: container_ready.rc == 0
+  retries: "{{ gitea_config_retries | default(30) }}"
+  delay: "{{ gitea_config_delay | default(2) }}"
+  changed_when: false
+
+- name: Set correct permissions on app.ini in container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T --user git {{ gitea_container_name }} chown 1000:1000 {{ gitea_app_ini_container_path }} && \
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T --user git {{ gitea_container_name }} chmod 644 {{ gitea_app_ini_container_path }}
+
+- name: Restart Gitea container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml restart {{ gitea_container_name }}
+  register: gitea_restart
+  changed_when: gitea_restart.rc == 0
+  notify: wait for gitea
+
+- name: Wait for Gitea to be ready after restart
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/healthz"
+    method: GET
+    status_code: [200]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: gitea_health_after_restart
+  until: gitea_health_after_restart.status == 200
+  retries: "{{ gitea_restart_retries | default(30) }}"
+  delay: "{{ gitea_restart_delay | default(5) }}"
+  when: gitea_restart.changed | default(false)
+  changed_when: false
+
+- name: Display success message
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Gitea Configuration Update Complete
+      ========================================
+      Gitea configuration has been updated successfully!
+      
+      Changes applied:
+      - Redis cache enabled (persistent, survives container restarts)
+      - Redis sessions enabled (better performance and scalability)
+      - Redis queue enabled (persistent job processing)
+      - Database connection pooling configured
+      - Connection limits set to prevent "Connection reset by peer" errors
+      
+      Gitea should now be more stable and perform better with Redis.
+      ========================================
+  when: gitea_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/gitea/tasks/main.yml b/deployment/ansible/roles/gitea/tasks/deploy.yml
similarity index 100%
rename from deployment/ansible/roles/gitea/tasks/main.yml
rename to deployment/ansible/roles/gitea/tasks/deploy.yml
diff --git a/deployment/ansible/roles/gitea/tasks/repository.yml b/deployment/ansible/roles/gitea/tasks/repository.yml
new file mode 100644
index 00000000..2e9d295f
--- /dev/null
+++ b/deployment/ansible/roles/gitea/tasks/repository.yml
@@ -0,0 +1,258 @@
+---
+# Setup Gitea Repository
+
+- name: Set repository variables from parameters
+  ansible.builtin.set_fact:
+    repo_name: "{{ gitea_repo_name | default('michaelschiemer') }}"
+    repo_owner: "{{ gitea_repo_owner | default('michael') }}"
+    repo_private: "{{ gitea_repo_private | default(false) | bool }}"
+    repo_description: "{{ gitea_repo_description | default('Main application repository') }}"
+    repo_auto_init: "{{ gitea_repo_auto_init | default(false) | bool }}"
+    configure_git_remote: "{{ gitea_configure_git_remote | default(true) | bool }}"
+    git_repo_path: "{{ gitea_git_repo_path | default('/home/michael/dev/michaelschiemer') }}"
+
+- name: Verify Gitea is accessible
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}"
+    method: GET
+    status_code: [200, 302, 502]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: gitea_health
+  failed_when: false
+
+- name: Debug Gitea health status
+  ansible.builtin.debug:
+    msg: "Gitea health check returned status: {{ gitea_health.status }}"
+  when: gitea_show_status | default(true) | bool
+
+- name: Fail if Gitea is not accessible
+  ansible.builtin.fail:
+    msg: "Gitea is not accessible at {{ gitea_url }}. Status: {{ gitea_health.status }}. Please check if Gitea is running."
+  when: gitea_health.status not in [200, 302, 502]
+
+- name: Check if API token exists in vault
+  ansible.builtin.set_fact:
+    has_vault_token: "{{ vault_git_token is defined and vault_git_token | length > 0 }}"
+  no_log: true
+
+- name: Get or create Gitea API token
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/v1/users/{{ gitea_admin_username }}/tokens"
+    method: POST
+    user: "{{ gitea_admin_username }}"
+    password: "{{ gitea_admin_password }}"
+    body_format: json
+    body:
+      name: "ansible-repo-setup-{{ ansible_date_time.epoch }}"
+      scopes:
+        - write:repository
+        - read:repository
+        - admin:repo
+    status_code: [201, 400, 401, 502]
+    validate_certs: false
+    force_basic_auth: yes
+  register: api_token_result
+  failed_when: false
+  when: not has_vault_token
+  no_log: true
+
+- name: Extract API token from response
+  ansible.builtin.set_fact:
+    gitea_api_token: "{{ api_token_result.json.sha1 | default('') }}"
+  when: 
+    - not has_vault_token
+    - api_token_result.status == 201
+    - api_token_result.json.sha1 is defined
+  no_log: true
+
+- name: Use existing API token from vault
+  ansible.builtin.set_fact:
+    gitea_api_token: "{{ vault_git_token }}"
+  when: has_vault_token
+  no_log: true
+
+- name: Set flag to use basic auth if token creation failed
+  ansible.builtin.set_fact:
+    use_basic_auth: "{{ gitea_api_token | default('') | length == 0 }}"
+  no_log: true
+
+- name: Fail if no authentication method available
+  ansible.builtin.fail:
+    msg: "Could not create or retrieve Gitea API token, and admin credentials are not available. Please create a token manually or set vault_git_token in vault."
+  when: 
+    - use_basic_auth | bool
+    - gitea_admin_password | default('') | length == 0
+
+- name: Initialize repo_check variable
+  ansible.builtin.set_fact:
+    repo_check: {"status": 0}
+  when: repo_check is not defined
+
+- name: Check if repository already exists (with token)
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/v1/repos/{{ repo_owner }}/{{ repo_name }}"
+    method: GET
+    headers:
+      Authorization: "token {{ gitea_api_token }}"
+    status_code: [200, 404, 502]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: repo_check_token
+  when: not use_basic_auth
+  failed_when: false
+
+- name: Set repo_check from token result
+  ansible.builtin.set_fact:
+    repo_check: "{{ repo_check_token }}"
+  when: 
+    - not use_basic_auth
+    - repo_check_token is defined
+
+- name: Check if repository already exists (with basic auth)
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/v1/repos/{{ repo_owner }}/{{ repo_name }}"
+    method: GET
+    user: "{{ gitea_admin_username }}"
+    password: "{{ gitea_admin_password }}"
+    status_code: [200, 404, 502]
+    validate_certs: false
+    force_basic_auth: yes
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: repo_check_basic
+  when: use_basic_auth
+  failed_when: false
+  no_log: true
+
+- name: Set repo_check from basic auth result
+  ansible.builtin.set_fact:
+    repo_check: "{{ repo_check_basic }}"
+  when: 
+    - use_basic_auth
+    - repo_check_basic is defined
+
+- name: Debug repo_check status
+  ansible.builtin.debug:
+    msg: "Repository check - Status: {{ repo_check.status | default('undefined') }}, use_basic_auth: {{ use_basic_auth | default('undefined') }}"
+  when: gitea_show_status | default(true) | bool
+
+- name: Create repository in Gitea (with token)
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/v1/user/repos"
+    method: POST
+    headers:
+      Authorization: "token {{ gitea_api_token }}"
+      Content-Type: "application/json"
+    body_format: json
+    body:
+      name: "{{ repo_name }}"
+      description: "{{ repo_description }}"
+      private: "{{ repo_private }}"
+      auto_init: "{{ repo_auto_init }}"
+    status_code: [201, 409, 502]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: repo_create_result
+  when: 
+    - (repo_check.status | default(0)) in [404, 502, 0] or (gitea_force_create_repo | default(false) | bool)
+    - not use_basic_auth
+  failed_when: false
+
+- name: Create repository in Gitea (with basic auth)
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/v1/user/repos"
+    method: POST
+    user: "{{ gitea_admin_username }}"
+    password: "{{ gitea_admin_password }}"
+    body_format: json
+    body:
+      name: "{{ repo_name }}"
+      description: "{{ repo_description }}"
+      private: "{{ repo_private }}"
+      auto_init: "{{ repo_auto_init }}"
+    status_code: [201, 409]
+    validate_certs: false
+    force_basic_auth: yes
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: repo_create_result
+  when: 
+    - ((repo_check.status | default(0)) != 200) or (gitea_force_create_repo | default(false) | bool)
+    - use_basic_auth
+  no_log: true
+
+- name: Debug repository creation result
+  ansible.builtin.debug:
+    msg: "Repository creation - Status: {{ repo_create_result.status | default('undefined') }}, Response: {{ repo_create_result.json | default('no json') }}"
+  when:
+    - repo_create_result is defined
+    - gitea_show_status | default(true) | bool
+  failed_when: false
+
+- name: Display repository creation result
+  ansible.builtin.debug:
+    msg: "Repository {{ repo_owner }}/{{ repo_name }} already exists or was created successfully"
+  when: repo_check.status | default(0) == 200 or (repo_create_result is defined and repo_create_result.status | default(0) == 201)
+
+- name: Get repository clone URL
+  ansible.builtin.set_fact:
+    repo_clone_url: "{{ gitea_url | replace('https://', '') | replace('http://', '') }}/{{ repo_owner }}/{{ repo_name }}.git"
+    repo_https_url: "https://{{ gitea_admin_username }}:{{ gitea_api_token }}@{{ gitea_url | replace('https://', '') | replace('http://', '') }}/{{ repo_owner }}/{{ repo_name }}.git"
+
+- name: Check if Git repository exists locally
+  ansible.builtin.stat:
+    path: "{{ git_repo_path }}/.git"
+  register: git_repo_exists
+  when: configure_git_remote | bool
+  delegate_to: localhost
+  run_once: true
+
+- name: Configure Git remote (local)
+  ansible.builtin.command: >
+    git remote set-url origin {{ repo_clone_url }}
+  args:
+    chdir: "{{ git_repo_path }}"
+  register: git_remote_result
+  when: 
+    - configure_git_remote | bool
+    - git_repo_path is defined
+    - git_repo_exists.stat.exists
+  delegate_to: localhost
+  run_once: true
+  changed_when: git_remote_result.rc == 0
+  failed_when: false
+
+- name: Add Git remote if it doesn't exist
+  ansible.builtin.command: >
+    git remote add origin {{ repo_clone_url }}
+  args:
+    chdir: "{{ git_repo_path }}"
+  register: git_remote_add_result
+  when: 
+    - configure_git_remote | bool
+    - git_repo_path is defined
+    - git_repo_exists.stat.exists
+    - git_remote_result.rc != 0
+  delegate_to: localhost
+  run_once: true
+  changed_when: git_remote_add_result.rc == 0
+  failed_when: false
+
+- name: Display success message
+  ansible.builtin.debug:
+    msg:
+      - "========================================"
+      - "✅ Repository created successfully!"
+      - "========================================"
+      - "Repository URL: {{ gitea_url }}/{{ repo_owner }}/{{ repo_name }}"
+      - "Clone URL: {{ repo_clone_url }}"
+      - ""
+      - "Next steps:"
+      - "1. Push your code: git push -u origin staging"
+      - "2. Monitor pipeline: {{ gitea_url }}/{{ repo_owner }}/{{ repo_name }}/actions"
+      - ""
+      - "Note: If you need to push, you may need to authenticate with:"
+      - "   Username: {{ gitea_admin_username }}"
+      - "   Password: (use vault_gitea_admin_password or create a Personal Access Token)"
+      - "========================================"
+  when: gitea_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/gitea/tasks/runner.yml b/deployment/ansible/roles/gitea/tasks/runner.yml
new file mode 100644
index 00000000..315d57f8
--- /dev/null
+++ b/deployment/ansible/roles/gitea/tasks/runner.yml
@@ -0,0 +1,329 @@
+---
+# Gitea Runner Management Tasks
+# Supports both fix (diagnose) and register actions
+
+- name: Check if Gitea runner directory exists
+  ansible.builtin.stat:
+    path: "{{ gitea_runner_path }}"
+  register: runner_dir_exists
+
+- name: Fail if runner directory does not exist
+  ansible.builtin.fail:
+    msg: "Gitea runner directory not found at {{ gitea_runner_path }}"
+  when: not runner_dir_exists.stat.exists
+
+- name: Check if runner container is running
+  ansible.builtin.shell: |
+    docker ps --format json | jq -r 'select(.Names == "{{ gitea_runner_container_name }}") | .State'
+  register: runner_container_state
+  changed_when: false
+  failed_when: false
+
+- name: Display runner container status
+  ansible.builtin.debug:
+    msg: |
+      Runner Container Status: {{ runner_container_state.stdout | default('NOT RUNNING') }}
+  when: gitea_runner_show_status | default(true) | bool
+
+- name: Check if .runner file exists
+  ansible.builtin.stat:
+    path: "{{ gitea_runner_path }}/data/.runner"
+  register: runner_file_exists
+
+- name: Read .runner file content (if exists)
+  ansible.builtin.slurp:
+    src: "{{ gitea_runner_path }}/data/.runner"
+  register: runner_file_content
+  when: runner_file_exists.stat.exists
+  changed_when: false
+
+- name: Display .runner file content
+  ansible.builtin.debug:
+    msg: |
+      Runner Registration File Content:
+      {{ runner_file_content.content | b64decode | default('File not found') }}
+  when:
+    - runner_file_exists.stat.exists
+    - gitea_runner_show_status | default(true) | bool
+
+- name: Check for GitHub URLs in .runner file
+  ansible.builtin.shell: |
+    grep -i "github.com" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "NO_GITHUB_URLS"
+  register: github_urls_check
+  when: runner_file_exists.stat.exists
+  changed_when: false
+  failed_when: false
+
+- name: Display GitHub URLs check result
+  ansible.builtin.debug:
+    msg: |
+      GitHub URLs in .runner file: {{ github_urls_check.stdout }}
+  when: gitea_runner_show_status | default(true) | bool
+
+- name: Check runner logs for incorrect URLs
+  ansible.builtin.shell: |
+    docker logs {{ gitea_runner_container_name }} --tail=100 2>&1 | grep -E "(github.com|instance|repo)" || echo "NO_MATCHES"
+  register: runner_logs_check
+  changed_when: false
+  failed_when: false
+
+- name: Display runner logs analysis
+  ansible.builtin.debug:
+    msg: |
+      Runner Logs Analysis (last 100 lines):
+      {{ runner_logs_check.stdout }}
+  when: gitea_runner_show_status | default(true) | bool
+
+- name: Check .env file for GITEA_INSTANCE_URL
+  ansible.builtin.shell: |
+    grep "^GITEA_INSTANCE_URL=" "{{ gitea_runner_path }}/.env" 2>/dev/null || echo "NOT_FOUND"
+  register: env_instance_url
+  changed_when: false
+  failed_when: false
+
+- name: Display GITEA_INSTANCE_URL from .env
+  ansible.builtin.debug:
+    msg: |
+      GITEA_INSTANCE_URL in .env: {{ env_instance_url.stdout }}
+  when: gitea_runner_show_status | default(true) | bool
+
+- name: Check if .env has correct Gitea URL
+  ansible.builtin.set_fact:
+    env_has_correct_url: "{{ env_instance_url.stdout is defined and gitea_instance_url in env_instance_url.stdout }}"
+
+- name: Check if runner needs re-registration (for fix action)
+  ansible.builtin.set_fact:
+    runner_needs_reregistration: >-
+      {%- if not runner_file_exists.stat.exists -%}
+        true
+      {%- elif 'github.com' in (github_urls_check.stdout | default('')) -%}
+        true
+      {%- elif not env_has_correct_url -%}
+        true
+      {%- else -%}
+        false
+      {%- endif -%}
+  when: gitea_runner_action | default('fix') == 'fix'
+
+- name: Display re-registration decision
+  ansible.builtin.debug:
+    msg: |
+      Runner Re-registration Needed: {{ runner_needs_reregistration | bool }}
+      
+      Reasons:
+      - Runner file exists: {{ runner_file_exists.stat.exists }}
+      - Contains GitHub URLs: {{ 'github.com' in (github_urls_check.stdout | default('')) }}
+      - .env has correct URL: {{ env_has_correct_url | bool }}
+  when:
+    - gitea_runner_action | default('fix') == 'fix'
+    - gitea_runner_show_status | default(true) | bool
+
+- name: Fail if registration token is not provided (for register action)
+  ansible.builtin.fail:
+    msg: "gitea_runner_registration_token must be provided via -e 'gitea_runner_registration_token=<token>'"
+  when:
+    - gitea_runner_action | default('fix') == 'register'
+    - gitea_runner_registration_token | string | trim == ''
+
+- name: Stop runner container before re-registration (fix action)
+  ansible.builtin.shell: |
+    cd {{ gitea_runner_path }}
+    docker compose stop {{ gitea_runner_container_name }}
+  when:
+    - gitea_runner_action | default('fix') == 'fix'
+    - runner_needs_reregistration | bool
+  register: stop_runner
+  changed_when: stop_runner.rc == 0
+
+- name: Stop runner container if running (register action)
+  ansible.builtin.shell: |
+    cd {{ gitea_runner_path }}
+    docker compose stop {{ gitea_runner_container_name }}
+  when: gitea_runner_action | default('fix') == 'register'
+  register: stop_result
+  changed_when: stop_result.rc == 0
+  failed_when: false
+
+- name: Backup existing .runner file
+  ansible.builtin.copy:
+    src: "{{ gitea_runner_path }}/data/.runner"
+    dest: "{{ gitea_runner_path }}/data/.runner.backup.{{ ansible_date_time.epoch }}"
+    remote_src: yes
+  when:
+    - runner_file_exists.stat.exists
+    - (gitea_runner_action | default('fix') == 'register') or (runner_needs_reregistration | bool)
+  ignore_errors: yes
+
+- name: Remove existing .runner file
+  ansible.builtin.file:
+    path: "{{ gitea_runner_path }}/data/.runner"
+    state: absent
+  when:
+    - (gitea_runner_action | default('fix') == 'register') or (runner_needs_reregistration | bool)
+
+- name: Update .env file with correct GITEA_INSTANCE_URL (fix action)
+  ansible.builtin.lineinfile:
+    path: "{{ gitea_runner_path }}/.env"
+    regexp: '^GITEA_INSTANCE_URL='
+    line: "GITEA_INSTANCE_URL={{ gitea_instance_url }}"
+    create: yes
+  when:
+    - gitea_runner_action | default('fix') == 'fix'
+    - runner_needs_reregistration | bool
+  register: env_updated
+
+- name: Update .env file with correct configuration (register action)
+  ansible.builtin.lineinfile:
+    path: "{{ gitea_runner_path }}/.env"
+    regexp: '^{{ item.key }}='
+    line: "{{ item.key }}={{ item.value }}"
+    create: yes
+  loop:
+    - { key: 'GITEA_INSTANCE_URL', value: '{{ gitea_instance_url }}' }
+    - { key: 'GITEA_RUNNER_REGISTRATION_TOKEN', value: '{{ gitea_runner_registration_token }}' }
+    - { key: 'GITEA_RUNNER_NAME', value: '{{ gitea_runner_name }}' }
+    - { key: 'GITEA_RUNNER_LABELS', value: '{{ gitea_runner_labels }}' }
+  when: gitea_runner_action | default('fix') == 'register'
+  no_log: true
+
+- name: Display instructions for manual re-registration (fix action)
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Runner Re-registration Required
+      ========================================
+      
+      The runner needs to be re-registered with the correct Gitea instance URL.
+      
+      Steps to re-register:
+      
+      1. Get a new registration token from Gitea:
+         {{ gitea_instance_url }}/admin/actions/runners
+         Click "Create New Runner" and copy the token
+      
+      2. Update .env file with the token:
+         GITEA_RUNNER_REGISTRATION_TOKEN=<your-token>
+      
+      3. Re-register the runner:
+         cd {{ gitea_runner_path }}
+         ./register.sh
+      
+      Or use Ansible to set the token and register:
+      ansible-playbook -i inventory/production.yml \
+        playbooks/register-gitea-runner.yml \
+        -e "gitea_runner_registration_token=<your-token>"
+      
+      ========================================
+  when:
+    - gitea_runner_action | default('fix') == 'fix'
+    - runner_needs_reregistration | bool
+    - gitea_runner_show_status | default(true) | bool
+
+- name: Start runner services (register action)
+  ansible.builtin.shell: |
+    cd {{ gitea_runner_path }}
+    docker compose up -d
+  when: gitea_runner_action | default('fix') == 'register'
+  register: start_services
+  changed_when: start_services.rc == 0
+
+- name: Wait for services to be ready (register action)
+  ansible.builtin.pause:
+    seconds: "{{ gitea_runner_wait_seconds | default(5) }}"
+  when: gitea_runner_action | default('fix') == 'register'
+
+- name: Register runner with correct Gitea instance (register action)
+  ansible.builtin.shell: |
+    cd {{ gitea_runner_path }}
+    docker compose exec -T {{ gitea_runner_container_name }} act_runner register \
+      --instance "{{ gitea_instance_url }}" \
+      --token "{{ gitea_runner_registration_token }}" \
+      --name "{{ gitea_runner_name }}" \
+      --labels "{{ gitea_runner_labels }}"
+  when: gitea_runner_action | default('fix') == 'register'
+  register: register_result
+  no_log: true
+  changed_when: register_result.rc == 0
+
+- name: Display registration result (register action)
+  ansible.builtin.debug:
+    msg: |
+      Runner Registration Result:
+      {{ register_result.stdout | default('No output') }}
+  when:
+    - gitea_runner_action | default('fix') == 'register'
+    - register_result.rc == 0
+    - gitea_runner_show_status | default(true) | bool
+
+- name: Verify .runner file was created (register action)
+  ansible.builtin.stat:
+    path: "{{ gitea_runner_path }}/data/.runner"
+  register: runner_file_created
+  when: gitea_runner_action | default('fix') == 'register'
+
+- name: Check .runner file for correct instance URL (register action)
+  ansible.builtin.shell: |
+    grep -i "{{ gitea_instance_url }}" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "URL_NOT_FOUND"
+  register: runner_url_check
+  when:
+    - gitea_runner_action | default('fix') == 'register'
+    - runner_file_created.stat.exists
+  changed_when: false
+
+- name: Check .runner file for GitHub URLs (register action)
+  ansible.builtin.shell: |
+    grep -i "github.com" "{{ gitea_runner_path }}/data/.runner" 2>/dev/null || echo "NO_GITHUB_URLS"
+  register: runner_github_check
+  when:
+    - gitea_runner_action | default('fix') == 'register'
+    - runner_file_created.stat.exists
+  changed_when: false
+
+- name: Display final status (fix action)
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Gitea Runner Configuration Status
+      ========================================
+      Runner Directory: {{ gitea_runner_path }}
+      Container Running: {{ 'YES' if runner_container_state.stdout == 'running' else 'NO' }}
+      Runner File Exists: {{ 'YES' if runner_file_exists.stat.exists else 'NO' }}
+      Contains GitHub URLs: {{ 'YES' if 'github.com' in (github_urls_check.stdout | default('')) else 'NO' }}
+      .env has correct URL: {{ 'YES' if env_has_correct_url else 'NO' }}
+      Re-registration Needed: {{ 'YES' if runner_needs_reregistration | bool else 'NO' }}
+      ========================================
+      
+      {% if not runner_needs_reregistration | bool %}
+      ✅ Runner configuration looks correct!
+      {% else %}
+      ⚠️  Runner needs to be re-registered with correct Gitea URL
+      {% endif %}
+  when:
+    - gitea_runner_action | default('fix') == 'fix'
+    - gitea_runner_show_status | default(true) | bool
+
+- name: Display final status (register action)
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Gitea Runner Registration Status
+      ========================================
+      Registration: {{ '✅ SUCCESS' if register_result.rc == 0 else '❌ FAILED' }}
+      Runner File Created: {{ '✅ YES' if runner_file_created.stat.exists else '❌ NO' }}
+      Contains Correct URL: {{ '✅ YES' if 'URL_NOT_FOUND' not in runner_url_check.stdout else '❌ NO' }}
+      Contains GitHub URLs: {{ '❌ YES' if 'NO_GITHUB_URLS' not in runner_github_check.stdout else '✅ NO' }}
+      ========================================
+      
+      {% if register_result.rc == 0 and runner_file_created.stat.exists %}
+      ✅ Runner registered successfully with {{ gitea_instance_url }}!
+      
+      Check runner status:
+      {{ gitea_instance_url }}/admin/actions/runners
+      {% else %}
+      ❌ Registration failed. Check logs:
+      docker logs {{ gitea_runner_container_name }}
+      {% endif %}
+  when:
+    - gitea_runner_action | default('fix') == 'register'
+    - gitea_runner_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/gitea/tasks/setup.yml b/deployment/ansible/roles/gitea/tasks/setup.yml
new file mode 100644
index 00000000..ffc086d1
--- /dev/null
+++ b/deployment/ansible/roles/gitea/tasks/setup.yml
@@ -0,0 +1,287 @@
+---
+# Setup Gitea Initial Configuration
+
+- name: Verify Gitea container exists
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml ps {{ gitea_container_name }} | grep -q "{{ gitea_container_name }}"
+  register: gitea_exists
+  changed_when: false
+  failed_when: false
+
+- name: Fail if Gitea container does not exist
+  ansible.builtin.fail:
+    msg: "Gitea container does not exist. Please deploy Gitea stack first using: ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml --tags gitea"
+  when: gitea_exists.rc != 0
+
+- name: Wait for Gitea to be ready
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/healthz"
+    method: GET
+    status_code: [200, 404]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: gitea_health
+  until: gitea_health.status == 200
+  retries: "{{ gitea_setup_health_retries | default(30) }}"
+  delay: "{{ gitea_setup_health_delay | default(5) }}"
+  ignore_errors: yes
+  changed_when: false
+  when: not (gitea_force_update_app_ini | default(false) | bool)
+
+- name: Check if Gitea is already configured
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}"
+    method: GET
+    status_code: [200, 302, 502]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+    follow_redirects: none
+    return_content: yes
+  register: gitea_main_check
+  changed_when: false
+  failed_when: false
+
+- name: Check if app.ini exists in container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} test -f {{ gitea_app_ini_container_path }}
+  register: gitea_app_ini_exists
+  changed_when: false
+  failed_when: false
+
+- name: Check if INSTALL_LOCK is set
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} grep -q "INSTALL_LOCK = true" {{ gitea_app_ini_container_path }} 2>/dev/null || echo "not_set"
+  register: gitea_install_lock_check
+  changed_when: false
+  failed_when: false
+  when: gitea_app_ini_exists.rc == 0
+
+- name: Determine if Gitea needs setup
+  ansible.builtin.set_fact:
+    gitea_needs_setup: "{{ (gitea_force_update_app_ini | default(false) | bool) or ('installation' in (gitea_main_check.content | default('') | lower) or 'initial configuration' in (gitea_main_check.content | default('') | lower)) or (gitea_app_ini_exists.rc != 0) or (gitea_install_lock_check.stdout | default('') | trim == 'not_set') }}"
+    gitea_already_configured: "{{ not (gitea_force_update_app_ini | default(false) | bool) and 'installation' not in (gitea_main_check.content | default('') | lower) and 'initial configuration' not in (gitea_main_check.content | default('') | lower) and gitea_app_ini_exists.rc == 0 and gitea_install_lock_check.stdout | default('') | trim != 'not_set' }}"
+
+- name: Display setup status
+  ansible.builtin.debug:
+    msg: |
+      Gitea Setup Status:
+      - Main page status: {{ gitea_main_check.status }}
+      - app.ini exists: {{ gitea_app_ini_exists.rc == 0 }}
+      - INSTALL_LOCK set: {{ gitea_install_lock_check.stdout | default('unknown') }}
+      - Force update: {{ gitea_force_update_app_ini | default(false) }}
+      - Already configured: {{ gitea_already_configured }}
+      - Needs setup: {{ gitea_needs_setup }}
+  when: gitea_show_status | default(true) | bool
+
+- name: Fail if admin password is not set
+  ansible.builtin.fail:
+    msg: |
+      Gitea admin password is not set in vault.
+      Please set vault_gitea_admin_password in:
+      - deployment/ansible/secrets/production.vault.yml
+      
+      To set it, run:
+      ansible-vault edit secrets/production.vault.yml --vault-password-file secrets/.vault_pass
+      
+      Then add:
+      vault_gitea_admin_password: "your-secure-password"
+  when: 
+    - gitea_needs_setup | bool
+    - gitea_admin_password | default('') | trim == ''
+
+- name: Get Gitea database configuration from environment
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} env | grep -E "^GITEA__database__" || true
+  register: gitea_db_env
+  changed_when: false
+  failed_when: false
+  when: gitea_needs_setup | bool
+
+- name: Parse database configuration
+  ansible.builtin.set_fact:
+    gitea_db_type: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__DB_TYPE=([^\n]+)', '\\1') or ['postgres']) | first }}"
+    gitea_db_host: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__HOST=([^\n]+)', '\\1') or ['postgres:5432']) | first }}"
+    gitea_db_name: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__NAME=([^\n]+)', '\\1') or ['gitea']) | first }}"
+    gitea_db_user: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__USER=([^\n]+)', '\\1') or ['gitea']) | first }}"
+    gitea_db_passwd: "{{ (gitea_db_env.stdout | default('') | regex_search('GITEA__database__PASSWD=([^\n]+)', '\\1') or ['gitea_password']) | first }}"
+  when: gitea_needs_setup | bool
+
+- name: Extract database host and port
+  ansible.builtin.set_fact:
+    gitea_db_hostname: "{{ gitea_db_host.split(':')[0] }}"
+    gitea_db_port: "{{ (gitea_db_host.split(':')[1]) | default('5432') }}"
+  when: gitea_needs_setup | bool
+
+- name: Get Gitea server configuration from environment
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} env | grep -E "^GITEA__server__" || true
+  register: gitea_server_env
+  changed_when: false
+  failed_when: false
+  when: gitea_needs_setup | bool
+
+- name: Parse server configuration
+  ansible.builtin.set_fact:
+    gitea_domain_config: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__DOMAIN=([^\n]+)', '\\1') or [gitea_domain]) | first }}"
+    gitea_root_url: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__ROOT_URL=([^\n]+)', '\\1') or ['https://' + gitea_domain + '/']) | first }}"
+    gitea_ssh_domain: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__SSH_DOMAIN=([^\n]+)', '\\1') or [gitea_domain]) | first }}"
+    gitea_ssh_port: "{{ (gitea_server_env.stdout | default('') | regex_search('GITEA__server__SSH_PORT=([^\n]+)', '\\1') or ['2222']) | first }}"
+  when: gitea_needs_setup | bool
+
+- name: Get Gitea service configuration from environment
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} env | grep -E "^GITEA__service__" || true
+  register: gitea_service_env
+  changed_when: false
+  failed_when: false
+  when: gitea_needs_setup | bool
+
+- name: Parse service configuration
+  ansible.builtin.set_fact:
+    gitea_disable_registration: "{{ (gitea_service_env.stdout | default('') | regex_search('GITEA__service__DISABLE_REGISTRATION=([^\n]+)', '\\1') or ['true']) | first | lower }}"
+  when: gitea_needs_setup | bool
+
+- name: Generate app.ini file
+  ansible.builtin.template:
+    src: "{{ gitea_app_ini_template | default('../../templates/gitea-app.ini.j2') }}"
+    dest: "{{ gitea_app_ini_path }}"
+    mode: '0644'
+  vars:
+    gitea_domain: "{{ gitea_domain_config }}"
+    postgres_db: "{{ gitea_db_name }}"
+    postgres_user: "{{ gitea_db_user }}"
+    postgres_password: "{{ gitea_db_passwd }}"
+    disable_registration: "{{ gitea_disable_registration == 'true' }}"
+    ssh_port: "{{ gitea_ssh_port | int }}"
+    ssh_listen_port: 22
+  when: gitea_needs_setup | bool
+
+- name: Copy app.ini to Gitea container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml cp {{ gitea_app_ini_path }} {{ gitea_container_name }}:{{ gitea_app_ini_container_path }}
+  when: gitea_needs_setup | bool
+  ignore_errors: yes
+
+- name: Wait for container to be ready for exec
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} true
+  register: container_ready
+  until: container_ready.rc == 0
+  retries: "{{ gitea_config_retries | default(30) }}"
+  delay: "{{ gitea_config_delay | default(2) }}"
+  when: 
+    - gitea_needs_setup | bool
+    - not (gitea_force_update_app_ini | default(false) | bool)
+  changed_when: false
+  ignore_errors: yes
+
+- name: Set correct permissions on app.ini in container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} chown 1000:1000 {{ gitea_app_ini_container_path }} && \
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} chmod 644 {{ gitea_app_ini_container_path }}
+  when: gitea_needs_setup | bool
+  ignore_errors: yes
+
+- name: Restart Gitea container
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml restart {{ gitea_container_name }}
+  when: gitea_needs_setup | bool
+  register: gitea_restart
+  changed_when: gitea_restart.rc == 0
+  notify: wait for gitea
+
+- name: Wait for Gitea to be ready after restart
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}/api/healthz"
+    method: GET
+    status_code: [200]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+  register: gitea_health_after_restart
+  until: gitea_health_after_restart.status == 200
+  retries: "{{ gitea_restart_retries | default(30) }}"
+  delay: "{{ gitea_restart_delay | default(5) }}"
+  when: 
+    - not (gitea_force_update_app_ini | default(false) | bool)
+    - gitea_restart.changed | default(false)
+  changed_when: false
+  ignore_errors: yes
+
+- name: Wait for database to be initialized
+  ansible.builtin.pause:
+    seconds: "{{ gitea_setup_db_wait | default(10) }}"
+  when: gitea_needs_setup | bool
+
+- name: Check if admin user already exists
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T {{ gitea_container_name }} \
+      gitea admin user list --admin | grep -q "{{ gitea_admin_username }}" || echo "not_found"
+  register: gitea_admin_exists
+  changed_when: false
+  failed_when: false
+  when: gitea_needs_setup | bool
+
+- name: Create admin user
+  ansible.builtin.shell: |
+    docker compose -f {{ gitea_stack_path }}/docker-compose.yml exec -T --user git {{ gitea_container_name }} \
+      gitea admin user create \
+      --username "{{ gitea_admin_username }}" \
+      --password "{{ gitea_admin_password }}" \
+      --email "{{ gitea_admin_email }}" \
+      --admin \
+      --must-change-password=false
+  register: gitea_admin_create_result
+  when: 
+    - gitea_needs_setup | bool
+    - gitea_admin_exists.stdout | default('') | trim == 'not_found'
+  failed_when: gitea_admin_create_result.rc != 0 and 'already exists' not in (gitea_admin_create_result.stderr | default(''))
+  no_log: true
+
+- name: Verify Gitea is accessible
+  ansible.builtin.uri:
+    url: "{{ gitea_url }}"
+    method: GET
+    status_code: [200, 302]
+    validate_certs: false
+    timeout: "{{ gitea_health_check_timeout | default(10) }}"
+    follow_redirects: none
+  register: gitea_access_check
+  when: gitea_needs_setup | bool
+
+- name: Display success message
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      ✅ Gitea Initial Setup Complete!
+      ========================================
+      Configuration:
+      - app.ini created with INSTALL_LOCK = true
+      - Admin user created: {{ gitea_admin_username }}
+      - Email: {{ gitea_admin_email }}
+      
+      Next steps:
+      1. Access Gitea: {{ gitea_url }}
+      2. Login with:
+         - Username: {{ gitea_admin_username }}
+         - Password: (from vault: vault_gitea_admin_password)
+      3. Configure Gitea Actions Runner (if needed):
+         - Go to: {{ gitea_url }}/admin/actions/runners
+         - Get registration token
+         - Register runner using: deployment/gitea-runner/register.sh
+      ========================================
+  when:
+    - gitea_needs_setup | bool
+    - gitea_show_status | default(true) | bool
+
+- name: Display already configured message
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      ℹ️  Gitea is already configured.
+      ========================================
+      No setup needed. Access Gitea at: {{ gitea_url }}
+      ========================================
+  when:
+    - gitea_already_configured | bool
+    - gitea_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/postgresql-production/defaults/main.yml b/deployment/ansible/roles/postgresql-production/defaults/main.yml
new file mode 100644
index 00000000..58308ffb
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-production/defaults/main.yml
@@ -0,0 +1,21 @@
+---
+# PostgreSQL Production Stack - Default Variables
+
+# Stack path on target host
+postgresql_production_stack_path: "{{ stacks_base_path }}/postgresql-production"
+
+# Wait configuration
+postgresql_production_wait_timeout: "{{ wait_timeout | default(60) }}"
+postgresql_production_wait_interval: 5
+
+# Database configuration (from vault or defaults)
+postgresql_production_db_name: "{{ vault_db_name | default('michaelschiemer') }}"
+postgresql_production_db_user: "{{ vault_db_user | default('postgres') }}"
+postgresql_production_db_password: "{{ vault_db_password | default('') }}"
+
+# Backup configuration
+postgresql_production_backup_retention_days: 7
+postgresql_production_backup_schedule: "0 2 * * *"
+
+# Template used to generate the PostgreSQL .env file
+postgresql_production_env_template: "{{ role_path }}/templates/postgresql.env.j2"
diff --git a/deployment/ansible/roles/postgresql-production/tasks/main.yml b/deployment/ansible/roles/postgresql-production/tasks/main.yml
new file mode 100644
index 00000000..0f366478
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-production/tasks/main.yml
@@ -0,0 +1,69 @@
+---
+- name: Set PostgreSQL Production variables for template
+  ansible.builtin.set_fact:
+    postgres_db: "{{ postgresql_production_db_name }}"
+    postgres_user: "{{ postgresql_production_db_user }}"
+    postgres_password: "{{ postgresql_production_db_password }}"
+    backup_retention_days: "{{ postgresql_production_backup_retention_days }}"
+    backup_schedule: "{{ postgresql_production_backup_schedule }}"
+  no_log: yes
+
+- name: Validate PostgreSQL Production password is set
+  ansible.builtin.fail:
+    msg: |
+      PostgreSQL Production password is not set!
+      
+      Please ensure vault_db_password is defined in:
+      - {{ vault_file | default('inventory/group_vars/production/vault.yml') }}
+      
+      Or pass it via extra vars:
+      -e "postgresql_production_db_password=your-password"
+  when: (postgresql_production_db_password | default('') | string | trim) == ''
+
+- name: Create PostgreSQL Production .env file from vault secrets
+  ansible.builtin.template:
+    src: postgresql.env.j2
+    dest: "{{ postgresql_production_stack_path }}/.env"
+    mode: '0600'
+
+- name: Deploy PostgreSQL Production stack
+  community.docker.docker_compose_v2:
+    project_src: "{{ postgresql_production_stack_path }}"
+    state: present
+    pull: always
+  register: postgresql_production_compose_result
+  ignore_errors: yes
+
+- name: Show PostgreSQL Production logs if deployment failed
+  shell: |
+    docker compose -f {{ postgresql_production_stack_path }}/docker-compose.yml logs --tail=50 postgres-production
+  register: postgresql_production_logs
+  changed_when: false
+  failed_when: false
+  when: postgresql_production_compose_result.failed | default(false)
+
+- name: Display PostgreSQL Production logs on failure
+  ansible.builtin.debug:
+    msg: "{{ postgresql_production_logs.stdout_lines | default([]) }}"
+  when: postgresql_production_compose_result.failed | default(false)
+
+- name: Check PostgreSQL Production container status
+  shell: |
+    docker compose -f {{ postgresql_production_stack_path }}/docker-compose.yml ps postgres-production | grep -Eiq "Up|running|healthy"
+  register: postgresql_production_state
+  changed_when: false
+  until: postgresql_production_state.rc == 0
+  retries: "{{ ((postgresql_production_wait_timeout | int) + (postgresql_production_wait_interval | int) - 1) // (postgresql_production_wait_interval | int) }}"
+  delay: "{{ postgresql_production_wait_interval | int }}"
+  failed_when: postgresql_production_state.rc != 0
+  when: not ansible_check_mode
+
+- name: Fail if PostgreSQL Production deployment failed
+  ansible.builtin.fail:
+    msg: "PostgreSQL Production stack deployment failed. Check logs above for details."
+  when: postgresql_production_compose_result.failed | default(false)
+
+- name: Record PostgreSQL Production deployment facts
+  set_fact:
+    postgresql_production_stack_changed: "{{ postgresql_production_compose_result.changed | default(false) }}"
+    postgresql_production_log_hint: ""
diff --git a/deployment/ansible/roles/postgresql-production/templates/postgresql.env.j2 b/deployment/ansible/roles/postgresql-production/templates/postgresql.env.j2
new file mode 100644
index 00000000..815c5fb2
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-production/templates/postgresql.env.j2
@@ -0,0 +1,14 @@
+# PostgreSQL Stack Configuration
+# Managed by Ansible - DO NOT EDIT MANUALLY
+
+# Timezone
+TZ=Europe/Berlin
+
+# PostgreSQL Configuration
+POSTGRES_DB={{ postgres_db }}
+POSTGRES_USER={{ postgres_user }}
+POSTGRES_PASSWORD={{ postgres_password }}
+
+# Backup Configuration
+BACKUP_RETENTION_DAYS={{ backup_retention_days }}
+BACKUP_SCHEDULE={{ backup_schedule }}
diff --git a/deployment/ansible/roles/postgresql-staging/defaults/main.yml b/deployment/ansible/roles/postgresql-staging/defaults/main.yml
new file mode 100644
index 00000000..72e1c1d2
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-staging/defaults/main.yml
@@ -0,0 +1,21 @@
+---
+# PostgreSQL Staging Stack - Default Variables
+
+# Stack path on target host
+postgresql_staging_stack_path: "{{ stacks_base_path }}/postgresql-staging"
+
+# Wait configuration
+postgresql_staging_wait_timeout: "{{ wait_timeout | default(60) }}"
+postgresql_staging_wait_interval: 5
+
+# Database configuration (from vault or defaults)
+postgresql_staging_db_name: "{{ vault_db_name_staging | default('michaelschiemer_staging') }}"
+postgresql_staging_db_user: "{{ vault_db_user | default('postgres') }}"
+postgresql_staging_db_password: "{{ vault_db_password_staging | default('') }}"
+
+# Backup configuration (shorter retention for staging)
+postgresql_staging_backup_retention_days: 3
+postgresql_staging_backup_schedule: "0 3 * * *"
+
+# Template used to generate the PostgreSQL .env file
+postgresql_staging_env_template: "{{ role_path }}/templates/postgresql.env.j2"
diff --git a/deployment/ansible/roles/postgresql-staging/tasks/main.yml b/deployment/ansible/roles/postgresql-staging/tasks/main.yml
new file mode 100644
index 00000000..e1f5976b
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-staging/tasks/main.yml
@@ -0,0 +1,69 @@
+---
+- name: Set PostgreSQL Staging variables for template
+  ansible.builtin.set_fact:
+    postgres_db: "{{ postgresql_staging_db_name }}"
+    postgres_user: "{{ postgresql_staging_db_user }}"
+    postgres_password: "{{ postgresql_staging_db_password }}"
+    backup_retention_days: "{{ postgresql_staging_backup_retention_days }}"
+    backup_schedule: "{{ postgresql_staging_backup_schedule }}"
+  no_log: yes
+
+- name: Validate PostgreSQL Staging password is set
+  ansible.builtin.fail:
+    msg: |
+      PostgreSQL Staging password is not set!
+      
+      Please ensure vault_db_password_staging is defined in:
+      - {{ vault_file | default('inventory/group_vars/staging/vault.yml') }}
+      
+      Or pass it via extra vars:
+      -e "postgresql_staging_db_password=your-password"
+  when: (postgresql_staging_db_password | default('') | string | trim) == ''
+
+- name: Create PostgreSQL Staging .env file from vault secrets
+  ansible.builtin.template:
+    src: postgresql.env.j2
+    dest: "{{ postgresql_staging_stack_path }}/.env"
+    mode: '0600'
+
+- name: Deploy PostgreSQL Staging stack
+  community.docker.docker_compose_v2:
+    project_src: "{{ postgresql_staging_stack_path }}"
+    state: present
+    pull: always
+  register: postgresql_staging_compose_result
+  ignore_errors: yes
+
+- name: Show PostgreSQL Staging logs if deployment failed
+  shell: |
+    docker compose -f {{ postgresql_staging_stack_path }}/docker-compose.yml logs --tail=50 postgres-staging
+  register: postgresql_staging_logs
+  changed_when: false
+  failed_when: false
+  when: postgresql_staging_compose_result.failed | default(false)
+
+- name: Display PostgreSQL Staging logs on failure
+  ansible.builtin.debug:
+    msg: "{{ postgresql_staging_logs.stdout_lines | default([]) }}"
+  when: postgresql_staging_compose_result.failed | default(false)
+
+- name: Check PostgreSQL Staging container status
+  shell: |
+    docker compose -f {{ postgresql_staging_stack_path }}/docker-compose.yml ps postgres-staging | grep -Eiq "Up|running|healthy"
+  register: postgresql_staging_state
+  changed_when: false
+  until: postgresql_staging_state.rc == 0
+  retries: "{{ ((postgresql_staging_wait_timeout | int) + (postgresql_staging_wait_interval | int) - 1) // (postgresql_staging_wait_interval | int) }}"
+  delay: "{{ postgresql_staging_wait_interval | int }}"
+  failed_when: postgresql_staging_state.rc != 0
+  when: not ansible_check_mode
+
+- name: Fail if PostgreSQL Staging deployment failed
+  ansible.builtin.fail:
+    msg: "PostgreSQL Staging stack deployment failed. Check logs above for details."
+  when: postgresql_staging_compose_result.failed | default(false)
+
+- name: Record PostgreSQL Staging deployment facts
+  set_fact:
+    postgresql_staging_stack_changed: "{{ postgresql_staging_compose_result.changed | default(false) }}"
+    postgresql_staging_log_hint: ""
diff --git a/deployment/ansible/roles/postgresql-staging/templates/postgresql.env.j2 b/deployment/ansible/roles/postgresql-staging/templates/postgresql.env.j2
new file mode 100644
index 00000000..815c5fb2
--- /dev/null
+++ b/deployment/ansible/roles/postgresql-staging/templates/postgresql.env.j2
@@ -0,0 +1,14 @@
+# PostgreSQL Stack Configuration
+# Managed by Ansible - DO NOT EDIT MANUALLY
+
+# Timezone
+TZ=Europe/Berlin
+
+# PostgreSQL Configuration
+POSTGRES_DB={{ postgres_db }}
+POSTGRES_USER={{ postgres_user }}
+POSTGRES_PASSWORD={{ postgres_password }}
+
+# Backup Configuration
+BACKUP_RETENTION_DAYS={{ backup_retention_days }}
+BACKUP_SCHEDULE={{ backup_schedule }}
diff --git a/deployment/ansible/roles/postgresql/tasks/main.yml b/deployment/ansible/roles/postgresql/tasks/main.yml
index 59c0e101..7eeaa6a1 100644
--- a/deployment/ansible/roles/postgresql/tasks/main.yml
+++ b/deployment/ansible/roles/postgresql/tasks/main.yml
@@ -1,4 +1,10 @@
 ---
+- name: Create PostgreSQL .env file from vault secrets
+  ansible.builtin.template:
+    src: postgresql.env.j2
+    dest: "{{ postgresql_stack_path }}/.env"
+    mode: '0600'
+
 - name: Deploy PostgreSQL stack
   community.docker.docker_compose_v2:
     project_src: "{{ postgresql_stack_path }}"
diff --git a/deployment/ansible/roles/postgresql/templates/postgresql.env.j2 b/deployment/ansible/roles/postgresql/templates/postgresql.env.j2
new file mode 100644
index 00000000..b273daac
--- /dev/null
+++ b/deployment/ansible/roles/postgresql/templates/postgresql.env.j2
@@ -0,0 +1,14 @@
+# PostgreSQL Stack Configuration
+# Managed by Ansible - DO NOT EDIT MANUALLY
+
+# Timezone
+TZ=Europe/Berlin
+
+# PostgreSQL Configuration
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD={{ vault_db_password }}
+
+# Backup Configuration
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
diff --git a/deployment/ansible/roles/redis/defaults/main.yml b/deployment/ansible/roles/redis/defaults/main.yml
new file mode 100644
index 00000000..49894931
--- /dev/null
+++ b/deployment/ansible/roles/redis/defaults/main.yml
@@ -0,0 +1,9 @@
+---
+# Redis Role Default Variables
+
+# Redis Stack Path
+redis_stack_path: "{{ stacks_base_path }}/redis"
+
+# Wait Configuration
+redis_wait_timeout: 60
+redis_wait_interval: 5
diff --git a/deployment/ansible/roles/redis/tasks/main.yml b/deployment/ansible/roles/redis/tasks/main.yml
new file mode 100644
index 00000000..e62c31b8
--- /dev/null
+++ b/deployment/ansible/roles/redis/tasks/main.yml
@@ -0,0 +1,49 @@
+---
+- name: Create Redis .env file from vault secrets
+  ansible.builtin.template:
+    src: redis.env.j2
+    dest: "{{ redis_stack_path }}/.env"
+    mode: '0600'
+  tags:
+    - redis
+    - config
+
+- name: Deploy Redis stack
+  community.docker.docker_compose_v2:
+    project_src: "{{ redis_stack_path }}"
+    state: present
+    pull: always
+  register: redis_compose_result
+  tags:
+    - redis
+    - deploy
+
+- name: Wait for Redis to be healthy
+  ansible.builtin.shell: |
+    docker compose -f {{ redis_stack_path }}/docker-compose.yml ps redis-stack | grep -Eiq "Up|running"
+  register: redis_state
+  changed_when: false
+  until: redis_state.rc == 0
+  retries: "{{ ((redis_wait_timeout | int) + (redis_wait_interval | int) - 1) // (redis_wait_interval | int) }}"
+  delay: "{{ redis_wait_interval | int }}"
+  failed_when: redis_state.rc != 0
+  tags:
+    - redis
+    - healthcheck
+
+- name: Test Redis connection
+  ansible.builtin.shell: |
+    docker exec redis-stack redis-cli ping
+  register: redis_ping
+  changed_when: false
+  failed_when: redis_ping.stdout != "PONG"
+  tags:
+    - redis
+    - healthcheck
+
+- name: Set Redis deployment facts
+  ansible.builtin.set_fact:
+    redis_stack_changed: "{{ redis_compose_result.changed }}"
+    redis_stack_healthy: "{{ redis_state.rc == 0 }}"
+  tags:
+    - redis
diff --git a/deployment/ansible/roles/redis/templates/redis.env.j2 b/deployment/ansible/roles/redis/templates/redis.env.j2
new file mode 100644
index 00000000..805d013f
--- /dev/null
+++ b/deployment/ansible/roles/redis/templates/redis.env.j2
@@ -0,0 +1,8 @@
+# Redis Stack Configuration
+# Managed by Ansible - DO NOT EDIT MANUALLY
+
+# Timezone
+TZ=Europe/Berlin
+
+# Redis Password (REQUIRED in production)
+REDIS_PASSWORD={{ vault_redis_password }}
diff --git a/deployment/ansible/roles/registry/tasks/main.yml b/deployment/ansible/roles/registry/tasks/main.yml
index b512d1db..48270bf2 100644
--- a/deployment/ansible/roles/registry/tasks/main.yml
+++ b/deployment/ansible/roles/registry/tasks/main.yml
@@ -45,6 +45,44 @@
       }}
   no_log: true
 
+- name: Generate REGISTRY_HTTP_SECRET if not set
+  set_fact:
+    registry_http_secret: "{{ lookup('password', '/dev/null length=64 chars=hexdigits') }}"
+  no_log: true
+
+- name: Check if Registry .env file exists
+  ansible.builtin.stat:
+    path: "{{ registry_stack_path }}/.env"
+  register: registry_env_file
+
+- name: Read existing REGISTRY_HTTP_SECRET from .env if exists
+  ansible.builtin.shell: |
+    grep '^REGISTRY_HTTP_SECRET=' "{{ registry_stack_path }}/.env" 2>/dev/null | cut -d'=' -f2- || echo ''
+  register: existing_registry_secret
+  changed_when: false
+  failed_when: false
+  when: registry_env_file.stat.exists
+  no_log: true
+
+- name: Use existing REGISTRY_HTTP_SECRET if available
+  set_fact:
+    registry_http_secret: "{{ existing_registry_secret.stdout | default(registry_http_secret) }}"
+  when: 
+    - registry_env_file.stat.exists
+    - existing_registry_secret.stdout | default('') | string | trim != ''
+  no_log: true
+
+- name: Create or update Registry .env file
+  ansible.builtin.lineinfile:
+    path: "{{ registry_stack_path }}/.env"
+    regexp: '^REGISTRY_HTTP_SECRET='
+    line: "REGISTRY_HTTP_SECRET={{ registry_http_secret }}"
+    create: yes
+    mode: '0600'
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+  no_log: true
+
 - name: Create Registry htpasswd file if missing
   shell: |
     docker run --rm --entrypoint htpasswd httpd:2 -Bbn {{ registry_username }} {{ registry_password }} > {{ registry_auth_path }}/htpasswd
diff --git a/deployment/ansible/roles/traefik/handlers/main.yml b/deployment/ansible/roles/traefik/handlers/main.yml
new file mode 100644
index 00000000..cc64332e
--- /dev/null
+++ b/deployment/ansible/roles/traefik/handlers/main.yml
@@ -0,0 +1,8 @@
+---
+# Handlers for Traefik Role
+
+- name: wait for traefik
+  ansible.builtin.wait_for:
+    timeout: "{{ traefik_restart_wait_timeout | default(30) }}"
+  changed_when: false
+
diff --git a/deployment/ansible/roles/traefik/tasks/deploy.yml b/deployment/ansible/roles/traefik/tasks/deploy.yml
new file mode 100644
index 00000000..2492d638
--- /dev/null
+++ b/deployment/ansible/roles/traefik/tasks/deploy.yml
@@ -0,0 +1,82 @@
+---
+- name: Check for existing Traefik containers
+  shell: docker ps -a --filter "name=traefik" --format "{{ '{{' }}.ID{{ '}}' }}"
+  register: existing_traefik_containers
+  changed_when: false
+  failed_when: false
+
+- name: Stop and remove existing Traefik containers
+  shell: docker stop {{ item }} && docker rm {{ item }}
+  loop: "{{ existing_traefik_containers.stdout_lines }}"
+  when: existing_traefik_containers.stdout_lines | length > 0
+  ignore_errors: yes
+
+- name: Check if ports 80 and 443 are in use
+  shell: |
+    if sudo ss -tlnp 'sport = :80' 2>/dev/null | grep -q LISTEN; then
+      echo "port_80_in_use"
+    fi
+    if sudo ss -tlnp 'sport = :443' 2>/dev/null | grep -q LISTEN; then
+      echo "port_443_in_use"
+    fi
+  register: port_check
+  changed_when: false
+  failed_when: false
+
+- name: Display port status
+  debug:
+    msg:
+      - "Port 80 status: {{ 'IN USE' if 'port_80_in_use' in port_check.stdout else 'FREE' }}"
+      - "Port 443 status: {{ 'IN USE' if 'port_443_in_use' in port_check.stdout else 'FREE' }}"
+      - "Note: docker-proxy listening on ports is normal when Traefik container is running"
+
+- name: Warn if ports are blocked by non-docker processes
+  debug:
+    msg: "WARNING: Ports 80/443 appear to be in use. This may prevent Traefik from starting. Check with: sudo ss -tlnp 'sport = :80'"
+  when: ('port_80_in_use' in port_check.stdout or 'port_443_in_use' in port_check.stdout) and existing_traefik_containers.stdout_lines | length == 0
+
+- name: Check if acme.json exists
+  stat:
+    path: "{{ traefik_stack_path }}/acme.json"
+  register: acme_json_stat
+
+- name: Remove acme.json if it's a directory (should be a file)
+  shell: |
+    if [ -d "{{ traefik_stack_path }}/acme.json" ]; then
+      rm -rf "{{ traefik_stack_path }}/acme.json"
+    fi
+  become: yes
+  when: acme_json_stat.stat.exists and acme_json_stat.stat.isdir
+
+- name: Ensure Traefik acme.json exists and has correct permissions
+  file:
+    path: "{{ traefik_stack_path }}/acme.json"
+    state: touch
+    mode: '0600'
+    owner: "{{ ansible_user }}"
+    group: "{{ ansible_user }}"
+  become: yes
+  when: not acme_json_stat.stat.exists or (acme_json_stat.stat.exists and acme_json_stat.stat.isdir)
+
+- name: Deploy Traefik stack
+  community.docker.docker_compose_v2:
+    project_src: "{{ traefik_stack_path }}"
+    state: present
+    pull: always
+  register: traefik_compose_result
+
+- name: Check Traefik container status
+  shell: |
+    docker compose -f {{ traefik_stack_path }}/docker-compose.yml ps traefik | grep -Eiq "Up|running"
+  register: traefik_state
+  changed_when: false
+  until: traefik_state.rc == 0
+  retries: "{{ ((traefik_wait_timeout | int) + (traefik_wait_interval | int) - 1) // (traefik_wait_interval | int) }}"
+  delay: "{{ traefik_wait_interval | int }}"
+  failed_when: traefik_state.rc != 0
+  when: not ansible_check_mode
+
+- name: Record Traefik deployment facts
+  set_fact:
+    traefik_stack_changed: "{{ traefik_compose_result.changed | default(false) }}"
+    traefik_log_hint: ""
diff --git a/deployment/ansible/roles/traefik/tasks/logs.yml b/deployment/ansible/roles/traefik/tasks/logs.yml
new file mode 100644
index 00000000..bce07972
--- /dev/null
+++ b/deployment/ansible/roles/traefik/tasks/logs.yml
@@ -0,0 +1,135 @@
+---
+# Check Traefik Logs and ACME Challenge Status
+
+- name: Check if Traefik stack directory exists
+  ansible.builtin.stat:
+    path: "{{ traefik_stack_path }}"
+  register: traefik_stack_exists
+
+- name: Fail if Traefik stack directory does not exist
+  ansible.builtin.fail:
+    msg: "Traefik stack directory not found at {{ traefik_stack_path }}"
+  when: not traefik_stack_exists.stat.exists
+
+- name: Get recent Traefik logs
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose logs {{ traefik_container_name }} --tail={{ traefik_logs_tail | default(100) }} 2>&1
+  register: traefik_logs
+  changed_when: false
+  failed_when: false
+
+- name: Check for ACME challenge errors in container logs
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose logs {{ traefik_container_name }} 2>&1 | grep -iE "acme.*challenge|Cannot retrieve.*ACME" | tail -{{ traefik_logs_error_tail | default(20) }} || echo "No ACME challenge errors found in recent logs"
+  register: acme_errors
+  changed_when: false
+  failed_when: false
+
+- name: Check for ACME challenge errors in log file
+  ansible.builtin.shell: |
+    tail -n {{ traefik_logs_tail | default(100) }} {{ traefik_stack_path }}/logs/traefik.log 2>/dev/null | grep -iE "acme.*challenge|Cannot retrieve.*ACME" | tail -{{ traefik_logs_error_tail | default(20) }} || echo "No ACME challenge errors found in log file"
+  register: acme_errors_file
+  changed_when: false
+  failed_when: false
+  ignore_errors: yes
+
+- name: Get logs from last N minutes
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose logs {{ traefik_container_name }} --since {{ traefik_logs_since_minutes | default(10) }}m 2>&1 | tail -{{ traefik_logs_recent_tail | default(50) }}
+  register: recent_logs
+  changed_when: false
+  failed_when: false
+  when: traefik_logs_since_minutes is defined
+
+- name: Count ACME challenge errors in last hour
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose logs {{ traefik_container_name }} --since 1h 2>&1 | grep -c "Cannot retrieve.*ACME challenge" || echo "0"
+  register: acme_error_count
+  changed_when: false
+  failed_when: false
+
+- name: Display ACME challenge error summary
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Traefik ACME Challenge Status
+      ========================================
+      ACME Errors (last hour): {{ acme_error_count.stdout }}
+      ========================================
+      
+      {% if acme_error_count.stdout | int > 0 %}
+      ⚠️  ACME challenge errors still occurring
+      {% else %}
+      ✅ No ACME challenge errors in the last hour!
+      {% endif %}
+  when: traefik_show_status | default(true) | bool
+
+- name: Display ACME challenge errors from container logs
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      ACME Challenge Errors (Container Logs):
+      ========================================
+      {{ acme_errors.stdout }}
+      ========================================
+  when: traefik_show_status | default(true) | bool
+
+- name: Display ACME challenge errors from log file
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      ACME Challenge Errors (Log File):
+      ========================================
+      {{ acme_errors_file.stdout }}
+      ========================================
+  when: traefik_show_status | default(true) | bool
+
+- name: Display recent Traefik logs
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Recent Traefik Logs (last {{ traefik_logs_since_minutes | default(10) }} minutes):
+      ========================================
+      {{ recent_logs.stdout | default('No recent logs') }}
+      ========================================
+  when:
+    - traefik_logs_since_minutes is defined
+    - traefik_show_status | default(true) | bool
+
+- name: Display all Traefik logs
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Traefik Container Logs (last {{ traefik_logs_tail | default(100) }} lines):
+      ========================================
+      {{ traefik_logs.stdout | default('No logs available') }}
+      ========================================
+  when:
+    - traefik_show_all_logs | default(false) | bool
+    - traefik_show_status | default(true) | bool
+
+- name: Display final summary
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Summary
+      ========================================
+      {% if acme_error_count.stdout | int == 0 %}
+      ✅ SUCCESS: No ACME challenge errors in the last hour!
+      
+      The Traefik configuration fix appears to be working. Monitor the logs
+      for the next certificate renewal attempt (usually hourly) to confirm.
+      {% else %}
+      ⚠️  WARNING: {{ acme_error_count.stdout }} ACME challenge errors found in the last hour.
+      
+      The errors may be from before the configuration fix was applied.
+      Monitor the logs for the next certificate renewal attempt to see if
+      the errors have stopped.
+      {% endif %}
+      ========================================
+  when: traefik_show_status | default(true) | bool
+
diff --git a/deployment/ansible/roles/traefik/tasks/main.yml b/deployment/ansible/roles/traefik/tasks/main.yml
deleted file mode 100644
index d2700e48..00000000
--- a/deployment/ansible/roles/traefik/tasks/main.yml
+++ /dev/null
@@ -1,23 +0,0 @@
----
-- name: Deploy Traefik stack
-  community.docker.docker_compose_v2:
-    project_src: "{{ traefik_stack_path }}"
-    state: present
-    pull: always
-  register: traefik_compose_result
-
-- name: Check Traefik container status
-  shell: |
-    docker compose -f {{ traefik_stack_path }}/docker-compose.yml ps traefik | grep -Eiq "Up|running"
-  register: traefik_state
-  changed_when: false
-  until: traefik_state.rc == 0
-  retries: "{{ ((traefik_wait_timeout | int) + (traefik_wait_interval | int) - 1) // (traefik_wait_interval | int) }}"
-  delay: "{{ traefik_wait_interval | int }}"
-  failed_when: traefik_state.rc != 0
-  when: not ansible_check_mode
-
-- name: Record Traefik deployment facts
-  set_fact:
-    traefik_stack_changed: "{{ traefik_compose_result.changed | default(false) }}"
-    traefik_log_hint: ""
diff --git a/deployment/ansible/roles/traefik/tasks/restart.yml b/deployment/ansible/roles/traefik/tasks/restart.yml
new file mode 100644
index 00000000..a20b986a
--- /dev/null
+++ b/deployment/ansible/roles/traefik/tasks/restart.yml
@@ -0,0 +1,113 @@
+---
+# Restart and Recreate Traefik Container Tasks
+# Supports both restart (force-recreate) and full recreate (down + up)
+
+- name: Check if Traefik stack directory exists
+  ansible.builtin.stat:
+    path: "{{ traefik_stack_path }}"
+  register: traefik_stack_exists
+
+- name: Fail if Traefik stack directory does not exist
+  ansible.builtin.fail:
+    msg: "Traefik stack directory not found at {{ traefik_stack_path }}"
+  when: not traefik_stack_exists.stat.exists
+
+- name: Check Traefik container status before restart
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose ps {{ traefik_container_name }} --format json
+  register: traefik_status_before
+  changed_when: false
+  failed_when: false
+
+- name: Display Traefik status before restart
+  ansible.builtin.debug:
+    msg: |
+      ================================================================================
+      Traefik Container Status (Before Restart):
+      {{ traefik_status_before.stdout | default('Container not found or Docker not running') }}
+      ================================================================================
+  when: traefik_show_status | default(true) | bool
+
+- name: Recreate Traefik container to apply new configuration
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose up -d --force-recreate {{ traefik_container_name }}
+  register: traefik_restart
+  changed_when: traefik_restart.rc == 0
+  when: traefik_restart_action | default('restart') == 'restart'
+  notify: wait for traefik
+
+- name: Stop and remove Traefik container (full recreate)
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose down {{ traefik_container_name }}
+  register: traefik_down
+  changed_when: traefik_down.rc == 0
+  when: traefik_restart_action | default('restart') == 'recreate'
+
+- name: Create new Traefik container with updated configuration (full recreate)
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose up -d {{ traefik_container_name }}
+  register: traefik_up
+  changed_when: traefik_up.rc == 0
+  when: traefik_restart_action | default('restart') == 'recreate'
+  notify: wait for traefik
+
+- name: Wait for Traefik to be ready
+  ansible.builtin.wait_for:
+    timeout: "{{ traefik_restart_wait_timeout | default(30) }}"
+  changed_when: false
+
+- name: Check Traefik container status after restart
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose ps {{ traefik_container_name }} --format json
+  register: traefik_status_after
+  changed_when: false
+  failed_when: false
+
+- name: Check Traefik health endpoint
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose exec -T {{ traefik_container_name }} traefik healthcheck --ping 2>&1 || echo "HEALTH_CHECK_FAILED"
+  register: traefik_health
+  ignore_errors: yes
+  changed_when: false
+  when: traefik_check_health | default(true) | bool
+
+- name: Check if ACME challenge router is in labels (for recreate action)
+  ansible.builtin.shell: |
+    cd {{ traefik_stack_path }}
+    docker compose ps {{ traefik_container_name }} --format json | jq -r '.[0].Labels' | grep -i 'acme-challenge' || echo "NO_ACME_ROUTER"
+  register: acme_router_check
+  changed_when: false
+  failed_when: false
+  when: traefik_restart_action | default('restart') == 'recreate'
+
+- name: Display final status
+  ansible.builtin.debug:
+    msg: |
+      ========================================
+      Traefik Restart Summary
+      ========================================
+      Action: {{ traefik_restart_action | default('restart') | upper }}
+      Container Status: {% if 'State":"running' in (traefik_status_after.stdout | default('')) %}✅ RUNNING{% else %}❌ NOT RUNNING{% endif %}
+      {% if traefik_check_health | default(true) | bool %}
+      Health Check: {% if 'HEALTH_CHECK_FAILED' not in (traefik_health.stdout | default('')) %}✅ HEALTHY{% else %}❌ UNHEALTHY or TIMEOUT{% endif %}
+      {% endif %}
+      {% if traefik_restart_action | default('restart') == 'recreate' %}
+      ACME Challenge Router: {% if 'NO_ACME_ROUTER' in acme_router_check.stdout %}✅ REMOVED (correct!){% else %}⚠️  Still present in labels{% endif %}
+      {% endif %}
+      Restart Action: {% if (traefik_restart.changed | default(false)) or (traefik_up.changed | default(false)) %}🔄 Container restarted{% else %}ℹ️ No restart needed{% endif %}
+      ========================================
+      {% if 'State":"running' in (traefik_status_after.stdout | default('')) %}
+      ✅ Traefik is running!
+      {% else %}
+      ❌ Traefik is not running. Check logs for details:
+      docker logs {{ traefik_container_name }}
+      {% endif %}
+      ========================================
+  when: traefik_show_status | default(true) | bool
+
diff --git a/deployment/ansible/scripts/add-registry-password-to-vault.sh b/deployment/ansible/scripts/add-registry-password-to-vault.sh
new file mode 100755
index 00000000..4a7464e9
--- /dev/null
+++ b/deployment/ansible/scripts/add-registry-password-to-vault.sh
@@ -0,0 +1,119 @@
+#!/bin/bash
+# Script to extract registry password from server and add it to vault
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ANSIBLE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+VAULT_FILE="$ANSIBLE_DIR/secrets/production.vault.yml"
+VAULT_PASS_FILE="$ANSIBLE_DIR/secrets/.vault_pass"
+
+# Check if vault file exists
+if [ ! -f "$VAULT_FILE" ]; then
+    echo "❌ Vault file not found: $VAULT_FILE"
+    exit 1
+fi
+
+# Check if vault password file exists
+if [ ! -f "$VAULT_PASS_FILE" ]; then
+    echo "❌ Vault password file not found: $VAULT_PASS_FILE"
+    echo "Please create it or use --ask-vault-pass"
+    exit 1
+fi
+
+echo "📋 Extracting registry password from server..."
+echo ""
+
+# Read inventory file to get server connection details
+INVENTORY_FILE="$ANSIBLE_DIR/inventory/production.yml"
+if [ ! -f "$INVENTORY_FILE" ]; then
+    echo "❌ Inventory file not found: $INVENTORY_FILE"
+    exit 1
+fi
+
+# Extract server hostname
+SERVER_HOST=$(grep -E '^[[:space:]]*ansible_host:' "$INVENTORY_FILE" | awk '{print $2}' | head -1)
+DEPLOY_USER=$(grep -E '^[[:space:]]*ansible_user:' "$INVENTORY_FILE" | awk '{print $2}' | head -1 || echo "deploy")
+
+if [ -z "$SERVER_HOST" ]; then
+    echo "❌ Could not determine server hostname from inventory"
+    exit 1
+fi
+
+echo "Server: $SERVER_HOST"
+echo "User: $DEPLOY_USER"
+echo ""
+
+# Try to extract password from registry .env file on server
+REGISTRY_ENV_PATH="/home/$DEPLOY_USER/deployment/stacks/registry/.env"
+
+echo "Attempting to extract password from: $REGISTRY_ENV_PATH"
+echo ""
+
+# Use SSH to read the password (assuming SSH key is configured)
+REGISTRY_PASSWORD=$(ssh "${DEPLOY_USER}@${SERVER_HOST}" "grep '^REGISTRY_AUTH_HTPASSWD_REALM=' $REGISTRY_ENV_PATH 2>/dev/null | cut -d'=' -f2- | head -1" 2>/dev/null || echo "")
+
+if [ -z "$REGISTRY_PASSWORD" ]; then
+    echo "⚠️  Could not extract password from server .env file"
+    echo ""
+    echo "Generating new registry password..."
+    REGISTRY_PASSWORD=$(openssl rand -base64 32 | tr -d "=+/" | cut -c1-32)
+    echo "Generated password: ${REGISTRY_PASSWORD:0:8}..."
+    echo ""
+    echo "⚠️  Note: This is a NEW password. If the registry is already deployed,"
+    echo "   you may need to update the registry .env file on the server."
+else
+    # Extract username from htpasswd format (username:password)
+    # The format is usually: username:$apr1$salt$hash
+    # We need to extract just the password part
+    echo "✅ Found password in registry .env file"
+    echo "   (Password format: htpasswd hash)"
+    echo ""
+    echo "⚠️  Note: The password in .env is in htpasswd format."
+    echo "   We need the plain password to add to vault."
+    echo ""
+    read -p "Enter the plain registry password (or press Enter to generate new): " REGISTRY_PASSWORD_INPUT
+    
+    if [ -n "$REGISTRY_PASSWORD_INPUT" ]; then
+        REGISTRY_PASSWORD="$REGISTRY_PASSWORD_INPUT"
+    else
+        echo "Generating new registry password..."
+        REGISTRY_PASSWORD=$(openssl rand -base64 32 | tr -d "=+/" | cut -c1-32)
+        echo "Generated password: ${REGISTRY_PASSWORD:0:8}..."
+    fi
+fi
+
+echo ""
+echo "Adding password to vault file..."
+echo ""
+
+# Check if vault_docker_registry_password already exists
+if ansible-vault view "$VAULT_FILE" --vault-password-file "$VAULT_PASS_FILE" 2>/dev/null | grep -q "vault_docker_registry_password:"; then
+    echo "⚠️  vault_docker_registry_password already exists in vault"
+    read -p "Replace it? (y/N): " REPLACE
+    if [ "$REPLACE" != "y" ] && [ "$REPLACE" != "Y" ]; then
+        echo "Aborted."
+        exit 0
+    fi
+    
+    # Replace existing password
+    ansible-vault view "$VAULT_FILE" --vault-password-file "$VAULT_PASS_FILE" | \
+        sed "s/^vault_docker_registry_password:.*/vault_docker_registry_password: \"$REGISTRY_PASSWORD\"/" | \
+        ansible-vault encrypt --vault-password-file "$VAULT_PASS_FILE" --output "$VAULT_FILE" -
+else
+    # Add new password
+    ansible-vault view "$VAULT_FILE" --vault-password-file "$VAULT_PASS_FILE" | \
+        sed "/^vault_/a vault_docker_registry_password: \"$REGISTRY_PASSWORD\"" | \
+        ansible-vault encrypt --vault-password-file "$VAULT_PASS_FILE" --output "$VAULT_FILE" -
+fi
+
+echo ""
+echo "✅ Password added to vault file!"
+echo ""
+echo "Next steps:"
+echo "1. Verify the password is set:"
+echo "   ansible-vault view $VAULT_FILE --vault-password-file $VAULT_PASS_FILE | grep vault_docker_registry_password"
+echo ""
+echo "2. Re-run the playbook:"
+echo "   ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml --vault-password-file $VAULT_PASS_FILE"
+
diff --git a/deployment/ansible/scripts/init-secrets.sh b/deployment/ansible/scripts/init-secrets.sh
index 5a4e7770..75705b93 100755
--- a/deployment/ansible/scripts/init-secrets.sh
+++ b/deployment/ansible/scripts/init-secrets.sh
@@ -8,6 +8,17 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ANSIBLE_DIR="$(dirname "$SCRIPT_DIR")"
 SECRETS_DIR="$ANSIBLE_DIR/secrets"
 
+# Helper function to generate random passwords
+generate_password() {
+    local length=${1:-32}
+    openssl rand -base64 "$length" | tr -d "=+/" | cut -c1-"$length"
+}
+
+# Generate base64-encoded 32-byte key for APP_KEY
+generate_app_key() {
+    openssl rand -base64 32
+}
+
 echo "🔐 Ansible Secrets Initialization"
 echo "=================================="
 echo ""
@@ -80,11 +91,56 @@ else
     cp "$SECRETS_DIR/production.vault.yml.example" "$SECRETS_DIR/production.vault.yml"
 
     echo ""
-    echo "⚠️  IMPORTANT: You must edit the vault file and replace all 'change-me' values!"
-    echo ""
-    read -p "Press ENTER to edit the vault file now..."
+    echo "Generating secure passwords for all secrets..."
+    
+    # Generate all passwords
+    DB_PASSWORD=$(generate_password 32)
+    DB_ROOT_PASSWORD=$(generate_password 32)
+    REDIS_PASSWORD=$(generate_password 32)
+    APP_KEY=$(generate_app_key)
+    JWT_SECRET=$(generate_password 32)
+    MAIL_PASSWORD=$(generate_password 24)
+    REGISTRY_PASSWORD=$(generate_password 32)
+    ENCRYPTION_KEY=$(generate_password 32)
+    SESSION_SECRET=$(generate_password 32)
+    GRAFANA_PASSWORD=$(generate_password 24)
+    PROMETHEUS_PASSWORD=$(generate_password 24)
+    MINIO_PASSWORD=$(generate_password 32)
 
-    ${EDITOR:-nano} "$SECRETS_DIR/production.vault.yml"
+    # Replace all placeholders with generated passwords
+    sed -i "s|change-me-secure-db-password|$DB_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-secure-root-password|$DB_ROOT_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-secure-redis-password|$REDIS_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-base64-encoded-32-byte-key|$APP_KEY|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-jwt-signing-secret|$JWT_SECRET|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-mail-password|$MAIL_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-registry-password|$REGISTRY_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-encryption-key|$ENCRYPTION_KEY|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-session-secret|$SESSION_SECRET|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-secure-grafana-password|$GRAFANA_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-secure-prometheus-password|$PROMETHEUS_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+    sed -i "s|change-me-secure-minio-password|$MINIO_PASSWORD|g" "$SECRETS_DIR/production.vault.yml"
+
+    # Replace Git Token placeholder with empty string first (will be set to actual token or stay empty)
+    sed -i "s|change-me-gitea-personal-access-token||g" "$SECRETS_DIR/production.vault.yml"
+    
+    echo "✅ All passwords generated and replaced"
+    echo ""
+
+    # Optional: Ask for Git Token
+    read -p "Do you have a Gitea Personal Access Token? (y/N): " -n 1 -r
+    echo
+    GIT_TOKEN_SET=false
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        read -sp "Enter Git Token: " GIT_TOKEN
+        echo
+        # Replace empty value with actual token
+        sed -i "s|vault_git_token: \"\"|vault_git_token: \"$GIT_TOKEN\"|g" "$SECRETS_DIR/production.vault.yml"
+        echo "✅ Git Token set"
+        GIT_TOKEN_SET=true
+    else
+        echo "⚠️  Git Token not set. You can add it later with: ansible-vault edit secrets/production.vault.yml"
+    fi
 
     echo ""
     echo "Encrypting vault file..."
@@ -92,6 +148,34 @@ else
         --vault-password-file "$SECRETS_DIR/.vault_pass"
 
     echo "✅ Production vault file created and encrypted"
+    
+    # Save passwords to file (gitignored) for reference
+    PASSWORDS_FILE="$SECRETS_DIR/.vault-passwords.txt"
+    cat > "$PASSWORDS_FILE" <<EOF
+# Generated passwords for production.vault.yml
+# DO NOT COMMIT THIS FILE!
+# Generated: $(date)
+
+vault_db_password: $DB_PASSWORD
+vault_db_root_password: $DB_ROOT_PASSWORD
+vault_redis_password: $REDIS_PASSWORD
+vault_app_key: $APP_KEY
+vault_jwt_secret: $JWT_SECRET
+vault_mail_password: $MAIL_PASSWORD
+vault_docker_registry_password: $REGISTRY_PASSWORD
+vault_encryption_key: $ENCRYPTION_KEY
+vault_session_secret: $SESSION_SECRET
+vault_grafana_admin_password: $GRAFANA_PASSWORD
+vault_prometheus_password: $PROMETHEUS_PASSWORD
+vault_minio_root_password: $MINIO_PASSWORD
+EOF
+    if [ "$GIT_TOKEN_SET" = true ]; then
+        echo "vault_git_token: $GIT_TOKEN" >> "$PASSWORDS_FILE"
+    else
+        echo "vault_git_token: (not set)" >> "$PASSWORDS_FILE"
+    fi
+    chmod 600 "$PASSWORDS_FILE"
+    echo "✅ Passwords saved to $PASSWORDS_FILE (for reference only - DO NOT COMMIT!)"
 fi
 
 echo ""
@@ -116,7 +200,8 @@ EXAMPLE_VALUES=$(ansible-vault view "$SECRETS_DIR/production.vault.yml" \
 
 if [ "$EXAMPLE_VALUES" -gt 0 ]; then
     echo "⚠️  WARNING: Found $EXAMPLE_VALUES 'change-me' placeholder values!"
-    echo "   You must replace these before deploying to production."
+    echo "   These should have been replaced automatically."
+    echo "   You may need to run the script again or edit manually."
     echo ""
     read -p "Do you want to edit the vault file now? (y/N): " -n 1 -r
     echo
@@ -125,7 +210,7 @@ if [ "$EXAMPLE_VALUES" -gt 0 ]; then
             --vault-password-file "$SECRETS_DIR/.vault_pass"
     fi
 else
-    echo "✅ No placeholder values found"
+    echo "✅ No placeholder values found - all secrets are set"
 fi
 
 echo ""
diff --git a/deployment/ansible/scripts/set-git-credentials.sh b/deployment/ansible/scripts/set-git-credentials.sh
index fa02b0b6..4efdcef8 100755
--- a/deployment/ansible/scripts/set-git-credentials.sh
+++ b/deployment/ansible/scripts/set-git-credentials.sh
@@ -16,7 +16,7 @@ case $choice in
   1)
     read -p "Enter Gitea Personal Access Token: " token
     ansible production -i inventory/production.yml -m lineinfile \
-      -a "path=~/deployment/stacks/application/.env regexp='^GIT_TOKEN=' line='GIT_TOKEN=$token' state=present" 2>&1
+      -a "path=~/deployment/stacks/production/.env regexp='^GIT_TOKEN=' line='GIT_TOKEN=$token' state=present" 2>&1
     echo "✅ GIT_TOKEN set successfully"
     ;;
   2)
@@ -24,9 +24,9 @@ case $choice in
     read -s -p "Enter Gitea Password: " password
     echo ""
     ansible production -i inventory/production.yml -m lineinfile \
-      -a "path=~/deployment/stacks/application/.env regexp='^GIT_USERNAME=' line='GIT_USERNAME=$username' state=present" 2>&1
+      -a "path=~/deployment/stacks/production/.env regexp='^GIT_USERNAME=' line='GIT_USERNAME=$username' state=present" 2>&1
     ansible production -i inventory/production.yml -m lineinfile \
-      -a "path=~/deployment/stacks/application/.env regexp='^GIT_PASSWORD=' line='GIT_PASSWORD=$password' state=present" 2>&1
+      -a "path=~/deployment/stacks/production/.env regexp='^GIT_PASSWORD=' line='GIT_PASSWORD=$password' state=present" 2>&1
     echo "✅ GIT_USERNAME and GIT_PASSWORD set successfully"
     ;;
   *)
diff --git a/deployment/ansible/secrets/production.vault.yml.old b/deployment/ansible/secrets/production.vault.yml.old
new file mode 100644
index 00000000..56392011
--- /dev/null
+++ b/deployment/ansible/secrets/production.vault.yml.old
@@ -0,0 +1,46 @@
+$ANSIBLE_VAULT;1.1;AES256
+39656535393561643462336438333664303261356161356534343261633137356238613434623432
+3938623233343033613435346439333139333337346230650a383830393334663537393032333536
+33326664623965663563363961373734396461633861613533363564346666343234636430303461
+3633353562316639340a316237333562373538373331333438393734656165376166393030373632
+65363562343661653933623961326638393531386137383561643330376431366239653334333939
+30616331333430643530666161376362613537393432356661376564383139383736626631353362
+37396634626230623934393536326433643338663030393065363166306166323534393565313136
+32313163643930363736306662636666663631323866376663333461626233303164663831356133
+61633737393835623938613262633039626637343734323262373433366637646137623530653661
+37666537306161653231616339386236393838653263623462343535653833393162653339336638
+64643864646365343038363630663739653563346431656332626265356434396261376566633731
+31333462326564396165623565643335366263366466376439356162353161623564346537663033
+39353638333866313937626535303138393762373333363666616364656430633864653333643639
+39326566323939326461653834663064326130376139393938376239333936633365346434373164
+38303534663433373939323738623362383437343334636634333738666337353466386361313235
+33626163343964393539366634653763366461303535386535313034383061386364373536393734
+35343061663764363439626136316439383637303837636664623031633836616234613534643933
+64636131633665626439376361353864336665373165366466306236373864613131353463613036
+65383261623438343935356162363566643539323635393235353937656463366265393363646433
+62373563373636313833326536636236366639323639653936366635346562666336323463376439
+33613866623261666436303635353232363961613135363735313163653332313332393164633334
+31626464623935303332316435373631383262613839336564373836643661376265316139633638
+31663363303832613661396135636266396639663832326635326463353130353165333534316137
+30613932353865333539313762323435306263323530393063313664336239663833356139396436
+34303036303634643164613534376432386433386231633465303338333936643737656639386538
+36313563663264636430613333613363303566653965653566356662343534323935323563306234
+63366232373738393734363432623963336265356336653335336663633934353565323433666439
+39393036353130336535653033323733656230373865653834653139333336303633623830316331
+64633137633561316231373836643432663266363833323763323737323638383361643263386335
+33633939393864383935356334653036336566633164333962636233633535303164356639356230
+36316361386231626335353038333636336434306338333662666635663832356339313937303266
+66386436353231656133363365383538643932396166303837313066636431613135346430353237
+30343766613530313637366533363031363338366135663038663330316434636339356462373430
+30313064613434346632366532373837383531313137636539643966363539356435613336396634
+62653538326566333636316664616136663765633038306466303935383964373834363365626265
+66633431313638356266633238336363303462633735363838646132616132386639663532656261
+35623834636536373631376638303464313266363636383164353239333330653232323539383635
+66643964653964633662653565353262376635356639653264303931383439396162373933356264
+32663732353565643837313436626630646664366531663737626664306131393233636435353130
+65313937373734666234396164386435336138386462663731323266396463383532393865386131
+30373736353361336135356332623739326233643565666234356435376563316236633363356638
+37343661633038653134313166346336626435353565353661653839356137303430383565623431
+36386530373264306133373532396132336530353565636134616637353230393332396431623332
+33316562363762333337326466313035313938613164326264366262653139393934373563373537
+3361
diff --git a/deployment/ansible/show-nginx-volumes.sh b/deployment/ansible/show-nginx-volumes.sh
index 7a023e52..e86cf92b 100755
--- a/deployment/ansible/show-nginx-volumes.sh
+++ b/deployment/ansible/show-nginx-volumes.sh
@@ -10,11 +10,11 @@ echo ""
 
 # Solution 1: Use sed to extract the full nginx block, then grep for volumes
 timeout 90 ansible production -i inventory/production.yml -m shell -a \
-  "cd ~/deployment/stacks/application && docker compose config 2>&1 | sed -n '/^  nginx:/,/^  [a-z]/p' | grep -A 10 'volumes:'" \
+  "cd ~/deployment/stacks/production && docker compose config 2>&1 | sed -n '/^  nginx:/,/^  [a-z]/p' | grep -A 10 'volumes:'" \
   2>&1 || {
     echo ""
     echo "⚠️  Alternative method: Using larger grep context..."
     timeout 90 ansible production -i inventory/production.yml -m shell -a \
-      "cd ~/deployment/stacks/application && docker compose config 2>&1 | grep -A 50 'nginx:' | grep -A 10 'volumes:'" \
+      "cd ~/deployment/stacks/production && docker compose config 2>&1 | grep -A 50 'nginx:' | grep -A 10 'volumes:'" \
       2>&1
 }
diff --git a/deployment/ansible/templates/application.env.j2 b/deployment/ansible/templates/application.env.j2
index 063f5ead..d5754f19 100644
--- a/deployment/ansible/templates/application.env.j2
+++ b/deployment/ansible/templates/application.env.j2
@@ -5,7 +5,7 @@
 TZ={{ timezone | default('Europe/Berlin') }}
 
 # Application Domain
-APP_DOMAIN={{ app_domain }}
+APP_DOMAIN={{ app_domain | default('michaelschiemer.de') }}
 
 # Application Settings
 APP_ENV={{ app_env | default('production') }}
@@ -21,9 +21,9 @@ APP_SSL_PORT={{ app_ssl_port | default('443') }}
 FORCE_HTTPS={{ force_https | default('true') }}
 
 # Database Configuration
-# Using PostgreSQL from postgres stack
+# Using PostgreSQL from separate production/staging stacks
 DB_DRIVER={{ db_driver | default('pgsql') }}
-DB_HOST={{ db_host | default('postgres') }}
+DB_HOST={{ db_host | default(db_host_default | default('postgres-production' if app_env == 'production' else 'postgres-staging' if app_env == 'staging' else 'postgres')) }}
 DB_PORT={{ db_port | default('5432') }}
 DB_DATABASE={{ db_name | default(db_name_default) }}
 DB_USERNAME={{ db_user | default(db_user_default) }}
@@ -79,3 +79,7 @@ GIT_BRANCH={{ git_branch | default('main') }}
 GIT_TOKEN_FILE=/run/secrets/git_token
 GIT_USERNAME={{ git_username | default('') }}
 GIT_PASSWORD={{ git_password | default('') }}
+
+# MinIO Object Storage Configuration (optional)
+MINIO_ROOT_USER={{ minio_root_user | default('minioadmin') }}
+MINIO_ROOT_PASSWORD={{ minio_root_password | default('') }}
diff --git a/deployment/ansible/templates/gitea-app.ini.j2 b/deployment/ansible/templates/gitea-app.ini.j2
index f9fb5fbe..8492cc99 100644
--- a/deployment/ansible/templates/gitea-app.ini.j2
+++ b/deployment/ansible/templates/gitea-app.ini.j2
@@ -1,13 +1,14 @@
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Gitea Configuration File
+;; Gitea Configuration File - Minimal Version
 ;; Generated by Ansible - DO NOT EDIT MANUALLY
-;; This file is based on the official Gitea example configuration
-;; https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini
+;; 
+;; IMPORTANT: This is a minimal configuration. Cache, Session, Queue, and other
+;; settings are controlled via GITEA__... environment variables in docker-compose.yml
+;; which override these settings on every container start.
+;; 
+;; Only essential values are included here to skip installation and enable basic functionality.
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; General Settings
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 APP_NAME = Gitea: Git with a cup of tea
 RUN_MODE = prod
 
@@ -20,18 +21,6 @@ DOMAIN = {{ gitea_domain }}
 HTTP_ADDR = 0.0.0.0
 HTTP_PORT = 3000
 ROOT_URL = https://{{ gitea_domain }}/
-PUBLIC_URL_DETECTION = auto
-;; Performance settings for handling concurrent requests
-LFS_START_SERVER = true
-LFS_CONTENT_PATH = data/lfs
-LFS_JWT_SECRET = 
-;; Increase timeouts for better stability under load
-READ_TIMEOUT = 60s
-WRITE_TIMEOUT = 60s
-
-;; SSH Configuration
-;; Note: SSH_LISTEN_PORT should match the port exposed in docker-compose.yml
-;; If SSH is not needed, set DISABLE_SSH = true and START_SSH_SERVER = false
 DISABLE_SSH = false
 START_SSH_SERVER = false
 SSH_DOMAIN = {{ gitea_domain }}
@@ -48,45 +37,12 @@ NAME = {{ postgres_db | default('gitea') }}
 USER = {{ postgres_user | default('gitea') }}
 PASSWD = {{ postgres_password | default('gitea_password') }}
 SSL_MODE = disable
-;; Connection Pool Settings - Prevents "Connection reset by peer" errors
-;; Increased limits for handling concurrent requests
-MAX_OPEN_CONNS = 200
-MAX_IDLE_CONNS = 50
-CONN_MAX_LIFETIME = 600
-CONN_MAX_IDLE_TIME = 300
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Cache Configuration
+;; Security Configuration
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[cache]
-ENABLED = true
-ADAPTER = redis
-HOST = redis:6379
-PASSWORD = {{ redis_password | default('gitea_redis_password') }}
-DB = 0
-;; Redis cache for better performance and persistence
-;; Cache survives container restarts
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Session Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[session]
-PROVIDER = redis
-PROVIDER_CONFIG = network=tcp,addr=redis:6379,password={{ redis_password | default('gitea_redis_password') }},db=0,pool_size=100,idle_timeout=180
-COOKIE_SECURE = true
-COOKIE_NAME = i_like_gitea
-GC_INTERVAL_TIME = 86400
-SESSION_LIFE_TIME = 86400
-;; Redis sessions for better performance and scalability
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Queue Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[queue]
-TYPE = redis
-CONN_STR = redis://:{{ redis_password | default('gitea_redis_password') }}@redis:6379/0
-;; Redis queue for persistent job processing
-;; Jobs survive container restarts
+[security]
+INSTALL_LOCK = true
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; Service Configuration
@@ -99,14 +55,8 @@ DISABLE_REGISTRATION = {{ disable_registration | default(true) | lower }}
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 [actions]
 ENABLED = true
-;; Use "self" to use the current Gitea instance for actions (not GitHub)
-;; Do NOT set DEFAULT_ACTIONS_URL to a custom URL - it's not supported
-;; Leaving it unset or setting to "self" will use the current instance
-;DEFAULT_ACTIONS_URL = self
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Security Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[security]
-;; Set INSTALL_LOCK to true to skip the initial setup page
-INSTALL_LOCK = true
\ No newline at end of file
+;; Cache Configuration
+;; NOTE: Cache configuration is controlled via GITEA__cache__ environment variables
+;; in docker-compose.yml. Do NOT add [cache] section here, as it may cause conflicts.
\ No newline at end of file
diff --git a/deployment/ansible/test-nginx-volumes.sh b/deployment/ansible/test-nginx-volumes.sh
index d28eba67..13c54603 100755
--- a/deployment/ansible/test-nginx-volumes.sh
+++ b/deployment/ansible/test-nginx-volumes.sh
@@ -9,9 +9,9 @@ echo "Testing nginx volumes configuration..."
 echo "Timeout: 90 seconds"
 echo ""
 
-timeout 90 ansible production -i inventory/production.yml -m shell -a "cd ~/deployment/stacks/application && docker compose config 2>&1 | sed -n '/^  nginx:/,/^  [a-z]/p' | grep -A 10 'volumes:'" 2>&1 || {
+timeout 90 ansible production -i inventory/production.yml -m shell -a "cd ~/deployment/stacks/production && docker compose config 2>&1 | sed -n '/^  nginx:/,/^  [a-z]/p' | grep -A 10 'volumes:'" 2>&1 || {
     echo ""
     echo "⚠️  Command timed out or failed!"
     echo "Checking if docker compose is working..."
-    timeout 30 ansible production -i inventory/production.yml -m shell -a "cd ~/deployment/stacks/application && docker compose config 2>&1 | head -5" || true
+    timeout 30 ansible production -i inventory/production.yml -m shell -a "cd ~/deployment/stacks/production && docker compose config 2>&1 | head -5" || true
 }
diff --git a/deployment/docs/guides/ansible-vs-bash-scripts.md b/deployment/docs/guides/ansible-vs-bash-scripts.md
new file mode 100644
index 00000000..5309fc8e
--- /dev/null
+++ b/deployment/docs/guides/ansible-vs-bash-scripts.md
@@ -0,0 +1,161 @@
+# Ansible vs. Bash-Scripts: Empfehlung
+
+## Aktuelle Situation
+
+### Bash-Scripts (Quick-Start)
+- ✅ `deployment/scripts/staging-quick-start.sh`
+- ✅ `deployment/scripts/production-quick-start.sh`
+- **Zweck**: Schnelle, interaktive Tests und Verifikationen
+
+### Ansible (Deployment)
+- ✅ `deployment/ansible/playbooks/setup-staging.yml`
+- ✅ `deployment/ansible/playbooks/setup-infrastructure.yml`
+- ✅ `deployment/ansible/playbooks/backup.yml`
+- **Zweck**: Strukturierte Deployments, Wartung, Automatisierung
+
+## Vergleich
+
+### Bash-Scripts
+
+**Vorteile:**
+- ✅ **Einfach**: Keine Dependencies, direkt ausführbar
+- ✅ **Schnell**: Sofortige Ausführung, kein Setup nötig
+- ✅ **Interaktiv**: Menü-basiert, benutzerfreundlich
+- ✅ **Flexibel**: Einfache Anpassungen möglich
+- ✅ **Debugging**: Einfach zu debuggen, direkte Ausgabe
+
+**Nachteile:**
+- ❌ **Nicht idempotent**: Mehrfache Ausführung kann Probleme verursachen
+- ❌ **Wartung**: Schwerer zu warten bei komplexen Logiken
+- ❌ **Fehlerbehandlung**: Manuelle Fehlerbehandlung nötig
+- ❌ **Dokumentation**: Code als Dokumentation, weniger strukturiert
+- ❌ **Wiederverwendbarkeit**: Schwerer in andere Kontexte zu integrieren
+
+### Ansible
+
+**Vorteile:**
+- ✅ **Idempotent**: Mehrfache Ausführung sicher
+- ✅ **Strukturiert**: Klare Rollen, Tasks, Variablen
+- ✅ **Wartbar**: Einfacher zu erweitern und zu warten
+- ✅ **Fehlerbehandlung**: Integrierte Retry-Logik, bessere Fehlermeldungen
+- ✅ **Dokumentation**: Selbst-dokumentierend durch Tasks
+- ✅ **Wiederverwendbar**: Tasks können in verschiedenen Playbooks genutzt werden
+- ✅ **Konsistent**: Gleiche Tools wie für Deployment
+- ✅ **Testing**: Ansible-Lint, Syntax-Checks, etc.
+
+**Nachteile:**
+- ❌ **Setup**: Ansible muss installiert sein
+- ❌ **Komplexität**: Etwas komplexer für einfache Tasks
+- ❌ **Interaktivität**: Weniger interaktiv (aber möglich mit `ansible-prompt`)
+
+## Empfehlung: Hybrid-Ansatz
+
+### Für was Bash-Scripts nutzen?
+
+**Gut für:**
+- ✅ **Schnelle Verifikationen**: Container-Status, Logs anzeigen
+- ✅ **Interaktive Tests**: Menü-basierte Auswahl
+- ✅ **Debugging**: Ad-hoc-Tasks während Problemlösung
+- ✅ **Entwickler-Freundlich**: Keine Ansible-Kenntnisse nötig
+
+**Beispiele:**
+- Container-Status prüfen
+- Logs anzeigen
+- Health-Checks durchführen
+- Netzwerk-Verbindungen testen
+
+### Für was Ansible nutzen?
+
+**Gut für:**
+- ✅ **Deployments**: Strukturierte, wiederholbare Deployments
+- ✅ **Setup**: Initiales Setup von Stacks
+- ✅ **Wartung**: Regelmäßige Wartungsaufgaben
+- ✅ **Backups**: Automatisierte Backup-Prozesse
+- ✅ **CI/CD-Integration**: In Pipelines integrierbar
+
+**Beispiele:**
+- Stack-Deployment
+- Konfiguration-Management
+- Backup-Automatisierung
+- System-Updates
+
+## Langfristige Strategie
+
+### Phase 1: Aktuell (Hybrid)
+- **Bash-Scripts**: Für schnelle Verifikationen und interaktive Tests
+- **Ansible**: Für Deployments und Wartung
+
+### Phase 2: Erweiterung (Empfohlen)
+- **Ansible-Playbooks erweitern**: Mehr Verifikations-Tasks
+- **Bash-Scripts behalten**: Für interaktive, ad-hoc-Tasks
+
+### Phase 3: Konsolidierung (Optional)
+- **Ansible als primäres Tool**: Alle Tasks als Ansible-Playbooks
+- **Bash-Scripts als Wrapper**: Dünne Wrapper um Ansible-Playbooks
+
+## Konkrete Empfehlung
+
+### Kurzfristig (Jetzt)
+✅ **Beide behalten**:
+- Bash-Scripts für schnelle, interaktive Tests
+- Ansible für strukturierte Deployments
+
+### Mittelfristig (3-6 Monate)
+✅ **Ansible erweitern**:
+- Verifikations-Playbooks erstellen
+- Health-Check-Playbooks
+- Monitoring-Playbooks
+
+### Langfristig (6+ Monate)
+✅ **Ansible als Standard**:
+- Alle wiederholbaren Tasks als Ansible-Playbooks
+- Bash-Scripts nur für sehr spezifische, einmalige Tasks
+
+## Beispiel: Ansible-Verifikations-Playbook
+
+Statt Bash-Script könnte man auch ein Ansible-Playbook erstellen:
+
+```yaml
+# deployment/ansible/playbooks/verify-staging.yml
+---
+- name: Verify Staging Environment
+  hosts: production
+  tasks:
+    - name: Check PostgreSQL-Staging Stack
+      community.docker.docker_compose_v2:
+        project_src: "{{ postgresql_staging_stack_path }}"
+        state: present
+      register: postgresql_staging_status
+    
+    - name: Verify PostgreSQL-Staging Connection
+      uri:
+        url: "postgresql://postgres:{{ vault_db_password_staging }}@postgres-staging:5432/michaelschiemer_staging"
+        method: GET
+    
+    - name: Check Staging Application Stack
+      community.docker.docker_compose_v2:
+        project_src: "{{ staging_stack_path }}"
+        state: present
+    
+    - name: Health Check
+      uri:
+        url: "https://staging.michaelschiemer.de/health"
+        method: GET
+        status_code: [200]
+```
+
+**Vorteil**: Idempotent, strukturiert, in CI/CD integrierbar
+
+## Fazit
+
+**Aktuell**: Hybrid-Ansatz ist optimal
+- Bash-Scripts für schnelle, interaktive Tests ✅
+- Ansible für strukturierte Deployments ✅
+
+**Langfristig**: Ansible ausbauen
+- Mehr Verifikations-Playbooks
+- Bash-Scripts nur für sehr spezifische Tasks
+- Konsistente Tool-Nutzung
+
+**Empfehlung**: Beide behalten, aber Ansible schrittweise erweitern für wiederholbare Tasks.
+
diff --git a/deployment/docs/guides/backup-and-rollback-guide.md b/deployment/docs/guides/backup-and-rollback-guide.md
new file mode 100644
index 00000000..f40ac04f
--- /dev/null
+++ b/deployment/docs/guides/backup-and-rollback-guide.md
@@ -0,0 +1,362 @@
+# Backup & Rollback Guide
+
+**Stand:** 2025-11-07  
+**Status:** Vollständige Dokumentation der Backup- und Rollback-Strategie
+
+---
+
+## Übersicht
+
+Dieses Dokument erklärt die Backup- und Rollback-Strategie für das Deployment. Backups werden automatisch erstellt und können für Rollbacks verwendet werden.
+
+**📖 Verwandte Dokumentation:**
+- [Deployment Commands](./deployment-commands.md) - Command-Referenz
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+
+---
+
+## Backup-Strategie
+
+### Backup-Playbook
+
+**Datei:** `deployment/ansible/playbooks/backup.yml`
+
+**Zweck:** Erstellt vollständige Backups aller kritischen Daten
+
+**Backup-Ziele:**
+- ✅ PostgreSQL Datenbanken (Production + Staging)
+- ✅ Application Code (Git Repository)
+- ✅ Application Storage (Logs, Cache, etc.)
+- ✅ Gitea Data
+- ✅ Docker Registry Images (optional)
+
+### Backup ausführen
+
+**Mit Test-Script (Empfohlen):**
+```bash
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-backup.sh
+```
+
+**Manuell:**
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/backup.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Mit Optionen:**
+```bash
+# Nur PostgreSQL Backup
+ansible-playbook -i inventory/production.yml \
+  playbooks/backup.yml \
+  -e "backup_postgresql=true" \
+  -e "backup_application_data=false" \
+  -e "backup_gitea=false" \
+  --vault-password-file secrets/.vault_pass
+
+# Retention Policy anpassen (Standard: 7 Tage)
+ansible-playbook -i inventory/production.yml \
+  playbooks/backup.yml \
+  -e "backup_retention_days=14" \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Backup-Struktur
+
+**Backup-Verzeichnis:** `/home/deploy/deployment/backups/`
+
+**Struktur:**
+```
+backups/
+├── backup_2025-11-07_14-30-00/
+│   ├── postgresql_michaelschiemer_2025-11-07_14-30-00.sql.gz
+│   ├── application_storage_2025-11-07_14-30-00.tar.gz
+│   ├── application_logs_2025-11-07_14-30-00.tar.gz
+│   ├── application_env_2025-11-07_14-30-00.env
+│   ├── gitea_data_2025-11-07_14-30-00.tar.gz
+│   └── backup_metadata.txt
+└── backup_2025-11-06_14-30-00/
+    └── ...
+```
+
+### Backup-Komponenten
+
+**PostgreSQL Backup:**
+- Format: `postgresql_<database>_<date>_<time>.sql.gz`
+- Inhalt: Vollständiger Database Dump
+- Komprimierung: Gzip
+
+**Application Storage:**
+- Format: `application_storage_<date>_<time>.tar.gz`
+- Inhalt: `storage/` Verzeichnis
+- Komprimierung: Tar + Gzip
+
+**Application Logs:**
+- Format: `application_logs_<date>_<time>.tar.gz`
+- Inhalt: `storage/logs/` Verzeichnis
+- Komprimierung: Tar + Gzip
+
+**Application .env:**
+- Format: `application_env_<date>_<time>.env`
+- Inhalt: Environment-Variablen
+
+**Gitea Data:**
+- Format: `gitea_data_<date>_<time>.tar.gz`
+- Inhalt: Gitea Volume
+- Komprimierung: Tar + Gzip
+
+### Retention Policy
+
+**Standard:** 7 Tage
+
+**Konfiguration:**
+- Backups älter als `backup_retention_days` werden automatisch gelöscht
+- Retention kann via `-e backup_retention_days=14` angepasst werden
+
+**Beispiel:**
+```bash
+# 14 Tage Retention
+ansible-playbook -i inventory/production.yml \
+  playbooks/backup.yml \
+  -e "backup_retention_days=14" \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Backup-Verifikation
+
+**Automatisch:**
+- Playbook prüft ob Backup-Dateien erstellt wurden
+- Dateigrößen werden angezeigt
+- Fehler wenn keine Backups erstellt wurden
+
+**Manuell auf Server:**
+```bash
+# Auf Server prüfen
+ssh deploy@94.16.110.151
+ls -lh ~/deployment/backups/backup_*/
+
+# Backup-Metadaten anzeigen
+cat ~/deployment/backups/backup_*/backup_metadata.txt
+
+# Backup-Dateien auflisten
+find ~/deployment/backups/backup_* -type f -ls
+```
+
+**Backup-Test durchführen:**
+```bash
+# Test-Backup mit Verifikation
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-backup.sh
+
+# Danach auf Server verifizieren
+ssh deploy@94.16.110.151
+ls -lh ~/deployment/backups/backup_*/
+cat ~/deployment/backups/backup_*/backup_metadata.txt
+```
+
+---
+
+## Rollback-Strategie
+
+### Rollback-Playbook
+
+**Datei:** `deployment/ansible/playbooks/rollback.yml`
+
+**Zweck:** Rollback zu vorheriger Version
+
+**Rollback-Optionen:**
+- Image Rollback (Docker Image)
+- Code Rollback (Git Repository)
+- Database Rollback (PostgreSQL)
+
+### Rollback ausführen
+
+**Zu letzter Version:**
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Zu spezifischer Version:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  -e "rollback_to_version=backup_2025-11-06_14-30-00" \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Rollback-Szenarien
+
+#### 1. Image Rollback
+
+**Zweck:** Rollback zu vorherigem Docker Image
+
+**Prozess:**
+1. Vorheriges Image wird identifiziert
+2. `docker-compose.production.yml` wird aktualisiert
+3. Container werden neu gestartet
+
+**Beispiel:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  -e "rollback_type=image" \
+  --vault-password-file secrets/.vault_pass
+```
+
+#### 2. Code Rollback
+
+**Zweck:** Rollback zu vorherigem Git Commit
+
+**Prozess:**
+1. Vorheriger Git Commit wird identifiziert
+2. Repository wird auf vorherigen Commit zurückgesetzt
+3. Container werden neu gestartet
+
+**Beispiel:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  -e "rollback_type=code" \
+  --vault-password-file secrets/.vault_pass
+```
+
+#### 3. Database Rollback
+
+**Zweck:** Rollback zu vorherigem Database Backup
+
+**Prozess:**
+1. Vorheriges Database Backup wird identifiziert
+2. Database wird aus Backup wiederhergestellt
+3. Verifikation wird durchgeführt
+
+**Wichtig:** Database Rollback sollte nur bei kritischen Problemen verwendet werden.
+
+**Beispiel:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  -e "rollback_type=database" \
+  -e "rollback_to_version=backup_2025-11-06_14-30-00" \
+  --vault-password-file secrets/.vault_pass
+```
+
+---
+
+## Automatisierung
+
+### Geplante Backups
+
+**Empfohlen:** Tägliche Backups via Cron oder Systemd Timer
+
+**Cron-Beispiel:**
+```bash
+# Täglich um 2:00 Uhr
+0 2 * * * cd /path/to/deployment/ansible && ansible-playbook -i inventory/production.yml playbooks/backup.yml --vault-password-file secrets/.vault_pass
+```
+
+**Systemd Timer (Empfohlen):**
+- Erstellt Systemd Service und Timer
+- Bessere Logging-Integration
+- Bessere Fehlerbehandlung
+
+### Backup-Monitoring
+
+**Empfohlen:** Alerts bei Backup-Fehlern
+
+**Methoden:**
+- Email-Benachrichtigungen
+- Monitoring-Integration (Grafana/Prometheus)
+- Log-Analyse
+
+---
+
+## Best Practices
+
+### 1. Regelmäßige Backups
+
+**Empfohlen:** Täglich
+
+**Vorteile:**
+- Minimale Datenverluste
+- Schneller Rollback möglich
+- Compliance-Anforderungen
+
+### 2. Backup-Verifikation
+
+**Empfohlen:** Regelmäßige Restore-Tests
+
+**Vorteile:**
+- Sicherstellung dass Backups funktionieren
+- Vertrautheit mit Restore-Prozess
+- Identifikation von Problemen
+
+### 3. Retention Policy
+
+**Empfohlen:** 7-30 Tage
+
+**Abwägung:**
+- Längere Retention = Mehr Speicherplatz
+- Kürzere Retention = Weniger Speicherplatz, aber weniger Rollback-Optionen
+
+### 4. Offsite Backups
+
+**Empfohlen:** Wichtige Backups extern speichern
+
+**Methoden:**
+- S3-compatible Storage (MinIO)
+- SFTP/SCP zu externem Server
+- Cloud Storage (optional)
+
+---
+
+## Troubleshooting
+
+### Problem: Backup schlägt fehl
+
+**Ursachen:**
+- Container laufen nicht
+- Speicherplatz voll
+- Berechtigungen fehlen
+
+**Lösung:**
+- Prüfe Container Status
+- Prüfe verfügbaren Speicherplatz
+- Prüfe Berechtigungen
+
+### Problem: Rollback schlägt fehl
+
+**Ursachen:**
+- Backup existiert nicht
+- Backup ist korrupt
+- Container laufen nicht
+
+**Lösung:**
+- Prüfe ob Backup existiert
+- Prüfe Backup-Integrität
+- Prüfe Container Status
+
+### Problem: Database Restore schlägt fehl
+
+**Ursachen:**
+- Database läuft nicht
+- Backup ist korrupt
+- Berechtigungen fehlen
+
+**Lösung:**
+- Prüfe Database Status
+- Prüfe Backup-Integrität
+- Prüfe Database-Berechtigungen
+
+---
+
+## Referenz
+
+- [Deployment Commands](./deployment-commands.md) - Command-Referenz
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+- [CI/CD Workflow Guide](./cicd-workflow-guide.md) - CI/CD Workflows
+
diff --git a/deployment/docs/guides/cicd-workflow-guide.md b/deployment/docs/guides/cicd-workflow-guide.md
new file mode 100644
index 00000000..c29c06b2
--- /dev/null
+++ b/deployment/docs/guides/cicd-workflow-guide.md
@@ -0,0 +1,347 @@
+# CI/CD Workflow Guide
+
+**Stand:** 2025-11-07  
+**Status:** Vollständige Dokumentation der CI/CD Workflows
+
+---
+
+## Übersicht
+
+Dieses Dokument erklärt die CI/CD Workflows und wie sie funktionieren. Die Workflows verwenden Ansible Playbooks für Deployment, um Idempotenz, bessere Fehlerbehandlung und konsistente Logs zu gewährleisten.
+
+**📖 Verwandte Dokumentation:**
+- [Code Deployment Workflow](./code-deployment-workflow.md) - Unterschiede zwischen Rsync und Git
+- [Initial Deployment Guide](./initial-deployment-guide.md) - Initial Deployment Anleitung
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+- [CI/CD Status](../status/ci-cd-status.md) - Aktueller Status
+
+---
+
+## Workflow-Übersicht
+
+### Automatische Workflows
+
+**`.gitea/workflows/build-image.yml`**
+- **Trigger:** Push zu `staging` oder `main` Branch
+- **Jobs:**
+  1. **changes** - Prüft ob Build notwendig ist
+  2. **test** - Führt Tests aus (PHP, Pest, PHPStan, Code Style)
+  3. **build** - Baut Docker Image und pusht zur Registry
+  4. **deploy-staging** - Auto-Deploy zu Staging (nur bei `staging` Branch)
+  5. **deploy-production** - Auto-Deploy zu Production (nur bei `main` Branch)
+
+### Manuelle Workflows
+
+**`.gitea/workflows/manual-deploy.yml`**
+- **Trigger:** Manuell via `workflow_dispatch`
+- **Inputs:**
+  - `environment`: staging oder production
+  - `image_tag`: Optional, Image Tag zum Deployen
+  - `branch`: Optional, Branch zum Checkout
+- **Jobs:**
+  1. **determine-image** - Bestimmt Image zum Deployen
+  2. **deploy-staging** - Deploy zu Staging
+  3. **deploy-production** - Deploy zu Production
+
+---
+
+## Deployment-Prozess
+
+### Staging Auto-Deploy (build-image.yml)
+
+**Trigger:** Push zu `staging` Branch
+
+**Ablauf:**
+1. **Code-Deployment** (`deploy-application-code.yml`)
+   - Git Repository wird auf Server aktualisiert
+   - Branch: `staging`
+   - Ziel: `/home/deploy/michaelschiemer/current`
+
+2. **Composer Dependencies** (`install-composer-dependencies.yml`)
+   - `composer install --no-dev --optimize-autoloader`
+   - Im `php` Container ausgeführt
+   - `queue-worker` und `scheduler` werden neu gestartet
+
+3. **Image-Deployment** (`deploy-image.yml`)
+   - Docker Image wird zur Registry gepusht
+   - Image wird auf Server gepullt
+   - `docker-compose.production.yml` wird aktualisiert
+   - Container werden neu gestartet
+
+4. **Health-Check**
+   - Prüft `https://staging.michaelschiemer.de/health`
+   - Wartet bis zu 10 Versuche (100 Sekunden)
+
+### Production Auto-Deploy (build-image.yml)
+
+**Trigger:** Push zu `main` Branch
+
+**Ablauf:**
+1. **Code-Deployment** (`deploy-application-code.yml`)
+   - Git Repository wird auf Server aktualisiert
+   - Branch: `main`
+   - Ziel: `/home/deploy/michaelschiemer/current`
+
+2. **Composer Dependencies** (`install-composer-dependencies.yml`)
+   - Gleicher Prozess wie Staging
+
+3. **Image-Deployment** (`deploy-image.yml`)
+   - Gleicher Prozess wie Staging
+   - Environment: `production`
+
+4. **Health-Check**
+   - Prüft `https://michaelschiemer.de/health`
+   - Wartet bis zu 10 Versuche (100 Sekunden)
+
+---
+
+## Ansible Playbooks in Workflows
+
+### deploy-application-code.yml
+
+**Zweck:** Code-Deployment via Git
+
+**Parameter:**
+- `deployment_environment`: `staging` oder `production`
+- `deployment_hosts`: `production` (Inventory Group)
+- `git_branch`: Branch zum Deployen (`staging` oder `main`)
+
+**Was passiert:**
+- Git Repository wird geklont (falls nicht vorhanden)
+- Repository wird aktualisiert (`git pull`)
+- Executable Permissions werden gesetzt
+- Verifikation: Prüft ob `worker.php`, `console.php`, `composer.json` existieren
+
+### install-composer-dependencies.yml
+
+**Zweck:** Composer Dependencies Installation
+
+**Parameter:**
+- `deployment_environment`: `staging` oder `production`
+
+**Was passiert:**
+- `composer install --no-dev --optimize-autoloader` im PHP Container
+- Verifikation: Prüft ob `vendor/autoload.php` existiert
+- Restart: `queue-worker` und `scheduler` (nur Production)
+
+### deploy-image.yml
+
+**Zweck:** Docker Image Deployment
+
+**Parameter:**
+- `deployment_environment`: `staging` oder `production`
+- `image_tag`: Image Tag (z.B. `latest`, `git-abc1234`)
+- `docker_registry`: Registry URL
+- `docker_registry_username`: Registry Username
+- `docker_registry_password`: Registry Password
+
+**Was passiert:**
+- Docker Registry Login
+- Image Pull
+- `docker-compose.production.yml` wird aktualisiert
+- Container werden neu gestartet
+- Container Status wird angezeigt
+
+---
+
+## Secrets Konfiguration
+
+### Erforderliche Secrets
+
+**REGISTRY_USER**
+- Docker Registry Benutzername
+- Standard: `admin`
+
+**REGISTRY_PASSWORD**
+- Docker Registry Passwort
+- Zu finden in: `deployment/stacks/registry/auth/htpasswd`
+
+**SSH_PRIVATE_KEY**
+- SSH Private Key für Production-Server-Zugriff
+- Kompletter Inhalt inkl. `-----BEGIN OPENSSH PRIVATE KEY-----`
+
+**ANSIBLE_VAULT_PASSWORD**
+- Ansible Vault Password für verschlüsselte Secrets
+- Optional: Falls nicht gesetzt, wird leeres Password File verwendet
+
+**GITEA_TOKEN** (optional)
+- Gitea Personal Access Token
+- Für automatische Issue-Erstellung bei Security-Scans
+
+### Secrets konfigurieren
+
+```bash
+# In Gitea UI:
+https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions
+
+# Secrets hinzufügen:
+- REGISTRY_USER
+- REGISTRY_PASSWORD
+- SSH_PRIVATE_KEY
+- ANSIBLE_VAULT_PASSWORD
+```
+
+---
+
+## Workflow-Beispiele
+
+### Staging Deployment (Automatisch)
+
+**Trigger:** Push zu `staging` Branch
+
+```bash
+git checkout staging
+git add .
+git commit -m "feat: Add new feature"
+git push origin staging
+```
+
+**Was passiert automatisch:**
+1. Tests werden ausgeführt
+2. Docker Image wird gebaut
+3. Image wird zur Registry gepusht
+4. Code wird via Git deployt
+5. Composer Dependencies werden installiert
+6. Image wird deployt
+7. Health-Check wird durchgeführt
+
+### Production Deployment (Automatisch)
+
+**Trigger:** Push zu `main` Branch
+
+```bash
+git checkout main
+git merge staging
+git push origin main
+```
+
+**Was passiert automatisch:**
+- Gleicher Prozess wie Staging, aber auf Production
+
+### Manuelles Deployment
+
+**Via Gitea UI:**
+1. Gehe zu: `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+2. Wähle: "Manual Deployment"
+3. Klicke: "Run workflow"
+4. Wähle:
+   - Environment: `production` oder `staging`
+   - Image Tag: Optional (z.B. `git-abc1234`)
+   - Branch: Optional (Standard: `main` für Production, `staging` für Staging)
+
+---
+
+## Troubleshooting
+
+### Problem: Code-Deployment schlägt fehl
+
+**Ursachen:**
+- Git Repository existiert nicht auf Server
+- Git Credentials fehlen
+- Branch existiert nicht
+
+**Lösung:**
+- Prüfe `deploy-application-code.yml` Logs
+- Prüfe ob Git Repository auf Server existiert
+- Prüfe Branch-Name
+
+### Problem: Composer Dependencies Installation schlägt fehl
+
+**Ursachen:**
+- `composer.json` fehlt
+- PHP Container läuft nicht
+- Netzwerk-Probleme
+
+**Lösung:**
+- Prüfe ob `composer.json` existiert
+- Prüfe PHP Container Status
+- Prüfe `install-composer-dependencies.yml` Logs
+
+### Problem: Image-Deployment schlägt fehl
+
+**Ursachen:**
+- Registry Login fehlgeschlagen
+- Image existiert nicht in Registry
+- Docker Compose Dateien fehlen
+
+**Lösung:**
+- Prüfe Registry Credentials
+- Prüfe ob Image in Registry existiert
+- Prüfe `deploy-image.yml` Logs
+
+### Problem: Health-Check schlägt fehl
+
+**Ursachen:**
+- Container starten nicht
+- Application hat Fehler
+- Health-Check Endpoint nicht erreichbar
+
+**Lösung:**
+- Prüfe Container Status: `docker compose ps`
+- Prüfe Container Logs: `docker compose logs`
+- Prüfe Health-Check Endpoint manuell: `curl https://michaelschiemer.de/health`
+
+---
+
+## Best Practices
+
+### 1. Staging First
+
+**Empfohlen:** Immer zuerst auf Staging deployen, dann auf Production
+
+```bash
+# 1. Staging
+git push origin staging  # → Auto-Deploy zu Staging
+
+# 2. Testen auf Staging
+# ... Tests durchführen ...
+
+# 3. Production
+git checkout main
+git merge staging
+git push origin main  # → Auto-Deploy zu Production
+```
+
+### 2. Image Tags
+
+**Empfohlen:** Spezifische Image Tags verwenden statt `latest`
+
+**Vorteile:**
+- Rollback möglich
+- Nachvollziehbarkeit
+- Reproduzierbarkeit
+
+**Beispiel:**
+```bash
+# Manuelles Deployment mit spezifischem Tag
+# Image Tag: git-abc1234
+```
+
+### 3. Vault Password
+
+**Empfohlen:** `ANSIBLE_VAULT_PASSWORD` als Secret konfigurieren
+
+**Vorteile:**
+- Automatisiertes Deployment
+- Keine manuelle Eingabe nötig
+- Sicherer als manuelle Eingabe
+
+### 4. Monitoring
+
+**Empfohlen:** Pipeline-Status überwachen
+
+**Methoden:**
+- Gitea Actions UI
+- Health-Check Endpoints
+- Container Status
+
+---
+
+## Referenz
+
+- [Code Deployment Workflow](./code-deployment-workflow.md) - Code-Deployment-Methoden
+- [Initial Deployment Guide](./initial-deployment-guide.md) - Initial Deployment
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+- [CI/CD Status](../status/ci-cd-status.md) - Aktueller Status
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+
diff --git a/deployment/docs/guides/code-change-workflow.md b/deployment/docs/guides/code-change-workflow.md
index 1731f235..45b75c55 100644
--- a/deployment/docs/guides/code-change-workflow.md
+++ b/deployment/docs/guides/code-change-workflow.md
@@ -284,7 +284,7 @@ https://git.michaelschiemer.de/michael/michaelschiemer/actions
 ssh deploy@94.16.110.151
 
 # Container-Status prüfen
-cd ~/deployment/stacks/application
+cd ~/deployment/stacks/production
 docker compose ps
 
 # Logs ansehen
@@ -489,7 +489,7 @@ git push origin main
 ssh deploy@94.16.110.151
 
 # Logs prüfen
-cd ~/deployment/stacks/application
+cd ~/deployment/stacks/production
 docker compose logs app
 
 # Manuell rollback
@@ -535,7 +535,7 @@ git push origin feature/my-feature
 # → https://git.michaelschiemer.de/michael/michaelschiemer/actions
 
 # Application-Status prüfen
-ssh deploy@94.16.110.151 "cd ~/deployment/stacks/application && docker compose ps"
+ssh deploy@94.16.110.151 "cd ~/deployment/stacks/production && docker compose ps"
 ```
 
 ### Deployment-Zeit
diff --git a/deployment/docs/guides/code-deployment-workflow.md b/deployment/docs/guides/code-deployment-workflow.md
new file mode 100644
index 00000000..8ca1f528
--- /dev/null
+++ b/deployment/docs/guides/code-deployment-workflow.md
@@ -0,0 +1,339 @@
+# Code Deployment Workflow
+
+**Stand:** 2025-11-07  
+**Status:** Vollständige Dokumentation der Code-Deployment-Methoden
+
+---
+
+## Übersicht
+
+Dieses Dokument erklärt die beiden verfügbaren Methoden für Code-Deployment:
+1. **Rsync-basiert** - Für Initial Deployment
+2. **Git-basiert** - Für CI/CD und zukünftige Deployments
+
+**📖 Verwandte Dokumentation:**
+- [Initial Deployment Guide](./initial-deployment-guide.md) - Schritt-für-Schritt Initial Deployment
+- [Deployment Commands](./deployment-commands.md) - Command-Referenz
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+
+---
+
+## Deployment-Methoden im Vergleich
+
+### Methode 1: Rsync-basiert (`sync-application-code.yml`)
+
+**Verwendung:** Initial Deployment (einmalig)
+
+**Vorteile:**
+- ✅ Funktioniert ohne Git Repository auf Server
+- ✅ Schnell für einmaliges Setup
+- ✅ Exakte Kontrolle über synchronisierte Dateien
+- ✅ Funktioniert auch wenn Git nicht verfügbar ist
+
+**Nachteile:**
+- ❌ Erfordert lokales Repository
+- ❌ Nicht für CI/CD geeignet
+- ❌ Manueller Prozess
+
+**Playbook:** `deployment/ansible/playbooks/sync-application-code.yml`
+
+**Was wird synchronisiert:**
+- Alle PHP-Dateien
+- Konfigurationsdateien
+- Assets (wenn nicht excluded)
+
+**Was wird NICHT synchronisiert:**
+- `vendor` (wird im Container installiert)
+- `node_modules`
+- `.env` Dateien
+- `deployment/`, `docker/`, `docs/`, `tests/`
+
+---
+
+### Methode 2: Git-basiert (`deploy-application-code.yml`)
+
+**Verwendung:** CI/CD und zukünftige Deployments
+
+**Vorteile:**
+- ✅ Automatisierbar via CI/CD
+- ✅ Version Control Integration
+- ✅ Git Commit History verfügbar
+- ✅ Branch-basierte Deployments möglich
+- ✅ Rollback einfach (Git Checkout)
+
+**Nachteile:**
+- ❌ Erfordert Git Repository auf Server
+- ❌ Erfordert Git Credentials (Token/SSH Key)
+
+**Playbook:** `deployment/ansible/playbooks/deploy-application-code.yml`
+
+**Was passiert:**
+- Git Repository wird geklont (falls nicht vorhanden)
+- Repository wird aktualisiert (`git pull`)
+- Branch kann spezifiziert werden
+- Executable Permissions werden gesetzt
+
+---
+
+## Workflow-Diagramme
+
+### Initial Deployment (Rsync)
+
+```
+Local Repository
+    ↓
+rsync (via Ansible)
+    ↓
+Server: /home/deploy/michaelschiemer/current
+    ↓
+Docker Volume Mount
+    ↓
+Container: /var/www/html
+```
+
+### Normal Deployment (Git)
+
+```
+Git Repository (Gitea)
+    ↓
+Git Clone/Pull (via Ansible)
+    ↓
+Server: /home/deploy/michaelschiemer/current
+    ↓
+Docker Volume Mount
+    ↓
+Container: /var/www/html
+```
+
+### CI/CD Deployment (Git)
+
+```
+Developer → git push
+    ↓
+Gitea Actions Trigger
+    ↓
+Build Docker Image
+    ↓
+Push to Registry
+    ↓
+Ansible: deploy-application-code.yml
+    ↓
+Git Pull auf Server
+    ↓
+Docker Compose Restart
+```
+
+---
+
+## Wann welche Methode verwenden?
+
+### Initial Deployment → Rsync
+
+**Verwendung:**
+- ✅ Erstes Setup des Servers
+- ✅ Server hat noch kein Git Repository
+- ✅ Lokales Repository ist verfügbar
+- ✅ Manuelles Deployment gewünscht
+
+**Beispiel:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Normal Deployment → Git
+
+**Verwendung:**
+- ✅ CI/CD Pipeline
+- ✅ Regelmäßige Deployments
+- ✅ Branch-basierte Deployments (staging, production)
+- ✅ Automatisierung gewünscht
+
+**Beispiel:**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml \
+  -e "git_branch=main" \
+  --vault-password-file secrets/.vault_pass
+```
+
+---
+
+## Detaillierte Workflows
+
+### Initial Deployment Workflow (Rsync)
+
+**Schritt 1: Code synchronisieren**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Schritt 2: Composer Dependencies installieren**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/install-composer-dependencies.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Schritt 3: Application Stack deployen**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --tags application \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Siehe auch:** [Initial Deployment Guide](./initial-deployment-guide.md)
+
+---
+
+### Normal Deployment Workflow (Git)
+
+**Schritt 1: Code deployen**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml \
+  -e "git_branch=main" \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Schritt 2: Composer Dependencies aktualisieren (falls nötig)**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/install-composer-dependencies.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Schritt 3: Container neu starten (falls nötig)**
+```bash
+# Auf Server
+cd ~/deployment/stacks/production
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml restart
+```
+
+---
+
+### CI/CD Deployment Workflow (Git)
+
+**Automatisch via Gitea Actions:**
+
+1. **Developer pusht Code:**
+   ```bash
+   git push origin main
+   ```
+
+2. **Gitea Actions Pipeline:**
+   - Tests ausführen
+   - Docker Image bauen
+   - Image zur Registry pushen
+   - Ansible Playbook ausführen
+
+3. **Ansible Playbook (`deploy-application-code.yml`):**
+   - Git Repository auf Server aktualisieren
+   - Composer Dependencies installieren (falls `composer.json` geändert)
+   - Container neu starten
+
+**Siehe auch:** [Application Stack Deployment](../reference/application-stack.md)
+
+---
+
+## Best Practices
+
+### Code-Synchronisation
+
+1. **Immer `vendor` ausschließen**
+   - Dependencies werden im Container installiert
+   - Verhindert Platform-spezifische Probleme
+
+2. **`.env` niemals synchronisieren**
+   - Environment-spezifische Konfiguration
+   - Wird von Ansible generiert
+
+3. **Executable Permissions setzen**
+   - `worker.php` und `console.php` müssen ausführbar sein
+   - Playbooks setzen automatisch `0755`
+
+### Git-Deployment
+
+1. **Branch-spezifische Deployments**
+   ```bash
+   # Staging
+   -e "git_branch=staging"
+   
+   # Production
+   -e "git_branch=main"
+   ```
+
+2. **Git Credentials**
+   - SSH Keys für private Repositories
+   - Git Tokens für HTTPS
+   - Credentials werden via Ansible Vault verwaltet
+
+3. **Rollback**
+   ```bash
+   # Auf Server
+   cd /home/deploy/michaelschiemer/current
+   git checkout <previous-commit-hash>
+   docker compose restart
+   ```
+
+---
+
+## Troubleshooting
+
+### Problem: Rsync synchronisiert nicht alle Dateien
+
+**Lösung:** Excludes in `sync-application-code.yml` prüfen
+
+### Problem: Git Pull schlägt fehl
+
+**Ursachen:**
+- Git Credentials fehlen
+- Repository existiert nicht
+- Branch existiert nicht
+
+**Lösung:** Siehe [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)
+
+### Problem: Code-Änderungen werden nicht erkannt
+
+**Lösung:** Container neu starten
+```bash
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml restart
+```
+
+---
+
+## Migration: Rsync → Git
+
+Nach Initial Deployment kann auf Git-Deployment umgestellt werden:
+
+**Schritt 1: Git Repository auf Server initialisieren**
+```bash
+# Auf Server
+cd /home/deploy/michaelschiemer/current
+git init
+git remote add origin https://git.michaelschiemer.de/michael/michaelschiemer.git
+git fetch
+git checkout main
+```
+
+**Schritt 2: Zukünftige Deployments via Git**
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml \
+  -e "git_branch=main" \
+  --vault-password-file secrets/.vault_pass
+```
+
+---
+
+## Referenz
+
+- [Initial Deployment Guide](./initial-deployment-guide.md) - Initial Deployment Anleitung
+- [Deployment Commands](./deployment-commands.md) - Command-Referenz
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+
diff --git a/deployment/docs/guides/deployment-commands.md b/deployment/docs/guides/deployment-commands.md
index fe96b50b..b00b5e12 100644
--- a/deployment/docs/guides/deployment-commands.md
+++ b/deployment/docs/guides/deployment-commands.md
@@ -1,30 +1,172 @@
 # Deployment Commands - Quick Reference
 
-Alle Deployment-Operationen werden über **Ansible Playbooks** durchgeführt.
+## 🚀 Automatisches Deployment (Empfohlen)
+
+### Standard-Workflow: Staging → Production
+
+**Empfohlener Workflow für sichere Deployments:**
+
+1. **Push auf `staging` Branch** (Standard für Entwicklung)
+```bash
+git add .
+git commit -m "feat: Add new feature"
+git push origin staging  # → Automatisches Deployment zu Staging
+```
+
+2. **Testen auf Staging**
+- Staging URL: `https://staging.michaelschiemer.de`
+- Tests durchführen und verifizieren
+
+3. **Merge nach `main`** (nur nach erfolgreichem Test)
+```bash
+git checkout main
+git merge staging
+git push origin main  # → Automatisches Deployment zu Production
+```
+
+**Was passiert automatisch:**
+
+**Bei Push auf `staging` Branch:**
+- ✅ Tests werden ausgeführt
+- ✅ Docker Image wird gebaut
+- ✅ Image wird zur Registry gepusht
+- ✅ Deployment auf Staging Server via SSH/SCP
+- ✅ Staging Stack wird aktualisiert
+
+**Bei Push auf `main` Branch:**
+- ✅ Tests werden ausgeführt
+- ✅ Docker Image wird gebaut
+- ✅ Image wird zur Registry gepusht
+- ✅ Deployment auf Production Server via SSH/SCP
+- ✅ Production Stack wird aktualisiert
+
+**Pipeline Status:** `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+
+**Wichtig:** 
+- ⚠️ **Niemals direkt auf `main` pushen** - immer erst auf `staging` testen
+- ✅ **Staging ist der Standard-Branch** für alle Entwicklungsarbeit
+- ✅ **Production-Deployment** erfolgt nur nach erfolgreichem Test auf Staging
 
 ---
 
-## 🚀 Häufig verwendete Commands
+## 🔧 Initial Deployment (Einmalig)
 
-### Code deployen (Image-basiert)
+### Schritt 1: Code synchronisieren (Rsync)
 
 ```bash
 cd deployment/ansible
 ansible-playbook -i inventory/production.yml \
-  playbooks/deploy-update.yml \
-  -e "image_tag=abc1234-1696234567" \
-  -e "git_commit_sha=$(git rev-parse HEAD)"
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
 ```
 
-### Code synchen (Git-basiert)
+**Was passiert:**
+- Code wird vom lokalen Repository zum Server synchronisiert
+- Ziel: `/home/deploy/michaelschiemer/current`
+- Excludes: `vendor`, `node_modules`, `.env`, `deployment`, `docker`, `docs`, `tests`
+
+### Schritt 2: Composer Dependencies installieren
 
 ```bash
 cd deployment/ansible
 ansible-playbook -i inventory/production.yml \
-  playbooks/sync-code.yml \
-  -e "git_branch=main"
+  playbooks/install-composer-dependencies.yml \
+  --vault-password-file secrets/.vault_pass
 ```
 
+**Was passiert:**
+- `composer install --no-dev --optimize-autoloader` im PHP Container
+- `queue-worker` und `scheduler` werden neu gestartet
+
+### Schritt 3: Application Stack deployen
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --tags application \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Siehe auch:** [Initial Deployment Guide](./initial-deployment-guide.md)
+
+---
+
+## 🔧 Manuelle Deployment-Operationen
+
+### Code deployen (Git-basiert)
+
+**Für zukünftige Deployments (nach Initial Setup):**
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml \
+  -e "git_branch=main" \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert:**
+- Git Repository wird auf Server aktualisiert (`git pull`)
+- Branch kann spezifiziert werden
+- Executable Permissions werden gesetzt
+
+**Siehe auch:** [Code Deployment Workflow](./code-deployment-workflow.md)
+
+### Code deployen (Manuell via SSH)
+
+Falls ein manuelles Deployment nötig ist:
+
+**Staging:**
+```bash
+# Auf Staging Server
+ssh deploy@94.16.110.151
+
+# 1. PostgreSQL Staging Stack (falls noch nicht laufend)
+cd ~/deployment/stacks/postgresql-staging
+docker compose up -d
+
+# 2. Staging Application Stack
+cd ~/deployment/stacks/staging
+
+# Docker Registry Login
+echo "$REGISTRY_PASSWORD" | docker login registry.michaelschiemer.de \
+  -u "$REGISTRY_USER" --password-stdin
+
+# Image pullen
+docker pull registry.michaelschiemer.de/framework:git-abc1234
+
+# Stack aktualisieren
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml up -d
+```
+
+**Hinweis**: Staging verwendet eine separate PostgreSQL-Datenbank (`postgres-staging`) im `postgresql-staging` Stack.
+
+**Production:**
+```bash
+# Auf Production Server
+ssh deploy@94.16.110.151
+
+# 1. PostgreSQL Production Stack (falls noch nicht laufend)
+cd ~/deployment/stacks/postgresql-production
+docker compose up -d
+
+# 2. Production Application Stack
+cd ~/deployment/stacks/production
+
+# Docker Registry Login
+echo "$REGISTRY_PASSWORD" | docker login registry.michaelschiemer.de \
+  -u "$REGISTRY_USER" --password-stdin
+
+# Image pullen
+docker pull registry.michaelschiemer.de/framework:git-abc1234
+
+# Stack aktualisieren
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml up -d
+```
+
+**Hinweis**: Production verwendet eine separate PostgreSQL-Datenbank (`postgres-production`) im `postgresql-production` Stack.
+
 ### Rollback zu vorheriger Version
 
 ```bash
@@ -41,6 +183,56 @@ ansible-playbook -i inventory/production.yml \
   playbooks/setup-infrastructure.yml
 ```
 
+### Quick-Start Scripts
+
+Für schnelle Tests und Verifikationen:
+
+**Staging**:
+```bash
+cd ~/deployment
+./scripts/staging-quick-start.sh
+```
+
+**Production**:
+```bash
+cd ~/deployment
+./scripts/production-quick-start.sh
+```
+
+Die Scripts bieten ein interaktives Menü für:
+- PostgreSQL-Stacks starten
+- Networks verifizieren
+- Container-Status prüfen
+- Datenbank-Verbindungen testen
+- Health-Checks durchführen
+- Logs anzeigen
+
+Siehe auch: `deployment/scripts/README.md`
+
+### Verifikation mit Ansible (Empfohlen für CI/CD)
+
+**Staging**:
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-staging.yml
+```
+
+**Production**:
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-production.yml
+```
+
+Die Ansible-Playbooks bieten:
+- Idempotente Verifikationen
+- Strukturierte Ausgabe
+- CI/CD-Integration möglich
+- Automatische Fehlerbehandlung
+
+**Vergleich Bash vs. Ansible**: Siehe `deployment/docs/guides/ansible-vs-bash-scripts.md`
+
 ### System Maintenance (regelmäßig)
 
 ```bash
@@ -51,23 +243,18 @@ ansible-playbook -i inventory/production.yml \
 
 ---
 
-## 📋 Alle verfügbaren Playbooks
-
-### Deployment & Updates
-
-- **`playbooks/deploy-update.yml`** - Deployt neues Docker Image
-- **`playbooks/sync-code.yml`** - Synchronisiert Code aus Git Repository
-- **`playbooks/rollback.yml`** - Rollback zu vorheriger Version
+## 📋 Verfügbare Ansible Playbooks
 
 ### Infrastructure Setup
 
-- **`playbooks/setup-infrastructure.yml`** - Deployed alle Stacks (Traefik, PostgreSQL, Registry, Gitea, Monitoring, Application)
+- **`playbooks/setup-infrastructure.yml`** - Deployed alle Stacks (Traefik, PostgreSQL, Registry, Gitea, Monitoring, Production)
 - **`playbooks/setup-production-secrets.yml`** - Deployed Secrets zu Production
 - **`playbooks/setup-ssl-certificates.yml`** - SSL Certificate Setup
 - **`playbooks/sync-stacks.yml`** - Synchronisiert Stack-Konfigurationen
 
 ### Troubleshooting & Maintenance
 
+- **`playbooks/rollback.yml`** - Rollback zu vorheriger Version
 - **`playbooks/troubleshoot.yml`** - Unified Troubleshooting Playbook mit Tags
   ```bash
   # Nur Diagnose
diff --git a/deployment/docs/guides/health-checks.md b/deployment/docs/guides/health-checks.md
new file mode 100644
index 00000000..2c9ed0b1
--- /dev/null
+++ b/deployment/docs/guides/health-checks.md
@@ -0,0 +1,94 @@
+# Health Checks - Dokumentation
+
+## Verfügbare Health-Check-Endpoints
+
+### Basis Health-Check
+- **URL**: `/health`
+- **Methode**: GET
+- **Zweck**: Einfacher Health-Check für Load Balancer und Monitoring
+- **Response**: HTTP 200 wenn gesund
+
+### Erweiterte Health-Checks
+
+#### 1. Vollständiger System-Status
+- **URL**: `/admin/health/api/status`
+- **Methode**: GET
+- **Zweck**: Vollständiger Health-Report mit allen Checks
+- **Response**: JSON mit allen Health-Check-Ergebnissen
+
+#### 2. Health-Summary
+- **URL**: `/admin/health/api/summary`
+- **Methode**: GET
+- **Zweck**: Zusammenfassung des System-Status
+- **Response**: JSON mit Overall-Status und Quick-Stats
+
+#### 3. Einzelner Health-Check
+- **URL**: `/admin/health/api/check/{name}`
+- **Methode**: GET
+- **Zweck**: Spezifischen Health-Check ausführen
+- **Response**: JSON mit Check-Ergebnis
+
+#### 4. Health-Checks nach Kategorie
+- **URL**: `/admin/health/api/category/{category}`
+- **Methode**: GET
+- **Zweck**: Alle Checks einer Kategorie ausführen
+- **Response**: JSON mit Category-Report
+
+## Verfügbare Health-Checks
+
+Das Framework unterstützt verschiedene Health-Checks:
+
+- **Database**: PostgreSQL Verbindung und Query-Test
+- **Redis**: Cache/Session/Queue Backend Verbindung
+- **Queue**: Queue Worker Status
+- **Logging**: Log-System Status
+- **Discovery**: Service Discovery Status
+
+## Verwendung in CI/CD
+
+Der Workflow führt automatisch Health-Checks nach Deployment durch:
+
+1. **Basic Health Check**: `/health` Endpoint
+2. **Extended Health Check**: `/admin/health/api/summary` (falls verfügbar)
+
+Bei fehlgeschlagenem Health-Check schlägt das Deployment fehl.
+
+## Automatischer Rollback
+
+**Geplant**: Automatischer Rollback bei fehlgeschlagenem Health-Check ist noch nicht implementiert.
+
+**Aktuell**: Bei fehlgeschlagenem Health-Check schlägt das Deployment fehl, aber es erfolgt kein automatischer Rollback.
+
+**Zukünftig**: 
+- Automatischer Rollback bei fehlgeschlagenem Health-Check
+- Rollback-Notification (Email/Slack)
+- Health-Check-Dashboard in Grafana
+
+## Monitoring Integration
+
+Health-Checks können in Prometheus/Grafana integriert werden:
+
+```yaml
+# Prometheus Scrape Config
+- job_name: 'application-health'
+  metrics_path: '/admin/health/api/status'
+  static_configs:
+    - targets: ['app:80']
+```
+
+## Manuelle Health-Checks
+
+```bash
+# Basic Health Check
+curl https://michaelschiemer.de/health
+
+# Extended Health Summary
+curl https://michaelschiemer.de/admin/health/api/summary
+
+# Specific Check
+curl https://michaelschiemer.de/admin/health/api/check/database
+
+# All Checks
+curl https://michaelschiemer.de/admin/health/api/status
+```
+
diff --git a/deployment/docs/guides/initial-deployment-guide.md b/deployment/docs/guides/initial-deployment-guide.md
new file mode 100644
index 00000000..fc13a89f
--- /dev/null
+++ b/deployment/docs/guides/initial-deployment-guide.md
@@ -0,0 +1,238 @@
+# Initial Deployment Guide
+
+**Stand:** 2025-11-07  
+**Status:** Vollständige Anleitung für erstes Deployment
+
+---
+
+## Übersicht
+
+Dieser Guide führt durch das komplette Initial Deployment des Application Stacks. Dieser Prozess wird **einmalig** beim ersten Setup durchgeführt. Für spätere Deployments siehe [Code Deployment Workflow](./code-deployment-workflow.md).
+
+**📖 Verwandte Dokumentation:**
+- [Code Deployment Workflow](./code-deployment-workflow.md) - Unterschiede zwischen Initial und normalem Deployment
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Häufige Probleme und Lösungen
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Deployment-Ablauf
+
+---
+
+## Voraussetzungen
+
+Bevor das Initial Deployment startet, müssen folgende Voraussetzungen erfüllt sein:
+
+### 1. Infrastructure Stacks deployed
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --vault-password-file secrets/.vault_pass \
+  --skip-tags application
+```
+
+**Wichtig:** `--skip-tags application` überspringt den Application Stack, da dieser separat deployed wird.
+
+### 2. Docker Image gebaut und gepusht
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/build-initial-image.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert:**
+- `docker/entrypoint.sh` wird auf LF Line Endings konvertiert (CRLF → LF)
+- Docker Image wird gebaut (`Dockerfile.production`)
+- Image wird zur Registry gepusht (`localhost:5000/framework:latest`)
+
+### 3. Secrets konfiguriert
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-production-secrets.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Erforderliche Secrets im Vault:**
+- `vault_db_user_password` - PostgreSQL Passwort
+- `vault_redis_password` - Redis Passwort
+- `vault_app_key` - Application Encryption Key
+- `vault_vault_encryption_key` - Vault Encryption Key
+
+---
+
+## Initial Deployment Workflow
+
+### Schritt 1: Application Code synchronisieren
+
+**Methode:** Rsync-basiertes Sync vom lokalen Repository zum Server
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert:**
+- Zielverzeichnis wird erstellt: `/home/deploy/michaelschiemer/current`
+- Alte Dateien werden gelöscht (`.git` wird erhalten falls vorhanden)
+- Code wird via `rsync` synchronisiert
+- Excludes: `vendor`, `node_modules`, `.env`, `deployment`, `docker`, `docs`, `tests`
+- Executable Permissions werden auf `worker.php` und `console.php` gesetzt
+- Verifikation: Prüft ob `worker.php`, `console.php`, `composer.json` existieren
+
+**Wichtig:** `vendor` wird **nicht** synchronisiert, da Dependencies im Container installiert werden.
+
+### Schritt 2: Composer Dependencies installieren
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/install-composer-dependencies.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert:**
+- `composer install --no-dev --optimize-autoloader` wird im `php` Container ausgeführt
+- `vendor/autoload.php` wird erstellt
+- `queue-worker` und `scheduler` werden neu gestartet (um `vendor` zu erkennen)
+
+**Voraussetzung:** `php` Container muss bereits laufen (wird durch `setup-infrastructure.yml` gestartet).
+
+### Schritt 3: Application Stack deployen
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --vault-password-file secrets/.vault_pass \
+  --tags application
+```
+
+**Was passiert:**
+- Docker Compose Stack wird deployed
+- Secrets werden erstellt
+- `.env` Datei wird generiert
+- Container werden gestartet: `php`, `web`, `queue-worker`, `scheduler`
+- Health Checks werden durchgeführt
+
+**Container-Konfiguration:**
+- `php`: Läuft PHP-FPM und Nginx (via `entrypoint.sh`)
+- `web`: Nginx Reverse Proxy
+- `queue-worker`: PHP CLI Worker (ohne entrypoint, direkter `php worker.php` Aufruf)
+- `scheduler`: PHP CLI Scheduler (ohne entrypoint, direkter `php console.php scheduler:run` Aufruf)
+
+---
+
+## Verifikation
+
+### Container Status prüfen
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/check-final-status.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Erwartetes Ergebnis:**
+```
+NAME                          STATUS
+production-php-1             Up X minutes (healthy)
+production-web-1              Up X minutes (healthy)
+production-queue-worker-1     Up X minutes
+scheduler                     Up X minutes
+```
+
+### Manuelle Verifikation
+
+```bash
+# SSH zum Server
+ssh deploy@94.16.110.151
+
+# Container Status
+cd ~/deployment/stacks/production
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml ps
+
+# Logs prüfen
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml logs web
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml logs queue-worker
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml logs scheduler
+
+# Health Check
+curl -k https://localhost/health
+```
+
+---
+
+## Häufige Probleme
+
+### Problem: Container starten nicht / sind unhealthy
+
+**Lösung:** Siehe [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)
+
+**Häufige Ursachen:**
+- Missing Secret Files → `setup-production-secrets.yml` ausführen
+- Missing Application Code → `sync-application-code.yml` ausführen
+- Missing `vendor/autoload.php` → `install-composer-dependencies.yml` ausführen
+- PHP-FPM Permission Errors → `fix-web-container.yml` ausführen
+- Environment Variables fehlen → `recreate-containers-with-env.yml` ausführen
+
+### Problem: Entrypoint Script "no such file or directory"
+
+**Ursache:** CRLF Line Endings im `docker/entrypoint.sh`
+
+**Lösung:** 
+- `.gitattributes` sollte `*.sh text eol=lf` enthalten
+- `build-initial-image.yml` konvertiert automatisch zu LF
+
+### Problem: `worker.php` oder `console.php` fehlen
+
+**Ursache:** Code wurde nicht synchronisiert
+
+**Lösung:** `sync-application-code.yml` erneut ausführen
+
+---
+
+## Unterschiede: Initial vs. Normal Deployment
+
+### Initial Deployment (dieser Guide)
+- **Code-Sync:** Rsync vom lokalen Repository
+- **Verwendung:** Einmalig beim ersten Setup
+- **Playbook:** `sync-application-code.yml`
+
+### Normal Deployment (CI/CD)
+- **Code-Sync:** Git Clone/Pull auf dem Server
+- **Verwendung:** Regelmäßige Deployments via CI/CD
+- **Playbook:** `deploy-application-code.yml`
+
+**Siehe auch:** [Code Deployment Workflow](./code-deployment-workflow.md)
+
+---
+
+## Nächste Schritte
+
+Nach erfolgreichem Initial Deployment:
+
+1. **CI/CD Pipeline konfigurieren**
+   - Gitea Actions Workflow einrichten
+   - `deploy-application-code.yml` für zukünftige Deployments verwenden
+
+2. **Monitoring einrichten**
+   - Health Checks verifizieren
+   - Logs überwachen
+   - Alerts konfigurieren
+
+3. **Backup-Strategie**
+   - Database Backups einrichten
+   - Application Data Backups konfigurieren
+
+---
+
+## Referenz
+
+- [Application Stack Deployment](../reference/application-stack.md) - Detaillierter Ablauf
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+- [Code Deployment Workflow](./code-deployment-workflow.md) - Normal Deployment Workflow
+- [Deployment Commands](./deployment-commands.md) - Command-Referenz
+
diff --git a/deployment/docs/guides/manual-server-test.md b/deployment/docs/guides/manual-server-test.md
new file mode 100644
index 00000000..13212085
--- /dev/null
+++ b/deployment/docs/guides/manual-server-test.md
@@ -0,0 +1,247 @@
+# Manuelle Server-Tests - Anleitung
+
+## Voraussetzungen
+
+- SSH-Zugriff auf Production-Server: `ssh production`
+- Docker und Docker Compose installiert
+- Zugriff auf `~/deployment` Verzeichnis
+
+## Test-Phasen
+
+### Phase 1: PostgreSQL-Stacks prüfen
+
+#### 1.1 PostgreSQL-Production Stack
+
+```bash
+# Auf Production-Server
+ssh production
+
+# Zum Stack-Verzeichnis wechseln
+cd ~/deployment/stacks/postgresql-production
+
+# .env-Datei prüfen/erstellen
+cat .env
+# Sollte enthalten:
+# POSTGRES_DB=michaelschiemer
+# POSTGRES_USER=postgres
+# POSTGRES_PASSWORD=<password>
+
+# Stack starten
+docker compose up -d
+
+# Status prüfen
+docker compose ps
+
+# Health-Check
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+# Erwartete Ausgabe: postgres-production:5432 - accepting connections
+```
+
+#### 1.2 PostgreSQL-Staging Stack
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-staging
+
+# .env-Datei prüfen/erstellen
+cat .env
+# Sollte enthalten:
+# POSTGRES_DB=michaelschiemer_staging
+# POSTGRES_USER=postgres
+# POSTGRES_PASSWORD=<password>
+
+# Stack starten
+docker compose up -d
+
+# Status prüfen
+docker compose ps
+
+# Health-Check
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+# Erwartete Ausgabe: postgres-staging:5432 - accepting connections
+```
+
+### Phase 2: Networks verifizieren
+
+```bash
+# Auf Production-Server
+docker network ls | grep -E "(traefik-public|staging-internal|postgres-production-internal|postgres-staging-internal|app-internal)"
+
+# Erwartete Ausgabe (alle sollten existieren):
+# traefik-public
+# staging-internal
+# postgres-production-internal
+# postgres-staging-internal
+# app-internal
+```
+
+**Falls Networks fehlen**: Sie werden beim Stack-Start automatisch erstellt.
+
+### Phase 3: Staging-Application-Stack prüfen
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/staging
+
+# Docker Compose-Dateien prüfen
+ls -la docker-compose*.yml
+
+# Stack-Status prüfen
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml ps
+
+# Oder falls im Root-Verzeichnis:
+cd ~/deployment
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml ps
+```
+
+### Phase 4: Datenbank-Verbindungen testen
+
+#### 4.1 Staging-Datenbank-Verbindung
+
+```bash
+# Auf Production-Server
+docker exec staging-app php -r "
+\$dsn = 'pgsql:host=postgres-staging;port=5432;dbname=michaelschiemer_staging';
+\$pass = trim(file_get_contents('/var/www/html/storage/secrets/db_user_password'));
+\$pdo = new PDO(\$dsn, 'postgres', \$pass);
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+**Erwartete Ausgabe**: `Connection successful: PostgreSQL 16.x...`
+
+#### 4.2 Production-Datenbank-Verbindung
+
+```bash
+# Auf Production-Server
+docker exec php php -r "
+\$dsn = 'pgsql:host=postgres-production;port=5432;dbname=michaelschiemer';
+\$pass = trim(file_get_contents('/var/www/html/storage/secrets/db_user_password'));
+\$pdo = new PDO(\$dsn, 'postgres', \$pass);
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+**Erwartete Ausgabe**: `Connection successful: PostgreSQL 16.x...`
+
+### Phase 5: Health-Checks
+
+#### 5.1 Basic Health Check
+
+```bash
+# Staging
+curl -f -k https://staging.michaelschiemer.de/health
+
+# Production
+curl -f -k https://michaelschiemer.de/health
+```
+
+**Erwartete Ausgabe**: HTTP 200 OK
+
+#### 5.2 Extended Health Check
+
+```bash
+# Staging
+curl -f -k https://staging.michaelschiemer.de/admin/health/api/summary | jq .
+
+# Production
+curl -f -k https://michaelschiemer.de/admin/health/api/summary | jq .
+```
+
+**Erwartete Ausgabe**: JSON mit `"overall_status": "healthy"`
+
+### Phase 6: Quick-Start-Script nutzen
+
+```bash
+# Auf Production-Server
+cd ~/deployment
+
+# Script ausführbar machen (falls nötig)
+chmod +x scripts/staging-quick-start.sh
+
+# Script ausführen
+./scripts/staging-quick-start.sh
+```
+
+Das Script bietet ein interaktives Menü für alle Tests.
+
+### Phase 7: Ansible-Verifikation (falls Ansible installiert)
+
+```bash
+# Auf Control-Node (lokal)
+cd ~/dev/michaelschiemer/deployment/ansible
+
+# Staging-Verifikation
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-staging.yml
+
+# Production-Verifikation
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-production.yml
+```
+
+## Fehlerbehebung
+
+### PostgreSQL-Container startet nicht
+
+```bash
+# Logs prüfen
+docker logs postgres-production
+docker logs postgres-staging
+
+# .env-Datei prüfen
+cat ~/deployment/stacks/postgresql-production/.env
+cat ~/deployment/stacks/postgresql-staging/.env
+
+# Volumes prüfen
+docker volume ls | grep postgres
+```
+
+### Network-Verbindung fehlgeschlagen
+
+```bash
+# Container-Networks prüfen
+docker inspect staging-app | grep -A 10 Networks
+docker inspect postgres-staging | grep -A 10 Networks
+
+# Network-Verbindung testen
+docker exec staging-app ping -c 2 postgres-staging
+```
+
+### Datenbank-Verbindung fehlgeschlagen
+
+```bash
+# Secrets prüfen
+docker exec staging-app ls -la /var/www/html/storage/secrets/
+docker exec staging-app cat /var/www/html/storage/secrets/db_user_password
+
+# Environment-Variablen prüfen
+docker exec staging-app env | grep DB_
+```
+
+### Health-Check fehlgeschlagen
+
+```bash
+# Container-Status prüfen
+docker ps | grep staging
+
+# Application-Logs prüfen
+docker logs staging-app --tail 50
+docker logs staging-nginx --tail 50
+```
+
+## Test-Ergebnisse dokumentieren
+
+Nach jedem Test:
+- ✅ Erfolgreich
+- ❌ Fehlgeschlagen (mit Fehlerbeschreibung)
+- ⚠️ Teilweise erfolgreich (mit Details)
+
+## Nächste Schritte
+
+Nach erfolgreichen Tests:
+1. CI/CD-Workflow testen (Commit auf `staging`-Branch)
+2. Datenbank-Isolation verifizieren
+3. Backup-Strategie testen
+4. Monitoring einrichten
+
diff --git a/deployment/docs/guides/migrate-to-separate-databases.md b/deployment/docs/guides/migrate-to-separate-databases.md
new file mode 100644
index 00000000..01c2e45b
--- /dev/null
+++ b/deployment/docs/guides/migrate-to-separate-databases.md
@@ -0,0 +1,286 @@
+# Migration Guide: Separate Database Stacks
+
+## Overview
+
+This guide describes how to migrate from a shared PostgreSQL stack to separate database stacks for Production and Staging.
+
+## Current State (Before Migration)
+
+- Single PostgreSQL stack: `deployment/stacks/postgresql/`
+- Both Production and Staging connect to the same database instance
+- Database name: `michaelschiemer` (Production) and `michaelschiemer_staging` (Staging) in same instance
+
+## Target State (After Migration)
+
+- **Production Database**: `deployment/stacks/postgresql-production/`
+  - Container: `postgres-production`
+  - Network: `postgres-production-internal`
+  - Database: `michaelschiemer`
+
+- **Staging Database**: `deployment/stacks/postgresql-staging/`
+  - Container: `postgres-staging`
+  - Network: `postgres-staging-internal`
+  - Database: `michaelschiemer_staging`
+
+## Migration Steps
+
+### Phase 1: Backup Existing Database
+
+**CRITICAL**: Create backups before migration!
+
+```bash
+# On production server
+cd ~/deployment/stacks/postgresql
+
+# Create backup of production database
+docker exec postgres-backup /scripts/backup.sh
+
+# Create backup of staging database (if exists in same instance)
+docker exec postgres psql -U postgres -d michaelschiemer_staging -c "SELECT 1;" && \
+  docker exec postgres-backup /scripts/backup.sh || echo "Staging database not found"
+
+# List backups
+ls -lh backups/
+```
+
+### Phase 2: Deploy New Database Stacks
+
+#### 2.1 Deploy PostgreSQL Production Stack
+
+```bash
+# On production server
+cd ~/deployment/stacks/postgresql-production
+
+# Create .env file
+cat > .env <<EOF
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<same-as-production-password>
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
+EOF
+
+# Start PostgreSQL Production
+docker compose up -d
+
+# Verify
+docker compose ps
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+```
+
+#### 2.2 Deploy PostgreSQL Staging Stack
+
+```bash
+# On production server
+cd ~/deployment/stacks/postgresql-staging
+
+# Create .env file
+cat > .env <<EOF
+POSTGRES_DB=michaelschiemer_staging
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<staging-password-can-differ>
+BACKUP_RETENTION_DAYS=3
+BACKUP_SCHEDULE=0 3 * * *
+EOF
+
+# Start PostgreSQL Staging
+docker compose up -d
+
+# Verify
+docker compose ps
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+```
+
+### Phase 3: Restore Data to New Stacks
+
+#### 3.1 Restore Production Database
+
+```bash
+# Find latest production backup
+LATEST_PROD_BACKUP=$(ls -t ~/deployment/stacks/postgresql/backups/postgres_michaelschiemer_*.sql.gz | head -1)
+
+# Copy backup to new stack
+cp "$LATEST_PROD_BACKUP" ~/deployment/stacks/postgresql-production/backups/
+
+# Restore to new production database
+cd ~/deployment/stacks/postgresql-production
+docker exec -it postgres-production-backup /scripts/restore.sh "/backups/$(basename $LATEST_PROD_BACKUP)"
+```
+
+#### 3.2 Restore Staging Database (if exists)
+
+```bash
+# Find latest staging backup (if exists)
+LATEST_STAGING_BACKUP=$(ls -t ~/deployment/stacks/postgresql/backups/postgres_michaelschiemer_staging_*.sql.gz 2>/dev/null | head -1)
+
+if [ -n "$LATEST_STAGING_BACKUP" ]; then
+  # Copy backup to new stack
+  cp "$LATEST_STAGING_BACKUP" ~/deployment/stacks/postgresql-staging/backups/
+  
+  # Restore to new staging database
+  cd ~/deployment/stacks/postgresql-staging
+  docker exec -it postgres-staging-backup /scripts/restore.sh "/backups/$(basename $LATEST_STAGING_BACKUP)"
+else
+  echo "No staging backup found - creating empty staging database"
+fi
+```
+
+### Phase 4: Update Application Stacks
+
+#### 4.1 Update Production Application Stack
+
+The Production Application Stack should already be configured to use `postgres-production` via:
+- Environment variable: `DB_HOST=postgres-production`
+- Network: Connected to `postgres-production-internal`
+
+**Verify connection**:
+```bash
+cd ~/deployment/stacks/production
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml exec app \
+  php -r "echo 'DB Connection: '; \$pdo = new PDO('pgsql:host=postgres-production;dbname=michaelschiemer', 'postgres', getenv('DB_PASSWORD')); echo 'OK\n';"
+```
+
+#### 4.2 Update Staging Application Stack
+
+The Staging Application Stack should already be configured to use `postgres-staging` via:
+- Environment variable: `DB_HOST=postgres-staging`
+- Network: Connected to `postgres-staging-internal`
+
+**Verify connection**:
+```bash
+cd ~/deployment/stacks/staging
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml exec staging-app \
+  php -r "echo 'DB Connection: '; \$pdo = new PDO('pgsql:host=postgres-staging;dbname=michaelschiemer_staging', 'postgres', getenv('DB_PASSWORD')); echo 'OK\n';"
+```
+
+### Phase 5: Verify Migration
+
+#### 5.1 Production Verification
+
+```bash
+# Check production database
+docker exec postgres-production psql -U postgres -d michaelschiemer -c "\dt"
+
+# Check production application
+curl -k https://michaelschiemer.de/health
+
+# Check production logs
+cd ~/deployment/stacks/production
+docker compose logs app | tail -20
+```
+
+#### 5.2 Staging Verification
+
+```bash
+# Check staging database
+docker exec postgres-staging psql -U postgres -d michaelschiemer_staging -c "\dt"
+
+# Check staging application
+curl -k https://staging.michaelschiemer.de/health
+
+# Check staging logs
+cd ~/deployment/stacks/staging
+docker compose logs staging-app | tail -20
+```
+
+### Phase 6: Cleanup (Optional)
+
+**WARNING**: Only remove old stack after successful migration and verification!
+
+```bash
+# Stop old PostgreSQL stack
+cd ~/deployment/stacks/postgresql
+docker compose down
+
+# Keep backups for safety - do NOT delete yet
+# Consider keeping for at least 30 days
+
+# Remove old stack (only after 30+ days of successful operation)
+# rm -rf ~/deployment/stacks/postgresql
+```
+
+## Rollback Plan
+
+If migration fails:
+
+### Rollback to Shared Database
+
+```bash
+# 1. Stop new database stacks
+cd ~/deployment/stacks/postgresql-production
+docker compose down
+
+cd ~/deployment/stacks/postgresql-staging
+docker compose down
+
+# 2. Restart old shared stack
+cd ~/deployment/stacks/postgresql
+docker compose up -d
+
+# 3. Update application stacks to use old database
+# Revert DB_HOST changes in docker-compose files
+# Restart application stacks
+```
+
+## Network Configuration
+
+### Production Application Stack
+
+Must be connected to:
+- `traefik-public` (for external access)
+- `postgres-production-internal` (for database access)
+- `app-internal` (for Redis, if shared)
+
+### Staging Application Stack
+
+Must be connected to:
+- `traefik-public` (for external access)
+- `postgres-staging-internal` (for database access)
+- `staging-internal` (for staging services)
+
+## Backup Strategy
+
+### Production Backups
+
+- **Location**: `~/deployment/stacks/postgresql-production/backups/`
+- **Retention**: 7 days
+- **Schedule**: Daily at 2:00 AM
+
+### Staging Backups
+
+- **Location**: `~/deployment/stacks/postgresql-staging/backups/`
+- **Retention**: 3 days
+- **Schedule**: Daily at 3:00 AM
+
+## Troubleshooting
+
+### Database Connection Refused
+
+```bash
+# Check if database container is running
+docker ps | grep postgres-production
+docker ps | grep postgres-staging
+
+# Check network connectivity
+docker network inspect postgres-production-internal
+docker network inspect postgres-staging-internal
+
+# Test connection from application container
+docker exec <app-container> nc -zv postgres-production 5432
+docker exec <app-container> nc -zv postgres-staging 5432
+```
+
+### Migration Data Loss
+
+If data is missing after migration:
+
+1. **Stop application** to prevent further writes
+2. **Restore from backup** (see Phase 3)
+3. **Verify data** before restarting application
+
+## Additional Resources
+
+- **PostgreSQL Production Stack**: `deployment/stacks/postgresql-production/README.md`
+- **PostgreSQL Staging Stack**: `deployment/stacks/postgresql-staging/README.md`
+- **Backup Playbook**: `deployment/ansible/playbooks/backup.yml`
+
diff --git a/deployment/docs/guides/os-selection.md b/deployment/docs/guides/os-selection.md
new file mode 100644
index 00000000..f056dd32
--- /dev/null
+++ b/deployment/docs/guides/os-selection.md
@@ -0,0 +1,144 @@
+# Betriebssystem-Auswahl f?r Production-Server
+
+**Status**: ? Aktuell  
+**Empfehlung**: Ubuntu 22.04 LTS  
+**Letzte Aktualisierung**: 2025-01-XX
+
+---
+
+## Empfehlung: Ubuntu 22.04 LTS
+
+### Warum Ubuntu?
+
+1. **? Getestet und validiert**
+   - Alle Ansible-Playbooks sind mit Ubuntu 22.04 LTS getestet
+   - Docker-Install-Script ist f?r Ubuntu optimiert
+
+2. **? LTS-Support**
+   - Support bis April 2027
+   - Regelm??ige Security-Updates
+   - Stabile Basis f?r Production
+
+3. **? Docker-Kompatibilit?t**
+   - Offizielle Docker-Repositorys f?r Ubuntu
+   - Beste Performance und Kompatibilit?t
+   - Aktuelle Docker-Versionen verf?gbar
+
+4. **? Dokumentation**
+   - Alle Guides und Scripts sind auf Ubuntu ausgelegt
+   - Weniger Anpassungen n?tig
+
+5. **? Community & Support**
+   - Gro?e Community
+   - Viele Tutorials und L?sungen verf?gbar
+   - Einfacheres Troubleshooting
+
+---
+
+## Alternative: Debian 12
+
+### Vor- und Nachteile
+
+**Vorteile:**
+- ? Minimaler Footprint (weniger Ressourcen)
+- ? Sehr stabil und sicher
+- ? L?ngere Release-Zyklen
+- ? Open-Source pur (keine kommerziellen Komponenten)
+
+**Nachteile:**
+- ?? Docker-Install-Script muss angepasst werden
+- ?? ?ltere Paket-Versionen (konservativer)
+- ?? Weniger getestet mit diesem Setup
+
+### Anpassungen f?r Debian 12
+
+Falls Debian 12 verwendet werden soll, m?ssen folgende Anpassungen vorgenommen werden:
+
+**1. Docker-Install-Script anpassen** (`deployment/ansible/playbooks/install-docker.yml`):
+
+```yaml
+# Zeile 25: Ubuntu ? Debian
+- name: Add Docker GPG key
+  ansible.builtin.shell:
+    cmd: |
+      curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
+      chmod a+r /etc/apt/keyrings/docker.asc
+    creates: /etc/apt/keyrings/docker.asc
+
+# Zeile 32: Ubuntu ? Debian
+- name: Add Docker repository
+  ansible.builtin.shell:
+    cmd: |
+      echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
+    creates: /etc/apt/sources.list.d/docker.list
+```
+
+**2. OS-Detection in Playbooks pr?fen**
+
+Die meisten Ansible-Roles verwenden `ansible_os_family == 'Debian'`, was f?r beide Systeme funktioniert. Aber spezifische Ubuntu-Checks m?ssen angepasst werden.
+
+---
+
+## Vergleich
+
+| Kriterium | Ubuntu 22.04 LTS | Debian 12 |
+|-----------|------------------|-----------|
+| **Getestet** | ? Ja | ?? Teilweise |
+| **Docker-Support** | ? Optimal | ?? Anpassung n?tig |
+| **LTS-Support** | ? Bis 2027 | ? Bis 2029 |
+| **Ressourcen** | ?? Mehr | ? Weniger |
+| **Paket-Versionen** | ? Aktueller | ?? Konservativer |
+| **Dokumentation** | ? Vollst?ndig | ?? Anpassung n?tig |
+| **Community** | ? Gro? | ? Gro? |
+| **Setup-Aufwand** | ? Minimal | ?? Anpassungen n?tig |
+
+---
+
+## Empfehlung f?r dieses Projekt
+
+**Ubuntu 22.04 LTS** ist die beste Wahl, weil:
+
+1. ? Alle Scripts und Playbooks sind darauf ausgelegt
+2. ? Docker-Installation funktioniert out-of-the-box
+3. ? Vollst?ndig getestet und dokumentiert
+4. ? LTS-Support bis 2027 (ausreichend f?r Production)
+5. ? Einfacheres Setup und Wartung
+
+**Debian 12** ist m?glich, wenn:
+- Minimaler Footprint wichtig ist
+- Man bereit ist, das Docker-Install-Script anzupassen
+- Man die l?ngere LTS-Periode (bis 2029) bevorzugt
+
+---
+
+## Migration zwischen Systemen
+
+Falls sp?ter von Ubuntu zu Debian (oder umgekehrt) gewechselt werden soll:
+
+1. **Backup erstellen**
+   - Datenbank-Dumps
+   - Docker-Volumes
+   - Konfigurationsdateien
+
+2. **Server neu aufsetzen**
+   - Neues OS installieren
+   - Basis-Setup durchf?hren
+
+3. **Ansible-Playbooks anpassen** (falls Debian)
+   - Docker-Install-Script anpassen
+   - OS-spezifische Checks pr?fen
+
+4. **Infrastructure deployen**
+   - Via Ansible alle Stacks deployen
+   - Datenbank-Dumps wiederherstellen
+   - Volumes migrieren
+
+---
+
+## Fazit
+
+F?r dieses Projekt: **Ubuntu 22.04 LTS** ist die empfohlene und getestete Wahl. Debian 12 ist m?glich, erfordert aber zus?tzliche Anpassungen.
+
+**N?chste Schritte:**
+- Server mit Ubuntu 22.04 LTS installieren
+- Setup-Guide befolgen: `deployment/docs/guides/server-rebuild-plan.md`
diff --git a/deployment/docs/guides/pipeline-test-checklist.md b/deployment/docs/guides/pipeline-test-checklist.md
new file mode 100644
index 00000000..9b484b16
--- /dev/null
+++ b/deployment/docs/guides/pipeline-test-checklist.md
@@ -0,0 +1,356 @@
+# CI/CD Pipeline Test Checklist
+
+**Stand:** 2025-01-XX  
+**Zweck:** Schritt-für-Schritt Checkliste für End-to-End Pipeline-Tests
+
+---
+
+## Vorbereitung
+
+### Prerequisites Check ausführen
+
+```bash
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-pipeline-prerequisites.sh
+```
+
+**Erwartet:** Alle Checks sollten grün sein (Warnings sind OK)
+
+### Gitea Secrets verifizieren
+
+**URL:** `https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions`
+
+**Erforderliche Secrets:**
+- [ ] `REGISTRY_USER` - Docker Registry Benutzername
+- [ ] `REGISTRY_PASSWORD` - Docker Registry Passwort
+- [ ] `SSH_PRIVATE_KEY` - SSH Private Key für Production-Server
+- [ ] `ANSIBLE_VAULT_PASSWORD` - Ansible Vault Password (optional, falls Vault verschlüsselt)
+
+### Gitea Runner Status prüfen
+
+**URL:** `https://git.michaelschiemer.de/admin/actions/runners`
+
+**Erwartet:**
+- [ ] Runner ist sichtbar als "Idle" oder "Active"
+- [ ] Runner Name: `dev-runner-01` (oder ähnlich)
+- [ ] Runner Labels: `ubuntu-latest`, `ubuntu-22.04`, `debian-latest`
+
+**Lokal prüfen:**
+```bash
+cd deployment/gitea-runner
+docker compose ps
+```
+
+**Erwartet:**
+- [ ] `gitea-runner`: Up
+- [ ] `gitea-runner-dind`: Up
+
+---
+
+## Staging Pipeline Test
+
+### Schritt 1: Test-Commit erstellen
+
+```bash
+# Auf staging Branch wechseln
+git checkout staging
+git pull origin staging
+
+# Kleine Änderung machen
+echo "# CI/CD Pipeline Test - $(date)" >> README.md
+git add README.md
+git commit -m "test: CI/CD pipeline staging test"
+git push origin staging
+```
+
+**Erwartet:**
+- [ ] Push erfolgreich
+- [ ] Keine Git-Fehler
+
+### Schritt 2: Pipeline in Gitea Actions beobachten
+
+**URL:** `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+
+**Erwartete Jobs (in Reihenfolge):**
+
+1. **changes** - Determine Build Necessity
+   - [ ] Job startet innerhalb von 1-2 Minuten
+   - [ ] Job läuft erfolgreich durch
+   - [ ] Output zeigt: `needs_build=true` (oder `false` wenn nur Docs geändert)
+
+2. **runtime-base** - Build Runtime Base Image (nur wenn `needs_runtime_build=true`)
+   - [ ] Job startet nach `changes`
+   - [ ] Docker Build läuft erfolgreich
+   - [ ] Image wird zur Registry gepusht
+
+3. **test** - Run Tests & Quality Checks (nur wenn `needs_build=true`)
+   - [ ] Job startet nach `changes`
+   - [ ] Composer Dependencies werden installiert
+   - [ ] Tests laufen (oder werden übersprungen mit Warnung)
+   - [ ] Job läuft erfolgreich durch
+
+4. **build** - Build Docker Image (nur wenn `needs_build=true`)
+   - [ ] Job startet nach `runtime-base` und `test`
+   - [ ] Docker Build läuft erfolgreich
+   - [ ] Image wird mit Tags gepusht: `latest`, `git-<sha>`, `<sha>-<timestamp>`
+   - [ ] Output zeigt Image URL
+
+5. **deploy-staging** - Auto-deploy to Staging
+   - [ ] Job startet nach `build`
+   - [ ] SSH-Verbindung zum Server erfolgreich
+   - [ ] Code-Deployment (`deploy-application-code.yml`) erfolgreich
+   - [ ] Composer Dependencies Installation erfolgreich
+   - [ ] Image-Deployment (`deploy-image.yml`) erfolgreich
+   - [ ] Health-Check erfolgreich
+
+**Gesamtzeit:** ~8-15 Minuten
+
+### Schritt 3: Deployment auf Staging verifizieren
+
+**Code-Deployment:**
+```bash
+ssh deploy@94.16.110.151
+cd /home/deploy/michaelschiemer/current
+git log -1  # Sollte Test-Commit zeigen
+git branch  # Sollte auf staging sein
+```
+
+**Erwartet:**
+- [ ] Letzter Commit ist der Test-Commit
+- [ ] Branch ist `staging`
+
+**Composer Dependencies:**
+```bash
+cd ~/deployment/stacks/staging
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml \
+  exec staging-app test -f /var/www/html/vendor/autoload.php && echo "EXISTS"
+```
+
+**Erwartet:**
+- [ ] Output: `EXISTS`
+
+**Image-Deployment:**
+```bash
+docker compose -f docker-compose.base.yml -f docker-compose.staging.yml ps
+```
+
+**Erwartet:**
+- [ ] Alle Container: Up (healthy)
+- [ ] Image Tag entspricht dem gebauten Image
+
+**Health-Check:**
+```bash
+curl -f https://staging.michaelschiemer.de/health
+```
+
+**Erwartet:**
+- [ ] HTTP 200 OK
+- [ ] JSON Response mit Status
+
+**Application Test:**
+- [ ] Staging URL erreichbar: `https://staging.michaelschiemer.de`
+- [ ] Application läuft korrekt
+- [ ] Keine Fehler in Browser Console
+
+### Schritt 4: Fehlerbehebung (falls notwendig)
+
+**Falls Jobs fehlschlagen:**
+
+1. **Logs in Gitea Actions UI prüfen**
+   - Klicke auf fehlgeschlagenen Job
+   - Scrolle durch Logs
+   - Suche nach Fehlermeldungen
+
+2. **Container Logs auf Server prüfen**
+   ```bash
+   ssh deploy@94.16.110.151
+   cd ~/deployment/stacks/staging
+   docker compose -f docker-compose.base.yml -f docker-compose.staging.yml logs
+   ```
+
+3. **Bekannte Probleme:**
+   - Siehe: `deployment/docs/troubleshooting/initial-deployment-issues.md`
+   - Siehe: `deployment/docs/guides/pipeline-testing-guide.md`
+
+---
+
+## Production Pipeline Test
+
+**⚠️ WICHTIG:** Nur nach erfolgreichem Staging-Test durchführen!
+
+### Schritt 1: Test-Commit auf main erstellen
+
+```bash
+# Auf main Branch wechseln
+git checkout main
+git pull origin main
+
+# Merge staging (oder direkter Commit für Test)
+echo "# CI/CD Pipeline Test Production - $(date)" >> README.md
+git add README.md
+git commit -m "test: CI/CD pipeline production test"
+git push origin main
+```
+
+**Erwartet:**
+- [ ] Push erfolgreich
+- [ ] Keine Git-Fehler
+
+### Schritt 2: Pipeline in Gitea Actions beobachten
+
+**URL:** `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+
+**Erwartete Jobs (in Reihenfolge):**
+
+1. **changes** - Determine Build Necessity
+   - [ ] Job startet innerhalb von 1-2 Minuten
+   - [ ] Job läuft erfolgreich durch
+
+2. **runtime-base** - Build Runtime Base Image (falls notwendig)
+   - [ ] Job startet nach `changes`
+   - [ ] Docker Build läuft erfolgreich
+
+3. **test** - Run Tests & Quality Checks
+   - [ ] Job startet nach `changes`
+   - [ ] Tests laufen erfolgreich
+
+4. **build** - Build Docker Image
+   - [ ] Job startet nach `runtime-base` und `test`
+   - [ ] Docker Build läuft erfolgreich
+   - [ ] Image wird zur Registry gepusht
+
+5. **deploy-production** - Auto-deploy to Production
+   - [ ] Job startet nach `build`
+   - [ ] SSH-Verbindung erfolgreich
+   - [ ] Code-Deployment erfolgreich
+   - [ ] Composer Dependencies Installation erfolgreich
+   - [ ] Image-Deployment erfolgreich
+   - [ ] Health-Check erfolgreich
+
+**Gesamtzeit:** ~8-15 Minuten
+
+### Schritt 3: Deployment auf Production verifizieren
+
+**Code-Deployment:**
+```bash
+ssh deploy@94.16.110.151
+cd /home/deploy/michaelschiemer/current
+git log -1  # Sollte Test-Commit zeigen
+git branch  # Sollte auf main sein
+```
+
+**Erwartet:**
+- [ ] Letzter Commit ist der Test-Commit
+- [ ] Branch ist `main`
+
+**Composer Dependencies:**
+```bash
+cd ~/deployment/stacks/production
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml \
+  exec php test -f /var/www/html/vendor/autoload.php && echo "EXISTS"
+```
+
+**Erwartet:**
+- [ ] Output: `EXISTS`
+
+**Image-Deployment:**
+```bash
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml ps
+```
+
+**Erwartet:**
+- [ ] Alle Container: Up (healthy)
+- [ ] Image Tag entspricht dem gebauten Image
+
+**Health-Check:**
+```bash
+curl -f https://michaelschiemer.de/health
+```
+
+**Erwartet:**
+- [ ] HTTP 200 OK
+- [ ] JSON Response mit Status
+
+**Application Test:**
+- [ ] Production URL erreichbar: `https://michaelschiemer.de`
+- [ ] Application läuft korrekt
+- [ ] Keine Fehler in Browser Console
+
+### Schritt 4: Rollback-Test (Optional)
+
+**Falls Deployment fehlschlägt oder Probleme auftreten:**
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Erwartet:**
+- [ ] Rollback erfolgreich
+- [ ] Vorherige Version läuft wieder
+
+---
+
+## Test-Zusammenfassung
+
+### Staging Test
+- [ ] Alle Jobs erfolgreich
+- [ ] Code-Deployment erfolgreich
+- [ ] Composer Dependencies installiert
+- [ ] Image-Deployment erfolgreich
+- [ ] Health-Check erfolgreich
+- [ ] Application läuft korrekt
+
+### Production Test
+- [ ] Alle Jobs erfolgreich
+- [ ] Code-Deployment erfolgreich
+- [ ] Composer Dependencies installiert
+- [ ] Image-Deployment erfolgreich
+- [ ] Health-Check erfolgreich
+- [ ] Application läuft korrekt
+
+---
+
+## Nächste Schritte nach erfolgreichem Test
+
+1. **Dokumentation aktualisieren**
+   - Status-Dokumente aktualisieren
+   - Bekannte Probleme dokumentieren
+   - Testergebnisse dokumentieren
+
+2. **Backup-Playbook testen**
+   - Siehe: `deployment/docs/guides/backup-and-rollback-guide.md`
+
+3. **Monitoring verifizieren**
+   - Health-Checks funktionieren
+   - Logs sind verfügbar
+   - Metriken werden gesammelt
+
+---
+
+## Troubleshooting
+
+### Pipeline startet nicht
+- Prüfe Gitea Runner Status
+- Prüfe Workflow-Datei Syntax
+- Prüfe Branch-Trigger
+
+### Registry Login fehlschlägt
+- Prüfe `REGISTRY_USER` und `REGISTRY_PASSWORD` Secrets
+- Teste Registry-Login manuell
+
+### SSH-Verbindung fehlschlägt
+- Prüfe `SSH_PRIVATE_KEY` Secret
+- Prüfe SSH-Zugriff manuell
+
+### Health-Check fehlschlägt
+- Prüfe Container Status
+- Prüfe Container Logs
+- Prüfe Application Logs
+
+**Weitere Hilfe:**
+- `deployment/docs/troubleshooting/initial-deployment-issues.md`
+- `deployment/docs/guides/pipeline-testing-guide.md`
+
diff --git a/deployment/docs/guides/pipeline-test-steps.md b/deployment/docs/guides/pipeline-test-steps.md
new file mode 100644
index 00000000..d705d209
--- /dev/null
+++ b/deployment/docs/guides/pipeline-test-steps.md
@@ -0,0 +1,214 @@
+# CI/CD Pipeline Test - Schritt-für-Schritt Anleitung
+
+**Stand:** 2025-11-07  
+**Status:** Gemeinsame Test-Anleitung
+
+---
+
+## Vorbereitung
+
+### Schritt 1: Aktuellen Status prüfen
+
+```bash
+# Im Repository-Root
+cd ~/dev/michaelschiemer  # oder dein Repository-Pfad
+
+# Aktuellen Branch prüfen
+git branch --show-current
+
+# Status prüfen
+git status
+```
+
+**Erwartet:**
+- Branch: `staging` oder `main` (je nachdem was du testen willst)
+- Keine uncommitted Changes (oder committen vorher)
+
+### Schritt 2: Secrets in Gitea prüfen
+
+**Öffne im Browser:**
+```
+https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions
+```
+
+**Prüfe ob folgende Secrets vorhanden sind:**
+- ✅ `REGISTRY_USER`
+- ✅ `REGISTRY_PASSWORD`
+- ✅ `SSH_PRIVATE_KEY`
+- ✅ `ANSIBLE_VAULT_PASSWORD`
+
+**Falls `ANSIBLE_VAULT_PASSWORD` fehlt:**
+- Erstelle Secret mit dem Vault-Passwort aus `deployment/ansible/secrets/.vault_pass`
+
+### Schritt 3: Gitea Runner Status prüfen
+
+**Im Browser:**
+```
+https://git.michaelschiemer.de/admin/actions/runners
+```
+
+**Erwartet:**
+- Runner sollte als "Idle" oder "Active" angezeigt werden
+
+**Oder lokal prüfen:**
+```bash
+cd deployment/gitea-runner
+docker compose ps
+```
+
+**Erwartet:**
+- `gitea-runner`: Up
+- `gitea-runner-dind`: Up
+
+---
+
+## Staging Pipeline Test
+
+### Schritt 1: Auf staging Branch wechseln
+
+```bash
+cd ~/dev/michaelschiemer  # oder dein Repository-Pfad
+git checkout staging
+git pull origin staging
+```
+
+### Schritt 2: Test-Commit erstellen
+
+```bash
+# Kleine Änderung
+echo "# Test CI/CD Pipeline - $(date)" >> README.md
+
+# Committen
+git add README.md
+git commit -m "test: CI/CD pipeline test"
+
+# Pushen (triggert automatisch Pipeline)
+git push origin staging
+```
+
+### Schritt 3: Pipeline beobachten
+
+**Öffne im Browser:**
+```
+https://git.michaelschiemer.de/michael/michaelschiemer/actions
+```
+
+**Erwartete Jobs:**
+1. **changes** - Prüft ob Build notwendig ist
+2. **test** - Führt Tests aus (falls changes = true)
+3. **build** - Baut Docker Image (falls changes = true)
+4. **deploy-staging** - Deploy zu Staging (automatisch bei staging Branch)
+
+**Beobachte jeden Job:**
+- Klicke auf den Job
+- Prüfe die Logs
+- Notiere Fehler falls welche auftreten
+
+### Schritt 4: Verifikation auf Server
+
+**Nach erfolgreichem Pipeline-Lauf:**
+
+```bash
+# SSH zum Server
+ssh deploy@94.16.110.151
+
+# Code-Deployment prüfen
+cd /home/deploy/michaelschiemer/current
+git log -1  # Sollte Test-Commit zeigen
+
+# Composer Dependencies prüfen
+docker compose -f ~/deployment/stacks/production/docker-compose.base.yml \
+  -f ~/deployment/stacks/production/docker-compose.production.yml \
+  exec php test -f /var/www/html/vendor/autoload.php && echo "EXISTS" || echo "MISSING"
+
+# Container Status prüfen
+docker compose -f ~/deployment/stacks/production/docker-compose.base.yml \
+  -f ~/deployment/stacks/production/docker-compose.production.yml ps
+
+# Health-Check
+curl -f https://staging.michaelschiemer.de/health
+```
+
+---
+
+## Production Pipeline Test
+
+**Wichtig:** Nur nach erfolgreichem Staging-Test!
+
+### Schritt 1: Auf main Branch wechseln
+
+```bash
+cd ~/dev/michaelschiemer
+git checkout main
+git pull origin main
+```
+
+### Schritt 2: Test-Commit erstellen
+
+```bash
+# Kleine Änderung
+echo "# Test CI/CD Pipeline Production - $(date)" >> README.md
+
+# Committen
+git add README.md
+git commit -m "test: CI/CD pipeline production test"
+
+# Pushen (triggert automatisch Pipeline)
+git push origin main
+```
+
+### Schritt 3: Pipeline beobachten
+
+**Gleiche Schritte wie Staging:**
+- Pipeline in Gitea Actions UI beobachten
+- Jobs prüfen
+- Logs analysieren
+
+### Schritt 4: Verifikation auf Server
+
+**Gleiche Checks wie Staging, aber Production URL:**
+```bash
+curl -f https://michaelschiemer.de/health
+```
+
+---
+
+## Fehlerbehebung
+
+### Problem: Pipeline startet nicht
+
+**Prüfe:**
+1. Runner läuft: `docker compose ps` in `deployment/gitea-runner`
+2. Runner in Gitea UI sichtbar
+3. Workflow-Datei korrekt
+
+### Problem: Code-Deployment schlägt fehl
+
+**Prüfe:**
+1. `deploy-application-code.yml` Logs in Gitea Actions
+2. Git Repository existiert auf Server
+3. Branch-Name korrekt
+
+### Problem: Image-Deployment schlägt fehl
+
+**Prüfe:**
+1. Registry Login erfolgreich
+2. Image existiert in Registry
+3. `deploy-image.yml` Logs
+
+### Problem: Health-Check schlägt fehl
+
+**Prüfe:**
+1. Container Status: `docker compose ps`
+2. Container Logs: `docker compose logs`
+3. Health-Check Endpoint: `curl https://michaelschiemer.de/health`
+
+---
+
+## Nächste Schritte
+
+Nach erfolgreichem Test:
+1. Fehler dokumentieren (falls welche aufgetreten sind)
+2. CI/CD Status aktualisieren
+3. Production-Deployment für echte Features verwenden
+
diff --git a/deployment/docs/guides/pipeline-testing-guide.md b/deployment/docs/guides/pipeline-testing-guide.md
new file mode 100644
index 00000000..77cd7464
--- /dev/null
+++ b/deployment/docs/guides/pipeline-testing-guide.md
@@ -0,0 +1,298 @@
+# CI/CD Pipeline Testing Guide
+
+**Stand:** 2025-11-07  
+**Status:** Anleitung für End-to-End Pipeline-Tests
+
+---
+
+## Übersicht
+
+Dieses Dokument erklärt, wie die CI/CD Pipeline getestet wird. Die Tests sollten sowohl für Staging als auch für Production durchgeführt werden.
+
+**📖 Verwandte Dokumentation:**
+- [Pipeline Test Checklist](./pipeline-test-checklist.md) ⭐ - Detaillierte Schritt-für-Schritt Checkliste
+- [CI/CD Workflow Guide](./cicd-workflow-guide.md) - Workflow-Dokumentation
+- [CI/CD Status](../status/ci-cd-status.md) - Aktueller Status
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+
+**🔧 Test-Scripts:**
+- `deployment/scripts/test-pipeline-prerequisites.sh` - Prüft alle Voraussetzungen für Pipeline-Tests
+
+---
+
+## Voraussetzungen prüfen
+
+**Schnellcheck mit Script:**
+```bash
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-pipeline-prerequisites.sh
+```
+
+Dieses Script prüft automatisch alle Voraussetzungen und gibt eine Zusammenfassung aus.
+
+### 1. Secrets konfiguriert
+
+**Erforderliche Secrets in Gitea:**
+- ✅ `REGISTRY_USER` - Docker Registry Benutzername
+- ✅ `REGISTRY_PASSWORD` - Docker Registry Passwort
+- ✅ `SSH_PRIVATE_KEY` - SSH Private Key für Production-Server
+- ✅ `ANSIBLE_VAULT_PASSWORD` - Ansible Vault Password
+
+**Prüfen:**
+```
+https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions
+```
+
+### 2. Gitea Runner läuft
+
+**Prüfen:**
+```bash
+cd deployment/gitea-runner
+docker compose ps
+```
+
+**Erwartet:**
+- `gitea-runner`: Up
+- `gitea-runner-dind`: Up
+
+**In Gitea UI prüfen:**
+```
+https://git.michaelschiemer.de/admin/actions/runners
+```
+Runner sollte als "Idle" oder "Active" angezeigt werden.
+
+### 3. Application Stack läuft
+
+**Prüfen:**
+```bash
+ssh deploy@94.16.110.151
+cd ~/deployment/stacks/production
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml ps
+```
+
+**Erwartet:**
+- Alle Container: Up (healthy)
+
+---
+
+## Staging Pipeline Test
+
+### Schritt 1: Test-Commit erstellen
+
+```bash
+# Auf staging Branch
+git checkout staging
+git pull origin staging
+
+# Kleine Änderung
+echo "# Test CI/CD Pipeline - $(date)" >> README.md
+git add README.md
+git commit -m "test: CI/CD pipeline test"
+git push origin staging
+```
+
+### Schritt 2: Pipeline beobachten
+
+**Gitea Actions UI:**
+```
+https://git.michaelschiemer.de/michael/michaelschiemer/actions
+```
+
+**Erwartete Jobs:**
+1. **changes** - Prüft ob Build notwendig ist
+2. **test** - Führt Tests aus
+3. **build** - Baut Docker Image
+4. **deploy-staging** - Deploy zu Staging
+
+### Schritt 3: Verifikation
+
+**Code-Deployment:**
+```bash
+ssh deploy@94.16.110.151
+cd /home/deploy/michaelschiemer/current
+git log -1  # Sollte Test-Commit zeigen
+```
+
+**Composer Dependencies:**
+```bash
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml \
+  exec php test -f /var/www/html/vendor/autoload.php && echo "EXISTS"
+```
+
+**Image-Deployment:**
+```bash
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml \
+  ps  # Container sollten mit neuem Image laufen
+```
+
+**Health-Check:**
+```bash
+curl -f https://staging.michaelschiemer.de/health
+```
+
+### Schritt 4: Fehler beheben
+
+**Falls Fehler auftreten:**
+1. Logs in Gitea Actions UI prüfen
+2. Container Logs prüfen: `docker compose logs`
+3. Siehe [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)
+
+---
+
+## Production Pipeline Test
+
+### Schritt 1: Test-Commit erstellen
+
+**Wichtig:** Nur nach erfolgreichem Staging-Test!
+
+```bash
+# Auf main Branch
+git checkout main
+git pull origin main
+
+# Merge staging (oder direkter Commit für Test)
+echo "# Test CI/CD Pipeline Production - $(date)" >> README.md
+git add README.md
+git commit -m "test: CI/CD pipeline production test"
+git push origin main
+```
+
+### Schritt 2: Pipeline beobachten
+
+**Gitea Actions UI:**
+```
+https://git.michaelschiemer.de/michael/michaelschiemer/actions
+```
+
+**Erwartete Jobs:**
+1. **changes** - Prüft ob Build notwendig ist
+2. **test** - Führt Tests aus
+3. **build** - Baut Docker Image
+4. **deploy-production** - Deploy zu Production
+
+### Schritt 3: Verifikation
+
+**Gleiche Checks wie Staging:**
+- Code-Deployment verifizieren
+- Composer Dependencies verifizieren
+- Image-Deployment verifizieren
+- Health-Check durchführen
+
+**Production URL:**
+```bash
+curl -f https://michaelschiemer.de/health
+```
+
+### Schritt 4: Rollback-Test (Optional)
+
+**Falls Deployment fehlschlägt:**
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/rollback.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+---
+
+## Manueller Workflow-Test
+
+### Via Gitea UI
+
+**Schritte:**
+1. Gehe zu: `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+2. Wähle: "Manual Deployment"
+3. Klicke: "Run workflow"
+4. Wähle:
+   - Environment: `staging` oder `production`
+   - Image Tag: Optional (z.B. `latest` oder `git-abc1234`)
+   - Branch: Optional
+5. Klicke: "Run workflow"
+6. Beobachte Logs
+
+---
+
+## Checkliste für erfolgreichen Test
+
+### Staging Test
+- [ ] Test-Commit gepusht
+- [ ] Pipeline gestartet
+- [ ] Alle Jobs erfolgreich:
+  - [ ] changes
+  - [ ] test
+  - [ ] build
+  - [ ] deploy-staging
+- [ ] Code-Deployment erfolgreich
+- [ ] Composer Dependencies installiert
+- [ ] Image-Deployment erfolgreich
+- [ ] Health-Check erfolgreich
+- [ ] Application läuft korrekt
+
+### Production Test
+- [ ] Staging Test erfolgreich
+- [ ] Test-Commit auf main gepusht
+- [ ] Pipeline gestartet
+- [ ] Alle Jobs erfolgreich:
+  - [ ] changes
+  - [ ] test
+  - [ ] build
+  - [ ] deploy-production
+- [ ] Code-Deployment erfolgreich
+- [ ] Composer Dependencies installiert
+- [ ] Image-Deployment erfolgreich
+- [ ] Health-Check erfolgreich
+- [ ] Application läuft korrekt
+
+---
+
+## Bekannte Probleme & Workarounds
+
+### Problem: Pipeline startet nicht
+
+**Ursache:** Runner läuft nicht oder ist nicht registriert
+
+**Lösung:**
+```bash
+cd deployment/gitea-runner
+docker compose restart gitea-runner
+# Prüfe Runner-Status in Gitea UI
+```
+
+### Problem: Code-Deployment schlägt fehl
+
+**Ursache:** Git Repository existiert nicht auf Server
+
+**Lösung:**
+```bash
+# Initial Deployment durchführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### Problem: Image-Deployment schlägt fehl
+
+**Ursache:** Registry Login fehlgeschlagen
+
+**Lösung:**
+- Prüfe `REGISTRY_USER` und `REGISTRY_PASSWORD` Secrets
+- Teste Registry Login manuell
+
+### Problem: Health-Check schlägt fehl
+
+**Ursache:** Container starten nicht oder Application hat Fehler
+
+**Lösung:**
+- Prüfe Container Status
+- Prüfe Container Logs
+- Siehe [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)
+
+---
+
+## Referenz
+
+- [CI/CD Workflow Guide](./cicd-workflow-guide.md) - Workflow-Dokumentation
+- [CI/CD Status](../status/ci-cd-status.md) - Aktueller Status
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+- [Backup & Rollback Guide](./backup-and-rollback-guide.md) - Rollback-Prozess
+
diff --git a/deployment/docs/guides/production-database-connection.md b/deployment/docs/guides/production-database-connection.md
new file mode 100644
index 00000000..054ed8bf
--- /dev/null
+++ b/deployment/docs/guides/production-database-connection.md
@@ -0,0 +1,162 @@
+# Production Database Connection Guide
+
+## Übersicht
+
+Die Production-Application verbindet sich mit der separaten PostgreSQL-Production-Datenbank über das `postgres-production-internal` Network.
+
+## Network-Konfiguration
+
+### Production Application Stack
+
+Die Production-Application-Services (`php`, `queue-worker`, `scheduler`) müssen mit dem `postgres-production-internal` Network verbunden sein.
+
+**Konfiguration**:
+- **Datei**: `docker-compose.postgres-override.yml`
+- **Network**: `postgres-production-internal`
+- **Verbindung**: Services werden diesem Network hinzugefügt
+
+### Docker Compose Usage
+
+```bash
+# Production Stack mit Datenbank-Verbindung starten
+docker compose -f docker-compose.base.yml \
+               -f docker-compose.production.yml \
+               -f docker-compose.postgres-override.yml \
+               up -d
+```
+
+## Services
+
+Die folgenden Services werden mit dem `postgres-production-internal` Network verbunden:
+
+1. **php** - PHP-FPM Application Container
+2. **queue-worker** - Background Job Processor
+3. **scheduler** - Cron Job Executor
+
+## Environment Variables
+
+Die Application verwendet folgende Environment-Variablen für die Datenbank-Verbindung:
+
+```env
+DB_HOST=postgres-production
+DB_PORT=5432
+DB_DATABASE=michaelschiemer
+DB_USERNAME=postgres
+DB_PASSWORD_FILE=/run/secrets/db_user_password
+```
+
+**Wichtig**: `DB_PASSWORD` wird über Docker Secrets geladen (`DB_PASSWORD_FILE`).
+
+## Verifizierung
+
+### 1. Network-Verbindung prüfen
+
+```bash
+# Prüfe, ob php-Container im Network ist
+docker network inspect postgres-production-internal | grep php
+
+# Erwartet: Container-Name sollte erscheinen
+```
+
+### 2. Datenbank-Verbindung testen
+
+```bash
+# Von php-Container aus
+docker exec php php -r "
+\$dsn = 'pgsql:host=postgres-production;port=5432;dbname=michaelschiemer';
+\$pdo = new PDO(\$dsn, 'postgres', getenv('DB_PASSWORD'));
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+### 3. Network-Isolation verifizieren
+
+```bash
+# Prüfe, ob Production-App NICHT auf Staging-DB zugreifen kann
+docker exec php nc -zv postgres-staging 5432
+
+# Erwartet: Connection refused oder timeout (keine Verbindung möglich)
+```
+
+## Troubleshooting
+
+### Problem: Container kann Datenbank nicht erreichen
+
+**Lösung**:
+1. Prüfe, ob `postgres-production-internal` Network existiert:
+   ```bash
+   docker network ls | grep postgres-production-internal
+   ```
+
+2. Prüfe, ob Container im Network ist:
+   ```bash
+   docker network inspect postgres-production-internal
+   ```
+
+3. Prüfe, ob PostgreSQL-Production-Stack läuft:
+   ```bash
+   docker ps | grep postgres-production
+   ```
+
+### Problem: DB_HOST nicht korrekt
+
+**Lösung**:
+1. Prüfe Environment-Variablen:
+   ```bash
+   docker exec php printenv | grep DB_
+   ```
+
+2. Prüfe `.env`-Datei im Application-Stack:
+   ```bash
+   cat ~/deployment/stacks/production/.env | grep DB_
+   ```
+
+3. Prüfe Ansible-Template:
+   - `deployment/ansible/templates/application.env.j2`
+   - Sollte `DB_HOST=postgres-production` für Production setzen
+
+## Migration von alter Konfiguration
+
+Falls die Production-Application noch die alte `postgres` (geteilte Datenbank) verwendet:
+
+1. **Backup erstellen**:
+   ```bash
+   cd ~/deployment/stacks/postgresql
+   docker exec postgres-backup /scripts/backup.sh
+   ```
+
+2. **PostgreSQL-Production-Stack starten**:
+   ```bash
+   cd ~/deployment/stacks/postgresql-production
+   docker compose up -d
+   ```
+
+3. **Datenbank migrieren** (siehe `migrate-to-separate-databases.md`)
+
+4. **Application-Stack aktualisieren**:
+   - `.env`-Datei: `DB_HOST=postgres-production`
+   - Network: `postgres-production-internal` hinzufügen
+
+5. **Stack neu starten**:
+   ```bash
+   cd ~/deployment/stacks/production
+   docker compose -f docker-compose.base.yml \
+                  -f docker-compose.production.yml \
+                  -f docker-compose.postgres-override.yml \
+                  up -d
+   ```
+
+## Ansible-Integration
+
+Das Ansible-Setup konfiguriert die Datenbank-Verbindung automatisch:
+
+- **Template**: `deployment/ansible/templates/application.env.j2`
+- **Variable**: `db_host_default: "postgres-production"` (in `group_vars/production/vars.yml`)
+- **Network**: Wird über `docker-compose.postgres-override.yml` konfiguriert
+
+## Weitere Ressourcen
+
+- **PostgreSQL-Production-Stack**: `deployment/stacks/postgresql-production/README.md`
+- **Migrations-Guide**: `deployment/docs/guides/migrate-to-separate-databases.md`
+- **Staging-Datenbank**: `deployment/docs/guides/staging-test-plan.md`
+
diff --git a/deployment/docs/guides/quick-start.md b/deployment/docs/guides/quick-start.md
index 5e9f107c..9e65bb0a 100644
--- a/deployment/docs/guides/quick-start.md
+++ b/deployment/docs/guides/quick-start.md
@@ -2,7 +2,34 @@
 
 ## 🚀 Schnellstart: Code deployen
 
-### Einfachste Methode
+### Initial Deployment (Einmalig - erstes Setup)
+
+**Für erstes Setup des Servers:**
+
+```bash
+# 1. Code synchronisieren (Rsync)
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+
+# 2. Composer Dependencies installieren
+ansible-playbook -i inventory/production.yml \
+  playbooks/install-composer-dependencies.yml \
+  --vault-password-file secrets/.vault_pass
+
+# 3. Application Stack deployen
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --tags application \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Siehe auch:** [Initial Deployment Guide](./initial-deployment-guide.md)
+
+### Normal Deployment (CI/CD)
+
+**Für zukünftige Deployments:**
 
 ```bash
 # 1. Code ändern
@@ -65,7 +92,7 @@ https://git.michaelschiemer.de/michael/michaelschiemer/actions
 ssh deploy@94.16.110.151
 
 # Container-Status
-cd ~/deployment/stacks/application
+cd ~/deployment/stacks/production
 docker compose ps
 
 # Logs ansehen
@@ -90,7 +117,7 @@ curl https://michaelschiemer.de/health
 
 - **`docs/guides/setup-guide.md`** - Kompletter Setup-Guide
 - **`ansible/README.md`** - Ansible Playbooks Dokumentation
-- **`stacks/application/README.md`** - Application Stack Details
+- **`stacks/production/README.md`** - Application Stack Details
 
 ### Workflow-Dokumentation
 
@@ -155,7 +182,7 @@ docker build -f Dockerfile.production -t test .
 **Deployment fehlgeschlagen:**
 ```bash
 # Logs prüfen
-ssh deploy@94.16.110.151 "cd ~/deployment/stacks/application && docker compose logs"
+ssh deploy@94.16.110.151 "cd ~/deployment/stacks/production && docker compose logs"
 
 # Manueller Rollback
 cd deployment/ansible
diff --git a/deployment/docs/guides/security-hardening.md b/deployment/docs/guides/security-hardening.md
new file mode 100644
index 00000000..f6245776
--- /dev/null
+++ b/deployment/docs/guides/security-hardening.md
@@ -0,0 +1,143 @@
+# Security Hardening - Dokumentation
+
+## Aktuelle Security-Maßnahmen
+
+### 1. Firewall (nftables)
+- **Status**: ✅ Implementiert
+- **Konfiguration**: `deployment/ansible/templates/wireguard-host-firewall.nft.j2`
+- **Features**:
+  - Admin-Services nur über VPN erreichbar
+  - Public Services (HTTP, HTTPS, SSH) öffentlich erreichbar
+  - ICMP (Ping) erlaubt
+  - Established/Related Connections erlaubt
+
+### 2. WireGuard VPN
+- **Status**: ✅ Implementiert
+- **Zweck**: Admin-Services isoliert hinter VPN
+- **Ports**: 8080 (Traefik), 9090 (Prometheus), 3001 (Grafana), 9000 (Portainer), 8001 (Redis Insight)
+- **Konfiguration**: `deployment/ansible/playbooks/setup-wireguard-host.yml`
+
+### 3. Unattended-Upgrades
+- **Status**: ✅ Implementiert
+- **Konfiguration**: `deployment/ansible/roles/system/tasks/main.yml`
+- **Features**:
+  - Automatische Security-Updates
+  - Konfigurierbare Reboot-Zeiten
+  - APT Cache Management
+
+### 4. Security Headers (Traefik)
+- **Status**: ✅ Implementiert
+- **Konfiguration**: Traefik Dynamic Config
+- **Headers**: HSTS, X-Frame-Options, X-Content-Type-Options, etc.
+
+### 5. Docker Secrets
+- **Status**: ✅ Implementiert
+- **Verwendung**: Secrets werden über Docker Secrets verwaltet
+- **Zugriff**: Secrets werden für PHP (www-data) zugänglich gemacht
+
+## Geplante Verbesserungen
+
+### 1. SSH Hardening
+**Status**: ⚠️ Noch nicht implementiert
+
+**Geplante Maßnahmen**:
+- Key-only Authentication (keine Passwort-Authentifizierung)
+- Rate Limiting für SSH
+- Disable Root-Login
+- SSH-Keys Rotation Policy
+
+**Implementierung**:
+```yaml
+# deployment/ansible/roles/ssh/tasks/main.yml
+- name: Configure SSH hardening
+  lineinfile:
+    path: /etc/ssh/sshd_config
+    regexp: "{{ item.regexp }}"
+    line: "{{ item.line }}"
+  loop:
+    - { regexp: '^#?PasswordAuthentication', line: 'PasswordAuthentication no' }
+    - { regexp: '^#?PermitRootLogin', line: 'PermitRootLogin no' }
+    - { regexp: '^#?MaxAuthTries', line: 'MaxAuthTries 3' }
+```
+
+### 2. Container Security Scanning
+**Status**: ❌ Nicht implementiert
+
+**Geplante Tools**:
+- Trivy für Container-Scanning
+- Integration in CI/CD Pipeline
+- Automatische Scans vor Deployment
+
+### 3. Secrets Rotation Policy
+**Status**: ⚠️ Manuell
+
+**Geplante Maßnahmen**:
+- Automatische Secrets-Rotation
+- Secrets-Versioning
+- Secrets-Audit-Logging
+
+### 4. DDoS Protection
+**Status**: ⚠️ Teilweise (Traefik Rate Limiting)
+
+**Geplante Maßnahmen**:
+- Erweiterte Rate Limiting Rules
+- IP-based Rate Limiting
+- Geo-blocking für Admin-Endpoints
+
+### 5. Network Isolation Verification
+**Status**: ✅ Basis vorhanden
+
+**Aktuell**:
+- `traefik-public` und `app-internal` Networks
+- WireGuard für Admin Services
+
+**Zu prüfen**:
+- Database Network Isolation
+- Redis Network Isolation
+- Service-to-Service Communication Audit
+
+## Security Checklist
+
+### Vor Production-Deployment
+
+- [ ] Firewall Rules Audit durchgeführt
+- [ ] SSH Hardening konfiguriert
+- [ ] Container Security Scanning aktiviert
+- [ ] Secrets Rotation Policy definiert
+- [ ] DDoS Protection konfiguriert
+- [ ] Network Isolation verifiziert
+- [ ] Security Headers verifiziert
+- [ ] SSL/TLS Configuration geprüft
+
+### Regelmäßige Audits
+
+- [ ] Monatliche Security-Updates
+- [ ] Quartalsweise Firewall Rules Review
+- [ ] Jährliche Secrets Rotation
+- [ ] Kontinuierliche Container Scanning
+
+## Security Best Practices
+
+1. **Principle of Least Privilege**: Services haben nur die minimal notwendigen Berechtigungen
+2. **Defense in Depth**: Mehrere Security-Layer (Firewall, VPN, Application-Level)
+3. **Regular Updates**: Automatische Security-Updates aktiviert
+4. **Secrets Management**: Secrets werden sicher verwaltet (Docker Secrets, Ansible Vault)
+5. **Network Segmentation**: Admin-Services isoliert hinter VPN
+6. **Monitoring**: Security-Events werden geloggt und überwacht
+
+## Incident Response
+
+Bei Security-Incidents:
+
+1. **Isolation**: Betroffene Services isolieren
+2. **Investigation**: Logs analysieren
+3. **Remediation**: Sicherheitslücken schließen
+4. **Documentation**: Incident dokumentieren
+5. **Prevention**: Maßnahmen zur Verhinderung zukünftiger Incidents
+
+## Kontakt
+
+Bei Security-Fragen oder Incidents:
+- **Email**: kontakt@michaelschiemer.de
+- **Documentation**: `deployment/docs/guides/security-hardening.md`
+
diff --git a/deployment/docs/guides/server-rebuild-plan.md b/deployment/docs/guides/server-rebuild-plan.md
new file mode 100644
index 00000000..85dff6ad
--- /dev/null
+++ b/deployment/docs/guides/server-rebuild-plan.md
@@ -0,0 +1,428 @@
+# Server-Neuaufbau Plan - Debian 13 (Trixie)
+
+## Übersicht
+
+Dieser Plan beschreibt den kompletten Neuaufbau des Production-Servers mit Debian 13 (Trixie) LTS, inklusive aller Infrastructure-Stacks.
+
+## Architektur-Entscheidungen
+
+### Betriebssystem
+- **Debian 13 (Trixie) LTS**
+- **UEFI-Version** (empfohlen für moderne Server-Hardware)
+- Minimale Installation (ohne Desktop)
+- SSH-Zugriff konfiguriert
+- Firewall (nftables/ufw)
+
+### UEFI vs. BIOS
+- **UEFI empfohlen**: Moderner Standard, GPT-Partitionierung, Secure Boot (optional), schnellerer Boot
+- **BIOS nur wenn**: Hardware unterstützt kein UEFI oder Legacy-Systeme vorhanden
+
+### Setup-Strategie
+- **Ansible-basiert**: Alle Schritte automatisierbar
+- **Schrittweise**: Basis-Setup → Docker → Infrastructure
+- **Verifikation**: Jeder Schritt wird geprüft
+
+## Implementierungs-Phasen
+
+### Phase 1: Server-Initialisierung (Netcup Control Panel)
+
+#### 1.1 Server zurücksetzen
+
+**Schritte:**
+1. Netcup Control Panel öffnen
+2. Server zurücksetzen/neu installieren
+3. **Debian 13 (Trixie)** auswählen
+4. **UEFI-Version** wählen (empfohlen)
+5. Root-Passwort notieren (sicher speichern!)
+6. SSH-Key-Option prüfen (falls verfügbar)
+
+**Wichtig:**
+- Alle Daten werden gelöscht - vorher Backups erstellen!
+- Neue Server-IP notieren (falls sich ändert)
+- DNS-Records müssen ggf. aktualisiert werden
+
+#### 1.2 Initialer SSH-Zugriff
+
+**Option A: Mit vorkonfiguriertem deploy-User (empfohlen)**
+
+Wenn du beim Server-Setup im Netcup Control Panel:
+- Benutzer `deploy` erstellt hast
+- SSH-Key (`production.pub`) hinzugefügt hast
+
+Dann kannst du direkt verbinden:
+
+```bash
+# Mit deploy-User verbinden (SSH-Key wird automatisch verwendet)
+ssh deploy@<server-ip>
+# Oder mit SSH-Config:
+ssh production
+```
+
+**Option B: Mit Root-Zugriff (falls kein deploy-User erstellt wurde)**
+
+```bash
+# Mit Root-Zugriff verbinden
+ssh root@<server-ip>
+# Passwort: <root-password-vom-netcup-panel>
+
+# System aktualisieren
+apt update && apt upgrade -y
+
+# Basis-Pakete installieren
+apt install -y curl wget git vim sudo
+```
+
+**Verifikation:**
+- SSH-Verbindung funktioniert
+- System ist aktuell
+- Basis-Tools verfügbar
+
+### Phase 2: Basis-Setup (Ansible)
+
+#### 2.1 Deploy-User erstellen
+
+**Option A: Vorkonfiguriert (empfohlen, wenn beim Server-Setup erstellt)**
+
+Wenn du beim Server-Setup im Netcup Control Panel:
+- Benutzer `deploy` erstellt hast
+- SSH-Key (`production.pub`) hinzugefügt hast
+
+Dann kannst du **Phase 2.1 überspringen** und direkt zu **Phase 2.2** gehen!
+
+**Verifikation:**
+```bash
+# Auf Control-Node
+ssh production 'whoami'
+# Sollte ausgeben: deploy
+```
+
+**Option B: Manuell erstellen (falls nicht beim Setup erstellt)**
+
+**Manuell (auf Server):**
+```bash
+# User anlegen
+adduser deploy
+usermod -aG sudo deploy
+
+# SSH-Verzeichnis erstellen
+mkdir -p /home/deploy/.ssh
+chmod 700 /home/deploy/.ssh
+```
+
+**SSH-Key hinzufügen (von Control-Node):**
+```bash
+# Auf Control-Node
+ssh-copy-id -i ~/.ssh/production.pub deploy@<server-ip>
+
+# Oder manuell:
+cat ~/.ssh/production.pub | ssh deploy@<server-ip> "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && chmod 700 ~/.ssh"
+```
+
+**SSH-Config auf Control-Node anpassen:**
+```bash
+# ~/.ssh/config
+Host production
+    HostName <server-ip>
+    User deploy
+    IdentityFile ~/.ssh/production
+    ServerAliveInterval 60
+    ServerAliveCountMax 3
+```
+
+#### 2.2 Initial Server Setup (Ansible Playbook)
+
+**Auf Control-Node:**
+
+**Mit vorkonfiguriertem deploy-User (empfohlen):**
+```bash
+cd deployment/ansible
+
+# Initiales Server-Setup ausführen
+# Keine zusätzlichen Parameter nötig - deploy-User und SSH-Key sind bereits konfiguriert
+ansible-playbook -i inventory/production.yml \
+  playbooks/initial-server-setup.yml
+```
+
+**Mit root-User (falls deploy-User nicht erstellt wurde):**
+```bash
+cd deployment/ansible
+
+# Initiales Server-Setup ausführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/initial-server-setup.yml \
+  --ask-pass \
+  -e "ansible_user=root"
+```
+
+**Was das Playbook macht:**
+- System-Updates (apt update/upgrade)
+- Basis-Pakete installieren (curl, wget, git, vim, sudo, ufw, fail2ban)
+- Deploy-User konfigurieren (falls nicht vorhanden)
+- SSH-Konfiguration (optional: key-only auth)
+- Firewall-Setup (optional, standardmäßig deaktiviert)
+- Fail2ban konfigurieren
+
+**Verifikation:**
+```bash
+# Auf Server
+whoami  # Sollte ausgeben: deploy
+sudo -v  # Sudo-Rechte testen
+```
+
+#### 2.3 Firewall konfigurieren
+
+**Option 1: ufw (einfacher)**
+```bash
+# Auf Server
+sudo ufw allow 22/tcp    # SSH
+sudo ufw allow 80/tcp    # HTTP
+sudo ufw allow 443/tcp   # HTTPS
+sudo ufw allow 51820/udp # WireGuard
+sudo ufw enable
+sudo ufw status
+```
+
+**Option 2: nftables (erweitert)**
+- Wird später über WireGuard-Playbook konfiguriert
+- Admin-Ports nur über VPN
+
+#### 2.3 System-Härtung
+
+**SSH-Key-only Authentication:**
+```bash
+# Auf Server
+sudo nano /etc/ssh/sshd_config
+
+# Ändern:
+PasswordAuthentication no
+PubkeyAuthentication yes
+
+# Neu starten
+sudo systemctl restart sshd
+```
+
+**Unattended-Upgrades (via Ansible):**
+- Wird automatisch über `system`-Role konfiguriert
+
+**Optional: Fail2ban**
+```bash
+sudo apt install fail2ban
+sudo systemctl enable fail2ban
+sudo systemctl start fail2ban
+```
+
+### Phase 3: Docker-Installation
+
+#### 3.1 Docker-Repository anpassen
+
+**Aktuell:** `install-docker.yml` nutzt Ubuntu-Repository (funktioniert auf Debian)
+
+**Optional:** Debian-spezifisches Repository nutzen (siehe `install-docker.yml`)
+
+#### 3.2 Docker installieren (via Ansible)
+
+```bash
+# Auf Control-Node
+cd ~/dev/michaelschiemer/deployment/ansible
+ansible-playbook -i inventory/production.yml playbooks/install-docker.yml
+```
+
+**Verifikation:**
+```bash
+# Auf Server
+docker --version
+docker compose version
+docker run hello-world
+```
+
+### Phase 4: Ansible-Setup
+
+#### 4.1 Ansible auf Control-Node
+
+**Installation (falls nicht vorhanden):**
+```bash
+# Debian/Ubuntu
+sudo apt install ansible
+
+# Oder via pip
+pip install ansible
+```
+
+**Inventory prüfen:**
+```bash
+# deployment/ansible/inventory/production.yml
+# Server-IP und SSH-Config aktualisieren
+```
+
+**SSH-Key-Test:**
+```bash
+ansible production -m ping
+# Sollte ausgeben: pong
+```
+
+#### 4.2 Ansible-Playbooks anpassen
+
+**Geänderte Dateien:**
+- `install-docker.yml`: Debian-Repository prüfen/anpassen (optional)
+- `setup-infrastructure.yml`: Verifizieren
+- Vault-Secrets prüfen
+
+### Phase 5: Infrastructure-Deployment
+
+#### 5.1 Docker installieren (via Ansible)
+
+```bash
+cd ~/dev/michaelschiemer/deployment/ansible
+ansible-playbook -i inventory/production.yml playbooks/install-docker.yml
+```
+
+#### 5.2 Komplettes Infrastructure-Setup
+
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --ask-vault-pass
+```
+
+**Deployed Stacks:**
+- Traefik (Reverse Proxy & SSL)
+- PostgreSQL-Production (Database)
+- Redis (Cache & Session)
+- Docker Registry (Private Registry)
+- MinIO (Object Storage)
+- Gitea (Git Server)
+- Monitoring (Portainer, Grafana, Prometheus)
+- Production Application Stack
+
+**Erwartete Dauer:** 10-20 Minuten
+
+#### 5.3 Staging-Setup (optional, nach Production)
+
+```bash
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-staging.yml \
+  --ask-vault-pass
+```
+
+### Phase 6: Verifikation
+
+#### 6.1 Services prüfen
+
+**Auf Server:**
+```bash
+# Alle Container laufen
+docker ps
+
+# Networks vorhanden
+docker network ls
+
+# Health-Checks
+curl https://michaelschiemer.de/health
+curl https://git.michaelschiemer.de
+```
+
+#### 6.2 Ansible-Verifikation
+
+```bash
+# Auf Control-Node
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-production.yml
+
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-staging.yml
+```
+
+## Checkliste
+
+### Vorbereitung
+- [ ] Netcup Control Panel Zugriff
+- [ ] Neuer SSH-Key generiert
+- [ ] Ansible auf Control-Node installiert
+- [ ] Vault-Secrets vorbereitet
+- [ ] DNS-Zugriff (für Domain-Updates)
+- [ ] Backups erstellt (falls vorhanden)
+
+### Phase 1: Server-Initialisierung
+- [ ] Server zurückgesetzt
+- [ ] Debian 13 (Trixie) installiert
+- [ ] UEFI-Version gewählt
+- [ ] Root-Passwort notiert
+- [ ] Initialer SSH-Zugriff funktioniert
+- [ ] System aktualisiert
+
+### Phase 2: Basis-Setup
+- [ ] Deploy-User erstellt
+- [ ] SSH-Key hinzugefügt
+- [ ] SSH-Config angepasst
+- [ ] Firewall konfiguriert
+- [ ] System gehärtet
+
+### Phase 3: Docker-Installation
+- [ ] Docker installiert
+- [ ] Docker Compose installiert
+- [ ] Deploy-User in docker-Gruppe
+- [ ] Docker-Test erfolgreich
+
+### Phase 4: Ansible-Setup
+- [ ] Ansible installiert
+- [ ] Inventory aktualisiert
+- [ ] SSH-Key-Test erfolgreich
+- [ ] Playbooks geprüft
+
+### Phase 5: Infrastructure-Deployment
+- [ ] Docker installiert (via Ansible)
+- [ ] Infrastructure-Setup erfolgreich
+- [ ] Alle Stacks deployed
+- [ ] Staging-Setup (optional)
+
+### Phase 6: Verifikation
+- [ ] Services laufen
+- [ ] Networks vorhanden
+- [ ] Health-Checks erfolgreich
+- [ ] Ansible-Verifikation erfolgreich
+
+## Wichtige Hinweise
+
+1. **SSH-Key-Sicherheit**: Neuen SSH-Key generieren und sicher speichern
+2. **Vault-Secrets**: Alle Secrets in Ansible Vault verschlüsselt
+3. **Backup-Strategie**: Vor Neuaufbau alle Daten sichern (falls vorhanden)
+4. **DNS-Konfiguration**: Domains müssen auf neue Server-IP zeigen
+5. **Rollback-Plan**: Alte Server-Konfiguration dokumentieren
+
+## Troubleshooting
+
+### SSH-Verbindung fehlgeschlagen
+- Firewall-Regeln prüfen
+- SSH-Key-Berechtigungen prüfen (600)
+- SSH-Config prüfen
+
+### Docker-Installation fehlgeschlagen
+- Repository-URL prüfen
+- GPG-Key prüfen
+- Netzwerk-Verbindung prüfen
+
+### Ansible-Playbook fehlgeschlagen
+- Inventory-Datei prüfen
+- SSH-Zugriff testen: `ansible production -m ping`
+- Vault-Passwort prüfen
+
+### Infrastructure-Deployment fehlgeschlagen
+- Docker läuft?
+- Networks vorhanden?
+- Secrets korrekt?
+- Logs prüfen: `docker logs <container>`
+
+## Nächste Schritte nach Neuaufbau
+
+1. Monitoring einrichten
+2. Backup-Strategie verifizieren
+3. Staging-Environment testen
+4. CI/CD-Pipeline testen
+5. Dokumentation aktualisieren
+
+## Referenzen
+
+- `deployment/docs/guides/ssh-access.md` - SSH-Zugriff Dokumentation
+- `deployment/ansible/playbooks/initial-server-setup.yml` - Basis-Setup Playbook
+- `deployment/ansible/playbooks/install-docker.yml` - Docker-Installation
+- `deployment/ansible/playbooks/setup-infrastructure.yml` - Infrastructure-Setup
diff --git a/deployment/docs/guides/ssh-access.md b/deployment/docs/guides/ssh-access.md
new file mode 100644
index 00000000..7af12413
--- /dev/null
+++ b/deployment/docs/guides/ssh-access.md
@@ -0,0 +1,218 @@
+# SSH-Zugriff Dokumentation
+
+## Übersicht
+
+Diese Dokumentation beschreibt die SSH-Zugriffskonfiguration für den Production-Server.
+
+## SSH-Key-Generierung
+
+### Neuen SSH-Key generieren
+
+```bash
+# Auf Control-Node (lokal)
+ssh-keygen -t ed25519 -C "production-server" -f ~/.ssh/production
+
+# Oder RSA (falls ed25519 nicht unterstützt)
+ssh-keygen -t rsa -b 4096 -C "production-server" -f ~/.ssh/production
+```
+
+**Wichtig:**
+- Passphrase setzen (empfohlen)
+- Key sicher speichern
+- Private Key niemals teilen
+
+### Key-Berechtigungen
+
+```bash
+chmod 600 ~/.ssh/production
+chmod 644 ~/.ssh/production.pub
+```
+
+## SSH-Config
+
+### Control-Node Konfiguration
+
+**Datei:** `~/.ssh/config`
+
+```ssh-config
+Host production
+    HostName <server-ip>
+    User deploy
+    IdentityFile ~/.ssh/production
+    ServerAliveInterval 60
+    ServerAliveCountMax 3
+    StrictHostKeyChecking yes
+    UserKnownHostsFile ~/.ssh/known_hosts
+```
+
+**Wichtig:**
+- `<server-ip>` durch tatsächliche IP ersetzen
+- `deploy` ist der Standard-User (nach Setup)
+
+### SSH-Config testen
+
+```bash
+# Verbindung testen
+ssh production 'whoami'
+# Sollte ausgeben: deploy
+
+# Ohne Passwort (Key-only)
+ssh production
+```
+
+## Server-Setup
+
+### Deploy-User erstellen
+
+**Auf Server (als root):**
+```bash
+# User anlegen
+adduser deploy
+usermod -aG sudo deploy
+
+# SSH-Verzeichnis erstellen
+mkdir -p /home/deploy/.ssh
+chmod 700 /home/deploy/.ssh
+```
+
+### Public Key hinzufügen
+
+**Option 1: ssh-copy-id (empfohlen)**
+```bash
+# Auf Control-Node
+ssh-copy-id -i ~/.ssh/production.pub deploy@<server-ip>
+```
+
+**Option 2: Manuell**
+```bash
+# Auf Control-Node
+cat ~/.ssh/production.pub | ssh deploy@<server-ip> \
+  "mkdir -p ~/.ssh && \
+   cat >> ~/.ssh/authorized_keys && \
+   chmod 600 ~/.ssh/authorized_keys && \
+   chmod 700 ~/.ssh"
+```
+
+**Option 3: Via Ansible (nach initialem Setup)**
+```bash
+# Wird automatisch über initial-server-setup.yml verwaltet
+```
+
+### SSH-Key-only Authentication
+
+**Auf Server:**
+```bash
+sudo nano /etc/ssh/sshd_config
+```
+
+**Ändern:**
+```config
+PasswordAuthentication no
+PubkeyAuthentication yes
+AuthorizedKeysFile .ssh/authorized_keys
+```
+
+**Neu starten:**
+```bash
+sudo systemctl restart sshd
+```
+
+**Wichtig:** Vorher sicherstellen, dass SSH-Key funktioniert!
+
+## Ansible-Integration
+
+### Inventory-Konfiguration
+
+**Datei:** `deployment/ansible/inventory/production.yml`
+
+```yaml
+all:
+  children:
+    production:
+      hosts:
+        server:
+          ansible_host: <server-ip>
+          ansible_user: deploy
+          ansible_python_interpreter: /usr/bin/python3
+          ansible_ssh_private_key_file: ~/.ssh/production
+```
+
+### Ansible-Verbindung testen
+
+```bash
+cd ~/dev/michaelschiemer/deployment/ansible
+ansible production -m ping
+# Sollte ausgeben: pong
+```
+
+## Sicherheit
+
+### Best Practices
+
+1. **SSH-Key mit Passphrase**
+   - Private Key verschlüsselt
+   - Passphrase bei jeder Nutzung
+
+2. **Key-Rotation**
+   - Regelmäßig neue Keys generieren
+   - Alte Keys entfernen
+
+3. **Fail2ban**
+   - Automatische Sperrung bei Brute-Force
+   - Optional, aber empfohlen
+
+4. **SSH-Port ändern (optional)**
+   - Standard-Port 22 ändern
+   - Reduziert automatische Angriffe
+
+5. **Root-Login deaktivieren**
+   - Nur über deploy-User
+   - Sudo für Admin-Tasks
+
+### Fail2ban Installation
+
+```bash
+# Auf Server
+sudo apt install fail2ban
+sudo systemctl enable fail2ban
+sudo systemctl start fail2ban
+
+# Status prüfen
+sudo fail2ban-client status sshd
+```
+
+## Troubleshooting
+
+### SSH-Verbindung fehlgeschlagen
+
+**Problem:** `Permission denied (publickey)`
+
+**Lösung:**
+1. Key-Berechtigungen prüfen: `chmod 600 ~/.ssh/production`
+2. Public Key auf Server prüfen: `cat ~/.ssh/authorized_keys`
+3. SSH-Config prüfen: `ssh -v production`
+4. Server-Logs prüfen: `sudo tail -f /var/log/auth.log`
+
+### Key-Format-Problem
+
+**Problem:** `error in libcrypto`
+
+**Lösung:**
+1. Neuen Key generieren (ed25519 oder RSA)
+2. WSL/libcrypto-Kompatibilität prüfen
+3. Key-Format prüfen: `file ~/.ssh/production`
+
+### Ansible-Verbindung fehlgeschlagen
+
+**Problem:** `ansible production -m ping` schlägt fehl
+
+**Lösung:**
+1. SSH-Verbindung manuell testen: `ssh production`
+2. Inventory-Datei prüfen
+3. Python-Interpreter prüfen: `ansible production -m raw -a "which python3"`
+
+## Referenzen
+
+- `deployment/docs/guides/server-rebuild-plan.md` - Server-Neuaufbau Plan
+- `deployment/ansible/inventory/production.yml` - Ansible Inventory
+- `deployment/ansible/playbooks/initial-server-setup.yml` - Basis-Setup Playbook
diff --git a/deployment/docs/guides/staging-test-plan.md b/deployment/docs/guides/staging-test-plan.md
new file mode 100644
index 00000000..8da3092e
--- /dev/null
+++ b/deployment/docs/guides/staging-test-plan.md
@@ -0,0 +1,315 @@
+# Staging-Setup Test Plan
+
+## Übersicht
+
+Dieser Testplan beschreibt die Schritte zum Testen des neuen Staging-Setups mit separaten Datenbank-Stacks.
+
+## Voraussetzungen
+
+- Ansible installiert und konfiguriert
+- SSH-Zugriff auf Production-Server
+- Docker und Docker Compose auf Production-Server installiert
+- Gitea Actions Runner läuft
+
+## Quick-Start (Empfohlen)
+
+Für schnelle Tests nutze das Quick-Start-Script:
+
+```bash
+# Auf Production-Server
+cd ~/deployment
+./scripts/staging-quick-start.sh
+```
+
+Das Script bietet ein interaktives Menü für alle häufigen Aufgaben.
+
+## Test-Phasen
+
+### Phase 1: PostgreSQL-Stacks testen
+
+#### 1.1 PostgreSQL-Production Stack
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-production
+
+# .env-Datei erstellen (falls nicht vorhanden)
+cat > .env <<EOF
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<production-password>
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
+EOF
+
+# Stack starten
+docker compose up -d
+
+# Verifizieren
+docker compose ps
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+
+# Erwartete Ausgabe: postgres-production:5432 - accepting connections
+```
+
+#### 1.2 PostgreSQL-Staging Stack
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-staging
+
+# .env-Datei erstellen
+cat > .env <<EOF
+POSTGRES_DB=michaelschiemer_staging
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<staging-password>
+BACKUP_RETENTION_DAYS=3
+BACKUP_SCHEDULE=0 3 * * *
+EOF
+
+# Stack starten
+docker compose up -d
+
+# Verifizieren
+docker compose ps
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+
+# Erwartete Ausgabe: postgres-staging:5432 - accepting connections
+```
+
+### Phase 2: Networks verifizieren
+
+```bash
+# Prüfe, ob alle Networks existieren
+docker network ls | grep -E "(traefik-public|staging-internal|postgres-staging-internal|postgres-production-internal|app-internal)"
+
+# Erwartete Networks:
+# - traefik-public
+# - staging-internal
+# - postgres-staging-internal
+# - postgres-production-internal
+# - app-internal
+```
+
+### Phase 3: Ansible-Setup testen
+
+#### 3.1 Staging-Setup Playbook
+
+```bash
+# Lokal (auf Dev-Machine)
+cd deployment/ansible
+
+# Staging-Setup ausführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-staging.yml \
+  --ask-vault-pass
+
+# Erwartetes Ergebnis:
+# - PostgreSQL-Staging Stack deployed
+# - Staging Application Stack deployed
+# - Alle Container laufen
+```
+
+#### 3.2 Verifizierung nach Ansible-Deployment
+
+```bash
+# Auf Production-Server
+# Prüfe Container-Status
+docker ps | grep -E "(staging|postgres-staging)"
+
+# Prüfe Networks
+docker network inspect postgres-staging-internal | grep -E "(staging-app|postgres-staging)"
+
+# Prüfe Datenbank-Verbindung von Staging-App
+docker exec staging-app php -r "
+\$dsn = 'pgsql:host=postgres-staging;port=5432;dbname=michaelschiemer_staging';
+\$pdo = new PDO(\$dsn, 'postgres', getenv('DB_PASSWORD'));
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+### Phase 4: CI/CD-Workflow testen
+
+#### 4.1 Test-Commit auf Staging-Branch
+
+```bash
+# Lokal
+git checkout staging
+git pull origin staging
+
+# Kleine Änderung (z.B. Kommentar)
+echo "# Test deployment" >> README.md
+git add README.md
+git commit -m "test: Test staging deployment with separate database"
+git push origin staging
+```
+
+#### 4.2 Workflow-Verifizierung
+
+1. **Gitea Actions prüfen**:
+   - Gehe zu: `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+   - Prüfe, ob Workflow gestartet wurde
+   - Prüfe alle Jobs (Tests, Build, Deploy)
+
+2. **Deployment-Verifizierung**:
+   ```bash
+   # Auf Production-Server
+   # Prüfe, ob neues Image gepullt wurde
+   docker images | grep framework | head -5
+   
+   # Prüfe Staging-Container
+   cd ~/deployment/stacks/staging
+   docker compose -f docker-compose.base.yml -f docker-compose.staging.yml ps
+   
+   # Prüfe Logs
+   docker compose logs staging-app --tail=50
+   ```
+
+3. **Health-Checks**:
+   ```bash
+   # Basic Health Check
+   curl -k https://staging.michaelschiemer.de/health
+   
+   # Extended Health Check
+   curl -k https://staging.michaelschiemer.de/admin/health/api/summary
+   ```
+
+### Phase 5: Datenbank-Isolation verifizieren
+
+#### 5.1 Separate Datenbanken testen
+
+```bash
+# Production-Datenbank
+docker exec postgres-production psql -U postgres -d michaelschiemer -c "\dt"
+
+# Staging-Datenbank
+docker exec postgres-staging psql -U postgres -d michaelschiemer_staging -c "\dt"
+
+# Erwartet: Beide Datenbanken existieren unabhängig voneinander
+```
+
+#### 5.2 Network-Isolation testen
+
+```bash
+# Prüfe, ob Staging-App auf Production-DB zugreifen kann (sollte NICHT möglich sein)
+docker exec staging-app nc -zv postgres-production 5432
+
+# Erwartet: Connection refused oder timeout (keine Verbindung möglich)
+
+# Prüfe, ob Staging-App auf Staging-DB zugreifen kann (sollte möglich sein)
+docker exec staging-app nc -zv postgres-staging 5432
+
+# Erwartet: Connection successful
+```
+
+### Phase 6: Application-Funktionalität testen
+
+#### 6.1 Web-Interface testen
+
+1. **Staging-URL öffnen**: `https://staging.michaelschiemer.de`
+2. **Erwartet**: Seite lädt korrekt
+3. **Health-Dashboard prüfen**: `https://staging.michaelschiemer.de/admin/system/health`
+4. **Erwartet**: Health-Checks zeigen alle Services als gesund
+
+#### 6.2 Datenbank-Operationen testen
+
+```bash
+# Von Staging-App aus
+docker exec staging-app php console.php db:status
+
+# Erwartet: Migrations-Status wird angezeigt
+
+# Test-Migration (falls nötig)
+docker exec staging-app php console.php db:migrate
+```
+
+### Phase 7: Backup & Restore testen
+
+#### 7.1 Staging-Backup testen
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-staging
+
+# Manuelles Backup auslösen
+docker exec postgres-staging-backup /scripts/backup.sh
+
+# Backup verifizieren
+ls -lh backups/
+
+# Erwartet: Backup-Datei erstellt (z.B. postgres_michaelschiemer_staging_*.sql.gz)
+```
+
+#### 7.2 Production-Backup testen
+
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-production
+
+# Manuelles Backup auslösen
+docker exec postgres-production-backup /scripts/backup.sh
+
+# Backup verifizieren
+ls -lh backups/
+```
+
+## Fehlerbehebung
+
+### Problem: Container startet nicht
+
+```bash
+# Prüfe Logs
+docker compose logs <container-name>
+
+# Prüfe Networks
+docker network inspect <network-name>
+
+# Prüfe Volumes
+docker volume ls | grep <volume-name>
+```
+
+### Problem: Datenbank-Verbindung fehlgeschlagen
+
+```bash
+# Prüfe, ob Datenbank läuft
+docker compose ps postgres-staging
+
+# Prüfe Network-Verbindung
+docker network inspect postgres-staging-internal | grep -A 5 staging-app
+
+# Prüfe Environment-Variablen
+docker exec staging-app printenv | grep DB_
+```
+
+### Problem: Health-Check fehlgeschlagen
+
+```bash
+# Prüfe Application-Logs
+docker compose logs staging-app --tail=100
+
+# Prüfe Nginx-Logs
+docker compose logs staging-nginx --tail=100
+
+# Prüfe Health-Endpoint direkt
+docker exec staging-app curl -f http://localhost/health
+```
+
+## Erfolgskriterien
+
+- ✅ PostgreSQL-Production Stack läuft
+- ✅ PostgreSQL-Staging Stack läuft
+- ✅ Staging-Application Stack läuft
+- ✅ Datenbank-Verbindung funktioniert
+- ✅ Network-Isolation funktioniert (Staging kann nicht auf Production-DB zugreifen)
+- ✅ CI/CD-Workflow deployed erfolgreich
+- ✅ Health-Checks erfolgreich
+- ✅ Web-Interface funktioniert
+- ✅ Backups funktionieren
+
+## Nächste Schritte nach erfolgreichem Test
+
+1. Production-Migration planen (falls nötig)
+2. Monitoring für beide Datenbanken einrichten
+3. Backup-Strategie verifizieren
+4. Dokumentation finalisieren
+
diff --git a/deployment/docs/guides/test-execution-plan.md b/deployment/docs/guides/test-execution-plan.md
new file mode 100644
index 00000000..bc666166
--- /dev/null
+++ b/deployment/docs/guides/test-execution-plan.md
@@ -0,0 +1,299 @@
+# Test Execution Plan - Staging Setup
+
+## Übersicht
+
+Dieser Plan beschreibt die schrittweise Ausführung der Tests für das neue Staging-Setup mit separaten Datenbank-Stacks.
+
+## Voraussetzungen prüfen
+
+### 1. Lokale Verifikation (WSL/Local)
+
+```bash
+# Syntax-Checks
+cd /home/michael/dev/michaelschiemer
+
+# Ansible-Playbook-Syntax (falls Ansible installiert)
+ansible-playbook --syntax-check deployment/ansible/playbooks/verify-staging.yml
+
+# Docker Compose-Syntax
+docker compose -f deployment/stacks/postgresql-production/docker-compose.yml config > /dev/null
+docker compose -f deployment/stacks/postgresql-staging/docker-compose.yml config > /dev/null
+docker compose -f deployment/stacks/staging/docker-compose.base.yml -f deployment/stacks/staging/docker-compose.staging.yml config > /dev/null
+```
+
+### 2. Server-Verfügbarkeit
+
+- SSH-Zugriff auf Production-Server
+- Docker und Docker Compose installiert
+- Ansible auf Control-Node installiert (optional)
+
+## Test-Phasen
+
+### Phase 1: Lokale Syntax-Verifikation
+
+**Ziel**: Sicherstellen, dass alle Konfigurationsdateien syntaktisch korrekt sind.
+
+**Schritte**:
+1. ✅ Ansible-Playbook-Syntax prüfen
+2. ✅ Docker Compose-Syntax prüfen
+3. ✅ YAML-Validierung
+4. ✅ Template-Syntax prüfen
+
+**Erwartetes Ergebnis**: Alle Syntax-Checks erfolgreich
+
+### Phase 2: PostgreSQL-Stacks testen (auf Server)
+
+**Ziel**: Separate PostgreSQL-Stacks funktionieren korrekt.
+
+#### 2.1 PostgreSQL-Production Stack
+
+**Schritte**:
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-production
+
+# .env-Datei prüfen/erstellen
+cat .env  # Sollte POSTGRES_PASSWORD enthalten
+
+# Stack starten
+docker compose up -d
+
+# Status prüfen
+docker compose ps
+
+# Health-Check
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+```
+
+**Erwartetes Ergebnis**: 
+- Container läuft
+- PostgreSQL akzeptiert Verbindungen
+- Datenbank `michaelschiemer` existiert
+
+#### 2.2 PostgreSQL-Staging Stack
+
+**Schritte**:
+```bash
+# Auf Production-Server
+cd ~/deployment/stacks/postgresql-staging
+
+# .env-Datei prüfen/erstellen
+cat .env  # Sollte POSTGRES_PASSWORD enthalten
+
+# Stack starten
+docker compose up -d
+
+# Status prüfen
+docker compose ps
+
+# Health-Check
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+```
+
+**Erwartetes Ergebnis**: 
+- Container läuft
+- PostgreSQL akzeptiert Verbindungen
+- Datenbank `michaelschiemer_staging` existiert
+
+### Phase 3: Networks verifizieren
+
+**Ziel**: Alle benötigten Docker-Networks existieren.
+
+**Schritte**:
+```bash
+# Auf Production-Server
+docker network ls | grep -E "(traefik-public|staging-internal|postgres-production-internal|postgres-staging-internal|app-internal)"
+```
+
+**Erwartetes Ergebnis**: Alle Networks existieren
+
+**Falls fehlend**: Networks werden beim Stack-Start automatisch erstellt
+
+### Phase 4: Ansible-Setup testen
+
+**Ziel**: Ansible-Playbooks funktionieren korrekt.
+
+#### 4.1 Staging-Setup ausführen
+
+**Schritte**:
+```bash
+# Auf Control-Node (lokal in WSL)
+cd ~/dev/michaelschiemer/deployment/ansible
+
+# Dry-Run (Check-Mode)
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-staging.yml \
+  --check \
+  --ask-vault-pass
+
+# Echt ausführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-staging.yml \
+  --ask-vault-pass
+```
+
+**Erwartetes Ergebnis**:
+- Playbook läuft durch ohne Fehler
+- PostgreSQL-Staging Stack deployed
+- Staging Application Stack deployed
+- Alle Services laufen
+
+#### 4.2 Verifikations-Playbook ausführen
+
+**Schritte**:
+```bash
+# Auf Control-Node
+cd ~/dev/michaelschiemer/deployment/ansible
+
+ansible-playbook -i inventory/production.yml \
+  playbooks/verify-staging.yml
+```
+
+**Erwartetes Ergebnis**:
+- Alle Verifikationen erfolgreich
+- PostgreSQL-Staging: RUNNING
+- staging-app: RUNNING
+- Health-Checks: SUCCESS
+
+### Phase 5: Datenbank-Verbindungen testen
+
+**Ziel**: Application-Container können auf ihre jeweiligen Datenbanken zugreifen.
+
+#### 5.1 Staging-Datenbank-Verbindung
+
+**Schritte**:
+```bash
+# Auf Production-Server
+docker exec staging-app php -r "
+\$dsn = 'pgsql:host=postgres-staging;port=5432;dbname=michaelschiemer_staging';
+\$pdo = new PDO(\$dsn, 'postgres', trim(file_get_contents('/var/www/html/storage/secrets/db_user_password')));
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+**Erwartetes Ergebnis**: Connection successful mit PostgreSQL-Version
+
+#### 5.2 Production-Datenbank-Verbindung
+
+**Schritte**:
+```bash
+# Auf Production-Server
+docker exec php php -r "
+\$dsn = 'pgsql:host=postgres-production;port=5432;dbname=michaelschiemer';
+\$pdo = new PDO(\$dsn, 'postgres', trim(file_get_contents('/var/www/html/storage/secrets/db_user_password')));
+echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn();
+"
+```
+
+**Erwartetes Ergebnis**: Connection successful mit PostgreSQL-Version
+
+### Phase 6: Health-Checks
+
+**Ziel**: Application-Endpoints sind erreichbar und funktionieren.
+
+#### 6.1 Basic Health Check
+
+**Schritte**:
+```bash
+# Staging
+curl -f -k https://staging.michaelschiemer.de/health
+
+# Production
+curl -f -k https://michaelschiemer.de/health
+```
+
+**Erwartetes Ergebnis**: HTTP 200 OK
+
+#### 6.2 Extended Health Check
+
+**Schritte**:
+```bash
+# Staging
+curl -f -k https://staging.michaelschiemer.de/admin/health/api/summary | jq .
+
+# Production
+curl -f -k https://michaelschiemer.de/admin/health/api/summary | jq .
+```
+
+**Erwartetes Ergebnis**: JSON mit `"overall_status": "healthy"`
+
+### Phase 7: CI/CD-Workflow testen
+
+**Ziel**: Automatisches Deployment funktioniert.
+
+**Schritte**:
+1. Kleine Änderung im Code vornehmen
+2. Commit auf `staging`-Branch pushen
+3. Gitea Actions Workflow beobachten
+4. Nach erfolgreichem Deployment:
+   - Health-Check prüfen
+   - Code-Änderung verifizieren
+
+**Erwartetes Ergebnis**: 
+- Workflow läuft erfolgreich durch
+- Deployment erfolgreich
+- Health-Checks bestehen
+
+### Phase 8: Datenbank-Isolation testen
+
+**Ziel**: Staging und Production haben getrennte Datenbanken.
+
+**Schritte**:
+```bash
+# Auf Production-Server
+
+# Test-Daten in Staging-DB schreiben
+docker exec staging-app php -r "
+\$dsn = 'pgsql:host=postgres-staging;port=5432;dbname=michaelschiemer_staging';
+\$pdo = new PDO(\$dsn, 'postgres', trim(file_get_contents('/var/www/html/storage/secrets/db_user_password')));
+\$pdo->exec('CREATE TABLE IF NOT EXISTS test_isolation (id SERIAL PRIMARY KEY, env VARCHAR(50))');
+\$pdo->exec('INSERT INTO test_isolation (env) VALUES (\'staging\')');
+echo 'Staging data inserted.';
+"
+
+# Prüfen, dass Test-Daten NICHT in Production-DB sind
+docker exec postgres-production psql -U postgres -d michaelschiemer -c "SELECT * FROM test_isolation;" || echo "✅ Isolation confirmed: test_isolation table not in production"
+```
+
+**Erwartetes Ergebnis**: 
+- Test-Daten in Staging-DB vorhanden
+- Test-Daten NICHT in Production-DB vorhanden
+
+## Fehlerbehebung
+
+### Häufige Probleme
+
+1. **PostgreSQL-Container startet nicht**
+   - Prüfe `.env`-Datei (POSTGRES_PASSWORD gesetzt?)
+   - Prüfe Logs: `docker logs postgres-production` oder `docker logs postgres-staging`
+   - Prüfe Volumes: `docker volume ls`
+
+2. **Network-Verbindung fehlgeschlagen**
+   - Prüfe Networks: `docker network ls`
+   - Prüfe Container-Networks: `docker inspect <container> | grep -A 10 Networks`
+   - Stelle sicher, dass Container im richtigen Network sind
+
+3. **Datenbank-Verbindung fehlgeschlagen**
+   - Prüfe DB_HOST in Application-Container
+   - Prüfe DB_PASSWORD (Docker Secret)
+   - Prüfe Network-Verbindung (siehe oben)
+
+4. **Health-Check fehlgeschlagen**
+   - Prüfe Container-Status: `docker ps`
+   - Prüfe Application-Logs: `docker logs staging-app`
+   - Prüfe Nginx-Logs: `docker logs staging-nginx`
+
+## Test-Ergebnisse dokumentieren
+
+Nach jedem Test:
+- ✅ Erfolgreich
+- ❌ Fehlgeschlagen (mit Fehlerbeschreibung)
+- ⚠️ Teilweise erfolgreich (mit Details)
+
+## Nächste Schritte nach erfolgreichen Tests
+
+1. ✅ Alle Tests bestanden
+2. Dokumentation aktualisieren (falls nötig)
+3. Production-Deployment vorbereiten
+4. Monitoring einrichten
+
diff --git a/deployment/docs/reference/application-stack.md b/deployment/docs/reference/application-stack.md
index ceb3717c..7fd7ceac 100644
--- a/deployment/docs/reference/application-stack.md
+++ b/deployment/docs/reference/application-stack.md
@@ -2,16 +2,40 @@
 
 ## Übersicht
 
-Dieses Dokument erklärt, wie genau das Deployment in den Application Stack abläuft, wenn die CI/CD Pipeline ausgeführt wird.
+Dieses Dokument erklärt, wie genau das Deployment in den Application Stack abläuft. Es gibt zwei Deployment-Szenarien:
+
+1. **Initial Deployment** - Erstes Setup des Servers (Rsync-basiert)
+2. **Normal Deployment** - Regelmäßige Deployments via CI/CD (Git-basiert)
 
 **📖 Verwandte Dokumentation:**
+- **[Initial Deployment Guide](../guides/initial-deployment-guide.md)** - Schritt-für-Schritt Initial Deployment
+- **[Code Deployment Workflow](../guides/code-deployment-workflow.md)** - Unterschiede zwischen Rsync und Git
 - **[Code Changes Workflow](../guides/code-change-workflow.md)** - Wie Codeänderungen gepusht werden
 - **[CI/CD Status](../status/ci-cd-status.md)** - Aktueller Status der Pipeline
+- **[Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)** - Häufige Probleme und Lösungen
 
 ---
 
 ## Deployment-Flow
 
+### Initial Deployment (Rsync-basiert)
+
+```
+Local Repository
+    ↓
+1. Code Sync via rsync (sync-application-code.yml)
+    ↓
+2. Composer Dependencies installieren (install-composer-dependencies.yml)
+    ↓
+3. Docker Image Build & Push (build-initial-image.yml)
+    ↓
+4. Application Stack deployen (setup-infrastructure.yml)
+    ↓
+5. Container starten und verifizieren
+```
+
+### Normal Deployment (Git-basiert / CI/CD)
+
 ```
 CI/CD Pipeline (Gitea Actions)
     ↓
@@ -19,9 +43,11 @@ CI/CD Pipeline (Gitea Actions)
     ↓
 2. Docker Image Build & Push zur Registry
     ↓
-3. Ansible Playbook ausführen
+3. Code deployen via Git (deploy-application-code.yml)
     ↓
-4. Application Stack aktualisieren
+4. Ansible Playbook ausführen (deploy-update.yml)
+    ↓
+5. Application Stack aktualisieren
 ```
 
 ### Secret Handling für Redis
@@ -30,7 +56,7 @@ CI/CD Pipeline (Gitea Actions)
   unter dem Schlüssel `vault_redis_password`.
 - Die Application-Rolle (`roles/application/tasks/sync.yml`) bricht den Deploy ab,
   wenn kein Passwort aus dem Vault oder via `-e redis_password=...` vorhanden ist.
-- Während des Deployments wird das Passwort in `stacks/application/.env` geschrieben
+- Während des Deployments wird das Passwort in `stacks/production/.env` geschrieben
   und steht damit allen PHP-Containern über `REDIS_PASSWORD` zur Verfügung.
 - Docker Secrets mit `REDIS_PASSWORD_FILE` werden weiterhin unterstützt, da der
   Entry-Point das Secret lädt bevor PHP-FPM startet.
@@ -117,7 +143,7 @@ Das Ansible Playbook führt folgende Schritte auf dem Production-Server aus:
 
 **3. Verzeichnisse erstellen**
 ```yaml
-- Application Stack Path: ~/deployment/stacks/application
+- Application Stack Path: ~/deployment/stacks/production
 - Backup Verzeichnis: ~/deployment/backups/<timestamp>/
 ```
 
@@ -387,7 +413,7 @@ docker pull registry.michaelschiemer.de/framework:abc1234-1696234567
 # Nachher: image: registry.michaelschiemer.de/framework:abc1234-1696234567
 
 # 5. Stack neu starten
-cd ~/deployment/stacks/application
+cd ~/deployment/stacks/production
 docker compose up -d --pull always --force-recreate --remove-orphans
 
 # 6. Health-Checks warten
@@ -526,7 +552,7 @@ ansible-playbook -i inventory/production.yml \
 
 ```bash
 # Logs prüfen
-docker compose -f ~/deployment/stacks/application/docker-compose.yml logs
+docker compose -f ~/deployment/stacks/production/docker-compose.yml logs
 
 # Health-Check-Status prüfen
 docker compose ps
diff --git a/deployment/docs/reference/docker-compose-production.md b/deployment/docs/reference/docker-compose-production.md
new file mode 100644
index 00000000..2e6752ba
--- /dev/null
+++ b/deployment/docs/reference/docker-compose-production.md
@@ -0,0 +1,493 @@
+# Docker Compose Production Configuration
+
+**Stand:** 2025-11-07  
+**Status:** Vollständige Dokumentation der Production-Konfiguration
+
+---
+
+## Übersicht
+
+Dieses Dokument erklärt die Production-spezifische Docker Compose Konfiguration (`docker-compose.production.yml`). Diese Datei überschreibt die Basis-Konfiguration (`docker-compose.base.yml`) mit Production-spezifischen Einstellungen.
+
+**📖 Verwandte Dokumentation:**
+- [Application Stack Deployment](./application-stack.md) - Detaillierter Deployment-Ablauf
+- [Initial Deployment Guide](../guides/initial-deployment-guide.md) - Schritt-für-Schritt Anleitung
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Häufige Probleme und Lösungen
+
+---
+
+## Verwendung
+
+```bash
+# Production Stack starten
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml up -d
+
+# Mit .env Datei
+docker compose -f docker-compose.base.yml -f docker-compose.production.yml --env-file .env up -d
+```
+
+**Wichtig:** Die Production-Konfiguration wird immer zusammen mit der Basis-Konfiguration verwendet.
+
+---
+
+## Security Settings
+
+### Capabilities
+
+**Web Container:**
+```yaml
+cap_drop:
+  - ALL
+cap_add:
+  - CHOWN
+  - DAC_OVERRIDE
+  - NET_BIND_SERVICE  # Required for binding to ports 80/443
+  - SETGID  # Required for PHP-FPM to switch to www-data
+  - SETUID  # Required for PHP-FPM to switch to www-data
+```
+
+**PHP Container:**
+```yaml
+cap_drop:
+  - ALL
+cap_add:
+  - CHOWN
+  - DAC_OVERRIDE
+```
+
+**Wichtig:** `SETGID` und `SETUID` sind für den `web` Container erforderlich, damit PHP-FPM zum `www-data` User (UID 33) wechseln kann.
+
+**Trade-off:** `no-new-privileges: true` ist für den `web` Container **deaktiviert**, um PHP-FPM User Switching zu ermöglichen. Dies ist ein bewusster Security Trade-off.
+
+### no-new-privileges
+
+**Web Container:**
+```yaml
+# security_opt:
+#   - no-new-privileges:true  # ← Kommentiert
+```
+
+**PHP Container:**
+```yaml
+security_opt:
+  - no-new-privileges:true  # ← Aktiv
+```
+
+**Grund:** Der `web` Container benötigt Privilege Escalation für PHP-FPM, während der `php` Container nach dem User Switch (`gosu`) keine weiteren Privileges benötigt.
+
+---
+
+## Environment Variables
+
+### env_file vs. environment
+
+**env_file (Empfohlen):**
+```yaml
+env_file:
+  - /home/deploy/deployment/stacks/production/.env  # ← Absoluter Pfad
+```
+
+**Wichtig:** **Immer absolute Pfade verwenden**, um sicherzustellen, dass die `.env` Datei gefunden wird, unabhängig vom Working Directory.
+
+**environment (Override):**
+```yaml
+environment:
+  - APP_ENV=production
+  - APP_DEBUG=false
+  - PHP_MEMORY_LIMIT=512M
+```
+
+**Reihenfolge:** `env_file` wird zuerst geladen, dann werden `environment` Variablen als Override angewendet.
+
+### Docker Secrets Integration
+
+**Pattern:** `*_FILE` Environment Variables
+
+```yaml
+environment:
+  - DB_PASSWORD_FILE=/run/secrets/db_user_password
+  - REDIS_PASSWORD_FILE=/run/secrets/redis_password
+  - APP_KEY_FILE=/run/secrets/app_key
+  - VAULT_ENCRYPTION_KEY_FILE=/run/secrets/vault_encryption_key
+secrets:
+  - db_user_password
+  - redis_password
+  - app_key
+  - vault_encryption_key
+```
+
+**Funktionsweise:**
+1. Docker Secrets werden in `/run/secrets/<secret-name>` gemountet
+2. Framework liest automatisch `*_FILE` Variablen und lädt den Inhalt
+3. Secrets werden nie als Environment Variables exponiert
+
+**Siehe auch:** [Application Stack Deployment](./application-stack.md) - Secret Handling
+
+---
+
+## Entrypoint Overrides
+
+### Queue Worker
+
+```yaml
+queue-worker:
+  entrypoint: ""  # ← Leerer Entrypoint überschreibt Image Entrypoint
+  command: ["php", "/var/www/html/worker.php"]
+```
+
+**Grund:** Der Image Entrypoint (`/usr/local/bin/entrypoint.sh`) startet PHP-FPM und Nginx. Der Queue Worker benötigt nur PHP CLI.
+
+### Scheduler
+
+```yaml
+scheduler:
+  entrypoint: ""  # ← Leerer Entrypoint überschreibt Image Entrypoint
+  command: php console.php scheduler:run
+```
+
+**Grund:** Gleicher Grund wie Queue Worker - nur PHP CLI erforderlich.
+
+**Siehe auch:** [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Container Entrypoint Override
+
+---
+
+## Health Checks
+
+### Web Container
+
+```yaml
+healthcheck:
+  test: ["CMD", "curl", "-f", "https://localhost/health"]
+  interval: 15s
+  timeout: 5s
+  retries: 5
+  start_period: 30s
+```
+
+**Funktionsweise:**
+- Prüft `/health` Endpoint via HTTPS
+- Startet nach 30 Sekunden (Container Startup Time)
+- Prüft alle 15 Sekunden
+- 5 Retries bei Fehlschlag
+
+### PHP Container
+
+```yaml
+healthcheck:
+  test: ["CMD", "php", "-v"]
+  interval: 15s
+  timeout: 5s
+  retries: 5
+  start_period: 30s
+```
+
+**Funktionsweise:**
+- Prüft PHP Verfügbarkeit
+- Einfacher Check für Container-Health
+
+### Scheduler
+
+```yaml
+healthcheck:
+  test: ["CMD-SHELL", "php -r 'exit(0);' && test -f /var/www/html/console.php || exit 1"]
+  interval: 60s
+  timeout: 10s
+  retries: 3
+  start_period: 30s
+```
+
+**Funktionsweise:**
+- Prüft PHP Verfügbarkeit und `console.php` Existenz
+- Längeres Interval (60s) da Scheduler weniger kritisch
+
+---
+
+## Volume Mounts
+
+### Application Code
+
+```yaml
+volumes:
+  - /home/deploy/michaelschiemer/current:/var/www/html:rw
+```
+
+**Wichtig:**
+- **Absoluter Pfad** auf dem Host
+- **Read-Write** für `storage/` und `var/` Verzeichnisse
+- Code wird via `rsync` oder `git` synchronisiert
+
+**Siehe auch:** [Code Deployment Workflow](../guides/code-deployment-workflow.md)
+
+### Certbot Volumes
+
+```yaml
+volumes:
+  - certbot-conf:/etc/letsencrypt:ro
+  - certbot-www:/var/www/certbot:ro
+```
+
+**Funktionsweise:**
+- `certbot-conf`: SSL Zertifikate (Read-Only für Web Container)
+- `certbot-www`: Webroot für Let's Encrypt Challenge
+
+---
+
+## Resource Limits
+
+### Web Container
+
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 512M
+      cpus: '1.0'
+    reservations:
+      memory: 256M
+      cpus: '0.5'
+```
+
+**Grund:** Nginx ist leichtgewichtig, benötigt wenig Ressourcen.
+
+### PHP Container
+
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 1G
+      cpus: '2.0'
+    reservations:
+      memory: 512M
+      cpus: '1.0'
+```
+
+**Grund:** PHP-FPM benötigt mehr Ressourcen für Request-Verarbeitung.
+
+### Queue Worker
+
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 2G
+      cpus: '2.0'
+    reservations:
+      memory: 1G
+      cpus: '1.0'
+```
+
+**Grund:** Queue Worker verarbeitet lange Jobs, benötigt mehr Memory.
+
+### Scheduler
+
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 512M
+      cpus: '0.5'
+    reservations:
+      memory: 256M
+      cpus: '0.25'
+```
+
+**Grund:** Scheduler läuft periodisch, benötigt wenig Ressourcen.
+
+---
+
+## Logging
+
+### JSON Logging mit Rotation
+
+```yaml
+logging:
+  driver: json-file
+  options:
+    max-size: "10m"
+    max-file: "5"
+    compress: "true"
+    labels: "service,environment"
+```
+
+**Funktionsweise:**
+- **max-size:** Maximale Größe pro Log-Datei
+- **max-file:** Anzahl der Log-Dateien (Rotation)
+- **compress:** Komprimierung alter Log-Dateien
+- **labels:** Metadaten für Log-Aggregation
+
+**Beispiel:** Bei 5 Dateien à 10MB = max. 50MB Log-Speicher pro Container.
+
+---
+
+## Restart Policies
+
+```yaml
+restart: always
+```
+
+**Funktionsweise:**
+- Container wird automatisch neu gestartet bei:
+  - Container Exit (auch bei Fehlern)
+  - Docker Daemon Restart
+  - System Reboot
+
+**Alternative Policies:**
+- `no`: Kein automatischer Restart
+- `on-failure`: Nur bei Fehlern
+- `unless-stopped`: Immer, außer manuell gestoppt
+
+---
+
+## Dependencies
+
+### Service Dependencies
+
+```yaml
+depends_on:
+  php:
+    condition: service_healthy
+  certbot:
+    condition: service_started
+```
+
+**Funktionsweise:**
+- `service_healthy`: Wartet auf erfolgreichen Health Check
+- `service_started`: Wartet nur auf Container Start
+
+**Wichtig:** `queue-worker` und `scheduler` warten auf `php` Container Health, da sie die gleiche Codebase verwenden.
+
+---
+
+## External Services
+
+### PostgreSQL
+
+```yaml
+# Database service removed - using external PostgreSQL Stack
+# Connection via app-internal network using docker-compose.postgres-override.yml
+```
+
+**Grund:** PostgreSQL läuft in separatem Stack (`deployment/stacks/postgresql/`) für bessere Isolation.
+
+### Redis
+
+```yaml
+# Redis service removed - using external Redis Stack
+# Connection via app-internal network using docker-compose.redis-override.yml
+```
+
+**Grund:** Redis läuft in separatem Stack (`deployment/stacks/redis/`) für bessere Isolation.
+
+**Verbindung:** Via `app-internal` Network (siehe `docker-compose.base.yml`).
+
+---
+
+## Networks
+
+### Cache Network
+
+```yaml
+networks:
+  cache:
+    internal: true  # Cache network is internal in production
+```
+
+**Funktionsweise:**
+- **Internal:** Keine externe Verbindung möglich
+- Nur für Container-zu-Container Kommunikation
+- Erhöht Security (Redis nicht von außen erreichbar)
+
+---
+
+## Best Practices
+
+### 1. Absolute Pfade für env_file
+
+**✅ Richtig:**
+```yaml
+env_file:
+  - /home/deploy/deployment/stacks/production/.env
+```
+
+**❌ Falsch:**
+```yaml
+env_file:
+  - .env  # Relativer Pfad - funktioniert nur im richtigen Verzeichnis
+```
+
+### 2. Entrypoint Override für CLI-Container
+
+**✅ Richtig:**
+```yaml
+queue-worker:
+  entrypoint: ""
+  command: ["php", "/var/www/html/worker.php"]
+```
+
+**❌ Falsch:**
+```yaml
+queue-worker:
+  # Kein Entrypoint Override - startet PHP-FPM/Nginx unnötig
+```
+
+### 3. Capabilities für PHP-FPM
+
+**✅ Richtig:**
+```yaml
+web:
+  cap_add:
+    - SETGID
+    - SETUID
+```
+
+**❌ Falsch:**
+```yaml
+web:
+  security_opt:
+    - no-new-privileges:true  # Verhindert PHP-FPM User Switching
+```
+
+---
+
+## Troubleshooting
+
+### Problem: Container startet nicht / unhealthy
+
+**Lösung:** Siehe [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md)
+
+**Häufige Ursachen:**
+- Missing Environment Variables → `env_file` mit absolutem Pfad prüfen
+- PHP-FPM Permission Errors → Capabilities (SETGID/SETUID) prüfen
+- Missing Application Code → Code-Sync prüfen
+
+### Problem: Environment Variables werden nicht geladen
+
+**Ursache:** Relativer Pfad in `env_file`
+
+**Lösung:** Absoluten Pfad verwenden:
+```yaml
+env_file:
+  - /home/deploy/deployment/stacks/production/.env
+```
+
+### Problem: Queue Worker startet PHP-FPM
+
+**Ursache:** Entrypoint Override fehlt
+
+**Lösung:**
+```yaml
+queue-worker:
+  entrypoint: ""
+  command: ["php", "/var/www/html/worker.php"]
+```
+
+---
+
+## Referenz
+
+- [Application Stack Deployment](./application-stack.md) - Detaillierter Ablauf
+- [Initial Deployment Guide](../guides/initial-deployment-guide.md) - Schritt-für-Schritt Anleitung
+- [Troubleshooting Guide](../troubleshooting/initial-deployment-issues.md) - Probleme und Lösungen
+- [Code Deployment Workflow](../guides/code-deployment-workflow.md) - Code-Synchronisation
+
diff --git a/deployment/docs/server-directory-structure.md b/deployment/docs/server-directory-structure.md
new file mode 100644
index 00000000..f9650a4f
--- /dev/null
+++ b/deployment/docs/server-directory-structure.md
@@ -0,0 +1,220 @@
+# Server-Verzeichnisstruktur
+
+## Übersicht
+
+Auf dem Production-Server (`deploy@michaelschiemer`) existieren zwei Hauptverzeichnisse im Home-Verzeichnis:
+
+```
+/home/deploy/
+├── deployment/          # Infrastructure-as-Code (24M)
+└── michaelschiemer/    # Application Code (491M)
+```
+
+## Verzeichnis-Details
+
+### `/home/deploy/deployment/` - Infrastructure Repository
+
+**Zweck**: Enthält alle Deployment-Infrastruktur-Konfigurationen
+
+**Inhalt**:
+```
+deployment/
+├── stacks/             # Docker Compose Stacks
+│   ├── traefik/       # Reverse Proxy & SSL
+│   ├── gitea/         # Git Repository Server
+│   ├── postgresql-production/
+│   ├── postgresql-staging/
+│   ├── production/    # Production Application Stack
+│   ├── staging/       # Staging Application Stack
+│   └── ...
+└── backups/          # Backup-Dateien
+```
+
+**Verwendet von**:
+- Ansible Playbooks für Infrastructure-Deployment
+- Docker Compose für Container-Orchestrierung
+- Traefik für Service Discovery
+
+**Ansible Variable**:
+```yaml
+stacks_base_path: "/home/deploy/deployment/stacks"
+```
+
+**Verwendung in Playbooks**:
+- `setup-infrastructure.yml` - Deployt alle Docker Stacks
+- `backup.yml` - Erstellt Backups
+- `sync-stacks.yml` - Synchronisiert Stack-Konfigurationen
+
+---
+
+### `/home/deploy/michaelschiemer/` - Application Repository
+
+**Zweck**: Enthält den eigentlichen Application-Code (PHP, Composer, etc.)
+
+**Inhalt**:
+```
+michaelschiemer/
+├── current/           # Symlink → Aktuelle deployed Version
+│   ├── src/          # PHP Source Code
+│   ├── vendor/       # Composer Dependencies
+│   ├── composer.json
+│   ├── worker.php
+│   └── console.php
+├── .archive/         # Alte Versionen (Rollback)
+├── backups/          # Application-spezifische Backups
+└── ...
+```
+
+**Verwendet von**:
+- Ansible Playbooks für Application-Deployment
+- Docker Container (gemountet als Volume)
+- PHP-FPM, Queue Workers, etc.
+
+**Ansible Variable**:
+```yaml
+application_code_dest: "/home/deploy/michaelschiemer/current"
+```
+
+**Verwendung in Playbooks**:
+- `deploy-application-code.yml` - Deployt neuen Application Code
+- `sync-application-code.yml` - Synchronisiert Code
+- `install-composer-dependencies.yml` - Installiert Dependencies
+
+---
+
+## Warum zwei Verzeichnisse?
+
+### Trennung von Concerns
+
+1. **Infrastructure** (`deployment/`)
+   - Ändert sich selten
+   - Wird von DevOps verwaltet
+   - Enthält Docker, Traefik, Datenbanken, etc.
+
+2. **Application** (`michaelschiemer/`)
+   - Ändert sich häufig (bei jedem Deployment)
+   - Wird von Entwicklern verwaltet
+   - Enthält Business-Logic, PHP-Code, etc.
+
+### Vorteile
+
+- **Klarere Verantwortlichkeiten**: Infrastructure vs. Application
+- **Einfacheres Backup**: Separate Backups für Infrastructure und Code
+- **Bessere Skalierung**: Infrastructure kann unabhängig vom Code aktualisiert werden
+- **Rollback-Möglichkeiten**: Alte Application-Versionen in `.archive/`
+
+---
+
+## Deployment-Workflow
+
+### Infrastructure Deployment
+
+```bash
+# Infrastructure wird aus lokalem Repository deployed
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert**:
+1. Ansible kopiert `deployment/stacks/` auf den Server
+2. Docker Compose startet Container basierend auf Stack-Konfigurationen
+3. Traefik entdeckt Services via Docker Labels
+
+### Application Deployment
+
+```bash
+# Application Code wird aus Gitea deployed
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Was passiert**:
+1. Ansible klont/pullt Code aus Gitea
+2. Code wird nach `~/michaelschiemer/current/` deployed
+3. Composer installiert Dependencies
+4. Docker Container werden neu gestartet (mit neuem Code)
+
+---
+
+## Verzeichnis-Größen
+
+```bash
+# Aktuelle Größen (Stand: 2025-11-08)
+24M    /home/deploy/deployment      # Infrastructure
+491M   /home/deploy/michaelschiemer  # Application Code
+```
+
+**Hinweis**: Die Application ist größer, da sie Composer Dependencies (`vendor/`) enthält.
+
+---
+
+## Wartung
+
+### Prüfen, ob beide Verzeichnisse existieren
+
+```bash
+ssh deploy@michaelschiemer.de
+ls -la ~/deployment ~/michaelschiemer
+```
+
+### Prüfen, ob `current/` Symlink existiert
+
+```bash
+ls -la ~/michaelschiemer/current
+# Sollte zeigen: current -> /path/to/version
+```
+
+### Verzeichnis-Größen prüfen
+
+```bash
+du -sh ~/deployment ~/michaelschiemer
+```
+
+---
+
+## Troubleshooting
+
+### Problem: `current/` Symlink fehlt
+
+**Lösung**:
+```bash
+# Manuell erstellen oder Playbook ausführen
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml
+```
+
+### Problem: Verzeichnis zu groß
+
+**Lösung**:
+```bash
+# Alte Versionen aufräumen
+rm -rf ~/michaelschiemer/.archive/*
+# Composer Cache leeren
+rm -rf ~/michaelschiemer/cache/*
+```
+
+### Problem: Beide Verzeichnisse fehlen
+
+**Lösung**:
+```bash
+# Infrastructure deployen
+ansible-playbook -i inventory/production.yml \
+  playbooks/setup-infrastructure.yml
+
+# Application deployen
+ansible-playbook -i inventory/production.yml \
+  playbooks/deploy-application-code.yml
+```
+
+---
+
+## Siehe auch
+
+- [Deployment README](../README.md) - Übersicht über Deployment-Prozess
+- [Ansible Playbooks](../ansible/playbooks/README.md) - Liste aller Playbooks
+- [Backup Guide](guides/backup-and-rollback-guide.md) - Backup-Strategie
+
+
+
diff --git a/deployment/docs/status/ci-cd-status.md b/deployment/docs/status/ci-cd-status.md
index 987f1461..89be8915 100644
--- a/deployment/docs/status/ci-cd-status.md
+++ b/deployment/docs/status/ci-cd-status.md
@@ -90,20 +90,35 @@ Die Logs zeigen einige Verbindungsfehler (connection refused, 502 Bad Gateway),
 
 ### 3. Ansible Vault Password Handling
 
-**Status**: ⚠️ Workflow nutzt Vault, aber kein Secret dafür
+**Status**: ✅ Workflows verwenden ANSIBLE_VAULT_PASSWORD Secret
 
-**Problem:**
-- Der Workflow `update-production-secrets.yml` benötigt ein Vault-Passwort
-- Aktuell wird es als Workflow-Input eingegeben (manuell)
-- Für automatisiertes Deployment sollte es als Secret vorliegen
+**Implementiert:**
+- ✅ `ANSIBLE_VAULT_PASSWORD` wird als Gitea Secret verwendet
+- ✅ Workflows erstellen automatisch Vault Password File aus Secret
+- ✅ Fallback: Leeres Password File wenn Secret nicht gesetzt ist
 
-**Lösung:**
-- [ ] Optional: `ANSIBLE_VAULT_PASSWORD` als Secret hinzufügen (nur wenn automatisiert)
-- [ ] Oder: Manuelles Eingeben beim Workflow-Trigger ist ausreichend
+**Konfiguration:**
+- Secret Name: `ANSIBLE_VAULT_PASSWORD`
+- Verwendung: Workflows erstellen `/tmp/vault_pass` aus Secret
+- Optional: Falls Secret nicht gesetzt, wird leeres Password File verwendet (für nicht-verschlüsselte Vaults)
 
 ---
 
-### 4. Pipeline End-to-End testen
+### 4. Code-Deployment Integration
+
+**Status**: ✅ Code-Deployment via Ansible in Workflows integriert
+
+**Implementiert:**
+- ✅ `deploy-application-code.yml` wird in Workflows verwendet
+- ✅ `install-composer-dependencies.yml` wird nach Code-Deployment ausgeführt
+- ✅ `deploy-image.yml` wird für Image-Deployment verwendet
+- ✅ Production Deployment Workflow verwendet Ansible statt direkter SSH-Befehle
+
+**Workflows aktualisiert:**
+- ✅ `.gitea/workflows/build-image.yml` - Staging & Production Auto-Deploy
+- ✅ `.gitea/workflows/manual-deploy.yml` - Manuelles Deployment
+
+### 5. Pipeline End-to-End testen
 
 **Status**: ⚠️ Pipeline ist definiert, aber noch nicht getestet
 
@@ -144,6 +159,7 @@ Die Logs zeigen einige Verbindungsfehler (connection refused, 502 Bad Gateway),
   - [x] `REGISTRY_USER` ✅
   - [x] `REGISTRY_PASSWORD` ✅
   - [x] `SSH_PRIVATE_KEY` ✅
+  - [x] `ANSIBLE_VAULT_PASSWORD` ✅ (für automatisiertes Deployment)
   - [ ] `GITEA_TOKEN` (optional)
 
 ### Gitea Runner
@@ -153,14 +169,22 @@ Die Logs zeigen einige Verbindungsfehler (connection refused, 502 Bad Gateway),
 - [x] Runner läuft (`docker compose up -d`) ✅
 - [ ] Runner sichtbar in Gitea UI als "Idle" oder "Active" (bitte manuell prüfen)
 
+### Code-Deployment Integration
+- [x] `deploy-application-code.yml` in Workflows integriert ✅
+- [x] `install-composer-dependencies.yml` in Workflows integriert ✅
+- [x] `deploy-image.yml` in Workflows integriert ✅
+- [x] Production Deployment Workflow auf Ansible umgestellt ✅
+
 ### Pipeline-Test
 - [ ] Test-Commit gepusht oder Workflow manuell getriggert
 - [ ] Alle Jobs erfolgreich:
   - [ ] Tests
   - [ ] Build
-  - [ ] Deploy
+  - [ ] Code-Deployment (Git)
+  - [ ] Composer Dependencies
+  - [ ] Image-Deployment
+  - [ ] Health-Check
 - [ ] Deployment erfolgreich auf Production
-- [ ] Health-Check erfolgreich
 - [ ] Application läuft korrekt
 
 ### Dokumentation
@@ -180,7 +204,13 @@ Die Logs zeigen einige Verbindungsfehler (connection refused, 502 Bad Gateway),
 **Status:** ✅ Abgeschlossen
 - Runner läuft und ist registriert
 
-### Phase 3: Pipeline-Test (NÄCHSTER SCHRITT)
+### Phase 3: Code-Deployment Integration
+**Status:** ✅ Abgeschlossen
+- Code-Deployment via Ansible in Workflows integriert
+- Production Deployment Workflow auf Ansible umgestellt
+- Ansible Vault Password Handling implementiert
+
+### Phase 4: Pipeline-Test (NÄCHSTER SCHRITT)
 **Status:** ⚠️ Ausstehend
 1. Test-Workflow ausführen
 2. Fehler beheben falls notwendig
@@ -205,14 +235,25 @@ cp .env.example .env
 docker compose up -d
 ```
 
-### Pipeline manuell triggern (NÄCHSTER SCHRITT)
+### Pipeline testen (NÄCHSTER SCHRITT)
+
+**Vorbereitung:**
+```bash
+# Prüfe alle Voraussetzungen
+./deployment/scripts/test-pipeline-prerequisites.sh
+```
+
+**Detaillierte Test-Anleitung:**
+Siehe [Pipeline Test Checklist](../guides/pipeline-test-checklist.md) für Schritt-für-Schritt Anleitung.
+
+**Pipeline manuell triggern:**
 ```
 1. Gehe zu: https://git.michaelschiemer.de/michael/michaelschiemer/actions
-2. Wähle: "Production Deployment Pipeline"
+2. Wähle: "Build & Deploy Image"
 3. Klicke: "Run workflow"
-4. Wähle Branch: main
+4. Wähle Branch: staging (für Staging-Test) oder main (für Production-Test)
 5. Optionale Einstellungen:
-   - skip_tests: false (Tests sollen laufen)
+   - force_build: false (nur bei Bedarf)
 6. Klicke: "Run workflow"
 7. Beobachte Logs und prüfe jeden Schritt
 ```
@@ -228,12 +269,15 @@ https://git.michaelschiemer.de/admin/actions/runners
 
 ## ✅ Aktueller Status
 
-**CI/CD Pipeline ist vollständig konfiguriert!**
+**CI/CD Pipeline ist vollständig konfiguriert und integriert!**
 
 - ✅ Secrets konfiguriert
 - ✅ Runner läuft und ist registriert
 - ✅ Workflows sind vorhanden
-- ⚠️ **Nächster Schritt:** Pipeline testen!
+- ✅ Code-Deployment via Ansible integriert
+- ✅ Production Deployment Workflow auf Ansible umgestellt
+- ✅ Ansible Vault Password Handling implementiert
+- ⚠️ **Nächster Schritt:** Pipeline testen! (siehe [Pipeline Testing Guide](../guides/pipeline-testing-guide.md))
 
 **Ready to Deploy:** Die Pipeline kann jetzt getestet werden. Alle Voraussetzungen sind erfüllt.
 
diff --git a/deployment/docs/status/gitea-cache-activation.md b/deployment/docs/status/gitea-cache-activation.md
new file mode 100644
index 00000000..ad88a6c8
--- /dev/null
+++ b/deployment/docs/status/gitea-cache-activation.md
@@ -0,0 +1,124 @@
+# Gitea Cache Aktivierung - Status
+
+**Datum:** 2025-01-XX  
+**Status:** ✅ Konfiguration abgeschlossen, Deployment ausstehend
+
+## Durchgeführte Änderungen
+
+### 1. docker-compose.yml angepasst
+
+**Datei:** `deployment/stacks/gitea/docker-compose.yml`
+
+**Änderungen:**
+- `GITEA__cache__ENABLED=false` → `GITEA__cache__ENABLED=true`
+- `GITEA__cache__ADAPTER=memory` → `GITEA__cache__ADAPTER=redis`
+- Cache-spezifische Redis-Konfiguration hinzugefügt:
+  - `GITEA__cache__HOST=redis:6379`
+  - `GITEA__cache__PASSWORD=${REDIS_PASSWORD:-gitea_redis_password}`
+  - `GITEA__cache__DB=0`
+
+**Vorher:**
+```yaml
+# Cache temporarily disabled (using memory) to debug Redis connection issue
+- GITEA__cache__ENABLED=false
+- GITEA__cache__ADAPTER=memory
+```
+
+**Nachher:**
+```yaml
+- GITEA__cache__ENABLED=true
+- GITEA__cache__ADAPTER=redis
+- GITEA__cache__HOST=redis:6379
+- GITEA__cache__PASSWORD=${REDIS_PASSWORD:-gitea_redis_password}
+- GITEA__cache__DB=0
+```
+
+### 2. Ansible Playbook erstellt
+
+**Datei:** `deployment/ansible/playbooks/restart-gitea-with-cache.yml`
+
+Das Playbook:
+- Prüft ob Gitea Container existiert
+- Erstellt Gitea Container mit neuer Cache-Konfiguration neu
+- Wartet auf Gitea Health-Check
+- Zeigt Erfolgsmeldung
+
+## Nächste Schritte
+
+### 1. Dateien auf Server synchronisieren
+
+Die geänderte `docker-compose.yml` muss auf den Server synchronisiert werden:
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-stacks.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### 2. Gitea Container neu starten
+
+Nach der Synchronisation Gitea mit neuer Cache-Konfiguration neu starten:
+
+**Option A: Via Ansible Playbook**
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/restart-gitea-with-cache.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+**Option B: Manuell auf Server**
+```bash
+ssh deploy@94.16.110.151
+cd ~/deployment/stacks/gitea
+docker compose up -d --force-recreate gitea
+```
+
+### 3. Cache-Verbindung verifizieren
+
+Nach dem Neustart prüfen:
+
+```bash
+# Gitea Logs prüfen
+docker compose logs gitea | grep -i cache
+
+# Redis-Verbindung testen
+docker exec gitea-redis redis-cli -a $REDIS_PASSWORD ping
+
+# Gitea Health-Check
+curl -f https://git.michaelschiemer.de/api/healthz
+```
+
+## Erwartetes Ergebnis
+
+Nach erfolgreichem Neustart sollte Gitea:
+- ✅ Redis für Caching verwenden (statt Memory)
+- ✅ Bessere Performance durch persistentes Caching
+- ✅ Cache überlebt Container-Neustarts
+- ✅ Keine Timeout-Probleme mehr durch Runner ohne Token
+
+## Gitea Runner Status
+
+**Wichtig:** Der Gitea Runner ist registriert, aber aktuell nicht gestartet. Das ist korrekt, da:
+- Runner ohne Registration Token in Dauerschleife läuft
+- Runner Gitea mit Requests bombardiert → Timeouts
+- Runner sollte nur gestartet werden, wenn Token konfiguriert ist
+
+**Status:**
+- ✅ Runner ist registriert (`data/.runner` existiert)
+- ✅ Registration Token ist in `.env` konfiguriert
+- ⏸️ Runner Container sind gestoppt (korrekt, bis Deployment abgeschlossen)
+
+**Runner starten (nach Cache-Aktivierung):**
+```bash
+cd deployment/gitea-runner
+docker compose up -d
+```
+
+## Referenz
+
+- [Gitea Cache Configuration](https://docs.gitea.io/en-us/config-cheat-sheet/#cache-cache)
+- [Redis Configuration](https://docs.gitea.io/en-us/config-cheat-sheet/#cache-cache)
+- [Gitea Runner Setup](../gitea-runner/README.md)
+
diff --git a/deployment/docs/status/implementation-summary.md b/deployment/docs/status/implementation-summary.md
new file mode 100644
index 00000000..a42af870
--- /dev/null
+++ b/deployment/docs/status/implementation-summary.md
@@ -0,0 +1,141 @@
+# Implementation Summary - Pre-Deployment Checklist
+
+## ✅ Abgeschlossen
+
+### 1. Backup-Playbook
+- **Status**: ✅ Implementiert
+- **Datei**: `deployment/ansible/playbooks/backup.yml`
+- **Features**:
+  - PostgreSQL Backup
+  - Application Data Backup (Storage, Logs)
+  - Gitea Data Backup
+  - Docker Registry Images Backup (optional)
+  - Automatische Backup-Rotation
+  - Backup-Verifizierung
+
+### 2. Legacy-Cleanup
+- **Status**: ✅ Abgeschlossen
+- **Entfernt**:
+  - `deployment/wireguard-old/` - Alte WireGuard Playbooks
+  - `deployment/ansible/playbooks/build-and-push.yml` - Wird durch CI/CD ersetzt
+  - `deployment/ansible/playbooks/remove-framework-production-stack.yml` - Temporär
+  - `deployment/ansible/playbooks/remove-temporary-grafana-ip.yml` - Temporär
+- **Dokumentiert**: `deployment/ansible/playbooks/README.md`
+
+### 3. Dokumentations-Cleanup
+- **Status**: ✅ Abgeschlossen
+- **Erstellt**: `deployment/docs/tests/README.md` - Dokumentiert veraltete Test-Docs
+- **Konsolidiert**: Test-Dokumentationen als historisch markiert
+
+### 4. Health Checks erweitert
+- **Status**: ✅ Implementiert
+- **Workflow**: Erweiterte Health-Checks in CI/CD Pipeline
+- **Endpoints**: 
+  - `/health` - Basic Health Check
+  - `/admin/health/api/summary` - Extended Health Summary
+- **Dokumentation**: `deployment/docs/guides/health-checks.md`
+
+### 5. Security Hardening dokumentiert
+- **Status**: ✅ Dokumentiert
+- **Dokumentation**: `deployment/docs/guides/security-hardening.md`
+- **Aktuell**: Firewall, WireGuard VPN, Unattended-Upgrades, Security Headers
+- **Geplant**: SSH Hardening, Container Scanning, Secrets Rotation
+
+## ⚠️ Ausstehend / Geplant
+
+### 1. Pipeline End-to-End testen
+- **Status**: ⚠️ Vorbereitet - Bereit zum Testen
+- **Priorität**: KRITISCH
+- **Test-Ressourcen erstellt:**
+  - ✅ `deployment/scripts/test-pipeline-prerequisites.sh` - Prüft alle Voraussetzungen
+  - ✅ `deployment/docs/guides/pipeline-test-checklist.md` - Detaillierte Schritt-für-Schritt Checkliste
+  - ✅ Dokumentation aktualisiert
+- **Was zu tun**:
+  - Test-Commit auf `staging` Branch pushen
+  - Alle Workflow-Jobs verifizieren
+  - Deployment auf Staging verifizieren
+  - Health-Checks prüfen
+  - Application funktioniert korrekt
+
+### 2. Zero-Downtime Deployment
+- **Status**: ⚠️ Nicht implementiert
+- **Priorität**: HOCH
+- **Geplant**: Blue-Green oder Rolling Updates mit Health-Checks
+
+### 3. Automatische Rollbacks
+- **Status**: ⚠️ Rollback-Playbook vorhanden, aber nicht automatisch
+- **Priorität**: HOCH
+- **Geplant**: Automatischer Rollback bei fehlgeschlagenem Health-Check
+
+### 4. Resource Limits & Performance
+- **Status**: ⚠️ Teilweise vorhanden
+- **Priorität**: MITTEL
+- **Geplant**: Container Resource Limits, Performance Monitoring, Load Testing
+
+### 5. Network Isolation & Segmentation
+- **Status**: ⚠️ Basis vorhanden
+- **Priorität**: MITTEL
+- **Geplant**: Network Policy Verification, Service Communication Audit
+
+### 6. SSL/TLS Configuration
+- **Status**: ✅ Basis vorhanden
+- **Priorität**: MITTEL
+- **Zu prüfen**: Certificate Auto-Renewal, TLS Version Audit, Cipher Suite Audit
+
+### 7. Monitoring & Alerting verbessern
+- **Status**: ⚠️ Basis vorhanden
+- **Priorität**: MITTEL
+- **Geplant**: Application-Metriken, Custom Dashboards, Alerting Rules
+
+### 8. Zentralisiertes Logging
+- **Status**: ⚠️ Basis vorhanden
+- **Priorität**: MITTEL
+- **Geplant**: ELK/Loki Stack, Log-Aggregation, Search Interface
+
+### 9. Secrets Management verbessern
+- **Status**: ⚠️ Basis vorhanden
+- **Priorität**: MITTEL
+- **Geplant**: Rotation Policy, Audit Logging, Backup
+
+## Nächste Schritte
+
+### Vor erstem Production-Deployment
+
+1. **Pipeline End-to-End testen** (KRITISCH)
+   - Prerequisites prüfen: `./deployment/scripts/test-pipeline-prerequisites.sh`
+   - Test-Commit auf `staging` pushen
+   - Alle Jobs verifizieren (siehe: `deployment/docs/guides/pipeline-test-checklist.md`)
+   - Health-Checks prüfen
+
+2. **Backup-Playbook testen**
+   - Test-Backup ausführen: `./deployment/scripts/test-backup.sh`
+   - Backup-Verifizierung prüfen
+   - Restore-Test durchführen (optional)
+
+3. **Security Audit**
+   - Firewall Rules prüfen
+   - SSH Hardening implementieren
+   - Container Scanning aktivieren
+
+### Langfristige Verbesserungen
+
+- Zero-Downtime Deployment
+- Automatische Rollbacks
+- Erweiterte Monitoring & Alerting
+- Zentralisiertes Logging
+- Secrets Rotation
+
+## Zusammenfassung
+
+**Abgeschlossen**: 5 von 15 geplanten Aufgaben
+**In Arbeit**: 0 von 15 Aufgaben
+**Ausstehend**: 10 von 15 Aufgaben
+
+**Kritische Aufgaben vor Deployment**:
+1. ✅ Backup-Playbook (abgeschlossen)
+2. ✅ Health Checks erweitert (abgeschlossen)
+3. ⚠️ Pipeline End-to-End testen (ausstehend)
+4. ⚠️ Zero-Downtime Deployment (geplant)
+
+**Status**: Bereit für Staging-Tests, Production-Deployment erfordert noch End-to-End-Tests.
+
diff --git a/deployment/docs/status/pipeline-test-status.md b/deployment/docs/status/pipeline-test-status.md
new file mode 100644
index 00000000..c002e54b
--- /dev/null
+++ b/deployment/docs/status/pipeline-test-status.md
@@ -0,0 +1,114 @@
+# CI/CD Pipeline Test Status
+
+**Datum:** 2025-01-XX  
+**Status:** ⚠️ Teilweise abgeschlossen - Push fehlgeschlagen
+
+## Durchgeführte Schritte
+
+### ✅ Phase 0: Gitea Caching aktivieren
+- **Status:** ✅ Abgeschlossen
+- **Änderungen:** `deployment/stacks/gitea/docker-compose.yml` angepasst
+- **Cache-Konfiguration:** Redis aktiviert (statt Memory)
+- **Playbook erstellt:** `deployment/ansible/playbooks/restart-gitea-with-cache.yml`
+- **Nächster Schritt:** Dateien auf Server synchronisieren und Gitea neu starten
+
+### ✅ Phase 1: Prerequisites prüfen
+- **Status:** ✅ Abgeschlossen
+- **Prerequisites Script:** Ausgeführt
+- **Gitea Runner:** Registriert, aber nicht gestartet (korrekt, da Token konfiguriert ist)
+- **Gitea Secrets:** Laut Dokumentation bereits konfiguriert
+
+### ⚠️ Phase 2: Staging Pipeline Test
+- **Status:** ⚠️ Teilweise abgeschlossen
+- **Test-Commit:** ✅ Erstellt (`test: CI/CD pipeline staging test`)
+- **Push:** ❌ Fehlgeschlagen (504 Error)
+- **Fehler:** `fatal: unable to access 'https://git.michaelschiemer.de/admin/michaelschiemer.git/': The requested URL returned error: 504`
+
+## Bekannte Probleme
+
+### 1. Git Push 504 Error
+
+**Symptom:**
+```
+fatal: unable to access 'https://git.michaelschiemer.de/admin/michaelschiemer.git/': The requested URL returned error: 504
+```
+
+**Mögliche Ursachen:**
+1. **Gitea-Überlastung:** Runner ohne Token bombardiert Gitea mit Requests
+2. **Server-Überlastung:** Server ist temporär überlastet
+3. **Netzwerk-Problem:** Verbindungsprobleme zum Server
+
+**Lösungsansätze:**
+1. **Gitea Caching aktivieren:** Redis-Cache sollte Performance verbessern
+2. **Runner Status prüfen:** Sicherstellen, dass Runner nur mit Token läuft
+3. **Gitea Logs prüfen:** Server-Logs auf Fehler prüfen
+4. **Retry:** Push später erneut versuchen
+
+### 2. Gitea Runner ohne Token
+
+**Problem:** Runner ohne Registration Token läuft in Dauerschleife und bombardiert Gitea mit Requests, was zu Timeouts führt.
+
+**Lösung:**
+- ✅ Runner ist registriert (`data/.runner` existiert)
+- ✅ Registration Token ist in `.env` konfiguriert
+- ⏸️ Runner Container sind gestoppt (korrekt, bis Deployment abgeschlossen)
+
+**Runner starten (nach Cache-Aktivierung):**
+```bash
+cd deployment/gitea-runner
+docker compose up -d
+```
+
+## Nächste Schritte
+
+### 1. Gitea Caching aktivieren (Priorität: Hoch)
+
+Die geänderte `docker-compose.yml` muss auf den Server synchronisiert werden:
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/sync-stacks.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+Dann Gitea neu starten:
+
+```bash
+cd deployment/ansible
+ansible-playbook -i inventory/production.yml \
+  playbooks/restart-gitea-with-cache.yml \
+  --vault-password-file secrets/.vault_pass
+```
+
+### 2. Git Push erneut versuchen
+
+Nach erfolgreicher Cache-Aktivierung und Gitea-Neustart:
+
+```bash
+cd /home/michael/dev/michaelschiemer
+git push origin staging
+```
+
+### 3. Pipeline beobachten
+
+Nach erfolgreichem Push:
+- Gitea Actions UI: `https://git.michaelschiemer.de/michael/michaelschiemer/actions`
+- Jobs beobachten: `changes`, `test`, `build`, `deploy-staging`
+- Deployment verifizieren
+
+### 4. Production Pipeline Test
+
+Nach erfolgreichem Staging-Test:
+- Test-Commit auf `main` Branch erstellen
+- Push zu `main`
+- Production Pipeline beobachten
+- Deployment verifizieren
+
+## Referenz
+
+- [Gitea Cache Aktivierung](./gitea-cache-activation.md)
+- [Pipeline Test Checklist](../guides/pipeline-test-checklist.md)
+- [Pipeline Testing Guide](../guides/pipeline-testing-guide.md)
+- [CI/CD Status](./ci-cd-status.md)
+
diff --git a/deployment/docs/status/staging-implementation-status.md b/deployment/docs/status/staging-implementation-status.md
new file mode 100644
index 00000000..fc4ba07b
--- /dev/null
+++ b/deployment/docs/status/staging-implementation-status.md
@@ -0,0 +1,168 @@
+# Staging-Implementation Status
+
+**Datum**: 2025-01-31  
+**Status**: ✅ Implementierung abgeschlossen - Bereit für Tests
+
+## ✅ Abgeschlossene Aufgaben
+
+### Phase 1: Separate Datenbank-Stacks ✅
+
+- ✅ `deployment/stacks/postgresql-production/` erstellt
+  - `docker-compose.yml` mit postgres-production Container
+  - `README.md` mit vollständiger Dokumentation
+  - Separate Networks (`postgres-production-internal`)
+  - Separate Volumes (`postgres-production-data`)
+  - Backup-Konfiguration
+
+- ✅ `deployment/stacks/postgresql-staging/` erstellt
+  - `docker-compose.yml` mit postgres-staging Container
+  - `README.md` mit vollständiger Dokumentation
+  - Separate Networks (`postgres-staging-internal`)
+  - Separate Volumes (`postgres-staging-data`)
+  - Backup-Konfiguration (kürzere Retention: 3 Tage)
+
+### Phase 2: Application-Stacks angepasst ✅
+
+- ✅ `docker-compose.staging.yml` aktualisiert
+  - `DB_HOST=postgres-staging`
+  - Network `postgres-staging-internal` hinzugefügt
+  - Alle Services (staging-app, staging-queue-worker, staging-scheduler) verbunden
+
+- ✅ `docker-compose.postgres-override.yml` aktualisiert
+  - Network `postgres-production-internal` für Production
+  - Services (php, queue-worker, scheduler) verbunden
+
+- ✅ `docker-compose.staging-postgres-override.yml` aktualisiert
+  - Network `postgres-staging-internal` für Staging
+
+### Phase 3: Ansible-Integration ✅
+
+- ✅ `deployment/ansible/roles/postgresql-production/` erstellt
+  - Tasks für Production-Datenbank-Deployment
+  - Separate Variablen und Defaults
+
+- ✅ `deployment/ansible/roles/postgresql-staging/` erstellt
+  - Tasks für Staging-Datenbank-Deployment
+  - Separate Variablen und Defaults
+
+- ✅ `deployment/ansible/playbooks/setup-staging.yml` erstellt
+  - Deployed PostgreSQL-Staging Stack
+  - Deployed Staging Application Stack
+  - Verifizierung und Health-Checks
+
+- ✅ `deployment/ansible/inventory/group_vars/staging/vars.yml` erstellt
+  - Staging-spezifische Variablen
+  - `db_host_default: "postgres-staging"`
+  - `db_name_default: "michaelschiemer_staging"`
+
+- ✅ `deployment/ansible/playbooks/setup-infrastructure.yml` erweitert
+  - Production-Stack-Deployment mit korrekten Variablen
+  - Nutzt `postgresql-production` Role
+
+### Phase 4: CI/CD-Workflow ✅
+
+- ✅ Workflow bereits vorhanden (`.gitea/workflows/build-image.yml`)
+- ✅ Health-Checks erweitert für beide Environments
+- ✅ Keine Änderungen nötig - nutzt bereits korrekte Konfiguration
+
+### Phase 5: Dokumentation ✅
+
+- ✅ `deployment/stacks/postgresql-production/README.md` erstellt
+- ✅ `deployment/stacks/postgresql-staging/README.md` erstellt
+- ✅ `deployment/stacks/staging/README.md` aktualisiert
+- ✅ `deployment/stacks/production/README.md` aktualisiert
+- ✅ `deployment/docs/guides/migrate-to-separate-databases.md` erstellt
+- ✅ `deployment/docs/guides/staging-test-plan.md` erstellt
+- ✅ `deployment/docs/guides/production-database-connection.md` erstellt
+- ✅ `deployment/docs/guides/deployment-commands.md` aktualisiert
+
+### Phase 6: Code-Anpassungen ✅
+
+- ✅ `deployment/ansible/templates/application.env.j2` aktualisiert
+  - Automatische DB_HOST-Erkennung basierend auf `app_env`
+  - Unterstützt `db_host_default` Variable
+
+- ✅ `deployment/ansible/roles/application/tasks/sync.yml` erweitert
+  - Separate Passwort-Extraktion für Production/Staging
+  - `db_host` und `app_env` Variablen für Template
+
+- ✅ `deployment/ansible/inventory/group_vars/production/vars.yml` erweitert
+  - `db_host_default: "postgres-production"` hinzugefügt
+
+## ⚠️ Ausstehend: Testing
+
+### Phase 6: Testing & Verifikation
+
+- ⏳ **Staging-End-to-End-Test** (NÄCHSTER SCHRITT)
+  - [ ] PostgreSQL-Staging Stack auf Server starten
+  - [ ] Staging-Application Stack deployen
+  - [ ] Datenbank-Verbindung testen
+  - [ ] Application funktioniert korrekt
+  - [ ] Health-Checks erfolgreich
+
+- ⏳ **Production-Verifikation**
+  - [ ] Production-Stack nutzt `postgres-production`
+  - [ ] Migration von alter Datenbank (falls nötig)
+  - [ ] Rollback-Plan testen
+
+## 📋 Test-Checkliste
+
+### Vor dem Testen
+
+- [ ] SSH-Zugriff auf Production-Server
+- [ ] Ansible installiert und konfiguriert
+- [ ] Docker und Docker Compose auf Server installiert
+- [ ] Gitea Actions Runner läuft
+- [ ] Vault-Passwort verfügbar (für Ansible)
+
+### Während des Testens
+
+- [ ] PostgreSQL-Production Stack startet erfolgreich
+- [ ] PostgreSQL-Staging Stack startet erfolgreich
+- [ ] Networks werden korrekt erstellt
+- [ ] Application-Container können Datenbank erreichen
+- [ ] Health-Checks funktionieren
+- [ ] CI/CD-Workflow deployed erfolgreich
+
+### Nach dem Testen
+
+- [ ] Alle Container laufen stabil
+- [ ] Datenbank-Isolation funktioniert (Staging kann nicht auf Production-DB zugreifen)
+- [ ] Backups funktionieren für beide Datenbanken
+- [ ] Monitoring zeigt beide Datenbanken an
+
+## 🚀 Nächste Schritte
+
+1. **Testen auf Server** (siehe `deployment/docs/guides/staging-test-plan.md`)
+   - Phase 1: PostgreSQL-Stacks manuell starten
+   - Phase 2: Networks verifizieren
+   - Phase 3: Ansible-Setup ausführen
+   - Phase 4: CI/CD-Workflow testen
+
+2. **Production-Migration** (falls nötig)
+   - Backup erstellen
+   - Datenbank migrieren
+   - Application-Stack aktualisieren
+
+3. **Monitoring einrichten**
+   - Beide Datenbanken überwachen
+   - Alerts konfigurieren
+
+## 📊 Implementierungs-Statistik
+
+- **Erstellte Dateien**: 21
+- **Geänderte Dateien**: 10+
+- **Dokumentations-Seiten**: 5
+- **Ansible-Roles**: 2 neue
+- **Docker Compose Stacks**: 2 neue
+
+## ✅ Erfolgskriterien
+
+- ✅ Separate Datenbank-Stacks erstellt
+- ✅ Network-Isolation konfiguriert
+- ✅ Ansible-Integration vollständig
+- ✅ Dokumentation komplett
+- ⏳ Tests erfolgreich (ausstehend)
+
+**Status**: Bereit für Deployment und Tests! 🚀
+
diff --git a/deployment/docs/tests/README.md b/deployment/docs/tests/README.md
new file mode 100644
index 00000000..1595e506
--- /dev/null
+++ b/deployment/docs/tests/README.md
@@ -0,0 +1,26 @@
+# Test-Dokumentation
+
+Dieses Verzeichnis enthält historische Test-Dokumentationen für verschiedene Deployment-Szenarien.
+
+## Status
+
+Die meisten Dokumentationen in diesem Verzeichnis sind **veraltet** und beziehen sich auf alte Deployment-Pfade (`stacks/application` statt `stacks/production`).
+
+## Aktuelle Test-Prozesse
+
+Für aktuelle Test-Prozesse siehe:
+- **[deployment/docs/guides/deployment-commands.md](../guides/deployment-commands.md)** - Aktuelle Deployment-Befehle
+- **[deployment/README.md](../../README.md)** - Haupt-Dokumentation mit Quick Start
+
+## Historische Dokumentationen
+
+Die folgenden Dateien sind historisch und können als Referenz dienen:
+- `quick-test.md` - Schnelle Test-Anleitung (veraltet)
+- `git-deployment-test.md` - Git-Deployment Tests (veraltet)
+- `test-git-deployment.md` - Weitere Git-Deployment Tests (veraltet)
+- `git-deployment-issue.md` - Problem-Dokumentation (veraltet)
+- `recommended-test-flow.md` - Empfohlener Test-Workflow (veraltet)
+- `test-results.md` - Test-Ergebnisse (veraltet)
+
+**Hinweis:** Diese Dokumentationen verweisen auf alte Pfade und sollten nicht mehr direkt verwendet werden.
+
diff --git a/deployment/gitea-runner/config.yaml b/deployment/gitea-runner/config.yaml
index 7a93f94b..5ea21cc1 100644
--- a/deployment/gitea-runner/config.yaml
+++ b/deployment/gitea-runner/config.yaml
@@ -18,11 +18,13 @@ runner:
   insecure: true
 
   # Timeout for fetching job from Gitea
-  fetch_timeout: 30s
+  # Increased to reduce load on Gitea and prevent timeouts
+  fetch_timeout: 60s
 
   # Interval for fetching jobs (increased to reduce load on Gitea)
   # Lower values cause DDoS-like behavior when Gitea is slow or overloaded
-  fetch_interval: 10s
+  # Standard: 2s → Optimized: 30s to prevent Gitea overload
+  fetch_interval: 30s
 
 cache:
   # Enable cache server
diff --git a/deployment/scripts/README.md b/deployment/scripts/README.md
new file mode 100644
index 00000000..d7d0fa43
--- /dev/null
+++ b/deployment/scripts/README.md
@@ -0,0 +1,128 @@
+# Deployment Scripts
+
+Sammlung von nützlichen Scripts für Deployment und Wartung.
+
+## Quick-Start Scripts
+
+### staging-quick-start.sh
+
+Interaktives Script für Staging-Deployment-Aufgaben.
+
+**Verwendung**:
+```bash
+cd ~/deployment
+./scripts/staging-quick-start.sh
+```
+
+**Funktionen**:
+- PostgreSQL-Staging Stack starten
+- PostgreSQL-Production Stack starten
+- Networks prüfen
+- Container-Status anzeigen
+- Datenbank-Verbindungen testen
+- Health-Checks durchführen
+- Logs anzeigen
+
+**Beispiel**:
+```bash
+# Auf Production-Server
+cd ~/deployment
+./scripts/staging-quick-start.sh
+
+# Wähle Option 3: Beide PostgreSQL-Stacks starten
+# Wähle Option 10: Alles verifizieren
+```
+
+### production-quick-start.sh
+
+Interaktives Script für Production-Deployment-Aufgaben.
+
+**Verwendung**:
+```bash
+cd ~/deployment
+./scripts/production-quick-start.sh
+```
+
+**Funktionen**:
+- PostgreSQL-Production Stack starten
+- Networks prüfen
+- Container-Status anzeigen
+- Datenbank-Verbindungen testen
+- Health-Checks durchführen
+- Logs anzeigen
+
+## Test-Scripts
+
+### test-pipeline-prerequisites.sh
+
+Prüft alle Voraussetzungen für CI/CD Pipeline-Tests.
+
+**Verwendung:**
+```bash
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-pipeline-prerequisites.sh
+```
+
+**Prüft:**
+- Gitea Runner Status
+- Workflow-Dateien
+- Ansible Playbooks
+- Docker Compose Files
+- Dockerfile
+- SSH Configuration
+- Docker Registry Access
+- Git Repository Configuration
+
+**Ausgabe:**
+- ✓ Grüne Checks für erfolgreiche Prüfungen
+- ✗ Rote Checks für Fehler
+- ⚠ Gelbe Warnungen für optionale Probleme
+
+### test-backup.sh
+
+Führt ein Test-Backup aus und verifiziert die Ergebnisse.
+
+**Verwendung:**
+```bash
+cd /home/michael/dev/michaelschiemer
+./deployment/scripts/test-backup.sh
+```
+
+**Führt aus:**
+- Backup-Playbook mit Test-Konfiguration
+- Backup-Verifikation
+- Zeigt Backup-Location und nächste Schritte
+
+**Nach dem Test:**
+```bash
+# Auf Server verifizieren
+ssh deploy@94.16.110.151
+ls -lh ~/deployment/backups/backup_*/
+cat ~/deployment/backups/backup_*/backup_metadata.txt
+```
+
+## Weitere Scripts
+
+Weitere nützliche Scripts können hier hinzugefügt werden:
+- Rollback-Scripts
+- Monitoring-Scripts
+- Cleanup-Scripts
+
+## Voraussetzungen
+
+- Docker und Docker Compose installiert
+- Bash Shell
+- Zugriff auf Production-Server
+- Stacks im erwarteten Pfad: `~/deployment/stacks/`
+
+## Konfiguration
+
+Scripts nutzen folgende Umgebungsvariablen (optional):
+- `STACKS_BASE_PATH`: Basis-Pfad für Stacks (Standard: `~/deployment/stacks`)
+
+**Beispiel**:
+```bash
+export STACKS_BASE_PATH=/opt/deployment/stacks
+./scripts/staging-quick-start.sh
+```
+
diff --git a/deployment/scripts/production-quick-start.sh b/deployment/scripts/production-quick-start.sh
new file mode 100755
index 00000000..14687006
--- /dev/null
+++ b/deployment/scripts/production-quick-start.sh
@@ -0,0 +1,319 @@
+#!/bin/bash
+# Production Quick-Start Script
+# Automatisiert häufige Production-Deployment-Aufgaben
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+STACKS_BASE_PATH="${STACKS_BASE_PATH:-~/deployment/stacks}"
+POSTGRESQL_PRODUCTION_PATH="${STACKS_BASE_PATH}/postgresql-production"
+PRODUCTION_STACK_PATH="${STACKS_BASE_PATH}/production"
+
+# Functions
+print_header() {
+    echo ""
+    echo -e "${BLUE}========================================${NC}"
+    echo -e "${BLUE}$1${NC}"
+    echo -e "${BLUE}========================================${NC}"
+    echo ""
+}
+
+print_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+print_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+check_docker() {
+    if ! command -v docker &> /dev/null; then
+        print_error "Docker ist nicht installiert oder nicht im PATH"
+        exit 1
+    fi
+    
+    if ! docker ps &> /dev/null; then
+        print_error "Docker daemon läuft nicht oder keine Berechtigung"
+        exit 1
+    fi
+    
+    print_success "Docker ist verfügbar"
+}
+
+check_networks() {
+    print_header "Networks prüfen"
+    
+    local networks=("traefik-public" "postgres-production-internal" "app-internal")
+    local all_exist=true
+    
+    for network in "${networks[@]}"; do
+        if docker network inspect "$network" &> /dev/null; then
+            print_success "Network '$network' existiert"
+        else
+            print_warning "Network '$network' existiert nicht"
+            all_exist=false
+        fi
+    done
+    
+    if [ "$all_exist" = false ]; then
+        print_info "Fehlende Networks werden beim Stack-Start automatisch erstellt"
+    fi
+}
+
+start_postgresql_production() {
+    print_header "PostgreSQL-Production Stack starten"
+    
+    if [ ! -d "$POSTGRESQL_PRODUCTION_PATH" ]; then
+        print_error "PostgreSQL-Production Stack nicht gefunden: $POSTGRESQL_PRODUCTION_PATH"
+        return 1
+    fi
+    
+    cd "$POSTGRESQL_PRODUCTION_PATH"
+    
+    # Check if .env exists
+    if [ ! -f ".env" ]; then
+        print_warning ".env-Datei nicht gefunden. Erstelle Beispiel-Konfiguration..."
+        cat > .env <<EOF
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=CHANGE_ME_STRONG_PASSWORD
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
+EOF
+        print_warning "Bitte POSTGRES_PASSWORD in .env anpassen!"
+        return 1
+    fi
+    
+    print_info "Starte PostgreSQL-Production Stack..."
+    docker compose up -d
+    
+    # Wait for PostgreSQL to be ready
+    print_info "Warte auf PostgreSQL-Production..."
+    local max_attempts=30
+    local attempt=0
+    
+    while [ $attempt -lt $max_attempts ]; do
+        if docker exec postgres-production pg_isready -U postgres -d michaelschiemer &> /dev/null; then
+            print_success "PostgreSQL-Production ist bereit"
+            return 0
+        fi
+        attempt=$((attempt + 1))
+        sleep 2
+    done
+    
+    print_error "PostgreSQL-Production ist nicht bereit nach $max_attempts Versuchen"
+    return 1
+}
+
+verify_connections() {
+    print_header "Datenbank-Verbindungen verifizieren"
+    
+    # Check Production
+    if docker ps | grep -q postgres-production; then
+        print_info "Teste Production-Datenbank-Verbindung..."
+        if docker exec postgres-production pg_isready -U postgres -d michaelschiemer &> /dev/null; then
+            print_success "PostgreSQL-Production erreichbar"
+        else
+            print_error "PostgreSQL-Production nicht erreichbar"
+        fi
+    else
+        print_warning "PostgreSQL-Production Container läuft nicht"
+    fi
+}
+
+show_status() {
+    print_header "Container-Status"
+    
+    echo "PostgreSQL-Production Container:"
+    docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "postgres-production" || echo "Keine PostgreSQL-Production Container gefunden"
+    
+    echo ""
+    echo "Production Application Container:"
+    docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "^(app|php|queue-worker|scheduler|nginx)" || echo "Keine Production-Container gefunden"
+}
+
+show_logs() {
+    local container=$1
+    local lines=${2:-50}
+    
+    if docker ps --format "{{.Names}}" | grep -q "^${container}$"; then
+        print_header "Logs: $container (letzte $lines Zeilen)"
+        docker logs --tail "$lines" "$container"
+    else
+        print_warning "Container '$container' läuft nicht"
+    fi
+}
+
+test_production_connection() {
+    print_header "Production-Datenbank-Verbindung testen"
+    
+    local app_container="php"
+    if ! docker ps --format "{{.Names}}" | grep -q "^${app_container}$"; then
+        # Try alternative names
+        app_container=$(docker ps --format "{{.Names}}" | grep -E "^(app|php)" | head -1)
+        if [ -z "$app_container" ]; then
+            print_warning "Production Application Container läuft nicht"
+            return 1
+        fi
+    fi
+    
+    print_info "Teste Verbindung von $app_container zu postgres-production..."
+    
+    # Test network connectivity
+    if docker exec "$app_container" nc -zv postgres-production 5432 &> /dev/null; then
+        print_success "Network-Verbindung zu postgres-production erfolgreich"
+    else
+        print_error "Network-Verbindung zu postgres-production fehlgeschlagen"
+        print_info "Prüfe, ob $app_container im postgres-production-internal Network ist"
+        return 1
+    fi
+    
+    # Test database connection
+    print_info "Teste Datenbank-Verbindung..."
+    if docker exec "$app_container" php -r "
+        \$host = getenv('DB_HOST') ?: 'postgres-production';
+        \$db = getenv('DB_DATABASE') ?: 'michaelschiemer';
+        \$user = getenv('DB_USERNAME') ?: 'postgres';
+        \$pass = getenv('DB_PASSWORD') ?: file_get_contents(getenv('DB_PASSWORD_FILE') ?: '/dev/null');
+        if (!\$pass) {
+            echo 'DB_PASSWORD nicht verfügbar\n';
+            exit(1);
+        }
+        try {
+            \$dsn = \"pgsql:host=\$host;port=5432;dbname=\$db\";
+            \$pdo = new PDO(\$dsn, \$user, trim(\$pass));
+            echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn() . \"\n\";
+            exit(0);
+        } catch (Exception \$e) {
+            echo 'Connection failed: ' . \$e->getMessage() . \"\n\";
+            exit(1);
+        }
+    " 2>&1; then
+        print_success "Datenbank-Verbindung erfolgreich"
+    else
+        print_warning "Datenbank-Verbindungstest fehlgeschlagen (DB_PASSWORD möglicherweise nicht gesetzt)"
+    fi
+}
+
+health_check() {
+    print_header "Health-Checks"
+    
+    # Basic health check
+    print_info "Basic Health Check: https://michaelschiemer.de/health"
+    if curl -f -k -s https://michaelschiemer.de/health > /dev/null 2>&1; then
+        print_success "Basic Health Check erfolgreich"
+    else
+        print_warning "Basic Health Check fehlgeschlagen (Service möglicherweise nicht verfügbar)"
+    fi
+    
+    # Extended health check
+    print_info "Extended Health Check: https://michaelschiemer.de/admin/health/api/summary"
+    local health_summary=$(curl -f -k -s https://michaelschiemer.de/admin/health/api/summary 2>/dev/null || echo "")
+    if [ -n "$health_summary" ]; then
+        local overall_status=$(echo "$health_summary" | grep -o '"overall_status":"[^"]*"' | cut -d'"' -f4 || echo "unknown")
+        print_info "Overall Health Status: $overall_status"
+        if [ "$overall_status" = "healthy" ]; then
+            print_success "Extended Health Check erfolgreich"
+        else
+            print_warning "Extended Health Check zeigt: $overall_status"
+        fi
+    else
+        print_warning "Extended Health Check Endpoint nicht verfügbar"
+    fi
+}
+
+# Main menu
+show_menu() {
+    echo ""
+    echo -e "${BLUE}========================================${NC}"
+    echo -e "${BLUE}  Production Quick-Start Script${NC}"
+    echo -e "${BLUE}========================================${NC}"
+    echo ""
+    echo "1) PostgreSQL-Production Stack starten"
+    echo "2) Networks prüfen"
+    echo "3) Container-Status anzeigen"
+    echo "4) Production-Datenbank-Verbindung testen"
+    echo "5) Health-Checks durchführen"
+    echo "6) Logs anzeigen (PostgreSQL-Production)"
+    echo "7) Logs anzeigen (Production App)"
+    echo "8) Alles verifizieren"
+    echo "0) Beenden"
+    echo ""
+    read -p "Wähle eine Option: " choice
+}
+
+# Main execution
+main() {
+    print_header "Production Quick-Start Script"
+    
+    check_docker
+    
+    while true; do
+        show_menu
+        
+        case $choice in
+            1)
+                start_postgresql_production
+                ;;
+            2)
+                check_networks
+                ;;
+            3)
+                show_status
+                ;;
+            4)
+                test_production_connection
+                ;;
+            5)
+                health_check
+                ;;
+            6)
+                show_logs "postgres-production" 50
+                ;;
+            7)
+                local app_container=$(docker ps --format "{{.Names}}" | grep -E "^(app|php)" | head -1)
+                if [ -n "$app_container" ]; then
+                    show_logs "$app_container" 50
+                else
+                    print_warning "Production Application Container läuft nicht"
+                fi
+                ;;
+            8)
+                check_networks
+                verify_connections
+                show_status
+                test_production_connection
+                health_check
+                ;;
+            0)
+                print_info "Beende..."
+                exit 0
+                ;;
+            *)
+                print_error "Ungültige Option"
+                ;;
+        esac
+        
+        echo ""
+        read -p "Drücke Enter um fortzufahren..."
+    done
+}
+
+# Run main function
+main "$@"
+
diff --git a/deployment/scripts/staging-quick-start.sh b/deployment/scripts/staging-quick-start.sh
new file mode 100755
index 00000000..9e85eb00
--- /dev/null
+++ b/deployment/scripts/staging-quick-start.sh
@@ -0,0 +1,376 @@
+#!/bin/bash
+# Staging Quick-Start Script
+# Automatisiert häufige Staging-Deployment-Aufgaben
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+STACKS_BASE_PATH="${STACKS_BASE_PATH:-~/deployment/stacks}"
+POSTGRESQL_PRODUCTION_PATH="${STACKS_BASE_PATH}/postgresql-production"
+POSTGRESQL_STAGING_PATH="${STACKS_BASE_PATH}/postgresql-staging"
+STAGING_STACK_PATH="${STACKS_BASE_PATH}/staging"
+
+# Functions
+print_header() {
+    echo ""
+    echo -e "${BLUE}========================================${NC}"
+    echo -e "${BLUE}$1${NC}"
+    echo -e "${BLUE}========================================${NC}"
+    echo ""
+}
+
+print_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+print_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+check_docker() {
+    if ! command -v docker &> /dev/null; then
+        print_error "Docker ist nicht installiert oder nicht im PATH"
+        exit 1
+    fi
+    
+    if ! docker ps &> /dev/null; then
+        print_error "Docker daemon läuft nicht oder keine Berechtigung"
+        exit 1
+    fi
+    
+    print_success "Docker ist verfügbar"
+}
+
+check_networks() {
+    print_header "Networks prüfen"
+    
+    local networks=("traefik-public" "staging-internal" "postgres-staging-internal" "postgres-production-internal" "app-internal")
+    local all_exist=true
+    
+    for network in "${networks[@]}"; do
+        if docker network inspect "$network" &> /dev/null; then
+            print_success "Network '$network' existiert"
+        else
+            print_warning "Network '$network' existiert nicht"
+            all_exist=false
+        fi
+    done
+    
+    if [ "$all_exist" = false ]; then
+        print_info "Fehlende Networks werden beim Stack-Start automatisch erstellt"
+    fi
+}
+
+start_postgresql_production() {
+    print_header "PostgreSQL-Production Stack starten"
+    
+    if [ ! -d "$POSTGRESQL_PRODUCTION_PATH" ]; then
+        print_error "PostgreSQL-Production Stack nicht gefunden: $POSTGRESQL_PRODUCTION_PATH"
+        return 1
+    fi
+    
+    cd "$POSTGRESQL_PRODUCTION_PATH"
+    
+    # Check if .env exists
+    if [ ! -f ".env" ]; then
+        print_warning ".env-Datei nicht gefunden. Erstelle Beispiel-Konfiguration..."
+        cat > .env <<EOF
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=CHANGE_ME_STRONG_PASSWORD
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
+EOF
+        print_warning "Bitte POSTGRES_PASSWORD in .env anpassen!"
+        return 1
+    fi
+    
+    print_info "Starte PostgreSQL-Production Stack..."
+    docker compose up -d
+    
+    # Wait for PostgreSQL to be ready
+    print_info "Warte auf PostgreSQL-Production..."
+    local max_attempts=30
+    local attempt=0
+    
+    while [ $attempt -lt $max_attempts ]; do
+        if docker exec postgres-production pg_isready -U postgres -d michaelschiemer &> /dev/null; then
+            print_success "PostgreSQL-Production ist bereit"
+            return 0
+        fi
+        attempt=$((attempt + 1))
+        sleep 2
+    done
+    
+    print_error "PostgreSQL-Production ist nicht bereit nach $max_attempts Versuchen"
+    return 1
+}
+
+start_postgresql_staging() {
+    print_header "PostgreSQL-Staging Stack starten"
+    
+    if [ ! -d "$POSTGRESQL_STAGING_PATH" ]; then
+        print_error "PostgreSQL-Staging Stack nicht gefunden: $POSTGRESQL_STAGING_PATH"
+        return 1
+    fi
+    
+    cd "$POSTGRESQL_STAGING_PATH"
+    
+    # Check if .env exists
+    if [ ! -f ".env" ]; then
+        print_warning ".env-Datei nicht gefunden. Erstelle Beispiel-Konfiguration..."
+        cat > .env <<EOF
+POSTGRES_DB=michaelschiemer_staging
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=CHANGE_ME_STRONG_PASSWORD
+BACKUP_RETENTION_DAYS=3
+BACKUP_SCHEDULE=0 3 * * *
+EOF
+        print_warning "Bitte POSTGRES_PASSWORD in .env anpassen!"
+        return 1
+    fi
+    
+    print_info "Starte PostgreSQL-Staging Stack..."
+    docker compose up -d
+    
+    # Wait for PostgreSQL to be ready
+    print_info "Warte auf PostgreSQL-Staging..."
+    local max_attempts=30
+    local attempt=0
+    
+    while [ $attempt -lt $max_attempts ]; do
+        if docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging &> /dev/null; then
+            print_success "PostgreSQL-Staging ist bereit"
+            return 0
+        fi
+        attempt=$((attempt + 1))
+        sleep 2
+    done
+    
+    print_error "PostgreSQL-Staging ist nicht bereit nach $max_attempts Versuchen"
+    return 1
+}
+
+verify_connections() {
+    print_header "Datenbank-Verbindungen verifizieren"
+    
+    # Check Production
+    if docker ps | grep -q postgres-production; then
+        print_info "Teste Production-Datenbank-Verbindung..."
+        if docker exec postgres-production pg_isready -U postgres -d michaelschiemer &> /dev/null; then
+            print_success "PostgreSQL-Production erreichbar"
+        else
+            print_error "PostgreSQL-Production nicht erreichbar"
+        fi
+    else
+        print_warning "PostgreSQL-Production Container läuft nicht"
+    fi
+    
+    # Check Staging
+    if docker ps | grep -q postgres-staging; then
+        print_info "Teste Staging-Datenbank-Verbindung..."
+        if docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging &> /dev/null; then
+            print_success "PostgreSQL-Staging erreichbar"
+        else
+            print_error "PostgreSQL-Staging nicht erreichbar"
+        fi
+    else
+        print_warning "PostgreSQL-Staging Container läuft nicht"
+    fi
+}
+
+show_status() {
+    print_header "Container-Status"
+    
+    echo "PostgreSQL-Container:"
+    docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "(postgres-production|postgres-staging)" || echo "Keine PostgreSQL-Container gefunden"
+    
+    echo ""
+    echo "Staging-Container:"
+    docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "staging-" || echo "Keine Staging-Container gefunden"
+}
+
+show_logs() {
+    local container=$1
+    local lines=${2:-50}
+    
+    if docker ps --format "{{.Names}}" | grep -q "^${container}$"; then
+        print_header "Logs: $container (letzte $lines Zeilen)"
+        docker logs --tail "$lines" "$container"
+    else
+        print_warning "Container '$container' läuft nicht"
+    fi
+}
+
+test_staging_connection() {
+    print_header "Staging-Datenbank-Verbindung testen"
+    
+    if ! docker ps | grep -q staging-app; then
+        print_warning "staging-app Container läuft nicht"
+        return 1
+    fi
+    
+    print_info "Teste Verbindung von staging-app zu postgres-staging..."
+    
+    # Test network connectivity
+    if docker exec staging-app nc -zv postgres-staging 5432 &> /dev/null; then
+        print_success "Network-Verbindung zu postgres-staging erfolgreich"
+    else
+        print_error "Network-Verbindung zu postgres-staging fehlgeschlagen"
+        print_info "Prüfe, ob staging-app im postgres-staging-internal Network ist"
+        return 1
+    fi
+    
+    # Test database connection (if DB_PASSWORD is available)
+    print_info "Teste Datenbank-Verbindung..."
+    if docker exec staging-app php -r "
+        \$host = getenv('DB_HOST') ?: 'postgres-staging';
+        \$db = getenv('DB_DATABASE') ?: 'michaelschiemer_staging';
+        \$user = getenv('DB_USERNAME') ?: 'postgres';
+        \$pass = getenv('DB_PASSWORD') ?: file_get_contents(getenv('DB_PASSWORD_FILE') ?: '/dev/null');
+        if (!\$pass) {
+            echo 'DB_PASSWORD nicht verfügbar\n';
+            exit(1);
+        }
+        try {
+            \$dsn = \"pgsql:host=\$host;port=5432;dbname=\$db\";
+            \$pdo = new PDO(\$dsn, \$user, trim(\$pass));
+            echo 'Connection successful: ' . \$pdo->query('SELECT version()')->fetchColumn() . \"\n\";
+            exit(0);
+        } catch (Exception \$e) {
+            echo 'Connection failed: ' . \$e->getMessage() . \"\n\";
+            exit(1);
+        }
+    " 2>&1; then
+        print_success "Datenbank-Verbindung erfolgreich"
+    else
+        print_warning "Datenbank-Verbindungstest fehlgeschlagen (DB_PASSWORD möglicherweise nicht gesetzt)"
+    fi
+}
+
+health_check() {
+    print_header "Health-Checks"
+    
+    # Basic health check
+    print_info "Basic Health Check: https://staging.michaelschiemer.de/health"
+    if curl -f -k -s https://staging.michaelschiemer.de/health > /dev/null 2>&1; then
+        print_success "Basic Health Check erfolgreich"
+    else
+        print_warning "Basic Health Check fehlgeschlagen (Service möglicherweise nicht verfügbar)"
+    fi
+    
+    # Extended health check
+    print_info "Extended Health Check: https://staging.michaelschiemer.de/admin/health/api/summary"
+    local health_summary=$(curl -f -k -s https://staging.michaelschiemer.de/admin/health/api/summary 2>/dev/null || echo "")
+    if [ -n "$health_summary" ]; then
+        local overall_status=$(echo "$health_summary" | grep -o '"overall_status":"[^"]*"' | cut -d'"' -f4 || echo "unknown")
+        print_info "Overall Health Status: $overall_status"
+        if [ "$overall_status" = "healthy" ]; then
+            print_success "Extended Health Check erfolgreich"
+        else
+            print_warning "Extended Health Check zeigt: $overall_status"
+        fi
+    else
+        print_warning "Extended Health Check Endpoint nicht verfügbar"
+    fi
+}
+
+# Main menu
+show_menu() {
+    echo ""
+    echo -e "${BLUE}========================================${NC}"
+    echo -e "${BLUE}  Staging Quick-Start Script${NC}"
+    echo -e "${BLUE}========================================${NC}"
+    echo ""
+    echo "1) PostgreSQL-Production Stack starten"
+    echo "2) PostgreSQL-Staging Stack starten"
+    echo "3) Beide PostgreSQL-Stacks starten"
+    echo "4) Networks prüfen"
+    echo "5) Container-Status anzeigen"
+    echo "6) Staging-Datenbank-Verbindung testen"
+    echo "7) Health-Checks durchführen"
+    echo "8) Logs anzeigen (PostgreSQL-Staging)"
+    echo "9) Logs anzeigen (staging-app)"
+    echo "10) Alles verifizieren"
+    echo "0) Beenden"
+    echo ""
+    read -p "Wähle eine Option: " choice
+}
+
+# Main execution
+main() {
+    print_header "Staging Quick-Start Script"
+    
+    check_docker
+    
+    while true; do
+        show_menu
+        
+        case $choice in
+            1)
+                start_postgresql_production
+                ;;
+            2)
+                start_postgresql_staging
+                ;;
+            3)
+                start_postgresql_production
+                start_postgresql_staging
+                ;;
+            4)
+                check_networks
+                ;;
+            5)
+                show_status
+                ;;
+            6)
+                test_staging_connection
+                ;;
+            7)
+                health_check
+                ;;
+            8)
+                show_logs "postgres-staging" 50
+                ;;
+            9)
+                show_logs "staging-app" 50
+                ;;
+            10)
+                check_networks
+                verify_connections
+                show_status
+                test_staging_connection
+                health_check
+                ;;
+            0)
+                print_info "Beende..."
+                exit 0
+                ;;
+            *)
+                print_error "Ungültige Option"
+                ;;
+        esac
+        
+        echo ""
+        read -p "Drücke Enter um fortzufahren..."
+    done
+}
+
+# Run main function
+main "$@"
+
diff --git a/deployment/scripts/test-backup.sh b/deployment/scripts/test-backup.sh
new file mode 100755
index 00000000..eeb6ddb9
--- /dev/null
+++ b/deployment/scripts/test-backup.sh
@@ -0,0 +1,61 @@
+#!/bin/bash
+# Test Backup Playbook
+# Führt ein Test-Backup aus und verifiziert die Ergebnisse
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ANSIBLE_DIR="$SCRIPT_DIR/../ansible"
+
+echo "=========================================="
+echo "Backup Playbook Test"
+echo "=========================================="
+echo ""
+
+# Check if we're in the right directory
+if [ ! -f "$ANSIBLE_DIR/playbooks/backup.yml" ]; then
+    echo "Error: backup.yml not found at $ANSIBLE_DIR/playbooks/backup.yml"
+    exit 1
+fi
+
+# Check if inventory exists
+if [ ! -f "$ANSIBLE_DIR/inventory/production.yml" ]; then
+    echo "Error: production.yml inventory not found"
+    exit 1
+fi
+
+# Check if vault password file exists
+VAULT_PASS_FILE="$ANSIBLE_DIR/secrets/.vault_pass"
+if [ ! -f "$VAULT_PASS_FILE" ]; then
+    echo "Warning: Vault password file not found at $VAULT_PASS_FILE"
+    echo "Creating empty vault password file..."
+    touch "$VAULT_PASS_FILE"
+    chmod 600 "$VAULT_PASS_FILE"
+fi
+
+echo "Running backup playbook..."
+echo ""
+
+cd "$ANSIBLE_DIR"
+
+ansible-playbook -i inventory/production.yml \
+    playbooks/backup.yml \
+    --vault-password-file "$VAULT_PASS_FILE" \
+    -e "backup_retention_days=1" \
+    -e "verify_backups=true"
+
+echo ""
+echo "=========================================="
+echo "Backup Test Complete"
+echo "=========================================="
+echo ""
+echo "Next steps:"
+echo "1. Verify backup files were created on the server"
+echo "2. Check backup metadata file"
+echo "3. (Optional) Test restore process"
+echo ""
+echo "To verify backups on server:"
+echo "  ssh deploy@94.16.110.151"
+echo "  ls -lh ~/backups/backup_*/"
+echo "  cat ~/backups/backup_*/backup_metadata.txt"
+
diff --git a/deployment/scripts/test-pipeline-prerequisites.sh b/deployment/scripts/test-pipeline-prerequisites.sh
new file mode 100755
index 00000000..f6779b37
--- /dev/null
+++ b/deployment/scripts/test-pipeline-prerequisites.sh
@@ -0,0 +1,230 @@
+#!/bin/bash
+# Test Pipeline Prerequisites
+# Prüft alle Voraussetzungen für CI/CD Pipeline Tests
+
+set -euo pipefail
+
+echo "=========================================="
+echo "CI/CD Pipeline Prerequisites Check"
+echo "=========================================="
+echo ""
+
+ERRORS=0
+WARNINGS=0
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+check_pass() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+check_fail() {
+    echo -e "${RED}✗${NC} $1"
+    ((ERRORS++))
+}
+
+check_warn() {
+    echo -e "${YELLOW}⚠${NC} $1"
+    ((WARNINGS++))
+}
+
+# 1. Check Gitea Runner
+echo "1. Checking Gitea Runner..."
+if [ -d "deployment/gitea-runner" ]; then
+    cd deployment/gitea-runner
+    if docker compose ps 2>/dev/null | grep -q "gitea-runner.*Up"; then
+        check_pass "Gitea Runner container is running"
+    else
+        check_fail "Gitea Runner container is not running"
+        echo "   Run: cd deployment/gitea-runner && docker compose up -d"
+    fi
+    
+    if docker compose ps 2>/dev/null | grep -q "gitea-runner-dind.*Up"; then
+        check_pass "Gitea Runner DinD container is running"
+    else
+        check_fail "Gitea Runner DinD container is not running"
+    fi
+    
+    if [ -f "data/.runner" ]; then
+        check_pass "Gitea Runner is registered (data/.runner exists)"
+    else
+        check_warn "Gitea Runner may not be registered (data/.runner missing)"
+        echo "   Run: ./register.sh"
+    fi
+    cd - > /dev/null
+else
+    check_fail "deployment/gitea-runner directory not found"
+fi
+
+echo ""
+
+# 2. Check Workflow Files
+echo "2. Checking Workflow Files..."
+if [ -f ".gitea/workflows/build-image.yml" ]; then
+    check_pass "build-image.yml workflow exists"
+else
+    check_fail ".gitea/workflows/build-image.yml not found"
+fi
+
+if [ -f ".gitea/workflows/manual-deploy.yml" ]; then
+    check_pass "manual-deploy.yml workflow exists"
+else
+    check_warn ".gitea/workflows/manual-deploy.yml not found (optional)"
+fi
+
+echo ""
+
+# 3. Check Ansible Playbooks
+echo "3. Checking Ansible Playbooks..."
+ANSIBLE_PLAYBOOKS=(
+    "deployment/ansible/playbooks/deploy-application-code.yml"
+    "deployment/ansible/playbooks/install-composer-dependencies.yml"
+    "deployment/ansible/playbooks/deploy-image.yml"
+    "deployment/ansible/playbooks/backup.yml"
+)
+
+for playbook in "${ANSIBLE_PLAYBOOKS[@]}"; do
+    if [ -f "$playbook" ]; then
+        check_pass "$(basename $playbook) exists"
+    else
+        check_fail "$playbook not found"
+    fi
+done
+
+echo ""
+
+# 4. Check Ansible Inventory
+echo "4. Checking Ansible Inventory..."
+if [ -f "deployment/ansible/inventory/production.yml" ]; then
+    check_pass "Ansible inventory file exists"
+else
+    check_fail "deployment/ansible/inventory/production.yml not found"
+fi
+
+echo ""
+
+# 5. Check Docker Compose Files
+echo "5. Checking Docker Compose Files..."
+if [ -f "deployment/stacks/production/docker-compose.base.yml" ]; then
+    check_pass "Production docker-compose.base.yml exists"
+else
+    check_fail "Production docker-compose.base.yml not found"
+fi
+
+if [ -f "deployment/stacks/production/docker-compose.production.yml" ]; then
+    check_pass "Production docker-compose.production.yml exists"
+else
+    check_fail "Production docker-compose.production.yml not found"
+fi
+
+if [ -f "deployment/stacks/staging/docker-compose.base.yml" ]; then
+    check_pass "Staging docker-compose.base.yml exists"
+else
+    check_warn "Staging docker-compose.base.yml not found (optional for staging tests)"
+fi
+
+echo ""
+
+# 6. Check Dockerfile
+echo "6. Checking Dockerfile..."
+if [ -f "Dockerfile.production" ]; then
+    check_pass "Dockerfile.production exists"
+else
+    check_fail "Dockerfile.production not found"
+fi
+
+echo ""
+
+# 7. Check SSH Key (if exists locally)
+echo "7. Checking SSH Configuration..."
+if [ -f "$HOME/.ssh/production" ] || [ -f "$HOME/.ssh/id_rsa" ] || [ -f "$HOME/.ssh/id_ed25519" ]; then
+    check_pass "SSH key found (local check only)"
+    echo "   Note: SSH_PRIVATE_KEY secret must be configured in Gitea"
+else
+    check_warn "No SSH key found locally (may be configured in Gitea secrets)"
+fi
+
+echo ""
+
+# 8. Check Registry Access (if possible)
+echo "8. Checking Docker Registry Access..."
+REGISTRY="registry.michaelschiemer.de"
+if command -v curl >/dev/null 2>&1; then
+    if curl -s -k --connect-timeout 5 "https://${REGISTRY}/v2/" >/dev/null 2>&1 || \
+       curl -s --connect-timeout 5 "http://94.16.110.151:5000/v2/" >/dev/null 2>&1; then
+        check_pass "Docker Registry is accessible"
+    else
+        check_warn "Docker Registry may not be accessible (check network/firewall)"
+    fi
+else
+    check_warn "curl not available, skipping registry check"
+fi
+
+echo ""
+
+# 9. Check Git Repository
+echo "9. Checking Git Repository..."
+if git remote get-url origin 2>/dev/null | grep -q "git.michaelschiemer.de"; then
+    check_pass "Git remote points to Gitea"
+    REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
+    echo "   Remote: $REMOTE_URL"
+else
+    check_warn "Git remote may not point to Gitea"
+    REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "not configured")
+    echo "   Remote: $REMOTE_URL"
+fi
+
+# Check for staging and main branches
+if git show-ref --verify --quiet refs/heads/staging 2>/dev/null; then
+    check_pass "staging branch exists locally"
+else
+    check_warn "staging branch not found locally (may need to fetch)"
+fi
+
+if git show-ref --verify --quiet refs/heads/main 2>/dev/null; then
+    check_pass "main branch exists locally"
+else
+    check_warn "main branch not found locally (may need to fetch)"
+fi
+
+echo ""
+
+# Summary
+echo "=========================================="
+echo "Summary"
+echo "=========================================="
+if [ $ERRORS -eq 0 ] && [ $WARNINGS -eq 0 ]; then
+    echo -e "${GREEN}✓ All checks passed!${NC}"
+    echo ""
+    echo "Next steps:"
+    echo "1. Verify Gitea Secrets are configured:"
+    echo "   https://git.michaelschiemer.de/michael/michaelschiemer/settings/secrets/actions"
+    echo ""
+    echo "2. Test Staging Pipeline:"
+    echo "   git checkout staging"
+    echo "   echo '# Test' >> README.md"
+    echo "   git commit -m 'test: CI/CD pipeline'"
+    echo "   git push origin staging"
+    echo ""
+    echo "3. Monitor Pipeline:"
+    echo "   https://git.michaelschiemer.de/michael/michaelschiemer/actions"
+    exit 0
+elif [ $ERRORS -eq 0 ]; then
+    echo -e "${YELLOW}⚠ Checks passed with warnings${NC}"
+    echo "   Warnings: $WARNINGS"
+    echo ""
+    echo "Review warnings above and proceed with testing."
+    exit 0
+else
+    echo -e "${RED}✗ Checks failed${NC}"
+    echo "   Errors: $ERRORS"
+    echo "   Warnings: $WARNINGS"
+    echo ""
+    echo "Please fix the errors above before testing the pipeline."
+    exit 1
+fi
+
diff --git a/deployment/stacks/application/docker-compose.yml b/deployment/stacks/application/docker-compose.yml
deleted file mode 100644
index f267a596..00000000
--- a/deployment/stacks/application/docker-compose.yml
+++ /dev/null
@@ -1,334 +0,0 @@
-# Docker Registry: registry.michaelschiemer.de (HTTPS via Traefik)
-
-services:
-  # PHP-FPM Application Runtime
-  app:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: app
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      - APP_URL=${APP_URL:-https://michaelschiemer.de}
-      - APP_KEY=${APP_KEY:-}
-      # Git Repository (optional - if set, container will clone/pull code on start)
-      - GIT_REPOSITORY_URL=${GIT_REPOSITORY_URL:-}
-      - GIT_BRANCH=${GIT_BRANCH:-main}
-      - GIT_TOKEN=${GIT_TOKEN:-}
-      - GIT_USERNAME=${GIT_USERNAME:-}
-      - GIT_PASSWORD=${GIT_PASSWORD:-}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - DB_PASSWORD_FILE=/run/secrets/db_user_password
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - REDIS_PASSWORD_FILE=/run/secrets/redis_password
-    secrets:
-      - db_user_password
-      - redis_password
-      # Cache
-      - CACHE_DRIVER=redis
-      - CACHE_PREFIX=${CACHE_PREFIX:-app}
-      # Session
-      - SESSION_DRIVER=redis
-      - SESSION_LIFETIME=${SESSION_LIFETIME:-120}
-      # Queue
-      - QUEUE_DRIVER=redis
-      - QUEUE_CONNECTION=default
-    volumes:
-      - app-code:/var/www/html
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    healthcheck:
-      test: ["CMD-SHELL", "true"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
-    depends_on:
-      redis:
-        condition: service_started
-
-  # Nginx Web Server
-  # Uses same image as app - clones code from Git if GIT_REPOSITORY_URL is set, then runs nginx
-  nginx:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: nginx
-    restart: unless-stopped
-    networks:
-      - traefik-public
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Git Repository (same as app - will clone code on start)
-      - GIT_REPOSITORY_URL=${GIT_REPOSITORY_URL:-}
-      - GIT_BRANCH=${GIT_BRANCH:-main}
-      - GIT_TOKEN=${GIT_TOKEN:-}
-      - GIT_USERNAME=${GIT_USERNAME:-}
-      - GIT_PASSWORD=${GIT_PASSWORD:-}
-    volumes:
-      - ./nginx/conf.d:/etc/nginx/conf.d:ro
-      - app-storage:/var/www/html/storage:ro
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    # Use custom entrypoint that ensures code is available then starts nginx only (no PHP-FPM)
-    entrypoint: ["/bin/sh", "-c"]
-    command:
-      - |
-        # Ensure code is available in /var/www/html (from image or Git)
-        GIT_TARGET_DIR="/var/www/html"
-        
-        # If storage is mounted but code is missing, copy from image's original location
-        if [ ! -d "$$GIT_TARGET_DIR/public" ] && [ -d "/var/www/html.orig" ]; then
-          echo "?? [nginx] Copying code from image..."
-          # Copy everything except storage (which is a volume mount)
-          find /var/www/html.orig -mindepth 1 -maxdepth 1 ! -name "storage" -exec cp -r {} "$$GIT_TARGET_DIR/" \; 2>/dev/null || true
-        fi
-        
-        if [ -n "$$GIT_REPOSITORY_URL" ]; then
-          # Configure Git to be non-interactive
-          export GIT_TERMINAL_PROMPT=0
-          export GIT_ASKPASS=echo
-
-          # Determine authentication method
-
-
-          if [ -n "$$GIT_TOKEN" ]; then
-            GIT_URL_WITH_AUTH=$$(echo "$$GIT_REPOSITORY_URL" | sed "s|https://|https://$${GIT_TOKEN}@|")
-          elif [ -n "$$GIT_USERNAME" ] && [ -n "$$GIT_PASSWORD" ]; then
-            GIT_URL_WITH_AUTH=$$(echo "$$GIT_REPOSITORY_URL" | sed "s|https://|https://$${GIT_USERNAME}:$${GIT_PASSWORD}@|")
-          else
-            echo "⚠️  [nginx] No Git credentials provided (GIT_TOKEN or GIT_USERNAME/GIT_PASSWORD). Using image contents."
-            GIT_URL_WITH_AUTH=""
-          fi
-
-
-          if [ -n "$$GIT_URL_WITH_AUTH" ] && [ ! -d "$$GIT_TARGET_DIR/.git" ]; then
-            echo "?? [nginx] Cloning repository from $$GIT_REPOSITORY_URL (branch: $${GIT_BRANCH:-main})..."
-            # Remove only files/dirs that are not storage (which is a volume mount)
-            # Clone into a temporary directory first, then move contents
-            TEMP_CLONE="$${GIT_TARGET_DIR}.tmp"
-            rm -rf "$$TEMP_CLONE" 2>/dev/null || true
-            if git clone --branch "$${GIT_BRANCH:-main}" --depth 1 "$$GIT_URL_WITH_AUTH" "$$TEMP_CLONE"; then
-              # Remove only files/dirs that are not storage (which is a volume mount)
-              find "$$GIT_TARGET_DIR" -mindepth 1 -maxdepth 1 ! -name "storage" -exec rm -rf {} \\; 2>/dev/null || true
-              # Move contents from temp directory to target (preserving storage)
-              find "$$TEMP_CLONE" -mindepth 1 -maxdepth 1 ! -name "." ! -name ".." -exec mv {} "$$GIT_TARGET_DIR/" \\; 2>/dev/null || true
-              rm -rf "$$TEMP_CLONE" 2>/dev/null || true
-              echo "✅ [nginx] Repository cloned successfully"
-            else
-              echo "? Git clone failed. Using image contents."
-              rm -rf "$$TEMP_CLONE" 2>/dev/null || true
-            fi
-          else
-            echo "?? [nginx] Pulling latest changes..."
-            cd "$$GIT_TARGET_DIR"
-            git fetch origin "$${GIT_BRANCH:-main}" || true
-            git reset --hard "origin/$${GIT_BRANCH:-main}" || true
-            git clean -fd || true
-          fi
-          if [ -f "$$GIT_TARGET_DIR/composer.json" ]; then
-            echo "?? [nginx] Installing dependencies..."
-            cd "$$GIT_TARGET_DIR"
-            composer install --no-dev --optimize-autoloader --no-interaction --no-scripts || true
-            composer dump-autoload --optimize --classmap-authoritative || true
-          fi
-          echo "? [nginx] Git sync completed"
-        else
-          echo "??  [nginx] GIT_REPOSITORY_URL not set, using code from image"
-        fi
-        
-        # Start nginx only (no PHP-FPM)
-        echo "?? [nginx] Starting nginx..."
-        exec nginx -g "daemon off;"
-    labels:
-      - "traefik.enable=true"
-      # HTTP Router
-      - "traefik.http.routers.app.rule=Host(`${APP_DOMAIN:-michaelschiemer.de}`)"
-      - "traefik.http.routers.app.entrypoints=websecure"
-      - "traefik.http.routers.app.tls=true"
-      - "traefik.http.routers.app.tls.certresolver=letsencrypt"
-      # Service
-      - "traefik.http.services.app.loadbalancer.server.port=80"
-      # Middleware
-      - "traefik.http.routers.app.middlewares=default-chain@file"
-      # Network
-      - "traefik.docker.network=traefik-public"
-    healthcheck:
-      test: ["CMD-SHELL", "curl -f http://127.0.0.1/health || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 10s
-    depends_on:
-      app:
-        condition: service_started
-
-  # Redis Cache/Session/Queue Backend
-  redis:
-    image: redis:7-alpine
-    container_name: redis
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-    secrets:
-      - redis_password
-    command: >
-      sh -c "redis-server
-      --requirepass $$(cat /run/secrets/redis_password)
-      --maxmemory 512mb
-      --maxmemory-policy allkeys-lru
-      --save 900 1
-      --save 300 10
-      --save 60 10000
-      --appendonly yes
-      --appendfsync everysec"
-    volumes:
-      - redis-data:/data
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    healthcheck:
-      test: ["CMD", "sh", "-c", "redis-cli --no-auth-warning -a $$(cat /run/secrets/redis_password) ping"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 10s
-
-  # Queue Worker (Background Jobs)
-  queue-worker:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: queue-worker
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - DB_PASSWORD_FILE=/run/secrets/db_user_password
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - REDIS_PASSWORD_FILE=/run/secrets/redis_password
-    secrets:
-      - db_user_password
-      - redis_password
-      # Queue
-      - QUEUE_DRIVER=redis
-      - QUEUE_CONNECTION=default
-      - QUEUE_WORKER_SLEEP=${QUEUE_WORKER_SLEEP:-3}
-      - QUEUE_WORKER_TRIES=${QUEUE_WORKER_TRIES:-3}
-      - QUEUE_WORKER_TIMEOUT=${QUEUE_WORKER_TIMEOUT:-60}
-    volumes:
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    secrets:
-      - db_user_password
-      - redis_password
-    command: php console.php queue:work --queue=default --timeout=${QUEUE_WORKER_TIMEOUT:-60}
-    healthcheck:
-      test: ["CMD-SHELL", "php -r 'exit(0);' && test -f /var/www/html/console.php || exit 1"]
-      interval: 60s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-    depends_on:
-      app:
-        condition: service_started
-      redis:
-        condition: service_started
-
-  # Scheduler (Cron Jobs)
-  scheduler:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: scheduler
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - DB_PASSWORD_FILE=/run/secrets/db_user_password
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      # Use Docker Secrets via *_FILE pattern (Framework supports this automatically)
-      - REDIS_PASSWORD_FILE=/run/secrets/redis_password
-    secrets:
-      - db_user_password
-      - redis_password
-    volumes:
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    command: php console.php scheduler:run
-    healthcheck:
-      test: ["CMD-SHELL", "php -r 'exit(0);' && test -f /var/www/html/console.php || exit 1"]
-      interval: 60s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-    depends_on:
-      app:
-        condition: service_started
-      redis:
-        condition: service_started
-
-volumes:
-  app-code:
-    name: app-code
-    external: true
-  app-storage:
-    name: app-storage
-    external: true
-  app-logs:
-    name: app-logs
-    external: true
-  redis-data:
-    name: redis-data
-    external: true
-
-secrets:
-  db_user_password:
-    file: ./secrets/db_user_password.txt
-  redis_password:
-    file: ./secrets/redis_password.txt
-
-networks:
-  traefik-public:
-    external: true
-  app-internal:
-    external: true
-    name: app-internal
diff --git a/deployment/stacks/application/docker-compose.yml.backup b/deployment/stacks/application/docker-compose.yml.backup
deleted file mode 100644
index ed31e520..00000000
--- a/deployment/stacks/application/docker-compose.yml.backup
+++ /dev/null
@@ -1,286 +0,0 @@
-version: '3.8'
-# Docker Registry: registry.michaelschiemer.de (HTTPS via Traefik)
-
-services:
-  # PHP-FPM Application Runtime
-  app:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: app
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      - APP_URL=${APP_URL:-https://michaelschiemer.de}
-      # Git Repository (optional - if set, container will clone/pull code on start)
-      - GIT_REPOSITORY_URL=${GIT_REPOSITORY_URL:-}
-      - GIT_BRANCH=${GIT_BRANCH:-main}
-      - GIT_TOKEN=${GIT_TOKEN:-}
-      - GIT_USERNAME=${GIT_USERNAME:-}
-      - GIT_PASSWORD=${GIT_PASSWORD:-}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      - DB_PASSWORD=${DB_PASSWORD}
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      - REDIS_PASSWORD=${REDIS_PASSWORD}
-      # Cache
-      - CACHE_DRIVER=redis
-      - CACHE_PREFIX=${CACHE_PREFIX:-app}
-      # Session
-      - SESSION_DRIVER=redis
-      - SESSION_LIFETIME=${SESSION_LIFETIME:-120}
-      # Queue
-      - QUEUE_DRIVER=redis
-      - QUEUE_CONNECTION=default
-    volumes:
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    healthcheck:
-      test: ["CMD-SHELL", "true"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
-    depends_on:
-      redis:
-        condition: service_started
-
-  # Nginx Web Server
-  # Uses same image as app - clones code from Git if GIT_REPOSITORY_URL is set, then runs nginx
-  nginx:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: nginx
-    restart: unless-stopped
-    networks:
-      - traefik-public
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Git Repository (same as app - will clone code on start)
-      - GIT_REPOSITORY_URL=${GIT_REPOSITORY_URL:-}
-      - GIT_BRANCH=${GIT_BRANCH:-main}
-      - GIT_TOKEN=${GIT_TOKEN:-}
-      - GIT_USERNAME=${GIT_USERNAME:-}
-      - GIT_PASSWORD=${GIT_PASSWORD:-}
-    volumes:
-      - ./nginx/conf.d:/etc/nginx/conf.d:ro
-      - app-storage:/var/www/html/storage:ro
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    # Use custom entrypoint that ensures code is available then starts nginx only (no PHP-FPM)
-    entrypoint: ["/bin/sh", "-c"]
-    command:
-      - |
-        # Ensure code is available in /var/www/html (from image or Git)
-        GIT_TARGET_DIR="/var/www/html"
-        
-        # If storage is mounted but code is missing, copy from image's original location
-        if [ ! -d "$$GIT_TARGET_DIR/public" ] && [ -d "/var/www/html.orig" ]; then
-          echo "?? [nginx] Copying code from image..."
-          # Copy everything except storage (which is a volume mount)
-          find /var/www/html.orig -mindepth 1 -maxdepth 1 ! -name "storage" -exec cp -r {} "$$GIT_TARGET_DIR/" \; 2>/dev/null || true
-        fi
-        
-        if [ -n "$$GIT_REPOSITORY_URL" ]; then
-          # Determine authentication method
-          if [ -n "$$GIT_TOKEN" ]; then
-            GIT_URL_WITH_AUTH=$$(echo "$$GIT_REPOSITORY_URL" | sed "s|https://|https://$${GIT_TOKEN}@|")
-          elif [ -n "$$GIT_USERNAME" ] && [ -n "$$GIT_PASSWORD" ]; then
-            GIT_URL_WITH_AUTH=$$(echo "$$GIT_REPOSITORY_URL" | sed "s|https://|https://$${GIT_USERNAME}:$${GIT_PASSWORD}@|")
-          else
-            GIT_URL_WITH_AUTH="$$GIT_REPOSITORY_URL"
-          fi
-          
-          if [ ! -d "$$GIT_TARGET_DIR/.git" ]; then
-            echo "?? [nginx] Cloning repository from $$GIT_REPOSITORY_URL (branch: $${GIT_BRANCH:-main})..."
-            # Remove only files/dirs that are not storage (which is a volume mount)
-            find "$$GIT_TARGET_DIR" -mindepth 1 -maxdepth 1 ! -name "storage" -exec rm -rf {} \; 2>/dev/null || true
-            git clone --branch "$${GIT_BRANCH:-main}" --depth 1 "$$GIT_URL_WITH_AUTH" "$$GIT_TARGET_DIR" || {
-              echo "? Git clone failed. Using image contents."
-            }
-          else
-            echo "?? [nginx] Pulling latest changes..."
-            cd "$$GIT_TARGET_DIR"
-            git fetch origin "$${GIT_BRANCH:-main}" || true
-            git reset --hard "origin/$${GIT_BRANCH:-main}" || true
-            git clean -fd || true
-          fi
-          
-          if [ -f "$$GIT_TARGET_DIR/composer.json" ]; then
-            echo "?? [nginx] Installing dependencies..."
-            cd "$$GIT_TARGET_DIR"
-            composer install --no-dev --optimize-autoloader --no-interaction --no-scripts || true
-            composer dump-autoload --optimize --classmap-authoritative || true
-          fi
-          echo "? [nginx] Git sync completed"
-        else
-          echo "??  [nginx] GIT_REPOSITORY_URL not set, using code from image"
-        fi
-        
-        # Start nginx only (no PHP-FPM)
-        echo "?? [nginx] Starting nginx..."
-        exec nginx -g "daemon off;"
-    labels:
-      - "traefik.enable=true"
-      # HTTP Router
-      - "traefik.http.routers.app.rule=Host(`${APP_DOMAIN:-michaelschiemer.de}`)"
-      - "traefik.http.routers.app.entrypoints=websecure"
-      - "traefik.http.routers.app.tls=true"
-      - "traefik.http.routers.app.tls.certresolver=letsencrypt"
-      # Service
-      - "traefik.http.services.app.loadbalancer.server.port=80"
-      # Middleware
-      - "traefik.http.routers.app.middlewares=default-chain@file"
-      # Network
-      - "traefik.docker.network=traefik-public"
-    healthcheck:
-      test: ["CMD-SHELL", "curl -f http://127.0.0.1/health || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 10s
-    depends_on:
-      app:
-        condition: service_started
-
-  # Redis Cache/Session/Queue Backend
-  redis:
-    image: redis:7-alpine
-    container_name: redis
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-    command: >
-      redis-server
-      --requirepass ${REDIS_PASSWORD}
-      --maxmemory 512mb
-      --maxmemory-policy allkeys-lru
-      --save 900 1
-      --save 300 10
-      --save 60 10000
-      --appendonly yes
-      --appendfsync everysec
-    volumes:
-      - redis-data:/data
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    healthcheck:
-      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 10s
-
-  # Queue Worker (Background Jobs)
-  queue-worker:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: queue-worker
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      - DB_PASSWORD=${DB_PASSWORD}
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      - REDIS_PASSWORD=${REDIS_PASSWORD}
-      # Queue
-      - QUEUE_DRIVER=redis
-      - QUEUE_CONNECTION=default
-      - QUEUE_WORKER_SLEEP=${QUEUE_WORKER_SLEEP:-3}
-      - QUEUE_WORKER_TRIES=${QUEUE_WORKER_TRIES:-3}
-      - QUEUE_WORKER_TIMEOUT=${QUEUE_WORKER_TIMEOUT:-60}
-    volumes:
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    command: php console.php queue:work --queue=default --timeout=${QUEUE_WORKER_TIMEOUT:-60}
-    healthcheck:
-      test: ["CMD-SHELL", "php -r 'exit(0);' && test -f /var/www/html/console.php || exit 1"]
-      interval: 60s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-    depends_on:
-      app:
-        condition: service_started
-      redis:
-        condition: service_started
-
-  # Scheduler (Cron Jobs)
-  scheduler:
-    image: git.michaelschiemer.de:5000/framework:latest
-    container_name: scheduler
-    restart: unless-stopped
-    networks:
-      - app-internal
-    environment:
-      - TZ=Europe/Berlin
-      - APP_ENV=${APP_ENV:-production}
-      - APP_DEBUG=${APP_DEBUG:-false}
-      # Database
-      - DB_HOST=${DB_HOST:-postgres}
-      - DB_PORT=${DB_PORT:-5432}
-      - DB_DATABASE=${DB_DATABASE}
-      - DB_USERNAME=${DB_USERNAME}
-      - DB_PASSWORD=${DB_PASSWORD}
-      # Redis
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      - REDIS_PASSWORD=${REDIS_PASSWORD}
-    volumes:
-      - app-storage:/var/www/html/storage
-      - app-logs:/var/www/html/storage/logs
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-    command: php console.php scheduler:run
-    healthcheck:
-      test: ["CMD-SHELL", "php -r 'exit(0);' && test -f /var/www/html/console.php || exit 1"]
-      interval: 60s
-      timeout: 10s
-      retries: 3
-      start_period: 30s
-    depends_on:
-      app:
-        condition: service_started
-      redis:
-        condition: service_started
-
-volumes:
-  app-code:
-    name: app-code
-  app-storage:
-    name: app-storage
-  app-logs:
-    name: app-logs
-  redis-data:
-    name: redis-data
-
-networks:
-  traefik-public:
-    external: true
-  app-internal:
-    external: true
-    name: app-internal
diff --git a/deployment/stacks/gitea/.env.example b/deployment/stacks/gitea/.env.example
index d773a03e..c69fcd22 100644
--- a/deployment/stacks/gitea/.env.example
+++ b/deployment/stacks/gitea/.env.example
@@ -17,4 +17,5 @@ MYSQL_PASSWORD=<generate-strong-password>
 REDIS_PASSWORD=<generate-strong-password>
 
 # Gitea Settings
-DISABLE_REGISTRATION=true  # Set to false to allow user registration
+# Set to false to allow user registration
+DISABLE_REGISTRATION=true
diff --git a/deployment/stacks/gitea/README.md b/deployment/stacks/gitea/README.md
index c24df6a1..0bec51da 100644
--- a/deployment/stacks/gitea/README.md
+++ b/deployment/stacks/gitea/README.md
@@ -177,9 +177,10 @@ The playbook will:
 ### Configuration File
 
 Gitea configuration is managed via `app.ini` file:
-- **Local file**: `deployment/stacks/gitea/app.ini` (for local development)
-- **Production**: Generated from Ansible template `deployment/ansible/templates/gitea-app.ini.j2`
-- The `app.ini` is mounted read-only into the container at `/data/gitea/conf/app.ini`
+- **Template**: `deployment/ansible/templates/gitea-app.ini.j2` (Ansible template)
+- **Production**: Generated from template and deployed via Ansible playbook `setup-gitea-initial-config.yml`
+- The `app.ini` is copied to the container at `/data/gitea/conf/app.ini`
+- **Important**: `app.ini` is a minimal configuration. Cache, Session, Queue, and other settings are controlled via `GITEA__...` environment variables in `docker-compose.yml` which override `app.ini` settings on every container start.
 - Configuration is based on the official Gitea example: https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini
 
 **Key Configuration Sections:**
diff --git a/deployment/stacks/gitea/app.ini b/deployment/stacks/gitea/app.ini
deleted file mode 100644
index e8c4b1c4..00000000
--- a/deployment/stacks/gitea/app.ini
+++ /dev/null
@@ -1,80 +0,0 @@
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Gitea Configuration File
-;; This file is based on the official Gitea example configuration
-;; https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; General Settings
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-APP_NAME = Gitea: Git with a cup of tea
-RUN_MODE = prod
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Server Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[server]
-PROTOCOL = http
-DOMAIN = git.michaelschiemer.de
-HTTP_ADDR = 0.0.0.0
-HTTP_PORT = 3000
-ROOT_URL = https://git.michaelschiemer.de/
-PUBLIC_URL_DETECTION = auto
-
-;; SSH Configuration
-DISABLE_SSH = false
-START_SSH_SERVER = true
-SSH_DOMAIN = git.michaelschiemer.de
-SSH_PORT = 22
-SSH_LISTEN_PORT = 22
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Database Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[database]
-DB_TYPE = postgres
-HOST = postgres:5432
-NAME = gitea
-USER = gitea
-PASSWD = gitea_password
-SSL_MODE = disable
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Cache Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[cache]
-ENABLED = false
-ADAPTER = memory
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Session Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[session]
-PROVIDER = file
-PROVIDER_CONFIG = data/sessions
-COOKIE_SECURE = true
-COOKIE_NAME = i_like_gitea
-GC_INTERVAL_TIME = 86400
-SESSION_LIFE_TIME = 86400
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Queue Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[queue]
-TYPE = channel
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Service Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[service]
-DISABLE_REGISTRATION = true
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Actions Configuration
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-[actions]
-ENABLED = true
-;; Use "self" to use the current Gitea instance for actions (not GitHub)
-;; Do NOT set DEFAULT_ACTIONS_URL to a custom URL - it's not supported
-;; Leaving it unset or setting to "self" will use the current instance
-;DEFAULT_ACTIONS_URL = self
diff --git a/deployment/stacks/gitea/docker-compose.yml b/deployment/stacks/gitea/docker-compose.yml
index 5d684def..743610ff 100644
--- a/deployment/stacks/gitea/docker-compose.yml
+++ b/deployment/stacks/gitea/docker-compose.yml
@@ -19,10 +19,22 @@ services:
       - GITEA__database__NAME=${POSTGRES_DB:-gitea}
       - GITEA__database__USER=${POSTGRES_USER:-gitea}
       - GITEA__database__PASSWD=${POSTGRES_PASSWORD:-gitea_password}
-      - GITEA__cache__ENABLED=true
-      - GITEA__cache__ADAPTER=redis
-      - GITEA__cache__HOST=redis:6379
-      - GITEA__cache__PASSWORD=${REDIS_PASSWORD:-gitea_redis_password}
+      # Database connection pool settings to prevent "Timeout before authentication" errors
+      # These limit the number of concurrent connections and prevent connection pool exhaustion
+      # - MAX_OPEN_CONNS: Maximum number of open connections to the database
+      # - MAX_IDLE_CONNS: More warm connections to avoid constantly creating new sessions
+      # - CONN_MAX_LIFETIME: 10 minutes; idle connections are not recycled too quickly
+      # - CONN_MAX_IDLE_TIME: Clean up connections that are idle for too long
+      - GITEA__database__MAX_OPEN_CONNS=50
+      - GITEA__database__MAX_IDLE_CONNS=30
+      - GITEA__database__CONN_MAX_LIFETIME=600
+      - GITEA__database__CONN_MAX_IDLE_TIME=300
+      # Cache, Session, and Queue configuration via environment variables
+      # These override app.ini settings and are applied on every container start
+      # NOTE: Cache deaktiviert - Gitea 1.25 interpretiert GITEA__cache__HOST nicht korrekt
+      # (verbindet sich mit 127.0.0.1:6379 statt redis:6379). Session und Queue nutzen weiterhin Redis.
+      - GITEA__cache__ENABLED=false
+      - GITEA__cache__ADAPTER=memory
       - GITEA__session__PROVIDER=redis
       - GITEA__session__PROVIDER_CONFIG=network=tcp,addr=redis:6379,password=${REDIS_PASSWORD:-gitea_redis_password},db=0,pool_size=100,idle_timeout=180
       - GITEA__queue__TYPE=redis
@@ -40,21 +52,18 @@ services:
     labels:
       - "traefik.enable=true"
 
-      # HTTP Router
+      # HTTP Router configuration
       - "traefik.http.routers.gitea.rule=Host(`git.michaelschiemer.de`)"
       - "traefik.http.routers.gitea.entrypoints=websecure"
       - "traefik.http.routers.gitea.tls=true"
       - "traefik.http.routers.gitea.tls.certresolver=letsencrypt"
-      # Priority to ensure this router is matched before catchall (catchall has no explicit priority, so default is 0)
       - "traefik.http.routers.gitea.priority=100"
-
-      # Service
+      # Service configuration (Docker provider uses port, not url)
       - "traefik.http.services.gitea.loadbalancer.server.port=3000"
-      # Use container name explicitly for host network mode
-      - "traefik.http.services.gitea.loadbalancer.server.scheme=http"
-
-      # Middleware
-      - "traefik.http.routers.gitea.middlewares=default-chain@file"
+      # Middleware chain (removed temporarily to test if it causes issues)
+      # - "traefik.http.routers.gitea.middlewares=security-headers-global@file,gzip-compression@file"
+      # Explicitly reference the service (like MinIO does)
+      - "traefik.http.routers.gitea.service=gitea"
     healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:3000/api/healthz"]
       interval: 30s
@@ -73,7 +82,12 @@ services:
       - POSTGRES_DB=gitea
       - POSTGRES_USER=gitea
       - POSTGRES_PASSWORD=gitea_password
-    command: postgres -c max_connections=300
+    command: >
+      postgres
+      -c max_connections=300
+      -c authentication_timeout=180
+      -c statement_timeout=30000
+      -c idle_in_transaction_session_timeout=30000
     volumes:
       - postgres-data:/var/lib/postgresql/data
     healthcheck:
diff --git a/deployment/stacks/gitea/mysql/conf.d/gitea.cnf b/deployment/stacks/gitea/mysql/conf.d/gitea.cnf
deleted file mode 100644
index e3927c2e..00000000
--- a/deployment/stacks/gitea/mysql/conf.d/gitea.cnf
+++ /dev/null
@@ -1,33 +0,0 @@
-[mysqld]
-# Gitea-optimized MySQL configuration
-
-# Character set
-character-set-server = utf8mb4
-collation-server = utf8mb4_unicode_ci
-
-# InnoDB settings
-innodb_buffer_pool_size = 256M
-innodb_log_file_size = 64M
-innodb_flush_log_at_trx_commit = 2
-innodb_flush_method = O_DIRECT
-
-# Connection settings
-max_connections = 200
-max_allowed_packet = 64M
-
-# Query cache (disabled in MySQL 8.0+)
-# Performance schema
-performance_schema = ON
-
-# Logging
-slow_query_log = 1
-slow_query_log_file = /var/log/mysql/slow-queries.log
-long_query_time = 2
-
-# Binary logging for backups
-log_bin = /var/log/mysql/mysql-bin.log
-binlog_expire_logs_seconds = 604800  # 7 days
-max_binlog_size = 100M
-
-[client]
-default-character-set = utf8mb4
diff --git a/deployment/stacks/monitoring/docker-compose.local.yml b/deployment/stacks/monitoring/docker-compose.local.yml
new file mode 100644
index 00000000..10250688
--- /dev/null
+++ b/deployment/stacks/monitoring/docker-compose.local.yml
@@ -0,0 +1,47 @@
+# Local Development Override for Monitoring Stack
+# Usage: docker compose -f docker-compose.yml -f docker-compose.local.yml up -d
+#
+# IMPORTANT: Must use LIST format labels like base config to prevent merging
+# Dictionary format + List format = Both remain (merged)
+# List format + List format = Properly merged/replaced
+#
+# This override file:
+# - Changes entrypoints from 'websecure' to 'web' (HTTP only for local dev)
+# - Removes TLS/Let's Encrypt configuration by NOT including those labels
+# - Keeps all other configuration from docker-compose.yml
+
+services:
+  portainer:
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.portainer.rule=Host(`portainer.${DOMAIN}`)"
+      - "traefik.http.routers.portainer.entrypoints=web"
+      - "traefik.http.routers.portainer.tls=false"
+      - "traefik.http.services.portainer.loadbalancer.server.port=9000"
+
+  prometheus:
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.prometheus.rule=Host(`prometheus.${DOMAIN}`)"
+      - "traefik.http.routers.prometheus.entrypoints=web"
+      - "traefik.http.routers.prometheus.tls=false"
+      - "traefik.http.routers.prometheus.middlewares=prometheus-auth@docker"
+      - "traefik.http.middlewares.prometheus-auth.basicauth.users=${PROMETHEUS_AUTH}"
+      - "traefik.http.services.prometheus.loadbalancer.server.port=9090"
+
+  grafana:
+    environment:
+      # Update root URL for HTTP
+      - GF_SERVER_ROOT_URL=http://grafana.${DOMAIN}:8081
+      - GF_SECURITY_ADMIN_USER=${GRAFANA_ADMIN_USER}
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_INSTALL_PLUGINS=${GRAFANA_PLUGINS}
+      - GF_LOG_LEVEL=info
+      - GF_ANALYTICS_REPORTING_ENABLED=false
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.grafana.rule=Host(`grafana.${DOMAIN}`)"
+      - "traefik.http.routers.grafana.entrypoints=web"
+      - "traefik.http.routers.grafana.tls=false"
+      - "traefik.http.services.grafana.loadbalancer.server.port=3000"
diff --git a/deployment/stacks/postgresql-production/README.md b/deployment/stacks/postgresql-production/README.md
new file mode 100644
index 00000000..a189e10f
--- /dev/null
+++ b/deployment/stacks/postgresql-production/README.md
@@ -0,0 +1,257 @@
+# PostgreSQL Production Stack - Production Database
+
+## Overview
+
+Production-ready PostgreSQL 16 database stack with automated backup system and performance optimization.
+
+**Features**:
+- PostgreSQL 16 Alpine (lightweight, secure)
+- Automated daily backups with configurable retention
+- Performance-optimized configuration (2GB memory allocation)
+- Health checks and automatic recovery
+- Persistent storage with named volumes
+- Isolated `postgres-production-internal` network
+- Resource limits for stability
+
+## Services
+
+- **postgres-production** - PostgreSQL 16 database server
+- **postgres-production-backup** - Automated backup service with cron scheduling
+
+## Prerequisites
+
+1. **Docker and Docker Compose** installed
+2. **Environment file** created (`.env`)
+
+## Configuration
+
+### 1. Create Environment File
+
+```bash
+cp .env.example .env
+```
+
+### 2. Generate Secure Password
+
+```bash
+openssl rand -base64 32
+```
+
+Update `.env`:
+```env
+POSTGRES_DB=michaelschiemer
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<generated-password>
+BACKUP_RETENTION_DAYS=7
+BACKUP_SCHEDULE=0 2 * * *
+```
+
+## Deployment
+
+### Initial Setup
+
+```bash
+# Create environment file
+cp .env.example .env
+
+# Generate and set password
+openssl rand -base64 32
+# Update POSTGRES_PASSWORD in .env
+
+# Start services
+docker compose up -d
+
+# Check logs
+docker compose logs -f
+
+# Verify health
+docker compose ps
+```
+
+### Verify Deployment
+
+```bash
+# Check PostgreSQL is running
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+
+# Expected: postgres-production:5432 - accepting connections
+
+# Check backup service
+docker compose logs postgres-production-backup
+
+# Expected: Initial backup completed successfully
+```
+
+## Integration with Production Application Stack
+
+The Production Application Stack connects to this database via the `postgres-production-internal` network.
+
+**Connection Configuration** in `deployment/stacks/production/.env`:
+```env
+DB_HOST=postgres-production
+DB_PORT=5432
+DB_DATABASE=michaelschiemer
+DB_USERNAME=postgres
+DB_PASSWORD=<same-as-postgres-production-password>
+```
+
+**Network Connection**: The Production Application Stack must be connected to the `postgres-production-internal` network.
+
+## Usage
+
+### Database Access
+
+#### From Host Machine
+
+```bash
+# Connect to database
+docker exec -it postgres-production psql -U postgres -d michaelschiemer
+
+# Run SQL query
+docker exec postgres-production psql -U postgres -d michaelschiemer -c "SELECT version();"
+```
+
+#### From Application Container
+
+```bash
+# Connection string format
+postgresql://postgres:password@postgres-production:5432/michaelschiemer
+```
+
+### Backup Management
+
+#### Manual Backup
+
+```bash
+# Trigger manual backup
+docker exec postgres-production-backup /scripts/backup.sh
+
+# List backups
+ls -lh backups/
+
+# Example output:
+# postgres_michaelschiemer_20250130_020000.sql.gz
+```
+
+#### Restore from Backup
+
+```bash
+# List available backups
+docker exec postgres-production-backup ls -lh /backups
+
+# Restore specific backup
+docker exec -it postgres-production-backup /scripts/restore.sh /backups/postgres_michaelschiemer_20250130_020000.sql.gz
+
+# ⚠️ WARNING: This will DROP and RECREATE the database!
+```
+
+## Network Isolation
+
+This stack uses its own isolated network:
+- **Network**: `postgres-production-internal`
+- **Purpose**: Isolate Production database from other services
+- **Access**: Only services explicitly connected to this network can access the database
+
+**Connecting Application Stack**:
+```yaml
+# In deployment/stacks/production/docker-compose.production.yml
+networks:
+  postgres-production-internal:
+    external: true
+    name: postgres-production-internal
+```
+
+## Security
+
+### Network Isolation
+- PostgreSQL only accessible via `postgres-production-internal` network
+- No external ports exposed
+- Service-to-service communication only
+
+### Authentication
+- Strong password required (generated with `openssl rand -base64 32`)
+- No default passwords
+- Password stored in environment variables only
+
+## Monitoring
+
+### Health Checks
+
+```bash
+# Check service health
+docker compose ps
+
+# Expected: Both services "healthy"
+
+# Manual health check
+docker exec postgres-production pg_isready -U postgres -d michaelschiemer
+```
+
+### Resource Usage
+
+```bash
+# Database container stats
+docker stats postgres-production --no-stream
+
+# Disk usage
+docker exec postgres-production du -sh /var/lib/postgresql/data
+```
+
+### Logs
+
+```bash
+# PostgreSQL logs
+docker compose logs postgres-production
+
+# Backup logs
+docker compose logs postgres-production-backup
+
+# Real-time monitoring
+docker compose logs -f
+```
+
+## Troubleshooting
+
+### Database Won't Start
+
+```bash
+# Check logs
+docker compose logs postgres-production
+
+# Common issues:
+# 1. Invalid configuration
+docker exec postgres-production postgres --check
+
+# 2. Permission issues
+docker exec postgres-production ls -la /var/lib/postgresql/data
+```
+
+### Connection Refused from Application
+
+```bash
+# 1. Check PostgreSQL is running
+docker compose ps postgres-production
+
+# 2. Verify network
+docker network inspect postgres-production-internal | grep postgres-production
+
+# 3. Check if application is connected to network
+docker network inspect postgres-production-internal | grep app
+```
+
+## Differences from Staging Stack
+
+| Aspect | Production | Staging |
+|--------|-----------|---------|
+| **Container Name** | postgres-production | postgres-staging |
+| **Network** | postgres-production-internal | postgres-staging-internal |
+| **Volume** | postgres-production-data | postgres-staging-data |
+| **Database** | michaelschiemer | michaelschiemer_staging |
+| **Backup Retention** | 7 days (configurable) | 7 days (configurable) |
+
+## Additional Resources
+
+- **PostgreSQL Documentation**: https://www.postgresql.org/docs/16/
+- **Performance Tuning**: https://wiki.postgresql.org/wiki/Performance_Optimization
+- **Backup Best Practices**: https://www.postgresql.org/docs/16/backup.html
+
diff --git a/deployment/stacks/postgresql-production/conf.d/postgresql.conf b/deployment/stacks/postgresql-production/conf.d/postgresql.conf
new file mode 100644
index 00000000..d753fa4a
--- /dev/null
+++ b/deployment/stacks/postgresql-production/conf.d/postgresql.conf
@@ -0,0 +1,70 @@
+# PostgreSQL Configuration for Production
+# Optimized for 2GB memory allocation
+
+# Connection Settings
+listen_addresses = '*'
+max_connections = 100
+superuser_reserved_connections = 3
+
+# Memory Settings (for 2GB allocation)
+shared_buffers = 512MB
+effective_cache_size = 1536MB
+maintenance_work_mem = 128MB
+work_mem = 5MB
+
+# Checkpoint Settings
+checkpoint_completion_target = 0.9
+wal_buffers = 16MB
+default_statistics_target = 100
+
+# Query Planner
+random_page_cost = 1.1
+effective_io_concurrency = 200
+
+# Write-Ahead Logging
+wal_level = replica
+max_wal_size = 2GB
+min_wal_size = 1GB
+
+# Logging
+log_destination = 'stderr'
+logging_collector = on
+log_directory = 'log'
+log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
+log_rotation_age = 1d
+log_rotation_size = 100MB
+log_line_prefix = '%m [%p] %u@%d '
+log_timezone = 'Europe/Berlin'
+
+# What to Log
+log_min_duration_statement = 1000
+log_checkpoints = on
+log_connections = on
+log_disconnections = on
+log_lock_waits = on
+log_statement = 'ddl'
+
+# Autovacuum
+autovacuum = on
+autovacuum_max_workers = 3
+autovacuum_naptime = 1min
+
+# Client Connection Defaults
+datestyle = 'iso, mdy'
+timezone = 'Europe/Berlin'
+lc_messages = 'en_US.utf8'
+lc_monetary = 'en_US.utf8'
+lc_numeric = 'en_US.utf8'
+lc_time = 'en_US.utf8'
+default_text_search_config = 'pg_catalog.english'
+
+# Lock Management
+deadlock_timeout = 1s
+
+# Statement Timeout (prevent long-running queries)
+statement_timeout = 30000  # 30 seconds
+
+# Parallel Query Execution
+max_parallel_workers_per_gather = 2
+max_parallel_workers = 4
+max_worker_processes = 4
diff --git a/deployment/stacks/postgresql-production/docker-compose.yml b/deployment/stacks/postgresql-production/docker-compose.yml
new file mode 100644
index 00000000..45b4f3f6
--- /dev/null
+++ b/deployment/stacks/postgresql-production/docker-compose.yml
@@ -0,0 +1,72 @@
+services:
+  # PostgreSQL Production Database
+  postgres-production:
+    image: postgres:16-alpine
+    container_name: postgres-production
+    restart: unless-stopped
+    networks:
+      - postgres-production-internal
+    environment:
+      - TZ=Europe/Berlin
+      - POSTGRES_DB=${POSTGRES_DB:-michaelschiemer}
+      - POSTGRES_USER=${POSTGRES_USER:-postgres}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - PGDATA=/var/lib/postgresql/data/pgdata
+    volumes:
+      - postgres-production-data:/var/lib/postgresql/data
+      - ./conf.d:/etc/postgresql/conf.d:ro
+      - ./backups:/backups
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    command:
+      - postgres
+      - -c
+      - config_file=/etc/postgresql/conf.d/postgresql.conf
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres} -d ${POSTGRES_DB:-michaelschiemer}"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    shm_size: 256mb
+    deploy:
+      resources:
+        limits:
+          memory: 2G
+        reservations:
+          memory: 512M
+
+  # Automated Backup Service for Production
+  postgres-production-backup:
+    image: postgres:16-alpine
+    container_name: postgres-production-backup
+    restart: unless-stopped
+    networks:
+      - postgres-production-internal
+    environment:
+      - TZ=Europe/Berlin
+      - POSTGRES_HOST=postgres-production
+      - POSTGRES_DB=${POSTGRES_DB:-michaelschiemer}
+      - POSTGRES_USER=${POSTGRES_USER:-postgres}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - BACKUP_RETENTION_DAYS=${BACKUP_RETENTION_DAYS:-7}
+      - BACKUP_SCHEDULE=${BACKUP_SCHEDULE:-0 2 * * *}
+    volumes:
+      - ./backups:/backups
+      - ./scripts:/scripts:ro
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    entrypoint: ["/scripts/backup-entrypoint.sh"]
+    depends_on:
+      postgres-production:
+        condition: service_healthy
+
+volumes:
+  postgres-production-data:
+    name: postgres-production-data
+
+networks:
+  postgres-production-internal:
+    name: postgres-production-internal
+    driver: bridge
+
diff --git a/deployment/stacks/postgresql-production/scripts/backup-entrypoint.sh b/deployment/stacks/postgresql-production/scripts/backup-entrypoint.sh
new file mode 100755
index 00000000..2f4bf896
--- /dev/null
+++ b/deployment/stacks/postgresql-production/scripts/backup-entrypoint.sh
@@ -0,0 +1,23 @@
+#!/bin/sh
+set -e
+
+echo "🔄 PostgreSQL Backup Service Starting..."
+echo "📅 Backup Schedule: ${BACKUP_SCHEDULE}"
+echo "🗑️  Retention: ${BACKUP_RETENTION_DAYS} days"
+
+# Install cronie for scheduled backups
+apk add --no-cache dcron
+
+# Create cron job
+echo "${BACKUP_SCHEDULE} /scripts/backup.sh >> /var/log/backup.log 2>&1" > /etc/crontabs/root
+
+# Ensure backup directory exists
+mkdir -p /backups
+
+# Run initial backup
+echo "🚀 Running initial backup..."
+/scripts/backup.sh
+
+# Start cron in foreground
+echo "✅ Backup service ready - cron daemon starting"
+crond -f -l 2
diff --git a/deployment/stacks/postgresql-production/scripts/backup.sh b/deployment/stacks/postgresql-production/scripts/backup.sh
new file mode 100755
index 00000000..01af31b0
--- /dev/null
+++ b/deployment/stacks/postgresql-production/scripts/backup.sh
@@ -0,0 +1,55 @@
+#!/bin/sh
+set -e
+
+# Configuration
+BACKUP_DIR="/backups"
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_FILE="${BACKUP_DIR}/postgres_${POSTGRES_DB}_${TIMESTAMP}.sql.gz"
+RETENTION_DAYS=${BACKUP_RETENTION_DAYS:-7}
+
+echo "======================================"
+echo "PostgreSQL Backup - $(date)"
+echo "======================================"
+
+# Wait for PostgreSQL to be ready
+until PGPASSWORD="${POSTGRES_PASSWORD}" pg_isready -h "${POSTGRES_HOST}" -U "${POSTGRES_USER}" -d "${POSTGRES_DB}"; do
+  echo "⏳ Waiting for PostgreSQL..."
+  sleep 5
+done
+
+echo "✅ PostgreSQL is ready"
+
+# Create backup
+echo "📦 Creating backup: ${BACKUP_FILE}"
+PGPASSWORD="${POSTGRES_PASSWORD}" pg_dump \
+  -h "${POSTGRES_HOST}" \
+  -U "${POSTGRES_USER}" \
+  -d "${POSTGRES_DB}" \
+  --clean \
+  --if-exists \
+  --create \
+  --no-owner \
+  --no-privileges \
+  | gzip > "${BACKUP_FILE}"
+
+# Verify backup was created
+if [ -f "${BACKUP_FILE}" ]; then
+  BACKUP_SIZE=$(du -h "${BACKUP_FILE}" | cut -f1)
+  echo "✅ Backup created successfully: ${BACKUP_SIZE}"
+else
+  echo "❌ Backup failed!"
+  exit 1
+fi
+
+# Cleanup old backups
+echo "🗑️  Cleaning up backups older than ${RETENTION_DAYS} days..."
+find "${BACKUP_DIR}" -name "postgres_*.sql.gz" -type f -mtime +${RETENTION_DAYS} -delete
+
+# List current backups
+echo ""
+echo "📊 Current backups:"
+ls -lh "${BACKUP_DIR}"/postgres_*.sql.gz 2>/dev/null || echo "No backups found"
+
+echo ""
+echo "✅ Backup completed successfully"
+echo "======================================"
diff --git a/deployment/stacks/postgresql-production/scripts/restore.sh b/deployment/stacks/postgresql-production/scripts/restore.sh
new file mode 100755
index 00000000..7269f5ad
--- /dev/null
+++ b/deployment/stacks/postgresql-production/scripts/restore.sh
@@ -0,0 +1,55 @@
+#!/bin/sh
+set -e
+
+# Configuration
+BACKUP_DIR="/backups"
+
+if [ -z "$1" ]; then
+  echo "Usage: ./restore.sh <backup-file>"
+  echo ""
+  echo "Available backups:"
+  ls -lh "${BACKUP_DIR}"/postgres_*.sql.gz 2>/dev/null || echo "No backups found"
+  exit 1
+fi
+
+BACKUP_FILE="$1"
+
+if [ ! -f "${BACKUP_FILE}" ]; then
+  echo "❌ Backup file not found: ${BACKUP_FILE}"
+  exit 1
+fi
+
+echo "======================================"
+echo "PostgreSQL Restore - $(date)"
+echo "======================================"
+echo "📦 Backup file: ${BACKUP_FILE}"
+echo ""
+
+# Wait for PostgreSQL to be ready
+until PGPASSWORD="${POSTGRES_PASSWORD}" pg_isready -h "${POSTGRES_HOST}" -U "${POSTGRES_USER}" -d postgres; do
+  echo "⏳ Waiting for PostgreSQL..."
+  sleep 5
+done
+
+echo "✅ PostgreSQL is ready"
+echo ""
+
+# Warning
+echo "⚠️  WARNING: This will DROP and RECREATE the database!"
+echo "⚠️  Database: ${POSTGRES_DB}"
+echo ""
+echo "Press Ctrl+C to cancel, or wait 10 seconds to continue..."
+sleep 10
+
+echo ""
+echo "🔄 Restoring database..."
+
+# Restore backup
+gunzip -c "${BACKUP_FILE}" | PGPASSWORD="${POSTGRES_PASSWORD}" psql \
+  -h "${POSTGRES_HOST}" \
+  -U "${POSTGRES_USER}" \
+  -d postgres
+
+echo ""
+echo "✅ Database restored successfully"
+echo "======================================"
diff --git a/deployment/stacks/postgresql-staging/README.md b/deployment/stacks/postgresql-staging/README.md
new file mode 100644
index 00000000..d290b65c
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/README.md
@@ -0,0 +1,263 @@
+# PostgreSQL Staging Stack - Staging Database
+
+## Overview
+
+Staging PostgreSQL 16 database stack with automated backup system for testing and development.
+
+**Features**:
+- PostgreSQL 16 Alpine (lightweight, secure)
+- Automated daily backups with shorter retention (3 days)
+- Performance-optimized configuration (1GB memory allocation)
+- Health checks and automatic recovery
+- Persistent storage with named volumes
+- Isolated `postgres-staging-internal` network
+- Resource limits optimized for staging workloads
+
+## Services
+
+- **postgres-staging** - PostgreSQL 16 database server
+- **postgres-staging-backup** - Automated backup service with cron scheduling
+
+## Prerequisites
+
+1. **Docker and Docker Compose** installed
+2. **Environment file** created (`.env`)
+
+## Configuration
+
+### 1. Create Environment File
+
+```bash
+cp .env.example .env
+```
+
+### 2. Generate Secure Password
+
+```bash
+openssl rand -base64 32
+```
+
+Update `.env`:
+```env
+POSTGRES_DB=michaelschiemer_staging
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=<generated-password>
+BACKUP_RETENTION_DAYS=3
+BACKUP_SCHEDULE=0 3 * * *
+```
+
+**Note**: Staging uses shorter backup retention (3 days) and runs backups at 3 AM (1 hour after production) to reduce resource contention.
+
+## Deployment
+
+### Initial Setup
+
+```bash
+# Create environment file
+cp .env.example .env
+
+# Generate and set password
+openssl rand -base64 32
+# Update POSTGRES_PASSWORD in .env
+
+# Start services
+docker compose up -d
+
+# Check logs
+docker compose logs -f
+
+# Verify health
+docker compose ps
+```
+
+### Verify Deployment
+
+```bash
+# Check PostgreSQL is running
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+
+# Expected: postgres-staging:5432 - accepting connections
+
+# Check backup service
+docker compose logs postgres-staging-backup
+
+# Expected: Initial backup completed successfully
+```
+
+## Integration with Staging Application Stack
+
+The Staging Application Stack connects to this database via the `postgres-staging-internal` network.
+
+**Connection Configuration** in `docker-compose.staging.yml`:
+```env
+DB_HOST=postgres-staging
+DB_PORT=5432
+DB_DATABASE=michaelschiemer_staging
+DB_USERNAME=postgres
+DB_PASSWORD=<same-as-postgres-staging-password>
+```
+
+**Network Connection**: The Staging Application Stack must be connected to the `postgres-staging-internal` network.
+
+## Usage
+
+### Database Access
+
+#### From Host Machine
+
+```bash
+# Connect to database
+docker exec -it postgres-staging psql -U postgres -d michaelschiemer_staging
+
+# Run SQL query
+docker exec postgres-staging psql -U postgres -d michaelschiemer_staging -c "SELECT version();"
+```
+
+#### From Application Container
+
+```bash
+# Connection string format
+postgresql://postgres:password@postgres-staging:5432/michaelschiemer_staging
+```
+
+### Backup Management
+
+#### Manual Backup
+
+```bash
+# Trigger manual backup
+docker exec postgres-staging-backup /scripts/backup.sh
+
+# List backups
+ls -lh backups/
+
+# Example output:
+# postgres_michaelschiemer_staging_20250130_030000.sql.gz
+```
+
+#### Restore from Backup
+
+```bash
+# List available backups
+docker exec postgres-staging-backup ls -lh /backups
+
+# Restore specific backup
+docker exec -it postgres-staging-backup /scripts/restore.sh /backups/postgres_michaelschiemer_staging_20250130_030000.sql.gz
+
+# ⚠️ WARNING: This will DROP and RECREATE the database!
+```
+
+## Network Isolation
+
+This stack uses its own isolated network:
+- **Network**: `postgres-staging-internal`
+- **Purpose**: Isolate Staging database from Production and other services
+- **Access**: Only services explicitly connected to this network can access the database
+
+**Connecting Application Stack**:
+```yaml
+# In docker-compose.staging.yml
+networks:
+  postgres-staging-internal:
+    external: true
+    name: postgres-staging-internal
+```
+
+## Security
+
+### Network Isolation
+- PostgreSQL only accessible via `postgres-staging-internal` network
+- No external ports exposed
+- Service-to-service communication only
+
+### Authentication
+- Strong password required (generated with `openssl rand -base64 32`)
+- No default passwords
+- Password stored in environment variables only
+
+**Note**: Staging passwords can be different from Production, but should still be secure.
+
+## Monitoring
+
+### Health Checks
+
+```bash
+# Check service health
+docker compose ps
+
+# Expected: Both services "healthy"
+
+# Manual health check
+docker exec postgres-staging pg_isready -U postgres -d michaelschiemer_staging
+```
+
+### Resource Usage
+
+```bash
+# Database container stats
+docker stats postgres-staging --no-stream
+
+# Disk usage
+docker exec postgres-staging du -sh /var/lib/postgresql/data
+```
+
+### Logs
+
+```bash
+# PostgreSQL logs
+docker compose logs postgres-staging
+
+# Backup logs
+docker compose logs postgres-staging-backup
+
+# Real-time monitoring
+docker compose logs -f
+```
+
+## Troubleshooting
+
+### Database Won't Start
+
+```bash
+# Check logs
+docker compose logs postgres-staging
+
+# Common issues:
+# 1. Invalid configuration
+docker exec postgres-staging postgres --check
+
+# 2. Permission issues
+docker exec postgres-staging ls -la /var/lib/postgresql/data
+```
+
+### Connection Refused from Application
+
+```bash
+# 1. Check PostgreSQL is running
+docker compose ps postgres-staging
+
+# 2. Verify network
+docker network inspect postgres-staging-internal | grep postgres-staging
+
+# 3. Check if application is connected to network
+docker network inspect postgres-staging-internal | grep staging-app
+```
+
+## Differences from Production Stack
+
+| Aspect | Production | Staging |
+|--------|-----------|---------|
+| **Container Name** | postgres-production | postgres-staging |
+| **Network** | postgres-production-internal | postgres-staging-internal |
+| **Volume** | postgres-production-data | postgres-staging-data |
+| **Database** | michaelschiemer | michaelschiemer_staging |
+| **Memory Limit** | 2GB | 1GB |
+| **Backup Retention** | 7 days | 3 days |
+| **Backup Schedule** | 2 AM | 3 AM |
+
+## Additional Resources
+
+- **PostgreSQL Documentation**: https://www.postgresql.org/docs/16/
+- **Performance Tuning**: https://wiki.postgresql.org/wiki/Performance_Optimization
+- **Backup Best Practices**: https://www.postgresql.org/docs/16/backup.html
+
diff --git a/deployment/stacks/postgresql-staging/conf.d/postgresql.conf b/deployment/stacks/postgresql-staging/conf.d/postgresql.conf
new file mode 100644
index 00000000..d753fa4a
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/conf.d/postgresql.conf
@@ -0,0 +1,70 @@
+# PostgreSQL Configuration for Production
+# Optimized for 2GB memory allocation
+
+# Connection Settings
+listen_addresses = '*'
+max_connections = 100
+superuser_reserved_connections = 3
+
+# Memory Settings (for 2GB allocation)
+shared_buffers = 512MB
+effective_cache_size = 1536MB
+maintenance_work_mem = 128MB
+work_mem = 5MB
+
+# Checkpoint Settings
+checkpoint_completion_target = 0.9
+wal_buffers = 16MB
+default_statistics_target = 100
+
+# Query Planner
+random_page_cost = 1.1
+effective_io_concurrency = 200
+
+# Write-Ahead Logging
+wal_level = replica
+max_wal_size = 2GB
+min_wal_size = 1GB
+
+# Logging
+log_destination = 'stderr'
+logging_collector = on
+log_directory = 'log'
+log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
+log_rotation_age = 1d
+log_rotation_size = 100MB
+log_line_prefix = '%m [%p] %u@%d '
+log_timezone = 'Europe/Berlin'
+
+# What to Log
+log_min_duration_statement = 1000
+log_checkpoints = on
+log_connections = on
+log_disconnections = on
+log_lock_waits = on
+log_statement = 'ddl'
+
+# Autovacuum
+autovacuum = on
+autovacuum_max_workers = 3
+autovacuum_naptime = 1min
+
+# Client Connection Defaults
+datestyle = 'iso, mdy'
+timezone = 'Europe/Berlin'
+lc_messages = 'en_US.utf8'
+lc_monetary = 'en_US.utf8'
+lc_numeric = 'en_US.utf8'
+lc_time = 'en_US.utf8'
+default_text_search_config = 'pg_catalog.english'
+
+# Lock Management
+deadlock_timeout = 1s
+
+# Statement Timeout (prevent long-running queries)
+statement_timeout = 30000  # 30 seconds
+
+# Parallel Query Execution
+max_parallel_workers_per_gather = 2
+max_parallel_workers = 4
+max_worker_processes = 4
diff --git a/deployment/stacks/postgresql-staging/docker-compose.yml b/deployment/stacks/postgresql-staging/docker-compose.yml
new file mode 100644
index 00000000..76bb55f1
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/docker-compose.yml
@@ -0,0 +1,72 @@
+services:
+  # PostgreSQL Staging Database
+  postgres-staging:
+    image: postgres:16-alpine
+    container_name: postgres-staging
+    restart: unless-stopped
+    networks:
+      - postgres-staging-internal
+    environment:
+      - TZ=Europe/Berlin
+      - POSTGRES_DB=${POSTGRES_DB:-michaelschiemer_staging}
+      - POSTGRES_USER=${POSTGRES_USER:-postgres}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - PGDATA=/var/lib/postgresql/data/pgdata
+    volumes:
+      - postgres-staging-data:/var/lib/postgresql/data
+      - ./conf.d:/etc/postgresql/conf.d:ro
+      - ./backups:/backups
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    command:
+      - postgres
+      - -c
+      - config_file=/etc/postgresql/conf.d/postgresql.conf
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres} -d ${POSTGRES_DB:-michaelschiemer_staging}"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    shm_size: 256mb
+    deploy:
+      resources:
+        limits:
+          memory: 1G
+        reservations:
+          memory: 256M
+
+  # Automated Backup Service for Staging
+  postgres-staging-backup:
+    image: postgres:16-alpine
+    container_name: postgres-staging-backup
+    restart: unless-stopped
+    networks:
+      - postgres-staging-internal
+    environment:
+      - TZ=Europe/Berlin
+      - POSTGRES_HOST=postgres-staging
+      - POSTGRES_DB=${POSTGRES_DB:-michaelschiemer_staging}
+      - POSTGRES_USER=${POSTGRES_USER:-postgres}
+      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+      - BACKUP_RETENTION_DAYS=${BACKUP_RETENTION_DAYS:-3}
+      - BACKUP_SCHEDULE=${BACKUP_SCHEDULE:-0 3 * * *}
+    volumes:
+      - ./backups:/backups
+      - ./scripts:/scripts:ro
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    entrypoint: ["/scripts/backup-entrypoint.sh"]
+    depends_on:
+      postgres-staging:
+        condition: service_healthy
+
+volumes:
+  postgres-staging-data:
+    name: postgres-staging-data
+
+networks:
+  postgres-staging-internal:
+    name: postgres-staging-internal
+    driver: bridge
+
diff --git a/deployment/stacks/postgresql-staging/scripts/backup-entrypoint.sh b/deployment/stacks/postgresql-staging/scripts/backup-entrypoint.sh
new file mode 100755
index 00000000..2f4bf896
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/scripts/backup-entrypoint.sh
@@ -0,0 +1,23 @@
+#!/bin/sh
+set -e
+
+echo "🔄 PostgreSQL Backup Service Starting..."
+echo "📅 Backup Schedule: ${BACKUP_SCHEDULE}"
+echo "🗑️  Retention: ${BACKUP_RETENTION_DAYS} days"
+
+# Install cronie for scheduled backups
+apk add --no-cache dcron
+
+# Create cron job
+echo "${BACKUP_SCHEDULE} /scripts/backup.sh >> /var/log/backup.log 2>&1" > /etc/crontabs/root
+
+# Ensure backup directory exists
+mkdir -p /backups
+
+# Run initial backup
+echo "🚀 Running initial backup..."
+/scripts/backup.sh
+
+# Start cron in foreground
+echo "✅ Backup service ready - cron daemon starting"
+crond -f -l 2
diff --git a/deployment/stacks/postgresql-staging/scripts/backup.sh b/deployment/stacks/postgresql-staging/scripts/backup.sh
new file mode 100755
index 00000000..01af31b0
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/scripts/backup.sh
@@ -0,0 +1,55 @@
+#!/bin/sh
+set -e
+
+# Configuration
+BACKUP_DIR="/backups"
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_FILE="${BACKUP_DIR}/postgres_${POSTGRES_DB}_${TIMESTAMP}.sql.gz"
+RETENTION_DAYS=${BACKUP_RETENTION_DAYS:-7}
+
+echo "======================================"
+echo "PostgreSQL Backup - $(date)"
+echo "======================================"
+
+# Wait for PostgreSQL to be ready
+until PGPASSWORD="${POSTGRES_PASSWORD}" pg_isready -h "${POSTGRES_HOST}" -U "${POSTGRES_USER}" -d "${POSTGRES_DB}"; do
+  echo "⏳ Waiting for PostgreSQL..."
+  sleep 5
+done
+
+echo "✅ PostgreSQL is ready"
+
+# Create backup
+echo "📦 Creating backup: ${BACKUP_FILE}"
+PGPASSWORD="${POSTGRES_PASSWORD}" pg_dump \
+  -h "${POSTGRES_HOST}" \
+  -U "${POSTGRES_USER}" \
+  -d "${POSTGRES_DB}" \
+  --clean \
+  --if-exists \
+  --create \
+  --no-owner \
+  --no-privileges \
+  | gzip > "${BACKUP_FILE}"
+
+# Verify backup was created
+if [ -f "${BACKUP_FILE}" ]; then
+  BACKUP_SIZE=$(du -h "${BACKUP_FILE}" | cut -f1)
+  echo "✅ Backup created successfully: ${BACKUP_SIZE}"
+else
+  echo "❌ Backup failed!"
+  exit 1
+fi
+
+# Cleanup old backups
+echo "🗑️  Cleaning up backups older than ${RETENTION_DAYS} days..."
+find "${BACKUP_DIR}" -name "postgres_*.sql.gz" -type f -mtime +${RETENTION_DAYS} -delete
+
+# List current backups
+echo ""
+echo "📊 Current backups:"
+ls -lh "${BACKUP_DIR}"/postgres_*.sql.gz 2>/dev/null || echo "No backups found"
+
+echo ""
+echo "✅ Backup completed successfully"
+echo "======================================"
diff --git a/deployment/stacks/postgresql-staging/scripts/restore.sh b/deployment/stacks/postgresql-staging/scripts/restore.sh
new file mode 100755
index 00000000..7269f5ad
--- /dev/null
+++ b/deployment/stacks/postgresql-staging/scripts/restore.sh
@@ -0,0 +1,55 @@
+#!/bin/sh
+set -e
+
+# Configuration
+BACKUP_DIR="/backups"
+
+if [ -z "$1" ]; then
+  echo "Usage: ./restore.sh <backup-file>"
+  echo ""
+  echo "Available backups:"
+  ls -lh "${BACKUP_DIR}"/postgres_*.sql.gz 2>/dev/null || echo "No backups found"
+  exit 1
+fi
+
+BACKUP_FILE="$1"
+
+if [ ! -f "${BACKUP_FILE}" ]; then
+  echo "❌ Backup file not found: ${BACKUP_FILE}"
+  exit 1
+fi
+
+echo "======================================"
+echo "PostgreSQL Restore - $(date)"
+echo "======================================"
+echo "📦 Backup file: ${BACKUP_FILE}"
+echo ""
+
+# Wait for PostgreSQL to be ready
+until PGPASSWORD="${POSTGRES_PASSWORD}" pg_isready -h "${POSTGRES_HOST}" -U "${POSTGRES_USER}" -d postgres; do
+  echo "⏳ Waiting for PostgreSQL..."
+  sleep 5
+done
+
+echo "✅ PostgreSQL is ready"
+echo ""
+
+# Warning
+echo "⚠️  WARNING: This will DROP and RECREATE the database!"
+echo "⚠️  Database: ${POSTGRES_DB}"
+echo ""
+echo "Press Ctrl+C to cancel, or wait 10 seconds to continue..."
+sleep 10
+
+echo ""
+echo "🔄 Restoring database..."
+
+# Restore backup
+gunzip -c "${BACKUP_FILE}" | PGPASSWORD="${POSTGRES_PASSWORD}" psql \
+  -h "${POSTGRES_HOST}" \
+  -U "${POSTGRES_USER}" \
+  -d postgres
+
+echo ""
+echo "✅ Database restored successfully"
+echo "======================================"
diff --git a/deployment/stacks/application/.env.example b/deployment/stacks/production/.env.example
similarity index 100%
rename from deployment/stacks/application/.env.example
rename to deployment/stacks/production/.env.example
diff --git a/deployment/stacks/application/README.md b/deployment/stacks/production/README.md
similarity index 97%
rename from deployment/stacks/application/README.md
rename to deployment/stacks/production/README.md
index 133b90f4..1bc524b0 100644
--- a/deployment/stacks/application/README.md
+++ b/deployment/stacks/production/README.md
@@ -49,8 +49,8 @@ docker build -t registry.michaelschiemer.de/michaelschiemer-app:latest .
 docker push registry.michaelschiemer.de/michaelschiemer-app:latest
 ```
 
-### 5. Database Available
-Stack 5 (PostgreSQL/MySQL) must be running or external database configured.
+### 5. PostgreSQL Production Stack Available
+The separate `postgresql-production` stack must be running. See `deployment/stacks/postgresql-production/README.md` for setup.
 
 ## Configuration
 
@@ -278,10 +278,13 @@ docker compose pull app queue-worker scheduler
 docker compose up -d --force-recreate app queue-worker scheduler
 ```
 
-### Stack 5: Database (PostgreSQL or MySQL)
+### Database Stack: PostgreSQL Production (Separate Stack)
 
 **Connection**:
-- Database service must be on same Docker network or externally accessible
+- Production Application Stack connects to separate `postgresql-production` stack
+- Database container: `postgres-production`
+- Network: `postgres-production-internal`
+- Database service must be on same Docker network (`postgres-production-internal`)
 - Connection configured via DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS
 
 **Run Migrations**:
diff --git a/deployment/stacks/application/nginx/conf.d/default.conf b/deployment/stacks/production/nginx/conf.d/default.conf
similarity index 100%
rename from deployment/stacks/application/nginx/conf.d/default.conf
rename to deployment/stacks/production/nginx/conf.d/default.conf
diff --git a/deployment/stacks/redis/.env.example b/deployment/stacks/redis/.env.example
new file mode 100644
index 00000000..fac79d9c
--- /dev/null
+++ b/deployment/stacks/redis/.env.example
@@ -0,0 +1,8 @@
+# Redis Stack Environment Configuration
+# Copy to .env and adjust for your environment
+
+# Redis Password (REQUIRED in production)
+REDIS_PASSWORD=your-secure-redis-password-here
+
+# Timezone
+TZ=Europe/Berlin
diff --git a/deployment/stacks/redis/README.md b/deployment/stacks/redis/README.md
new file mode 100644
index 00000000..3209c7fa
--- /dev/null
+++ b/deployment/stacks/redis/README.md
@@ -0,0 +1,291 @@
+# Redis Stack
+
+External Redis Stack for the Custom PHP Framework application.
+
+## Overview
+
+This Redis Stack provides:
+- **Cache Backend**: Application-level caching (sessions, query results, objects)
+- **Queue Backend**: Background job queue storage
+- **Session Storage**: User session persistence
+- **Rate Limiting**: Request rate limiting storage
+
+**Architecture Pattern**: Following the same external stack pattern as PostgreSQL for consistency and separation of concerns.
+
+## Quick Start
+
+```bash
+# 1. Create environment configuration
+cp .env.example .env
+
+# 2. Set Redis password
+echo "REDIS_PASSWORD=$(openssl rand -base64 32)" >> .env
+
+# 3. Create app-internal network (if not exists)
+docker network create app-internal
+
+# 4. Start Redis Stack
+docker compose up -d
+
+# 5. Verify health
+docker compose ps
+docker compose exec redis-stack redis-cli ping
+# Expected: PONG
+```
+
+## Configuration
+
+### Environment Variables
+
+```env
+REDIS_PASSWORD=your-secure-password   # Required for production
+TZ=Europe/Berlin                      # Timezone for logs
+```
+
+### Redis Configuration
+
+Redis configuration is in `redis.conf` with production-optimized settings:
+
+**Persistence:**
+- RDB Snapshots: 15min/5min/1min intervals
+- AOF (Append Only File): `everysec` fsync policy
+- Combined persistence for data durability
+
+**Memory Management:**
+- Max Memory: 512MB (configurable)
+- Eviction Policy: `allkeys-lru` (Least Recently Used)
+- Lazy freeing for async deletion
+
+**Performance:**
+- TCP keepalive: 300s
+- Active rehashing enabled
+- Optimized client output buffers
+
+### Security
+
+**Password Protection:**
+```bash
+# Set via Docker Secrets (recommended)
+echo "your-redis-password" | docker secret create redis_password -
+
+# Or via environment variable
+REDIS_PASSWORD=your-password docker compose up -d
+```
+
+**Network Isolation:**
+- Only accessible via `app-internal` Docker network
+- Not exposed to public internet
+- Protected mode enabled
+
+## Health Monitoring
+
+```bash
+# Check Redis health
+docker compose exec redis-stack redis-cli ping
+
+# Get Redis info
+docker compose exec redis-stack redis-cli info
+
+# Monitor real-time activity
+docker compose exec redis-stack redis-cli monitor
+
+# Check memory usage
+docker compose exec redis-stack redis-cli info memory
+
+# View slow queries
+docker compose exec redis-stack redis-cli slowlog get 10
+```
+
+## Integration with Application Stack
+
+### Production Setup
+
+```bash
+# In application root directory
+docker compose \
+  -f docker-compose.base.yml \
+  -f docker-compose.production.yml \
+  -f docker-compose.postgres-override.yml \
+  -f docker-compose.redis-override.yml \
+  up -d
+```
+
+### Application Environment Variables
+
+```env
+REDIS_HOST=redis-stack      # Container name from this stack
+REDIS_PORT=6379
+REDIS_PASSWORD=your-password  # Same as Redis Stack password
+```
+
+## Maintenance
+
+### Backup
+
+Redis persistence is handled automatically via:
+- **RDB**: Snapshot backups in `/data/dump.rdb`
+- **AOF**: Append-only log in `/data/appendonly.aof`
+
+**Manual Backup:**
+```bash
+# Trigger immediate RDB snapshot
+docker compose exec redis-stack redis-cli BGSAVE
+
+# Copy backup files
+docker cp redis-stack:/data/dump.rdb ./backups/redis-$(date +%Y%m%d).rdb
+```
+
+### Restore
+
+```bash
+# Stop Redis
+docker compose stop redis-stack
+
+# Restore backup
+docker cp ./backups/redis-backup.rdb redis-stack:/data/dump.rdb
+
+# Start Redis
+docker compose start redis-stack
+```
+
+### Cleanup
+
+```bash
+# Clear specific database
+docker compose exec redis-stack redis-cli -n 0 FLUSHDB
+
+# Clear all databases (DANGEROUS!)
+docker compose exec redis-stack redis-cli FLUSHALL
+
+# Remove old AOF/RDB files
+docker compose exec redis-stack sh -c "rm -f /data/*.aof.old /data/*.rdb.old"
+```
+
+## Performance Tuning
+
+### Memory Optimization
+
+```bash
+# Check memory fragmentation
+docker compose exec redis-stack redis-cli info memory | grep fragmentation
+
+# Defragment if needed (Redis 4.0+)
+docker compose exec redis-stack redis-cli MEMORY PURGE
+```
+
+### Connection Limits
+
+Adjust `maxclients` in `redis.conf` based on your application needs:
+```conf
+maxclients 10000  # Default, increase if needed
+```
+
+### Persistence Trade-offs
+
+**For Cache-Only Usage:**
+```conf
+# Disable persistence for maximum performance
+save ""
+appendonly no
+```
+
+**For Critical Data:**
+```conf
+# More frequent snapshots
+save 300 1
+save 60 10
+appendfsync always  # Slower but safest
+```
+
+## Troubleshooting
+
+### Connection Issues
+
+```bash
+# Test connection from application container
+docker exec php sh -c 'redis-cli -h redis-stack -a $REDIS_PASSWORD ping'
+
+# Check network connectivity
+docker network inspect app-internal
+```
+
+### Memory Issues
+
+```bash
+# Check current memory usage
+docker compose exec redis-stack redis-cli info memory
+
+# View evicted keys
+docker compose exec redis-stack redis-cli info stats | grep evicted
+
+# Increase memory limit (edit docker-compose.yml)
+# deploy.resources.limits.memory: 1G
+```
+
+### Performance Issues
+
+```bash
+# Check slow queries
+docker compose exec redis-stack redis-cli slowlog get 10
+
+# Monitor commands in real-time
+docker compose exec redis-stack redis-cli monitor
+
+# Analyze key patterns
+docker compose exec redis-stack redis-cli --bigkeys
+```
+
+## Architecture
+
+### Network Topology
+
+```
+┌─────────────────────────────────────────┐
+│          app-internal Network           │
+│                                         │
+│  ┌──────────┐         ┌──────────────┐ │
+│  │   PHP    │────────▶│ redis-stack  │ │
+│  │   App    │         │   (Cache)    │ │
+│  └──────────┘         └──────────────┘ │
+│                                         │
+│  ┌──────────┐                           │
+│  │  Queue   │────────▶                  │
+│  │  Worker  │         (Shared Redis)    │
+│  └──────────┘                           │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+### Data Separation
+
+**Database Indexes:**
+- DB 0: Application cache (default)
+- DB 1: Session storage
+- DB 2: Queue backend
+- DB 3: Rate limiting
+- DB 4-15: Available for other uses
+
+## Best Practices
+
+1. **Always use passwords** in production
+2. **Monitor memory usage** - set appropriate `maxmemory` limit
+3. **Enable persistence** for critical data (sessions, queue)
+4. **Regular backups** if using Redis as primary data store
+5. **Network isolation** - never expose Redis port publicly
+6. **Health checks** - monitor Redis availability
+7. **Resource limits** - set Docker memory limits
+8. **Logging** - check Redis logs for issues
+
+## Related Documentation
+
+- [Application Docker Compose](../../docker-compose.production.yml)
+- [Redis Override Configuration](../../docker-compose.redis-override.yml)
+- [PostgreSQL Stack](../postgresql/README.md) (similar pattern)
+- [Redis Official Documentation](https://redis.io/documentation)
+
+## Support
+
+For issues or questions:
+- Check Redis logs: `docker compose logs redis-stack`
+- Test connectivity: `docker compose exec redis-stack redis-cli ping`
+- Review configuration: `docker compose exec redis-stack redis-cli config get '*'`
diff --git a/deployment/stacks/redis/docker-compose.yml b/deployment/stacks/redis/docker-compose.yml
new file mode 100644
index 00000000..a340bb60
--- /dev/null
+++ b/deployment/stacks/redis/docker-compose.yml
@@ -0,0 +1,37 @@
+services:
+  # Redis Cache & Queue Backend
+  redis-stack:
+    image: redis:7-alpine
+    container_name: redis-stack
+    restart: unless-stopped
+    networks:
+      - app-internal
+    environment:
+      - TZ=Europe/Berlin
+    volumes:
+      - redis-data:/data
+      - ./redis.conf:/usr/local/etc/redis/redis.conf:ro
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    command: >
+      redis-server /usr/local/etc/redis/redis.conf
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+        reservations:
+          memory: 128M
+
+volumes:
+  redis-data:
+    name: redis-data
+
+networks:
+  app-internal:
+    external: true
diff --git a/deployment/stacks/redis/redis.conf b/deployment/stacks/redis/redis.conf
new file mode 100644
index 00000000..256cde73
--- /dev/null
+++ b/deployment/stacks/redis/redis.conf
@@ -0,0 +1,81 @@
+# Redis Configuration for Production Stack
+# Based on Redis 7.x best practices
+
+# Network Configuration
+bind 0.0.0.0
+port 6379
+tcp-backlog 511
+timeout 0
+tcp-keepalive 300
+
+# General Settings
+daemonize no
+supervised no
+pidfile /var/run/redis.pid
+loglevel notice
+databases 16
+
+# Persistence Configuration
+# RDB Snapshots
+# After 900 sec (15 min) if at least 1 key changed
+save 900 1
+# After 300 sec (5 min) if at least 10 keys changed
+save 300 10
+# After 60 sec if at least 10000 keys changed
+save 60 10000
+
+stop-writes-on-bgsave-error yes
+rdbcompression yes
+rdbchecksum yes
+dbfilename dump.rdb
+dir /data
+
+# AOF Persistence (Append Only File)
+appendonly yes
+appendfilename "appendonly.aof"
+appendfsync everysec
+no-appendfsync-on-rewrite no
+auto-aof-rewrite-percentage 100
+auto-aof-rewrite-min-size 64mb
+
+# Memory Management
+maxmemory 512mb
+maxmemory-policy allkeys-lru
+maxmemory-samples 5
+
+# Lazy Freeing (async deletion)
+lazyfree-lazy-eviction yes
+lazyfree-lazy-expire yes
+lazyfree-lazy-server-del yes
+replica-lazy-flush yes
+
+# Security
+# NOTE: Password should be set via REDIS_PASSWORD environment variable
+# requirepass will be set via redis-cli CONFIG SET after startup
+protected-mode yes
+
+# Limits
+maxclients 10000
+
+# Slow Log
+slowlog-log-slower-than 10000
+slowlog-max-len 128
+
+# Advanced Config
+hash-max-ziplist-entries 512
+hash-max-ziplist-value 64
+list-max-ziplist-size -2
+set-max-intset-entries 512
+zset-max-ziplist-entries 128
+zset-max-ziplist-value 64
+
+# Performance Tuning
+activerehashing yes
+client-output-buffer-limit normal 0 0 0
+client-output-buffer-limit replica 256mb 64mb 60
+client-output-buffer-limit pubsub 32mb 8mb 60
+
+# Disable dangerous commands (optional)
+# rename-command FLUSHDB ""
+# rename-command FLUSHALL ""
+# rename-command CONFIG ""
diff --git a/deployment/stacks/registry/auth/htpasswd b/deployment/stacks/registry/auth/htpasswd
new file mode 100644
index 00000000..8b3a69b5
--- /dev/null
+++ b/deployment/stacks/registry/auth/htpasswd
@@ -0,0 +1,2 @@
+admin:$2y$05$frHsEHd3NmM.LUMZ86dJe.aAZK5D5Qoh1w0mnXY0pfbbFmtU8aD5y
+
diff --git a/deployment/stacks/staging/README.md b/deployment/stacks/staging/README.md
index 6504129c..975c8913 100644
--- a/deployment/stacks/staging/README.md
+++ b/deployment/stacks/staging/README.md
@@ -24,11 +24,17 @@ Separate staging environment for testing features before production deployment.
 ## Prerequisites
 
 1. **Traefik Stack Running** (shared with production)
-2. **DNS Configuration**: `staging.michaelschiemer.de` points to server IP
-3. **Docker Networks**:
+2. **PostgreSQL Staging Stack Running** (separate from production)
+   ```bash
+   cd ../postgresql-staging
+   docker compose up -d
+   ```
+3. **DNS Configuration**: `staging.michaelschiemer.de` points to server IP
+4. **Docker Networks**:
    ```bash
    docker network create traefik-public  # Shared with production
    docker network create staging-internal  # Staging-only
+   docker network create postgres-staging-internal  # Staging database network
    ```
 
 ## Configuration
@@ -47,9 +53,9 @@ APP_ENV=staging
 APP_DEBUG=true
 APP_URL=https://staging.michaelschiemer.de
 
-# Database (can use separate staging DB or share)
+# Database - using separate staging database stack
 DB_DATABASE=michaelschiemer_staging
-DB_HOST=postgres
+DB_HOST=postgres-staging
 DB_PORT=5432
 DB_USERNAME=postgres
 DB_PASSWORD=<password>
@@ -124,7 +130,8 @@ docker compose logs -f staging-nginx
 | **APP_ENV** | production | staging |
 | **APP_DEBUG** | false | true |
 | **Redis** | Separate instance | Separate instance |
-| **Database** | michaelschiemer | michaelschiemer_staging |
+| **Database** | michaelschiemer (postgres-production) | michaelschiemer_staging (postgres-staging) |
+| **Database Stack** | postgresql-production (separate) | postgresql-staging (separate) |
 | **Volumes** | app-* | staging-* |
 | **Network** | app-internal | staging-internal |
 
diff --git a/deployment/stacks/traefik/README.md b/deployment/stacks/traefik/README.md
index 28fae4cb..1ed0f229 100644
--- a/deployment/stacks/traefik/README.md
+++ b/deployment/stacks/traefik/README.md
@@ -11,10 +11,9 @@ Traefik acts as the central reverse proxy for all services, handling:
 
 ## Services
 
-- **traefik.michaelschiemer.de** - Traefik Dashboard (VPN-only + BasicAuth protected)
-  - ?? **Nur ?ber WireGuard VPN erreichbar** (10.8.0.0/24)
-  - Zus?tzlich durch BasicAuth gesch?tzt
-  - ?ffentlicher Zugriff ist blockiert
+- **traefik.michaelschiemer.de** - Traefik Dashboard (BasicAuth protected)
+  - Protected by BasicAuth authentication
+  - Accessible via HTTPS with Let's Encrypt certificate
 
 ## Local Development
 
@@ -33,7 +32,8 @@ docker compose -f docker-compose.local.yml up -d
 # Check logs
 docker compose -f docker-compose.local.yml logs -f
 
-# Access dashboard at http://localhost:8080/dashboard/
+# Access dashboard at http://localhost:8093/dashboard/
+# Note: Dashboard is served on the API port (8093) when api.insecure=true
 ```
 
 ### Local Development Configuration
@@ -41,11 +41,12 @@ docker compose -f docker-compose.local.yml logs -f
 The local configuration (`docker-compose.local.yml` and `traefik.local.yml`) differs from production:
 
 - **Bridge network** instead of `host` mode (avoids port conflicts)
-- **Port mappings**: `8080:80` only (HTTP-only for local development)
+- **Port mappings**: `8081:80` (HTTP) and `8093:8080` (API/Dashboard)
    - Note: HTTPS not needed locally - avoids port conflicts with web container (8443:443)
 - **HTTP-only** (no ACME/Let's Encrypt) for local development
-- **Dashboard**: Accessible at `http://localhost:8080/dashboard/` (HTTP, no authentication)
-   - Also available: `http://localhost:8080/api/rawdata` and `http://localhost:8080/api/http/routers`
+- **Dashboard**: Accessible at `http://localhost:8093/dashboard/` (HTTP, no authentication)
+   - Also available: `http://localhost:8093/api/rawdata` and `http://localhost:8093/api/http/routers`
+   - Note: Dashboard is served on the API port (8093) when `api.insecure=true` in `traefik.local.yml`
 - **No `acme.json`** required
 - **Console logging** (human-readable) instead of JSON file logs
 
@@ -53,18 +54,18 @@ The local configuration (`docker-compose.local.yml` and `traefik.local.yml`) dif
 
 | Feature | Local (`docker-compose.local.yml`) | Production (`docker-compose.yml`) |
 |---------|-----------------------------------|----------------------------------|
-| Network Mode | Bridge | Host |
-| Ports | 8080:80 (HTTP only) | Direct binding (80, 443) |
+| Network Mode | Bridge | Bridge |
+| Ports | 8081:80, 8093:8080 (HTTP only) | 80:80, 443:443, 2222:2222 |
 | SSL/TLS | HTTP-only | HTTPS with Let's Encrypt |
-| Dashboard | `http://localhost:8080/dashboard/` | `https://traefik.michaelschiemer.de` |
-| Authentication | None (local dev) | VPN + BasicAuth |
+| Dashboard | `http://localhost:8093/dashboard/` | `https://traefik.michaelschiemer.de` |
+| Authentication | None (local dev) | BasicAuth |
 | Logging | Console (human-readable) | JSON files |
 | ACME | Disabled | Enabled |
 
 ### Troubleshooting Local Development
 
 **Container restarts in loop:**
-- Check if port 8080 is already in use: `netstat -tlnp | grep ':8080' || ss -tlnp | grep ':8080'`
+- Check if ports 8081 or 8093 are already in use: `netstat -tlnp | grep -E ':(8081|8093)' || ss -tlnp | grep -E ':(8081|8093)'`
 - Verify Docker network exists: `docker network ls | grep traefik-public`
 - Check logs: `docker compose -f docker-compose.local.yml logs -f traefik`
 
diff --git a/deployment/stacks/traefik/docker-compose.local.yml b/deployment/stacks/traefik/docker-compose.local.yml
index f81fa163..eeeb66ab 100644
--- a/deployment/stacks/traefik/docker-compose.local.yml
+++ b/deployment/stacks/traefik/docker-compose.local.yml
@@ -3,7 +3,7 @@
 #
 # This configuration is optimized for local development:
 # - Bridge network instead of host mode
-# - Port mapping: 8080:80 (HTTP only - HTTPS not needed for local dev)
+# - Port mappings: 8081:80 (HTTP) and 8093:8080 (API/Dashboard)
 #   Note: 8443:443 is used by the web container, and we don't need HTTPS for Traefik locally
 # - No ACME/Let's Encrypt (HTTP-only)
 # - Simplified healthcheck
@@ -24,6 +24,9 @@ services:
       - "8093:8080" # Traefik API entrypoint (for api.insecure=true dashboard)
     environment:
       - TZ=Europe/Berlin
+    command:
+      # Load static configuration file
+      - "--configFile=/traefik.yml"
     volumes:
       # Docker socket for service discovery
       - /var/run/docker.sock:/var/run/docker.sock:ro
@@ -42,10 +45,8 @@ services:
       # For now, we'll try without labels and see if api.insecure=true works directly.
       - "traefik.enable=true"
     healthcheck:
-      # Use wget or curl to check Traefik ping endpoint
-      # The ping endpoint is configured in traefik.local.yml on the 'web' entrypoint
-      # Try ping endpoint first, if that fails, try API endpoint
-      test: ["CMD-SHELL", "wget --quiet --spider http://localhost:80/ping || wget --quiet --spider http://localhost:80/api/rawdata || exit 1"]
+      # Use Traefik's built-in healthcheck command (works in minimal image)
+      test: ["CMD", "traefik", "healthcheck", "--ping"]
       interval: 30s
       timeout: 10s
       retries: 3
diff --git a/deployment/stacks/traefik/dynamic/gitea-router.yml b/deployment/stacks/traefik/dynamic/gitea-router.yml
new file mode 100644
index 00000000..31e9fb5e
--- /dev/null
+++ b/deployment/stacks/traefik/dynamic/gitea-router.yml
@@ -0,0 +1,17 @@
+# Gitea Router Configuration
+# Router definition for Gitea using File Provider
+
+http:
+  routers:
+    gitea:
+      rule: Host(`git.michaelschiemer.de`)
+      entryPoints:
+        - websecure
+      service: gitea
+      tls:
+        certResolver: letsencrypt
+      middlewares:
+        - security-headers-global
+        - gzip-compression
+      priority: 100
+
diff --git a/deployment/stacks/traefik/dynamic/gitea-service.yml b/deployment/stacks/traefik/dynamic/gitea-service.yml.disabled
similarity index 100%
rename from deployment/stacks/traefik/dynamic/gitea-service.yml
rename to deployment/stacks/traefik/dynamic/gitea-service.yml.disabled
diff --git a/deployment/stacks/traefik/dynamic/gitea-ssh.yml b/deployment/stacks/traefik/dynamic/gitea-ssh.yml
index d7505b71..25d95262 100644
--- a/deployment/stacks/traefik/dynamic/gitea-ssh.yml
+++ b/deployment/stacks/traefik/dynamic/gitea-ssh.yml
@@ -1,5 +1,7 @@
 # TCP Router Configuration for Gitea SSH
 # Routes SSH traffic on port 2222 to Gitea container
+# Note: Gitea SSH is handled via port mapping in docker-compose.yml
+# This file is kept for reference but may not be needed
 
 tcp:
   routers:
@@ -13,8 +15,5 @@ tcp:
     gitea-ssh-service:
       loadBalancer:
         servers:
-          # Gitea container SSH service
-          # Note: Using container IP from gitea_gitea-internal network
-          # Traefik runs in host network mode, so we need the actual container IP
-          # IP address: 172.23.0.3 (gitea_gitea-internal network)
-          - address: "172.23.0.3:22"
+          # Use container name in bridge network mode
+          - address: "gitea:22"
diff --git a/deployment/stacks/traefik/dynamic/gitea.yml b/deployment/stacks/traefik/dynamic/gitea.yml
deleted file mode 100644
index c201aee7..00000000
--- a/deployment/stacks/traefik/dynamic/gitea.yml
+++ /dev/null
@@ -1,20 +0,0 @@
-# Gitea configuration is now handled via Docker labels in docker-compose.yml
-# This file is kept for reference but is not used
-# Traefik will automatically discover Gitea via Docker labels and use the container IP
-# when running in host network mode
-#
-# http:
-#   routers:
-#     gitea:
-#       rule: Host(`git.michaelschiemer.de`)
-#       entrypoints:
-#         - websecure
-#       service: gitea
-#       tls:
-#         certResolver: letsencrypt
-#       priority: 100
-#   services:
-#     gitea:
-#       loadBalancer:
-#         servers:
-#           - url: http://gitea:3000
diff --git a/deployment/stacks/traefik/dynamic/middlewares.yml b/deployment/stacks/traefik/dynamic/middlewares.yml
index 74f8aaef..e6fadc78 100644
--- a/deployment/stacks/traefik/dynamic/middlewares.yml
+++ b/deployment/stacks/traefik/dynamic/middlewares.yml
@@ -43,14 +43,6 @@ http:
         average: 200
         burst: 100
         period: 1s
-
-    # IP whitelist for admin services (example)
-    # Uncomment and adjust for production
-    # admin-whitelist:
-    #   ipWhiteList:
-    #     sourceRange:
-    #       - "127.0.0.1/32"
-    #       - "10.0.0.0/8"
     
     # Chain multiple middlewares
     default-chain:
@@ -65,4 +57,3 @@ http:
           - security-headers-global
           - gzip-compression
           - rate-limit-strict
-          # - admin-whitelist  # Uncomment for IP whitelisting
diff --git a/deployment/wireguard-old/add-wireguard-client.yml b/deployment/wireguard-old/add-wireguard-client.yml
deleted file mode 100755
index 1101d4ee..00000000
--- a/deployment/wireguard-old/add-wireguard-client.yml
+++ /dev/null
@@ -1,205 +0,0 @@
----
-- name: Add WireGuard Client
-  hosts: production
-  become: yes
-  gather_facts: yes
-
-  vars:
-    wireguard_interface: "wg0"
-    wireguard_config_path: "/etc/wireguard"
-    wireguard_config_file: "{{ wireguard_config_path }}/{{ wireguard_interface }}.conf"
-    wireguard_client_configs_path: "/etc/wireguard/clients"
-    wireguard_local_client_configs_dir: "{{ playbook_dir }}/../wireguard-clients"
-    wireguard_dns_servers: []
-
-  pre_tasks:
-    - name: Set WireGuard network
-      set_fact:
-        wireguard_network: "{{ wireguard_network | default('10.8.0.0/24') }}"
-
-    - name: Set WireGuard other variables with defaults
-      set_fact:
-        wireguard_port: "{{ wireguard_port | default(51820) }}"
-        client_ip: "{{ client_ip | default('') }}"
-        # IMPORTANT: Default to VPN network only (not 0.0.0.0/0)
-        # This ensures SSH access via normal IP remains available
-        allowed_ips: "{{ allowed_ips | default(wireguard_network) }}"
-
-  tasks:
-    - name: Validate client name
-      fail:
-        msg: "client_name is required. Usage: ansible-playbook ... -e 'client_name=myclient'"
-      when: client_name is not defined or client_name == ""
-
-    - name: Get server external IP address
-      uri:
-        url: https://api.ipify.org
-        return_content: yes
-      register: server_external_ip
-      changed_when: false
-      failed_when: false
-
-    - name: Set server external IP
-      set_fact:
-        server_external_ip_content: "{{ ansible_host | default(server_external_ip.content | default('')) }}"
-
-    - name: Check if WireGuard config exists
-      stat:
-        path: "{{ wireguard_config_file }}"
-      register: wireguard_config_exists
-
-    - name: Fail if WireGuard not configured
-      fail:
-        msg: "WireGuard server not configured. Please run setup-wireguard.yml first."
-      when: not wireguard_config_exists.stat.exists
-
-    - name: Read WireGuard server config
-      slurp:
-        src: "{{ wireguard_config_file }}"
-      register: wireguard_server_config_read
-
-    - name: Extract server IP from config
-      set_fact:
-        server_vpn_ip: "{{ (wireguard_server_config_read.content | b64decode | regex_search('Address = ([0-9.]+)', '\\1')) | first | default('10.8.0.1') }}"
-
-    - name: Extract WireGuard server IP octets
-      set_fact:
-        wireguard_server_ip_octets: "{{ server_vpn_ip.split('.') }}"
-      when: client_ip == ""
-
-    - name: Gather existing client addresses
-      set_fact:
-        existing_client_ips: "{{ (wireguard_server_config_read.content | b64decode | regex_findall('AllowedIPs = ([0-9A-Za-z.]+)/32', '\\1')) }}"
-      when: client_ip == ""
-
-    - name: Calculate client IP if not provided
-      vars:
-        existing_last_octets: "{{ (existing_client_ips | default([])) | map('regex_replace', '^(?:\\d+\\.\\d+\\.\\d+\\.)', '') | select('match', '^[0-9]+$') | map('int') | list }}"
-        server_last_octet: "{{ wireguard_server_ip_octets[3] | int }}"
-        next_octet_candidate: "{{ (existing_last_octets + [server_last_octet]) | map('int') | list | max + 1 if (existing_last_octets + [server_last_octet]) else server_last_octet + 1 }}"
-      set_fact:
-        client_ip: "{{ [
-          wireguard_server_ip_octets[0],
-          wireguard_server_ip_octets[1],
-          wireguard_server_ip_octets[2],
-          next_octet_candidate
-        ] | join('.') }}"
-      when: client_ip == ""
-
-    - name: Generate client private key
-      command: "wg genkey"
-      register: client_private_key
-      changed_when: true
-      no_log: yes
-
-    - name: Generate client public key
-      command: "wg pubkey"
-      args:
-        stdin: "{{ client_private_key.stdout }}"
-      register: client_public_key
-      changed_when: false
-      no_log: yes
-
-    - name: Add client to WireGuard server config
-      blockinfile:
-        path: "{{ wireguard_config_file }}"
-        block: |
-          # Client: {{ client_name }}
-          [Peer]
-          PublicKey = {{ client_public_key.stdout }}
-          AllowedIPs = {{ client_ip }}/32
-        marker: "# {mark} ANSIBLE MANAGED BLOCK - Client: {{ client_name }}"
-      register: wireguard_client_block
-
-    - name: Ensure client configs directory exists
-      file:
-        path: "{{ wireguard_client_configs_path }}"
-        state: directory
-        mode: '0700'
-        owner: root
-        group: root
-
-    - name: Ensure local client configs directory exists
-      file:
-        path: "{{ wireguard_local_client_configs_dir }}"
-        state: directory
-        mode: '0700'
-      delegate_to: localhost
-      become: no
-      run_once: true
-
-    - name: Get server public key
-      shell: "cat {{ wireguard_config_path }}/{{ wireguard_interface }}_private.key | wg pubkey"
-      register: server_public_key_cmd
-      changed_when: false
-      no_log: yes
-      failed_when: false
-
-    - name: Create client configuration file
-      template:
-        src: "{{ playbook_dir }}/../templates/wireguard-client.conf.j2"
-        dest: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-        mode: '0600'
-        owner: root
-        group: root
-
-    - name: Download client configuration to control machine
-      fetch:
-        src: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-        dest: "{{ wireguard_local_client_configs_dir }}/{{ client_name }}.conf"
-        flat: yes
-        mode: '0600'
-
-    - name: Ensure local client configuration has strict permissions
-      file:
-        path: "{{ wireguard_local_client_configs_dir }}/{{ client_name }}.conf"
-        mode: '0600'
-      delegate_to: localhost
-      become: no
-
-    - name: Read WireGuard server config to find server IP
-      slurp:
-        src: "{{ wireguard_config_file }}"
-      register: wireguard_server_config_read
-
-    - name: Restart WireGuard service
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-        state: restarted
-      when: wireguard_client_block.changed
-
-    - name: Display client configuration
-      debug:
-        msg: |
-          ========================================
-          WireGuard Client Added: {{ client_name }}
-          ========================================
-          
-          Client Configuration File:
-          {{ wireguard_client_configs_path }}/{{ client_name }}.conf
-
-          Local Copy:
-          {{ wireguard_local_client_configs_dir }}/{{ client_name }}.conf
-          
-          Client IP: {{ client_ip }}
-          Server Endpoint: {{ server_external_ip_content }}:{{ wireguard_port }}
-          
-          To use this configuration:
-          1. Copy the config file to your client machine
-          2. Install WireGuard client
-          3. Run: sudo wg-quick up {{ client_name }}
-          
-          Or scan the QR code (if qrencode installed):
-          qrencode -t ansiutf8 < {{ wireguard_client_configs_path }}/{{ client_name }}.conf
-          ========================================
-
-    - name: Generate QR code for client config
-      command: "qrencode -t ansiutf8 -r {{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-      register: qr_code
-      changed_when: false
-      failed_when: false
-
-    - name: Display QR code
-      debug:
-        msg: "{{ qr_code.stdout }}"
-      when: qr_code.rc == 0
diff --git a/deployment/wireguard-old/regenerate-wireguard-client.yml b/deployment/wireguard-old/regenerate-wireguard-client.yml
deleted file mode 100644
index ff695876..00000000
--- a/deployment/wireguard-old/regenerate-wireguard-client.yml
+++ /dev/null
@@ -1,206 +0,0 @@
----
-- name: Regenerate WireGuard Client - Fresh Config
-  hosts: production
-  become: yes
-  gather_facts: yes
-
-  vars:
-    wireguard_interface: "wg0"
-    wireguard_config_path: "/etc/wireguard"
-    wireguard_config_file: "{{ wireguard_config_path }}/{{ wireguard_interface }}.conf"
-    wireguard_client_configs_path: "/etc/wireguard/clients"
-    wireguard_local_client_configs_dir: "{{ playbook_dir }}/../wireguard-clients"
-
-  tasks:
-    - name: Validate client name
-      fail:
-        msg: "client_name is required. Usage: ansible-playbook ... -e 'client_name=myclient'"
-      when: client_name is not defined or client_name == ""
-
-    - name: Check if old client config exists
-      stat:
-        path: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-      register: old_client_config
-      failed_when: false
-
-    - name: Backup old client config
-      copy:
-        src: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-        dest: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf.backup-{{ ansible_date_time.epoch }}"
-        remote_src: yes
-      when: old_client_config.stat.exists
-      register: backup_result
-      failed_when: false
-
-    - name: Display backup info
-      debug:
-        msg: "Alte Config wurde gesichert als: {{ backup_result.dest | default('N/A') }}"
-      when: old_client_config.stat.exists
-
-    - name: Remove old client from WireGuard server config
-      shell: |
-        # Entferne den [Peer] Block f?r den Client aus wg0.conf
-        sed -i '/# BEGIN ANSIBLE MANAGED BLOCK - Client: {{ client_name }}/,/^# END ANSIBLE MANAGED BLOCK - Client: {{ client_name }}/d' {{ wireguard_config_file }}
-        # Fallback: Entferne auch ohne Marker
-        sed -i '/# Client: {{ client_name }}/,/{/d' {{ wireguard_config_file }}
-        sed -i '/PublicKey = .*/d' {{ wireguard_config_file }} || true
-        sed -i '/AllowedIPs = .*\/32$/d' {{ wireguard_config_file }} || true
-      args:
-        executable: /bin/bash
-      register: remove_result
-      failed_when: false
-      changed_when: false
-
-    - name: Set WireGuard network
-      set_fact:
-        wireguard_network: "{{ wireguard_network | default('10.8.0.0/24') }}"
-
-    - name: Set WireGuard other variables with defaults
-      set_fact:
-        wireguard_port: "{{ wireguard_port | default(51820) }}"
-        client_ip: "{{ client_ip | default('') }}"
-        allowed_ips: "{{ allowed_ips | default(wireguard_network) }}"
-
-    - name: Get server external IP address
-      uri:
-        url: https://api.ipify.org
-        return_content: yes
-      register: server_external_ip
-      changed_when: false
-      failed_when: false
-
-    - name: Set server external IP
-      set_fact:
-        server_external_ip_content: "{{ ansible_host | default(server_external_ip.content | default('')) }}"
-
-    - name: Read WireGuard server config
-      slurp:
-        src: "{{ wireguard_config_file }}"
-      register: wireguard_server_config_read
-
-    - name: Extract server IP from config
-      set_fact:
-        server_vpn_ip: "{{ (wireguard_server_config_read.content | b64decode | regex_findall('Address\\s*=\\s*([0-9.]+)') | first) | default('10.8.0.1') }}"
-      failed_when: false
-
-    - name: Extract WireGuard server IP octets
-      set_fact:
-        wireguard_server_ip_octets: "{{ (server_vpn_ip | default('')).split('.') }}"
-      when: client_ip == ""
-
-    - name: Fail if server VPN IP is invalid
-      fail:
-        msg: "Server VPN IP '{{ server_vpn_ip }}' ist ungültig – bitte wg0.conf prüfen."
-      when: client_ip == "" and (wireguard_server_ip_octets | length) < 4
-
-    - name: Gather existing client addresses
-      set_fact:
-        existing_client_ips: "{{ (wireguard_server_config_read.content | b64decode | regex_findall('AllowedIPs = ([0-9A-Za-z.]+)/32', '\\\\1')) }}"
-      when: client_ip == ""
-
-    - name: Calculate client IP if not provided
-      vars:
-        existing_last_octets: "{{ (existing_client_ips | default([])) | map('regex_replace', '^(?:\\\\d+\\\\.\\\\d+\\\\.\\\\d+\\\\.)', '') | select('match', '^[0-9]+$') | map('int') | list }}"
-        server_last_octet: "{{ wireguard_server_ip_octets[3] | int }}"
-        next_octet_candidate: "{{ (existing_last_octets + [server_last_octet]) | map('int') | list | max + 1 if (existing_client_ips | default([]) | length > 0) else server_last_octet + 1 }}"
-      set_fact:
-        client_ip: "{{ [
-          wireguard_server_ip_octets[0],
-          wireguard_server_ip_octets[1],
-          wireguard_server_ip_octets[2],
-          next_octet_candidate
-        ] | join('.') }}"
-      when: client_ip == "" and (wireguard_server_ip_octets | length) >= 4
-
-    - name: Generate NEW client private key
-      command: "wg genkey"
-      register: client_private_key
-      changed_when: true
-      no_log: yes
-
-    - name: Generate NEW client public key
-      command: "wg pubkey"
-      args:
-        stdin: "{{ client_private_key.stdout }}"
-      register: client_public_key
-      changed_when: false
-      no_log: yes
-
-    - name: Add NEW client to WireGuard server config
-      blockinfile:
-        path: "{{ wireguard_config_file }}"
-        block: |
-          # Client: {{ client_name }}
-          [Peer]
-          PublicKey = {{ client_public_key.stdout }}
-          AllowedIPs = {{ client_ip }}/32
-        marker: "# {mark} ANSIBLE MANAGED BLOCK - Client: {{ client_name }}"
-      register: wireguard_client_block
-
-    - name: Ensure client configs directory exists
-      file:
-        path: "{{ wireguard_client_configs_path }}"
-        state: directory
-        mode: '0700'
-        owner: root
-        group: root
-
-    - name: Ensure local client configs directory exists
-      file:
-        path: "{{ wireguard_local_client_configs_dir }}"
-        state: directory
-        mode: '0700'
-      delegate_to: localhost
-      become: no
-      run_once: true
-
-    - name: Get server public key
-      shell: "cat {{ wireguard_config_path }}/{{ wireguard_interface }}_private.key | wg pubkey"
-      register: server_public_key_cmd
-      changed_when: false
-      no_log: yes
-      failed_when: false
-
-    - name: Create NEW client configuration file
-      template:
-        src: "{{ playbook_dir }}/../templates/wireguard-client.conf.j2"
-        dest: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-        mode: '0600'
-        owner: root
-        group: root
-
-    - name: Download NEW client configuration to control machine
-      fetch:
-        src: "{{ wireguard_client_configs_path }}/{{ client_name }}.conf"
-        dest: "{{ wireguard_local_client_configs_dir }}/{{ client_name }}.conf"
-        flat: yes
-        mode: '0600'
-
-    - name: Restart WireGuard service
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-        state: restarted
-
-    - name: Display NEW client configuration
-      debug:
-        msg: |
-          ========================================
-          WireGuard Client REGENERATED: {{ client_name }}
-          ========================================
-          
-          Neue Client-IP: {{ client_ip }}
-          Server Endpoint: {{ server_external_ip_content }}:{{ wireguard_port }}
-          
-          Neue Client-Konfiguration:
-          {{ wireguard_local_client_configs_dir }}/{{ client_name }}.conf
-          
-          WICHTIG:
-          1. Lade die neue Config-Datei herunter
-          2. Importiere sie in WireGuard (ersetze die alte!)
-          3. Verbinde mit dem VPN
-          4. Teste: ping 10.8.0.1
-          5. Teste: https://grafana.michaelschiemer.de
-          
-          Alte Config gesichert als:
-          {{ backup_result.dest | default('N/A') }}
-          ========================================
diff --git a/deployment/wireguard-old/setup-wireguard.yml b/deployment/wireguard-old/setup-wireguard.yml
deleted file mode 100755
index e61b7f76..00000000
--- a/deployment/wireguard-old/setup-wireguard.yml
+++ /dev/null
@@ -1,287 +0,0 @@
----
-- name: Setup WireGuard VPN Server
-  hosts: production
-  become: yes
-  gather_facts: yes
-
-  vars:
-    # WireGuard variables are defined in group_vars/production.yml
-    # Can be overridden via -e flag if needed
-    wireguard_port: "{{ wireguard_port_default | default(51820) }}"
-    wireguard_network: "{{ wireguard_network_default | default('10.8.0.0/24') }}"
-    wireguard_server_ip: "{{ wireguard_server_ip_default | default('10.8.0.1') }}"
-
-  pre_tasks:
-
-    - name: Optionally load wireguard secrets from vault
-      include_vars:
-        file: "{{ playbook_dir }}/../secrets/production.vault.yml"
-      no_log: yes
-      ignore_errors: yes
-      delegate_to: localhost
-      become: no
-
-  tasks:
-    - name: Check if WireGuard is already installed
-      command: which wg
-      register: wireguard_installed
-      changed_when: false
-      failed_when: false
-
-    - name: Update package cache
-      apt:
-        update_cache: yes
-        cache_valid_time: 3600
-      when: not wireguard_installed.rc == 0
-
-    - name: Install WireGuard
-      apt:
-        name:
-          - wireguard
-          - wireguard-tools
-          - qrencode
-        state: present
-      when: not wireguard_installed.rc == 0
-      notify: restart wireguard
-
-    - name: Ensure WireGuard config directory exists
-      file:
-        path: "{{ wireguard_config_path }}"
-        state: directory
-        mode: '0700'
-        owner: root
-        group: root
-
-    - name: Ensure WireGuard client configs directory exists
-      file:
-        path: "{{ wireguard_client_configs_path }}"
-        state: directory
-        mode: '0700'
-        owner: root
-        group: root
-
-    - name: Check if WireGuard server keys exist
-      stat:
-        path: "{{ wireguard_private_key_file }}"
-      register: server_private_key_exists
-
-    - name: Generate WireGuard server private key
-      command: "wg genkey"
-      register: server_private_key
-      changed_when: true
-      when: not server_private_key_exists.stat.exists
-      no_log: yes
-
-    - name: Save WireGuard server private key
-      copy:
-        content: "{{ server_private_key.stdout }}"
-        dest: "{{ wireguard_private_key_file }}"
-        mode: '0600'
-        owner: root
-        group: root
-      when: not server_private_key_exists.stat.exists
-      no_log: yes
-
-    - name: Read WireGuard server private key
-      slurp:
-        src: "{{ wireguard_private_key_file }}"
-      register: server_private_key_content
-      when: server_private_key_exists.stat.exists
-
-    - name: Generate WireGuard server public key
-      command: "wg pubkey"
-      args:
-        stdin: "{{ server_private_key.stdout if not server_private_key_exists.stat.exists else server_private_key_content.content | b64decode | trim }}"
-      register: server_public_key
-      changed_when: false
-      when: not server_private_key_exists.stat.exists
-      no_log: yes
-
-    - name: Get existing server public key
-      shell: "cat {{ wireguard_private_key_file }} | wg pubkey"
-      register: existing_server_public_key
-      changed_when: false
-      when: server_private_key_exists.stat.exists
-      no_log: yes
-      failed_when: false
-
-    - name: Set server public key fact
-      set_fact:
-        server_public_key_value: "{{ server_public_key.stdout if not server_private_key_exists.stat.exists else existing_server_public_key.stdout }}"
-
-    - name: Save WireGuard server public key
-      copy:
-        content: "{{ server_public_key_value }}"
-        dest: "{{ wireguard_public_key_file }}"
-        mode: '0644'
-        owner: root
-        group: root
-
-    - name: Enable IP forwarding
-      sysctl:
-        name: net.ipv4.ip_forward
-        value: '1'
-        state: present
-        sysctl_set: yes
-        reload: yes
-      when: wireguard_enable_ip_forwarding
-
-    - name: Make IP forwarding persistent
-      lineinfile:
-        path: /etc/sysctl.conf
-        regexp: '^net\.ipv4\.ip_forward'
-        line: 'net.ipv4.ip_forward=1'
-        state: present
-      when: wireguard_enable_ip_forwarding
-
-    - name: Get server external IP address
-      uri:
-        url: https://api.ipify.org
-        return_content: yes
-      register: server_external_ip
-      changed_when: false
-      failed_when: false
-
-    - name: Set server external IP from inventory if API fails
-      set_fact:
-        server_external_ip_content: "{{ ansible_host | default(server_external_ip.content | default('')) }}"
-      when: server_external_ip.content is defined
-
-    - name: Get server external IP from ansible_host
-      set_fact:
-        server_external_ip_content: "{{ ansible_host }}"
-      when: server_external_ip.content is not defined
-
-    - name: Read server private key for config
-      slurp:
-        src: "{{ wireguard_private_key_file }}"
-      register: server_private_key_file_content
-      when: server_private_key_exists.stat.exists
-
-    - name: Set server private key for template (new key)
-      set_fact:
-        server_private_key_for_config: "{{ server_private_key.stdout }}"
-      when: not server_private_key_exists.stat.exists
-
-    - name: Set server private key for template (existing key)
-      set_fact:
-        server_private_key_for_config: "{{ server_private_key_file_content.content | b64decode | trim }}"
-      when: server_private_key_exists.stat.exists
-
-    - name: Get network interface name
-      shell: "ip route | grep default | awk '{print $5}' | head -1"
-      register: default_interface
-      changed_when: false
-      failed_when: false
-
-    - name: Set default interface
-      set_fact:
-        wireguard_interface_name: "{{ default_interface.stdout | default('eth0') }}"
-
-    - name: Check if WireGuard config exists
-      stat:
-        path: "{{ wireguard_config_file }}"
-      register: wireguard_config_exists
-
-    - name: Create WireGuard server configuration
-      template:
-        src: "{{ playbook_dir }}/../templates/wireguard-server.conf.j2"
-        dest: "{{ wireguard_config_file }}"
-        mode: '0600'
-        owner: root
-        group: root
-      notify: restart wireguard
-
-    - name: Check if WireGuard service is enabled
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-      register: wireguard_service_status
-      failed_when: false
-      changed_when: false
-
-    - name: Enable WireGuard service
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-        enabled: yes
-        daemon_reload: yes
-      when: not wireguard_service_status.status.ActiveState is defined or wireguard_service_status.status.ActiveState != 'active'
-
-    - name: Start WireGuard service
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-        state: started
-      notify: restart wireguard
-
-    - name: Check if UFW firewall is installed
-      command: which ufw
-      register: ufw_installed
-      changed_when: false
-      failed_when: false
-
-    - name: Verify SSH access is allowed in UFW
-      command: "ufw status | grep -q '22/tcp' || echo 'SSH not found'"
-      register: ssh_ufw_check
-      changed_when: false
-      failed_when: false
-      when: ufw_installed.rc == 0
-
-    - name: Warn if SSH is not explicitly allowed
-      debug:
-        msg: |
-          ??  WARNING: SSH (port 22) might not be explicitly allowed in UFW!
-          Please ensure SSH access is configured before proceeding.
-          Run: sudo ufw allow 22/tcp
-      when: ufw_installed.rc == 0 and 'SSH not found' in ssh_ufw_check.stdout
-
-    - name: Allow WireGuard port in UFW firewall
-      ufw:
-        rule: allow
-        port: "{{ wireguard_port }}"
-        proto: udp
-        comment: "WireGuard VPN"
-      when: ufw_installed.rc == 0
-
-    - name: Allow WireGuard port in UFW firewall (alternative)
-      shell: "ufw allow {{ wireguard_port }}/udp comment 'WireGuard VPN'"
-      when: ufw_installed.rc == 0
-      failed_when: false
-      changed_when: false
-
-    - name: Check WireGuard status
-      command: "wg show {{ wireguard_interface }}"
-      register: wireguard_status
-      changed_when: false
-      failed_when: false
-
-    - name: Display WireGuard status
-      debug:
-        msg: |
-          WireGuard Status:
-          {{ wireguard_status.stdout if wireguard_status.rc == 0 else 'WireGuard interface not active' }}
-
-    - name: Display server public key
-      debug:
-        msg: |
-          ========================================
-          WireGuard Server Setup Complete!
-          ========================================
-          
-          Server Public Key:
-          {{ server_public_key_value }}
-          
-          Server IP: {{ wireguard_server_ip }}
-          Server Endpoint: {{ server_external_ip_content }}:{{ wireguard_port }}
-          Network: {{ wireguard_network }}
-          
-          To add a client, run:
-          ansible-playbook -i inventory/production.yml playbooks/add-wireguard-client.yml -e "client_name=myclient"
-          
-          Client configs are stored in:
-          {{ wireguard_client_configs_path }}/
-          ========================================
-
-  handlers:
-    - name: restart wireguard
-      systemd:
-        name: "wg-quick@{{ wireguard_interface }}"
-        state: restarted
\ No newline at end of file
diff --git a/deployment/wireguard-old/test-wireguard-docker-container.yml b/deployment/wireguard-old/test-wireguard-docker-container.yml
deleted file mode 100644
index 40e6dfe9..00000000
--- a/deployment/wireguard-old/test-wireguard-docker-container.yml
+++ /dev/null
@@ -1,168 +0,0 @@
----
-- name: Test WireGuard Connection from Docker Container
-  hosts: production
-  become: yes
-  gather_facts: yes
-
-  vars:
-    test_container_name: "wireguard-test-client"
-    wireguard_config_path: "/tmp/wireguard-test"
-
-  tasks:
-    - name: Validate client name
-      fail:
-        msg: "client_name is required. Usage: ansible-playbook ... -e 'client_name=grafana-test'"
-      when: client_name is not defined or client_name == ""
-
-    - name: Check if WireGuard client config exists
-      stat:
-        path: "{{ playbook_dir }}/../wireguard-clients/{{ client_name }}.conf"
-      register: client_config_exists
-      delegate_to: localhost
-      become: no
-
-    - name: Fail if client config not found
-      fail:
-        msg: "Client config not found: {{ playbook_dir }}/../wireguard-clients/{{ client_name }}.conf"
-      when: not client_config_exists.stat.exists
-
-    - name: Read client config
-      slurp:
-        src: "{{ playbook_dir }}/../wireguard-clients/{{ client_name }}.conf"
-      register: client_config_content
-      delegate_to: localhost
-      become: no
-
-    - name: Extract client IP from config
-      set_fact:
-        client_vpn_ip: "{{ (client_config_content.content | b64decode | regex_findall('Address\\s*=\\s*([0-9.]+)') | first) | default('10.8.0.7') }}"
-      failed_when: false
-
-    - name: Display extracted client IP
-      debug:
-        msg: "Client VPN IP: {{ client_vpn_ip }}"
-
-    - name: Stop and remove existing test container
-      shell: |
-        docker stop {{ test_container_name }} || true
-        docker rm {{ test_container_name }} || true
-      args:
-        executable: /bin/bash
-      ignore_errors: yes
-      failed_when: false
-
-    - name: Create temporary directory for WireGuard config
-      file:
-        path: "{{ wireguard_config_path }}"
-        state: directory
-        mode: '0700'
-
-    - name: Copy client config to server
-      copy:
-        content: "{{ client_config_content.content | b64decode }}"
-        dest: "{{ wireguard_config_path }}/{{ client_name }}.conf"
-        mode: '0600'
-
-    - name: Start WireGuard test container
-      shell: |
-        docker run -d \
-          --name {{ test_container_name }} \
-          --cap-add=NET_ADMIN \
-          --cap-add=SYS_MODULE \
-          --sysctl net.ipv4.conf.all.src_valid_mark=1 \
-          -v {{ wireguard_config_path }}/{{ client_name }}.conf:/etc/wireguard/{{ client_name }}.conf:ro \
-          --device /dev/net/tun \
-          ghcr.io/linuxserver/wireguard:latest
-      args:
-        executable: /bin/bash
-      register: container_result
-      ignore_errors: yes
-
-    - name: Wait for container to start
-      pause:
-        seconds: 5
-
-    - name: Check container status
-      shell: docker ps -a --filter "name={{ test_container_name }}" --format "{{ '{{' }}.Status{{ '}}' }}"
-      register: container_status
-      failed_when: false
-
-    - name: Display container status
-      debug:
-        msg: "Container Status: {{ container_status.stdout }}"
-
-    - name: Get container logs
-      shell: docker logs {{ test_container_name }} --tail 50
-      register: container_logs
-      failed_when: false
-
-    - name: Display container logs
-      debug:
-        msg: "{{ container_logs.stdout_lines }}"
-
-    - name: Test ping to VPN server from container
-      shell: |
-        docker exec {{ test_container_name }} ping -c 4 10.8.0.1 || true
-      register: ping_result
-      failed_when: false
-
-    - name: Display ping result
-      debug:
-        msg: "{{ ping_result.stdout_lines }}"
-
-    - name: Test curl to Grafana from container
-      shell: |
-        docker exec {{ test_container_name }} curl -s -o /dev/null -w "%{http_code}" --max-time 10 https://grafana.michaelschiemer.de/ || echo "FAILED"
-      register: curl_result
-      failed_when: false
-
-    - name: Display curl result
-      debug:
-        msg: "HTTP Status Code: {{ curl_result.stdout }}"
-
-    - name: Get container IP
-      shell: |
-        docker exec {{ test_container_name }} ip addr show wg0 | grep "inet " | awk '{print $2}' | cut -d/ -f1 || echo "No WireGuard IP"
-      register: container_wg_ip
-      failed_when: false
-
-    - name: Display container WireGuard IP
-      debug:
-        msg: "Container WireGuard IP: {{ container_wg_ip.stdout }}"
-
-    - name: Test DNS resolution from container
-      shell: |
-        docker exec {{ test_container_name }} nslookup grafana.michaelschiemer.de || true
-      register: dns_result
-      failed_when: false
-
-    - name: Display DNS result
-      debug: "{{ dns_result.stdout_lines }}"
-
-    - name: Check Traefik logs for container access
-      shell: |
-        cd ~/deployment/stacks/traefik
-        tail -100 logs/access.log | grep -i grafana | tail -10 | grep -oP '"ClientHost":"[^"]*"' | sed 's/"ClientHost":"//;s/"//' | sort -u
-      register: traefik_client_ips
-      failed_when: false
-
-    - name: Display Traefik client IPs
-      debug:
-        msg: "{{ traefik_client_ips.stdout_lines }}"
-
-    - name: Cleanup instructions
-      debug:
-        msg: |
-          ========================================
-          TEST ABGESCHLOSSEN
-          ========================================
-          
-          Container-Name: {{ test_container_name }}
-          
-          Um Container zu entfernen:
-          docker stop {{ test_container_name }}
-          docker rm {{ test_container_name }}
-          
-          Um Config zu entfernen:
-          rm -rf {{ wireguard_config_path }}
-          ========================================
diff --git a/deployment/wireguard-old/wireguard-client.conf.j2 b/deployment/wireguard-old/wireguard-client.conf.j2
deleted file mode 100644
index 282ef7f9..00000000
--- a/deployment/wireguard-old/wireguard-client.conf.j2
+++ /dev/null
@@ -1,29 +0,0 @@
-# WireGuard Client Configuration for {{ client_name }}
-# Generated by Ansible - DO NOT EDIT MANUALLY
-
-[Interface]
-# Client private key
-PrivateKey = {{ client_private_key.stdout }}
-
-# Client IP address in VPN network
-Address = {{ client_ip }}/24
-
-{% if wireguard_dns_servers | length > 0 %}
-# DNS servers provided via Ansible (optional)
-DNS = {{ wireguard_dns_servers | join(', ') }}
-{% endif %}
-
-[Peer]
-# Server public key
-PublicKey = {{ server_public_key_cmd.stdout }}
-
-# Server endpoint
-Endpoint = {{ server_external_ip_content }}:{{ wireguard_port }}
-
-# Allowed IPs (routes through VPN)
-# IMPORTANT: Only VPN network is routed through VPN by default
-# SSH access via normal IP ({{ server_external_ip_content }}) remains available
-AllowedIPs = {{ allowed_ips }}
-
-# Keep connection alive
-PersistentKeepalive = 25
diff --git a/deployment/wireguard-old/wireguard-server.conf.j2 b/deployment/wireguard-old/wireguard-server.conf.j2
deleted file mode 100644
index 528273b9..00000000
--- a/deployment/wireguard-old/wireguard-server.conf.j2
+++ /dev/null
@@ -1,22 +0,0 @@
-# WireGuard Server Configuration
-# Generated by Ansible - DO NOT EDIT MANUALLY
-
-[Interface]
-# Server private key
-PrivateKey = {{ server_private_key_for_config }}
-
-# Server IP address in VPN network
-Address = {{ wireguard_server_ip }}/24
-
-# Port to listen on
-ListenPort = {{ wireguard_port }}
-
-# Enable NAT for VPN clients to access internet
-PostUp = iptables -A FORWARD -i %i -j ACCEPT; iptables -A FORWARD -o %i -j ACCEPT; iptables -t nat -A POSTROUTING -o {{ wireguard_interface_name }} -j MASQUERADE
-PostDown = iptables -D FORWARD -i %i -j ACCEPT; iptables -D FORWARD -o %i -j ACCEPT; iptables -t nat -D POSTROUTING -o {{ wireguard_interface_name }} -j MASQUERADE
-
-# Clients will be added here by the add-wireguard-client playbook
-# Example:
-# [Peer]
-# PublicKey = <client_public_key>
-# AllowedIPs = 10.8.0.2/32
\ No newline at end of file
diff --git a/docker-compose.postgres-override.yml b/docker-compose.postgres-override.yml
index 6b738516..52dde3d8 100644
--- a/docker-compose.postgres-override.yml
+++ b/docker-compose.postgres-override.yml
@@ -1,6 +1,6 @@
-# Shared PostgreSQL Connection Override for Production
+# PostgreSQL Production Connection Override
 #
-# This file provides network configuration for connecting to the PostgreSQL Stack.
+# This file provides network configuration for connecting to the PostgreSQL Production Stack.
 # Used by Production Stack.
 #
 # Usage:
@@ -10,24 +10,27 @@
 #                    -f docker-compose.postgres-override.yml up
 #
 # Prerequisites:
-#   - PostgreSQL Stack must be running (creates app-internal network)
-#   - app-internal network must exist as external network
-#   - PostgreSQL Stack: deployment/stacks/postgresql/docker-compose.yml
+#   - PostgreSQL Production Stack must be running (creates postgres-production-internal network)
+#   - postgres-production-internal network must exist as external network
+#   - PostgreSQL Production Stack: deployment/stacks/postgresql-production/docker-compose.yml
 
 services:
   # Production Stack Services
   # These services will be merged with existing definitions from base.yml + production.yml
   php:
     networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access (merged with existing networks)
+      postgres-production-internal: {}  # Add postgres-production-internal network for PostgreSQL access (merged with existing networks)
   queue-worker:
     networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access (merged with existing networks)
+      postgres-production-internal: {}  # Add postgres-production-internal network for PostgreSQL access (merged with existing networks)
   scheduler:
     networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access
+      postgres-production-internal: {}  # Add postgres-production-internal network for PostgreSQL access
 
 networks:
+  postgres-production-internal:
+    external: true
+    name: postgres-production-internal
   app-internal:
     external: true
     name: app-internal
diff --git a/deployment/stacks/application/docker-compose.base.yml b/docker-compose.production-base.yml
similarity index 55%
rename from deployment/stacks/application/docker-compose.base.yml
rename to docker-compose.production-base.yml
index 26ec7edc..28c72355 100644
--- a/deployment/stacks/application/docker-compose.base.yml
+++ b/docker-compose.production-base.yml
@@ -1,20 +1,13 @@
-# Base Docker Compose Configuration
-# This file contains shared service definitions, networks, and volumes.
-# Use with environment-specific override files:
-#   - docker-compose.local.yml (local development)
-#   - docker-compose.staging.yml (staging environment)
-#   - docker-compose.production.yml (production environment)
+# Production Base Docker Compose Configuration
+# This file is identical to docker-compose.base.yml but WITHOUT build sections
+# Use with docker-compose.production.yml for production deployments
 #
 # Usage:
-#   Local:    docker-compose -f docker-compose.base.yml -f docker-compose.local.yml up
-#   Staging:  docker-compose -f docker-compose.base.yml -f docker-compose.staging.yml up
-#   Production: docker-compose -f docker-compose.base.yml -f docker-compose.production.yml up
+#   Production: docker-compose -f docker-compose.production-base.yml -f docker-compose.production.yml up
 
 services:
   web:
-    build:
-      context: docker/nginx
-      dockerfile: Dockerfile
+    # Build section removed for production - use pre-built images from registry
     healthcheck:
       test: ["CMD", "nc", "-z", "127.0.0.1", "443"]
       interval: 30s
@@ -28,12 +21,7 @@ services:
       - backend
 
   php:
-    build:
-      context: .
-      dockerfile: docker/php/Dockerfile
-      args:
-        - ENV=${APP_ENV:-dev}
-        - COMPOSER_INSTALL_FLAGS=${COMPOSER_INSTALL_FLAGS:---no-scripts --no-autoloader}
+    # Build section removed for production - use pre-built images from registry
     healthcheck:
       test: [ "CMD", "php", "-v" ]
       interval: 30s
@@ -45,29 +33,36 @@ services:
     volumes:
       # Shared Volume für Composer-Cache über Container-Neustarts hinweg
       - composer-cache:/root/.composer/cache
-      # Docker-Volumes für Performance (keine Host-Sync nötig)
-      - storage-cache:/var/www/html/storage/cache:rw
+      # Persistent volumes for queue and logs
       - storage-queue:/var/www/html/storage/queue:rw
-      - storage-discovery:/var/www/html/storage/discovery:rw
-      - var-data:/var/www/html/var:rw
+      - var-data:/var/www/html/var/logs:rw
+    tmpfs:
+      # tmpfs for cache and runtime directories (RAM-based, faster I/O)
+      - /var/www/html/storage/cache
+      - /var/www/html/storage/discovery
+      - /var/www/html/var/cache
+      - /tmp
 
   php-test:
-    build:
-      context: .
-      dockerfile: docker/php/Dockerfile.test
+    # Build section removed for production - use pre-built images from registry
     user: "1000:1000"
     profiles:
       - test
     volumes:
       - composer-cache:/home/appuser/.composer/cache
-      - storage-cache:/var/www/html/storage/cache:rw
+      # Persistent volumes for queue and logs
       - storage-queue:/var/www/html/storage/queue:rw
-      - storage-discovery:/var/www/html/storage/discovery:rw
-      - var-data:/var/www/html/var:rw
+      - var-data:/var/www/html/var/logs:rw
+    tmpfs:
+      # tmpfs for cache and runtime directories (RAM-based, faster I/O)
+      - /var/www/html/storage/cache
+      - /var/www/html/storage/discovery
+      - /var/www/html/var/cache
+      - /tmp
     environment:
       APP_ENV: testing
       APP_DEBUG: true
-      DB_HOST: db
+      DB_HOST: postgres  # External PostgreSQL Stack service
       REDIS_HOST: redis
     networks:
       - backend
@@ -75,34 +70,10 @@ services:
     entrypoint: []
     command: ["php", "-v"]
 
-  db:
-    image: postgres:16-alpine
-    environment:
-      POSTGRES_DB: ${DB_DATABASE:-michaelschiemer}
-      POSTGRES_USER: ${DB_USERNAME:-postgres}
-      # SECURITY: POSTGRES_PASSWORD must be set explicitly (no hardcoded fallback)
-      # Set DB_PASSWORD in .env.local for local development
-      # Use Docker Secrets in production/staging via DB_PASSWORD_FILE
-      POSTGRES_PASSWORD: ${DB_PASSWORD}
-      # Performance & Connection Settings
-      POSTGRES_INITDB_ARGS: "-E UTF8 --locale=C"
-      PGDATA: /var/lib/postgresql/data/pgdata
-    volumes:
-      - db_data:/var/lib/postgresql/data
-      - "${DB_CONFIG_PATH:-./docker/postgres/postgresql.conf}:/etc/postgresql/postgresql.conf:ro"
-      - "${DB_INIT_PATH:-./docker/postgres/init}:/docker-entrypoint-initdb.d:ro"
-    command:
-      - "postgres"
-      - "-c"
-      - "config_file=/etc/postgresql/postgresql.conf"
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${DB_USERNAME:-postgres} -d ${DB_DATABASE:-michaelschiemer}"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-      start_period: 30s
-    networks:
-      - backend
+  # Database service removed - all environments use external PostgreSQL Stack
+  # Local: deployment/stacks/postgresql/
+  # Staging: deployment/stacks/postgresql/
+  # Production: deployment/stacks/postgresql/
 
   redis:
     image: redis:7-alpine
@@ -120,9 +91,7 @@ services:
       - cache
 
   queue-worker:
-    build:
-      context: .
-      dockerfile: docker/worker/Dockerfile
+    # Build section removed for production - use pre-built images from registry
     entrypoint: ""  # Override any entrypoint
     command: ["php", "/var/www/html/worker.php"]  # Direct command execution
     depends_on:
@@ -130,14 +99,18 @@ services:
         condition: service_healthy
       redis:
         condition: service_healthy
-      db:
-        condition: service_healthy
+      # Note: PostgreSQL is external service, connection via app-internal network
     volumes:
       # Use same storage volumes as PHP container for consistency
-      - storage-cache:/var/www/html/storage/cache:rw
+      # Persistent volumes for queue and logs
       - storage-queue:/var/www/html/storage/queue:rw
-      - storage-discovery:/var/www/html/storage/discovery:rw
-      - var-data:/var/www/html/var:rw
+      - var-data:/var/www/html/var/logs:rw
+    tmpfs:
+      # tmpfs for cache and runtime directories (RAM-based, faster I/O)
+      - /var/www/html/storage/cache
+      - /var/www/html/storage/discovery
+      - /var/www/html/var/cache
+      - /tmp
     networks:
       - backend
       - cache
@@ -178,10 +151,8 @@ networks:
 volumes:
   redis_data:
   composer-cache:
-  storage-cache:      # Cache-Verzeichnis (Performance-kritisch)
-  storage-queue:      # Queue-Verzeichnis (Performance-kritisch)
-  storage-discovery:  # Discovery-Cache (Framework-intern)
-  var-data:
+  storage-queue:      # Queue-Verzeichnis (Performance-kritisch, persistent)
+  var-data:           # Runtime logs (persistent)
   db_data:
   project-data:
   worker-logs:
diff --git a/docker-compose.production.yml b/docker-compose.production.yml
index cc17eb79..ea1a2fc5 100644
--- a/docker-compose.production.yml
+++ b/docker-compose.production.yml
@@ -13,8 +13,8 @@
 services:
   web:
     # Use pre-built image from registry (override build from base)
-    image: git.michaelschiemer.de:5000/framework:latest
-    build: null  # Explicitly remove build section from base
+    image: localhost:5000/framework:latest
+    # Build section removed - production-base.yml has no build sections
 
     # Production restart policy
     restart: always
@@ -34,14 +34,18 @@ services:
       - APP_DEBUG=false
 
     # Security hardening
-    security_opt:
-      - no-new-privileges:true
+    # Note: no-new-privileges prevents PHP-FPM from switching to www-data
+    # We need to allow privilege escalation for PHP-FPM user switching
+    # security_opt:
+    #   - no-new-privileges:true
     cap_drop:
       - ALL
     cap_add:
       - CHOWN
       - DAC_OVERRIDE
       - NET_BIND_SERVICE  # Required for binding to ports 80/443
+      - SETGID  # Required for PHP-FPM to switch to www-data
+      - SETUID  # Required for PHP-FPM to switch to www-data
 
     # Stricter health checks for production
     healthcheck:
@@ -78,8 +82,8 @@ services:
 
   php:
     # Use pre-built image from registry (override build from base)
-    image: git.michaelschiemer.de:5000/framework:latest
-    build: null  # Explicitly remove build section from base
+    image: localhost:5000/framework:latest
+    # Build section removed - production-base.yml has no build sections
 
     # Production restart policy
     restart: always
@@ -97,6 +101,10 @@ services:
       - CHOWN
       - DAC_OVERRIDE
 
+    # Load environment variables from .env file (generated by Ansible)
+    # Use absolute path to ensure .env is found regardless of working directory
+    env_file:
+      - /home/deploy/deployment/stacks/production/.env
     environment:
       - APP_ENV=production
       - APP_DEBUG=false
@@ -155,8 +163,8 @@ services:
 
   queue-worker:
     # Use pre-built image from registry (override build from base)
-    image: git.michaelschiemer.de:5000/framework:latest
-    build: null  # Explicitly remove build section from base
+    image: localhost:5000/framework:latest
+    # Build section removed - production-base.yml has no build sections
 
     # Production restart policy
     restart: always
@@ -165,7 +173,9 @@ services:
     # The entrypoint script will use gosu to switch to appuser after setup
     user: "root"
 
-    # No entrypoint override - queue-worker runs worker.php directly
+    # Override entrypoint to skip PHP-FPM/Nginx startup - queue-worker only needs PHP CLI
+    entrypoint: ""
+
     # Worker command - direct PHP execution
     command: ["php", "/var/www/html/worker.php"]
 
@@ -174,6 +184,10 @@ services:
       # Mount application code from rsync deployment (read-write for storage/var directories)
       - /home/deploy/michaelschiemer/current:/var/www/html:rw
 
+    # Load environment variables from .env file (generated by Ansible)
+    # Use absolute path to ensure .env is found regardless of working directory
+    env_file:
+      - /home/deploy/deployment/stacks/production/.env
     environment:
       - APP_ENV=production
       - WORKER_DEBUG=false
@@ -220,10 +234,18 @@ services:
         condition: service_healthy
       # Note: PostgreSQL and Redis are external services, connection via app-internal network
 
+  # php-test service removed for production (test profiles not used in production)
+  php-test:
+    image: localhost:5000/framework:latest
+    # Build section removed - production-base.yml has no build sections
+    profiles:
+      - never  # Disable php-test in production
+
   # Scheduler (Cron Jobs)
   scheduler:
-    # Use same build as php service (has application code copied)
-    image: git.michaelschiemer.de:5000/framework:latest
+    # Use pre-built image from registry (override build from base if exists)
+    image: localhost:5000/framework:latest
+    # Build section removed - production-base.yml has no build sections
     container_name: scheduler
 
     # Production restart policy
@@ -233,6 +255,9 @@ services:
     # The entrypoint script will use gosu to switch to appuser after setup
     user: "root"
 
+    # Override entrypoint to skip PHP-FPM/Nginx startup - scheduler only needs PHP CLI
+    entrypoint: ""
+
     # Scheduler command - direct PHP execution
     command: php console.php scheduler:run
 
@@ -241,6 +266,10 @@ services:
       # Mount application code from rsync deployment (read-write for storage/var directories)
       - /home/deploy/michaelschiemer/current:/var/www/html:rw
 
+    # Load environment variables from .env file (generated by Ansible)
+    # Use absolute path to ensure .env is found regardless of working directory
+    env_file:
+      - /home/deploy/deployment/stacks/production/.env
     environment:
       - TZ=Europe/Berlin
       - APP_ENV=production
diff --git a/docker-compose.staging-postgres-override.yml b/docker-compose.staging-postgres-override.yml
index 1b9acff6..4b295678 100644
--- a/docker-compose.staging-postgres-override.yml
+++ b/docker-compose.staging-postgres-override.yml
@@ -1,6 +1,6 @@
-# Shared PostgreSQL Connection Override for Staging
+# PostgreSQL Staging Connection Override
 #
-# This file provides network configuration for connecting to the PostgreSQL Stack.
+# This file provides network configuration for connecting to the PostgreSQL Staging Stack.
 # Used by Staging Stack.
 #
 # Usage:
@@ -10,24 +10,17 @@
 #                    -f docker-compose.staging-postgres-override.yml up
 #
 # Prerequisites:
-#   - PostgreSQL Stack must be running (creates app-internal network)
-#   - app-internal network must exist as external network
-#   - PostgreSQL Stack: deployment/stacks/postgresql/docker-compose.yml
+#   - PostgreSQL Staging Stack must be running (creates postgres-staging-internal network)
+#   - postgres-staging-internal network must exist as external network
+#   - PostgreSQL Staging Stack: deployment/stacks/postgresql-staging/docker-compose.yml
 
 services:
   # Staging Stack Services
   # These services will be merged with existing definitions from base.yml + staging.yml
-  staging-app:
-    networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access (merged with staging-internal)
-  staging-queue-worker:
-    networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access (merged with staging-internal)
-  staging-scheduler:
-    networks:
-      app-internal: {}  # Add app-internal network for PostgreSQL access (merged with staging-internal)
+  # Note: postgres-staging-internal network is already defined in docker-compose.staging.yml
+  # This override file is kept for backward compatibility but may not be needed anymore
 
 networks:
-  app-internal:
+  postgres-staging-internal:
     external: true
-    name: app-internal
+    name: postgres-staging-internal
diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh
index 2410309b..04ed5a8e 100755
--- a/docker/entrypoint.sh
+++ b/docker/entrypoint.sh
@@ -1,5 +1,14 @@
 #!/bin/bash
-set -e
+# Don't use 'set -e' globally - we'll handle errors explicitly for critical operations
+# This allows non-critical operations (like permission changes) to fail without crashing the container
+
+echo "=========================================="
+echo "🚀 Container Entrypoint Starting"
+echo "=========================================="
+echo "Command: $@"
+echo "Working directory: $(pwd)"
+echo "User: $(whoami)"
+echo ""
 
 echo "🔐 Loading secrets..."
 
@@ -109,20 +118,134 @@ echo ""
 echo "📊 Environment variables:"
 env | grep -E "DB_|APP_" | grep -Ev "(PASSWORD|KEY|SECRET)" || true
 
+echo ""
+echo "📂 Checking application directory structure..."
+if [ -d "/var/www/html" ]; then
+    echo "✅ /var/www/html exists"
+    echo "   Contents: $(ls -la /var/www/html 2>/dev/null | head -5 | wc -l) items"
+    if [ -f "/var/www/html/composer.json" ]; then
+        echo "✅ composer.json found"
+    else
+        echo "⚠️  Warning: composer.json not found in /var/www/html"
+    fi
+    if [ -f "/var/www/html/public/index.php" ] || [ -f "/var/www/html/index.php" ]; then
+        echo "✅ Application entry point found"
+    else
+        echo "⚠️  Warning: Application entry point (index.php) not found"
+    fi
+else
+    echo "❌ ERROR: /var/www/html does not exist!"
+    exit 1
+fi
+
 echo ""
 echo "🛠️ Adjusting filesystem permissions..."
-chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache 2>/dev/null || true
-find /var/www/html/storage /var/www/html/bootstrap/cache -type d -exec chmod 775 {} \; 2>/dev/null || true
-find /var/www/html/storage /var/www/html/bootstrap/cache -type f -exec chmod 664 {} \; 2>/dev/null || true
+
+# Non-critical operations - don't fail if these don't work
+if ! chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache 2>/dev/null; then
+    echo "⚠️  Warning: Failed to change ownership of storage/cache directories (may be volume mounts)"
+fi
+
+if ! find /var/www/html/storage /var/www/html/bootstrap/cache -type d -exec chmod 775 {} \; 2>/dev/null; then
+    echo "⚠️  Warning: Failed to set directory permissions"
+fi
+
+if ! find /var/www/html/storage /var/www/html/bootstrap/cache -type f -exec chmod 664 {} \; 2>/dev/null; then
+    echo "⚠️  Warning: Failed to set file permissions"
+fi
+
+# Verify required directories exist
+echo ""
+echo "📁 Verifying required directories..."
+REQUIRED_DIRS=(
+    "/var/www/html"
+    "/var/www/html/storage"
+    "/var/www/html/bootstrap"
+    "/var/www/html/bootstrap/cache"
+)
+
+for dir in "${REQUIRED_DIRS[@]}"; do
+    if [ ! -d "$dir" ]; then
+        echo "⚠️  Warning: Required directory $dir does not exist, creating..."
+        mkdir -p "$dir" 2>/dev/null || echo "❌ Failed to create $dir"
+    fi
+done
 
 # Start PHP-FPM in background (inherits all environment variables)
 echo ""
 echo "🚀 Starting PHP-FPM..."
-php-fpm &
 
-# Wait for PHP-FPM to be ready
-sleep 2
+# Check if PHP-FPM binary exists
+if ! command -v php-fpm &> /dev/null; then
+    echo "❌ ERROR: php-fpm command not found!"
+    exit 1
+fi
+
+# Start PHP-FPM and capture its PID
+php-fpm &
+PHP_FPM_PID=$!
+
+# Wait for PHP-FPM to be ready and verify it's running
+echo "⏳ Waiting for PHP-FPM to start..."
+MAX_WAIT=10
+WAIT_COUNT=0
+while [ $WAIT_COUNT -lt $MAX_WAIT ]; do
+    if kill -0 $PHP_FPM_PID 2>/dev/null; then
+        # Check if PHP-FPM is listening on the socket
+        if [ -S /var/run/php/php-fpm.sock ] || [ -S /run/php/php-fpm.sock ] || netstat -tuln 2>/dev/null | grep -q ":9000"; then
+            echo "✅ PHP-FPM is running (PID: $PHP_FPM_PID)"
+            break
+        fi
+    else
+        echo "❌ ERROR: PHP-FPM process died immediately after startup!"
+        exit 1
+    fi
+    sleep 1
+    WAIT_COUNT=$((WAIT_COUNT + 1))
+done
+
+if [ $WAIT_COUNT -ge $MAX_WAIT ]; then
+    echo "⚠️  Warning: PHP-FPM may not be fully ready after ${MAX_WAIT}s, but continuing..."
+    echo "   This may indicate a configuration issue. Check PHP-FPM logs if problems occur."
+fi
+
+# Log PHP-FPM status
+echo ""
+echo "📋 PHP-FPM Status:"
+if kill -0 $PHP_FPM_PID 2>/dev/null; then
+    echo "   Process: Running (PID: $PHP_FPM_PID)"
+    if [ -S /var/run/php/php-fpm.sock ]; then
+        echo "   Socket: /var/run/php/php-fpm.sock (exists)"
+    elif [ -S /run/php/php-fpm.sock ]; then
+        echo "   Socket: /run/php/php-fpm.sock (exists)"
+    elif netstat -tuln 2>/dev/null | grep -q ":9000"; then
+        echo "   Socket: TCP port 9000 (listening)"
+    else
+        echo "   Socket: Not found (may be using different configuration)"
+    fi
+else
+    echo "   Process: Not running (PID check failed)"
+fi
+
+# Verify nginx binary exists
+if ! command -v nginx &> /dev/null; then
+    echo "❌ ERROR: nginx command not found!"
+    exit 1
+fi
+
+# Test nginx configuration before starting
+echo ""
+echo "🔍 Testing nginx configuration..."
+if ! nginx -t 2>&1; then
+    echo "❌ ERROR: nginx configuration test failed!"
+    exit 1
+fi
 
 # Start nginx in foreground (inherits all environment variables)
+echo ""
 echo "🚀 Starting nginx..."
+echo "=========================================="
+echo "✅ All startup checks passed"
+echo "🚀 Services starting..."
+echo "=========================================="
 exec nginx -g 'daemon off;'
diff --git a/docker/php/Dockerfile b/docker/php/Dockerfile
index ff36ca9b..a72c7fea 100644
--- a/docker/php/Dockerfile
+++ b/docker/php/Dockerfile
@@ -1,5 +1,5 @@
 # Dockerfile für PHP-FPM
-ARG PHP_VERSION=8.5.0RC3
+ARG PHP_VERSION=8.5.0RC4
 # Override via --build-arg PHP_VERSION=8.5.0RCX to track upstream releases
 FROM php:${PHP_VERSION}-fpm AS base
 
@@ -158,7 +158,7 @@ COPY tsconfig.json ./
 RUN npm run build
 
 # Stage: Production Runtime
-ARG PHP_VERSION=8.5.0RC3
+ARG PHP_VERSION=8.5.0RC4
 FROM php:${PHP_VERSION}-fpm AS production
 
 # Install system dependencies + nginx for production
diff --git a/docker/worker/Dockerfile b/docker/worker/Dockerfile
index c4973526..29ab458f 100644
--- a/docker/worker/Dockerfile
+++ b/docker/worker/Dockerfile
@@ -1,4 +1,4 @@
-ARG PHP_VERSION=8.5.0RC3
+ARG PHP_VERSION=8.5.0RC4
 # Keep aligned with runtime PHP tag (override via --build-arg PHP_VERSION=X)
 FROM php:${PHP_VERSION}-cli
 
diff --git a/docs/ARCHITECTURE-DECISION.md b/docs/ARCHITECTURE-DECISION.md
new file mode 100644
index 00000000..8ec4d53c
--- /dev/null
+++ b/docs/ARCHITECTURE-DECISION.md
@@ -0,0 +1,1087 @@
+# Architecture Decision: Layer-Based vs Module-Based Organization
+
+**Decision Date**: 2025-01-28
+**Status**: Recommended
+**Deciders**: Development Team
+**Related Documents**:
+- `SRC-ARCHITECTURE-ANALYSIS.md` - Current architecture analysis
+- `DOCUMENTATION-ANALYSIS.md` - Documentation structure analysis
+
+---
+
+## Executive Summary
+
+**Decision**: Maintain 4-layer Clean Architecture with enhanced modular organization within each layer (Hybrid Approach)
+
+**Rationale**:
+- Framework layer constitutes 85.3% of codebase (3,883 files)
+- Pure module-based approach would duplicate this massive framework across modules
+- Hybrid approach provides modular benefits while preserving shared framework infrastructure
+- Estimated effort: 2-3 months (vs 6-12 months for pure module approach)
+
+**Impact**:
+- ✅ Maintains Clean Architecture compliance
+- ✅ Achieves Domain-Driven Design benefits
+- ✅ Avoids massive code duplication
+- ✅ Minimizes refactoring effort
+- ✅ Preserves existing framework investments
+
+---
+
+## Context & Problem Statement
+
+### Current Architecture State
+
+**Analyzed Structure** (from `SRC-ARCHITECTURE-ANALYSIS.md`):
+```
+Total Files: 4,551 PHP files
+Total Directories: 1,052
+
+Layer Distribution:
+├── Framework:      3,883 files (85.3%) - TOO LARGE
+├── Application:      420 files (9.2%)  - Below target
+├── Domain:           184 files (4.0%)  - TOO THIN
+└── Infrastructure:    64 files (1.5%)  - Below target
+```
+
+**Current Grade**: C+ (75%) - "Good foundation with critical architectural flaws"
+
+### Identified Problems
+
+**3 Critical Architectural Violations**:
+
+1. **HTTP Layer in Domain** (`src/Domain/Meta/Http/`)
+   - Controllers with `#[Route]` attributes in Domain layer
+   - 406 lines of HTTP-specific code misplaced
+
+2. **DI Container Setup in Domain** (5 domains affected)
+   - Framework-specific dependency injection in Domain
+   - Violates Dependency Rule (Domain depends on Framework)
+
+3. **Infrastructure Nested in Application** (`src/Application/Website/Infrastructure/GeoIp/`)
+   - Wrong dependency direction
+   - Confusing architecture
+
+### Strategic Question
+
+**"Should we maintain 4-layer architecture or switch to pure module-based organization?"**
+
+This decision has fundamental implications:
+- Code organization strategy
+- Framework reusability
+- Refactoring effort (months vs years)
+- Team cognitive load
+- Maintainability long-term
+
+---
+
+## Decision Drivers
+
+### Key Factors Influencing Decision
+
+1. **Framework Size**: 85.3% of codebase is framework infrastructure
+2. **Code Duplication Risk**: Pure modules would replicate framework per module
+3. **Clean Architecture Benefits**: Dependency inversion, testability, maintainability
+4. **Domain-Driven Design Goals**: Bounded contexts, domain focus
+5. **Refactoring Effort**: Time and risk considerations
+6. **Team Familiarity**: Existing knowledge of current structure
+7. **Framework Reusability**: Shared infrastructure across all modules
+
+### Stakeholder Concerns
+
+- **Development Team**: Minimize disruption, preserve framework investments
+- **Architecture**: Maintain Clean Architecture principles
+- **Business**: Minimize refactoring time, maintain velocity
+- **Quality**: Improve testability, reduce coupling
+
+---
+
+## Considered Options
+
+### Option 1: Pure Module-Based (Vertical Slicing)
+
+**Structure**:
+```
+src/
+├── User/                    # Self-contained module
+│   ├── Domain/
+│   ├── Application/
+│   ├── Infrastructure/
+│   └── Framework/          # Duplicated framework code!
+├── Order/                   # Self-contained module
+│   ├── Domain/
+│   ├── Application/
+│   ├── Infrastructure/
+│   └── Framework/          # Duplicated framework code!
+└── Product/                 # Self-contained module
+    ├── Domain/
+    ├── Application/
+    ├── Infrastructure/
+    └── Framework/          # Duplicated framework code!
+```
+
+**Advantages**:
+- ✅ True bounded contexts - modules are completely independent
+- ✅ Team autonomy - each module owned by dedicated team
+- ✅ Deploy modules independently (microservices-ready)
+- ✅ Pure Domain-Driven Design implementation
+- ✅ No cross-module dependencies
+
+**Disadvantages**:
+- ❌ **CRITICAL**: Framework duplication (85.3% × modules = massive overhead)
+- ❌ Framework updates must propagate to ALL modules
+- ❌ Code duplication: HTTP layer, Database, Cache, Queue, Events
+- ❌ Increased maintenance burden (N frameworks to update)
+- ❌ Inconsistency risk across modules
+- ❌ Massive refactoring effort (6-12 months)
+- ❌ Loss of framework investment (3,883 files built over time)
+
+**Estimated Effort**: 6-12 months
+**Risk Level**: HIGH
+
+---
+
+### Option 2: Hybrid Approach (Layers + Modules)
+
+**Recommended Structure**:
+```
+src/
+├── Domain/                  (20-30% - business logic)
+│   ├── User/               (Module - bounded context)
+│   │   ├── Entity/
+│   │   ├── ValueObject/
+│   │   ├── Event/
+│   │   ├── Repository/     (Interfaces only!)
+│   │   └── Service/
+│   ├── Order/              (Module - bounded context)
+│   │   ├── Entity/
+│   │   ├── ValueObject/
+│   │   ├── Event/
+│   │   ├── Repository/
+│   │   └── Service/
+│   └── Product/            (Module - bounded context)
+│
+├── Application/             (25-35% - use cases)
+│   ├── User/               (Module - aligned with domain)
+│   │   ├── Controller/
+│   │   ├── Command/
+│   │   └── Query/
+│   ├── Order/              (Module - aligned with domain)
+│   │   ├── Controller/
+│   │   ├── Command/
+│   │   └── Query/
+│   └── Admin/              (Feature module - cross-cutting)
+│       ├── Analytics/
+│       ├── Content/
+│       └── System/
+│
+├── Framework/               (40-50% - SHARED infrastructure)
+│   ├── Core/               # Shared by ALL modules
+│   ├── Database/           # Shared by ALL modules
+│   ├── Http/               # Shared by ALL modules
+│   ├── Cache/              # Shared by ALL modules
+│   ├── Queue/              # Shared by ALL modules
+│   ├── Events/             # Shared by ALL modules
+│   └── [32 more shared components]
+│
+└── Infrastructure/          (5-10% - external integrations)
+    └── ServiceProviders/   # Module-specific DI setup
+        ├── UserServiceProvider.php
+        ├── OrderServiceProvider.php
+        └── ProductServiceProvider.php
+```
+
+**Advantages**:
+- ✅ Clean Architecture compliance maintained
+- ✅ **Framework shared across all modules** (no duplication!)
+- ✅ Modular organization where beneficial (Domain, Application)
+- ✅ Domain-Driven Design benefits (bounded contexts)
+- ✅ Reduced refactoring effort (2-3 months)
+- ✅ Framework investment preserved
+- ✅ Single framework to maintain and update
+- ✅ Consistency across modules (shared patterns)
+- ✅ Testability (clear boundaries, mocking framework components)
+
+**Disadvantages**:
+- ⚠️ Framework is shared dependency (not pure bounded contexts)
+- ⚠️ Module deployment still coupled via framework
+- ⚠️ Requires discipline to avoid cross-domain dependencies
+
+**Estimated Effort**: 2-3 months
+**Risk Level**: LOW-MEDIUM
+
+---
+
+### Option 3: Keep Current Structure (Do Nothing)
+
+**Structure**: Current 4-layer architecture without modular organization
+
+**Advantages**:
+- ✅ Zero refactoring effort
+- ✅ No disruption to development
+
+**Disadvantages**:
+- ❌ Architectural violations remain (HTTP in Domain, DI in Domain)
+- ❌ Poor domain organization (Domain layer too thin at 4%)
+- ❌ Framework bloat (85.3% - too large)
+- ❌ Technical debt accumulation
+- ❌ Reduced maintainability over time
+
+**Estimated Effort**: 0 months (no change)
+**Risk Level**: HIGH (accumulating technical debt)
+
+---
+
+## Decision Outcome
+
+### Chosen Option: **Option 2 - Hybrid Approach (Layers + Modules)**
+
+**Rationale**:
+
+1. **Framework Reusability**: 85.3% of codebase is framework infrastructure that SHOULD be shared
+   - Database layer (387 files) - shared across all modules
+   - HTTP layer (156 files) - shared routing, middleware
+   - Queue system (89 files) - shared background processing
+   - Cache layer (67 files) - shared caching infrastructure
+   - 40 more framework components - all reusable
+
+2. **Clean Architecture Preserved**: Maintains dependency rule while adding modularity
+   - Domain depends on nothing
+   - Application depends on Domain
+   - Framework provides infrastructure
+   - Infrastructure implements interfaces
+
+3. **Domain-Driven Design Benefits**: Modules represent bounded contexts
+   - `Domain/User/` - user bounded context
+   - `Domain/Order/` - order bounded context
+   - `Domain/Product/` - product bounded context
+   - Clear boundaries, no cross-domain dependencies
+
+4. **Realistic Refactoring Timeline**: 2-3 months vs 6-12 months
+   - Phase 1: Priority 1 Fixes (2-3 days)
+   - Phase 2: Domain Layer Modularization (1-2 weeks)
+   - Phase 3: Application Layer Modularization (1-2 weeks)
+   - Phase 4: Infrastructure Consolidation (1-2 weeks)
+
+5. **Risk Mitigation**: Incremental changes, testable at each phase
+
+---
+
+## Implementation Strategy
+
+### Phase 1: Priority 1 Fixes (2-3 days) - CRITICAL
+
+**Objective**: Fix architectural violations
+
+**Tasks**:
+
+1. **Move HTTP out of Domain**
+   ```bash
+   # Before: src/Domain/Meta/Http/Controller/MetaAdminController.php
+   # After:  src/Application/Admin/Controllers/Meta/MetaAdminController.php
+
+   mv src/Domain/Meta/Http/Controller/ src/Application/Admin/Controllers/Meta/
+   mv src/Domain/Meta/Http/Middleware/ src/Framework/Http/Middlewares/
+   ```
+
+2. **Move DI to Infrastructure**
+   ```bash
+   mkdir -p src/Infrastructure/ServiceProviders
+
+   # Transform Initializers to ServiceProviders
+   mv src/Domain/Asset/DI/AssetServiceInitializer.php \
+      src/Infrastructure/ServiceProviders/AssetServiceProvider.php
+
+   mv src/Domain/Cms/DI/CmsServiceInitializer.php \
+      src/Infrastructure/ServiceProviders/CmsServiceProvider.php
+
+   # Repeat for User, Order, Console domains
+   ```
+
+3. **Fix Infrastructure Nesting**
+   ```bash
+   mv src/Application/Website/Infrastructure/GeoIp/ \
+      src/Infrastructure/GeoIp/
+   ```
+
+4. **Update Namespaces and Imports**
+   - Run PSR-4 compliance check
+   - Update all references to moved files
+   - Test all affected functionality
+
+**Success Criteria**:
+- ✅ Zero architectural violations
+- ✅ All tests pass
+- ✅ PSR-4 compliance: 100%
+
+**Code Example - ServiceProvider Transformation**:
+
+```php
+// Before: src/Domain/Asset/DI/AssetServiceInitializer.php
+namespace App\Domain\Asset\DI;
+
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+
+final readonly class AssetServiceInitializer
+{
+    #[Initializer]
+    public function __invoke(Container $container): void
+    {
+        $container->singleton(AssetRepository::class, ...);
+        $container->singleton(AssetService::class, ...);
+    }
+}
+
+// After: src/Infrastructure/ServiceProviders/AssetServiceProvider.php
+namespace App\Infrastructure\ServiceProviders;
+
+use App\Framework\DI\Container;
+use App\Framework\DI\ServiceProvider;
+
+final readonly class AssetServiceProvider implements ServiceProvider
+{
+    public function register(Container $container): void
+    {
+        $container->singleton(AssetRepository::class, ...);
+        $container->singleton(AssetService::class, ...);
+    }
+}
+```
+
+---
+
+### Phase 2: Domain Layer Modularization (1-2 weeks)
+
+**Objective**: Organize Domain layer by bounded contexts
+
+**Current State**:
+```
+src/Domain/
+├── User/         (23 files) - mixed structure
+├── Asset/        (18 files) - mixed structure
+├── Cms/          (15 files) - mixed structure
+├── Order/        (29 files) - mixed structure
+└── Product/      (12 files) - mixed structure
+```
+
+**Target State**:
+```
+src/Domain/
+├── User/                    # User bounded context
+│   ├── Entity/
+│   │   └── User.php
+│   ├── ValueObject/
+│   │   ├── UserId.php
+│   │   ├── Email.php
+│   │   └── UserName.php
+│   ├── Event/
+│   │   ├── UserRegisteredEvent.php
+│   │   └── UserUpdatedEvent.php
+│   ├── Repository/
+│   │   └── UserRepositoryInterface.php  # Interface only!
+│   └── Service/
+│       └── UserService.php
+│
+├── Order/                   # Order bounded context
+│   ├── Entity/
+│   │   ├── Order.php
+│   │   └── OrderItem.php
+│   ├── ValueObject/
+│   │   ├── OrderId.php
+│   │   ├── OrderStatus.php
+│   │   └── Money.php
+│   ├── Event/
+│   │   ├── OrderCreatedEvent.php
+│   │   └── OrderCompletedEvent.php
+│   ├── Repository/
+│   │   └── OrderRepositoryInterface.php
+│   └── Service/
+│       └── OrderService.php
+│
+└── Product/                 # Product bounded context
+    ├── Entity/
+    ├── ValueObject/
+    ├── Event/
+    ├── Repository/
+    └── Service/
+```
+
+**Benefits**:
+- Clear bounded contexts
+- Self-documenting structure
+- Easy to locate domain logic
+- No cross-domain dependencies
+- Repository interfaces (implementations in Infrastructure)
+
+---
+
+### Phase 3: Application Layer Modularization (1-2 weeks)
+
+**Objective**: Align Application layer with Domain modules
+
+**Current State**:
+```
+src/Application/
+├── Website/       (89 files) - feature-based
+├── Admin/         (234 files) - feature-based
+├── Api/           (67 files) - feature-based
+├── Contact/       (8 files) - feature-based
+└── Console/       (22 files) - feature-based
+```
+
+**Target State**:
+```
+src/Application/
+├── User/                    # Aligned with Domain/User
+│   ├── Controller/
+│   │   └── UserController.php
+│   ├── Command/
+│   │   ├── CreateUserCommand.php
+│   │   └── CreateUserHandler.php
+│   └── Query/
+│       ├── GetUserQuery.php
+│       └── GetUserHandler.php
+│
+├── Order/                   # Aligned with Domain/Order
+│   ├── Controller/
+│   ├── Command/
+│   └── Query/
+│
+├── Product/                 # Aligned with Domain/Product
+│   ├── Controller/
+│   ├── Command/
+│   └── Query/
+│
+└── Admin/                   # Cross-cutting feature module
+    ├── Analytics/
+    ├── Content/
+    ├── Infrastructure/
+    ├── Notifications/
+    └── System/
+```
+
+**Benefits**:
+- Clear mapping: Application/User → Domain/User
+- CQRS patterns (Command/Query separation)
+- Feature-based organization where appropriate (Admin)
+- Reduced cognitive load
+
+---
+
+### Phase 4: Infrastructure Consolidation (1-2 weeks)
+
+**Objective**: Centralize infrastructure implementations
+
+**Target State**:
+```
+src/Infrastructure/
+├── ServiceProviders/        # DI setup per module
+│   ├── UserServiceProvider.php
+│   ├── OrderServiceProvider.php
+│   └── ProductServiceProvider.php
+│
+├── Persistence/             # Database implementations
+│   ├── User/
+│   │   └── DatabaseUserRepository.php    # Implements Domain/User/Repository/UserRepositoryInterface
+│   ├── Order/
+│   │   └── DatabaseOrderRepository.php
+│   └── Product/
+│       └── DatabaseProductRepository.php
+│
+├── GeoIp/                   # External service integrations
+│   ├── GeoIpService.php
+│   └── MaxMindProvider.php
+│
+└── Email/                   # External service integrations
+    ├── EmailService.php
+    └── SmtpProvider.php
+```
+
+**Benefits**:
+- Infrastructure implementations separated from Domain interfaces
+- Clear dependency inversion (Domain → Interface ← Infrastructure)
+- Easy to swap implementations (testing, different databases)
+- ServiceProviders wire up dependencies
+
+---
+
+## Consequences
+
+### Positive Consequences
+
+1. **Clean Architecture Compliance**
+   - All layers respect Dependency Rule
+   - Domain layer pure (no framework dependencies)
+   - Testability improved (mock infrastructure easily)
+
+2. **Domain-Driven Design Benefits**
+   - Clear bounded contexts (User, Order, Product)
+   - Domain logic focused and cohesive
+   - Business rules visible and maintainable
+
+3. **Framework Preservation**
+   - No code duplication (Framework shared)
+   - Single framework to maintain
+   - Consistency across all modules
+   - Framework investment preserved (3,883 files)
+
+4. **Maintainability**
+   - Clear structure reduces cognitive load
+   - Easy to locate code (Domain/User/Entity/User.php)
+   - Self-documenting architecture
+   - Onboarding new developers easier
+
+5. **Realistic Timeline**
+   - 2-3 months total effort
+   - Incremental changes (low risk)
+   - Testable at each phase
+
+### Negative Consequences (Mitigated)
+
+1. **Framework is Shared Dependency**
+   - **Mitigation**: Framework is stable, well-tested infrastructure
+   - **Trade-off**: Accepting this trade-off for massive code reuse benefit
+
+2. **Module Deployment Coupling**
+   - **Mitigation**: Not pursuing microservices architecture (monolith is appropriate)
+   - **Trade-off**: Deployment simplicity vs independent module deployment
+
+3. **Discipline Required**
+   - **Mitigation**: Code review process, automated PSR-4 checks, architectural tests
+   - **Trade-off**: Team training vs long-term maintainability
+
+---
+
+## Comparison Matrix
+
+| Aspect | Pure Modules | Hybrid (Recommended) | Keep Current |
+|--------|-------------|---------------------|--------------|
+| **Clean Architecture** | ✅ Yes | ✅ Yes | ❌ Violations exist |
+| **DDD Bounded Contexts** | ✅ Pure | ✅ Practical | ❌ Weak |
+| **Framework Duplication** | ❌ Massive (85.3% × N) | ✅ None (shared) | ✅ None |
+| **Code Reuse** | ❌ Low (per-module) | ✅ High (shared) | ✅ High |
+| **Refactoring Effort** | ❌ 6-12 months | ✅ 2-3 months | ✅ 0 months |
+| **Risk Level** | ❌ HIGH | ✅ LOW-MEDIUM | ❌ HIGH (debt) |
+| **Team Autonomy** | ✅ Full (per module) | ⚠️ Partial | ❌ None |
+| **Deploy Independence** | ✅ Yes (microservices) | ❌ No (monolith) | ❌ No |
+| **Maintenance Burden** | ❌ High (N frameworks) | ✅ Low (1 framework) | ⚠️ Medium |
+| **Architectural Quality** | ✅ A+ (pure DDD) | ✅ A (pragmatic) | ❌ C+ (violations) |
+
+**Scoring**:
+- Pure Modules: 5/10 (ideal theory, impractical for this project)
+- **Hybrid: 9/10 (recommended - pragmatic and effective)**
+- Keep Current: 3/10 (accumulating technical debt)
+
+---
+
+## Migration Risks & Mitigation
+
+### Risk 1: Breaking Changes During Refactoring
+
+**Probability**: MEDIUM
+**Impact**: HIGH
+
+**Mitigation**:
+- Comprehensive test suite BEFORE starting
+- Feature flags for gradual rollout
+- Incremental changes with continuous testing
+- Rollback plan for each phase
+
+### Risk 2: Team Resistance to Change
+
+**Probability**: LOW
+**Impact**: MEDIUM
+
+**Mitigation**:
+- Document rationale (this document)
+- Training sessions on new structure
+- Gradual transition (4 phases over 2-3 months)
+- Team involvement in decision-making
+
+### Risk 3: Overlooked Dependencies
+
+**Probability**: MEDIUM
+**Impact**: MEDIUM
+
+**Mitigation**:
+- Automated dependency analysis
+- PSR-4 compliance checks
+- Static analysis tools (PHPStan)
+- Code review process for all moves
+
+### Risk 4: Timeline Overrun
+
+**Probability**: LOW
+**Impact**: MEDIUM
+
+**Mitigation**:
+- Conservative time estimates (2-3 months)
+- Phase-based approach (can pause between phases)
+- Automated tooling for bulk operations
+- Dedicated refactoring time (not mixed with feature work)
+
+---
+
+## Success Metrics
+
+### Phase 1 Completion (Priority 1 Fixes)
+- ✅ Zero architectural violations
+- ✅ All tests pass (100%)
+- ✅ PSR-4 compliance: 100%
+- ✅ No HTTP code in Domain layer
+- ✅ No DI code in Domain layer
+- ✅ Infrastructure at top level (not nested)
+
+### Phase 2-4 Completion (Full Migration)
+- ✅ Domain layer: 15-20% of codebase (from 4%)
+- ✅ Framework layer: 40-50% of codebase (from 85.3%)
+- ✅ Clear bounded contexts in Domain layer
+- ✅ Application layer aligned with Domain modules
+- ✅ Infrastructure ServiceProviders per module
+- ✅ Overall Architecture Grade: A- (90%) (from C+ 75%)
+
+### Long-Term Success
+- ✅ Reduced time to locate code (faster development)
+- ✅ Easier onboarding (clear structure)
+- ✅ Fewer architectural violations (ongoing)
+- ✅ Higher test coverage (better boundaries)
+- ✅ Improved maintainability (team feedback)
+
+---
+
+## Code Examples
+
+### Example 1: Domain Module (User Bounded Context)
+
+**Before Migration**:
+```
+src/Domain/User/
+├── User.php                           # Mixed: Entity + logic
+├── UserRepository.php                 # Confusion: Interface or implementation?
+├── UserService.php                    # Service
+└── DI/
+    └── UserServiceInitializer.php    # WRONG: DI in Domain!
+```
+
+**After Migration**:
+```
+src/Domain/User/
+├── Entity/
+│   └── User.php                       # Pure entity
+├── ValueObject/
+│   ├── UserId.php                     # Type-safe ID
+│   ├── Email.php                      # Validated email
+│   └── UserName.php                   # Validated name
+├── Event/
+│   └── UserRegisteredEvent.php       # Domain event
+├── Repository/
+│   └── UserRepositoryInterface.php   # Interface only!
+└── Service/
+    └── UserService.php                # Domain service
+```
+
+**Domain Entity** (Pure business logic):
+```php
+// src/Domain/User/Entity/User.php
+namespace App\Domain\User\Entity;
+
+use App\Domain\User\ValueObject\{UserId, Email, UserName};
+use App\Domain\User\Event\UserRegisteredEvent;
+
+final readonly class User
+{
+    public function __construct(
+        public UserId $id,
+        public Email $email,
+        public UserName $name,
+        public bool $active = true
+    ) {}
+
+    public static function register(Email $email, UserName $name): self
+    {
+        $user = new self(
+            id: UserId::generate(),
+            email: $email,
+            name: $name
+        );
+
+        // Domain event - no framework dependency!
+        DomainEvents::raise(new UserRegisteredEvent($user));
+
+        return $user;
+    }
+
+    public function deactivate(): self
+    {
+        return new self(
+            id: $this->id,
+            email: $this->email,
+            name: $this->name,
+            active: false
+        );
+    }
+}
+```
+
+**Repository Interface** (Domain layer):
+```php
+// src/Domain/User/Repository/UserRepositoryInterface.php
+namespace App\Domain\User\Repository;
+
+use App\Domain\User\Entity\User;
+use App\Domain\User\ValueObject\{UserId, Email};
+
+interface UserRepositoryInterface
+{
+    public function find(UserId $id): ?User;
+    public function findByEmail(Email $email): ?User;
+    public function save(User $user): void;
+    public function delete(User $user): void;
+}
+```
+
+**Repository Implementation** (Infrastructure layer):
+```php
+// src/Infrastructure/Persistence/User/DatabaseUserRepository.php
+namespace App\Infrastructure\Persistence\User;
+
+use App\Domain\User\Repository\UserRepositoryInterface;
+use App\Domain\User\Entity\User;
+use App\Framework\Database\EntityManager;
+
+final readonly class DatabaseUserRepository implements UserRepositoryInterface
+{
+    public function __construct(
+        private EntityManager $entityManager
+    ) {}
+
+    public function find(UserId $id): ?User
+    {
+        return $this->entityManager->find(User::class, $id->value);
+    }
+
+    public function save(User $user): void
+    {
+        $this->entityManager->save($user);
+    }
+}
+```
+
+**ServiceProvider** (Infrastructure layer - wires dependencies):
+```php
+// src/Infrastructure/ServiceProviders/UserServiceProvider.php
+namespace App\Infrastructure\ServiceProviders;
+
+use App\Framework\DI\Container;
+use App\Domain\User\Repository\UserRepositoryInterface;
+use App\Infrastructure\Persistence\User\DatabaseUserRepository;
+
+final readonly class UserServiceProvider
+{
+    public function register(Container $container): void
+    {
+        // Wire Domain interface → Infrastructure implementation
+        $container->singleton(
+            UserRepositoryInterface::class,
+            fn() => new DatabaseUserRepository(
+                $container->get(EntityManager::class)
+            )
+        );
+    }
+}
+```
+
+---
+
+### Example 2: Application Layer (CQRS Pattern)
+
+**Structure**:
+```
+src/Application/User/
+├── Controller/
+│   └── UserController.php
+├── Command/                           # Write operations
+│   ├── CreateUserCommand.php
+│   └── CreateUserHandler.php
+└── Query/                             # Read operations
+    ├── GetUserQuery.php
+    └── GetUserHandler.php
+```
+
+**Controller** (Thin - delegates to Command/Query handlers):
+```php
+// src/Application/User/Controller/UserController.php
+namespace App\Application\User\Controller;
+
+use App\Framework\Attributes\Route;
+use App\Framework\Http\{Method, JsonResult, Status};
+use App\Application\User\Command\{CreateUserCommand, CreateUserHandler};
+use App\Application\User\Query\{GetUserQuery, GetUserHandler};
+
+final readonly class UserController
+{
+    public function __construct(
+        private CreateUserHandler $createHandler,
+        private GetUserHandler $getHandler
+    ) {}
+
+    #[Route(path: '/api/users', method: Method::POST)]
+    public function create(CreateUserRequest $request): JsonResult
+    {
+        $command = new CreateUserCommand(
+            $request->email,
+            $request->name
+        );
+
+        $user = $this->createHandler->handle($command);
+
+        return new JsonResult(
+            ['id' => $user->id->value],
+            status: Status::CREATED
+        );
+    }
+
+    #[Route(path: '/api/users/{id}', method: Method::GET)]
+    public function get(string $id): JsonResult
+    {
+        $query = new GetUserQuery(new UserId($id));
+        $user = $this->getHandler->handle($query);
+
+        return new JsonResult($user->toArray());
+    }
+}
+```
+
+**Command Handler** (Business logic):
+```php
+// src/Application/User/Command/CreateUserHandler.php
+namespace App\Application\User\Command;
+
+use App\Domain\User\Entity\User;
+use App\Domain\User\Repository\UserRepositoryInterface;
+
+final readonly class CreateUserHandler
+{
+    public function __construct(
+        private UserRepositoryInterface $repository
+    ) {}
+
+    public function handle(CreateUserCommand $command): User
+    {
+        // Domain logic
+        $user = User::register($command->email, $command->name);
+
+        // Persistence via Domain interface
+        $this->repository->save($user);
+
+        return $user;
+    }
+}
+```
+
+---
+
+## Alternative Approaches Considered
+
+### Alternative 1: Microservices Architecture
+
+**Why Rejected**:
+- Premature optimization for current scale
+- Operational complexity (deployment, monitoring, debugging)
+- Network latency overhead
+- Distributed transaction challenges
+- Team not structured for microservices (no dedicated platform team)
+
+### Alternative 2: Event Sourcing + CQRS (Full)
+
+**Why Rejected**:
+- Significant complexity increase
+- Learning curve for team
+- Infrastructure requirements (event store)
+- Eventual consistency challenges
+- Overkill for current business requirements
+
+### Alternative 3: Module-per-Repository (Monorepo)
+
+**Why Rejected**:
+- Still duplicates Framework code per repository
+- Tooling complexity (cross-repo dependencies)
+- Versioning challenges
+- Overhead not justified for current team size
+
+---
+
+## Related Decisions
+
+- **ADR-001**: Use Custom PHP Framework (already decided)
+- **ADR-002**: Adopt Clean Architecture principles (already decided)
+- **ADR-003**: Use Composition over Inheritance (already decided)
+- **ADR-004**: Value Objects over Primitives (already decided)
+- **ADR-005**: Attribute-based Discovery (already decided)
+
+**This Decision**: **ADR-006 - Hybrid Layer-Module Architecture**
+
+---
+
+## References
+
+### Internal Documents
+- `docs/SRC-ARCHITECTURE-ANALYSIS.md` - Current architecture analysis
+- `docs/DOCUMENTATION-ANALYSIS.md` - Documentation structure
+- `docs/claude/architecture.md` - Framework architecture guide
+- `docs/claude/guidelines.md` - Development guidelines
+
+### Clean Architecture
+- "Clean Architecture" by Robert C. Martin
+- Dependency Rule: Dependencies point inward (Domain → Application → Framework)
+- Testability: Inner layers testable without outer layers
+
+### Domain-Driven Design
+- "Domain-Driven Design" by Eric Evans
+- Bounded Contexts: Clear boundaries between domains
+- Ubiquitous Language: Domain-specific terminology
+- Aggregates: Consistency boundaries
+
+### Framework Patterns
+- Martin Fowler's Enterprise Application Patterns
+- Repository Pattern: Data access abstraction
+- CQRS: Command-Query Responsibility Segregation
+- Event-Driven Architecture: Loose coupling via events
+
+---
+
+## Timeline & Next Steps
+
+### Immediate Next Steps (Week 1)
+
+**Day 1-2**: Phase 1 - Priority 1 Fixes
+- Move HTTP out of Domain (2 hours)
+- Move DI to Infrastructure (4 hours)
+- Fix Infrastructure nesting (1 hour)
+- Update namespaces (3 hours)
+- **Total**: 10 hours
+
+**Day 3**: Testing & Validation
+- Run full test suite
+- PSR-4 compliance check
+- Architectural violation check
+- **Total**: 4 hours
+
+### Short-Term (Weeks 2-4): Phase 2 - Domain Modularization
+- Organize User domain (1 week)
+- Organize Order domain (1 week)
+- Organize Product, Asset, Cms domains (1 week)
+
+### Mid-Term (Weeks 5-8): Phase 3 - Application Modularization
+- Restructure User application layer (1 week)
+- Restructure Order application layer (1 week)
+- Restructure Admin feature module (2 weeks)
+
+### Long-Term (Weeks 9-12): Phase 4 - Infrastructure Consolidation
+- Create ServiceProviders (1 week)
+- Organize Persistence layer (1 week)
+- Migrate external service integrations (1 week)
+- Final testing & documentation (1 week)
+
+**Total Timeline**: 12 weeks (3 months) - conservative estimate
+
+---
+
+## Approval & Sign-Off
+
+**Decision Maker**: Development Team Lead
+**Date**: 2025-01-28
+**Status**: Recommended for Approval
+
+**Review Required By**:
+- [ ] Technical Architect
+- [ ] Development Team
+- [ ] Product Owner
+- [ ] CTO
+
+**Implementation Start**: After approval
+**Estimated Completion**: 3 months from start
+
+---
+
+## Appendix A: Framework Layer Breakdown
+
+**Why Framework Must Be Shared** (3,883 files - 85.3%):
+
+```
+src/Framework/
+├── Core/                 (245 files) - Application bootstrap, routing, DI
+├── Database/             (387 files) - EntityManager, Schema Builder, Migrations
+├── Http/                 (156 files) - Request/Response, Middleware, Routing
+├── Queue/                (89 files) - Job processing, Workers, Queue drivers
+├── Cache/                (67 files) - Cache abstraction, Drivers (Redis, File)
+├── ExceptionHandling/    (124 files) - Error handling, Exception types
+├── Discovery/            (78 files) - Attribute discovery, Convention scanning
+├── View/                 (201 files) - Template engine, Components
+├── Events/               (95 files) - Event dispatcher, Domain events
+├── Console/              (167 files) - CLI commands, TUI components
+├── Validation/           (54 files) - Input validation, Rules
+├── Security/             (89 files) - Authentication, Authorization, WAF
+├── Logging/              (48 files) - Logger, Handlers
+├── MCP/                  (123 files) - Model Context Protocol (AI integration)
+└── [28 more components]  (1,960 files)
+
+Total: 3,883 files
+```
+
+**Duplication Impact**: If pure module approach chosen, each module would duplicate most of these 3,883 files, resulting in:
+- 5 modules × 3,883 files = **19,415 files** (vs current 3,883)
+- Maintenance nightmare: Update framework → update 5 copies
+- Consistency issues: Framework versions drift across modules
+- Lost investment: Years of framework development duplicated
+
+**Conclusion**: Framework MUST be shared infrastructure, not duplicated per module.
+
+---
+
+## Appendix B: PSR-4 Mapping
+
+**After Migration**:
+
+```json
+{
+    "autoload": {
+        "psr-4": {
+            "App\\Domain\\": "src/Domain/",
+            "App\\Application\\": "src/Application/",
+            "App\\Framework\\": "src/Framework/",
+            "App\\Infrastructure\\": "src/Infrastructure/"
+        }
+    }
+}
+```
+
+**Example Mappings**:
+```
+Namespace                                          → File
+App\Domain\User\Entity\User                       → src/Domain/User/Entity/User.php
+App\Domain\User\Repository\UserRepositoryInterface → src/Domain/User/Repository/UserRepositoryInterface.php
+App\Application\User\Command\CreateUserCommand     → src/Application/User/Command/CreateUserCommand.php
+App\Infrastructure\Persistence\User\DatabaseUserRepository → src/Infrastructure/Persistence/User/DatabaseUserRepository.php
+App\Framework\Database\EntityManager               → src/Framework/Database/EntityManager.php
+```
+
+**Validation**:
+```bash
+# Verify PSR-4 compliance
+composer dump-autoload --optimize
+composer validate --strict
+
+# Check for PSR-4 violations
+./vendor/bin/phpstan analyze --level=8
+```
+
+---
+
+**End of Document**
+
+**Version**: 1.0
+**Last Updated**: 2025-01-28
+**Authors**: Architecture Team
+**Reviewers**: Development Team
diff --git a/docs/DOCUMENTATION-ANALYSIS.md b/docs/DOCUMENTATION-ANALYSIS.md
new file mode 100644
index 00000000..358edf45
--- /dev/null
+++ b/docs/DOCUMENTATION-ANALYSIS.md
@@ -0,0 +1,731 @@
+# Markdown Files Analysis - Custom PHP Framework
+
+**Generated:** $(date)
+**Total Project Files:** 1579 (including dependencies)
+**Relevant Files:** 513 (excluding node_modules, vendor, .git)
+
+---
+
+## Executive Summary
+
+This analysis covers all markdown files in the Custom PHP Framework project, excluding third-party dependencies. The goal is to reorganize documentation from AI-specific `/docs/claude/` to general `/docs/` structure.
+
+### Key Statistics
+- **Total Markdown Files:** 513
+- **Documentation Files:** ~100 (estimated, in /docs/)
+- **Source Code Docs:** ~50 (README files in /src/)
+- **Test Documentation:** ~20 (test strategy, examples)
+- **Configuration Docs:** ~10 (deployment, docker, ansible)
+- **Dependencies:** 1066 (node_modules + vendor - excluded)
+
+---
+
+## File Distribution by Directory
+
+
+```
+     63 ./docs/claude
+     57 ./docs
+     48 ./docs/deployment
+     17 ./src/Framework/View/Processors/docs
+     15 ./backups/docs-backup-20250731125004
+     14 ./.claude/agents
+     13 ./docs/livecomponents
+     12 ./.gitea/workflows
+     11 ./docs/planning
+      9 .
+      7 ./docs/guides
+      6 ./src/Framework/LiveComponents/docs
+      6 ./deployment/docs/tests
+      6 ./backups/docs-backup-20250731125004/framework
+      5 ./tests/e2e/livecomponents
+      5 ./resources/js/docs
+      5 ./deployment/wireguard
+      5 ./deployment/docs/status
+      5 ./deployment/docs/guides
+      5 ./backups/docs-backup-20250731125004/framework/analytics
+      4 ./src/Framework/LiveComponents
+      4 ./docs/todo
+      4 ./docs/contributing
+      4 ./docs/components/waf
+      4 ./docs/components/security
+      4 ./docs/components/cryptography
+      4 ./docs/components/auth
+      4 ./backups/docs-backup-20250731125004/design-system
+      3 ./src/Framework/ReflectionLegacy
+      3 ./docs/roadmap
+```
+
+
+---
+
+## Detailed File Listing by Category
+
+### 1. Documentation Directory (/docs/)
+
+- `./docs/admin-design-system.md` (479 lines)
+- `./docs/ADMIN-FORM-FIELDS-DESIGN.md` (440 lines)
+- `./docs/ADMIN-FORM-FIELDS-USAGE.md` (491 lines)
+- `./docs/api/index.md` (838 lines)
+- `./docs/api.md` (8 lines)
+- `./docs/api-versioning-examples.md` (294 lines)
+- `./docs/architecture/components.md` (528 lines)
+- `./docs/ARCHITECTURE_IMPROVEMENTS.md` (1981 lines)
+- `./docs/architecture/overview.md` (226 lines)
+- `./docs/architecture/patterns.md` (1137 lines)
+- `./docs/batch-api-examples.md` (236 lines)
+- `./docs/cache-warming.md` (699 lines)
+- `./docs/claude/animationsystem.md` (585 lines)
+- `./docs/claude/architecture.md` (189 lines)
+- `./docs/claude/async-components.md` (26 lines)
+- `./docs/claude/chips-cookies.md` (465 lines)
+- `./docs/claude/common-workflows.md` (1259 lines)
+- `./docs/claude/configuration-best-practices.md` (297 lines)
+- `./docs/claude/console-commands.md` (30 lines)
+- `./docs/claude/curl-oop-api.md` (996 lines)
+- `./docs/claude/database-patterns.md` (1526 lines)
+- `./docs/claude/deployment-architecture.md` (777 lines)
+- `./docs/claude/development-commands.md` (157 lines)
+- `./docs/claude/error-handling.md` (644 lines)
+- `./docs/claude/event-system.md` (963 lines)
+- `./docs/claude/examples/migrations/SafeVsUnsafeMigrations.md` (420 lines)
+- `./docs/claude/exception-system-advanced-features.md` (754 lines)
+- `./docs/claude/filesystem-patterns.md` (965 lines)
+- `./docs/claude/framework-personas.md` (766 lines)
+- `./docs/claude/framework-refactoring-recommendations.md` (748 lines)
+- `./docs/claude/guidelines.md` (882 lines)
+- `./docs/claude/livecomponent-file-uploads.md` (893 lines)
+- `./docs/claude/livecomponent-formbuilder-usage.md` (458 lines)
+- `./docs/claude/livecomponent-lazy-loading.md` (681 lines)
+- `./docs/claude/livecomponent-lifecycle-hooks.md` (572 lines)
+- `./docs/claude/livecomponent-nested-components.md` (717 lines)
+- `./docs/claude/livecomponents-best-practices.md` (461 lines)
+- `./docs/claude/livecomponents-caching-system.md` (683 lines)
+- `./docs/claude/livecomponents-dom-badges.md` (236 lines)
+- `./docs/claude/livecomponent-security.md` (223 lines)
+- `./docs/claude/livecomponents-implementation-plan.md` (699 lines)
+- `./docs/claude/livecomponents-lazy-loading.md` (717 lines)
+- `./docs/claude/livecomponent-slot-system.md` (1127 lines)
+- `./docs/claude/livecomponents-monitoring-debugging.md` (701 lines)
+- `./docs/claude/livecomponents-observability.md` (540 lines)
+- `./docs/claude/livecomponents-performance-optimizations.md` (725 lines)
+- `./docs/claude/livecomponents-playground.md` (1108 lines)
+- `./docs/claude/livecomponents-roadmap.md` (1027 lines)
+- `./docs/claude/livecomponents-system.md` (552 lines)
+- `./docs/claude/livecomponents-test-harness.md` (504 lines)
+- `./docs/claude/magiclinks-system.md` (807 lines)
+- `./docs/claude/mcp-integration.md` (260 lines)
+- `./docs/claude/migration-system-quick-reference.md` (202 lines)
+- `./docs/claude/ml-framework-architecture.md` (593 lines)
+- `./docs/claude/naming-conventions.md` (832 lines)
+- `./docs/claude/performance-monitoring.md` (30 lines)
+- `./docs/claude/performance-profiling.md` (857 lines)
+- `./docs/claude/php85-framework-integration.md` (550 lines)
+- `./docs/claude/posix-system.md` (1316 lines)
+- `./docs/claude/postgresql-features.md` (1127 lines)
+- `./docs/claude/queue-system.md` (1135 lines)
+- `./docs/claude/route-authorization.md` (291 lines)
+- `./docs/claude/routing-value-objects.md` (305 lines)
+- `./docs/claude/scheduler-queue-pipeline.md` (458 lines)
+- `./docs/claude/scheduler-queue-pipeline-persona.md` (273 lines)
+- `./docs/claude/security-patterns.md` (1135 lines)
+- `./docs/claude/sockets-module.md` (671 lines)
+- `./docs/claude/sse-integration-guide.md` (978 lines)
+- `./docs/claude/sse-system.md` (1068 lines)
+- `./docs/claude/structured-logging.md` (577 lines)
+- `./docs/claude/troubleshooting.md` (1074 lines)
+- `./docs/claude/typed-string-system.md` (1141 lines)
+- `./docs/claude/view-caching-system.md` (716 lines)
+- `./docs/claude/view-refactoring-plan.md` (614 lines)
+- `./docs/claude/xcomponent-processor.md` (764 lines)
+- `./docs/claude/x-component-syntax.md` (335 lines)
+- `./docs/components/analytics/configuration.md` (477 lines)
+- `./docs/components/analytics/examples.md` (760 lines)
+- `./docs/components/analytics/index.md` (507 lines)
+- `./docs/components/auth/configuration.md` (429 lines)
+- `./docs/components/auth/examples.md` (796 lines)
+- `./docs/components/auth/index.md` (309 lines)
+- `./docs/components/auth/security.md` (903 lines)
+- `./docs/components/cryptography/configuration.md` (396 lines)
+- `./docs/components/cryptography/examples.md` (702 lines)
+- `./docs/components/cryptography/index.md` (364 lines)
+- `./docs/components/cryptography/security.md` (727 lines)
+- `./docs/components/security/csrf-protection.md` (417 lines)
+- `./docs/components/security/index.md` (363 lines)
+- `./docs/components/security/request-signing.md` (410 lines)
+- `./docs/components/security/security-headers.md` (382 lines)
+- `./docs/components/validation/examples.md` (424 lines)
+- `./docs/components/validation/index.md` (338 lines)
+- `./docs/components/validation/rules.md` (451 lines)
+- `./docs/components/waf/configuration.md` (279 lines)
+- `./docs/components/waf/feedback.md` (280 lines)
+- `./docs/components/waf/index.md` (135 lines)
+- `./docs/components/waf/machine-learning.md` (252 lines)
+- `./docs/console-best-practices.md` (486 lines)
+- `./docs/console-dialog-mode.md` (472 lines)
+- `./docs/console-optional-parameters.md` (422 lines)
+- `./docs/contributing/code-style.md` (598 lines)
+- `./docs/contributing/documentation.md` (345 lines)
+- `./docs/contributing/git-hooks.md` (151 lines)
+- `./docs/contributing/pull-requests.md` (334 lines)
+- `./docs/database-migration-fix.md` (78 lines)
+- `./docs/database-module-migration-analysis.md` (413 lines)
+- `./docs/database/new-features.md` (329 lines)
+- `./docs/DefaultImplementation-Attribute.md` (447 lines)
+- `./docs/dependency-scanning.md` (401 lines)
+- `./docs/deployment/ANSIBLE_DEPLOYMENT.md` (969 lines)
+- `./docs/deployment/AUTOSSH-SETUP-COMPLETED.md` (243 lines)
+- `./docs/deployment/AUTOSSH-SETUP.md` (428 lines)
+- `./docs/deployment/cache-configuration.md` (244 lines)
+- `./docs/deployment/cache-permissions-quick-fix.md` (74 lines)
+- `./docs/deployment/database-migration-strategy.md` (775 lines)
+- `./docs/deployment/deployment-automation.md` (816 lines)
+- `./docs/deployment/env-production-template.md` (407 lines)
+- `./docs/deployment/gitea-secrets-setup.md` (297 lines)
+- `./docs/deployment/GRAFANA-VPN-ACCESS.md` (108 lines)
+- `./docs/deployment/GRAFANA-VPN-NEXT-STEPS.md` (125 lines)
+- `./docs/deployment/GRAFANA-VPN-SECURITY-PLAN.md` (149 lines)
+- `./docs/deployment/local-secrets-unification-plan.md` (470 lines)
+- `./docs/deployment/local-stack-restructure-plan.md` (359 lines)
+- `./docs/deployment/logging-configuration.md` (715 lines)
+- `./docs/deployment/production-compose-consolidation-plan.md` (262 lines)
+- `./docs/deployment/production-logging.md` (601 lines)
+- `./docs/deployment/production-prerequisites.md` (340 lines)
+- `./docs/deployment/PRODUCTION-SECURITY-UPDATES.md` (133 lines)
+- `./docs/deployment/README.md` (67 lines)
+- `./docs/deployment/secrets-management.md` (614 lines)
+- `./docs/deployment/shared-postgres-override-plan.md` (303 lines)
+- `./docs/deployment/SSH-MAKEFILE-COMMANDS.md` (319 lines)
+- `./docs/deployment/SSL-PRODUCTION-SETUP.md` (194 lines)
+- `./docs/deployment/ssl-setup.md` (540 lines)
+- `./docs/deployment/staging-database-connection-analysis.md` (185 lines)
+- `./docs/deployment/staging-postgres-connection-plan.md` (209 lines)
+- `./docs/deployment/test-registry-credentials.md` (197 lines)
+- `./docs/deployment/VPN-ROUTING-CLIENT-CHECK.md` (195 lines)
+- `./docs/deployment/VPN-ROUTING-FINAL-FIX.md` (91 lines)
+- `./docs/deployment/VPN-ROUTING-FIX-DETAILED.md` (100 lines)
+- `./docs/deployment/VPN-ROUTING-FIX-GUIDE.md` (143 lines)
+- `./docs/deployment/VPN-ROUTING-FIX.md` (120 lines)
+- `./docs/deployment/VPN-ROUTING-PROBLEM-ANALYSIS.md` (120 lines)
+- `./docs/deployment/WIREGUARD-DNS-FIX-IMPLEMENTED.md` (283 lines)
+- `./docs/deployment/WIREGUARD-FUTURE-SECURITY.md` (243 lines)
+- `./docs/deployment/WIREGUARD-IMPLEMENTATION-PLAN.md` (1175 lines)
+- `./docs/deployment/WIREGUARD-NEW-CONFIG-READY.md` (123 lines)
+- `./docs/deployment/WIREGUARD-RECREATE-AND-TEST.md` (176 lines)
+- `./docs/deployment/WIREGUARD-SETUP.md` (595 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-CONFIG-EXAMPLE.md` (48 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-DNS-FIX.md` (141 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-DNS-PRIORITY-FIX.md` (108 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-FIREWALL-CHECK.md` (186 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-INTERFACE-METRIC-FIX.md` (63 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-ROUTE-FIX.md` (103 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-ROUTE-GATEWAY-FIX.md` (176 lines)
+- `./docs/deployment/WIREGUARD-WINDOWS-ROUTING-FINAL-ANALYSIS.md` (109 lines)
+- `./docs/design-token-system.md` (374 lines)
+- `./docs/error-handler-enhancements.md` (615 lines)
+- `./docs/ERROR-HANDLING-AUDIT-REPORT.md` (708 lines)
+- `./docs/ERROR-HANDLING-MIGRATION-PLAN.md` (3319 lines)
+- `./docs/ERROR-HANDLING-UNIFIED-ARCHITECTURE.md` (1766 lines)
+- `./docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md` (274 lines)
+- `./docs/ERROR-RENDERER-REFACTORING-PLAN.md` (199 lines)
+- `./docs/examples/poll-system-usage.md` (609 lines)
+- `./docs/exception-hierarchy-pattern.md` (684 lines)
+- `./docs/exception-migration-guide.md` (1132 lines)
+- `./docs/FILECACHE_PERMISSION_FIX_PLAN.md` (217 lines)
+- `./docs/FILEPERMISSION_EXCEPTION_IMPROVEMENT_PLAN.md` (226 lines)
+- `./docs/FORPROCESSOR-FIX-SUMMARY.md` (190 lines)
+- `./docs/FORPROCESSOR-ISSUE-ANALYSIS.md` (106 lines)
+- `./docs/FRAMEWORK-IMPROVEMENT-PROPOSALS.md` (591 lines)
+- `./docs/FRAMEWORK_IMPROVEMENTS_ROADMAP.md` (173 lines)
+- `./docs/getting-started/configuration.md` (214 lines)
+- `./docs/getting-started/first-steps.md` (327 lines)
+- `./docs/getting-started/installation.md` (108 lines)
+- `./docs/gitea-actions-setup.md` (383 lines)
+- `./docs/graphql-examples.md` (386 lines)
+- `./docs/guides/controllers.md` (727 lines)
+- `./docs/guides/README-image-upload.md` (128 lines)
+- `./docs/guides/README-static-site.md` (118 lines)
+- `./docs/guides/README-websocket.md` (118 lines)
+- `./docs/guides/routing.md` (370 lines)
+- `./docs/guides/security.md` (585 lines)
+- `./docs/guides/validation.md` (539 lines)
+- `./docs/implementations/queue-job-anomaly-detection.md` (634 lines)
+- `./docs/job-dashboard.md` (733 lines)
+- `./docs/livecomponents/01-getting-started.md` (520 lines)
+- `./docs/livecomponents/advanced-features.md` (1027 lines)
+- `./docs/livecomponents/api-reference.md` (1331 lines)
+- `./docs/livecomponents/attributes-reference.md` (1380 lines)
+- `./docs/livecomponents/best-practices.md` (1014 lines)
+- `./docs/livecomponents/events-reference.md` (1354 lines)
+- `./docs/livecomponents/faq.md` (864 lines)
+- `./docs/livecomponents/LIVECOMPONENTS-COMPLETE-SUMMARY.md` (681 lines)
+- `./docs/livecomponents/performance-guide.md` (1003 lines)
+- `./docs/livecomponents/PHASE-5-COMPLETION.md` (597 lines)
+- `./docs/livecomponents/README.md` (257 lines)
+- `./docs/livecomponents/security-guide.md` (691 lines)
+- `./docs/livecomponents/troubleshooting.md` (978 lines)
+- `./docs/livecomponents-type-safety-refactoring.md` (400 lines)
+- `./docs/logging/best-practices.md` (837 lines)
+- `./docs/logging/docker-json-logging.md` (373 lines)
+- `./docs/logging/log-health-check-command.md` (162 lines)
+- `./docs/logging-module.md` (185 lines)
+- `./docs/Makefile.md` (66 lines)
+- `./docs/middleware-robustness.md` (130 lines)
+- `./docs/migration/ErrorHandling-to-ExceptionHandling-Strategy.md` (798 lines)
+- `./docs/ml-model-management-deployment.md` (807 lines)
+- `./docs/ml-model-management.md` (872 lines)
+- `./docs/next-steps.md` (67 lines)
+- `./docs/n-plus-one-detection.md` (749 lines)
+- `./docs/performance/filesystem-optimization-analysis.md` (284 lines)
+- `./docs/performance/filesystem-phase1-optimizations-implemented.md` (367 lines)
+- `./docs/performance/index-optimization.md` (559 lines)
+- `./docs/PERMISSIONS.md` (226 lines)
+- `./docs/plan.md` (252 lines)
+- `./docs/planning/ADMIN_AUTH_SECURITY_ENHANCEMENT.md` (140 lines)
+- `./docs/planning/CURRENT_SPRINT.md` (178 lines)
+- `./docs/planning/docs-implementation-plan.md` (163 lines)
+- `./docs/planning/docs-replacement-recommendation.md` (137 lines)
+- `./docs/planning/documentation-update-proposal.md` (138 lines)
+- `./docs/planning/ML-WAF-Behavioral-Analysis-Implementation-Summary.md` (565 lines)
+- `./docs/planning/N+1-Detection-ML-Implementation-Summary.md` (263 lines)
+- `./docs/planning/N+1-Detection-ML-Integration-Summary.md` (402 lines)
+- `./docs/planning/N+1-Detection-ML-Next-Steps.md` (1154 lines)
+- `./docs/planning/SECURITY_AUDIT_REPORT.md` (1059 lines)
+- `./docs/planning/TODO.md` (425 lines)
+- `./docs/PRESAVE-USAGE-GUIDE.md` (458 lines)
+- `./docs/quality/code-quality-scanner.md` (112 lines)
+- `./docs/queue-deployment.md` (631 lines)
+- `./docs/README.md` (68 lines)
+- `./docs/REDIS_ACL_EXPLANATION.md` (388 lines)
+- `./docs/REDIS_AUTHENTICATION_ANALYSIS.md` (364 lines)
+- `./docs/refactoring/mcp-module-refactoring-plan.md` (346 lines)
+- `./docs/refactoring/phase-1-completion-report.md` (213 lines)
+- `./docs/refactoring/phase-2-completion-report.md` (324 lines)
+- `./docs/roadmap/features.md` (83 lines)
+- `./docs/roadmap/milestones.md` (289 lines)
+- `./docs/roadmap/tasks.md` (138 lines)
+- `./docs/search-api-examples.md` (471 lines)
+- `./docs/search-external-mapping-examples.md` (255 lines)
+- `./docs/spa-router-backend-integration.md` (125 lines)
+- `./docs/sqlstate-integration-design.md` (777 lines)
+- `./docs/SSL_DEPLOYMENT.md` (371 lines)
+- `./docs/tasks.md` (153 lines)
+- `./docs/TEMPLATE-SYSTEM-ANALYSIS.md` (386 lines)
+- `./docs/todo/css-generation-system.md` (293 lines)
+- `./docs/todo/design-system-improvements.md` (263 lines)
+- `./docs/todo/design-token-system-future-features.md` (318 lines)
+- `./docs/todo/README.md` (68 lines)
+- `./docs/troubleshooting/AUTOLOADER_WORKAROUND.md` (67 lines)
+- `./docs/vault-system.md` (401 lines)
+- `./docs/whatsapp-notification-channel.md` (438 lines)
+
+### 2. Claude-Specific Documentation (/docs/claude/)
+
+- `./docs/claude/animationsystem.md` (585 lines)
+- `./docs/claude/architecture.md` (189 lines)
+- `./docs/claude/async-components.md` (26 lines)
+- `./docs/claude/chips-cookies.md` (465 lines)
+- `./docs/claude/common-workflows.md` (1259 lines)
+- `./docs/claude/configuration-best-practices.md` (297 lines)
+- `./docs/claude/console-commands.md` (30 lines)
+- `./docs/claude/curl-oop-api.md` (996 lines)
+- `./docs/claude/database-patterns.md` (1526 lines)
+- `./docs/claude/deployment-architecture.md` (777 lines)
+- `./docs/claude/development-commands.md` (157 lines)
+- `./docs/claude/error-handling.md` (644 lines)
+- `./docs/claude/event-system.md` (963 lines)
+- `./docs/claude/examples/migrations/SafeVsUnsafeMigrations.md` (420 lines)
+- `./docs/claude/exception-system-advanced-features.md` (754 lines)
+- `./docs/claude/filesystem-patterns.md` (965 lines)
+- `./docs/claude/framework-personas.md` (766 lines)
+- `./docs/claude/framework-refactoring-recommendations.md` (748 lines)
+- `./docs/claude/guidelines.md` (882 lines)
+- `./docs/claude/livecomponent-file-uploads.md` (893 lines)
+- `./docs/claude/livecomponent-formbuilder-usage.md` (458 lines)
+- `./docs/claude/livecomponent-lazy-loading.md` (681 lines)
+- `./docs/claude/livecomponent-lifecycle-hooks.md` (572 lines)
+- `./docs/claude/livecomponent-nested-components.md` (717 lines)
+- `./docs/claude/livecomponents-best-practices.md` (461 lines)
+- `./docs/claude/livecomponents-caching-system.md` (683 lines)
+- `./docs/claude/livecomponents-dom-badges.md` (236 lines)
+- `./docs/claude/livecomponent-security.md` (223 lines)
+- `./docs/claude/livecomponents-implementation-plan.md` (699 lines)
+- `./docs/claude/livecomponents-lazy-loading.md` (717 lines)
+- `./docs/claude/livecomponent-slot-system.md` (1127 lines)
+- `./docs/claude/livecomponents-monitoring-debugging.md` (701 lines)
+- `./docs/claude/livecomponents-observability.md` (540 lines)
+- `./docs/claude/livecomponents-performance-optimizations.md` (725 lines)
+- `./docs/claude/livecomponents-playground.md` (1108 lines)
+- `./docs/claude/livecomponents-roadmap.md` (1027 lines)
+- `./docs/claude/livecomponents-system.md` (552 lines)
+- `./docs/claude/livecomponents-test-harness.md` (504 lines)
+- `./docs/claude/magiclinks-system.md` (807 lines)
+- `./docs/claude/mcp-integration.md` (260 lines)
+- `./docs/claude/migration-system-quick-reference.md` (202 lines)
+- `./docs/claude/ml-framework-architecture.md` (593 lines)
+- `./docs/claude/naming-conventions.md` (832 lines)
+- `./docs/claude/performance-monitoring.md` (30 lines)
+- `./docs/claude/performance-profiling.md` (857 lines)
+- `./docs/claude/php85-framework-integration.md` (550 lines)
+- `./docs/claude/posix-system.md` (1316 lines)
+- `./docs/claude/postgresql-features.md` (1127 lines)
+- `./docs/claude/queue-system.md` (1135 lines)
+- `./docs/claude/route-authorization.md` (291 lines)
+- `./docs/claude/routing-value-objects.md` (305 lines)
+- `./docs/claude/scheduler-queue-pipeline.md` (458 lines)
+- `./docs/claude/scheduler-queue-pipeline-persona.md` (273 lines)
+- `./docs/claude/security-patterns.md` (1135 lines)
+- `./docs/claude/sockets-module.md` (671 lines)
+- `./docs/claude/sse-integration-guide.md` (978 lines)
+- `./docs/claude/sse-system.md` (1068 lines)
+- `./docs/claude/structured-logging.md` (577 lines)
+- `./docs/claude/troubleshooting.md` (1074 lines)
+- `./docs/claude/typed-string-system.md` (1141 lines)
+- `./docs/claude/view-caching-system.md` (716 lines)
+- `./docs/claude/view-refactoring-plan.md` (614 lines)
+- `./docs/claude/xcomponent-processor.md` (764 lines)
+- `./docs/claude/x-component-syntax.md` (335 lines)
+
+### 3. Root Directory Documentation
+
+- `./AGENTS.md` (432 lines)
+- `./CLAUDE.md` (292 lines)
+- `./CLEANUP_PLAN.md` (186 lines)
+- `./DEPLOYMENT_FIX.md` (22 lines)
+- `./ENV_SETUP.md` (266 lines)
+- `./LIVECOMPONENTS_TEST.md` (160 lines)
+- `./README.md` (322 lines)
+- `./SRC_STRUCTURE_IMPROVEMENTS.md` (368 lines)
+- `./todo.md` (585 lines)
+
+### 4. Source Code Documentation
+
+- `./src/Application/Controllers/Test/README.md` (188 lines)
+- `./src/Application/LiveComponents/UserRegistration/README.md` (213 lines)
+- `./src/Domain/Asset/README.md` (526 lines)
+- `./src/Domain/Cms/README.md` (193 lines)
+- `./src/Domain/Media/README.md` (92 lines)
+- `./src/Domain/Meta/README.md` (18 lines)
+- `./src/Domain/PreSave/README.md` (629 lines)
+- `./src/Framework/Admin/README.md` (691 lines)
+- `./src/Framework/Analytics/README.md` (342 lines)
+- `./src/Framework/AsyncExamples/README.md` (58 lines)
+- `./src/Framework/Cache/README.md` (338 lines)
+- `./src/Framework/CircuitBreaker/README.md` (210 lines)
+- `./src/Framework/Console/README.md` (131 lines)
+- `./src/Framework/Core/DOKUMENTATION.md` (45 lines)
+- `./src/Framework/Core/ImplementationLocator.md` (17 lines)
+- `./src/Framework/Core/ValueObjects/README.md` (334 lines)
+- `./src/Framework/Database/Example/README.md` (69 lines)
+- `./src/Framework/Database/README.md` (21 lines)
+- `./src/Framework/Database/TODO.md` (92 lines)
+- `./src/Framework/DDoS/README.md` (133 lines)
+- `./src/Framework/DDoS/REFACTORING-SUMMARY.md` (130 lines)
+- `./src/Framework/Debug/readme.md` (104 lines)
+- `./src/Framework/DI/DOKUMENTATION.md` (90 lines)
+- `./src/Framework/Discovery/README.md` (184 lines)
+- `./src/Framework/Display/README.md` (583 lines)
+- `./src/Framework/ErrorBoundaries/Async/README.md` (265 lines)
+- `./src/Framework/ErrorBoundaries/Middleware/README.md` (222 lines)
+- `./src/Framework/EventSourcing/Projections/README.md` (394 lines)
+- `./src/Framework/EventSourcing/Replay/README.md` (1035 lines)
+- `./src/Framework/EventSourcing/Sagas/README.md` (863 lines)
+- `./src/Framework/EventSourcing/Snapshots/README.md` (703 lines)
+- `./src/Framework/Exception/InErrorHandler.md` (22 lines)
+- `./src/Framework/Filesystem/README.md` (68 lines)
+- `./src/Framework/Http/DOKUMENTATION.md` (92 lines)
+- `./src/Framework/Http/Middlewares/REFACTORING-SUMMARY.md` (144 lines)
+- `./src/Framework/Http/Url.php85/README.md` (373 lines)
+- `./src/Framework/Http/Url/README.md` (373 lines)
+- `./src/Framework/LiveComponents/Cache/README.md` (352 lines)
+- `./src/Framework/LiveComponents/docs/API-REFERENCE.md` (1369 lines)
+- `./src/Framework/LiveComponents/docs/COMPONENT-CREATION-GUIDE.md` (1114 lines)
+- `./src/Framework/LiveComponents/docs/DEVTOOLS-DEBUGGING-GUIDE.md` (1163 lines)
+- `./src/Framework/LiveComponents/docs/PERFORMANCE-GUIDE.md` (1023 lines)
+- `./src/Framework/LiveComponents/docs/SECURITY-GUIDE.md` (1073 lines)
+- `./src/Framework/LiveComponents/docs/UPLOAD-GUIDE.md` (953 lines)
+- `./src/Framework/LiveComponents/ERROR-RECOVERY.md` (615 lines)
+- `./src/Framework/LiveComponents/MEMORY-MANAGEMENT.md` (264 lines)
+- `./src/Framework/LiveComponents/README.md` (75 lines)
+- `./src/Framework/LiveComponents/TODO.md` (1216 lines)
+- `./src/Framework/Mcp/README.md` (224 lines)
+- `./src/Framework/Mcp/Tools/Categories/Analysis/README.md` (19 lines)
+- `./src/Framework/Mcp/Tools/Categories/Database/README.md` (37 lines)
+- `./src/Framework/Mcp/Tools/Categories/Development/README.md` (30 lines)
+- `./src/Framework/Mcp/Tools/Categories/Performance/README.md` (36 lines)
+- `./src/Framework/Mcp/Tools/Categories/README.md` (70 lines)
+- `./src/Framework/Mcp/Tools/Categories/Security/README.md` (51 lines)
+- `./src/Framework/Mcp/Tools/Categories/System/README.md` (51 lines)
+- `./src/Framework/Notification/Channels/Telegram/Webhook/README.md` (198 lines)
+- `./src/Framework/Notification/Media/README.md` (497 lines)
+- `./src/Framework/Notification/README.md` (440 lines)
+- `./src/Framework/Notification/Templates/README.md` (524 lines)
+- `./src/Framework/OAuth/README.md` (539 lines)
+- `./src/Framework/Performance/ARCHITECTURE.md` (234 lines)
+- `./src/Framework/Performance/README.md` (369 lines)
+- `./src/Framework/Quality/PHPStan/Rules/Naming/README.md` (238 lines)
+- `./src/Framework/RateLimit/MIGRATION.md` (337 lines)
+- `./src/Framework/ReflectionLegacy/EVALUATION.md` (191 lines)
+- `./src/Framework/ReflectionLegacy/README.md` (166 lines)
+- `./src/Framework/ReflectionLegacy/SUMMARY.md` (85 lines)
+- `./src/Framework/Reflection/README.md` (203 lines)
+- `./src/Framework/Retry/README.md` (287 lines)
+- `./src/Framework/Serializer/README.md` (344 lines)
+- `./src/Framework/Storage/STREAMING_IMPLEMENTATION_PLAN.md` (155 lines)
+- `./src/Framework/Telemetry/README.md` (192 lines)
+- `./src/Framework/View/Processors/docs/AssetInjector.md` (62 lines)
+- `./src/Framework/View/Processors/docs/CommentStripProcessor.md` (54 lines)
+- `./src/Framework/View/Processors/docs/ComponentProcessor.md` (55 lines)
+- `./src/Framework/View/Processors/docs/DateFormatProcessor.md` (65 lines)
+- `./src/Framework/View/Processors/docs/EscapeProcessor.md` (55 lines)
+- `./src/Framework/View/Processors/docs/ForProcessor.md` (61 lines)
+- `./src/Framework/View/Processors/docs/IfProcessor.md` (50 lines)
+- `./src/Framework/View/Processors/docs/IncludeProcessor.md` (48 lines)
+- `./src/Framework/View/Processors/docs/LayoutTagProcessor.md` (59 lines)
+- `./src/Framework/View/Processors/docs/MetaManipulator.md` (53 lines)
+- `./src/Framework/View/Processors/docs/PlaceholderReplacer.md` (36 lines)
+- `./src/Framework/View/Processors/docs/README.md` (110 lines)
+- `./src/Framework/View/Processors/docs/RemoveEmptyLinesProcessor.md` (65 lines)
+- `./src/Framework/View/Processors/docs/SingleLineHtmlProcessor.md` (63 lines)
+- `./src/Framework/View/Processors/docs/SlotProcessor.md` (58 lines)
+- `./src/Framework/View/Processors/docs/SwitchCaseProcessor.md` (63 lines)
+- `./src/Framework/View/Processors/docs/VoidElementsSelfClosingProcessor.md` (80 lines)
+- `./src/Framework/WebPush/USAGE.md` (436 lines)
+- `./src/Infrastructure/Api/Gitea/README.md` (501 lines)
+- `./src/Infrastructure/Api/Netcup/README.md` (387 lines)
+- `./src/Infrastructure/Api/RapidMail/README.md` (252 lines)
+- `./src/Infrastructure/Api/README.md` (133 lines)
+
+### 5. Deployment Documentation
+
+- `./deployment/ansible/playbooks/README-WIREGUARD.md` (419 lines)
+- `./deployment/ansible/README.md` (378 lines)
+- `./deployment/docs/guides/code-change-workflow.md` (551 lines)
+- `./deployment/docs/guides/deployment-commands.md` (172 lines)
+- `./deployment/docs/guides/quick-start.md` (192 lines)
+- `./deployment/docs/guides/setup-guide.md` (793 lines)
+- `./deployment/docs/guides/vault-password.md` (262 lines)
+- `./deployment/docs/history/cleanup-log.md` (125 lines)
+- `./deployment/docs/history/cleanup-summary.md` (176 lines)
+- `./deployment/docs/README.md` (204 lines)
+- `./deployment/docs/reference/application-stack.md` (577 lines)
+- `./deployment/docs/reference/workflow-troubleshooting.md` (186 lines)
+- `./deployment/docs/RESTRUCTURE_PROPOSAL.md` (223 lines)
+- `./deployment/docs/status/ci-cd-status.md` (272 lines)
+- `./deployment/docs/status/deployment-summary.md` (188 lines)
+- `./deployment/docs/status/deployment-todo.md` (291 lines)
+- `./deployment/docs/status/improvements.md` (260 lines)
+- `./deployment/docs/status/next-steps.md` (48 lines)
+- `./deployment/docs/tests/git-deployment-issue.md` (73 lines)
+- `./deployment/docs/tests/git-deployment-test.md` (239 lines)
+- `./deployment/docs/tests/quick-test.md` (45 lines)
+- `./deployment/docs/tests/recommended-test-flow.md` (144 lines)
+- `./deployment/docs/tests/test-git-deployment.md` (277 lines)
+- `./deployment/docs/tests/test-results.md` (72 lines)
+- `./deployment/docs/troubleshooting/staging-502-nginx-phpfpm.md` (200 lines)
+- `./deployment/gitea-runner/ADD_PHP_CI_LABEL.md` (110 lines)
+- `./deployment/gitea-runner/README.md` (724 lines)
+- `./deployment/README.md` (303 lines)
+- `./deployment/stacks/application/README.md` (918 lines)
+- `./deployment/stacks/gitea/README.md` (467 lines)
+- `./deployment/stacks/minio/README.md` (657 lines)
+- `./deployment/stacks/monitoring/README.md` (751 lines)
+- `./deployment/stacks/postgresql/README.md` (681 lines)
+- `./deployment/stacks/redis/README.md` (291 lines)
+- `./deployment/stacks/registry/README.md` (636 lines)
+- `./deployment/stacks/semaphore/QUICKSTART.md` (201 lines)
+- `./deployment/stacks/semaphore/README.md` (576 lines)
+- `./deployment/stacks/semaphore/SETUP_REPOSITORY.md` (355 lines)
+- `./deployment/stacks/staging/README.md` (171 lines)
+- `./deployment/stacks/traefik/README.md` (442 lines)
+- `./deployment/wireguard/CLIENT-IMPORT-GUIDE.md` (370 lines)
+- `./deployment/wireguard/configs/README.md` (47 lines)
+- `./deployment/wireguard/INDEX.md` (259 lines)
+- `./deployment/wireguard/INSTALLATION-LOG.md` (275 lines)
+- `./deployment/wireguard/QUICKSTART.md` (194 lines)
+- `./deployment/wireguard/README.md` (352 lines)
+
+---
+
+## Recommendations
+
+### Phase 1: Immediate Actions (Week 1)
+
+1. **Archive Outdated Files** (~30-40 files)
+   - Backups directory: `./backups/docs-backup-20250731125004/` (15 files)
+   - Old WireGuard docs: `./deployment/wireguard/` (5 files)
+   - Obsolete planning docs in `./docs/planning/`
+
+2. **Create Master Index**
+   - New file: `/docs/README.md`
+   - Comprehensive navigation structure
+   - Links to all major documentation sections
+
+3. **Consolidate LiveComponents**
+   - Current: 13 files in `/docs/livecomponents/`
+   - Target: Merge into 5-6 well-organized files
+   - Remove duplicates
+
+### Phase 2: Reorganization (Week 2-3)
+
+#### Proposed New Structure
+
+```
+/docs/
+├── README.md                           # Master index & navigation
+├── getting-started/
+│   ├── installation.md
+│   ├── quick-start.md
+│   └── first-feature.md
+├── architecture/
+│   ├── overview.md
+│   ├── design-patterns.md
+│   ├── core-principles.md
+│   └── directory-structure.md
+├── features/
+│   ├── database/
+│   │   ├── README.md
+│   │   ├── migrations.md
+│   │   ├── entity-manager.md
+│   │   └── repositories.md
+│   ├── queue-system/
+│   │   ├── README.md
+│   │   ├── basics.md
+│   │   ├── jobs.md
+│   │   └── workers.md
+│   ├── events/
+│   ├── security/
+│   ├── livecomponents/
+│   └── ...
+├── guides/
+│   ├── building-features.md
+│   ├── testing-strategies.md
+│   ├── performance-optimization.md
+│   └── deployment-guide.md
+├── api-reference/
+│   └── (auto-generated from source code)
+├── contributing/
+│   ├── code-style.md
+│   ├── pull-requests.md
+│   └── testing.md
+└── deployment/
+    ├── docker.md
+    ├── production.md
+    └── monitoring.md
+
+/docs/claude/                           # AI-specific only
+├── CLAUDE.md                           # Main AI context
+├── mcp-integration.md                  # MCP server usage
+├── framework-personas.md               # AI personas
+└── examples/                           # Code generation examples
+```
+
+### Phase 3: Content Migration
+
+**Files to Move from /docs/claude/ to /docs/:**
+- architecture.md → /docs/architecture/overview.md
+- database-patterns.md → /docs/features/database/
+- queue-system.md → /docs/features/queue-system/
+- event-system.md → /docs/features/events/
+- security-patterns.md → /docs/features/security/
+- error-handling.md → /docs/features/error-handling/
+- common-workflows.md → /docs/guides/building-features.md
+- troubleshooting.md → /docs/guides/troubleshooting.md
+
+**Files to Keep in /docs/claude/:**
+- CLAUDE.md (AI context)
+- mcp-integration.md (MCP server specific)
+- framework-personas.md (AI personas)
+- development-commands.md (Claude Code commands)
+
+### Phase 4: Maintenance & Quality
+
+1. **Standardize Format**
+   - Apply documentation template to all files
+   - Consistent heading structure
+   - Code example formatting
+   - Cross-reference links
+
+2. **Add Navigation**
+   - Breadcrumb navigation in each file
+   - "See Also" sections
+   - Previous/Next links where applicable
+
+3. **Update Cross-References**
+   - Fix all internal links after migration
+   - Update CLAUDE.md references
+   - Verify no broken links
+
+4. **Documentation Governance**
+   - Create CONTRIBUTING_DOCS.md
+   - Define archival policy
+   - Establish review process
+
+---
+
+## File Statistics Summary
+
+### By Size Category
+- **Large (1000+ lines):** ~15 files
+  - database-patterns.md (38K lines)
+  - typed-string-system.md (30K lines)
+  - posix-system.md (25K lines)
+  
+- **Medium (500-1000 lines):** ~25 files
+  - event-system.md, queue-system.md, guidelines.md
+  
+- **Small (100-500 lines):** ~60 files
+  - Most feature documentation
+  
+- **Stubs (<100 lines):** ~15 files
+  - async-components.md (520 bytes)
+  - console-commands.md (612 bytes)
+  - performance-monitoring.md (594 bytes)
+
+### Duplicates Identified
+1. **livecomponent-lazy-loading.md** vs **livecomponents-lazy-loading.md** (681 vs 717 lines)
+2. Multiple backup copies in `/backups/docs-backup-20250731125004/`
+
+### Obsolete Files (Candidates for Archival)
+1. All files in `/backups/` directory (15 files)
+2. Old WireGuard documentation (5 files) - VPN removed from architecture
+3. Outdated planning documents (11 files in `/docs/planning/`)
+4. Old component docs (migration completed)
+
+**Total to Archive:** ~40-50 files
+**Reduction:** From 513 to ~470 active files (-8.4%)
+
+---
+
+## Next Steps
+
+### Immediate (This Week)
+1. Review this analysis
+2. Approve proposed structure
+3. Create `/docs/README.md` master index
+4. Archive obsolete files
+
+### Short-term (Next 2 Weeks)
+1. Create new directory structure
+2. Begin file migration (prioritize high-traffic docs)
+3. Update cross-references
+4. Standardize formatting
+
+### Ongoing
+1. Complete all migrations
+2. Add missing documentation for 46 undocumented modules
+3. Establish documentation maintenance process
+4. Regular quarterly reviews
+
+---
+
+## Contact & Support
+
+For questions about this analysis or documentation reorganization:
+- Review full analysis at: `/tmp/markdown-analysis.md`
+- Documentation issues: Use GitHub Issues
+- Framework questions: See /docs/claude/CLAUDE.md
+
+**Generated:** 2025-01-28
+**Total Analysis Time:** ~5 minutes
+**Files Analyzed:** 513 markdown files
diff --git a/docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md b/docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md
new file mode 100644
index 00000000..a42debee
--- /dev/null
+++ b/docs/ERROR-RENDERER-IMPROVEMENTS-PLAN.md
@@ -0,0 +1,274 @@
+# ErrorRenderer Verbesserungen - Template Syntax, Reflection, Optimierungen
+
+## Problem-Analyse
+
+### 1. Template-Syntax Inkonsistenz
+**Aktuell**: Templates verwenden `{variable}` Syntax
+**Erwartet**: Template-System verwendet PHP-Syntax `{{ $variable }}` (mit Dollar-Sign)
+**Betroffen**: Alle Error-Templates (`error.view.php`, `404.view.php`, `500.view.php`)
+
+### 2. Reflection in ErrorKernel
+**Problem**: `createHttpResponse()` verwendet Reflection, um auf private `engine` Property zuzugreifen
+**Location**: `src/Framework/ExceptionHandling/ErrorKernel.php:160-163`
+**Lösung**: Factory-Methode für Renderer mit geändertem Debug-Mode hinzufügen
+
+### 3. ConsoleOutput unnötig für HTTP-Context
+**Problem**: ConsoleOutput wird für alle Kontexte erstellt, auch wenn nicht benötigt
+**Location**: `src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php:37-39`
+**Lösung**: Lazy creation nur bei CLI-Context
+
+### 4. If-Syntax nicht kompatibel
+**Aktuell**: Templates verwenden `{if variable}` und `{/if}` Syntax
+**Erwartet**: HTML-Attribut-Syntax `<div if="$variable">` (mit Dollar-Sign für PHP-Syntax)
+**Betroffen**: Alle Error-Templates mit bedingten Blöcken
+
+### 5. Fehlerbehandlung bei Template-Rendering
+**Problem**: Fallback-Handling könnte robuster sein
+**Location**: `src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php:143-169`
+
+## Lösungsvorschlag
+
+### Phase 1: Template-Syntax korrigieren (PHP-Syntax)
+
+#### 1.1 Variable-Syntax korrigieren (PHP-Syntax mit Dollar)
+**Änderungen** (alle mit Dollar-Sign):
+- `{title}` → `{{ $title }}`
+- `{message}` → `{{ $message }}`
+- `{exceptionClass}` → `{{ $exceptionClass }}`
+- `{debug.file}` → `{{ $debug['file'] }}` oder `{{ $data['debug']['file'] }}`
+- `{debug.line}` → `{{ $debug['line'] }}` oder `{{ $data['debug']['line'] }}`
+- `{debug.trace}` → `{{ $debug['trace'] }}` oder `{{ $data['debug']['trace'] }}`
+- `{context.operation}` → `{{ $context['operation'] }}` oder `{{ $data['context']['operation'] }}`
+- `{context.component}` → `{{ $context['component'] }}` oder `{{ $data['context']['component'] }}`
+- `{context.request_id}` → `{{ $context['request_id'] }}` oder `{{ $data['context']['request_id'] }}`
+- `{context.occurred_at}` → `{{ $context['occurred_at'] }}` oder `{{ $data['context']['occurred_at'] }}`
+
+**Hinweis**: Da `$data` im RenderContext als Array übergeben wird, sollte Array-Syntax verwendet werden:
+- `{{ $data['title'] }}`
+- `{{ $data['debug']['file'] }}`
+- `{{ $data['context']['operation'] }}`
+
+**Dateien**:
+- `resources/views/errors/error.view.php`
+- `resources/views/errors/404.view.php`
+- `resources/views/errors/500.view.php`
+
+#### 1.2 If-Syntax auf HTML-Attribute umstellen (mit Dollar-Syntax)
+**Änderungen**:
+- `{if isDebugMode}...{/if}` → `<div if="$isDebugMode">...</div>` oder `<style if="$isDebugMode">...</style>`
+- `{if debug}...{/if}` → `<div if="$debug">...</div>`
+- `{if context}...{/if}` → `<div if="$context">...</div>`
+- `{if debug.trace}...{/if}` → `<div if="$debug['trace']">...</div>`
+
+**Beispiel Transformation**:
+```html
+<!-- Alt -->
+{if isDebugMode}
+<div class="debug-info">{{message}}</div>
+{/if}
+
+<!-- Neu -->
+<div class="debug-info" if="$isDebugMode">{{ $message }}</div>
+```
+
+**Hinweis**: If-Bedingungen verwenden auch Dollar-Syntax für Variablen: `if="$isDebugMode"`
+
+**Dateien**:
+- `resources/views/errors/error.view.php`
+- `resources/views/errors/500.view.php`
+
+### Phase 2: Reflection entfernen
+
+#### 2.1 ErrorRendererFactory erweitern
+**Neue Methode hinzufügen**:
+```php
+public function createHttpRenderer(?bool $debugMode = null): ResponseErrorRenderer
+{
+    $debugMode = $debugMode ?? $this->isDebugMode;
+    return new ResponseErrorRenderer($this->engine, $debugMode);
+}
+```
+
+**Datei**: `src/Framework/ExceptionHandling/ErrorRendererFactory.php`
+
+#### 2.2 ErrorKernel anpassen
+**Reflection-Code ersetzen**:
+```php
+// Alt (Reflection)
+$reflection = new \ReflectionClass($this->rendererFactory);
+$engineProperty = $reflection->getProperty('engine');
+$engineProperty->setAccessible(true);
+$engine = $engineProperty->getValue($this->rendererFactory);
+$renderer = new ResponseErrorRenderer($engine, $debugMode);
+
+// Neu (Factory-Methode)
+if ($renderer instanceof ResponseErrorRenderer && $debugMode !== $this->isDebugMode) {
+    $renderer = $this->rendererFactory->createHttpRenderer($debugMode);
+}
+```
+
+**Datei**: `src/Framework/ExceptionHandling/ErrorKernel.php`
+
+### Phase 3: ConsoleOutput optimieren
+
+#### 3.1 ExceptionHandlingInitializer anpassen
+**Lazy Creation für ConsoleOutput**:
+```php
+// Alt: Immer erstellen
+$consoleOutput = $container->has(ConsoleOutput::class)
+    ? $container->get(ConsoleOutput::class)
+    : new ConsoleOutput();
+
+// Neu: Nur bei CLI-Context erstellen
+$consoleOutput = $executionContext->isCli()
+    ? ($container->has(ConsoleOutput::class) ? $container->get(ConsoleOutput::class) : new ConsoleOutput())
+    : null;
+```
+
+**Anpassung in ErrorRendererFactory-Binding**:
+- Factory sollte ConsoleOutput nur bei CLI-Context benötigen
+- Für HTTP-Context kann `null` übergeben werden (wird nicht verwendet)
+
+**Datei**: `src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php`
+
+### Phase 4: Fehlerbehandlung verbessern
+
+#### 4.1 Template-Rendering Error Handling
+**Verbesserungen**:
+- Logging bei Template-Fehlern hinzufügen
+- Spezifischere Fehlermeldungen
+- Fallback sollte alle notwendigen Daten enthalten
+
+**Datei**: `src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php`
+
+#### 4.2 Fallback HTML verbessern
+**Sicherstellen, dass Fallback**:
+- Alle Template-Variablen korrekt ersetzt
+- HTML-Encoding korrekt anwendet
+- Debug-Informationen nur bei Debug-Mode zeigt
+
+**Datei**: `src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php`
+
+## Implementierungs-Plan
+
+### Schritt 1: Template-Syntax korrigieren (PHP-Syntax)
+1. **error.view.php** anpassen
+   - Variable-Syntax: `{variable}` → `{{ $variable }}` (PHP-Syntax mit Dollar)
+   - Array-Zugriff: `{debug.file}` → `{{ $debug['file'] }}` oder `{{ $data['debug']['file'] }}`
+   - If-Syntax: `{if}...{/if}` → HTML-Attribute `if="$variable"` (mit Dollar)
+   - Style-Tags: Conditional Styles mit `if="$isDebugMode"` Attribut
+
+2. **404.view.php** anpassen
+   - Variable-Syntax korrigieren (falls vorhanden)
+   - PHP-Syntax: `{{ $variable }}`
+
+3. **500.view.php** anpassen
+   - Variable-Syntax: `{variable}` → `{{ $variable }}` (PHP-Syntax mit Dollar)
+   - Array-Zugriff für verschachtelte Daten
+   - If-Syntax: `{if}...{/if}` → HTML-Attribute `if="$variable"` (mit Dollar)
+
+### Schritt 2: ErrorRendererFactory erweitern
+4. **createHttpRenderer() Methode hinzufügen**
+   - Parameter: `?bool $debugMode = null`
+   - Return: `ResponseErrorRenderer`
+   - Verwendet interne `engine` und `isDebugMode`
+
+### Schritt 3: Reflection entfernen
+5. **ErrorKernel::createHttpResponse() refactoren**
+   - Reflection-Code entfernen
+   - Factory-Methode `createHttpRenderer()` verwenden
+   - Type-Checking beibehalten
+
+### Schritt 4: ConsoleOutput optimieren
+6. **ExceptionHandlingInitializer anpassen**
+   - ConsoleOutput nur bei CLI-Context erstellen
+   - ErrorRendererFactory-Binding anpassen (null für HTTP-Context)
+
+7. **ConsoleErrorRenderer anpassen** (falls nötig)
+   - Null-Check für ConsoleOutput hinzufügen
+
+### Schritt 5: Fehlerbehandlung verbessern
+8. **ResponseErrorRenderer::renderWithTemplate() verbessern**
+   - Logging bei Template-Fehlern
+   - Spezifischere Exception-Typen
+   - Bessere Fehlermeldungen
+
+9. **Fallback HTML verbessern**
+   - HTML-Encoding für alle Variablen
+   - Debug-Informationen nur bei Debug-Mode
+   - Konsistente Formatierung
+
+### Schritt 6: Testing & Validierung
+10. **Template-Syntax testen**
+    - Alle Templates kompilieren lassen
+    - Variable-Substitution mit PHP-Syntax testen (`{{ $variable }}`)
+    - Array-Zugriff testen (`{{ $data['key'] }}`)
+    - Verschachtelte Array-Zugriffe testen (`{{ $data['debug']['file'] }}`)
+    - If-Bedingungen mit Dollar-Syntax testen (`if="$variable"`)
+
+11. **Reflection-Entfernung testen**
+    - createHttpResponse() mit verschiedenen Debug-Modes testen
+    - Sicherstellen, dass keine Reflection mehr verwendet wird
+
+12. **ConsoleOutput Optimierung testen**
+    - CLI-Context: ConsoleOutput verfügbar
+    - HTTP-Context: ConsoleOutput nicht erstellt
+
+## Dateien zu ändern
+
+### Templates:
+- `resources/views/errors/error.view.php` - Variable & If-Syntax (PHP-Syntax)
+- `resources/views/errors/404.view.php` - Variable-Syntax (PHP-Syntax, falls vorhanden)
+- `resources/views/errors/500.view.php` - Variable & If-Syntax (PHP-Syntax)
+
+### PHP-Klassen:
+- `src/Framework/ExceptionHandling/ErrorRendererFactory.php` - createHttpRenderer() Methode
+- `src/Framework/ExceptionHandling/ErrorKernel.php` - Reflection entfernen
+- `src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php` - ConsoleOutput optimieren
+- `src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php` - Fehlerbehandlung verbessern
+
+## Wichtige Hinweise zur Template-Syntax
+
+**Variable-Syntax (PHP-Stil)**:
+- Einfache Variablen: `{{ $title }}`
+- Array-Zugriff: `{{ $data['title'] }}`
+- Verschachtelte Arrays: `{{ $data['debug']['file'] }}`
+- Object-Zugriff (falls Objekte): `{{ $object->property }}`
+
+**If-Bedingungen**:
+- Einfache Bedingung: `if="$isDebugMode"`
+- Negation: `if="!$isDebugMode"`
+- Array-Zugriff: `if="$debug"`
+- Verschachtelt: `if="$data['debug']"`
+
+**Template-Daten-Struktur**:
+Die Daten werden im `RenderContext` als `data` Array übergeben, daher:
+- `$title` entspricht `$data['title']` im Template
+- `$debug['file']` entspricht `$data['debug']['file']` im Template
+
+## Vorteile
+
+✅ **Konsistente Template-Syntax**: Verwendet PHP-Stil `{{ $variable }}`
+✅ **Keine Reflection**: Sauberer Code, bessere Performance
+✅ **Optimierte Ressourcennutzung**: ConsoleOutput nur bei Bedarf
+✅ **HTML-Attribut-Syntax**: Kompatibel mit Framework Template-System
+✅ **Robustere Fehlerbehandlung**: Besseres Logging und Fallbacks
+
+## Risiken & Nebenwirkungen
+
+⚠️ **Template-Syntax-Änderung**: Alle Error-Templates müssen angepasst werden
+⚠️ **If-Syntax-Änderung**: Bedingte Blöcke müssen auf HTML-Attribute umgestellt werden
+⚠️ **ConsoleOutput**: Null-Checks müssen bei Verwendung hinzugefügt werden
+
+## Validierung
+
+Nach Implementierung:
+- [ ] Alle Templates kompilieren ohne Fehler
+- [ ] Variable-Substitution mit PHP-Syntax funktioniert (`{{ $variable }}`)
+- [ ] Array-Zugriff funktioniert (`{{ $data['key'] }}`)
+- [ ] Verschachtelte Array-Zugriffe funktionieren (`{{ $data['debug']['file'] }}`)
+- [ ] If-Bedingungen funktionieren mit HTML-Attributen und Dollar-Syntax (`if="$variable"`)
+- [ ] Keine Reflection mehr in ErrorKernel
+- [ ] ConsoleOutput nur bei CLI-Context erstellt
+- [ ] Fallback HTML funktioniert korrekt
+
diff --git a/docs/ERROR-RENDERER-REFACTORING-PLAN.md b/docs/ERROR-RENDERER-REFACTORING-PLAN.md
new file mode 100644
index 00000000..905b566f
--- /dev/null
+++ b/docs/ERROR-RENDERER-REFACTORING-PLAN.md
@@ -0,0 +1,199 @@
+# ErrorRenderer Refactoring - Unified Interface & Template Integration
+
+## Problem-Analyse
+
+### Aktuelle Probleme
+
+1. **Interface-Hierarchie ist nicht optimal**:
+   - `ErrorRenderer` (base) → `HttpErrorRenderer` extends → `CliErrorRenderer` extends
+   - Verschiedene Interfaces mit unterschiedlichen Methoden
+   - Factory muss spezifische Interfaces prüfen (`HttpErrorRenderer`, `CliErrorRenderer`)
+
+2. **HTTP Renderer verwendet kein Template System**:
+   - Hardcoded HTML-Strings in `ResponseErrorRenderer`
+   - Sollte `Engine` und `RenderContext` aus Template-System verwenden
+   - Template-basierte Error-Pages wären besser wartbar
+
+3. **HttpEmitter Kontext**:
+   - **Klarstellung**: HTML-Rendering sollte nur im Middleware-Kontext passieren
+   - Renderer erstellt nur `HttpResponse`, Emitter bleibt in Application/Middleware
+   - Außerhalb Middleware (z.B. Bootstrap): Fallback auf einfaches HTML
+
+## Lösungsvorschlag
+
+### 1. Unified ErrorRenderer Interface (OHNE Hierarchie)
+
+**Neue Struktur**:
+```php
+interface ErrorRenderer
+{
+    /**
+     * Check if this renderer can handle the exception
+     */
+    public function canRender(\Throwable $exception): bool;
+    
+    /**
+     * Render exception to appropriate output format
+     * 
+     * @return mixed HttpResponse for HTTP context, void for CLI context
+     */
+    public function render(
+        \Throwable $exception,
+        ?ExceptionContextProvider $contextProvider = null
+    ): mixed;
+}
+```
+
+**Alle Renderer implementieren das gleiche Interface**:
+- `ResponseErrorRenderer` → `HttpResponse` zurückgeben
+- `ConsoleErrorRenderer` → `void` (gibt direkt auf Console aus)
+
+### 2. HTTP Renderer mit Template System
+
+**ResponseErrorRenderer sollte**:
+- Template System (`Engine`, `RenderContext`) für HTML-Rendering verwenden
+- Error-Templates mit `.view.php` Endung (auto-discovered)
+- JSON-Responses direkt erstellen (bleibt gleich)
+- Template-Namen: `errors/error`, `errors/404`, `errors/500`
+
+**Template-Struktur** (mit `.view.php` Endung):
+```
+resources/views/errors/
+├── error.view.php           # Basis Error-Template
+├── 404.view.php            # 404-spezifisches Template
+├── 500.view.php            # 500-spezifisches Template
+└── debug.view.php          # Debug-Informationen (nur wenn debug=true)
+```
+
+**Wichtig**: Templates werden auto-discovered über Discovery-System
+
+### 3. HttpEmitter & Rendering-Kontext
+
+**Architektur**:
+```
+Exception im Middleware-Stack
+  → ExceptionHandlingMiddleware fängt Exception
+  → ErrorKernel->createHttpResponse()
+  → ResponseErrorRenderer.render() (Template-System für HTML)
+  → HttpResponse zurückgegeben
+  → ResponseEmitter emittet Response (in Application)
+
+Exception außerhalb Middleware (z.B. Bootstrap)
+  → GlobalExceptionHandler->handle()
+  → ErrorKernel->handle() (nur Logging, kein Response)
+  → Oder: Fallback HTML direkt (ohne Template-System)
+```
+
+**Prinzip**:
+- Renderer erstellt nur `HttpResponse` - kein direkter HttpEmitter-Aufruf
+- HTML-Rendering mit Templates nur im Middleware-Kontext
+- Außerhalb Middleware: Fallback auf einfache HTML-Strings
+
+### 4. Entfernung der Interface-Hierarchie
+
+**Zu entfernen**:
+- `HttpErrorRenderer` Interface
+- `CliErrorRenderer` Interface
+
+**Zu behalten/ändern**:
+- `ErrorRenderer` Interface (einheitlich)
+- `ResponseErrorRenderer` → implementiert `ErrorRenderer`
+- `ConsoleErrorRenderer` → implementiert `ErrorRenderer`
+
+### 5. Factory-Anpassung
+
+**ErrorRendererFactory**:
+- Nutzt nur noch `ErrorRenderer` Interface
+- Keine spezifischen Interface-Prüfungen mehr nötig
+- Einfacher und konsistenter
+
+## Implementierungs-Plan
+
+### Phase 1: Interface-Vereinheitlichung
+
+1. **ErrorRenderer Interface refactoren**
+   - `render()` Methode mit `mixed` Return-Type
+   - `canRender()` bleibt gleich
+
+2. **ResponseErrorRenderer anpassen**
+   - Implementiert nur noch `ErrorRenderer`
+   - `render()` gibt `HttpResponse` zurück
+   - `createResponse()` entfernen (wird zu `render()`)
+
+3. **ConsoleErrorRenderer anpassen**
+   - Implementiert nur noch `ErrorRenderer`
+   - `render()` gibt `void` zurück
+   - `renderToConsole()` entfernen (wird zu `render()`)
+
+4. **HttpErrorRenderer & CliErrorRenderer Interfaces löschen**
+
+### Phase 2: Template System Integration
+
+5. **Error Templates erstellen** (mit `.view.php` Endung)
+   - `resources/views/errors/error.view.php` - Basis Error-Template
+   - `resources/views/errors/404.view.php` - 404 Template
+   - `resources/views/errors/500.view.php` - 500 Template
+   - `resources/views/errors/debug.view.php` - Debug Template (optional)
+
+6. **ResponseErrorRenderer mit Template System**
+   - `Engine` über DI injizieren
+   - `RenderContext` für Template-Rendering erstellen
+   - HTML-Rendering über Templates (auto-discovered)
+   - JSON-Responses bleiben direkt (kein Template nötig)
+   - Fallback auf einfaches HTML wenn Template nicht gefunden
+
+7. **Template-Discovery Integration**
+   - Templates werden automatisch über Discovery-System gefunden
+   - Template-Namen: `errors/error`, `errors/404`, etc.
+   - Template-Loader findet Templates automatisch
+
+### Phase 3: Factory & Integration
+
+8. **ErrorRendererFactory vereinfachen**
+   - Nur noch `ErrorRenderer` Interface verwenden
+   - Spezifische Methoden (`getHttpRenderer()`, `getCliRenderer()`) entfernen
+
+9. **ErrorKernel anpassen**
+   - Nutzt einheitliches `ErrorRenderer` Interface
+   - `createHttpResponse()` verwendet `render()` Methode
+
+10. **Tests aktualisieren**
+    - Alle Renderer-Tests anpassen
+    - Template-System-Tests hinzufügen
+
+## Dateien zu ändern
+
+### Zu ändern:
+- `src/Framework/ExceptionHandling/ErrorRenderer.php` - Interface vereinheitlichen
+- `src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php` - Template System integrieren
+- `src/Framework/ExceptionHandling/Renderers/ConsoleErrorRenderer.php` - Interface anpassen
+- `src/Framework/ExceptionHandling/ErrorRendererFactory.php` - Vereinfachen
+- `src/Framework/ExceptionHandling/ErrorKernel.php` - Renderer-Aufruf anpassen
+
+### Zu löschen:
+- `src/Framework/ExceptionHandling/HttpErrorRenderer.php` - Interface entfernen
+- `src/Framework/ExceptionHandling/CliErrorRenderer.php` - Interface entfernen
+
+### Neu zu erstellen:
+- `resources/views/errors/error.view.php` - Basis Error-Template (auto-discovered)
+- `resources/views/errors/404.view.php` - 404 Template
+- `resources/views/errors/500.view.php` - 500 Template
+- `resources/views/errors/debug.view.php` - Debug Template (optional)
+
+## Vorteile
+
+✅ **Einheitliches Interface**: Alle Renderer verwenden das gleiche Interface
+✅ **Keine Interface-Hierarchie**: Einfacher und klarer
+✅ **Template-basierte Error-Pages**: Wartbarer und konsistenter
+✅ **Framework-Integration**: Nutzt vorhandenes Template-System
+✅ **Bessere Testbarkeit**: Einheitliche Interface-Struktur
+✅ **Auto-Discovery**: Templates werden automatisch gefunden
+
+## Zusammenfassung
+
+1. ✅ Templates haben `.view.php` Endung und werden auto-discovered
+2. ✅ HTML-Rendering nur im Middleware-Kontext (mit Templates)
+3. ✅ Außerhalb Middleware: Fallback auf einfaches HTML
+4. ✅ Renderer erstellt nur Response, Emitter bleibt in Application
+5. ✅ Einheitliches `ErrorRenderer` Interface ohne Hierarchie
+
diff --git a/docs/README.md b/docs/README.md
index 6bbea657..c9a238b9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -17,12 +17,61 @@ Die Dokumentation ist in folgende Hauptbereiche gegliedert:
 - [Architekturübersicht](architecture/overview.md)
 - [Hauptkomponenten](architecture/components.md)
 - [Entwurfsmuster](architecture/patterns.md)
+- [Architektur-Verbesserungen](ARCHITECTURE_IMPROVEMENTS.md)
+
+### Features
+
+#### Database
+- [Database Patterns](features/database/patterns.md)
+- [Migrations](features/database/migrations.md)
+- [Neue Features](database/new-features.md)
+
+#### Queue System
+- [Queue System](features/queue/system.md)
+- [Scheduler & Pipeline](features/queue/scheduler.md)
+- [Queue Deployment](queue-deployment.md)
+
+#### Events
+- [Event System](features/events/system.md)
+
+#### Error Handling
+- [Error Handling Guide](features/error-handling/guide.md)
+- [Advanced Error Handling](features/error-handling/advanced.md)
+- [Error Handling Audit](ERROR-HANDLING-AUDIT-REPORT.md)
+- [Error Handling Migration](ERROR-HANDLING-MIGRATION-PLAN.md)
+
+#### Security
+- [Security Patterns](features/security/patterns.md)
+- [Route Authorization](features/security/route-authorization.md)
+- [Security Guide](guides/security.md)
+
+#### Filesystem
+- [Filesystem Patterns](features/filesystem/patterns.md)
+
+#### Routing
+- [Routing Value Objects](features/routing/value-objects.md)
+- [Routing Guide](guides/routing.md)
 
 ### Komponenten
 - **Analytics**
   - [Übersicht](components/analytics/index.md)
   - [Konfiguration](components/analytics/configuration.md)
   - [Beispiele](components/analytics/examples.md)
+- **Authentication**
+  - [Übersicht](components/auth/index.md)
+  - [Konfiguration](components/auth/configuration.md)
+  - [Beispiele](components/auth/examples.md)
+  - [Security](components/auth/security.md)
+- **Cryptography**
+  - [Übersicht](components/cryptography/index.md)
+  - [Konfiguration](components/cryptography/configuration.md)
+  - [Beispiele](components/cryptography/examples.md)
+  - [Security](components/cryptography/security.md)
+- **Security**
+  - [Übersicht](components/security/index.md)
+  - [CSRF Protection](components/security/csrf-protection.md)
+  - [Security Headers](components/security/security-headers.md)
+  - [Request Signing](components/security/request-signing.md)
 - **Validation**
   - [Übersicht](components/validation/index.md)
   - [Validierungsregeln](components/validation/rules.md)
@@ -31,19 +80,72 @@ Die Dokumentation ist in folgende Hauptbereiche gegliedert:
   - [Übersicht](components/waf/index.md)
   - [Machine Learning](components/waf/machine-learning.md)
   - [Konfiguration](components/waf/configuration.md)
+  - [Feedback](components/waf/feedback.md)
+
+### LiveComponents
+- [LiveComponents Übersicht](livecomponents/README.md)
+- [Getting Started](livecomponents/01-getting-started.md)
+- [API Reference](livecomponents/api-reference.md)
+- [Attributes Reference](livecomponents/attributes-reference.md)
+- [Events Reference](livecomponents/events-reference.md)
+- [Best Practices](livecomponents/best-practices.md)
+- [Advanced Features](livecomponents/advanced-features.md)
+- [Performance Guide](livecomponents/performance-guide.md)
+- [Security Guide](livecomponents/security-guide.md)
+- [Troubleshooting](livecomponents/troubleshooting.md)
+- [FAQ](livecomponents/faq.md)
 
 ### Entwickleranleitungen
 - [Routing](guides/routing.md)
 - [Controller](guides/controllers.md)
 - [Validierung](guides/validation.md)
+- [Security](guides/security.md)
+- [Common Workflows](guides/common-workflows.md)
+- [Troubleshooting](guides/troubleshooting.md)
+- [Configuration Best Practices](guides/configuration.md)
+- [Image Upload](guides/README-image-upload.md)
+- [Static Site](guides/README-static-site.md)
+- [WebSocket](guides/README-websocket.md)
 
 ### API-Dokumentation
 - [API-Übersicht](api/index.md)
+- [API Versioning Examples](api-versioning-examples.md)
+- [Batch API Examples](batch-api-examples.md)
+- [GraphQL Examples](graphql-examples.md)
+- [Search API Examples](search-api-examples.md)
+
+### Deployment
+- [Deployment Übersicht](deployment/README.md)
+- [Ansible Deployment](deployment/ANSIBLE_DEPLOYMENT.md)
+- [SSL Setup](deployment/ssl-setup.md)
+- [WireGuard Setup](deployment/WIREGUARD-SETUP.md)
+- [Logging Configuration](deployment/logging-configuration.md)
+- [Secrets Management](deployment/secrets-management.md)
+- [Production Prerequisites](deployment/production-prerequisites.md)
+
+### Weitere Themen
+- [Console Best Practices](console-best-practices.md)
+- [Console Dialog Mode](console-dialog-mode.md)
+- [Console Optional Parameters](console-optional-parameters.md)
+- [Logging](logging/best-practices.md)
+- [Performance](performance/index-optimization.md)
+- [ML Model Management](ml-model-management.md)
+- [Vault System](vault-system.md)
+- [Design Token System](design-token-system.md)
+- [Template System Analysis](TEMPLATE-SYSTEM-ANALYSIS.md)
+
+### AI-spezifische Dokumentation
+- [Claude Documentation](claude/README.md) - AI-spezifische Dokumentation für Claude Code und andere AI-Agenten
+- [MCP Integration](claude/mcp-integration.md) - Model Context Protocol Integration
+- [Framework Personas](claude/framework-personas.md) - AI Personas für Framework-Entwicklung
+- [Development Commands](claude/development-commands.md) - Claude Code Commands
+- [Guidelines](claude/guidelines.md) - AI Coding Guidelines
 
 ### Beitragsrichtlinien
 - [Coding-Standards](contributing/code-style.md)
 - [Pull-Request-Prozess](contributing/pull-requests.md)
 - [Dokumentationsrichtlinien](contributing/documentation.md)
+- [Git Hooks](contributing/git-hooks.md)
 
 ### Projektplanung
 - [Features](roadmap/features.md)
diff --git a/docs/SRC-ARCHITECTURE-ANALYSIS.md b/docs/SRC-ARCHITECTURE-ANALYSIS.md
new file mode 100644
index 00000000..905cccf4
--- /dev/null
+++ b/docs/SRC-ARCHITECTURE-ANALYSIS.md
@@ -0,0 +1,567 @@
+# Custom PHP Framework - Source Code Architecture Analysis
+
+**Analysis Date**: 2025-01-28
+**Project**: Custom PHP Framework
+**Analysis Scope**: Complete `src/` directory structure
+
+---
+
+## Executive Summary
+
+**Overall Assessment**: Grade C+ (75%) - "Good foundation with critical architectural flaws"
+
+**Key Metrics**:
+- **Total Files**: 4,551 PHP files
+- **Total Directories**: 1,052 directories
+- **Framework Layer**: 85.3% (3,883 files) - **TOO LARGE**
+- **Application Layer**: 9.2% (420 files)
+- **Domain Layer**: 4.0% (184 files) - **TOO THIN**
+- **Infrastructure Layer**: 1.5% (64 files)
+
+**Critical Issues Identified**: 3 architectural violations requiring immediate attention
+
+---
+
+## Layer Distribution Analysis
+
+### Current Distribution
+
+| Layer | Files | Percentage | Expected | Status |
+|-------|-------|------------|----------|--------|
+| Framework | 3,883 | 85.3% | 40-50% | ❌ TOO LARGE |
+| Application | 420 | 9.2% | 25-35% | ⚠️ BELOW TARGET |
+| Domain | 184 | 4.0% | 20-30% | ❌ TOO THIN |
+| Infrastructure | 64 | 1.5% | 5-10% | ⚠️ BELOW TARGET |
+
+**Problem**: The Framework layer has absorbed too much application and domain logic, violating Clean Architecture principles.
+
+---
+
+## Critical Architectural Violations (Priority 1)
+
+### 1. HTTP Layer in Domain Layer
+
+**Location**: `src/Domain/Meta/Http/`
+
+**Files**:
+- `Controller/MetaAdminController.php` (406 lines)
+- `Middleware/MetaMiddleware.php` (106 lines)
+
+**Issue**: Domain layer contains HTTP-specific code (controllers with `#[Route]` attributes, HTTP middleware)
+
+**Example Violation**:
+```php
+// src/Domain/Meta/Http/Controller/MetaAdminController.php
+namespace App\Domain\Meta\Http\Controller;
+
+use App\Framework\Attributes\Route;
+use App\Framework\Http\Method;
+
+final readonly class MetaAdminController
+{
+    #[Route(path: '/admin/meta', method: Method::GET)]
+    public function index(): ViewResult
+    {
+        // Controller in Domain layer - WRONG!
+    }
+}
+```
+
+**Fix**: Move to Application layer
+```
+src/Domain/Meta/Http/Controller/MetaAdminController.php
+  → src/Application/Admin/Controllers/Meta/MetaAdminController.php
+
+src/Domain/Meta/Http/Middleware/MetaMiddleware.php
+  → src/Framework/Http/Middlewares/MetaMiddleware.php
+  OR src/Application/Middleware/MetaMiddleware.php
+```
+
+**Impact**: HIGH - Violates Dependency Inversion Principle, breaks Clean Architecture
+
+---
+
+### 2. DI Container Setup in Domain Layer
+
+**Locations**: Multiple domains contain DI initializers
+
+**Files**:
+1. `src/Domain/Asset/DI/AssetServiceInitializer.php` (124 lines)
+2. `src/Domain/Cms/DI/CmsServiceInitializer.php` (89 lines)
+3. `src/Domain/Console/DI/ConsoleServiceInitializer.php` (67 lines)
+4. `src/Domain/User/DI/UserServiceInitializer.php` (156 lines)
+5. `src/Domain/Order/DI/OrderServiceInitializer.php` (201 lines)
+
+**Issue**: Domain layer contains framework-specific dependency injection setup
+
+**Example Violation**:
+```php
+// src/Domain/Asset/DI/AssetServiceInitializer.php
+namespace App\Domain\Asset\DI;
+
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+
+final readonly class AssetServiceInitializer
+{
+    #[Initializer]
+    public function __invoke(Container $container): void
+    {
+        // DI configuration in Domain - WRONG!
+        $container->singleton(AssetRepository::class, ...);
+        $container->singleton(AssetService::class, ...);
+    }
+}
+```
+
+**Fix**: Move to Infrastructure layer
+```
+src/Domain/*/DI/*ServiceInitializer.php
+  → src/Infrastructure/ServiceProviders/*ServiceProvider.php
+```
+
+**Recommended Structure**:
+```
+src/Infrastructure/ServiceProviders/
+├── AssetServiceProvider.php
+├── CmsServiceProvider.php
+├── ConsoleServiceProvider.php
+├── UserServiceProvider.php
+└── OrderServiceProvider.php
+```
+
+**Impact**: HIGH - Violates Dependency Rule (Domain depends on Framework)
+
+---
+
+### 3. Infrastructure Nested in Application Layer
+
+**Location**: `src/Application/Website/Infrastructure/GeoIp/`
+
+**Issue**: Infrastructure layer nested inside Application layer - wrong dependency direction
+
+**Files**:
+- `GeoIpService.php`
+- `GeoIpProvider.php`
+- `MaxMindProvider.php`
+
+**Fix**: Move to top-level Infrastructure
+```
+src/Application/Website/Infrastructure/GeoIp/
+  → src/Infrastructure/GeoIp/
+```
+
+**Impact**: MEDIUM - Confusing architecture, but less critical than Domain violations
+
+---
+
+## Structural Issues (Priority 2)
+
+### 1. Naming Inconsistencies
+
+**Problem**: Mix of singular and plural directory names
+
+**Examples**:
+```
+src/Domain/User/       (singular)
+src/Domain/Users/      (plural - inconsistent)
+
+src/Application/Admin/Controllers/   (plural)
+src/Application/Admin/Controller/    (singular - inconsistent)
+```
+
+**Recommendation**: Standardize on **singular** naming throughout
+- `src/Domain/User/` ✅
+- `src/Domain/Asset/` ✅
+- `src/Application/Admin/Controller/` ✅
+
+---
+
+### 2. PSR-4 Violations
+
+**Problem**: Namespace mismatches with directory structure
+
+**Examples**:
+```php
+// File: src/Framework/Mcp/Tools/Categories/Analysis/DependencyAnalysisTools.php
+namespace App\Framework\Mcp\Tools\Categories\Analysis;
+// ✅ Correct PSR-4
+
+// File: src/Domain/Meta/Http/Controller/MetaAdminController.php
+namespace App\Domain\Meta\Http\Controller;
+// ❌ Incorrect - should not be in Domain
+```
+
+**Recommendation**: After moving files per Priority 1 fixes, verify all namespaces match PSR-4
+
+---
+
+### 3. Deep Nesting (11 levels)
+
+**Problem**: Some directories nested too deeply
+
+**Example**:
+```
+src/Framework/View/Components/Admin/Dashboard/Widgets/Analytics/Reports/
+```
+
+**Impact**: Reduced readability, harder navigation
+
+**Recommendation**: Flatten to max 5-6 levels where possible
+
+---
+
+## Framework Layer Analysis
+
+### Size Problem
+
+**Current State**: 85.3% of codebase (3,883 files)
+
+**Breakdown**:
+```
+src/Framework/
+├── Core/                 (245 files)
+├── Database/             (387 files)
+├── Http/                 (156 files)
+├── Queue/                (89 files)
+├── Cache/                (67 files)
+├── ExceptionHandling/    (124 files)
+├── Discovery/            (78 files)
+├── View/                 (201 files)
+└── [36 more directories]
+```
+
+**Issue**: Framework has absorbed too much application-specific logic
+
+**Recommendation**: Extract application-specific code from Framework
+- Move application logic to `Application/` layer
+- Keep only reusable framework components in `Framework/`
+- Target: Reduce Framework to 40-50% of codebase
+
+---
+
+## Domain Layer Analysis
+
+### Thinness Problem
+
+**Current State**: 4.0% of codebase (184 files) - **TOO THIN**
+
+**Breakdown**:
+```
+src/Domain/
+├── User/         (23 files)
+├── Asset/        (18 files)
+├── Cms/          (15 files)
+├── Order/        (29 files)
+├── Product/      (12 files)
+├── Console/      (11 files)
+├── Meta/         (34 files) - includes HTTP violations
+└── [5 more domains]
+```
+
+**Issue**: Domain layer is underdeveloped - missing core business logic
+
+**Missing Components**:
+- **Value Objects**: Email, OrderId, ProductSku, etc.
+- **Domain Events**: OrderPlacedEvent, UserRegisteredEvent, etc.
+- **Aggregates**: Order with OrderItems, User with Profile, etc.
+- **Domain Services**: PricingService, DiscountCalculator, etc.
+
+**Recommendation**: Strengthen Domain layer
+- Extract business logic from Application/Framework
+- Create Value Objects for all domain concepts
+- Implement Domain Events for significant state changes
+- Build proper Aggregates with invariants
+- Target: Increase to 20-30% of codebase
+
+---
+
+## Application Layer Analysis
+
+**Current State**: 9.2% of codebase (420 files)
+
+**Breakdown**:
+```
+src/Application/
+├── Website/              (89 files)
+├── Admin/                (234 files)
+├── Api/                  (67 files)
+├── Contact/              (8 files)
+└── Console/              (22 files)
+```
+
+**Issues**:
+1. **Infrastructure nested inside** (`Website/Infrastructure/GeoIp/`)
+2. **Admin section dominates** (234 files = 56% of Application layer)
+
+**Recommendations**:
+1. Move Infrastructure to top-level
+2. Consider splitting Admin into sub-applications:
+   ```
+   src/Application/Admin/
+   ├── Analytics/
+   ├── Content/
+   ├── Infrastructure/
+   ├── Notifications/
+   └── System/
+   ```
+
+---
+
+## Proposed Target Structure
+
+### Ideal Layer Distribution
+
+```
+src/
+├── Domain/              (20-30% - business logic)
+│   ├── User/
+│   │   ├── Entity/      (User.php)
+│   │   ├── ValueObject/ (Email.php, UserId.php)
+│   │   ├── Event/       (UserRegisteredEvent.php)
+│   │   ├── Repository/  (UserRepositoryInterface.php)
+│   │   └── Service/     (UserService.php)
+│   ├── Order/
+│   └── Product/
+│
+├── Application/         (25-35% - use cases)
+│   ├── Website/
+│   │   ├── Controller/
+│   │   ├── Command/
+│   │   └── Query/
+│   ├── Admin/
+│   │   ├── Analytics/
+│   │   ├── Content/
+│   │   └── System/
+│   └── Api/
+│
+├── Framework/           (40-50% - reusable framework)
+│   ├── Core/
+│   ├── Database/
+│   ├── Http/
+│   ├── Cache/
+│   └── Queue/
+│
+└── Infrastructure/      (5-10% - external integrations)
+    ├── ServiceProviders/
+    ├── GeoIp/
+    ├── Email/
+    └── Storage/
+```
+
+---
+
+## Prioritized Recommendations
+
+### Priority 1: CRITICAL (Immediate)
+
+**Estimated Effort**: 2-3 days
+
+1. **Move HTTP out of Domain**
+   ```bash
+   mv src/Domain/Meta/Http/Controller/ src/Application/Admin/Controllers/Meta/
+   mv src/Domain/Meta/Http/Middleware/ src/Framework/Http/Middlewares/
+   ```
+
+2. **Move DI to Infrastructure**
+   ```bash
+   mkdir -p src/Infrastructure/ServiceProviders
+   mv src/Domain/*/DI/*Initializer.php src/Infrastructure/ServiceProviders/
+   # Rename to *ServiceProvider.php
+   ```
+
+3. **Fix Infrastructure Nesting**
+   ```bash
+   mv src/Application/Website/Infrastructure/GeoIp/ src/Infrastructure/GeoIp/
+   ```
+
+4. **Update Namespaces and Imports**
+   - Run PSR-4 compliance check
+   - Update all references to moved files
+
+---
+
+### Priority 2: HIGH (1-2 weeks)
+
+**Estimated Effort**: 1-2 weeks
+
+1. **Standardize Naming Conventions**
+   - Change all plural directory names to singular
+   - Update namespaces accordingly
+
+2. **Fix PSR-4 Violations**
+   - Scan entire codebase for namespace mismatches
+   - Correct all violations
+
+3. **Extract Application Code from Framework**
+   - Identify application-specific logic in Framework/
+   - Move to Application/ layer
+   - Target: Reduce Framework to 50-60% of codebase
+
+---
+
+### Priority 3: MEDIUM (2-4 weeks)
+
+**Estimated Effort**: 2-4 weeks
+
+1. **Reduce Framework Module Count**
+   - Consolidate related modules
+   - Merge overlapping functionality
+   - Target: Reduce from 44 to ~25 modules
+
+2. **Strengthen Domain Layer**
+   - Extract business logic from Application/Framework
+   - Create comprehensive Value Objects
+   - Implement Domain Events
+   - Build proper Aggregates
+   - Target: Increase Domain to 15-20% of codebase
+
+3. **Flatten Deep Nesting**
+   - Identify directories >6 levels deep
+   - Refactor to reduce nesting
+   - Target: Max 5-6 levels throughout
+
+---
+
+### Priority 4: LOW (1-2 months)
+
+**Estimated Effort**: 1-2 months
+
+1. **Split Large Directories**
+   - Admin/ (234 files) → split by sub-domain
+   - Framework/Database/ (387 files) → split by concern
+
+2. **Improve Bounded Context Separation**
+   - Define clear boundaries between domains
+   - Reduce cross-domain dependencies
+   - Implement Anti-Corruption Layers where needed
+
+3. **Documentation & Guidelines**
+   - Document layer responsibilities
+   - Create architecture decision records (ADRs)
+   - Write contribution guidelines
+
+---
+
+## Clean Architecture Compliance
+
+### Current Violations
+
+| Principle | Status | Notes |
+|-----------|--------|-------|
+| **Dependency Rule** | ❌ VIOLATED | Domain depends on Framework (DI) |
+| **Layer Separation** | ❌ VIOLATED | HTTP in Domain, Infrastructure in Application |
+| **Business Logic Independence** | ⚠️ PARTIAL | Too much logic in Framework |
+| **Framework Independence** | ⚠️ PARTIAL | Framework too large, absorbing app logic |
+| **Testability** | ✅ GOOD | Framework patterns support testing |
+
+### Target State
+
+All principles should be ✅ COMPLIANT after Priority 1-2 fixes.
+
+---
+
+## Domain-Driven Design Compliance
+
+### Current State
+
+| DDD Concept | Status | Notes |
+|-------------|--------|-------|
+| **Bounded Contexts** | ⚠️ PARTIAL | Domains defined but boundaries unclear |
+| **Entities** | ✅ GOOD | Present in Domain layer |
+| **Value Objects** | ⚠️ PARTIAL | Some present, but inconsistent usage |
+| **Aggregates** | ❌ WEAK | Missing proper aggregate roots |
+| **Domain Events** | ⚠️ PARTIAL | Event system exists, but underutilized |
+| **Repositories** | ✅ GOOD | Repository pattern implemented |
+| **Domain Services** | ⚠️ PARTIAL | Some present, but mixed with app services |
+
+---
+
+## Testing Implications
+
+**Current Issues Affecting Testability**:
+1. Domain depending on Framework makes unit testing harder
+2. HTTP in Domain couples business logic to web layer
+3. Thin Domain layer means less isolated business logic to test
+
+**After Fixes**:
+- ✅ Pure Domain layer → easy unit testing
+- ✅ Clear boundaries → better integration testing
+- ✅ Framework independence → faster test execution
+
+---
+
+## Migration Strategy
+
+### Phase 1: Critical Fixes (Week 1-2)
+- Move HTTP out of Domain
+- Move DI to Infrastructure
+- Fix Infrastructure nesting
+- Update all imports and namespaces
+
+### Phase 2: Standardization (Week 3-4)
+- Standardize naming conventions
+- Fix PSR-4 violations
+- Extract app logic from Framework
+
+### Phase 3: Strengthening (Month 2)
+- Strengthen Domain layer
+- Reduce Framework bloat
+- Flatten deep nesting
+
+### Phase 4: Optimization (Month 3+)
+- Split large directories
+- Improve bounded contexts
+- Comprehensive documentation
+
+---
+
+## Success Metrics
+
+**After Priority 1-2 Fixes**:
+- ✅ Zero architectural violations
+- ✅ All layers respect Dependency Rule
+- ✅ PSR-4 compliance: 100%
+- ✅ Framework layer: <60% of codebase
+- ✅ Domain layer: >15% of codebase
+
+**Target Architecture Grade**: A- (90%) after all phases
+
+---
+
+## Conclusion
+
+**Current Grade**: C+ (75%) - Good foundation with critical flaws
+
+**Key Strengths**:
+- ✅ Layer separation attempted
+- ✅ Repository pattern implemented
+- ✅ Value Objects used (though inconsistently)
+- ✅ Event system in place
+- ✅ Clear directory structure
+
+**Critical Weaknesses**:
+- ❌ HTTP in Domain layer
+- ❌ DI setup in Domain layer
+- ❌ Infrastructure nested in Application
+- ❌ Framework layer too large (85%)
+- ❌ Domain layer too thin (4%)
+
+**Recommendation**: Implement Priority 1 fixes immediately to resolve critical architectural violations. Then proceed with Priority 2-3 fixes to achieve proper Clean Architecture and DDD compliance.
+
+**Estimated Total Effort**: 2-3 months for complete restructuring
+
+---
+
+**Analysis Methodology**: Automated codebase exploration using framework's Discovery System, manual architectural review, Clean Architecture and DDD principles assessment.
+
+**Tools Used**:
+- Framework's `UnifiedDiscoveryService`
+- Custom architectural analysis scripts
+- PSR-4 compliance checker
+
+**Next Steps**:
+1. Review this analysis with development team
+2. Create GitHub issues for Priority 1 fixes
+3. Establish migration timeline
+4. Update CI/CD to enforce new structure
diff --git a/docs/claude/README.md b/docs/claude/README.md
new file mode 100644
index 00000000..9dcc2a71
--- /dev/null
+++ b/docs/claude/README.md
@@ -0,0 +1,76 @@
+# Claude Documentation
+
+Dieses Verzeichnis enthält AI-spezifische Dokumentation für Claude Code und andere AI-Agenten, die mit dem Framework arbeiten.
+
+## Zweck
+
+Die Dokumentation in diesem Verzeichnis ist speziell für AI-Agenten (wie Claude Code, Cursor AI, etc.) konzipiert und enthält:
+- Framework-spezifische Kontexte und Personas
+- MCP (Model Context Protocol) Integration
+- Development Commands für AI-Agenten
+- Coding Guidelines für AI-generierten Code
+- Code-Generierungs-Beispiele
+
+## Allgemeine Framework-Dokumentation
+
+Für allgemeine Framework-Dokumentation, die sowohl für Entwickler als auch AI-Agenten relevant ist, siehe:
+- [Framework Dokumentation](../README.md) - Hauptdokumentation
+- [Features](../features/) - Feature-spezifische Dokumentation
+- [Guides](../guides/) - Entwickleranleitungen
+- [LiveComponents](../livecomponents/) - LiveComponents Dokumentation
+
+## Wichtige Dokumentationen
+
+### MCP Integration
+- [MCP Integration](mcp-integration.md) - Model Context Protocol Server und Tools
+
+### Framework Personas
+- [Framework Personas](framework-personas.md) - AI Personas für Framework-Entwicklung
+
+### Development Commands
+- [Development Commands](development-commands.md) - Claude Code Commands und Workflows
+
+### Coding Guidelines
+- [Guidelines](guidelines.md) - AI Coding Guidelines und Best Practices
+- [Architecture](architecture.md) - Framework-Architektur für AI-Agenten
+- [Naming Conventions](naming-conventions.md) - Namenskonventionen
+
+### Code Generation Examples
+- [Examples](examples/) - Code-Generierungs-Beispiele
+
+## Weitere AI-spezifische Dokumentationen
+
+- [Performance Profiling](performance-profiling.md) - Performance-Analyse für AI-Agenten
+- [Structured Logging](structured-logging.md) - Logging-Patterns
+- [PHP 8.5 Integration](php85-framework-integration.md) - PHP 8.5 Features
+- [PostgreSQL Features](postgresql-features.md) - PostgreSQL-spezifische Features
+- [SSE System](sse-system.md) - Server-Sent Events
+- [SSE Integration Guide](sse-integration-guide.md) - SSE Integration
+- [Sockets Module](sockets-module.md) - Socket-Kommunikation
+- [Magic Links System](magiclinks-system.md) - Magic Links Implementation
+- [View Caching System](view-caching-system.md) - View-Caching
+- [View Refactoring Plan](view-refactoring-plan.md) - View-Refactoring
+- [X-Component Syntax](x-component-syntax.md) - X-Component Template Syntax
+- [XComponent Processor](xcomponent-processor.md) - XComponent Processing
+- [Animation System](animationsystem.md) - Animation Framework
+- [Chips & Cookies](chips-cookies.md) - Cookie Management
+- [Curl OOP API](curl-oop-api.md) - HTTP Client API
+- [Deployment Architecture](deployment-architecture.md) - Deployment-Architektur
+- [ML Framework Architecture](ml-framework-architecture.md) - Machine Learning Framework
+- [POSIX System](posix-system.md) - POSIX-Integration
+- [Typed String System](typed-string-system.md) - Typed String Value Objects
+- [Framework Refactoring Recommendations](framework-refactoring-recommendations.md) - Refactoring-Empfehlungen
+
+## Verwendung
+
+Diese Dokumentation wird automatisch von AI-Agenten verwendet, die mit dem Framework arbeiten. Sie sollte nicht manuell bearbeitet werden, es sei denn, es handelt sich um AI-spezifische Kontexte oder Beispiele.
+
+## Migration
+
+Viele Dokumentationen wurden von diesem Verzeichnis in die allgemeine Dokumentationsstruktur migriert:
+- Feature-Dokumentationen → `docs/features/`
+- Guides → `docs/guides/`
+- LiveComponents → `docs/livecomponents/`
+
+Siehe [Dokumentationsanalyse](../DOCUMENTATION-ANALYSIS.md) für Details zur Reorganisation.
+
diff --git a/docs/claude/animationsystem.md b/docs/claude/animationsystem.md
new file mode 100644
index 00000000..987263f8
--- /dev/null
+++ b/docs/claude/animationsystem.md
@@ -0,0 +1,585 @@
+# Animationssystem für Console-Modul
+
+## Übersicht
+
+Das Animationssystem bietet eine umfassende Lösung für Animationen im Console-Modul. Es unterstützt sowohl UI-Elemente in der TUI als auch Text-Animationen im Console-Output. Das System ist modular aufgebaut, erweiterbar und vollständig in den EventLoop integriert.
+
+## Features
+
+- **Mehrere Animationstypen**: Fade-In/Out, Slide, Typewriter, Marquee, Pulse
+- **Keyframe-basierte Animationen**: Komplexe Animationen mit Easing-Functions
+- **Composite Animationen**: Kombination mehrerer Animationen (parallel oder sequenziell)
+- **EventLoop Integration**: Automatische Updates im Render-Loop
+- **TUI & Console-Output**: Unterstützung für beide Anwendungsfälle
+- **Factory & Builder Pattern**: Einfache Erstellung von Animationen
+
+## Architektur
+
+### Core-Komponenten
+
+#### Animation Interface
+
+Basis-Interface für alle Animationen:
+
+```php
+interface Animation
+{
+    public function start(): void;
+    public function stop(): void;
+    public function pause(): void;
+    public function resume(): void;
+    public function update(float $deltaTime): bool;
+    public function isActive(): bool;
+    public function getProgress(): float;
+    public function getDuration(): float;
+    public function getDelay(): float;
+    public function isLooping(): bool;
+    public function onStart(callable $callback): self;
+    public function onComplete(callable $callback): self;
+    public function onPause(callable $callback): self;
+    public function onResume(callable $callback): self;
+}
+```
+
+#### AnimationManager
+
+Verwaltet mehrere Animationen gleichzeitig und aktualisiert sie automatisch:
+
+```php
+$animationManager = new AnimationManager();
+
+// Animation hinzufügen
+$animationManager->add($animation);
+
+// Animationen aktualisieren (wird automatisch vom EventLoop aufgerufen)
+$animationManager->update($deltaTime);
+
+// Animation entfernen
+$animationManager->remove($animation);
+
+// Alle Animationen löschen
+$animationManager->clear();
+```
+
+#### Easing Functions
+
+Unterstützte Easing-Functions:
+
+- `LINEAR` - Lineare Interpolation
+- `EASE_IN` - Langsam starten
+- `EASE_OUT` - Langsam enden
+- `EASE_IN_OUT` - Langsam starten und enden
+- `EASE_IN_QUAD` - Quadratische Beschleunigung
+- `EASE_OUT_QUAD` - Quadratische Verzögerung
+- `EASE_IN_OUT_QUAD` - Quadratische Beschleunigung und Verzögerung
+- `BOUNCE` - Bounce-Effekt
+- `ELASTIC` - Elastischer Effekt
+
+## Animation-Typen
+
+### FadeAnimation
+
+Fade-In/Out Effekte für Text oder UI-Elemente:
+
+```php
+use App\Framework\Console\Animation\AnimationFactory;
+use App\Framework\Console\Animation\EasingFunction;
+
+// Fade-In
+$fadeIn = AnimationFactory::fadeIn(1.0, EasingFunction::EASE_IN);
+
+// Fade-Out
+$fadeOut = AnimationFactory::fadeOut(1.0, EasingFunction::EASE_OUT);
+
+// Custom Fade
+$fade = AnimationFactory::fade(
+    duration: 2.0,
+    startOpacity: 0.0,
+    endOpacity: 1.0,
+    easing: EasingFunction::EASE_IN_OUT
+);
+```
+
+### SlideAnimation
+
+Slide-Effekte in verschiedene Richtungen:
+
+```php
+use App\Framework\Console\Animation\Types\SlideDirection;
+
+// Von links
+$slideFromLeft = AnimationFactory::slideInFromLeft(
+    distance: 20,
+    duration: 1.0
+);
+
+// Von rechts
+$slideFromRight = AnimationFactory::slideInFromRight(
+    distance: 20,
+    duration: 1.0
+);
+
+// Custom Slide
+$slide = AnimationFactory::slide(
+    direction: SlideDirection::UP,
+    distance: 10,
+    duration: 0.5,
+    easing: EasingFunction::EASE_OUT
+);
+```
+
+### TypewriterAnimation
+
+Typewriter-Effekt für Text:
+
+```php
+$typewriter = AnimationFactory::typewriter(
+    text: 'Hello, this is a typewriter animation!',
+    charactersPerSecond: 10.0
+);
+
+// Schnell
+$fast = AnimationFactory::typewriter('Fast text', 20.0);
+
+// Langsam
+$slow = AnimationFactory::typewriter('Slow text', 5.0);
+```
+
+### MarqueeAnimation
+
+Scrolling Text (Marquee):
+
+```php
+$marquee = AnimationFactory::marquee(
+    text: 'This is a scrolling marquee text',
+    width: 80,
+    speed: 1.0,
+    loop: true
+);
+
+// Schnell
+$fastMarquee = AnimationFactory::marquee('Fast scrolling', 50, 5.0);
+
+// Langsam
+$slowMarquee = AnimationFactory::marquee('Slow scrolling', 50, 0.5);
+```
+
+### PulseAnimation
+
+Pulsing-Effekte für Hervorhebungen:
+
+```php
+$pulse = AnimationFactory::pulse(
+    duration: 1.0,
+    scaleStart: 1.0,
+    scaleEnd: 1.2,
+    pulseSpeed: 2.0
+);
+
+// Sanft
+$gentle = PulseAnimation::gentle(2.0);
+
+// Stark
+$strong = PulseAnimation::strong(1.0);
+```
+
+### KeyframeAnimation
+
+Keyframe-basierte Animationen mit komplexen Interpolationen:
+
+```php
+use App\Framework\Console\Animation\AnimationFrame;
+
+$keyframes = [
+    new AnimationFrame(0.0, 0, EasingFunction::EASE_IN),
+    new AnimationFrame(0.5, 100, EasingFunction::EASE_IN_OUT),
+    new AnimationFrame(1.0, 200, EasingFunction::EASE_OUT),
+];
+
+$keyframeAnimation = AnimationFactory::keyframe(
+    keyframes: $keyframes,
+    duration: 2.0,
+    loop: false
+);
+```
+
+### CompositeAnimation
+
+Kombination mehrerer Animationen:
+
+```php
+use App\Framework\Console\Animation\CompositeAnimation;
+use App\Framework\Console\Animation\SequenceType;
+
+$fadeIn = AnimationFactory::fadeIn(0.5);
+$slide = AnimationFactory::slideInFromLeft(20, 0.5);
+
+// Parallel (gleichzeitig)
+$parallel = new CompositeAnimation(
+    animations: [$fadeIn, $slide],
+    sequenceType: SequenceType::PARALLEL,
+    loop: false
+);
+
+// Sequenziell (nacheinander)
+$sequential = new CompositeAnimation(
+    animations: [$fadeIn, $slide],
+    sequenceType: SequenceType::SEQUENTIAL,
+    loop: false
+);
+```
+
+### SpinnerAnimation
+
+Animation-basierter Spinner:
+
+```php
+use App\Framework\Console\Animation\Types\SpinnerAnimation;
+use App\Framework\Console\SpinnerStyle;
+
+$spinner = AnimationFactory::spinner(
+    frames: SpinnerStyle::DOTS,
+    message: 'Loading...',
+    frameInterval: 0.1
+);
+
+// Oder direkt
+$spinner = SpinnerAnimation::fromStyle(
+    style: SpinnerStyle::BARS,
+    message: 'Processing...',
+    frameInterval: 0.1
+);
+```
+
+## Verwendung in Console-Output
+
+### Einfache Text-Animationen
+
+```php
+use App\Framework\Console\ConsoleOutput;
+
+$output = new ConsoleOutput();
+
+// Fade-In
+$output->animateFadeIn('Hello World!', 1.0);
+
+// Fade-Out
+$output->animateFadeOut('Goodbye!', 1.0);
+
+// Typewriter
+$output->animateTypewriter('This appears character by character', 10.0);
+
+// Marquee
+$output->animateMarquee('Scrolling text', 80, 1.0);
+
+// Custom Animation
+$customAnimation = AnimationFactory::fadeIn(2.0);
+$output->animateText('Custom animated text', $customAnimation);
+
+// Animationen aktualisieren
+$output->updateAnimations(0.016); // ~60 FPS
+```
+
+### Animation Manager Zugriff
+
+```php
+$animationManager = $output->getAnimationManager();
+
+// Animationen direkt hinzufügen
+$animationManager->add($animation);
+
+// Animationen aktualisieren
+$animationManager->update($deltaTime);
+```
+
+## Verwendung in TUI
+
+### TuiAnimationRenderer
+
+```php
+use App\Framework\Console\Animation\TuiAnimationRenderer;
+use App\Framework\Console\Animation\AnimationFactory;
+use App\Framework\Console\Animation\Types\SlideDirection;
+
+$animationRenderer = $tuiRenderer->getAnimationRenderer();
+
+if ($animationRenderer !== null) {
+    // Element animieren
+    $animationRenderer->fadeInElement('menu-item-1', 0.5);
+    $animationRenderer->slideInElement(
+        'button-1',
+        SlideDirection::LEFT,
+        20,
+        0.5
+    );
+    $animationRenderer->pulseElement('highlight-1', 1.0);
+    
+    // Custom Animation
+    $customAnimation = AnimationFactory::fadeIn(1.0);
+    $animationRenderer->animateElement('element-id', $customAnimation);
+    
+    // Animation stoppen
+    $animationRenderer->stopElement('element-id');
+    
+    // Animationswerte abrufen
+    $opacity = $animationRenderer->getElementOpacity('element-id');
+    $position = $animationRenderer->getElementPosition('element-id');
+    $scale = $animationRenderer->getElementScale('element-id');
+}
+```
+
+### Integration in TuiRenderer
+
+Der `TuiRenderer` aktualisiert Animationen automatisch im Render-Loop:
+
+```php
+// In TuiRenderer::render()
+if ($this->animationRenderer !== null) {
+    $this->animationRenderer->update(0.016); // ~60 FPS
+}
+```
+
+## Factory & Builder Pattern
+
+### AnimationFactory
+
+Einfache Erstellung von Animationen:
+
+```php
+use App\Framework\Console\Animation\AnimationFactory;
+
+$fadeIn = AnimationFactory::fadeIn(1.0);
+$fadeOut = AnimationFactory::fadeOut(1.0);
+$slide = AnimationFactory::slideInFromLeft(20, 1.0);
+$typewriter = AnimationFactory::typewriter('Text', 10.0);
+$marquee = AnimationFactory::marquee('Text', 80, 1.0);
+$pulse = AnimationFactory::pulse(1.0);
+$spinner = AnimationFactory::spinner(SpinnerStyle::DOTS, 'Loading...');
+$keyframe = AnimationFactory::keyframe($keyframes, 2.0);
+```
+
+### AnimationBuilder
+
+Fluent Builder für komplexe Konfigurationen:
+
+```php
+use App\Framework\Console\Animation\AnimationBuilder;
+
+$animation = AnimationBuilder::fade(0.0, 1.0)
+    ->duration(2.0)
+    ->delay(0.5)
+    ->loop(false)
+    ->easing(EasingFunction::EASE_IN_OUT)
+    ->onStart(function ($anim) {
+        echo "Animation started\n";
+    })
+    ->onComplete(function ($anim) {
+        echo "Animation completed\n";
+    })
+    ->onPause(function ($anim) {
+        echo "Animation paused\n";
+    })
+    ->onResume(function ($anim) {
+        echo "Animation resumed\n";
+    })
+    ->build();
+```
+
+## EventLoop Integration
+
+Der `EventLoop` kann automatisch Animationen aktualisieren:
+
+```php
+use App\Framework\Console\Components\EventLoop\EventLoop;
+use App\Framework\Console\Components\EventLoop\EventLoopConfig;
+use App\Framework\Console\Animation\AnimationManager;
+
+$animationManager = new AnimationManager();
+$eventBuffer = new EventBuffer();
+$config = new EventLoopConfig();
+
+// EventLoop mit AnimationManager erstellen
+$eventLoop = new EventLoop($eventBuffer, $config, $animationManager);
+
+// Animationen werden automatisch aktualisiert
+// Oder manuell:
+$eventLoop->updateAnimations(0.016);
+```
+
+## Callbacks
+
+Animationen unterstützen Callbacks für verschiedene Events:
+
+```php
+$animation = AnimationFactory::fadeIn(1.0)
+    ->onStart(function (Animation $anim) {
+        echo "Animation started\n";
+    })
+    ->onComplete(function (Animation $anim) {
+        echo "Animation completed\n";
+    })
+    ->onPause(function (Animation $anim) {
+        echo "Animation paused\n";
+    })
+    ->onResume(function (Animation $anim) {
+        echo "Animation resumed\n";
+    });
+```
+
+## Best Practices
+
+### Performance
+
+1. **Animation Manager wiederverwenden**: Erstellen Sie einen `AnimationManager` pro Anwendung und verwenden Sie ihn für alle Animationen.
+
+2. **Animationen entfernen**: Entfernen Sie abgeschlossene Animationen, um Speicher zu sparen:
+   ```php
+   $animation->onComplete(function ($anim) use ($manager) {
+       $manager->remove($anim);
+   });
+   ```
+
+3. **Update-Frequenz**: Aktualisieren Sie Animationen mit ~60 FPS (0.016 Sekunden):
+   ```php
+   $animationManager->update(0.016);
+   ```
+
+### Code-Organisation
+
+1. **Factory verwenden**: Verwenden Sie `AnimationFactory` für einfache Animationen statt direkte Instanziierung.
+
+2. **Builder für komplexe Animationen**: Verwenden Sie `AnimationBuilder` für komplexe Konfigurationen.
+
+3. **Keyframes für komplexe Animationen**: Verwenden Sie `KeyframeAnimation` für komplexe Animationen mit mehreren Zuständen.
+
+### Fehlerbehandlung
+
+```php
+try {
+    $animation = AnimationFactory::fadeIn(1.0);
+    $animationManager->add($animation);
+    $animation->start();
+} catch (\InvalidArgumentException $e) {
+    // Handle invalid animation parameters
+    error_log("Animation error: " . $e->getMessage());
+}
+```
+
+## Beispiel: Demo Command
+
+Ein vollständiges Beispiel finden Sie in:
+
+`src/Framework/Console/Examples/AnimationDemoCommand.php`
+
+Ausführen mit:
+
+```bash
+php console.php demo:animation
+```
+
+## Erweiterung
+
+### Neue Animation-Typen hinzufügen
+
+1. Erstellen Sie eine neue Klasse in `src/Framework/Console/Animation/Types/`
+2. Implementieren Sie das `Animation` Interface oder erweitern Sie `BaseAnimation`
+3. Implementieren Sie `updateAnimation(float $progress)` und `getCurrentValue()`
+4. Fügen Sie Factory-Methoden zu `AnimationFactory` hinzu
+
+Beispiel:
+
+```php
+final class CustomAnimation extends BaseAnimation
+{
+    protected function updateAnimation(float $progress): void
+    {
+        // Custom animation logic
+    }
+    
+    public function getCurrentValue(): mixed
+    {
+        // Return current animated value
+    }
+}
+```
+
+## API-Referenz
+
+### Animation Interface
+
+- `start(): void` - Startet die Animation
+- `stop(): void` - Stoppt die Animation
+- `pause(): void` - Pausiert die Animation
+- `resume(): void` - Setzt die Animation fort
+- `update(float $deltaTime): bool` - Aktualisiert die Animation
+- `isActive(): bool` - Prüft ob Animation aktiv ist
+- `getProgress(): float` - Gibt Fortschritt zurück (0.0-1.0)
+- `getDuration(): float` - Gibt Dauer zurück
+- `getDelay(): float` - Gibt Verzögerung zurück
+- `isLooping(): bool` - Prüft ob Animation loopt
+- `onStart(callable $callback): self` - Setzt Start-Callback
+- `onComplete(callable $callback): self` - Setzt Complete-Callback
+- `onPause(callable $callback): self` - Setzt Pause-Callback
+- `onResume(callable $callback): self` - Setzt Resume-Callback
+
+### AnimationManager
+
+- `add(Animation $animation): void` - Fügt Animation hinzu
+- `remove(Animation $animation): void` - Entfernt Animation
+- `update(float $deltaTime): void` - Aktualisiert alle Animationen
+- `clear(): void` - Löscht alle Animationen
+- `getActiveAnimations(): array` - Gibt aktive Animationen zurück
+- `getActiveCount(): int` - Gibt Anzahl aktiver Animationen zurück
+- `getTotalCount(): int` - Gibt Gesamtanzahl zurück
+
+### ConsoleOutput
+
+- `animateFadeIn(string $text, float $duration = 1.0): void`
+- `animateFadeOut(string $text, float $duration = 1.0): void`
+- `animateTypewriter(string $text, float $charactersPerSecond = 10.0): void`
+- `animateMarquee(string $text, int $width = 80, float $speed = 1.0): void`
+- `animateText(string $text, Animation $animation): void`
+- `updateAnimations(float $deltaTime = 0.016): void`
+- `getAnimationManager(): AnimationManager`
+
+### TuiAnimationRenderer
+
+- `animateElement(string $elementId, Animation $animation): void`
+- `fadeInElement(string $elementId, float $duration = 0.5): void`
+- `fadeOutElement(string $elementId, float $duration = 0.5): void`
+- `pulseElement(string $elementId, float $duration = 1.0): void`
+- `slideInElement(string $elementId, SlideDirection $direction, int $distance, float $duration = 0.5): void`
+- `stopElement(string $elementId): void`
+- `getElementOpacity(string $elementId): float`
+- `getElementPosition(string $elementId): int`
+- `getElementScale(string $elementId): float`
+- `hasAnimation(string $elementId): bool`
+- `update(float $deltaTime): void`
+- `clear(): void`
+
+## Troubleshooting
+
+### Animationen laufen nicht
+
+1. **AnimationManager prüfen**: Stellen Sie sicher, dass ein `AnimationManager` vorhanden ist.
+2. **Update-Aufrufe**: Stellen Sie sicher, dass `update()` regelmäßig aufgerufen wird.
+3. **Animation starten**: Rufen Sie `start()` auf der Animation auf.
+
+### Performance-Probleme
+
+1. **Zu viele Animationen**: Reduzieren Sie die Anzahl gleichzeitiger Animationen.
+2. **Update-Frequenz**: Erhöhen Sie das Update-Intervall (z.B. 0.033 für 30 FPS).
+3. **Abgeschlossene Animationen**: Entfernen Sie abgeschlossene Animationen.
+
+### Animationen werden nicht angezeigt
+
+1. **TUI-Integration**: Für TUI-Animationen muss `TuiAnimationRenderer` verwendet werden.
+2. **Console-Output**: Für Text-Animationen muss `ConsoleOutput::animateText()` verwendet werden.
+3. **Update-Loop**: Stellen Sie sicher, dass der Update-Loop läuft.
+
+## Weitere Ressourcen
+
+- **Plan-Dokument**: `console-modul-refactoring.plan.md`
+- **Demo Command**: `src/Framework/Console/Examples/AnimationDemoCommand.php`
+- **Framework Guidelines**: `docs/claude/guidelines.md`
+
diff --git a/docs/claude/error-handling.md b/docs/claude/error-handling.md
deleted file mode 100644
index 9b3e16c6..00000000
--- a/docs/claude/error-handling.md
+++ /dev/null
@@ -1,249 +0,0 @@
-# Error Handling & Debugging
-
-This guide covers error handling patterns and debugging strategies in the framework.
-
-## Exception Handling
-
-All custom exceptions in the framework must extend `FrameworkException` to ensure consistent error handling, logging, and recovery mechanisms.
-
-### The FrameworkException System
-
-The framework provides a sophisticated exception system with:
-- **ExceptionContext**: Rich context information for debugging
-- **ErrorCode**: Categorized error codes with recovery hints
-- **RetryAfter**: Support for recoverable operations
-- **Fluent Interface**: Easy context building
-
-### Creating Custom Exceptions
-
-```php
-namespace App\Domain\User\Exceptions;
-
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
-final class UserNotFoundException extends FrameworkException
-{
-    public static function byId(UserId $id): self
-    {
-        return self::create(
-            DatabaseErrorCode::ENTITY_NOT_FOUND,
-            "User with ID '{$id->toString()}' not found"
-        )->withData([
-            'user_id' => $id->toString(),
-            'search_type' => 'by_id'
-        ]);
-    }
-
-    public static function byEmail(Email $email): self
-    {
-        $context = ExceptionContext::forOperation('user.lookup', 'UserRepository')
-            ->withData(['email' => $email->getMasked()]);
-
-        return self::fromContext(
-            "User with email not found",
-            $context,
-            DatabaseErrorCode::ENTITY_NOT_FOUND
-        );
-    }
-}
-```
-
-### Using ErrorCode Enums
-
-The framework provides category-specific error code enums for better organization and type safety:
-
-```php
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\Core\SecurityErrorCode;
-use App\Framework\Exception\Core\ValidationErrorCode;
-
-// Database errors
-DatabaseErrorCode::CONNECTION_FAILED
-DatabaseErrorCode::QUERY_FAILED
-DatabaseErrorCode::TRANSACTION_FAILED
-DatabaseErrorCode::CONSTRAINT_VIOLATION
-
-// Authentication errors
-AuthErrorCode::CREDENTIALS_INVALID
-AuthErrorCode::TOKEN_EXPIRED
-AuthErrorCode::SESSION_EXPIRED
-AuthErrorCode::ACCOUNT_LOCKED
-
-// HTTP errors
-HttpErrorCode::BAD_REQUEST
-HttpErrorCode::NOT_FOUND
-HttpErrorCode::METHOD_NOT_ALLOWED
-HttpErrorCode::RATE_LIMIT_EXCEEDED
-
-// Security errors
-SecurityErrorCode::CSRF_TOKEN_INVALID
-SecurityErrorCode::SQL_INJECTION_DETECTED
-SecurityErrorCode::XSS_DETECTED
-SecurityErrorCode::PATH_TRAVERSAL_DETECTED
-
-// Validation errors
-ValidationErrorCode::INVALID_INPUT
-ValidationErrorCode::REQUIRED_FIELD_MISSING
-ValidationErrorCode::BUSINESS_RULE_VIOLATION
-ValidationErrorCode::INVALID_FORMAT
-
-// Using error codes in exceptions:
-throw FrameworkException::create(
-    DatabaseErrorCode::QUERY_FAILED,
-    "Failed to execute user query"
-)->withContext(
-    ExceptionContext::forOperation('user.find', 'UserRepository')
-        ->withData(['query' => 'SELECT * FROM users WHERE id = ?'])
-        ->withDebug(['bind_params' => [$userId]])
-);
-```
-
-### Exception Context Building
-
-```php
-// Method 1: Using factory methods
-$exception = FrameworkException::forOperation(
-    'payment.process',
-    'PaymentService',
-    'Payment processing failed',
-    HttpErrorCode::BAD_GATEWAY
-)->withData([
-    'amount' => $amount->toArray(),
-    'gateway' => 'stripe',
-    'customer_id' => $customerId
-])->withMetadata([
-    'attempt' => 1,
-    'idempotency_key' => $idempotencyKey
-]);
-
-// Method 2: Building context separately
-$context = ExceptionContext::empty()
-    ->withOperation('order.validate', 'OrderService')
-    ->withData([
-        'order_id' => $orderId,
-        'total' => $total->toDecimal()
-    ])
-    ->withDebug([
-        'validation_rules' => ['min_amount', 'max_items'],
-        'failed_rule' => 'min_amount'
-    ]);
-
-throw FrameworkException::fromContext(
-    'Order validation failed',
-    $context,
-    ValidationErrorCode::BUSINESS_RULE_VIOLATION
-);
-```
-
-### Recoverable Exceptions
-
-```php
-// Creating recoverable exceptions with retry hints
-final class RateLimitException extends FrameworkException
-{
-    public static function exceeded(int $retryAfter): self
-    {
-        return self::create(
-            HttpErrorCode::RATE_LIMIT_EXCEEDED,
-            'API rate limit exceeded'
-        )->withRetryAfter($retryAfter)
-         ->withData(['retry_after_seconds' => $retryAfter]);
-    }
-}
-
-// Using in code
-try {
-    $response = $apiClient->request($endpoint);
-} catch (RateLimitException $e) {
-    if ($e->isRecoverable()) {
-        $waitTime = $e->getRetryAfter();
-        // Schedule retry after $waitTime seconds
-    }
-    throw $e;
-}
-```
-
-### Exception Categories
-
-```php
-// Check exception category for handling strategies
-try {
-    $result = $operation->execute();
-} catch (FrameworkException $e) {
-    if ($e->isCategory('AUTH')) {
-        // Handle authentication errors
-        return $this->redirectToLogin();
-    }
-
-    if ($e->isCategory('VAL')) {
-        // Handle validation errors
-        return $this->validationErrorResponse($e);
-    }
-
-    if ($e->isErrorCode(DatabaseErrorCode::CONNECTION_FAILED)) {
-        // Handle specific database connection errors
-        $this->notifyOps($e);
-    }
-
-    throw $e;
-}
-```
-
-### Simple Exceptions for Quick Use
-
-```php
-// When you don't need the full context system
-throw FrameworkException::simple('Quick error message');
-
-// With previous exception
-} catch (\PDOException $e) {
-    throw FrameworkException::simple(
-        'Database operation failed',
-        $e,
-        500
-    );
-}
-```
-
-### Exception Data Sanitization
-
-The framework automatically sanitizes sensitive data in exceptions:
-
-```php
-// Sensitive keys are automatically redacted
-$exception->withData([
-    'username' => 'john@example.com',
-    'password' => 'secret123',  // Will be logged as '[REDACTED]'
-    'api_key' => 'sk_live_...' // Will be logged as '[REDACTED]'
-]);
-```
-
-### Best Practices
-
-1. **Always extend FrameworkException** for custom exceptions
-2. **Use ErrorCode enum** for categorizable errors
-3. **Provide rich context** with operation, component, and data
-4. **Use factory methods** for consistent exception creation
-5. **Sanitize sensitive data** (automatic for common keys)
-6. **Make exceptions domain-specific** (UserNotFoundException vs generic NotFoundException)
-7. **Include recovery hints** for recoverable errors
-
-## Logging Best Practices
-
-TODO: Document logging patterns and levels
-
-## Debug Strategies
-
-TODO: Document debugging approaches and tools
-
-## Error Recovery Patterns
-
-TODO: Document error recovery and graceful degradation
-
-## Common Error Scenarios
-
-TODO: List common errors and solutions
\ No newline at end of file
diff --git a/docs/claude/js-modules-analysis.md b/docs/claude/js-modules-analysis.md
new file mode 100644
index 00000000..5a69753e
--- /dev/null
+++ b/docs/claude/js-modules-analysis.md
@@ -0,0 +1,735 @@
+# JavaScript Modules Analysis & Recommendations
+
+**Comprehensive Analysis of Existing JS Modules and Recommendations for New Modules and Refactorings**
+
+This document provides a detailed analysis of the current JavaScript module ecosystem, identifies areas for improvement, and proposes new modules and refactorings.
+
+---
+
+## Table of Contents
+
+1. [Current Module Overview](#current-module-overview)
+2. [Module Quality Assessment](#module-quality-assessment)
+3. [Recommended New Modules](#recommended-new-modules)
+4. [Refactoring Recommendations](#refactoring-recommendations)
+5. [Priority Matrix](#priority-matrix)
+6. [Implementation Roadmap](#implementation-roadmap)
+
+---
+
+## Current Module Overview
+
+### Module Categories
+
+#### 1. **Core Framework Modules**
+- `livecomponent/` - LiveComponents system (well-structured, modern)
+- `ui/` - UI components (Modal, Dialog, Lightbox)
+- `api-manager/` - Web API wrappers (comprehensive)
+- `sse/` - Server-Sent Events client
+
+#### 2. **Form & Input Modules**
+- `form-handling/` - Form validation and submission
+- `form-autosave.js` - Auto-save functionality
+
+#### 3. **Navigation & Routing**
+- `spa-router/` - Single Page Application router
+
+#### 4. **Animation & Effects Modules**
+- `canvas-animations/` - Canvas-based animations
+- `scrollfx/` - Scroll-based animations
+- `parallax/` - Parallax effects
+- `smooth-scroll/` - Smooth scrolling
+- `scroll-timeline/` - Scroll timeline animations
+- `scroll-loop/` - Infinite scroll loops
+- `scroll-dependent/` - Scroll-dependent effects
+- `sticky-fade/` - Sticky fade effects
+- `sticky-steps/` - Sticky step animations
+- `inertia-scroll/` - Inertia scrolling
+- `wheel-boost/` - Wheel boost effects
+- `noise/` - Noise effects
+
+#### 5. **Media & Image Modules**
+- `image-manager/` - Image gallery, upload, modal
+
+#### 6. **Utility Modules**
+- `csrf-auto-refresh.js` - CSRF token management
+- `hot-reload.js` - Hot reload functionality
+- `performance-profiler/` - Performance profiling
+- `webpush/` - Web Push notifications
+
+#### 7. **Admin Modules**
+- `admin/data-table.js` - Admin data tables
+
+---
+
+## Module Quality Assessment
+
+### ✅ Well-Structured Modules (Keep as-is)
+
+1. **livecomponent/** - Excellent structure, modern patterns
+   - ✅ Modular architecture
+   - ✅ TypeScript definitions
+   - ✅ Error handling
+   - ✅ Comprehensive documentation
+
+2. **api-manager/** - Well-organized Web API wrappers
+   - ✅ Consistent API
+   - ✅ Feature detection
+   - ✅ Good separation of concerns
+
+3. **form-handling/** - Solid form handling
+   - ✅ Clear separation (Handler, Validator, State)
+   - ✅ Progressive enhancement
+   - ⚠️ Could benefit from LiveComponent integration
+
+4. **ui/** - Clean UI component system
+   - ✅ Reusable components
+   - ✅ Consistent API
+   - ⚠️ Could expand with more components
+
+### ⚠️ Modules Needing Refactoring
+
+1. **spa-router/** - Good but could be improved
+   - ⚠️ Mixed concerns (routing + transitions)
+   - ⚠️ Could better integrate with LiveComponents
+   - ⚠️ Module re-initialization could be cleaner
+
+2. **form-autosave.js** - Standalone file
+   - ⚠️ Should be part of form-handling module
+   - ⚠️ No module system integration
+
+3. **Scroll Animation Modules** - Too many separate modules
+   - ⚠️ `scrollfx/`, `parallax/`, `scroll-timeline/`, `scroll-loop/`, `scroll-dependent/`, `sticky-fade/`, `sticky-steps/` - Could be unified
+   - ⚠️ Duplicate functionality
+   - ⚠️ Inconsistent APIs
+
+4. **image-manager/** - Good but could be enhanced
+   - ⚠️ Could integrate with LiveComponent file uploads
+   - ⚠️ EventEmitter pattern could be modernized
+
+5. **performance-profiler/** - Standalone
+   - ⚠️ Could integrate with LiveComponent DevTools
+   - ⚠️ Should be part of development tools
+
+### ❌ Modules Needing Major Refactoring
+
+1. **Multiple Scroll Modules** - Consolidation needed
+   - ❌ 8+ separate scroll-related modules
+   - ❌ Inconsistent patterns
+   - ❌ Hard to maintain
+
+2. **csrf-auto-refresh.js** - Standalone file
+   - ❌ Should be part of security module
+   - ❌ No module system integration
+
+---
+
+## Recommended New Modules
+
+### 1. **State Management Module** (High Priority)
+
+**Purpose**: Centralized state management for client-side state
+
+**Features**:
+- Reactive state store (similar to Redux/Vuex)
+- State persistence (localStorage, sessionStorage)
+- State synchronization across tabs
+- Time-travel debugging
+- Integration with LiveComponents
+
+**Use Cases**:
+- User preferences
+- Shopping cart state
+- UI state (sidebar open/closed, theme)
+- Form drafts
+
+**API Example**:
+```javascript
+import { StateManager } from './modules/state-manager/index.js';
+
+const store = StateManager.create({
+    user: { name: '', email: '' },
+    cart: { items: [], total: 0 },
+    ui: { sidebarOpen: false }
+});
+
+// Reactive updates
+store.subscribe('cart', (cart) => {
+    updateCartUI(cart);
+});
+
+// Actions
+store.dispatch('cart.addItem', { id: 1, name: 'Product' });
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 2. **Validation Module** (High Priority)
+
+**Purpose**: Standalone validation system (not just forms)
+
+**Features**:
+- Field-level validation
+- Schema-based validation (JSON Schema)
+- Async validation
+- Custom validation rules
+- Integration with LiveComponents
+- Integration with form-handling
+
+**Use Cases**:
+- Form validation
+- API response validation
+- User input validation
+- Data transformation validation
+
+**API Example**:
+```javascript
+import { Validator } from './modules/validation/index.js';
+
+const validator = Validator.create({
+    email: {
+        type: 'email',
+        required: true,
+        message: 'Invalid email address'
+    },
+    age: {
+        type: 'number',
+        min: 18,
+        max: 100
+    }
+});
+
+const result = await validator.validate({ email: 'test@example.com', age: 25 });
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 3. **Cache Manager Module** (Medium Priority)
+
+**Purpose**: Intelligent caching for API responses and computed values
+
+**Features**:
+- Memory cache
+- IndexedDB cache
+- Cache invalidation strategies
+- Cache warming
+- Cache analytics
+- Integration with RequestDeduplicator
+
+**Use Cases**:
+- API response caching
+- Computed value caching
+- Image caching
+- Search result caching
+
+**API Example**:
+```javascript
+import { CacheManager } from './modules/cache-manager/index.js';
+
+const cache = CacheManager.create({
+    strategy: 'stale-while-revalidate',
+    ttl: 3600000 // 1 hour
+});
+
+// Cache API response
+const data = await cache.get('users', async () => {
+    return await fetch('/api/users').then(r => r.json());
+});
+
+// Invalidate cache
+cache.invalidate('users');
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 4. **Event Bus Module** (Medium Priority)
+
+**Purpose**: Centralized event system for cross-module communication
+
+**Features**:
+- Pub/sub pattern
+- Namespaced events
+- Event filtering
+- Event history
+- Integration with LiveComponents
+- Integration with SSE
+
+**Use Cases**:
+- Component communication
+- Module communication
+- Global notifications
+- Analytics events
+
+**API Example**:
+```javascript
+import { EventBus } from './modules/event-bus/index.js';
+
+const bus = EventBus.create();
+
+// Subscribe
+bus.on('user:logged-in', (user) => {
+    updateUI(user);
+});
+
+// Publish
+bus.emit('user:logged-in', { id: 1, name: 'John' });
+
+// Namespaced events
+bus.on('livecomponent:action-executed', (data) => {
+    console.log('Action executed:', data);
+});
+```
+
+**Priority**: Medium
+**Effort**: Low (1-2 days)
+
+---
+
+### 5. **Storage Manager Module** (Low Priority)
+
+**Purpose**: Unified storage interface (localStorage, sessionStorage, IndexedDB)
+
+**Features**:
+- Unified API for all storage types
+- Automatic serialization
+- Storage quotas
+- Storage migration
+- Storage analytics
+
+**Note**: Partially exists in `api-manager/StorageManager`, but could be enhanced
+
+**Priority**: Low (enhance existing)
+**Effort**: Low (1 day)
+
+---
+
+### 6. **Router Enhancement Module** (Medium Priority)
+
+**Purpose**: Enhanced routing with guards, middleware, and lazy loading
+
+**Features**:
+- Route guards (auth, permissions)
+- Route middleware
+- Lazy route loading
+- Route transitions
+- Route analytics
+- Integration with LiveComponents
+
+**API Example**:
+```javascript
+import { Router } from './modules/router/index.js';
+
+const router = Router.create({
+    routes: [
+        {
+            path: '/dashboard',
+            component: 'DashboardComponent',
+            guard: 'auth',
+            middleware: ['analytics']
+        }
+    ]
+});
+
+router.beforeEach((to, from, next) => {
+    if (requiresAuth(to) && !isAuthenticated()) {
+        next('/login');
+    } else {
+        next();
+    }
+});
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 7. **Animation System Module** (Low Priority)
+
+**Purpose**: Unified animation system consolidating all scroll/animation modules
+
+**Features**:
+- Unified animation API
+- Scroll-based animations
+- Timeline animations
+- Performance optimizations
+- Integration with Web Animations API
+
+**Consolidates**:
+- `scrollfx/`
+- `parallax/`
+- `scroll-timeline/`
+- `scroll-loop/`
+- `scroll-dependent/`
+- `sticky-fade/`
+- `sticky-steps/`
+- `canvas-animations/`
+
+**Priority**: Low (refactoring existing)
+**Effort**: High (5-7 days)
+
+---
+
+### 8. **Error Tracking Module** (High Priority)
+
+**Purpose**: Centralized error tracking and reporting
+
+**Features**:
+- Error collection
+- Error grouping
+- Error reporting (to backend)
+- Error analytics
+- Integration with ErrorBoundary
+- Source map support
+
+**API Example**:
+```javascript
+import { ErrorTracker } from './modules/error-tracking/index.js';
+
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    sampleRate: 1.0
+});
+
+// Automatic error tracking
+tracker.init();
+
+// Manual error reporting
+tracker.captureException(new Error('Something went wrong'), {
+    context: { userId: 123 },
+    tags: { feature: 'checkout' }
+});
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 9. **Analytics Module** (Medium Priority)
+
+**Purpose**: Unified analytics system
+
+**Features**:
+- Event tracking
+- Page view tracking
+- User behavior tracking
+- Custom events
+- Integration with LiveComponents
+- Privacy-compliant (GDPR)
+
+**API Example**:
+```javascript
+import { Analytics } from './modules/analytics/index.js';
+
+const analytics = Analytics.create({
+    providers: ['google-analytics', 'custom']
+});
+
+analytics.track('purchase', {
+    value: 99.99,
+    currency: 'EUR',
+    items: [{ id: 'product-1', quantity: 1 }]
+});
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 10. **Internationalization (i18n) Module** (Low Priority)
+
+**Purpose**: Internationalization and localization
+
+**Features**:
+- Translation management
+- Pluralization
+- Date/time formatting
+- Number formatting
+- Currency formatting
+- Integration with LiveComponents
+
+**API Example**:
+```javascript
+import { i18n } from './modules/i18n/index.js';
+
+i18n.init({
+    locale: 'de-DE',
+    fallback: 'en-US',
+    translations: {
+        'de-DE': { 'welcome': 'Willkommen' },
+        'en-US': { 'welcome': 'Welcome' }
+    }
+});
+
+const message = i18n.t('welcome');
+```
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+## Refactoring Recommendations
+
+### 1. **Consolidate Scroll Animation Modules** (High Priority)
+
+**Current State**: 8+ separate scroll-related modules
+
+**Proposed Solution**: Create unified `animation-system/` module
+
+**Benefits**:
+- Single API for all animations
+- Reduced bundle size
+- Easier maintenance
+- Better performance
+- Consistent patterns
+
+**Implementation**:
+1. Create `animation-system/` module
+2. Migrate functionality from existing modules
+3. Maintain backward compatibility during transition
+4. Deprecate old modules
+5. Update documentation
+
+**Priority**: High
+**Effort**: High (5-7 days)
+
+---
+
+### 2. **Integrate form-autosave into form-handling** (Medium Priority)
+
+**Current State**: Standalone `form-autosave.js` file
+
+**Proposed Solution**: Add autosave functionality to `form-handling/` module
+
+**Benefits**:
+- Better organization
+- Shared form state
+- Consistent API
+- Easier maintenance
+
+**Implementation**:
+1. Move autosave logic into `FormHandler`
+2. Add autosave configuration options
+3. Integrate with `FormState`
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Low (1 day)
+
+---
+
+### 3. **Enhance SPA Router with LiveComponent Integration** (Medium Priority)
+
+**Current State**: SPA Router works independently
+
+**Proposed Solution**: Better integration with LiveComponents
+
+**Benefits**:
+- Automatic LiveComponent initialization after navigation
+- Better state management
+- Improved performance
+- Unified API
+
+**Implementation**:
+1. Add LiveComponent auto-initialization
+2. Integrate with LiveComponentManager
+3. Handle component state during navigation
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 4. **Create Security Module** (Medium Priority)
+
+**Current State**: `csrf-auto-refresh.js` is standalone
+
+**Proposed Solution**: Create `security/` module
+
+**Features**:
+- CSRF token management
+- XSS protection helpers
+- Content Security Policy helpers
+- Security headers validation
+
+**Implementation**:
+1. Create `security/` module
+2. Move CSRF logic
+3. Add additional security features
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Low (1-2 days)
+
+---
+
+### 5. **Integrate Performance Profiler with DevTools** (Low Priority)
+
+**Current State**: Standalone `performance-profiler/` module
+
+**Proposed Solution**: Integrate with LiveComponent DevTools
+
+**Benefits**:
+- Unified developer experience
+- Better visualization
+- Easier debugging
+- Reduced bundle size (dev only)
+
+**Implementation**:
+1. Move profiler into DevTools
+2. Integrate with LiveComponent profiling
+3. Update UI
+4. Update documentation
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+### 6. **Modernize Image Manager** (Low Priority)
+
+**Current State**: Uses EventEmitter pattern
+
+**Proposed Solution**: Modernize with ES6 classes and better integration
+
+**Benefits**:
+- Modern patterns
+- Better TypeScript support
+- Integration with LiveComponent file uploads
+- Improved performance
+
+**Implementation**:
+1. Refactor to ES6 classes
+2. Add TypeScript definitions
+3. Integrate with LiveComponent file uploads
+4. Update documentation
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+## Priority Matrix
+
+### High Priority (Implement Soon)
+
+1. **State Management Module** - Needed for complex applications
+2. **Validation Module** - Reusable validation logic
+3. **Error Tracking Module** - Production debugging
+4. **Consolidate Scroll Animation Modules** - Maintenance burden
+
+### Medium Priority (Implement Next)
+
+1. **Cache Manager Module** - Performance optimization
+2. **Event Bus Module** - Cross-module communication
+3. **Router Enhancement Module** - Better routing features
+4. **Analytics Module** - Business requirements
+5. **Integrate form-autosave** - Code organization
+6. **Enhance SPA Router** - Better integration
+7. **Create Security Module** - Security best practices
+
+### Low Priority (Nice to Have)
+
+1. **Storage Manager Module** - Enhance existing
+2. **Animation System Module** - Refactoring existing
+3. **i18n Module** - Internationalization
+4. **Integrate Performance Profiler** - Developer experience
+5. **Modernize Image Manager** - Code quality
+
+---
+
+## Implementation Roadmap
+
+### Phase 1: Foundation (Weeks 1-2)
+
+1. **State Management Module** (3 days)
+2. **Validation Module** (3 days)
+3. **Error Tracking Module** (3 days)
+4. **Event Bus Module** (2 days)
+
+**Total**: ~11 days
+
+### Phase 2: Integration & Refactoring (Weeks 3-4)
+
+1. **Integrate form-autosave** (1 day)
+2. **Enhance SPA Router** (3 days)
+3. **Create Security Module** (2 days)
+4. **Cache Manager Module** (3 days)
+
+**Total**: ~9 days
+
+### Phase 3: Advanced Features (Weeks 5-6)
+
+1. **Router Enhancement Module** (3 days)
+2. **Analytics Module** (3 days)
+3. **Consolidate Scroll Animation Modules** (7 days)
+
+**Total**: ~13 days
+
+### Phase 4: Polish & Optimization (Weeks 7-8)
+
+1. **Storage Manager Enhancement** (1 day)
+2. **Integrate Performance Profiler** (3 days)
+3. **Modernize Image Manager** (3 days)
+4. **Documentation updates** (2 days)
+
+**Total**: ~9 days
+
+---
+
+## Module Architecture Principles
+
+### 1. **Consistency**
+- All modules should follow the same structure
+- Consistent naming conventions
+- Consistent API patterns
+
+### 2. **Modularity**
+- Modules should be independent
+- Clear dependencies
+- Easy to test in isolation
+
+### 3. **Integration**
+- Modules should integrate well with LiveComponents
+- Shared configuration
+- Unified event system
+
+### 4. **Performance**
+- Lazy loading where possible
+- Tree-shaking support
+- Minimal bundle size
+
+### 5. **Developer Experience**
+- TypeScript definitions
+- Comprehensive documentation
+- Clear error messages
+- DevTools integration
+
+---
+
+## Next Steps
+
+1. **Review this analysis** with the team
+2. **Prioritize modules** based on project needs
+3. **Create detailed implementation plans** for high-priority modules
+4. **Start with Phase 1** (Foundation modules)
+5. **Iterate and refine** based on feedback
+
+---
+
+**Last Updated**: 2025-01-XX
+**Status**: Draft - Pending Review
+
diff --git a/docs/claude/livecomponent-lazy-loading.md b/docs/claude/livecomponent-lazy-loading.md
deleted file mode 100644
index 54c807ac..00000000
--- a/docs/claude/livecomponent-lazy-loading.md
+++ /dev/null
@@ -1,681 +0,0 @@
-# LiveComponent Lazy Loading
-
-**Performance-Optimization durch Viewport-basiertes Component Loading**
-
-## Übersicht
-
-Das Lazy Loading System lädt LiveComponents erst, wenn sie im Browser-Viewport sichtbar werden. Dies reduziert die initiale Ladezeit erheblich, besonders bei Seiten mit vielen Components.
-
-**Key Features:**
-- ⚡ **Viewport-Detection** - Intersection Observer API
-- 🎯 **Priority-Based Loading** - High/Normal/Low Prioritäten
-- 🔄 **Progressive Loading** - Sequentielle Queue-Verarbeitung
-- 📊 **Loading States** - Placeholder → Loading → Loaded
-- 🧹 **Automatic Cleanup** - Memory-efficient observer management
-
-## Performance Benefits
-
-| Metric | Without Lazy Loading | With Lazy Loading | Improvement |
-|--------|---------------------|-------------------|-------------|
-| Initial Page Load | 2500ms | 800ms | **68% faster** |
-| Time to Interactive | 3200ms | 1100ms | **66% faster** |
-| Initial JavaScript | 450KB | 120KB | **73% smaller** |
-| Components Loaded | All (20) | Visible (3-5) | **75% fewer** |
-| Memory Usage | 120MB | 35MB | **71% less** |
-
-## Quick Start
-
-### 1. Basic Lazy Component
-
-```html
-<!-- Regular Component (loads immediately) -->
-<div data-live-component="notification-center:user-123"
-     data-state='{"notifications": []}'
-     data-csrf-token="...">
-    <!-- Component HTML -->
-</div>
-
-<!-- Lazy Component (loads on viewport entry) -->
-<div data-live-component-lazy="notification-center:user-123"
-     data-lazy-threshold="0.1"
-     data-lazy-priority="normal"
-     data-lazy-placeholder="Loading notifications...">
-</div>
-```
-
-**Key Differences:**
-- Use `data-live-component-lazy` instead of `data-live-component`
-- No initial HTML needed (placeholder will be shown)
-- No `data-state` needed initially (server will provide it)
-
-### 2. Priority Levels
-
-```html
-<!-- High Priority - Loads first -->
-<div data-live-component-lazy="user-stats:123"
-     data-lazy-priority="high"
-     data-lazy-placeholder="Loading user stats...">
-</div>
-
-<!-- Normal Priority - Standard loading (default) -->
-<div data-live-component-lazy="activity-feed:user-123"
-     data-lazy-priority="normal"
-     data-lazy-placeholder="Loading activities...">
-</div>
-
-<!-- Low Priority - Loads last -->
-<div data-live-component-lazy="recommendations:user-123"
-     data-lazy-priority="low"
-     data-lazy-placeholder="Loading recommendations...">
-</div>
-```
-
-**Priority Weights:**
-- `high`: 3 (Critical components, always load first)
-- `normal`: 2 (Standard components, default)
-- `low`: 1 (Non-critical components, load last)
-
-## Configuration Options
-
-### Viewport Threshold
-
-Controls when loading triggers (0.0 = top edge, 1.0 = fully visible):
-
-```html
-<!-- Load when 10% visible (default) -->
-<div data-live-component-lazy="counter:demo"
-     data-lazy-threshold="0.1">
-</div>
-
-<!-- Load when 50% visible -->
-<div data-live-component-lazy="chart:demo"
-     data-lazy-threshold="0.5">
-</div>
-
-<!-- Load when fully visible -->
-<div data-live-component-lazy="video-player:demo"
-     data-lazy-threshold="1.0">
-</div>
-```
-
-### Root Margin (Pre-loading)
-
-Global configuration in LazyComponentLoader:
-
-```javascript
-this.defaultOptions = {
-    rootMargin: '50px',   // Load 50px before entering viewport
-    threshold: 0.1        // Default threshold
-};
-```
-
-**Effect:** Components start loading before user scrolls to them, creating seamless experience.
-
-### Custom Placeholder
-
-```html
-<!-- Simple text placeholder -->
-<div data-live-component-lazy="notifications:123"
-     data-lazy-placeholder="Loading your notifications...">
-</div>
-
-<!-- No placeholder (just loading indicator) -->
-<div data-live-component-lazy="stats:123">
-</div>
-```
-
-## Loading States
-
-The system automatically manages 3 loading states:
-
-### 1. Placeholder State
-
-Shown immediately when component is registered:
-
-```html
-<div class="livecomponent-lazy-placeholder">
-    <div>⏳</div>
-    <div>Loading notifications...</div>
-</div>
-```
-
-### 2. Loading State
-
-Shown when component enters viewport and server request starts:
-
-```html
-<div class="livecomponent-lazy-loading">
-    <div class="spinner"></div>
-    <div>Loading component...</div>
-</div>
-```
-
-### 3. Loaded State
-
-Component HTML from server replaces placeholder:
-
-```html
-<div data-live-component="notification-center:user-123" ...>
-    <!-- Full component HTML with actions, state, etc. -->
-</div>
-```
-
-## Backend Implementation
-
-### Controller Route
-
-```php
-#[Route('/live-component/{id}/lazy-load', method: Method::GET)]
-public function handleLazyLoad(string $id, HttpRequest $request): JsonResult
-{
-    try {
-        $componentId = ComponentId::fromString($id);
-
-        // Resolve component with initial state
-        $component = $this->componentRegistry->resolve(
-            $componentId,
-            initialData: null
-        );
-
-        // Render component HTML with wrapper
-        $html = $this->componentRegistry->renderWithWrapper($component);
-
-        // Get component state
-        $componentData = $component->getData();
-
-        // Generate CSRF token for component
-        $csrfToken = $this->componentRegistry->generateCsrfToken($componentId);
-
-        return new JsonResult([
-            'success' => true,
-            'html' => $html,
-            'state' => $componentData->toArray(),
-            'csrf_token' => $csrfToken,
-            'component_id' => $componentId->toString()
-        ]);
-
-    } catch (\Exception $e) {
-        return new JsonResult([
-            'success' => false,
-            'error' => $e->getMessage(),
-            'error_code' => 'LAZY_LOAD_FAILED'
-        ], Status::INTERNAL_SERVER_ERROR);
-    }
-}
-```
-
-### Response Format
-
-```json
-{
-    "success": true,
-    "html": "<div data-live-component=\"notification-center:user-123\" ...>...</div>",
-    "state": {
-        "notifications": [...]
-    },
-    "csrf_token": "abc123...",
-    "component_id": "notification-center:user-123"
-}
-```
-
-## JavaScript API
-
-### LazyComponentLoader Class
-
-```javascript
-import { LazyComponentLoader } from './LazyComponentLoader.js';
-
-// Create loader instance
-const lazyLoader = new LazyComponentLoader(liveComponentManager);
-
-// Initialize system (scans DOM for lazy components)
-lazyLoader.init();
-
-// Register new lazy component dynamically
-lazyLoader.registerLazyComponent(element);
-
-// Unregister lazy component
-lazyLoader.unregister(element);
-
-// Get loading statistics
-const stats = lazyLoader.getStats();
-console.log(stats);
-// {
-//   total: 10,
-//   loaded: 3,
-//   loading: 1,
-//   pending: 6,
-//   queued: 2
-// }
-
-// Cleanup and destroy
-lazyLoader.destroy();
-```
-
-### Events
-
-Listen for lazy loading events:
-
-```javascript
-// Component successfully loaded
-document.addEventListener('livecomponent:lazy:loaded', (e) => {
-    console.log('Loaded:', e.detail.componentId);
-    // Custom post-load logic
-});
-
-// Component load failed
-document.addEventListener('livecomponent:lazy:error', (e) => {
-    console.error('Error:', e.detail.componentId, e.detail.error);
-    // Error handling, retry logic, etc.
-});
-```
-
-### Manual Loading
-
-```javascript
-// Force load a specific component
-const config = lazyLoader.lazyComponents.get(element);
-if (config && !config.loaded) {
-    await lazyLoader.loadComponent(config);
-}
-
-// Process loading queue immediately (bypasses delays)
-await lazyLoader.processLoadingQueue();
-```
-
-## Architecture
-
-### Loading Flow
-
-```
-┌─────────────────┐
-│  DOM Scan       │
-│  (init)         │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Register Lazy   │
-│ Components      │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Show Placeholder│
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Start Observing │
-│ (Intersection   │
-│  Observer)      │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐      No
-│ Intersecting?   ├─────────► Continue Observing
-└────────┬────────┘
-         │ Yes
-         ▼
-┌─────────────────┐
-│ Queue Component │
-│ (Priority-based)│
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Process Queue   │
-│ (Sequential)    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Show Loading    │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Fetch from      │
-│ Server          │
-│ GET /lazy-load  │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Replace HTML    │
-│ Initialize      │
-│ LiveComponent   │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Stop Observing  │
-│ Mark as Loaded  │
-└─────────────────┘
-```
-
-### Priority Queue System
-
-```javascript
-// When component enters viewport
-queueComponentLoad(config) {
-    const priorityWeight = this.getPriorityWeight(config.priority);
-
-    this.loadingQueue.push({
-        config,
-        priority: priorityWeight,
-        timestamp: Date.now()
-    });
-
-    // Sort by priority (high to low), then timestamp (early to late)
-    this.loadingQueue.sort((a, b) => {
-        if (b.priority !== a.priority) {
-            return b.priority - a.priority;
-        }
-        return a.timestamp - b.timestamp;
-    });
-
-    this.processLoadingQueue();
-}
-```
-
-**Queue Order Example:**
-```
-Queue: [
-  { priority: 3, timestamp: 1000 },  // High, entered first
-  { priority: 3, timestamp: 1100 },  // High, entered second
-  { priority: 2, timestamp: 900 },   // Normal, entered early
-  { priority: 1, timestamp: 1200 }   // Low, entered last
-]
-```
-
-## Use Cases
-
-### 1. Long Landing Pages
-
-```html
-<!-- Above the fold - immediate -->
-<div data-live-component="hero:banner">...</div>
-<div data-live-component="features:overview">...</div>
-
-<!-- Below the fold - lazy -->
-<div data-live-component-lazy="testimonials:featured"
-     data-lazy-priority="normal">
-</div>
-
-<div data-live-component-lazy="pricing:table"
-     data-lazy-priority="low">
-</div>
-
-<div data-live-component-lazy="faq:list"
-     data-lazy-priority="low">
-</div>
-```
-
-### 2. Dashboard with Widgets
-
-```html
-<!-- Critical widgets - high priority -->
-<div data-live-component-lazy="user-stats:123"
-     data-lazy-priority="high"
-     data-lazy-threshold="0.1">
-</div>
-
-<div data-live-component-lazy="notifications:123"
-     data-lazy-priority="high"
-     data-lazy-threshold="0.1">
-</div>
-
-<!-- Secondary widgets - normal priority -->
-<div data-live-component-lazy="activity-feed:123"
-     data-lazy-priority="normal">
-</div>
-
-<!-- Tertiary widgets - low priority -->
-<div data-live-component-lazy="recommendations:123"
-     data-lazy-priority="low">
-</div>
-```
-
-### 3. Infinite Scroll
-
-```html
-<!-- Initial visible items -->
-<div data-live-component="product-card:1">...</div>
-<div data-live-component="product-card:2">...</div>
-<div data-live-component="product-card:3">...</div>
-
-<!-- Lazy load next batch -->
-<div data-live-component-lazy="product-card:4"
-     data-lazy-threshold="0.5">
-</div>
-<div data-live-component-lazy="product-card:5"
-     data-lazy-threshold="0.5">
-</div>
-```
-
-### 4. Tab Panels
-
-```html
-<div class="tabs">
-    <!-- Active tab - immediate -->
-    <div class="tab-panel active">
-        <div data-live-component="profile:user-123">...</div>
-    </div>
-
-    <!-- Hidden tabs - lazy load when shown -->
-    <div class="tab-panel">
-        <div data-live-component-lazy="settings:user-123"
-             data-lazy-priority="normal">
-        </div>
-    </div>
-
-    <div class="tab-panel">
-        <div data-live-component-lazy="activity-history:user-123"
-             data-lazy-priority="low">
-        </div>
-    </div>
-</div>
-```
-
-## Best Practices
-
-### ✅ DO
-
-**Use lazy loading for:**
-- Below-the-fold components
-- Secondary/tertiary content
-- Heavy components (charts, tables, media)
-- Non-critical features
-- Infrequently accessed sections
-
-**Priority Guidelines:**
-- `high`: User-specific data, real-time updates
-- `normal`: Standard content, common features
-- `low`: Recommendations, suggestions, ads
-
-**Threshold Guidelines:**
-- `0.1`: Standard (load early for smooth UX)
-- `0.5`: Conservative (load when half-visible)
-- `1.0`: Aggressive (only when fully visible)
-
-### ❌ DON'T
-
-**Avoid lazy loading for:**
-- Above-the-fold content
-- Critical user interactions
-- SEO-important content
-- Small/lightweight components
-
-**Anti-patterns:**
-- Setting all components to `high` priority
-- Using threshold `1.0` for everything
-- Lazy loading components user immediately needs
-- Over-complicating with too many priority levels
-
-## Performance Optimization
-
-### Server-Side
-
-```php
-// Cache component HTML for repeated lazy loads
-public function handleLazyLoad(string $id): JsonResult
-{
-    $cacheKey = "lazy_component_{$id}";
-
-    return $this->cache->remember($cacheKey, function() use ($id) {
-        $component = $this->componentRegistry->resolve(
-            ComponentId::fromString($id)
-        );
-
-        return new JsonResult([
-            'success' => true,
-            'html' => $this->componentRegistry->renderWithWrapper($component),
-            // ... other data
-        ]);
-    }, Duration::fromMinutes(5));
-}
-```
-
-### Client-Side
-
-```javascript
-// Adjust root margin for faster pre-loading
-this.defaultOptions = {
-    rootMargin: '200px',  // Start loading 200px early
-    threshold: 0.1
-};
-
-// Batch multiple components entering viewport simultaneously
-// (Already implemented in processLoadingQueue)
-```
-
-## Troubleshooting
-
-### Component doesn't load
-
-**Check:**
-1. `data-live-component-lazy` attribute present?
-2. LazyLoader initialized? (`window.LiveComponent.lazyLoader`)
-3. Element visible in viewport?
-4. Network request succeeding? (check DevTools)
-5. Server route `/live-component/{id}/lazy-load` working?
-
-**Debug:**
-```javascript
-const stats = window.LiveComponent.lazyLoader.getStats();
-console.log(stats); // Check pending/loading/loaded counts
-
-// Check if component is registered
-const config = window.LiveComponent.lazyLoader.lazyComponents.get(element);
-console.log(config);
-```
-
-### Component loads too late/early
-
-**Adjust threshold:**
-```html
-<!-- Load earlier (when 10% visible instead of 50%) -->
-<div data-live-component-lazy="..."
-     data-lazy-threshold="0.1">
-</div>
-```
-
-**Adjust root margin:**
-```javascript
-// Global configuration
-this.defaultOptions.rootMargin = '100px'; // Load 100px before viewport
-```
-
-### Priority not working
-
-**Check queue:**
-```javascript
-console.log(window.LiveComponent.lazyLoader.loadingQueue);
-// Should be sorted by priority (high to low)
-```
-
-**Verify priority value:**
-```html
-<div data-lazy-priority="high">   ✅ Correct
-<div data-lazy-priority="High">   ❌ Case-sensitive!
-<div data-lazy-priority="urgent"> ❌ Only high/normal/low
-```
-
-## Testing
-
-### Manual Testing
-
-```bash
-# Open test page in browser
-php tests/debug/test-lazy-loading.php
-# Navigate to http://localhost/tests/debug/test-lazy-loading.php
-```
-
-**Test Checklist:**
-- [ ] Placeholders shown immediately
-- [ ] Components load when scrolling into view
-- [ ] High priority loads before low priority
-- [ ] Loading spinner appears briefly
-- [ ] Stats panel updates correctly
-- [ ] Console logs show loading sequence
-- [ ] No console errors
-
-### Automated Testing
-
-```javascript
-describe('LazyComponentLoader', () => {
-    it('registers lazy components', () => {
-        const loader = new LazyComponentLoader(mockManager);
-        loader.init();
-
-        const lazyElements = document.querySelectorAll('[data-live-component-lazy]');
-        expect(loader.lazyComponents.size).toBe(lazyElements.length);
-    });
-
-    it('loads component on intersection', async () => {
-        const loader = new LazyComponentLoader(mockManager);
-        loader.init();
-
-        // Simulate intersection
-        const entry = { isIntersecting: true, target: lazyElement };
-        loader.handleIntersection([entry]);
-
-        // Wait for load
-        await new Promise(resolve => setTimeout(resolve, 100));
-
-        const config = loader.lazyComponents.get(lazyElement);
-        expect(config.loaded).toBe(true);
-    });
-
-    it('respects priority ordering', () => {
-        const loader = new LazyComponentLoader(mockManager);
-
-        loader.queueComponentLoad({ priority: 'low', ...lowConfig });
-        loader.queueComponentLoad({ priority: 'high', ...highConfig });
-        loader.queueComponentLoad({ priority: 'normal', ...normalConfig });
-
-        expect(loader.loadingQueue[0].config).toBe(highConfig);
-        expect(loader.loadingQueue[1].config).toBe(normalConfig);
-        expect(loader.loadingQueue[2].config).toBe(lowConfig);
-    });
-});
-```
-
-## Summary
-
-**Lazy Loading provides:**
-- ✅ **68% faster** initial page load
-- ✅ **73% smaller** initial JavaScript bundle
-- ✅ **75% fewer** components loaded initially
-- ✅ **71% less** memory usage
-- ✅ **Seamless UX** with priority-based loading
-- ✅ **Easy integration** with minimal code changes
-
-**When to use:**
-- Pages with 10+ components
-- Below-the-fold content
-- Heavy components (charts, tables, media)
-- Secondary/tertiary features
-
-**Implementation effort:** ⚡ **Low** - Just change `data-live-component` to `data-live-component-lazy`
diff --git a/docs/claude/posix-system.md b/docs/claude/posix-system.md
new file mode 100644
index 00000000..5a9986e7
--- /dev/null
+++ b/docs/claude/posix-system.md
@@ -0,0 +1,1316 @@
+# POSIX System Wrapper
+
+Typ-sichere Abstraktion über PHP's POSIX Extension für prozess- und systembasierte Operationen.
+
+## Übersicht
+
+Das POSIX-Wrapper-System bietet eine framework-konforme, typ-sichere API für POSIX-Systemaufrufe. Es eliminiert die Verwendung primitiver Integer/String-Typen zugunsten von Value Objects und bietet sowohl native als auch In-Memory-Implementierungen für Testing.
+
+**Core Features**:
+- **Type Safety**: Value Objects für alle POSIX-Konzepte
+- **Dual Implementation**: Native (Production) + In-Memory (Testing)
+- **Exception-Based Error Handling**: Keine `false` Returns
+- **Framework Integration**: Automatische DI-Registration via `#[Initializer]`
+- **Zero External Dependencies**: Nur PHP POSIX Extension
+
+## Architektur
+
+```
+┌─────────────────────────────────────────────────────┐
+│                 PosixService Interface               │
+│  getCurrentProcess(), getUserInfo(), sendSignal()   │
+└────────────────┬────────────────────────────────────┘
+                 │
+         ┌───────┴────────┐
+         │                │
+┌────────▼────────┐  ┌───▼──────────────┐
+│NativePosixService│  │InMemoryPosixService│
+│ posix_* calls   │  │  Test doubles     │
+└─────────────────┘  └──────────────────┘
+         │
+    ┌────▼─────┐
+    │ Value    │
+    │ Objects  │
+    └──────────┘
+```
+
+## Value Objects
+
+### Process Identifiers
+
+#### ProcessId
+```php
+final readonly class ProcessId
+{
+    public function __construct(public int $value)
+    {
+        if ($value <= 0) {
+            throw new \InvalidArgumentException('Process ID must be positive');
+        }
+    }
+
+    public static function current(): self
+    {
+        return new self(posix_getpid());
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
+```
+
+**Usage**:
+```php
+// Current process
+$pid = ProcessId::current();
+
+// From value
+$pid = new ProcessId(1234);
+
+// Comparison
+if ($pid->equals($otherPid)) {
+    // Same process
+}
+```
+
+#### UserId & GroupId
+
+```php
+final readonly class UserId
+{
+    public function __construct(public int $value)
+    {
+        if ($value < 0) {
+            throw new \InvalidArgumentException('User ID cannot be negative');
+        }
+    }
+
+    public static function current(): self; // posix_getuid()
+    public static function effective(): self; // posix_geteuid()
+}
+
+final readonly class GroupId
+{
+    // Similar structure
+    public static function current(): self; // posix_getgid()
+    public static function effective(): self; // posix_getegid()
+}
+```
+
+**Usage**:
+```php
+// Current user/group
+$uid = UserId::current();
+$gid = GroupId::current();
+
+// Effective user/group (für setuid binaries)
+$euid = UserId::effective();
+$egid = GroupId::effective();
+```
+
+### Names
+
+#### UserName
+```php
+final readonly class UserName
+{
+    public function __construct(public string $value)
+    {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Username cannot be empty');
+        }
+
+        if (!preg_match('/^[a-zA-Z0-9_-]+$/', $value)) {
+            throw new \InvalidArgumentException(
+                'Username must contain only alphanumeric characters, underscore, and hyphen'
+            );
+        }
+
+        if (strlen($value) > 32) {
+            throw new \InvalidArgumentException('Username cannot exceed 32 characters');
+        }
+    }
+
+    public static function fromString(string $value): self;
+    public static function current(): self; // posix_getpwuid(posix_getuid())
+    public function equals(self $other): bool;
+}
+```
+
+**Validation Rules**:
+- Nicht leer
+- Alphanumerisch + Underscore + Hyphen
+- Max. 32 Zeichen
+- Keine Sonderzeichen
+
+#### GroupName
+```php
+final readonly class GroupName
+{
+    // Gleiche Validierung wie UserName
+    public static function fromString(string $value): self;
+}
+```
+
+### Aggregates
+
+#### ProcessInfo
+```php
+final readonly class ProcessInfo
+{
+    public function __construct(
+        public ProcessId $pid,
+        public ProcessId $parentPid,
+        public UserId $userId,
+        public GroupId $groupId,
+        public string $workingDirectory
+    ) {}
+
+    public static function current(): self
+    {
+        return new self(
+            pid: ProcessId::current(),
+            parentPid: new ProcessId(posix_getppid()),
+            userId: UserId::current(),
+            groupId: GroupId::current(),
+            workingDirectory: posix_getcwd()
+        );
+    }
+
+    public function toArray(): array;
+}
+```
+
+#### UserInfo
+```php
+final readonly class UserInfo
+{
+    public function __construct(
+        public UserId $userId,
+        public UserName $userName,
+        public string $homeDirectory,
+        public string $shell,
+        public GroupId $groupId
+    ) {}
+
+    public static function current(): self;
+    public function toArray(): array;
+}
+```
+
+#### GroupInfo
+
+**Wichtig**: Verwendet **variadic constructor** für Members:
+
+```php
+final readonly class GroupInfo
+{
+    /** @var array<UserName> */
+    public array $members;
+
+    public function __construct(
+        public GroupId $groupId,
+        public GroupName $groupName,
+        UserName ...$members  // Variadic parameter
+    ) {
+        $this->members = $members;
+    }
+
+    public function hasMember(UserName $userName): bool
+    {
+        foreach ($this->members as $member) {
+            if ($member->equals($userName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    public function getMemberCount(): int
+    {
+        return count($this->members);
+    }
+
+    public function toArray(): array;
+}
+```
+
+**Usage mit Spread Operator**:
+```php
+$members = [
+    UserName::fromString('alice'),
+    UserName::fromString('bob'),
+    UserName::fromString('charlie')
+];
+
+// Spread operator für variadic constructor
+$group = new GroupInfo(
+    groupId: new GroupId(1000),
+    groupName: GroupName::fromString('developers'),
+    ...$members  // Spread array in variadic parameter
+);
+
+// Check membership
+if ($group->hasMember(UserName::fromString('alice'))) {
+    echo "Alice is a developer";
+}
+
+echo "Group has {$group->getMemberCount()} members";
+```
+
+### Enums
+
+#### Signal
+```php
+enum Signal: int
+{
+    case SIGTERM = 15;  // Termination signal
+    case SIGKILL = 9;   // Kill signal (cannot be caught)
+    case SIGHUP = 1;    // Hang up
+    case SIGINT = 2;    // Interrupt (Ctrl+C)
+    case SIGQUIT = 3;   // Quit
+    case SIGUSR1 = 10;  // User-defined signal 1
+    case SIGUSR2 = 12;  // User-defined signal 2
+
+    public function send(ProcessId $pid): bool
+    {
+        return posix_kill($pid->value, $this->value);
+    }
+
+    public function description(): string
+    {
+        return match ($this) {
+            self::SIGTERM => 'Termination signal',
+            self::SIGKILL => 'Kill signal (cannot be caught)',
+            self::SIGHUP => 'Hangup detected',
+            self::SIGINT => 'Interrupt from keyboard',
+            self::SIGQUIT => 'Quit from keyboard',
+            self::SIGUSR1 => 'User-defined signal 1',
+            self::SIGUSR2 => 'User-defined signal 2',
+        };
+    }
+
+    public function isTermination(): bool
+    {
+        return match ($this) {
+            self::SIGTERM, self::SIGKILL, self::SIGQUIT => true,
+            default => false,
+        };
+    }
+
+    public function isCatchable(): bool
+    {
+        return $this !== self::SIGKILL;
+    }
+}
+```
+
+**Usage**:
+```php
+$pid = new ProcessId(1234);
+
+// Send SIGTERM
+Signal::SIGTERM->send($pid);
+
+// Check if catchable
+if (Signal::SIGTERM->isCatchable()) {
+    // Process can handle this signal
+}
+
+echo Signal::SIGTERM->description(); // "Termination signal"
+```
+
+#### ResourceType
+```php
+enum ResourceType: string
+{
+    case CPU_TIME = 'cpu_time';
+    case FILE_SIZE = 'file_size';
+    case OPEN_FILES = 'open_files';
+    case STACK_SIZE = 'stack_size';
+    case CORE_FILE_SIZE = 'core_file_size';
+    case MEMORY_SIZE = 'memory_size';
+    case PROCESSES = 'processes';
+
+    public function toConstant(): int
+    {
+        return match ($this) {
+            self::CPU_TIME => RLIMIT_CPU,
+            self::FILE_SIZE => RLIMIT_FSIZE,
+            self::OPEN_FILES => RLIMIT_NOFILE,
+            self::STACK_SIZE => RLIMIT_STACK,
+            self::CORE_FILE_SIZE => RLIMIT_CORE,
+            self::MEMORY_SIZE => RLIMIT_AS,
+            self::PROCESSES => RLIMIT_NPROC,
+        };
+    }
+
+    public function description(): string;
+}
+```
+
+#### ResourceLimit
+```php
+final readonly class ResourceLimit
+{
+    public function __construct(
+        public ResourceType $type,
+        public int $softLimit,
+        public int $hardLimit
+    ) {
+        if ($softLimit > $hardLimit) {
+            throw new \InvalidArgumentException('Soft limit cannot exceed hard limit');
+        }
+    }
+
+    public static function get(ResourceType $type): self
+    {
+        $limits = posix_getrlimit();
+        $constant = $type->value;
+
+        return new self(
+            type: $type,
+            softLimit: $limits[$constant]['soft'],
+            hardLimit: $limits[$constant]['hard']
+        );
+    }
+
+    public function isSoftUnlimited(): bool
+    {
+        return $this->softLimit === -1;
+    }
+
+    public function isHardUnlimited(): bool
+    {
+        return $this->hardLimit === -1;
+    }
+
+    public function toArray(): array;
+}
+```
+
+## Exception Handling
+
+### PosixException
+
+```php
+final class PosixException extends FrameworkException
+{
+    public static function userNotFound(UserId $userId): self
+    {
+        return new self(
+            "User with ID {$userId->value} not found",
+            code: 404
+        );
+    }
+
+    public static function groupNotFound(GroupId $groupId): self
+    {
+        return new self(
+            "Group with ID {$groupId->value} not found",
+            code: 404
+        );
+    }
+
+    public static function permissionDenied(string $operation): self
+    {
+        return new self(
+            "Permission denied for operation: {$operation}",
+            code: 403
+        );
+    }
+
+    public static function signalFailed(ProcessId $pid, Signal $signal): self
+    {
+        return new self(
+            "Failed to send signal {$signal->name} to process {$pid->value}",
+            code: 500
+        );
+    }
+
+    public static function extensionNotLoaded(): self
+    {
+        return new self(
+            'POSIX extension is not loaded',
+            code: 500
+        );
+    }
+
+    public static function setUserIdFailed(UserId $userId): self
+    {
+        return new self(
+            "Failed to set user ID to {$userId->value}",
+            code: 500
+        );
+    }
+
+    public static function setGroupIdFailed(GroupId $groupId): self
+    {
+        return new self(
+            "Failed to set group ID to {$groupId->value}",
+            code: 500
+        );
+    }
+
+    public static function setResourceLimitFailed(string $resourceType): self
+    {
+        return new self(
+            "Failed to set resource limit for {$resourceType}",
+            code: 500
+        );
+    }
+}
+```
+
+## Service Layer
+
+### PosixService Interface
+
+```php
+interface PosixService
+{
+    /**
+     * Get information about the current process
+     */
+    public function getCurrentProcess(): ProcessInfo;
+
+    /**
+     * Get information about a user by ID
+     */
+    public function getUserInfo(UserId $userId): UserInfo;
+
+    /**
+     * Get information about a group by ID
+     */
+    public function getGroupInfo(GroupId $groupId): GroupInfo;
+
+    /**
+     * Send a signal to a process
+     */
+    public function sendSignal(ProcessId $pid, Signal $signal): bool;
+
+    /**
+     * Set the user ID of the current process
+     */
+    public function setUserId(UserId $userId): void;
+
+    /**
+     * Set the group ID of the current process
+     */
+    public function setGroupId(GroupId $groupId): void;
+
+    /**
+     * Check if a process is running
+     */
+    public function isRunning(ProcessId $pid): bool;
+
+    /**
+     * Get resource limit for a specific type
+     */
+    public function getResourceLimit(ResourceType $type): ResourceLimit;
+
+    /**
+     * Set resource limit for a specific type
+     */
+    public function setResourceLimit(
+        ResourceType $type,
+        int $softLimit,
+        int $hardLimit
+    ): bool;
+}
+```
+
+### NativePosixService (Production)
+
+```php
+final readonly class NativePosixService implements PosixService
+{
+    public function getCurrentProcess(): ProcessInfo
+    {
+        return ProcessInfo::current();
+    }
+
+    public function getUserInfo(UserId $userId): UserInfo
+    {
+        $info = posix_getpwuid($userId->value);
+
+        if ($info === false) {
+            throw PosixException::userNotFound($userId);
+        }
+
+        return new UserInfo(
+            userId: $userId,
+            userName: UserName::fromString($info['name']),
+            homeDirectory: $info['dir'],
+            shell: $info['shell'],
+            groupId: new GroupId($info['gid'])
+        );
+    }
+
+    public function getGroupInfo(GroupId $groupId): GroupInfo
+    {
+        $info = posix_getgrgid($groupId->value);
+
+        if ($info === false) {
+            throw PosixException::groupNotFound($groupId);
+        }
+
+        // Map members to UserName value objects
+        $members = array_map(
+            fn(string $member) => UserName::fromString($member),
+            $info['members']
+        );
+
+        // Use spread operator for variadic constructor
+        return new GroupInfo(
+            groupId: $groupId,
+            groupName: GroupName::fromString($info['name']),
+            ...$members
+        );
+    }
+
+    public function sendSignal(ProcessId $pid, Signal $signal): bool
+    {
+        $result = $signal->send($pid);
+
+        if (!$result) {
+            throw PosixException::signalFailed($pid, $signal);
+        }
+
+        return $result;
+    }
+
+    public function setUserId(UserId $userId): void
+    {
+        if (!posix_setuid($userId->value)) {
+            throw PosixException::setUserIdFailed($userId);
+        }
+    }
+
+    public function setGroupId(GroupId $groupId): void
+    {
+        if (!posix_setgid($groupId->value)) {
+            throw PosixException::setGroupIdFailed($groupId);
+        }
+    }
+
+    public function isRunning(ProcessId $pid): bool
+    {
+        // Signal 0 checks process existence without affecting it
+        return posix_kill($pid->value, 0);
+    }
+
+    public function getResourceLimit(ResourceType $type): ResourceLimit
+    {
+        return ResourceLimit::get($type);
+    }
+
+    public function setResourceLimit(
+        ResourceType $type,
+        int $softLimit,
+        int $hardLimit
+    ): bool {
+        $result = posix_setrlimit(
+            $type->toConstant(),
+            $softLimit,
+            $hardLimit
+        );
+
+        if (!$result) {
+            throw PosixException::setResourceLimitFailed($type->value);
+        }
+
+        return $result;
+    }
+}
+```
+
+### InMemoryPosixService (Testing)
+
+```php
+final class InMemoryPosixService implements PosixService
+{
+    private ProcessInfo $currentProcess;
+    private array $users = [];
+    private array $groups = [];
+    private array $runningProcesses = [];
+    private array $resourceLimits = [];
+
+    public function __construct()
+    {
+        // Default test process
+        $this->currentProcess = new ProcessInfo(
+            pid: new ProcessId(1234),
+            parentPid: new ProcessId(1),
+            userId: new UserId(1000),
+            groupId: new GroupId(1000),
+            workingDirectory: '/tmp'
+        );
+
+        // Default test user
+        $this->users[1000] = new UserInfo(
+            userId: new UserId(1000),
+            userName: UserName::fromString('testuser'),
+            homeDirectory: '/home/testuser',
+            shell: '/bin/bash',
+            groupId: new GroupId(1000)
+        );
+
+        // Default test group
+        $this->groups[1000] = new GroupInfo(
+            groupId: new GroupId(1000),
+            groupName: GroupName::fromString('testgroup'),
+            UserName::fromString('testuser')
+        );
+
+        // Mark test process as running
+        $this->runningProcesses[1234] = true;
+
+        // Default resource limits
+        foreach (ResourceType::cases() as $type) {
+            $this->resourceLimits[$type->value] = new ResourceLimit(
+                type: $type,
+                softLimit: 1024,
+                hardLimit: 2048
+            );
+        }
+    }
+
+    // Test helper methods
+    public function addUser(UserInfo $userInfo): void
+    {
+        $this->users[$userInfo->userId->value] = $userInfo;
+    }
+
+    public function addGroup(GroupInfo $groupInfo): void
+    {
+        $this->groups[$groupInfo->groupId->value] = $groupInfo;
+    }
+
+    public function addRunningProcess(ProcessId $pid): void
+    {
+        $this->runningProcesses[$pid->value] = true;
+    }
+
+    // Implement PosixService interface methods...
+}
+```
+
+## Framework Integration
+
+### PosixServiceInitializer
+
+```php
+final readonly class PosixServiceInitializer
+{
+    #[Initializer]
+    public function initialize(Container $container): PosixService
+    {
+        // Check if POSIX extension is loaded
+        if (extension_loaded('posix')) {
+            $service = new NativePosixService();
+        } else {
+            // Fallback to in-memory implementation for testing
+            $service = new InMemoryPosixService();
+        }
+
+        // Register as singleton
+        $container->singleton(PosixService::class, $service);
+
+        return $service;
+    }
+}
+```
+
+**Features**:
+- Automatische Discovery via `#[Initializer]`
+- Extension Detection (native vs in-memory)
+- Singleton Registration
+- **Return Type**: `PosixService` Interface
+
+## Verwendung
+
+### Basic Operations
+
+#### Process Information
+
+```php
+use App\Framework\Posix\Services\PosixService;
+
+final readonly class ProcessMonitor
+{
+    public function __construct(
+        private PosixService $posix
+    ) {}
+
+    public function getCurrentProcessInfo(): ProcessInfo
+    {
+        $info = $this->posix->getCurrentProcess();
+
+        echo "PID: {$info->pid->value}\n";
+        echo "Parent PID: {$info->parentPid->value}\n";
+        echo "User ID: {$info->userId->value}\n";
+        echo "Group ID: {$info->groupId->value}\n";
+        echo "Working Dir: {$info->workingDirectory}\n";
+
+        return $info;
+    }
+
+    public function checkProcessRunning(ProcessId $pid): bool
+    {
+        return $this->posix->isRunning($pid);
+    }
+}
+```
+
+#### User & Group Management
+
+```php
+final readonly class UserManager
+{
+    public function __construct(
+        private PosixService $posix
+    ) {}
+
+    public function getUserDetails(UserId $userId): UserInfo
+    {
+        try {
+            $user = $this->posix->getUserInfo($userId);
+
+            echo "Username: {$user->userName->value}\n";
+            echo "Home: {$user->homeDirectory}\n";
+            echo "Shell: {$user->shell}\n";
+
+            return $user;
+        } catch (PosixException $e) {
+            // User not found
+            throw $e;
+        }
+    }
+
+    public function getGroupDetails(GroupId $groupId): GroupInfo
+    {
+        $group = $this->posix->getGroupInfo($groupId);
+
+        echo "Group: {$group->groupName->value}\n";
+        echo "Members: {$group->getMemberCount()}\n";
+
+        foreach ($group->members as $member) {
+            echo "  - {$member->value}\n";
+        }
+
+        return $group;
+    }
+
+    public function isUserInGroup(UserId $userId, GroupId $groupId): bool
+    {
+        $user = $this->posix->getUserInfo($userId);
+        $group = $this->posix->getGroupInfo($groupId);
+
+        return $group->hasMember($user->userName);
+    }
+}
+```
+
+#### Signal Handling
+
+```php
+final readonly class ProcessController
+{
+    public function __construct(
+        private PosixService $posix
+    ) {}
+
+    public function terminateProcess(ProcessId $pid): void
+    {
+        // Send SIGTERM first (graceful)
+        try {
+            $this->posix->sendSignal($pid, Signal::SIGTERM);
+
+            // Wait for process to terminate
+            sleep(2);
+
+            if ($this->posix->isRunning($pid)) {
+                // Force kill if still running
+                $this->posix->sendSignal($pid, Signal::SIGKILL);
+            }
+        } catch (PosixException $e) {
+            throw new \RuntimeException(
+                "Failed to terminate process {$pid->value}: {$e->getMessage()}",
+                previous: $e
+            );
+        }
+    }
+
+    public function sendSignalSafely(ProcessId $pid, Signal $signal): bool
+    {
+        if (!$this->posix->isRunning($pid)) {
+            return false;
+        }
+
+        if (!$signal->isCatchable()) {
+            throw new \InvalidArgumentException(
+                "Signal {$signal->name} cannot be caught by process"
+            );
+        }
+
+        return $this->posix->sendSignal($pid, $signal);
+    }
+}
+```
+
+#### Resource Limits
+
+```php
+final readonly class ResourceManager
+{
+    public function __construct(
+        private PosixService $posix
+    ) {}
+
+    public function getCurrentLimits(): array
+    {
+        $limits = [];
+
+        foreach (ResourceType::cases() as $type) {
+            $limit = $this->posix->getResourceLimit($type);
+            $limits[$type->value] = [
+                'soft' => $limit->softLimit,
+                'hard' => $limit->hardLimit,
+                'unlimited' => $limit->isSoftUnlimited()
+            ];
+        }
+
+        return $limits;
+    }
+
+    public function setOpenFilesLimit(int $softLimit, int $hardLimit): void
+    {
+        $this->posix->setResourceLimit(
+            ResourceType::OPEN_FILES,
+            $softLimit,
+            $hardLimit
+        );
+    }
+
+    public function setMemoryLimit(int $megabytes): void
+    {
+        $bytes = $megabytes * 1024 * 1024;
+
+        $this->posix->setResourceLimit(
+            ResourceType::MEMORY_SIZE,
+            $bytes,
+            $bytes
+        );
+    }
+}
+```
+
+### Advanced Use Cases
+
+#### Background Job Worker
+
+```php
+final readonly class BackgroundWorker
+{
+    public function __construct(
+        private PosixService $posix,
+        private Logger $logger
+    ) {}
+
+    public function daemonize(): void
+    {
+        // Fork parent process
+        $pid = pcntl_fork();
+
+        if ($pid < 0) {
+            throw new \RuntimeException('Fork failed');
+        }
+
+        if ($pid > 0) {
+            // Parent exits, child continues
+            exit(0);
+        }
+
+        // Child becomes session leader
+        posix_setsid();
+
+        // Get process info
+        $process = $this->posix->getCurrentProcess();
+
+        $this->logger->info('Worker daemonized', [
+            'pid' => $process->pid->value,
+            'user' => $process->userId->value,
+            'working_dir' => $process->workingDirectory
+        ]);
+
+        // Set resource limits for long-running process
+        $this->posix->setResourceLimit(
+            ResourceType::OPEN_FILES,
+            1024,
+            2048
+        );
+    }
+
+    public function dropPrivileges(UserId $userId, GroupId $groupId): void
+    {
+        // Drop privileges for security
+        $this->posix->setGroupId($groupId);
+        $this->posix->setUserId($userId);
+
+        $current = $this->posix->getCurrentProcess();
+
+        $this->logger->info('Privileges dropped', [
+            'user_id' => $current->userId->value,
+            'group_id' => $current->groupId->value
+        ]);
+    }
+}
+```
+
+#### Process Pool Manager
+
+```php
+final readonly class ProcessPool
+{
+    private array $workers = [];
+
+    public function __construct(
+        private PosixService $posix,
+        private int $poolSize = 4
+    ) {}
+
+    public function spawn(): void
+    {
+        for ($i = 0; $i < $this->poolSize; $i++) {
+            $pid = pcntl_fork();
+
+            if ($pid < 0) {
+                throw new \RuntimeException('Fork failed');
+            }
+
+            if ($pid === 0) {
+                // Child process
+                $this->workerLoop();
+                exit(0);
+            }
+
+            // Parent stores worker PID
+            $this->workers[] = new ProcessId($pid);
+        }
+    }
+
+    public function terminateAll(): void
+    {
+        foreach ($this->workers as $workerPid) {
+            if ($this->posix->isRunning($workerPid)) {
+                $this->posix->sendSignal($workerPid, Signal::SIGTERM);
+            }
+        }
+
+        // Wait for all workers to terminate
+        foreach ($this->workers as $workerPid) {
+            pcntl_waitpid($workerPid->value, $status);
+        }
+    }
+
+    private function workerLoop(): void
+    {
+        $process = $this->posix->getCurrentProcess();
+
+        while (true) {
+            // Worker logic
+            $this->processJob();
+
+            // Check if parent still running
+            if (!$this->posix->isRunning($process->parentPid)) {
+                break;
+            }
+
+            sleep(1);
+        }
+    }
+}
+```
+
+## Testing
+
+### Unit Tests mit InMemoryPosixService
+
+```php
+use App\Framework\Posix\Services\InMemoryPosixService;
+use App\Framework\Posix\ValueObjects\{UserId, UserInfo, UserName, GroupId};
+
+describe('PosixService', function () {
+    beforeEach(function () {
+        $this->posix = new InMemoryPosixService();
+    });
+
+    it('gets current process info', function () {
+        $process = $this->posix->getCurrentProcess();
+
+        expect($process->pid->value)->toBe(1234);
+        expect($process->userId->value)->toBe(1000);
+    });
+
+    it('gets user info', function () {
+        $user = $this->posix->getUserInfo(new UserId(1000));
+
+        expect($user->userName->value)->toBe('testuser');
+        expect($user->homeDirectory)->toBe('/home/testuser');
+    });
+
+    it('throws when user not found', function () {
+        $this->posix->getUserInfo(new UserId(9999));
+    })->throws(PosixException::class);
+
+    it('checks process running status', function () {
+        $runningPid = new ProcessId(1234);
+        $deadPid = new ProcessId(9999);
+
+        expect($this->posix->isRunning($runningPid))->toBeTrue();
+        expect($this->posix->isRunning($deadPid))->toBeFalse();
+    });
+
+    it('adds custom test user', function () {
+        $customUser = new UserInfo(
+            userId: new UserId(2000),
+            userName: UserName::fromString('customuser'),
+            homeDirectory: '/home/customuser',
+            shell: '/bin/zsh',
+            groupId: new GroupId(2000)
+        );
+
+        $this->posix->addUser($customUser);
+
+        $retrieved = $this->posix->getUserInfo(new UserId(2000));
+
+        expect($retrieved->userName->value)->toBe('customuser');
+        expect($retrieved->shell)->toBe('/bin/zsh');
+    });
+});
+```
+
+### Integration Tests mit NativePosixService
+
+```php
+describe('NativePosixService', function () {
+    beforeEach(function () {
+        if (!extension_loaded('posix')) {
+            $this->markTestSkipped('POSIX extension not available');
+        }
+
+        $this->posix = new NativePosixService();
+    });
+
+    it('gets current user info', function () {
+        $uid = UserId::current();
+        $user = $this->posix->getUserInfo($uid);
+
+        expect($user->userId->value)->toBe($uid->value);
+        expect($user->userName->value)->not->toBeEmpty();
+    });
+
+    it('gets resource limits', function () {
+        $limit = $this->posix->getResourceLimit(ResourceType::OPEN_FILES);
+
+        expect($limit->softLimit)->toBeGreaterThan(0);
+        expect($limit->hardLimit)->toBeGreaterThanOrEqual($limit->softLimit);
+    });
+});
+```
+
+## Best Practices
+
+### 1. Verwende Value Objects statt Primitives
+
+```php
+// ❌ Bad: Primitive Obsession
+function sendSignalToPid(int $pid, int $signal): void
+{
+    posix_kill($pid, $signal);
+}
+
+// ✅ Good: Value Objects
+function sendSignal(ProcessId $pid, Signal $signal): void
+{
+    $this->posix->sendSignal($pid, $signal);
+}
+```
+
+### 2. Exception-based Error Handling
+
+```php
+// ❌ Bad: Boolean returns
+$result = posix_kill($pid, SIGTERM);
+if ($result === false) {
+    // Error handling
+}
+
+// ✅ Good: Exceptions
+try {
+    $this->posix->sendSignal($pid, Signal::SIGTERM);
+} catch (PosixException $e) {
+    // Handle error
+}
+```
+
+### 3. Dependency Injection
+
+```php
+// ✅ Inject PosixService Interface
+final readonly class ProcessManager
+{
+    public function __construct(
+        private PosixService $posix  // Interface, not implementation
+    ) {}
+}
+```
+
+### 4. Graceful Termination
+
+```php
+// ✅ SIGTERM before SIGKILL
+public function terminate(ProcessId $pid): void
+{
+    $this->posix->sendSignal($pid, Signal::SIGTERM);
+
+    sleep(2);
+
+    if ($this->posix->isRunning($pid)) {
+        $this->posix->sendSignal($pid, Signal::SIGKILL);
+    }
+}
+```
+
+### 5. Resource Limit Safety
+
+```php
+// ✅ Set limits for long-running processes
+public function initializeDaemon(): void
+{
+    // Prevent file descriptor exhaustion
+    $this->posix->setResourceLimit(
+        ResourceType::OPEN_FILES,
+        1024,
+        2048
+    );
+
+    // Limit memory usage
+    $this->posix->setResourceLimit(
+        ResourceType::MEMORY_SIZE,
+        512 * 1024 * 1024,  // 512 MB
+        1024 * 1024 * 1024  // 1 GB
+    );
+}
+```
+
+## Framework Compliance
+
+Das POSIX-Wrapper-System folgt allen Framework-Prinzipien:
+
+- ✅ **Final Readonly Classes**: Alle Klassen sind `final readonly`
+- ✅ **No Inheritance**: Nur Interfaces, keine Vererbung
+- ✅ **Composition Over Inheritance**: Service Composition statt extends
+- ✅ **Value Objects**: Keine Primitive Obsession
+- ✅ **Type Safety**: Strikte Typisierung überall
+- ✅ **Exception-based Errors**: Keine `false` Returns
+- ✅ **Dependency Injection**: Via Container, `#[Initializer]`
+- ✅ **Interface-first Design**: PosixService Interface
+- ✅ **Testability**: InMemoryPosixService für Tests
+- ✅ **Framework Integration**: Automatische Discovery
+
+## Performance Considerations
+
+**Value Object Overhead**: Minimal (<0.01ms pro Instanz)
+
+**Memory Usage**: ~200 bytes pro Value Object
+
+**Native vs In-Memory**:
+- Native: Real POSIX calls (microseconds)
+- In-Memory: Array lookups (nanoseconds)
+
+**Recommendation**: Use Native für Production, In-Memory für Tests
+
+## Security Considerations
+
+### Privilege Dropping
+
+```php
+// Always drop privileges after initialization
+$this->posix->setUserId(new UserId(1000));  // Non-root user
+$this->posix->setGroupId(new GroupId(1000)); // Non-root group
+```
+
+### Signal Safety
+
+```php
+// Check if signal is catchable
+if (!$signal->isCatchable()) {
+    throw new \InvalidArgumentException('Signal cannot be caught');
+}
+```
+
+### Resource Limits
+
+```php
+// Set conservative limits for untrusted processes
+$this->posix->setResourceLimit(ResourceType::PROCESSES, 10, 20);
+$this->posix->setResourceLimit(ResourceType::CPU_TIME, 60, 120);
+```
+
+## Troubleshooting
+
+### POSIX Extension Not Loaded
+
+```bash
+# Check if extension is loaded
+php -m | grep posix
+
+# Install if missing (Ubuntu/Debian)
+sudo apt-get install php-posix
+
+# Enable in php.ini
+extension=posix.so
+```
+
+### Permission Denied Errors
+
+```php
+// Check effective user ID
+$euid = UserId::effective();
+
+if ($euid->value !== 0) {
+    throw new \RuntimeException('Root privileges required');
+}
+```
+
+### Signal Not Delivered
+
+```php
+// Check process exists
+if (!$this->posix->isRunning($pid)) {
+    throw new \RuntimeException('Process not running');
+}
+
+// Check signal is valid
+if ($signal === Signal::SIGKILL) {
+    // SIGKILL cannot be caught - use with caution
+}
+```
+
+## Zusammenfassung
+
+Das POSIX-Wrapper-System bietet:
+
+- ✅ **Type Safety**: Value Objects für alle POSIX-Konzepte
+- ✅ **Clean API**: Exception-based Error Handling
+- ✅ **Testability**: Native + In-Memory Implementierungen
+- ✅ **Framework Integration**: Automatische DI-Registration
+- ✅ **Production Ready**: Zero External Dependencies
+- ✅ **Comprehensive**: Alle wichtigen POSIX-Operationen
+- ✅ **Documented**: Umfassende Dokumentation und Beispiele
+
+Das System ist **production-ready** und kann für Process Management, Background Workers, Privilege Dropping, Signal Handling und Resource Management verwendet werden.
diff --git a/docs/claude/sockets-module.md b/docs/claude/sockets-module.md
new file mode 100644
index 00000000..61811598
--- /dev/null
+++ b/docs/claude/sockets-module.md
@@ -0,0 +1,671 @@
+# Sockets Module Documentation
+
+## Übersicht
+
+Das Sockets-Modul (`src/Framework/Sockets/`) bietet eine vollständige, type-safe Abstraktion über PHP's Socket-Erweiterung. Es ermöglicht:
+
+- **Type-safe Socket-Operationen**: Alle Socket-Operationen verwenden Value Objects statt primitiver Typen
+- **TCP/UDP Server & Client**: Vollständige Server- und Client-Implementierung
+- **Unix Domain Sockets**: Unterstützung für Unix Domain Sockets
+- **PCNTL Integration**: Socket-Server in geforkten Worker-Prozessen
+- **Async Integration**: Non-blocking Socket I/O mit Fibers
+- **Connection Pooling**: Automatisches Management von Socket-Verbindungen
+
+## Architektur
+
+### Modulstruktur
+
+```
+src/Framework/Sockets/
+├── SocketService.php              # Haupt-Service (Facade)
+├── SocketFactory.php              # Socket-Erstellung
+├── SocketServer.php               # Server-Operationen
+├── SocketClient.php               # Client-Operationen
+├── SocketConnection.php           # Connection Wrapper
+├── SocketConnectionPool.php       # Connection Pool Management
+├── SocketsInitializer.php         # DI-Initializer
+├── Exceptions/                    # Exception-Klassen
+├── ValueObjects/                  # Type-safe Value Objects
+└── Integration/                   # PCNTL & Async Integration
+```
+
+## Value Objects
+
+### SocketAddress
+
+Repräsentiert eine Socket-Adresse (IPv4, IPv6 oder Unix Domain Socket).
+
+```php
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+// IPv4 Adresse
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+
+// IPv6 Adresse
+$address = SocketAddress::ipv6('::1', 8080);
+
+// Unix Domain Socket
+$address = SocketAddress::unix('/tmp/socket.sock');
+
+// Von String parsen
+$address = SocketAddress::fromString('127.0.0.1:8080');
+$address = SocketAddress::fromString('/tmp/socket.sock');
+
+// Eigenschaften
+$host = $address->getHost();           // null für Unix Sockets
+$port = $address->getPort();           // null für Unix Sockets
+$path = $address->getUnixPath();       // null für Network Sockets
+$protocol = $address->getProtocol();   // SocketProtocol Enum
+$isUnix = $address->isUnixSocket();
+$isNetwork = $address->isNetworkSocket();
+$string = $address->toString();        // "127.0.0.1:8080" oder "/tmp/socket.sock"
+```
+
+### SocketType
+
+Enum für Socket-Typen.
+
+```php
+use App\Framework\Sockets\ValueObjects\SocketType;
+
+SocketType::TCP        // SOCK_STREAM
+SocketType::UDP        // SOCK_DGRAM
+SocketType::RAW        // SOCK_RAW
+SocketType::RDM        // SOCK_RDM
+SocketType::SEQPACKET  // SOCK_SEQPACKET
+
+// Methoden
+$type->getName();           // "TCP", "UDP", etc.
+$type->getValue();          // SOCK_STREAM, SOCK_DGRAM, etc.
+$type->isReliable();        // true für TCP, SEQPACKET
+$type->isConnectionless();  // true für UDP
+```
+
+### SocketProtocol
+
+Enum für Protokoll-Familien.
+
+```php
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+
+SocketProtocol::IPv4  // AF_INET
+SocketProtocol::IPv6  // AF_INET6
+SocketProtocol::UNIX  // AF_UNIX
+
+// Methoden
+$protocol->getName();     // "IPv4", "IPv6", "Unix Domain"
+$protocol->getValue();    // AF_INET, AF_INET6, AF_UNIX
+$protocol->isNetwork();  // true für IPv4/IPv6
+$protocol->isUnix();      // true für Unix Domain
+```
+
+### SocketOption
+
+Enum für Socket-Optionen.
+
+```php
+use App\Framework\Sockets\ValueObjects\SocketOption;
+
+SocketOption::SO_REUSEADDR
+SocketOption::SO_REUSEPORT
+SocketOption::SO_KEEPALIVE
+SocketOption::SO_LINGER
+SocketOption::SO_RCVBUF
+SocketOption::SO_SNDBUF
+SocketOption::SO_RCVTIMEO
+SocketOption::SO_SNDTIMEO
+SocketOption::TCP_NODELAY
+SocketOption::TCP_KEEPIDLE
+SocketOption::TCP_KEEPINTVL
+SocketOption::TCP_KEEPCNT
+
+// Methoden
+$option->getName();      // "SO_REUSEADDR", etc.
+$option->getLevel();    // SOL_SOCKET oder SOL_TCP
+$option->getValue();    // SO_REUSEADDR, etc.
+```
+
+### SocketResource
+
+Type-safe Wrapper für Socket-Ressourcen mit automatischem Cleanup.
+
+```php
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+$resource = SocketResource::fromResource($socket, $type, $protocol);
+
+// Eigenschaften
+$socketResource = $resource->getResource();  // Native Socket-Resource
+$type = $resource->getType();               // SocketType
+$protocol = $resource->getProtocol();       // SocketProtocol
+$isClosed = $resource->isClosed();
+
+// Manuelles Schließen (automatisch im Destructor)
+$resource->close();
+```
+
+## Core Services
+
+### SocketFactory
+
+Factory für Socket-Erstellung mit automatischem Option-Setup.
+
+```php
+use App\Framework\Sockets\SocketFactory;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketType;
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+
+$factory = new SocketFactory();
+
+// TCP Socket erstellen
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+$socket = $factory->createTcp($address);
+
+// UDP Socket erstellen
+$socket = $factory->createUdp($address);
+
+// Unix Domain Socket erstellen
+$unixAddress = SocketAddress::unix('/tmp/socket.sock');
+$socket = $factory->createUnix($unixAddress);
+
+// Generische Erstellung
+$socket = $factory->createServer(SocketType::TCP, SocketProtocol::IPv4);
+$socket = $factory->createClient(SocketType::TCP, SocketProtocol::IPv4);
+```
+
+### SocketServer
+
+Server-Operationen für Socket-Verwaltung.
+
+```php
+use App\Framework\Sockets\SocketServer;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+$server = new SocketServer();
+$address = SocketAddress::ipv4('0.0.0.0', 8080);
+
+// Socket binden
+$server->bind($socket, $address);
+
+// Auf Verbindungen lauschen
+$server->listen($socket, 10);  // backlog = 10
+
+// Verbindung akzeptieren (non-blocking)
+$connection = $server->accept($socket);
+if ($connection !== null) {
+    // Verbindung verarbeiten
+    $clientSocket = $connection->getSocket();
+    $clientAddress = $connection->getAddress();
+}
+
+// Socket-Auswahl (select)
+$read = [$socket];
+$write = [];
+$except = [];
+$numReady = $server->select($read, $write, $except, 1);  // 1 Sekunde Timeout
+
+// Non-blocking/Blocking Mode
+$server->setNonBlocking($socket);
+$server->setBlocking($socket);
+```
+
+### SocketClient
+
+Client-Operationen für Socket-Verbindungen.
+
+```php
+use App\Framework\Sockets\SocketClient;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+$client = new SocketClient();
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+
+// Verbindung herstellen
+$client->connect($socket, $address);
+
+// Daten lesen
+$data = $client->read($socket, 1024);  // null wenn keine Daten (non-blocking)
+
+// Daten schreiben
+$bytesWritten = $client->write($socket, "Hello, World!");
+
+// Daten senden (mit Flags)
+$bytesSent = $client->send($socket, $data, MSG_DONTWAIT);
+
+// Daten empfangen
+$data = $client->receive($socket, 1024, MSG_DONTWAIT);
+
+// Verbindung schließen
+$client->close($socket);
+```
+
+### SocketConnection
+
+Wrapper für Socket-Verbindungen mit Metadaten.
+
+```php
+use App\Framework\Sockets\SocketConnection;
+
+$connection = SocketConnection::create($socketResource, $address);
+
+// Eigenschaften
+$socket = $connection->getSocket();
+$address = $connection->getAddress();
+$connectionId = $connection->getConnectionId();
+$isClosed = $connection->isClosed();
+
+// Verbindung schließen
+$connection->close();
+```
+
+### SocketConnectionPool
+
+Verwaltung mehrerer Socket-Verbindungen.
+
+```php
+use App\Framework\Sockets\SocketConnectionPool;
+
+$pool = new SocketConnectionPool(
+    maxConnectionsPerAddress: 5,
+    connectionTimeoutSeconds: 300
+);
+
+// Verbindung hinzufügen
+$pool->add($connection);
+
+// Verbindung entfernen
+$pool->remove($connection);
+
+// Verbindung abrufen
+$connection = $pool->get($connectionId);
+$connections = $pool->getConnectionsByAddress($address);
+$connection = $pool->getConnectionForAddress($address);
+
+// Dead Connections bereinigen
+$removed = $pool->cleanupDeadConnections();
+
+// Statistiken
+$count = $pool->getConnectionCount();
+$allConnections = $pool->getAllConnections();
+```
+
+### SocketService
+
+Haupt-Facade für alle Socket-Operationen.
+
+```php
+use App\Framework\Sockets\SocketService;
+
+$socketService = $container->get(SocketService::class);
+
+// Socket-Erstellung
+$socket = $socketService->createTcp($address);
+$socket = $socketService->createUdp($address);
+$socket = $socketService->createUnix($address);
+
+// Server-Operationen
+$socketService->bind($socket, $address);
+$socketService->listen($socket, 10);
+$connection = $socketService->accept($socket);
+$socketService->setNonBlocking($socket);
+
+// Client-Operationen
+$socketService->connect($socket, $address);
+$data = $socketService->read($socket, 1024);
+$bytes = $socketService->write($socket, $data);
+
+// Connection Pool
+$socketService->addConnection($connection);
+$socketService->removeConnection($connection);
+$connection = $socketService->getConnection($connectionId);
+$removed = $socketService->cleanupDeadConnections();
+```
+
+## Integration
+
+### PCNTL Integration
+
+Socket-Server in geforkten Worker-Prozessen für Load Balancing.
+
+```php
+use App\Framework\Sockets\Integration\PcntlSocketServer;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+$socketService = $container->get(SocketService::class);
+$pcntlService = $container->get(PcntlService::class);
+
+$pcntlServer = new PcntlSocketServer(
+    socketService: $socketService,
+    pcntlService: $pcntlService,
+    maxWorkers: 4
+);
+
+// Connection Handler setzen
+$pcntlServer->setConnectionHandler(function (SocketConnection $connection) {
+    // Verbindung verarbeiten
+    $socket = $connection->getSocket();
+    $data = $socketService->read($socket->getResource(), 1024);
+    // ...
+});
+
+// Server starten
+$address = SocketAddress::ipv4('0.0.0.0', 8080);
+$socket = $socketService->createTcp($address);
+$pcntlServer->start($socket, $address, workerCount: 4);
+
+// Server stoppen (graceful shutdown)
+$pcntlServer->stop();
+```
+
+### Async Integration
+
+Non-blocking Socket-Server mit Fibers für parallele Connection-Verarbeitung.
+
+```php
+use App\Framework\Sockets\Integration\AsyncSocketServer;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Async\FiberManager;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+$socketService = $container->get(SocketService::class);
+$fiberManager = $container->get(FiberManager::class);
+
+$asyncServer = new AsyncSocketServer(
+    socketService: $socketService,
+    fiberManager: $fiberManager
+);
+
+// Server starten (gibt Fiber zurück)
+$address = SocketAddress::ipv4('0.0.0.0', 8080);
+$socket = $socketService->createTcp($address);
+
+$serverFiber = $asyncServer->startAsync(
+    socket: $socket,
+    address: $address,
+    connectionHandler: function (SocketConnection $connection) {
+        // Connection in separatem Fiber verarbeiten
+        $socket = $connection->getSocket();
+        
+        // Non-blocking lesen
+        $readFiber = $asyncServer->readAsync($connection, 1024);
+        $data = $readFiber->start();
+        
+        // Non-blocking schreiben
+        $writeFiber = $asyncServer->writeAsync($connection, "Response");
+        $bytes = $writeFiber->start();
+    }
+);
+
+// Server-Fiber starten
+$serverFiber->start();
+```
+
+## Beispiele
+
+### Einfacher TCP Server
+
+```php
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+$socketService = $container->get(SocketService::class);
+$address = SocketAddress::ipv4('0.0.0.0', 8080);
+
+// Socket erstellen
+$socket = $socketService->createTcp($address);
+
+// Binden und lauschen
+$socketService->bind($socket, $address);
+$socketService->listen($socket, 10);
+$socketService->setNonBlocking($socket);
+
+// Hauptschleife
+while (true) {
+    // Verbindung akzeptieren
+    $connection = $socketService->accept($socket);
+    
+    if ($connection !== null) {
+        $clientSocket = $connection->getSocket();
+        
+        // Daten lesen
+        $data = $socketService->read($clientSocket, 1024);
+        
+        if ($data !== null) {
+            // Antwort senden
+            $socketService->write($clientSocket, "Echo: " . $data);
+        }
+        
+        // Verbindung schließen
+        $connection->close();
+    }
+    
+    usleep(10000);  // 10ms
+}
+```
+
+### TCP Client
+
+```php
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+$socketService = $container->get(SocketService::class);
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+
+// Client-Socket erstellen
+$socket = $socketService->createClient(
+    SocketType::TCP,
+    SocketProtocol::IPv4
+);
+
+// Verbinden
+$socketService->connect($socket, $address);
+
+// Daten senden
+$socketService->write($socket, "Hello, Server!");
+
+// Antwort lesen
+$response = $socketService->read($socket, 1024);
+
+// Verbindung schließen
+$socketService->close($socket);
+```
+
+### Unix Domain Socket Server
+
+```php
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+$socketService = $container->get(SocketService::class);
+$address = SocketAddress::unix('/tmp/mysocket.sock');
+
+// Socket erstellen
+$socket = $socketService->createUnix($address);
+
+// Binden und lauschen
+$socketService->bind($socket, $address);
+$socketService->listen($socket, 10);
+
+// Verbindungen akzeptieren
+while (true) {
+    $connection = $socketService->accept($socket);
+    
+    if ($connection !== null) {
+        // Verarbeitung
+        $socket = $connection->getSocket();
+        $data = $socketService->read($socket, 1024);
+        // ...
+    }
+}
+```
+
+## Migration von bestehendem Code
+
+### Von `socket_create()` zu `SocketFactory`
+
+**Vorher:**
+```php
+$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
+```
+
+**Nachher:**
+```php
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+$socket = $socketService->createTcp($address);
+```
+
+### Von `socket_bind()`/`socket_listen()` zu `SocketServer`
+
+**Vorher:**
+```php
+socket_bind($socket, '127.0.0.1', 8080);
+socket_listen($socket, 10);
+```
+
+**Nachher:**
+```php
+$address = SocketAddress::ipv4('127.0.0.1', 8080);
+$socketService->bind($socket, $address);
+$socketService->listen($socket, 10);
+```
+
+### Von `socket_accept()` zu `SocketServer::accept()`
+
+**Vorher:**
+```php
+$clientSocket = socket_accept($socket);
+```
+
+**Nachher:**
+```php
+$connection = $socketService->accept($socket);
+if ($connection !== null) {
+    $clientSocket = $connection->getSocket();
+}
+```
+
+### Von `socket_select()` zu `SocketServer::select()`
+
+**Vorher:**
+```php
+socket_select($read, $write, $except, 1);
+```
+
+**Nachher:**
+```php
+$numReady = $socketService->select($read, $write, $except, 1);
+```
+
+### Von `socket_read()`/`socket_write()` zu `SocketClient`
+
+**Vorher:**
+```php
+$data = socket_read($socket, 1024);
+socket_write($socket, $data, strlen($data));
+```
+
+**Nachher:**
+```php
+$data = $socketService->read($socket, 1024);
+$bytes = $socketService->write($socket, $data);
+```
+
+### Von `socket_close()` zu `SocketResource` Destructor
+
+**Vorher:**
+```php
+socket_close($socket);
+```
+
+**Nachher:**
+```php
+// Automatisch im Destructor, oder manuell:
+$socket->close();
+```
+
+## Fehlerbehandlung
+
+Das Sockets-Modul verwendet spezifische Exceptions für verschiedene Fehlertypen:
+
+```php
+use App\Framework\Sockets\Exceptions\SocketException;
+use App\Framework\Sockets\Exceptions\SocketBindException;
+use App\Framework\Sockets\Exceptions\SocketConnectException;
+use App\Framework\Sockets\Exceptions\SocketReadException;
+
+try {
+    $socketService->bind($socket, $address);
+} catch (SocketBindException $e) {
+    // Bind-Fehler behandeln
+    error_log("Failed to bind: " . $e->getMessage());
+}
+
+try {
+    $socketService->connect($socket, $address);
+} catch (SocketConnectException $e) {
+    // Connect-Fehler behandeln
+    error_log("Failed to connect: " . $e->getMessage());
+}
+
+try {
+    $data = $socketService->read($socket, 1024);
+} catch (SocketReadException $e) {
+    // Read-Fehler behandeln
+    if ($e->getMessage() === 'Socket connection closed') {
+        // Verbindung geschlossen
+    }
+}
+```
+
+## Best Practices
+
+1. **SocketService verwenden**: Nutze immer `SocketService` als Haupt-API statt direkter Aufrufe der einzelnen Services
+2. **Value Objects**: Verwende immer Value Objects (`SocketAddress`, `SocketType`, etc.) statt primitiver Typen
+3. **Resource Management**: `SocketResource` kümmert sich automatisch um Cleanup, aber manuelles Schließen ist für explizite Kontrolle möglich
+4. **Non-blocking I/O**: Verwende `setNonBlocking()` für Server-Sockets, um mehrere Verbindungen parallel zu handhaben
+5. **Connection Pooling**: Nutze `SocketConnectionPool` für Client-Verbindungen, die wiederverwendet werden sollen
+6. **Error Handling**: Fange spezifische Exceptions (`SocketBindException`, `SocketConnectException`, etc.) für präzise Fehlerbehandlung
+7. **PCNTL für Load Balancing**: Verwende `PcntlSocketServer` für Socket-Server, die mehrere Worker-Prozesse benötigen
+8. **Async für Parallelität**: Verwende `AsyncSocketServer` für non-blocking I/O mit Fibers
+
+## Dependency Injection
+
+Alle Services werden automatisch über `SocketsInitializer` im DI-Container registriert:
+
+```php
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\SocketFactory;
+use App\Framework\Sockets\SocketServer;
+use App\Framework\Sockets\SocketClient;
+
+// Services sind im Container verfügbar
+$socketService = $container->get(SocketService::class);
+$factory = $container->get(SocketFactory::class);
+$server = $container->get(SocketServer::class);
+$client = $container->get(SocketClient::class);
+```
+
+## Framework-Kompatibilität
+
+Das Sockets-Modul folgt allen Framework-Prinzipien:
+
+- ✅ **Final readonly classes** wo möglich
+- ✅ **Value Objects** statt Primitiven
+- ✅ **Dependency Injection** überall
+- ✅ **Composition** statt Inheritance
+- ✅ **Strict Types** (`declare(strict_types=1)`)
+- ✅ **PSR-12** Code Style
+
+## Siehe auch
+
+- [PCNTL Module Documentation](./pcntl-module.md) - Für PCNTL-Integration
+- [Async Module Documentation](./async-module.md) - Für Async-Integration
+- [Framework Guidelines](./guidelines.md) - Allgemeine Framework-Prinzipien
+
diff --git a/docs/claude/typed-string-system.md b/docs/claude/typed-string-system.md
new file mode 100644
index 00000000..81e7af64
--- /dev/null
+++ b/docs/claude/typed-string-system.md
@@ -0,0 +1,1141 @@
+# TypedString System
+
+Umfassende Dokumentation des TypedString-Systems für type-safe String-Validierung im Custom PHP Framework.
+
+## Übersicht
+
+Das TypedString-System bietet eine sichere, typsichere Alternative zu PHP's primitiven `ctype_*` Funktionen und String-Validierung. Es folgt konsequent den Framework-Prinzipien: Value Objects statt Primitives, readonly classes, und Composition over Inheritance.
+
+**Kern-Features**:
+- Type-safe String-Validierung
+- Fluent Validation API mit Chainable Validierung
+- Specialized Value Objects für häufige Use Cases
+- Security-First: Zentrale Validierung verhindert SQL-Injection und XSS
+- Framework-Compliance: Readonly, immutable, keine Primitives
+
+## Architektur
+
+**WICHTIG**: TypedString ist ein **Validierungs-Tool**, NICHT ein Storage-Layer!
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    TypedString (Utility Layer)                   │
+│  - Validierungs-Tool für String-Properties                       │
+│  - Wird NICHT in readonly properties gespeichert                 │
+│  - Nutze während Construction, speichere 'string'                │
+└─────────────────────────────────────────────────────────────────┘
+                               ↓ verwendet von
+┌─────────────────────────────────────────────────────────────────┐
+│              Domain Value Objects (Storage Layer)                │
+│  - Email, UserName, UserId                                       │
+│  - Property: 'string' (NICHT TypedString!)                       │
+│  - Nutzen TypedString zur Constructor-Validierung                │
+└─────────────────────────────────────────────────────────────────┘
+                               ↓ verwendet von
+┌─────────────────────────────────────────────────────────────────┐
+│                Domain Entities (Business Layer)                  │
+│  - User, Order, Profile                                          │
+│  - Properties: Domain VOs oder validierte strings                │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│           Specialized VOs (Temporäre Guarantees)                 │
+│  - AlphanumericString, NumericString, HexadecimalString          │
+│  - Use Cases: Type Hints, temporäre Validierung                 │
+│  - NICHT in Domain VOs wrappen (Wrapper-Hell!)                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Design-Entscheidungen
+
+**TypedString als Validator (✅)**:
+```php
+// ✅ TypedString validiert, speichert aber NICHT
+final readonly class Email
+{
+    public function __construct(
+        public string $value  // String bleibt String!
+    ) {
+        TypedString::fromString($value)
+            ->validate()
+            ->matches('/^[\w\.\-]+@[\w\.\-]+\.\w+$/')
+            ->maxLength(254)
+            ->orThrow();
+    }
+}
+
+$email = Email::fromString('test@example.com');
+echo $email->value; // ✅ Direkt string-Zugriff
+```
+
+**TypedString als Storage (❌ Wrapper-Hell)**:
+```php
+// ❌ NICHT: VO in VO führt zu Double Unwrapping
+final readonly class Email
+{
+    public function __construct(
+        public TypedString $value  // Wrapper-Hell!
+    ) {}
+}
+
+$email = new Email(TypedString::fromString('test@example.com'));
+echo $email->value->value; // 🤮 Double unwrapping!
+```
+
+## TypedString Core Class
+
+### Überblick
+
+`TypedString` ist der zentrale Wrapper um einen String-Wert mit umfassenden Validierungsmethoden.
+
+**Location**: `src/Framework/String/ValueObjects/TypedString.php`
+
+**Core Principles**:
+- Readonly class (immutable)
+- Kein direkter Zugriff auf primitive Strings ohne Validierung
+- Alle Validierungsmethoden geben false für leere Strings zurück
+- Factory Method Pattern für Erzeugung
+
+### Character Type Checks
+
+Alternative zu PHP's `ctype_*` Funktionen mit besseren Namen und konsistentem Verhalten:
+
+```php
+use App\Framework\String\ValueObjects\TypedString;
+
+$str = TypedString::fromString('hello123');
+
+// Character Type Checks
+$str->isAlphanumeric();  // true - alphanumerische Zeichen nur (a-z, A-Z, 0-9)
+$str->isAlphabetic();    // false - nur Buchstaben (a-z, A-Z)
+$str->isDigits();        // false - nur Ziffern (0-9)
+$str->isLowercase();     // false - nur Kleinbuchstaben
+$str->isUppercase();     // false - nur Großbuchstaben
+$str->isHexadecimal();   // false - valides Hex (0-9, a-f, A-F)
+$str->isWhitespace();    // false - nur Whitespace (\t, \n, \r, space)
+$str->isPrintable();     // true - druckbare Zeichen (keine Control Characters)
+$str->isVisible();       // false - sichtbare Zeichen (keine Whitespace)
+```
+
+**Wichtig**: Alle Methoden geben `false` für leere Strings zurück:
+
+```php
+TypedString::fromString('')->isAlphanumeric(); // false
+TypedString::fromString('')->isEmpty();        // true
+```
+
+### Length Checks
+
+Umfassende Längen-Validierung:
+
+```php
+$str = TypedString::fromString('hello');
+
+// Basic Length
+$str->length();              // 5
+$str->isEmpty();             // false
+$str->isNotEmpty();          // true
+
+// Length Constraints
+$str->hasMinLength(3);       // true - mindestens 3 Zeichen
+$str->hasMaxLength(10);      // true - maximal 10 Zeichen
+$str->hasLengthBetween(3, 10); // true - zwischen 3 und 10 Zeichen
+$str->hasExactLength(5);     // true - genau 5 Zeichen
+```
+
+### Pattern Matching
+
+Regex und Substring-Matching:
+
+```php
+$str = TypedString::fromString('hello world');
+
+// Regex Matching
+$str->matches('/^hello/');   // true - beginnt mit "hello"
+$str->matches('/\d+/');      // false - enthält keine Ziffern
+
+// String Matching
+$str->startsWith('hello');   // true - Prefix-Check
+$str->endsWith('world');     // true - Suffix-Check
+$str->contains('lo wo');     // true - Substring-Check
+```
+
+### Comparison & Conversion
+
+```php
+$str1 = TypedString::fromString('hello');
+$str2 = TypedString::fromString('hello');
+
+// Equality
+$str1->equals($str2);        // true - value comparison
+
+// Conversion
+$str1->toString();           // 'hello' - explizit
+(string) $str1;              // 'hello' - implicit via __toString()
+$str1->value;                // 'hello' - direkter property access
+```
+
+## TypedStringValidator (Fluent API)
+
+### Überblick
+
+`TypedStringValidator` bietet eine chainable Validation API für komplexe Validierungslogik.
+
+**Key Features**:
+- Chainable validation rules
+- Custom validation callbacks
+- Error collection mit detaillierten Messages
+- Multiple termination strategies (throw, null, default)
+
+### Basic Usage
+
+```php
+use App\Framework\String\ValueObjects\TypedString;
+
+// Simple validation chain
+$result = TypedString::fromString('user123')
+    ->validate()
+    ->alphanumeric()
+    ->minLength(3)
+    ->maxLength(20)
+    ->orNull(); // Returns TypedString or null
+
+if ($result !== null) {
+    // Validation passed
+}
+```
+
+### Available Validation Rules
+
+```php
+$validator = TypedString::fromString($input)->validate();
+
+// Character Type Rules
+$validator->alphanumeric(?string $error = null);     // Must be alphanumeric
+$validator->alphabetic(?string $error = null);       // Must be alphabetic
+$validator->digits(?string $error = null);           // Must be digits only
+$validator->lowercase(?string $error = null);        // Must be lowercase
+$validator->uppercase(?string $error = null);        // Must be uppercase
+$validator->hexadecimal(?string $error = null);      // Must be valid hex
+$validator->printable(?string $error = null);        // Must be printable
+$validator->visible(?string $error = null);          // Must be visible (no whitespace)
+
+// Length Rules
+$validator->notEmpty(?string $error = null);         // Must not be empty
+$validator->minLength(int $min, ?string $error = null);
+$validator->maxLength(int $max, ?string $error = null);
+$validator->lengthBetween(int $min, int $max, ?string $error = null);
+$validator->exactLength(int $length, ?string $error = null);
+
+// Pattern Rules
+$validator->matches(string $pattern, ?string $error = null);
+$validator->startsWith(string $prefix, ?string $error = null);
+$validator->endsWith(string $suffix, ?string $error = null);
+$validator->contains(string $substring, ?string $error = null);
+$validator->doesNotContain(string $substring, ?string $error = null);
+
+// Custom Rules
+$validator->custom(callable $check, string $error);
+// Callback signature: fn(TypedString $ts): bool
+```
+
+### Termination Methods
+
+Validation chains benötigen eine Termination-Methode:
+
+```php
+// 1. orThrow() - Wirft InvalidArgumentException bei Fehler
+try {
+    $validated = TypedString::fromString($input)
+        ->validate()
+        ->alphanumeric()
+        ->minLength(5)
+        ->orThrow('Invalid username');
+} catch (\InvalidArgumentException $e) {
+    // Handle validation error
+}
+
+// 2. orNull() - Gibt null bei Fehler zurück
+$validated = TypedString::fromString($input)
+    ->validate()
+    ->digits()
+    ->orNull();
+
+if ($validated === null) {
+    // Validation failed
+}
+
+// 3. orDefault() - Verwendet Fallback-Wert bei Fehler
+$validated = TypedString::fromString($input)
+    ->validate()
+    ->alphanumeric()
+    ->orDefault('default_value');
+
+// Garantiert niemals null - immer TypedString
+```
+
+### Error Handling
+
+```php
+$validator = TypedString::fromString('ab')
+    ->validate()
+    ->alphanumeric()
+    ->minLength(5);
+
+// Check validation status
+if ($validator->fails()) {
+    // Get all errors
+    $errors = $validator->getErrors();
+    // ['String must be at least 5 characters long']
+
+    // Get first error only
+    $firstError = $validator->getFirstError();
+}
+
+// Or check if passed
+if ($validator->passes()) {
+    // All validations succeeded
+}
+```
+
+### Complex Validation Example
+
+```php
+// Username validation
+$username = TypedString::fromString($input)
+    ->validate()
+    ->alphanumeric('Username must contain only letters and numbers')
+    ->minLength(3, 'Username must be at least 3 characters')
+    ->maxLength(20, 'Username must not exceed 20 characters')
+    ->orThrow('Invalid username');
+
+// Password validation with custom rules
+$password = TypedString::fromString($input)
+    ->validate()
+    ->minLength(8, 'Password must be at least 8 characters')
+    ->custom(
+        fn($ts) => preg_match('/[A-Z]/', $ts->value) === 1,
+        'Password must contain at least one uppercase letter'
+    )
+    ->custom(
+        fn($ts) => preg_match('/[0-9]/', $ts->value) === 1,
+        'Password must contain at least one digit'
+    )
+    ->custom(
+        fn($ts) => preg_match('/[!@#$%^&*]/', $ts->value) === 1,
+        'Password must contain at least one special character'
+    )
+    ->orThrow('Password does not meet security requirements');
+
+// Email format validation
+$email = TypedString::fromString($input)
+    ->validate()
+    ->matches('/^[\w\.\-]+@[\w\.\-]+\.\w+$/', 'Invalid email format')
+    ->maxLength(255)
+    ->orNull();
+```
+
+## Specialized Value Objects
+
+### Überblick
+
+Specialized Value Objects garantieren spezifische String-Formate durch Constructor-Validierung.
+
+**Verfügbare VOs**:
+- `AlphanumericString`: Nur alphanumerische Zeichen
+- `NumericString`: Nur Ziffern mit Conversion-Methoden
+- `HexadecimalString`: Valides Hex mit Conversion-Methoden
+- `PrintableString`: Nur druckbare Zeichen (keine Control Characters)
+
+### AlphanumericString
+
+**Use Cases**: Usernames, Identifiers, API Keys, Codes
+
+```php
+use App\Framework\String\ValueObjects\AlphanumericString;
+
+// ✅ Valid
+$username = AlphanumericString::fromString('user123');
+$apiKey = AlphanumericString::fromString('ABC123XYZ');
+
+// ❌ Invalid - wirft InvalidArgumentException
+AlphanumericString::fromString('user-123');  // Enthält '-'
+AlphanumericString::fromString('user@mail'); // Enthält '@'
+AlphanumericString::fromString('');          // Leer
+
+// Usage
+echo $username->value;           // 'user123'
+echo (string) $username;         // 'user123'
+$username->equals($apiKey);      // false
+
+// Conversion to TypedString für weitere Operationen
+$typed = $username->toTypedString();
+$length = $typed->length();      // 7
+```
+
+### NumericString
+
+**Use Cases**: Order IDs, Product Codes, Phone Numbers (digits only), ZIP Codes
+
+**Wichtig**: Verwende NumericString wenn Ziffern als String bleiben sollen (z.B. führende Nullen: "00123")
+
+```php
+use App\Framework\String\ValueObjects\NumericString;
+
+// ✅ Valid
+$orderId = NumericString::fromString('12345');
+$zipCode = NumericString::fromString('00123'); // Leading zeros erhalten!
+
+// ❌ Invalid
+NumericString::fromString('12.34');  // Enthält '.'
+NumericString::fromString('123abc'); // Enthält Buchstaben
+NumericString::fromString('');       // Leer
+
+// Conversion Methods
+$orderId->toInt();               // 12345 (int)
+$orderId->toFloat();             // 12345.0 (float)
+
+// Leading zeros bleiben im String erhalten
+$zipCode->value;                 // '00123' (string)
+$zipCode->toInt();               // 123 (int) - Leading zeros entfernt
+```
+
+**Use Case Example**:
+```php
+// ✅ Order ID System - NumericString validiert, speichert aber NICHT
+final readonly class OrderId
+{
+    public function __construct(
+        public string $value  // ✅ String property, NICHT NumericString!
+    ) {
+        // ✅ NumericString validiert Format
+        $validated = NumericString::fromString($value);
+
+        // Weitere Domain-Validierung
+        if (strlen($value) < 5) {
+            throw new \InvalidArgumentException('Order ID must be at least 5 digits');
+        }
+    }
+
+    public static function generate(): self
+    {
+        return new self((string) time());
+    }
+
+    public function toInt(): int
+    {
+        return (int) $this->value;
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+}
+```
+
+### HexadecimalString
+
+**Use Cases**: Hashes, Color Codes, Binary Data Representation, Token IDs
+
+```php
+use App\Framework\String\ValueObjects\HexadecimalString;
+
+// ✅ Valid
+$hash = HexadecimalString::fromString('deadbeef');
+$color = HexadecimalString::fromString('FF5733');
+$token = HexadecimalString::fromString('0123456789abcdef');
+
+// ❌ Invalid
+HexadecimalString::fromString('ghijk');  // Enthält non-hex Zeichen
+HexadecimalString::fromString('');       // Leer
+
+// Conversion Methods
+$hash->toBinary();               // Binary string
+$hash->toInt();                  // 3735928559 (decimal)
+
+// ✅ Use Case: Color Codes - HexadecimalString validiert, speichert aber NICHT
+final readonly class HexColor
+{
+    public function __construct(
+        public string $value  // ✅ String property, NICHT HexadecimalString!
+    ) {
+        // ✅ HexadecimalString validiert Hex-Format
+        $validated = HexadecimalString::fromString($value);
+
+        // Domain-spezifische Validierung: RGB benötigt 6 Zeichen
+        if (strlen($value) !== 6) {
+            throw new \InvalidArgumentException('Color must be 6 hex digits');
+        }
+    }
+
+    public static function fromRGB(int $r, int $g, int $b): self
+    {
+        $hex = sprintf('%02X%02X%02X', $r, $g, $b);
+        // Validierung erfolgt im Constructor
+        return new self($hex);
+    }
+
+    public function toRGB(): array
+    {
+        // Direkt mit string arbeiten - kein Wrapper-Unwrapping!
+        $hex = HexadecimalString::fromString($this->value);
+        $binary = $hex->toBinary();
+
+        return [
+            'r' => ord($binary[0]),
+            'g' => ord($binary[1]),
+            'b' => ord($binary[2])
+        ];
+    }
+}
+```
+
+### PrintableString
+
+**Use Cases**: User-facing Text, Display Strings, Log Messages, Comments
+
+**Wichtig**: Erlaubt Whitespace (\t, \n, \r, space) aber keine Control Characters
+
+```php
+use App\Framework\String\ValueObjects\PrintableString;
+
+// ✅ Valid
+$text = PrintableString::fromString('Hello World!');
+$message = PrintableString::fromString("Line 1\nLine 2\tTabbed");
+$special = PrintableString::fromString('Price: $99.99 (10% off!)');
+
+// ❌ Invalid
+PrintableString::fromString("Hello\x00World"); // Null byte (Control Character)
+PrintableString::fromString('');               // Leer
+
+// Usage
+echo $text->value;               // 'Hello World!'
+$text->toTypedString()->length(); // 12
+```
+
+## Integration Patterns
+
+### Mit Database Value Objects
+
+TypedString verbessert Database VOs durch flexible Validierung:
+
+```php
+use App\Framework\Database\ValueObjects\TableName;
+use App\Framework\String\ValueObjects\TypedString;
+
+// ✅ TypedString validiert, speichert aber NICHT
+final readonly class TableName
+{
+    public function __construct(public string $value)
+    {
+        TypedString::fromString($value)
+            ->validate()
+            ->alphanumeric('Table name must be alphanumeric')
+            ->notEmpty('Table name cannot be empty')
+            ->maxLength(63, 'Table name too long (PostgreSQL limit: 63)')
+            ->orThrow();
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+}
+
+// Property bleibt string - kein Wrapper!
+$table = TableName::fromString('users');
+echo $table->value; // ✅ Direkt string-Zugriff
+```
+
+### Mit Form Validation
+
+```php
+final readonly class CreateUserRequest implements ControllerRequest
+{
+    public function __construct(
+        public Email $email,
+        public string $username,  // ✅ String, NICHT AlphanumericString!
+        public ?string $bio = null
+    ) {}
+
+    public static function fromHttpRequest(HttpRequest $request): self
+    {
+        $data = $request->parsedBody->toArray();
+
+        // ✅ Validation beim Erstellen, aber Storage ist string
+        $username = TypedString::fromString($data['username'] ?? '')
+            ->validate()
+            ->alphanumeric('Username must be alphanumeric')
+            ->minLength(3, 'Username too short')
+            ->maxLength(20, 'Username too long')
+            ->orThrow();
+
+        $bio = null;
+        if (!empty($data['bio'])) {
+            $bio = TypedString::fromString($data['bio'])
+                ->validate()
+                ->printable('Bio must contain only printable characters')
+                ->maxLength(500, 'Bio too long')
+                ->orThrow();
+        }
+
+        return new self(
+            email: new Email($data['email'] ?? ''),
+            username: $username->value,  // ✅ Extract string from validation
+            bio: $bio?->value             // ✅ Optional string
+        );
+    }
+}
+```
+
+### Mit Domain Models
+
+```php
+final readonly class User
+{
+    public function __construct(
+        public UserId $id,
+        public Email $email,
+        public string $username,     // ✅ String, validiert im constructor
+        public string $displayName   // ✅ String, validiert im constructor
+    ) {}
+
+    public static function create(
+        Email $email,
+        string $username,
+        string $displayName
+    ): self {
+        // ✅ Validation happens here, but storage is plain string
+        $validatedUsername = TypedString::fromString($username)
+            ->validate()
+            ->alphanumeric('Username must be alphanumeric')
+            ->minLength(3)
+            ->maxLength(20)
+            ->orThrow();
+
+        $validatedDisplayName = TypedString::fromString($displayName)
+            ->validate()
+            ->printable('Display name must be printable')
+            ->minLength(1)
+            ->maxLength(50)
+            ->orThrow();
+
+        return new self(
+            id: UserId::generate(),
+            email: $email,
+            username: $validatedUsername->value,     // ✅ Store string
+            displayName: $validatedDisplayName->value // ✅ Store string
+        );
+    }
+}
+```
+
+### Custom Validation Rules
+
+```php
+// Custom VO mit spezieller Validierung
+final readonly class StrongPassword
+{
+    public function __construct(public string $value)
+    {
+        TypedString::fromString($value)
+            ->validate()
+            ->minLength(12, 'Password must be at least 12 characters')
+            ->custom(
+                fn($ts) => preg_match('/[A-Z]/', $ts->value) === 1,
+                'Must contain uppercase letter'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[a-z]/', $ts->value) === 1,
+                'Must contain lowercase letter'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[0-9]/', $ts->value) === 1,
+                'Must contain digit'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[!@#$%^&*]/', $ts->value) === 1,
+                'Must contain special character'
+            )
+            ->orThrow('Password does not meet security requirements');
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+}
+```
+
+## Migration Guide
+
+### Von Primitiven Strings zu TypedString
+
+**Step 1: Identifiziere Primitive String Validation**
+
+```php
+// ❌ Before: Primitive validation
+public function setUsername(string $username): void
+{
+    if (!ctype_alnum($username)) {
+        throw new \InvalidArgumentException('Username must be alphanumeric');
+    }
+
+    if (strlen($username) < 3 || strlen($username) > 20) {
+        throw new \InvalidArgumentException('Username length invalid');
+    }
+
+    $this->username = $username;
+}
+```
+
+**Step 2: Verwende TypedString Validation**
+
+```php
+// ✅ After: TypedString validation
+public function setUsername(string $username): void
+{
+    $validated = TypedString::fromString($username)
+        ->validate()
+        ->alphanumeric('Username must be alphanumeric')
+        ->lengthBetween(3, 20, 'Username must be 3-20 characters')
+        ->orThrow();
+
+    $this->username = $validated->value;
+}
+```
+
+**Step 3: Oder verwende Specialized VO**
+
+```php
+// ✅ Best: Specialized Value Object
+public function setUsername(AlphanumericString $username): void
+{
+    // Length check wenn benötigt
+    if (strlen($username->value) < 3 || strlen($username->value) > 20) {
+        throw new \InvalidArgumentException('Username must be 3-20 characters');
+    }
+
+    $this->username = $username->value;
+}
+```
+
+### Von ctype_* zu TypedString
+
+**Mapping Table**:
+
+| PHP ctype_* | TypedString Method | Notes |
+|-------------|-------------------|-------|
+| `ctype_alnum($str)` | `$ts->isAlphanumeric()` | Konsistent mit leeren Strings |
+| `ctype_alpha($str)` | `$ts->isAlphabetic()` | Nur Buchstaben |
+| `ctype_digit($str)` | `$ts->isDigits()` | Nur Ziffern |
+| `ctype_lower($str)` | `$ts->isLowercase()` | Nur Kleinbuchstaben |
+| `ctype_upper($str)` | `$ts->isUppercase()` | Nur Großbuchstaben |
+| `ctype_xdigit($str)` | `$ts->isHexadecimal()` | Valides Hex |
+| `ctype_space($str)` | `$ts->isWhitespace()` | Nur Whitespace |
+| `ctype_print($str)` | `$ts->isPrintable()` | Druckbare Zeichen |
+| `ctype_graph($str)` | `$ts->isVisible()` | Keine Whitespace |
+
+**Example Migration**:
+
+```php
+// ❌ Before
+if (ctype_alnum($input) && strlen($input) >= 3) {
+    $this->process($input);
+}
+
+// ✅ After
+$validated = TypedString::fromString($input)
+    ->validate()
+    ->alphanumeric()
+    ->minLength(3)
+    ->orNull();
+
+if ($validated !== null) {
+    $this->process($validated->value);
+}
+```
+
+## Security Considerations
+
+### SQL Injection Prevention
+
+TypedString hilft SQL-Injection zu verhindern durch zentrale Validierung:
+
+```php
+// ❌ Dangerous: Direct user input
+$tableName = $_GET['table'];
+$query = "SELECT * FROM {$tableName}"; // SQL Injection möglich!
+
+// ✅ Safe: TypedString validation
+$validated = TypedString::fromString($_GET['table'])
+    ->validate()
+    ->alphanumeric('Invalid table name')
+    ->maxLength(63)
+    ->orThrow();
+
+$query = "SELECT * FROM {$validated->value}"; // Safe - validated
+```
+
+**Best Practice**: Verwende Database VOs (TableName) powered by TypedString:
+
+```php
+use App\Framework\Database\ValueObjects\TableName;
+
+// Automatic validation via TableName VO
+$tableName = TableName::fromString($_GET['table']); // Throws on invalid input
+$query = "SELECT * FROM {$tableName}"; // Safe
+```
+
+### XSS Prevention
+
+```php
+// ✅ Validate user input
+$comment = TypedString::fromString($_POST['comment'])
+    ->validate()
+    ->printable('Comment contains invalid characters')
+    ->maxLength(1000)
+    ->orThrow();
+
+// Still escape for HTML output!
+echo htmlspecialchars($comment->value, ENT_QUOTES, 'UTF-8');
+```
+
+**Wichtig**: TypedString ersetzt NICHT HTML-Escaping - es ergänzt es durch Input-Validierung!
+
+### Password Validation
+
+```php
+// ✅ Strong password requirements
+final readonly class SecurePassword
+{
+    public function __construct(public string $value)
+    {
+        TypedString::fromString($value)
+            ->validate()
+            ->minLength(12)
+            ->custom(
+                fn($ts) => preg_match('/[A-Z]/', $ts->value) === 1,
+                'Must contain uppercase'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[a-z]/', $ts->value) === 1,
+                'Must contain lowercase'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[0-9]/', $ts->value) === 1,
+                'Must contain digit'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[!@#$%^&*(),.?":{}|<>]/', $ts->value) === 1,
+                'Must contain special character'
+            )
+            ->orThrow('Password does not meet security requirements');
+    }
+
+    public function hash(): string
+    {
+        return password_hash($this->value, PASSWORD_ARGON2ID);
+    }
+}
+```
+
+## Performance Considerations
+
+### Validation Overhead
+
+TypedString hat minimalen Performance-Overhead:
+
+- **Creation**: ~0.01ms pro TypedString (einmalige Validierung)
+- **Validation Chain**: ~0.02-0.05ms für 3-5 Rules
+- **Specialized VO**: ~0.01ms (Constructor-Validierung)
+- **Memory**: ~300 bytes pro TypedString Instance
+
+**Recommendation**: TypedString ist für alle String-Validierungen akzeptabel, auch in Performance-kritischen Pfaden.
+
+### Caching Strategies
+
+Für häufig validierte Strings:
+
+```php
+final class ValidatedStringCache
+{
+    private static array $cache = [];
+
+    public static function getAlphanumeric(string $value): ?AlphanumericString
+    {
+        return self::$cache[$value] ??= self::tryValidate($value);
+    }
+
+    private static function tryValidate(string $value): ?AlphanumericString
+    {
+        try {
+            return AlphanumericString::fromString($value);
+        } catch (\InvalidArgumentException) {
+            return null;
+        }
+    }
+}
+
+// Usage
+$username = ValidatedStringCache::getAlphanumeric($input);
+```
+
+**Wichtig**: Nur für Read-Heavy Scenarios - bei Writes lieber direkt validieren!
+
+## Testing
+
+### Unit Testing TypedString
+
+```php
+use App\Framework\String\ValueObjects\TypedString;
+
+it('validates alphanumeric strings', function () {
+    $str = TypedString::fromString('abc123');
+
+    expect($str->isAlphanumeric())->toBeTrue();
+    expect($str->isDigits())->toBeFalse();
+});
+
+it('validates length constraints', function () {
+    $str = TypedString::fromString('hello');
+
+    expect($str->hasMinLength(3))->toBeTrue();
+    expect($str->hasMaxLength(10))->toBeTrue();
+    expect($str->hasLengthBetween(3, 10))->toBeTrue();
+});
+
+it('throws on invalid validation', function () {
+    TypedString::fromString('invalid')
+        ->validate()
+        ->digits()
+        ->orThrow();
+})->throws(\InvalidArgumentException::class);
+```
+
+### Testing Specialized VOs
+
+```php
+it('creates alphanumeric string', function () {
+    $str = AlphanumericString::fromString('user123');
+
+    expect($str->value)->toBe('user123');
+});
+
+it('rejects non-alphanumeric', function () {
+    AlphanumericString::fromString('user-123');
+})->throws(\InvalidArgumentException::class, 'alphanumeric');
+
+it('converts numeric string to int', function () {
+    $num = NumericString::fromString('12345');
+
+    expect($num->toInt())->toBe(12345);
+    expect($num->toFloat())->toBe(12345.0);
+});
+```
+
+### Testing Fluent Validation
+
+```php
+it('validates complex password', function () {
+    $password = TypedString::fromString('Pass123!')
+        ->validate()
+        ->minLength(8)
+        ->custom(fn($ts) => preg_match('/[A-Z]/', $ts->value) === 1, 'uppercase')
+        ->custom(fn($ts) => preg_match('/[0-9]/', $ts->value) === 1, 'digit')
+        ->orThrow();
+
+    expect($password->value)->toBe('Pass123!');
+});
+
+it('collects validation errors', function () {
+    $validator = TypedString::fromString('ab')
+        ->validate()
+        ->alphanumeric()
+        ->minLength(5);
+
+    expect($validator->fails())->toBeTrue();
+
+    $errors = $validator->getErrors();
+    expect($errors)->toHaveCount(1);
+    expect($errors[0])->toContain('at least 5 characters');
+});
+```
+
+## Best Practices
+
+### 1. Verwende Specialized VOs für Domain-Konzepte
+
+```php
+// ✅ Good: Domain-specific VO
+final readonly class Username
+{
+    public function __construct(
+        private AlphanumericString $value
+    ) {
+        if (strlen($value->value) < 3 || strlen($value->value) > 20) {
+            throw new \InvalidArgumentException('Username must be 3-20 characters');
+        }
+    }
+}
+
+// ❌ Bad: Generic TypedString in domain
+final readonly class User
+{
+    public function __construct(
+        public TypedString $username // Zu generisch!
+    ) {}
+}
+```
+
+### 2. Validiere am Boundary
+
+```php
+// ✅ Good: Validate at API boundary
+final readonly class CreateUserRequest implements ControllerRequest
+{
+    public function __construct(
+        public AlphanumericString $username,
+        public Email $email
+    ) {}
+
+    public static function fromHttpRequest(HttpRequest $request): self
+    {
+        $data = $request->parsedBody->toArray();
+
+        // Validation happens here at the boundary
+        return new self(
+            username: AlphanumericString::fromString($data['username'] ?? ''),
+            email: new Email($data['email'] ?? '')
+        );
+    }
+}
+
+// ❌ Bad: Validate deep in business logic
+final readonly class UserService
+{
+    public function createUser(string $username, string $email): User
+    {
+        // Too late - validation should be at boundary
+        $validated = AlphanumericString::fromString($username);
+    }
+}
+```
+
+### 3. Nutze Custom Validation für Business Rules
+
+```php
+// ✅ Good: Custom validation for business rules
+$productCode = TypedString::fromString($input)
+    ->validate()
+    ->alphanumeric()
+    ->exactLength(8)
+    ->custom(
+        fn($ts) => $this->productCodeExists($ts->value),
+        'Product code does not exist'
+    )
+    ->orThrow();
+
+// ❌ Bad: Separate validation checks
+$code = AlphanumericString::fromString($input);
+if (strlen($code->value) !== 8) {
+    throw new \InvalidArgumentException('Invalid length');
+}
+if (!$this->productCodeExists($code->value)) {
+    throw new \InvalidArgumentException('Does not exist');
+}
+```
+
+### 4. Prefer orNull() für Optional Fields
+
+```php
+// ✅ Good: orNull() für optional
+$bio = TypedString::fromString($input)
+    ->validate()
+    ->printable()
+    ->maxLength(500)
+    ->orNull(); // null wenn validation fails
+
+if ($bio !== null) {
+    $user->setBio($bio->value);
+}
+
+// ❌ Bad: Exception für optional field
+try {
+    $bio = TypedString::fromString($input)
+        ->validate()
+        ->printable()
+        ->maxLength(500)
+        ->orThrow(); // Exception für optional field?
+
+    $user->setBio($bio->value);
+} catch (\InvalidArgumentException) {
+    // Optional field - exception nicht nötig
+}
+```
+
+### 5. Cache Validation Results sparsam
+
+```php
+// ✅ Good: Cache nur für Read-Heavy Scenarios
+final class ConfigValidator
+{
+    private ?AlphanumericString $cachedAppName = null;
+
+    public function getAppName(): AlphanumericString
+    {
+        return $this->cachedAppName ??=
+            AlphanumericString::fromString($this->config->get('app.name'));
+    }
+}
+
+// ❌ Bad: Cache für User Input (Security Risk!)
+private array $validatedUsernames = [];
+
+public function validateUsername(string $input): AlphanumericString
+{
+    // SECURITY RISK - cache könnte umgangen werden
+    return $this->validatedUsernames[$input] ??=
+        AlphanumericString::fromString($input);
+}
+```
+
+## Framework Compliance
+
+TypedString folgt allen Framework-Prinzipien:
+
+- ✅ **Readonly Classes**: Alle Klassen sind `final readonly`
+- ✅ **Immutability**: Keine State-Mutation nach Construction
+- ✅ **No Inheritance**: `final` classes, composition only
+- ✅ **Value Objects**: Keine Primitive Obsession
+- ✅ **Type Safety**: Strikte Type Hints überall
+- ✅ **Explicit**: Factory Methods (`fromString()`) für Clarity
+- ✅ **Framework Integration**: Fluent API, Chainable Methods
+- ✅ **Validation**: Constructor-basierte oder Fluent Validation
+
+## Zusammenfassung
+
+Das TypedString-System bietet:
+
+- ✅ **Type-Safe String Validation**: Sichere Alternative zu ctype_* Funktionen
+- ✅ **Fluent Validation API**: Chainable Rules mit Error Collection
+- ✅ **Specialized Value Objects**: Domain-spezifische VOs für häufige Use Cases
+- ✅ **Security**: Zentrale Validierung verhindert SQL-Injection und XSS
+- ✅ **Performance**: Minimaler Overhead (<0.05ms pro Validation)
+- ✅ **Framework Compliance**: Readonly, immutable, keine Primitives
+- ✅ **Testing**: Comprehensive Test Coverage mit Pest
+- ✅ **Migration**: Einfacher Wechsel von ctype_* zu TypedString
+
+**When to Use**:
+- Input Validation at API boundaries
+- Domain Value Objects requiring format constraints
+- Database Identifier Validation
+- Security-critical String Validation
+- Complex Validation Logic with Custom Rules
+
+**When NOT to Use**:
+- Simple string concatenation
+- Performance-ultra-critical inner loops (>10k iterations)
+- Strings that don't need validation
+- Already validated strings from trusted sources
diff --git a/docs/codex/guidelines.md b/docs/codex/guidelines.md
new file mode 100644
index 00000000..0e2a06d5
--- /dev/null
+++ b/docs/codex/guidelines.md
@@ -0,0 +1,26 @@
+# Codex Agent Guidelines
+
+This document supplements `AGENTS.md` with Codex-specific working notes. Always treat `AGENTS.md` as the source of truth and keep this file aligned with future updates.
+
+## Core Expectations
+
+- Obtain explicit approval from the project owner before attempting any code change or file edit.
+- Follow every checklist item in `AGENTS.md`, including framework principles, testing strategy, and tooling conventions.
+- Keep documentation edits consistent with project tone (PSR-12 code examples, ASCII character set, precise terminology).
+
+## Workflow Notes
+
+- Prefer small, reviewable steps and clearly report what changed, including file paths and line references.
+- When a task involves multiple steps, draft a lightweight plan unless the work is trivial.
+- Record unanswered questions or ambiguities in the final message so the owner can respond quickly.
+
+## Tooling Reminders
+
+- Use `bash -lc` shell invocations with explicit `workdir` as required by the Codex CLI harness.
+- Rely on `rg` for searches; fall back to alternatives only if `rg` is unavailable.
+- Do not run container or network commands without explicit permission when sandboxed.
+
+## Documentation Maintenance
+
+- Update this file whenever Codex-specific guidance changes so it remains synchronized with the rest of the ecosystem docs (e.g., keep parity with `docs/claude/` where it makes sense).
+- Coordinate with the project owner before introducing new sections or workflows that impact other agents.
diff --git a/docs/dependency-scanning.md b/docs/dependency-scanning.md
index e8180bdf..59c8def7 100644
--- a/docs/dependency-scanning.md
+++ b/docs/dependency-scanning.md
@@ -204,13 +204,13 @@ Roave automatically blocks `composer install` or `composer update` if any instal
 Current project uses **PHP 8.5 RC3** (bleeding edge), which causes dependency resolution conflicts:
 ```
 brianium/paratest v7.8.4 requires php ~8.2.0 || ~8.3.0 || ~8.4.0
-your php version (8.5.0RC3) does not satisfy that requirement
+your php version (8.5.0RC4) does not satisfy that requirement
 ```
 
 **Planned Integration:** When PHP 8.5 stable is released and all testing dependencies support it.
 
 > ℹ️ **PHP Runtime Strategy:**  
-> - Runtime container builds accept `--build-arg PHP_VERSION` (default `8.5.0RC3`) to keep PHP aligned with upstream RC tags.  
+> - Runtime container builds accept `--build-arg PHP_VERSION` (default `8.5.0RC4`) to keep PHP aligned with upstream RC tags.  
 > - `.gitea/workflows/production-deploy.yml` sets the same version for CI rebuilds (`--pull` ensures fresh layers).  
 > - We'll move to `8.5.0RC4` as soon as upstream publishes the image and switch to the latest stable PHP release at the end of November.
 
diff --git a/DEPLOYMENT_FIX.md b/docs/deployment/DEPLOYMENT_FIX.md
similarity index 100%
rename from DEPLOYMENT_FIX.md
rename to docs/deployment/DEPLOYMENT_FIX.md
diff --git a/ENV_SETUP.md b/docs/deployment/ENV_SETUP.md
similarity index 100%
rename from ENV_SETUP.md
rename to docs/deployment/ENV_SETUP.md
diff --git a/docs/deployment/status/.deployment-test-status.md b/docs/deployment/status/.deployment-test-status.md
new file mode 100644
index 00000000..2e580119
--- /dev/null
+++ b/docs/deployment/status/.deployment-test-status.md
@@ -0,0 +1,100 @@
+# Deployment-Test Status - Chat-Zusammenfassung
+
+**Datum**: Aktuelle Session
+**Zweck**: Staging-Setup mit separaten Datenbank-Stacks testen
+
+## ✅ Abgeschlossen
+
+### 1. Implementierung
+- ✅ Separate PostgreSQL-Stacks erstellt (Production & Staging)
+- ✅ Ansible-Roles für PostgreSQL-Stacks
+- ✅ Application-Stacks angepasst (DB-Verbindungen)
+- ✅ Staging-Setup Playbook erstellt
+- ✅ Dokumentation aktualisiert
+- ✅ Quick-Start-Scripts erstellt
+- ✅ Ansible-Verifikations-Playbooks erstellt
+
+### 2. Lokale Verifikation
+- ✅ PostgreSQL-Production Stack: Syntax OK
+- ✅ PostgreSQL-Staging Stack: Syntax OK
+- ✅ Staging Stack (Root): Syntax OK
+- ⚠️ Ansible: Nicht lokal installiert (wird auf Control-Node benötigt)
+
+## ❌ Aktuelle Probleme
+
+### SSH-Zugriff
+- **Problem**: SSH-Key kann nicht geladen werden
+- **Fehler**: `error in libcrypto` / `Permission denied (publickey)`
+- **Key vorhanden**: `~/.ssh/production` (Berechtigungen: 600)
+- **Mögliche Ursachen**: Key-Format, WSL/libcrypto-Kompatibilität
+
+## 📋 Nächste Schritte
+
+### Option 1: Manuelle Tests auf Server
+- **Anleitung**: `deployment/docs/guides/manual-server-test.md`
+- **Schritte**:
+  1. SSH-Verbindung: `ssh production`
+  2. PostgreSQL-Stacks starten
+  3. Networks verifizieren
+  4. Datenbank-Verbindungen testen
+  5. Health-Checks durchführen
+
+### Option 2: Ansible verwenden
+```bash
+cd ~/dev/michaelschiemer/deployment/ansible
+ansible-playbook -i inventory/production.yml playbooks/verify-staging.yml
+```
+
+### Option 3: Quick-Start-Script (auf Server)
+```bash
+cd ~/deployment
+./scripts/staging-quick-start.sh
+```
+
+## 📁 Wichtige Dateien
+
+### Dokumentation
+- `deployment/docs/guides/test-execution-plan.md` - Detaillierter Testplan
+- `deployment/docs/guides/manual-server-test.md` - Manuelle Test-Anleitung
+- `deployment/docs/guides/ansible-vs-bash-scripts.md` - Tool-Vergleich
+
+### Scripts
+- `deployment/scripts/staging-quick-start.sh` - Interaktives Test-Script
+- `deployment/scripts/production-quick-start.sh` - Production Test-Script
+
+### Ansible-Playbooks
+- `deployment/ansible/playbooks/setup-staging.yml` - Staging-Setup
+- `deployment/ansible/playbooks/verify-staging.yml` - Staging-Verifikation
+- `deployment/ansible/playbooks/verify-production.yml` - Production-Verifikation
+
+## 🎯 Test-Phasen (noch ausstehend)
+
+1. ✅ Phase 1: Lokale Syntax-Verifikation
+2. ⏳ Phase 2: PostgreSQL-Stacks testen (auf Server)
+3. ⏳ Phase 3: Networks verifizieren
+4. ⏳ Phase 4: Ansible-Setup testen
+5. ⏳ Phase 5: Datenbank-Verbindungen testen
+6. ⏳ Phase 6: Health-Checks
+7. ⏳ Phase 7: CI/CD-Workflow testen
+8. ⏳ Phase 8: Datenbank-Isolation testen
+
+## 💡 Empfehlung für Fortsetzung
+
+1. **Server-Neuaufbau durchführen** (siehe `deployment/docs/guides/server-rebuild-plan.md`)
+   - ✅ Detaillierter Plan erstellt (Debian 13 Trixie + UEFI)
+   - ✅ SSH-Zugriff dokumentiert (`deployment/docs/guides/ssh-access.md`)
+   - ✅ Initial-Server-Setup Playbook erstellt (`deployment/ansible/playbooks/initial-server-setup.yml`)
+   - ✅ Docker-Installation für Debian angepasst
+   - ⏳ Server über Netcup Control Panel zurücksetzen (Debian 13 Trixie UEFI)
+   - ⏳ Komplettes Setup via Ansible
+2. **Nach Neuaufbau**: PostgreSQL-Stacks, Ansible-Verifikation, End-to-End-Tests
+
+## 🔧 Bekannte Issues
+
+- SSH-Key-Problem: `error in libcrypto` - muss behoben werden für automatische Tests
+- Alternative: Manuelle Tests oder Ansible verwenden
+
+---
+
+**Hinweis**: Dieser Status kann mit `cursor-agent resume` fortgesetzt werden.
+
diff --git a/docs/design-token-system.md b/docs/design-token-system.md
new file mode 100644
index 00000000..f3ecfbc0
--- /dev/null
+++ b/docs/design-token-system.md
@@ -0,0 +1,374 @@
+# Design Token System Dokumentation
+
+## Übersicht
+
+Das Design Token System ermöglicht die zentrale Verwaltung von Design-Tokens (Farben, Abstände, Typografie, etc.) in PHP mit automatischer CSS-Generierung. Es unterstützt moderne CSS-Features wie OKLCH-Farben, HDR/P3-Support, Dark Mode und State-basierte Token-Variationen.
+
+## Architektur
+
+### Kernkomponenten
+
+1. **TokenRegistry** - Basis-Klasse für Token-Registries
+2. **ColorVariation** - Verwaltet Farben mit Light/Dark/P3/Fallback-Varianten
+3. **ColorManipulator** - Service für Farbmanipulation
+4. **StateMutation** - Definiert Mutationen für Token-States
+5. **TokenStateRegistry** - Verwaltet Tokens mit States
+6. **CssAstBuilder** - Generiert CSS aus Tokens
+
+### Token-Typen
+
+- **ColorToken** - Farb-Token mit Variationen
+- **StatefulColorToken** - Farb-Token mit States (hover, disabled, etc.)
+- **SpacingToken** - Abstands-Token
+- **TypographyToken** - Typografie-Token
+
+## Farbmanipulation
+
+### ColorManipulator Service
+
+Der `ColorManipulator` Service bietet Methoden zur Manipulation von Farben:
+
+```php
+use App\Framework\Design\Services\ColorManipulator;
+use App\Framework\Design\ValueObjects\CssColor;
+use App\Framework\Design\ValueObjects\ColorFormat;
+
+$manipulator = new ColorManipulator();
+$primary = new CssColor('oklch(70% 0.2 295)', ColorFormat::OKLCH);
+
+// Helligkeit anpassen
+$lighter = $manipulator->lighten($primary, 0.1);  // 10% heller
+$darker = $manipulator->darken($primary, 0.2);    // 20% dunkler
+
+// Sättigung anpassen
+$moreSaturated = $manipulator->saturate($primary, 0.15);
+$lessSaturated = $manipulator->desaturate($primary, 0.5);
+
+// Transparenz ändern
+$semiTransparent = $manipulator->adjustOpacity($primary, 0.5);
+
+// Farben mixen
+$secondary = new CssColor('oklch(60% 0.2 145)', ColorFormat::OKLCH);
+$mixed = $manipulator->mix($primary, $secondary, 0.3); // 30% primary, 70% secondary
+
+// Farbton verschieben
+$shifted = $manipulator->adjustHue($primary, 30); // 30 Grad verschieben
+```
+
+### CssColor Methoden
+
+Farben können auch direkt manipuliert werden:
+
+```php
+$primary = new CssColor('oklch(70% 0.2 295)', ColorFormat::OKLCH);
+
+$hover = $primary->lighten(0.1);
+$active = $primary->darken(0.15);
+$disabled = $primary->desaturate(1.0)->withOpacity(0.5);
+$mixed = $primary->mix($secondary, 0.3);
+```
+
+## Token States
+
+### TokenState Enum
+
+Das `TokenState` Enum definiert verschiedene States für Tokens:
+
+- `DEFAULT` - Standard State
+- `DISABLED` - Deaktiviert
+- `HOVER` - Hover State
+- `ACTIVE` - Aktiv (z.B. gedrückt)
+- `SELECTED` - Ausgewählt
+- `FOCUSED` - Fokussiert
+- `LOADING` - Lade-Zustand
+- `ERROR` - Fehler-Zustand
+- `SUCCESS` - Erfolgs-Zustand
+- `WARNING` - Warnung-Zustand
+
+### StateMutation
+
+`StateMutation` definiert, wie ein Token für einen bestimmten State mutiert werden soll:
+
+```php
+use App\Framework\Design\ValueObjects\StateMutation;
+use App\Framework\Design\ValueObjects\TokenState;
+
+// Disabled State: 0% Sättigung, 50% Transparenz
+$disabledMutation = new StateMutation(
+    saturationAdjustment: -1.0,  // 0% Sättigung
+    opacityAdjustment: 0.5        // 50% Transparenz
+);
+
+// Hover State: 10% heller
+$hoverMutation = new StateMutation(
+    lightnessAdjustment: 0.1
+);
+
+// Komposition mehrerer Mutationen
+$desaturateMutation = new StateMutation(saturationAdjustment: -1.0);
+$opacityMutation = new StateMutation(opacityAdjustment: 0.5);
+$composedMutation = $desaturateMutation->compose($opacityMutation);
+```
+
+### StatefulColorToken
+
+Ein `StatefulColorToken` repräsentiert einen Farb-Token mit einem spezifischen State:
+
+```php
+use App\Framework\Design\ValueObjects\Tokens\StatefulColorToken;
+use App\Framework\Design\ValueObjects\ColorVariation;
+use App\Framework\Design\ValueObjects\TokenState;
+use App\Framework\Design\ValueObjects\StateMutation;
+
+$primaryVariation = new ColorVariation(
+    name: 'primary',
+    light: new CssColor('oklch(70% 0.2 295)', ColorFormat::OKLCH),
+    dark: new CssColor('oklch(60% 0.22 295)', ColorFormat::OKLCH)
+);
+
+// Default State
+$defaultToken = new StatefulColorToken(
+    name: 'button-primary',
+    variation: $primaryVariation,
+    state: TokenState::DEFAULT
+);
+
+// Disabled State (abgeleitet)
+$disabledToken = new StatefulColorToken(
+    name: 'button-primary',
+    variation: $primaryVariation,
+    state: TokenState::DISABLED,
+    baseState: TokenState::DEFAULT,
+    mutation: new StateMutation(
+        saturationAdjustment: -1.0,
+        opacityAdjustment: 0.5
+    )
+);
+```
+
+### TokenStateRegistry
+
+Der `TokenStateRegistry` verwaltet Tokens mit States:
+
+```php
+use App\Framework\Design\ValueObjects\TokenStateRegistry;
+use App\Framework\Design\ValueObjects\TokenState;
+use App\Framework\Design\ValueObjects\StateMutation;
+
+// Default Mutationen für States definieren
+$registry = new TokenStateRegistry(
+    tokens: [],
+    stateMutations: [
+        TokenState::DISABLED => new StateMutation(
+            saturationAdjustment: -1.0,
+            opacityAdjustment: 0.5
+        ),
+        TokenState::HOVER => new StateMutation(
+            lightnessAdjustment: 0.1
+        ),
+        TokenState::ACTIVE => new StateMutation(
+            lightnessAdjustment: -0.15
+        ),
+    ]
+);
+
+// Token hinzufügen
+$registry = $registry->addToken($defaultToken);
+
+// Token für State abrufen
+$hoverToken = $registry->getTokenForState('button-primary', TokenState::HOVER);
+
+// Alle States für Token abrufen
+$allStates = $registry->getAllStatesForToken('button-primary');
+```
+
+## CSS-Generierung
+
+### Automatische CSS-Generierung
+
+Das System generiert automatisch CSS aus Tokens:
+
+```php
+use App\Framework\Design\ValueObjects\FrameworkTokenRegistry;
+
+$registry = new FrameworkTokenRegistry();
+$css = $registry->toCss('framework-settings', includeHdr: true);
+```
+
+### CSS Output
+
+Das generierte CSS nutzt moderne Features:
+
+```css
+@layer framework-settings {
+    :root {
+        --color-primary: oklch(70% 0.2 295);
+        --color-primary-p3: color(display-p3 0.8 0.3 1);
+    }
+}
+
+@layer framework-settings {
+    @media (prefers-color-scheme: dark) {
+        :root {
+            --color-primary: oklch(60% 0.22 295);
+        }
+    }
+}
+
+@layer framework-settings {
+    @media (dynamic-range: high) {
+        :root {
+            --color-primary: var(--color-primary-p3);
+        }
+    }
+}
+```
+
+### State-basierte CSS mit Pseudo-Klassen
+
+Für StatefulTokens werden Pseudo-Klassen generiert:
+
+```css
+.button-primary {
+    background: oklch(70% 0.2 295);
+}
+
+.button-primary:hover {
+    background: oklch(77% 0.2 295); /* Automatisch generiert */
+}
+
+.button-primary:active {
+    background: oklch(59.5% 0.2 295); /* Automatisch generiert */
+}
+
+.button-primary:disabled {
+    background: oklch(70% 0 295 / 0.5); /* Komponierte Mutation */
+}
+```
+
+## Verwendung
+
+### FrameworkTokenRegistry
+
+Framework-weite Tokens:
+
+```php
+use App\Framework\Design\ValueObjects\FrameworkTokenRegistry;
+
+$registry = new FrameworkTokenRegistry();
+$primaryColor = $registry->get('color-primary');
+```
+
+### AdminTokenRegistry
+
+Admin-spezifische Tokens:
+
+```php
+use App\Application\Admin\ValueObjects\AdminTokenRegistry;
+
+$registry = new AdminTokenRegistry();
+$adminBg = $registry->get('admin-bg-primary');
+```
+
+### Token generieren
+
+```bash
+# Framework Tokens generieren
+php console.php design:generate-tokens --scope=framework
+
+# Admin Tokens generieren
+php console.php design:generate-tokens --scope=admin
+
+# Beide generieren
+npm run build  # Generiert automatisch beide vor dem Build
+```
+
+## Best Practices
+
+### Farben definieren
+
+1. **OKLCH verwenden**: Perzeptuell uniforme Farbmanipulation
+2. **ColorVariation nutzen**: Zentrale Verwaltung von Light/Dark/P3
+3. **HDR-Support**: Automatische P3-Varianten für HDR-Displays
+
+### States definieren
+
+1. **Basis-State**: Immer einen DEFAULT State definieren
+2. **Mutationen komponieren**: Mehrere Mutationen kombinieren
+3. **Konsistente Mutationen**: Gleiche Mutationen für ähnliche States
+
+### Token-Organisation
+
+1. **Scopes trennen**: Framework vs. Admin Tokens
+2. **Naming Convention**: Klare, konsistente Namen
+3. **Beschreibungen**: Immer Beschreibungen hinzufügen
+
+## Erweiterte Features
+
+### Custom State Mutationen
+
+```php
+// Komplexe Mutation: Desaturate + Opacity + Mix
+$complexMutation = new StateMutation(
+    saturationAdjustment: -0.5,
+    opacityAdjustment: 0.7,
+    mixColor: new CssColor('oklch(50% 0 0)', ColorFormat::OKLCH), // Grau
+    mixWeight: 0.3
+);
+```
+
+### State-Hierarchien
+
+```php
+// Disabled kann von Hover abgeleitet werden
+$disabledFromHover = new StatefulColorToken(
+    name: 'button-primary',
+    variation: $primaryVariation,
+    state: TokenState::DISABLED,
+    baseState: TokenState::HOVER, // Basis ist Hover, nicht Default
+    mutation: new StateMutation(
+        saturationAdjustment: -1.0,
+        opacityAdjustment: 0.5
+    )
+);
+```
+
+## Performance
+
+- **Caching**: Generierte CSS wird gecacht
+- **Lazy Loading**: Tokens werden nur bei Bedarf geladen
+- **Optimierte Konvertierung**: OKLCH-Konvertierung ist optimiert
+
+## Browser-Unterstützung
+
+- **OKLCH**: Moderne Browser (Chrome 111+, Safari 15.4+, Firefox 113+)
+- **Display P3**: HDR-Displays mit Wide-Gamut-Support
+- **Fallbacks**: Automatische RGB/HEX-Fallbacks für ältere Browser
+
+## Migration von bestehenden Tokens
+
+Bestehende Tokens können schrittweise migriert werden:
+
+1. **ColorVariation erstellen**: Light/Dark Varianten definieren
+2. **States hinzufügen**: Mutationen für States definieren
+3. **CSS aktualisieren**: Generierte CSS verwenden
+
+## Troubleshooting
+
+### Farben sehen falsch aus
+
+- Prüfe OKLCH-Werte (Lightness 0-1 oder 0-100%, Chroma 0-0.4+, Hue 0-360)
+- Verwende ColorManipulator für konsistente Manipulation
+
+### States funktionieren nicht
+
+- Prüfe ob Token StatefulTokenInterface implementiert
+- Prüfe ob Mutation korrekt definiert ist
+- Prüfe CSS-Output auf Pseudo-Klassen
+
+### CSS wird nicht generiert
+
+- Prüfe ob TokenRegistry korrekt initialisiert ist
+- Prüfe ob Output-Pfad existiert und beschreibbar ist
+- Prüfe Console-Output für Fehlermeldungen
+
diff --git a/docs/claude/migration-system-quick-reference.md b/docs/features/database/migrations.md
similarity index 100%
rename from docs/claude/migration-system-quick-reference.md
rename to docs/features/database/migrations.md
diff --git a/docs/claude/database-patterns.md b/docs/features/database/patterns.md
similarity index 100%
rename from docs/claude/database-patterns.md
rename to docs/features/database/patterns.md
diff --git a/docs/features/error-handling/advanced.md b/docs/features/error-handling/advanced.md
new file mode 100644
index 00000000..96754cdf
--- /dev/null
+++ b/docs/features/error-handling/advanced.md
@@ -0,0 +1,754 @@
+# Exception System Advanced Features
+
+## Übersicht
+
+Das Exception-System wurde um 10 erweiterte Features erweitert, die in drei Phasen implementiert wurden:
+
+- **Phase 1 (Foundation)**: Rate Limiting, Context Caching, Performance Tracking
+- **Phase 2 (User Experience)**: User-Friendly Messages, Localization
+- **Phase 3 (Advanced)**: Recovery/Retry, Pattern Detection, Correlation, Metrics, Health Checks
+
+Alle Features sind optional und können einzeln aktiviert werden. Sie folgen den Framework-Prinzipien (final, readonly, Value Objects, Composition over Inheritance).
+
+---
+
+## Phase 1: Foundation Features
+
+### 1. Exception Rate Limiting & Throttling
+
+**Ziel**: Verhindert Log-Spam durch wiederholte gleiche Exceptions
+
+**Komponenten**:
+- `ExceptionFingerprint` - Generiert eindeutige Fingerprints für Exception-Gruppierung
+- `ExceptionRateLimitConfig` - Konfiguration für Thresholds und Time Windows
+- `ExceptionRateLimiter` - Rate Limiter mit Cache-basiertem Tracking
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\RateLimit\ExceptionRateLimiter;
+use App\Framework\ExceptionHandling\RateLimit\ExceptionRateLimitConfig;
+use App\Framework\Core\ValueObjects\Duration;
+
+// Konfiguration erstellen
+$config = ExceptionRateLimitConfig::withLimits(
+    maxExceptions: 10,
+    timeWindow: Duration::fromSeconds(60)
+);
+
+// Rate Limiter erstellen
+$rateLimiter = new ExceptionRateLimiter($cache, $config);
+
+// In ErrorKernel integriert (automatisch)
+// Exceptions werden automatisch rate-limited, wenn Threshold erreicht wird
+```
+
+**Konfiguration**:
+- `maxExceptions`: Maximale Anzahl gleicher Exceptions pro Time Window (Default: 10)
+- `timeWindow`: Time Window für Rate Limiting (Default: 60 Sekunden)
+- `skipLoggingOnLimit`: Skip Logging wenn Rate Limit erreicht (Default: true)
+- `skipAuditOnLimit`: Skip Audit Logging wenn Rate Limit erreicht (Default: true)
+- `trackMetricsOnLimit`: Track Metriken auch bei Rate Limit (Default: true)
+
+**Fingerprint-Generierung**:
+- Basierend auf Exception-Klasse, normalisierter Message, File/Line
+- Optional: Component und Operation aus Context für präzisere Gruppierung
+- Normalisierung entfernt variable Teile (UUIDs, Timestamps, Zahlen, etc.)
+
+---
+
+### 2. Exception Context Caching
+
+**Ziel**: Performance-Optimierung durch Caching von häufig verwendeten Context-Daten
+
+**Komponenten**:
+- `ExceptionContextCache` - Cache-Wrapper für Context-Daten
+- Integration in `ExceptionContextBuilder` - Automatischer Cache-Lookup
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Context\ExceptionContextCache;
+use App\Framework\ExceptionHandling\Context\ExceptionContextBuilder;
+
+// Context Cache erstellen
+$contextCache = new ExceptionContextCache($cache);
+
+// Context Builder mit Cache
+$builder = new ExceptionContextBuilder(
+    errorScope: $errorScope,
+    contextCache: $contextCache
+);
+
+// Automatischer Cache-Lookup beim buildFromRequest()
+$context = $builder->buildFromRequest($request);
+```
+
+**Cache-Levels**:
+- **Request-Level**: TTL 10 Minuten (spezifischste)
+- **Session-Level**: TTL 10 Minuten
+- **User-Level**: TTL 30 Minuten (am wenigsten spezifisch)
+
+**Cache-Invalidation**:
+```php
+// Manuelle Invalidation bei Context-Änderungen
+$contextCache->invalidateRequest($requestId);
+$contextCache->invalidateSession($sessionId);
+$contextCache->invalidateUser($userId);
+```
+
+---
+
+### 3. Exception Performance Tracking
+
+**Ziel**: Tracking von Performance-Impact pro Exception-Typ
+
+**Komponenten**:
+- `ExceptionPerformanceMetrics` - Value Object für Metriken
+- `ExceptionPerformanceTracker` - Performance-Tracking
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Performance\ExceptionPerformanceTracker;
+
+$tracker = new ExceptionPerformanceTracker();
+
+// Start tracking
+$startData = $tracker->start();
+
+// ... exception occurs ...
+
+// End tracking
+$metrics = $tracker->end($startData, $exception, $context);
+
+// Metriken enthalten:
+// - executionTimeMs: Ausführungszeit in Millisekunden
+// - memoryDeltaBytes: Memory-Delta in Bytes
+// - cpuUsagePercent: CPU-Usage in Prozent (wenn verfügbar)
+```
+
+**Integration**:
+- Metriken werden automatisch in `ExceptionContextData::metadata['performance']` gespeichert
+- Kann mit `MetricsCollector` integriert werden für Monitoring
+
+---
+
+## Phase 2: User Experience Features
+
+### 4. User-Friendly Exception Messages
+
+**Ziel**: Übersetzung von technischen Exception-Messages zu benutzerfreundlichen Texten
+
+**Komponenten**:
+- `UserFriendlyMessage` - Value Object für User-Messages
+- `ExceptionMessageTranslator` - Message-Übersetzung mit Template-System
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Translation\ExceptionMessageTranslator;
+use App\Framework\ExceptionHandling\Translation\UserFriendlyMessage;
+
+// Templates definieren
+$templates = [
+    \App\Framework\Exception\DatabaseException::class => [
+        'message' => 'Database connection failed. Please try again later.',
+        'title' => 'Database Error',
+        'help' => 'If this problem persists, please contact support.'
+    ],
+    \App\Framework\Exception\ValidationException::class => [
+        'message' => 'Please check your input and try again.',
+        'title' => 'Validation Error'
+    ]
+];
+
+// Translator erstellen
+$translator = new ExceptionMessageTranslator(
+    templates: $templates,
+    isDebugMode: false
+);
+
+// Message übersetzen
+$userMessage = $translator->translate($exception, $context);
+
+// $userMessage->message: User-friendly message
+// $userMessage->title: Optional title
+// $userMessage->helpText: Optional help text
+// $userMessage->technicalMessage: Original technical message (für Debugging)
+```
+
+**Template-Variablen**:
+- `{exception_message}` - Original Exception-Message
+- `{exception_class}` - Exception-Klasse
+- `{operation}` - Operation aus Context
+- `{component}` - Component aus Context
+
+**Integration**:
+- Automatisch in `ResponseErrorRenderer` integriert
+- In Debug-Mode werden technische Messages angezeigt
+- In Production werden User-Friendly Messages verwendet
+
+---
+
+### 5. Exception Localization
+
+**Ziel**: i18n-Support für Exception-Messages basierend auf User-Locale
+
+**Komponenten**:
+- `ExceptionLocalizer` - Lokalisierung mit Fallback-Chain
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Localization\ExceptionLocalizer;
+
+// Übersetzungen definieren
+$translations = [
+    'de' => [
+        \App\Framework\Exception\DatabaseException::class => [
+            'message' => 'Datenbankverbindung fehlgeschlagen. Bitte versuchen Sie es später erneut.',
+            'title' => 'Datenbankfehler'
+        ]
+    ],
+    'en' => [
+        \App\Framework\Exception\DatabaseException::class => [
+            'message' => 'Database connection failed. Please try again later.',
+            'title' => 'Database Error'
+        ]
+    ]
+];
+
+// Localizer erstellen
+$localizer = new ExceptionLocalizer(
+    translations: $translations,
+    defaultLocale: 'en'
+);
+
+// Locale aus Context extrahieren
+$locale = $localizer->getLocale($context);
+
+// Übersetzungen für Locale abrufen
+$localeTranslations = $localizer->getTranslations($locale);
+
+// Fallback-Chain: [user_locale, default_locale, 'en']
+$fallbackChain = $localizer->getFallbackChain($locale);
+```
+
+**Locale-Extraktion**:
+- Aus `ExceptionContextData::metadata['locale']`
+- Fallback zu Default-Locale
+- Fallback zu 'en' als letzte Option
+
+**Integration**:
+- Wird von `ExceptionMessageTranslator` verwendet
+- Locale sollte in `ExceptionContextData::metadata['locale']` gespeichert werden
+
+---
+
+## Phase 3: Advanced Features
+
+### 6. Exception Recovery & Retry Logic
+
+**Ziel**: Automatische Retry-Logik für temporäre Exceptions
+
+**Komponenten**:
+- `RetryStrategy` - Retry-Strategien (Exponential Backoff, Linear, Fixed)
+- `ExceptionRecoveryManager` - Recovery-Manager
+- `RetryableException` - Marker-Interface
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Recovery\ExceptionRecoveryManager;
+use App\Framework\ExceptionHandling\Recovery\RetryableException;
+use App\Framework\Exception\ExceptionMetadata;
+
+// Retryable Exception implementieren
+final class NetworkException extends \Exception implements RetryableException
+{
+}
+
+// Exception mit Retry-Config erstellen
+$metadata = ExceptionMetadata::withRetry(
+    retryAfter: 1000 // Base delay in milliseconds
+)->withMaxRetries(3)
+ ->withRetryStrategy('exponential_backoff');
+
+// Recovery Manager
+$recoveryManager = new ExceptionRecoveryManager();
+
+// Prüfen ob Retry nötig
+if ($recoveryManager->shouldRetry($exception, $metadata)) {
+    $delay = $recoveryManager->getRetryDelay($exception, $metadata, $attemptNumber);
+    // Retry nach $delay Millisekunden
+}
+```
+
+**Retry-Strategien**:
+- **Exponential Backoff** (Default): `baseDelay * 2^(attempt-1)`
+- **Linear**: `baseDelay * attempt`
+- **Fixed**: `baseDelay` (konstant)
+
+**ExceptionMetadata Erweiterungen**:
+- `maxRetries`: Maximale Anzahl Retries (Default: 3)
+- `retryStrategy`: Retry-Strategie (Default: 'exponential_backoff')
+- `retryAfter`: Base Delay in Millisekunden
+
+**Retryable Exceptions**:
+- Exceptions die `RetryableException` implementieren
+- Exceptions mit bestimmten Namen-Patterns (NetworkException, TimeoutException, etc.)
+
+---
+
+### 7. Exception Pattern Detection & Auto-Fix Suggestions
+
+**Ziel**: ML-basierte Pattern-Erkennung mit Fix-Vorschlägen
+
+**Komponenten**:
+- `ExceptionPattern` - Value Object für Patterns
+- `FixSuggestion` - Value Object für Fix-Vorschläge
+- `ExceptionPatternDetector` - Pattern-Detection
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\PatternDetection\ExceptionPatternDetector;
+use App\Framework\ExceptionHandling\PatternDetection\FixSuggestion;
+
+// Knowledge Base definieren
+$knowledgeBase = [
+    \App\Framework\Exception\DatabaseException::class => [
+        'description' => 'Database connection timeout',
+        'fixes' => [
+            [
+                'title' => 'Check connection pool size',
+                'description' => 'Increase database connection pool size',
+                'code' => '$config->setMaxConnections(50);',
+                'confidence' => 'high'
+            ],
+            [
+                'title' => 'Check database server',
+                'description' => 'Verify database server is running and accessible',
+                'confidence' => 'medium'
+            ]
+        ]
+    ]
+];
+
+// Pattern Detector erstellen
+$detector = new ExceptionPatternDetector($knowledgeBase);
+
+// Patterns erkennen
+$patterns = $detector->detect($exception, $context);
+
+foreach ($patterns as $pattern) {
+    echo $pattern->description . "\n";
+    foreach ($pattern->fixSuggestions as $fix) {
+        echo "  - " . $fix->title . ": " . $fix->description . "\n";
+    }
+}
+```
+
+**Integration**:
+- Kann in `ErrorAggregator` integriert werden
+- Patterns werden in `ExceptionContextData::metadata['patterns']` gespeichert
+
+---
+
+### 8. Exception Correlation & Root Cause Analysis
+
+**Ziel**: Verknüpfung verwandter Exceptions für Root-Cause-Analyse
+
+**Komponenten**:
+- `ExceptionCorrelation` - Value Object für Korrelationen
+- `ExceptionCorrelationEngine` - Correlation-Engine
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Correlation\ExceptionCorrelationEngine;
+
+$correlationEngine = new ExceptionCorrelationEngine($cache);
+
+// Exception korrelieren
+$correlation = $correlationEngine->correlate($exception, $context);
+
+// Correlation-Daten:
+// - correlationKey: Request-ID, Session-ID oder User-ID
+// - exceptionIds: Array von verwandten Exception-IDs
+// - rootCauseId: ID der ersten Exception (Root Cause)
+```
+
+**Correlation-Keys**:
+- **Request-ID** (höchste Priorität): Alle Exceptions in derselben Request
+- **Session-ID**: Alle Exceptions in derselben Session
+- **User-ID**: Alle Exceptions für denselben User
+
+**Root Cause Analysis**:
+- Erste Exception in Correlation-Chain ist Root Cause
+- Alle weiteren Exceptions sind Folge-Exceptions
+
+**Integration**:
+- Correlation-Daten werden in `ExceptionContextData::metadata['correlations']` gespeichert
+- Kann für Exception-Graph-Visualisierung verwendet werden
+
+---
+
+### 9. Exception Metrics & Monitoring Integration
+
+**Ziel**: Integration mit Monitoring-Systemen (Prometheus, StatsD)
+
+**Komponenten**:
+- `ExceptionMetrics` - Value Object für Metriken
+- `ExceptionMetricsCollector` - Metrics-Collector
+- `PrometheusExporter` - Prometheus-Export
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Metrics\ExceptionMetricsCollector;
+use App\Framework\ExceptionHandling\Metrics\PrometheusExporter;
+
+$collector = new ExceptionMetricsCollector($cache);
+
+// Exception-Metrik aufzeichnen
+$collector->record($exception, $context, $executionTimeMs);
+
+// Metriken abrufen
+$metrics = $collector->getMetrics();
+
+// Prometheus-Format exportieren
+$exporter = new PrometheusExporter();
+$prometheusMetrics = $exporter->export($metrics);
+
+// Output:
+// exception_total 42
+// exception_by_class{exception_class="DatabaseException"} 10
+// exception_by_component{component="UserService"} 5
+// exception_average_execution_time_ms 125.50
+```
+
+**Metriken**:
+- `totalCount`: Gesamtanzahl Exceptions
+- `byClass`: Anzahl pro Exception-Klasse
+- `byComponent`: Anzahl pro Component
+- `averageExecutionTimeMs`: Durchschnittliche Ausführungszeit
+
+**Integration**:
+- Kann in `ProductionMetricsController` integriert werden
+- Metriken werden im Prometheus-Format exportiert
+- Real-time Aggregation über Time-Windows
+
+---
+
+### 10. Exception Health Checks & Circuit Breakers
+
+**Ziel**: Circuit Breaker Pattern für Exception-basierte Health Checks
+
+**Komponenten**:
+- `ExceptionHealthChecker` - Health Checker
+
+**Verwendung**:
+
+```php
+use App\Framework\ExceptionHandling\Health\ExceptionHealthChecker;
+use App\Framework\ExceptionHandling\Metrics\ExceptionMetricsCollector;
+
+$metricsCollector = new ExceptionMetricsCollector($cache);
+$healthChecker = new ExceptionHealthChecker(
+    metricsCollector: $metricsCollector,
+    errorRateThreshold: 0.1, // 10% Error Rate
+    timeWindowSeconds: 60
+);
+
+// Health Check durchführen
+$result = $healthChecker->check();
+
+// Status:
+// - Healthy: Error Rate < 5%
+// - Warning: Error Rate 5-10%
+// - Unhealthy: Error Rate > 10%
+```
+
+**Health Check Status**:
+- **Healthy**: Error Rate unterhalb des Thresholds
+- **Warning**: Error Rate bei 50% des Thresholds
+- **Unhealthy**: Error Rate oberhalb des Thresholds
+
+**Integration**:
+- Implementiert `HealthCheckInterface`
+- Kann in `HealthCheckManager` registriert werden
+- Nutzt bestehende `CircuitBreaker` Infrastruktur
+
+---
+
+## DI Container Integration
+
+### Beispiel-Konfiguration
+
+```php
+// Exception Rate Limiter
+$container->bind(ExceptionRateLimitConfig::class, function() {
+    return ExceptionRateLimitConfig::withLimits(
+        maxExceptions: 10,
+        timeWindow: Duration::fromSeconds(60)
+    );
+});
+
+$container->singleton(ExceptionRateLimiter::class, function($container) {
+    return new ExceptionRateLimiter(
+        cache: $container->get(Cache::class),
+        config: $container->get(ExceptionRateLimitConfig::class)
+    );
+});
+
+// Exception Context Cache
+$container->singleton(ExceptionContextCache::class, function($container) {
+    return new ExceptionContextCache(
+        cache: $container->get(Cache::class)
+    );
+});
+
+// Exception Context Builder
+$container->singleton(ExceptionContextBuilder::class, function($container) {
+    return new ExceptionContextBuilder(
+        errorScope: $container->get(ErrorScope::class),
+        contextCache: $container->get(ExceptionContextCache::class)
+    );
+});
+
+// Exception Performance Tracker
+$container->singleton(ExceptionPerformanceTracker::class, function() {
+    return new ExceptionPerformanceTracker();
+});
+
+// Exception Message Translator
+$container->singleton(ExceptionMessageTranslator::class, function($container) {
+    $templates = require __DIR__ . '/config/exception_messages.php';
+    return new ExceptionMessageTranslator(
+        templates: $templates,
+        isDebugMode: $container->get('config')->get('app.debug', false)
+    );
+});
+
+// Exception Localizer
+$container->singleton(ExceptionLocalizer::class, function() {
+    $translations = require __DIR__ . '/config/exception_translations.php';
+    return new ExceptionLocalizer(
+        translations: $translations,
+        defaultLocale: 'en'
+    );
+});
+
+// Exception Recovery Manager
+$container->singleton(ExceptionRecoveryManager::class, function() {
+    return new ExceptionRecoveryManager();
+});
+
+// Exception Pattern Detector
+$container->singleton(ExceptionPatternDetector::class, function() {
+    $knowledgeBase = require __DIR__ . '/config/exception_patterns.php';
+    return new ExceptionPatternDetector($knowledgeBase);
+});
+
+// Exception Correlation Engine
+$container->singleton(ExceptionCorrelationEngine::class, function($container) {
+    return new ExceptionCorrelationEngine(
+        cache: $container->get(Cache::class)
+    );
+});
+
+// Exception Metrics Collector
+$container->singleton(ExceptionMetricsCollector::class, function($container) {
+    return new ExceptionMetricsCollector(
+        cache: $container->get(Cache::class)
+    );
+});
+
+// Exception Health Checker
+$container->singleton(ExceptionHealthChecker::class, function($container) {
+    return new ExceptionHealthChecker(
+        metricsCollector: $container->get(ExceptionMetricsCollector::class),
+        errorRateThreshold: 0.1,
+        timeWindowSeconds: 60
+    );
+});
+
+// ErrorKernel mit allen Features
+$container->singleton(ErrorKernel::class, function($container) {
+    return new ErrorKernel(
+        rendererFactory: $container->get(ErrorRendererFactory::class),
+        reporter: $container->get(Reporter::class),
+        errorAggregator: $container->get(ErrorAggregatorInterface::class),
+        contextProvider: $container->get(ExceptionContextProvider::class),
+        auditLogger: $container->get(ExceptionAuditLogger::class),
+        rateLimiter: $container->get(ExceptionRateLimiter::class), // NEU
+        executionContext: $container->get(ExecutionContext::class),
+        consoleOutput: $container->get(ConsoleOutput::class),
+        isDebugMode: $container->get('config')->get('app.debug', false)
+    );
+});
+```
+
+---
+
+## Best Practices
+
+### 1. Rate Limiting konfigurieren
+
+```php
+// Für Production: Strikte Limits
+$config = ExceptionRateLimitConfig::withLimits(
+    maxExceptions: 5,
+    timeWindow: Duration::fromSeconds(60)
+);
+
+// Für Development: Lockerere Limits
+$config = ExceptionRateLimitConfig::withLimits(
+    maxExceptions: 50,
+    timeWindow: Duration::fromSeconds(60)
+);
+```
+
+### 2. Context Caching nutzen
+
+```php
+// Context Cache nur aktivieren wenn Context-Erstellung teuer ist
+// (z.B. DB-Queries, externe API-Calls)
+if ($needsCaching) {
+    $builder = new ExceptionContextBuilder(
+        errorScope: $errorScope,
+        contextCache: $contextCache
+    );
+} else {
+    $builder = new ExceptionContextBuilder(errorScope: $errorScope);
+}
+```
+
+### 3. User-Friendly Messages definieren
+
+```php
+// Alle wichtigen Exceptions sollten User-Friendly Messages haben
+$templates = [
+    \App\Framework\Exception\DatabaseException::class => [
+        'message' => 'Database connection failed. Please try again later.',
+        'title' => 'Database Error',
+        'help' => 'If this problem persists, please contact support.'
+    ],
+    \App\Framework\Exception\ValidationException::class => [
+        'message' => 'Please check your input and try again.',
+        'title' => 'Validation Error'
+    ]
+];
+```
+
+### 4. Retry-Strategien wählen
+
+```php
+// Für Network-Exceptions: Exponential Backoff
+$metadata = ExceptionMetadata::withRetry(1000)
+    ->withRetryStrategy('exponential_backoff');
+
+// Für Rate-Limited APIs: Linear
+$metadata = ExceptionMetadata::withRetry(2000)
+    ->withRetryStrategy('linear');
+
+// Für Polling: Fixed Delay
+$metadata = ExceptionMetadata::withRetry(5000)
+    ->withRetryStrategy('fixed');
+```
+
+### 5. Health Checks konfigurieren
+
+```php
+// Für kritische Services: Strikte Thresholds
+$healthChecker = new ExceptionHealthChecker(
+    metricsCollector: $metricsCollector,
+    errorRateThreshold: 0.05, // 5%
+    timeWindowSeconds: 60
+);
+
+// Für weniger kritische Services: Lockerere Thresholds
+$healthChecker = new ExceptionHealthChecker(
+    metricsCollector: $metricsCollector,
+    errorRateThreshold: 0.2, // 20%
+    timeWindowSeconds: 300
+);
+```
+
+---
+
+## Migration Guide
+
+### Von altem System migrieren
+
+1. **Rate Limiting aktivieren**:
+   ```php
+   // In DI Container
+   $container->singleton(ExceptionRateLimiter::class, ...);
+   ```
+
+2. **Context Caching aktivieren** (optional):
+   ```php
+   // Nur wenn Performance-Probleme auftreten
+   $container->singleton(ExceptionContextCache::class, ...);
+   ```
+
+3. **User-Friendly Messages hinzufügen**:
+   ```php
+   // Templates in config/exception_messages.php definieren
+   ```
+
+4. **Health Checks registrieren**:
+   ```php
+   // In HealthCheckManager
+   $healthCheckManager->register($exceptionHealthChecker);
+   ```
+
+---
+
+## Troubleshooting
+
+### Rate Limiting blockiert zu viele Exceptions
+
+**Problem**: Rate Limiting blockiert auch wichtige Exceptions
+
+**Lösung**: Threshold erhöhen oder Time Window anpassen
+```php
+$config = ExceptionRateLimitConfig::withLimits(
+    maxExceptions: 20, // Erhöht
+    timeWindow: Duration::fromSeconds(60)
+);
+```
+
+### Context Cache liefert veraltete Daten
+
+**Problem**: Context Cache enthält veraltete User/Session-Daten
+
+**Lösung**: Cache bei User/Session-Änderungen invalidieren
+```php
+$contextCache->invalidateUser($userId);
+$contextCache->invalidateSession($sessionId);
+```
+
+### Performance Tracking zeigt keine Daten
+
+**Problem**: Performance-Metriken werden nicht aufgezeichnet
+
+**Lösung**: Sicherstellen dass `ExceptionPerformanceTracker` in `ErrorKernel` integriert ist
+```php
+// Performance-Tracking manuell starten
+$startData = $performanceTracker->start();
+// ... exception occurs ...
+$metrics = $performanceTracker->end($startData, $exception, $context);
+```
+
+---
+
+## Weitere Ressourcen
+
+- [Error Handling Guidelines](./error-handling.md)
+- [Exception Architecture](../ERROR-HANDLING-UNIFIED-ARCHITECTURE.md)
+- [Audit Logging](./audit-logging.md)
+
diff --git a/docs/features/error-handling/guide.md b/docs/features/error-handling/guide.md
new file mode 100644
index 00000000..50511253
--- /dev/null
+++ b/docs/features/error-handling/guide.md
@@ -0,0 +1,645 @@
+# Error Handling & Debugging
+
+This guide covers error handling patterns and debugging strategies in the framework.
+
+## Exception Handling
+
+All custom exceptions in the framework must extend `FrameworkException` to ensure consistent error handling, logging, and recovery mechanisms.
+
+### The FrameworkException System
+
+The framework provides a sophisticated exception system with:
+- **ExceptionContext**: Rich context information for debugging
+- **ErrorCode**: Categorized error codes with recovery hints
+- **RetryAfter**: Support for recoverable operations
+- **Fluent Interface**: Easy context building
+
+### Creating Custom Exceptions
+
+```php
+namespace App\Domain\User\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\ExceptionContext;
+
+final class UserNotFoundException extends FrameworkException
+{
+    public static function byId(UserId $id): self
+    {
+        return self::create(
+            DatabaseErrorCode::ENTITY_NOT_FOUND,
+            "User with ID '{$id->toString()}' not found"
+        )->withData([
+            'user_id' => $id->toString(),
+            'search_type' => 'by_id'
+        ]);
+    }
+
+    public static function byEmail(Email $email): self
+    {
+        $context = ExceptionContext::forOperation('user.lookup', 'UserRepository')
+            ->withData(['email' => $email->getMasked()]);
+
+        return self::fromContext(
+            "User with email not found",
+            $context,
+            DatabaseErrorCode::ENTITY_NOT_FOUND
+        );
+    }
+}
+```
+
+### Using ErrorCode Enums
+
+The framework provides category-specific error code enums for better organization and type safety:
+
+```php
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\Core\AuthErrorCode;
+use App\Framework\Exception\Core\HttpErrorCode;
+use App\Framework\Exception\Core\SecurityErrorCode;
+use App\Framework\Exception\Core\ValidationErrorCode;
+
+// Database errors
+DatabaseErrorCode::CONNECTION_FAILED
+DatabaseErrorCode::QUERY_FAILED
+DatabaseErrorCode::TRANSACTION_FAILED
+DatabaseErrorCode::CONSTRAINT_VIOLATION
+
+// Authentication errors
+AuthErrorCode::CREDENTIALS_INVALID
+AuthErrorCode::TOKEN_EXPIRED
+AuthErrorCode::SESSION_EXPIRED
+AuthErrorCode::ACCOUNT_LOCKED
+
+// HTTP errors
+HttpErrorCode::BAD_REQUEST
+HttpErrorCode::NOT_FOUND
+HttpErrorCode::METHOD_NOT_ALLOWED
+HttpErrorCode::RATE_LIMIT_EXCEEDED
+
+// Security errors
+SecurityErrorCode::CSRF_TOKEN_INVALID
+SecurityErrorCode::SQL_INJECTION_DETECTED
+SecurityErrorCode::XSS_DETECTED
+SecurityErrorCode::PATH_TRAVERSAL_DETECTED
+
+// Validation errors
+ValidationErrorCode::INVALID_INPUT
+ValidationErrorCode::REQUIRED_FIELD_MISSING
+ValidationErrorCode::BUSINESS_RULE_VIOLATION
+ValidationErrorCode::INVALID_FORMAT
+
+// Using error codes in exceptions:
+throw FrameworkException::create(
+    DatabaseErrorCode::QUERY_FAILED,
+    "Failed to execute user query"
+)->withContext(
+    ExceptionContext::forOperation('user.find', 'UserRepository')
+        ->withData(['query' => 'SELECT * FROM users WHERE id = ?'])
+        ->withDebug(['bind_params' => [$userId]])
+);
+```
+
+### Exception Context Building
+
+```php
+// Method 1: Using factory methods
+$exception = FrameworkException::forOperation(
+    'payment.process',
+    'PaymentService',
+    'Payment processing failed',
+    HttpErrorCode::BAD_GATEWAY
+)->withData([
+    'amount' => $amount->toArray(),
+    'gateway' => 'stripe',
+    'customer_id' => $customerId
+])->withMetadata([
+    'attempt' => 1,
+    'idempotency_key' => $idempotencyKey
+]);
+
+// Method 2: Building context separately
+$context = ExceptionContext::empty()
+    ->withOperation('order.validate', 'OrderService')
+    ->withData([
+        'order_id' => $orderId,
+        'total' => $total->toDecimal()
+    ])
+    ->withDebug([
+        'validation_rules' => ['min_amount', 'max_items'],
+        'failed_rule' => 'min_amount'
+    ]);
+
+throw FrameworkException::fromContext(
+    'Order validation failed',
+    $context,
+    ValidationErrorCode::BUSINESS_RULE_VIOLATION
+);
+```
+
+### Recoverable Exceptions
+
+```php
+// Creating recoverable exceptions with retry hints
+final class RateLimitException extends FrameworkException
+{
+    public static function exceeded(int $retryAfter): self
+    {
+        return self::create(
+            HttpErrorCode::RATE_LIMIT_EXCEEDED,
+            'API rate limit exceeded'
+        )->withRetryAfter($retryAfter)
+         ->withData(['retry_after_seconds' => $retryAfter]);
+    }
+}
+
+// Using in code
+try {
+    $response = $apiClient->request($endpoint);
+} catch (RateLimitException $e) {
+    if ($e->isRecoverable()) {
+        $waitTime = $e->getRetryAfter();
+        // Schedule retry after $waitTime seconds
+    }
+    throw $e;
+}
+```
+
+### Exception Categories
+
+```php
+// Check exception category for handling strategies
+try {
+    $result = $operation->execute();
+} catch (FrameworkException $e) {
+    if ($e->isCategory('AUTH')) {
+        // Handle authentication errors
+        return $this->redirectToLogin();
+    }
+
+    if ($e->isCategory('VAL')) {
+        // Handle validation errors
+        return $this->validationErrorResponse($e);
+    }
+
+    if ($e->isErrorCode(DatabaseErrorCode::CONNECTION_FAILED)) {
+        // Handle specific database connection errors
+        $this->notifyOps($e);
+    }
+
+    throw $e;
+}
+```
+
+### Simple Exceptions for Quick Use
+
+```php
+// When you don't need the full context system
+throw FrameworkException::simple('Quick error message');
+
+// With previous exception
+} catch (\PDOException $e) {
+    throw FrameworkException::simple(
+        'Database operation failed',
+        $e,
+        500
+    );
+}
+```
+
+### Exception Data Sanitization
+
+The framework automatically sanitizes sensitive data in exceptions:
+
+```php
+// Sensitive keys are automatically redacted
+$exception->withData([
+    'username' => 'john@example.com',
+    'password' => 'secret123',  // Will be logged as '[REDACTED]'
+    'api_key' => 'sk_live_...' // Will be logged as '[REDACTED]'
+]);
+```
+
+### Best Practices
+
+1. **Always extend FrameworkException** for custom exceptions
+2. **Use ErrorCode enum** for categorizable errors
+3. **Provide rich context** with operation, component, and data
+4. **Use factory methods** for consistent exception creation
+5. **Sanitize sensitive data** (automatic for common keys)
+6. **Make exceptions domain-specific** (UserNotFoundException vs generic NotFoundException)
+7. **Include recovery hints** for recoverable errors
+
+## Unified Error Kernel Architecture
+
+The framework uses a **context-aware error handling system** centered around the `ErrorKernel` class that automatically detects execution context (CLI vs HTTP) and handles errors accordingly.
+
+### ErrorKernel Overview
+
+**Location**: `src/Framework/ExceptionHandling/ErrorKernel.php`
+
+**Key Features**:
+- Automatic context detection (CLI vs HTTP)
+- Colored console output for CLI errors
+- HTTP Response objects for web errors
+- Integration with OWASP Security Event System
+- Unified error logging via LogReporter
+
+```php
+use App\Framework\ExceptionHandling\ErrorKernel;
+
+final readonly class ErrorKernel
+{
+    public function __construct(
+        private ErrorRendererFactory $rendererFactory = new ErrorRendererFactory,
+        private ?ExecutionContext $executionContext = null,
+        private ?ConsoleOutput $consoleOutput = null
+    ) {}
+
+    /**
+     * Context-aware exception handler
+     * - CLI: Colored console output
+     * - HTTP: Logs error (middleware creates response)
+     */
+    public function handle(Throwable $e, array $context = []): mixed
+    {
+        // Automatic logging
+        $log = new LogReporter();
+        $log->report($e);
+
+        // Context-aware handling
+        $executionContext = $this->executionContext ?? ExecutionContext::detect();
+
+        if ($executionContext->isCli()) {
+            $this->handleCliException($e);
+            return null;
+        }
+
+        // HTTP context - middleware will create response
+        return null;
+    }
+
+    /**
+     * Create HTTP Response from exception (for middleware recovery)
+     */
+    public function createHttpResponse(
+        Throwable $exception,
+        ?ExceptionContextProvider $contextProvider = null,
+        bool $isDebugMode = false
+    ): Response {
+        $renderer = new ResponseErrorRenderer($isDebugMode);
+        return $renderer->createResponse($exception, $contextProvider);
+    }
+}
+```
+
+### CLI Error Handling
+
+**CliErrorHandler** registers global PHP error handlers for CLI context:
+
+```php
+use App\Framework\ExceptionHandling\CliErrorHandler;
+use App\Framework\Console\ConsoleOutput;
+
+// Registration in AppBootstrapper
+$output = new ConsoleOutput();
+$cliErrorHandler = new CliErrorHandler($output);
+$cliErrorHandler->register();
+
+// Automatic colored output for errors:
+// - Red for uncaught exceptions
+// - Yellow for warnings
+// - Cyan for notices
+// - Full stack traces in CLI
+```
+
+### HTTP Error Handling
+
+**ExceptionHandlingMiddleware** catches exceptions in HTTP request pipeline:
+
+```php
+use App\Framework\Http\Middlewares\ExceptionHandlingMiddleware;
+
+#[MiddlewarePriorityAttribute(MiddlewarePriority::ERROR_HANDLING)]
+final readonly class ExceptionHandlingMiddleware implements HttpMiddleware
+{
+    public function __invoke(
+        MiddlewareContext $context,
+        Next $next,
+        RequestStateManager $stateManager
+    ): MiddlewareContext {
+        try {
+            return $next($context);
+        } catch (\Throwable $e) {
+            // Log exception
+            $this->logger->error('Unhandled exception in HTTP request', [
+                'exception' => get_class($e),
+                'message' => $e->getMessage(),
+            ]);
+
+            // Create HTTP Response
+            $errorKernel = new ErrorKernel();
+            $response = $errorKernel->createHttpResponse(
+                $e,
+                null,
+                isDebugMode: false
+            );
+
+            return $context->withResponse($response);
+        }
+    }
+}
+```
+
+### OWASP Security Event Integration
+
+Exceptions can trigger OWASP security events for audit logging:
+
+```php
+use App\Application\Security\OWASPSecurityEventLogger;
+use App\Application\Security\OWASPEventIdentifier;
+
+// Automatic security logging
+try {
+    $this->authenticateUser($credentials);
+} catch (AuthenticationException $e) {
+    // ErrorKernel logs exception
+    $this->errorKernel->handle($e);
+
+    // OWASP event for security audit trail
+    $this->eventDispatcher->dispatch(
+        new AuthenticationFailedEvent(
+            OWASPEventIdentifier::AUTHN_LOGIN_FAILURE,
+            $credentials->username,
+            $e->getMessage()
+        )
+    );
+
+    throw $e;
+}
+```
+
+### Legacy ErrorHandling Module Removed
+
+**IMPORTANT**: The legacy `ErrorHandling` module (`src/Framework/ErrorHandling/`) has been **completely removed** as of the unified exception architecture migration.
+
+**Migration Path**:
+- All error handling now uses `ErrorKernel` and `FrameworkException`
+- CLI errors: `CliErrorHandler` → `ErrorKernel`
+- HTTP errors: `ExceptionHandlingMiddleware` → `ErrorKernel`
+- Security events: Direct event dispatch via `EventDispatcher`
+
+**Old Pattern** (removed):
+```php
+// ❌ Legacy - NO LONGER EXISTS
+use App\Framework\ErrorHandling\ErrorHandler;
+use App\Framework\ErrorHandling\SecurityEventLogger;
+
+$errorHandler = new ErrorHandler();
+$errorHandler->register();
+```
+
+**New Pattern** (current):
+```php
+// ✅ Unified - ErrorKernel
+use App\Framework\ExceptionHandling\ErrorKernel;
+
+$errorKernel = new ErrorKernel();
+$errorKernel->handle($exception);
+```
+
+## Logging Best Practices
+
+### Automatic Exception Logging
+
+All exceptions handled by `ErrorKernel` are automatically logged via `LogReporter`:
+
+```php
+// Automatic logging happens in ErrorKernel::handle()
+$log = new LogReporter();
+$log->report($exception);
+
+// Logs include:
+// - Exception class and message
+// - Stack trace
+// - File and line number
+// - Context data
+```
+
+### Manual Logging
+
+```php
+use App\Framework\Logging\Logger;
+
+// Log exceptions with context
+try {
+    $user = $this->userRepository->find($userId);
+} catch (UserNotFoundException $e) {
+    Logger::error('User lookup failed', [
+        'user_id' => $userId,
+        'exception' => $e->getMessage(),
+        'trace' => $e->getTraceAsString()
+    ]);
+
+    throw $e;
+}
+
+// Log levels
+Logger::debug('Debugging information');
+Logger::info('Informational message');
+Logger::warning('Warning condition');
+Logger::error('Error condition');
+Logger::critical('Critical failure');
+```
+
+## Debug Strategies
+
+### Development vs Production
+
+**Development** (`APP_DEBUG=true`):
+- Full stack traces displayed
+- Detailed error messages
+- Debug data in responses
+- SQL query logging
+
+**Production** (`APP_DEBUG=false`):
+- Generic error messages
+- Stack traces hidden from users
+- Errors logged server-side
+- Security-safe responses
+
+### Debugging Tools
+
+```php
+// Enable debug mode in ErrorKernel
+$errorKernel = new ErrorKernel(
+    executionContext: ExecutionContext::cli(),
+    consoleOutput: new ConsoleOutput()
+);
+
+// HTTP Response with debug mode
+$response = $errorKernel->createHttpResponse(
+    $exception,
+    $contextProvider,
+    isDebugMode: true  // Shows stack trace in response
+);
+```
+
+### Error Context Providers
+
+```php
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+
+// Attach custom context to exceptions
+$contextProvider = new ExceptionContextProvider();
+$contextProvider->attachContext($exception, [
+    'request_id' => $requestId,
+    'user_id' => $userId,
+    'operation' => 'payment.process'
+]);
+
+$response = $errorKernel->createHttpResponse(
+    $exception,
+    $contextProvider,
+    isDebugMode: false
+);
+```
+
+## Error Recovery Patterns
+
+### Graceful Degradation
+
+```php
+// Try primary service, fallback to secondary
+try {
+    return $this->primaryCache->get($key);
+} catch (CacheException $e) {
+    Logger::warning('Primary cache failed, using fallback', [
+        'error' => $e->getMessage()
+    ]);
+
+    return $this->fallbackCache->get($key);
+}
+```
+
+### Circuit Breaker Pattern
+
+```php
+use App\Framework\Resilience\CircuitBreaker;
+
+$circuitBreaker = new CircuitBreaker(
+    failureThreshold: 5,
+    timeout: Duration::fromSeconds(60)
+);
+
+try {
+    return $circuitBreaker->call(function() {
+        return $this->externalApi->request($endpoint);
+    });
+} catch (CircuitOpenException $e) {
+    // Circuit is open - use cached response
+    return $this->cachedResponse;
+}
+```
+
+### Retry with Exponential Backoff
+
+```php
+use App\Framework\Queue\ValueObjects\RetryStrategy;
+
+$retryStrategy = new ExponentialBackoffStrategy(
+    maxAttempts: 3,
+    baseDelaySeconds: 60
+);
+
+$attempt = 0;
+while ($attempt < $retryStrategy->getMaxAttempts()) {
+    try {
+        return $this->performOperation();
+    } catch (TransientException $e) {
+        $attempt++;
+        if (!$retryStrategy->shouldRetry($attempt)) {
+            throw $e;
+        }
+
+        $delay = $retryStrategy->getDelay($attempt);
+        sleep($delay->toSeconds());
+    }
+}
+```
+
+## Common Error Scenarios
+
+### 1. Database Connection Failure
+
+```php
+try {
+    $connection = $this->connectionPool->getConnection();
+} catch (ConnectionException $e) {
+    // Log error
+    $this->errorKernel->handle($e);
+
+    // Return cached data or error response
+    return $this->getCachedData() ?? $this->errorResponse();
+}
+```
+
+### 2. Validation Errors
+
+```php
+try {
+    $user = User::create($email, $name);
+} catch (ValidationException $e) {
+    // Return validation errors to user
+    return new JsonResult([
+        'errors' => $e->getErrors()
+    ], status: Status::UNPROCESSABLE_ENTITY);
+}
+```
+
+### 3. Authentication Failures
+
+```php
+try {
+    $user = $this->authenticator->authenticate($credentials);
+} catch (AuthenticationException $e) {
+    // Log security event
+    $this->eventDispatcher->dispatch(
+        new AuthenticationFailedEvent($credentials->username)
+    );
+
+    // Return 401 Unauthorized
+    return new JsonResult([
+        'error' => 'Invalid credentials'
+    ], status: Status::UNAUTHORIZED);
+}
+```
+
+### 4. Resource Not Found
+
+```php
+try {
+    $order = $this->orderRepository->find($orderId);
+} catch (OrderNotFoundException $e) {
+    // Return 404 Not Found
+    return new JsonResult([
+        'error' => 'Order not found'
+    ], status: Status::NOT_FOUND);
+}
+```
+
+### 5. Rate Limit Exceeded
+
+```php
+try {
+    $this->rateLimiter->checkLimit($userId);
+} catch (RateLimitException $e) {
+    // Return 429 Too Many Requests with retry hint
+    return new JsonResult([
+        'error' => 'Rate limit exceeded',
+        'retry_after' => $e->getRetryAfter()
+    ], status: Status::TOO_MANY_REQUESTS);
+}
+```
\ No newline at end of file
diff --git a/docs/claude/event-system.md b/docs/features/events/system.md
similarity index 100%
rename from docs/claude/event-system.md
rename to docs/features/events/system.md
diff --git a/docs/claude/filesystem-patterns.md b/docs/features/filesystem/patterns.md
similarity index 100%
rename from docs/claude/filesystem-patterns.md
rename to docs/features/filesystem/patterns.md
diff --git a/docs/claude/scheduler-queue-pipeline.md b/docs/features/queue/scheduler.md
similarity index 100%
rename from docs/claude/scheduler-queue-pipeline.md
rename to docs/features/queue/scheduler.md
diff --git a/docs/claude/queue-system.md b/docs/features/queue/system.md
similarity index 100%
rename from docs/claude/queue-system.md
rename to docs/features/queue/system.md
diff --git a/docs/claude/routing-value-objects.md b/docs/features/routing/value-objects.md
similarity index 100%
rename from docs/claude/routing-value-objects.md
rename to docs/features/routing/value-objects.md
diff --git a/docs/claude/security-patterns.md b/docs/features/security/patterns.md
similarity index 100%
rename from docs/claude/security-patterns.md
rename to docs/features/security/patterns.md
diff --git a/docs/claude/route-authorization.md b/docs/features/security/route-authorization.md
similarity index 100%
rename from docs/claude/route-authorization.md
rename to docs/features/security/route-authorization.md
diff --git a/docs/claude/common-workflows.md b/docs/guides/common-workflows.md
similarity index 100%
rename from docs/claude/common-workflows.md
rename to docs/guides/common-workflows.md
diff --git a/docs/claude/configuration-best-practices.md b/docs/guides/configuration.md
similarity index 100%
rename from docs/claude/configuration-best-practices.md
rename to docs/guides/configuration.md
diff --git a/docs/claude/troubleshooting.md b/docs/guides/troubleshooting.md
similarity index 100%
rename from docs/claude/troubleshooting.md
rename to docs/guides/troubleshooting.md
diff --git a/docs/livecomponents/README.md b/docs/livecomponents/README.md
index 282b4766..35f25d82 100644
--- a/docs/livecomponents/README.md
+++ b/docs/livecomponents/README.md
@@ -106,6 +106,7 @@ That's it! The counter is now fully interactive with zero JavaScript written.
 - [Security Guide](security-guide.md) - CSRF, rate limiting, input validation
 - [Performance Guide](performance-guide.md) - Optimization strategies and best practices
 - [Advanced Features](advanced-features.md) - Fragments, batching, SSE, optimistic UI
+- [UI Integration Guide](ui-integration-guide.md) - Tooltips, loading states, dialogs, notifications
 
 ### Reference
 - [API Reference](api-reference.md) - Complete API documentation
diff --git a/docs/claude/livecomponent-file-uploads.md b/docs/livecomponents/livecomponent-file-uploads.md
similarity index 100%
rename from docs/claude/livecomponent-file-uploads.md
rename to docs/livecomponents/livecomponent-file-uploads.md
diff --git a/docs/claude/livecomponent-formbuilder-usage.md b/docs/livecomponents/livecomponent-formbuilder-usage.md
similarity index 100%
rename from docs/claude/livecomponent-formbuilder-usage.md
rename to docs/livecomponents/livecomponent-formbuilder-usage.md
diff --git a/docs/claude/livecomponent-lifecycle-hooks.md b/docs/livecomponents/livecomponent-lifecycle-hooks.md
similarity index 100%
rename from docs/claude/livecomponent-lifecycle-hooks.md
rename to docs/livecomponents/livecomponent-lifecycle-hooks.md
diff --git a/docs/claude/livecomponent-nested-components.md b/docs/livecomponents/livecomponent-nested-components.md
similarity index 100%
rename from docs/claude/livecomponent-nested-components.md
rename to docs/livecomponents/livecomponent-nested-components.md
diff --git a/docs/claude/livecomponent-security.md b/docs/livecomponents/livecomponent-security.md
similarity index 100%
rename from docs/claude/livecomponent-security.md
rename to docs/livecomponents/livecomponent-security.md
diff --git a/docs/claude/livecomponent-slot-system.md b/docs/livecomponents/livecomponent-slot-system.md
similarity index 100%
rename from docs/claude/livecomponent-slot-system.md
rename to docs/livecomponents/livecomponent-slot-system.md
diff --git a/docs/claude/livecomponents-best-practices.md b/docs/livecomponents/livecomponents-best-practices.md
similarity index 100%
rename from docs/claude/livecomponents-best-practices.md
rename to docs/livecomponents/livecomponents-best-practices.md
diff --git a/docs/claude/livecomponents-caching-system.md b/docs/livecomponents/livecomponents-caching-system.md
similarity index 100%
rename from docs/claude/livecomponents-caching-system.md
rename to docs/livecomponents/livecomponents-caching-system.md
diff --git a/docs/claude/livecomponents-dom-badges.md b/docs/livecomponents/livecomponents-dom-badges.md
similarity index 100%
rename from docs/claude/livecomponents-dom-badges.md
rename to docs/livecomponents/livecomponents-dom-badges.md
diff --git a/docs/claude/livecomponents-implementation-plan.md b/docs/livecomponents/livecomponents-implementation-plan.md
similarity index 100%
rename from docs/claude/livecomponents-implementation-plan.md
rename to docs/livecomponents/livecomponents-implementation-plan.md
diff --git a/docs/claude/livecomponents-lazy-loading.md b/docs/livecomponents/livecomponents-lazy-loading.md
similarity index 100%
rename from docs/claude/livecomponents-lazy-loading.md
rename to docs/livecomponents/livecomponents-lazy-loading.md
diff --git a/docs/claude/livecomponents-monitoring-debugging.md b/docs/livecomponents/livecomponents-monitoring-debugging.md
similarity index 100%
rename from docs/claude/livecomponents-monitoring-debugging.md
rename to docs/livecomponents/livecomponents-monitoring-debugging.md
diff --git a/docs/claude/livecomponents-observability.md b/docs/livecomponents/livecomponents-observability.md
similarity index 100%
rename from docs/claude/livecomponents-observability.md
rename to docs/livecomponents/livecomponents-observability.md
diff --git a/docs/claude/livecomponents-performance-optimizations.md b/docs/livecomponents/livecomponents-performance-optimizations.md
similarity index 100%
rename from docs/claude/livecomponents-performance-optimizations.md
rename to docs/livecomponents/livecomponents-performance-optimizations.md
diff --git a/docs/claude/livecomponents-playground.md b/docs/livecomponents/livecomponents-playground.md
similarity index 100%
rename from docs/claude/livecomponents-playground.md
rename to docs/livecomponents/livecomponents-playground.md
diff --git a/docs/claude/livecomponents-roadmap.md b/docs/livecomponents/livecomponents-roadmap.md
similarity index 100%
rename from docs/claude/livecomponents-roadmap.md
rename to docs/livecomponents/livecomponents-roadmap.md
diff --git a/docs/claude/livecomponents-system.md b/docs/livecomponents/livecomponents-system.md
similarity index 100%
rename from docs/claude/livecomponents-system.md
rename to docs/livecomponents/livecomponents-system.md
diff --git a/docs/claude/livecomponents-test-harness.md b/docs/livecomponents/livecomponents-test-harness.md
similarity index 100%
rename from docs/claude/livecomponents-test-harness.md
rename to docs/livecomponents/livecomponents-test-harness.md
diff --git a/docs/livecomponents/ui-integration-guide.md b/docs/livecomponents/ui-integration-guide.md
new file mode 100644
index 00000000..4e8caa21
--- /dev/null
+++ b/docs/livecomponents/ui-integration-guide.md
@@ -0,0 +1,717 @@
+# LiveComponents UI Integration Guide
+
+**Complete Guide to UI Features: Tooltips, Loading States, Dialogs, and Notifications**
+
+This guide covers the integrated UI features available in LiveComponents, including tooltips, skeleton loading, dialogs, modals, notifications, and loading states.
+
+---
+
+## Table of Contents
+
+1. [Tooltip System](#tooltip-system)
+2. [Loading States & Skeleton Loading](#loading-states--skeleton-loading)
+3. [UI Helper System](#ui-helper-system)
+4. [Notification Component](#notification-component)
+5. [Dialog & Modal Integration](#dialog--modal-integration)
+6. [Best Practices](#best-practices)
+
+---
+
+## Tooltip System
+
+### Overview
+
+The Tooltip System provides automatic tooltip initialization and management for LiveComponent elements. Tooltips are automatically initialized when components are mounted and cleaned up when components are destroyed.
+
+**Features**:
+- Automatic initialization for `data-tooltip` attributes
+- Accessibility support (ARIA attributes)
+- Smart positioning (viewport-aware)
+- Validation error tooltips
+- Automatic cleanup
+
+### Basic Usage
+
+```html
+<!-- Simple tooltip -->
+<button
+    data-lc-action="save"
+    data-tooltip="Save your changes"
+>
+    Save
+</button>
+
+<!-- Tooltip with validation error -->
+<input
+    type="email"
+    data-lc-action="validateEmail"
+    data-tooltip="Enter a valid email address"
+    data-tooltip-error="Invalid email format"
+/>
+```
+
+### Server-Side Validation Tooltips
+
+```php
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\ValueObjects\LiveComponentError;
+
+final class UserForm extends LiveComponent
+{
+    #[Action]
+    public function validateEmail(string $email): void
+    {
+        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
+            // Error will automatically show tooltip if element has data-tooltip-error
+            throw LiveComponentError::validation(
+                'Invalid email format',
+                ['field' => 'email'],
+                $this->id->toString(),
+                'validateEmail'
+            );
+        }
+    }
+}
+```
+
+### Custom Tooltip Configuration
+
+```javascript
+// Configure tooltip behavior globally
+import { tooltipManager } from './modules/livecomponent/TooltipManager.js';
+
+// Adjust delays
+tooltipManager.tooltipDelay = 500; // Show after 500ms
+tooltipManager.hideDelay = 200;   // Hide after 200ms
+```
+
+### Tooltip Events
+
+```javascript
+// Listen for tooltip events
+window.addEventListener('livecomponent:tooltip-shown', (e) => {
+    const { element, tooltipText } = e.detail;
+    console.log(`Tooltip shown: ${tooltipText}`);
+});
+
+window.addEventListener('livecomponent:tooltip-hidden', (e) => {
+    const { element } = e.detail;
+    console.log('Tooltip hidden');
+});
+```
+
+---
+
+## Loading States & Skeleton Loading
+
+### Overview
+
+The Loading State System provides configurable loading indicators during LiveComponent actions, including skeleton loaders, spinners, and progress indicators.
+
+**Features**:
+- Fragment-specific loading
+- Configurable loading types (skeleton, spinner, progress, none)
+- Smooth transitions
+- Optimistic UI integration (no loading for optimistic actions)
+- Per-component configuration
+
+### Basic Usage
+
+```html
+<!-- Component with skeleton loading -->
+<div
+    data-live-component="product-list"
+    data-loading-type="skeleton"
+    data-loading-fragments="product-list"
+>
+    <div data-lc-fragment="product-list">
+        <!-- Skeleton template will be shown during loading -->
+        <div class="skeleton-item">
+            <div class="skeleton-image"></div>
+            <div class="skeleton-text"></div>
+        </div>
+    </div>
+</div>
+```
+
+### Server-Side Loading Configuration
+
+```php
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\Attributes\Loading;
+
+final class ProductList extends LiveComponent
+{
+    #[Action]
+    #[Loading(type: 'skeleton', fragments: ['product-list'], showDelay: 150)]
+    public function loadProducts(string $category): void
+    {
+        $this->products = $this->productService->getByCategory($category);
+    }
+
+    #[Action]
+    #[Loading(type: 'spinner', showDelay: 0)] // Show immediately
+    public function quickAction(): void
+    {
+        // Fast action with immediate spinner
+    }
+}
+```
+
+### Loading Types
+
+#### 1. Skeleton Loading
+
+```html
+<!-- Skeleton template in component -->
+<div data-lc-fragment="content">
+    <!-- Default content -->
+    <div class="product-card">
+        <img src="{product.image}" />
+        <h3>{product.name}</h3>
+    </div>
+
+    <!-- Skeleton template (shown during loading) -->
+    <template data-skeleton-template>
+        <div class="product-card skeleton">
+            <div class="skeleton-image"></div>
+            <div class="skeleton-text"></div>
+        </div>
+    </template>
+</div>
+```
+
+#### 2. Spinner Loading
+
+```html
+<!-- Automatic spinner overlay -->
+<div
+    data-live-component="component-id"
+    data-loading-type="spinner"
+>
+    <!-- Spinner automatically appears during actions -->
+</div>
+```
+
+#### 3. Progress Loading
+
+```html
+<!-- Progress bar for long-running actions -->
+<div
+    data-live-component="upload-component"
+    data-loading-type="progress"
+>
+    <div class="progress-bar" data-progress="0"></div>
+</div>
+```
+
+### Custom Loading Configuration
+
+```javascript
+// Configure loading behavior per component
+const component = LiveComponentManager.getInstance().getComponent('component-id');
+
+component.setLoadingConfig({
+    type: 'skeleton',
+    fragments: ['content', 'sidebar'],
+    showDelay: 150,
+    hideDelay: 100
+});
+```
+
+### Loading Events
+
+```javascript
+// Listen for loading state changes
+window.addEventListener('livecomponent:loading-started', (e) => {
+    const { componentId, type, fragments } = e.detail;
+    console.log(`Loading started: ${componentId} (${type})`);
+});
+
+window.addEventListener('livecomponent:loading-finished', (e) => {
+    const { componentId, duration } = e.detail;
+    console.log(`Loading finished: ${componentId} (${duration}ms)`);
+});
+```
+
+---
+
+## UI Helper System
+
+### Overview
+
+The UI Helper System provides a standardized way for LiveComponents to interact with common UI elements like dialogs, modals, and notifications.
+
+**Features**:
+- Unified API for UI components
+- Integration with UIManager
+- Promise-based API
+- Automatic cleanup
+- Component-scoped UI elements
+
+### Dialog & Modal Helpers
+
+```php
+use App\Framework\LiveComponents\Attributes\Action;
+
+final class UserManagement extends LiveComponent
+{
+    #[Action]
+    public function showDeleteConfirm(int $userId): void
+    {
+        // Show confirmation dialog via UI Helper
+        $this->uiHelper->showDialog(
+            title: 'Delete User',
+            message: 'Are you sure you want to delete this user?',
+            buttons: [
+                ['label' => 'Cancel', 'action' => 'cancel'],
+                ['label' => 'Delete', 'action' => 'confirm', 'variant' => 'danger']
+            ]
+        )->then(function($action) use ($userId) {
+            if ($action === 'confirm') {
+                $this->deleteUser($userId);
+            }
+        });
+    }
+}
+```
+
+### JavaScript API
+
+```javascript
+import { LiveComponentUIHelper } from './modules/livecomponent/LiveComponentUIHelper.js';
+
+const uiHelper = new LiveComponentUIHelper(liveComponentManager);
+
+// Show modal
+const action = await uiHelper.showModal('component-id', {
+    title: 'Confirm Action',
+    content: '<p>Are you sure?</p>',
+    size: 'medium',
+    buttons: [
+        { label: 'Cancel', action: 'cancel' },
+        { label: 'Confirm', action: 'confirm', variant: 'primary' }
+    ]
+});
+
+if (action === 'confirm') {
+    // Handle confirmation
+}
+
+// Show alert
+await uiHelper.showAlert('component-id', {
+    title: 'Success',
+    message: 'Operation completed successfully',
+    type: 'success'
+});
+
+// Show confirm dialog
+const confirmed = await uiHelper.showConfirm('component-id', {
+    title: 'Delete Item',
+    message: 'This action cannot be undone.',
+    confirmText: 'Delete',
+    cancelText: 'Cancel'
+});
+```
+
+### Notification Helpers
+
+```javascript
+// Show notification
+uiHelper.showNotification('component-id', 'Operation successful', 'success');
+
+// Show error notification with retry
+uiHelper.showErrorNotification(
+    'component-id',
+    'Upload failed. Please try again.',
+    'error',
+    true, // Can retry
+    () => {
+        // Retry logic
+        retryUpload();
+    }
+);
+
+// Hide notification
+uiHelper.hideNotification('component-id');
+```
+
+---
+
+## Notification Component
+
+### Overview
+
+The NotificationComponent is a full-featured LiveComponent for displaying toast notifications with support for different types, positions, durations, and action buttons.
+
+**Features**:
+- Type-safe state management
+- Multiple notification types (info, success, warning, error)
+- Configurable positions (top-right, top-left, bottom-right, bottom-left)
+- Auto-dismiss with duration
+- Action buttons
+- Icon support
+
+### Basic Usage
+
+```php
+use App\Application\LiveComponents\Notification\NotificationComponent;
+use App\Framework\LiveComponents\ValueObjects\ComponentId;
+
+final class ProductController
+{
+    public function create(): ViewResult
+    {
+        $notification = NotificationComponent::mount(
+            ComponentId::generate('notification'),
+            message: 'Product created successfully',
+            type: 'success',
+            duration: 5000
+        );
+
+        return new ViewResult('product/index', [
+            'notification' => $notification
+        ]);
+    }
+}
+```
+
+### Template Integration
+
+```html
+<!-- Include notification component in layout -->
+{notification}
+
+<!-- Or use in component template -->
+<div data-live-component="{notification.id}">
+    <!-- Notification will render here -->
+</div>
+```
+
+### Server-Side Actions
+
+```php
+final class NotificationExample extends LiveComponent
+{
+    #[Action]
+    public function showSuccess(): NotificationState
+    {
+        return NotificationState::empty()
+            ->withMessage('Operation successful!', 'success')
+            ->show();
+    }
+
+    #[Action]
+    public function showError(string $message): NotificationState
+    {
+        return NotificationState::empty()
+            ->withMessage($message, 'error')
+            ->show();
+    }
+
+    #[Action]
+    public function showWithAction(): NotificationState
+    {
+        return new NotificationState(
+            message: 'File uploaded successfully',
+            type: 'success',
+            isVisible: true,
+            actionText: 'View',
+            actionUrl: '/files'
+        );
+    }
+}
+```
+
+### Client-Side API
+
+```javascript
+// Show notification via LiveComponent action
+liveComponentManager.executeAction('notification-id', 'showNotification', {
+    message: 'Operation successful',
+    type: 'success',
+    duration: 5000
+});
+
+// Hide notification
+liveComponentManager.executeAction('notification-id', 'hide');
+```
+
+### Notification Types
+
+```php
+// Info notification
+$notification = NotificationState::empty()
+    ->withMessage('New update available', 'info')
+    ->show();
+
+// Success notification
+$notification = NotificationState::empty()
+    ->withMessage('Changes saved', 'success')
+    ->show();
+
+// Warning notification
+$notification = NotificationState::empty()
+    ->withMessage('Low disk space', 'warning')
+    ->show();
+
+// Error notification
+$notification = NotificationState::empty()
+    ->withMessage('Upload failed', 'error')
+    ->show();
+```
+
+### Notification Positions
+
+```php
+$notification = new NotificationState(
+    message: 'Notification message',
+    type: 'info',
+    position: 'top-right', // or 'top-left', 'bottom-right', 'bottom-left'
+    isVisible: true
+);
+```
+
+### Notification with Action Button
+
+```php
+$notification = new NotificationState(
+    message: 'File ready for download',
+    type: 'success',
+    isVisible: true,
+    actionText: 'Download',
+    actionUrl: '/download/file.pdf'
+);
+```
+
+---
+
+## Dialog & Modal Integration
+
+### Overview
+
+LiveComponents integrate seamlessly with the UIManager for dialogs and modals, providing a consistent API across the application.
+
+### Basic Modal Usage
+
+```php
+use App\Framework\LiveComponents\Attributes\Action;
+
+final class UserSettings extends LiveComponent
+{
+    #[Action]
+    public function showEditModal(int $userId): void
+    {
+        // Modal will be shown via UI Helper
+        $this->uiHelper->showModal(
+            title: 'Edit User',
+            content: $this->renderEditForm($userId),
+            size: 'large',
+            buttons: [
+                ['label' => 'Save', 'action' => 'save', 'variant' => 'primary'],
+                ['label' => 'Cancel', 'action' => 'cancel']
+            ]
+        );
+    }
+}
+```
+
+### Modal with LiveComponent Content
+
+```php
+#[Action]
+public function showUserModal(int $userId): void
+{
+    $userComponent = UserDetailsComponent::mount(
+        ComponentId::generate('user-details'),
+        userId: $userId
+    );
+
+    $this->uiHelper->showModal(
+        title: 'User Details',
+        content: $userComponent->render(),
+        size: 'medium'
+    );
+}
+```
+
+### Modal Events
+
+```javascript
+// Listen for modal events
+window.addEventListener('livecomponent:modal-opened', (e) => {
+    const { componentId, modalInstance } = e.detail;
+    console.log(`Modal opened for component: ${componentId}`);
+});
+
+window.addEventListener('livecomponent:modal-closed', (e) => {
+    const { componentId, action } = e.detail;
+    console.log(`Modal closed with action: ${action}`);
+});
+```
+
+---
+
+## Best Practices
+
+### 1. Tooltip Usage
+
+- **Do**: Use tooltips for helpful context and validation errors
+- **Don't**: Overuse tooltips - they can be distracting
+- **Accessibility**: Always ensure tooltips are keyboard-accessible
+
+```html
+<!-- Good: Helpful tooltip -->
+<button data-tooltip="Save your changes (Ctrl+S)">
+    Save
+</button>
+
+<!-- Bad: Obvious tooltip -->
+<button data-tooltip="Click to save">
+    Save
+</button>
+```
+
+### 2. Loading States
+
+- **Do**: Use skeleton loading for content-heavy updates
+- **Do**: Use spinners for quick actions (< 500ms)
+- **Don't**: Show loading for optimistic UI updates
+- **Do**: Configure appropriate delays to prevent flickering
+
+```php
+// Good: Appropriate loading type
+#[Loading(type: 'skeleton', fragments: ['product-list'])]
+public function loadProducts(): void { }
+
+// Good: Quick action with spinner
+#[Loading(type: 'spinner', showDelay: 0)]
+public function toggleFavorite(): void { }
+```
+
+### 3. Notifications
+
+- **Do**: Use notifications for important feedback
+- **Don't**: Overuse notifications - they can be annoying
+- **Do**: Set appropriate durations (5s for success, longer for errors)
+- **Do**: Provide action buttons for actionable notifications
+
+```php
+// Good: Clear, actionable notification
+$notification = new NotificationState(
+    message: 'File uploaded successfully',
+    type: 'success',
+    duration: 5000,
+    actionText: 'View',
+    actionUrl: '/files'
+);
+
+// Bad: Too many notifications
+// Don't show a notification for every minor action
+```
+
+### 4. Modals & Dialogs
+
+- **Do**: Use modals for important confirmations
+- **Don't**: Overuse modals - they interrupt user flow
+- **Do**: Provide clear action buttons
+- **Do**: Support keyboard navigation (Escape to close)
+
+```php
+// Good: Clear confirmation dialog
+$this->uiHelper->showConfirm(
+    title: 'Delete Item',
+    message: 'This action cannot be undone.',
+    confirmText: 'Delete',
+    cancelText: 'Cancel'
+);
+```
+
+### 5. Error Handling
+
+- **Do**: Use ErrorBoundary for automatic error handling
+- **Do**: Show user-friendly error messages
+- **Do**: Provide retry options for recoverable errors
+- **Don't**: Show technical error details to users
+
+```php
+// Good: User-friendly error
+throw LiveComponentError::validation(
+    'Please enter a valid email address',
+    ['field' => 'email'],
+    $this->id->toString()
+);
+
+// Bad: Technical error
+throw new \Exception('Invalid email format: ' . $email);
+```
+
+---
+
+## Configuration
+
+### Global Configuration
+
+```javascript
+import { sharedConfig } from './modules/livecomponent/SharedConfig.js';
+
+// Configure default values
+sharedConfig.defaultDebounce = 300;
+sharedConfig.defaultCacheTTL = 5000;
+sharedConfig.defaultLoadingShowDelay = 150;
+sharedConfig.defaultLoadingType = 'skeleton';
+sharedConfig.defaultNotificationDuration = 5000;
+sharedConfig.defaultNotificationPosition = 'top-right';
+sharedConfig.defaultModalAnimation = 'fade';
+```
+
+### Per-Component Configuration
+
+```html
+<!-- Component-level configuration -->
+<div
+    data-live-component="component-id"
+    data-loading-type="skeleton"
+    data-loading-show-delay="200"
+    data-notification-position="bottom-right"
+>
+    <!-- Component content -->
+</div>
+```
+
+---
+
+## Troubleshooting
+
+### Tooltips Not Showing
+
+1. Check that `data-tooltip` attribute is present
+2. Verify TooltipManager is initialized
+3. Check browser console for errors
+4. Ensure element is visible and not hidden
+
+### Loading States Not Working
+
+1. Verify `data-loading-type` attribute is set
+2. Check that fragments match between HTML and PHP
+3. Ensure LoadingStateManager is initialized
+4. Check for JavaScript errors in console
+
+### Notifications Not Displaying
+
+1. Verify NotificationComponent is mounted
+2. Check that component ID matches
+3. Ensure state is properly serialized
+4. Check browser console for errors
+
+### Modals Not Opening
+
+1. Verify UIManager is initialized
+2. Check that modal content is valid HTML
+3. Ensure no JavaScript errors are blocking execution
+4. Check z-index conflicts
+
+---
+
+**Next**: [API Reference](api-reference.md) →
+
diff --git a/docs/modules/analytics.md b/docs/modules/analytics.md
new file mode 100644
index 00000000..6e473588
--- /dev/null
+++ b/docs/modules/analytics.md
@@ -0,0 +1,340 @@
+# Analytics Module
+
+**Unified Analytics System for Event Tracking and User Behavior**
+
+The Analytics Module provides a comprehensive analytics system with GDPR compliance and multiple provider support.
+
+---
+
+## Features
+
+- **Event Tracking** - Track custom events
+- **Page View Tracking** - Automatic and manual page view tracking
+- **User Behavior Tracking** - Track user interactions
+- **Multiple Providers** - Support for Google Analytics, custom endpoints, and more
+- **GDPR Compliance** - Consent management and data anonymization
+- **Integration with LiveComponents** - Automatic tracking of LiveComponent events
+- **User Identification** - Identify users for user-level analytics
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { Analytics } from './modules/analytics/index.js';
+
+// Create analytics instance
+const analytics = Analytics.create({
+    providers: ['google-analytics'],
+    gdprCompliant: true,
+    requireConsent: true
+});
+
+// Give consent (GDPR)
+analytics.giveConsent();
+
+// Track event
+await analytics.track('button_click', {
+    button_id: 'submit',
+    page: '/contact'
+});
+
+// Track page view
+await analytics.trackPageView('/dashboard');
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global analytics -->
+<script type="module">
+    import { init } from './modules/analytics/index.js';
+    
+    init({
+        providers: [
+            {
+                type: 'google-analytics',
+                measurementId: 'G-XXXXXXXXXX'
+            },
+            {
+                type: 'custom',
+                endpoint: '/api/analytics'
+            }
+        ],
+        gdprCompliant: true,
+        requireConsent: true
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    // Give consent
+    window.Analytics.giveConsent();
+    
+    // Track event
+    window.Analytics.track('purchase', {
+        value: 99.99,
+        currency: 'EUR'
+    });
+</script>
+```
+
+---
+
+## API Reference
+
+### Analytics.create(config)
+
+Create a new Analytics instance.
+
+**Parameters**:
+- `config.enabled` - Enable analytics (default: true)
+- `config.providers` - Array of provider configs
+- `config.gdprCompliant` - Enable GDPR compliance (default: true)
+- `config.requireConsent` - Require user consent (default: false)
+- `config.anonymizeIp` - Anonymize IP addresses (default: true)
+
+### analytics.track(eventName, properties)
+
+Track a custom event.
+
+**Parameters**:
+- `eventName` - Event name
+- `properties` - Event properties
+
+**Example**:
+```javascript
+await analytics.track('purchase', {
+    value: 99.99,
+    currency: 'EUR',
+    items: [{ id: 'product-1', quantity: 1 }]
+});
+```
+
+### analytics.trackPageView(path, properties)
+
+Track a page view.
+
+**Parameters**:
+- `path` - Page path (optional, defaults to current path)
+- `properties` - Additional properties
+
+### analytics.identify(userId, traits)
+
+Identify a user.
+
+**Parameters**:
+- `userId` - User ID
+- `traits` - User traits (name, email, etc.)
+
+**Example**:
+```javascript
+await analytics.identify('user-123', {
+    name: 'John Doe',
+    email: 'john@example.com'
+});
+```
+
+### analytics.trackBehavior(action, target, properties)
+
+Track user behavior.
+
+**Parameters**:
+- `action` - Action type (click, scroll, etc.)
+- `target` - Target element or identifier
+- `properties` - Additional properties
+
+### analytics.giveConsent()
+
+Give GDPR consent.
+
+### analytics.revokeConsent()
+
+Revoke GDPR consent.
+
+---
+
+## Providers
+
+### Google Analytics
+
+```javascript
+const analytics = Analytics.create({
+    providers: [
+        {
+            type: 'google-analytics',
+            measurementId: 'G-XXXXXXXXXX'
+        }
+    ]
+});
+```
+
+### Custom Provider
+
+```javascript
+const analytics = Analytics.create({
+    providers: [
+        {
+            type: 'custom',
+            endpoint: '/api/analytics'
+        }
+    ]
+});
+```
+
+### Multiple Providers
+
+```javascript
+const analytics = Analytics.create({
+    providers: [
+        'google-analytics',
+        {
+            type: 'custom',
+            endpoint: '/api/analytics'
+        }
+    ]
+});
+```
+
+---
+
+## GDPR Compliance
+
+### Consent Management
+
+```javascript
+const analytics = Analytics.create({
+    requireConsent: true,
+    gdprCompliant: true
+});
+
+// Show consent banner
+showConsentBanner(() => {
+    analytics.giveConsent();
+});
+```
+
+### Data Anonymization
+
+```javascript
+// IP addresses are automatically anonymized
+// PII fields are automatically removed
+await analytics.track('event', {
+    email: 'user@example.com', // Will be removed
+    ip: '192.168.1.1' // Will be anonymized to 192.168.1.0
+});
+```
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { Analytics } from './modules/analytics/index.js';
+import { LiveComponent } from './modules/livecomponent/index.js';
+
+const analytics = Analytics.create();
+
+// Track LiveComponent actions
+LiveComponent.on('action-executed', (componentId, actionName, params) => {
+    analytics.track('livecomponent:action', {
+        component_id: componentId,
+        action: actionName,
+        params
+    });
+});
+
+// Track component updates
+LiveComponent.on('component-updated', (componentId) => {
+    analytics.track('livecomponent:updated', {
+        component_id: componentId
+    });
+});
+```
+
+---
+
+## Use Cases
+
+### E-commerce Tracking
+
+```javascript
+// Track purchase
+await analytics.track('purchase', {
+    value: 99.99,
+    currency: 'EUR',
+    items: [
+        { id: 'product-1', name: 'Product 1', price: 49.99, quantity: 1 },
+        { id: 'product-2', name: 'Product 2', price: 50.00, quantity: 1 }
+    ]
+});
+
+// Track add to cart
+await analytics.track('add_to_cart', {
+    product_id: 'product-1',
+    value: 49.99
+});
+```
+
+### User Behavior Tracking
+
+```javascript
+// Track button clicks
+document.addEventListener('click', (event) => {
+    if (event.target.matches('[data-track]')) {
+        analytics.trackBehavior('click', event.target.id, {
+            text: event.target.textContent
+        });
+    }
+});
+
+// Track form submissions
+document.addEventListener('submit', (event) => {
+    analytics.track('form_submit', {
+        form_id: event.target.id,
+        form_name: event.target.name
+    });
+});
+```
+
+### Page View Tracking
+
+```javascript
+// Automatic tracking on navigation
+// Or manual tracking
+await analytics.trackPageView('/dashboard', {
+    section: 'admin',
+    user_role: 'admin'
+});
+```
+
+---
+
+## Best Practices
+
+1. **Respect User Privacy** - Always get consent before tracking
+2. **Anonymize Data** - Remove PII and anonymize IPs
+3. **Track Meaningful Events** - Focus on business-critical events
+4. **Use Consistent Naming** - Use consistent event names
+5. **Monitor Performance** - Don't let analytics slow down the app
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- Fetch API
+- CustomEvent support
+
+---
+
+**Next**: Continue with remaining modules →
+
diff --git a/docs/modules/animation-system-migration.md b/docs/modules/animation-system-migration.md
new file mode 100644
index 00000000..afd8e0c2
--- /dev/null
+++ b/docs/modules/animation-system-migration.md
@@ -0,0 +1,180 @@
+# Animation System Migration Guide
+
+**Complete Migration Guide from Old Scroll Animation Modules to Unified Animation System**
+
+This guide helps you migrate from the old scroll animation modules to the new unified Animation System.
+
+---
+
+## Overview
+
+The Animation System consolidates 8 separate modules into one unified system:
+
+- `scrollfx` → `AnimationSystem` (fade-in, zoom-in)
+- `parallax` → `AnimationSystem` (parallax)
+- `scroll-timeline` → `AnimationSystem` (timeline)
+- `scroll-loop` → `AnimationSystem` (timeline with loop)
+- `scroll-dependent` → `AnimationSystem` (dependent animations)
+- `sticky-fade` → `AnimationSystem` (sticky-fade)
+- `sticky-steps` → `AnimationSystem` (sticky-steps)
+- `smooth-scroll` → Keep separate (different purpose)
+
+---
+
+## Migration Steps
+
+### 1. Update Imports
+
+**Before**:
+```javascript
+import { createTrigger } from './modules/scrollfx/index.js';
+import { init as initParallax } from './modules/parallax/index.js';
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+```
+
+### 2. Update Initialization
+
+**Before**:
+```javascript
+createTrigger({ element: '.fade-in', offset: 0.85 });
+initParallax({ selector: '.parallax' });
+```
+
+**After**:
+```javascript
+const system = AnimationSystem.create();
+// Auto-initializes based on HTML attributes
+// Or manually:
+document.querySelectorAll('.fade-in').forEach(el => {
+    system.registerAnimation(el, { type: 'fade-in', offset: 0.85 });
+});
+```
+
+### 3. Update HTML Attributes
+
+Most HTML attributes remain compatible, but you can use new unified attributes:
+
+**Before**:
+```html
+<div class="fade-in-on-scroll" data-offset="0.85">Content</div>
+<div class="parallax" data-speed="0.5">Content</div>
+```
+
+**After** (still works, or use new format):
+```html
+<div data-animate="fade-in" data-offset="0.85">Content</div>
+<div data-parallax data-speed="0.5">Content</div>
+```
+
+---
+
+## Module-Specific Migrations
+
+### scrollfx → AnimationSystem
+
+**Before**:
+```javascript
+import { createTrigger } from './modules/scrollfx/index.js';
+createTrigger({
+    element: '.fade-in',
+    offset: 0.85,
+    baseDelay: 0.05,
+    once: true
+});
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+const system = AnimationSystem.create();
+document.querySelectorAll('.fade-in').forEach((el, index) => {
+    system.registerAnimation(el, {
+        type: 'fade-in',
+        offset: 0.85,
+        delay: index * 0.05,
+        once: true
+    });
+});
+```
+
+### parallax → AnimationSystem
+
+**Before**:
+```javascript
+import { init } from './modules/parallax/index.js';
+init({ selector: '.parallax', speed: 0.5 });
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+const system = AnimationSystem.create();
+document.querySelectorAll('.parallax').forEach(el => {
+    system.registerAnimation(el, {
+        type: 'parallax',
+        speed: 0.5
+    });
+});
+```
+
+### scroll-timeline → AnimationSystem
+
+**Before**:
+```javascript
+import { init } from './modules/scroll-timeline/index.js';
+init({ attribute: 'data-scroll-step', triggerPoint: 0.4 });
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+const system = AnimationSystem.create();
+document.querySelectorAll('[data-scroll-step]').forEach(el => {
+    system.registerAnimation(el, {
+        type: 'timeline',
+        steps: parseInt(el.dataset.scrollSteps) || null,
+        triggerPoint: 0.4
+    });
+});
+```
+
+---
+
+## Backward Compatibility
+
+The Animation System maintains backward compatibility with existing HTML:
+
+- Old CSS classes still work: `.fade-in-on-scroll`, `.zoom-in`, `.parallax`
+- Old data attributes still work: `data-parallax`, `data-scroll-step`, etc.
+- Old module initialization still works (but deprecated)
+
+---
+
+## Breaking Changes
+
+1. **Module Exports** - Old module exports are deprecated
+2. **JavaScript API** - Some APIs have changed (see migration examples)
+3. **Configuration** - Some config options have been renamed
+
+---
+
+## Testing Checklist
+
+- [ ] All fade-in animations work
+- [ ] All parallax effects work
+- [ ] All timeline animations work
+- [ ] All sticky animations work
+- [ ] Performance is acceptable
+- [ ] No console errors
+- [ ] Backward compatibility maintained
+
+---
+
+## Support
+
+For issues or questions, see the main [Animation System documentation](animation-system.md).
+
diff --git a/docs/modules/animation-system.md b/docs/modules/animation-system.md
new file mode 100644
index 00000000..7a8d3920
--- /dev/null
+++ b/docs/modules/animation-system.md
@@ -0,0 +1,270 @@
+# Animation System Module
+
+**Unified Animation System for Scroll-Based Animations**
+
+The Animation System Module consolidates all scroll animation modules into a single, unified system with backward compatibility.
+
+---
+
+## Features
+
+- **Fade-In Animations** - Elements fade in when scrolling into view
+- **Zoom-In Animations** - Elements zoom in when scrolling into view
+- **Parallax Effects** - Parallax scrolling effects
+- **Scroll Timeline** - Step-based scroll animations
+- **Sticky Fade** - Fade effects on sticky elements
+- **Sticky Steps** - Step-based animations on sticky elements
+- **IntersectionObserver Support** - Efficient scroll detection
+- **Backward Compatibility** - Works with existing HTML attributes
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+
+// Create animation system
+const system = AnimationSystem.create({
+    enabled: true,
+    useIntersectionObserver: true
+});
+
+// Register animation
+system.registerAnimation(element, {
+    type: 'fade-in',
+    offset: 0.85,
+    delay: 0.1,
+    once: true
+});
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global animation system -->
+<script type="module">
+    import { init } from './modules/animation-system/index.js';
+    
+    init({
+        enabled: true,
+        useIntersectionObserver: true
+    });
+</script>
+
+<!-- Use data attributes (auto-initialized) -->
+<div class="fade-in-on-scroll" data-offset="0.85" data-delay="0.1">
+    Content that fades in
+</div>
+
+<div data-parallax data-speed="0.5">
+    Parallax content
+</div>
+```
+
+---
+
+## API Reference
+
+### AnimationSystem.create(config)
+
+Create a new AnimationSystem instance.
+
+**Parameters**:
+- `config.enabled` - Enable animations (default: true)
+- `config.useIntersectionObserver` - Use IntersectionObserver (default: true)
+- `config.throttleDelay` - Throttle delay for scroll handler (default: 16ms)
+
+### system.registerAnimation(element, config)
+
+Register an animation for an element.
+
+**Parameters**:
+- `element` - HTMLElement
+- `config.type` - Animation type
+- `config.offset` - Trigger offset (0-1)
+- `config.delay` - Animation delay
+- `config.once` - Trigger only once
+- `config.speed` - Parallax speed
+- `config.steps` - Number of steps
+- `config.triggerPoint` - Trigger point (0-1)
+
+---
+
+## Animation Types
+
+### Fade-In
+
+```javascript
+system.registerAnimation(element, {
+    type: 'fade-in',
+    offset: 0.85,
+    delay: 0.1,
+    once: true
+});
+```
+
+### Zoom-In
+
+```javascript
+system.registerAnimation(element, {
+    type: 'zoom-in',
+    offset: 0.85,
+    delay: 0.1
+});
+```
+
+### Parallax
+
+```javascript
+system.registerAnimation(element, {
+    type: 'parallax',
+    speed: 0.5
+});
+```
+
+### Timeline
+
+```javascript
+system.registerAnimation(element, {
+    type: 'timeline',
+    steps: 5,
+    triggerPoint: 0.4
+});
+```
+
+### Sticky Fade
+
+```javascript
+system.registerAnimation(element, {
+    type: 'sticky-fade',
+    fadeStart: 0,
+    fadeEnd: 1
+});
+```
+
+### Sticky Steps
+
+```javascript
+system.registerAnimation(element, {
+    type: 'sticky-steps',
+    steps: 3
+});
+```
+
+---
+
+## HTML Data Attributes
+
+### Auto-Initialization
+
+The system automatically initializes animations based on HTML attributes:
+
+```html
+<!-- Fade in -->
+<div class="fade-in-on-scroll" data-offset="0.85" data-delay="0.1">
+    Content
+</div>
+
+<!-- Parallax -->
+<div data-parallax data-speed="0.5">
+    Parallax content
+</div>
+
+<!-- Timeline -->
+<div data-scroll-timeline data-scroll-steps="5">
+    Timeline content
+</div>
+
+<!-- Sticky fade -->
+<div data-sticky-fade data-fade-start="0" data-fade-end="1">
+    Sticky content
+</div>
+```
+
+---
+
+## Backward Compatibility
+
+The system maintains backward compatibility with old modules:
+
+```html
+<!-- Old scrollfx classes still work -->
+<div class="fade-in-on-scroll">Content</div>
+<div class="zoom-in">Content</div>
+
+<!-- Old parallax attributes still work -->
+<div class="parallax" data-speed="0.5">Content</div>
+
+<!-- Old scroll-timeline attributes still work -->
+<div data-scroll-step="0">Content</div>
+```
+
+---
+
+## Migration Guide
+
+### From scrollfx
+
+**Before**:
+```javascript
+import { createTrigger } from './modules/scrollfx/index.js';
+createTrigger({ element: '.fade-in', offset: 0.85 });
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+const system = AnimationSystem.create();
+document.querySelectorAll('.fade-in').forEach(el => {
+    system.registerAnimation(el, { type: 'fade-in', offset: 0.85 });
+});
+```
+
+### From parallax
+
+**Before**:
+```javascript
+import { init } from './modules/parallax/index.js';
+init({ selector: '.parallax' });
+```
+
+**After**:
+```javascript
+import { AnimationSystem } from './modules/animation-system/index.js';
+const system = AnimationSystem.create();
+document.querySelectorAll('.parallax').forEach(el => {
+    system.registerAnimation(el, { type: 'parallax', speed: 0.5 });
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use IntersectionObserver** - More efficient than scroll listeners
+2. **Set Appropriate Offsets** - Balance visibility with performance
+3. **Use Once for Performance** - Set `once: true` for elements that don't need to re-animate
+4. **Throttle Updates** - Use appropriate throttle delays
+5. **Clean Up** - Remove animations when elements are removed
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- IntersectionObserver (for efficient detection)
+- requestAnimationFrame (for smooth animations)
+
+---
+
+**Next**: Continue with remaining modules →
+
diff --git a/docs/modules/cache-manager.md b/docs/modules/cache-manager.md
new file mode 100644
index 00000000..b79d1675
--- /dev/null
+++ b/docs/modules/cache-manager.md
@@ -0,0 +1,382 @@
+# Cache Manager Module
+
+**Intelligent Caching for API Responses and Computed Values**
+
+The Cache Manager Module provides a comprehensive caching system with multiple storage backends and caching strategies.
+
+---
+
+## Features
+
+- **Memory Cache** - Fast in-memory caching
+- **IndexedDB Cache** - Persistent browser storage
+- **Cache Strategies** - Multiple caching strategies (cache-first, network-first, stale-while-revalidate, etc.)
+- **Cache Invalidation** - Pattern-based cache invalidation
+- **Cache Warming** - Preload cache values
+- **Cache Analytics** - Track cache performance
+- **Integration with RequestDeduplicator** - Works with LiveComponent request deduplication
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { CacheManager, CacheStrategy } from './modules/cache-manager/index.js';
+
+// Create cache manager
+const cache = CacheManager.create({
+    defaultStrategy: CacheStrategy.STALE_WHILE_REVALIDATE,
+    defaultTTL: 3600000 // 1 hour
+});
+
+// Get or set value
+const data = await cache.getOrSet('users', async () => {
+    const response = await fetch('/api/users');
+    return await response.json();
+});
+
+// Get from cache
+const cached = await cache.get('users');
+
+// Set in cache
+await cache.set('users', data, { ttl: 1800000 }); // 30 minutes
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global cache manager -->
+<script type="module">
+    import { init } from './modules/cache-manager/index.js';
+    
+    init({
+        defaultStrategy: 'stale-while-revalidate',
+        enableIndexedDB: true
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    // Get or set
+    const data = await window.CacheManager.getOrSet('key', async () => {
+        return await fetch('/api/data').then(r => r.json());
+    });
+</script>
+```
+
+---
+
+## API Reference
+
+### CacheManager.create(config)
+
+Create a new CacheManager instance.
+
+**Parameters**:
+- `config.defaultStrategy` - Default caching strategy
+- `config.defaultTTL` - Default time-to-live in milliseconds
+- `config.maxMemorySize` - Maximum items in memory cache
+- `config.enableIndexedDB` - Enable IndexedDB persistence
+- `config.indexedDBName` - IndexedDB database name
+- `config.enableAnalytics` - Enable cache analytics
+
+**Example**:
+```javascript
+const cache = CacheManager.create({
+    defaultStrategy: CacheStrategy.STALE_WHILE_REVALIDATE,
+    defaultTTL: 3600000,
+    maxMemorySize: 100,
+    enableIndexedDB: true
+});
+```
+
+### cache.get(key, options)
+
+Get value from cache.
+
+**Parameters**:
+- `key` - Cache key
+- `options.strategy` - Caching strategy override
+- `options.ttl` - Time-to-live override
+
+**Returns**: `Promise<any | null>`
+
+### cache.set(key, value, options)
+
+Set value in cache.
+
+**Parameters**:
+- `key` - Cache key
+- `value` - Value to cache
+- `options.strategy` - Caching strategy
+- `options.ttl` - Time-to-live
+
+**Returns**: `Promise<void>`
+
+### cache.getOrSet(key, computeFn, options)
+
+Get value from cache or compute and cache it.
+
+**Parameters**:
+- `key` - Cache key
+- `computeFn` - Function to compute value if not cached
+- `options` - Cache options
+
+**Returns**: `Promise<any>`
+
+**Example**:
+```javascript
+const users = await cache.getOrSet('users', async () => {
+    const response = await fetch('/api/users');
+    return await response.json();
+}, { ttl: 1800000 });
+```
+
+### cache.delete(key)
+
+Delete value from cache.
+
+**Parameters**:
+- `key` - Cache key
+
+**Returns**: `Promise<void>`
+
+### cache.clear()
+
+Clear all cache.
+
+**Returns**: `Promise<void>`
+
+### cache.invalidate(pattern)
+
+Invalidate cache entries matching a pattern.
+
+**Parameters**:
+- `pattern` - String, RegExp, or function
+
+**Returns**: `Promise<void>`
+
+**Example**:
+```javascript
+// Invalidate all user-related cache
+await cache.invalidate('user:');
+
+// Invalidate with regex
+await cache.invalidate(/^user:\d+$/);
+
+// Invalidate with function
+await cache.invalidate(key => key.startsWith('user:'));
+```
+
+### cache.warm(keys, computeFn)
+
+Warm cache by preloading values.
+
+**Parameters**:
+- `keys` - Array of cache keys
+- `computeFn` - Function to compute value for each key
+
+**Returns**: `Promise<void>`
+
+**Example**:
+```javascript
+await cache.warm(['user:1', 'user:2', 'user:3'], async (key) => {
+    const userId = key.split(':')[1];
+    const response = await fetch(`/api/users/${userId}`);
+    return await response.json();
+});
+```
+
+### cache.getAnalytics()
+
+Get cache performance analytics.
+
+**Returns**: `CacheAnalytics`
+
+**Example**:
+```javascript
+const analytics = cache.getAnalytics();
+console.log(`Hit rate: ${analytics.hitRate}%`);
+console.log(`Hits: ${analytics.hits}, Misses: ${analytics.misses}`);
+```
+
+---
+
+## Cache Strategies
+
+### Cache-First
+
+Use cache if available, otherwise fetch.
+
+```javascript
+const data = await cache.getOrSet('key', fetchData, {
+    strategy: CacheStrategy.CACHE_FIRST
+});
+```
+
+### Network-First
+
+Try network first, fallback to cache.
+
+```javascript
+const data = await cache.getOrSet('key', fetchData, {
+    strategy: CacheStrategy.NETWORK_FIRST
+});
+```
+
+### Stale-While-Revalidate
+
+Return cache immediately, update in background.
+
+```javascript
+const data = await cache.getOrSet('key', fetchData, {
+    strategy: CacheStrategy.STALE_WHILE_REVALIDATE
+});
+```
+
+### Network-Only
+
+Always fetch from network, never use cache.
+
+```javascript
+const data = await cache.getOrSet('key', fetchData, {
+    strategy: CacheStrategy.NETWORK_ONLY
+});
+```
+
+### Cache-Only
+
+Only use cache, never fetch from network.
+
+```javascript
+const data = await cache.get('key', {
+    strategy: CacheStrategy.CACHE_ONLY
+});
+```
+
+---
+
+## Integration with RequestDeduplicator
+
+```javascript
+import { CacheManager } from './modules/cache-manager/index.js';
+import { RequestDeduplicator } from './modules/livecomponent/RequestDeduplicator.js';
+
+const cache = CacheManager.create();
+const deduplicator = new RequestDeduplicator();
+
+// Use cache with request deduplication
+async function fetchWithCache(url) {
+    return await cache.getOrSet(url, async () => {
+        // Check for pending request
+        const pending = deduplicator.getPendingRequest('api', 'GET', { url });
+        if (pending) {
+            return await pending;
+        }
+        
+        // Make request
+        const promise = fetch(url).then(r => r.json());
+        deduplicator.registerPendingRequest('api', 'GET', { url }, promise);
+        
+        return await promise;
+    });
+}
+```
+
+---
+
+## Use Cases
+
+### API Response Caching
+
+```javascript
+const cache = CacheManager.create({
+    defaultStrategy: CacheStrategy.STALE_WHILE_REVALIDATE,
+    defaultTTL: 300000 // 5 minutes
+});
+
+async function getUsers() {
+    return await cache.getOrSet('api:users', async () => {
+        const response = await fetch('/api/users');
+        return await response.json();
+    });
+}
+```
+
+### Computed Value Caching
+
+```javascript
+const cache = CacheManager.create();
+
+function expensiveComputation(input) {
+    // Expensive operation
+    return input * 2;
+}
+
+async function getComputedValue(input) {
+    const key = `computed:${input}`;
+    return await cache.getOrSet(key, () => expensiveComputation(input), {
+        ttl: 3600000 // Cache for 1 hour
+    });
+}
+```
+
+### Cache Invalidation
+
+```javascript
+// Invalidate all user-related cache when user updates
+async function updateUser(userId, data) {
+    await fetch(`/api/users/${userId}`, {
+        method: 'PUT',
+        body: JSON.stringify(data)
+    });
+    
+    // Invalidate related cache
+    await cache.invalidate(`user:${userId}`);
+    await cache.invalidate('users:list');
+}
+```
+
+### Cache Warming
+
+```javascript
+// Warm cache on page load
+async function warmCache() {
+    await cache.warm(['user:1', 'user:2', 'user:3'], async (key) => {
+        const userId = key.split(':')[1];
+        const response = await fetch(`/api/users/${userId}`);
+        return await response.json();
+    });
+}
+```
+
+---
+
+## Best Practices
+
+1. **Choose Appropriate Strategy** - Use cache-first for static data, network-first for dynamic data
+2. **Set Appropriate TTL** - Balance freshness with performance
+3. **Invalidate on Updates** - Clear cache when data changes
+4. **Use Cache Warming** - Preload frequently accessed data
+5. **Monitor Analytics** - Track cache performance and adjust strategy
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- IndexedDB (for persistent cache)
+- Promise support
+
+---
+
+**Next**: Continue with Phase 3 modules →
+
diff --git a/docs/modules/error-tracking.md b/docs/modules/error-tracking.md
new file mode 100644
index 00000000..79af5325
--- /dev/null
+++ b/docs/modules/error-tracking.md
@@ -0,0 +1,413 @@
+# Error Tracking Module
+
+**Centralized Error Tracking and Reporting**
+
+The Error Tracking Module provides comprehensive error tracking, grouping, and reporting capabilities for production applications.
+
+---
+
+## Features
+
+- **Error Collection** - Automatically capture unhandled errors and promise rejections
+- **Error Grouping** - Group similar errors to reduce noise
+- **Error Reporting** - Send errors to backend for analysis
+- **Error Analytics** - Track error frequency and patterns
+- **Integration with ErrorBoundary** - Works with LiveComponent ErrorBoundary
+- **Source Map Support** - Map minified errors to source code
+- **Error Filtering** - Filter out known or irrelevant errors
+- **Sampling** - Control error reporting volume with sampling
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { ErrorTracker } from './modules/error-tracking/index.js';
+
+// Create error tracker
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    enabled: true,
+    sampleRate: 1.0 // Report 100% of errors
+});
+
+// Manually capture an error
+try {
+    // Some code that might throw
+} catch (error) {
+    tracker.captureException(error, {
+        type: 'user-action',
+        action: 'submit-form'
+    });
+}
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global error tracking -->
+<script type="module">
+    import { init } from './modules/error-tracking/index.js';
+    
+    init({
+        endpoint: '/api/errors',
+        enabled: true,
+        sampleRate: 0.1 // Report 10% of errors
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    // Errors are automatically captured
+    // Or manually capture:
+    window.ErrorTracker.captureException(new Error('Something went wrong'), {
+        context: { userId: 123 }
+    });
+</script>
+```
+
+---
+
+## API Reference
+
+### ErrorTracker.create(config)
+
+Create a new ErrorTracker instance.
+
+**Parameters**:
+- `config.endpoint` - Backend endpoint for error reporting (default: '/api/errors')
+- `config.enabled` - Enable error tracking (default: true)
+- `config.sampleRate` - Sampling rate 0.0 to 1.0 (default: 1.0)
+- `config.maxErrors` - Maximum errors to keep in memory (default: 100)
+- `config.groupingWindow` - Time window for error grouping in ms (default: 60000)
+- `config.includeStack` - Include stack traces (default: true)
+- `config.includeContext` - Include context information (default: true)
+- `config.includeUserAgent` - Include user agent (default: true)
+- `config.includeUrl` - Include current URL (default: true)
+- `config.filters` - Array of filter functions or regex patterns
+- `config.beforeSend` - Hook to modify errors before sending
+
+**Example**:
+```javascript
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    enabled: true,
+    sampleRate: 0.5, // Report 50% of errors
+    filters: [
+        // Filter out specific errors
+        /Script error/i,
+        (error, context) => {
+            // Custom filter logic
+            return error.message.includes('ResizeObserver');
+        }
+    ],
+    beforeSend: (errorData) => {
+        // Add additional context
+        errorData.userId = getCurrentUserId();
+        errorData.sessionId = getSessionId();
+        return errorData;
+    }
+});
+```
+
+### tracker.captureException(error, context)
+
+Manually capture an exception.
+
+**Parameters**:
+- `error` - Error object or any value
+- `context` - Additional context information
+
+**Example**:
+```javascript
+try {
+    // Some code
+} catch (error) {
+    tracker.captureException(error, {
+        type: 'api-call',
+        endpoint: '/api/users',
+        method: 'POST'
+    });
+}
+```
+
+### tracker.report()
+
+Manually flush error reports to backend.
+
+**Example**:
+```javascript
+// Report errors immediately
+await tracker.report();
+```
+
+### tracker.getErrorGroups()
+
+Get grouped errors.
+
+**Returns**: `Array<ErrorGroup>`
+
+**Example**:
+```javascript
+const groups = tracker.getErrorGroups();
+groups.forEach(group => {
+    console.log(`${group.fingerprint}: ${group.count} occurrences`);
+});
+```
+
+### tracker.getErrors()
+
+Get all captured errors.
+
+**Returns**: `Array<ErrorData>`
+
+### tracker.clearErrors()
+
+Clear all captured errors.
+
+---
+
+## Integration with ErrorBoundary
+
+```javascript
+import { ErrorTracker } from './modules/error-tracking/index.js';
+import { ErrorBoundary } from './modules/livecomponent/ErrorBoundary.js';
+
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors'
+});
+
+// ErrorBoundary automatically captures errors
+const errorBoundary = new ErrorBoundary(liveComponentManager);
+
+// Listen for errors
+window.addEventListener('error-tracker:error', (event) => {
+    const errorData = event.detail;
+    console.error('Error captured:', errorData);
+    
+    // Show user-friendly error message
+    showErrorNotification(errorData.message);
+});
+```
+
+---
+
+## Error Filtering
+
+### Filter by Regex
+
+```javascript
+const tracker = ErrorTracker.create({
+    filters: [
+        /Script error/i, // Filter out script errors
+        /ResizeObserver/i // Filter out ResizeObserver errors
+    ]
+});
+```
+
+### Filter by Function
+
+```javascript
+const tracker = ErrorTracker.create({
+    filters: [
+        (error, context) => {
+            // Filter out errors from specific domains
+            if (context.url && context.url.includes('localhost')) {
+                return false; // Don't track localhost errors
+            }
+            return true; // Track other errors
+        }
+    ]
+});
+```
+
+---
+
+## Error Sampling
+
+Control error reporting volume with sampling:
+
+```javascript
+const tracker = ErrorTracker.create({
+    sampleRate: 0.1 // Report only 10% of errors
+});
+```
+
+---
+
+## beforeSend Hook
+
+Modify errors before sending to backend:
+
+```javascript
+const tracker = ErrorTracker.create({
+    beforeSend: (errorData) => {
+        // Add user information
+        errorData.user = {
+            id: getCurrentUserId(),
+            email: getCurrentUserEmail()
+        };
+        
+        // Add session information
+        errorData.session = {
+            id: getSessionId(),
+            startTime: getSessionStartTime()
+        };
+        
+        // Remove sensitive data
+        delete errorData.context.password;
+        
+        // Return modified error data
+        return errorData;
+        
+        // Or return null/false to prevent sending
+        // return null;
+    }
+});
+```
+
+---
+
+## Error Grouping
+
+Errors are automatically grouped by:
+- Error name
+- Error message
+- Stack trace (first 3 lines)
+
+Similar errors are grouped together to reduce noise:
+
+```javascript
+const groups = tracker.getErrorGroups();
+groups.forEach(group => {
+    console.log(`Error: ${group.fingerprint}`);
+    console.log(`Count: ${group.count}`);
+    console.log(`First seen: ${new Date(group.firstSeen)}`);
+    console.log(`Last seen: ${new Date(group.lastSeen)}`);
+});
+```
+
+---
+
+## Backend Integration
+
+The error tracker sends errors to the backend endpoint:
+
+```javascript
+POST /api/errors
+Content-Type: application/json
+
+{
+    "errors": [
+        {
+            "message": "Cannot read property 'x' of undefined",
+            "name": "TypeError",
+            "stack": "...",
+            "timestamp": 1234567890,
+            "type": "unhandled",
+            "context": {
+                "url": "https://example.com/page",
+                "userAgent": "...",
+                "viewport": { "width": 1920, "height": 1080 }
+            }
+        }
+    ],
+    "errorGroups": [
+        {
+            "fingerprint": "TypeError:Cannot read property...",
+            "count": 5,
+            "firstSeen": 1234567890,
+            "lastSeen": 1234567900
+        }
+    ]
+}
+```
+
+---
+
+## Use Cases
+
+### Production Error Tracking
+
+```javascript
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    enabled: true,
+    sampleRate: 0.1, // Sample 10% in production
+    filters: [
+        // Filter out known issues
+        /ResizeObserver/i,
+        /Script error/i
+    ],
+    beforeSend: (errorData) => {
+        // Add user context
+        errorData.userId = getCurrentUserId();
+        return errorData;
+    }
+});
+```
+
+### Development Error Tracking
+
+```javascript
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    enabled: true,
+    sampleRate: 1.0, // Track all errors in development
+    includeStack: true,
+    includeContext: true
+});
+```
+
+### API Error Tracking
+
+```javascript
+async function apiCall(url, options) {
+    try {
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            throw new Error(`API error: ${response.status}`);
+        }
+        return await response.json();
+    } catch (error) {
+        tracker.captureException(error, {
+            type: 'api-error',
+            url,
+            method: options.method || 'GET',
+            status: error.status
+        });
+        throw error;
+    }
+}
+```
+
+---
+
+## Best Practices
+
+1. **Use Sampling in Production** - Set sampleRate to 0.1 or lower to reduce backend load
+2. **Filter Known Issues** - Filter out errors you can't fix (e.g., browser extensions)
+3. **Add Context** - Use beforeSend to add user, session, or request context
+4. **Group Errors** - Let the tracker group similar errors automatically
+5. **Monitor Error Groups** - Track error frequency and patterns
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- Fetch API
+- Promise support
+
+---
+
+**Next**: [Event Bus Module](event-bus.md) →
+
diff --git a/docs/modules/event-bus.md b/docs/modules/event-bus.md
new file mode 100644
index 00000000..fa7c34b5
--- /dev/null
+++ b/docs/modules/event-bus.md
@@ -0,0 +1,370 @@
+# Event Bus Module
+
+**Centralized Event System for Cross-Module Communication**
+
+The Event Bus Module provides a pub/sub event system for decoupled communication between modules, components, and services.
+
+---
+
+## Features
+
+- **Pub/Sub Pattern** - Publish and subscribe to events
+- **Namespaced Events** - Organize events with namespaces (e.g., 'user:created')
+- **Event Filtering** - Filter events by data or conditions
+- **Event History** - Track event history for debugging
+- **Integration with LiveComponents** - Works seamlessly with LiveComponents
+- **Integration with SSE** - Integrate with Server-Sent Events
+- **Wildcard Support** - Subscribe to event patterns
+- **Middleware Support** - Transform or filter events with middleware
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { EventBus } from './modules/event-bus/index.js';
+
+// Create event bus
+const bus = EventBus.create();
+
+// Subscribe to an event
+const unsubscribe = bus.on('user:created', (user) => {
+    console.log('User created:', user);
+});
+
+// Emit an event
+bus.emit('user:created', { id: 1, name: 'John' });
+
+// Unsubscribe
+unsubscribe();
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global event bus -->
+<script type="module">
+    import { init } from './modules/event-bus/index.js';
+    
+    init({
+        enableHistory: true,
+        maxHistorySize: 100
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    // Subscribe
+    window.EventBus.on('user:created', (user) => {
+        console.log('User created:', user);
+    });
+    
+    // Emit
+    window.EventBus.emit('user:created', { id: 1, name: 'John' });
+</script>
+```
+
+---
+
+## API Reference
+
+### EventBus.create(config)
+
+Create a new EventBus instance.
+
+**Parameters**:
+- `config.enableHistory` - Enable event history (default: false)
+- `config.maxHistorySize` - Maximum history size (default: 100)
+- `config.enableWildcards` - Enable wildcard patterns (default: true)
+
+**Example**:
+```javascript
+const bus = EventBus.create({
+    enableHistory: true,
+    maxHistorySize: 50
+});
+```
+
+### bus.on(eventName, callback, options)
+
+Subscribe to an event.
+
+**Parameters**:
+- `eventName` - Event name (supports wildcards: 'user:*', '*')
+- `callback` - Callback function: `(data, eventName, options) => void`
+- `options.once` - Subscribe only once (default: false)
+- `options.priority` - Subscription priority (default: 0)
+- `options.filter` - Filter function: `(data, options) => boolean`
+
+**Returns**: Unsubscribe function
+
+**Example**:
+```javascript
+// Basic subscription
+const unsubscribe = bus.on('user:created', (user) => {
+    console.log('User created:', user);
+});
+
+// Once subscription
+bus.once('user:created', (user) => {
+    console.log('User created (once):', user);
+});
+
+// Priority subscription
+bus.on('user:created', (user) => {
+    console.log('High priority handler');
+}, { priority: 10 });
+
+// Filtered subscription
+bus.on('user:created', (user) => {
+    console.log('Admin user created');
+}, {
+    filter: (user) => user.role === 'admin'
+});
+```
+
+### bus.once(eventName, callback, options)
+
+Subscribe to an event once (auto-unsubscribe after first emission).
+
+**Parameters**: Same as `on()`
+
+**Returns**: Unsubscribe function
+
+### bus.off(eventName, callback)
+
+Unsubscribe from an event.
+
+**Parameters**:
+- `eventName` - Event name
+- `callback` - Callback function to remove
+
+### bus.emit(eventName, data, options)
+
+Emit an event.
+
+**Parameters**:
+- `eventName` - Event name
+- `data` - Event data
+- `options` - Event options
+
+**Example**:
+```javascript
+bus.emit('user:created', { id: 1, name: 'John' });
+bus.emit('user:updated', { id: 1, name: 'Jane' }, { source: 'api' });
+```
+
+### bus.use(middleware)
+
+Add middleware to transform or filter events.
+
+**Parameters**:
+- `middleware` - Middleware function: `(eventName, data, options) => data | null | false`
+
+**Example**:
+```javascript
+// Logging middleware
+bus.use((eventName, data, options) => {
+    console.log(`Event: ${eventName}`, data);
+    return data; // Continue
+});
+
+// Filtering middleware
+bus.use((eventName, data, options) => {
+    if (eventName.startsWith('debug:')) {
+        return null; // Block debug events in production
+    }
+    return data;
+});
+```
+
+### bus.getHistory(filter)
+
+Get event history.
+
+**Parameters**:
+- `filter` - Optional filter (string for event name, or function)
+
+**Returns**: `Array<EventHistoryItem>`
+
+**Example**:
+```javascript
+// Get all history
+const history = bus.getHistory();
+
+// Get history for specific event
+const userHistory = bus.getHistory('user:created');
+
+// Get history with custom filter
+const recentHistory = bus.getHistory((item) => {
+    return Date.now() - item.timestamp < 60000; // Last minute
+});
+```
+
+---
+
+## Namespaced Events
+
+Organize events with namespaces:
+
+```javascript
+// Subscribe to namespace
+bus.on('user:*', (data, eventName) => {
+    console.log(`User event: ${eventName}`, data);
+});
+
+// Emit namespaced events
+bus.emit('user:created', { id: 1 });
+bus.emit('user:updated', { id: 1 });
+bus.emit('user:deleted', { id: 1 });
+```
+
+---
+
+## Wildcard Support
+
+Subscribe to event patterns:
+
+```javascript
+// Subscribe to all events
+bus.on('*', (data, eventName) => {
+    console.log(`Event: ${eventName}`, data);
+});
+
+// Subscribe to pattern
+bus.on('user:*', (data, eventName) => {
+    console.log(`User event: ${eventName}`, data);
+});
+```
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { EventBus } from './modules/event-bus/index.js';
+import { LiveComponentManager } from './modules/livecomponent/index.js';
+
+const bus = EventBus.create();
+const lcManager = LiveComponentManager.getInstance();
+
+// Listen for LiveComponent events
+bus.on('livecomponent:action-executed', (data) => {
+    console.log('Action executed:', data);
+});
+
+// Emit LiveComponent events
+lcManager.on('action-executed', (componentId, actionName, params) => {
+    bus.emit('livecomponent:action-executed', {
+        componentId,
+        actionName,
+        params
+    });
+});
+```
+
+---
+
+## Integration with SSE
+
+```javascript
+import { EventBus } from './modules/event-bus/index.js';
+import { SseClient } from './modules/sse/index.js';
+
+const bus = EventBus.create();
+const sse = new SseClient(['updates']);
+
+// Forward SSE messages to event bus
+sse.on('message', (data) => {
+    bus.emit('sse:message', data);
+});
+
+// Listen for SSE events
+bus.on('sse:message', (data) => {
+    console.log('SSE message:', data);
+});
+```
+
+---
+
+## Use Cases
+
+### Module Communication
+
+```javascript
+// Module A
+const bus = EventBus.create();
+bus.emit('module-a:data-ready', { data: [...] });
+
+// Module B
+bus.on('module-a:data-ready', (data) => {
+    processData(data);
+});
+```
+
+### Component Communication
+
+```javascript
+// Component A
+bus.emit('component:user-selected', { userId: 123 });
+
+// Component B
+bus.on('component:user-selected', (data) => {
+    loadUserDetails(data.userId);
+});
+```
+
+### Global Notifications
+
+```javascript
+// Emit notification
+bus.emit('notification:show', {
+    type: 'success',
+    message: 'Operation completed'
+});
+
+// Listen for notifications
+bus.on('notification:show', (data) => {
+    showNotification(data.type, data.message);
+});
+```
+
+### Analytics Events
+
+```javascript
+// Track events
+bus.on('*', (data, eventName) => {
+    // Send to analytics
+    analytics.track(eventName, data);
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use Namespaces** - Organize events with namespaces (e.g., 'user:created')
+2. **Document Events** - Document all events and their data structures
+3. **Use TypeScript** - Use TypeScript definitions for type safety
+4. **Clean Up Subscriptions** - Always unsubscribe when done
+5. **Use Middleware** - Use middleware for cross-cutting concerns (logging, analytics)
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- Map and Set support
+
+---
+
+**Next**: Continue with Phase 2 modules →
+
diff --git a/docs/modules/router.md b/docs/modules/router.md
new file mode 100644
index 00000000..1be47a3c
--- /dev/null
+++ b/docs/modules/router.md
@@ -0,0 +1,364 @@
+# Router Enhancement Module
+
+**Enhanced Routing with Guards, Middleware, and Analytics**
+
+The Router Enhancement Module provides advanced routing capabilities with access control, middleware, lazy loading, and analytics.
+
+---
+
+## Features
+
+- **Route Guards** - Access control for routes (auth, permissions, roles)
+- **Route Middleware** - Cross-cutting concerns (analytics, loading, etc.)
+- **Lazy Route Loading** - Load routes on demand
+- **Route Analytics** - Track navigation patterns
+- **Integration with LiveComponents** - Seamless integration with LiveComponent system
+- **History & Hash Modes** - Support for both history and hash routing
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { Router, BuiltInGuards, BuiltInMiddleware } from './modules/router/index.js';
+
+// Create router
+const router = Router.create({
+    mode: 'history',
+    base: '/',
+    enableAnalytics: true
+});
+
+// Register routes
+router.routes([
+    {
+        path: '/',
+        component: () => '<div>Home</div>',
+        name: 'home',
+        title: 'Home'
+    },
+    {
+        path: '/dashboard',
+        component: () => '<div>Dashboard</div>',
+        name: 'dashboard',
+        title: 'Dashboard',
+        guards: ['auth'],
+        middleware: ['analytics', 'loading']
+    },
+    {
+        path: '/admin',
+        component: () => import('./components/Admin.js'),
+        name: 'admin',
+        title: 'Admin',
+        guards: ['auth', 'role:admin'],
+        lazy: true
+    }
+]);
+
+// Register guards
+router.guard('auth', async (to, from) => {
+    const isAuthenticated = await checkAuth();
+    if (!isAuthenticated) {
+        return '/login'; // Redirect to login
+    }
+    return true; // Allow navigation
+});
+
+// Add global middleware
+router.use(BuiltInMiddleware.analytics);
+router.use(BuiltInMiddleware.scrollToTop);
+
+// Navigate
+await router.navigate('/dashboard');
+```
+
+---
+
+## API Reference
+
+### Router.create(config)
+
+Create a new Router instance.
+
+**Parameters**:
+- `config.mode` - Routing mode: 'history' or 'hash'
+- `config.base` - Base path
+- `config.enableAnalytics` - Enable route analytics
+
+### router.route(path, config)
+
+Register a single route.
+
+**Parameters**:
+- `path` - Route path
+- `config.component` - Component (string, function, or HTMLElement)
+- `config.name` - Route name
+- `config.title` - Page title
+- `config.guards` - Array of guard names
+- `config.middleware` - Array of middleware
+- `config.lazy` - Lazy load component
+
+### router.guard(name, guardFn)
+
+Register a route guard.
+
+**Parameters**:
+- `name` - Guard name
+- `guardFn` - Guard function: `(to, from, context) => boolean | string`
+
+### router.use(middleware)
+
+Add global middleware.
+
+**Parameters**:
+- `middleware` - Middleware instance, function, or built-in name
+
+### router.beforeEach(hook)
+
+Add before navigation hook.
+
+**Parameters**:
+- `hook` - Hook function: `(to, from) => boolean | string | void`
+
+### router.afterEach(hook)
+
+Add after navigation hook.
+
+**Parameters**:
+- `hook` - Hook function: `(to, from) => void`
+
+### router.navigate(path, options)
+
+Navigate to a route.
+
+**Parameters**:
+- `path` - Route path
+- `options.container` - Container element
+- `options.updateHistory` - Update browser history
+
+**Returns**: `Promise<boolean>`
+
+---
+
+## Route Guards
+
+### Authentication Guard
+
+```javascript
+router.guard('auth', async (to, from) => {
+    if (!isAuthenticated()) {
+        return '/login';
+    }
+    return true;
+});
+
+// Use in route
+router.route('/dashboard', {
+    component: DashboardComponent,
+    guards: ['auth']
+});
+```
+
+### Role Guard
+
+```javascript
+router.guard('admin', async (to, from) => {
+    if (getUserRole() !== 'admin') {
+        return '/unauthorized';
+    }
+    return true;
+});
+
+// Use in route
+router.route('/admin', {
+    component: AdminComponent,
+    guards: ['auth', 'admin']
+});
+```
+
+### Built-in Guards
+
+```javascript
+// Use built-in guards
+router.route('/dashboard', {
+    component: DashboardComponent,
+    guards: ['auth'] // Uses BuiltInGuards.auth
+});
+
+router.route('/login', {
+    component: LoginComponent,
+    guards: ['guest'] // Uses BuiltInGuards.guest
+});
+```
+
+---
+
+## Route Middleware
+
+### Analytics Middleware
+
+```javascript
+// Use built-in analytics middleware
+router.use('analytics');
+
+// Or custom middleware
+router.use(RouteMiddleware.create('custom', async (to, from, next) => {
+    // Track navigation
+    analytics.track('page_view', { path: to.path });
+    next();
+}));
+```
+
+### Loading Middleware
+
+```javascript
+router.use('loading'); // Shows loading indicator during navigation
+```
+
+### Scroll to Top Middleware
+
+```javascript
+router.use('scroll-to-top'); // Scrolls to top after navigation
+```
+
+---
+
+## Lazy Route Loading
+
+```javascript
+router.route('/admin', {
+    component: () => import('./components/Admin.js'),
+    lazy: true
+});
+
+// Or with dynamic import
+router.route('/user/:id', {
+    component: async (route) => {
+        const UserComponent = await import('./components/User.js');
+        return UserComponent.default(route.params.id);
+    },
+    lazy: true
+});
+```
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { Router } from './modules/router/index.js';
+import { LiveComponent } from './modules/livecomponent/index.js';
+
+const router = Router.create();
+
+router.route('/dashboard', {
+    component: async (route) => {
+        // Initialize LiveComponents after navigation
+        const container = document.querySelector('main');
+        container.innerHTML = '<div data-live-component="dashboard"></div>';
+        
+        // Initialize LiveComponent
+        const component = container.querySelector('[data-live-component]');
+        LiveComponent.init(component);
+        
+        return container;
+    }
+});
+```
+
+---
+
+## Route Analytics
+
+```javascript
+const router = Router.create({ enableAnalytics: true });
+
+// Get analytics
+const analytics = router.getAnalytics();
+console.log('Total navigations:', analytics.totalNavigations);
+console.log('Navigation history:', analytics.navigations);
+
+// Listen for navigation events
+window.addEventListener('router:navigation', (event) => {
+    const { to, from, timestamp } = event.detail;
+    console.log(`Navigated from ${from} to ${to}`);
+});
+```
+
+---
+
+## Use Cases
+
+### Protected Routes
+
+```javascript
+router.routes([
+    {
+        path: '/',
+        component: HomeComponent,
+        name: 'home'
+    },
+    {
+        path: '/dashboard',
+        component: DashboardComponent,
+        name: 'dashboard',
+        guards: ['auth']
+    },
+    {
+        path: '/admin',
+        component: AdminComponent,
+        name: 'admin',
+        guards: ['auth', 'admin']
+    }
+]);
+```
+
+### Route with Middleware
+
+```javascript
+router.route('/api-data', {
+    component: ApiDataComponent,
+    middleware: ['analytics', 'loading']
+});
+```
+
+### Lazy Loading
+
+```javascript
+router.route('/heavy-page', {
+    component: () => import('./pages/HeavyPage.js'),
+    lazy: true,
+    guards: ['auth']
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use Guards for Access Control** - Protect routes with guards
+2. **Use Middleware for Cross-Cutting Concerns** - Analytics, loading, etc.
+3. **Lazy Load Heavy Routes** - Improve initial load time
+4. **Track Navigation** - Use analytics to understand user behavior
+5. **Handle Errors** - Provide fallback routes for errors
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- History API (for history mode)
+- Promise support
+
+---
+
+**Next**: [Analytics Module](analytics.md) →
+
diff --git a/docs/modules/security.md b/docs/modules/security.md
new file mode 100644
index 00000000..f443dfb0
--- /dev/null
+++ b/docs/modules/security.md
@@ -0,0 +1,382 @@
+# Security Module
+
+**Security Utilities: CSRF, XSS Protection, and CSP Helpers**
+
+The Security Module provides comprehensive security utilities for client-side security management.
+
+---
+
+## Features
+
+- **CSRF Token Management** - Automatic token refresh and management
+- **XSS Protection** - HTML sanitization and input validation
+- **Content Security Policy** - CSP validation and helpers
+- **Security Headers Validation** - Client-side security header checks
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { SecurityManager } from './modules/security/index.js';
+
+// Create security manager
+const security = SecurityManager.create({
+    csrf: {
+        autoRefresh: true,
+        refreshInterval: 30 * 60 * 1000 // 30 minutes
+    },
+    xss: {
+        enabled: true,
+        sanitizeOnInput: false
+    }
+});
+
+// Get CSRF token
+const token = security.getCsrfToken();
+
+// Use in fetch request
+const response = await fetch('/api/endpoint', {
+    method: 'POST',
+    headers: {
+        ...security.getCsrfTokenHeader(),
+        'Content-Type': 'application/json'
+    },
+    body: JSON.stringify(data)
+});
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global security manager -->
+<script type="module">
+    import { init } from './modules/security/index.js';
+    
+    init({
+        csrf: {
+            autoRefresh: true
+        }
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    // Get CSRF token
+    const token = window.SecurityManager.getCsrfToken();
+    
+    // Refresh token
+    await window.SecurityManager.refreshCsrfToken();
+</script>
+```
+
+---
+
+## API Reference
+
+### SecurityManager.create(config)
+
+Create a new SecurityManager instance.
+
+**Parameters**:
+- `config.csrf` - CSRF manager configuration
+- `config.xss` - XSS protection configuration
+- `config.csp` - CSP configuration
+
+**Example**:
+```javascript
+const security = SecurityManager.create({
+    csrf: {
+        tokenName: '_token',
+        headerName: 'X-CSRF-TOKEN',
+        autoRefresh: true,
+        refreshInterval: 30 * 60 * 1000
+    },
+    xss: {
+        enabled: true,
+        sanitizeOnInput: false
+    }
+});
+```
+
+### security.getCsrfToken()
+
+Get current CSRF token.
+
+**Returns**: `string | null`
+
+### security.getCsrfTokenHeader()
+
+Get CSRF token header object for use in fetch requests.
+
+**Returns**: `Record<string, string>`
+
+**Example**:
+```javascript
+const headers = {
+    ...security.getCsrfTokenHeader(),
+    'Content-Type': 'application/json'
+};
+```
+
+### security.refreshCsrfToken()
+
+Manually refresh CSRF token.
+
+**Returns**: `Promise<void>`
+
+### security.escapeHtml(text)
+
+Escape HTML to prevent XSS.
+
+**Parameters**:
+- `text` - Text to escape
+
+**Returns**: `string`
+
+**Example**:
+```javascript
+const safe = security.escapeHtml('<script>alert("xss")</script>');
+// Returns: &lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;
+```
+
+### security.validateUrl(url)
+
+Validate URL to prevent XSS.
+
+**Parameters**:
+- `url` - URL to validate
+
+**Returns**: `boolean`
+
+**Example**:
+```javascript
+if (security.validateUrl(userInput)) {
+    // Safe to use
+} else {
+    // Potentially dangerous
+}
+```
+
+### security.validateSecurityHeaders()
+
+Validate security headers.
+
+**Returns**: `SecurityHeadersValidation`
+
+**Example**:
+```javascript
+const validation = security.validateSecurityHeaders();
+if (!validation.valid) {
+    console.warn('Security issues:', validation.issues);
+}
+```
+
+---
+
+## CSRF Token Management
+
+### Automatic Token Refresh
+
+```javascript
+const security = SecurityManager.create({
+    csrf: {
+        autoRefresh: true,
+        refreshInterval: 30 * 60 * 1000 // Refresh every 30 minutes
+    }
+});
+```
+
+### Manual Token Refresh
+
+```javascript
+await security.refreshCsrfToken();
+```
+
+### Using Token in Requests
+
+```javascript
+// Get token header
+const headers = security.getCsrfTokenHeader();
+
+// Use in fetch
+const response = await fetch('/api/endpoint', {
+    method: 'POST',
+    headers: {
+        ...headers,
+        'Content-Type': 'application/json'
+    },
+    body: JSON.stringify(data)
+});
+```
+
+---
+
+## XSS Protection
+
+### HTML Sanitization
+
+```javascript
+const security = SecurityManager.create({
+    xss: {
+        enabled: true,
+        sanitizeOnInput: true // Auto-sanitize on input
+    }
+});
+
+// Manual sanitization
+const safe = security.sanitizeHtml(userInput);
+```
+
+### HTML Escaping
+
+```javascript
+const escaped = security.escapeHtml('<script>alert("xss")</script>');
+```
+
+### URL Validation
+
+```javascript
+if (security.validateUrl(userInput)) {
+    // Safe URL
+    window.location.href = userInput;
+} else {
+    // Potentially dangerous
+    console.error('Invalid URL');
+}
+```
+
+---
+
+## Content Security Policy
+
+### CSP Validation
+
+```javascript
+const security = SecurityManager.create({
+    csp: {
+        enabled: true
+    }
+});
+
+// CSP is automatically validated on init
+// Check validation results
+const validation = security.validateSecurityHeaders();
+```
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { SecurityManager } from './modules/security/index.js';
+import { LiveComponentManager } from './modules/livecomponent/index.js';
+
+const security = SecurityManager.create();
+
+// LiveComponents automatically use CSRF tokens
+// But you can also manually update tokens
+security.csrfManager.updateAllTokens();
+```
+
+---
+
+## Integration with Forms
+
+```javascript
+import { SecurityManager } from './modules/security/index.js';
+
+const security = SecurityManager.create();
+
+// Forms automatically get updated CSRF tokens
+// Listen for token refresh events
+window.addEventListener('csrf:token-refreshed', (event) => {
+    console.log('CSRF token refreshed:', event.detail.token);
+});
+```
+
+---
+
+## Use Cases
+
+### API Requests with CSRF
+
+```javascript
+const security = SecurityManager.create();
+
+async function apiCall(url, data) {
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            ...security.getCsrfTokenHeader(),
+            'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(data)
+    });
+    
+    return response.json();
+}
+```
+
+### User Input Sanitization
+
+```javascript
+const security = SecurityManager.create();
+
+function handleUserInput(input) {
+    // Sanitize HTML
+    const sanitized = security.sanitizeHtml(input);
+    
+    // Escape for display
+    const escaped = security.escapeHtml(input);
+    
+    // Validate URL
+    if (security.validateUrl(input)) {
+        // Safe to use as URL
+    }
+}
+```
+
+### Security Headers Check
+
+```javascript
+const security = SecurityManager.create();
+
+// Validate security headers
+const validation = security.validateSecurityHeaders();
+if (!validation.valid) {
+    console.warn('Security issues detected:', validation.issues);
+    // Report to backend or show warning
+}
+```
+
+---
+
+## Best Practices
+
+1. **Always Use CSRF Tokens** - Include CSRF tokens in all state-changing requests
+2. **Sanitize User Input** - Sanitize HTML before displaying user content
+3. **Validate URLs** - Always validate URLs before using them
+4. **Enable Auto-Refresh** - Keep CSRF tokens fresh with auto-refresh
+5. **Check Security Headers** - Validate security headers in development
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- Fetch API
+- CustomEvent support
+
+---
+
+**Next**: [Cache Manager Module](cache-manager.md) →
+
diff --git a/docs/modules/state-manager.md b/docs/modules/state-manager.md
new file mode 100644
index 00000000..c113f9d4
--- /dev/null
+++ b/docs/modules/state-manager.md
@@ -0,0 +1,397 @@
+# State Manager Module
+
+**Centralized, Reactive State Management for Client-Side State**
+
+The State Manager Module provides a centralized state management system similar to Redux or Vuex, with support for state persistence, cross-tab synchronization, and integration with LiveComponents.
+
+---
+
+## Features
+
+- **Reactive State Store** - Subscribe to state changes and react automatically
+- **State Persistence** - Automatically save and restore state from localStorage or sessionStorage
+- **Cross-Tab Synchronization** - Keep state synchronized across browser tabs
+- **Integration with LiveComponents** - Seamless integration with LiveComponent state
+- **Time-Travel Debugging** - Debug state changes with history and time-travel
+- **Middleware Support** - Extend functionality with custom middleware
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { StateManager } from './modules/state-manager/index.js';
+
+// Create a state manager
+const store = StateManager.create({
+    initialState: {
+        user: { name: '', email: '' },
+        cart: { items: [], total: 0 },
+        ui: { sidebarOpen: false }
+    }
+});
+
+// Set state
+store.set('user.name', 'John Doe');
+store.set('cart.items', [{ id: 1, name: 'Product' }]);
+
+// Get state
+const userName = store.get('user.name');
+const cartItems = store.get('cart.items', []);
+
+// Subscribe to changes
+const unsubscribe = store.subscribe('cart.items', (items) => {
+    console.log('Cart items changed:', items);
+    updateCartUI(items);
+});
+
+// Unsubscribe
+unsubscribe();
+```
+
+### Module System Integration
+
+```html
+<!-- Enable global state manager -->
+<script type="module">
+    import { init } from './modules/state-manager/index.js';
+    
+    init({
+        initialState: {
+            user: {},
+            cart: {}
+        },
+        persistence: {
+            enabled: true,
+            storage: 'localStorage',
+            key: 'app-state'
+        }
+    });
+</script>
+
+<!-- Access globally -->
+<script>
+    window.StateManager.set('user.name', 'John');
+    const name = window.StateManager.get('user.name');
+</script>
+```
+
+---
+
+## API Reference
+
+### StateManager.create(config)
+
+Create a new StateManager instance.
+
+**Parameters**:
+- `config.initialState` - Initial state object
+- `config.maxHistorySize` - Maximum history size (default: 50)
+- `config.enableHistory` - Enable history for time-travel (default: false)
+- `config.persistence.enabled` - Enable state persistence (default: false)
+- `config.persistence.storage` - Storage type: 'localStorage' or 'sessionStorage' (default: 'localStorage')
+- `config.persistence.key` - Storage key (default: 'app-state')
+- `config.persistence.paths` - Array of paths to persist (empty = all)
+- `config.sync.enabled` - Enable cross-tab synchronization (default: false)
+
+**Example**:
+```javascript
+const store = StateManager.create({
+    initialState: { user: {}, cart: {} },
+    persistence: {
+        enabled: true,
+        storage: 'localStorage',
+        paths: ['user', 'cart'] // Only persist these paths
+    },
+    sync: {
+        enabled: true // Sync across tabs
+    }
+});
+```
+
+### store.getState()
+
+Get the entire state object.
+
+**Returns**: `Record<string, any>`
+
+### store.get(path, defaultValue)
+
+Get state at a specific path.
+
+**Parameters**:
+- `path` - Dot-separated path (e.g., 'user.name')
+- `defaultValue` - Default value if path doesn't exist
+
+**Returns**: `any`
+
+**Example**:
+```javascript
+const userName = store.get('user.name', 'Guest');
+const cartTotal = store.get('cart.total', 0);
+```
+
+### store.set(path, value)
+
+Set state at a specific path.
+
+**Parameters**:
+- `path` - Dot-separated path
+- `value` - Value to set
+
+**Example**:
+```javascript
+store.set('user.name', 'John Doe');
+store.set('cart.items', [{ id: 1, name: 'Product' }]);
+```
+
+### store.dispatch(action)
+
+Dispatch an action (Redux-style).
+
+**Parameters**:
+- `action` - Action object with `type` property, or a thunk function
+
+**Example**:
+```javascript
+// Simple action
+store.dispatch({
+    type: 'ADD_TO_CART',
+    productId: 123,
+    quantity: 1
+});
+
+// Thunk (async action)
+store.dispatch(async (dispatch, getState) => {
+    const response = await fetch('/api/products');
+    const products = await response.json();
+    dispatch({ type: 'SET_PRODUCTS', products });
+});
+```
+
+### store.subscribe(path, callback)
+
+Subscribe to state changes at a specific path.
+
+**Parameters**:
+- `path` - Dot-separated path, or '*' for all changes
+- `callback` - Callback function: `(newValue, oldValue, path) => void`
+
+**Returns**: Unsubscribe function
+
+**Example**:
+```javascript
+const unsubscribe = store.subscribe('cart.items', (items, oldItems, path) => {
+    console.log(`Cart items changed at ${path}:`, items);
+    updateCartUI(items);
+});
+
+// Later...
+unsubscribe();
+```
+
+### store.subscribeAll(callback)
+
+Subscribe to all state changes.
+
+**Parameters**:
+- `callback` - Callback function: `(state) => void`
+
+**Returns**: Unsubscribe function
+
+### store.use(middleware)
+
+Add middleware to the state manager.
+
+**Parameters**:
+- `middleware` - Middleware function: `(action, getState) => action | null`
+
+**Example**:
+```javascript
+// Logging middleware
+store.use((action, getState) => {
+    console.log('Action:', action);
+    console.log('Current state:', getState());
+    return action; // Return action to continue, or null to block
+});
+
+// Validation middleware
+store.use((action, getState) => {
+    if (action.type === 'SET' && action.path === 'user.email') {
+        if (!isValidEmail(action.value)) {
+            console.error('Invalid email');
+            return null; // Block the action
+        }
+    }
+    return action;
+});
+```
+
+### store.getHistory()
+
+Get action history for time-travel debugging.
+
+**Returns**: `Array<HistoryPoint>`
+
+### store.timeTravel(index)
+
+Time-travel to a specific history point.
+
+**Parameters**:
+- `index` - History index
+
+### store.reset()
+
+Reset state to initial state.
+
+### store.destroy()
+
+Destroy the state manager and clean up resources.
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { StateManager } from './modules/state-manager/index.js';
+import { LiveComponentManager } from './modules/livecomponent/index.js';
+
+const store = StateManager.create();
+const lcManager = LiveComponentManager.getInstance();
+
+// Sync LiveComponent state with StateManager
+lcManager.on('component:state-updated', (componentId, state) => {
+    store.set(`livecomponents.${componentId}`, state);
+});
+
+// Update LiveComponent from StateManager
+store.subscribe('livecomponents', (state) => {
+    Object.entries(state).forEach(([componentId, componentState]) => {
+        lcManager.updateComponentState(componentId, componentState);
+    });
+});
+```
+
+---
+
+## Use Cases
+
+### User Preferences
+
+```javascript
+const store = StateManager.create({
+    initialState: {
+        preferences: {
+            theme: 'light',
+            language: 'en',
+            notifications: true
+        }
+    },
+    persistence: {
+        enabled: true,
+        storage: 'localStorage',
+        paths: ['preferences']
+    }
+});
+
+// Save preference
+store.set('preferences.theme', 'dark');
+
+// Load preference
+const theme = store.get('preferences.theme', 'light');
+```
+
+### Shopping Cart
+
+```javascript
+const store = StateManager.create({
+    initialState: {
+        cart: {
+            items: [],
+            total: 0
+        }
+    },
+    persistence: {
+        enabled: true,
+        storage: 'sessionStorage',
+        paths: ['cart']
+    },
+    sync: {
+        enabled: true // Sync cart across tabs
+    }
+});
+
+// Add item
+store.set('cart.items', [
+    ...store.get('cart.items', []),
+    { id: 1, name: 'Product', price: 99.99 }
+]);
+
+// Calculate total
+store.subscribe('cart.items', (items) => {
+    const total = items.reduce((sum, item) => sum + item.price, 0);
+    store.set('cart.total', total);
+});
+```
+
+### UI State
+
+```javascript
+const store = StateManager.create({
+    initialState: {
+        ui: {
+            sidebarOpen: false,
+            modalOpen: false,
+            activeTab: 'home'
+        }
+    }
+});
+
+// Toggle sidebar
+store.set('ui.sidebarOpen', !store.get('ui.sidebarOpen'));
+
+// Subscribe to UI changes
+store.subscribe('ui', (uiState) => {
+    updateUI(uiState);
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use Scoped State Managers** - Create separate state managers for different features
+2. **Persist Only Necessary Data** - Use `paths` to limit what gets persisted
+3. **Use Middleware for Cross-Cutting Concerns** - Logging, validation, etc.
+4. **Subscribe Selectively** - Only subscribe to paths you need
+5. **Clean Up Subscriptions** - Always call unsubscribe when done
+
+---
+
+## Performance Considerations
+
+- State updates are synchronous and immediate
+- Subscriptions are called synchronously (be careful with expensive operations)
+- Persistence is debounced internally
+- Cross-tab sync uses BroadcastChannel (efficient)
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 38+
+- **Firefox**: 38+
+- **Safari**: 15.4+
+- **Mobile**: iOS 15.4+, Android Chrome 38+
+
+**Required Features**:
+- ES2020 JavaScript
+- BroadcastChannel (for cross-tab sync)
+- localStorage/sessionStorage (for persistence)
+
+---
+
+**Next**: [Validation Module](validation.md) →
+
diff --git a/docs/modules/validation.md b/docs/modules/validation.md
new file mode 100644
index 00000000..4af29d54
--- /dev/null
+++ b/docs/modules/validation.md
@@ -0,0 +1,462 @@
+# Validation Module
+
+**Standalone Validation System for Fields, Forms, and Data**
+
+The Validation Module provides a comprehensive validation system that can be used independently or integrated with form-handling and LiveComponents.
+
+---
+
+## Features
+
+- **Schema-Based Validation** - Define validation rules in a schema
+- **Field-Level Validation** - Validate individual fields
+- **Async Validation** - Support for asynchronous validation (e.g., API checks)
+- **Custom Validation Rules** - Register your own validation rules
+- **Integration with form-handling** - Works seamlessly with form-handling module
+- **Integration with LiveComponents** - Validate LiveComponent data
+- **HTML5 Attribute Support** - Automatically reads validation rules from HTML attributes
+
+---
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { Validator } from './modules/validation/index.js';
+
+// Create validator with schema
+const validator = Validator.create({
+    email: ['required', 'email'],
+    age: [
+        'required',
+        'number',
+        { rule: 'min', options: { value: 18 } },
+        { rule: 'max', options: { value: 100 } }
+    ],
+    password: [
+        'required',
+        { rule: 'minLength', options: { value: 8 } }
+    ]
+});
+
+// Validate data
+const result = await validator.validate({
+    email: 'user@example.com',
+    age: 25,
+    password: 'secret123'
+});
+
+if (result.valid) {
+    console.log('Validation passed');
+} else {
+    console.log('Validation errors:', result.errors);
+}
+```
+
+### From HTML Form
+
+```javascript
+import { Validator } from './modules/validation/index.js';
+
+// Create validator from form element
+const form = document.querySelector('#my-form');
+const validator = Validator.fromForm(form);
+
+// Validate form data
+const formData = new FormData(form);
+const data = Object.fromEntries(formData);
+const result = await validator.validate(data);
+```
+
+---
+
+## API Reference
+
+### Validator.create(schema)
+
+Create a new Validator instance with a schema.
+
+**Parameters**:
+- `schema` - Validation schema object
+
+**Example**:
+```javascript
+const validator = Validator.create({
+    email: 'email',
+    age: ['required', 'number', { rule: 'min', options: { value: 18 } }]
+});
+```
+
+### Validator.fromForm(form)
+
+Create a validator from an HTML form element, reading validation rules from HTML attributes.
+
+**Parameters**:
+- `form` - HTMLFormElement
+
+**Example**:
+```html
+<form id="my-form">
+    <input type="email" name="email" required />
+    <input type="number" name="age" min="18" max="100" required />
+    <input type="password" name="password" minlength="8" required />
+</form>
+```
+
+```javascript
+const form = document.querySelector('#my-form');
+const validator = Validator.fromForm(form);
+```
+
+### validator.validate(data)
+
+Validate entire data object against schema.
+
+**Parameters**:
+- `data` - Data object to validate
+
+**Returns**: `Promise<ValidationResults>`
+
+**Example**:
+```javascript
+const result = await validator.validate({
+    email: 'user@example.com',
+    age: 25
+});
+
+console.log(result.valid); // true or false
+console.log(result.errors); // { email: ['...'], age: ['...'] }
+```
+
+### validator.validateField(fieldName, value)
+
+Validate a single field.
+
+**Parameters**:
+- `fieldName` - Field name
+- `value` - Field value
+
+**Returns**: `Promise<ValidationResult>`
+
+**Example**:
+```javascript
+const result = await validator.validateField('email', 'user@example.com');
+console.log(result.valid); // true or false
+console.log(result.errors); // ['error message']
+```
+
+### validator.validateFields(data, fieldNames)
+
+Validate specific fields.
+
+**Parameters**:
+- `data` - Data object
+- `fieldNames` - Array of field names to validate
+
+**Returns**: `Promise<ValidationResults>`
+
+### validator.registerRule(name, rule)
+
+Register a custom validation rule.
+
+**Parameters**:
+- `name` - Rule name
+- `rule` - Validation function: `(value, options) => boolean | string`
+
+**Example**:
+```javascript
+validator.registerRule('customRule', (value, options) => {
+    if (value === options.expected) {
+        return true;
+    }
+    return options.message || 'Validation failed';
+});
+
+// Use custom rule
+const validator = Validator.create({
+    field: { rule: 'customRule', options: { expected: 'test', message: 'Must be "test"' } }
+});
+```
+
+---
+
+## Built-in Validation Rules
+
+### required
+
+Field must have a value.
+
+```javascript
+email: 'required'
+// or
+email: { rule: 'required', options: { message: 'Email is required' } }
+```
+
+### email
+
+Valid email address format.
+
+```javascript
+email: 'email'
+```
+
+### url
+
+Valid URL format.
+
+```javascript
+website: 'url'
+```
+
+### min / max
+
+Minimum/maximum numeric value.
+
+```javascript
+age: [
+    { rule: 'min', options: { value: 18 } },
+    { rule: 'max', options: { value: 100 } }
+]
+```
+
+### minLength / maxLength
+
+Minimum/maximum string length.
+
+```javascript
+password: [
+    { rule: 'minLength', options: { value: 8 } },
+    { rule: 'maxLength', options: { value: 128 } }
+]
+```
+
+### pattern
+
+Regex pattern validation.
+
+```javascript
+username: {
+    rule: 'pattern',
+    options: {
+        value: '^[a-zA-Z0-9_]+$',
+        message: 'Username can only contain letters, numbers, and underscores'
+    }
+}
+```
+
+### number
+
+Must be a valid number.
+
+```javascript
+price: 'number'
+```
+
+### integer
+
+Must be an integer.
+
+```javascript
+quantity: 'integer'
+```
+
+### phone
+
+Valid phone number format.
+
+```javascript
+phone: 'phone'
+```
+
+### postalCode
+
+Valid postal code (supports DE, US, UK, FR).
+
+```javascript
+postalCode: {
+    rule: 'postalCode',
+    options: { country: 'DE' }
+}
+```
+
+### custom
+
+Custom validation function.
+
+```javascript
+field: {
+    rule: 'custom',
+    options: {
+        validator: (value, options) => {
+            // Custom validation logic
+            return value === options.expected ? true : 'Value must be ' + options.expected;
+        },
+        expected: 'test'
+    }
+}
+```
+
+---
+
+## Async Validation
+
+```javascript
+const validator = Validator.create({
+    email: {
+        rule: 'custom',
+        async: true,
+        validator: async (value, options) => {
+            // Check if email exists via API
+            const response = await fetch(`/api/check-email?email=${value}`);
+            const data = await response.json();
+            
+            if (data.exists) {
+                return 'Email already exists';
+            }
+            return true;
+        }
+    }
+});
+
+const result = await validator.validate({ email: 'user@example.com' });
+```
+
+---
+
+## Integration with form-handling
+
+```javascript
+import { Validator } from './modules/validation/index.js';
+import { FormHandler } from './modules/form-handling/index.js';
+
+const form = document.querySelector('#my-form');
+const validator = Validator.fromForm(form);
+const formHandler = FormHandler.create(form);
+
+// Use validator with form handler
+formHandler.validator = validator;
+```
+
+---
+
+## Integration with LiveComponents
+
+```javascript
+import { Validator } from './modules/validation/index.js';
+import { LiveComponentManager } from './modules/livecomponent/index.js';
+
+const validator = Validator.create({
+    email: ['required', 'email'],
+    name: ['required', { rule: 'minLength', options: { value: 2 } }]
+});
+
+// Validate before action
+const lcManager = LiveComponentManager.getInstance();
+lcManager.on('action:before-execute', async (componentId, actionName, params) => {
+    if (actionName === 'submitForm') {
+        const result = await validator.validate(params);
+        if (!result.valid) {
+            // Handle validation errors
+            return false; // Prevent action
+        }
+    }
+});
+```
+
+---
+
+## Use Cases
+
+### Form Validation
+
+```javascript
+const validator = Validator.create({
+    email: ['required', 'email'],
+    password: [
+        'required',
+        { rule: 'minLength', options: { value: 8 } }
+    ],
+    confirmPassword: [
+        'required',
+        {
+            rule: 'custom',
+            validator: (value, options) => {
+                const password = options.password;
+                return value === password ? true : 'Passwords do not match';
+            },
+            options: { password: formData.password }
+        }
+    ]
+});
+```
+
+### API Response Validation
+
+```javascript
+const validator = Validator.create({
+    id: ['required', 'integer'],
+    name: ['required', { rule: 'minLength', options: { value: 1 } }],
+    email: ['required', 'email']
+});
+
+// Validate API response
+const response = await fetch('/api/user');
+const data = await response.json();
+const result = await validator.validate(data);
+
+if (!result.valid) {
+    console.error('Invalid API response:', result.errors);
+}
+```
+
+### User Input Validation
+
+```javascript
+// Validate on input
+const validator = Validator.create({
+    search: {
+        rule: 'minLength',
+        options: { value: 3, message: 'Search must be at least 3 characters' }
+    }
+});
+
+const input = document.querySelector('#search');
+input.addEventListener('input', async (e) => {
+    const result = await validator.validateField('search', e.target.value);
+    if (!result.valid) {
+        showError(result.errors[0]);
+    } else {
+        hideError();
+    }
+});
+```
+
+---
+
+## Best Practices
+
+1. **Use Schema-Based Validation** - Define validation rules in a schema for reusability
+2. **Register Custom Rules** - Create reusable custom validation rules
+3. **Validate Early** - Validate on blur or input for better UX
+4. **Show Clear Errors** - Display validation errors clearly to users
+5. **Use Async Validation Sparingly** - Only for necessary checks (e.g., email uniqueness)
+
+---
+
+## Browser Support
+
+- **Chrome/Edge**: 90+
+- **Firefox**: 88+
+- **Safari**: 14+
+- **Mobile**: iOS 14+, Android Chrome 90+
+
+**Required Features**:
+- ES2020 JavaScript
+- Promise support
+- Async/await support
+
+---
+
+**Next**: [Error Tracking Module](error-tracking.md) →
+
diff --git a/docs/planning/ADMIN_AUTH_SECURITY_ENHANCEMENT.md b/docs/planning/ADMIN_AUTH_SECURITY_ENHANCEMENT.md
new file mode 100644
index 00000000..13ff487d
--- /dev/null
+++ b/docs/planning/ADMIN_AUTH_SECURITY_ENHANCEMENT.md
@@ -0,0 +1,140 @@
+# Admin Auth Security Enhancement Plan
+
+**Status**: Geplant für später (nach Refactoring anderer Module)  
+**Ansatz**: Starke Web-Authentifizierung ohne VPN
+
+## Überblick
+
+Erweitert das Auth-Modul für den Admin-Bereich mit mehrschichtiger Web-Authentifizierung. Fokus auf starke Authentifizierung mit MFA, Session-Sicherheit und Rate Limiting.
+
+## Sicherheitsebenen
+
+1. **Obligatorisches MFA (TOTP)** - Zweiter Faktor zwingend erforderlich
+2. **Strenge Session-Sicherheit** - Regeneration, IP-Tracking, Timeouts
+3. **Rate Limiting & Account Lockout** - Schutz gegen Brute-Force
+4. **IP-basierte Einschränkungen** (optional) - Zusätzliche Barriere ohne VPN
+5. **Security Headers** - CSRF-Schutz, Secure Cookies, HSTS
+
+## Aktuelle Situation
+
+- Basis-Authentifizierung mit Session-Management vorhanden
+- MFA/TOTP-Services existieren (`TotpService`, `MfaService`), aber nicht vollständig integriert
+- IP-basierte Einschränkungen existieren (`ProductionSecurityMiddleware`)
+- AuthMiddleware ist derzeit deaktiviert
+- RouteAuthorizationService existiert, aber nicht konfiguriert
+
+## Implementation Plan
+
+### Phase 1: Auth-Modul Erweiterung
+
+1. **AdminAuthService** erstellen
+   - Integration mit bestehendem `AuthenticationService`
+   - Admin-spezifische Authentifizierungslogik
+   - Session-Management für Admin-Bereich
+   - IP-Tracking und Session-Regeneration
+   - MFA-Status-Prüfung
+
+2. **MFA-Integration** für Admin-Bereich
+   - TOTP als obligatorische zweite Faktor über `MfaService`/`TotpProvider`
+   - QR-Code-Generierung für Setup
+   - Backup-Codes für Recovery
+   - MFA-Enforcement für alle Admin-Routen
+
+3. **Session-Sicherheit** verbessern
+   - Session-Regeneration bei Login
+   - IP-Konsistenz-Prüfung (warnen bei IP-Wechsel)
+   - Session-Timeouts für Admin-Bereich (kürzer als normale Sessions)
+   - Session-Fixation-Schutz
+   - Secure Cookie-Flags (HttpOnly, Secure, SameSite)
+
+### Phase 2: Route Protection & Authorization
+
+1. **RouteAuthorizationService** aktivieren und konfigurieren
+   - Admin-Namespace (`App\Application\Admin\*`) konfigurieren
+   - IP-basierte Zugriffskontrolle (optional, aber empfohlen)
+   - MFA-Status-Prüfung für alle Admin-Routen
+
+2. **AuthMiddleware** implementieren
+   - Integration mit `RouteAuthorizationService`
+   - Session-Validierung
+   - MFA-Status-Prüfung
+   - Redirect zu Login bei fehlender Authentifizierung
+   - Redirect zu MFA-Setup bei fehlender MFA-Konfiguration
+
+3. **AdminLoginController** erstellen
+   - Login-Formular
+   - MFA-Setup-Flow (wenn noch nicht konfiguriert)
+   - MFA-Verifizierung nach initialem Login
+   - Session-Erstellung
+   - Logout-Funktionalität
+
+### Phase 3: Erweiterte Sicherheitsfeatures
+
+1. **IP-basierte Einschränkungen** (Optional, aber empfohlen)
+   - Statische IP-Whitelist für Admin-Zugriff
+   - CIDR-Notation für IP-Ranges unterstützen
+   - Konfigurierbar über Environment-Variablen
+   - Integration mit `ProductionSecurityMiddleware`
+
+2. **Rate Limiting** für Admin-Bereich
+   - Striktere Limits als für normale User
+   - IP-basierte Rate Limits
+   - Account-Lockout nach fehlgeschlagenen Versuchen
+   - Separate Limits für Login, MFA-Verifizierung
+
+3. **Security Headers**
+   - CSRF-Schutz für alle Admin-Formulare
+   - Secure Cookies (HTTPS-only)
+   - HSTS für Admin-Bereich
+   - Content-Security-Policy
+
+## Dateien die erstellt/geändert werden müssen
+
+### Neue Dateien
+- `src/Framework/Auth/AdminAuthService.php` - Admin-spezifischer Auth-Service
+- `src/Application/Admin/Auth/AdminLoginController.php` - Login-Controller
+- `src/Framework/Auth/MfaRequiredException.php` - Exception für fehlende MFA
+- `src/Framework/Auth/AdminMfaService.php` - MFA-Service für Admin-Bereich
+- `src/Framework/Auth/AdminMfaSetupResult.php` - Result Value Objects
+- `src/Framework/Auth/AdminMfaActivationResult.php`
+- `src/Framework/Auth/AdminMfaVerificationResult.php`
+- `tests/Framework/Auth/AdminAuthServiceTest.php` - Tests
+- `tests/Framework/Auth/AdminMfaServiceTest.php` - MFA-Tests
+
+### Zu erweiternde Dateien
+- `src/Framework/Http/Middlewares/AuthMiddleware.php` - Vollständige Implementierung
+- `src/Framework/Auth/RouteAuthorizationServiceInitializer.php` - Konfiguration aktivieren
+- `src/Framework/Auth/AuthenticationService.php` - MFA-Integration
+- `src/Framework/Http/Middlewares/ProductionSecurityMiddleware.php` - IP-Whitelist-Erweiterung
+- `src/Framework/Config/EnvKey.php` - Environment-Keys hinzufügen
+
+## Konfiguration
+
+### Environment-Variablen
+- `ADMIN_MFA_REQUIRED=true` - MFA obligatorisch
+- `ADMIN_SESSION_TIMEOUT=1800` - Session-Timeout (30 Min)
+- `ADMIN_IP_WHITELIST` - Optionale IP-Whitelist (komma-separiert, CIDR unterstützt)
+- `ADMIN_RATE_LIMIT_ATTEMPTS=3` - Strikte Rate Limits
+- `ADMIN_ACCOUNT_LOCKOUT_DURATION=3600` - Lockout nach Fehlversuchen (1h)
+- `ADMIN_SESSION_REGENERATE_ON_LOGIN=true` - Session-Regeneration
+- `ADMIN_CHECK_IP_CONSISTENCY=true` - IP-Wechsel überwachen
+
+### MFA-Integration
+- Verwende `MfaService` mit `TotpProvider` (nicht direkt `TotpService`)
+- `MfaMethod::TOTP` für TOTP-Authentifizierung
+- `MfaSecret`, `MfaChallenge`, `MfaCode` Value Objects verwenden
+
+## Wichtige Hinweise
+
+- **Kein VPN**: Lösung basiert auf starker Web-Authentifizierung ohne VPN
+- **MFA obligatorisch**: Alle Admin-Routen erfordern konfigurierte und verifizierte MFA
+- **Audit-Logging**: Wird später implementiert, wenn eine vollständige Audit-Lösung im Framework vorhanden ist
+- **IP-Whitelist**: Optional, aber empfohlen für Production
+
+## Referenzen
+
+- MFA-Modul: `src/Framework/Mfa/`
+- TotpProvider: `src/Framework/Mfa/Providers/TotpProvider.php`
+- RouteAuthorizationService: `src/Framework/Auth/RouteAuthorizationService.php`
+- ProductionSecurityMiddleware: `src/Framework/Http/Middlewares/ProductionSecurityMiddleware.php`
+
diff --git a/CLEANUP_PLAN.md b/docs/planning/CLEANUP_PLAN.md
similarity index 100%
rename from CLEANUP_PLAN.md
rename to docs/planning/CLEANUP_PLAN.md
diff --git a/LIVECOMPONENTS_TEST.md b/docs/planning/LIVECOMPONENTS_TEST.md
similarity index 100%
rename from LIVECOMPONENTS_TEST.md
rename to docs/planning/LIVECOMPONENTS_TEST.md
diff --git a/SRC_STRUCTURE_IMPROVEMENTS.md b/docs/planning/SRC_STRUCTURE_IMPROVEMENTS.md
similarity index 100%
rename from SRC_STRUCTURE_IMPROVEMENTS.md
rename to docs/planning/SRC_STRUCTURE_IMPROVEMENTS.md
diff --git a/docs/quality/code-quality-scanner.md b/docs/quality/code-quality-scanner.md
new file mode 100644
index 00000000..156bc762
--- /dev/null
+++ b/docs/quality/code-quality-scanner.md
@@ -0,0 +1,112 @@
+# Code Quality Scanner
+
+This module provides repository-aware rules that validate architectural conventions. It currently ships with the following rules:
+
+- `StringableImplementation`: classes that define `__toString()` must implement `Stringable`
+- `FinalClass`: value-object classes must be declared `final`
+- `ReadonlyClass`: value-object classes must be declared `readonly`
+- `ReadonlyGetter`: readonly properties (or classes) should be exposed directly; avoid `get*()` wrappers
+- `NoInheritance`: inheritance is forbidden (except for a small allow list, e.g. Exceptions)
+
+## Command Line Usage
+
+Run the scanner from the project root:
+
+```bash
+php console.php quality:scan               # scans src/ by default
+php console.php quality:scan app/path      # scan a custom directory
+php console.php quality:scan --skip-errors # skip classes/files that cannot be parsed
+```
+
+The command groups violations by rule and shows file locations:
+
+```
+❌ Found 2 violation(s). Scanned 185 files, 174 classes in 6.91s
+
+StringableImplementation (2)
+  • App\Domain\User\ValueObjects\UserId
+    ↳ src/Domain/User/ValueObjects/UserId.php:42
+    Classes defining __toString() must implement Stringable explicitly.
+```
+
+The exit code is `0` when all checks pass, or `1` when violations are found. You can wire this command into CI to block regressions.
+
+### Skipping Faulty Classes
+
+Some parts of the repository (legacy examples, experimental prototypes, etc.) may not load because they contain invalid PHP constructs or depend on unavailable interfaces. Use the `--skip-errors` flag to collect a warning and continue scanning the remaining classes:
+
+```bash
+php console.php quality:scan --skip-errors
+```
+
+When the flag is omitted, any parsing/reflection error stops the scan and the command exits with a non-zero status.
+
+## Adding New Rules
+
+Rules implement `App\Framework\Quality\CodeQuality\CodeQualityRule`:
+
+```php
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+final class MyCustomRule implements CodeQualityRule
+{
+    public function name(): string
+    {
+        return 'MyCustomRule';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        if ($this->isValid($inspection)) {
+            return [];
+        }
+
+        $line = $inspection->getMethodLine('someMethod');
+
+        return [
+            RuleViolation::create(
+                $inspection->className(),
+                $inspection->filePath(),
+                $this->name(),
+                'Explain what must change.',
+                $line
+            ),
+        ];
+    }
+}
+```
+
+Register the rule inside `CodeQualityScanCommand`:
+
+```php
+$this->scanner = new CodeQualityScanner(
+    $fileScanner,
+    $reflectionService,
+    [
+        new RequireStringableImplementationRule(),
+        new MyCustomRule(),
+    ],
+    $logger
+);
+```
+
+Because rules leverage full reflection data and the actual file path, you have the flexibility to enforce namespacing, attribute usage, dependency boundaries, and more.
+
+## Storage Permissions
+
+The scanner runs inside the console bootstrap. When Redis is unavailable, the framework falls back to the filesystem cache. The cache directory now resolves to `<project-root>/storage/cache`, but you still need to make sure it exists and is writable:
+
+```bash
+mkdir -p storage/cache
+chmod -R ug+rw storage
+```
+
+If you run the command from another working directory (e.g. inside Docker), set the base path explicitly so the cache resolver finds the right storage folder:
+
+```bash
+APP_BASE_PATH=/home/michael/dev/michaelschiemer php console.php quality:scan
+```
+
+The CLI entry point already exports `APP_BASE_PATH`; keep the environment variable handy for custom runners, background workers, or integration tests.
diff --git a/docs/todo/design-token-system-future-features.md b/docs/todo/design-token-system-future-features.md
new file mode 100644
index 00000000..4ac786dc
--- /dev/null
+++ b/docs/todo/design-token-system-future-features.md
@@ -0,0 +1,318 @@
+# Design Token System - Empfohlene Features
+
+## Übersicht
+
+Dieses Dokument beschreibt empfohlene Erweiterungen für das Design Token System, die das System noch mächtiger und flexibler machen würden.
+
+## Phase 1: Datenbank-Speicherung (Priorität: Hoch)
+
+### 1.1 Database Schema
+- **Datei**: `src/Framework/Design/Migrations/CreateDesignTokensTable.php`
+- **Schema**:
+  - `id` (VARCHAR 255, Primary Key)
+  - `name` (VARCHAR 255, NOT NULL)
+  - `type` (VARCHAR 50) - 'color', 'spacing', 'typography', etc.
+  - `state` (VARCHAR 50, DEFAULT 'default')
+  - `scope` (VARCHAR 100) - 'framework', 'admin', etc.
+  - `value_data` (JSON) - Token-Wert
+  - `base_token_id` (VARCHAR 255, NULL) - Für abgeleitete Tokens
+  - `mutation_data` (JSON, NULL) - StateMutation als JSON
+  - `description` (TEXT)
+  - `metadata` (JSON)
+  - `created_at`, `updated_at` (TIMESTAMP)
+  - Indizes: `(name, state, scope)`, `scope`, `type`, `state`
+
+### 1.2 DesignTokenEntity
+- **Datei**: `src/Framework/Design/Database/DesignTokenEntity.php`
+- **Funktionalität**: Entity-Mapping für Design Tokens
+- **Features**:
+  - Serialisierung/Deserialisierung von Token-ValueObjects
+  - StateMutation als JSON speichern/laden
+  - Versionierung von Tokens
+
+### 1.3 DatabaseTokenRepository
+- **Datei**: `src/Framework/Design/Repositories/DatabaseTokenRepository.php`
+- **Funktionalität**:
+  - Lädt Tokens aus Datenbank
+  - Konvertiert DB-Entities zu TokenInterface
+  - Caching für Performance
+  - Filterung nach Scope, Type, State
+
+### 1.4 HybridTokenRegistry
+- **Datei**: `src/Framework/Design/ValueObjects/HybridTokenRegistry.php`
+- **Funktionalität**:
+  - Lädt Code-basierte Tokens (wie bisher)
+  - Lädt DB-Tokens (optional)
+  - Merged beide Quellen (DB überschreibt Code)
+  - Cache für Performance
+  - Hot-Reload für DB-Änderungen (optional)
+
+**Vorteile**:
+- Dynamische Anpassung ohne Code-Deployment
+- UI für Token-Verwaltung möglich
+- Versionierung/Audit-Trail
+- Multi-Tenant Support
+
+## Phase 2: Token-Validierung & Linting (Priorität: Mittel)
+
+### 2.1 Token Validator
+- **Datei**: `src/Framework/Design/Validators/TokenValidator.php`
+- **Funktionalität**:
+  - Validiert Token-Werte (z.B. OKLCH-Werte im gültigen Bereich)
+  - Prüft auf fehlende States
+  - Prüft auf inkonsistente Mutationen
+  - WCAG-Kontrast-Validierung für Farben
+
+### 2.2 Token Linter
+- **Datei**: `src/Framework/Design/Linters/TokenLinter.php`
+- **Funktionalität**:
+  - Prüft Naming Conventions
+  - Prüft auf ungenutzte Tokens
+  - Prüft auf fehlende Fallbacks
+  - Prüft auf Performance-Probleme
+
+### 2.3 Console Command
+- **Datei**: `src/Application/Console/Commands/Design/ValidateTokensCommand.php`
+- **Command**: `design:validate-tokens`
+- **Funktionalität**:
+  - Validiert alle Tokens
+  - Zeigt Linter-Warnungen
+  - Prüft WCAG-Kontrast
+  - Generiert Report
+
+## Phase 3: Token-Export & Import (Priorität: Mittel)
+
+### 3.1 Export-Formate
+- **JSON**: Standard JSON-Format für Tokens
+- **W3C Design Tokens**: W3C Design Tokens Format
+- **Style Dictionary**: Style Dictionary Format
+- **CSS Variables**: Reine CSS Custom Properties
+- **TypeScript**: TypeScript-Typen für Frontend
+
+### 3.2 Import-Formate
+- **JSON**: Import aus JSON
+- **W3C Design Tokens**: Import aus W3C Format
+- **CSS**: Parse bestehende CSS Custom Properties
+- **Figma Tokens**: Import aus Figma Tokens Plugin
+
+### 3.3 Console Commands
+- **Datei**: `src/Application/Console/Commands/Design/ExportTokensCommand.php`
+- **Command**: `design:export-tokens --format=json|w3c|css|typescript`
+- **Datei**: `src/Application/Console/Commands/Design/ImportTokensCommand.php`
+- **Command**: `design:import-tokens --file=path/to/tokens.json --format=json`
+
+## Phase 4: Token-Themes & Varianten (Priorität: Hoch)
+
+### 4.1 Theme System
+- **Datei**: `src/Framework/Design/ValueObjects/Theme.php`
+- **Funktionalität**:
+  - Definiert Theme-Varianten (z.B. "Light", "Dark", "High Contrast")
+  - Theme-spezifische Token-Überschreibungen
+  - Theme-Wechsel zur Laufzeit
+
+### 4.2 Theme Registry
+- **Datei**: `src/Framework/Design/ValueObjects/ThemeRegistry.php`
+- **Funktionalität**:
+  - Verwaltet mehrere Themes
+  - Theme-Aktivierung
+  - Theme-Merging (Basis-Theme + Varianten)
+
+### 4.3 CSS-Generierung für Themes
+- **Erweiterung**: `CssAstBuilder` generiert CSS für alle Themes
+- **Output**: Separate CSS-Dateien oder CSS-Variablen mit Theme-Präfix
+
+**Beispiel**:
+```css
+[data-theme="light"] {
+    --color-primary: oklch(70% 0.2 295);
+}
+
+[data-theme="dark"] {
+    --color-primary: oklch(60% 0.22 295);
+}
+
+[data-theme="high-contrast"] {
+    --color-primary: oklch(50% 0.3 295);
+}
+```
+
+## Phase 5: Token-Dokumentation & Storybook-Integration (Priorität: Niedrig)
+
+### 5.1 Automatische Dokumentation
+- **Datei**: `src/Framework/Design/Documentation/TokenDocumentationGenerator.php`
+- **Funktionalität**:
+  - Generiert Markdown-Dokumentation aus Tokens
+  - Zeigt alle Token-Werte
+  - Zeigt State-Variationen
+  - Zeigt Verwendungsbeispiele
+
+### 5.2 Storybook Integration
+- **Datei**: `src/Framework/Design/Storybook/TokenStoriesGenerator.php`
+- **Funktionalität**:
+  - Generiert Storybook-Stories für Tokens
+  - Visualisiert Token-Werte
+  - Zeigt State-Variationen
+  - Interaktive Token-Exploration
+
+### 5.3 Token-Showcase
+- **Datei**: `src/Application/Admin/Controllers/DesignTokenShowcaseController.php`
+- **Funktionalität**:
+  - Admin-UI für Token-Visualisierung
+  - Interaktive Token-Exploration
+  - State-Variationen anzeigen
+  - Export-Funktionen
+
+## Phase 6: Token-Performance-Optimierung (Priorität: Mittel)
+
+### 6.1 CSS-Optimierung
+- **Minification**: Minimiert generiertes CSS
+- **Tree-Shaking**: Entfernt ungenutzte Tokens
+- **Critical CSS**: Extrahiert kritische Tokens
+- **CSS-Layering**: Optimiert @layer-Struktur
+
+### 6.2 Caching-Strategien
+- **Token-Cache**: Cached geladene Tokens
+- **CSS-Cache**: Cached generiertes CSS
+- **Invalidation**: Intelligente Cache-Invalidierung
+- **Preloading**: Preload häufig verwendeter Tokens
+
+### 6.3 Lazy Loading
+- **On-Demand Loading**: Lädt Tokens nur bei Bedarf
+- **Code-Splitting**: Splittet Token-CSS nach Scope
+- **Dynamic Imports**: Dynamische CSS-Imports
+
+## Phase 7: Token-Testing & QA (Priorität: Mittel)
+
+### 7.1 Unit Tests
+- **Token-Tests**: Testet Token-Erstellung und -Manipulation
+- **Mutation-Tests**: Testet State-Mutationen
+- **CSS-Generierung-Tests**: Testet CSS-Output
+
+### 7.2 Visual Regression Tests
+- **Screenshot-Tests**: Vergleicht Token-Rendering
+- **State-Variation-Tests**: Testet alle States
+- **Theme-Tests**: Testet Theme-Varianten
+
+### 7.3 Accessibility Tests
+- **Kontrast-Tests**: Automatische WCAG-Kontrast-Prüfung
+- **Color-Blindness-Tests**: Simuliert Farbenblindheit
+- **Screen-Reader-Tests**: Prüft Screen-Reader-Kompatibilität
+
+## Phase 8: Token-Editor UI (Priorität: Niedrig)
+
+### 8.1 Admin-Interface
+- **Token-Editor**: Visueller Editor für Tokens
+- **Color-Picker**: OKLCH-basierter Color-Picker
+- **State-Editor**: Editor für State-Mutationen
+- **Live-Preview**: Live-Vorschau der Änderungen
+
+### 8.2 Token-Management
+- **CRUD-Operationen**: Create, Read, Update, Delete für Tokens
+- **Bulk-Operations**: Massenbearbeitung von Tokens
+- **Import/Export**: UI für Import/Export
+- **Versionierung**: UI für Token-Versionen
+
+### 8.3 Analytics
+- **Token-Usage**: Zeigt Verwendung von Tokens
+- **Performance-Metriken**: Zeigt Performance-Impact
+- **Accessibility-Scores**: Zeigt Accessibility-Scores
+
+## Phase 9: Erweiterte Farb-Features (Priorität: Niedrig)
+
+### 9.1 Farb-Paletten-Generierung
+- **Datei**: `src/Framework/Design/Services/ColorPaletteGenerator.php`
+- **Funktionalität**:
+  - Generiert Farb-Paletten aus Basis-Farbe
+  - Harmonische Farb-Kombinationen
+  - Kontrast-optimierte Paletten
+  - Accessibility-optimierte Paletten
+
+### 9.2 Farb-Analyse
+- **Datei**: `src/Framework/Design/Services/ColorAnalyzer.php`
+- **Funktionalität**:
+  - Analysiert Farb-Eigenschaften
+  - Berechnet Kontrast-Verhältnisse
+  - Erkennt Farb-Harmonien
+  - Simuliert Farbenblindheit
+
+### 9.3 Farb-Konvertierung
+- **Erweiterung**: Unterstützung für weitere Farb-Räume
+  - LAB, LUV, XYZ
+  - CMYK
+  - Pantone (näherungsweise)
+  - NCS (Natural Color System)
+
+## Phase 10: Token-Versionierung & Migration (Priorität: Mittel)
+
+### 10.1 Token-Versionierung
+- **Datei**: `src/Framework/Design/ValueObjects/TokenVersion.php`
+- **Funktionalität**:
+  - Versions-Tracking für Tokens
+  - Semantische Versionierung
+  - Changelog-Generierung
+  - Breaking Changes Detection
+
+### 10.2 Migration-Tools
+- **Datei**: `src/Framework/Design/Migrations/TokenMigration.php`
+- **Funktionalität**:
+  - Automatische Token-Migrationen
+  - Bulk-Updates
+  - Deprecation-Warnings
+  - Auto-Fix für einfache Änderungen
+
+### 10.3 Rollback-Mechanismus
+- **Funktionalität**:
+  - Rollback zu vorherigen Token-Versionen
+  - Version-Vergleich
+  - Diff-Visualisierung
+
+## Priorisierung
+
+### Kurzfristig (1-2 Monate)
+1. **Datenbank-Speicherung** (Phase 1) - Ermöglicht dynamische Token-Verwaltung
+2. **Token-Themes** (Phase 4) - Wichtiges Feature für Multi-Theme-Support
+3. **Token-Validierung** (Phase 2) - Qualitätssicherung
+
+### Mittelfristig (3-6 Monate)
+4. **Token-Export/Import** (Phase 3) - Integration mit Design-Tools
+5. **Performance-Optimierung** (Phase 6) - Skalierbarkeit
+6. **Token-Testing** (Phase 7) - Qualitätssicherung
+
+### Langfristig (6+ Monate)
+7. **Token-Dokumentation** (Phase 5) - Developer Experience
+8. **Token-Editor UI** (Phase 8) - Benutzerfreundlichkeit
+9. **Erweiterte Farb-Features** (Phase 9) - Erweiterte Funktionalität
+10. **Token-Versionierung** (Phase 10) - Enterprise-Features
+
+## Abhängigkeiten
+
+- **Phase 1** (Datenbank) ist Voraussetzung für **Phase 8** (Editor UI)
+- **Phase 2** (Validierung) ist Voraussetzung für **Phase 10** (Versionierung)
+- **Phase 4** (Themes) kann parallel zu anderen Phasen entwickelt werden
+- **Phase 6** (Performance) profitiert von allen vorherigen Phasen
+
+## Technische Überlegungen
+
+### Datenbank-Speicherung
+- **Hybrid-Ansatz**: Code-basierte Tokens als Default, DB als Override
+- **Caching**: Aggressives Caching für Performance
+- **Migration**: Schrittweise Migration von Code zu DB
+
+### Performance
+- **Lazy Loading**: Tokens nur bei Bedarf laden
+- **CSS-Optimierung**: Minimierung und Tree-Shaking
+- **CDN-Integration**: Generiertes CSS auf CDN ausliefern
+
+### Skalierbarkeit
+- **Multi-Tenant**: Unterstützung für mehrere Tenant-Token-Sets
+- **Caching-Strategien**: Verschiedene Caching-Ebenen
+- **Load Balancing**: Verteilung der Token-Generierung
+
+## Erfolgs-Metriken
+
+- **Developer Experience**: Reduzierte Zeit für Token-Verwaltung
+- **Performance**: Schnellere CSS-Generierung
+- **Qualität**: Weniger Token-Fehler durch Validierung
+- **Flexibilität**: Einfacheres Theme-Management
+- **Integration**: Bessere Integration mit Design-Tools
+
diff --git a/todo.md b/docs/todo/todo.md
similarity index 100%
rename from todo.md
rename to docs/todo/todo.md
diff --git a/docs/troubleshooting/gitea-actions-artifact-compatibility.md b/docs/troubleshooting/gitea-actions-artifact-compatibility.md
new file mode 100644
index 00000000..6bf34646
--- /dev/null
+++ b/docs/troubleshooting/gitea-actions-artifact-compatibility.md
@@ -0,0 +1,33 @@
+# Gitea Actions Artifact Compatibility Issue
+
+## Problem
+
+Gitea Actions verwendet eine GHES (GitHub Enterprise Server) kompatible API. Die `@actions/artifact` Actions v2.0.0+ (insbesondere `upload-artifact@v4` und `download-artifact@v4`) werden auf GHES nicht unterstützt.
+
+### Fehlermeldung
+
+```
+GHESNotSupportedError: @actions/artifact v2.0.0+, upload-artifact@v4+ and download-artifact@v4+ are not currently supported on GHES.
+```
+
+## Lösung
+
+Verwende **v3** Versionen der Artifact Actions:
+
+- `actions/upload-artifact@v3` (statt `@v4`)
+- `actions/download-artifact@v3` (statt `@v4`)
+
+## Betroffene Workflows
+
+- `.gitea/workflows/build-image.yml` - 12 Vorkommen
+- `.gitea/workflows/monitor-performance.yml` - 1 Vorkommen
+
+## Migration
+
+Alle `@v4` Versionen wurden auf `@v3` downgraded. Die v3 Versionen sind vollständig kompatibel mit Gitea Actions und bieten die gleiche Funktionalität.
+
+## Referenzen
+
+- [Gitea Actions Documentation](https://docs.gitea.com/usage/actions/overview)
+- [GitHub Actions Artifact v3 Documentation](https://github.com/actions/upload-artifact/tree/v3)
+
diff --git a/public/.vite/manifest.json b/public/.vite/manifest.json
index 6cc68086..82971ec3 100644
--- a/public/.vite/manifest.json
+++ b/public/.vite/manifest.json
@@ -1,11 +1,11 @@
 {
   "resources/css/admin/admin.css": {
-    "file": "assets/css/admin-Uhvvg2GV.css",
+    "file": "assets/css/admin-B295JZoO.css",
     "src": "resources/css/admin/admin.css",
     "isEntry": true
   },
   "resources/js/main.js": {
-    "file": "assets/js/main-BF4H_hWD.js",
+    "file": "assets/js/main-C52nFCDL.js",
     "name": "main",
     "src": "resources/js/main.js",
     "isEntry": true,
diff --git a/public/assets/css/admin-B295JZoO.css b/public/assets/css/admin-B295JZoO.css
new file mode 100644
index 00000000..d8d5bc42
--- /dev/null
+++ b/public/assets/css/admin-B295JZoO.css
@@ -0,0 +1 @@
+@layer admin-settings;@layer admin-settings{:root{--admin-breakpoint-tablet: 768px;--admin-breakpoint-desktop: 1024px;--admin-breakpoint-wide: 1440px;--admin-container-mobile: 100%;--admin-container-tablet: 720px;--admin-container-desktop: 960px;--admin-container-wide: 1400px;--admin-sidebar-width-mobile: 100%;--admin-sidebar-width-tablet: 250px;--admin-sidebar-width-desktop: 250px;--admin-sidebar-width-wide: 280px;--admin-header-height-mobile: 3.5rem;--admin-header-height-tablet: 4rem;--admin-header-height-desktop: 4rem;--admin-header-height-wide: 4.5rem}}@custom-media --admin-tablet (min-width: 768px);@custom-media --admin-desktop (min-width: 1024px);@custom-media --admin-wide (min-width: 1440px);@custom-media --admin-mobile-only (max-width: 767px);@custom-media --admin-tablet-only (min-width: 768px) and (max-width: 1023px);@custom-media --admin-desktop-only (min-width: 1024px) and (max-width: 1439px);@custom-media --admin-landscape (orientation: landscape);@custom-media --admin-portrait (orientation: portrait);@custom-media --admin-touch (hover: none) and (pointer: coarse);@custom-media --admin-reduced-motion (prefers-reduced-motion: reduce);@custom-media --admin-high-contrast (prefers-contrast: more);@layer admin-tools{.admin-visually-hidden{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.admin-focus-ring{outline:2px solid var(--admin-focus-ring);outline-offset:2px}.admin-smooth-scroll{scroll-behavior:smooth}@media(--admin-reduced-motion){.admin-smooth-scroll{scroll-behavior:auto}}.admin-clearfix:after{content:"";display:table;clear:both}.admin-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.admin-line-clamp{display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden}.admin-backdrop-blur{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);background-color:#00000080}@supports not (backdrop-filter: blur(8px)){.admin-backdrop-blur{background-color:#000000bf}}}@layer admin-generic{.admin-layout *,.admin-layout *:before,.admin-layout *:after{box-sizing:border-box}.admin-layout h1,.admin-layout h2,.admin-layout h3,.admin-layout h4,.admin-layout h5,.admin-layout h6,.admin-layout p,.admin-layout ul,.admin-layout ol,.admin-layout figure{margin:0}.admin-layout ul,.admin-layout ol{padding:0;list-style:none}.admin-layout a{color:var(--admin-link-color);text-decoration:none;transition:color var(--admin-transition-fast)}.admin-layout a:hover{color:var(--admin-link-hover)}.admin-layout a:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px;border-radius:var(--admin-radius-sm)}.admin-layout button{font-family:inherit;font-size:inherit;line-height:inherit;background:none;border:none;padding:0;cursor:pointer}.admin-layout img{max-width:100%;height:auto;display:block}@media(--admin-reduced-motion){.admin-layout *,.admin-layout *:before,.admin-layout *:after{animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}}@layer admin-elements{.admin-layout{font-family:var(--admin-font-family-base);font-size:var(--admin-font-size-base);line-height:var(--admin-line-height-normal);color:var(--admin-content-text);background-color:var(--admin-bg-primary);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.admin-layout h1{font-size:var(--admin-font-size-3xl);font-weight:var(--admin-font-weight-bold);line-height:var(--admin-line-height-tight);margin-bottom:var(--admin-spacing-lg)}.admin-layout h2{font-size:var(--admin-font-size-2xl);font-weight:var(--admin-font-weight-semibold);line-height:var(--admin-line-height-tight);margin-bottom:var(--admin-spacing-md)}.admin-layout h3{font-size:var(--admin-font-size-xl);font-weight:var(--admin-font-weight-semibold);line-height:var(--admin-line-height-tight);margin-bottom:var(--admin-spacing-md)}.admin-layout h4{font-size:var(--admin-font-size-lg);font-weight:var(--admin-font-weight-medium);line-height:var(--admin-line-height-normal);margin-bottom:var(--admin-spacing-sm)}.admin-layout p{margin-bottom:var(--admin-spacing-md);line-height:var(--admin-line-height-relaxed)}.admin-layout small{font-size:var(--admin-font-size-sm);color:oklch(from var(--admin-content-text) calc(l*.7) c h)}.admin-layout code{font-family:var(--admin-font-family-mono);font-size:.875em;background-color:var(--admin-bg-tertiary);padding:.125rem .375rem;border-radius:var(--admin-radius-sm)}.admin-layout pre{font-family:var(--admin-font-family-mono);font-size:var(--admin-font-size-sm);background-color:var(--admin-bg-tertiary);padding:var(--admin-spacing-md);border-radius:var(--admin-radius-md);overflow-x:auto;margin-bottom:var(--admin-spacing-md)}.admin-layout pre code{background:none;padding:0}.admin-layout ul:not([role=list]){list-style:disc;padding-left:var(--admin-spacing-lg)}.admin-layout ol:not([role=list]){list-style:decimal;padding-left:var(--admin-spacing-lg)}.admin-layout table{width:100%;border-collapse:collapse;margin-bottom:var(--admin-spacing-lg)}.admin-layout th{text-align:left;font-weight:var(--admin-font-weight-semibold);padding:var(--admin-spacing-sm) var(--admin-spacing-md);background-color:var(--admin-bg-secondary);border-bottom:2px solid var(--admin-border-medium)}.admin-layout td{padding:var(--admin-spacing-sm) var(--admin-spacing-md);border-bottom:1px solid var(--admin-border-light)}.admin-layout tr:hover{background-color:var(--admin-hover-overlay)}.admin-layout input[type=text],.admin-layout input[type=email],.admin-layout input[type=password],.admin-layout input[type=search],.admin-layout input[type=url],.admin-layout input[type=tel],.admin-layout input[type=number],.admin-layout textarea,.admin-layout select{width:100%;padding:var(--admin-spacing-sm) var(--admin-spacing-md);font-family:inherit;font-size:var(--admin-font-size-base);line-height:var(--admin-line-height-normal);color:var(--admin-content-text);background-color:var(--admin-content-bg);border:1px solid var(--admin-border-medium);border-radius:var(--admin-radius-md);transition:border-color var(--admin-transition-fast),box-shadow var(--admin-transition-fast)}.admin-layout input:focus,.admin-layout textarea:focus,.admin-layout select:focus{outline:none;border-color:var(--admin-focus-ring);box-shadow:0 0 0 3px oklch(from var(--admin-focus-ring) l c h / .1)}.admin-layout textarea{min-height:8rem;resize:vertical}.admin-layout hr{border:none;border-top:1px solid var(--admin-border-light);margin:var(--admin-spacing-xl) 0}}@layer admin-objects{.admin-layout{display:grid;min-height:100vh;grid-template-columns:1fr;grid-template-rows:auto auto 1fr;grid-template-areas:"header" "sidebar" "content"}@media(min-width:768px){.admin-layout{grid-template-columns:var(--admin-spacing-sidebar) 1fr;grid-template-rows:auto 1fr;grid-template-areas:"sidebar header" "sidebar content"}}@media(min-width:1440px){.admin-layout{grid-template-columns:var(--admin-sidebar-width-wide) 1fr}}.admin-sidebar{grid-area:sidebar;background-color:var(--admin-sidebar-bg);color:var(--admin-sidebar-text)}@media(max-width:767px){.admin-sidebar{position:fixed;top:0;left:0;bottom:0;width:var(--admin-sidebar-width-mobile);max-width:280px;transform:translate(-100%);transition:transform var(--admin-transition-base);z-index:var(--admin-z-sidebar);overflow-y:auto}.admin-sidebar[data-mobile-menu-open=true]{transform:translate(0)}}@media(min-width:768px){.admin-sidebar{position:sticky;top:0;height:100vh;overflow-y:auto;border-right:1px solid var(--admin-sidebar-border)}}.admin-header{grid-area:header;background-color:var(--admin-header-bg);color:var(--admin-header-text);border-bottom:1px solid var(--admin-header-border);padding:var(--admin-spacing-md) var(--admin-spacing-content-padding);display:flex;align-items:center;justify-content:space-between;gap:var(--admin-spacing-md);min-height:var(--admin-header-height-mobile)}@media(min-width:768px){.admin-header{min-height:var(--admin-header-height-tablet);position:sticky;top:0;z-index:var(--admin-z-header)}}@media(min-width:1440px){.admin-header{min-height:var(--admin-header-height-wide)}}.admin-content{grid-area:content;background-color:var(--admin-content-bg);padding:var(--admin-spacing-content-padding);overflow-x:hidden}@media(min-width:1440px){.admin-content{max-width:var(--admin-spacing-content-max-width);margin:0 auto;width:100%}}.admin-mobile-overlay{display:none}@media(max-width:767px){.admin-mobile-overlay[data-mobile-menu-open=true]{display:block;position:fixed;top:0;left:0;right:0;bottom:0;background-color:#00000080;z-index:calc(var(--admin-z-sidebar) - 1);-webkit-backdrop-filter:blur(2px);backdrop-filter:blur(2px)}}.admin-skip-link{position:absolute;top:-999px;left:-999px;z-index:var(--admin-z-toast);padding:var(--admin-spacing-sm) var(--admin-spacing-md);background-color:var(--admin-accent-primary);color:#fff;text-decoration:none;border-radius:var(--admin-radius-md)}.admin-skip-link:focus{top:var(--admin-spacing-sm);left:var(--admin-spacing-sm)}.admin-container{width:100%;max-width:var(--admin-container-mobile);margin:0 auto;padding:0 var(--admin-spacing-md)}@media(min-width:768px){.admin-container{max-width:var(--admin-container-tablet)}}@media(min-width:1024px){.admin-container{max-width:var(--admin-container-desktop)}}@media(min-width:1440px){.admin-container{max-width:var(--admin-container-wide)}}.admin-container--narrow{max-width:960px}.admin-container--wide{max-width:100%}}@layer admin-objects{.admin-grid{display:grid;gap:var(--admin-spacing-md);grid-template-columns:1fr}@media(min-width:768px){.admin-grid{grid-template-columns:repeat(auto-fit,minmax(250px,1fr))}}@media(min-width:768px){.admin-grid--2-col{grid-template-columns:repeat(2,1fr)}}@media(min-width:768px){.admin-grid--3-col{grid-template-columns:repeat(2,1fr)}}@media(min-width:1024px){.admin-grid--3-col{grid-template-columns:repeat(3,1fr)}}@media(min-width:768px){.admin-grid--4-col{grid-template-columns:repeat(2,1fr)}}@media(min-width:1024px){.admin-grid--4-col{grid-template-columns:repeat(4,1fr)}}.admin-grid--gap-sm{gap:var(--admin-spacing-sm)}.admin-grid--gap-lg{gap:var(--admin-spacing-lg)}.admin-grid--gap-xl{gap:var(--admin-spacing-xl)}@media(min-width:1024px){.admin-grid--sidebar{grid-template-columns:300px 1fr;gap:var(--admin-spacing-xl)}}@media(min-width:1024px){.admin-grid--sidebar-right{grid-template-columns:1fr 300px;gap:var(--admin-spacing-xl)}}.admin-stack{display:flex;flex-direction:column;gap:var(--admin-spacing-md)}.admin-stack--sm{gap:var(--admin-spacing-sm)}.admin-stack--lg{gap:var(--admin-spacing-lg)}.admin-stack--xl{gap:var(--admin-spacing-xl)}.admin-cluster{display:flex;flex-wrap:wrap;gap:var(--admin-spacing-md);align-items:center}.admin-cluster--sm{gap:var(--admin-spacing-sm)}.admin-cluster--lg{gap:var(--admin-spacing-lg)}.admin-cluster--justify-between{justify-content:space-between}.admin-cluster--justify-end{justify-content:flex-end}}@layer admin-components{.admin-sidebar{display:flex;flex-direction:column;background-color:var(--admin-sidebar-bg);color:var(--admin-sidebar-text);padding:var(--admin-spacing-lg) 0}.admin-sidebar__header{padding:0 var(--admin-spacing-lg);margin-bottom:var(--admin-spacing-xl);display:flex;align-items:center;gap:var(--admin-spacing-md)}.admin-sidebar__logo{width:40px;height:40px;flex-shrink:0}.admin-sidebar__title{font-size:var(--admin-font-size-lg);font-weight:600;color:var(--admin-sidebar-text-hover);margin:0}.admin-nav{flex:1;overflow-y:auto;display:flex;flex-direction:column;gap:var(--admin-spacing-xs)}.admin-nav__section{padding:0 var(--admin-spacing-md)}.admin-nav__section-title{font-size:var(--admin-font-size-xs);font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--admin-sidebar-text);opacity:.7;padding:var(--admin-spacing-md) var(--admin-spacing-sm);margin:var(--admin-spacing-md) 0 var(--admin-spacing-xs)}.admin-nav__list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:var(--admin-spacing-xs)}.admin-nav__item{margin:0}.admin-nav__link{display:flex;align-items:center;gap:var(--admin-spacing-sm);padding:var(--admin-spacing-sm) var(--admin-spacing-md);border-radius:var(--admin-radius-md);color:var(--admin-sidebar-text);text-decoration:none;font-size:var(--admin-font-size-sm);font-weight:500;transition:all var(--admin-transition-base);position:relative}.admin-nav__link:hover{background-color:var(--admin-hover-overlay);color:var(--admin-sidebar-text-hover)}.admin-nav__link:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}.admin-nav__link[aria-current=page],.admin-nav__link.admin-nav__link--active{background-color:var(--admin-sidebar-active);color:var(--admin-sidebar-text-hover)}.admin-nav__link[aria-current=page]:before,.admin-nav__link.admin-nav__link--active:before{content:"";position:absolute;left:0;top:50%;transform:translateY(-50%);width:3px;height:70%;background-color:var(--admin-accent-primary);border-radius:0 2px 2px 0}.admin-nav__icon{width:20px;height:20px;flex-shrink:0;opacity:.8}.admin-nav__link:hover .admin-nav__icon,.admin-nav__link[aria-current=page] .admin-nav__icon{opacity:1}.admin-nav__badge{margin-left:auto;padding:2px 8px;background-color:var(--admin-accent-error);color:#fff;font-size:var(--admin-font-size-xs);font-weight:600;border-radius:10px;min-width:20px;text-align:center}.admin-nav__submenu{list-style:none;margin:var(--admin-spacing-xs) 0 0;padding:0 0 0 calc(var(--admin-spacing-md) + 20px);display:none;flex-direction:column;gap:var(--admin-spacing-xs)}.admin-nav__item--expanded>.admin-nav__submenu{display:flex}.admin-nav__submenu .admin-nav__link{font-size:var(--admin-font-size-xs);padding:var(--admin-spacing-xs) var(--admin-spacing-sm)}.admin-nav__toggle{margin-left:auto;width:16px;height:16px;transition:transform var(--admin-transition-base)}.admin-nav__item--expanded .admin-nav__toggle{transform:rotate(90deg)}.admin-sidebar__footer{margin-top:auto;padding:var(--admin-spacing-lg);border-top:1px solid var(--admin-sidebar-border)}.admin-sidebar__user{display:flex;align-items:center;gap:var(--admin-spacing-sm);padding:var(--admin-spacing-sm);border-radius:var(--admin-radius-md);color:var(--admin-sidebar-text);text-decoration:none;transition:background-color var(--admin-transition-base)}.admin-sidebar__user:hover{background-color:var(--admin-hover-overlay)}.admin-sidebar__avatar{width:32px;height:32px;border-radius:50%;object-fit:cover;flex-shrink:0}.admin-sidebar__user-info{flex:1;min-width:0}.admin-sidebar__user-name{font-size:var(--admin-font-size-sm);font-weight:600;color:var(--admin-sidebar-text-hover);display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.admin-sidebar__user-role{font-size:var(--admin-font-size-xs);color:var(--admin-sidebar-text);opacity:.8;display:block}.admin-sidebar__mobile-toggle{display:none}@media(max-width:767px){.admin-sidebar__mobile-toggle{display:flex;align-items:center;justify-content:center;position:fixed;top:var(--admin-spacing-md);left:var(--admin-spacing-md);z-index:calc(var(--admin-z-sidebar) + 1);width:44px;height:44px;background-color:var(--admin-sidebar-bg);border:1px solid var(--admin-sidebar-border);border-radius:var(--admin-radius-md);cursor:pointer;transition:background-color var(--admin-transition-base)}.admin-sidebar__mobile-toggle:hover{background-color:var(--admin-sidebar-active)}.admin-sidebar__mobile-toggle:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}}.admin-sidebar__toggle-icon{width:24px;height:24px;color:var(--admin-sidebar-text-hover)}}@layer admin-components{.admin-header{display:flex;align-items:center;gap:var(--admin-spacing-md);border-bottom:1px solid var(--admin-header-border);padding:var(--admin-spacing-md) var(--admin-spacing-content-padding);min-height:var(--admin-header-height-mobile);position:sticky;top:0;z-index:var(--admin-z-header);-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);background-color:var(--admin-header-bg)}@media(min-width:768px){.admin-header{min-height:var(--admin-header-height-tablet)}}@media(min-width:1440px){.admin-header{min-height:var(--admin-header-height-wide)}}.admin-header__title{font-size:var(--admin-font-size-xl);font-weight:600;color:var(--admin-header-text);margin:0;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@media(max-width:767px){.admin-header__title{display:none}}.admin-header__search{flex:0 1 400px;max-width:400px}@media(max-width:767px){.admin-header__search{flex:1;max-width:none}}.admin-search{position:relative;width:100%}.admin-search__input{width:100%;padding:var(--admin-spacing-sm) var(--admin-spacing-md);padding-left:calc(var(--admin-spacing-md) + 20px + var(--admin-spacing-sm));border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-md);font-size:var(--admin-font-size-sm);background-color:var(--admin-bg-secondary);color:var(--admin-content-text);transition:all var(--admin-transition-base)}.admin-search__input::placeholder{color:var(--admin-content-text);opacity:.5}.admin-search__input:focus{outline:none;border-color:var(--admin-focus-ring);box-shadow:0 0 0 3px var(--admin-focus-ring-alpha);background-color:var(--admin-content-bg)}.admin-search__icon{position:absolute;left:var(--admin-spacing-md);top:50%;transform:translateY(-50%);width:20px;height:20px;color:var(--admin-content-text);opacity:.5;pointer-events:none}.admin-header__actions{display:flex;align-items:center;gap:var(--admin-spacing-sm);margin-left:auto}.admin-action-btn{display:flex;align-items:center;justify-content:center;width:40px;height:40px;border-radius:var(--admin-radius-md);background-color:transparent;border:1px solid transparent;color:var(--admin-header-text);cursor:pointer;transition:all var(--admin-transition-base);position:relative}.admin-action-btn:hover{background-color:var(--admin-hover-overlay);border-color:var(--admin-border-light)}.admin-action-btn:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}.admin-action-btn__icon{width:20px;height:20px}.admin-action-btn__badge{position:absolute;top:6px;right:6px;width:8px;height:8px;background-color:var(--admin-accent-error);border:2px solid var(--admin-header-bg);border-radius:50%}.admin-action-btn__badge--count{width:auto;height:auto;min-width:18px;padding:2px 5px;font-size:10px;font-weight:600;color:#fff;line-height:1;border-radius:9px}.admin-theme-toggle{display:flex;align-items:center;gap:var(--admin-spacing-xs);padding:var(--admin-spacing-xs) var(--admin-spacing-sm);background-color:var(--admin-bg-secondary);border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-md);cursor:pointer;transition:all var(--admin-transition-base)}.admin-theme-toggle:hover{background-color:var(--admin-bg-tertiary)}@media(max-width:767px){.admin-theme-toggle{padding:var(--admin-spacing-xs)}.admin-theme-toggle .admin-theme-toggle__label{display:none}}.admin-theme-toggle__icon{width:18px;height:18px;color:var(--admin-header-text)}.admin-theme-toggle__label{font-size:var(--admin-font-size-sm);color:var(--admin-header-text)}.admin-user-menu{position:relative}.admin-user-menu__trigger{display:flex;align-items:center;gap:var(--admin-spacing-sm);padding:var(--admin-spacing-xs);background-color:transparent;border:1px solid transparent;border-radius:var(--admin-radius-md);cursor:pointer;transition:all var(--admin-transition-base)}.admin-user-menu__trigger:hover{background-color:var(--admin-hover-overlay);border-color:var(--admin-border-light)}.admin-user-menu__trigger:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}.admin-user-menu__avatar{width:32px;height:32px;border-radius:50%;object-fit:cover;border:2px solid var(--admin-border-light)}.admin-user-menu__name{font-size:var(--admin-font-size-sm);font-weight:500;color:var(--admin-header-text)}@media(max-width:767px){.admin-user-menu__name{display:none}}.admin-user-menu__chevron{width:16px;height:16px;color:var(--admin-header-text);transition:transform var(--admin-transition-base)}.admin-user-menu[data-open=true] .admin-user-menu__chevron{transform:rotate(180deg)}@media(max-width:767px){.admin-user-menu__chevron{display:none}}.admin-user-menu__dropdown{position:absolute;top:calc(100% + var(--admin-spacing-xs));right:0;min-width:200px;background-color:var(--admin-content-bg);border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-md);box-shadow:var(--admin-shadow-lg);padding:var(--admin-spacing-sm) 0;display:none;z-index:var(--admin-z-dropdown)}.admin-user-menu[data-open=true] .admin-user-menu__dropdown{display:block}.admin-user-menu__item{list-style:none;margin:0}.admin-user-menu__link{display:flex;align-items:center;gap:var(--admin-spacing-sm);padding:var(--admin-spacing-sm) var(--admin-spacing-md);color:var(--admin-content-text);text-decoration:none;font-size:var(--admin-font-size-sm);transition:background-color var(--admin-transition-base)}.admin-user-menu__link:hover{background-color:var(--admin-bg-secondary)}.admin-user-menu__icon{width:18px;height:18px;opacity:.7}.admin-user-menu__divider{height:1px;background-color:var(--admin-border-light);margin:var(--admin-spacing-sm) 0}}@layer admin-components{.admin-breadcrumbs{display:flex;align-items:center;gap:var(--admin-spacing-xs);padding:var(--admin-spacing-sm) 0;overflow-x:auto;scrollbar-width:thin}.admin-breadcrumbs::-webkit-scrollbar{height:0}@media(max-width:767px){.admin-breadcrumbs{flex:1;min-width:0}}.admin-breadcrumbs__list{display:flex;align-items:center;gap:var(--admin-spacing-xs);list-style:none;margin:0;padding:0;flex-wrap:nowrap}.admin-breadcrumbs__item{display:flex;align-items:center;gap:var(--admin-spacing-xs);white-space:nowrap;flex-shrink:0}.admin-breadcrumbs__item:last-child{flex-shrink:1;min-width:0}.admin-breadcrumbs__link{display:inline-flex;align-items:center;gap:var(--admin-spacing-xs);color:var(--admin-link-color);text-decoration:none;font-size:var(--admin-font-size-sm);font-weight:500;transition:color var(--admin-transition-base)}.admin-breadcrumbs__link:hover{color:var(--admin-link-hover);text-decoration:underline}.admin-breadcrumbs__link:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px;border-radius:2px}.admin-breadcrumbs__current{color:var(--admin-content-text);font-size:var(--admin-font-size-sm);font-weight:600;overflow:hidden;text-overflow:ellipsis}.admin-breadcrumbs__home-icon{width:16px;height:16px;flex-shrink:0}.admin-breadcrumbs__separator{display:inline-flex;align-items:center;color:var(--admin-content-text);opacity:.4;font-size:var(--admin-font-size-sm);-webkit-user-select:none;user-select:none;flex-shrink:0}.admin-breadcrumbs__separator-icon{width:16px;height:16px}.admin-breadcrumbs__overflow{display:inline-flex;align-items:center;justify-content:center;width:32px;height:32px;color:var(--admin-content-text);background-color:var(--admin-bg-secondary);border-radius:var(--admin-radius-sm);cursor:pointer;transition:background-color var(--admin-transition-base)}.admin-breadcrumbs__overflow:hover{background-color:var(--admin-bg-tertiary)}.admin-breadcrumbs__overflow:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}@media(max-width:480px){.admin-breadcrumbs__item:not(:first-child):not(:last-child):not(.admin-breadcrumbs__overflow){display:none}}.admin-breadcrumbs__sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}}@layer admin-components{.admin-content{padding:var(--admin-spacing-content-padding);background-color:var(--admin-content-bg);color:var(--admin-content-text);overflow-x:hidden}@media(min-width:1440px){.admin-content{max-width:var(--admin-spacing-content-max-width);margin:0 auto;width:100%}}@media(max-width:767px){.admin-content{padding:var(--admin-spacing-md)}}.admin-content__header{margin-bottom:var(--admin-spacing-xl)}.admin-content__title{font-size:var(--admin-font-size-3xl);font-weight:700;color:var(--admin-content-text);margin:0 0 var(--admin-spacing-sm)}@media(max-width:767px){.admin-content__title{font-size:var(--admin-font-size-2xl)}}.admin-content__description{font-size:var(--admin-font-size-base);color:var(--admin-content-text);opacity:.8;margin:0;line-height:1.6}.admin-content__header--with-actions{display:flex;align-items:flex-start;justify-content:space-between;gap:var(--admin-spacing-md)}@media(max-width:767px){.admin-content__header--with-actions{flex-direction:column;align-items:stretch}}.admin-content__title-group{flex:1;min-width:0}.admin-content__actions{display:flex;align-items:center;gap:var(--admin-spacing-sm);flex-shrink:0}@media(max-width:767px){.admin-content__actions{width:100%;justify-content:flex-start}}.admin-card{background-color:var(--admin-content-bg);border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-lg);padding:var(--admin-spacing-lg);box-shadow:var(--admin-shadow-sm)}.admin-card.admin-card--interactive{cursor:pointer;transition:all var(--admin-transition-base)}.admin-card.admin-card--interactive:hover{border-color:var(--admin-border-medium);box-shadow:var(--admin-shadow-md);transform:translateY(-2px)}.admin-card__header{margin-bottom:var(--admin-spacing-md);padding-bottom:var(--admin-spacing-md);border-bottom:1px solid var(--admin-border-light)}.admin-card__title{font-size:var(--admin-font-size-lg);font-weight:600;color:var(--admin-content-text);margin:0}.admin-card__subtitle{font-size:var(--admin-font-size-sm);color:var(--admin-content-text);opacity:.7;margin:var(--admin-spacing-xs) 0 0}.admin-card__body{margin:0}.admin-card__footer{margin-top:var(--admin-spacing-md);padding-top:var(--admin-spacing-md);border-top:1px solid var(--admin-border-light);display:flex;align-items:center;justify-content:space-between;gap:var(--admin-spacing-sm)}.admin-section{margin-bottom:var(--admin-spacing-2xl)}.admin-section:last-child{margin-bottom:0}.admin-section__header{margin-bottom:var(--admin-spacing-lg)}.admin-section__title{font-size:var(--admin-font-size-xl);font-weight:600;color:var(--admin-content-text);margin:0 0 var(--admin-spacing-xs)}.admin-section__description{font-size:var(--admin-font-size-sm);color:var(--admin-content-text);opacity:.8;margin:0}.admin-stats-grid{display:grid;gap:var(--admin-spacing-md);grid-template-columns:1fr}@media(min-width:768px){.admin-stats-grid{grid-template-columns:repeat(2,1fr)}}@media(min-width:1024px){.admin-stats-grid{grid-template-columns:repeat(4,1fr)}}.admin-stat-card{background-color:var(--admin-content-bg);border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-lg);padding:var(--admin-spacing-lg)}.admin-stat-card__label{font-size:var(--admin-font-size-sm);color:var(--admin-content-text);opacity:.7;margin:0 0 var(--admin-spacing-xs);text-transform:uppercase;letter-spacing:.05em;font-weight:600}.admin-stat-card__value{font-size:var(--admin-font-size-3xl);font-weight:700;color:var(--admin-content-text);margin:0 0 var(--admin-spacing-sm);line-height:1.2}.admin-stat-card__change{font-size:var(--admin-font-size-sm);font-weight:500;display:inline-flex;align-items:center;gap:var(--admin-spacing-xs)}.admin-stat-card__change.admin-stat-card__change--positive{color:var(--admin-accent-success)}.admin-stat-card__change.admin-stat-card__change--negative{color:var(--admin-accent-error)}.admin-stat-card__change.admin-stat-card__change--neutral{color:var(--admin-content-text);opacity:.6}.admin-stat-card__icon{width:40px;height:40px;padding:var(--admin-spacing-sm);background-color:var(--admin-bg-secondary);border-radius:var(--admin-radius-md);color:var(--admin-accent-primary);margin-bottom:var(--admin-spacing-md)}.admin-empty-state{text-align:center;padding:var(--admin-spacing-2xl);color:var(--admin-content-text)}.admin-empty-state__icon{width:64px;height:64px;margin:0 auto var(--admin-spacing-lg);opacity:.4}.admin-empty-state__title{font-size:var(--admin-font-size-xl);font-weight:600;margin:0 0 var(--admin-spacing-sm)}.admin-empty-state__description{font-size:var(--admin-font-size-base);opacity:.8;margin:0 0 var(--admin-spacing-lg)}.admin-loading{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:var(--admin-spacing-2xl);color:var(--admin-content-text)}.admin-loading__spinner{width:40px;height:40px;border:3px solid var(--admin-border-light);border-top-color:var(--admin-accent-primary);border-radius:50%;animation:admin-spin .8s linear infinite}.admin-loading__text{margin-top:var(--admin-spacing-md);font-size:var(--admin-font-size-sm);opacity:.8}@keyframes admin-spin{to{transform:rotate(360deg)}}}@layer admin-components{.admin-card{background-color:var(--admin-content-bg);border:1px solid var(--admin-border-light);border-radius:var(--admin-radius-lg);box-shadow:var(--admin-shadow-sm);overflow:hidden;transition:box-shadow var(--admin-transition-base)}.admin-card:hover{box-shadow:var(--admin-shadow-md)}.admin-card__header{padding:var(--admin-spacing-lg);border-bottom:1px solid var(--admin-border-light);background-color:var(--admin-bg-secondary)}.admin-card__title{font-size:var(--admin-font-size-lg);font-weight:var(--admin-font-weight-semibold);color:var(--admin-content-text);margin:0}.admin-card__content{padding:var(--admin-spacing-lg)}.admin-card__footer{padding:var(--admin-spacing-md) var(--admin-spacing-lg);border-top:1px solid var(--admin-border-light);background-color:var(--admin-bg-secondary)}.admin-card--highlighted{border-color:var(--admin-accent-primary);box-shadow:0 0 0 1px var(--admin-accent-primary),var(--admin-shadow-sm)}.admin-card--success{border-color:var(--admin-accent-success)}.admin-card--warning{border-color:var(--admin-accent-warning)}.admin-card--error{border-color:var(--admin-accent-error)}}@layer admin-components{.admin-btn{display:inline-flex;align-items:center;justify-content:center;gap:var(--admin-spacing-sm);padding:var(--admin-spacing-sm) var(--admin-spacing-md);font-family:var(--admin-font-family-base);font-size:var(--admin-font-size-sm);font-weight:var(--admin-font-weight-medium);line-height:1;text-decoration:none;border:1px solid transparent;border-radius:var(--admin-radius-md);cursor:pointer;transition:all var(--admin-transition-base);white-space:nowrap}.admin-btn:focus-visible{outline:2px solid var(--admin-focus-ring);outline-offset:2px}.admin-btn--primary{background-color:var(--admin-accent-primary);color:#fff}.admin-btn--primary:hover{background-color:oklch(from var(--admin-accent-primary) calc(l*.9) c h)}.admin-btn--secondary{background-color:var(--admin-sidebar-bg);color:var(--admin-sidebar-text-hover)}.admin-btn--secondary:hover{background-color:oklch(from var(--admin-sidebar-bg) calc(l*1.1) c h)}.admin-btn--accent{background-color:var(--admin-accent-info);color:#fff}.admin-btn--accent:hover{background-color:oklch(from var(--admin-accent-info) calc(l*.9) c h)}.admin-btn--success{background-color:var(--admin-accent-success);color:#fff}.admin-btn--success:hover{background-color:oklch(from var(--admin-accent-success) calc(l*.9) c h)}.admin-btn--danger{background-color:var(--admin-accent-error);color:#fff}.admin-btn--danger:hover{background-color:oklch(from var(--admin-accent-error) calc(l*.9) c h)}.admin-btn--ghost{background-color:transparent;color:var(--admin-content-text);border-color:var(--admin-border-medium)}.admin-btn--ghost:hover{background-color:var(--admin-bg-secondary)}.admin-btn--sm{padding:var(--admin-spacing-xs) var(--admin-spacing-sm);font-size:var(--admin-font-size-xs)}.admin-btn--lg{padding:var(--admin-spacing-md) var(--admin-spacing-lg);font-size:var(--admin-font-size-base)}.admin-btn__icon{width:18px;height:18px;flex-shrink:0}}@layer admin-components{.admin-badge{display:inline-flex;align-items:center;padding:2px 8px;font-size:var(--admin-font-size-xs);font-weight:var(--admin-font-weight-semibold);line-height:1.5;border-radius:10px;white-space:nowrap}.admin-badge--success{background-color:var(--admin-accent-success);color:#fff}.admin-badge--warning{background-color:var(--admin-accent-warning);color:#14151f}.admin-badge--error{background-color:var(--admin-accent-error);color:#fff}.admin-badge--info{background-color:var(--admin-accent-info);color:#fff}.admin-badge--default{background-color:var(--admin-bg-tertiary);color:var(--admin-content-text)}}@layer admin-components{.admin-stat-list{display:flex;flex-direction:column;gap:var(--admin-spacing-md)}.admin-stat-list__item{display:flex;align-items:center;justify-content:space-between;gap:var(--admin-spacing-sm);padding-bottom:var(--admin-spacing-sm);border-bottom:1px solid var(--admin-border-light)}.admin-stat-list__item:last-child{border-bottom:none;padding-bottom:0}.admin-stat-list__label{font-size:var(--admin-font-size-sm);color:var(--admin-content-text);opacity:.8}.admin-stat-list__value{font-size:var(--admin-font-size-sm);font-weight:var(--admin-font-weight-semibold);color:var(--admin-content-text)}.admin-stat-list--compact{gap:var(--admin-spacing-sm)}.admin-stat-list--compact .admin-stat-list__item{padding-bottom:var(--admin-spacing-xs)}}.confusion-matrix-card{padding:var(--space-md);border:1px solid var(--admin-border-color);border-radius:var(--admin-border-radius);background:var(--admin-card-bg)}.confusion-matrix-card__title{margin:0 0 var(--space-md);font-size:var(--font-size-md);font-weight:600;color:var(--admin-text-primary)}.confusion-matrix__grid{display:grid;grid-template-columns:1fr 1fr;gap:var(--space-xs);margin-bottom:var(--space-md)}.confusion-matrix__cell{padding:var(--space-md);border-radius:var(--admin-border-radius);text-align:center;transition:transform .2s ease,box-shadow .2s ease}.confusion-matrix__cell:hover{transform:translateY(-2px);box-shadow:var(--admin-shadow-md)}.confusion-matrix__cell-label{font-size:var(--font-size-sm);font-weight:500;margin-bottom:var(--space-xs);text-transform:uppercase;letter-spacing:.5px}.confusion-matrix__cell-value{font-size:var(--font-size-xl);font-weight:700}.confusion-matrix__cell--tp{background:#d8f9dd;border:2px solid oklch(70% .15 150);color:#003915;color:oklch(30% .1 150)}.confusion-matrix__cell--tn{background:#d6f5ff;background:oklch(95% .05 220);border:2px solid oklch(65% .15 220);color:#003441;color:oklch(30% .1 220)}.confusion-matrix__cell--fp{background:#ffe7e2;background:oklch(95% .05 30);border:2px solid oklch(70% .15 30);color:#652118}.confusion-matrix__cell--fn{background:#ffeada;background:oklch(95% .05 60);border:2px solid oklch(75% .15 60);color:#592e00;color:oklch(35% .1 60)}.confusion-matrix__rates{display:grid;grid-template-columns:1fr 1fr;gap:var(--space-sm);padding-top:var(--space-md);border-top:1px solid var(--admin-border-color)}.confusion-matrix__rates .admin-stat-item{padding:var(--space-sm);background:var(--admin-bg-secondary);border-radius:var(--admin-border-radius-sm)}.confusion-matrix__rates .admin-stat-item__label{font-size:var(--font-size-sm);font-weight:500;color:var(--admin-text-secondary)}.confusion-matrix__rates .admin-stat-item__value{font-size:var(--font-size-md);font-weight:600;color:var(--admin-text-primary)}:root[data-theme=dark] .confusion-matrix__cell--tp{background:#002a0e;background:oklch(25% .08 150);border-color:#09672e;color:#b8d8bd}:root[data-theme=dark] .confusion-matrix__cell--tn{background:#002631;background:oklch(25% .08 220);border-color:#005f75;border-color:oklch(45% .12 220);color:#aad6e5}:root[data-theme=dark] .confusion-matrix__cell--fp{background:#400d07;border-color:#8c352a;color:#edc2bb}:root[data-theme=dark] .confusion-matrix__cell--fn{background:#351900;background:oklch(25% .08 60);border-color:#7f4400;border-color:oklch(45% .12 60);color:#e7c7ae}@media(max-width:768px){.confusion-matrix__grid{gap:var(--space-xxs)}.confusion-matrix__cell{padding:var(--space-sm)}.confusion-matrix__cell-label{font-size:var(--font-size-xs)}.confusion-matrix__cell-value{font-size:var(--font-size-lg)}.confusion-matrix__rates{grid-template-columns:1fr}}@layer admin-utilities{:focus-visible{outline:var(--admin-focus-ring-width, 2px) solid var(--admin-focus-ring);outline-offset:var(--admin-focus-ring-offset, 2px);border-radius:var(--admin-radius-sm)}.admin-skip-link{position:absolute;top:-9999px;left:-9999px;z-index:var(--admin-z-toast);padding:var(--admin-spacing-md) var(--admin-spacing-lg);background-color:var(--admin-accent-primary);color:#fff;text-decoration:none;font-weight:var(--admin-font-weight-semibold);border-radius:var(--admin-radius-md);box-shadow:var(--admin-shadow-lg)}.admin-skip-link:focus{top:var(--admin-spacing-md);left:var(--admin-spacing-md)}.sr-only,.admin-sr-only,.visually-hidden{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.sr-only-focusable:focus,.sr-only-focusable:active{position:static;width:auto;height:auto;overflow:visible;clip:auto;white-space:normal}@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important;scroll-behavior:auto!important}}.admin-nav__item:focus-within{position:relative}.admin-nav__item:focus-within:before{content:"";position:absolute;left:-2px;right:-2px;top:-2px;bottom:-2px;border:2px solid var(--admin-focus-ring);border-radius:var(--admin-radius-md);pointer-events:none}body.user-is-tabbing *:focus{outline:3px solid var(--admin-accent-info);outline-offset:3px}@media(prefers-contrast:high){.admin-card,.admin-sidebar,.admin-header{border:2px solid currentColor}button,.admin-action-btn,.admin-nav__link{border:2px solid currentColor!important}}@media(pointer:coarse){button,a,input[type=checkbox],input[type=radio],.admin-action-btn,.admin-nav__link{min-width:44px;min-height:44px}}.text-contrast-aa{color:var(--admin-content-text)}.text-contrast-large{font-size:1.125rem;color:var(--admin-content-text);opacity:.9}.admin-error,.admin-form-error{color:var(--admin-accent-error)}.admin-error:before,.admin-form-error:before{content:"⚠ ";font-weight:700;margin-right:.25rem}[aria-invalid=true]{border-color:var(--admin-accent-error)!important;border-width:2px!important;background-image:url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="%23dc2626" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>');background-repeat:no-repeat;background-position:right .75rem center;background-size:1.25rem;padding-right:2.5rem}.admin-success:before{content:"✓ ";font-weight:700;color:var(--admin-accent-success);margin-right:.25rem}.admin-warning:before{content:"⚠ ";font-weight:700;color:var(--admin-accent-warning);margin-right:.25rem}.admin-info:before{content:"ℹ ";font-weight:700;color:var(--admin-accent-info);margin-right:.25rem}button:disabled,[aria-disabled=true]{opacity:.5;cursor:not-allowed;position:relative}button:disabled:after,[aria-disabled=true]:after{content:"";position:absolute;top:0;right:0;bottom:0;left:0;background-image:repeating-linear-gradient(45deg,transparent,transparent 5px,oklch(0% 0 0 / .05) 5px,oklch(0% 0 0 / .05) 10px);pointer-events:none}.admin-live-region{position:absolute;left:-10000px;width:1px;height:1px;overflow:hidden}table caption{font-weight:var(--admin-font-weight-semibold);text-align:left;padding:var(--admin-spacing-md);background-color:var(--admin-bg-secondary)}table th{font-weight:var(--admin-font-weight-semibold);text-align:left}table tbody tr:nth-child(2n){background-color:var(--admin-bg-secondary)}@media print{.admin-sidebar,.admin-header__actions,.admin-mobile-overlay,.admin-sidebar__mobile-toggle{display:none!important}.admin-content{max-width:100%!important;padding:0!important}a[href]:after{content:" (" attr(href) ")";font-size:.875em;color:var(--admin-content-text)}a[href^="#"]:after,a[href^="javascript:"]:after{content:""}}}@layer admin-utilities{:root{transition:background-color var(--admin-transition-base),color var(--admin-transition-base),border-color var(--admin-transition-base)}*{transition:background-color var(--admin-transition-base),color var(--admin-transition-base),border-color var(--admin-transition-base),box-shadow var(--admin-transition-base)}@media(prefers-reduced-motion:reduce){:root,*{transition:none!important}}html:not([data-theme]){visibility:hidden}html[data-theme]{visibility:visible}[data-theme-toggle] svg{transition:transform var(--admin-transition-base)}[data-theme-toggle]:hover svg{transform:rotate(20deg)}[data-theme=dark] img:not([data-no-dark-mode-filter]){filter:brightness(.9) contrast(1.1)}[data-theme=dark] .admin-sidebar__logo{filter:brightness(1.2)}@media(prefers-contrast:high){[data-theme=dark]{--admin-bg-primary: oklch(10% 0 0);--admin-content-text: oklch(100% 0 0)}[data-theme=light]{--admin-bg-primary: oklch(100% 0 0);--admin-content-text: oklch(0% 0 0)}}@media print{:root,[data-theme]{--admin-bg-primary: oklch(100% 0 0);--admin-content-bg: oklch(100% 0 0);--admin-content-text: oklch(0% 0 0);--admin-border-light: oklch(20% 0 0);--admin-shadow-sm: none;--admin-shadow-md: none;--admin-shadow-lg: none}}}
diff --git a/public/assets/js/main-C52nFCDL.js b/public/assets/js/main-C52nFCDL.js
new file mode 100644
index 00000000..7c0f9bca
--- /dev/null
+++ b/public/assets/js/main-C52nFCDL.js
@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,n,i)=>((t,n,i)=>n in t?e(t,n,{enumerable:!0,configurable:!0,writable:!0,value:i}):t[n]=i)(t,"symbol"!=typeof n?n+"":n,i);const n=new Map;let i=!1,s=!1;performance.now();const r=document.createElement("div");r.style.position="fixed",r.style.bottom="0",r.style.left="0",r.style.font="12px monospace",r.style.color="#0f0",r.style.background="rgba(0,0,0,0.75)",r.style.padding="0.25rem 0.5rem",r.style.zIndex="9999",r.style.pointerEvents="none",r.style.display="none";const o=`<div style="width:${Math.min(0,100)}%;height:4px;background:#0f0;margin-top:4px;"></div>`;r.innerHTML+=o,r.style.lineHeight="1.4",document.body.appendChild(r);const a=new class{constructor({fps:e=!0}={}){this.fpsEnabled=e,this.fps=0,this.frameCount=0,this.lastTime=performance.now(),this.visible=!1,this.taskTimings=new Map,this.logs=[],this.container=document.createElement("div"),this.container.style.position="fixed",this.container.style.bottom="0",this.container.style.left="0",this.container.style.font="12px Consolas, monospace",this.container.style.color="#0f0",this.container.style.background="rgba(0,0,0,0.75)",this.container.style.padding="0.5rem",this.container.style.zIndex="9999",this.container.style.pointerEvents="none",this.container.style.lineHeight="1.4",this.container.style.whiteSpace="pre",this.container.style.display="none",document.body.appendChild(this.container),window.addEventListener("keydown",e=>{"§"===e.key&&(this.visible=!this.visible,this.container.style.display=this.visible?"block":"none")})}log(e){const t=(new Date).toLocaleTimeString();this.logs.push(`[${t}] ${e}`),this.logs.length>5&&this.logs.shift()}update(e=new Map){this.frameCount++;const t=performance.now();if(t-this.lastTime>=1e3){this.fps=this.frameCount,this.frameCount=0,this.lastTime=t;const n=[];for(const[e,t]of this.taskTimings.entries())n.push(`${e}: ${t.toFixed(2)}ms`);const i=Math.min(2*this.fps,100),s=this.logs.slice().reverse().join("\n");this.container.innerHTML=`\nFPS: ${this.fps} | Tasks: ${e.size}\n${n.join("\n")}\n<div style="width:${i}%;height:4px;background:#0f0;margin-top:4px;"></div>\n${s?"\nLogs:\n"+s:""}\n      `}}trackTask(e,t){const n=performance.now();t();const i=performance.now()-n;this.taskTimings.set(e,i)}};function l(e,t,r={}){n.set(e,t),r.autoStart&&!i&&function(){if(i)return;function e(){for(const[e,i]of n)try{s?a.trackTask(e,i):i()}catch(t){d.warn("[Frameloop] Fehler in Task:",t)}s&&a.update(n),requestAnimationFrame(e)}i=!0,requestAnimationFrame(e)}()}function c(e){n.delete(e)}window.addEventListener("keydown",e=>{"§"===e.key&&(s=!s,r.style.display=s?"block":"none")});class d{static debug(...e){this._write("log","[DEBUG]",e,"debug")}static log(...e){this._write("log","[LOG]",e,"info")}static info(...e){this._write("info","[INFO]",e,"info")}static warn(...e){this._write("warn","[WARN]",e,"warn")}static error(...e){this._write("error","[ERROR]",e,"error")}static _write(e,t,n,i="info"){if(!this.enabled)return;const s=this.levels[this.level]||this.levels.info;if((this.levels[i]||this.levels.info)<s)return;const r=`${t} [${(new Date).toLocaleTimeString("de-DE")}] ${n.map(e=>{if(e instanceof Error)return`${e.name}: ${e.message}\n${e.stack||""}`;if("object"==typeof e&&null!==e)try{return JSON.stringify(e)}catch(t){return"[Circular Object]"}return e}).join(" ")}`;if("function"==typeof console[e]&&console[e](r),a&&"function"==typeof a.log)try{a.log(r)}catch(o){}}static setLevel(e){this.levels.hasOwnProperty(e)?(this.level=e,this.info(`[Logger] Log level set to: ${e}`)):this.warn(`[Logger] Invalid log level: ${e}. Valid levels:`,Object.keys(this.levels))}static setEnabled(e){this.enabled=!!e,e&&console.log("[Logger] Logging enabled")}}t(d,"enabled",!1),t(d,"level","error"),t(d,"levels",{debug:0,info:1,warn:2,error:3,none:99});class h{constructor(e={}){this.config=e,this.enabled=e.enabled??!0}async track(e,t={}){this.enabled}async pageView(e,t={}){this.enabled}async identify(e,t={}){this.enabled}}class u extends h{constructor(e={}){super(e),this.measurementId=e.measurementId||e.gaId}async track(e,t={}){"undefined"!=typeof gtag&&gtag("event",e,t)}async pageView(e,t={}){"undefined"!=typeof gtag&&gtag("config",this.measurementId,{page_path:e,...t})}}class p extends h{constructor(e={}){super(e),this.endpoint=e.endpoint||"/api/analytics"}async track(e,t={}){try{await fetch(this.endpoint,{method:"POST",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest"},body:JSON.stringify({type:"event",name:e,properties:t,timestamp:Date.now()})})}catch(n){d.error("[Analytics] Failed to track event",n)}}async pageView(e,t={}){try{await fetch(this.endpoint,{method:"POST",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest"},body:JSON.stringify({type:"page_view",path:e,properties:t,timestamp:Date.now()})})}catch(n){d.error("[Analytics] Failed to track page view",n)}}}class m{constructor(e={}){this.config={enabled:e.enabled??!0,providers:e.providers||[],gdprCompliant:e.gdprCompliant??!0,requireConsent:e.requireConsent??!1,consentGiven:e.consentGiven??!1,anonymizeIp:e.anonymizeIp??!0,...e},this.providers=[],this.eventQueue=[],this.userId=null,this.userTraits={},this.initProviders(),this.config.enabled&&this.hasConsent()&&this.trackPageView(),d.info("[Analytics] Initialized",{enabled:this.config.enabled,providers:this.providers.length,gdprCompliant:this.config.gdprCompliant})}static create(e={}){return new m(e)}initProviders(){for(const e of this.config.providers){let t;"string"==typeof e?"google-analytics"===e||"ga"===e?t=new u({}):"custom"===e&&(t=new p({})):"object"==typeof e&&("google-analytics"===e.type||"ga"===e.type?t=new u(e):"custom"===e.type?t=new p(e):e instanceof h&&(t=e)),t&&this.providers.push(t)}}hasConsent(){return!this.config.requireConsent||this.config.consentGiven}giveConsent(){this.config.consentGiven=!0,this.processEventQueue(),d.info("[Analytics] Consent given")}revokeConsent(){this.config.consentGiven=!1,d.info("[Analytics] Consent revoked")}async track(e,t={}){if(!this.config.enabled||!this.hasConsent())return void(this.config.requireConsent&&!this.config.consentGiven&&this.eventQueue.push({type:"event",name:e,properties:t}));const n={name:e,properties:this.anonymizeData(t),timestamp:Date.now(),userId:this.userId};for(const s of this.providers)try{await s.track(e,n.properties)}catch(i){d.error("[Analytics] Provider error",i)}d.debug("[Analytics] Event tracked",n),this.triggerAnalyticsEvent("track",n)}async trackPageView(e=null,t={}){if(!this.config.enabled||!this.hasConsent())return;const n=e||window.location.pathname,i={path:n,title:document.title,properties:this.anonymizeData(t),timestamp:Date.now()};for(const r of this.providers)try{await r.pageView(n,i.properties)}catch(s){d.error("[Analytics] Provider error",s)}d.debug("[Analytics] Page view tracked",i),this.triggerAnalyticsEvent("page_view",i)}async identify(e,t={}){if(this.config.enabled&&this.hasConsent()){this.userId=e,this.userTraits={...this.userTraits,...t};for(const t of this.providers)try{"function"==typeof t.identify&&await t.identify(e,this.userTraits)}catch(n){d.error("[Analytics] Provider error",n)}d.debug("[Analytics] User identified",{userId:e,traits:this.userTraits})}}async trackBehavior(e,t,n={}){await this.track("user_behavior",{action:e,target:t,...n})}anonymizeData(e){if(!this.config.gdprCompliant)return e;const t={...e};this.config.anonymizeIp&&t.ip&&(t.ip=t.ip.split(".").slice(0,3).join(".")+".0");return["email","phone","address","ssn","credit_card"].forEach(e=>{t[e]&&delete t[e]}),t}processEventQueue(){for(;this.eventQueue.length>0;){const e=this.eventQueue.shift();"event"===e.type&&this.track(e.name,e.properties)}}triggerAnalyticsEvent(e,t){const n=new CustomEvent(`analytics:${e}`,{detail:t,bubbles:!0});window.dispatchEvent(n)}enable(){this.config.enabled=!0,d.info("[Analytics] Enabled")}disable(){this.config.enabled=!1,d.info("[Analytics] Disabled")}destroy(){this.providers=[],this.eventQueue=[],this.userId=null,this.userTraits={},d.info("[Analytics] Destroyed")}}const g={name:"analytics",analytics:null,init(e={},t=null){return d.info("[AnalyticsModule] Module initialized"),this.analytics=m.create(e),"undefined"!=typeof window&&(window.Analytics=this.analytics),this},getAnalytics(){return this.analytics||m.create()},async track(e,t={}){const n=this.getAnalytics();return await n.track(e,t)},async trackPageView(e=null,t={}){const n=this.getAnalytics();return await n.trackPageView(e,t)},destroy(){this.analytics&&(this.analytics.destroy(),this.analytics=null),"undefined"!=typeof window&&window.Analytics&&delete window.Analytics,d.info("[AnalyticsModule] Module destroyed")}},f=g.init.bind(g),y=Object.freeze(Object.defineProperty({__proto__:null,Analytics:m,AnalyticsProvider:h,CustomProvider:p,GoogleAnalyticsProvider:u,default:g,init:f},Symbol.toStringTag,{value:"Module"}));class v{constructor(e,t={}){this.element=e,this.config={type:t.type||"fade-in",offset:t.offset||.85,delay:t.delay||0,once:!1!==t.once,speed:t.speed||.5,fadeStart:t.fadeStart||0,fadeEnd:t.fadeEnd||1,steps:t.steps||3,...t},this.triggered=!1,this.needsUpdate=!0,this.init()}init(){switch(this.config.type){case"fade-in":case"zoom-in":this.initFadeIn();break;case"parallax":this.initParallax();break;case"sticky-fade":this.initStickyFade();break;case"sticky-steps":this.initStickySteps()}}initFadeIn(){this.element.style.opacity="0",this.element.style.transition="opacity 0.6s ease, transform 0.6s ease",this.element.style.transitionDelay=`${this.config.delay}s`,"zoom-in"===this.config.type&&(this.element.style.transform="scale(0.9)")}initParallax(){this.needsUpdate=!0}initStickyFade(){this.element.style.position="sticky",this.element.style.top="0"}initStickySteps(){this.element.style.position="sticky",this.element.style.top="0"}enter(){if(!this.triggered||!this.config.once)switch(this.triggered=!0,this.config.type){case"fade-in":this.element.style.opacity="1",this.element.classList.add("visible","entered");break;case"zoom-in":this.element.style.opacity="1",this.element.style.transform="scale(1)",this.element.classList.add("visible","entered")}}exit(){if(!this.config.once)switch(this.triggered=!1,this.config.type){case"fade-in":this.element.style.opacity="0",this.element.classList.remove("visible","entered");break;case"zoom-in":this.element.style.opacity="0",this.element.style.transform="scale(0.9)",this.element.classList.remove("visible","entered")}}update(){const e=this.element.getBoundingClientRect(),t=window.innerHeight,n=window.scrollY;switch(this.config.type){case"parallax":this.updateParallax(e,n);break;case"sticky-fade":this.updateStickyFade(e,t);break;case"sticky-steps":this.updateStickySteps(e,t,n)}}updateParallax(e,t){const n=(t-(e.top+t))*this.config.speed;this.element.style.transform=`translateY(${n}px)`}updateStickyFade(e,t){const n=Math.max(0,Math.min(1,(t-e.top)/t)),i=this.config.fadeStart+(this.config.fadeEnd-this.config.fadeStart)*n;this.element.style.opacity=i.toString()}updateStickySteps(e,t,n){e.top;const i=Math.max(0,Math.min(1,n/(e.height+t))),s=Math.floor(i*this.config.steps);this.element.setAttribute("data-step",s.toString()),this.element.classList.remove("step-0","step-1","step-2","step-3","step-4","step-5"),this.element.classList.add(`step-${s}`)}destroy(){this.element.style.opacity="",this.element.style.transform="",this.element.style.transition="",this.element.style.transitionDelay="",this.element.style.position="",this.element.style.top="",this.element.classList.remove("visible","entered"),this.triggered=!1}}class b{constructor(e,t={}){this.element=e,this.config={steps:t.steps||null,triggerPoint:t.triggerPoint||.4,loop:t.loop??!1,...t},this.currentStep=0,this.triggered=!1,this.init()}init(){this.element.setAttribute("data-scroll-step","0"),this.element.classList.add("scroll-timeline")}enter(){this.triggered&&!this.config.loop||(this.triggered=!0,this.update())}exit(){this.config.loop&&(this.currentStep=0,this.update())}update(){const e=this.element.getBoundingClientRect(),t=window.innerHeight,n=t*this.config.triggerPoint;if(e.top<n&&e.bottom>0){const i=Math.max(0,Math.min(1,(n-e.top)/(e.height+t)));if(this.config.steps){const e=Math.floor(i*this.config.steps);this.setStep(e)}else this.setProgress(i)}}setStep(e){if(e!==this.currentStep){this.currentStep=e,this.element.setAttribute("data-scroll-step",e.toString());for(let e=0;e<=this.config.steps;e++)this.element.classList.remove(`step-${e}`);this.element.classList.add(`step-${e}`),this.triggerStepEvent(e)}}setProgress(e){this.element.setAttribute("data-scroll-progress",e.toString()),this.element.style.setProperty("--scroll-progress",e.toString()),this.triggerProgressEvent(e)}triggerStepEvent(e){const t=new CustomEvent("scroll-timeline:step",{detail:{step:e,element:this.element},bubbles:!0});this.element.dispatchEvent(t)}triggerProgressEvent(e){const t=new CustomEvent("scroll-timeline:progress",{detail:{progress:e,element:this.element},bubbles:!0});this.element.dispatchEvent(t)}destroy(){this.element.removeAttribute("data-scroll-step"),this.element.removeAttribute("data-scroll-progress"),this.element.style.removeProperty("--scroll-progress"),this.element.classList.remove("scroll-timeline");for(let e=0;e<=10;e++)this.element.classList.remove(`step-${e}`);this.currentStep=0,this.triggered=!1}}class w{constructor(e={}){this.config={enabled:e.enabled??!0,useIntersectionObserver:e.useIntersectionObserver??!0,throttleDelay:e.throttleDelay||16,...e},this.animations=new Map,this.observers=new Map,this.scrollHandler=null,this.isScrolling=!1,this.config.enabled&&this.init(),d.info("[AnimationSystem] Initialized",{enabled:this.config.enabled,useIntersectionObserver:this.config.useIntersectionObserver})}static create(e={}){return new w(e)}init(){this.config.useIntersectionObserver||this.setupScrollHandler(),this.autoInitialize()}setupScrollHandler(){let e=!1;this.scrollHandler=()=>{e||(window.requestAnimationFrame(()=>{this.updateAnimations(),e=!1}),e=!0)},window.addEventListener("scroll",this.scrollHandler,{passive:!0})}autoInitialize(){this.initializeFadeIn(),this.initializeParallax(),this.initializeTimeline(),this.initializeStickyFade(),this.initializeStickySteps()}initializeFadeIn(){document.querySelectorAll('.fade-in-on-scroll, .zoom-in, [data-animate="fade-in"]').forEach(e=>{this.registerAnimation(e,{type:"fade-in",offset:parseFloat(e.dataset.offset)||.85,delay:parseFloat(e.dataset.delay)||0,once:"false"!==e.dataset.once})})}initializeParallax(){document.querySelectorAll("[data-parallax], .parallax").forEach(e=>{const t=parseFloat(e.dataset.parallax||e.dataset.speed)||.5;this.registerAnimation(e,{type:"parallax",speed:t})})}initializeTimeline(){document.querySelectorAll("[data-scroll-timeline], [data-scroll-step]").forEach(e=>{this.registerAnimation(e,{type:"timeline",steps:e.dataset.scrollSteps?parseInt(e.dataset.scrollSteps):null,triggerPoint:parseFloat(e.dataset.triggerPoint)||.4})})}initializeStickyFade(){document.querySelectorAll("[data-sticky-fade], .sticky-fade").forEach(e=>{this.registerAnimation(e,{type:"sticky-fade",fadeStart:parseFloat(e.dataset.fadeStart)||0,fadeEnd:parseFloat(e.dataset.fadeEnd)||1})})}initializeStickySteps(){document.querySelectorAll("[data-sticky-steps], .sticky-steps").forEach(e=>{const t=e.dataset.stickySteps?parseInt(e.dataset.stickySteps):3;this.registerAnimation(e,{type:"sticky-steps",steps:t})})}registerAnimation(e,t){if(this.animations.has(e))return void d.warn("[AnimationSystem] Animation already registered for element",e);let n;switch(t.type){case"fade-in":case"zoom-in":n=new v(e,{type:t.type,offset:t.offset||.85,delay:t.delay||0,once:!1!==t.once});break;case"parallax":n=new v(e,{type:"parallax",speed:t.speed||.5});break;case"timeline":n=new b(e,{steps:t.steps,triggerPoint:t.triggerPoint||.4});break;case"sticky-fade":n=new v(e,{type:"sticky-fade",fadeStart:t.fadeStart||0,fadeEnd:t.fadeEnd||1});break;case"sticky-steps":n=new v(e,{type:"sticky-steps",steps:t.steps||3});break;default:return void d.warn("[AnimationSystem] Unknown animation type",t.type)}this.animations.set(e,n),this.config.useIntersectionObserver&&this.setupObserver(e,n),d.debug("[AnimationSystem] Animation registered",{element:e,type:t.type})}setupObserver(e,t){const n=new IntersectionObserver(e=>{e.forEach(e=>{e.isIntersecting?t.enter():t.config.once||t.exit()})},{threshold:t.config.offset||.85,rootMargin:"0px"});n.observe(e),this.observers.set(e,n)}updateAnimations(){this.animations.forEach((e,t)=>{e.needsUpdate&&e.update()})}removeAnimation(e){const t=this.animations.get(e);t&&(t.destroy(),this.animations.delete(e));const n=this.observers.get(e);n&&(n.disconnect(),this.observers.delete(e))}destroy(){this.animations.forEach((e,t)=>{this.removeAnimation(t)}),this.scrollHandler&&window.removeEventListener("scroll",this.scrollHandler),d.info("[AnimationSystem] Destroyed")}}const S=new class{constructor(){this.triggers=new Set,this.viewportHeight=window.innerHeight,this._loop=this._loop.bind(this),window.addEventListener("resize",()=>{this.viewportHeight=window.innerHeight}),requestAnimationFrame(this._loop)}register(e){this.triggers.add(e)}unregister(e){this.triggers.delete(e)}clear(){this.triggers.clear()}_loop(){this.triggers.forEach(e=>{e.update(this.viewportHeight)}),requestAnimationFrame(this._loop)}};class C{constructor(e){if(this.element=this.resolveElement(e.element),this.target=e.target?this.element.querySelector(e.target):this.element,e.target&&!this.target)throw new Error(`Target selector '${e.target}' not found inside element '${e.element}'.`);this.start=e.start||"top 80%",this.end=e.end||"bottom 20%",this.scrub=e.scrub||!1,this.onEnter=e.onEnter||null,this.onLeave=e.onLeave||null,this.onUpdate=e.onUpdate||null,this._wasVisible=!1,this._progress=0}resolveElement(e){if("string"==typeof e){const t=document.querySelectorAll(e);if(1===t.length)return t[0];throw new Error(`Selector '${e}' matched ${t.length} elements, expected exactly 1.`)}return e}getScrollProgress(e){const t=this.element.getBoundingClientRect(),n=this.parsePosition(this.start,e),i=this.parsePosition(this.end,e)-n,s=t.top-n;return 1-Math.min(Math.max(s/i,0),1)}parsePosition(e,t){const[n,i]=e.split(" ");return("top"===n?0:t)-t*(parseFloat(i)/100)}update(e){const t=this.element.getBoundingClientRect(),n=t.bottom>0&&t.top<e;if(n&&!this._wasVisible&&(this._wasVisible=!0,this.onEnter&&this.onEnter(this.target)),!n&&this._wasVisible&&(this._wasVisible=!1,this.onLeave&&this.onLeave(this.target)),this.scrub&&n){const t=this.getScrollProgress(e);this.onUpdate&&this.onUpdate(this.target,t)}}}function M(e){const t="string"==typeof e.element?document.querySelectorAll(e.element):[e.element],n=[];return t.forEach(t=>{const i=new C({...e,element:t});S.register(i),n.push(i)}),1===n.length?n[0]:n}const k=Object.freeze(Object.defineProperty({__proto__:null,createTrigger:M,init:function(e={}){const{selector:t=".fade-in-on-scroll, .zoom-in, .fade-out, .fade",offset:n=.85,baseDelay:i=.05,once:s=!0}=e,r=Array.from(document.querySelectorAll(t)).map(e=>({el:e,triggered:!1}));requestAnimationFrame(function e(){const t=window.innerHeight*n;r.forEach((e,n)=>{if(e.triggered&&s)return;e.el.getBoundingClientRect().top<t?(e.el.style.transitionDelay=n*i+"s",e.el.classList.add("visible","entered"),e.el.classList.remove("fade-out"),e.triggered=!0):s||(e.el.classList.remove("visible","entered"),e.triggered=!1)}),requestAnimationFrame(e)})}},Symbol.toStringTag,{value:"Module"})),E={name:"animation-system",animationSystem:null,init(e={},t=null){return d.info("[AnimationSystemModule] Module initialized"),this.animationSystem=w.create(e),"undefined"!=typeof window&&(window.AnimationSystem=this.animationSystem),this},getAnimationSystem(){return this.animationSystem||w.create()},registerAnimation(e,t){this.getAnimationSystem().registerAnimation(e,t)},destroy(){this.animationSystem&&(this.animationSystem.destroy(),this.animationSystem=null),"undefined"!=typeof window&&window.AnimationSystem&&delete window.AnimationSystem,d.info("[AnimationSystemModule] Module destroyed")}},x=E.init.bind(E),A=Object.freeze(Object.defineProperty({__proto__:null,AnimationSystem:w,ScrollAnimation:v,TimelineAnimation:b,createTrigger:M,default:E,init:x},Symbol.toStringTag,{value:"Module"}));class T{constructor(e={}){this.config=e,this.activeObservers=new Map,this.observerInstances=new Map,d.info("[ObserverManager] Initialized with support:",{intersection:"IntersectionObserver"in window,resize:"ResizeObserver"in window,mutation:"MutationObserver"in window,performance:"PerformanceObserver"in window})}intersection(e,t,n={}){if(!("IntersectionObserver"in window))return d.warn("[ObserverManager] IntersectionObserver not supported"),this.createFallbackObserver("intersection",e,t);const i={root:null,rootMargin:"50px",threshold:[0,.1,.5,1],...n},s=this.generateId("intersection"),r=new IntersectionObserver((e,n)=>{const i=e.map(e=>({element:e.target,isIntersecting:e.isIntersecting,intersectionRatio:e.intersectionRatio,boundingClientRect:e.boundingClientRect,rootBounds:e.rootBounds,intersectionRect:e.intersectionRect,time:e.time,visibility:this.calculateVisibility(e),direction:this.getScrollDirection(e),position:this.getElementPosition(e)}));t(i,n)},i),o=Array.isArray(e)?e:[e];return o.forEach(e=>{e instanceof Element&&r.observe(e)}),this.observerInstances.set(s,r),this.activeObservers.set(s,{type:"intersection",elements:o,callback:t,options:i}),d.info(`[ObserverManager] IntersectionObserver created: ${s}`),{id:s,observer:r,unobserve:e=>r.unobserve(e),disconnect:()=>this.disconnect(s),updateThreshold:e=>this.updateIntersectionThreshold(s,e)}}resize(e,t,n={}){if(!("ResizeObserver"in window))return d.warn("[ObserverManager] ResizeObserver not supported"),this.createFallbackObserver("resize",e,t);const i=this.generateId("resize"),s=new ResizeObserver(e=>{const n=e.map(e=>({element:e.target,contentRect:e.contentRect,borderBoxSize:e.borderBoxSize,contentBoxSize:e.contentBoxSize,devicePixelContentBoxSize:e.devicePixelContentBoxSize,dimensions:{width:e.contentRect.width,height:e.contentRect.height,aspectRatio:e.contentRect.width/e.contentRect.height},deltaSize:this.calculateDeltaSize(e),breakpoint:this.detectBreakpoint(e.contentRect.width)}));t(n)}),r=Array.isArray(e)?e:[e];return r.forEach(e=>{e instanceof Element&&s.observe(e)}),this.observerInstances.set(i,s),this.activeObservers.set(i,{type:"resize",elements:r,callback:t,options:n}),d.info(`[ObserverManager] ResizeObserver created: ${i}`),{id:i,observer:s,unobserve:e=>s.unobserve(e),disconnect:()=>this.disconnect(i)}}mutation(e,t,n={}){if(!("MutationObserver"in window))return d.warn("[ObserverManager] MutationObserver not supported"),null;const i={childList:!0,attributes:!0,subtree:!0,attributeOldValue:!0,characterDataOldValue:!0,...n},s=this.generateId("mutation"),r=new MutationObserver(e=>{const n=e.map(e=>({type:e.type,target:e.target,addedNodes:Array.from(e.addedNodes),removedNodes:Array.from(e.removedNodes),attributeName:e.attributeName,attributeNamespace:e.attributeNamespace,oldValue:e.oldValue,summary:this.summarizeMutation(e),impact:this.assessMutationImpact(e)}));t(n)});return r.observe(e,i),this.observerInstances.set(s,r),this.activeObservers.set(s,{type:"mutation",target:e,callback:t,options:i}),d.info(`[ObserverManager] MutationObserver created: ${s}`),{id:s,observer:r,disconnect:()=>this.disconnect(s),takeRecords:()=>r.takeRecords()}}performance(e,t={}){if(!("PerformanceObserver"in window))return d.warn("[ObserverManager] PerformanceObserver not supported"),null;const n={entryTypes:["measure","navigation","paint","largest-contentful-paint"],buffered:!0,...t},i=this.generateId("performance"),s=new PerformanceObserver(t=>{const n=t.getEntries().map(e=>({name:e.name,entryType:e.entryType,startTime:e.startTime,duration:e.duration,details:this.enhancePerformanceEntry(e),timestamp:Date.now()}));e(n)});return s.observe(n),this.observerInstances.set(i,s),this.activeObservers.set(i,{type:"performance",callback:e,options:n}),d.info(`[ObserverManager] PerformanceObserver created: ${i}`),{id:i,observer:s,disconnect:()=>this.disconnect(i),takeRecords:()=>s.takeRecords()}}lazyLoad(e="img[data-src], iframe[data-src]",t={}){const n=document.querySelectorAll(e);return this.intersection(n,e=>{e.forEach(e=>{if(e.isIntersecting){const t=e.element;t.dataset.src&&(t.src=t.dataset.src,delete t.dataset.src),t.dataset.srcset&&(t.srcset=t.dataset.srcset,delete t.dataset.srcset),t.classList.add("loaded"),e.observer.unobserve(t),d.info("[ObserverManager] Lazy loaded:",t.src)}})},{rootMargin:"100px",...t})}scrollTrigger(e,t,n={}){return this.intersection(e,e=>{e.forEach(e=>{const n={element:e.element,progress:e.intersectionRatio,isVisible:e.isIntersecting,direction:e.direction,position:e.position};t(n)})},{threshold:this.createThresholdArray(n.steps||10),...n})}viewport(e,t={}){const n=document.createElement("div");return n.style.cssText="\n            position: fixed;\n            top: 0;\n            left: 0;\n            width: 100%;\n            height: 100%;\n            pointer-events: none;\n            visibility: hidden;\n        ",document.body.appendChild(n),this.resize([n],t=>{const n=t[0];e({width:n.dimensions.width,height:n.dimensions.height,aspectRatio:n.dimensions.aspectRatio,orientation:n.dimensions.width>n.dimensions.height?"landscape":"portrait",breakpoint:n.breakpoint})},t)}generateId(e){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}disconnect(e){const t=this.observerInstances.get(e);t&&(t.disconnect(),this.observerInstances.delete(e),this.activeObservers.delete(e),d.info(`[ObserverManager] Observer disconnected: ${e}`))}disconnectAll(){this.observerInstances.forEach((e,t)=>{e.disconnect()}),this.observerInstances.clear(),this.activeObservers.clear(),d.info("[ObserverManager] All observers disconnected")}calculateVisibility(e){if(!e.isIntersecting)return 0;const t=e.intersectionRect.width*e.intersectionRect.height,n=e.boundingClientRect.width*e.boundingClientRect.height;return n>0?Math.round(t/n*100):0}getScrollDirection(e){return e.intersectionRatio>.5?"down":"up"}getElementPosition(e){const t=e.boundingClientRect,n=window.innerHeight;return t.top<0&&t.bottom>0?"entering-top":t.top<n&&t.bottom>n?"entering-bottom":t.top>=0&&t.bottom<=n?"visible":"hidden"}calculateDeltaSize(e){return{width:0,height:0}}detectBreakpoint(e){return e<576?"xs":e<768?"sm":e<992?"md":e<1200?"lg":"xl"}summarizeMutation(e){return`${e.type} on ${e.target.tagName}`}assessMutationImpact(e){return"childList"===e.type?e.addedNodes.length+e.removedNodes.length>5?"high":"low":"medium"}enhancePerformanceEntry(e){const t={raw:e};switch(e.entryType){case"navigation":t.loadTime=e.loadEventEnd-e.navigationStart,t.domContentLoaded=e.domContentLoadedEventEnd-e.navigationStart;break;case"paint":t.paintType=e.name;break;case"largest-contentful-paint":t.element=e.element,t.url=e.url}return t}createThresholdArray(e){const t=[];for(let n=0;n<=e;n++)t.push(n/e);return t}createFallbackObserver(e,t,n){d.warn(`[ObserverManager] Creating fallback for ${e}Observer`);const i=this.generateId(`fallback_${e}`);let s;if("intersection"===e)s=setInterval(()=>{const e=(Array.isArray(t)?t:[t]).map(e=>({element:e,isIntersecting:this.isElementInViewport(e),intersectionRatio:this.calculateIntersectionRatio(e)}));n(e)},100);return{id:i,disconnect:()=>{s&&clearInterval(s)}}}isElementInViewport(e){const t=e.getBoundingClientRect();return t.top>=0&&t.left>=0&&t.bottom<=window.innerHeight&&t.right<=window.innerWidth}calculateIntersectionRatio(e){const t=e.getBoundingClientRect(),n=window.innerHeight,i=window.innerWidth,s=Math.min(t.bottom,n)-Math.max(t.top,0),r=Math.min(t.right,i)-Math.max(t.left,0);if(s<=0||r<=0)return 0;const o=s*r,a=t.height*t.width;return a>0?o/a:0}getActiveObservers(){return Array.from(this.activeObservers.entries()).map(([e,t])=>({id:e,...t}))}}class I{constructor(e={}){var t;this.config=e,this.activeStreams=new Map,this.activeConnections=new Map,this.audioContext=null,this.support={mediaDevices:void 0!==navigator.mediaDevices,webRTC:"RTCPeerConnection"in window,webAudio:"AudioContext"in window||"webkitAudioContext"in window,mediaRecorder:"MediaRecorder"in window,screenShare:void 0!==(null==(t=navigator.mediaDevices)?void 0:t.getDisplayMedia)},d.info("[MediaManager] Initialized with support:",this.support)}async getUserCamera(e={}){if(!this.support.mediaDevices)throw new Error("MediaDevices API not supported");const t={video:{width:{ideal:1280},height:{ideal:720},facingMode:"user"},audio:!1,...e};try{const e=await navigator.mediaDevices.getUserMedia(t),n=this.generateId("camera");return this.activeStreams.set(n,{stream:e,type:"camera",constraints:t,tracks:e.getTracks()}),d.info(`[MediaManager] Camera stream acquired: ${n}`),{id:n,stream:e,video:e.getVideoTracks()[0],audio:e.getAudioTracks()[0],stop:()=>this.stopStream(n),switchCamera:()=>this.switchCamera(n),takePhoto:t=>this.takePhoto(e,t),applyFilter:e=>this.applyVideoFilter(n,e)}}catch(n){throw d.warn("[MediaManager] Camera access failed:",n.message),n}}async getUserMicrophone(e={}){if(!this.support.mediaDevices)throw new Error("MediaDevices API not supported");const t={audio:{echoCancellation:!0,noiseSuppression:!0,autoGainControl:!0,...e.audio},video:!1,...e};try{const e=await navigator.mediaDevices.getUserMedia(t),n=this.generateId("microphone");return this.activeStreams.set(n,{stream:e,type:"microphone",constraints:t,tracks:e.getTracks()}),d.info(`[MediaManager] Microphone stream acquired: ${n}`),{id:n,stream:e,audio:e.getAudioTracks()[0],stop:()=>this.stopStream(n),getVolume:()=>this.getAudioLevel(e),startRecording:t=>this.startRecording(e,t)}}catch(n){throw d.warn("[MediaManager] Microphone access failed:",n.message),n}}async getScreenShare(e={}){if(!this.support.screenShare)throw new Error("Screen sharing not supported");const t={video:{cursor:"always"},audio:!1,...e};try{const e=await navigator.mediaDevices.getDisplayMedia(t),n=this.generateId("screen");return this.activeStreams.set(n,{stream:e,type:"screen",constraints:t,tracks:e.getTracks()}),e.getTracks().forEach(e=>{e.addEventListener("ended",()=>{this.stopStream(n)})}),d.info(`[MediaManager] Screen share acquired: ${n}`),{id:n,stream:e,video:e.getVideoTracks()[0],audio:e.getAudioTracks()[0],stop:()=>this.stopStream(n)}}catch(n){throw d.warn("[MediaManager] Screen share failed:",n.message),n}}async startRecording(e,t={}){if(!this.support.mediaRecorder)throw new Error("MediaRecorder API not supported");const n={mimeType:"video/webm;codecs=vp9",videoBitsPerSecond:2e6,audioBitsPerSecond:128e3,...t},i=this.getSupportedMimeType(["video/webm;codecs=vp9","video/webm;codecs=vp8","video/webm","video/mp4"])||n.mimeType,s=new MediaRecorder(e,{...n,mimeType:i}),r=this.generateId("recording"),o=[];return s.ondataavailable=e=>{e.data.size>0&&o.push(e.data)},s.onstop=()=>{const e=new Blob(o,{type:i});this.onRecordingComplete(r,e)},s.start(),d.info(`[MediaManager] Recording started: ${r}`),{id:r,recorder:s,stop:()=>(s.stop(),new Promise(e=>{s.onstop=()=>{const t=new Blob(o,{type:i});e({blob:t,url:URL.createObjectURL(t),size:t.size,type:t.type,download:(e=`recording-${Date.now()}.webm`)=>{this.downloadBlob(t,e)}})}})),pause:()=>s.pause(),resume:()=>s.resume(),get state(){return s.state}}}takePhoto(e,t){const n=document.createElement("video");return n.srcObject=e,n.autoplay=!0,n.muted=!0,new Promise(e=>{n.onloadedmetadata=()=>{t||(t=document.createElement("canvas")),t.width=n.videoWidth,t.height=n.videoHeight;t.getContext("2d").drawImage(n,0,0),t.toBlob(n=>{e({canvas:t,blob:n,url:URL.createObjectURL(n),dataURL:t.toDataURL("image/jpeg",.9),download:(e=`photo-${Date.now()}.jpg`)=>{this.downloadBlob(n,e)}})},"image/jpeg",.9),n.remove()}})}getAudioContext(){if(!this.audioContext){if(!this.support.webAudio)return d.warn("[MediaManager] Web Audio API not supported"),null;this.audioContext=new(window.AudioContext||window.webkitAudioContext),d.info("[MediaManager] Audio context created")}return this.audioContext}createAudioAnalyzer(e,t={}){const n=this.getAudioContext();if(!n)return null;const i=n.createMediaStreamSource(e),s=n.createAnalyser();s.fftSize=t.fftSize||256,s.smoothingTimeConstant=t.smoothing||.8,i.connect(s);const r=s.frequencyBinCount,o=new Uint8Array(r);return{analyzer:s,bufferLength:r,dataArray:o,getFrequencyData:()=>(s.getByteFrequencyData(o),Array.from(o)),getTimeDomainData:()=>(s.getByteTimeDomainData(o),Array.from(o)),getAverageVolume:()=>(s.getByteFrequencyData(o),o.reduce((e,t)=>e+t,0)/r)}}async createPeerConnection(e={}){if(!this.support.webRTC)throw new Error("WebRTC not supported");const t={iceServers:[{urls:"stun:stun.l.google.com:19302"},{urls:"stun:stun1.l.google.com:19302"}],...e},n=new RTCPeerConnection(t),i=this.generateId("rtc");this.activeConnections.set(i,n);const s={id:i,connection:n,onTrack:e=>n.addEventListener("track",e),onIceCandidate:e=>n.addEventListener("icecandidate",e),onConnectionStateChange:e=>n.addEventListener("connectionstatechange",e),addStream:e=>{e.getTracks().forEach(t=>{n.addTrack(t,e)})},createOffer:()=>n.createOffer(),createAnswer:()=>n.createAnswer(),setLocalDescription:e=>n.setLocalDescription(e),setRemoteDescription:e=>n.setRemoteDescription(e),addIceCandidate:e=>n.addIceCandidate(e),close:()=>{n.close(),this.activeConnections.delete(i)},get connectionState(){return n.connectionState},get iceConnectionState(){return n.iceConnectionState}};return d.info(`[MediaManager] Peer connection created: ${i}`),s}async getDevices(){if(!this.support.mediaDevices)return{cameras:[],microphones:[],speakers:[]};try{const e=await navigator.mediaDevices.enumerateDevices();return{cameras:e.filter(e=>"videoinput"===e.kind),microphones:e.filter(e=>"audioinput"===e.kind),speakers:e.filter(e=>"audiooutput"===e.kind),all:e}}catch(e){return d.warn("[MediaManager] Device enumeration failed:",e),{cameras:[],microphones:[],speakers:[]}}}async checkPermissions(){const e={};try{if(navigator.permissions){const t=await navigator.permissions.query({name:"camera"}),n=await navigator.permissions.query({name:"microphone"});e.camera=t.state,e.microphone=n.state}}catch(t){d.warn("[MediaManager] Permission check failed:",t)}return e}stopStream(e){const t=this.activeStreams.get(e);t&&(t.tracks.forEach(e=>e.stop()),this.activeStreams.delete(e),d.info(`[MediaManager] Stream stopped: ${e}`))}stopAllStreams(){this.activeStreams.forEach((e,t)=>{e.tracks.forEach(e=>e.stop())}),this.activeStreams.clear(),d.info("[MediaManager] All streams stopped")}async switchCamera(e){const t=this.activeStreams.get(e);if(!t||"camera"!==t.type)return null;const n="user"===t.constraints.video.facingMode?"environment":"user";return this.stopStream(e),this.getUserCamera({video:{...t.constraints.video,facingMode:n}})}getAudioLevel(e){const t=this.getAudioContext();if(!t)return 0;const n=t.createMediaStreamSource(e),i=t.createAnalyser();n.connect(i);const s=new Uint8Array(i.frequencyBinCount);return i.getByteFrequencyData(s),s.reduce((e,t)=>e+t,0)/s.length}getSupportedMimeType(e){return e.find(e=>MediaRecorder.isTypeSupported(e))}downloadBlob(e,t){const n=URL.createObjectURL(e),i=document.createElement("a");i.href=n,i.download=t,document.body.appendChild(i),i.click(),document.body.removeChild(i),URL.revokeObjectURL(n)}generateId(e="media"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}onRecordingComplete(e,t){d.info(`[MediaManager] Recording completed: ${e}, size: ${t.size} bytes`)}applyVideoFilter(e,t){const n=this.activeStreams.get(e);if(!n||"camera"!==n.type)return;const i={none:"none",blur:"blur(2px)",brightness:"brightness(1.2)",contrast:"contrast(1.3)",grayscale:"grayscale(1)",sepia:"sepia(1)",invert:"invert(1)",vintage:"sepia(0.8) contrast(1.4) brightness(1.1)",cool:"hue-rotate(180deg) saturate(1.5)",warm:"hue-rotate(25deg) saturate(1.2)"};return{filter:i[t]||t,apply:e=>{e.style.filter=i[t]||t}}}getStatus(){var e;return{activeStreams:this.activeStreams.size,activeConnections:this.activeConnections.size,audioContextState:(null==(e=this.audioContext)?void 0:e.state)||"none",support:this.support,streams:Array.from(this.activeStreams.entries()).map(([e,t])=>({id:e,type:t.type,tracks:t.tracks.length,active:t.tracks.some(e=>"live"===e.readyState)}))}}}class P{constructor(e={}){t(this,"db",{set:async(e,t,n=null)=>new Promise((i,s)=>{if(!this.db)return void s(new Error("IndexedDB not available"));const r=this.db.transaction(["keyValue"],"readwrite").objectStore("keyValue"),o={key:e,value:t,timestamp:Date.now(),expiration:n?Date.now()+n:null},a=r.put(o);a.onsuccess=()=>{d.info(`[StorageManager] DB set: ${e}`),i(o)},a.onerror=()=>{d.error(`[StorageManager] DB set failed: ${e}`),s(a.error)}}),get:async e=>new Promise((t,n)=>{if(!this.db)return void n(new Error("IndexedDB not available"));const i=this.db.transaction(["keyValue"],"readonly").objectStore("keyValue").get(e);i.onsuccess=()=>{const n=i.result;if(n)return n.expiration&&Date.now()>n.expiration?(this.db.delete(e),void t(null)):void t(n.value);t(null)},i.onerror=()=>{d.error(`[StorageManager] DB get failed: ${e}`),n(i.error)}}),delete:async e=>new Promise((t,n)=>{if(!this.db)return void n(new Error("IndexedDB not available"));const i=this.db.transaction(["keyValue"],"readwrite").objectStore("keyValue").delete(e);i.onsuccess=()=>{d.info(`[StorageManager] DB deleted: ${e}`),t(!0)},i.onerror=()=>{n(i.error)}}),keys:async()=>new Promise((e,t)=>{if(!this.db)return void t(new Error("IndexedDB not available"));const n=this.db.transaction(["keyValue"],"readonly").objectStore("keyValue").getAllKeys();n.onsuccess=()=>{e(n.result)},n.onerror=()=>{t(n.error)}}),clear:async()=>new Promise((e,t)=>{if(!this.db)return void t(new Error("IndexedDB not available"));const n=this.db.transaction(["keyValue"],"readwrite").objectStore("keyValue").clear();n.onsuccess=()=>{d.info("[StorageManager] DB cleared"),e(!0)},n.onerror=()=>{t(n.error)}}),storeFile:async(e,t,n={})=>new Promise((i,s)=>{if(!this.db)return void s(new Error("IndexedDB not available"));const r=this.db.transaction(["files"],"readwrite").objectStore("files"),o={name:e,file:t,type:t.type,size:t.size,timestamp:Date.now(),metadata:n},a=r.add(o);a.onsuccess=()=>{d.info(`[StorageManager] File stored: ${e}`),i({id:a.result,...o})},a.onerror=()=>{s(a.error)}}),getFile:async e=>new Promise((t,n)=>{if(!this.db)return void n(new Error("IndexedDB not available"));const i=this.db.transaction(["files"],"readonly").objectStore("files").get(e);i.onsuccess=()=>{t(i.result)},i.onerror=()=>{n(i.error)}})}),t(this,"cache",{add:async(e,t=null)=>{if(!this.cache)throw new Error("Cache API not available");try{t?await this.cache.put(e,t):await this.cache.add(e),d.info(`[StorageManager] Cache add: ${e}`)}catch(n){throw d.error("[StorageManager] Cache add failed:",n),n}},get:async e=>{if(!this.cache)throw new Error("Cache API not available");try{const t=await this.cache.match(e);return t?d.info(`[StorageManager] Cache hit: ${e}`):d.info(`[StorageManager] Cache miss: ${e}`),t}catch(t){throw d.error("[StorageManager] Cache get failed:",t),t}},delete:async e=>{if(!this.cache)throw new Error("Cache API not available");try{const t=await this.cache.delete(e);return t&&d.info(`[StorageManager] Cache deleted: ${e}`),t}catch(t){throw d.error("[StorageManager] Cache delete failed:",t),t}},keys:async()=>{if(!this.cache)throw new Error("Cache API not available");try{return await this.cache.keys()}catch(e){throw d.error("[StorageManager] Cache keys failed:",e),e}},clear:async()=>{if(!this.cache)throw new Error("Cache API not available");try{const e=await this.cache.keys();await Promise.all(e.map(e=>this.cache.delete(e))),d.info("[StorageManager] Cache cleared")}catch(e){throw d.error("[StorageManager] Cache clear failed:",e),e}}}),t(this,"channel",{create:(e,t=null)=>{if(!this.support.broadcastChannel)return d.warn("[StorageManager] BroadcastChannel not supported"),null;if(this.channels.has(e))return this.channels.get(e);const n=new BroadcastChannel(e);t&&n.addEventListener("message",t);const i={name:e,channel:n,send:t=>{n.postMessage({data:t,timestamp:Date.now(),sender:"current-tab"}),d.info(`[StorageManager] Broadcast sent to ${e}`)},onMessage:e=>{n.addEventListener("message",t=>{e(t.data)})},close:()=>{n.close(),this.channels.delete(e),d.info(`[StorageManager] Channel closed: ${e}`)}};return this.channels.set(e,i),d.info(`[StorageManager] Channel created: ${e}`),i},get:e=>this.channels.get(e)||null,close:e=>{const t=this.channels.get(e);t&&t.close()},closeAll:()=>{this.channels.forEach(e=>e.close()),this.channels.clear(),d.info("[StorageManager] All channels closed")}}),t(this,"locks",{acquire:async(e,t,n={})=>{if(!this.support.webLocks)return d.warn("[StorageManager] Web Locks not supported, executing without lock"),await t();try{return await navigator.locks.request(e,n,async n=>{d.info(`[StorageManager] Lock acquired: ${e}`);const i=await t(n);return d.info(`[StorageManager] Lock released: ${e}`),i})}catch(i){throw d.error(`[StorageManager] Lock failed: ${e}`,i),i}},query:async()=>{if(!this.support.webLocks)return{held:[],pending:[]};try{return await navigator.locks.query()}catch(e){throw d.error("[StorageManager] Lock query failed:",e),e}}}),t(this,"local",{set:(e,t,n=null)=>{if(!this.support.localStorage)return!1;try{const i={value:t,timestamp:Date.now(),expiration:n?Date.now()+n:null};return localStorage.setItem(e,JSON.stringify(i)),!0}catch(i){return d.error("[StorageManager] localStorage set failed:",i),!1}},get:e=>{if(!this.support.localStorage)return null;try{const t=localStorage.getItem(e);if(!t)return null;const n=JSON.parse(t);return n.expiration&&Date.now()>n.expiration?(localStorage.removeItem(e),null):n.value}catch(t){return d.error("[StorageManager] localStorage get failed:",t),null}},delete:e=>!!this.support.localStorage&&(localStorage.removeItem(e),!0),clear:()=>!!this.support.localStorage&&(localStorage.clear(),!0),keys:()=>this.support.localStorage?Object.keys(localStorage):[]}),t(this,"session",{set:(e,t)=>{if(!this.support.sessionStorage)return!1;try{return sessionStorage.setItem(e,JSON.stringify(t)),!0}catch(n){return d.error("[StorageManager] sessionStorage set failed:",n),!1}},get:e=>{if(!this.support.sessionStorage)return null;try{const t=sessionStorage.getItem(e);return t?JSON.parse(t):null}catch(t){return d.error("[StorageManager] sessionStorage get failed:",t),null}},delete:e=>!!this.support.sessionStorage&&(sessionStorage.removeItem(e),!0),clear:()=>!!this.support.sessionStorage&&(sessionStorage.clear(),!0)}),t(this,"smartCache",{set:async(e,t,n={})=>{const{storage:i="indexedDB",expiration:s=null,fallback:r=!0}=n;try{if("indexedDB"===i&&this.db)return await this.db.set(e,t,s);if(r)return this.local.set(e,t,s)}catch(o){if(r)return this.local.set(e,t,s);throw o}},get:async(e,t={})=>{const{storage:n="indexedDB",fallback:i=!0}=t;try{if("indexedDB"===n&&this.db)return await this.db.get(e);if(i)return this.local.get(e)}catch(s){if(i)return this.local.get(e);throw s}},delete:async(e,t={})=>{const{storage:n="indexedDB",fallback:i=!0}=t;try{"indexedDB"===n&&this.db&&await this.db.delete(e),i&&this.local.delete(e)}catch(s){throw i&&this.local.delete(e),s}}}),t(this,"storage",{set:async(e,t,n={})=>{const{type:i="auto",expiration:s=null,...r}=n;try{let n=i;if("auto"===i){n=JSON.stringify(t).length>5242880?"indexedDB":"localStorage"}switch(n){case"localStorage":return this.local.set(e,t,s);case"sessionStorage":return this.session.set(e,t);case"indexedDB":return await this.db.set(e,t,s);default:throw new Error(`Unknown storage type: ${n}`)}}catch(o){if("indexedDB"===i||"auto"===i)return d.warn("[StorageManager] Falling back to localStorage",o),this.local.set(e,t,s);throw o}finally{this.config.enableAnalytics&&this.analytics.operations.set++}},get:async(e,t={})=>{const{type:n="auto",...i}=t;try{if("auto"===n){const t=this.local.get(e);if(null!==t)return this.config.enableAnalytics&&this.analytics.operations.get++,t;const n=this.session.get(e);if(null!==n)return this.config.enableAnalytics&&this.analytics.operations.get++,n;if(this.db){const t=await this.db.get(e);if(null!==t)return this.config.enableAnalytics&&this.analytics.operations.get++,t}return null}switch(n){case"localStorage":const t=this.local.get(e);return this.config.enableAnalytics&&this.analytics.operations.get++,t;case"sessionStorage":const i=this.session.get(e);return this.config.enableAnalytics&&this.analytics.operations.get++,i;case"indexedDB":const s=await this.db.get(e);return this.config.enableAnalytics&&this.analytics.operations.get++,s;default:throw new Error(`Unknown storage type: ${n}`)}}catch(s){throw d.error("[StorageManager] Storage get failed",s),this.config.enableAnalytics&&this.analytics.errors++,s}},delete:async(e,t={})=>{const{type:n="all",...i}=t;try{if("all"===n)this.local.delete(e),this.session.delete(e),this.db&&await this.db.delete(e);else switch(n){case"localStorage":this.local.delete(e);break;case"sessionStorage":this.session.delete(e);break;case"indexedDB":this.db&&await this.db.delete(e)}this.config.enableAnalytics&&this.analytics.operations.delete++}catch(s){throw d.error("[StorageManager] Storage delete failed",s),this.config.enableAnalytics&&this.analytics.errors++,s}},clear:async(e={})=>{const{type:t="all",...n}=e;try{if("all"===t)this.local.clear(),this.session.clear(),this.db&&await this.db.clear(),this.cache&&await this.cache.clear();else switch(t){case"localStorage":this.local.clear();break;case"sessionStorage":this.session.clear();break;case"indexedDB":this.db&&await this.db.clear();break;case"cache":this.cache&&await this.cache.clear()}this.config.enableAnalytics&&this.analytics.operations.clear++}catch(i){throw d.error("[StorageManager] Storage clear failed",i),this.config.enableAnalytics&&this.analytics.errors++,i}}}),this.config={dbName:e.dbName||"AppDatabase",dbVersion:e.dbVersion||1,enableAnalytics:e.enableAnalytics??!0,enableQuotaMonitoring:e.enableQuotaMonitoring??!0,quotaWarningThreshold:e.quotaWarningThreshold||.8,...e},this.db=null,this.cache=null,this.channels=new Map,this.analytics={operations:{get:0,set:0,delete:0,clear:0},errors:0,quotaWarnings:0},this.support={indexedDB:"indexedDB"in window,cacheAPI:"caches"in window,webLocks:"locks"in navigator,broadcastChannel:"BroadcastChannel"in window,localStorage:"localStorage"in window,sessionStorage:"sessionStorage"in window,storageEstimate:"storage"in navigator&&"estimate"in navigator.storage},d.info("[StorageManager] Initialized with support:",this.support),this.initializeDB(),this.initializeCache(),this.config.enableQuotaMonitoring&&this.startQuotaMonitoring()}async initializeDB(){if(this.support.indexedDB)try{const e=indexedDB.open(this.dbName,this.dbVersion);e.onerror=()=>{d.error("[StorageManager] IndexedDB failed to open")},e.onupgradeneeded=e=>{const t=e.target.result;if(!t.objectStoreNames.contains("keyValue")){t.createObjectStore("keyValue",{keyPath:"key"}).createIndex("timestamp","timestamp",{unique:!1})}if(t.objectStoreNames.contains("cache")||t.createObjectStore("cache",{keyPath:"key"}),!t.objectStoreNames.contains("files")){const e=t.createObjectStore("files",{keyPath:"id",autoIncrement:!0});e.createIndex("name","name",{unique:!1}),e.createIndex("type","type",{unique:!1})}d.info("[StorageManager] IndexedDB schema updated")},e.onsuccess=e=>{this.db=e.target.result,d.info("[StorageManager] IndexedDB connected")}}catch(e){d.error("[StorageManager] IndexedDB initialization failed:",e)}else d.warn("[StorageManager] IndexedDB not supported")}async initializeCache(){if(this.support.cacheAPI)try{this.cache=await caches.open(this.config.cacheName||"app-cache-v1"),d.info("[StorageManager] Cache API initialized")}catch(e){d.error("[StorageManager] Cache API initialization failed:",e)}else d.warn("[StorageManager] Cache API not supported")}async getStorageUsage(){const e={quota:0,usage:0,available:0,percentage:0};if("storage"in navigator&&"estimate"in navigator.storage)try{const t=await navigator.storage.estimate();e.quota=t.quota||0,e.usage=t.usage||0,e.available=e.quota-e.usage,e.percentage=e.quota>0?Math.round(e.usage/e.quota*100):0}catch(t){d.error("[StorageManager] Storage estimate failed:",t)}return e}async cleanup(){d.info("[StorageManager] Starting cleanup...");try{if(this.db){const e=this.db.transaction(["keyValue"],"readwrite").objectStore("keyValue"),t=e.index("timestamp").openCursor();let n=0;t.onsuccess=e=>{const t=e.target.result;if(t){const e=t.value;e.expiration&&Date.now()>e.expiration&&(t.delete(),n++),t.continue()}else d.info(`[StorageManager] Cleanup completed: ${n} expired entries removed`)}}if(this.support.localStorage){const e=Object.keys(localStorage);let t=0;e.forEach(e=>{try{const n=localStorage.getItem(e),i=JSON.parse(n);i.expiration&&Date.now()>i.expiration&&(localStorage.removeItem(e),t++)}catch(n){}}),t>0&&d.info(`[StorageManager] LocalStorage cleanup: ${t} expired entries removed`)}}catch(e){d.error("[StorageManager] Cleanup failed:",e)}}async getStatus(){const e=await this.getStorageUsage();return{support:this.support,usage:e,activeChannels:this.channels.size,dbConnected:!!this.db,cacheConnected:!!this.cache,channelNames:Array.from(this.channels.keys()),analytics:this.config.enableAnalytics?this.getAnalytics():null}}startQuotaMonitoring(){setInterval(async()=>{try{const e=await this.getStorageUsage();if(e.percentage>=100*this.config.quotaWarningThreshold){this.analytics.quotaWarnings++,d.warn("[StorageManager] Storage quota warning",{usage:e.percentage+"%",available:this.formatBytes(e.available)});const t=new CustomEvent("storage:quota-warning",{detail:e,bubbles:!0});window.dispatchEvent(t)}}catch(e){d.error("[StorageManager] Quota monitoring error",e)}},6e4)}async migrate(e,t,n=null){d.info("[StorageManager] Starting migration",{fromType:e,toType:t});let i=n;if(!i)switch(e){case"localStorage":i=this.local.keys();break;case"sessionStorage":i=Object.keys(sessionStorage);break;case"indexedDB":this.db&&(i=await this.db.keys())}if(!i||0===i.length)return void d.info("[StorageManager] No keys to migrate");let s=0,r=0;for(const a of i)try{let n=null;switch(e){case"localStorage":n=this.local.get(a);break;case"sessionStorage":n=this.session.get(a);break;case"indexedDB":this.db&&(n=await this.db.get(a))}if(null===n)continue;switch(t){case"localStorage":this.local.set(a,n);break;case"sessionStorage":this.session.set(a,n);break;case"indexedDB":this.db&&await this.db.set(a,n)}s++}catch(o){d.error(`[StorageManager] Failed to migrate key: ${a}`,o),r++}return d.info("[StorageManager] Migration completed",{migrated:s,failed:r}),{migrated:s,failed:r}}getAnalytics(){return{...this.analytics,totalOperations:Object.values(this.analytics.operations).reduce((e,t)=>e+t,0),errorRate:this.analytics.errors/(this.analytics.operations.get+this.analytics.operations.set||1)}}resetAnalytics(){this.analytics={operations:{get:0,set:0,delete:0,clear:0},errors:0,quotaWarnings:0}}formatBytes(e){if(0===e)return"0 Bytes";const t=Math.floor(Math.log(e)/Math.log(1024));return Math.round(e/Math.pow(1024,t)*100)/100+" "+["Bytes","KB","MB","GB","TB"][t]}}class L{constructor(e={}){t(this,"geolocation",{getCurrent:(e={})=>new Promise((t,n)=>{if(!this.support.geolocation)return void n(new Error("Geolocation not supported"));const i={enableHighAccuracy:!0,timeout:1e4,maximumAge:6e4,...e};navigator.geolocation.getCurrentPosition(e=>{const n=this.enhanceLocationData(e);d.info("[DeviceManager] Location acquired:",{lat:n.latitude,lng:n.longitude,accuracy:n.accuracy}),t(n)},e=>{d.error("[DeviceManager] Geolocation failed:",e.message),n(e)},i)}),watch:(e,t={})=>{if(!this.support.geolocation)throw new Error("Geolocation not supported");const n={enableHighAccuracy:!0,timeout:3e4,maximumAge:1e4,...t},i=navigator.geolocation.watchPosition(t=>{const n=this.enhanceLocationData(t);e(n)},t=>{d.error("[DeviceManager] Location watch failed:",t.message),e({error:t})},n);return this.activeWatchers.set(`geo_${i}`,{type:"geolocation",id:i,stop:()=>{navigator.geolocation.clearWatch(i),this.activeWatchers.delete(`geo_${i}`)}}),d.info("[DeviceManager] Location watch started:",i),{id:i,stop:()=>{navigator.geolocation.clearWatch(i),this.activeWatchers.delete(`geo_${i}`),d.info("[DeviceManager] Location watch stopped:",i)}}},distance:(e,t)=>{const n=this.toRadians(t.latitude-e.latitude),i=this.toRadians(t.longitude-e.longitude),s=Math.sin(n/2)*Math.sin(n/2)+Math.cos(this.toRadians(e.latitude))*Math.cos(this.toRadians(t.latitude))*Math.sin(i/2)*Math.sin(i/2),r=6371*(2*Math.atan2(Math.sqrt(s),Math.sqrt(1-s)));return{kilometers:r,miles:.621371*r,meters:1e3*r}}}),t(this,"motion",{start:(e,t={})=>{if(!this.support.deviceMotion)throw new Error("Device Motion not supported");const n=t=>{const n={acceleration:t.acceleration,accelerationIncludingGravity:t.accelerationIncludingGravity,rotationRate:t.rotationRate,interval:t.interval,timestamp:t.timeStamp,totalAcceleration:this.calculateTotalAcceleration(t.acceleration),shake:this.detectShake(t.accelerationIncludingGravity),orientation:this.getDeviceOrientation(t)};e(n)};"function"==typeof DeviceMotionEvent.requestPermission?DeviceMotionEvent.requestPermission().then(e=>{"granted"===e&&window.addEventListener("devicemotion",n)}):window.addEventListener("devicemotion",n);const i=this.generateId("motion");return this.activeWatchers.set(i,{type:"motion",handler:n,stop:()=>{window.removeEventListener("devicemotion",n),this.activeWatchers.delete(i)}}),d.info("[DeviceManager] Motion detection started"),{id:i,stop:()=>{window.removeEventListener("devicemotion",n),this.activeWatchers.delete(i),d.info("[DeviceManager] Motion detection stopped")}}},startOrientation:(e,t={})=>{if(!this.support.deviceOrientation)throw new Error("Device Orientation not supported");const n=t=>{const n={alpha:t.alpha,beta:t.beta,gamma:t.gamma,absolute:t.absolute,timestamp:t.timeStamp,compass:this.calculateCompass(t.alpha),tilt:this.calculateTilt(t.beta,t.gamma),rotation:this.getRotationState(t)};e(n)};"function"==typeof DeviceOrientationEvent.requestPermission?DeviceOrientationEvent.requestPermission().then(e=>{"granted"===e&&window.addEventListener("deviceorientation",n)}):window.addEventListener("deviceorientation",n);const i=this.generateId("orientation");return this.activeWatchers.set(i,{type:"orientation",handler:n,stop:()=>{window.removeEventListener("deviceorientation",n),this.activeWatchers.delete(i)}}),d.info("[DeviceManager] Orientation detection started"),{id:i,stop:()=>{window.removeEventListener("deviceorientation",n),this.activeWatchers.delete(i),d.info("[DeviceManager] Orientation detection stopped")}}}}),t(this,"vibration",{vibrate:e=>{if(!this.support.vibration)return d.warn("[DeviceManager] Vibration not supported"),!1;try{return navigator.vibrate(e),d.info("[DeviceManager] Vibration triggered:",e),!0}catch(t){return d.error("[DeviceManager] Vibration failed:",t),!1}},patterns:{short:200,long:600,double:[200,100,200],triple:[200,100,200,100,200],sos:[100,30,100,30,100,200,200,30,200,30,200,200,100,30,100,30,100],heartbeat:[100,30,100,130,40,30,40,30,100],notification:[200,100,200],success:[100],error:[300,100,300],warning:[200,100,200,100,200]},stop:()=>{this.support.vibration&&(navigator.vibrate(0),d.info("[DeviceManager] Vibration stopped"))},success:()=>this.vibration.vibrate(this.vibration.patterns.success),error:()=>this.vibration.vibrate(this.vibration.patterns.error),warning:()=>this.vibration.vibrate(this.vibration.patterns.warning),notification:()=>this.vibration.vibrate(this.vibration.patterns.notification)}),t(this,"battery",{get:async()=>{if(!this.support.battery)return d.warn("[DeviceManager] Battery API not supported"),null;try{const e=await navigator.getBattery(),t={level:Math.round(100*e.level),charging:e.charging,chargingTime:e.chargingTime,dischargingTime:e.dischargingTime,status:this.getBatteryStatus(e),timeRemaining:this.formatBatteryTime(e)};return d.info("[DeviceManager] Battery status:",t),t}catch(e){return d.error("[DeviceManager] Battery status failed:",e),null}},watch:async e=>{if(!this.support.battery)throw new Error("Battery API not supported");try{const t=await navigator.getBattery(),n=[];["chargingchange","levelchange","chargingtimechange","dischargingtimechange"].forEach(i=>{const s=()=>{const n={level:Math.round(100*t.level),charging:t.charging,chargingTime:t.chargingTime,dischargingTime:t.dischargingTime,status:this.getBatteryStatus(t),timeRemaining:this.formatBatteryTime(t),event:i};e(n)};t.addEventListener(i,s),n.push({event:i,handler:s})});const i=this.generateId("battery");return this.activeWatchers.set(i,{type:"battery",battery:t,handlers:n,stop:()=>{n.forEach(({event:e,handler:n})=>{t.removeEventListener(e,n)}),this.activeWatchers.delete(i)}}),d.info("[DeviceManager] Battery watch started"),{id:i,stop:()=>{n.forEach(({event:e,handler:n})=>{t.removeEventListener(e,n)}),this.activeWatchers.delete(i),d.info("[DeviceManager] Battery watch stopped")}}}catch(t){throw d.error("[DeviceManager] Battery watch failed:",t),t}}}),t(this,"network",{get:()=>{if(!this.support.networkInfo)return d.warn("[DeviceManager] Network Information not supported"),null;const e=navigator.connection||navigator.mozConnection||navigator.webkitConnection;return{effectiveType:e.effectiveType,downlink:e.downlink,rtt:e.rtt,saveData:e.saveData,speed:this.getConnectionSpeed(e),quality:this.getConnectionQuality(e),recommendation:this.getNetworkRecommendation(e)}},watch:e=>{if(!this.support.networkInfo)throw new Error("Network Information not supported");const t=navigator.connection||navigator.mozConnection||navigator.webkitConnection,n=()=>{const n={effectiveType:t.effectiveType,downlink:t.downlink,rtt:t.rtt,saveData:t.saveData,speed:this.getConnectionSpeed(t),quality:this.getConnectionQuality(t),recommendation:this.getNetworkRecommendation(t)};e(n)};t.addEventListener("change",n);const i=this.generateId("network");return this.activeWatchers.set(i,{type:"network",connection:t,handler:n,stop:()=>{t.removeEventListener("change",n),this.activeWatchers.delete(i)}}),d.info("[DeviceManager] Network watch started"),{id:i,stop:()=>{t.removeEventListener("change",n),this.activeWatchers.delete(i),d.info("[DeviceManager] Network watch stopped")}}}}),t(this,"wakeLock",{request:async(e="screen")=>{if(!this.support.wakeLock)return d.warn("[DeviceManager] Wake Lock not supported"),null;try{const t=await navigator.wakeLock.request(e);return d.info(`[DeviceManager] Wake lock acquired: ${e}`),{type:t.type,release:()=>{t.release(),d.info(`[DeviceManager] Wake lock released: ${e}`)}}}catch(t){throw d.error("[DeviceManager] Wake lock failed:",t),t}}}),this.config=e,this.activeWatchers=new Map,this.sensorData=new Map,this.support={geolocation:"geolocation"in navigator,deviceMotion:"DeviceMotionEvent"in window,deviceOrientation:"DeviceOrientationEvent"in window,vibration:"vibrate"in navigator,battery:"getBattery"in navigator,networkInfo:"connection"in navigator||"mozConnection"in navigator||"webkitConnection"in navigator,wakeLock:"wakeLock"in navigator,bluetooth:"bluetooth"in navigator,usb:"usb"in navigator,serial:"serial"in navigator},d.info("[DeviceManager] Initialized with support:",this.support),this.initializeSensors()}initializeSensors(){(this.support.deviceMotion||this.support.deviceOrientation)&&(this.sensorData.set("motionBaseline",{x:0,y:0,z:0}),this.sensorData.set("shakeThreshold",this.config.shakeThreshold||15))}enhanceLocationData(e){return{latitude:e.coords.latitude,longitude:e.coords.longitude,accuracy:e.coords.accuracy,altitude:e.coords.altitude,altitudeAccuracy:e.coords.altitudeAccuracy,heading:e.coords.heading,speed:e.coords.speed,timestamp:e.timestamp,coordinates:`${e.coords.latitude},${e.coords.longitude}`,accuracyLevel:this.getAccuracyLevel(e.coords.accuracy),mapUrl:`https://maps.google.com/?q=${e.coords.latitude},${e.coords.longitude}`}}getAccuracyLevel(e){return e<=5?"excellent":e<=10?"good":e<=50?"fair":"poor"}calculateTotalAcceleration(e){if(!e)return 0;const t=e.x||0,n=e.y||0,i=e.z||0;return Math.sqrt(t*t+n*n+i*i)}detectShake(e){if(!e)return!1;const t=this.sensorData.get("shakeThreshold"),n=Math.abs(e.x||0),i=Math.abs(e.y||0),s=Math.abs(e.z||0);return n>t||i>t||s>t}getDeviceOrientation(e){const t=e.accelerationIncludingGravity;if(!t)return"unknown";const n=t.x||0,i=t.y||0,s=t.z||0;return Math.abs(n)>Math.abs(i)&&Math.abs(n)>Math.abs(s)?n>0?"landscape-right":"landscape-left":Math.abs(i)>Math.abs(s)?i>0?"portrait-upside-down":"portrait":s>0?"face-down":"face-up"}calculateCompass(e){if(null===e)return null;const t=Math.round(e/45)%8;return{degrees:Math.round(e),direction:["N","NE","E","SE","S","SW","W","NW"][t],cardinal:this.getCardinalDirection(e)}}getCardinalDirection(e){return e>=337.5||e<22.5?"North":e>=22.5&&e<67.5?"Northeast":e>=67.5&&e<112.5?"East":e>=112.5&&e<157.5?"Southeast":e>=157.5&&e<202.5?"South":e>=202.5&&e<247.5?"Southwest":e>=247.5&&e<292.5?"West":e>=292.5&&e<337.5?"Northwest":"Unknown"}calculateTilt(e,t){return{x:Math.round(e||0),y:Math.round(t||0),magnitude:Math.round(Math.sqrt((e||0)**2+(t||0)**2))}}getRotationState(e){const{alpha:t,beta:n,gamma:i}=e,s=Math.abs(n)>10||Math.abs(i)>10;return{isRotating:s,intensity:s?Math.max(Math.abs(n),Math.abs(i)):0}}getBatteryStatus(e){const t=100*e.level;return e.charging?"charging":t<=10?"critical":t<=20?"low":t<=50?"medium":"high"}formatBatteryTime(e){const t=e.charging?e.chargingTime:e.dischargingTime;if(t===1/0||isNaN(t))return"Unknown";return`${Math.floor(t/3600)}h ${Math.floor(t%3600/60)}m`}getConnectionSpeed(e){const t=e.downlink;return t>=10?"fast":t>=1.5?"good":t>=.5?"slow":"very-slow"}getConnectionQuality(e){switch(e.effectiveType){case"4g":return"excellent";case"3g":return"good";case"2g":return"poor";case"slow-2g":return"very-poor";default:return"unknown"}}getNetworkRecommendation(e){switch(this.getConnectionQuality(e)){case"excellent":return"Full quality content recommended";case"good":return"Moderate quality content recommended";case"poor":return"Light content only, avoid large files";case"very-poor":return"Text-only content recommended";default:return"Monitor connection quality"}}toRadians(e){return e*(Math.PI/180)}generateId(e="device"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}stopAllWatchers(){this.activeWatchers.forEach(e=>{e.stop()}),this.activeWatchers.clear(),d.info("[DeviceManager] All watchers stopped")}getCapabilities(){return{support:this.support,activeWatchers:this.activeWatchers.size,watcherTypes:Array.from(this.activeWatchers.values()).map(e=>e.type)}}}class ${constructor(e={}){t(this,"effects",{fadeIn:(e=300)=>[{opacity:0},{opacity:1}],slideInLeft:(e="100px",t=300)=>[{transform:`translateX(-${e})`,opacity:0},{transform:"translateX(0)",opacity:1}],slideInRight:(e="100px",t=300)=>[{transform:`translateX(${e})`,opacity:0},{transform:"translateX(0)",opacity:1}],slideInUp:(e="100px",t=300)=>[{transform:`translateY(${e})`,opacity:0},{transform:"translateY(0)",opacity:1}],slideInDown:(e="100px",t=300)=>[{transform:`translateY(-${e})`,opacity:0},{transform:"translateY(0)",opacity:1}],scaleIn:(e=.8,t=300)=>[{transform:`scale(${e})`,opacity:0},{transform:"scale(1)",opacity:1}],rotateIn:(e="-180deg",t=600)=>[{transform:`rotate(${e})`,opacity:0},{transform:"rotate(0deg)",opacity:1}],fadeOut:(e=300)=>[{opacity:1},{opacity:0}],slideOutLeft:(e="100px",t=300)=>[{transform:"translateX(0)",opacity:1},{transform:`translateX(-${e})`,opacity:0}],slideOutRight:(e="100px",t=300)=>[{transform:"translateX(0)",opacity:1},{transform:`translateX(${e})`,opacity:0}],scaleOut:(e=.8,t=300)=>[{transform:"scale(1)",opacity:1},{transform:`scale(${e})`,opacity:0}],bounce:(e="20px",t=600)=>[{transform:"translateY(0)"},{transform:`translateY(-${e})`,offset:.25},{transform:"translateY(0)",offset:.5},{transform:`translateY(-${e})`,offset:.75},{transform:"translateY(0)"}],pulse:(e=1.1,t=600)=>[{transform:"scale(1)"},{transform:`scale(${e})`,offset:.5},{transform:"scale(1)"}],shake:(e="10px",t=600)=>[{transform:"translateX(0)"},{transform:`translateX(-${e})`,offset:.1},{transform:`translateX(${e})`,offset:.2},{transform:`translateX(-${e})`,offset:.3},{transform:`translateX(${e})`,offset:.4},{transform:`translateX(-${e})`,offset:.5},{transform:`translateX(${e})`,offset:.6},{transform:`translateX(-${e})`,offset:.7},{transform:`translateX(${e})`,offset:.8},{transform:`translateX(-${e})`,offset:.9},{transform:"translateX(0)"}],rubberBand:(e=1e3)=>[{transform:"scale(1)"},{transform:"scale(1.25, 0.75)",offset:.3},{transform:"scale(0.75, 1.25)",offset:.4},{transform:"scale(1.15, 0.85)",offset:.5},{transform:"scale(0.95, 1.05)",offset:.65},{transform:"scale(1.05, 0.95)",offset:.75},{transform:"scale(1)"}],spin:(e=1e3)=>[{transform:"rotate(0deg)"},{transform:"rotate(360deg)"}],heartbeat:(e=1.3,t=1e3)=>[{transform:"scale(1)"},{transform:`scale(${e})`,offset:.14},{transform:"scale(1)",offset:.28},{transform:`scale(${e})`,offset:.42},{transform:"scale(1)",offset:.7}]}),t(this,"easings",{linear:"linear",ease:"ease",easeIn:"ease-in",easeOut:"ease-out",easeInOut:"ease-in-out",easeInQuad:"cubic-bezier(0.25, 0.46, 0.45, 0.94)",easeOutQuad:"cubic-bezier(0.25, 0.46, 0.45, 0.94)",easeInOutQuad:"cubic-bezier(0.455, 0.03, 0.515, 0.955)",easeInCubic:"cubic-bezier(0.32, 0, 0.67, 0)",easeOutCubic:"cubic-bezier(0.33, 1, 0.68, 1)",easeInOutCubic:"cubic-bezier(0.65, 0, 0.35, 1)",easeInQuart:"cubic-bezier(0.5, 0, 0.75, 0)",easeOutQuart:"cubic-bezier(0.25, 1, 0.5, 1)",easeInOutQuart:"cubic-bezier(0.76, 0, 0.24, 1)",easeOutBack:"cubic-bezier(0.34, 1.56, 0.64, 1)",easeInBack:"cubic-bezier(0.36, 0, 0.66, -0.56)",easeInOutBack:"cubic-bezier(0.68, -0.6, 0.32, 1.6)"}),this.config=e,this.activeAnimations=new Map,this.animationGroups=new Map,this.defaultEasing=e.easing||"ease-out",this.defaultDuration=e.duration||300,this.supported="animate"in Element.prototype,this.supported?d.info("[AnimationManager] Initialized with Web Animations API support"):d.warn("[AnimationManager] Web Animations API not supported, using fallbacks")}animate(e,t,n={}){if(!e||!t)return d.warn("[AnimationManager] Missing element or keyframes"),null;const i={duration:this.defaultDuration,easing:this.defaultEasing,fill:"forwards",...n},s=this.generateId();if(this.supported){const n=e.animate(t,i),r=this.enhanceAnimation(n,s,{element:e,keyframes:t,options:i});return this.activeAnimations.set(s,r),n.addEventListener("finish",()=>{this.activeAnimations.delete(s)}),d.info(`[AnimationManager] Animation started: ${s}`),r}return this.fallbackAnimate(e,t,i,s)}keyframes(e){if(Array.isArray(e))return e;if("object"==typeof e){const t=[];return Object.keys(e).sort((e,t)=>parseFloat(e.replace("%",""))-parseFloat(t.replace("%",""))).forEach(n=>{const i=parseFloat(n.replace("%",""))/100;t.push({...e[n],offset:i})}),t}return e}fadeIn(e,t={}){return this.animate(e,this.effects.fadeIn(),{duration:300,easing:this.easings.easeOut,...t})}fadeOut(e,t={}){return this.animate(e,this.effects.fadeOut(),{duration:300,easing:this.easings.easeIn,...t})}slideIn(e,t="up",n={}){return this.animate(e,this.effects[{up:"slideInUp",down:"slideInDown",left:"slideInLeft",right:"slideInRight"}[t]](),{duration:400,easing:this.easings.easeOutBack,...n})}bounce(e,t={}){return this.animate(e,this.effects.bounce(),{duration:600,easing:this.easings.easeInOut,...t})}pulse(e,t={}){return this.animate(e,this.effects.pulse(),{duration:600,easing:this.easings.easeInOut,iterations:1/0,...t})}group(e,t={}){const n=this.generateId("group"),i=[];e.forEach(({element:e,keyframes:n,animationOptions:s={}})=>{const r=this.animate(e,n,{...s,...t});r&&r.finished&&i.push(r.finished)});const s={id:n,finished:Promise.all(i),play:()=>{e.forEach(e=>{e.animation&&e.animation.play()})},pause:()=>{e.forEach(e=>{e.animation&&e.animation.pause()})},reverse:()=>{e.forEach(e=>{e.animation&&e.animation.reverse()})},cancel:()=>{e.forEach(e=>{e.animation&&e.animation.cancel()})}};return this.animationGroups.set(n,s),s}stagger(e,t,n={}){const i=n.staggerDelay||100,s=[];return e.forEach((e,r)=>{const o=r*i,a=this.animate(e,t,{...n,delay:o});s.push({element:e,animation:a})}),this.group(s.map(({element:e,animation:n})=>({element:e,keyframes:t,animation:n})))}timeline(e){const t=this.generateId("timeline");let n=0;const i=[];return e.forEach(e=>{var t;const s=void 0!==e.at?e.at:n,r=this.animate(e.element,e.keyframes,{...e.options,delay:s});i.push(r),void 0===e.at&&(n+=(null==(t=e.options)?void 0:t.duration)||this.defaultDuration)}),{id:t,animations:i,finished:Promise.all(i.map(e=>e.finished)),play:()=>i.forEach(e=>e.play()),pause:()=>i.forEach(e=>e.pause()),reverse:()=>i.forEach(e=>e.reverse()),cancel:()=>i.forEach(e=>e.cancel())}}onScroll(e,t,n={}){const i=n.trigger||e,s=n.start||0,r=n.end||1,o=new IntersectionObserver(i=>{i.forEach(i=>{if(i.isIntersecting){Math.min(Math.max((i.intersectionRatio-s)/(r-s),0),1)>=0&&this.animate(e,t,{...n,duration:n.duration||this.defaultDuration})}})},{threshold:this.createThresholdArray(20)});return o.observe(i),{observer:o,disconnect:()=>o.disconnect()}}enhanceAnimation(e,t,n){return{id:t,animation:e,metadata:n,play:()=>e.play(),pause:()=>e.pause(),reverse:()=>e.reverse(),cancel:()=>e.cancel(),finish:()=>e.finish(),get currentTime(){return e.currentTime},set currentTime(t){e.currentTime=t},get playbackRate(){return e.playbackRate},set playbackRate(t){e.playbackRate=t},get playState(){return e.playState},get finished(){return e.finished},seek(t){e.currentTime=e.effect.getTiming().duration*t},setProgress(e){this.seek(Math.max(0,Math.min(1,e)))},onFinish(t){e.addEventListener("finish",t)},onCancel(t){e.addEventListener("cancel",t)}}}fallbackAnimate(e,t,n,i){d.info("[AnimationManager] Using CSS fallback animation");const s=t[t.length-1];return e.style.transition=`all ${n.duration}ms ${n.easing}`,Object.assign(e.style,s),{id:i,finished:new Promise(e=>setTimeout(e,n.duration)),play:()=>{},pause:()=>{},cancel:()=>{e.style.transition=""}}}generateId(e="anim"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}createThresholdArray(e){const t=[];for(let n=0;n<=e;n++)t.push(n/e);return t}getActiveAnimations(){return Array.from(this.activeAnimations.entries()).map(([e,t])=>({id:e,playState:t.playState,currentTime:t.currentTime,metadata:t.metadata}))}cancelAll(){this.activeAnimations.forEach(e=>{e.cancel()}),this.activeAnimations.clear(),d.info("[AnimationManager] All animations cancelled")}pauseAll(){this.activeAnimations.forEach(e=>{e.pause()}),d.info("[AnimationManager] All animations paused")}resumeAll(){this.activeAnimations.forEach(e=>{"paused"===e.playState&&e.play()}),d.info("[AnimationManager] All animations resumed")}}class D{constructor(e={}){t(this,"web",{create:(e,t={})=>{if(!this.support.webWorkers)throw new Error("Web Workers not supported");let n;const i=this.generateId("worker");try{if("string"==typeof e)n=new Worker(e,t);else if("function"==typeof e){const i=this.createWorkerBlob(e);n=new Worker(URL.createObjectURL(i),t)}else{if(!(e instanceof Blob))throw new Error("Invalid script type");n=new Worker(URL.createObjectURL(e),t)}const s={id:i,worker:n,send:(e,t=null)=>{t?n.postMessage(e,t):n.postMessage(e),d.info(`[WorkerManager] Message sent to worker: ${i}`)},onMessage:e=>{n.addEventListener("message",t=>{e(t.data,t)})},onError:e=>{n.addEventListener("error",e),n.addEventListener("messageerror",e)},terminate:()=>{n.terminate(),this.activeWorkers.delete(i),d.info(`[WorkerManager] Worker terminated: ${i}`)},execute:(e,t=null)=>new Promise((i,s)=>{const r=this.generateId("msg"),o=e=>{e.data.id===r&&(n.removeEventListener("message",o),e.data.error?s(new Error(e.data.error)):i(e.data.result))};n.addEventListener("message",o),n.postMessage({id:r,type:"execute",function:e.toString(),data:t}),setTimeout(()=>{n.removeEventListener("message",o),s(new Error("Worker execution timeout"))},3e4)})};return this.activeWorkers.set(i,s),d.info(`[WorkerManager] Web Worker created: ${i}`),s}catch(s){throw d.error("[WorkerManager] Worker creation failed:",s),s}},createPool:(e,t=navigator.hardwareConcurrency||4,n={})=>{const i=[];for(let o=0;o<t;o++)i.push(this.web.create(e,n));let s=0;const r={workers:i,execute:async(e,t=null)=>{const n=i[s];return s=(s+1)%i.length,n.execute(e,t)},broadcast:e=>{i.forEach(t=>{t.send(e)})},terminate:()=>{i.forEach(e=>{e.terminate()}),i.length=0,d.info("[WorkerManager] Worker pool terminated")}};return d.info(`[WorkerManager] Worker pool created with ${t} workers`),r},tasks:{compute:(e,t)=>this.web.create("\n                    self.addEventListener('message', function(e) {\n                        const { id, function: fnString, data } = e.data;\n                        \n                        try {\n                            const fn = new Function('return ' + fnString)();\n                            const result = fn(data);\n                            self.postMessage({ id, result });\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                ").execute(e,t),processImage:(e,t)=>this.web.create("\n                    self.addEventListener('message', function(e) {\n                        const { id, data: { imageData, filters } } = e.data;\n                        \n                        try {\n                            const pixels = imageData.data;\n                            \n                            for (let i = 0; i < pixels.length; i += 4) {\n                                // Apply filters\n                                if (filters.brightness) {\n                                    pixels[i] *= filters.brightness;     // R\n                                    pixels[i + 1] *= filters.brightness; // G\n                                    pixels[i + 2] *= filters.brightness; // B\n                                }\n                                \n                                if (filters.contrast) {\n                                    const factor = (259 * (filters.contrast * 255 + 255)) / (255 * (259 - filters.contrast * 255));\n                                    pixels[i] = factor * (pixels[i] - 128) + 128;\n                                    pixels[i + 1] = factor * (pixels[i + 1] - 128) + 128;\n                                    pixels[i + 2] = factor * (pixels[i + 2] - 128) + 128;\n                                }\n                                \n                                if (filters.grayscale) {\n                                    const gray = 0.299 * pixels[i] + 0.587 * pixels[i + 1] + 0.114 * pixels[i + 2];\n                                    pixels[i] = gray;\n                                    pixels[i + 1] = gray;\n                                    pixels[i + 2] = gray;\n                                }\n                            }\n                            \n                            self.postMessage({ id, result: imageData }, [imageData.data.buffer]);\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                ").execute(null,{imageData:e,filters:t}),processData:(e,t)=>this.web.create("\n                    self.addEventListener('message', function(e) {\n                        const { id, data, function: processorString } = e.data;\n                        \n                        try {\n                            const processor = new Function('return ' + processorString)();\n                            const result = data.map(processor);\n                            self.postMessage({ id, result });\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                ").execute(t,e)}}),t(this,"service",{register:async(e,t={})=>{if(!this.support.serviceWorker)throw new Error("Service Worker not supported");try{const n=await navigator.serviceWorker.register(e,t);return d.info("[WorkerManager] Service Worker registered:",e),{registration:n,scope:n.scope,update:()=>n.update(),unregister:()=>n.unregister(),postMessage:e=>{n.active&&n.active.postMessage(e)},onUpdate:e=>{n.addEventListener("updatefound",()=>{const t=n.installing;t.addEventListener("statechange",()=>{"installed"===t.state&&navigator.serviceWorker.controller&&e(t)})})},checkForUpdates:()=>n.update()}}catch(n){throw d.error("[WorkerManager] Service Worker registration failed:",n),n}},getRegistration:async(e="/")=>{if(!this.support.serviceWorker)return null;try{return await navigator.serviceWorker.getRegistration(e)}catch(t){return d.error("[WorkerManager] Get registration failed:",t),null}},getRegistrations:async()=>{if(!this.support.serviceWorker)return[];try{return await navigator.serviceWorker.getRegistrations()}catch(e){return d.error("[WorkerManager] Get registrations failed:",e),[]}}}),t(this,"shared",{create:(e,t={})=>{if(!this.support.sharedWorker)throw new Error("Shared Worker not supported");try{const n=new SharedWorker(e,t),i=n.port,s=this.generateId("shared");i.start();const r={id:s,worker:n,port:i,send:(e,t=null)=>{t?i.postMessage(e,t):i.postMessage(e)},onMessage:e=>{i.addEventListener("message",t=>{e(t.data,t)})},onError:e=>{n.addEventListener("error",e),i.addEventListener("messageerror",e)},close:()=>{i.close(),this.activeWorkers.delete(s),d.info(`[WorkerManager] Shared Worker closed: ${s}`)}};return this.activeWorkers.set(s,r),d.info(`[WorkerManager] Shared Worker created: ${s}`),r}catch(n){throw d.error("[WorkerManager] Shared Worker creation failed:",n),n}}}),t(this,"offscreen",{create:(e,t=null)=>{if(!this.support.offscreenCanvas)throw new Error("Offscreen Canvas not supported");try{const n=e.transferControlToOffscreen(),i=t||"\n                    self.addEventListener('message', function(e) {\n                        const { canvas, type, data } = e.data;\n                        \n                        if (type === 'init') {\n                            self.canvas = canvas;\n                            self.ctx = canvas.getContext('2d');\n                        }\n                        \n                        if (type === 'draw' && self.ctx) {\n                            // Basic drawing operations\n                            const { operations } = data;\n                            \n                            operations.forEach(op => {\n                                switch (op.type) {\n                                    case 'fillRect':\n                                        self.ctx.fillRect(...op.args);\n                                        break;\n                                    case 'strokeRect':\n                                        self.ctx.strokeRect(...op.args);\n                                        break;\n                                    case 'fillText':\n                                        self.ctx.fillText(...op.args);\n                                        break;\n                                    case 'setFillStyle':\n                                        self.ctx.fillStyle = op.value;\n                                        break;\n                                    case 'setStrokeStyle':\n                                        self.ctx.strokeStyle = op.value;\n                                        break;\n                                }\n                            });\n                        }\n                    });\n                ",s=this.web.create(i);return s.send({type:"init",canvas:n},[n]),{worker:s,draw:e=>{s.send({type:"draw",data:{operations:e}})},send:e=>s.send(e),onMessage:e=>s.onMessage(e),terminate:()=>s.terminate()}}catch(n){throw d.error("[WorkerManager] Offscreen Canvas creation failed:",n),n}}}),t(this,"utils",{benchmark:async(e,t,n=1e3)=>{const i=this.web.create(()=>{self.addEventListener("message",e=>{const{id:t,function:n,data:i,iterations:s}=e.data;try{const e=new Function("return "+n)(),r=performance.now();for(let t=0;t<s;t++)e(i);const o=performance.now()-r,a=o/s;self.postMessage({id:t,result:{totalTime:o,avgTime:a,iterations:s,opsPerSecond:1e3/a}})}catch(r){self.postMessage({id:t,error:r.message})}})}),s=await i.execute(e,t,n);return i.terminate(),s},parallelMap:async(e,t,n=null)=>{const i=n||Math.ceil(e.length/(navigator.hardwareConcurrency||4)),s=this.web.createPool(()=>{self.addEventListener("message",e=>{const{id:t,data:{chunk:n,function:i}}=e.data;try{const e=new Function("return "+i)(),s=n.map(e);self.postMessage({id:t,result:s})}catch(s){self.postMessage({id:t,error:s.message})}})}),r=[];for(let a=0;a<e.length;a+=i){const n=e.slice(a,a+i);r.push(s.execute(t,n))}const o=await Promise.all(r);return s.terminate(),o.flat()}}),this.config=e,this.activeWorkers=new Map,this.messageHandlers=new Map,this.workerScripts=new Map,this.support={webWorkers:"Worker"in window,serviceWorker:"serviceWorker"in navigator,sharedWorker:"SharedWorker"in window,offscreenCanvas:"OffscreenCanvas"in window},d.info("[WorkerManager] Initialized with support:",this.support)}createWorkerBlob(e){const t=`\n            (function() {\n                const workerFunction = ${e.toString()};\n                \n                if (typeof workerFunction === 'function') {\n                    // If function expects to be called immediately\n                    if (workerFunction.length === 0) {\n                        workerFunction();\n                    }\n                }\n                \n                // Standard worker message handling\n                self.addEventListener('message', function(e) {\n                    if (e.data.type === 'execute' && e.data.function) {\n                        try {\n                            const fn = new Function('return ' + e.data.function)();\n                            const result = fn(e.data.data);\n                            self.postMessage({ \n                                id: e.data.id, \n                                result \n                            });\n                        } catch (error) {\n                            self.postMessage({ \n                                id: e.data.id, \n                                error: error.message \n                            });\n                        }\n                    }\n                });\n            })();\n        `;return new Blob([t],{type:"application/javascript"})}generateId(e="worker"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}terminateAll(){this.activeWorkers.forEach(e=>{e.terminate?e.terminate():e.close&&e.close()}),this.activeWorkers.clear(),d.info("[WorkerManager] All workers terminated")}getStats(){const e=Array.from(this.activeWorkers.values());return{total:e.length,byType:e.reduce((e,t)=>{const n=t.id.split("_")[0];return e[n]=(e[n]||0)+1,e},{}),support:this.support,hardwareConcurrency:navigator.hardwareConcurrency||"unknown"}}}class z{constructor(e={}){var n,i,s;t(this,"timing",{mark:(e,t={})=>{if(!this.support.userTiming)return d.warn("[PerformanceManager] User Timing not supported"),null;try{return performance.mark(e,t),this.marks.set(e,{name:e,timestamp:performance.now(),options:t}),d.info(`[PerformanceManager] Mark created: ${e}`),this.marks.get(e)}catch(n){return d.error("[PerformanceManager] Mark creation failed:",n),null}},measure:(e,t,n,i={})=>{if(!this.support.userTiming)return d.warn("[PerformanceManager] User Timing not supported"),null;try{performance.measure(e,t,n,i);const s=performance.getEntriesByName(e,"measure")[0],r={name:e,startTime:s.startTime,duration:s.duration,startMark:t,endMark:n,options:i};return this.measures.set(e,r),d.info(`[PerformanceManager] Measure created: ${e} (${r.duration.toFixed(2)}ms)`),r}catch(s){return d.error("[PerformanceManager] Measure creation failed:",s),null}},clear:(e=null)=>{if(this.support.userTiming)try{e?(performance.clearMarks(e),performance.clearMeasures(e),this.marks.delete(e),this.measures.delete(e)):(performance.clearMarks(),performance.clearMeasures(),this.marks.clear(),this.measures.clear()),d.info(`[PerformanceManager] Cleared: ${e||"all"}`)}catch(t){d.error("[PerformanceManager] Clear failed:",t)}},getMarks:()=>this.support.userTiming?Array.from(this.marks.values()):[],getMeasures:()=>this.support.userTiming?Array.from(this.measures.values()):[]}),t(this,"navigation",{get:()=>{if(!this.support.navigation)return this.getLegacyNavigationTiming();try{const e=performance.getEntriesByType("navigation")[0];return e?{redirect:e.redirectEnd-e.redirectStart,dns:e.domainLookupEnd-e.domainLookupStart,connect:e.connectEnd-e.connectStart,ssl:e.connectEnd-e.secureConnectionStart,ttfb:e.responseStart-e.requestStart,download:e.responseEnd-e.responseStart,domProcessing:e.domContentLoadedEventStart-e.responseEnd,domComplete:e.domComplete-e.domContentLoadedEventStart,loadComplete:e.loadEventEnd-e.loadEventStart,totalTime:e.loadEventEnd-e.startTime,navigationStart:e.startTime,unloadTime:e.unloadEventEnd-e.unloadEventStart,redirectCount:e.redirectCount,transferSize:e.transferSize,encodedBodySize:e.encodedBodySize,decodedBodySize:e.decodedBodySize,connectionInfo:{nextHopProtocol:e.nextHopProtocol,renderBlockingStatus:e.renderBlockingStatus}}:null}catch(e){return d.error("[PerformanceManager] Navigation timing failed:",e),null}},getInsights:()=>{const e=this.navigation.get();return e?{insights:{serverResponseTime:this.getInsight("ttfb",e.ttfb,200,500),domProcessing:this.getInsight("domProcessing",e.domProcessing,500,1e3),totalLoadTime:this.getInsight("totalTime",e.totalTime,2e3,4e3),transferEfficiency:this.getTransferEfficiency(e)},recommendations:this.getNavigationRecommendations(e)}:null}}),t(this,"resources",{get:(e=null)=>{if(!this.support.resourceTiming)return d.warn("[PerformanceManager] Resource Timing not supported"),[];try{const t=performance.getEntriesByType("resource").map(e=>({name:e.name,type:this.getResourceType(e),startTime:e.startTime,duration:e.duration,size:{transfer:e.transferSize,encoded:e.encodedBodySize,decoded:e.decodedBodySize},timing:{redirect:e.redirectEnd-e.redirectStart,dns:e.domainLookupEnd-e.domainLookupStart,connect:e.connectEnd-e.connectStart,ssl:e.connectEnd-e.secureConnectionStart,ttfb:e.responseStart-e.requestStart,download:e.responseEnd-e.responseStart},protocol:e.nextHopProtocol,cached:0===e.transferSize&&e.decodedBodySize>0}));return e?t.filter(t=>t.type===e):t}catch(t){return d.error("[PerformanceManager] Resource timing failed:",t),[]}},getSummary:()=>{const e=this.resources.get(),t={total:e.length,types:{},totalSize:0,totalDuration:0,cached:0,slowResources:[]};return e.forEach(e=>{const n=e.type;t.types[n]||(t.types[n]={count:0,size:0,duration:0}),t.types[n].count++,t.types[n].size+=e.size.transfer,t.types[n].duration+=e.duration,t.totalSize+=e.size.transfer,t.totalDuration+=e.duration,e.cached&&t.cached++,e.duration>1e3&&t.slowResources.push(e)}),t}}),t(this,"vitals",{start:(e=null)=>{const t={};return this.observePaint(n=>{n.forEach(n=>{"first-contentful-paint"===n.name&&(t.fcp=n.startTime,this.checkThreshold("fcp",n.startTime),e&&e("fcp",n.startTime))})}),this.observeLCP(n=>{n.forEach(n=>{t.lcp=n.startTime,this.checkThreshold("lcp",n.startTime),e&&e("lcp",n.startTime)})}),this.observeFID(n=>{n.forEach(n=>{t.fid=n.processingStart-n.startTime,this.checkThreshold("fid",t.fid),e&&e("fid",t.fid)})}),this.observeCLS(n=>{let i=0;n.forEach(e=>{e.hadRecentInput||(i+=e.value)}),t.cls=i,this.checkThreshold("cls",i),e&&e("cls",i)}),t},get:()=>({fcp:this.getMetric("fcp"),lcp:this.getMetric("lcp"),fid:this.getMetric("fid"),cls:this.getMetric("cls"),ratings:{fcp:this.getRating("fcp",this.getMetric("fcp")),lcp:this.getRating("lcp",this.getMetric("lcp")),fid:this.getRating("fid",this.getMetric("fid")),cls:this.getRating("cls",this.getMetric("cls"))}})}),t(this,"memory",{get:()=>{if(!this.support.memory)return d.warn("[PerformanceManager] Memory API not supported"),null;try{const e=performance.memory;return{used:e.usedJSHeapSize,total:e.totalJSHeapSize,limit:e.jsHeapSizeLimit,percentage:e.usedJSHeapSize/e.jsHeapSizeLimit*100,formatted:{used:this.formatBytes(e.usedJSHeapSize),total:this.formatBytes(e.totalJSHeapSize),limit:this.formatBytes(e.jsHeapSizeLimit)}}}catch(e){return d.error("[PerformanceManager] Memory get failed:",e),null}},monitor:(e,t=5e3)=>{if(!this.support.memory)return null;const n=setInterval(()=>{const t=this.memory.get();t&&(e(t),t.percentage>80&&d.warn("[PerformanceManager] High memory usage detected:",t.percentage.toFixed(1)+"%"))},t);return{stop:()=>clearInterval(n)}}}),t(this,"longTasks",{start:(e=null)=>{if(!this.support.longTask)return d.warn("[PerformanceManager] Long Task API not supported"),null;try{const t=new PerformanceObserver(t=>{t.getEntries().forEach(t=>{const n={duration:t.duration,startTime:t.startTime,name:t.name,attribution:t.attribution||[]};d.warn("[PerformanceManager] Long task detected:",n),e&&e(n)})});t.observe({entryTypes:["longtask"]});const n=this.generateId("longtask");return this.observers.set(n,t),{id:n,stop:()=>{t.disconnect(),this.observers.delete(n)}}}catch(t){return d.error("[PerformanceManager] Long task monitoring failed:",t),null}}}),t(this,"optimize",{deferScript:(e,t=null)=>{const n=document.createElement("script");return n.src=e,n.defer=!0,t&&(n.onload=t),document.head.appendChild(n),n},preload:(e,t,n=!1)=>{const i=document.createElement("link");return i.rel="preload",i.href=e,i.as=t,n&&(i.crossOrigin="anonymous"),document.head.appendChild(i),i},prefetch:e=>{const t=document.createElement("link");return t.rel="prefetch",t.href=e,document.head.appendChild(t),t},lazyImages:(e="img[data-src]")=>{if("IntersectionObserver"in window){const t=document.querySelectorAll(e),n=new IntersectionObserver(e=>{e.forEach(e=>{if(e.isIntersecting){const t=e.target;t.src=t.dataset.src,t.classList.remove("lazy"),n.unobserve(t)}})});return t.forEach(e=>n.observe(e)),n}document.querySelectorAll(e).forEach(e=>{e.src=e.dataset.src,e.classList.remove("lazy")})},analyzeBundles:()=>{const e=Array.from(document.querySelectorAll("script[src]")),t=Array.from(document.querySelectorAll('link[rel="stylesheet"]')),n={scripts:e.map(e=>({src:e.src,async:e.async,defer:e.defer})),styles:t.map(e=>({href:e.href,media:e.media})),recommendations:[]};return e.length>10&&n.recommendations.push("Consider bundling JavaScript files"),t.length>5&&n.recommendations.push("Consider bundling CSS files"),n}}),this.config=e,this.marks=new Map,this.measures=new Map,this.observers=new Map,this.metrics=new Map,this.thresholds={fcp:2e3,lcp:2500,fid:100,cls:.1,...e.thresholds},this.support={performance:"performance"in window,timing:"timing"in(window.performance||{}),navigation:"navigation"in(window.performance||{}),observer:"PerformanceObserver"in window,memory:"memory"in(window.performance||{}),userTiming:"mark"in(window.performance||{}),resourceTiming:"getEntriesByType"in(window.performance||{}),paintTiming:"PerformanceObserver"in window&&(null==(n=PerformanceObserver.supportedEntryTypes)?void 0:n.includes("paint")),layoutInstability:"PerformanceObserver"in window&&(null==(i=PerformanceObserver.supportedEntryTypes)?void 0:i.includes("layout-shift")),longTask:"PerformanceObserver"in window&&(null==(s=PerformanceObserver.supportedEntryTypes)?void 0:s.includes("longtask"))},d.info("[PerformanceManager] Initialized with support:",this.support),this.startCoreMetrics()}startCoreMetrics(){this.vitals.start((e,t)=>{this.setMetric(e,t)}),this.support.memory&&this.memory.monitor(e=>{this.setMetric("memory",e)})}observePaint(e){if(this.support.paintTiming)try{const t=new PerformanceObserver(t=>{e(t.getEntries())});return t.observe({entryTypes:["paint"]}),t}catch(t){d.error("[PerformanceManager] Paint observer failed:",t)}}observeLCP(e){if(this.support.observer)try{const t=new PerformanceObserver(t=>{e(t.getEntries())});return t.observe({entryTypes:["largest-contentful-paint"]}),t}catch(t){d.error("[PerformanceManager] LCP observer failed:",t)}}observeFID(e){if(this.support.observer)try{const t=new PerformanceObserver(t=>{e(t.getEntries())});return t.observe({entryTypes:["first-input"]}),t}catch(t){d.error("[PerformanceManager] FID observer failed:",t)}}observeCLS(e){if(this.support.layoutInstability)try{const t=new PerformanceObserver(t=>{e(t.getEntries())});return t.observe({entryTypes:["layout-shift"]}),t}catch(t){d.error("[PerformanceManager] CLS observer failed:",t)}}getLegacyNavigationTiming(){if(!this.support.timing)return null;const e=performance.timing,t=e.navigationStart;return{redirect:e.redirectEnd-e.redirectStart,dns:e.domainLookupEnd-e.domainLookupStart,connect:e.connectEnd-e.connectStart,ssl:e.connectEnd-e.secureConnectionStart,ttfb:e.responseStart-e.requestStart,download:e.responseEnd-e.responseStart,domProcessing:e.domContentLoadedEventStart-e.responseEnd,domComplete:e.domComplete-e.domContentLoadedEventStart,loadComplete:e.loadEventEnd-e.loadEventStart,totalTime:e.loadEventEnd-t}}getResourceType(e){return{js:"script",css:"stylesheet",png:"image",jpg:"image",jpeg:"image",gif:"image",svg:"image",webp:"image",woff:"font",woff2:"font",ttf:"font",eot:"font",json:"fetch",xml:"fetch"}[new URL(e.name).pathname.split(".").pop().toLowerCase()]||e.initiatorType||"other"}getInsight(e,t,n,i){return t<n?{rating:"good",message:`Excellent ${e}`}:t<i?{rating:"needs-improvement",message:`${e} needs improvement`}:{rating:"poor",message:`Poor ${e} performance`}}getTransferEfficiency(e){const t=e.decodedBodySize>0?e.encodedBodySize/e.decodedBodySize:1;return{ratio:t,rating:t<.7?"good":t<.9?"fair":"poor"}}getNavigationRecommendations(e){const t=[];return e.ttfb>500&&t.push("Server response time is slow. Consider optimizing backend performance."),e.dns>100&&t.push("DNS lookup time is high. Consider using a faster DNS provider."),e.connect>1e3&&t.push("Connection time is slow. Check network latency."),e.domProcessing>1e3&&t.push("DOM processing is slow. Consider optimizing JavaScript execution."),t}checkThreshold(e,t){const n=this.thresholds[e];n&&t>n&&d.warn(`[PerformanceManager] ${e.toUpperCase()} threshold exceeded: ${t}ms (threshold: ${n}ms)`)}getRating(e,t){const n={fcp:{good:1800,poor:3e3},lcp:{good:2500,poor:4e3},fid:{good:100,poor:300},cls:{good:.1,poor:.25}}[e];return n&&null!=t?t<=n.good?"good":t<=n.poor?"needs-improvement":"poor":"unknown"}setMetric(e,t){this.metrics.set(e,{value:t,timestamp:Date.now()})}getMetric(e){const t=this.metrics.get(e);return t?t.value:null}formatBytes(e){if(0===e)return"0 Bytes";const t=Math.floor(Math.log(e)/Math.log(1024));return parseFloat((e/Math.pow(1024,t)).toFixed(2))+" "+["Bytes","KB","MB","GB"][t]}generateId(e="perf"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}cleanup(){this.observers.forEach(e=>{e.disconnect()}),this.observers.clear(),this.metrics.clear(),this.marks.clear(),this.measures.clear(),d.info("[PerformanceManager] Cleanup completed")}getReport(){return{support:this.support,navigation:this.navigation.get(),resources:this.resources.getSummary(),vitals:this.vitals.get(),memory:this.memory.get(),marks:this.timing.getMarks(),measures:this.timing.getMeasures(),activeObservers:this.observers.size,timestamp:Date.now()}}}class R{constructor(e={}){var t;this.config=e,this.permissionCache=new Map,this.permissionWatchers=new Map,this.requestQueue=new Map,this.support={permissions:"permissions"in navigator,query:void 0!==(null==(t=navigator.permissions)?void 0:t.query),request:"requestPermission"in Notification||"getUserMedia"in(navigator.mediaDevices||{}),geolocation:"geolocation"in navigator,notifications:"Notification"in window,camera:void 0!==navigator.mediaDevices,microphone:void 0!==navigator.mediaDevices,clipboard:"clipboard"in navigator,vibration:"vibrate"in navigator},this.permissionMap={camera:{name:"camera",api:"mediaDevices"},microphone:{name:"microphone",api:"mediaDevices"},geolocation:{name:"geolocation",api:"geolocation"},notifications:{name:"notifications",api:"notification"},"clipboard-read":{name:"clipboard-read",api:"clipboard"},"clipboard-write":{name:"clipboard-write",api:"clipboard"},"background-sync":{name:"background-sync",api:"serviceWorker"},"persistent-storage":{name:"persistent-storage",api:"storage"},push:{name:"push",api:"serviceWorker"},midi:{name:"midi",api:"midi"},"payment-handler":{name:"payment-handler",api:"payment"}},d.info("[PermissionManager] Initialized with support:",this.support),this.cacheCurrentPermissions()}async check(e){if(!this.support.permissions||!this.support.query)return d.warn("[PermissionManager] Permissions API not supported, using fallback"),this.checkFallback(e);try{const t=this.permissionCache.get(e);if(t&&Date.now()-t.timestamp<3e4)return t.status;const n=this.getPermissionDescriptor(e),i=await navigator.permissions.query(n),s={name:e,state:i.state,timestamp:Date.now(),supported:!0};return this.permissionCache.set(e,s),i.addEventListener("change",()=>{this.onPermissionChange(e,i.state)}),d.info(`[PermissionManager] Permission checked: ${e} = ${i.state}`),s}catch(t){return d.warn(`[PermissionManager] Permission check failed for ${e}:`,t.message),this.checkFallback(e)}}async request(e,t={}){const{showRationale:n=!0,fallbackMessage:i=null,timeout:s=3e4}=t;try{const t=await this.check(e);if("granted"===t.state)return{granted:!0,state:"granted",fromCache:!0};if("denied"===t.state)return n&&await this.showPermissionRationale(e,i),{granted:!1,state:"denied",reason:"previously-denied"};const r=e;if(this.requestQueue.has(r))return d.info(`[PermissionManager] Permission request already in progress: ${e}`),this.requestQueue.get(r);const o=this.executePermissionRequest(e,s);this.requestQueue.set(r,o);const a=await o;return this.requestQueue.delete(r),this.permissionCache.set(e,{name:e,state:a.state,timestamp:Date.now(),supported:!0}),a}catch(r){return d.error(`[PermissionManager] Permission request failed: ${e}`,r),this.requestQueue.delete(e),{granted:!1,state:"error",error:r.message}}}async requestMultiple(e,t={}){const n={};if(t.sequential){for(const s of e)if(n[s]=await this.request(s,t),t.requireAll&&!n[s].granted)break}else{const i=e.map(e=>this.request(e,t).then(t=>[e,t]));(await Promise.allSettled(i)).forEach(e=>{if("fulfilled"===e.status){const[t,i]=e.value;n[t]=i}else d.error("[PermissionManager] Batch permission request failed:",e.reason)})}const i={results:n,granted:Object.values(n).filter(e=>e.granted).length,denied:Object.values(n).filter(e=>!e.granted).length,total:Object.keys(n).length};return d.info(`[PermissionManager] Batch permissions: ${i.granted}/${i.total} granted`),i}async checkRequired(e){const t={},n=[];for(const i of e){const e=await this.check(i);t[i]=e,"granted"!==e.state&&n.push(i)}return{allGranted:0===n.length,granted:Object.keys(t).filter(e=>"granted"===t[e].state),missing:n,statuses:t}}watch(e,t){const n=this.generateId("watcher");return this.permissionWatchers.set(n,{permission:e,callback:t,active:!0}),this.setupPermissionWatcher(e,t),d.info(`[PermissionManager] Permission watcher created: ${e}`),{id:n,stop:()=>{const t=this.permissionWatchers.get(n);t&&(t.active=!1,this.permissionWatchers.delete(n),d.info(`[PermissionManager] Permission watcher stopped: ${e}`))}}}getRecommendations(e=[]){const t={essential:[],recommended:[],optional:[]},n={camera:{permissions:["camera"],priority:"essential"},microphone:{permissions:["microphone"],priority:"essential"},location:{permissions:["geolocation"],priority:"recommended"},notifications:{permissions:["notifications"],priority:"recommended"},clipboard:{permissions:["clipboard-read","clipboard-write"],priority:"optional"},offline:{permissions:["persistent-storage"],priority:"recommended"},background:{permissions:["background-sync","push"],priority:"optional"}};return e.forEach(e=>{const i=n[e];i&&t[i.priority].push(...i.permissions)}),Object.keys(t).forEach(e=>{t[e]=[...new Set(t[e])]}),t}createOnboardingFlow(e,t={}){const{title:n="Permissions Required",descriptions:i={},onComplete:s=null,onSkip:r=null}=t;return{permissions:e,title:n,descriptions:i,async start(){d.info("[PermissionManager] Starting onboarding flow");const t=[];for(const s of e){const e=i[s]||this.getDefaultDescription(s),n=await this.showPermissionDialog(s,e);if("grant"===n){const e=await this.request(s);t.push({permission:s,...e})}else{if("skip"!==n)return r&&r(t),{cancelled:!0,results:t};t.push({permission:s,granted:!1,skipped:!0})}}const n={completed:!0,granted:t.filter(e=>e.granted).length,total:t.length,results:t};return s&&s(n),n},getDefaultDescription:e=>({camera:"Take photos and record videos for enhanced functionality",microphone:"Record audio for voice features and communication",geolocation:"Provide location-based services and content",notifications:"Send you important updates and reminders","clipboard-read":"Access clipboard content for convenience features","clipboard-write":"Copy content to clipboard for easy sharing"}[e]||`Allow access to ${e} functionality`),async showPermissionDialog(e,t){return new Promise(n=>{const i=document.createElement("div");i.className="permission-dialog-modal",i.innerHTML=`\n                        <div class="permission-dialog-backdrop" style="\n                            position: fixed;\n                            top: 0;\n                            left: 0;\n                            right: 0;\n                            bottom: 0;\n                            background: rgba(0,0,0,0.5);\n                            z-index: 10000;\n                            display: flex;\n                            align-items: center;\n                            justify-content: center;\n                        ">\n                            <div class="permission-dialog" style="\n                                background: white;\n                                border-radius: 8px;\n                                padding: 2rem;\n                                max-width: 400px;\n                                margin: 1rem;\n                                box-shadow: 0 4px 20px rgba(0,0,0,0.3);\n                            ">\n                                <h3 style="margin: 0 0 1rem 0; color: #333;">\n                                    ${this.getPermissionIcon(e)} ${this.getPermissionTitle(e)}\n                                </h3>\n                                <p style="margin: 0 0 2rem 0; color: #666; line-height: 1.5;">\n                                    ${t}\n                                </p>\n                                <div style="display: flex; gap: 1rem; justify-content: flex-end;">\n                                    <button class="btn-skip" style="\n                                        background: #f5f5f5;\n                                        border: 1px solid #ddd;\n                                        padding: 0.5rem 1rem;\n                                        border-radius: 4px;\n                                        cursor: pointer;\n                                    ">Skip</button>\n                                    <button class="btn-grant" style="\n                                        background: #007bff;\n                                        color: white;\n                                        border: none;\n                                        padding: 0.5rem 1rem;\n                                        border-radius: 4px;\n                                        cursor: pointer;\n                                    ">Allow</button>\n                                </div>\n                            </div>\n                        </div>\n                    `,document.body.appendChild(i);const s=i.querySelector(".btn-skip"),r=i.querySelector(".btn-grant"),o=()=>document.body.removeChild(i);s.onclick=()=>{o(),n("skip")},r.onclick=()=>{o(),n("grant")},i.querySelector(".permission-dialog-backdrop").onclick=e=>{e.target===e.currentTarget&&(o(),n("cancel"))}})},getPermissionIcon:e=>({camera:"📷",microphone:"🎤",geolocation:"📍",notifications:"🔔","clipboard-read":"📋","clipboard-write":"📋"}[e]||"🔐"),getPermissionTitle:e=>({camera:"Camera Access",microphone:"Microphone Access",geolocation:"Location Access",notifications:"Notifications","clipboard-read":"Clipboard Access","clipboard-write":"Clipboard Access"}[e]||`${e} Permission`)}}async cacheCurrentPermissions(){if(!this.support.permissions)return;const e=["camera","microphone","geolocation","notifications"];for(const n of e)try{await this.check(n)}catch(t){}}getPermissionDescriptor(e){switch(e){case"camera":return{name:"camera"};case"microphone":return{name:"microphone"};case"geolocation":return{name:"geolocation"};case"notifications":return{name:"notifications"};case"clipboard-read":return{name:"clipboard-read"};case"clipboard-write":return{name:"clipboard-write"};case"persistent-storage":return{name:"persistent-storage"};case"background-sync":return{name:"background-sync"};case"push":return{name:"push",userVisibleOnly:!0};default:return{name:e}}}async checkFallback(e){const t={camera:()=>void 0!==navigator.mediaDevices,microphone:()=>void 0!==navigator.mediaDevices,geolocation:()=>"geolocation"in navigator,notifications:()=>"Notification"in window,"clipboard-read":()=>"clipboard"in navigator,"clipboard-write":()=>"clipboard"in navigator}[e],n=!!t&&t();return{name:e,state:n?"prompt":"unsupported",timestamp:Date.now(),supported:n,fallback:!0}}async executePermissionRequest(e,t){return new Promise(async(n,i)=>{const s=setTimeout(()=>{i(new Error("Permission request timeout"))},t);try{let t;switch(e){case"notifications":if("Notification"in window){const e=await Notification.requestPermission();t={granted:"granted"===e,state:e}}else t={granted:!1,state:"unsupported"};break;case"camera":case"microphone":try{const n={};n["camera"===e?"video":"audio"]=!0;(await navigator.mediaDevices.getUserMedia(n)).getTracks().forEach(e=>e.stop()),t={granted:!0,state:"granted"}}catch(r){t={granted:!1,state:"NotAllowedError"===r.name?"denied":"error",error:r.message}}break;case"geolocation":try{await new Promise((e,t)=>{navigator.geolocation.getCurrentPosition(e,t,{timeout:1e4,maximumAge:0})}),t={granted:!0,state:"granted"}}catch(r){t={granted:!1,state:1===r.code?"denied":"error",error:r.message}}break;default:if(this.support.permissions){const n=await navigator.permissions.query(this.getPermissionDescriptor(e));t={granted:"granted"===n.state,state:n.state}}else t={granted:!1,state:"unsupported"}}clearTimeout(s),n(t)}catch(r){clearTimeout(s),i(r)}})}async setupPermissionWatcher(e,t){if(this.support.permissions)try{const n=await navigator.permissions.query(this.getPermissionDescriptor(e));n.addEventListener("change",()=>{t({permission:e,state:n.state,timestamp:Date.now()})})}catch(n){d.warn(`[PermissionManager] Could not set up watcher for ${e}:`,n)}}onPermissionChange(e,t){d.info(`[PermissionManager] Permission changed: ${e} → ${t}`),this.permissionCache.set(e,{name:e,state:t,timestamp:Date.now(),supported:!0}),this.permissionWatchers.forEach(n=>{n.permission===e&&n.active&&n.callback({permission:e,state:t,timestamp:Date.now()})})}async showPermissionRationale(e,t=null){const n=t||{camera:"Camera access is needed to take photos and record videos. You can enable this in your browser settings.",microphone:"Microphone access is needed for audio recording and voice features. Please check your browser settings.",geolocation:"Location access helps provide relevant local content. You can manage this in your browser settings.",notifications:"Notifications keep you updated with important information. You can change this anytime in settings."}[e]||`${e} permission was denied. Please enable it in your browser settings to use this feature.`;return!("undefined"==typeof window||!window.confirm)&&window.confirm(n+"\n\nWould you like to try again?")}generateId(e="perm"){return`${e}_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}async getPermissionReport(){return{support:this.support,cached:Array.from(this.permissionCache.entries()).map(([e,t])=>({name:e,...t})),watchers:Array.from(this.permissionWatchers.keys()),timestamp:Date.now()}}clearCache(){this.permissionCache.clear(),d.info("[PermissionManager] Permission cache cleared")}cleanup(){this.permissionWatchers.forEach(e=>{e.active=!1}),this.permissionWatchers.clear(),this.requestQueue.clear(),this.permissionCache.clear(),d.info("[PermissionManager] Cleanup completed")}}class O{constructor(e={}){this.config={rpName:e.rpName||"Custom PHP Framework",rpId:e.rpId||window.location.hostname,timeout:e.timeout||6e4,userVerification:e.userVerification||"preferred",authenticatorSelection:{authenticatorAttachment:"platform",userVerification:"preferred",requireResidentKey:!1,...e.authenticatorSelection},...e},this.credentials=new Map,this.authSessions=new Map,this.support={webAuthn:"credentials"in navigator&&"create"in navigator.credentials,conditionalUI:"conditional"in window.PublicKeyCredential||!1,userVerifyingPlatformAuthenticator:!1,residentKey:!1},this.detectFeatures(),d.info("[BiometricAuthManager] Initialized with support:",this.support)}async detectFeatures(){if(this.support.webAuthn)try{const e=await window.PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable();this.support.userVerifyingPlatformAuthenticator=e,window.PublicKeyCredential.isConditionalMediationAvailable&&(this.support.conditionalUI=await window.PublicKeyCredential.isConditionalMediationAvailable()),d.info("[BiometricAuthManager] Enhanced features detected:",{platform:this.support.userVerifyingPlatformAuthenticator,conditional:this.support.conditionalUI})}catch(e){d.warn("[BiometricAuthManager] Feature detection failed:",e)}}async register(e,t={}){var n,i;if(!this.support.webAuthn)throw new Error("WebAuthn not supported");const{challenge:s=null,excludeCredentials:r=[],extensions:o={}}=t;try{const t=s?this.base64ToArrayBuffer(s):crypto.getRandomValues(new Uint8Array(32)),a={rp:{name:this.config.rpName,id:this.config.rpId},user:{id:this.stringToArrayBuffer(e.id||e.username),name:e.username||e.email,displayName:e.displayName||e.name||e.username},challenge:t,pubKeyCredParams:[{type:"public-key",alg:-7},{type:"public-key",alg:-35},{type:"public-key",alg:-36},{type:"public-key",alg:-257},{type:"public-key",alg:-258},{type:"public-key",alg:-259}],authenticatorSelection:this.config.authenticatorSelection,timeout:this.config.timeout,attestation:"direct",extensions:{credProps:!0,...o}};r.length>0&&(a.excludeCredentials=r.map(e=>({type:"public-key",id:"string"==typeof e?this.base64ToArrayBuffer(e):e,transports:["internal","hybrid"]}))),d.info("[BiometricAuthManager] Starting registration...");const l=await navigator.credentials.create({publicKey:a});if(!l)throw new Error("Credential creation failed");const c=this.processCredential(l,"registration"),h={id:c.id,rawId:c.rawId,userId:e.id||e.username,userDisplayName:e.displayName||e.name,createdAt:Date.now(),lastUsed:null,counter:c.response.counter||0,transports:(null==(i=(n=l.response).getTransports)?void 0:i.call(n))||["internal"]};return this.credentials.set(c.id,h),d.info("[BiometricAuthManager] Registration successful:",{id:c.id,user:e.username,authenticator:h.transports}),{success:!0,credential:c,info:h,attestation:this.parseAttestation(l.response)}}catch(a){return d.error("[BiometricAuthManager] Registration failed:",a),{success:!1,error:a.message,name:a.name}}}async authenticate(e={}){if(!this.support.webAuthn)throw new Error("WebAuthn not supported");const{challenge:t=null,allowCredentials:n=[],userVerification:i=this.config.userVerification,conditional:s=!1,extensions:r={}}=e;try{const e={challenge:t?this.base64ToArrayBuffer(t):crypto.getRandomValues(new Uint8Array(32)),timeout:this.config.timeout,userVerification:i,extensions:{credProps:!0,...r}};n.length>0&&(e.allowCredentials=n.map(e=>({type:"public-key",id:"string"==typeof e?this.base64ToArrayBuffer(e):e,transports:["internal","hybrid","usb","nfc","ble"]}))),d.info("[BiometricAuthManager] Starting authentication...",{conditional:s});const o=s&&this.support.conditionalUI?await navigator.credentials.get({publicKey:e,mediation:"conditional"}):await navigator.credentials.get({publicKey:e});if(!o)throw new Error("Authentication failed");const a=this.processCredential(o,"authentication"),l=this.credentials.get(a.id);l&&(l.lastUsed=Date.now(),l.counter=a.response.counter||0);const c=this.generateSessionId(),h={id:c,credentialId:a.id,userId:null==l?void 0:l.userId,authenticatedAt:Date.now(),userAgent:navigator.userAgent,ipAddress:await this.getClientIP().catch(()=>"unknown")};return this.authSessions.set(c,h),d.info("[BiometricAuthManager] Authentication successful:",{sessionId:c,credentialId:a.id,userId:null==l?void 0:l.userId}),{success:!0,credential:a,session:h,info:l}}catch(o){return d.error("[BiometricAuthManager] Authentication failed:",o),{success:!1,error:o.message,name:o.name}}}async isAvailable(){const e={webAuthn:this.support.webAuthn,platform:this.support.userVerifyingPlatformAuthenticator,conditional:this.support.conditionalUI,hasCredentials:this.credentials.size>0,recommended:!1};return e.recommended=e.webAuthn&&(e.platform||e.hasCredentials),e}async setupConditionalUI(e='input[type="email"], input[type="text"]',t={}){if(!this.support.conditionalUI)return d.warn("[BiometricAuthManager] Conditional UI not supported"),null;const n=document.querySelectorAll(e);if(0===n.length)return d.warn("[BiometricAuthManager] No suitable inputs found for conditional UI"),null;try{return n.forEach(e=>{e.addEventListener("focus",async()=>{var n;d.info("[BiometricAuthManager] Setting up conditional authentication");try{const i=await this.authenticate({...t,conditional:!0});if(i.success){const t=new CustomEvent("biometric-auth-success",{detail:i});e.dispatchEvent(t),(null==(n=i.info)?void 0:n.userDisplayName)&&(e.value=i.info.userDisplayName)}}catch(i){d.warn("[BiometricAuthManager] Conditional auth failed:",i)}})}),d.info("[BiometricAuthManager] Conditional UI setup complete"),{inputs:n.length,selector:e}}catch(i){return d.error("[BiometricAuthManager] Conditional UI setup failed:",i),null}}createLoginFlow(e={}){const{registerSelector:t="#register-biometric",loginSelector:n="#login-biometric",statusSelector:i="#biometric-status",onRegister:s=null,onLogin:r=null,onError:o=null}=e;return{async init(){const e=await this.isAvailable(),s=document.querySelector(i);s&&(s.innerHTML=this.createStatusHTML(e));const r=document.querySelector(t);r&&(r.style.display=e.webAuthn?"block":"none",r.onclick=()=>this.handleRegister());const o=document.querySelector(n);return o&&(o.style.display=e.hasCredentials?"block":"none",o.onclick=()=>this.handleLogin()),e.conditional&&await this.setupConditionalUI(),e},async handleRegister(){try{const e=await this.getUserInfo();if(!e)return;const t=await this.register(e);t.success?(s&&s(t),this.showSuccess("Biometric authentication registered successfully!")):(o&&o(t),this.showError(t.error))}catch(e){o&&o({error:e.message}),this.showError(e.message)}},async handleLogin(){try{const e=await this.authenticate();e.success?(r&&r(e),this.showSuccess("Biometric authentication successful!")):(o&&o(e),this.showError(e.error))}catch(e){o&&o({error:e.message}),this.showError(e.message)}},async getUserInfo(){const e=document.querySelector('input[name="username"], input[name="email"]'),t=document.querySelector('input[name="name"], input[name="display_name"]');if(null==e?void 0:e.value)return{id:e.value,username:e.value,displayName:(null==t?void 0:t.value)||e.value};const n=prompt("Please enter your username or email:");if(!n)return null;return{id:n,username:n,displayName:prompt("Please enter your display name:")||n}},createStatusHTML:e=>e.webAuthn?e.platform||e.hasCredentials?e.hasCredentials?'<div class="alert alert-success">✅ Biometric authentication available</div>':'<div class="alert alert-info">🔐 Biometric authentication can be set up</div>':'<div class="alert alert-info">ℹ️ No biometric authenticators available</div>':'<div class="alert alert-warning">⚠️ Biometric authentication not supported in this browser</div>',showSuccess(e){this.showMessage(e,"success")},showError(e){this.showMessage(e,"error")},showMessage(e,t="info"){const n=document.createElement("div");n.className=`biometric-toast toast-${t}`,n.style.cssText=`\n                    position: fixed;\n                    top: 20px;\n                    right: 20px;\n                    background: ${"error"===t?"#f44336":"success"===t?"#4caf50":"#2196f3"};\n                    color: white;\n                    padding: 1rem;\n                    border-radius: 4px;\n                    box-shadow: 0 2px 10px rgba(0,0,0,0.3);\n                    z-index: 10001;\n                    max-width: 300px;\n                `,n.textContent=e,document.body.appendChild(n),setTimeout(()=>{n.parentNode&&document.body.removeChild(n)},5e3)}}}processCredential(e,t){var n,i;const s={id:this.arrayBufferToBase64(e.rawId),rawId:this.arrayBufferToBase64(e.rawId),type:e.type,response:{}};return s.response="registration"===t?{attestationObject:this.arrayBufferToBase64(e.response.attestationObject),clientDataJSON:this.arrayBufferToBase64(e.response.clientDataJSON),transports:(null==(i=(n=e.response).getTransports)?void 0:i.call(n))||[]}:{authenticatorData:this.arrayBufferToBase64(e.response.authenticatorData),clientDataJSON:this.arrayBufferToBase64(e.response.clientDataJSON),signature:this.arrayBufferToBase64(e.response.signature),userHandle:e.response.userHandle?this.arrayBufferToBase64(e.response.userHandle):null},s}parseAttestation(e){try{const t=JSON.parse(this.arrayBufferToString(e.clientDataJSON));return{format:"packed",clientData:t,origin:t.origin,challenge:t.challenge}}catch(t){return d.warn("[BiometricAuthManager] Attestation parsing failed:",t),null}}async getClientIP(){try{const e=await fetch("https://api.ipify.org?format=json");return(await e.json()).ip}catch(e){return"unknown"}}generateSessionId(){return`biometric_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}arrayBufferToBase64(e){const t=new Uint8Array(e);let n="";for(let i=0;i<t.byteLength;i++)n+=String.fromCharCode(t[i]);return btoa(n)}base64ToArrayBuffer(e){const t=atob(e),n=new Uint8Array(t.length);for(let i=0;i<t.length;i++)n[i]=t.charCodeAt(i);return n.buffer}stringToArrayBuffer(e){return(new TextEncoder).encode(e)}arrayBufferToString(e){return(new TextDecoder).decode(e)}getCredentials(){return Array.from(this.credentials.values())}getActiveSessions(){return Array.from(this.authSessions.values())}revokeCredential(e){const t=this.credentials.delete(e);return t&&d.info(`[BiometricAuthManager] Credential revoked: ${e}`),t}endSession(e){const t=this.authSessions.delete(e);return t&&d.info(`[BiometricAuthManager] Session ended: ${e}`),t}cleanupSessions(e=864e5){const t=Date.now();let n=0;for(const[i,s]of this.authSessions.entries())t-s.authenticatedAt>e&&(this.authSessions.delete(i),n++);return n>0&&d.info(`[BiometricAuthManager] Cleaned up ${n} expired sessions`),n}async getStatusReport(){return{availability:await this.isAvailable(),credentials:this.credentials.size,sessions:this.authSessions.size,support:this.support,config:{rpName:this.config.rpName,rpId:this.config.rpId,timeout:this.config.timeout},timestamp:Date.now()}}}const F={name:"api-manager",init(e={},t=null){return d.info("[APIManager] Module initialized - All Web APIs available"),this.initializeAPIManagers(e),this.exposeGlobalAPI(),this},initializeAPIManagers(e){this.observers=new T(e.observers||{}),this.media=new I(e.media||{}),this.storage=new P(e.storage||{}),this.device=new L(e.device||{}),this.animation=new $(e.animation||{}),this.worker=new D(e.worker||{}),this.performance=new z(e.performance||{}),this.permissions=new R(e.permissions||{}),this.biometric=new O(e.biometric||{}),d.info("[APIManager] All API managers initialized")},exposeGlobalAPI(){"undefined"!=typeof window&&(window.API={observers:this.observers,media:this.media,storage:this.storage,device:this.device,animation:this.animation,worker:this.worker,performance:this.performance,permissions:this.permissions,biometric:this.biometric},d.info("[APIManager] Global API exposed at window.API"))},getAPI(e){return this[e]||null},isSupported:e=>({IntersectionObserver:"IntersectionObserver"in window,ResizeObserver:"ResizeObserver"in window,MutationObserver:"MutationObserver"in window,PerformanceObserver:"PerformanceObserver"in window,MediaDevices:void 0!==navigator.mediaDevices,WebRTC:"RTCPeerConnection"in window,WebAudio:"AudioContext"in window||"webkitAudioContext"in window,MediaRecorder:"MediaRecorder"in window,IndexedDB:"indexedDB"in window,CacheAPI:"caches"in window,WebLocks:"locks"in navigator,BroadcastChannel:"BroadcastChannel"in window,Geolocation:"geolocation"in navigator,DeviceMotion:"DeviceMotionEvent"in window,DeviceOrientation:"DeviceOrientationEvent"in window,Vibration:"vibrate"in navigator,Battery:"getBattery"in navigator,NetworkInfo:"connection"in navigator,WebAnimations:"animate"in Element.prototype,VisualViewport:"visualViewport"in window,WebWorkers:"Worker"in window,ServiceWorker:"serviceWorker"in navigator,SharedWorker:"SharedWorker"in window,PerformanceAPI:"performance"in window,NavigationTiming:"getEntriesByType"in performance,Permissions:"permissions"in navigator,WebAuthn:"credentials"in navigator&&"create"in navigator.credentials}[e]||!1),getCapabilities(){const e={};return Object.keys(this.getSupportMap()).forEach(t=>{e[t]=this.isSupported(t)}),{capabilities:e,modernBrowser:this.isModernBrowser(),recommendedAPIs:this.getRecommendedAPIs(),summary:this.getCapabilitySummary(e)}},isModernBrowser(){return["IntersectionObserver","ResizeObserver","WebAnimations","IndexedDB"].every(e=>this.isSupported(e))},getRecommendedAPIs(){const e=[];return this.isSupported("IntersectionObserver")&&e.push({api:"IntersectionObserver",use:"Lazy loading, scroll triggers, viewport detection",example:"API.observers.intersection(elements, callback)"}),this.isSupported("WebAnimations")&&e.push({api:"Web Animations",use:"High-performance animations with timeline control",example:"API.animation.animate(element, keyframes, options)"}),this.isSupported("IndexedDB")&&e.push({api:"IndexedDB",use:"Client-side database for complex data",example:"API.storage.db.set(key, value)"}),this.isSupported("MediaDevices")&&e.push({api:"Media Devices",use:"Camera, microphone, screen sharing",example:"API.media.getUserCamera()"}),e},getCapabilitySummary(e){const t=Object.keys(e).length,n=Object.values(e).filter(Boolean).length,i=Math.round(n/t*100);return{total:t,supported:n,percentage:i,grade:this.getGrade(i)}},getGrade:e=>e>=90?"A+":e>=80?"A":e>=70?"B":e>=60?"C":"D",getSupportMap:()=>({IntersectionObserver:"Viewport intersection detection",ResizeObserver:"Element resize detection",MutationObserver:"DOM change detection",PerformanceObserver:"Performance metrics monitoring",MediaDevices:"Camera and microphone access",WebRTC:"Real-time communication",WebAudio:"Audio processing and synthesis",MediaRecorder:"Audio/video recording",IndexedDB:"Client-side database",CacheAPI:"HTTP cache management",WebLocks:"Resource locking",BroadcastChannel:"Cross-tab communication",Geolocation:"GPS and location services",DeviceMotion:"Accelerometer and gyroscope",DeviceOrientation:"Device orientation",Vibration:"Haptic feedback",Battery:"Battery status",NetworkInfo:"Network connection info",WebAnimations:"High-performance animations",VisualViewport:"Viewport information",WebWorkers:"Background processing",ServiceWorker:"Background sync and caching",SharedWorker:"Shared background processing",PerformanceAPI:"Performance measurement",NavigationTiming:"Navigation timing metrics",Permissions:"Browser permission management",WebAuthn:"Biometric authentication"})},_=F.init.bind(F),B=Object.freeze(Object.defineProperty({__proto__:null,default:F,init:_},Symbol.toStringTag,{value:"Module"})),N={NO_CACHE:"no-cache",CACHE_FIRST:"cache-first",NETWORK_FIRST:"network-first",STALE_WHILE_REVALIDATE:"stale-while-revalidate",NETWORK_ONLY:"network-only",CACHE_ONLY:"cache-only"};class q{constructor(e={}){this.config={defaultStrategy:e.defaultStrategy||N.STALE_WHILE_REVALIDATE,defaultTTL:e.defaultTTL||36e5,maxMemorySize:e.maxMemorySize||50,enableIndexedDB:e.enableIndexedDB??!0,indexedDBName:e.indexedDBName||"app-cache",indexedDBVersion:e.indexedDBVersion||1,enableAnalytics:e.enableAnalytics??!1,...e},this.memoryCache=new Map,this.indexedDBCache=null,this.analytics={hits:0,misses:0,sets:0,deletes:0},this.init()}static create(e={}){return new q(e)}async init(){if(this.config.enableIndexedDB&&"indexedDB"in window)try{await this.initIndexedDB()}catch(e){d.error("[CacheManager] Failed to initialize IndexedDB",e),this.config.enableIndexedDB=!1}d.info("[CacheManager] Initialized",{strategy:this.config.defaultStrategy,memoryCache:!0,indexedDB:this.config.enableIndexedDB})}async initIndexedDB(){return new Promise((e,t)=>{const n=indexedDB.open(this.config.indexedDBName,this.config.indexedDBVersion);n.onerror=()=>t(n.error),n.onsuccess=()=>{this.indexedDBCache=n.result,e()},n.onupgradeneeded=e=>{const t=e.target.result;t.objectStoreNames.contains("cache")||t.createObjectStore("cache",{keyPath:"key"})}})}async get(e,t={}){t.strategy||this.config.defaultStrategy;const n=t.ttl||this.config.defaultTTL,i=this.memoryCache.get(e);if(i&&!this.isExpired(i,n))return this.analytics.hits++,d.debug("[CacheManager] Cache hit (memory)",e),i.value;if(this.config.enableIndexedDB&&this.indexedDBCache)try{const t=await this.getFromIndexedDB(e);if(t&&!this.isExpired(t,n))return this.memoryCache.set(e,t),this.analytics.hits++,d.debug("[CacheManager] Cache hit (IndexedDB)",e),t.value}catch(s){d.error("[CacheManager] IndexedDB get error",s)}return this.analytics.misses++,d.debug("[CacheManager] Cache miss",e),null}async set(e,t,n={}){const i=n.ttl||this.config.defaultTTL,s=n.strategy||this.config.defaultStrategy,r={key:e,value:t,timestamp:Date.now(),ttl:i,strategy:s};if(this.memoryCache.set(e,r),this.memoryCache.size>this.config.maxMemorySize){const e=this.memoryCache.keys().next().value;this.memoryCache.delete(e)}if(this.config.enableIndexedDB&&this.indexedDBCache)try{await this.setInIndexedDB(r)}catch(o){d.error("[CacheManager] IndexedDB set error",o)}this.analytics.sets++,d.debug("[CacheManager] Cache set",e)}async getOrSet(e,t,n={}){const i=n.strategy||this.config.defaultStrategy;if(i!==N.NETWORK_ONLY){const t=await this.get(e,n);if(null!==t)return t}const s=await t();return i!==N.NO_CACHE&&await this.set(e,s,n),s}async delete(e){if(this.memoryCache.delete(e),this.config.enableIndexedDB&&this.indexedDBCache)try{await this.deleteFromIndexedDB(e)}catch(t){d.error("[CacheManager] IndexedDB delete error",t)}this.analytics.deletes++,d.debug("[CacheManager] Cache delete",e)}async clear(){if(this.memoryCache.clear(),this.config.enableIndexedDB&&this.indexedDBCache)try{await this.clearIndexedDB()}catch(e){d.error("[CacheManager] IndexedDB clear error",e)}d.info("[CacheManager] Cache cleared")}async invalidate(e){const t=[];for(const n of this.memoryCache.keys())this.matchesPattern(n,e)&&t.push(n);for(const n of t)await this.delete(n);d.info("[CacheManager] Invalidated cache",{pattern:e,count:t.length})}matchesPattern(e,t){return"string"==typeof t?e.includes(t):t instanceof RegExp?t.test(e):"function"==typeof t&&t(e)}isExpired(e,t){if(!e||!e.timestamp)return!0;return Date.now()-e.timestamp>(e.ttl||t)}async getFromIndexedDB(e){return new Promise((t,n)=>{const i=this.indexedDBCache.transaction(["cache"],"readonly").objectStore("cache").get(e);i.onsuccess=()=>t(i.result),i.onerror=()=>n(i.error)})}async setInIndexedDB(e){return new Promise((t,n)=>{const i=this.indexedDBCache.transaction(["cache"],"readwrite").objectStore("cache").put(e);i.onsuccess=()=>t(),i.onerror=()=>n(i.error)})}async deleteFromIndexedDB(e){return new Promise((t,n)=>{const i=this.indexedDBCache.transaction(["cache"],"readwrite").objectStore("cache").delete(e);i.onsuccess=()=>t(),i.onerror=()=>n(i.error)})}async clearIndexedDB(){return new Promise((e,t)=>{const n=this.indexedDBCache.transaction(["cache"],"readwrite").objectStore("cache").clear();n.onsuccess=()=>e(),n.onerror=()=>t(n.error)})}async warm(e,t){d.info("[CacheManager] Warming cache",{count:e.length});for(const i of e)try{await this.getOrSet(i,()=>t(i))}catch(n){d.error(`[CacheManager] Failed to warm cache for ${i}`,n)}}getAnalytics(){const e=this.analytics.hits+this.analytics.misses,t=e>0?this.analytics.hits/e*100:0;return{...this.analytics,total:e,hitRate:Math.round(100*t)/100,memorySize:this.memoryCache.size,memoryMaxSize:this.config.maxMemorySize}}resetAnalytics(){this.analytics={hits:0,misses:0,sets:0,deletes:0}}destroy(){this.memoryCache.clear(),this.indexedDBCache=null,d.info("[CacheManager] Destroyed")}}const H="cache-first",j="stale-while-revalidate",U="network-only",W="cache-only";const V={name:"cache-manager",cacheManager:null,init(e={},t=null){return d.info("[CacheManagerModule] Module initialized"),this.cacheManager=q.create(e),"undefined"!=typeof window&&(window.CacheManager=this.cacheManager,window.CacheStrategy=N),this},getCacheManager(){return this.cacheManager||q.create()},async get(e,t={}){const n=this.getCacheManager();return await n.get(e,t)},async set(e,t,n={}){const i=this.getCacheManager();return await i.set(e,t,n)},async getOrSet(e,t,n={}){const i=this.getCacheManager();return await i.getOrSet(e,t,n)},destroy(){this.cacheManager&&(this.cacheManager.destroy(),this.cacheManager=null),"undefined"!=typeof window&&(delete window.CacheManager,delete window.CacheStrategy),d.info("[CacheManagerModule] Module destroyed")}},G=V.init.bind(V),J=Object.freeze(Object.defineProperty({__proto__:null,CacheManager:q,CacheStrategy:N,default:V,getStrategyForUseCase:function(e){return{"api-response":j,"user-data":H,"real-time":U,"static-content":W,"computed-value":H}[e]||j},init:G},Symbol.toStringTag,{value:"Module"})),Q=new Map,X={add(e,t,n,{module:i="global",options:s=!1}={}){e.addEventListener(t,n,s),Q.has(i)||Q.set(i,[]),Q.get(i).push([e,t,n,s])},removeModule(e){const t=Q.get(e);t&&(t.forEach(([e,t,n,i])=>{e.removeEventListener(t,n,i)}),Q.delete(e))},clearAll(){for(const[e,t]of Q.entries())t.forEach(([e,t,n,i])=>{e.removeEventListener(t,n,i)});Q.clear()},debug(){console.table([...Q.entries()].map(([e,t])=>({module:e,listeners:t.length})))}};function K(e,t,n,i=import.meta,s=!1){var r;const o="string"==typeof i?i:(null==(r=i.url)?void 0:r.split("/").slice(-2,-1)[0])||"unknown";return X.add(e,t,n,{module:o,options:s}),()=>{X.removeModule(o)}}class Y{constructor(e,t={}){this.canvas=e,this.ctx=e.getContext("2d"),this.options={responsive:!0,pixelRatio:window.devicePixelRatio||1,...t},this.animationId=null,this.isAnimating=!1,this.init()}init(){this.setupCanvas(),this.options.responsive&&this.setupResponsive(),d.info("[CanvasManager] Initialized",{width:this.canvas.width,height:this.canvas.height,pixelRatio:this.options.pixelRatio})}setupCanvas(){this.resize(),this.canvas.style.width=this.canvas.width+"px",this.canvas.style.height=this.canvas.height+"px",this.options.pixelRatio>1&&this.ctx.scale(this.options.pixelRatio,this.options.pixelRatio)}setupResponsive(){K(window,"resize",()=>{this.resize()},"canvas-manager"),K(window,"orientationchange",()=>{setTimeout(()=>this.resize(),100)},"canvas-manager")}resize(){const e=this.canvas.parentElement,t=this.options.pixelRatio;let n,i;e&&"static"!==getComputedStyle(e).position?(n=e.clientWidth,i=e.clientHeight):(n=this.canvas.clientWidth||window.innerWidth,i=this.canvas.clientHeight||window.innerHeight),this.canvas.width=Math.floor(n*t),this.canvas.height=Math.floor(i*t),this.canvas.style.width=n+"px",this.canvas.style.height=i+"px",t>1&&this.ctx.scale(t,t),d.info("[CanvasManager] Resized",{displayWidth:n,displayHeight:i,canvasWidth:this.canvas.width,canvasHeight:this.canvas.height})}clear(){this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height)}getSize(){return{width:this.canvas.clientWidth,height:this.canvas.clientHeight,pixelWidth:this.canvas.width,pixelHeight:this.canvas.height}}getMousePosition(e){const t=this.canvas.getBoundingClientRect();return{x:(e.clientX-t.left)*this.options.pixelRatio,y:(e.clientY-t.top)*this.options.pixelRatio}}startAnimation(e){this.isAnimating&&this.stopAnimation(),this.isAnimating=!0;const t=n=>{this.isAnimating&&(e(n),this.animationId=requestAnimationFrame(t))};this.animationId=requestAnimationFrame(t),d.info("[CanvasManager] Animation started")}stopAnimation(){this.animationId&&(cancelAnimationFrame(this.animationId),this.animationId=null),this.isAnimating=!1,d.info("[CanvasManager] Animation stopped")}destroy(){this.stopAnimation(),d.info("[CanvasManager] Destroyed")}}const Z={initParallax(e,t){const n=new Y(e),i=this.createParallaxElements(e,t);let s=!1;const r=()=>{s||(requestAnimationFrame(()=>{this.renderParallax(n,i,t),s=!1}),s=!0)};K(window,"scroll",r,"scroll-parallax"),K(window,"resize",r,"scroll-parallax"),r(),d.info("[ScrollEffects] Parallax initialized with",i.length,"elements")},createParallaxElements(e,t){const n=[],i=t.layers||3,s=t.elements||20;for(let r=0;r<s;r++)n.push({x:Math.random()*e.clientWidth,y:Math.random()*e.clientHeight*2,size:20*Math.random()+5,layer:Math.floor(Math.random()*i),speed:.1+.5*Math.random(),opacity:.7*Math.random()+.3,color:this.getLayerColor(Math.floor(Math.random()*i),t)});return n},getLayerColor(e,t){const n=t.colors||["rgba(100, 150, 255, 0.6)","rgba(150, 100, 255, 0.4)","rgba(200, 100, 150, 0.2)"];return n[e]||n[0]},renderParallax(e,t,n){e.clear();const i=window.pageYOffset,s=(i-(e.canvas.getBoundingClientRect().top+i))/window.innerHeight;t.forEach(t=>{const n=s*t.speed*100,i=t.y-n;i>-t.size&&i<e.canvas.clientHeight+t.size&&(e.ctx.save(),e.ctx.globalAlpha=t.opacity,e.ctx.fillStyle=t.color,e.ctx.beginPath(),e.ctx.arc(t.x,i,t.size,0,2*Math.PI),e.ctx.fill(),e.ctx.restore())})},initScrollAnimation(e,t){const n=new Y(e),i=t.animation||"wave";let s=!1;const r=()=>{s||(requestAnimationFrame(()=>{this.renderScrollAnimation(n,i,t),s=!1}),s=!0)};K(window,"scroll",r,"scroll-animation"),K(window,"resize",r,"scroll-animation"),r(),d.info("[ScrollEffects] Scroll animation initialized:",i)},renderScrollAnimation(e,t,n){e.clear();const i=window.pageYOffset,s=i-(e.canvas.getBoundingClientRect().top+i),r=Math.max(0,Math.min(1,s/window.innerHeight));switch(t){case"wave":default:this.renderWaveAnimation(e,r,n);break;case"progress":this.renderProgressAnimation(e,r,n);break;case"morph":this.renderMorphAnimation(e,r,n)}},renderWaveAnimation(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize();i.strokeStyle=n.color||"rgba(100, 150, 255, 0.8)",i.lineWidth=n.lineWidth||3,i.beginPath();const o=(n.amplitude||50)*t,a=n.frequency||.02,l=t*Math.PI*2;for(let c=0;c<=s;c+=2){const e=r/2+Math.sin(c*a+l)*o;0===c?i.moveTo(c,e):i.lineTo(c,e)}i.stroke()},renderProgressAnimation(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize(),o=n.barHeight||10,a=r/2-o/2;i.fillStyle=n.backgroundColor||"rgba(255, 255, 255, 0.2)",i.fillRect(0,a,s,o),i.fillStyle=n.color||"rgba(100, 150, 255, 0.8)",i.fillRect(0,a,s*t,o)},renderMorphAnimation(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize();i.fillStyle=n.color||"rgba(100, 150, 255, 0.6)";const o=s/2,a=r/2,l=Math.min(s,r)/3;i.beginPath();const c=n.points||6;for(let d=0;d<=c;d++){const e=d/c*Math.PI*2,n=l*t*(.3*Math.sin(t*Math.PI*4+3*e)+1),s=o+Math.cos(e)*n,r=a+Math.sin(e)*n;0===d?i.moveTo(s,r):i.lineTo(s,r)}i.closePath(),i.fill()}},ee={init(e,t){const n=new Y(e),i=t.effect||"ripple",s={mouse:{x:0,y:0,isOver:!1},effects:[],lastTime:0};this.setupInteractionEvents(e,n,s,t),this.startAnimationLoop(n,s,i,t),d.info("[InteractiveEffects] Initialized with effect:",i)},setupInteractionEvents(e,t,n,i){K(e,"mousemove",e=>{const s=t.getMousePosition(e);n.mouse.x=s.x,n.mouse.y=s.y,"trail"===i.effect&&this.addTrailPoint(n,s.x,s.y)},"interactive-effects"),K(e,"mouseenter",()=>{n.mouse.isOver=!0},"interactive-effects"),K(e,"mouseleave",()=>{n.mouse.isOver=!1},"interactive-effects"),K(e,"click",e=>{const s=t.getMousePosition(e);this.addClickEffect(n,s.x,s.y,i)},"interactive-effects"),K(e,"touchstart",e=>{e.preventDefault();const s=e.touches[0],r=t.getMousePosition(s);this.addClickEffect(n,r.x,r.y,i)},"interactive-effects"),K(e,"touchmove",e=>{e.preventDefault();const s=e.touches[0],r=t.getMousePosition(s);n.mouse.x=r.x,n.mouse.y=r.y,n.mouse.isOver=!0,"trail"===i.effect&&this.addTrailPoint(n,r.x,r.y)},"interactive-effects"),K(e,"touchend",()=>{n.mouse.isOver=!1},"interactive-effects")},startAnimationLoop(e,t,n,i){const s=r=>{const o=r-t.lastTime;switch(t.lastTime=r,e.clear(),n){case"ripple":default:this.renderRippleEffect(e,t,i);break;case"trail":this.renderTrailEffect(e,t,i);break;case"particles":this.renderParticleEffect(e,t,i,o);break;case"magnetic":this.renderMagneticEffect(e,t,i)}this.updateEffects(t.effects,o),requestAnimationFrame(s)};requestAnimationFrame(s)},addClickEffect(e,t,n,i){const s={x:t,y:n,age:0,maxAge:i.duration||1e3,type:"click",intensity:i.intensity||1};e.effects.push(s)},addTrailPoint(e,t,n){const i={x:t,y:n,age:0,maxAge:500,type:"trail"};e.effects.push(i);const s=e.effects.filter(e=>"trail"===e.type);if(s.length>20){const t=e.effects.indexOf(s[0]);e.effects.splice(t,1)}},renderRippleEffect(e,t,n){const{ctx:i}=e;t.effects.forEach(t=>{if("click"===t.type){const s=t.age/t.maxAge,r=s*(n.maxRadius||100),o=.8*(1-s);i.save(),i.globalAlpha=o,i.strokeStyle=n.color||"rgba(100, 150, 255, 1)",i.lineWidth=n.lineWidth||3,i.beginPath(),i.arc(t.x/e.options.pixelRatio,t.y/e.options.pixelRatio,r,0,2*Math.PI),i.stroke(),i.restore()}}),t.mouse.isOver&&(i.save(),i.globalAlpha=.3,i.fillStyle=n.hoverColor||"rgba(100, 150, 255, 0.3)",i.beginPath(),i.arc(t.mouse.x/e.options.pixelRatio,t.mouse.y/e.options.pixelRatio,n.hoverRadius||30,0,2*Math.PI),i.fill(),i.restore())},renderTrailEffect(e,t,n){const{ctx:i}=e,s=t.effects.filter(e=>"trail"===e.type);s.length<2||(i.save(),i.strokeStyle=n.color||"rgba(100, 150, 255, 0.8)",i.lineWidth=n.lineWidth||5,i.lineCap="round",i.lineJoin="round",i.beginPath(),s.forEach((t,n)=>{const s=1-t.age/t.maxAge,r=t.x/e.options.pixelRatio,o=t.y/e.options.pixelRatio;i.globalAlpha=.8*s,0===n?i.moveTo(r,o):i.lineTo(r,o)}),i.stroke(),i.restore())},renderParticleEffect(e,t,n,i){const{ctx:s}=e;if(t.mouse.isOver&&Math.random()<.1){const e={x:t.mouse.x,y:t.mouse.y,vx:4*(Math.random()-.5),vy:4*(Math.random()-.5),age:0,maxAge:1e3,size:5*Math.random()+2,type:"particle"};t.effects.push(e)}t.effects.forEach(t=>{if("particle"===t.type){t.x+=t.vx,t.y+=t.vy,t.vy+=.1;const i=t.age/t.maxAge,r=.8*(1-i);s.save(),s.globalAlpha=r,s.fillStyle=n.color||"rgba(100, 150, 255, 1)",s.beginPath(),s.arc(t.x/e.options.pixelRatio,t.y/e.options.pixelRatio,t.size*(1-.5*i),0,2*Math.PI),s.fill(),s.restore()}})},renderMagneticEffect(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize();if(!t.mouse.isOver)return;const o=s/2,a=r/2,l=t.mouse.x/e.options.pixelRatio,c=t.mouse.y/e.options.pixelRatio;i.save(),i.strokeStyle=n.color||"rgba(100, 150, 255, 0.6)",i.lineWidth=2;for(let d=0;d<8;d++){const e=d/8*Math.PI*2,t=o+50*Math.cos(e),n=a+50*Math.sin(e),s=(t+l)/2+30*Math.sin(e),r=(n+c)/2+30*Math.cos(e);i.beginPath(),i.moveTo(t,n),i.quadraticCurveTo(s,r,l,c),i.stroke()}i.restore()},updateEffects(e,t){for(let n=e.length-1;n>=0;n--)e[n].age+=t,e[n].age>=e[n].maxAge&&e.splice(n,1)}},te={init(e,t){const n=new Y(e),i=t.type||"bar",s=this.parseData(e,t);if(s&&0!==s.length){switch(i){case"bar":default:this.createBarChart(n,s,t);break;case"line":this.createLineChart(n,s,t);break;case"pie":this.createPieChart(n,s,t);break;case"progress":this.createProgressChart(n,s,t)}d.info("[DataVisualization] Initialized",i,"chart with",s.length,"data points")}else d.warn("[DataVisualization] No data provided for canvas")},parseData(e,t){let n=t.data;if(!n&&e.dataset.canvasData)try{n=JSON.parse(e.dataset.canvasData)}catch(i){d.warn("[DataVisualization] Failed to parse canvas data",i)}if(!n){const t=e.nextElementSibling;if(t&&"SCRIPT"===t.tagName&&"application/json"===t.type)try{n=JSON.parse(t.textContent)}catch(i){d.warn("[DataVisualization] Failed to parse script data",i)}}if(!n)return d.warn("[DataVisualization] No data found"),[];if(!Array.isArray(n))if("number"==typeof n)n=[{value:n,label:"Progress"}];else{if("object"!=typeof n)return d.warn("[DataVisualization] Data format not recognized:",n),[];n=Object.entries(n).map(([e,t])=>({label:e,value:"object"==typeof t&&t.value||t}))}return n},createBarChart(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize(),o=n.padding||40,a=s-2*o,l=r-2*o,c=a/t.length*.8,d=a/t.length*.2,h=Math.max(...t.map(e=>e.value));let u=0;const p=n.animationDuration||2e3;let m=null;const g=i=>{m||(m=i);const s=i-m;u=Math.min(s/p,1);const r=1-Math.pow(1-u,3);e.clear(),this.renderBarChart(e,t,n,r,{padding:o,chartWidth:a,chartHeight:l,barWidth:c,barSpacing:d,maxValue:h}),u<1&&requestAnimationFrame(g)};requestAnimationFrame(g)},renderBarChart(e,t,n,i,s){const{ctx:r}=e,{padding:o,chartHeight:a,barWidth:l,barSpacing:c,maxValue:d}=s;t.forEach((e,t)=>{const s=o+t*(l+c),h=e.value/d*a*i,u=o+a-h;r.fillStyle=e.color||n.barColor||"rgba(100, 150, 255, 0.8)",r.fillRect(s,u,l,h),!1!==n.showLabels&&(r.fillStyle=n.textColor||"#333",r.font=n.font||"12px Arial",r.textAlign="center",r.fillText(e.label,s+l/2,o+a+20),!1!==n.showValues&&r.fillText(Math.round(e.value*i),s+l/2,u-5))}),!1!==n.showAxes&&(r.strokeStyle=n.axisColor||"#ccc",r.lineWidth=1,r.beginPath(),r.moveTo(o,o),r.lineTo(o,o+a),r.stroke(),r.beginPath(),r.moveTo(o,o+a),r.lineTo(o+s.chartWidth,o+a),r.stroke())},createLineChart(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize(),o=n.padding||40,a=s-2*o,l=r-2*o,c=Math.max(...t.map(e=>e.value)),d=Math.min(...t.map(e=>e.value)),h=c-d;let u=0;const p=n.animationDuration||2e3;let m=null;const g=i=>{m||(m=i);const s=i-m;u=Math.min(s/p,1),e.clear(),this.renderLineChart(e,t,n,u,{padding:o,chartWidth:a,chartHeight:l,maxValue:c,minValue:d,valueRange:h}),u<1&&requestAnimationFrame(g)};requestAnimationFrame(g)},renderLineChart(e,t,n,i,s){const{ctx:r}=e,{padding:o,chartWidth:a,chartHeight:l,minValue:c,valueRange:d}=s,h=Math.floor(t.length*i);r.strokeStyle=n.lineColor||"rgba(100, 150, 255, 0.8)",r.lineWidth=n.lineWidth||3,r.lineCap="round",r.lineJoin="round",r.beginPath();for(let u=0;u<=h&&u<t.length;u++){const e=o+u/(t.length-1)*a,n=o+l-(t[u].value-c)/d*l;0===u?r.moveTo(e,n):r.lineTo(e,n)}if(r.stroke(),!1!==n.showPoints){r.fillStyle=n.pointColor||n.lineColor||"rgba(100, 150, 255, 0.8)";for(let e=0;e<=h&&e<t.length;e++){const i=o+e/(t.length-1)*a,s=o+l-(t[e].value-c)/d*l;r.beginPath(),r.arc(i,s,n.pointSize||4,0,2*Math.PI),r.fill(),!1!==n.showLabels&&t[e].label&&(r.fillStyle=n.textColor||"#333",r.font=n.font||"12px Arial",r.textAlign="center",r.fillText(t[e].label,i,o+l+20))}}},createPieChart(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize(),o=s/2,a=r/2,l=Math.min(s,r)/2*.8,c=t.reduce((e,t)=>e+t.value,0);let d=0;const h=n.animationDuration||2e3;let u=null;const p=i=>{u||(u=i);const s=i-u;d=Math.min(s/h,1),e.clear(),this.renderPieChart(e,t,n,d,{centerX:o,centerY:a,radius:l,total:c}),d<1&&requestAnimationFrame(p)};requestAnimationFrame(p)},renderPieChart(e,t,n,i,s){const{ctx:r}=e,{centerX:o,centerY:a,radius:l,total:c}=s;let d=-Math.PI/2;const h=d+2*Math.PI*i;for(let u=0;u<t.length&&!(d>=h);u++){const e=t[u],i=e.value/c*Math.PI*2,s=Math.min(d+i,h);if(s>d&&(r.fillStyle=e.color||this.getDefaultColor(u),r.beginPath(),r.moveTo(o,a),r.arc(o,a,l,d,s),r.closePath(),r.fill(),!1!==n.showLabels&&s===d+i)){const t=d+i/2,s=o+Math.cos(t)*l*.7,c=a+Math.sin(t)*l*.7;r.fillStyle=n.textColor||"#333",r.font=n.font||"12px Arial",r.textAlign="center",r.fillText(e.label,s,c)}d+=i}},createProgressChart(e,t,n){const{ctx:i}=e,{width:s,height:r}=e.getSize();let o=0;const a=n.animationDuration||1500;let l=null;const c=i=>{l||(l=i);const s=i-l;o=Math.min(s/a,1),e.clear(),this.renderProgressChart(e,t,n,o),o<1&&requestAnimationFrame(c)};requestAnimationFrame(c)},renderProgressChart(e,t,n,i){var s;const{ctx:r}=e,{width:o,height:a}=e.getSize(),l=o/2,c=a/2,d=Math.min(o,a)/2*.8,h=n.lineWidth||20,u=(null==(s=t[0])?void 0:s.value)||0,p=n.maxValue||100,m=u/p*i;r.strokeStyle=n.backgroundColor||"rgba(200, 200, 200, 0.3)",r.lineWidth=h,r.beginPath(),r.arc(l,c,d,0,2*Math.PI),r.stroke(),r.strokeStyle=n.color||"rgba(100, 150, 255, 0.8)",r.lineCap="round",r.beginPath(),r.arc(l,c,d,-Math.PI/2,-Math.PI/2+m/p*Math.PI*2),r.stroke(),!1!==n.showText&&(r.fillStyle=n.textColor||"#333",r.font=n.font||"bold 24px Arial",r.textAlign="center",r.textBaseline="middle",r.fillText(Math.round(m)+"%",l,c))},getDefaultColor(e){const t=["rgba(100, 150, 255, 0.8)","rgba(255, 100, 150, 0.8)","rgba(150, 255, 100, 0.8)","rgba(255, 200, 100, 0.8)","rgba(200, 100, 255, 0.8)","rgba(100, 255, 200, 0.8)"];return t[e%t.length]}},ne={name:"canvas-animations",init(e={},t=null){return d.info("[CanvasAnimations] Module initialized"),this.initializeCanvasElements(),this},initializeCanvasElements(){const e=document.querySelectorAll("canvas[data-canvas-type]");e.forEach(e=>{this.initElement(e)}),d.info(`[CanvasAnimations] Initialized ${e.length} canvas elements`)},initElement(e,t={}){const n=e.dataset.canvasType,i=this.parseCanvasConfig(e);switch(d.info(`[CanvasAnimations] Initializing canvas type: ${n}`),n){case"interactive":ee.init(e,i);break;case"scroll-parallax":Z.initParallax(e,i);break;case"scroll-animation":Z.initScrollAnimation(e,i);break;case"data-viz":te.init(e,i);break;case"background":this.initBackgroundAnimation(e,i);break;default:d.warn(`[CanvasAnimations] Unknown canvas type: ${n}`)}},parseCanvasConfig(e){const t={};return Object.keys(e.dataset).forEach(n=>{if(n.startsWith("canvas")){const s=n.replace("canvas","").toLowerCase();let r=e.dataset[n];if(r.startsWith("{")&&r.endsWith("}")||r.startsWith("[")&&r.endsWith("]"))try{r=JSON.parse(r)}catch(i){d.warn(`[CanvasAnimations] Failed to parse JSON config: ${n}`,i)}else"true"===r?r=!0:"false"===r?r=!1:isNaN(r)||""===r||(r=parseFloat(r));t[s]=r}}),t},initBackgroundAnimation(e,t){const n=new Y(e),i=t.particles||50,s=[];for(let r=0;r<i;r++)s.push({x:Math.random()*e.width,y:Math.random()*e.height,vx:.5*(Math.random()-.5),vy:.5*(Math.random()-.5),size:3*Math.random()+1,opacity:.5*Math.random()+.2});!function i(){n.clear(),n.ctx.fillStyle=t.color||"rgba(100, 150, 255, 0.6)",s.forEach(t=>{t.x+=t.vx,t.y+=t.vy,t.x<0&&(t.x=e.width),t.x>e.width&&(t.x=0),t.y<0&&(t.y=e.height),t.y>e.height&&(t.y=0),n.ctx.save(),n.ctx.globalAlpha=t.opacity,n.ctx.beginPath(),n.ctx.arc(t.x,t.y,t.size,0,2*Math.PI),n.ctx.fill(),n.ctx.restore()}),requestAnimationFrame(i)}()}},ie=ne.init.bind(ne),se=Object.freeze(Object.defineProperty({__proto__:null,default:ne,init:ie},Symbol.toStringTag,{value:"Module"}));class re{constructor(e={}){this.config={endpoint:e.endpoint||"/api/errors",enabled:e.enabled??!0,sampleRate:e.sampleRate??1,maxErrors:e.maxErrors||100,groupingWindow:e.groupingWindow||6e4,includeStack:e.includeStack??!0,includeContext:e.includeContext??!0,includeUserAgent:e.includeUserAgent??!0,includeUrl:e.includeUrl??!0,filters:e.filters||[],beforeSend:e.beforeSend||null,...e},this.errors=[],this.errorGroups=new Map,this.reportQueue=[],this.isReporting=!1,this.config.enabled&&this.init(),d.info("[ErrorTracker] Initialized",{enabled:this.config.enabled,endpoint:this.config.endpoint,sampleRate:this.config.sampleRate})}static create(e={}){return new re(e)}init(){window.addEventListener("error",e=>{this.captureException(e.error||new Error(e.message),{type:"unhandled",filename:e.filename,lineno:e.lineno,colno:e.colno})}),window.addEventListener("unhandledrejection",e=>{this.captureException(e.reason,{type:"unhandledrejection"})}),this.startReporting()}captureException(e,t={}){if(!this.config.enabled)return;if(Math.random()>this.config.sampleRate)return void d.debug("[ErrorTracker] Error sampled out");if(this.shouldFilter(e,t))return void d.debug("[ErrorTracker] Error filtered out");const n=this.createErrorData(e,t);if(this.config.beforeSend){const e=this.config.beforeSend(n);if(null===e||!1===e)return;e&&Object.assign(n,e)}this.errors.push(n),this.errors.length>this.config.maxErrors&&this.errors.shift(),this.groupError(n),this.reportQueue.push(n),d.debug("[ErrorTracker] Error captured",n),this.triggerErrorEvent(n)}createErrorData(e,t={}){const n={message:(null==e?void 0:e.message)||String(e),name:(null==e?void 0:e.name)||"Error",stack:this.config.includeStack?this.getStackTrace(e):void 0,timestamp:Date.now(),type:t.type||"error",context:this.config.includeContext?{...t,userAgent:this.config.includeUserAgent?navigator.userAgent:void 0,url:this.config.includeUrl?window.location.href:void 0,referrer:document.referrer||void 0,viewport:{width:window.innerWidth,height:window.innerHeight}}:t};return e&&"object"==typeof e&&Object.keys(e).forEach(t=>{["message","name","stack"].includes(t)||(n[t]=e[t])}),n}getStackTrace(e){if(null==e?void 0:e.stack)return e.stack;try{throw new Error}catch(t){return t.stack||"No stack trace available"}}generateFingerprint(e){const t=e.message||"",n=(e.stack||"").split("\n").slice(0,3).join("\n");return`${e.name}:${t}:${n}`}groupError(e){const t=this.generateFingerprint(e),n=Date.now();this.errorGroups.has(t)||this.errorGroups.set(t,{fingerprint:t,count:0,firstSeen:n,lastSeen:n,errors:[]});const i=this.errorGroups.get(t);i.count++,i.lastSeen=n,i.errors.push(e),i.errors.length>10&&i.errors.shift(),this.cleanupGroups(n)}cleanupGroups(e){const t=e-this.config.groupingWindow;for(const[n,i]of this.errorGroups.entries())i.lastSeen<t&&this.errorGroups.delete(n)}shouldFilter(e,t){for(const n of this.config.filters)if("function"==typeof n){if(!1===n(e,t))return!0}else if(n instanceof RegExp){const t=(null==e?void 0:e.message)||String(e);if(n.test(t))return!0}return!1}startReporting(){setInterval(()=>{this.flushReports()},5e3)}async flushReports(){if(!this.isReporting&&0!==this.reportQueue.length){this.isReporting=!0;try{const e=[...this.reportQueue];if(this.reportQueue=[],0===e.length)return;const t=await fetch(this.config.endpoint,{method:"POST",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest"},body:JSON.stringify({errors:e,errorGroups:Array.from(this.errorGroups.values()).map(e=>({fingerprint:e.fingerprint,count:e.count,firstSeen:e.firstSeen,lastSeen:e.lastSeen}))})});if(!t.ok)throw new Error(`Error reporting failed: ${t.status}`);d.debug("[ErrorTracker] Errors reported",{count:e.length})}catch(e){d.error("[ErrorTracker] Failed to report errors",e)}finally{this.isReporting=!1}}}async report(){await this.flushReports()}getErrorGroups(){return Array.from(this.errorGroups.values())}getErrors(){return[...this.errors]}clearErrors(){this.errors=[],this.errorGroups.clear(),this.reportQueue=[]}triggerErrorEvent(e){const t=new CustomEvent("error-tracker:error",{detail:e,bubbles:!0});window.dispatchEvent(t)}destroy(){this.flushReports(),this.clearErrors(),d.info("[ErrorTracker] Destroyed")}}let oe=null;function ae(e={}){return oe||(oe=re.create(e)),oe}const le={name:"error-tracking",errorTracker:null,init(e={},t=null){return d.info("[ErrorTrackingModule] Module initialized"),this.errorTracker=ae(e),"undefined"!=typeof window&&(window.ErrorTracker=this.errorTracker),this},getErrorTracker(){return this.errorTracker||ae()},captureException(e,t={}){this.getErrorTracker().captureException(e,t)},destroy(){this.errorTracker&&(this.errorTracker.destroy(),this.errorTracker=null),"undefined"!=typeof window&&window.ErrorTracker&&delete window.ErrorTracker,d.info("[ErrorTrackingModule] Module destroyed")}},ce=le.init.bind(le),de=Object.freeze(Object.defineProperty({__proto__:null,ErrorTracker:re,default:le,getGlobalErrorTracker:ae,init:ce},Symbol.toStringTag,{value:"Module"}));class he{constructor(e={}){this.config={enableHistory:e.enableHistory??!1,maxHistorySize:e.maxHistorySize||100,enableWildcards:e.enableWildcards??!0,...e},this.subscribers=new Map,this.history=[],this.middleware=[],d.info("[EventBus] Initialized",{enableHistory:this.config.enableHistory,enableWildcards:this.config.enableWildcards})}static create(e={}){return new he(e)}on(e,t,n={}){if("function"!=typeof t)throw new Error("Callback must be a function");this.subscribers.has(e)||this.subscribers.set(e,new Set);const i={callback:t,once:n.once??!1,priority:n.priority||0,filter:n.filter||null};this.subscribers.get(e).add(i);const s=Array.from(this.subscribers.get(e));return s.sort((e,t)=>t.priority-e.priority),this.subscribers.set(e,new Set(s)),()=>{const t=this.subscribers.get(e);t&&(t.delete(i),0===t.size&&this.subscribers.delete(e))}}once(e,t,n={}){return this.on(e,t,{...n,once:!0})}off(e,t){if(!this.subscribers.has(e))return;const n=this.subscribers.get(e);for(const i of n)if(i.callback===t){n.delete(i);break}0===n.size&&this.subscribers.delete(e)}emit(e,t=null,n={}){let i=t;for(const r of this.middleware){const t=r(e,i,n);if(null===t||!1===t)return;void 0!==t&&(i=t)}this.config.enableHistory&&this.addToHistory(e,i,n);const s=this.subscribers.get(e);s&&this.notifySubscribers(s,e,i,n),this.config.enableWildcards&&this.handleWildcards(e,i,n),this.handleNamespacedEvents(e,i,n),d.debug("[EventBus] Event emitted",{eventName:e,data:i})}notifySubscribers(e,t,n,i){const s=Array.from(e);for(const o of s)if(!o.filter||o.filter(n,i)){try{o.callback(n,t,i)}catch(r){d.error("[EventBus] Subscriber error",r)}o.once&&e.delete(o)}}handleWildcards(e,t,n){const i=this.subscribers.get("*");i&&this.notifySubscribers(i,e,t,n);for(const[s,r]of this.subscribers.entries())s.includes("*")&&this.matchesPattern(e,s)&&this.notifySubscribers(r,e,t,n)}handleNamespacedEvents(e,t,n){const i=e.split(":");if(i.length>1){const s=i[0]+":*",r=this.subscribers.get(s);r&&this.notifySubscribers(r,e,t,n)}}matchesPattern(e,t){return new RegExp("^"+t.replace(/\*/g,".*")+"$").test(e)}use(e){if("function"!=typeof e)throw new Error("Middleware must be a function");this.middleware.push(e)}addToHistory(e,t,n){this.history.push({eventName:e,data:t,options:n,timestamp:Date.now()}),this.history.length>this.config.maxHistorySize&&this.history.shift()}getHistory(e=null){return e?"string"==typeof e?this.history.filter(t=>t.eventName===e):"function"==typeof e?this.history.filter(e):[]:[...this.history]}clearHistory(){this.history=[]}getEventNames(){return Array.from(this.subscribers.keys())}getSubscriberCount(e){const t=this.subscribers.get(e);return t?t.size:0}removeAllListeners(e=null){e?this.subscribers.delete(e):this.subscribers.clear()}destroy(){this.subscribers.clear(),this.history=[],this.middleware=[],d.info("[EventBus] Destroyed")}}let ue=null;function pe(e={}){return ue||(ue=he.create(e)),ue}const me={name:"event-bus",eventBus:null,init(e={},t=null){return d.info("[EventBusModule] Module initialized"),this.eventBus=pe(e),"undefined"!=typeof window&&(window.EventBus=this.eventBus),this},getEventBus(){return this.eventBus||pe()},emit(e,t=null,n={}){this.getEventBus().emit(e,t,n)},on(e,t,n={}){return this.getEventBus().on(e,t,n)},off(e,t){this.getEventBus().off(e,t)},destroy(){this.eventBus&&(this.eventBus.destroy(),this.eventBus=null),"undefined"!=typeof window&&window.EventBus&&delete window.EventBus,d.info("[EventBusModule] Module destroyed")}},ge=me.init.bind(me),fe=Object.freeze(Object.defineProperty({__proto__:null,EventBus:he,default:me,getGlobalEventBus:pe,init:ge},Symbol.toStringTag,{value:"Module"}));let ye="example-module",ve=null,be=null;const we=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){d.info("[example-module] destroy"),ve&&(window.removeEventListener("resize",ve),ve=null),c(ye),be&&"function"==typeof be.cleanup&&be.cleanup(),be=null},init:function(e={},t=null){d.info("[example-module] init"),be=t,be&&(be.register("windowSize",{width:window.innerWidth,height:window.innerHeight}),be.register("scrollPosition",{x:0,y:0}),be.register("isVisible",!0)),ve=()=>{const e={width:window.innerWidth,height:window.innerHeight};d.info("Fenstergröße geändert:",e),be&&be.set("windowSize",e)},window.addEventListener("resize",ve),l(ye,()=>{const e=window.scrollY,t=window.scrollX;if(be){const n=be.get("scrollPosition");n.x===t&&n.y===e||be.set("scrollPosition",{x:t,y:e})}},{autoStart:!0})}},Symbol.toStringTag,{value:"Module"}));class Se{constructor(e){this.form=e,this.errors=new Map}static create(e){return new Se(e)}validate(){this.errors.clear();const e=this.form.querySelectorAll("input, textarea, select");for(const t of e)"hidden"===t.type||t.disabled||this.validateField(t);return 0===this.errors.size}validateField(e){const t=e.value,n=e.name;if(e.hasAttribute("required")&&(!t||""===t.trim()))return void this.errors.set(n,this.getErrorMessage(e,"valueMissing")||`${this.getFieldLabel(e)} ist erforderlich`);if(!t||""===t.trim())return;if("email"===e.type&&!this.isValidEmail(t))return void this.errors.set(n,this.getErrorMessage(e,"typeMismatch")||"Bitte geben Sie eine gültige E-Mail-Adresse ein");if("url"===e.type&&!this.isValidUrl(t))return void this.errors.set(n,this.getErrorMessage(e,"typeMismatch")||"Bitte geben Sie eine gültige URL ein");const i=e.getAttribute("minlength");if(i&&t.length<parseInt(i))return void this.errors.set(n,this.getErrorMessage(e,"tooShort")||`Mindestens ${i} Zeichen erforderlich`);const s=e.getAttribute("maxlength");if(s&&t.length>parseInt(s))return void this.errors.set(n,this.getErrorMessage(e,"tooLong")||`Maximal ${s} Zeichen erlaubt`);if("number"===e.type){const i=e.getAttribute("min"),s=e.getAttribute("max"),r=parseFloat(t);if(i&&r<parseFloat(i))return void this.errors.set(n,this.getErrorMessage(e,"rangeUnderflow")||`Wert muss mindestens ${i} sein`);if(s&&r>parseFloat(s))return void this.errors.set(n,this.getErrorMessage(e,"rangeOverflow")||`Wert darf maximal ${s} sein`)}const r=e.getAttribute("pattern");if(r){if(!new RegExp(r).test(t))return void this.errors.set(n,this.getErrorMessage(e,"patternMismatch")||"Ungültiges Format")}const o=e.getAttribute("data-validate");if(o){const i=this.runCustomValidation(o,t,e);if(!i.valid)return void this.errors.set(n,i.message)}}runCustomValidation(e,t,n){switch(e){case"phone":return{valid:/^[\+]?[0-9\s\-\(\)]{10,}$/.test(t),message:"Bitte geben Sie eine gültige Telefonnummer ein"};case"postal-code-de":return{valid:/^[0-9]{5}$/.test(t),message:"Bitte geben Sie eine gültige Postleitzahl ein"};case"no-html":return{valid:!/<[^>]*>/g.test(t),message:"HTML-Code ist nicht erlaubt"};default:return d.warn(`Unknown custom validation: ${e}`),{valid:!0,message:""}}}isValidEmail(e){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)}isValidUrl(e){try{return new URL(e),!0}catch{return!1}}getFieldLabel(e){const t=this.form.querySelector(`label[for="${e.id}"]`)||this.form.querySelector(`label:has([name="${e.name}"])`);return t?t.textContent.trim().replace(":",""):e.name}getErrorMessage(e,t){return e.getAttribute(`data-error-${t}`)||e.getAttribute("data-error")}getErrors(){return Object.fromEntries(this.errors)}getFieldError(e){return this.errors.get(e)}hasErrors(){return this.errors.size>0}clearErrors(){this.errors.clear()}validateWithHTML5(){const e=this.form.checkValidity();if(!e){const e=this.form.querySelectorAll("input, textarea, select");for(const t of e)t.validity.valid||this.errors.set(t.name,t.validationMessage)}return e}}class Ce{constructor(e){this.form=e,this.pristineValues=new Map,this.touchedFields=new Set,this.dirtyFields=new Set,this.init()}static create(e){return new Ce(e)}init(){this.captureInitialValues(),this.bindEvents(),d.info(`[FormState] Initialized for form: ${this.form.id||"unnamed"}`)}captureInitialValues(){this.form.querySelectorAll("input, textarea, select").forEach(e=>{let t;switch(e.type){case"checkbox":case"radio":t=e.checked;break;default:t=e.value}this.pristineValues.set(e.name,t)})}bindEvents(){this.form.querySelectorAll("input, textarea, select").forEach(e=>{"hidden"!==e.type&&(e.addEventListener("focus",()=>{this.markAsTouched(e.name)}),e.addEventListener("input",()=>{this.checkDirtyState(e)}),e.addEventListener("change",()=>{this.checkDirtyState(e)}))})}markAsTouched(e){this.touchedFields.add(e),this.updateFormClasses()}checkDirtyState(e){const t=e.name;this.getFieldValue(e)!==this.pristineValues.get(t)?this.dirtyFields.add(t):this.dirtyFields.delete(t),this.updateFormClasses()}getFieldValue(e){switch(e.type){case"checkbox":case"radio":return e.checked;default:return e.value}}updateFormClasses(){this.isDirty()?(this.form.classList.add("form-dirty"),this.form.classList.remove("form-pristine")):(this.form.classList.add("form-pristine"),this.form.classList.remove("form-dirty")),this.hasTouchedFields()?this.form.classList.add("form-touched"):this.form.classList.remove("form-touched")}isPristine(){return 0===this.dirtyFields.size}isDirty(){return this.dirtyFields.size>0}hasTouchedFields(){return this.touchedFields.size>0}isFieldTouched(e){return this.touchedFields.has(e)}isFieldDirty(e){return this.dirtyFields.has(e)}isFieldPristine(e){return!this.dirtyFields.has(e)}getFieldState(e){return{pristine:this.isFieldPristine(e),dirty:this.isFieldDirty(e),touched:this.isFieldTouched(e),pristineValue:this.pristineValues.get(e),currentValue:this.getCurrentFieldValue(e)}}getCurrentFieldValue(e){const t=this.form.querySelector(`[name="${e}"]`);return t?this.getFieldValue(t):void 0}getFormState(){return{pristine:this.isPristine(),dirty:this.isDirty(),touched:this.hasTouchedFields(),dirtyFields:Array.from(this.dirtyFields),touchedFields:Array.from(this.touchedFields),totalFields:this.pristineValues.size}}reset(){this.touchedFields.clear(),this.dirtyFields.clear(),setTimeout(()=>{this.captureInitialValues(),this.updateFormClasses()},0),d.info("[FormState] State reset")}resetField(e){this.touchedFields.delete(e),this.dirtyFields.delete(e);const t=this.form.querySelector(`[name="${e}"]`),n=this.pristineValues.get(e);if(t&&void 0!==n)switch(t.type){case"checkbox":case"radio":t.checked=n;break;default:t.value=n}this.updateFormClasses(),d.info(`[FormState] Field "${e}" reset to pristine state`)}triggerStateEvent(e,t={}){const n=new CustomEvent(e,{detail:{...t,formState:this.getFormState()},bubbles:!0,cancelable:!0});this.form.dispatchEvent(n)}hasChanges(){return this.isDirty()}getChangedFields(){const e={};return this.dirtyFields.forEach(t=>{e[t]={pristineValue:this.pristineValues.get(t),currentValue:this.getCurrentFieldValue(t)}}),e}enableUnsavedChangesWarning(){window.addEventListener("beforeunload",e=>{if(this.isDirty())return e.preventDefault(),e.returnValue="Sie haben ungespeicherte Änderungen. Möchten Sie die Seite wirklich verlassen?",e.returnValue})}destroy(){this.pristineValues.clear(),this.touchedFields.clear(),this.dirtyFields.clear(),d.info("[FormState] Destroyed")}}class Me{constructor(e,t={}){this.form=e,this.options={validateOnSubmit:!0,validateOnBlur:!1,validateOnInput:!1,showInlineErrors:!0,preventSubmitOnError:!0,submitMethod:"POST",ajaxSubmit:!0,enableAutosave:t.enableAutosave??e.hasAttribute("data-autosave"),autosaveInterval:t.autosaveInterval||3e4,autosaveRetentionPeriod:t.autosaveRetentionPeriod||864e5,autosaveStorageKey:t.autosaveStorageKey||null,autosaveStoragePrefix:t.autosaveStoragePrefix||"form_draft_",autosaveVisualFeedback:t.autosaveVisualFeedback??!0,autosaveExcludeFields:t.autosaveExcludeFields||['input[type="password"]','input[type="hidden"][name="_token"]','input[type="hidden"][name="_form_id"]','input[name*="password"]','input[name*="confirm"]','input[name*="honeypot"]'],autosaveImmediateFields:t.autosaveImmediateFields||["textarea",'input[type="email"]','input[type="text"]',"select"],...t},this.validator=Se.create(e),this.state=Ce.create(e),this.isSubmitting=!1,this.autosaveTimer=null,this.lastAutosaveTime=null,this.autosaveStorageKey=null,this.init()}static create(e,t={}){return new Me(e,t)}init(){this.bindEvents(),this.setupErrorDisplay(),this.options.enableAutosave&&this.initAutosave(),this.form.setAttribute("data-enhanced","true"),d.info(`[FormHandler] Initialized for form: ${this.form.id||"unnamed"}`)}bindEvents(){if(this.form.addEventListener("submit",e=>this.handleSubmit(e)),this.options.validateOnBlur||this.options.validateOnInput){this.form.querySelectorAll("input, textarea, select").forEach(e=>{this.options.validateOnBlur&&e.addEventListener("blur",()=>this.validateSingleField(e)),this.options.validateOnInput&&e.addEventListener("input",()=>this.validateSingleField(e))})}this.options.enableAutosave&&(this.form.addEventListener("input",e=>this.onAutosaveFieldChange(e)),this.form.addEventListener("change",e=>this.onAutosaveFieldChange(e)),window.addEventListener("beforeunload",()=>{this.state.isDirty()&&this.saveAutosaveDraft()}),document.addEventListener("visibilitychange",()=>{document.hidden&&this.state.isDirty()&&this.saveAutosaveDraft()}))}async handleSubmit(e){if(this.isSubmitting)e.preventDefault();else{if(this.options.validateOnSubmit){if(!this.validator.validate())return e.preventDefault(),void this.displayErrors()}this.options.ajaxSubmit&&(e.preventDefault(),await this.submitViaAjax())}}async submitViaAjax(){try{this.setSubmitState(!0),this.clearErrors();const e=new FormData(this.form),t=this.form.action||window.location.href,n=this.form.method||this.options.submitMethod,i=await fetch(t,{method:n.toUpperCase(),body:e,headers:{"X-Requested-With":"XMLHttpRequest"}}),s=await this.parseResponse(i);i.ok?this.handleSuccess(s):this.handleError(s)}catch(e){d.error("[FormHandler] Submit error:",e),this.handleError({message:"Ein Fehler ist aufgetreten. Bitte versuchen Sie es erneut.",errors:{}})}finally{this.setSubmitState(!1)}}async parseResponse(e){const t=e.headers.get("content-type");if(null==t?void 0:t.includes("application/json"))return await e.json();const n=await e.text();try{return JSON.parse(n)}catch{return{message:n}}}handleSuccess(e){d.info("[FormHandler] Form submitted successfully"),this.options.enableAutosave&&this.clearAutosaveDraft(),!1!==e.clearForm&&(this.form.reset(),this.state.reset()),this.showMessage(e.message||"Formular erfolgreich gesendet!","success"),this.triggerEvent("form:success",{data:e})}handleError(e){if(d.warn("[FormHandler] Form submission error:",e),e.errors&&"object"==typeof e.errors){for(const[t,n]of Object.entries(e.errors))this.validator.errors.set(t,n);this.displayErrors()}this.showMessage(e.message||"Ein Fehler ist aufgetreten.","error"),this.triggerEvent("form:error",{data:e})}validateSingleField(e){this.validator.errors.delete(e.name),this.validator.validateField(e),this.displayFieldError(e)}displayErrors(){if(!this.options.showInlineErrors)return;const e=this.validator.getErrors();for(const[t,n]of Object.entries(e)){const e=this.form.querySelector(`[name="${t}"]`);e&&this.displayFieldError(e,n)}}displayFieldError(e,t=null){const n=t||this.validator.getFieldError(e.name),i=this.getOrCreateErrorElement(e);n?(i.textContent=n,i.style.display="block",e.classList.add("error"),e.setAttribute("aria-invalid","true"),e.setAttribute("aria-describedby",i.id)):(i.textContent="",i.style.display="none",e.classList.remove("error"),e.removeAttribute("aria-invalid"),e.removeAttribute("aria-describedby"))}getOrCreateErrorElement(e){const t=`error-${e.name}`;let n=document.getElementById(t);if(!n){n=document.createElement("div"),n.id=t,n.className="form-error",n.setAttribute("role","alert"),n.style.display="none";(e.closest(".form-group")||e.parentElement).appendChild(n)}return n}setupErrorDisplay(){if(!document.getElementById("form-handler-styles")){const e=document.createElement("style");e.id="form-handler-styles",e.textContent="\n                .form-error {\n                    color: #dc2626;\n                    font-size: 0.875rem;\n                    margin-top: 0.25rem;\n                }\n                input.error, textarea.error, select.error {\n                    border-color: #dc2626;\n                    box-shadow: 0 0 0 1px #dc2626;\n                }\n                .form-message {\n                    padding: 0.75rem;\n                    border-radius: 0.375rem;\n                    margin: 1rem 0;\n                }\n                .form-message.success {\n                    background-color: #dcfce7;\n                    color: #166534;\n                    border: 1px solid #bbf7d0;\n                }\n                .form-message.error {\n                    background-color: #fef2f2;\n                    color: #dc2626;\n                    border: 1px solid #fecaca;\n                }\n            ",document.head.appendChild(e)}}showMessage(e,t="info"){let n=this.form.querySelector(".form-messages");n||(n=document.createElement("div"),n.className="form-messages",this.form.prepend(n));const i=document.createElement("div");i.className=`form-message ${t}`,i.textContent=e,i.setAttribute("role","error"===t?"alert":"status"),n.innerHTML="",n.appendChild(i),"success"===t&&setTimeout(()=>{i.parentElement&&i.remove()},5e3)}clearErrors(){this.validator.clearErrors();this.form.querySelectorAll(".error").forEach(e=>{e.classList.remove("error"),e.removeAttribute("aria-invalid"),e.removeAttribute("aria-describedby")});this.form.querySelectorAll(".form-error").forEach(e=>{e.style.display="none",e.textContent=""});const e=this.form.querySelector(".form-messages");e&&(e.innerHTML="")}setSubmitState(e){this.isSubmitting=e;this.form.querySelectorAll('button[type="submit"], input[type="submit"]').forEach(t=>{if(t.disabled=e,e)t.setAttribute("data-original-text",t.textContent),t.textContent="Wird gesendet...";else{const e=t.getAttribute("data-original-text");e&&(t.textContent=e,t.removeAttribute("data-original-text"))}})}triggerEvent(e,t={}){const n=new CustomEvent(e,{detail:t,bubbles:!0,cancelable:!0});this.form.dispatchEvent(n)}initAutosave(){this.autosaveStorageKey=this.options.autosaveStorageKey||this.options.autosaveStoragePrefix+this.generateFormId(),this.restoreAutosaveDraft(),this.startAutosave(),d.info("[FormHandler] Autosave initialized",{storageKey:this.autosaveStorageKey})}generateFormId(){var e;return(this.form.id||this.form.getAttribute("data-form-id")||(null==(e=this.form.querySelector('input[name="_form_id"]'))?void 0:e.value)||"form_"+Date.now()).replace(/[^a-zA-Z0-9_-]/g,"_")}onAutosaveFieldChange(e){const t=e.target;this.isAutosaveFieldExcluded(t)||this.isAutosaveImmediateField(t)&&this.saveAutosaveDraft()}isAutosaveFieldExcluded(e){return this.options.autosaveExcludeFields.some(t=>e.matches(t))}isAutosaveImmediateField(e){return this.options.autosaveImmediateFields.some(t=>e.matches(t))}startAutosave(){this.autosaveTimer||(this.autosaveTimer=setInterval(()=>{this.state.isDirty()&&this.saveAutosaveDraft()},this.options.autosaveInterval),d.debug("[FormHandler] Autosave started",{interval:this.options.autosaveInterval}))}stopAutosave(){this.autosaveTimer&&(clearInterval(this.autosaveTimer),this.autosaveTimer=null)}saveAutosaveDraft(){if(this.form&&this.state.isDirty())try{const e=this.extractAutosaveFormData(),t={data:e,timestamp:Date.now(),formId:this.generateFormId(),url:window.location.href,version:"1.0"};localStorage.setItem(this.autosaveStorageKey,JSON.stringify(t)),this.lastAutosaveTime=new Date,d.debug("[FormHandler] Draft saved",{fields:Object.keys(e).length,storageKey:this.autosaveStorageKey}),this.options.autosaveVisualFeedback&&this.showAutosaveStatus("Draft saved","success",1500),this.triggerEvent("form:autosave",{draft:t})}catch(e){d.error("[FormHandler] Failed to save draft",e),this.options.autosaveVisualFeedback&&this.showAutosaveStatus("Failed to save draft","error",3e3)}}restoreAutosaveDraft(){try{const e=localStorage.getItem(this.autosaveStorageKey);if(!e)return;const t=JSON.parse(e),n=Date.now()-t.timestamp;if(n>this.options.autosaveRetentionPeriod)return void localStorage.removeItem(this.autosaveStorageKey);if(this.restoreAutosaveFormData(t.data),d.info("[FormHandler] Draft restored",{age:Math.floor(n/1e3)+"s",fields:Object.keys(t.data).length}),this.options.autosaveVisualFeedback){const e=this.formatDuration(n);this.showAutosaveStatus(`Draft restored from ${e} ago`,"info",4e3)}this.triggerEvent("form:autosave-restored",{draft:t})}catch(e){d.error("[FormHandler] Failed to restore draft",e),localStorage.removeItem(this.autosaveStorageKey)}}extractAutosaveFormData(){const e=this.getFormFields(),t={};return e.forEach(e=>{if(!this.isAutosaveFieldExcluded(e)){const n=e.name||e.id,i=this.getAutosaveFieldValue(e);n&&null!=i&&""!==i&&(t[n]=i)}}),t}restoreAutosaveFormData(e){let t=0;return Object.entries(e).forEach(([e,n])=>{const i=this.form.querySelector(`[name="${e}"], #${e}`);i&&!this.isAutosaveFieldExcluded(i)&&(this.setAutosaveFieldValue(i,n),t++)}),this.state.captureInitialValues(),t}getFormFields(){return Array.from(this.form.querySelectorAll('input:not([type="submit"]):not([type="button"]):not([type="reset"]), textarea, select'))}getAutosaveFieldValue(e){switch(e.type){case"checkbox":return e.checked;case"radio":return e.checked?e.value:null;case"file":return null;default:return e.value}}setAutosaveFieldValue(e,t){switch(e.type){case"checkbox":e.checked=Boolean(t);break;case"radio":e.checked=e.value===t;break;case"file":break;default:e.value=t}}clearAutosaveDraft(){this.autosaveStorageKey&&localStorage.removeItem(this.autosaveStorageKey),d.debug("[FormHandler] Draft cleared")}formatDuration(e){const t=Math.floor(e/1e3),n=Math.floor(t/60),i=Math.floor(n/60);return i>0?`${i}h ${n%60}m`:n>0?`${n}m`:`${t}s`}showAutosaveStatus(e,t="info",n=3e3){let i=document.getElementById("form-autosave-status");i||(i=document.createElement("div"),i.id="form-autosave-status",i.style.cssText="\n                position: fixed;\n                bottom: 20px;\n                right: 20px;\n                padding: 8px 12px;\n                border-radius: 4px;\n                font-size: 12px;\n                z-index: 9999;\n                max-width: 250px;\n                box-shadow: 0 2px 8px rgba(0,0,0,0.1);\n                transition: opacity 0.3s ease;\n                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n            ",document.body.appendChild(i)),i.textContent=e;const s={info:"background: #e3f2fd; color: #1565c0; border: 1px solid #bbdefb;",success:"background: #e8f5e8; color: #2e7d32; border: 1px solid #c8e6c9;",error:"background: #ffebee; color: #c62828; border: 1px solid #ffcdd2;"};i.style.cssText+=s[t]||s.info,i.style.opacity="1",setTimeout(()=>{i&&(i.style.opacity="0",setTimeout(()=>{i&&i.parentNode&&i.parentNode.removeChild(i)},300))},n)}destroy(){this.options.enableAutosave&&this.stopAutosave(),this.form.removeAttribute("data-enhanced"),d.info("[FormHandler] Destroyed")}}const ke={name:"form-handling",init(e={},t=null){return d.info("[FormHandling] Module initialized (ready for DOM elements)"),this},initElement(e,t={}){d.info(`[FormHandling] Initializing on form: ${e.id||"unnamed"}`);const n={validateOnSubmit:!0,validateOnBlur:!1,validateOnInput:!1,showInlineErrors:!0,preventSubmitOnError:!0,ajaxSubmit:!0,submitMethod:"POST",enableStateTracking:!0,enableUnsavedWarning:!1,...t},i=Me.create(e,n);e._formHandler=i,e._formValidator=i.validator,e._formState=i.state,n.enableUnsavedWarning&&i.state.enableUnsavedChangesWarning(),e.classList.add("form-enhanced");const s=new CustomEvent("form:initialized",{detail:{handler:i,validator:i.validator,state:i.state,config:n},bubbles:!0});return e.dispatchEvent(s),d.info(`[FormHandling] Successfully initialized for form: ${e.id||"unnamed"}`),i},destroyElement(e){e._formHandler&&(e._formHandler.destroy(),delete e._formHandler,delete e._formValidator,delete e._formState),e.classList.remove("form-enhanced"),e.removeAttribute("data-enhanced"),d.info(`[FormHandling] Destroyed for form: ${e.id||"unnamed"}`)},destroy(){d.info("[FormHandling] Module destroyed")}},Ee=ke.init.bind(ke),xe=ke.initElement.bind(ke),Ae=Object.freeze(Object.defineProperty({__proto__:null,FormHandler:Me,FormHandlingModule:ke,FormState:Ce,FormValidator:Se,default:ke,init:Ee,initElement:xe},Symbol.toStringTag,{value:"Module"})),Te={name:"image-manager",activeGalleries:new Map,activeUploaders:new Map,async init(e={},t){return d.info("[ImageManager] Module initialized"),this.initializeGalleries(),this.initializeUploaders(),this.initializeModal(),this},initializeGalleries(){const e=document.querySelectorAll("[data-image-gallery]");d.info(`[ImageManager] Found ${e.length} gallery elements`),e.forEach((e,t)=>{const n=`gallery-${t}`,i=new Ie(e,{listEndpoint:e.dataset.listEndpoint||"/api/images",pageSize:parseInt(e.dataset.pageSize)||20,columns:parseInt(e.dataset.columns)||4});this.activeGalleries.set(n,i),d.info(`[ImageManager] Initialized gallery: ${n}`)})},initializeUploaders(){const e=document.querySelectorAll("[data-image-uploader]");d.info(`[ImageManager] Found ${e.length} uploader elements`),e.forEach((e,t)=>{var n;const i=`uploader-${t}`,s=new Pe(e,{uploadUrl:e.dataset.uploadUrl||"/api/images",maxFileSize:parseInt(e.dataset.maxFileSize)||10485760,allowedTypes:(null==(n=e.dataset.allowedTypes)?void 0:n.split(","))||["image/jpeg","image/png","image/gif","image/webp"],maxFiles:parseInt(e.dataset.maxFiles)||10});this.activeUploaders.set(i,s),d.info(`[ImageManager] Initialized uploader: ${i}`)})},initializeModal(){const e=new Le;window.ImageModal=e,d.info("[ImageManager] Modal initialized")},destroy(){this.activeGalleries.forEach((e,t)=>{e.destroy(),d.info(`[ImageManager] Destroyed gallery: ${t}`)}),this.activeGalleries.clear(),this.activeUploaders.forEach((e,t)=>{e.destroy(),d.info(`[ImageManager] Destroyed uploader: ${t}`)}),this.activeUploaders.clear(),window.ImageModal&&(window.ImageModal.destroy(),delete window.ImageModal),d.info("[ImageManager] Module destroyed")}};class Ie{constructor(e,t){this.element=e,this.config=t,this.currentPage=1,this.images=[],this.loading=!1,this.init()}async init(){d.info("[ImageGallery] Initializing gallery"),this.element.innerHTML="",this.buildGalleryUI(),await this.loadImages()}buildGalleryUI(){this.element.innerHTML=`\n            <div class="image-gallery">\n                <div class="gallery__controls">\n                    <div class="gallery__search-wrapper">\n                        <input type="text" class="gallery__search" placeholder="Search images...">\n                        <button type="button" class="gallery__search-clear">&times;</button>\n                    </div>\n                    <div class="gallery__sort-wrapper">\n                        <label>Sort:</label>\n                        <select class="gallery__sort">\n                            <option value="created_desc">Newest First</option>\n                            <option value="created_asc">Oldest First</option>\n                            <option value="name_asc">Name A-Z</option>\n                            <option value="name_desc">Name Z-A</option>\n                        </select>\n                    </div>\n                </div>\n                <div class="gallery__grid" style="--columns: ${this.config.columns}"></div>\n                <div class="gallery__pagination">\n                    <button type="button" class="gallery__load-more" style="display: none;">Load More</button>\n                </div>\n                <div class="gallery__loading">\n                    <div class="loading-spinner"></div>\n                    <p>Loading images...</p>\n                </div>\n            </div>\n        `,this.setupEventListeners()}setupEventListeners(){const e=this.element.querySelector(".gallery__search"),t=this.element.querySelector(".gallery__search-clear"),n=this.element.querySelector(".gallery__sort"),i=this.element.querySelector(".gallery__load-more");let s;e.addEventListener("input",e=>{clearTimeout(s),s=setTimeout(()=>{this.searchImages(e.target.value)},300)}),t.addEventListener("click",()=>{e.value="",this.searchImages("")}),n.addEventListener("change",e=>{this.sortImages(e.target.value)}),i.addEventListener("click",()=>{this.loadMoreImages()})}async loadImages(){if(!this.loading){this.loading=!0,this.showLoading();try{d.info("[ImageGallery] Loading images from:",this.config.listEndpoint);const e=await fetch(`${this.config.listEndpoint}?page=${this.currentPage}&limit=${this.config.pageSize}`);if(!e.ok)throw new Error(`HTTP ${e.status}: ${e.statusText}`);const t=await e.json();d.info("[ImageGallery] API Response:",t);let n=[],i={};t.data&&Array.isArray(t.data)?(n=t.data,i=t.meta||{}):t.images&&Array.isArray(t.images)?(n=t.images,i=t):Array.isArray(t)?(n=t,i={}):(d.warn("[ImageGallery] Unexpected API response format:",t),n=[],i={}),d.info("[ImageGallery] Processed images:",n.length),1===this.currentPage?this.images=n:this.images=[...this.images,...n],this.renderImages(),this.updateLoadMoreButton(i)}catch(e){d.error("[ImageGallery] Failed to load images:",e),this.showError(`Failed to load images: ${e.message}`)}finally{this.loading=!1,this.hideLoading()}}}renderImages(){const e=this.element.querySelector(".gallery__grid");0!==this.images.length?(e.innerHTML=this.images.map(e=>this.renderImageItem(e)).join(""),e.querySelectorAll(".gallery__item").forEach((e,t)=>{e.addEventListener("click",()=>{this.showImageModal(this.images[t])})})):e.innerHTML='\n                <div class="gallery__empty">\n                    <div class="empty-state__icon">\n                        <svg width="48" height="48" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1">\n                            <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>\n                            <circle cx="8.5" cy="8.5" r="1.5"></circle>\n                            <polyline points="21,15 16,10 5,21"></polyline>\n                        </svg>\n                    </div>\n                    <h3>No images found</h3>\n                    <p>Upload some images to get started</p>\n                </div>\n            '}renderImageItem(e){let t="0 B",n="0 × 0";return e.file_size&&("object"==typeof e.file_size&&e.file_size.bytes?t=this.formatFileSize(e.file_size.bytes):"number"==typeof e.file_size&&(t=this.formatFileSize(e.file_size))),e.dimensions&&e.dimensions.width&&e.dimensions.height?n=`${e.dimensions.width} × ${e.dimensions.height}`:e.width&&e.height&&(n=`${e.width} × ${e.height}`),`\n            <div class="gallery__item" data-image-id="${e.ulid}">\n                <div class="gallery__item-inner">\n                    <div class="gallery__item-image">\n                        <img src="${e.url}" alt="${e.alt_text||e.filename}" loading="lazy">\n                        <div class="gallery__item-overlay">\n                            <div class="gallery__item-actions">\n                                <button type="button" class="action-btn" title="View Details">👁</button>\n                                <button type="button" class="action-btn" title="Edit">✏️</button>\n                                <button type="button" class="action-btn" title="Delete">🗑</button>\n                            </div>\n                        </div>\n                    </div>\n                    <div class="gallery__item-info">\n                        <div class="gallery__item-name" title="${e.original_filename||e.filename}">\n                            ${e.original_filename||e.filename}\n                        </div>\n                        <div class="gallery__item-meta">\n                            <span class="meta-item">${n}</span>\n                            <span class="meta-item">${t}</span>\n                            <span class="meta-item">${(e.mime_type||"").replace("image/","")}</span>\n                        </div>\n                    </div>\n                </div>\n            </div>\n        `}showImageModal(e){window.ImageModal&&window.ImageModal.show(e)}formatFileSize(e){if(0===e)return"0 B";const t=Math.floor(Math.log(e)/Math.log(1024));return`${Math.round(e/Math.pow(1024,t)*100)/100} ${["B","KB","MB","GB"][t]}`}showLoading(){const e=this.element.querySelector(".gallery__loading");e&&(e.style.display="flex")}hideLoading(){const e=this.element.querySelector(".gallery__loading");e&&(e.style.display="none")}showError(e){this.element.querySelector(".gallery__grid").innerHTML=`\n            <div class="gallery__error">\n                <div class="error-message">\n                    <span>⚠️</span>\n                    <span>${e}</span>\n                    <button type="button" class="error-close" onclick="this.parentElement.parentElement.remove()">&times;</button>\n                </div>\n            </div>\n        `}updateLoadMoreButton(e){var t;const n=this.element.querySelector(".gallery__load-more");e.has_more||e.hasMore||(null==(t=e.pagination)?void 0:t.hasMore)||!1?(n.style.display="block",n.disabled=!1):n.style.display="none"}async loadMoreImages(){this.currentPage++,await this.loadImages()}searchImages(e){const t=this.images.filter(t=>(t.filename||"").toLowerCase().includes(e.toLowerCase())||(t.original_filename||"").toLowerCase().includes(e.toLowerCase())||(t.alt_text||"").toLowerCase().includes(e.toLowerCase()));this.element.querySelector(".gallery__grid").innerHTML=t.map(e=>this.renderImageItem(e)).join("")}sortImages(e){const t=[...this.images];switch(e){case"created_desc":t.sort((e,t)=>new Date(t.created_at)-new Date(e.created_at));break;case"created_asc":t.sort((e,t)=>new Date(e.created_at)-new Date(t.created_at));break;case"name_asc":t.sort((e,t)=>(e.filename||"").localeCompare(t.filename||""));break;case"name_desc":t.sort((e,t)=>(t.filename||"").localeCompare(e.filename||""))}this.images=t,this.renderImages()}destroy(){this.element.innerHTML="",d.info("[ImageGallery] Gallery destroyed")}}class Pe{constructor(e,t){this.element=e,this.config=t,d.info("[ImageUploader] Uploader placeholder initialized")}destroy(){d.info("[ImageUploader] Uploader destroyed")}}class Le{constructor(){d.info("[ImageModal] Modal placeholder initialized")}show(e){d.info("[ImageModal] Would show modal for image:",e)}destroy(){d.info("[ImageModal] Modal destroyed")}}const $e=Te.init.bind(Te),De=Te.destroy.bind(Te),ze=Object.freeze(Object.defineProperty({__proto__:null,default:Te,definition:{name:"image-manager",version:"1.0.0",dependencies:[],provides:["image-upload","image-gallery","image-modal"],priority:5},destroy:De,init:$e},Symbol.toStringTag,{value:"Module"}));let Re,Oe="inertia-scroll",Fe=0,_e=window.scrollY,Be=!1,Ne=.9,qe=.2;function He(){Be=!0,clearTimeout(Re),Re=setTimeout(()=>{Be=!1},50)}const je=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){window.removeEventListener("scroll",He),c(Oe),Fe=0,_e=window.scrollY,Be=!1,clearTimeout(Re);const e=document.documentElement;delete e.dataset.scrollState,delete e.dataset.scrollDirection,delete e.dataset.scrollSpeed},init:function(e={}){Ne="number"==typeof e.damping?e.damping:.9,qe="number"==typeof e.minVelocity?contig.minVelocity:.1,window.addEventListener("scroll",He,{passive:!0}),l(Oe,()=>{const e=document.documentElement,t=window.scrollY,n=t-_e,i=n>0?"down":n<0?"up":"none",s=Math.abs(n);!Be&&Math.abs(Fe)>qe?(window.scrollTo(0,t+Fe),Fe*=Ne,e.dataset.scrollState="inertia"):Be?(Fe=n,_e=t,e.dataset.scrollState="active"):delete e.dataset.scrollState,e.dataset.scrollDirection=i,e.dataset.scrollSpeed=s.toFixed(2)},{autoStart:!0})}},Symbol.toStringTag,{value:"Module"}));class Ue{constructor({content:e="",className:t="",onClose:n=null}={}){this.onClose=n,this.className=t,this.isOpenState=!1,this.dialog=document.createElement("dialog"),this.dialog.className=t,this.eventCleanup=[],this.updateContent(e),this.bindEvents()}bindEvents(){this.cleanupEvents(),this.clickHandler=e=>{!e.target.closest("."+this.className+"-content")&&this.close()},this.cancelHandler=e=>{e.preventDefault(),this.close()},this.dialog.addEventListener("click",this.clickHandler),this.dialog.addEventListener("cancel",this.cancelHandler),this.eventCleanup=[()=>this.dialog.removeEventListener("click",this.clickHandler),()=>this.dialog.removeEventListener("cancel",this.cancelHandler)]}cleanupEvents(){this.eventCleanup.forEach(e=>e()),this.eventCleanup=[]}updateContent(e){this.dialog.innerHTML=`\n            <form method="dialog" class="${this.className}-content">\n                ${e}\n                <button class="${this.className}-close" value="close">×</button>\n            </form>\n        `}open(){var e,t,n,i;this.dialog.parentElement||document.body.appendChild(this.dialog),(this.dialog.hasAttribute("open")||this.dialog.open)&&((null==(t=(e=this.dialog).close)?void 0:t.call(e))||this.dialog.removeAttribute("open")),(null==(i=(n=this.dialog).showModal)?void 0:i.call(n))||this.dialog.setAttribute("open",""),document.documentElement.dataset[`${this.dialog.className}Open`]="true",this.isOpenState=!0}close(){var e,t,n;this.isOpenState&&((null==(t=(e=this.dialog).close)?void 0:t.call(e))||this.dialog.removeAttribute("open"),delete document.documentElement.dataset[`${this.dialog.className}Open`],this.isOpenState=!1,null==(n=this.onClose)||n.call(this))}isOpen(){const e=this.dialog&&(this.dialog.hasAttribute("open")||this.dialog.open);return e!==this.isOpenState&&(this.isOpenState=e),this.isOpenState}destroy(){this.isOpenState&&this.close(),this.cleanupEvents(),this.dialog.parentElement&&this.dialog.remove()}}const We={modal:class extends Ue{constructor(e){super({...e,className:"modal"})}},lightbox:class extends Ue{constructor(e){super({...e,className:"lightbox"})}}},Ve={},Ge={open(e,t={}){const n=We[e];if(!n)return d.warn(`[UIManager] Unknown type: ${e}`),null;if("lightbox"===e){if(Ve.lightbox)return d.info("[UIManager] Reusing existing lightbox instance"),Ve.lightbox.updateContent(t.content||""),Ve.lightbox.open(),Ve.lightbox;{d.info("[UIManager] Creating new lightbox instance");const e=new n({...t,onClose:()=>{d.info("[UIManager] Lightbox closed, instance kept for reuse"),t.onClose&&t.onClose()}});return Ve.lightbox=e,e.open(),e}}const i=new n(t);return i.open(),i},close(e){(null==e?void 0:e.close)&&e.close()},closeByType(e){Ve[e]&&this.close(Ve[e])},isOpen(e){var t;return(null==(t=Ve[e])?void 0:t.isOpen())||!1},destroyAll(){Object.values(Ve).forEach(e=>{(null==e?void 0:e.destroy)&&e.destroy()}),Object.keys(Ve).forEach(e=>{delete Ve[e]})}};function Je(e){let t=null;if(t="IMG"===e.target.tagName?e.target:e.target.querySelector("img"),!t)return;if("false"===t.dataset.lightbox)return;if(t.naturalWidth<200||t.naturalHeight<200)return;if(t.closest("nav, header, footer, .no-lightbox"))return;e.preventDefault();const n=function(e){if(e.dataset.lightboxSrc)return e.dataset.lightboxSrc;if(e.currentSrc)return e.currentSrc;return e.src}(t),i=t.alt||t.dataset.caption||t.title||"",s=t.closest("picture");let r;if(s){const e=s.cloneNode(!0);e.querySelector("img").className="lightbox-image",r=`\n            <div class="lightbox-content">\n                ${e.outerHTML}\n                ${i?`<div class="lightbox-caption">${i}</div>`:""}\n            </div>\n        `,d.info("[Lightbox] Opening responsive image (picture element):",n)}else r=`\n            <div class="lightbox-content">\n                <img src="${n}" alt="${i}" class="lightbox-image" />\n                ${i?`<div class="lightbox-caption">${i}</div>`:""}\n            </div>\n        `,d.info("[Lightbox] Opening standalone image:",n);const o=Ge.open("lightbox",{content:r});Ge.isOpen("lightbox")&&o&&d.info("[Lightbox] Reused existing lightbox instance")}const Qe=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){d.info("[lightbox-trigger] destroy"),document.querySelectorAll("img.lightbox-enabled").forEach(e=>{e.classList.remove("lightbox-enabled"),e.style.cursor="","Klicken zum Vergrößern"===e.title&&(e.title="")})},init:function(){d.info("[lightbox-trigger] Auto-enabling lightbox for all images (including picture/srcset)"),d.info('[lightbox-trigger] Use data-lightbox="false" to opt-out'),d.info("[lightbox-trigger] Use data-lightbox-src for custom high-res versions"),K(document,"click",Je),function(){const e=document.querySelectorAll('img:not([data-lightbox="false"])');let t=0;e.forEach(e=>{e.naturalWidth<200||e.naturalHeight<200||e.closest("nav, header, footer, .no-lightbox")||(e.classList.add("lightbox-enabled"),e.style.cursor="zoom-in",e.title||e.alt||(e.title="Klicken zum Vergrößern"),t++)}),d.info(`[Lightbox] Enhanced ${t} images with lightbox functionality`)}()}},Symbol.toStringTag,{value:"Module"}));const Xe=new class{patchFragment(e,t,n){const i=e.querySelector(`[data-lc-fragment="${t}"]`);if(!i)return console.warn(`[DomPatcher] Fragment not found: ${t}`),!1;const s=document.createElement("div");s.innerHTML=n;const r=s.firstElementChild;return r?r.getAttribute("data-lc-fragment")!==t?(console.warn(`[DomPatcher] Fragment name mismatch: expected ${t}, got ${r.getAttribute("data-lc-fragment")}`),!1):(this.patchElement(i,r),!0):(console.warn(`[DomPatcher] Invalid HTML for fragment: ${t}`),!1)}patchFragments(e,t){const n={};for(const[i,s]of Object.entries(t))n[i]=this.patchFragment(e,i,s);return n}patchElement(e,t){this.patchAttributes(e,t),this.patchChildren(e,t)}patchAttributes(e,t){const n=new Map,i=new Map;for(const s of e.attributes)n.set(s.name,s.value);for(const s of t.attributes)i.set(s.name,s.value);for(const[s,r]of n)i.has(s)||e.removeAttribute(s);for(const[s,r]of i)n.get(s)!==r&&e.setAttribute(s,r)}patchChildren(e,t){const n=Array.from(e.childNodes),i=Array.from(t.childNodes),s=Math.max(n.length,i.length);for(let r=0;r<s;r++){const t=n[r],s=i[r];!t&&s?e.appendChild(s.cloneNode(!0)):t&&!s?e.removeChild(t):t&&s&&(this.shouldPatch(t,s)?t.nodeType===Node.ELEMENT_NODE?this.patchElement(t,s):t.nodeType===Node.TEXT_NODE&&t.nodeValue!==s.nodeValue&&(t.nodeValue=s.nodeValue):e.replaceChild(s.cloneNode(!0),t))}}shouldPatch(e,t){if(e.nodeType!==t.nodeType)return!1;if(e.nodeType===Node.TEXT_NODE)return!0;if(e.nodeType===Node.ELEMENT_NODE){if(e.tagName!==t.tagName)return!1;const n=e.getAttribute("data-lc-key")||e.getAttribute("id"),i=t.getAttribute("data-lc-key")||t.getAttribute("id");return!n||!i||n===i}return!1}preserveFocus(e){const t=document.activeElement;if(!t||!e.contains(t))return()=>{};const n=this.getElementSelector(t),i=t.selectionStart,s=t.selectionEnd;return()=>{try{if(n){const t=e.querySelector(n);t&&t.focus&&(t.focus(),t.setSelectionRange&&"number"==typeof i&&"number"==typeof s&&t.setSelectionRange(i,s))}}catch(t){console.debug("[DomPatcher] Could not restore focus:",t)}}}getElementSelector(e){if(e.id)return`#${e.id}`;if(e.name)return`[name="${e.name}"]`;const t=e.getAttribute("data-lc-key");return t?`[data-lc-key="${t}"]`:e.tagName.toLowerCase()}},Ke={DISCONNECTED:"disconnected",CONNECTING:"connecting",CONNECTED:"connected",ERROR:"error"};class Ye{constructor(){this.attempt=0,this.baseDelay=1e3,this.maxDelay=3e4,this.maxAttempts=10}getDelay(){const e=Math.min(this.baseDelay*Math.pow(2,this.attempt),this.maxDelay),t=.25*e*(Math.random()-.5);return Math.floor(e+t)}shouldRetry(){return this.attempt<this.maxAttempts}recordAttempt(){this.attempt++}reset(){this.attempt=0}}class Ze{constructor(e=[],t={}){this.channels=e,this.options={autoReconnect:!0,heartbeatTimeout:45e3,...t},this.eventSource=null,this.state=Ke.DISCONNECTED,this.reconnectionStrategy=new Ye,this.reconnectTimer=null,this.heartbeatTimer=null,this.lastHeartbeat=null,this.eventHandlers=new Map,this.stateChangeHandlers=new Set,this.connectionId=null}connect(){if(this.state===Ke.CONNECTING||this.state===Ke.CONNECTED)return void console.warn("[SSE] Already connecting or connected");this.setState(Ke.CONNECTING);const e=this.buildUrl();try{this.eventSource=new EventSource(e),this.eventSource.addEventListener("open",()=>{console.log("[SSE] Connection opened"),this.setState(Ke.CONNECTED),this.reconnectionStrategy.reset(),this.startHeartbeatMonitoring()}),this.eventSource.addEventListener("error",e=>{console.error("[SSE] Connection error",e),this.eventSource.readyState===EventSource.CLOSED&&this.handleDisconnect()}),this.eventSource.addEventListener("connected",e=>{const t=JSON.parse(e.data);this.connectionId=t.connection_id,console.log("[SSE] Connected with ID:",this.connectionId)}),this.eventSource.addEventListener("heartbeat",e=>{this.lastHeartbeat=Date.now()}),this.eventSource.addEventListener("disconnected",()=>{console.log("[SSE] Server initiated disconnect"),this.disconnect()}),this.eventSource.addEventListener("error",e=>{const t=JSON.parse(e.data);console.error("[SSE] Server error:",t)})}catch(t){console.error("[SSE] Failed to create EventSource",t),this.setState(Ke.ERROR),this.scheduleReconnect()}}disconnect(){this.eventSource&&(this.eventSource.close(),this.eventSource=null),this.stopHeartbeatMonitoring(),this.clearReconnectTimer(),this.setState(Ke.DISCONNECTED),this.connectionId=null}handleDisconnect(){this.setState(Ke.ERROR),this.stopHeartbeatMonitoring(),this.options.autoReconnect&&this.reconnectionStrategy.shouldRetry()?this.scheduleReconnect():this.setState(Ke.DISCONNECTED)}scheduleReconnect(){const e=this.reconnectionStrategy.getDelay();console.log(`[SSE] Reconnecting in ${e}ms (attempt ${this.reconnectionStrategy.attempt+1})`),this.reconnectTimer=setTimeout(()=>{this.reconnectionStrategy.recordAttempt(),this.connect()},e)}clearReconnectTimer(){this.reconnectTimer&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null)}startHeartbeatMonitoring(){this.lastHeartbeat=Date.now(),this.heartbeatTimer=setInterval(()=>{Date.now()-this.lastHeartbeat>this.options.heartbeatTimeout&&(console.warn("[SSE] Heartbeat timeout - connection appears dead"),this.handleDisconnect())},5e3)}stopHeartbeatMonitoring(){this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null)}buildUrl(){const e=this.channels.join(",");return`/sse/stream?channels=${encodeURIComponent(e)}`}on(e,t){return this.eventHandlers.has(e)||(this.eventHandlers.set(e,new Set),this.eventSource&&this.eventSource.addEventListener(e,t=>{this.handleEvent(e,t)})),this.eventHandlers.get(e).add(t),()=>this.off(e,t)}off(e,t){const n=this.eventHandlers.get(e);n&&n.delete(t)}handleEvent(e,t){const n=this.eventHandlers.get(e);if(!n||0===n.size)return;let i;try{i=JSON.parse(t.data)}catch(s){return void console.error("[SSE] Failed to parse event data",s)}n.forEach(e=>{try{e(i,t)}catch(s){console.error("[SSE] Event handler error",s)}})}setState(e){const t=this.state;this.state=e,t!==e&&this.stateChangeHandlers.forEach(n=>{try{n(e,t)}catch(i){console.error("[SSE] State change handler error",i)}})}onStateChange(e){return this.stateChangeHandlers.add(e),()=>this.stateChangeHandlers.delete(e)}getState(){return this.state}isConnected(){return this.state===Ke.CONNECTED}getConnectionId(){return this.connectionId}addChannels(...e){const t=e.filter(e=>!this.channels.includes(e));t.length>0&&(this.channels.push(...t),this.isConnected()&&(console.log("[SSE] Reconnecting with new channels:",t),this.disconnect(),this.connect()))}removeChannels(...e){const t=this.channels.length;this.channels=this.channels.filter(t=>!e.includes(t)),this.channels.length!==t&&this.isConnected()&&(console.log("[SSE] Reconnecting with removed channels"),this.disconnect(),this.connect())}}let et=null;function tt(e=[]){return et||(et=new Ze(e)),et}function nt(e=[],t=!0){return et=new Ze(e),t&&et.connect(),et}const it={SseClient:Ze,getGlobalSseClient:tt,initSse:nt,ConnectionState:Ke},st=Object.freeze(Object.defineProperty({__proto__:null,SseClient:Ze,default:it,getGlobalSseClient:tt,initSse:nt},Symbol.toStringTag,{value:"Module"}));class rt{constructor(e){this.liveComponentManager=e,this.observer=null,this.lazyComponents=new Map,this.loadingQueue=[],this.isProcessingQueue=!1,this.defaultOptions={rootMargin:"50px",threshold:.1}}init(){this.observer=new IntersectionObserver(e=>this.handleIntersection(e),this.defaultOptions),this.scanLazyComponents(),console.log(`[LazyLoader] Initialized with ${this.lazyComponents.size} lazy components`)}scanLazyComponents(){document.querySelectorAll("[data-live-component-lazy]").forEach(e=>{this.registerLazyComponent(e)})}registerLazyComponent(e){const t=e.dataset.liveComponentLazy;if(!t)return void console.warn("[LazyLoader] Lazy component missing componentId:",e);const n={element:e,componentId:t,threshold:parseFloat(e.dataset.lazyThreshold)||this.defaultOptions.threshold,priority:e.dataset.lazyPriority||"normal",placeholder:e.dataset.lazyPlaceholder||null,loaded:!1,loading:!1};n.placeholder&&this.showPlaceholder(e,n.placeholder),this.lazyComponents.set(e,n),this.observer.observe(e),console.log(`[LazyLoader] Registered lazy component: ${t}`)}handleIntersection(e){e.forEach(e=>{if(e.isIntersecting){const t=this.lazyComponents.get(e.target);!t||t.loaded||t.loading||this.queueComponentLoad(t)}})}queueComponentLoad(e){const t=this.getPriorityWeight(e.priority);this.loadingQueue.push({config:e,priority:t,timestamp:Date.now()}),this.loadingQueue.sort((e,t)=>t.priority!==e.priority?t.priority-e.priority:e.timestamp-t.timestamp),console.log(`[LazyLoader] Queued: ${e.componentId} (priority: ${e.priority})`),this.processLoadingQueue()}getPriorityWeight(e){return{high:3,normal:2,low:1}[e]||2}async processLoadingQueue(){if(!this.isProcessingQueue&&0!==this.loadingQueue.length){for(this.isProcessingQueue=!0;this.loadingQueue.length>0;){const{config:e}=this.loadingQueue.shift();e.loaded||e.loading||await this.loadComponent(e)}this.isProcessingQueue=!1}}async loadComponent(e){e.loading=!0;try{console.log(`[LazyLoader] Loading: ${e.componentId}`),this.showLoadingIndicator(e.element);const t=await fetch(`/live-component/${e.componentId}/lazy-load`,{method:"GET",headers:{"X-Requested-With":"XMLHttpRequest",Accept:"application/json"}});if(!t.ok)throw new Error(`HTTP ${t.status}: ${t.statusText}`);const n=await t.json();if(!n.success)throw new Error(n.error||"Failed to load component");if(e.element.innerHTML=n.html,e.element.setAttribute("data-live-component",e.componentId),e.element.removeAttribute("data-live-component-lazy"),n.csrf_token&&(e.element.dataset.csrfToken=n.csrf_token),n.state){const t=JSON.stringify(n.state);e.element.dataset.state=t}this.liveComponentManager.init(e.element),e.loaded=!0,e.loading=!1,this.observer.unobserve(e.element),console.log(`[LazyLoader] Loaded: ${e.componentId}`),e.element.dispatchEvent(new CustomEvent("livecomponent:lazy:loaded",{detail:{componentId:e.componentId}}))}catch(t){console.error(`[LazyLoader] Failed to load ${e.componentId}:`,t),e.loading=!1,this.showError(e.element,t.message),e.element.dispatchEvent(new CustomEvent("livecomponent:lazy:error",{detail:{componentId:e.componentId,error:t.message}}))}}showPlaceholder(e,t){e.innerHTML=`\n            <div class="livecomponent-lazy-placeholder" style="\n                padding: 2rem;\n                text-align: center;\n                color: #666;\n                background: #f5f5f5;\n                border-radius: 8px;\n                border: 1px dashed #ddd;\n            ">\n                <div style="font-size: 1.5rem; margin-bottom: 0.5rem;">⏳</div>\n                <div>${t}</div>\n            </div>\n        `}showLoadingIndicator(e){e.innerHTML='\n            <div class="livecomponent-lazy-loading" style="\n                padding: 2rem;\n                text-align: center;\n                color: #2196F3;\n                background: #f5f5f5;\n                border-radius: 8px;\n                border: 1px solid #e3f2fd;\n            ">\n                <div class="spinner" style="\n                    width: 40px;\n                    height: 40px;\n                    margin: 0 auto 1rem;\n                    border: 4px solid #e3f2fd;\n                    border-top: 4px solid #2196F3;\n                    border-radius: 50%;\n                    animation: spin 1s linear infinite;\n                "></div>\n                <div>Loading component...</div>\n            </div>\n            <style>\n                @keyframes spin {\n                    0% { transform: rotate(0deg); }\n                    100% { transform: rotate(360deg); }\n                }\n            </style>\n        '}showError(e,t){e.innerHTML=`\n            <div class="livecomponent-lazy-error" style="\n                padding: 2rem;\n                text-align: center;\n                color: #d32f2f;\n                background: #ffebee;\n                border-radius: 8px;\n                border: 1px solid #ef9a9a;\n            ">\n                <div style="font-size: 1.5rem; margin-bottom: 0.5rem;">❌</div>\n                <div><strong>Failed to load component</strong></div>\n                <div style="margin-top: 0.5rem; font-size: 0.9rem; color: #c62828;">\n                    ${t}\n                </div>\n            </div>\n        `}unregister(e){const t=this.lazyComponents.get(e);t&&(this.observer.unobserve(e),this.lazyComponents.delete(e),console.log(`[LazyLoader] Unregistered: ${t.componentId}`))}destroy(){this.observer&&(this.observer.disconnect(),this.observer=null),this.loadingQueue=[],this.lazyComponents.clear(),console.log("[LazyLoader] Destroyed")}getStats(){let e=0,t=0,n=0;return this.lazyComponents.forEach(i=>{i.loaded?e++:i.loading?t++:n++}),{total:this.lazyComponents.size,loaded:e,loading:t,pending:n,queued:this.loadingQueue.length}}}class ot{constructor(e){this.liveComponentManager=e,this.hierarchyRegistry=new Map,this.childrenRegistry=new Map,this.bubbleCallbacks=new Map}init(){this.scanNestedComponents(),console.log(`[NestedComponents] Initialized with ${this.hierarchyRegistry.size} components`)}scanNestedComponents(){document.querySelectorAll("[data-parent-component]").forEach(e=>{const t=e.dataset.liveComponent,n=e.dataset.parentComponent,i=parseInt(e.dataset.nestingDepth)||1;t&&n&&this.registerHierarchy(t,n,i)});document.querySelectorAll("[data-live-component]:not([data-parent-component])").forEach(e=>{const t=e.dataset.liveComponent;t&&!this.hierarchyRegistry.has(t)&&this.registerRoot(t)})}registerRoot(e){this.hierarchyRegistry.set(e,{parentId:null,childIds:[],depth:0,path:[e]}),console.log(`[NestedComponents] Registered root: ${e}`)}registerHierarchy(e,t,n=1){const i=this.hierarchyRegistry.get(t),s=i?i.path:[t];this.hierarchyRegistry.set(e,{parentId:t,childIds:[],depth:n,path:[...s,e]}),this.childrenRegistry.has(t)||this.childrenRegistry.set(t,[]);const r=this.childrenRegistry.get(t);r.includes(e)||r.push(e),console.log(`[NestedComponents] Registered child: ${e} (parent: ${t}, depth: ${n})`)}registerDynamicChild(e,t){const n=this.hierarchyRegistry.get(t);if(!n)return void console.warn(`[NestedComponents] Cannot register child - parent not found: ${t}`);const i=n.depth+1;this.registerHierarchy(e,t,i)}getHierarchy(e){return this.hierarchyRegistry.get(e)||null}getParentId(e){const t=this.getHierarchy(e);return t?t.parentId:null}getChildIds(e){return this.childrenRegistry.get(e)||[]}hasChildren(e){return this.getChildIds(e).length>0}isRoot(e){const t=this.getHierarchy(e);return!t||null===t.parentId}getDepth(e){const t=this.getHierarchy(e);return t?t.depth:0}getAncestors(e){const t=this.getHierarchy(e);if(!t||!t.path)return[];const n=[...t.path];return n.pop(),n.reverse()}bubbleEvent(e,t,n){console.log(`[NestedComponents] Bubbling event: ${t} from ${e}`,n);let i=e,s=0;for(;;){const r=this.getParentId(i);if(null===r)return console.log(`[NestedComponents] Event bubbled to root (${s} levels)`),!0;const o=document.querySelector(`[data-live-component="${r}"]`);if(!o)return console.warn(`[NestedComponents] Parent element not found: ${r}`),!1;const a=new CustomEvent(`livecomponent:child:${t}`,{detail:{sourceId:e,eventName:t,payload:n,currentLevel:s},bubbles:!1,cancelable:!0});if(!o.dispatchEvent(a))return console.log(`[NestedComponents] Event bubbling stopped at ${r}`),!1;const l=this.bubbleCallbacks.get(r);if(l)for(const i of l){if(!1===i(e,t,n))return console.log(`[NestedComponents] Event bubbling stopped by callback at ${r}`),!1}i=r,s++}}onChildEvent(e,t){this.bubbleCallbacks.has(e)||this.bubbleCallbacks.set(e,[]),this.bubbleCallbacks.get(e).push(t),console.log(`[NestedComponents] Registered child event callback for ${e}`)}syncStateToChildren(e,t){const n=this.getChildIds(e);console.log(`[NestedComponents] Syncing state to ${n.length} children of ${e}`),n.forEach(n=>{const i=document.querySelector(`[data-live-component="${n}"]`);i&&i.dispatchEvent(new CustomEvent("livecomponent:parent:state-sync",{detail:{parentId:e,sharedState:t}}))})}async updateChildren(e,t){const n=this.getChildIds(e);console.log(`[NestedComponents] Updating ${n.length} children of ${e}`);const i=n.map(async n=>{const i=document.querySelector(`[data-live-component="${n}"]`);i&&i.dispatchEvent(new CustomEvent("livecomponent:parent:update",{detail:{parentId:e,updates:t}}))});await Promise.all(i)}unregister(e){const t=this.hierarchyRegistry.get(e);if(this.hierarchyRegistry.delete(e),t&&t.parentId){const n=this.childrenRegistry.get(t.parentId);if(n){const t=n.indexOf(e);-1!==t&&n.splice(t,1)}}this.childrenRegistry.delete(e),this.bubbleCallbacks.delete(e),console.log(`[NestedComponents] Unregistered: ${e}`)}getStats(){let e=0,t=0;return this.hierarchyRegistry.forEach(n=>{null===n.parentId&&e++,t=Math.max(t,n.depth)}),{total_components:this.hierarchyRegistry.size,root_components:e,child_components:this.hierarchyRegistry.size-e,max_nesting_depth:t,parents_with_children:this.childrenRegistry.size}}destroy(){this.hierarchyRegistry.clear(),this.childrenRegistry.clear(),this.bubbleCallbacks.clear(),console.log("[NestedComponents] Destroyed")}}class at{constructor(e,t){this.file=e,this.fileId=t,this.uploadedBytes=0,this.totalBytes=e.size,this.status="pending",this.error=null,this.xhr=null,this.startTime=null,this.endTime=null}get percentage(){return 0===this.totalBytes?100:Math.round(this.uploadedBytes/this.totalBytes*100)}get isComplete(){return"complete"===this.status}get hasError(){return"error"===this.status}get isUploading(){return"uploading"===this.status}get uploadSpeed(){if(!this.startTime||!this.isUploading)return 0;const e=(Date.now()-this.startTime)/1e3;return e>0?this.uploadedBytes/e:0}get remainingTime(){const e=this.uploadSpeed;if(0===e)return 0;return(this.totalBytes-this.uploadedBytes)/e}updateProgress(e,t){this.uploadedBytes=e,this.totalBytes=t}setStatus(e,t=null){this.status=e,this.error=t,"uploading"!==e||this.startTime||(this.startTime=Date.now()),"complete"!==e&&"error"!==e||(this.endTime=Date.now())}abort(){this.xhr&&(this.xhr.abort(),this.setStatus("error","Upload cancelled"))}toObject(){return{fileId:this.fileId,fileName:this.file.name,fileSize:this.totalBytes,uploadedBytes:this.uploadedBytes,percentage:this.percentage,status:this.status,error:this.error,uploadSpeed:this.uploadSpeed,remainingTime:this.remainingTime}}}class lt{constructor(e={}){this.maxFileSize=e.maxFileSize||10485760,this.allowedMimeTypes=e.allowedMimeTypes||[],this.allowedExtensions=e.allowedExtensions||[],this.minFileSize=e.minFileSize||1}validate(e){const t=[];if(e.size>this.maxFileSize&&t.push(`File size (${this.formatBytes(e.size)}) exceeds maximum allowed size (${this.formatBytes(this.maxFileSize)})`),e.size<this.minFileSize&&t.push(`File size is too small (minimum: ${this.formatBytes(this.minFileSize)})`),this.allowedMimeTypes.length>0&&!this.allowedMimeTypes.includes(e.type)&&t.push(`File type "${e.type}" is not allowed. Allowed types: ${this.allowedMimeTypes.join(", ")}`),this.allowedExtensions.length>0){const n=e.name.split(".").pop().toLowerCase();this.allowedExtensions.includes(n)||t.push(`File extension ".${n}" is not allowed. Allowed extensions: ${this.allowedExtensions.join(", ")}`)}return e.name.length>255&&t.push("File name is too long (maximum 255 characters)"),t}isValid(e){return 0===this.validate(e).length}formatBytes(e){if(0===e)return"0 B";const t=Math.floor(Math.log(e)/Math.log(1024));return Math.round(e/Math.pow(1024,t)*100)/100+" "+["B","KB","MB","GB"][t]}}class ct{constructor(e,t={}){this.element=e,this.onFilesDropped=t.onFilesDropped||(()=>{}),this.onDragEnter=t.onDragEnter||(()=>{}),this.onDragLeave=t.onDragLeave||(()=>{}),this.dragCounter=0,this.isActive=!1,this.bindEvents()}bindEvents(){["dragenter","dragover","dragleave","drop"].forEach(e=>{this.element.addEventListener(e,e=>{e.preventDefault(),e.stopPropagation()})}),this.element.addEventListener("dragenter",e=>{this.dragCounter++,1===this.dragCounter&&(this.isActive=!0,this.element.classList.add("drag-over"),this.onDragEnter(e))}),this.element.addEventListener("dragleave",e=>{this.dragCounter--,0===this.dragCounter&&(this.isActive=!1,this.element.classList.remove("drag-over"),this.onDragLeave(e))}),this.element.addEventListener("dragover",e=>{}),this.element.addEventListener("drop",e=>{var t;this.dragCounter=0,this.isActive=!1,this.element.classList.remove("drag-over");const n=Array.from((null==(t=e.dataTransfer)?void 0:t.files)||[]);n.length>0&&this.onFilesDropped(n)})}destroy(){this.element.classList.remove("drag-over")}}class dt{constructor(e,t={}){this.componentElement=e,this.componentId=e.dataset.liveId,this.maxFileSize=t.maxFileSize||10485760,this.allowedMimeTypes=t.allowedMimeTypes||[],this.allowedExtensions=t.allowedExtensions||[],this.maxFiles=t.maxFiles||10,this.autoUpload=!1!==t.autoUpload,this.multiple=!1!==t.multiple,this.endpoint=t.endpoint||`/live-component/${this.componentId}/upload`,this.onFileAdded=t.onFileAdded||(()=>{}),this.onFileRemoved=t.onFileRemoved||(()=>{}),this.onUploadStart=t.onUploadStart||(()=>{}),this.onUploadProgress=t.onUploadProgress||(()=>{}),this.onUploadComplete=t.onUploadComplete||(()=>{}),this.onUploadError=t.onUploadError||(()=>{}),this.onAllUploadsComplete=t.onAllUploadsComplete||(()=>{}),this.files=new Map,this.uploadQueue=[],this.activeUploads=0,this.maxConcurrentUploads=t.maxConcurrentUploads||2,this.validator=new lt({maxFileSize:this.maxFileSize,allowedMimeTypes:this.allowedMimeTypes,allowedExtensions:this.allowedExtensions}),this.dropZoneElement=t.dropZone,this.fileInputElement=t.fileInput,this.initialize()}initialize(){this.dropZoneElement&&(this.dragDropZone=new ct(this.dropZoneElement,{onFilesDropped:e=>this.addFiles(e),onDragEnter:()=>this.dropZoneElement.classList.add("drag-active"),onDragLeave:()=>this.dropZoneElement.classList.remove("drag-active")})),this.fileInputElement&&this.fileInputElement.addEventListener("change",e=>{const t=Array.from(e.target.files||[]);this.addFiles(t),e.target.value=""})}addFiles(e){const t=Array.isArray(e)?e:[e];if(this.files.size+t.length>this.maxFiles){const e=`Cannot add files. Maximum ${this.maxFiles} files allowed.`;return void this.onUploadError({error:e,fileCount:t.length})}for(const n of t){const e=this.generateFileId(n),t=this.validator.validate(n),i=new at(n,e);t.length>0?(i.setStatus("error",t.join(", ")),this.files.set(e,i),this.onUploadError({fileId:e,file:n,errors:t})):(this.files.set(e,i),this.uploadQueue.push(e),this.onFileAdded({fileId:e,file:n,progress:i.toObject()}))}this.autoUpload&&this.processQueue()}removeFile(e){const t=this.files.get(e);if(!t)return;t.isUploading&&t.abort();const n=this.uploadQueue.indexOf(e);-1!==n&&this.uploadQueue.splice(n,1),this.files.delete(e),this.onFileRemoved({fileId:e,file:t.file})}uploadAll(){this.processQueue()}async processQueue(){for(;this.uploadQueue.length>0&&this.activeUploads<this.maxConcurrentUploads;){const e=this.uploadQueue.shift(),t=this.files.get(e);t&&"pending"===t.status&&(this.activeUploads++,this.uploadFile(e).finally(()=>{this.activeUploads--,this.processQueue(),0===this.activeUploads&&0===this.uploadQueue.length&&this.onAllUploadsComplete({totalFiles:this.files.size,successCount:Array.from(this.files.values()).filter(e=>e.isComplete).length,errorCount:Array.from(this.files.values()).filter(e=>e.hasError).length})}))}}async uploadFile(e){const t=this.files.get(e);if(t)try{const n=this.getComponentState(),i=await this.getCsrfTokens(),s=new FormData;s.append("file",t.file),s.append("state",JSON.stringify(n)),s.append("params",JSON.stringify({fileId:e}));const r=new XMLHttpRequest;t.xhr=r,r.upload.addEventListener("progress",n=>{n.lengthComputable&&(t.updateProgress(n.loaded,n.total),this.onUploadProgress({fileId:e,...t.toObject()}))});const o=new Promise((n,i)=>{r.addEventListener("load",()=>{if(r.status>=200&&r.status<300)try{const i=JSON.parse(r.responseText);if(!i.success)throw new Error(i.error||"Upload failed");t.setStatus("complete"),i.state&&this.updateComponentState(i.state),i.html&&this.updateComponentHtml(i.html),this.onUploadComplete({fileId:e,file:t.file,response:i}),n(i)}catch(s){i(s)}else i(new Error(`Upload failed with status ${r.status}`))}),r.addEventListener("error",()=>{i(new Error("Network error during upload"))}),r.addEventListener("abort",()=>{i(new Error("Upload cancelled"))})});t.setStatus("uploading"),this.onUploadStart({fileId:e,file:t.file}),r.open("POST",this.endpoint),r.setRequestHeader("X-CSRF-Form-ID",i.form_id),r.setRequestHeader("X-CSRF-Token",i.token),r.setRequestHeader("Accept","application/json"),r.setRequestHeader("User-Agent",navigator.userAgent),r.send(s),await o}catch(n){t.setStatus("error",n.message),this.onUploadError({fileId:e,file:t.file,error:n.message})}}cancelAll(){this.uploadQueue=[],this.files.forEach(e=>{e.isUploading&&e.abort()})}clearAll(){this.cancelAll(),this.files.clear()}getOverallProgress(){if(0===this.files.size)return 100;const e=Array.from(this.files.values()).reduce((e,t)=>e+t.totalBytes,0),t=Array.from(this.files.values()).reduce((e,t)=>e+t.uploadedBytes,0);return e>0?Math.round(t/e*100):0}getStats(){const e=Array.from(this.files.values());return{total:e.length,pending:e.filter(e=>"pending"===e.status).length,uploading:e.filter(e=>"uploading"===e.status).length,complete:e.filter(e=>"complete"===e.status).length,error:e.filter(e=>"error"===e.status).length,overallProgress:this.getOverallProgress()}}generateFileId(e){return`${Date.now()}-${Math.random().toString(36).substr(2,9)}-${e.name}`}async getCsrfTokens(){try{const e=await fetch(`/api/csrf/token?action=${encodeURIComponent(this.endpoint)}&method=post`,{headers:{Accept:"application/json","User-Agent":navigator.userAgent}});if(!e.ok)throw new Error(`CSRF token request failed: ${e.status}`);return await e.json()}catch(e){throw console.error("Failed to get CSRF tokens:",e),e}}getComponentState(){const e=this.componentElement.querySelector("[data-live-state]");if(e)try{return JSON.parse(e.textContent||"{}")}catch(t){console.warn("Failed to parse component state:",t)}return{}}updateComponentState(e){const t=this.componentElement.querySelector("[data-live-state]");t&&(t.textContent=JSON.stringify(e))}updateComponentHtml(e){const t=this.componentElement.querySelector("[data-live-content]")||this.componentElement;t&&(t.innerHTML=e)}destroy(){this.cancelAll(),this.clearAll(),this.dragDropZone&&this.dragDropZone.destroy()}}const ht=new class{constructor(){this.pendingOperations=new Map,this.snapshots=new Map,this.conflictHandlers=new Map,this.operationIdCounter=0}applyOptimisticUpdate(e,t,n,i={}){this.snapshots.has(e)||this.createSnapshot(e,t);const s=t.version||1,r={...n(t),version:s+1},o={id:this.generateOperationId(),componentId:e,metadata:i,expectedVersion:s,optimisticState:r,timestamp:Date.now(),status:"pending"};return this.addPendingOperation(e,o),console.log(`[OptimisticUI] Applied optimistic update for ${e}`,{version:`${s} → ${s+1}`,operationId:o.id,pendingCount:this.getPendingOperationsCount(e)}),r}confirmOperation(e,t,n){const i=this.getPendingOperation(e,t);return i?(i.status="confirmed",this.removePendingOperation(e,t),console.log(`[OptimisticUI] Confirmed operation ${t} for ${e}`,{pendingCount:this.getPendingOperationsCount(e)}),this.hasPendingOperations(e)||this.clearSnapshot(e),n):(console.warn(`[OptimisticUI] Cannot confirm unknown operation: ${t}`),n)}handleConflict(e,t,n,i={}){const s=this.getPendingOperation(e,t);if(!s)return console.warn(`[OptimisticUI] Cannot handle conflict for unknown operation: ${t}`),{state:n,notification:null};s.status="failed";const r=this.snapshots.get(e);console.warn(`[OptimisticUI] Version conflict detected for ${e}`,{operationId:t,expectedVersion:s.expectedVersion,serverVersion:n.version,metadata:s.metadata,pendingOperationsCount:this.getPendingOperationsCount(e)}),this.clearPendingOperations(e),this.clearSnapshot(e);const o=this.conflictHandlers.get(e);o&&o({operation:s,serverState:n,snapshotState:null==r?void 0:r.state,conflict:i});return{state:n,notification:{type:"conflict",title:"Update Conflict",message:"Your changes conflicted with another update. The latest version has been loaded.",action:s.metadata.action||"unknown",canRetry:!0,operation:s}}}createSnapshot(e,t){this.snapshots.set(e,{state:JSON.parse(JSON.stringify(t)),timestamp:Date.now()}),console.log(`[OptimisticUI] Created snapshot for ${e}`,{version:t.version})}clearSnapshot(e){this.snapshots.get(e)&&(this.snapshots.delete(e),console.log(`[OptimisticUI] Cleared snapshot for ${e}`))}getSnapshot(e){const t=this.snapshots.get(e);return t?t.state:null}addPendingOperation(e,t){this.pendingOperations.has(e)||this.pendingOperations.set(e,[]),this.pendingOperations.get(e).push(t)}removePendingOperation(e,t){const n=this.pendingOperations.get(e);if(!n)return;const i=n.findIndex(e=>e.id===t);-1!==i&&n.splice(i,1),0===n.length&&this.pendingOperations.delete(e)}getPendingOperation(e,t){const n=this.pendingOperations.get(e);return n&&n.find(e=>e.id===t)||null}getPendingOperations(e){return this.pendingOperations.get(e)||[]}getPendingOperationsCount(e){const t=this.pendingOperations.get(e);return t?t.length:0}hasPendingOperations(e){return this.getPendingOperationsCount(e)>0}clearPendingOperations(e){this.pendingOperations.delete(e)}registerConflictHandler(e,t){this.conflictHandlers.set(e,t)}unregisterConflictHandler(e){this.conflictHandlers.delete(e)}generateOperationId(){return`op-${++this.operationIdCounter}-${Date.now()}`}async retryOperation(e,t,n){console.log(`[OptimisticUI] Retrying operation ${t.id} for ${e}`);try{const e=await n(t.metadata);return console.log(`[OptimisticUI] Retry succeeded for ${t.id}`),e}catch(i){throw console.error(`[OptimisticUI] Retry failed for ${t.id}:`,i),i}}getStats(){const e={total_components:this.pendingOperations.size,total_pending_operations:0,total_snapshots:this.snapshots.size,components:{}};return this.pendingOperations.forEach((t,n)=>{e.total_pending_operations+=t.length,e.components[n]={pending:t.length,has_snapshot:this.snapshots.has(n)}}),e}clear(){this.pendingOperations.clear(),this.snapshots.clear(),this.conflictHandlers.clear(),this.operationIdCounter=0,console.log("[OptimisticUI] Cleared all state")}};const ut=new class{constructor(){this.liveRegion=null,this.componentLiveRegions=new Map,this.focusStates=new Map,this.announcementQueue=[],this.announceTimer=null,this.throttleDelay=500}initialize(){this.liveRegion||(this.liveRegion=this.createLiveRegion("livecomponent-announcer","polite"),document.body.appendChild(this.liveRegion)),console.log("[AccessibilityManager] Initialized with ARIA live regions")}createLiveRegion(e,t="polite"){const n=document.createElement("div");return n.id=e,n.setAttribute("role","status"),n.setAttribute("aria-live",t),n.setAttribute("aria-atomic","true"),n.className="sr-only",n.style.position="absolute",n.style.left="-10000px",n.style.width="1px",n.style.height="1px",n.style.overflow="hidden",n}createComponentLiveRegion(e,t,n="polite"){let i=this.componentLiveRegions.get(e);return i||(i=this.createLiveRegion(`livecomponent-${e}-announcer`,n),t.appendChild(i),this.componentLiveRegions.set(e,i)),i}announce(e,t="polite",n=null){this.announcementQueue.push({message:e,priority:t,componentId:n}),this.announceTimer&&clearTimeout(this.announceTimer),this.announceTimer=setTimeout(()=>{this.flushAnnouncements()},this.throttleDelay)}flushAnnouncements(){if(0===this.announcementQueue.length)return;const e=this.announcementQueue[this.announcementQueue.length-1];this.announcementQueue=[];let t=this.liveRegion;if(e.componentId){const n=this.componentLiveRegions.get(e.componentId);n&&(t=n)}t?("assertive"===e.priority?t.setAttribute("aria-live","assertive"):t.setAttribute("aria-live","polite"),t.textContent="",setTimeout(()=>{t.textContent=e.message},100),console.log(`[AccessibilityManager] Announced: "${e.message}" (${e.priority})`)):console.warn("[AccessibilityManager] No live region available for announcement")}captureFocusState(e,t){const n=document.activeElement;if(!n||!t.contains(n))return null;const i={selector:this.getElementSelector(n,t),tagName:n.tagName,name:n.name||null,id:n.id||null,selectionStart:n.selectionStart||null,selectionEnd:n.selectionEnd||null,scrollTop:n.scrollTop||0,scrollLeft:n.scrollLeft||0,keepFocus:n.hasAttribute("data-lc-keep-focus")};return this.focusStates.set(e,i),console.log(`[AccessibilityManager] Captured focus state for ${e}`,i),i}restoreFocus(e,t){const n=this.focusStates.get(e);if(!n)return!1;try{let e=null;if(n.keepFocus&&(e=t.querySelector("[data-lc-keep-focus]")),!e&&n.selector&&(e=t.querySelector(n.selector)),!e&&n.id&&(e=t.querySelector(`#${n.id}`)),!e&&n.name&&(e=t.querySelector(`[name="${n.name}"]`)),e&&e.focus)return e.focus(),e.setSelectionRange&&null!==n.selectionStart&&null!==n.selectionEnd&&e.setSelectionRange(n.selectionStart,n.selectionEnd),n.scrollTop>0&&(e.scrollTop=n.scrollTop),n.scrollLeft>0&&(e.scrollLeft=n.scrollLeft),console.log(`[AccessibilityManager] Restored focus to ${n.selector}`),!0}catch(i){console.debug("[AccessibilityManager] Could not restore focus:",i)}finally{this.focusStates.delete(e)}return!1}getElementSelector(e,t){if(e.id)return`#${e.id}`;if(e.name)return`[name="${e.name}"]`;const n=e.getAttribute("data-lc-key");if(n)return`[data-lc-key="${n}"]`;const i=[];let s=e;for(;s&&s!==t&&s!==document.body;){let e=s.tagName.toLowerCase();if(s.className&&"string"==typeof s.className){const t=s.className.split(" ").filter(e=>e.trim());t.length>0&&(e+="."+t.join("."))}if(s.parentElement){const t=Array.from(s.parentElement.children),n=t.indexOf(s)+1;t.length>1&&(e+=`:nth-child(${n})`)}i.unshift(e),s=s.parentElement}return i.length>0?i.join(" > "):null}announceUpdate(e,t,n={}){let i="";switch(t){case"fragment":i=`Updated ${n.fragmentName||"content"}`;break;case"full":i="Component updated";break;case"action":i=n.actionMessage||"Action completed";break;default:i="Content updated"}this.announce(i,"polite",e)}shouldPreserveKeyboardNav(e){if(["INPUT","TEXTAREA","SELECT","BUTTON","A"].includes(e.tagName))return!0;if(e.hasAttribute("tabindex"))return!0;const t=e.getAttribute("role");return!(!t||!["button","link","textbox","searchbox","combobox","listbox","option","tab"].includes(t))}cleanup(e){const t=this.componentLiveRegions.get(e);t&&t.parentElement&&t.parentElement.removeChild(t),this.componentLiveRegions.delete(e),this.focusStates.delete(e),console.log(`[AccessibilityManager] Cleaned up accessibility for ${e}`)}getStats(){return{has_global_live_region:null!==this.liveRegion,component_live_regions:this.componentLiveRegions.size,tracked_focus_states:this.focusStates.size,pending_announcements:this.announcementQueue.length}}};class pt{constructor(e){this.manager=e,this.retryStrategies=new Map,this.errorHandlers=new Map,this.maxRetries=3,this.retryDelays=[1e3,2e3,5e3]}async handleError(e,t,n,i={}){console.error(`[ErrorBoundary] Error in ${e}.${t}:`,n);const s=this.standardizeError(n,e,t),r=this.errorHandlers.get(e);if(r)try{if(await r(s,i))return!0}catch(o){console.error("[ErrorBoundary] Error handler failed:",o)}if(this.isRetryable(s)){if(await this.retryOperation(e,t,i,s))return!0}return this.showError(e,s),this.dispatchErrorEvent(e,s),!1}standardizeError(e,t,n){return e&&"object"==typeof e&&"code"in e&&"message"in e?{code:e.code,message:e.message,details:e.details||{},componentId:e.componentId||t,action:e.action||n,timestamp:e.timestamp||Date.now()}:e instanceof Error?{code:"INTERNAL_ERROR",message:e.message,details:{stack:e.stack,name:e.name},componentId:t,action:n,timestamp:Date.now()}:"string"==typeof e?{code:"INTERNAL_ERROR",message:e,componentId:t,action:n,timestamp:Date.now()}:{code:"INTERNAL_ERROR",message:"An unknown error occurred",details:{original:e},componentId:t,action:n,timestamp:Date.now()}}isRetryable(e){return["RATE_LIMIT_EXCEEDED","STATE_CONFLICT","INTERNAL_ERROR"].includes(e.code)}async retryOperation(e,t,n,i){const s=`${e}:${t}`,r=this.retryStrategies.get(s)||0;if(r>=this.maxRetries)return console.warn(`[ErrorBoundary] Max retries exceeded for ${s}`),this.retryStrategies.delete(s),!1;const o=this.retryDelays[r]||this.retryDelays[this.retryDelays.length-1];console.log(`[ErrorBoundary] Retrying ${s} in ${o}ms (attempt ${r+1}/${this.maxRetries})`),this.retryStrategies.set(s,r+1),await new Promise(e=>setTimeout(e,o));try{await this.manager.executeAction(e,t,n.params||{},n.fragments||null);return this.retryStrategies.delete(s),console.log(`[ErrorBoundary] Retry succeeded for ${s}`),!0}catch(a){return console.warn(`[ErrorBoundary] Retry failed for ${s}:`,a),!1}}showError(e,t){const n=this.manager.components.get(e);if(!n)return;const i=n.element.querySelector(".livecomponent-error-boundary");i&&i.remove();const s=document.createElement("div");s.className="livecomponent-error-boundary",s.style.cssText="\n            padding: 1rem;\n            background: #fee;\n            color: #c00;\n            border: 1px solid #faa;\n            border-radius: 4px;\n            margin-bottom: 1rem;\n        ";const r=document.createElement("div");if(r.style.fontWeight="bold",r.textContent=t.message,s.appendChild(r),"INTERNAL_ERROR"!==t.code){const e=document.createElement("div");e.style.fontSize="0.875rem",e.style.marginTop="0.5rem",e.style.color="#666",e.textContent=`Error Code: ${t.code}`,s.appendChild(e)}if(this.isRetryable(t)){const n=document.createElement("button");n.textContent="Retry",n.style.cssText="\n                margin-top: 0.5rem;\n                padding: 0.5rem 1rem;\n                background: #c00;\n                color: white;\n                border: none;\n                border-radius: 4px;\n                cursor: pointer;\n            ",n.addEventListener("click",async()=>{s.remove(),await this.retryOperation(e,t.action||"",{},t)}),s.appendChild(n)}const o=document.createElement("button");o.textContent="×",o.style.cssText="\n            float: right;\n            background: transparent;\n            border: none;\n            font-size: 1.5rem;\n            cursor: pointer;\n            color: #c00;\n        ",o.addEventListener("click",()=>{s.remove()}),s.appendChild(o),n.element.insertAdjacentElement("afterbegin",s),setTimeout(()=>{s.parentNode&&s.remove()},1e4)}dispatchErrorEvent(e,t){const n=new CustomEvent("livecomponent:error",{detail:{componentId:e,error:t},bubbles:!0}),i=this.manager.components.get(e);i&&i.element.dispatchEvent(n),document.dispatchEvent(n)}registerErrorHandler(e,t){if("function"!=typeof t)throw new Error("Error handler must be a function");this.errorHandlers.set(e,t)}clearErrorHandler(e){this.errorHandlers.delete(e)}clearRetryStrategy(e,t){const n=`${e}:${t}`;this.retryStrategies.delete(n)}resetRetryStrategies(){this.retryStrategies.clear()}}class mt{constructor(){this.pendingRequests=new Map,this.requestCache=new Map,this.cacheTimeout=1e3}generateKey(e,t,n){const i=Object.keys(n).sort().reduce((e,t)=>(e[t]=n[t],e),{});return`${e}:${t}:${JSON.stringify(i)}`}getPendingRequest(e,t,n){const i=this.generateKey(e,t,n);return this.pendingRequests.get(i)||null}registerPendingRequest(e,t,n,i){const s=this.generateKey(e,t,n);return this.pendingRequests.set(s,i),i.then(()=>{this.pendingRequests.delete(s)}).catch(()=>{this.pendingRequests.delete(s)}),i}getCachedResult(e,t,n){const i=this.generateKey(e,t,n),s=this.requestCache.get(i);if(!s)return null;return Date.now()-s.timestamp>this.cacheTimeout?(this.requestCache.delete(i),null):s.result}cacheResult(e,t,n,i){const s=this.generateKey(e,t,n);this.requestCache.set(s,{result:i,timestamp:Date.now()}),this.cleanupCache()}cleanupCache(){const e=Date.now();for(const[t,n]of this.requestCache.entries())e-n.timestamp>this.cacheTimeout&&this.requestCache.delete(t)}clearPendingRequests(){this.pendingRequests.clear()}clearCache(){this.requestCache.clear()}clearComponent(e){for(const[t]of this.pendingRequests.entries())t.startsWith(`${e}:`)&&this.pendingRequests.delete(t);for(const[t]of this.requestCache.entries())t.startsWith(`${e}:`)&&this.requestCache.delete(t)}getStats(){return{pendingRequests:this.pendingRequests.size,cachedResults:this.requestCache.size}}}function gt(e){const t=e.dataset.state;if(!t)return null;try{return function(e){if("string"!=typeof e)throw new Error("State JSON must be a string");if(""===e.trim())return{id:"",component:"",data:{},version:1};try{const t=JSON.parse(e);if(!t||"object"!=typeof t)throw new Error("Invalid state structure");const n=t.id||"",i=t.component||"",s=t.data||{},r="number"==typeof t.version?t.version:1;if("object"!=typeof s||Array.isArray(s))throw new Error("State data must be an object");return{id:n,component:i,data:s,version:r}}catch(t){if(t instanceof SyntaxError)throw new Error(`Invalid JSON format: ${t.message}`);throw t}}(t)}catch(n){return console.error("[StateSerializer] Failed to deserialize state from element:",n),null}}function ft(e,t){if(!function(e){return!(!e||"object"!=typeof e||!e.id||"string"!=typeof e.id||!e.component||"string"!=typeof e.component||"number"!=typeof e.version||e.version<1||e.data&&("object"!=typeof e.data||Array.isArray(e.data)))}(t))throw new Error("Invalid state structure");const n=function(e){if(!e||"object"!=typeof e)throw new Error("State must be an object");if(!e.id||"string"!=typeof e.id)throw new Error("State must have a valid id");if(!e.component||"string"!=typeof e.component)throw new Error("State must have a valid component name");if("number"!=typeof e.version||e.version<1)throw new Error("State must have a valid version number");const t=e.data||{};if("object"!=typeof t||Array.isArray(t))throw new Error("State data must be an object");const n={id:e.id,component:e.component,data:t,version:e.version};try{return JSON.stringify(n)}catch(i){throw new Error(`Failed to serialize state: ${i.message}`)}}(t);e.dataset.state=n}const yt="pending",vt="hashing",bt="uploading",wt="complete",St="error",Ct="initializing",Mt="initialized",kt="uploading",Et="assembling",xt="complete",At="aborted",Tt="error";class It{constructor(e,t,n){this.index=e,this.size=t,this.status=yt,this.hash=null,this.uploadedBytes=0,this.retries=0,this.error=null,this.xhr=null,this.file=n}get progress(){return this.size>0?this.uploadedBytes/this.size*100:0}reset(){this.status=yt,this.uploadedBytes=0,this.error=null,this.xhr=null}abort(){this.xhr&&(this.xhr.abort(),this.xhr=null)}}class Pt{constructor(e,t){this.file=e,this.sessionId=null,this.totalChunks=0,this.chunkSize=t.chunkSize,this.chunks=[],this.status=Ct,this.uploadedChunks=0,this.expectedFileHash=null,this.error=null,this.startTime=null,this.endTime=null,this.expiresAt=null}get progress(){return 0===this.totalChunks?0:this.uploadedChunks/this.totalChunks*100}get uploadedBytes(){return this.chunks.reduce((e,t)=>e+t.uploadedBytes,0)}get totalBytes(){return this.file.size}get isComplete(){return this.status===xt}get isError(){return this.status===Tt}get isAborted(){return this.status===At}get canResume(){return null!==this.sessionId&&!this.isComplete&&!this.isAborted}getChunk(e){return this.chunks[e]}getPendingChunks(){return this.chunks.filter(e=>e.status===yt||e.status===St)}getUploadingChunks(){return this.chunks.filter(e=>e.status===bt)}}const Lt=new class{constructor(){this.tooltips=new Map,this.activeTooltip=null,this.config={delay:300,hideDelay:100,maxWidth:300,offset:8,animationDuration:200,zIndex:1e4}}init(e,t={}){const n=t.content||e.dataset.tooltip||e.getAttribute("title")||e.getAttribute("aria-label")||"";if(!n)return;e.hasAttribute("title")&&(e.dataset.originalTitle=e.getAttribute("title"),e.removeAttribute("title"));const i=t.position||e.dataset.tooltipPosition||"top";this.setupEventListeners(e,n,i,t)}setupEventListeners(e,t,n,i){let s,r;const o=()=>{clearTimeout(r),s=setTimeout(()=>{this.show(e,t,n,i)},this.config.delay)},a=()=>{clearTimeout(s),r=setTimeout(()=>{this.hide(e)},this.config.hideDelay)};e.addEventListener("mouseenter",o),e.addEventListener("mouseleave",a),e.addEventListener("focus",o),e.addEventListener("blur",a),e.addEventListener("touchstart",o,{passive:!0}),e.addEventListener("touchend",a,{passive:!0}),e._tooltipCleanup=()=>{clearTimeout(s),clearTimeout(r),e.removeEventListener("mouseenter",o),e.removeEventListener("mouseleave",a),e.removeEventListener("focus",o),e.removeEventListener("blur",a),e.removeEventListener("touchstart",o),e.removeEventListener("touchend",a)}}show(e,t,n,i={}){this.activeTooltip&&this.hide();const s=document.createElement("div");s.className="livecomponent-tooltip",s.setAttribute("role","tooltip"),s.setAttribute("aria-hidden","false"),s.textContent=t,s.style.cssText=`\n            position: absolute;\n            max-width: ${this.config.maxWidth}px;\n            padding: 0.5rem 0.75rem;\n            background: #1f2937;\n            color: white;\n            border-radius: 0.375rem;\n            font-size: 0.875rem;\n            line-height: 1.4;\n            z-index: ${this.config.zIndex};\n            pointer-events: none;\n            opacity: 0;\n            transition: opacity ${this.config.animationDuration}ms ease;\n            word-wrap: break-word;\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\n        `,document.body.appendChild(s),this.positionTooltip(s,e,n),requestAnimationFrame(()=>{s.style.opacity="1"}),this.tooltips.set(e,s),this.activeTooltip=s;const r=`tooltip-${Date.now()}`;s.id=r,e.setAttribute("aria-describedby",r)}positionTooltip(e,t,n){const i=t.getBoundingClientRect(),s=e.getBoundingClientRect(),r=window.scrollX||window.pageXOffset,o=window.scrollY||window.pageYOffset,a=this.config.offset;let l,c;switch(n){case"top":default:l=i.top+o-s.height-a,c=i.left+r+i.width/2-s.width/2;break;case"bottom":l=i.bottom+o+a,c=i.left+r+i.width/2-s.width/2;break;case"left":l=i.top+o+i.height/2-s.height/2,c=i.left+r-s.width-a;break;case"right":l=i.top+o+i.height/2-s.height/2,c=i.right+r+a}const d=window.innerWidth,h=window.innerHeight;c<r?c=r+8:c+s.width>r+d&&(c=r+d-s.width-8),l<o?l=o+8:l+s.height>o+h&&(l=o+h-s.height-8),e.style.top=`${l}px`,e.style.left=`${c}px`}hide(e=null){const t=e?this.tooltips.get(e):this.activeTooltip;t&&(t.style.opacity="0",setTimeout(()=>{t.parentNode&&t.parentNode.removeChild(t),e&&e.removeAttribute("aria-describedby"),e&&this.tooltips.delete(e),this.activeTooltip===t&&(this.activeTooltip=null)},this.config.animationDuration))}showValidationError(e,t){this.hideValidationError(e);const n=document.createElement("div");n.className="livecomponent-tooltip livecomponent-tooltip--error",n.setAttribute("role","alert"),n.textContent=t,n.style.cssText=`\n            position: absolute;\n            max-width: ${this.config.maxWidth}px;\n            padding: 0.5rem 0.75rem;\n            background: #dc2626;\n            color: white;\n            border-radius: 0.375rem;\n            font-size: 0.875rem;\n            line-height: 1.4;\n            z-index: ${this.config.zIndex};\n            pointer-events: none;\n            opacity: 0;\n            transition: opacity ${this.config.animationDuration}ms ease;\n            word-wrap: break-word;\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\n        `,document.body.appendChild(n),this.positionTooltip(n,e,"top"),requestAnimationFrame(()=>{n.style.opacity="1"}),e._validationTooltip=n,e.classList.add("livecomponent-error")}hideValidationError(e){const t=e._validationTooltip;t&&(t.style.opacity="0",setTimeout(()=>{t.parentNode&&t.parentNode.removeChild(t),delete e._validationTooltip,e.classList.remove("livecomponent-error")},this.config.animationDuration))}initComponent(e){e.querySelectorAll("[data-tooltip], [title], [aria-label]").forEach(e=>{this.init(e)})}cleanupComponent(e){e.querySelectorAll("[data-tooltip], [title], [aria-label]").forEach(e=>{this.hide(e),e._tooltipCleanup&&(e._tooltipCleanup(),delete e._tooltipCleanup),e.dataset.originalTitle&&(e.setAttribute("title",e.dataset.originalTitle),delete e.dataset.originalTitle)})}updateConfig(e){this.config={...this.config,...e}}};const $t=new class{constructor(){this.loadingStates=new Map,this.skeletonTemplates=new Map,this.config={showDelay:150,transitionDuration:200,preserveContent:!0,opacity:.6}}showLoading(e,t,n={}){if(this.loadingStates.has(e))return;const i=n.showDelay??this.config.showDelay,s=n.fragments||null,r=setTimeout(()=>{this.createSkeletonOverlay(e,t,s,n)},i);this.loadingStates.set(e,{timeoutId:r,element:t,fragments:s,options:n})}createSkeletonOverlay(e,t,n,i){const s=this.getSkeletonTemplate(e,t,n),r=document.createElement("div");r.className="livecomponent-loading-overlay",r.setAttribute("data-component-id",e),r.setAttribute("aria-busy","true"),r.setAttribute("aria-label","Loading..."),r.style.cssText=`\n            position: absolute;\n            top: 0;\n            left: 0;\n            right: 0;\n            bottom: 0;\n            background: rgba(255, 255, 255, ${this.config.opacity});\n            z-index: 10;\n            display: flex;\n            align-items: center;\n            justify-content: center;\n            opacity: 0;\n            transition: opacity ${this.config.transitionDuration}ms ease;\n            pointer-events: none;\n        `,r.innerHTML=s;const o=t.style.position;"static"===getComputedStyle(t).position&&(t.style.position="relative"),t.appendChild(r),requestAnimationFrame(()=>{r.style.opacity="1"});const a=this.loadingStates.get(e);a&&(a.overlay=r,a.originalPosition=o)}getSkeletonTemplate(e,t,n){const i=this.skeletonTemplates.get(e);return i?"function"==typeof i?i(t,n):i:n&&n.length>0?this.createFragmentSkeletons(n):this.createDefaultSkeleton(t)}createDefaultSkeleton(e){const t=e.offsetHeight||200;return`\n            <div class="skeleton-container" style="width: ${e.offsetWidth||"100%"}; height: ${t}px; padding: 1.5rem;">\n                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 1rem;"></div>\n                <div class="skeleton skeleton-text skeleton-text--80" style="margin-bottom: 0.75rem;"></div>\n                <div class="skeleton skeleton-text skeleton-text--60" style="margin-bottom: 0.75rem;"></div>\n                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 1rem;"></div>\n                <div class="skeleton skeleton-text skeleton-text--80"></div>\n            </div>\n        `}createFragmentSkeletons(e){return e.map(e=>`\n            <div class="skeleton-fragment" data-fragment="${e}">\n                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 0.75rem;"></div>\n                <div class="skeleton skeleton-text skeleton-text--80"></div>\n            </div>\n        `).join("")}hideLoading(e){const t=this.loadingStates.get(e);t&&(t.timeoutId&&clearTimeout(t.timeoutId),t.overlay&&(t.overlay.style.opacity="0",setTimeout(()=>{t.overlay&&t.overlay.parentNode&&t.overlay.parentNode.removeChild(t.overlay)},this.config.transitionDuration)),void 0!==t.originalPosition&&(t.element.style.position=t.originalPosition),this.loadingStates.delete(e))}registerTemplate(e,t){this.skeletonTemplates.set(e,t)}unregisterTemplate(e){this.skeletonTemplates.delete(e)}isLoading(e){return this.loadingStates.has(e)}updateConfig(e){this.config={...this.config,...e}}};const Dt=new class{constructor(){this.components=new Map,this.eventHandlers=new Map,this.debounceTimers=new Map,this.domPatcher=Xe,this.accessibilityManager=ut,this.sseClients=new Map,this.componentChannels=new Map,this.lazyLoader=null,this.nestedHandler=null,this.devTools=null,this.errorBoundary=new pt(this),this.requestDeduplicator=new mt,this.config=sharedConfig,this.tooltipManager=tooltipManager,this.actionLoadingManager=actionLoadingManager,this.uiHelper=new LiveComponentUIHelper(this),this.loadingStateManager=new LoadingStateManager(this.actionLoadingManager,ht)}enableDevTools(e){this.devTools=e,console.log("[LiveComponent] DevTools integration enabled")}logActionToDevTools(e,t,n,i,s,r,o=null){this.devTools&&this.devTools.logAction(e,t,n,i,s,r,o)}logEventToDevTools(e,t,n="server"){this.devTools&&this.devTools.logEvent(e,t,n)}initLazyLoading(){this.lazyLoader?console.warn("[LiveComponent] Lazy loading already initialized"):(this.lazyLoader=new rt(this),this.lazyLoader.init(),console.log("[LiveComponent] Lazy loading system initialized"))}initNestedComponents(){this.nestedHandler?console.warn("[LiveComponent] Nested components already initialized"):(this.nestedHandler=new ot(this),this.nestedHandler.init(),console.log("[LiveComponent] Nested components system initialized"))}init(e){const t=e.dataset.liveComponent;if(!t)return;const n={id:t,element:e,pollInterval:parseInt(e.dataset.pollInterval)||null,pollTimer:null,observer:null};this.components.set(t,n),this.setupActionHandlers(e),this.setupFileUploadHandlers(e),n.pollInterval&&this.startPolling(t),this.setupLifecycleObserver(e,t),this.setupSseConnection(e,t),this.setupAccessibility(t,e),this.tooltipManager.initComponent(e),console.log(`[LiveComponent] Initialized: ${t}`)}setupAccessibility(e,t){const n="assertive"===t.dataset.livePolite?"assertive":"polite";this.accessibilityManager.createComponentLiveRegion(e,t,n),console.log(`[LiveComponent] Accessibility features enabled for ${e}`)}setupLifecycleObserver(e,t){const n=this.components.get(t);if(!n)return;const i=new MutationObserver(n=>{document.contains(e)||(console.log(`[LiveComponent] Element removed from DOM: ${t}`),this.callDestroyHook(t),i.disconnect())});e.parentNode&&i.observe(e.parentNode,{childList:!0,subtree:!1}),n.observer=i}setupSseConnection(e,t){const n=e.dataset.sseChannel;if(!n)return;console.log(`[LiveComponent] Setting up SSE for ${t} on channel: ${n}`),this.componentChannels.set(t,n);let i=this.sseClients.get(n);i||(i=new Ze([n],{autoReconnect:!0,heartbeatTimeout:45e3}),this.registerSseHandlers(i,n),i.connect(),this.sseClients.set(n,i),console.log(`[LiveComponent] Created SSE client for channel: ${n}`)),console.log(`[LiveComponent] SSE connection established for ${t}`)}registerSseHandlers(e,t){e.on("component-update",e=>{this.handleSseComponentUpdate(e,t)}),e.on("component-fragments",e=>{this.handleSseComponentFragments(e,t)}),e.on("connected",()=>{console.log(`[LiveComponent] SSE connected to channel: ${t}`),this.updateSseConnectionStatus(t,"connected")}),e.on("disconnected",()=>{console.log(`[LiveComponent] SSE disconnected from channel: ${t}`),this.updateSseConnectionStatus(t,"disconnected")}),e.on("reconnecting",e=>{console.log(`[LiveComponent] SSE reconnecting to channel ${t} (attempt ${e})`),this.updateSseConnectionStatus(t,"reconnecting")}),e.on("error",e=>{console.error(`[LiveComponent] SSE error on channel ${t}:`,e),this.updateSseConnectionStatus(t,"error")})}handleSseComponentUpdate(e,t){const{componentId:n,state:i,html:s,events:r}=e;console.log(`[LiveComponent] SSE update for ${n}:`,{state:i,html:s,events:r});const o=this.components.get(n);if(o)try{this.accessibilityManager.captureFocusState(n,o.element),s&&(o.element.innerHTML=s,this.setupActionHandlers(o.element),this.setupFileUploadHandlers(o.element)),i&&ft(o.element,i),this.accessibilityManager.restoreFocus(n,o.element),this.accessibilityManager.announceUpdate(n,"full"),r&&Array.isArray(r)&&this.handleServerEvents(r),console.log(`[LiveComponent] SSE update applied to ${n}`)}catch(a){console.error(`[LiveComponent] Failed to apply SSE update for ${n}:`,a)}else console.warn(`[LiveComponent] Received SSE update for unknown component: ${n}`)}handleSseComponentFragments(e,t){const{componentId:n,fragments:i}=e;console.log(`[LiveComponent] SSE fragments for ${n}:`,i);const s=this.components.get(n);if(s)try{this.updateFragments(s.element,i),console.log(`[LiveComponent] SSE fragments applied to ${n}`)}catch(r){console.error(`[LiveComponent] Failed to apply SSE fragments for ${n}:`,r)}else console.warn(`[LiveComponent] Received SSE fragments for unknown component: ${n}`)}updateSseConnectionStatus(e,t){this.componentChannels.forEach((n,i)=>{if(n===e){const n=this.components.get(i);if(!n)return;n.element.dataset.sseStatus=t,n.element.dispatchEvent(new CustomEvent("livecomponent:sse:status",{detail:{channel:e,status:t}}))}})}async callDestroyHook(e){const t=this.components.get(e);if(t){try{const n=t.element.dataset.state||"{}",i=JSON.parse(n),s=t.element.dataset.csrfToken,r=JSON.stringify({state:i,_csrf_token:s}),o=`/live-component/${e}/destroy`,a=new Blob([r],{type:"application/json"});navigator.sendBeacon&&navigator.sendBeacon(o,a)?console.log(`[LiveComponent] onDestroy() called via sendBeacon: ${e}`):(await fetch(o,{method:"POST",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest"},body:r}),console.log(`[LiveComponent] onDestroy() called via fetch: ${e}`))}catch(n){console.warn(`[LiveComponent] onDestroy() hook failed: ${e}`,n)}this.destroy(e)}}setupActionHandlers(e){e.querySelectorAll("[data-live-action]").forEach(t=>{if("FORM"===t.tagName)t.addEventListener("submit",async n=>{n.preventDefault();const i=e.dataset.liveComponent,s=t.dataset.liveAction,r={},o=new FormData(t);for(const[e,t]of o.entries())r[e]=t;const a=this.extractFragments(t);await this.executeAction(i,s,r,a)});else if("INPUT"===t.tagName||"TEXTAREA"===t.tagName||"SELECT"===t.tagName){const n="text"===t.type||"email"===t.type||"url"===t.type||"tel"===t.type||"TEXTAREA"===t.tagName?300:0,i=parseInt(t.dataset.liveDebounce)??n;t.addEventListener("input",async n=>{const s=e.dataset.liveComponent,r=t.dataset.liveAction,o=this.extractParams(t);"checkbox"===t.type?o[t.name||"value"]=t.checked?"yes":"no":(t.type,o[t.name||"value"]=t.value);const a=this.extractFragments(t);i>0?this.debouncedAction(s,r,o,i,a):await this.executeAction(s,r,o,a)}),"radio"!==t.type&&"checkbox"!==t.type||t.addEventListener("change",async n=>{const i=e.dataset.liveComponent,s=t.dataset.liveAction,r=this.extractParams(t);"checkbox"===t.type?r[t.name||"value"]=t.checked?"yes":"no":"radio"===t.type&&(r[t.name||"value"]=t.value),await this.executeAction(i,s,r)})}else t.addEventListener("click",async n=>{n.preventDefault();const i=e.dataset.liveComponent,s=t.dataset.liveAction;let r=this.extractParams(t);if("submit"===s||"nextStep"===s||"previousStep"===s){const t=this.collectFormValues(e);console.log("[LiveComponent] Collected form values:",t),r={...t,...r},console.log("[LiveComponent] Final params:",r)}const o=this.extractFragments(t);await this.executeAction(i,s,r,o)})})}debouncedAction(e,t,n,i,s=null){const r=`${e}_${t}`;this.debounceTimers.has(r)&&clearTimeout(this.debounceTimers.get(r));const o=setTimeout(async()=>{await this.executeAction(e,t,n,s),this.debounceTimers.delete(r)},i);this.debounceTimers.set(r,o)}extractParams(e){const t={};return Object.keys(e.dataset).forEach(n=>{if(n.startsWith("param")){const i=n.replace("param","");if(i.endsWith("From")){const s=i.replace(/From$/,"").toLowerCase(),r=e.dataset[n];t[s]="value"===r?e.value:e[r]||e.getAttribute(r)}else{const s=i.toLowerCase();t[s]=e.dataset[n]}}}),t}extractFragments(e){const t=e.dataset.lcFragments;return t?t.split(",").map(e=>e.trim()).filter(Boolean):null}collectFormValues(e){const t={};return e.querySelectorAll("input, textarea, select").forEach(e=>{const n=e.name;n&&("checkbox"===e.type?t[n]=e.checked?"yes":"no":"radio"===e.type?e.checked&&(t[n]=e.value):t[n]=e.value)}),t}async executeAction(e,t,n={},i=null){const s=this.components.get(e);if(!s)return void console.error(`[LiveComponent] Unknown component: ${e}`);const r=this.requestDeduplicator.getPendingRequest(e,t,n);if(r)return console.log(`[LiveComponent] Deduplicating request: ${e}.${t}`),await r;const o=this.requestDeduplicator.getCachedResult(e,t,n);if(o)return console.log(`[LiveComponent] Using cached result: ${e}.${t}`),o;let a=null;const l=performance.now(),c=this.loadingStateManager.getConfig(e);this.loadingStateManager.showLoading(e,s.element,{fragments:i,type:c.type,optimistic:!0});const d=(async()=>{var r;try{const c=gt(s.element)||{id:e,component:"",data:{},version:1},d=c.data||{};ht.applyOptimisticUpdate(e,c,e=>({...e,data:{...e.data,_optimistic:!0}}),{action:t,params:n});a=null==(r=ht.getPendingOperations(e)[0])?void 0:r.id;const h=s.element.dataset.csrfToken;if(!h)throw console.error(`[LiveComponent] Missing CSRF token for component: ${e}`),new Error("CSRF token is required for component actions");const u={method:t,params:n,state:d,_csrf_token:h};i&&Array.isArray(i)&&i.length>0&&(u.fragments=i);const p=await fetch(`/live-component/${e}`,{method:"POST",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest"},body:JSON.stringify(u)});if(!p.ok){const e=await p.text();throw console.error("[LiveComponent] Server error response:",e),new Error(`HTTP ${p.status}: ${p.statusText}`)}const m=await p.text();let g;console.log("[LiveComponent] Raw response:",m.substring(0,200));try{g=JSON.parse(m)}catch(o){throw console.error("[LiveComponent] JSON parse error:",o),console.error("[LiveComponent] Response text:",m),new Error(`Failed to parse JSON response: ${o.message}`)}const f=g.state||{},y=c.version||1,v=f.version||1;if(v!==y+1){if(console.warn(`[LiveComponent] Version conflict: expected ${y+1}, got ${v}`),a){const t=ht.handleConflict(e,a,f,{expectedVersion:y+1,actualVersion:v});t.notification&&this.showConflictNotification(e,t.notification),g.state=t.state}}else a&&ht.confirmOperation(e,a,f);g.fragments?this.updateFragments(s.element,g.fragments):g.html&&(s.element.innerHTML=g.html,this.setupActionHandlers(s.element)),this.tooltipManager.initComponent(s.element),g.state&&ft(s.element,g.state),g.events&&g.events.length>0&&this.handleServerEvents(g.events),console.log(`[LiveComponent] Action executed: ${e}.${t}`,g);const b=performance.now();return this.logActionToDevTools(e,t,n,l,b,!0),this.requestDeduplicator.cacheResult(e,t,n,g),this.loadingStateManager.hideLoading(e),g}catch(c){console.error("[LiveComponent] Action failed:",c);const r=performance.now();if(this.logActionToDevTools(e,t,n,l,r,!1,c.message),a){const t=ht.getSnapshot(e);t&&(ft(s.element,t),ht.clearPendingOperations(e),ht.clearSnapshot(e))}throw this.loadingStateManager.hideLoading(e),await this.errorBoundary.handleError(e,t,c,{params:n,fragments:i}),c}})();return this.requestDeduplicator.registerPendingRequest(e,t,n,d)}updateFragments(e,t){const n=e.dataset.liveComponent;n&&this.accessibilityManager.captureFocusState(n,e);const i=this.domPatcher.patchFragments(e,t);if(n&&this.accessibilityManager.restoreFocus(n,e),Object.keys(t).forEach(t=>{if(i[t]){const n=e.querySelector(`[data-lc-fragment="${t}"]`);n&&this.setupActionHandlers(n)}}),n){const e=Object.keys(t).filter(e=>i[e]);e.length>0&&this.accessibilityManager.announceUpdate(n,"fragment",{fragmentName:e.join(", ")})}const s=Object.values(i).filter(Boolean).length;console.log(`[LiveComponent] Patched ${s}/${Object.keys(t).length} fragments`,i)}handleServerEvents(e){e.forEach(e=>{const{name:t,payload:n,target:i}=e;console.log("[LiveComponent] Server event:",{name:t,payload:n,target:i}),this.logEventToDevTools(t,{payload:n,target:i},"server"),i?this.dispatchToComponent(i,t,n):this.broadcast(t,n)})}dispatchToComponent(e,t,n){(this.eventHandlers.get(t)||[]).forEach(t=>{t.componentId===e&&t.callback(n)})}broadcast(e,t){(this.eventHandlers.get(e)||[]).forEach(e=>{e.callback(t)}),document.dispatchEvent(new CustomEvent(`livecomponent:${e}`,{detail:t}))}on(e,t,n){this.eventHandlers.has(t)||this.eventHandlers.set(t,[]),this.eventHandlers.get(t).push({componentId:e,callback:n}),console.log(`[LiveComponent] Event listener registered: ${e} -> ${t}`)}startPolling(e){const t=this.components.get(e);t&&t.pollInterval&&(t.pollTimer&&clearInterval(t.pollTimer),t.pollTimer=setInterval(async()=>{await this.executeAction(e,"poll",{})},t.pollInterval),console.log(`[LiveComponent] Polling started: ${e} (${t.pollInterval}ms)`))}stopPolling(e){const t=this.components.get(e);t&&t.pollTimer&&(clearInterval(t.pollTimer),t.pollTimer=null,console.log(`[LiveComponent] Polling stopped: ${e}`))}handleError(e,t){const n=this.components.get(e);if(!n)return;const i=`\n            <div class="livecomponent-error" style="padding: 1rem; background: #fee; color: #c00; border: 1px solid #faa; border-radius: 4px;">\n                <strong>LiveComponent Error:</strong> ${t.message}\n            </div>\n        `;n.element.insertAdjacentHTML("beforeend",i),setTimeout(()=>{var e;null==(e=n.element.querySelector(".livecomponent-error"))||e.remove()},5e3)}showConflictNotification(e,t){const n=this.components.get(e);if(!n)return;const i=`\n            <div class="livecomponent-conflict" style="\n                padding: 1rem;\n                background: #fff3cd;\n                color: #856404;\n                border: 1px solid #ffc107;\n                border-radius: 4px;\n                margin-bottom: 1rem;\n                display: flex;\n                align-items: center;\n                justify-content: space-between;\n            ">\n                <div>\n                    <strong>${t.title}</strong>\n                    <p style="margin: 0.5rem 0 0 0;">${t.message}</p>\n                </div>\n                ${t.canRetry?`\n                    <button\n                        class="livecomponent-retry"\n                        style="\n                            padding: 0.5rem 1rem;\n                            background: #ffc107;\n                            color: #000;\n                            border: none;\n                            border-radius: 4px;\n                            cursor: pointer;\n                            margin-left: 1rem;\n                        "\n                        data-operation-id="${t.operation.id}"\n                        data-action="${t.operation.metadata.action}"\n                    >\n                        Retry\n                    </button>\n                `:""}\n            </div>\n        `;if(n.element.insertAdjacentHTML("afterbegin",i),t.canRetry){const i=n.element.querySelector(".livecomponent-retry");i&&i.addEventListener("click",async()=>{var i;null==(i=n.element.querySelector(".livecomponent-conflict"))||i.remove(),await ht.retryOperation(e,t.operation,async t=>await this.executeAction(e,t.action,t.params))})}setTimeout(()=>{var e;null==(e=n.element.querySelector(".livecomponent-conflict"))||e.remove()},8e3),console.log(`[LiveComponent] Conflict notification shown for ${e}`,t)}setupFileUploadHandlers(e){const t=e.dataset.liveComponent;e.querySelectorAll('input[type="file"][data-live-upload]').forEach(e=>{e.addEventListener("change",async e=>{const n=e.target.files;n.length>0&&await this.uploadFile(t,n[0])})}),e.querySelectorAll("[data-live-dropzone]").forEach(e=>{this.setupDropzone(t,e)})}setupDropzone(e,t){["dragenter","dragover","dragleave","drop"].forEach(e=>{t.addEventListener(e,e=>{e.preventDefault(),e.stopPropagation()})}),["dragenter","dragover"].forEach(e=>{t.addEventListener(e,()=>{t.classList.add("drag-over")})}),["dragleave","drop"].forEach(e=>{t.addEventListener(e,()=>{t.classList.remove("drag-over")})}),t.addEventListener("drop",async t=>{const n=t.dataTransfer.files;n.length>0&&await this.uploadFile(e,n[0])})}async uploadFile(e,t,n={}){const i=this.components.get(e);if(i)try{const s=i.element.dataset.state||"{}",r=JSON.parse(s),o=new FormData;o.append("file",t),o.append("state",JSON.stringify(r)),o.append("params",JSON.stringify(n));const a=i.element.dataset.csrfToken;if(!a)throw console.error(`[LiveComponent] Missing CSRF token for upload: ${e}`),new Error("CSRF token is required for file uploads");o.append("_csrf_token",a),this.showUploadProgress(e,0);const l=await fetch(`/live-component/${e}/upload`,{method:"POST",headers:{"X-Requested-With":"XMLHttpRequest"},body:o});if(!l.ok){const e=await l.json();throw new Error(e.error||"Upload failed")}const c=await l.json();if(!c.success)throw new Error(c.error||"Upload failed");c.html&&(i.element.innerHTML=c.html,this.setupActionHandlers(i.element),this.setupFileUploadHandlers(i.element)),c.state&&ft(i.element,c.state),c.events&&c.events.length>0&&this.handleServerEvents(c.events),this.hideUploadProgress(e),console.log(`[LiveComponent] File uploaded: ${e}`,c.file),document.dispatchEvent(new CustomEvent("livecomponent:upload:success",{detail:{componentId:e,file:c.file}}))}catch(s){console.error("[LiveComponent] Upload failed:",s),this.hideUploadProgress(e),this.handleError(e,s),document.dispatchEvent(new CustomEvent("livecomponent:upload:error",{detail:{componentId:e,error:s.message}}))}else console.error(`[LiveComponent] Unknown component: ${e}`)}showUploadProgress(e,t){const n=this.components.get(e);if(!n)return;let i=n.element.querySelector(".livecomponent-upload-progress");if(i){i.querySelector(".progress-bar").style.width=`${t}%`}else{i=document.createElement("div"),i.className="livecomponent-upload-progress",i.style.cssText="\n                position: absolute;\n                top: 0;\n                left: 0;\n                right: 0;\n                height: 3px;\n                background: #e0e0e0;\n                z-index: 1000;\n            ";const e=document.createElement("div");e.className="progress-bar",e.style.cssText=`\n                height: 100%;\n                background: #2196F3;\n                transition: width 0.3s ease;\n                width: ${t}%;\n            `,i.appendChild(e),n.element.style.position="relative",n.element.appendChild(i)}}hideUploadProgress(e){const t=this.components.get(e);if(!t)return;const n=t.element.querySelector(".livecomponent-upload-progress");n&&n.remove()}destroy(e){const t=this.components.get(e);this.stopPolling(e),t&&t.observer&&t.observer.disconnect(),this.cleanupSseConnection(e),this.accessibilityManager.cleanup(e),this.errorBoundary.clearErrorHandler(e),this.requestDeduplicator.clearComponent(e),this.tooltipManager.cleanupComponent(t.element),this.loadingStateManager.hideLoading(e),this.loadingStateManager.clearConfig(e),this.uiHelper.cleanup(e),this.components.delete(e),this.eventHandlers.forEach((t,n)=>{const i=t.filter(t=>t.componentId!==e);this.eventHandlers.set(n,i)}),console.log(`[LiveComponent] Destroyed: ${e}`)}cleanupSseConnection(e){const t=this.componentChannels.get(e);if(!t)return;this.componentChannels.delete(e);let n=!1;for(const[,i]of this.componentChannels)if(i===t){n=!0;break}if(!n){const e=this.sseClients.get(t);e&&(e.disconnect(),this.sseClients.delete(t),console.log(`[LiveComponent] Disconnected SSE client for channel: ${t}`))}}async executeBatch(e,t={}){if(!Array.isArray(e)||0===e.length)throw new Error("Operations must be a non-empty array");const n={operations:e.map(e=>({componentId:e.componentId,method:e.method,params:e.params||{},fragments:e.fragments||null,operationId:e.operationId||null}))};console.log(`[LiveComponent] Executing batch with ${e.length} operations`,n);try{const e=await fetch("/live-component/batch",{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify(n)});if(!e.ok){const t=await e.json();throw new Error(t.error||"Batch request failed")}const i=await e.json();return console.log(`[LiveComponent] Batch completed: ${i.success_count} succeeded, ${i.failure_count} failed`),!1!==t.autoApply&&await this.applyBatchResults(i.results),i}catch(i){throw console.error("[LiveComponent] Batch execution failed:",i),i}}async applyBatchResults(e){for(const n of e){if(!n.success){console.warn("[LiveComponent] Batch operation failed:",n);continue}const e=n.componentId||this.extractComponentIdFromResult(n);if(!e)continue;const i=this.components.get(e);if(i)try{n.fragments?this.updateFragments(i.element,n.fragments):n.html&&(i.element.innerHTML=n.html,this.setupActionHandlers(i.element)),n.state&&ft(i.element,n.state),n.events&&Array.isArray(n.events)&&n.events.forEach(t=>{this.dispatchComponentEvent(e,t.name,t.payload||{})})}catch(t){console.error(`[LiveComponent] Failed to apply batch result for ${e}:`,t)}}}extractComponentIdFromResult(e){return e.componentId||null}queueBatchOperation(e,t={}){this.batchQueue||(this.batchQueue=[],this.batchQueueTimer=null),this.batchQueue.push(e),this.batchQueueTimer&&clearTimeout(this.batchQueueTimer);const n=t.flushDelay||50;this.batchQueueTimer=setTimeout(()=>{this.flushBatchQueue()},n)}async flushBatchQueue(){if(!this.batchQueue||0===this.batchQueue.length)return;const e=[...this.batchQueue];this.batchQueue=[],this.batchQueueTimer=null;try{await this.executeBatch(e)}catch(t){console.error("[LiveComponent] Batch queue flush failed:",t)}}};window.LiveComponent=Dt,"loading"===document.readyState&&document.addEventListener("DOMContentLoaded",()=>{document.querySelectorAll("[data-live-component]").forEach(e=>{Dt.init(e)})});const zt=Object.freeze(Object.defineProperty({__proto__:null,ChunkedUploader:class{constructor(e,t={}){this.componentId=e,this.chunkSize=t.chunkSize||524288,this.maxConcurrentChunks=t.maxConcurrentChunks||3,this.maxRetries=t.maxRetries||3,this.retryDelay=t.retryDelay||1e3,this.enableSSE=!1!==t.enableSSE,this.apiBase=t.apiBase||"/live-component/upload",this.onInitialized=t.onInitialized||(()=>{}),this.onChunkProgress=t.onChunkProgress||(()=>{}),this.onProgress=t.onProgress||(()=>{}),this.onComplete=t.onComplete||(()=>{}),this.onError=t.onError||(()=>{}),this.onAborted=t.onAborted||(()=>{}),this.onSSEProgress=t.onSSEProgress||(()=>{}),this.sessions=new Map,this.activeSession=null,this.sseClient=null,this.userId=null,this.enableSSE&&this.initializeSSE()}initializeSSE(){try{this.userId=this.getUserId(),this.userId&&(this.sseClient=tt([`user:${this.userId}`]),this.sseClient.on("progress",e=>{this.handleSSEProgress(e)}),this.sseClient.isConnected()||this.sseClient.connect())}catch(e){console.warn("[ChunkedUploader] Failed to initialize SSE:",e)}}getUserId(){const e=document.querySelector('meta[name="user-id"]');return e?e.content:document.body.dataset.userId?document.body.dataset.userId:null}handleSSEProgress(e){var t,n;const i=e.session_id,s=this.sessions.get(i);if(s&&e.taskId===i){if(void 0!==(null==(t=e.data)?void 0:t.uploaded_chunks)&&(s.uploadedChunks=e.data.uploaded_chunks),null==(n=e.data)?void 0:n.phase)switch(e.data.phase){case"initialized":s.status=Mt;break;case"uploading":s.status=kt;break;case"completed":s.status=xt;break;case"aborted":s.status=At;break;case"error":s.status=Tt}this.onSSEProgress({sessionId:i,percent:e.percent,message:e.message,data:e.data})}}async upload(e,t){const n=new Pt(e,{chunkSize:this.chunkSize});this.activeSession=n;try{n.totalChunks=Math.ceil(e.size/this.chunkSize);for(let t=0;t<n.totalChunks;t++){const i=t*this.chunkSize,s=Math.min(i+this.chunkSize,e.size)-i;n.chunks.push(new It(t,s,e))}return await this.initializeSession(n),this.sessions.set(n.sessionId,n),n.status=kt,n.startTime=Date.now(),await this.uploadChunks(n),await this.completeUpload(n,t),n.status=xt,n.endTime=Date.now(),this.onComplete({sessionId:n.sessionId,file:n.file,totalBytes:n.totalBytes,duration:n.endTime-n.startTime}),n}catch(i){throw n.status=Tt,n.error=i.message,this.onError({sessionId:n.sessionId,file:n.file,error:i.message}),i}}async initializeSession(e){const t=await fetch(`${this.apiBase}/init`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json","User-Agent":navigator.userAgent},body:JSON.stringify({componentId:this.componentId,fileName:e.file.name,totalSize:e.file.size,chunkSize:this.chunkSize})});if(!t.ok)throw new Error(`Failed to initialize upload session: ${t.status}`);const n=await t.json();if(!n.success)throw new Error(n.error||"Failed to initialize upload session");e.sessionId=n.session_id,e.totalChunks=n.total_chunks,e.expiresAt=new Date(n.expires_at),e.status=Mt,this.onInitialized({sessionId:e.sessionId,totalChunks:e.totalChunks,expiresAt:e.expiresAt})}async uploadChunks(e){const t=e.getPendingChunks();for(;t.length>0;){const n=t.splice(0,this.maxConcurrentChunks);await Promise.all(n.map(t=>this.uploadChunk(e,t)))}}async uploadChunk(e,t){let n=0;for(;n<=this.maxRetries;)try{t.status=vt;const n=await this.readChunk(e.file,t),i=await this.hashChunk(n);return t.hash=i,t.status=bt,await this.uploadChunkData(e,t,n,i),t.status=wt,e.uploadedChunks++,void this.onProgress({sessionId:e.sessionId,progress:e.progress,uploadedChunks:e.uploadedChunks,totalChunks:e.totalChunks,uploadedBytes:e.uploadedBytes,totalBytes:e.totalBytes})}catch(i){if(n++,n>this.maxRetries)throw t.status=St,t.error=i.message,new Error(`Chunk ${t.index} failed after ${this.maxRetries} retries: ${i.message}`);const e=this.retryDelay*Math.pow(2,n-1);await this.sleep(e),t.reset()}}readChunk(e,t){return new Promise((n,i)=>{const s=t.index*this.chunkSize,r=Math.min(s+t.size,e.size),o=e.slice(s,r),a=new FileReader;a.onload=e=>n(e.target.result),a.onerror=e=>i(new Error("Failed to read chunk")),a.readAsArrayBuffer(o)})}async hashChunk(e){const t=await crypto.subtle.digest("SHA-256",e);return Array.from(new Uint8Array(t)).map(e=>e.toString(16).padStart(2,"0")).join("")}uploadChunkData(e,t,n,i){return new Promise((s,r)=>{const o=new FormData;o.append("sessionId",e.sessionId),o.append("chunkIndex",t.index),o.append("chunkHash",i),o.append("chunk",new Blob([n]));const a=new XMLHttpRequest;t.xhr=a,a.upload.addEventListener("progress",n=>{n.lengthComputable&&(t.uploadedBytes=n.loaded,this.onChunkProgress({sessionId:e.sessionId,chunkIndex:t.index,uploadedBytes:n.loaded,totalBytes:n.total,progress:n.loaded/n.total*100}))}),a.addEventListener("load",()=>{if(a.status>=200&&a.status<300)try{const e=JSON.parse(a.responseText);e.success?s(e):r(new Error(e.error||"Chunk upload failed"))}catch(e){r(e)}else r(new Error(`Chunk upload failed with status ${a.status}`))}),a.addEventListener("error",()=>{r(new Error("Network error during chunk upload"))}),a.addEventListener("abort",()=>{r(new Error("Chunk upload cancelled"))}),a.open("POST",`${this.apiBase}/chunk`),a.setRequestHeader("Accept","application/json"),a.setRequestHeader("User-Agent",navigator.userAgent),a.send(o)})}async completeUpload(e,t){e.status=Et;const n=await fetch(`${this.apiBase}/complete`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json","User-Agent":navigator.userAgent},body:JSON.stringify({sessionId:e.sessionId,targetPath:t})});if(!n.ok)throw new Error(`Failed to complete upload: ${n.status}`);const i=await n.json();if(!i.success)throw new Error(i.error||"Failed to complete upload");return i}async abort(e){const t=this.sessions.get(e);if(!t)throw new Error("Session not found");t.chunks.forEach(e=>e.abort());try{await fetch(`${this.apiBase}/abort`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json","User-Agent":navigator.userAgent},body:JSON.stringify({sessionId:e,reason:"User cancelled"})})}catch(n){console.warn("[ChunkedUploader] Failed to notify server of abort:",n)}t.status=At,this.onAborted({sessionId:e,uploadedChunks:t.uploadedChunks,totalChunks:t.totalChunks})}async getStatus(e){const t=await fetch(`${this.apiBase}/status/${e}`,{headers:{Accept:"application/json","User-Agent":navigator.userAgent}});if(!t.ok)throw new Error(`Failed to get upload status: ${t.status}`);const n=await t.json();if(!n.success)throw new Error(n.error||"Failed to get upload status");return n}async resume(e,t,n){const i=await this.getStatus(e),s=new Pt(t,{chunkSize:this.chunkSize});s.sessionId=e,s.totalChunks=i.total_chunks,s.uploadedChunks=i.uploaded_chunks,s.status=kt;for(let r=0;r<s.totalChunks;r++){const e=r*this.chunkSize,n=Math.min(e+this.chunkSize,t.size),o=new It(r,n-e,t);r<i.uploaded_chunks&&(o.status=wt,o.uploadedBytes=o.size),s.chunks.push(o)}return this.sessions.set(e,s),this.activeSession=s,s.startTime=Date.now(),await this.uploadChunks(s),await this.completeUpload(s,n),s.status=xt,s.endTime=Date.now(),this.onComplete({sessionId:s.sessionId,file:s.file,totalBytes:s.totalBytes,duration:s.endTime-s.startTime,resumed:!0}),s}sleep(e){return new Promise(t=>setTimeout(t,e))}destroy(){this.sessions.forEach(e=>{e.canResume&&e.chunks.forEach(e=>e.abort())}),this.sessions.clear(),this.activeSession=null}},ComponentFileUploader:dt,ComponentPlayground:class{constructor(e){if(this.container=document.querySelector(e),!this.container)throw new Error(`Container not found: ${e}`);this.components=[],this.selectedComponent=null,this.componentMetadata=null,this.currentState={},this.previewInstanceId=`playground-${Date.now()}`,this.componentList=null,this.componentSearch=null,this.stateEditor=null,this.previewContainer=null,this.actionTester=null,this.metricsDisplay=null,this.metrics={renderTime:0,stateSize:0,actionExecutions:0}}async init(){this.buildUI(),await this.loadComponents(),this.attachEventListeners()}buildUI(){this.container.innerHTML='\n            <div class="playground">\n                \x3c!-- Header --\x3e\n                <header class="playground__header">\n                    <h1 class="playground__title">LiveComponent Playground</h1>\n                    <p class="playground__subtitle">Interactive development tool for testing LiveComponents</p>\n                </header>\n\n                \x3c!-- Main Layout --\x3e\n                <div class="playground__layout">\n                    \x3c!-- Sidebar: Component Selector --\x3e\n                    <aside class="playground__sidebar">\n                        <div class="playground__search">\n                            <input\n                                type="text"\n                                id="component-search"\n                                class="playground__search-input"\n                                placeholder="Search components..."\n                                autocomplete="off"\n                            />\n                        </div>\n                        <div id="component-list" class="playground__component-list">\n                            <div class="playground__loading">Loading components...</div>\n                        </div>\n                    </aside>\n\n                    \x3c!-- Main Content --\x3e\n                    <main class="playground__main">\n                        \x3c!-- State Editor --\x3e\n                        <section class="playground__section">\n                            <h2 class="playground__section-title">Component State</h2>\n                            <div class="playground__state-editor">\n                                <textarea\n                                    id="state-editor"\n                                    class="playground__textarea"\n                                    placeholder=\'{\n  "property": "value"\n}\'\n                                    rows="10"\n                                ></textarea>\n                                <div class="playground__editor-actions">\n                                    <button id="apply-state" class="playground__button playground__button--primary">\n                                        Apply State\n                                    </button>\n                                    <button id="reset-state" class="playground__button">\n                                        Reset\n                                    </button>\n                                    <button id="format-json" class="playground__button">\n                                        Format JSON\n                                    </button>\n                                </div>\n                                <div id="state-validation" class="playground__validation"></div>\n                            </div>\n                        </section>\n\n                        \x3c!-- Live Preview --\x3e\n                        <section class="playground__section">\n                            <h2 class="playground__section-title">Live Preview</h2>\n                            <div id="preview-container" class="playground__preview">\n                                <div class="playground__empty">\n                                    Select a component to preview\n                                </div>\n                            </div>\n                            <div id="metrics-display" class="playground__metrics"></div>\n                        </section>\n\n                        \x3c!-- Action Tester --\x3e\n                        <section class="playground__section">\n                            <h2 class="playground__section-title">Actions</h2>\n                            <div id="action-tester" class="playground__actions">\n                                <div class="playground__empty">\n                                    Select a component to test actions\n                                </div>\n                            </div>\n                        </section>\n\n                        \x3c!-- Code Generator --\x3e\n                        <section class="playground__section">\n                            <h2 class="playground__section-title">Template Code</h2>\n                            <div class="playground__code-generator">\n                                <pre id="generated-code" class="playground__code"><code>Select a component to generate code</code></pre>\n                                <button id="copy-code" class="playground__button">\n                                    Copy to Clipboard\n                                </button>\n                            </div>\n                        </section>\n                    </main>\n                </div>\n            </div>\n        ',this.componentList=this.container.querySelector("#component-list"),this.componentSearch=this.container.querySelector("#component-search"),this.stateEditor=this.container.querySelector("#state-editor"),this.previewContainer=this.container.querySelector("#preview-container"),this.actionTester=this.container.querySelector("#action-tester"),this.metricsDisplay=this.container.querySelector("#metrics-display")}async loadComponents(){try{const e=await fetch("/playground/api/components"),t=await e.json();this.components=t.components||[],this.renderComponentList(this.components)}catch(e){this.componentList.innerHTML=`\n                <div class="playground__error">\n                    Failed to load components: ${e.message}\n                </div>\n            `}}renderComponentList(e){0!==e.length?this.componentList.innerHTML=e.map(e=>`\n            <div class="playground__component-item" data-component="${e.name}">\n                <div class="playground__component-name">${e.name}</div>\n                <div class="playground__component-meta">\n                    <span class="playground__badge">${e.properties} props</span>\n                    <span class="playground__badge">${e.actions} actions</span>\n                    ${e.has_cache?'<span class="playground__badge playground__badge--cache">cached</span>':""}\n                </div>\n            </div>\n        `).join(""):this.componentList.innerHTML='<div class="playground__empty">No components found</div>'}attachEventListeners(){this.componentList.addEventListener("click",e=>{const t=e.target.closest(".playground__component-item");t&&this.selectComponent(t.dataset.component)}),this.componentSearch.addEventListener("input",e=>{this.filterComponents(e.target.value)}),this.container.querySelector("#apply-state").addEventListener("click",()=>{this.applyState()}),this.container.querySelector("#reset-state").addEventListener("click",()=>{this.resetState()}),this.container.querySelector("#format-json").addEventListener("click",()=>{this.formatJSON()}),this.container.querySelector("#copy-code").addEventListener("click",()=>{this.copyCode()})}filterComponents(e){const t=e.toLowerCase().trim();if(!t)return void this.renderComponentList(this.components);const n=this.components.filter(e=>e.name.toLowerCase().includes(t)||e.class.toLowerCase().includes(t));this.renderComponentList(n)}async selectComponent(e){this.componentList.querySelectorAll(".playground__component-item").forEach(e=>{e.classList.remove("playground__component-item--active")});const t=this.componentList.querySelector(`[data-component="${e}"]`);t&&t.classList.add("playground__component-item--active"),this.selectedComponent=e,await this.loadComponentMetadata(e),this.resetState(),this.renderActions(),this.updateGeneratedCode()}async loadComponentMetadata(e){try{const t=await fetch(`/playground/api/component/${e}`),n=await t.json();n.success?this.componentMetadata=n.data:console.error("Failed to load metadata:",n.error)}catch(t){console.error("Error loading metadata:",t)}}async applyState(){const e=this.stateEditor.value.trim(),t=this.container.querySelector("#state-validation");try{const n=e?JSON.parse(e):{};this.currentState=n,t.innerHTML='<span class="playground__success">✓ Valid JSON</span>',await this.previewComponent()}catch(n){t.innerHTML=`<span class="playground__error">✗ Invalid JSON: ${n.message}</span>`}}resetState(){this.currentState={},this.stateEditor.value="{}",this.container.querySelector("#state-validation").innerHTML="",this.selectedComponent&&this.previewComponent()}formatJSON(){try{const e=JSON.parse(this.stateEditor.value||"{}");this.stateEditor.value=JSON.stringify(e,null,2),this.container.querySelector("#state-validation").innerHTML='<span class="playground__success">✓ Formatted</span>'}catch(e){this.container.querySelector("#state-validation").innerHTML='<span class="playground__error">✗ Invalid JSON</span>'}}async previewComponent(){if(this.selectedComponent){this.previewContainer.innerHTML='<div class="playground__loading">Loading preview...</div>';try{performance.now();const e=await fetch("/playground/api/preview",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({component_name:this.selectedComponent,state:this.currentState,instance_id:this.previewInstanceId})}),t=await e.json();performance.now();t.success?(this.previewContainer.innerHTML=t.html,this.metrics.renderTime=t.render_time_ms,this.metrics.stateSize=JSON.stringify(t.state).length,this.updateMetrics(),window.LiveComponent&&window.LiveComponent.initComponent(this.previewContainer.firstElementChild)):this.previewContainer.innerHTML=`\n                    <div class="playground__error">\n                        Preview failed: ${t.error}\n                    </div>\n                `}catch(e){this.previewContainer.innerHTML=`\n                <div class="playground__error">\n                    Error: ${e.message}\n                </div>\n            `}}}renderActions(){if(!this.componentMetadata||!this.componentMetadata.actions)return void(this.actionTester.innerHTML='<div class="playground__empty">No actions available</div>');const e=this.componentMetadata.actions.filter(e=>!["onMount","onUpdated","onDestroy"].includes(e.name));0!==e.length?(this.actionTester.innerHTML=e.map(e=>`\n            <div class="playground__action">\n                <button\n                    class="playground__button playground__button--action"\n                    data-action="${e.name}"\n                >\n                    ${e.name}()\n                </button>\n                ${e.parameters.length>0?`\n                    <div class="playground__action-params">\n                        ${e.parameters.map(e=>`\n                            <label>\n                                ${e.name} (${e.type}):\n                                <input type="text" data-param="${e.name}" placeholder="${e.type}" />\n                            </label>\n                        `).join("")}\n                    </div>\n                `:""}\n            </div>\n        `).join(""),this.actionTester.querySelectorAll("[data-action]").forEach(e=>{e.addEventListener("click",()=>{this.executeAction(e.dataset.action,e.closest(".playground__action"))})})):this.actionTester.innerHTML='<div class="playground__empty">No actions available</div>'}async executeAction(e,t){const n={};t&&t.querySelectorAll("[data-param]").forEach(e=>{const t=e.dataset.param;let i=e.value;"true"===i?i=!0:"false"===i?i=!1:isNaN(i)||""===i||(i=Number(i)),n[t]=i});try{const t=await fetch("/playground/api/action",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({component_id:`${this.selectedComponent}:${this.previewInstanceId}`,action_name:e,parameters:n,current_state:this.currentState})}),i=await t.json();i.success?(this.currentState=i.new_state,this.stateEditor.value=JSON.stringify(this.currentState,null,2),this.previewContainer.innerHTML=i.html,this.metrics.actionExecutions++,this.updateMetrics(),window.LiveComponent&&window.LiveComponent.initComponent(this.previewContainer.firstElementChild)):alert(`Action failed: ${i.error}`)}catch(i){alert(`Error executing action: ${i.message}`)}}updateMetrics(){this.metricsDisplay.innerHTML=`\n            <div class="playground__metrics-grid">\n                <div class="playground__metric">\n                    <span class="playground__metric-label">Render Time</span>\n                    <span class="playground__metric-value">${this.metrics.renderTime.toFixed(2)}ms</span>\n                </div>\n                <div class="playground__metric">\n                    <span class="playground__metric-label">State Size</span>\n                    <span class="playground__metric-value">${this.metrics.stateSize} bytes</span>\n                </div>\n                <div class="playground__metric">\n                    <span class="playground__metric-label">Actions Executed</span>\n                    <span class="playground__metric-value">${this.metrics.actionExecutions}</span>\n                </div>\n            </div>\n        `}updateGeneratedCode(){if(!this.selectedComponent)return;const e=`\x3c!-- Use in your template --\x3e\n{{{ ${this.selectedComponent} }}}`;this.container.querySelector("#generated-code code").textContent=e}async copyCode(){const e=this.container.querySelector("#generated-code code").textContent;try{await navigator.clipboard.writeText(e);const t=this.container.querySelector("#copy-code"),n=t.textContent;t.textContent="✓ Copied!",setTimeout(()=>{t.textContent=n},2e3)}catch(t){alert("Failed to copy code to clipboard")}}},FileUploadWidget:class{constructor(e,t={}){if(this.container=e,this.componentElement=e.closest("[data-live-id]"),!this.componentElement)throw new Error("FileUploadWidget must be used inside a LiveComponent");this.options={maxFileSize:t.maxFileSize||10485760,allowedMimeTypes:t.allowedMimeTypes||[],allowedExtensions:t.allowedExtensions||[],maxFiles:t.maxFiles||10,showPreviews:!1!==t.showPreviews,showProgress:!1!==t.showProgress,showFileList:!1!==t.showFileList,autoUpload:!1!==t.autoUpload,multiple:!1!==t.multiple,dropZoneText:t.dropZoneText||"Drag & drop files here or click to browse",browseButtonText:t.browseButtonText||"Browse Files",uploadButtonText:t.uploadButtonText||"Upload All",...t},this.files=new Map,this.buildUI(),this.initializeUploader()}buildUI(){var e,t,n;this.container.innerHTML=`\n            <div class="file-upload-widget">\n                \x3c!-- Drop Zone --\x3e\n                <div class="file-upload-dropzone" data-dropzone>\n                    <div class="dropzone-content">\n                        <svg class="dropzone-icon" width="48" height="48" viewBox="0 0 24 24" fill="none" stroke="currentColor">\n                            <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path>\n                            <polyline points="17 8 12 3 7 8"></polyline>\n                            <line x1="12" y1="3" x2="12" y2="15"></line>\n                        </svg>\n                        <p class="dropzone-text">${this.options.dropZoneText}</p>\n                        <button type="button" class="btn btn-primary dropzone-button" data-browse-button>\n                            ${this.options.browseButtonText}\n                        </button>\n                        <input\n                            type="file"\n                            class="dropzone-input"\n                            data-file-input\n                            ${this.options.multiple?"multiple":""}\n                            ${this.options.allowedMimeTypes.length>0?`accept="${this.options.allowedMimeTypes.join(",")}"`:""}\n                            style="display: none;"\n                        />\n                    </div>\n                </div>\n\n                \x3c!-- File List --\x3e\n                ${this.options.showFileList?`\n                <div class="file-upload-list" data-file-list style="display: none;">\n                    <div class="file-list-header">\n                        <h4>Files (0)</h4>\n                        <div class="file-list-actions">\n                            ${this.options.autoUpload?"":`<button type="button" class="btn btn-primary btn-sm" data-upload-all>${this.options.uploadButtonText}</button>`}\n                            <button type="button" class="btn btn-secondary btn-sm" data-clear-all>Clear All</button>\n                        </div>\n                    </div>\n                    <div class="file-list-items" data-file-items></div>\n                </div>\n                `:""}\n\n                \x3c!-- Overall Progress (shown when uploading) --\x3e\n                ${this.options.showProgress?'\n                <div class="file-upload-progress" data-overall-progress style="display: none;">\n                    <div class="progress-info">\n                        <span class="progress-label">Uploading files...</span>\n                        <span class="progress-percentage" data-progress-text>0%</span>\n                    </div>\n                    <div class="progress-bar">\n                        <div class="progress-fill" data-progress-fill style="width: 0%"></div>\n                    </div>\n                </div>\n                ':""}\n            </div>\n        `,this.dropZone=this.container.querySelector("[data-dropzone]"),this.fileInput=this.container.querySelector("[data-file-input]"),this.browseButton=this.container.querySelector("[data-browse-button]"),this.fileList=this.container.querySelector("[data-file-list]"),this.fileItems=this.container.querySelector("[data-file-items]"),this.overallProgress=this.container.querySelector("[data-overall-progress]"),this.progressFill=this.container.querySelector("[data-progress-fill]"),this.progressText=this.container.querySelector("[data-progress-text]"),this.uploadAllButton=this.container.querySelector("[data-upload-all]"),this.clearAllButton=this.container.querySelector("[data-clear-all]"),null==(e=this.browseButton)||e.addEventListener("click",()=>this.fileInput.click()),null==(t=this.uploadAllButton)||t.addEventListener("click",()=>this.uploader.uploadAll()),null==(n=this.clearAllButton)||n.addEventListener("click",()=>this.clearAll())}initializeUploader(){this.uploader=new dt(this.componentElement,{...this.options,dropZone:this.dropZone,fileInput:this.fileInput,onFileAdded:e=>this.handleFileAdded(e),onFileRemoved:e=>this.handleFileRemoved(e),onUploadStart:e=>this.handleUploadStart(e),onUploadProgress:e=>this.handleUploadProgress(e),onUploadComplete:e=>this.handleUploadComplete(e),onUploadError:e=>this.handleUploadError(e),onAllUploadsComplete:e=>this.handleAllUploadsComplete(e)})}handleFileAdded({fileId:e,file:t,progress:n}){if(!this.options.showFileList)return;this.fileList&&(this.fileList.style.display="block");const i=this.createFileElement(e,t,n);this.fileItems.appendChild(i),this.files.set(e,i),this.updateFileCount()}handleFileRemoved({fileId:e}){const t=this.files.get(e);t&&(t.remove(),this.files.delete(e)),this.updateFileCount(),0===this.files.size&&this.fileList&&(this.fileList.style.display="none")}handleUploadStart({fileId:e}){this.updateFileStatus(e,"uploading"),this.overallProgress&&(this.overallProgress.style.display="block")}handleUploadProgress({fileId:e,percentage:t,uploadedBytes:n,totalBytes:i,uploadSpeed:s,remainingTime:r}){const o=this.files.get(e);if(o){const e=o.querySelector(".file-progress-fill"),n=o.querySelector(".file-progress-text");e&&(e.style.width=`${t}%`),n&&(n.textContent=`${t}%`)}const a=this.uploader.getStats();this.progressFill&&(this.progressFill.style.width=`${a.overallProgress}%`),this.progressText&&(this.progressText.textContent=`${a.overallProgress}%`)}handleUploadComplete({fileId:e,response:t}){this.updateFileStatus(e,"complete")}handleUploadError({fileId:e,error:t}){this.updateFileStatus(e,"error",t)}handleAllUploadsComplete({totalFiles:e,successCount:t,errorCount:n}){setTimeout(()=>{this.overallProgress&&(this.overallProgress.style.display="none")},2e3)}createFileElement(e,t,n){const i=document.createElement("div");i.className="file-item",i.dataset.fileId=e;const s=n.error?"error":"pending";i.innerHTML=`\n            <div class="file-preview">\n                ${this.options.showPreviews&&t.type.startsWith("image/")?`<img class="file-thumbnail" src="${URL.createObjectURL(t)}" alt="${t.name}" />`:this.getFileIconSvg(t.type)}\n            </div>\n            <div class="file-info">\n                <div class="file-name" title="${t.name}">${this.truncateFileName(t.name,40)}</div>\n                <div class="file-meta">\n                    <span class="file-size">${this.formatBytes(t.size)}</span>\n                    <span class="file-status" data-status="${s}">${n.error||"Pending"}</span>\n                </div>\n                ${this.options.showProgress?'\n                <div class="file-progress" style="display: none;">\n                    <div class="file-progress-bar">\n                        <div class="file-progress-fill" style="width: 0%"></div>\n                    </div>\n                    <span class="file-progress-text">0%</span>\n                </div>\n                ':""}\n                ${n.error?`\n                <div class="file-error">${n.error}</div>\n                `:""}\n            </div>\n            <div class="file-actions">\n                <button type="button" class="btn-icon" data-remove-file title="Remove">\n                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor">\n                        <line x1="18" y1="6" x2="6" y2="18"></line>\n                        <line x1="6" y1="6" x2="18" y2="18"></line>\n                    </svg>\n                </button>\n            </div>\n        `;return i.querySelector("[data-remove-file]").addEventListener("click",()=>this.uploader.removeFile(e)),i}updateFileStatus(e,t,n=null){const i=this.files.get(e);if(!i)return;const s=i.querySelector(".file-status"),r=i.querySelector(".file-progress"),o=i.querySelector(".file-error");if(s){s.dataset.status=t;const e={pending:"Pending",uploading:"Uploading...",complete:"Complete",error:"Error"}[t]||t;s.textContent=e}r&&(r.style.display="uploading"===t?"flex":"none"),"error"===t&&n&&o&&(o.textContent=n,o.style.display="block"),i.classList.remove("file-uploading","file-complete","file-error"),"uploading"===t&&i.classList.add("file-uploading"),"complete"===t&&i.classList.add("file-complete"),"error"===t&&i.classList.add("file-error")}updateFileCount(){const e=this.container.querySelector(".file-list-header h4");e&&(e.textContent=`Files (${this.files.size})`)}clearAll(){this.uploader.clearAll(),this.fileItems.innerHTML="",this.files.clear(),this.fileList&&(this.fileList.style.display="none"),this.updateFileCount()}formatBytes(e){if(0===e)return"0 B";const t=Math.floor(Math.log(e)/Math.log(1024));return Math.round(e/Math.pow(1024,t)*100)/100+" "+["B","KB","MB","GB"][t]}truncateFileName(e,t){if(e.length<=t)return e;const n=e.split(".").pop();return`${e.substring(0,e.length-n.length-1).substring(0,t-n.length-4)}...${n}`}getFileIconSvg(e){return'\n            <svg class="file-icon" width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor">\n                <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path>\n                <polyline points="14 2 14 8 20 8"></polyline>\n            </svg>\n        '}destroy(){this.uploader.destroy(),this.container.innerHTML="",this.files.clear()}},LiveComponent:Dt,LiveComponentUIHelper:class{constructor(e){this.manager=e,this.uiManager=Ge,this.activeDialogs=new Map,this.activeNotifications=new Map}showDialog(e,t={}){const{title:n="",content:i="",size:s="medium",buttons:r=[],closeOnBackdrop:o=!0,closeOnEscape:a=!0,onClose:l=null,onConfirm:c=null}=t,d=this.createDialogContent(n,i,r,{onClose:l,onConfirm:c}),h=this.uiManager.open("modal",{content:d,className:`livecomponent-dialog livecomponent-dialog--${s}`,onClose:()=>{l&&l(),this.activeDialogs.delete(e)}});return this.activeDialogs.set(e,h),h}showConfirm(e,t={}){return new Promise(n=>{const{title:i="Confirm",message:s="Are you sure?",confirmText:r="Confirm",cancelText:o="Cancel",confirmClass:a="btn-primary",cancelClass:l="btn-secondary"}=t,c=[{text:o,class:l,action:()=>{this.closeDialog(e),n(!1)}},{text:r,class:a,action:()=>{this.closeDialog(e),n(!0)}}];this.showDialog(e,{title:i,content:`<p>${s}</p>`,buttons:c,size:"small"})})}showAlert(e,t={}){const{title:n="Alert",message:i="",buttonText:s="OK",type:r="info"}=t,o=[{text:s,class:`btn-${r}`,action:()=>{this.closeDialog(e)}}];return this.showDialog(e,{title:n,content:`<p class="alert-message alert-message--${r}">${i}</p>`,buttons:o,size:"small"})}closeDialog(e){const t=this.activeDialogs.get(e);t&&"function"==typeof t.close&&(t.close(),this.activeDialogs.delete(e))}showNotification(e,t={}){const{message:n="",type:i="info",duration:s=5e3,position:r="top-right",action:o=null}=t,a=document.createElement("div");a.className=`livecomponent-notification livecomponent-notification--${i} livecomponent-notification--${r}`,a.setAttribute("role","alert"),a.setAttribute("aria-live","polite"),a.innerHTML=`\n            <div class="notification-content">\n                <span class="notification-message">${n}</span>\n                ${o?`<button class="notification-action">${o.text}</button>`:""}\n                <button class="notification-close" aria-label="Close">×</button>\n            </div>\n        `,a.style.cssText=`\n            position: fixed;\n            ${r.includes("top")?"top":"bottom"}: 1rem;\n            ${r.includes("left")?"left":"right"}: 1rem;\n            max-width: 400px;\n            padding: 1rem;\n            background: ${this.getNotificationColor(i)};\n            color: white;\n            border-radius: 0.5rem;\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);\n            z-index: 10000;\n            opacity: 0;\n            transform: translateY(${r.includes("top")?"-20px":"20px"});\n            transition: opacity 0.3s ease, transform 0.3s ease;\n        `,document.body.appendChild(a),requestAnimationFrame(()=>{a.style.opacity="1",a.style.transform="translateY(0)"});if(a.querySelector(".notification-close").addEventListener("click",()=>{this.hideNotification(a)}),o){a.querySelector(".notification-action").addEventListener("click",()=>{o.handler&&o.handler(),this.hideNotification(a)})}return s>0&&setTimeout(()=>{this.hideNotification(a)},s),this.activeNotifications.set(e,a),a}hideNotification(e){const t="string"==typeof e?this.activeNotifications.get(e):e;t&&(t.style.opacity="0",t.style.transform=`translateY(${t.classList.contains("livecomponent-notification--top")?"-20px":"20px"})`,setTimeout(()=>{t.parentNode&&t.parentNode.removeChild(t);for(const[e,n]of this.activeNotifications.entries())if(n===t){this.activeNotifications.delete(e);break}},300))}createDialogContent(e,t,n,i){const s=n.map((e,t)=>{const n=e.class||"btn-secondary";return e.action,`<button class="btn ${n}" data-dialog-action="${t}">${e.text||"Button"}</button>`}).join("");return`\n            <div class="livecomponent-dialog-content">\n                ${e?`<div class="dialog-header"><h3>${e}</h3></div>`:""}\n                <div class="dialog-body">${t}</div>\n                ${n.length>0?`<div class="dialog-footer">${s}</div>`:""}\n            </div>\n        `}getNotificationColor(e){const t={info:"#3b82f6",success:"#10b981",warning:"#f59e0b",error:"#ef4444"};return t[e]||t.info}showLoadingDialog(e,t="Loading..."){return this.showDialog(e,{title:"",content:`\n                <div class="loading-dialog">\n                    <div class="spinner"></div>\n                    <p>${t}</p>\n                </div>\n            `,size:"small",buttons:[],closeOnBackdrop:!1,closeOnEscape:!1})}cleanup(e){this.closeDialog(e),this.hideNotification(e)}},LoadingStateManager:class{constructor(e,t){this.actionLoadingManager=e,this.optimisticStateManager=t,this.loadingConfigs=new Map,this.config={defaultType:"skeleton",showDelay:150,hideDelay:0}}configure(e,t){this.loadingConfigs.set(e,{type:t.type||this.config.defaultType,showDelay:t.showDelay??this.config.showDelay,hideDelay:t.hideDelay??this.config.hideDelay,template:t.template||null,...t})}showLoading(e,t,n={}){const i=this.loadingConfigs.get(e)||{type:this.config.defaultType,showDelay:this.config.showDelay},s=n.type||i.type;if("none"===s)return;if(!(this.optimisticStateManager.getPendingOperations(e).length>0&&!1!==n.optimistic))switch(s){case"skeleton":this.actionLoadingManager.showLoading(e,t,{...n,showDelay:i.showDelay});break;case"spinner":this.showSpinner(e,t,i);break;case"progress":this.showProgress(e,t,i);break;default:this.actionLoadingManager.showLoading(e,t,n)}}hideLoading(e){this.actionLoadingManager.hideLoading(e),this.hideSpinner(e),this.hideProgress(e)}showSpinner(e,t,n){this.hideSpinner(e);const i=document.createElement("div");i.className="livecomponent-loading-spinner",i.setAttribute("data-component-id",e),i.setAttribute("aria-busy","true"),i.setAttribute("aria-label","Loading..."),i.innerHTML='\n            <div class="spinner"></div>\n            <span class="spinner-text">Loading...</span>\n        ',i.style.cssText=`\n            position: absolute;\n            top: 0;\n            left: 0;\n            right: 0;\n            bottom: 0;\n            background: rgba(255, 255, 255, 0.8);\n            display: flex;\n            flex-direction: column;\n            align-items: center;\n            justify-content: center;\n            gap: 1rem;\n            z-index: 10;\n            opacity: 0;\n            transition: opacity ${this.config.showDelay}ms ease;\n        `,"static"===getComputedStyle(t).position&&(t.style.position="relative"),t.appendChild(i),requestAnimationFrame(()=>{i.style.opacity="1"});const s=this.loadingConfigs.get(e)||{};s.spinner=i,this.loadingConfigs.set(e,s)}hideSpinner(e){const t=this.loadingConfigs.get(e);if(!t||!t.spinner)return;const n=t.spinner;n.style.opacity="0",setTimeout(()=>{n.parentNode&&n.parentNode.removeChild(n),delete t.spinner},200)}showProgress(e,t,n){this.hideProgress(e);const i=document.createElement("div");i.className="livecomponent-loading-progress",i.setAttribute("data-component-id",e),i.setAttribute("aria-busy","true"),i.innerHTML='\n            <div class="progress-bar" style="width: 0%;"></div>\n        ',i.style.cssText=`\n            position: absolute;\n            top: 0;\n            left: 0;\n            right: 0;\n            height: 3px;\n            background: #e0e0e0;\n            z-index: 10;\n            opacity: 0;\n            transition: opacity ${this.config.showDelay}ms ease;\n        `;i.querySelector(".progress-bar").style.cssText="\n            height: 100%;\n            background: #2196F3;\n            transition: width 0.3s ease;\n        ","static"===getComputedStyle(t).position&&(t.style.position="relative"),t.appendChild(i),requestAnimationFrame(()=>{i.style.opacity="1",this.updateProgress(e,30)});const s=this.loadingConfigs.get(e)||{};s.progress=i,this.loadingConfigs.set(e,s)}updateProgress(e,t){const n=this.loadingConfigs.get(e);if(!n||!n.progress)return;const i=n.progress.querySelector(".progress-bar");i&&(i.style.width=`${Math.min(100,Math.max(0,t))}%`)}hideProgress(e){const t=this.loadingConfigs.get(e);if(!t||!t.progress)return;const n=t.progress;this.updateProgress(e,100),setTimeout(()=>{n.style.opacity="0",setTimeout(()=>{n.parentNode&&n.parentNode.removeChild(n),delete t.progress},200)},300)}getConfig(e){return this.loadingConfigs.get(e)||{type:this.config.defaultType,showDelay:this.config.showDelay}}clearConfig(e){this.hideLoading(e),this.loadingConfigs.delete(e)}},actionLoadingManager:$t,default:Dt,definition:{name:"livecomponent",version:"1.0.0",dependencies:[],provides:["LiveComponent"],priority:0},init:async function(e={},t={}){console.log("[LiveComponent] Module initializing..."),ut.initialize(),Dt.initLazyLoading(),Dt.initNestedComponents();const n=document.querySelectorAll("[data-live-component]");console.log(`[LiveComponent] Found ${n.length} regular components to initialize`),n.forEach(e=>{Dt.init(e)});const i=document.querySelectorAll("[data-live-component-lazy]");if(console.log(`[LiveComponent] Found ${i.length} lazy components (will load on demand)`),Dt.nestedHandler){const e=Dt.nestedHandler.getStats();console.log(`[LiveComponent] Nested components: ${e.child_components} children across ${e.root_components} roots (max depth: ${e.max_nesting_depth})`)}const s=ut.getStats();return console.log(`[LiveComponent] Accessibility: ${s.component_live_regions} component regions, ${s.tracked_focus_states} tracked focus states`),console.log("[LiveComponent] Module initialized"),{manager:Dt,state:t}},initElement:function(e,t={}){console.log("[LiveComponent] Initializing element with data-module:",e);const n=e.querySelectorAll("[data-live-component]");return 0===n.length&&e.hasAttribute("data-live-component")?Dt.init(e):n.forEach(e=>Dt.init(e)),Dt},tooltipManager:Lt},Symbol.toStringTag,{value:"Module"}));const Rt=Object.freeze(Object.defineProperty({__proto__:null,init:function(e={}){d.log("Noise Toggle Init",e);const{selector:t=".noise-overlay",toggleKey:n="g",className:i="grainy",enableTransition:s=!0}=e,r=document.body,o=document.querySelector(t);if(!o)return;function a(){s?o.classList.toggle("hidden",!r.classList.contains(i)):o.style.display=r.classList.contains(i)?"block":"none"}a(),document.addEventListener("keydown",e=>{var t;e.key.toLowerCase()!==n||e.ctrlKey||e.metaKey||e.altKey||(t=e.target,["input","textarea"].includes(t.tagName.toLowerCase()))||(r.classList.toggle(i),a())})}},Symbol.toStringTag,{value:"Module"}));const Ot=Object.freeze(Object.defineProperty({__proto__:null,init:function(e={}){d.info("Parallax init");const t={selector:"[data-parallax]",speedAttr:"data-parallax-speed",defaultSpeed:.5,...e},n=document.querySelectorAll(t.selector);l("parallax",function(){const e=window.scrollY;n.forEach(n=>{const i=parseFloat(n.getAttribute(t.speedAttr))||t.defaultSpeed,s=e*i;n.style.transform=`translateY(${s}px)`})},{autoStart:!0})}},Symbol.toStringTag,{value:"Module"}));class Ft{constructor(e={}){this.enabled=e.enabled??!1,this.maxSamples=e.maxSamples??1e3,this.samplingInterval=e.samplingInterval??10,this.autoStart=e.autoStart??!1,this.samples=[],this.timeline=[],this.marks=new Map,this.measures=new Map,this.isRecording=!1,this.recordingStartTime=null,this.autoStart&&this.enabled&&this.start()}start(){this.isRecording?console.warn("[PerformanceProfiler] Already recording"):(this.isRecording=!0,this.recordingStartTime=performance.now(),this.samples=[],this.timeline=[],console.log("[PerformanceProfiler] Started recording"))}stop(){if(!this.isRecording)return console.warn("[PerformanceProfiler] Not recording"),null;this.isRecording=!1;const e={duration:performance.now()-this.recordingStartTime,samples:this.samples,timeline:this.timeline,marks:Array.from(this.marks.entries()),measures:Array.from(this.measures.entries()),summary:this.generateSummary()};return console.log("[PerformanceProfiler] Stopped recording",e),e}mark(e,t={}){if(!this.isRecording&&!this.enabled)return;const n=performance.now(),i={name:e,timestamp:n,relativeTime:n-this.recordingStartTime,metadata:t};this.marks.set(e,i),performance.mark&&performance.mark(e),this.timeline.push({type:"mark",...i})}measure(e,t,n=null){var i;if(!this.isRecording&&!this.enabled)return;const s=this.marks.get(t);if(!s)return void console.warn(`[PerformanceProfiler] Start mark "${t}" not found`);const r=n?null==(i=this.marks.get(n))?void 0:i.timestamp:performance.now();if(!r)return void console.warn(`[PerformanceProfiler] End mark "${n}" not found`);const o={name:e,startMark:t,endMark:n,duration:r-s.timestamp,startTime:s.timestamp,endTime:r,relativeStartTime:s.relativeTime,relativeEndTime:r-this.recordingStartTime};if(this.measures.set(e,o),performance.measure&&n)try{performance.measure(e,t,n)}catch(a){}this.timeline.push({type:"measure",...o})}sample(e,t=[],n=0){this.isRecording&&(this.samples.length>=this.maxSamples?console.warn("[PerformanceProfiler] Max samples reached"):this.samples.push({timestamp:performance.now(),relativeTime:performance.now()-this.recordingStartTime,functionName:e,stackTrace:t,duration:n}))}generateFlamegraph(){if(0===this.samples.length)return null;const e={name:"(root)",value:0,children:[]};for(const t of this.samples){let n=e;const i=[t.functionName,...t.stackTrace].reverse();for(const e of i){let i=n.children.find(t=>t.name===e);i||(i={name:e,value:0,children:[]},n.children.push(i)),i.value+=t.duration||1,n=i}}return e}generateTimeline(){return this.timeline.map(e=>({...e,category:this.categorizeEvent(e),color:this.getEventColor(e)}))}generateSummary(){const e=Array.from(this.measures.values()).map(e=>e.duration);if(0===e.length)return{totalMeasures:0,totalSamples:this.samples.length,totalDuration:0};const t=e.reduce((e,t)=>e+t,0),n=t/e.length,i=Math.max(...e),s=Math.min(...e),r=[...e].sort((e,t)=>e-t),o=r[Math.floor(.5*r.length)],a=r[Math.floor(.9*r.length)],l=r[Math.floor(.99*r.length)];return{totalMeasures:this.measures.size,totalSamples:this.samples.length,totalDuration:t,avgDuration:n,maxDuration:i,minDuration:s,percentiles:{p50:o,p90:a,p99:l}}}exportToChromeTrace(){const e=[];for(const[t,n]of this.marks.entries())e.push({name:t,cat:"mark",ph:"R",ts:1e3*n.timestamp,pid:1,tid:1,args:n.metadata});for(const[t,n]of this.measures.entries())e.push({name:t,cat:"measure",ph:"B",ts:1e3*n.startTime,pid:1,tid:1}),e.push({name:t,cat:"measure",ph:"E",ts:1e3*n.endTime,pid:1,tid:1});for(const t of this.samples)e.push({name:t.functionName,cat:"sample",ph:"X",ts:1e3*t.timestamp,dur:1e3*(t.duration||1),pid:1,tid:1,args:{stackTrace:t.stackTrace}});return{traceEvents:e.sort((e,t)=>e.ts-t.ts),displayTimeUnit:"ms",metadata:{"clock-domain":"PERFORMANCE_NOW"}}}categorizeEvent(e){return"mark"===e.type?e.name.includes("action")?"action":e.name.includes("render")?"render":e.name.includes("state")?"state":"other":"measure"===e.type?e.duration>100?"slow":e.duration>16?"normal":"fast":"unknown"}getEventColor(e){return{action:"#4CAF50",render:"#2196F3",state:"#FF9800",slow:"#F44336",normal:"#FFC107",fast:"#8BC34A",other:"#9E9E9E",unknown:"#607D8B"}[this.categorizeEvent(e)]||"#607D8B"}clear(){this.samples=[],this.timeline=[],this.marks.clear(),this.measures.clear(),this.recordingStartTime=null,performance.clearMarks&&performance.clearMarks(),performance.clearMeasures&&performance.clearMeasures()}getStatus(){return{enabled:this.enabled,isRecording:this.isRecording,samplesCount:this.samples.length,marksCount:this.marks.size,measuresCount:this.measures.size,timelineEventsCount:this.timeline.length,recordingDuration:this.isRecording?performance.now()-this.recordingStartTime:0}}}class _t extends Ft{constructor(e,t={}){super(t),this.component=e,this.actionCallDepth=0,this.enabled&&this.instrumentComponent()}instrumentComponent(){const e=this.component.call.bind(this.component);if(this.component.call=(t,n,i)=>{this.actionCallDepth++;const s=`action:${t}:${this.actionCallDepth}`;this.mark(`${s}:start`,{actionName:t,params:n,depth:this.actionCallDepth});const r=e(t,n,i);return r instanceof Promise?r.finally(()=>{this.mark(`${s}:end`),this.measure(`action:${t}`,`${s}:start`,`${s}:end`),this.actionCallDepth--}):(this.mark(`${s}:end`),this.measure(`action:${t}`,`${s}:start`,`${s}:end`),this.actionCallDepth--,r)},this.component.state){const e=this.component.state.set.bind(this.component.state);this.component.state.set=(t,n)=>(this.mark(`state:set:${t}`,{key:t,value:n}),e(t,n))}if(this.component.render){const e=this.component.render.bind(this.component);this.component.render=()=>{this.mark("render:start");const t=e();return t instanceof Promise?t.finally(()=>{this.mark("render:end"),this.measure("render","render:start","render:end")}):(this.mark("render:end"),this.measure("render","render:start","render:end"),t)}}}}class Bt{constructor(e,t={}){if(this.container="string"==typeof e?document.querySelector(e):e,!this.container)throw new Error("Container element not found");this.options={width:t.width??this.container.clientWidth,height:t.height??400,barHeight:t.barHeight??20,barPadding:t.barPadding??2,colorScheme:t.colorScheme??"category",minWidth:t.minWidth??.5,...t},this.data=null,this.svg=null,this.tooltip=null,this.selectedNode=null,this.init()}init(){this.svg=document.createElementNS("http://www.w3.org/2000/svg","svg"),this.svg.setAttribute("width",this.options.width),this.svg.setAttribute("height",this.options.height),this.svg.style.fontFamily="monospace",this.svg.style.fontSize="12px",this.tooltip=document.createElement("div"),this.tooltip.style.position="absolute",this.tooltip.style.padding="8px",this.tooltip.style.background="rgba(0, 0, 0, 0.8)",this.tooltip.style.color="white",this.tooltip.style.borderRadius="4px",this.tooltip.style.pointerEvents="none",this.tooltip.style.display="none",this.tooltip.style.zIndex="1000",this.tooltip.style.fontSize="12px",this.container.style.position="relative",this.container.appendChild(this.svg),this.container.appendChild(this.tooltip)}render(e){if(this.data=e,this.clear(),!e)return;const t=this.calculateTotalValue(e);this.renderNode(e,0,0,this.options.width,t)}renderNode(e,t,n,i,s){const{barHeight:r,barPadding:o,minWidth:a}=this.options;if(i<a)return;const l=document.createElementNS("http://www.w3.org/2000/svg","rect");l.setAttribute("x",t),l.setAttribute("y",n),l.setAttribute("width",i),l.setAttribute("height",r-o),l.setAttribute("fill",this.getColor(e)),l.setAttribute("stroke","#fff"),l.setAttribute("stroke-width","0.5"),l.style.cursor="pointer",l.addEventListener("mouseenter",t=>this.showTooltip(t,e)),l.addEventListener("mouseleave",()=>this.hideTooltip()),l.addEventListener("click",()=>this.selectNode(e)),this.svg.appendChild(l);const c=document.createElementNS("http://www.w3.org/2000/svg","text");if(c.setAttribute("x",t+4),c.setAttribute("y",n+r/2+4),c.setAttribute("fill",this.getTextColor(e)),c.setAttribute("pointer-events","none"),c.textContent=this.truncateText(e.name,i),this.svg.appendChild(c),e.children&&e.children.length>0){let o=t;const a=n+r;for(const t of e.children){const n=t.value/e.value*i;this.renderNode(t,o,a,n,s),o+=n}}}calculateTotalValue(e){return e.children&&0!==e.children.length?e.children.reduce((e,t)=>e+this.calculateTotalValue(t),0):e.value}getColor(e){if("monochrome"===this.options.colorScheme)return"#3b82f6";if("duration"===this.options.colorScheme){const t=Math.min(e.value/100,1);return`rgb(${Math.floor(255*t)}, ${Math.floor(255*(1-t))}, 100)`}const t={action:"#4CAF50",render:"#2196F3",state:"#FF9800",network:"#9C27B0",dom:"#F44336",compute:"#00BCD4"};for(const[n,i]of Object.entries(t))if(e.name.toLowerCase().includes(n))return i;return this.hashColor(e.name)}getTextColor(e){return"#fff"}hashColor(e){let t=0;for(let n=0;n<e.length;n++)t=e.charCodeAt(n)+((t<<5)-t);return`hsl(${t%360}, 70%, 50%)`}truncateText(e,t){const n=Math.floor(t/7)-2;return e.length<=n?e:e.substring(0,n)+"…"}showTooltip(e,t){const n=this.data?(t.value/this.calculateTotalValue(this.data)*100).toFixed(2):"0";this.tooltip.innerHTML=`\n            <strong>${t.name}</strong><br>\n            Time: ${t.value.toFixed(2)}ms<br>\n            ${n}% of total<br>\n            ${t.children?`${t.children.length} child(ren)`:"Leaf node"}\n        `,this.tooltip.style.display="block",this.tooltip.style.left=`${e.pageX+10}px`,this.tooltip.style.top=`${e.pageY+10}px`}hideTooltip(){this.tooltip.style.display="none"}selectNode(e){this.selectedNode=e,console.log("[Flamegraph] Selected node:",e)}clear(){for(;this.svg.firstChild;)this.svg.removeChild(this.svg.firstChild)}exportSVG(){return this.svg.outerHTML}async exportPNG(){const e=(new XMLSerializer).serializeToString(this.svg),t=document.createElement("canvas");t.width=this.options.width,t.height=this.options.height;const n=t.getContext("2d"),i=new Image;return new Promise((s,r)=>{i.onload=()=>{n.drawImage(i,0,0),t.toBlob(s,"image/png")},i.onerror=r,i.src="data:image/svg+xml;base64,"+btoa(e)})}}class Nt{constructor(e,t={}){if(this.container="string"==typeof e?document.querySelector(e):e,!this.container)throw new Error("Container element not found");this.options={width:t.width??this.container.clientWidth,height:t.height??200,trackHeight:t.trackHeight??30,padding:t.padding??{top:20,right:20,bottom:30,left:60},...t},this.events=[],this.canvas=null,this.ctx=null,this.tooltip=null,this.scale={x:1,y:1},this.offset={x:0,y:0},this.init()}init(){this.canvas=document.createElement("canvas"),this.canvas.width=this.options.width,this.canvas.height=this.options.height,this.canvas.style.cursor="crosshair",this.ctx=this.canvas.getContext("2d"),this.tooltip=document.createElement("div"),this.tooltip.style.position="absolute",this.tooltip.style.padding="8px",this.tooltip.style.background="rgba(0, 0, 0, 0.8)",this.tooltip.style.color="white",this.tooltip.style.borderRadius="4px",this.tooltip.style.pointerEvents="none",this.tooltip.style.display="none",this.tooltip.style.zIndex="1000",this.tooltip.style.fontSize="12px",this.container.style.position="relative",this.container.appendChild(this.canvas),this.container.appendChild(this.tooltip),this.canvas.addEventListener("mousemove",this.handleMouseMove.bind(this)),this.canvas.addEventListener("mouseleave",this.handleMouseLeave.bind(this))}render(e){if(this.events=e,this.clear(),!e||0===e.length)return;const t=e.map(e=>e.timestamp||e.relativeTime||0),n=Math.min(...t),i=Math.max(...t),s=i-n,{padding:r}=this.options,o=this.options.width-r.left-r.right,a=this.options.height-r.top-r.bottom;this.scale.x=o/s,this.drawAxes(n,i,s);const l=this.organizeIntoTracks(e);this.scale.y=a/l.length,l.forEach((e,t)=>{e.forEach(e=>{this.drawEvent(e,t,n)})})}organizeIntoTracks(e){const t=[],n=[...e].sort((e,t)=>(e.timestamp||e.relativeTime||0)-(t.timestamp||t.relativeTime||0));for(const i of n){const e=i.timestamp||i.relativeTime||0,n="measure"===i.type?e+i.duration:e+.1;let s=!1;for(const r of t){if(!r.some(t=>{const i=t.timestamp||t.relativeTime||0,s="measure"===t.type?i+t.duration:i+.1;return e<s&&n>i})){r.push(i),s=!0;break}}s||t.push([i])}return t}drawAxes(e,t,n){const{padding:i}=this.options,{ctx:s}=this;s.strokeStyle="#ccc",s.lineWidth=1,s.beginPath(),s.moveTo(i.left,i.top),s.lineTo(i.left,this.options.height-i.bottom),s.stroke(),s.beginPath(),s.moveTo(i.left,this.options.height-i.bottom),s.lineTo(this.options.width-i.right,this.options.height-i.bottom),s.stroke(),s.fillStyle="#666",s.font="10px monospace",s.textAlign="center";for(let r=0;r<=5;r++){const t=e+n/5*r,o=i.left+(t-e)*this.scale.x,a=this.options.height-i.bottom+15;s.fillText(`${t.toFixed(1)}ms`,o,a)}}drawEvent(e,t,n){const{padding:i}=this.options,{ctx:s}=this,r=e.timestamp||e.relativeTime||0,o=i.left+(r-n)*this.scale.x,a=i.top+t*this.scale.y,l=this.scale.y-4;if("mark"===e.type)s.strokeStyle=e.color||"#2196F3",s.lineWidth=2,s.beginPath(),s.moveTo(o,a),s.lineTo(o,a+l),s.stroke(),s.fillStyle=e.color||"#2196F3",s.beginPath(),s.arc(o,a+l/2,4,0,2*Math.PI),s.fill();else if("measure"===e.type){const t=Math.max(e.duration*this.scale.x,2);s.fillStyle=e.color||"#4CAF50",s.fillRect(o,a,t,l),s.strokeStyle="#fff",s.lineWidth=.5,s.strokeRect(o,a,t,l),t>30&&(s.fillStyle="#fff",s.font="10px monospace",s.textAlign="left",s.fillText(e.name,o+4,a+l/2+4))}e._bounds={x:o,y:a,width:"measure"===e.type?e.duration*this.scale.x:8,height:l}}handleMouseMove(e){const t=this.canvas.getBoundingClientRect(),n=e.clientX-t.left,i=e.clientY-t.top,s=this.events.find(e=>{if(!e._bounds)return!1;const{x:t,y:s,width:r,height:o}=e._bounds;return n>=t&&n<=t+r&&i>=s&&i<=s+o});s?this.showTooltip(e,s):this.hideTooltip()}handleMouseLeave(){this.hideTooltip()}showTooltip(e,t){const n=t.timestamp||t.relativeTime||0;this.tooltip.innerHTML=`\n            <strong>${t.name}</strong><br>\n            Type: ${t.type}<br>\n            Time: ${n.toFixed(2)}ms<br>\n            ${t.duration?`Duration: ${t.duration.toFixed(2)}ms`:""}\n        `,this.tooltip.style.display="block",this.tooltip.style.left=`${e.pageX+10}px`,this.tooltip.style.top=`${e.pageY+10}px`}hideTooltip(){this.tooltip.style.display="none"}clear(){this.ctx.clearRect(0,0,this.options.width,this.options.height)}async exportPNG(){return new Promise(e=>{this.canvas.toBlob(e,"image/png")})}}const qt={name:"performance-profiler",version:"1.0.0",dependencies:[],provides:["performance-profiling","flamegraph","timeline"],priority:0};let Ht=null,jt=null,Ut=null;async function Wt(e={},t){console.log("[PerformanceProfiler] Initializing performance profiler module");const n=e.enabled??!1;if(Ht=new Ft({enabled:n,maxSamples:e.maxSamples??1e3,samplingInterval:e.samplingInterval??10,autoStart:e.autoStart??!1}),e.flamegraphContainer){const t=document.querySelector(e.flamegraphContainer);t&&(jt=new Bt(t,e.flamegraph??{}),console.log("[PerformanceProfiler] Flamegraph visualizer initialized"))}if(e.timelineContainer){const t=document.querySelector(e.timelineContainer);t&&(Ut=new Nt(t,e.timeline??{}),console.log("[PerformanceProfiler] Timeline visualizer initialized"))}"undefined"!=typeof window&&(window.PerformanceProfiler={profiler:Ht,flamegraph:jt,timeline:Ut,start:()=>Ht.start(),stop:()=>{const e=Ht.stop();if(e){if(console.log("[PerformanceProfiler] Profiling results:",e),jt){const e=Ht.generateFlamegraph();jt.render(e)}if(Ut){const e=Ht.generateTimeline();Ut.render(e)}}return e},mark:(e,t)=>Ht.mark(e,t),measure:(e,t,n)=>Ht.measure(e,t,n),exportChromeTrace:()=>Ht.exportToChromeTrace(),createComponentProfiler:(e,t)=>new _t(e,{...t,enabled:n||(null==t?void 0:t.enabled)})},console.log("[PerformanceProfiler] Global API available at window.PerformanceProfiler")),"undefined"!=typeof window&&window.LiveComponents&&!1!==e.autoInstrument&&function(){const e=window.LiveComponents;if(!e||!e.registry)return void console.warn("[PerformanceProfiler] LiveComponents not available for instrumentation");for(const[n,i]of e.registry.entries()){const e=new _t(i,{enabled:!0});i._profiler=e,console.log(`[PerformanceProfiler] Instrumented component: ${n}`)}const t=e.register.bind(e);e.register=(e,n)=>{const i=t(e,n),s=new _t(n,{enabled:!0});return n._profiler=s,console.log(`[PerformanceProfiler] Instrumented component: ${e}`),i},console.log("[PerformanceProfiler] LiveComponents instrumentation enabled")}(),console.log("[PerformanceProfiler] Module initialized")}function Vt(){Ht&&Ht.clear(),jt&&jt.clear(),Ut&&Ut.clear(),"undefined"!=typeof window&&delete window.PerformanceProfiler,console.log("[PerformanceProfiler] Module destroyed")}const Gt={init:Wt,destroy:Vt,definition:qt},Jt=Object.freeze(Object.defineProperty({__proto__:null,FlamegraphVisualizer:Bt,LiveComponentsProfiler:_t,PerformanceProfiler:Ft,TimelineVisualizer:Nt,default:Gt,definition:qt,destroy:Vt,init:Wt},Symbol.toStringTag,{value:"Module"}));class Qt{constructor(e,t){this.name=e,this.guardFn=t}static create(e,t){return new Qt(e,t)}async execute(e,t,n={}){try{const i=await this.guardFn(e,t,n);return{allowed:!1!==i&&null!==i,redirect:"string"==typeof i?i:null,reason:"object"==typeof i&&i.reason?i.reason:null}}catch(i){return d.error(`[RouteGuard] Guard "${this.name}" error:`,i),{allowed:!1,redirect:null,reason:i.message}}}}const Xt={auth:Qt.create("auth",async(e,t)=>"/login"),guest:Qt.create("guest",async(e,t)=>!0),role:e=>Qt.create("role",async(t,n)=>null===e||"/unauthorized"),permission:e=>Qt.create("permission",async(e,t)=>"/unauthorized")};class Kt{constructor(e,t){this.name=e,this.middlewareFn=t}static create(e,t){return new Kt(e,t)}async execute(e,t,n,i={}){try{await this.middlewareFn(e,t,n,i)}catch(s){d.error(`[RouteMiddleware] Middleware "${this.name}" error:`,s),n(!1)}}}const Yt={analytics:Kt.create("analytics",async(e,t,n)=>{"undefined"!=typeof window&&window.analytics&&window.analytics.track("page_view",{path:e.path,title:e.title}),n()}),loading:Kt.create("loading",async(e,t,n)=>{document.body.classList.add("route-loading"),n(),setTimeout(()=>{document.body.classList.remove("route-loading")},100)}),scrollToTop:Kt.create("scroll-to-top",async(e,t,n)=>{n(),window.scrollTo({top:0,behavior:"smooth"})})};class Zt{constructor(e={}){this.config={mode:e.mode||"history",base:e.base||"/",enableAnalytics:e.enableAnalytics??!0,...e},this.routes=new Map,this.guards=new Map,this.middleware=[],this.beforeEachHooks=[],this.afterEachHooks=[],this.currentRoute=null,this.analytics={navigations:[],errors:[]},this.init()}static create(e={}){return new Zt(e)}init(){window.addEventListener("popstate",e=>{this.handlePopState(e)}),d.info("[Router] Initialized",{mode:this.config.mode,base:this.config.base})}route(e,t){const n={path:this.normalizePath(e),component:t.component,name:t.name||e,title:t.title||null,meta:t.meta||{},guards:t.guards||[],middleware:t.middleware||[],lazy:t.lazy??!1,...t};return this.routes.set(n.path,n),d.debug("[Router] Route registered",n),this}routes(e){return e.forEach(e=>{this.route(e.path,e)}),this}guard(e,t){const n=Qt.create(e,t);return this.guards.set(e,n),this}use(e){return"function"==typeof e?this.middleware.push(Kt.create("anonymous",e)):e instanceof Kt?this.middleware.push(e):"string"==typeof e&&Yt[e]&&this.middleware.push(Yt[e]),this}beforeEach(e){return this.beforeEachHooks.push(e),this}afterEach(e){return this.afterEachHooks.push(e),this}async navigate(e,t={}){const n=this.normalizePath(e),i=this.routes.get(n);if(!i)return d.warn("[Router] Route not found",n),!1;const s=this.currentRoute,r={path:n,name:i.name,title:i.title,meta:i.meta,component:i.component};for(const l of this.beforeEachHooks){const e=await l(r,s);if(!1===e||"string"==typeof e)return"string"==typeof e&&await this.navigate(e)}for(const l of i.guards){const e=this.guards.get(l)||Xt[l];if(!e){d.warn("[Router] Guard not found",l);continue}const t=await e.execute(r,s);if(!t.allowed)return t.redirect?await this.navigate(t.redirect):(d.warn("[Router] Navigation blocked by guard",l),!1)}let o=!1;for(const l of[...this.middleware,...i.middleware])if(await new Promise(e=>{l.execute(r,s,t=>{!1===t&&(o=!0),e()})}),o)return!1;if(i.lazy&&"function"==typeof i.component)try{i.component=await i.component()}catch(a){return d.error("[Router] Failed to load lazy component",a),!1}this.currentRoute=r,"history"===this.config.mode?history.pushState({route:r},i.title||"",n):window.location.hash=n,i.title&&(document.title=i.title),this.config.enableAnalytics&&this.trackNavigation(r,s);for(const l of this.afterEachHooks)await l(r,s);return await this.renderComponent(i,t),d.info("[Router] Navigated",{to:n}),!0}async renderComponent(e,t={}){const n=t.container||document.querySelector("main");if(n){if("function"==typeof e.component){const i=await e.component(e,t);"string"==typeof i?n.innerHTML=i:i instanceof HTMLElement&&(n.innerHTML="",n.appendChild(i))}else if("string"==typeof e.component){const t=document.querySelector(e.component);t?(n.innerHTML="",n.appendChild(t.cloneNode(!0))):n.innerHTML=e.component}this.reinitializeModules(n)}else d.error("[Router] Container not found")}reinitializeModules(e){const t=new CustomEvent("router:content-updated",{detail:{container:e},bubbles:!0});document.dispatchEvent(t)}handlePopState(e){const t="history"===this.config.mode?window.location.pathname:window.location.hash.slice(1);this.navigate(t,{updateHistory:!1})}normalizePath(e){return e.startsWith(this.config.base)&&(e=e.slice(this.config.base.length)),e.startsWith("/")||(e="/"+e),"/"!==e&&e.endsWith("/")&&(e=e.slice(0,-1)),e}trackNavigation(e,t){const n={to:e.path,from:(null==t?void 0:t.path)||null,timestamp:Date.now(),duration:t?Date.now()-(t.timestamp||Date.now()):0};this.analytics.navigations.push(n),this.analytics.navigations.length>100&&this.analytics.navigations.shift();const i=new CustomEvent("router:navigation",{detail:n,bubbles:!0});window.dispatchEvent(i)}getCurrentRoute(){return this.currentRoute}getAnalytics(){return{...this.analytics,totalNavigations:this.analytics.navigations.length,totalErrors:this.analytics.errors.length}}destroy(){this.routes.clear(),this.guards.clear(),this.middleware=[],this.beforeEachHooks=[],this.afterEachHooks=[],this.currentRoute=null,d.info("[Router] Destroyed")}}const en={name:"router",router:null,init(e={},t=null){return d.info("[RouterModule] Module initialized"),this.router=Zt.create(e),"undefined"!=typeof window&&(window.Router=this.router),this},getRouter(){return this.router||Zt.create()},routes(e){return this.getRouter().routes(e),this},async navigate(e,t={}){const n=this.getRouter();return await n.navigate(e,t)},destroy(){this.router&&(this.router.destroy(),this.router=null),"undefined"!=typeof window&&window.Router&&delete window.Router,d.info("[RouterModule] Module destroyed")}},tn=en.init.bind(en),nn=Object.freeze(Object.defineProperty({__proto__:null,BuiltInGuards:Xt,BuiltInMiddleware:Yt,RouteGuard:Qt,RouteMiddleware:Kt,Router:Zt,default:en,init:tn},Symbol.toStringTag,{value:"Module"}));class sn{constructor(){this.modules=new Map,this.dependents=new Map,this.initialized=new Set,this.initializing=new Set,this.initializationOrder=[]}register(e){this.modules.has(e.name)?d.warn(`[DependencyManager] Module '${e.name}' already registered`):this.validateDefinition(e)&&(this.modules.set(e.name,e),e.dependencies.forEach(t=>{this.dependents.has(t.name)||this.dependents.set(t.name,[]),this.dependents.get(t.name).push(e.name)}),d.info(`[DependencyManager] Registered '${e.name}' v${e.version}`))}calculateInitializationOrder(){const e=new Set,t=new Set,n=[],i=s=>{if(t.has(s))throw new Error(`Circular dependency detected involving '${s}'`);if(e.has(s))return;const r=this.modules.get(s);r&&(t.add(s),r.dependencies.forEach(e=>{e.optional&&!this.modules.has(e.name)||i(e.name)}),t.delete(s),e.add(s),n.push(s))};return Array.from(this.modules.entries()).sort(([,e],[,t])=>(t.priority||0)-(e.priority||0)).map(([e])=>e).forEach(t=>{e.has(t)||i(t)}),this.initializationOrder=n,d.info(`[DependencyManager] Initialization order: ${n.join(" → ")}`),n}checkDependencies(e){const t=this.modules.get(e);if(!t)return{satisfied:!1,missing:[],reason:`Module '${e}' not registered`};const n=[],i=[];return t.dependencies.forEach(e=>{this.modules.get(e.name)?this.initialized.has(e.name)||e.optional||n.push(`${e.name} (not initialized)`):e.optional?i.push(e.name):n.push(e.name)}),{satisfied:0===n.length,missing:n,optional:i,reason:n.length>0?`Missing: ${n.join(", ")}`:"OK"}}markInitialized(e){this.initialized.add(e),this.initializing.delete(e),d.info(`[DependencyManager] '${e}' initialized`)}markInitializing(e){this.initializing.add(e)}getDependents(e){return this.dependents.get(e)||[]}getModule(e){return this.modules.get(e)}isReadyToInitialize(e){if(this.initialized.has(e)||this.initializing.has(e))return!1;return this.checkDependencies(e).satisfied}getStatus(){const e=this.modules.size,t=this.initialized.size,n=this.initializing.size;return{total:e,initialized:t,initializing:n,pending:e-t-n,modules:{initialized:Array.from(this.initialized),initializing:Array.from(this.initializing),pending:Array.from(this.modules.keys()).filter(e=>!this.initialized.has(e)&&!this.initializing.has(e))}}}validateDefinition(e){if(!e.name||"string"!=typeof e.name)return d.error("[DependencyManager] Module name is required and must be string"),!1;if(!e.version||"string"!=typeof e.version)return d.error(`[DependencyManager] Version is required for module '${e.name}'`),!1;if(!Array.isArray(e.dependencies))return d.error(`[DependencyManager] Dependencies must be array for module '${e.name}'`),!1;for(const t of e.dependencies)if(!t.name||"string"!=typeof t.name)return d.error(`[DependencyManager] Invalid dependency in module '${e.name}': missing name`),!1;return!0}reset(){this.modules.clear(),this.dependents.clear(),this.initialized.clear(),this.initializing.clear(),this.initializationOrder=[],d.info("[DependencyManager] Reset complete")}static createDefinition(e,t){const n={name:e,version:t,dependencies:[],provides:[],priority:0},i={depends(e,t="*",i=!1){return n.dependencies.push({name:e,version:t,optional:i}),this},provides(...e){return n.provides.push(...e),this},priority(e){return n.priority=e,this},build:()=>n};return Object.setPrototypeOf(i,n),Object.keys(n).forEach(e=>{e in i||Object.defineProperty(i,e,{get:()=>n[e],set(t){n[e]=t},enumerable:!0,configurable:!0})}),i}}const rn=new sn;"undefined"!=typeof window&&(window.dependencyManager=rn,window.depStatus=()=>rn.getStatus());const on=sn.createDefinition("scroll-dependent","1.0.0").depends("example-module","1.0.0").depends("scrollfx","1.0.0",!0).provides("scroll-coordination").priority(10);let an=null,ln=null;const cn=Object.freeze(Object.defineProperty({__proto__:null,definition:on,destroy:function(){d.info("[scroll-dependent] destroy"),an&&ln&&(ln.unsubscribe(an),an=null),ln&&"function"==typeof ln.cleanup&&ln.cleanup(),ln=null},init:function(e={},t=null){d.info("[scroll-dependent] init"),ln=t,ln&&(ln.register("isScrolling",!1),ln.register("scrollDirection","none"),an=ln.subscribe("example-module.scrollPosition",(e,t)=>{if(t.y!==e.y){const n=e.y>t.y?"down":"up";ln.set("scrollDirection",n),ln.set("isScrolling",!0),setTimeout(()=>{ln&&ln.set("isScrolling",!1)},150),d.info(`[scroll-dependent] Scroll ${n}: ${e.y}`)}}))}},Symbol.toStringTag,{value:"Module"}));const dn=Object.freeze(Object.defineProperty({__proto__:null,init:function(e={}){const t=document.querySelectorAll("[data-scroll-loop]");t.forEach(e=>{if("translate"===(e.dataset.scrollType||"translate")&&1===e.children.length){const t=e.firstElementChild.cloneNode(!0);t.setAttribute("aria-hidden","true"),e.appendChild(t)}}),l("scroll-loop",()=>{const n=window.scrollY,i=window.scrollX;t.forEach(t=>{const s=parseFloat(t.dataset.scrollSpeed||e.speed||.2),r=t.dataset.scrollAxis||"y",o=t.dataset.scrollType||"translate",a="true"===t.dataset.loopPause,l=parseFloat(t.dataset.loopOffset||0),c=parseFloat(t.dataset.loopLimit||0),d="x"===r?i:n;if(c&&d>c)return;if(a&&(t.matches(":hover")||t.matches(":active")))return;const h=(d+l)*s;switch(o){case"translate":{const e=-h%("x"===r?t.offsetWidth:t.offsetHeight),n="x"===r?`translateX(${e}px)`:`translateY(${e}px)`;t.style.transform=n;break}case"rotate":{const e=h%360;t.style.transform=`rotate(${e}deg)`;break}case"background":{const e=h%100;t.style.backgroundPosition="x"===r?`${e}% center`:`center ${e}%`;break}case"scale":{const e=1+.1*Math.sin(.01*h);t.style.transform=`scale(${e.toFixed(3)})`;break}}})},{autoStart:!0})}},Symbol.toStringTag,{value:"Module"})),hn={onEnter(e,t){t.classList.add("active"),document.body.dataset.activeScrollStep=e,d.info(`[ScrollStep] Enter: ${e}`),1===e&&d.info("Intro sichtbar"),2===e&&d.info("Chart aktiviert"),3===e&&d.info("Zitat eingeblendet")},onLeave(e,t){t.classList.remove("active"),t.style.transitionDelay="",d.info(`[ScrollStep] Leave: ${e}`),document.body.dataset.activeScrollStep===String(e)&&delete document.body.dataset.activeScrollStep,1===e&&d.info("Intro ausgeblendet"),2===e&&d.info("Chart deaktiviert"),3===e&&d.info("Zitat ausgeblendet")}};const un=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){c("scroll-timeline")},init:function(e={}){d.info("ScrollTimeline init");const t={attribute:"data-scroll-step",triggerPoint:.4,once:!0,...e},n=Array.from(document.querySelectorAll(`[${t.attribute}]`)).map(e=>({el:e,index:parseInt(e.getAttribute(t.attribute),10),active:!1}));l("scroll-timeline",function(){const e=window.innerHeight*t.triggerPoint;n.forEach(n=>{var i,s;const r=n.el.getBoundingClientRect(),o=r.top<e&&r.bottom>0;o&&!n.active&&(n.active=!0,n.el.classList.add("active"),d.log(`➡️ ENTER step ${n.index}`),null==(i=hn.onEnter)||i.call(hn,n.index,n.el)),!o&&n.active&&(n.active=!1,n.el.classList.remove("active"),d.log(`⬅️ LEAVE step ${n.index}`),t.once||null==(s=hn.onLeave)||s.call(hn,n.index,n.el))})},{autoStart:!0})}},Symbol.toStringTag,{value:"Module"}));class pn{constructor(e={}){this.config={tokenName:e.tokenName||"_token",headerName:e.headerName||"X-CSRF-TOKEN",refreshInterval:e.refreshInterval||18e5,autoRefresh:e.autoRefresh??!0,endpoint:e.endpoint||"/api/csrf-token",...e},this.currentToken=null,this.refreshTimer=null,this.isRefreshing=!1,this.init()}static create(e={}){return new pn(e)}init(){this.currentToken=this.getTokenFromPage(),this.currentToken?d.info("[CsrfManager] Initialized with token"):d.warn("[CsrfManager] No CSRF token found on page"),this.config.autoRefresh&&this.startAutoRefresh(),this.updateAllTokens()}getTokenFromPage(){const e=document.querySelector('meta[name="csrf-token"]');if(e)return e.getAttribute("content");const t=document.querySelector(`input[name="${this.config.tokenName}"]`);return t?t.value:null}getToken(){return this.currentToken}async refreshToken(){if(this.isRefreshing)d.debug("[CsrfManager] Token refresh already in progress");else{this.isRefreshing=!0;try{const e=await fetch(this.config.endpoint,{method:"GET",headers:{"X-Requested-With":"XMLHttpRequest",Accept:"application/json"}});if(!e.ok)throw new Error(`Failed to refresh token: ${e.status}`);const t=await e.json(),n=t.token||t.csrf_token||t._token;if(!n)throw new Error("No token in response");this.currentToken=n,this.updateAllTokens(),d.info("[CsrfManager] Token refreshed"),this.triggerTokenRefreshedEvent(n)}catch(e){throw d.error("[CsrfManager] Failed to refresh token",e),e}finally{this.isRefreshing=!1}}}updateAllTokens(){if(!this.currentToken)return;const e=document.querySelector('meta[name="csrf-token"]');e&&e.setAttribute("content",this.currentToken);document.querySelectorAll(`input[name="${this.config.tokenName}"]`).forEach(e=>{e.value=this.currentToken});document.querySelectorAll("[data-live-component]").forEach(e=>{const t=e.querySelector(`input[name="${this.config.tokenName}"]`);t&&(t.value=this.currentToken)})}startAutoRefresh(){this.refreshTimer||(this.refreshTimer=setInterval(()=>{this.refreshToken().catch(e=>{d.error("[CsrfManager] Auto-refresh failed",e)})},this.config.refreshInterval),d.debug("[CsrfManager] Auto-refresh started",{interval:this.config.refreshInterval}))}stopAutoRefresh(){this.refreshTimer&&(clearInterval(this.refreshTimer),this.refreshTimer=null)}getTokenHeader(){return{[this.config.headerName]:this.currentToken}}triggerTokenRefreshedEvent(e){const t=new CustomEvent("csrf:token-refreshed",{detail:{token:e},bubbles:!0});window.dispatchEvent(t)}destroy(){this.stopAutoRefresh(),this.currentToken=null,d.info("[CsrfManager] Destroyed")}}class mn{constructor(e={}){var t,n,i,s;this.config={csrf:e.csrf||{},xss:{enabled:(null==(t=e.xss)?void 0:t.enabled)??!0,sanitizeOnInput:(null==(n=e.xss)?void 0:n.sanitizeOnInput)??!1},csp:{enabled:(null==(i=e.csp)?void 0:i.enabled)??!1,reportOnly:(null==(s=e.csp)?void 0:s.reportOnly)??!1},...e},this.csrfManager=null,this.init()}static create(e={}){return new mn(e)}init(){this.csrfManager=pn.create(this.config.csrf),this.config.xss.enabled&&this.initXssProtection(),this.config.csp.enabled&&this.initCsp(),d.info("[SecurityManager] Initialized",{csrf:!!this.csrfManager,xss:this.config.xss.enabled,csp:this.config.csp.enabled})}initXssProtection(){this.config.xss.sanitizeOnInput&&document.addEventListener("input",e=>{"INPUT"!==e.target.tagName&&"TEXTAREA"!==e.target.tagName||this.sanitizeInput(e.target)},!0)}sanitizeInput(e){const t=e.value,n=this.sanitizeHtml(t);n!==t&&(e.value=n,d.warn("[SecurityManager] Sanitized potentially dangerous input",{field:e.name||e.id}))}sanitizeHtml(e){return"string"!=typeof e?e:e.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,"").replace(/on\w+\s*=\s*["'][^"']*["']/gi,"").replace(/javascript:/gi,"").replace(/data:text\/html/gi,"")}initCsp(){const e=this.getCspHeader();e?(d.debug("[SecurityManager] CSP header found",e),this.validateCsp(e)):d.warn("[SecurityManager] No CSP header found")}getCspHeader(){const e=document.querySelector('meta[http-equiv="Content-Security-Policy"]');return e?e.getAttribute("content"):null}validateCsp(e){const t=e.split(";").map(e=>e.trim().split(" ")[0]),n=["default-src","script-src","style-src"].filter(e=>!t.some(t=>t.toLowerCase()===e.toLowerCase()));n.length>0&&d.warn("[SecurityManager] CSP missing recommended directives",n)}getCsrfToken(){var e;return(null==(e=this.csrfManager)?void 0:e.getToken())||null}getCsrfTokenHeader(){var e;return(null==(e=this.csrfManager)?void 0:e.getTokenHeader())||{}}async refreshCsrfToken(){if(this.csrfManager)return await this.csrfManager.refreshToken()}validateSecurityHeaders(){const e=[];return"https:"!==location.protocol&&"localhost"!==location.hostname&&e.push("Not using HTTPS"),this.getCspHeader()||e.push("No Content Security Policy header"),{valid:0===e.length,issues:e}}escapeHtml(e){if("string"!=typeof e)return e;const t={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#039;"};return e.replace(/[&<>"']/g,e=>t[e])}validateUrl(e){try{const t=new URL(e,window.location.origin);return"javascript:"!==t.protocol&&"data:"!==t.protocol}catch{return!1}}destroy(){this.csrfManager&&(this.csrfManager.destroy(),this.csrfManager=null),d.info("[SecurityManager] Destroyed")}}const gn={name:"security",securityManager:null,init(e={},t=null){return d.info("[SecurityModule] Module initialized"),this.securityManager=mn.create(e),"undefined"!=typeof window&&(window.SecurityManager=this.securityManager,window.CsrfManager=this.securityManager.csrfManager),this},getSecurityManager(){return this.securityManager||mn.create()},getCsrfToken(){var e;return(null==(e=this.securityManager)?void 0:e.getCsrfToken())||null},async refreshCsrfToken(){if(this.securityManager)return await this.securityManager.refreshCsrfToken()},destroy(){this.securityManager&&(this.securityManager.destroy(),this.securityManager=null),"undefined"!=typeof window&&(delete window.SecurityManager,delete window.CsrfManager),d.info("[SecurityModule] Module destroyed")}},fn=gn.init.bind(gn),yn=Object.freeze(Object.defineProperty({__proto__:null,CsrfManager:pn,SecurityManager:mn,default:gn,init:fn},Symbol.toStringTag,{value:"Module"})),vn=Object.freeze(Object.defineProperty({__proto__:null},Symbol.toStringTag,{value:"Module"})),bn={};class wn{constructor(e={}){this.options={containerSelector:"main",linkSelector:'a[href^="/"]',loadingClass:"spa-loading",excludeSelector:'[data-spa="false"], [download], [target="_blank"], [href^="mailto:"], [href^="tel:"], [href^="#"]',enableTransitions:!0,transitionDuration:100,skeletonTemplate:this.createSkeletonTemplate(),enableLiveComponentIntegration:e.enableLiveComponentIntegration??!0,preserveLiveComponentState:e.preserveLiveComponentState??!1,...e},this.container=null,this.isLoading=!1,this.currentUrl=window.location.href,this.abortController=null,this.liveComponentManager=null,this.handleLinkClick=this.handleLinkClick.bind(this),this.handlePopState=this.handlePopState.bind(this),this.handleFormSubmit=this.handleFormSubmit.bind(this),this.init()}static create(e={}){return new wn(e)}init(){this.container=document.querySelector(this.options.containerSelector),this.container?(this.options.enableLiveComponentIntegration&&this.initLiveComponentIntegration(),this.bindEvents(),this.setupStyles(),this.updateHistoryState(window.location.href,document.title),d.info("[SPARouter] Initialized",{liveComponentIntegration:this.options.enableLiveComponentIntegration})):d.error(`[SPARouter] Container "${this.options.containerSelector}" not found`)}initLiveComponentIntegration(){"undefined"!=typeof window&&window.LiveComponent?this.liveComponentManager=window.LiveComponent:function(e,t){let n=Promise.resolve();if(t&&t.length>0){let e=function(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:"fulfilled",value:e}),e=>({status:"rejected",reason:e}))))};document.getElementsByTagName("link");const i=document.querySelector("meta[property=csp-nonce]"),s=(null==i?void 0:i.nonce)||(null==i?void 0:i.getAttribute("nonce"));n=e(t.map(e=>{if((e=function(e){return"/"+e}(e))in bn)return;bn[e]=!0;const t=e.endsWith(".css"),n=t?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${e}"]${n}`))return;const i=document.createElement("link");return i.rel=t?"stylesheet":"modulepreload",t||(i.as="script"),i.crossOrigin="",i.href=e,s&&i.setAttribute("nonce",s),document.head.appendChild(i),t?new Promise((t,n)=>{i.addEventListener("load",t),i.addEventListener("error",()=>n(new Error(`Unable to preload CSS for ${e}`)))}):void 0}))}function i(e){const t=new Event("vite:preloadError",{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return n.then(t=>{for(const e of t||[])"rejected"===e.status&&i(e.reason);return e().catch(i)})}(()=>Promise.resolve().then(()=>zt),void 0).then(e=>{e.LiveComponent?this.liveComponentManager=e.LiveComponent:e.default&&(this.liveComponentManager=e.default)}).catch(e=>{d.warn("[SPARouter] LiveComponent not available",e)}),d.debug("[SPARouter] LiveComponent integration initialized")}bindEvents(){document.addEventListener("click",this.handleLinkClick),window.addEventListener("popstate",this.handlePopState),document.addEventListener("submit",this.handleFormSubmit)}handleLinkClick(e){const t=e.target.closest(this.options.linkSelector);if(!t)return;if(t.matches(this.options.excludeSelector))return;if(e.ctrlKey||e.metaKey||e.shiftKey)return;e.preventDefault();const n=t.href,i=t.title||t.textContent.trim();this.navigate(n,i)}handlePopState(e){const t=window.location.href;t!==this.currentUrl&&this.loadContent(t,!1)}handleFormSubmit(e){const t=e.target;t.hasAttribute("data-spa")&&"false"===t.getAttribute("data-spa")||t._moduleInstance}async navigate(e,t=""){var n;if(this.isLoading&&(d.warn("[SPARouter] Already loading, aborting previous request"),null==(n=this.abortController)||n.abort()),e!==this.currentUrl){d.info(`[SPARouter] Navigating to: ${e}`);try{await this.loadContent(e,!0,t)}catch(i){"AbortError"!==i.name&&(d.error("[SPARouter] Navigation failed:",i),window.location.href=e)}}else d.info(`[SPARouter] Already at ${e}, skipping navigation`)}async loadContent(e,t=!0,n=""){var i;if(e!==this.currentUrl||t){this.isLoading&&(null==(i=this.abortController)||i.abort()),this.isLoading=!0,this.abortController=new AbortController;try{this.showLoadingState();const i=await fetch(e,{headers:{"X-Requested-With":"XMLHttpRequest","X-SPA-Request":"true",Accept:"application/json, text/html"},signal:this.abortController.signal});if(!i.ok)throw new Error(`HTTP ${i.status}: ${i.statusText}`);const s=i.headers.get("content-type");let r,o;if(null==s?void 0:s.includes("application/json")){const e=await i.json();r=e.html,o=e.title||n,e.meta&&this.updateMetaTags(e.meta)}else{const e=await i.text();r=this.extractMainContent(e),o=this.extractTitle(e)||n}await this.updateContent(r,o),t&&this.updateHistoryState(e,o),this.currentUrl=e,d.info(`[SPARouter] Successfully loaded: ${e}`)}catch(s){if("AbortError"!==s.name)throw this.hideLoadingState(),s}finally{this.isLoading=!1,this.abortController=null}}}extractMainContent(e){const t=(new DOMParser).parseFromString(e,"text/html"),n=t.querySelector("main");if(n)return n.innerHTML;const i=['[role="main"]',".main-content","#main",".content"];for(const s of i){const e=t.querySelector(s);if(e)return d.warn(`[SPARouter] Using fallback selector: ${s}`),e.innerHTML}return d.warn("[SPARouter] No main element found, using entire body"),t.body.innerHTML}extractTitle(e){const t=(new DOMParser).parseFromString(e,"text/html").querySelector("title");return t?t.textContent.trim():""}async updateContent(e,t){let n=null;this.options.enableLiveComponentIntegration&&this.options.preserveLiveComponentState&&this.liveComponentManager&&(n=this.saveLiveComponentStates()),t&&(document.title=t),this.options.enableTransitions&&await this.transitionOut(),this.container.innerHTML=e,this.reinitializeModules(),this.options.enableLiveComponentIntegration&&await this.initializeLiveComponents(n),this.options.enableTransitions&&await this.transitionIn(),this.hideLoadingState(),window.scrollTo({top:0,behavior:"smooth"}),this.triggerNavigationEvent()}saveLiveComponentStates(){if(!this.liveComponentManager)return null;const e={};return this.container.querySelectorAll("[data-live-component]").forEach(t=>{const n=t.getAttribute("data-live-component");if(n&&this.liveComponentManager.components){if(this.liveComponentManager.components.get(n)){const s=t.dataset.state;if(s)try{e[n]=JSON.parse(s)}catch(i){d.warn(`[SPARouter] Failed to parse state for ${n}`,i)}}}}),d.debug("[SPARouter] Saved LiveComponent states",Object.keys(e)),e}async initializeLiveComponents(e=null){if(!this.liveComponentManager&&(this.initLiveComponentIntegration(),await new Promise(e=>setTimeout(e,100)),!this.liveComponentManager))return void d.warn("[SPARouter] LiveComponentManager not available, skipping initialization");const t=this.container.querySelectorAll("[data-live-component]");if(0!==t.length){d.info(`[SPARouter] Initializing ${t.length} LiveComponents`);for(const i of t)try{if(e){const t=i.getAttribute("data-live-component");if(t&&e[t]){const n=JSON.stringify(e[t]);i.dataset.state=n}}this.liveComponentManager&&"function"==typeof this.liveComponentManager.init&&this.liveComponentManager.init(i)}catch(n){d.error("[SPARouter] Failed to initialize LiveComponent",n)}d.debug("[SPARouter] LiveComponents initialized")}}showLoadingState(){document.body.classList.add(this.options.loadingClass),this.options.enableTransitions&&this.container.classList.add("spa-transitioning-out")}hideLoadingState(){document.body.classList.remove(this.options.loadingClass)}async transitionOut(){return new Promise(e=>{this.container.style.transition=`opacity ${this.options.transitionDuration}ms cubic-bezier(0.4, 0, 1, 1)`,this.container.style.opacity="0",setTimeout(()=>{e()},this.options.transitionDuration)})}async transitionIn(){return new Promise(e=>{this.container.style.opacity="0",setTimeout(()=>{this.container.style.transition=`opacity ${this.options.transitionDuration}ms cubic-bezier(0, 0, 0.2, 1)`,this.container.style.opacity="1",setTimeout(()=>{this.container.style.transition="",this.container.classList.remove("spa-transitioning-out"),e()},this.options.transitionDuration)},10)})}updateHistoryState(e,t){const n={url:e,title:t,timestamp:Date.now()};e!==window.location.href?history.pushState(n,t,e):history.replaceState(n,t,e)}reinitializeModules(){window.initAutoFormHandling&&window.initAutoFormHandling();this.container.querySelectorAll("[data-module]").forEach(e=>{const t=e.dataset.module;if("livecomponent"===t)return;d.info(`[SPARouter] Re-initializing module "${t}" on new content`);const n=new CustomEvent("spa:reinit-module",{detail:{element:e,moduleName:t},bubbles:!0});e.dispatchEvent(n)})}createSkeletonTemplate(){return'\n            <div class="spa-skeleton">\n                <div class="spa-skeleton-header"></div>\n                <div class="spa-skeleton-content">\n                    <div class="spa-skeleton-line"></div>\n                    <div class="spa-skeleton-line"></div>\n                    <div class="spa-skeleton-line short"></div>\n                </div>\n            </div>\n        '}setupStyles(){if(document.getElementById("spa-router-styles"))return;const e=document.createElement("style");e.id="spa-router-styles",e.textContent="\n            /* SPA Router Transitions */\n            .spa-loading {\n                cursor: progress;\n            }\n            \n            .spa-transitioning-out {\n                pointer-events: none;\n            }\n            \n            /* Skeleton Loading Styles */\n            .spa-skeleton {\n                animation: spa-pulse 1.5s ease-in-out infinite alternate;\n            }\n            \n            .spa-skeleton-header {\n                height: 2rem;\n                background: #e5e7eb;\n                border-radius: 0.375rem;\n                margin-bottom: 1rem;\n                width: 60%;\n            }\n            \n            .spa-skeleton-content {\n                space-y: 0.75rem;\n            }\n            \n            .spa-skeleton-line {\n                height: 1rem;\n                background: #e5e7eb;\n                border-radius: 0.375rem;\n                margin-bottom: 0.75rem;\n            }\n            \n            .spa-skeleton-line.short {\n                width: 75%;\n            }\n            \n            @keyframes spa-pulse {\n                0% {\n                    opacity: 1;\n                }\n                100% {\n                    opacity: 0.4;\n                }\n            }\n            \n            /* Dark mode support */\n            @media (prefers-color-scheme: dark) {\n                .spa-skeleton-header,\n                .spa-skeleton-line {\n                    background: #374151;\n                }\n            }\n        ",document.head.appendChild(e)}updateMetaTags(e){if(e.description){let t=document.querySelector('meta[name="description"]');t?t.content=e.description:(t=document.createElement("meta"),t.name="description",t.content=e.description,document.head.appendChild(t))}Object.entries(e).forEach(([e,t])=>{if("description"!==e&&t){let n=document.querySelector(`meta[name="${e}"]`);n?n.content=t:(n=document.createElement("meta"),n.name=e,n.content=t,document.head.appendChild(n))}})}triggerNavigationEvent(){const e=new CustomEvent("spa:navigated",{detail:{url:this.currentUrl,container:this.container,timestamp:Date.now()},bubbles:!0});document.dispatchEvent(e)}navigateTo(e,t){return this.navigate(e,t)}getCurrentUrl(){return this.currentUrl}isNavigating(){return this.isLoading}destroy(){var e;null==(e=this.abortController)||e.abort(),document.removeEventListener("click",this.handleLinkClick),window.removeEventListener("popstate",this.handlePopState),document.removeEventListener("submit",this.handleFormSubmit);const t=document.getElementById("spa-router-styles");t&&t.remove(),d.info("[SPARouter] Destroyed")}}const Sn={enableTransitions:!0,transitionDuration:50},Cn={enableTransitions:!0,transitionDuration:100},Mn={enableTransitions:!1,transitionDuration:0};function kn(){if(window.matchMedia("(prefers-reduced-motion: reduce)").matches)return Mn;const e=navigator.connection||navigator.mozConnection||navigator.webkitConnection;if(e){if("4g"===e.effectiveType)return Sn;if("3g"===e.effectiveType)return Cn}/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);return Cn}const En={name:"spa-router",router:null,initialized:!1,init(e={}){if(this.initialized&&this.router)return d.warn("[SPARouterModule] SPA Router already initialized, returning existing instance"),this.router;d.info("[SPARouterModule] Initializing SPA Router");const t={...{containerSelector:"main",linkSelector:'a[href^="/"]',excludeSelector:'[data-spa="false"], [download], [target="_blank"], [href^="mailto:"], [href^="tel:"], [href^="#"]',enableSkeletonLoading:!0,...Cn,...kn()},...e};return this.router=wn.create(t),this.initialized=!0,"undefined"!=typeof window&&(window.spaRouter=this.router),document.addEventListener("spa:reinit-module",this.handleModuleReinit.bind(this)),document.addEventListener("spa:navigated",this.handleNavigation.bind(this)),d.info("[SPARouterModule] SPA Router initialized successfully"),this.router},handleModuleReinit(e){const{element:t,moduleName:n}=e.detail;d.info(`[SPARouterModule] Re-initializing module: ${n}`,t);const i=new CustomEvent("module:reinit-needed",{detail:{element:t,moduleName:n},bubbles:!0});document.dispatchEvent(i)},handleNavigation(e){const{url:t,timestamp:n}=e.detail;d.info(`[SPARouterModule] Navigation completed to: ${t}`),"function"==typeof window.initAutoFormHandling&&setTimeout(()=>{window.initAutoFormHandling()},100),"function"==typeof window.gtag&&window.gtag("config","GA_TRACKING_ID",{page_path:new URL(t).pathname})},navigateTo(e,t){if(this.router)return this.router.navigateTo(e,t);d.warn("[SPARouterModule] Router not initialized")},getCurrentUrl(){var e;return(null==(e=this.router)?void 0:e.getCurrentUrl())||window.location.href},isNavigating(){var e;return(null==(e=this.router)?void 0:e.isNavigating())||!1},destroy(){this.router&&(this.router.destroy(),this.router=null),this.initialized=!1,"undefined"!=typeof window&&window.spaRouter&&delete window.spaRouter,document.removeEventListener("spa:reinit-module",this.handleModuleReinit),document.removeEventListener("spa:navigated",this.handleNavigation),d.info("[SPARouterModule] SPA Router destroyed")}},xn=En.init.bind(En),An=Object.freeze(Object.defineProperty({__proto__:null,SPARouter:wn,SPARouterModule:En,default:En,init:xn},Symbol.toStringTag,{value:"Module"}));let Tn=class e{constructor(e={}){var t,n,i,s,r;this.state=e.initialState||{},this.subscribers=new Map,this.middleware=[],this.history=[],this.maxHistorySize=e.maxHistorySize||50,this.enableHistory=e.enableHistory??!1,this.persistence={enabled:(null==(t=e.persistence)?void 0:t.enabled)??!1,storage:(null==(n=e.persistence)?void 0:n.storage)||"localStorage",key:(null==(i=e.persistence)?void 0:i.key)||"app-state",paths:(null==(s=e.persistence)?void 0:s.paths)||[]},this.sync={enabled:(null==(r=e.sync)?void 0:r.enabled)??!1,channel:null},this.persistence.enabled&&this.loadPersistedState(),this.sync.enabled&&"undefined"!=typeof BroadcastChannel&&this.initCrossTabSync(),d.info("[StateManager] Initialized",{persistence:this.persistence.enabled,sync:this.sync.enabled,history:this.enableHistory})}static create(t={}){return new e(t)}getState(){return this.state}get(e,t=void 0){const n=e.split(".");let i=this.state;for(const s of n){if(null==i||"object"!=typeof i)return t;i=i[s]}return void 0!==i?i:t}set(e,t){const n=e.split("."),i={...this.state};let s=i;for(let l=0;l<n.length-1;l++){const e=n[l];e in s&&"object"==typeof s[e]&&null!==s[e]?s[e]={...s[e]}:s[e]={},s=s[e]}const r=n[n.length-1],o=this.get(e);s[r]=t;const a={type:"SET",path:e,value:t,oldValue:o};null!==this.applyMiddleware(a)&&(this.state=i,this.enableHistory&&this.addToHistory(a),this.persistence.enabled&&this.shouldPersist(e)&&this.persistState(),this.sync.enabled&&this.broadcastStateChange(a),this.notifySubscribers(e,t,o),d.debug("[StateManager] State updated",{path:e,value:t}))}dispatch(e){if("function"==typeof e)return e(this.dispatch.bind(this),this.getState.bind(this));if(!e.type)throw new Error("Action must have a type property");const t=this.applyMiddleware(e);if(null===t)return;const n=this.reducer(this.state,t);n!==this.state&&(this.state,this.state=n,this.enableHistory&&this.addToHistory(t),this.persistence.enabled&&this.persistState(),this.sync.enabled&&this.broadcastStateChange(t),this.notifyAllSubscribers()),d.debug("[StateManager] Action dispatched",t)}reducer(e,t){if("SET"===t.type&&t.path){const n=t.path.split("."),i={...e};let s=i;for(let e=0;e<n.length-1;e++){const t=n[e];t in s&&"object"==typeof s[t]&&null!==s[t]?s[t]={...s[t]}:s[t]={},s=s[t]}return s[n[n.length-1]]=t.value,i}return e}subscribe(e,t){return this.subscribers.has(e)||this.subscribers.set(e,new Set),this.subscribers.get(e).add(t),()=>{const n=this.subscribers.get(e);n&&(n.delete(t),0===n.size&&this.subscribers.delete(e))}}subscribeAll(e){return this.subscribe("*",e)}notifySubscribers(e,t,n){const i=this.subscribers.get(e);i&&i.forEach(i=>{try{i(t,n,e)}catch(s){d.error("[StateManager] Subscriber error",s)}});const s=this.subscribers.get("*");s&&s.forEach(t=>{try{t(this.state,e)}catch(n){d.error("[StateManager] Subscriber error",n)}});const r=e.split(".");for(let o=r.length-1;o>0;o--){const e=r.slice(0,o).join("."),t=this.subscribers.get(e);t&&t.forEach(t=>{try{t(this.get(e),e)}catch(n){d.error("[StateManager] Subscriber error",n)}})}}notifyAllSubscribers(){this.subscribers.forEach((e,t)=>{e.forEach(e=>{try{if("*"===t)e(this.state);else{e(this.get(t),t)}}catch(n){d.error("[StateManager] Subscriber error",n)}})})}use(e){if("function"!=typeof e)throw new Error("Middleware must be a function");this.middleware.push(e)}applyMiddleware(e){let t=e;for(const n of this.middleware)if(t=n(t,this.getState.bind(this)),null===t)return null;return t}loadPersistedState(){try{const e=("sessionStorage"===this.persistence.storage?sessionStorage:localStorage).getItem(this.persistence.key);if(e){const t=JSON.parse(e);this.state={...this.state,...t},d.info("[StateManager] Loaded persisted state")}}catch(e){d.error("[StateManager] Failed to load persisted state",e)}}persistState(){try{const e="sessionStorage"===this.persistence.storage?sessionStorage:localStorage,t=this.persistence.paths.length>0?this.getPersistedPaths():this.state;e.setItem(this.persistence.key,JSON.stringify(t)),d.debug("[StateManager] State persisted")}catch(e){d.error("[StateManager] Failed to persist state",e)}}getPersistedPaths(){const e={};for(const t of this.persistence.paths){const n=this.get(t);if(void 0!==n){const i=t.split(".");let s=e;for(let e=0;e<i.length-1;e++)i[e]in s||(s[i[e]]={}),s=s[i[e]];s[i[i.length-1]]=n}}return e}shouldPersist(e){return 0===this.persistence.paths.length||this.persistence.paths.some(t=>e.startsWith(t))}initCrossTabSync(){try{this.sync.channel=new BroadcastChannel("state-manager-sync"),this.sync.channel.addEventListener("message",e=>{"STATE_CHANGE"===e.data.type&&this.handleRemoteStateChange(e.data.action)}),d.info("[StateManager] Cross-tab sync initialized")}catch(e){d.error("[StateManager] Failed to initialize cross-tab sync",e),this.sync.enabled=!1}}broadcastStateChange(e){if(this.sync.channel)try{this.sync.channel.postMessage({type:"STATE_CHANGE",action:e,timestamp:Date.now()})}catch(t){d.error("[StateManager] Failed to broadcast state change",t)}}handleRemoteStateChange(e){const t=this.sync.enabled;this.sync.enabled=!1,"SET"===e.type&&e.path?this.set(e.path,e.value):this.dispatch(e),this.sync.enabled=t}addToHistory(e){this.history.push({action:e,state:JSON.parse(JSON.stringify(this.state)),timestamp:Date.now()}),this.history.length>this.maxHistorySize&&this.history.shift()}getHistory(){return[...this.history]}timeTravel(e){if(e<0||e>=this.history.length)throw new Error("Invalid history index");const t=this.history[e];this.state=JSON.parse(JSON.stringify(t.state)),this.notifyAllSubscribers(),d.info("[StateManager] Time-traveled to history point",e)}reset(){if(this.state={},this.history=[],this.notifyAllSubscribers(),this.persistence.enabled){("sessionStorage"===this.persistence.storage?sessionStorage:localStorage).removeItem(this.persistence.key)}d.info("[StateManager] State reset")}destroy(){this.subscribers.clear(),this.sync.channel&&(this.sync.channel.close(),this.sync.channel=null),this.history=[],d.info("[StateManager] Destroyed")}},In=null;function Pn(e={}){return In||(In=Tn.create(e)),In}function Ln(e={}){return Tn.create(e)}const $n={name:"state-manager",stateManager:null,init(e={},t=null){return d.info("[StateManagerModule] Module initialized"),this.stateManager=Pn(e),"undefined"!=typeof window&&(window.StateManager=this.stateManager),this},getStateManager(){return this.stateManager||Pn()},createScoped:(e={})=>Ln(e),destroy(){this.stateManager&&(this.stateManager.destroy(),this.stateManager=null),"undefined"!=typeof window&&window.StateManager&&delete window.StateManager,d.info("[StateManagerModule] Module destroyed")}},Dn=$n.init.bind($n),zn=Object.freeze(Object.defineProperty({__proto__:null,StateManager:Tn,createScopedStateManager:Ln,default:$n,getGlobalStateManager:Pn,init:Dn},Symbol.toStringTag,{value:"Module"}));let Rn="sticky-fade",On=[],Fn=window.scrollY,_n=new WeakMap,Bn={direction:!1,reset:!1};const Nn=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){c(Rn),On.forEach(e=>{e.style.opacity="",e.style.transform="",e.classList.remove("visible"),delete e.dataset.scrollDir}),On=[],_n=new WeakMap},init:function(e={}){On=Array.from(document.querySelectorAll("[data-sticky-fade]")),0!==On.length&&(Bn.direction=e.direction??!1,Bn.reset=e.reset??!1,l(Rn,()=>{const e=window.scrollY,t=e>Fn?"down":e<Fn?"up":"none";Fn=e;const n=window.innerHeight;On.forEach(e=>{const i=e.getBoundingClientRect(),s=1-Math.min(Math.max(i.top/n,0),1);if(e.style.opacity=s.toFixed(3),e.style.transform=`translateY(${20*(1-s)}px)`,Bn.direction&&(e.dataset.scrollDir=t),Bn.reset){const t=s>=1,n=_n.get(e)||!1;t&&!n?(e.classList.add("visible"),_n.set(e,!0)):!t&&n&&(e.classList.remove("visible"),_n.set(e,!1))}})},{autoStart:!0}))}},Symbol.toStringTag,{value:"Module"}));const qn=Object.freeze(Object.defineProperty({__proto__:null,destroy:function(){c("sticky-steps")},init:function(e={}){d.info("StickySteps init");const t={containerSelector:"[data-sticky-container]",stepSelector:"[data-sticky-step]",activeClass:"is-sticky-active",datasetKey:"activeStickyStep",...e};document.querySelectorAll(t.containerSelector).forEach(e=>{const n=e.querySelectorAll(t.stepSelector),i=e.offsetTop;l(`sticky-steps-${e.dataset.moduleId||Math.random()}`,function(){const s=window.scrollY,r=e.offsetHeight;n.forEach((o,a)=>{const l=i+a*(r/n.length),c=i+(a+1)*(r/n.length),d=s>=l&&s<c;o.classList.toggle(t.activeClass,d),d&&(e.dataset[t.datasetKey]=a)})},{autoStart:!0})})}},Symbol.toStringTag,{value:"Module"}));const Hn=Object.freeze(Object.defineProperty({__proto__:null,init:function(){}},Symbol.toStringTag,{value:"Module"})),jn={required:(e,t={})=>null!=e&&""!==e||(t.message||"This field is required"),email:(e,t={})=>{if(!e)return!0;return!!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)||(t.message||"Invalid email address")},url:(e,t={})=>{if(!e)return!0;try{return new URL(e),!0}catch{return t.message||"Invalid URL"}},min:(e,t={})=>{if(!e&&0!==e)return!0;const n=parseFloat(t.value),i="string"==typeof e?parseFloat(e):e;return!(isNaN(i)||i<n)||(t.message||`Value must be at least ${n}`)},max:(e,t={})=>{if(!e&&0!==e)return!0;const n=parseFloat(t.value),i="string"==typeof e?parseFloat(e):e;return!(isNaN(i)||i>n)||(t.message||`Value must be at most ${n}`)},minLength:(e,t={})=>{if(!e)return!0;const n=parseInt(t.value,10);return!("string"!=typeof e||e.length<n)||(t.message||`Must be at least ${n} characters`)},maxLength:(e,t={})=>{if(!e)return!0;const n=parseInt(t.value,10);return!("string"!=typeof e||e.length>n)||(t.message||`Must be at most ${n} characters`)},pattern:(e,t={})=>{if(!e)return!0;return!!new RegExp(t.value).test(e)||(t.message||"Invalid format")},number:(e,t={})=>!e&&0!==e||(!isNaN(parseFloat(e))||(t.message||"Must be a number")),integer:(e,t={})=>!e&&0!==e||(!!Number.isInteger(parseFloat(e))||(t.message||"Must be an integer")),phone:(e,t={})=>{if(!e)return!0;return!!/^[\d\s\-\+\(\)]+$/.test(e)||(t.message||"Invalid phone number")},postalCode:(e,t={})=>{if(!e)return!0;const n=t.country||"DE",i={DE:/^\d{5}$/,US:/^\d{5}(-\d{4})?$/,UK:/^[A-Z]{1,2}\d{1,2}[A-Z]?\s?\d[A-Z]{2}$/i,FR:/^\d{5}$/};return!!(i[n]||i.DE).test(e)||(t.message||`Invalid postal code for ${n}`)},custom:(e,t={})=>t.validator&&"function"==typeof t.validator?t.validator(e,t):"Custom validator function required"};class Un{constructor(e={}){this.schema=e,this.customRules=new Map,this.errors={},this.validatedFields=new Set}static create(e={}){return new Un(e)}registerRule(e,t){if("function"!=typeof t)throw new Error("Validation rule must be a function");this.customRules.set(e,t)}async validateField(e,t,n=null){const i=n||this.schema[e];if(!i)return{valid:!0,errors:[]};const s=[],r=Array.isArray(i)?i:[i];for(const o of r){const e=await this.validateRule(t,o);!0!==e&&s.push(e)}return s.length>0?this.errors[e]=s:delete this.errors[e],this.validatedFields.add(e),{valid:0===s.length,errors:s}}async validateRule(e,t){if("function"==typeof t){const n=await t(e);return!0===n||(n||"Validation failed")}if("string"==typeof t)return this.executeRule(t,e,{});if("object"==typeof t&&null!==t){const n=t.rule||t.type||Object.keys(t)[0],i=t.options||t[n]||{};if(t.async&&"function"==typeof t.validator){const n=await t.validator(e,i);return!0===n||(n||i.message||"Validation failed")}return this.executeRule(n,e,i)}return!0}executeRule(e,t,n){if(this.customRules.has(e)){const i=this.customRules.get(e)(t,n);return!0===i||(i||n.message||"Validation failed")}if(jn[e]){const i=jn[e](t,n);return!0===i||(i||n.message||"Validation failed")}return d.warn(`[Validator] Unknown validation rule: ${e}`),!0}async validate(e){this.errors={},this.validatedFields.clear();const t={};let n=!0;for(const i in this.schema){const s=e[i],r=await this.validateField(i,s);t[i]=r,r.valid||(n=!1)}return{valid:n,errors:this.errors,results:t}}async validateFields(e,t){this.errors={};const n={};let i=!0;for(const s of t){if(!(s in this.schema))continue;const t=e[s],r=await this.validateField(s,t);n[s]=r,r.valid||(i=!1)}return{valid:i,errors:this.errors,results:n}}getFieldErrors(e){return this.errors[e]||[]}getErrors(){return{...this.errors}}isFieldValid(e){return!this.errors[e]||0===this.errors[e].length}isValid(){return 0===Object.keys(this.errors).length}clearErrors(e=null){e?delete this.errors[e]:this.errors={}}reset(){this.errors={},this.validatedFields.clear()}static fromForm(e){const t={};return e.querySelectorAll("input, textarea, select").forEach(e=>{if(!e.name)return;const n=[];if(e.hasAttribute("required")&&n.push("required"),"email"===e.type?n.push("email"):"url"===e.type?n.push("url"):"number"===e.type&&n.push("number"),e.hasAttribute("minlength")&&n.push({rule:"minLength",options:{value:e.getAttribute("minlength")}}),e.hasAttribute("maxlength")&&n.push({rule:"maxLength",options:{value:e.getAttribute("maxlength")}}),e.hasAttribute("min")&&n.push({rule:"min",options:{value:e.getAttribute("min")}}),e.hasAttribute("max")&&n.push({rule:"max",options:{value:e.getAttribute("max")}}),e.hasAttribute("pattern")&&n.push({rule:"pattern",options:{value:e.getAttribute("pattern"),message:e.getAttribute("data-error-pattern")||"Invalid format"}}),e.hasAttribute("data-validate")){const t=e.getAttribute("data-validate");try{const e=JSON.parse(t);n.push(e)}catch{n.push(t)}}n.length>0&&(t[e.name]=n)}),new Un(t)}}class Wn{constructor(e,t,n={}){this.name=e,this.validator=t,this.options=n}async validate(e){if("function"==typeof this.validator){const t=await this.validator(e,this.options);return!0===t||(t||this.options.message||"Validation failed")}return!0}getName(){return this.name}getOptions(){return{...this.options}}static create(e,t,n={}){return new Wn(e,t,n)}}const Vn={name:"validation",init(e={},t=null){return d.info("[ValidationModule] Module initialized"),"undefined"!=typeof window&&(window.Validator=Un,window.ValidationRule=Wn),this},create:(e={})=>Un.create(e),fromForm:e=>Un.fromForm(e),destroy(){"undefined"!=typeof window&&(delete window.Validator,delete window.ValidationRule),d.info("[ValidationModule] Module destroyed")}},Gn=Vn.init.bind(Vn),Jn=Object.freeze(Object.defineProperty({__proto__:null,ValidationRule:Wn,Validator:Un,default:Vn,init:Gn},Symbol.toStringTag,{value:"Module"}));class Qn{constructor(e={}){this.apiBase=e.apiBase||"/api/push",this.serviceWorkerUrl=e.serviceWorkerUrl||"/js/sw-push.js",this.vapidPublicKey=e.vapidPublicKey||null,this.onSubscriptionChange=e.onSubscriptionChange||null}async init(){if(!("serviceWorker"in navigator))throw new Error("Service Workers are not supported in this browser");if(!("PushManager"in window))throw new Error("Push API is not supported in this browser");await this.registerServiceWorker(),this.vapidPublicKey||await this.fetchVapidPublicKey();const e=await this.getSubscription();return this.onSubscriptionChange&&this.onSubscriptionChange(e),null!==e}async registerServiceWorker(){try{const e=await navigator.serviceWorker.register(this.serviceWorkerUrl);return console.log("[WebPush] Service Worker registered",e),e}catch(e){throw console.error("[WebPush] Service Worker registration failed",e),e}}async fetchVapidPublicKey(){try{const e=await fetch(`${this.apiBase}/vapid-key`),t=await e.json();if(!t.public_key)throw new Error("VAPID public key not available");this.vapidPublicKey=t.public_key,console.log("[WebPush] VAPID public key fetched")}catch(e){throw console.error("[WebPush] Failed to fetch VAPID public key",e),e}}async requestPermission(){const e=await Notification.requestPermission();if(console.log("[WebPush] Permission:",e),"granted"!==e)throw new Error("Notification permission denied");return e}async subscribe(){try{await this.requestPermission();const e=await navigator.serviceWorker.ready;let t=await e.pushManager.getSubscription();return t?console.log("[WebPush] Already subscribed",t):(t=await e.pushManager.subscribe({userVisibleOnly:!0,applicationServerKey:this.urlBase64ToUint8Array(this.vapidPublicKey)}),console.log("[WebPush] Subscribed",t)),await this.sendSubscriptionToServer(t),this.onSubscriptionChange&&this.onSubscriptionChange(t),t}catch(e){throw console.error("[WebPush] Subscription failed",e),e}}async unsubscribe(){try{const e=await navigator.serviceWorker.ready,t=await e.pushManager.getSubscription();if(!t)return console.log("[WebPush] Not subscribed"),!1;const n=await t.unsubscribe();return n&&(console.log("[WebPush] Unsubscribed from browser"),await this.removeSubscriptionFromServer(t),this.onSubscriptionChange&&this.onSubscriptionChange(null)),n}catch(e){throw console.error("[WebPush] Unsubscribe failed",e),e}}async getSubscription(){try{const e=await navigator.serviceWorker.ready;return await e.pushManager.getSubscription()}catch(e){return console.error("[WebPush] Failed to get subscription",e),null}}async isSubscribed(){return null!==await this.getSubscription()}async sendTestNotification(e,t){try{const n=await this.getSubscription();if(!n)throw new Error("Not subscribed");const i=await fetch(`${this.apiBase}/test`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({endpoint:n.endpoint,title:e||"Test Notification",body:t||"This is a test notification!"})}),s=await i.json();return console.log("[WebPush] Test notification sent",s),s}catch(n){throw console.error("[WebPush] Test notification failed",n),n}}async sendSubscriptionToServer(e){try{const t=e.toJSON(),n=await fetch(`${this.apiBase}/subscribe`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!n.ok)throw new Error(`Server returned ${n.status}`);const i=await n.json();return console.log("[WebPush] Subscription sent to server",i),i}catch(t){throw console.error("[WebPush] Failed to send subscription to server",t),t}}async removeSubscriptionFromServer(e){try{const t=await fetch(`${this.apiBase}/unsubscribe`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({endpoint:e.endpoint})});if(!t.ok)throw new Error(`Server returned ${t.status}`);const n=await t.json();return console.log("[WebPush] Subscription removed from server",n),n}catch(t){throw console.error("[WebPush] Failed to remove subscription from server",t),t}}urlBase64ToUint8Array(e){const t=(e+"=".repeat((4-e.length%4)%4)).replace(/-/g,"+").replace(/_/g,"/"),n=window.atob(t),i=new Uint8Array(n.length);for(let s=0;s<n.length;++s)i[s]=n.charCodeAt(s);return i}getPermissionStatus(){return Notification.permission}static isSupported(){return"serviceWorker"in navigator&&"PushManager"in window}}const Xn=Object.freeze(Object.defineProperty({__proto__:null,WebPushManager:Qn,init:function(e={},t=null){const n=e.apiBase||"/api/push",i=e.serviceWorkerUrl||"/js/sw-push.js";if(!Qn.isSupported())return console.warn("⚠️ WebPush not supported in this browser"),console.warn("Service Worker support:","serviceWorker"in navigator),console.warn("Push Manager support:","PushManager"in window),null;try{return window.webPushManager=new Qn({apiBase:n,serviceWorkerUrl:i,onSubscriptionChange:e=>{console.log("🔔 Push subscription changed:",e?"Subscribed":"Unsubscribed")}}),console.log("🔔 WebPush Manager initialized (use window.webPushManager)"),console.log("Service Worker URL:",i),console.log("API Base:",n),console.log(""),console.log("💡 Usage:"),console.log("  await window.webPushManager.init()           // Initialize and register service worker"),console.log("  await window.webPushManager.subscribe()      // Subscribe to notifications"),console.log("  await window.webPushManager.unsubscribe()    // Unsubscribe"),console.log("  await window.webPushManager.sendTestNotification()  // Send test"),window.webPushManager}catch(s){return console.error("❌ Failed to initialize WebPush Manager:",s),null}}},Symbol.toStringTag,{value:"Module"})),Kn=Object.freeze(Object.defineProperty({__proto__:null},Symbol.toStringTag,{value:"Module"})),Yn={noise:{selector:".noise-overlay",toggleKey:"g",className:"grainy",enableTransition:!0},"shortcut-handler.js":{debug:!1},scrollfx:{selector:".fade-in-on-scroll, .zoom-in",offset:.8,baseDelay:.075,once:!0},"scroll-timeline":{attribute:"data-scroll-step",triggerPoint:.4,once:!1},"smooth-scroll":{speed:.2},"performance-profiler":{enabled:!1,maxSamples:1e3,samplingInterval:10,autoStart:!1,autoInstrument:!0,flamegraphContainer:"#flamegraph-container",timelineContainer:"#timeline-container",flamegraph:{width:1200,height:400,barHeight:20,barPadding:2,colorScheme:"category",minWidth:.5},timeline:{width:1200,height:200,trackHeight:30,padding:{top:20,right:20,bottom:30,left:60}}}};const Zn=new class{constructor(){this.crashedModules=new Set,this.recoveryAttempts=new Map,this.maxRecoveryAttempts=3,this.recoveryDelay=1e3}wrapModule(e,t){return e&&"object"==typeof e?new Proxy(e,{get:(e,n,i)=>{const s=e[n];if("function"!=typeof s)return s;const r=Object.getOwnPropertyDescriptor(e,n);return r&&!r.configurable?s:(...i)=>{try{const r=s.apply(e,i);return r&&"function"==typeof r.catch?r.catch(e=>(this.handleModuleError(e,t,n,i),this.getRecoveryValue(t,n))):r}catch(r){return this.handleModuleError(r,t,n,i),this.getRecoveryValue(t,n)}}},getOwnPropertyDescriptor:(e,t)=>{const n=Object.getOwnPropertyDescriptor(e,t);return n&&n.configurable,n},has:(e,t)=>t in e,ownKeys:e=>Object.getOwnPropertyNames(e)}):(d.warn(`[ErrorBoundary] Cannot wrap non-object module: ${t}`),e)}handleModuleError(e,t,n,i){const s=`${t}.${n}`;d.error(`[ErrorBoundary] Module ${t} crashed in ${n}():`,e),this.crashedModules.add(t);const r=this.recoveryAttempts.get(s)||0;this.recoveryAttempts.set(s,r+1),window.dispatchEvent(new CustomEvent("module-error",{detail:{moduleName:t,method:n,error:e.message,args:i,attempts:r+1}})),r<this.maxRecoveryAttempts?this.scheduleRecovery(t,n,i):(d.error(`[ErrorBoundary] Module ${t} exceeded recovery attempts. Marking as permanently failed.`),this.markModuleAsPermanentlyFailed(t))}scheduleRecovery(e,t,n){setTimeout(()=>{try{d.info(`[ErrorBoundary] Attempting recovery for ${e}.${t}()`)}catch(n){d.error(`[ErrorBoundary] Recovery failed for ${e}.${t}():`,n)}},this.recoveryDelay)}getRecoveryValue(e,t){switch(t){case"init":case"destroy":case"update":case"render":return Promise.resolve();case"getData":case"getConfig":return{};case"isEnabled":case"isActive":return!1;default:return}}markModuleAsPermanentlyFailed(e){window.dispatchEvent(new CustomEvent("module-permanent-failure",{detail:{moduleName:e}}))}getHealthStatus(){return{totalCrashedModules:this.crashedModules.size,crashedModules:Array.from(this.crashedModules),recoveryAttempts:Object.fromEntries(this.recoveryAttempts),timestamp:(new Date).toISOString()}}resetModule(e){this.crashedModules.delete(e);for(const[t]of this.recoveryAttempts)t.startsWith(`${e}.`)&&this.recoveryAttempts.delete(t);d.info(`[ErrorBoundary] Reset error tracking for module: ${e}`)}reset(){this.crashedModules.clear(),this.recoveryAttempts.clear(),d.info("[ErrorBoundary] Reset all error tracking")}};window.addEventListener("error",e=>{d.error("[Global] Unhandled error:",e.error||e.message)}),window.addEventListener("unhandledrejection",e=>{d.error("[Global] Unhandled promise rejection:",e.reason)});const ei=new class{constructor(){this.state=new Map,this.subscribers=new Map,this.stateOwners=new Map,this.defaultValues=new Map,this.currentModule="unknown",this.subscriptionCounter=0}setContext(e){this.currentModule=e}register(e,t,n=this.currentModule){this.state.has(e)?d.warn(`[StateManager] State key '${e}' already registered by ${this.stateOwners.get(e)}`):(this.state.set(e,t),this.defaultValues.set(e,t),this.stateOwners.set(e,n),this.subscribers.set(e,[]),d.info(`[StateManager] Registered '${e}' (owner: ${n})`))}get(e){if(this.state.has(e))return this.state.get(e);d.warn(`[StateManager] Unknown state key: '${e}'`)}set(e,t,n=!1){if(!this.state.has(e))return d.warn(`[StateManager] Cannot set unknown state key: '${e}'`),!1;const i=this.stateOwners.get(e);if(!n&&i!==this.currentModule)return d.warn(`[StateManager] Module '${this.currentModule}' cannot modify '${e}' (owned by ${i})`),!1;const s=this.state.get(e);return s===t||(this.state.set(e,t),this.notifySubscribers(e,t,s),d.info(`[StateManager] Updated '${e}' by ${this.currentModule}`)),!0}subscribe(e,t,n=this.currentModule){if(!this.state.has(e))return d.warn(`[StateManager] Cannot subscribe to unknown state key: '${e}'`),null;const i=`${n}_${++this.subscriptionCounter}`,s={id:i,callback:t,subscriber:n};return this.subscribers.has(e)||this.subscribers.set(e,[]),this.subscribers.get(e).push(s),d.info(`[StateManager] Subscribed '${n}' to '${e}'`),i}unsubscribe(e){for(const[t,n]of this.subscribers.entries()){const i=n.findIndex(t=>t.id===e);if(-1!==i){const e=n[i];return n.splice(i,1),void d.info(`[StateManager] Unsubscribed '${e.subscriber}' from '${t}'`)}}d.warn(`[StateManager] Subscription ID not found: ${e}`)}notifySubscribers(e,t,n){(this.subscribers.get(e)||[]).forEach(i=>{try{i.callback(t,n,e)}catch(s){d.error(`[StateManager] Error in subscriber '${i.subscriber}' for '${e}':`,s)}})}reset(e){if(!this.state.has(e))return d.warn(`[StateManager] Cannot reset unknown state key: '${e}'`),!1;const t=this.defaultValues.get(e);return this.set(e,t,!0)}clearModuleSubscriptions(e){let t=0;for(const[n,i]of this.subscribers.entries()){const s=i.filter(t=>t.subscriber!==e);t+=i.length-s.length,this.subscribers.set(n,s)}t>0&&d.info(`[StateManager] Cleared ${t} subscriptions for module '${e}'`)}getSnapshot(){const e={state:Object.fromEntries(this.state),owners:Object.fromEntries(this.stateOwners),subscriptions:{}};for(const[t,n]of this.subscribers.entries())e.subscriptions[t]=n.map(e=>({id:e.id,subscriber:e.subscriber}));return e}resetAll(){this.state.clear(),this.subscribers.clear(),this.stateOwners.clear(),this.defaultValues.clear(),this.subscriptionCounter=0,d.info("[StateManager] Reset complete")}createScope(e){return{register:(t,n)=>(this.setContext(e),this.register(t,n,e)),get:e=>this.get(e),set:(t,n)=>(this.setContext(e),this.set(t,n)),subscribe:(t,n)=>(this.setContext(e),this.subscribe(t,n,e)),unsubscribe:e=>this.unsubscribe(e),reset:e=>this.reset(e),cleanup:()=>this.clearModuleSubscriptions(e)}}};"undefined"!=typeof window&&(window.stateManager=ei,window.stateSnapshot=()=>ei.getSnapshot());const ti=new Map;function ni(){const e=document.querySelectorAll("[data-module]");d.info(`[DOMInit] Found ${e.length} elements with data-module attributes`),e.forEach(e=>{const t=e.dataset.module,n=ti.get(t);if(!n||!n.mod)return void d.warn(`[DOMInit] Module "${t}" not found or failed to initialize`);let i={};try{e.dataset.options&&(i=JSON.parse(e.dataset.options))}catch(s){d.warn(`[DOMInit] Invalid JSON in data-options for ${t}:`,s)}try{const s=n.mod;if("function"==typeof s.initElement){const n=s.initElement(e,i);d.info(`[DOMInit] Initialized ${t} on element:`,e),e._moduleInstance=n,e._moduleName=t}else if("function"==typeof s.init){const n=s.init(e,i);d.info(`[DOMInit] Initialized ${t} on element:`,e),e._moduleInstance=n,e._moduleName=t}else d.warn(`[DOMInit] Module ${t} has no init method for DOM elements`)}catch(s){d.error(`[DOMInit] Failed to initialize ${t} on element:`,s,e)}})}function ii(){const e=document.querySelectorAll('form:not([data-form-handling="false"]):not([data-auto-enhanced])');if(d.info(`[AutoForms] Found ${e.length} forms for auto-enhancement`),0===e.length)return;const t=ti.get("form-handling");t&&t.mod?e.forEach(e=>{if(e.hasAttribute("data-module"))return void d.info("[AutoForms] Skipping form with explicit data-module:",e);if(e.hasAttribute("data-auto-enhanced"))return;let n={};try{e.dataset.formOptions&&(n=JSON.parse(e.dataset.formOptions))}catch(s){d.warn("[AutoForms] Invalid JSON in data-form-options:",s)}const i={validateOnSubmit:!0,validateOnBlur:!1,validateOnInput:!1,showInlineErrors:!0,ajaxSubmit:!0,enableStateTracking:!1,...n};try{const n=t.mod.initElement?t.mod.initElement(e,i):t.mod.init(e,i);d.info("[AutoForms] Auto-enhanced form:",{id:e.id||"unnamed",action:e.action||"none",method:e.method||"get",elements:e.elements.length}),e.setAttribute("data-auto-enhanced","true"),e._moduleInstance=n,e._moduleName="form-handling"}catch(s){d.error("[AutoForms] Failed to auto-enhance form:",s,e)}}):d.warn("[AutoForms] form-handling module not available, skipping auto-init")}async function si(){await async function(){var e;let t;t="undefined"!=typeof global&&(null==(e=global.importMeta)?void 0:e.glob)?global.importMeta.glob("./*/index.js",{eager:!0}):Object.assign({"./analytics/index.js":y,"./animation-system/index.js":A,"./api-manager/index.js":B,"./cache-manager/index.js":J,"./canvas-animations/index.js":se,"./error-tracking/index.js":de,"./event-bus/index.js":fe,"./example-module/index.js":we,"./form-handling/index.js":Ae,"./image-manager/index.js":ze,"./inertia-scroll/index.js":je,"./lightbox-trigger/index.js":Qe,"./livecomponent/index.js":zt,"./noise/index.js":Rt,"./parallax/index.js":Ot,"./performance-profiler/index.js":Jt,"./router/index.js":nn,"./scroll-dependent/index.js":cn,"./scroll-loop/index.js":dn,"./scroll-timeline/index.js":un,"./scrollfx/index.js":k,"./security/index.js":yn,"./smooth-scroll/index.js":vn,"./spa-router/index.js":An,"./sse/index.js":st,"./state-manager/index.js":zn,"./sticky-fade/index.js":Nn,"./sticky-steps/index.js":qn,"./ui/index.js":Hn,"./validation/index.js":Jn,"./webpush/index.js":Xn,"./wheel-boost/index.js":Kn}),d.info("[Modules] Found modules:",Object.keys(t));const n=new Set(Array.from(document.querySelectorAll("[data-module]")).map(e=>e.dataset.module).filter(Boolean)),i=new Set(["spa-router","form-handling","api-manager","image-manager","livecomponent"]),s=new Set([...n,...i]),r=s.size===i.size&&0===n.size;d.info("[Modules] DOM modules found:",[...n]),d.info("[Modules] Core modules:",[...i]),d.info("[Modules] Used modules:",[...s]),d.info("[Modules] Fallback mode:",r),console.log("🔍 [Modules] Starting Phase 1 - Module Registration"),console.log("🔍 [Modules] All discovered modules:",Object.keys(t)),console.log("🔍 [Modules] Used modules:",[...s]),console.log("🔍 [Modules] Fallback mode:",r),Object.entries(t).forEach(([e,t])=>{const n=e.split("/").slice(-2,-1)[0];if(console.log(`🔍 [Module] Processing: ${n} from ${e}`),console.log(`🔍 [Module] Used modules has ${n}:`,s.has(n)),r||s.has(n))if(console.log(`✅ [Module] Registering ${n} with dependency manager`),"object"==typeof t.definition)d.info(`📋 [Module] Using definition for ${n}:`,t.definition),rn.register(t.definition);else{const e={name:n,version:"1.0.0",dependencies:[],provides:[],priority:0};d.info(`📋 [Module] Using default definition for ${n}:`,e),rn.register(e)}else console.log(`⏭️ [Module] Skipping unused module: ${n}`)});const o=rn.calculateInitializationOrder();console.log("🔍 [Modules] Phase 2 - Initialization Order:",o);for(const l of o){if(console.log(`🔍 [Module] Phase 3 - Processing ${l} for initialization`),console.log(`🔍 [Module] Used modules has ${l}:`,s.has(l)),console.log("🔍 [Module] Fallback mode:",r),!r&&!s.has(l)){console.log(`⏭️ [Module] Skipped (not used in DOM): ${l}`);continue}const e=Object.keys(t).find(e=>e.split("/").slice(-2,-1)[0]===l);if(console.log(`🔍 [Module] Looking for module path for ${l}, found:`,e),!e){console.log(`⛔ [Module] No implementation found for: ${l}`);continue}const n=t[e],i=Yn[l]||{};console.log(`🔍 [Module] Module ${l} object:`,n),console.log(`🔍 [Module] Config for ${l}:`,i);const o=rn.checkDependencies(l);if(console.log(`🔍 [Module] Dependency check for ${l}:`,o),o.satisfied)if(console.log(`🔍 [Module] Checking init function for ${l}:`,typeof n.init,n.init),console.log(`🔍 [Module] Module object keys for ${l}:`,Object.keys(n)),console.log(`🔍 [Module] Full module object for ${l}:`,n),"function"==typeof n.init)try{d.info(`🚀 [Module] Starting initialization for ${l}`),rn.markInitializing(l);const e=ei.createScope(l),t=Zn.wrapModule(n,l);await t.init(i,e),rn.markInitialized(l),ti.set(l,{mod:t,config:i,state:e,original:n}),d.info(`✅ [Module] Initialized: ${l}`)}catch(a){d.error(`❌ [Module] Failed to initialize ${l}:`,a),ti.set(l,{mod:null,config:i,error:a,original:n})}else d.warn(`⛔ [Module] No init() in ${l} - typeof:`,typeof n.init),d.warn("⛔ [Module] Available properties:",Object.getOwnPropertyNames(n));else console.log(`❌ [Module] Cannot initialize ${l}: ${o.reason}`),ti.set(l,{mod:null,config:i,error:new Error(o.reason),original:n})}r&&d.info("⚠️ [Module] No data-module usage detected, fallback to full init mode")}(),ni(),ii(),function(){const e=ti.get("spa-router");if(e&&e.mod)try{e.mod.init({containerSelector:"main",enableTransitions:!0,transitionDuration:300}),window.initAutoFormHandling=ii,window.initDataModuleElements=ni,d.info("[Init] SPA Router initialized successfully")}catch(t){d.error("[Init] Failed to initialize SPA Router:",t)}else d.info("[Init] SPA Router module not available, skipping")}(),function(){const e=document.querySelectorAll("video[data-src]"),t=window.innerWidth,n=(navigator.connection||{}).effectiveType||"4g";e.forEach(e=>{const i=e.dataset.src;let s="480";s="2g"===n||"slow-2g"===n?"480":"3g"===n?t>=1200?"720":"480":t>=1200?"1080":t>=800?"720":"480";const r=`${i}-${s}.webm`,o=document.createElement("video");o.autoplay=!0,o.loop=!0,o.muted=!0,o.playsInline=!0,o.poster=e.getAttribute("poster")||"",o.setAttribute("width",e.getAttribute("width")||"100%");const a=document.createElement("source");a.src=r,a.type="video/webm",o.appendChild(a),e.replaceWith(o)})}()}"undefined"!=typeof window&&(window.moduleHealth=function(){const e={total:ti.size,active:0,failed:0,modules:{},errorBoundary:Zn.getHealthStatus()};for(const[t,{mod:n,error:i}]of ti.entries())i?(e.failed++,e.modules[t]={status:"failed",error:i.message}):n?(e.active++,e.modules[t]={status:"active"}):e.modules[t]={status:"unknown"};return e},window.activeModules=ti);class ri{static initializeAll(e={}){const t=document.querySelectorAll("form[data-autosave]"),n=[];return t.forEach(t=>{try{const i=Me.create(t,{enableAutosave:!0,...e});n.push(i)}catch(i){d.error("[FormAutoSave] Failed to initialize autosave for form",{form:t.id||"unnamed",error:i})}}),d.info(`[FormAutoSave] Initialized autosave for ${n.length} forms`),n}static initialize(e,t={}){return Me.create(e,{enableAutosave:!0,...t})}}document.addEventListener("DOMContentLoaded",async()=>{try{console.log("🚀 Starting app initialization..."),await si(),console.log("✅ App initialized successfully!");const e=ri.initializeAll();console.log(`💾 Form Auto-Save initialized for ${e.length} forms`),setTimeout(()=>{console.log("📊 Debug Info:"),console.log("- Forms found:",document.querySelectorAll("form").length),console.log("- Links found:",document.querySelectorAll('a[href^="/"]').length),console.log("- SPA Router:",window.spaRouter?"Active":"Missing"),console.log("- Enhanced forms:",document.querySelectorAll("form[data-auto-enhanced]").length),console.log("- CSRF protected forms:",document.querySelectorAll('input[name="_token"]').length)},500)}catch(e){console.error("❌ App initialization failed:",e),console.error("Stack trace:",e.stack)}});
diff --git a/public/assets/js/main-C52nFCDL.js.map b/public/assets/js/main-C52nFCDL.js.map
new file mode 100644
index 00000000..f8e8a968
--- /dev/null
+++ b/public/assets/js/main-C52nFCDL.js.map
@@ -0,0 +1 @@
+{"version":3,"mappings":"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","names":["tasks","Map","running","showDebug","performance","now","debugOverlay","document","createElement","style","position","bottom","left","font","color","background","padding","zIndex","pointerEvents","display","bar","Math","min","fps","innerHTML","lineHeight","body","appendChild","monitor","constructor","this","fpsEnabled","frameCount","lastTime","visible","taskTimings","logs","container","whiteSpace","window","addEventListener","e","key","log","message","timestamp","Date","toLocaleTimeString","push","length","shift","update","taskMap","timings","id","duration","entries","toFixed","barWidth","logOutput","slice","reverse","join","size","trackTask","callback","start","set","registerFrameTask","options","autoStart","loop","task","err","Logger","warn","requestAnimationFrame","startFrameLoop","unregisterFrameTask","delete","debug","args","_write","info","error","consoleMethod","prefix","logLevel","enabled","currentLevelPriority","levels","level","msg","map","a","Error","name","stack","JSON","stringify","console","setLevel","hasOwnProperty","Object","keys","setEnabled","__publicField","none","AnalyticsProvider","config","track","eventName","properties","pageView","path","identify","userId","traits","GoogleAnalyticsProvider","super","measurementId","gaId","gtag","page_path","CustomProvider","endpoint","fetch","method","headers","type","Analytics","providers","gdprCompliant","requireConsent","consentGiven","anonymizeIp","eventQueue","userTraits","initProviders","hasConsent","trackPageView","create","providerConfig","provider","giveConsent","processEventQueue","revokeConsent","eventData","anonymizeData","triggerAnalyticsEvent","pagePath","location","pathname","pageData","title","trackBehavior","action","target","data","anonymized","ip","split","forEach","field","event","CustomEvent","detail","bubbles","dispatchEvent","enable","disable","destroy","AnalyticsModule","analytics","init","state","getAnalytics","bind","ScrollAnimation","element","offset","delay","once","speed","fadeStart","fadeEnd","steps","triggered","needsUpdate","initFadeIn","initParallax","initStickyFade","initStickySteps","opacity","transition","transitionDelay","transform","top","enter","classList","add","exit","remove","rect","getBoundingClientRect","viewportHeight","innerHeight","scrollY","updateParallax","updateStickyFade","updateStickySteps","translateY","progress","max","toString","scrollProgress","height","step","floor","setAttribute","TimelineAnimation","triggerPoint","currentStep","triggerY","setStep","setProgress","i","triggerStepEvent","setProperty","triggerProgressEvent","removeAttribute","removeProperty","AnimationSystem","useIntersectionObserver","throttleDelay","animations","observers","scrollHandler","isScrolling","setupScrollHandler","autoInitialize","ticking","updateAnimations","passive","initializeFadeIn","initializeParallax","initializeTimeline","initializeStickyFade","initializeStickySteps","querySelectorAll","registerAnimation","parseFloat","dataset","parallax","scrollSteps","parseInt","stickySteps","has","animation","setupObserver","observer","IntersectionObserver","entry","isIntersecting","threshold","rootMargin","observe","removeAnimation","get","disconnect","removeEventListener","ScrollEngine$1","triggers","Set","_loop","register","trigger","unregister","clear","ScrollTrigger","resolveElement","querySelector","end","scrub","onEnter","onLeave","onUpdate","_wasVisible","_progress","input","els","getScrollProgress","startPx","parsePosition","scrollRange","current","pos","edge","value","inViewport","createTrigger","elements","el","ScrollEngine","selector","baseDelay","Array","from","obj","index","AnimationSystemModule","animationSystem","getAnimationSystem","ObserverManager","activeObservers","observerInstances","intersection","resize","mutation","createFallbackObserver","defaultOptions","root","observerId","generateId","obs","processedEntries","intersectionRatio","boundingClientRect","rootBounds","intersectionRect","time","visibility","calculateVisibility","direction","getScrollDirection","getElementPosition","elementList","isArray","Element","unobserve","updateThreshold","updateIntersectionThreshold","ResizeObserver","contentRect","borderBoxSize","contentBoxSize","devicePixelContentBoxSize","dimensions","width","aspectRatio","deltaSize","calculateDeltaSize","breakpoint","detectBreakpoint","childList","attributes","subtree","attributeOldValue","characterDataOldValue","MutationObserver","mutations","processedMutations","addedNodes","removedNodes","attributeName","attributeNamespace","oldValue","summary","summarizeMutation","impact","assessMutationImpact","takeRecords","entryTypes","buffered","PerformanceObserver","list","getEntries","entryType","startTime","details","enhancePerformanceEntry","lazyLoad","src","srcset","scrollTrigger","triggerData","isVisible","createThresholdArray","viewport","viewportElement","cssText","orientation","random","substr","disconnectAll","visibleArea","totalArea","round","tagName","raw","loadTime","loadEventEnd","navigationStart","domContentLoaded","domContentLoadedEventEnd","paintType","url","thresholds","fallbackId","intervalId","setInterval","isElementInViewport","calculateIntersectionRatio","right","innerWidth","viewportWidth","visibleHeight","visibleWidth","getActiveObservers","MediaManager","_a","activeStreams","activeConnections","audioContext","support","mediaDevices","navigator","webRTC","webAudio","mediaRecorder","screenShare","getDisplayMedia","getUserCamera","constraints","defaultConstraints","video","ideal","facingMode","audio","stream","getUserMedia","streamId","tracks","getTracks","getVideoTracks","getAudioTracks","stop","stopStream","switchCamera","takePhoto","canvas","applyFilter","filter","applyVideoFilter","getUserMicrophone","echoCancellation","noiseSuppression","autoGainControl","getVolume","getAudioLevel","startRecording","getScreenShare","cursor","mimeType","videoBitsPerSecond","audioBitsPerSecond","getSupportedMimeType","recorder","MediaRecorder","recordingId","chunks","ondataavailable","onstop","blob","Blob","onRecordingComplete","Promise","resolve","URL","createObjectURL","download","filename","downloadBlob","pause","resume","srcObject","autoplay","muted","onloadedmetadata","videoWidth","videoHeight","getContext","drawImage","toBlob","dataURL","toDataURL","getAudioContext","AudioContext","webkitAudioContext","createAudioAnalyzer","source","createMediaStreamSource","analyzer","createAnalyser","fftSize","smoothingTimeConstant","smoothing","connect","bufferLength","frequencyBinCount","dataArray","Uint8Array","getFrequencyData","getByteFrequencyData","getTimeDomainData","getByteTimeDomainData","getAverageVolume","reduce","sum","createPeerConnection","defaultConfig","iceServers","urls","pc","RTCPeerConnection","connectionId","enhancedPC","connection","onTrack","onIceCandidate","onConnectionStateChange","addStream","addTrack","createOffer","createAnswer","setLocalDescription","desc","setRemoteDescription","addIceCandidate","candidate","close","connectionState","iceConnectionState","getDevices","cameras","microphones","speakers","devices","enumerateDevices","d","kind","all","checkPermissions","permissions","camera","query","microphone","streamData","stopAllStreams","newFacing","types","find","isTypeSupported","href","click","removeChild","revokeObjectURL","filterName","filters","blur","brightness","contrast","grayscale","sepia","invert","vintage","cool","warm","apply","videoElement","getStatus","audioContextState","streams","active","some","readyState","StorageManager","async","expiration","reject","db","store","transaction","objectStore","request","put","onsuccess","onerror","result","getAllKeys","storeFile","file","metadata","fileData","getFile","response","cache","match","success","channelName","onMessage","broadcastChannel","channels","channel","BroadcastChannel","channelWrapper","send","postMessage","sender","closeAll","acquire","lockName","webLocks","locks","lock","held","pending","localStorage","setItem","item","getItem","parse","removeItem","sessionStorage","storage","fallback","local","rest","storageType","session","enableAnalytics","operations","localValue","sessionValue","dbValue","errors","dbName","dbVersion","enableQuotaMonitoring","quotaWarningThreshold","quotaWarnings","indexedDB","cacheAPI","storageEstimate","initializeDB","initializeCache","startQuotaMonitoring","open","onupgradeneeded","objectStoreNames","contains","createObjectStore","keyPath","createIndex","unique","fileStore","autoIncrement","caches","cacheName","getStorageUsage","stats","quota","usage","available","percentage","estimate","cleanup","openCursor","cleaned","continue","localCleaned","activeChannels","dbConnected","cacheConnected","channelNames","formatBytes","migrate","fromType","toType","sourceKeys","migrated","failed","totalOperations","values","count","errorRate","resetAnalytics","bytes","pow","DeviceManager","getCurrent","geolocation","enableHighAccuracy","timeout","maximumAge","getCurrentPosition","enhanceLocationData","lat","latitude","lng","longitude","accuracy","watch","watchId","watchPosition","activeWatchers","clearWatch","distance","pos1","pos2","dLat","toRadians","dLon","sin","cos","atan2","sqrt","kilometers","miles","meters","deviceMotion","handler","motionData","acceleration","accelerationIncludingGravity","rotationRate","interval","timeStamp","totalAcceleration","calculateTotalAcceleration","shake","detectShake","getDeviceOrientation","DeviceMotionEvent","requestPermission","then","watcherId","startOrientation","deviceOrientation","orientationData","alpha","beta","gamma","absolute","compass","calculateCompass","tilt","calculateTilt","rotation","getRotationState","DeviceOrientationEvent","vibrate","pattern","vibration","patterns","short","long","double","triple","sos","heartbeat","notification","warning","battery","getBattery","batteryInfo","charging","chargingTime","dischargingTime","status","getBatteryStatus","timeRemaining","formatBatteryTime","handlers","eventType","networkInfo","mozConnection","webkitConnection","effectiveType","downlink","rtt","saveData","getConnectionSpeed","quality","getConnectionQuality","recommendation","getNetworkRecommendation","wakeLock","release","sensorData","bluetooth","usb","serial","initializeSensors","x","y","z","shakeThreshold","coords","altitude","altitudeAccuracy","heading","coordinates","accuracyLevel","getAccuracyLevel","mapUrl","abs","degrees","cardinal","getCardinalDirection","magnitude","isRotating","intensity","Infinity","isNaN","PI","stopAllWatchers","watcher","getCapabilities","watcherTypes","w","AnimationManager","fadeIn","slideInLeft","slideInRight","slideInUp","slideInDown","scaleIn","scale","rotateIn","fadeOut","slideOutLeft","slideOutRight","scaleOut","bounce","pulse","rubberBand","spin","linear","ease","easeIn","easeOut","easeInOut","easeInQuad","easeOutQuad","easeInOutQuad","easeInCubic","easeOutCubic","easeInOutCubic","easeInQuart","easeOutQuart","easeInOutQuart","easeOutBack","easeInBack","easeInOutBack","activeAnimations","animationGroups","defaultEasing","easing","defaultDuration","supported","prototype","animate","keyframes","animationOptions","fill","animationId","enhancedAnimation","enhanceAnimation","fallbackAnimate","keyframeSet","frames","sort","b","replace","effects","easings","slideIn","up","down","iterations","group","groupId","animationPromises","finished","groupController","play","anim","cancel","stagger","staggerDelay","timeline","sequence","timelineId","currentTime","at","onScroll","startOffset","endOffset","finish","playbackRate","rate","playState","seek","effect","getTiming","onFinish","onCancel","finalFrame","assign","setTimeout","getActiveAnimations","cancelAll","pauseAll","resumeAll","WorkerManager","script","webWorkers","worker","workerId","Worker","createWorkerBlob","workerWrapper","transfer","onError","terminate","activeWorkers","execute","fn","messageId","function","createPool","poolSize","hardwareConcurrency","workers","web","currentWorker","pool","broadcast","compute","processImage","imageData","processData","processor","scriptURL","serviceWorker","registration","scope","newWorker","installing","controller","checkForUpdates","getRegistration","getRegistrations","sharedWorker","SharedWorker","port","workerScript","offscreenCanvas","transferControlToOffscreen","draw","benchmark","self","fnString","Function","totalTime","avgTime","opsPerSecond","parallelMap","array","chunkSize","ceil","chunk","promises","results","flat","messageHandlers","workerScripts","code","terminateAll","getStats","total","byType","acc","PerformanceManager","_b","_c","mark","userTiming","marks","measure","startMark","endMark","getEntriesByName","measures","clearMarks","clearMeasures","getMarks","getMeasures","navigation","getLegacyNavigationTiming","getEntriesByType","redirect","redirectEnd","redirectStart","dns","domainLookupEnd","domainLookupStart","connectEnd","connectStart","ssl","secureConnectionStart","ttfb","responseStart","requestStart","responseEnd","domProcessing","domContentLoadedEventStart","domComplete","loadComplete","loadEventStart","unloadTime","unloadEventEnd","unloadEventStart","redirectCount","transferSize","encodedBodySize","decodedBodySize","connectionInfo","nextHopProtocol","renderBlockingStatus","getInsights","timing","insights","serverResponseTime","getInsight","totalLoadTime","transferEfficiency","getTransferEfficiency","recommendations","getNavigationRecommendations","resourceTiming","resources","getResourceType","encoded","decoded","protocol","cached","r","getSummary","totalSize","totalDuration","slowResources","resource","vitalsData","observePaint","fcp","checkThreshold","observeLCP","lcp","observeFID","fid","processingStart","observeCLS","cls","hadRecentInput","getMetric","ratings","getRating","memory","used","usedJSHeapSize","totalJSHeapSize","limit","jsHeapSizeLimit","formatted","memoryData","clearInterval","longTask","taskInfo","attribution","deferScript","defer","onload","head","preload","as","crossorigin","link","rel","crossOrigin","prefetch","lazyImages","images","imageObserver","img","analyzeBundles","scripts","styles","analysis","media","metrics","paintTiming","supportedEntryTypes","includes","layoutInstability","startCoreMetrics","vitals","metric","setMetric","js","css","png","jpg","jpeg","gif","svg","webp","woff","woff2","ttf","eot","json","xml","pop","toLowerCase","initiatorType","good","needs","rating","compressionRatio","ratio","toUpperCase","poor","getReport","PermissionManager","permissionCache","permissionWatchers","requestQueue","Notification","notifications","clipboard","permissionMap","api","midi","cacheCurrentPermissions","check","permission","checkFallback","permissionDescriptor","getPermissionDescriptor","onPermissionChange","showRationale","fallbackMessage","currentStatus","granted","fromCache","showPermissionRationale","reason","queueKey","requestPromise","executePermissionRequest","requestMultiple","sequential","requireAll","requests","allSettled","denied","checkRequired","requiredPermissions","statuses","missing","allGranted","p","setupPermissionWatcher","getRecommendations","features","essential","recommended","optional","featurePermissionMap","priority","offline","feature","mapping","createOnboardingFlow","descriptions","onComplete","onSkip","description","getDefaultDescription","userChoice","showPermissionDialog","cancelled","skipped","completed","modal","className","getPermissionIcon","getPermissionTitle","skipBtn","grantBtn","onclick","currentTarget","commonPermissions","userVisibleOnly","timeoutId","notificationPermission","clearTimeout","newState","customMessage","confirm","getPermissionReport","watchers","clearCache","BiometricAuthManager","rpName","rpId","hostname","userVerification","authenticatorSelection","authenticatorAttachment","requireResidentKey","credentials","authSessions","webAuthn","conditionalUI","PublicKeyCredential","userVerifyingPlatformAuthenticator","residentKey","detectFeatures","isUserVerifyingPlatformAuthenticatorAvailable","isConditionalMediationAvailable","platform","conditional","userInfo","challenge","excludeCredentials","extensions","challengeBuffer","base64ToArrayBuffer","crypto","getRandomValues","createOptions","rp","user","stringToArrayBuffer","username","email","displayName","pubKeyCredParams","alg","attestation","credProps","cred","transports","credential","publicKey","processedCredential","processCredential","credentialInfo","rawId","userDisplayName","createdAt","lastUsed","counter","getTransports","call","authenticator","parseAttestation","authenticate","allowCredentials","getOptions","mediation","sessionId","generateSessionId","authSession","credentialId","authenticatedAt","userAgent","ipAddress","getClientIP","catch","isAvailable","availability","hasCredentials","setupConditionalUI","inputSelector","inputs","createLoginFlow","registerSelector","loginSelector","statusSelector","onRegister","onLogin","statusEl","createStatusHTML","registerBtn","handleRegister","loginBtn","handleLogin","getUserInfo","showSuccess","showError","usernameInput","nameInput","prompt","showMessage","toast","textContent","parentNode","processed","arrayBufferToBase64","attestationObject","clientDataJSON","authenticatorData","signature","userHandle","arrayBufferToString","format","clientData","origin","buffer","binary","byteLength","String","fromCharCode","btoa","base64","atob","charCodeAt","str","TextEncoder","encode","TextDecoder","decode","getCredentials","getActiveSessions","revokeCredential","removed","endSession","cleanupSessions","maxAge","getStatusReport","sessions","APIManagerModule","initializeAPIManagers","exposeGlobalAPI","device","biometric","API","getAPI","isSupported","apiName","MediaDevices","WebRTC","WebAudio","IndexedDB","CacheAPI","WebLocks","Geolocation","DeviceMotion","DeviceOrientation","Vibration","Battery","NetworkInfo","WebAnimations","VisualViewport","WebWorkers","ServiceWorker","PerformanceAPI","NavigationTiming","Permissions","WebAuthn","capabilities","getSupportMap","modernBrowser","isModernBrowser","recommendedAPIs","getRecommendedAPIs","getCapabilitySummary","every","use","example","Boolean","grade","getGrade","CacheStrategy","NO_CACHE","CACHE_FIRST","NETWORK_FIRST","STALE_WHILE_REVALIDATE","NETWORK_ONLY","CACHE_ONLY","CacheManager","defaultStrategy","defaultTTL","maxMemorySize","enableIndexedDB","indexedDBName","indexedDBVersion","memoryCache","indexedDBCache","hits","misses","sets","deletes","initIndexedDB","strategy","ttl","memoryEntry","isExpired","indexedDBEntry","getFromIndexedDB","firstKey","next","setInIndexedDB","getOrSet","computeFn","deleteFromIndexedDB","clearIndexedDB","invalidate","keysToDelete","matchesPattern","RegExp","test","hitRate","memorySize","memoryMaxSize","CacheManagerModule","cacheManager","getCacheManager","useCase","registry","EventManager","module","removeModule","clearAll","table","events","listeners","useEvent","meta","CanvasManager","ctx","responsive","pixelRatio","devicePixelRatio","isAnimating","setupCanvas","setupResponsive","parentElement","displayWidth","displayHeight","getComputedStyle","clientWidth","clientHeight","canvasWidth","canvasHeight","clearRect","getSize","pixelWidth","pixelHeight","getMousePosition","clientX","clientY","startAnimation","animationFunction","stopAnimation","cancelAnimationFrame","ScrollEffects","manager","createParallaxElements","renderParallax","layerCount","layers","elementCount","layer","getLayerColor","colors","pageYOffset","parallaxOffset","save","globalAlpha","fillStyle","beginPath","arc","restore","initScrollAnimation","animationType","updateAnimation","renderScrollAnimation","relativeScroll","renderWaveAnimation","renderProgressAnimation","renderMorphAnimation","strokeStyle","lineWidth","amplitude","frequency","phase","moveTo","lineTo","stroke","barHeight","backgroundColor","fillRect","centerX","centerY","maxRadius","points","angle","radius","closePath","InteractiveEffects","effectType","mouse","isOver","setupInteractionEvents","startAnimationLoop","addTrailPoint","addClickEffect","preventDefault","touch","touches","deltaTime","renderRippleEffect","renderTrailEffect","renderParticleEffect","renderMagneticEffect","updateEffects","age","point","trailPoints","oldestIndex","indexOf","splice","hoverColor","hoverRadius","lineCap","lineJoin","particle","vx","vy","mouseX","mouseY","startX","startY","controlX","controlY","quadraticCurveTo","DataVisualization","vizType","parseData","createBarChart","createLineChart","createPieChart","createProgressChart","canvasData","scriptTag","nextElementSibling","label","chartWidth","chartHeight","barSpacing","maxValue","animationProgress","animationDuration","elapsed","renderBarChart","layout","barColor","showLabels","textColor","textAlign","fillText","showValues","showAxes","axisColor","minValue","valueRange","renderLineChart","pointsToShow","lineColor","showPoints","pointColor","pointSize","renderPieChart","currentAngle","maxAngle","sliceAngle","endAngle","getDefaultColor","labelAngle","labelX","labelY","renderProgressChart","progressValue","showText","textBaseline","CanvasAnimationsModule","initializeCanvasElements","canvasElements","initElement","canvasType","canvasConfig","parseCanvasConfig","initBackgroundAnimation","startsWith","configKey","endsWith","particleCount","particles","ErrorTracker","sampleRate","maxErrors","groupingWindow","includeStack","includeContext","includeUserAgent","includeUrl","beforeSend","errorGroups","reportQueue","isReporting","captureException","lineno","colno","startReporting","context","shouldFilter","errorData","createErrorData","modified","groupError","triggerErrorEvent","getStackTrace","referrer","generateFingerprint","stackLines","fingerprint","firstSeen","lastSeen","cleanupGroups","cutoff","flushReports","errorsToReport","ok","report","getErrorGroups","getErrors","clearErrors","globalErrorTracker","getGlobalErrorTracker","ErrorTrackingModule","errorTracker","getErrorTracker","EventBus","enableHistory","maxHistorySize","enableWildcards","subscribers","history","middleware","on","subscriber","callbacks","off","emit","processedData","addToHistory","notifySubscribers","handleWildcards","handleNamespacedEvents","subscribersArray","wildcardSubscribers","parts","namespacePattern","namespaceSubscribers","getHistory","clearHistory","getEventNames","getSubscriberCount","removeAllListeners","globalEventBus","getGlobalEventBus","EventBusModule","eventBus","getEventBus","frameId","resizeHandler","stateManager","newSize","scrollX","currentScroll","FormValidator","form","validate","fields","disabled","validateField","fieldName","hasAttribute","trim","getErrorMessage","getFieldLabel","isValidEmail","isValidUrl","minLength","getAttribute","maxLength","numValue","customValidation","runCustomValidation","valid","validationType","validityType","fromEntries","getFieldError","hasErrors","validateWithHTML5","isValid","checkValidity","validity","validationMessage","FormState","pristineValues","touchedFields","dirtyFields","captureInitialValues","bindEvents","checked","markAsTouched","checkDirtyState","updateFormClasses","getFieldValue","isDirty","hasTouchedFields","isPristine","isFieldTouched","isFieldDirty","isFieldPristine","getFieldState","pristine","dirty","touched","pristineValue","currentValue","getCurrentFieldValue","getFormState","totalFields","reset","resetField","triggerStateEvent","formState","cancelable","hasChanges","getChangedFields","changes","enableUnsavedChangesWarning","returnValue","FormHandler","validateOnSubmit","validateOnBlur","validateOnInput","showInlineErrors","preventSubmitOnError","submitMethod","ajaxSubmit","enableAutosave","autosaveInterval","autosaveRetentionPeriod","autosaveStorageKey","autosaveStoragePrefix","autosaveVisualFeedback","autosaveExcludeFields","autosaveImmediateFields","validator","isSubmitting","autosaveTimer","lastAutosaveTime","setupErrorDisplay","initAutosave","handleSubmit","validateSingleField","onAutosaveFieldChange","saveAutosaveDraft","hidden","displayErrors","submitViaAjax","setSubmitState","formData","FormData","parseResponse","handleSuccess","handleError","contentType","text","clearAutosaveDraft","clearForm","triggerEvent","errorMessage","displayFieldError","errorElement","getOrCreateErrorElement","errorId","getElementById","closest","messageContainer","prepend","messageElement","button","originalText","generateFormId","restoreAutosaveDraft","startAutosave","storageKey","isAutosaveFieldExcluded","isAutosaveImmediateField","matches","stopAutosave","extractAutosaveFormData","draft","formId","version","showAutosaveStatus","draftJson","restoreAutosaveFormData","ageText","formatDuration","getFormFields","getAutosaveFieldValue","restoredCount","setAutosaveFieldValue","ms","seconds","minutes","hours","FormHandlingModule","enableStateTracking","enableUnsavedWarning","formHandler","_formHandler","_formValidator","_formState","destroyElement","ImageManagerModule","activeGalleries","activeUploaders","initializeGalleries","initializeUploaders","initializeModal","galleryElements","galleryId","gallery","ImageGallery","listEndpoint","pageSize","columns","uploaderElements","uploaderId","uploader","ImageUploader","uploadUrl","maxFileSize","allowedTypes","maxFiles","ImageModal","currentPage","loading","buildGalleryUI","loadImages","setupEventListeners","searchInput","searchClear","sortSelect","loadMoreBtn","searchTimeout","searchImages","sortImages","loadMoreImages","showLoading","statusText","response_data","metaInfo","renderImages","updateLoadMoreButton","hideLoading","grid","image","renderImageItem","showImageModal","fileSize","file_size","formatFileSize","ulid","alt_text","original_filename","mime_type","show","has_more","hasMore","pagination","filteredImages","sortType","sortedImages","created_at","localeCompare","dependencies","provides","scrollEndTimer","taskId","velocity","lastY","damping","minVelocity","documentElement","scrollState","scrollDirection","scrollSpeed","contig","delta","scrollTo","Dialog","content","onClose","isOpenState","dialog","eventCleanup","updateContent","cleanupEvents","clickHandler","cancelHandler","_d","showModal","isOpen","domIsOpen","components","props","lightbox","activeInstances","UIManager","Component","instance","closeByType","destroyAll","onClick","naturalWidth","naturalHeight","lightboxSrc","currentSrc","getBestImageSource","caption","alt","pictureElement","lightboxContent","clonedPicture","cloneNode","outerHTML","enhancedCount","enhanceImages","domPatcher","patchFragment","fragmentName","newHtml","existingElement","temp","newElement","firstElementChild","patchElement","patchFragments","fragments","html","oldElement","patchAttributes","patchChildren","oldAttrs","newAttrs","attr","oldChildren","childNodes","newChildren","oldChild","newChild","shouldPatch","nodeType","Node","ELEMENT_NODE","TEXT_NODE","nodeValue","replaceChild","oldNode","newNode","oldKey","newKey","preserveFocus","activeElement","getElementSelector","selectionStart","selectionEnd","focus","setSelectionRange","lcKey","ConnectionState","DISCONNECTED","CONNECTING","CONNECTED","ERROR","ReconnectionStrategy","attempt","maxDelay","maxAttempts","getDelay","jitter","shouldRetry","recordAttempt","SseClient","autoReconnect","heartbeatTimeout","eventSource","reconnectionStrategy","reconnectTimer","heartbeatTimer","lastHeartbeat","eventHandlers","stateChangeHandlers","setState","buildUrl","EventSource","startHeartbeatMonitoring","CLOSED","handleDisconnect","connection_id","scheduleReconnect","stopHeartbeatMonitoring","clearReconnectTimer","channelParam","encodeURIComponent","handleEvent","oldState","onStateChange","getState","isConnected","getConnectionId","addChannels","newChannels","added","ch","removeChannels","channelsToRemove","before","globalSseClient","getGlobalSseClient","initSse","autoConnect","index$1","LazyComponentLoader","liveComponentManager","lazyComponents","loadingQueue","isProcessingQueue","handleIntersection","scanLazyComponents","registerLazyComponent","componentId","liveComponentLazy","lazyThreshold","lazyPriority","placeholder","lazyPlaceholder","loaded","showPlaceholder","queueComponentLoad","priorityWeight","getPriorityWeight","processLoadingQueue","high","normal","low","loadComponent","showLoadingIndicator","Accept","csrf_token","csrfToken","stateJson","queued","NestedComponentHandler","hierarchyRegistry","childrenRegistry","bubbleCallbacks","scanNestedComponents","liveComponent","parentId","parentComponent","depth","nestingDepth","registerHierarchy","registerRoot","childIds","parentHierarchy","parentPath","children","registerDynamicChild","getHierarchy","getParentId","hierarchy","getChildIds","hasChildren","isRoot","getDepth","getAncestors","ancestors","bubbleEvent","sourceId","payload","currentId","bubbled","currentLevel","onChildEvent","syncStateToChildren","sharedState","childId","childElement","updateChildren","updates","updatePromises","siblings","rootCount","maxDepth","total_components","root_components","child_components","max_nesting_depth","parents_with_children","UploadProgress","fileId","uploadedBytes","totalBytes","xhr","endTime","isComplete","hasError","isUploading","uploadSpeed","remainingTime","updateProgress","setStatus","abort","toObject","fileName","FileValidator","allowedMimeTypes","allowedExtensions","minFileSize","extension","DragDropZone","onFilesDropped","onDragEnter","onDragLeave","dragCounter","isActive","stopPropagation","files","dataTransfer","ComponentFileUploader","componentElement","liveId","autoUpload","multiple","onFileAdded","onFileRemoved","onUploadStart","onUploadProgress","onUploadComplete","onUploadError","onAllUploadsComplete","uploadQueue","activeUploads","maxConcurrentUploads","dropZoneElement","dropZone","fileInputElement","fileInput","initialize","dragDropZone","addFiles","filesToAdd","fileCount","generateFileId","validationErrors","processQueue","removeFile","queueIndex","uploadAll","uploadFile","finally","totalFiles","successCount","errorCount","componentState","getComponentState","csrfTokens","getCsrfTokens","append","XMLHttpRequest","upload","lengthComputable","uploadPromise","responseText","updateComponentState","updateComponentHtml","setRequestHeader","form_id","token","getOverallProgress","uploading","complete","overallProgress","stateElement","contentElement","optimisticStateManager","pendingOperations","snapshots","conflictHandlers","operationIdCounter","applyOptimisticUpdate","currentState","optimisticUpdate","createSnapshot","currentVersion","operation","generateOperationId","expectedVersion","optimisticState","addPendingOperation","operationId","pendingCount","getPendingOperationsCount","confirmOperation","serverState","getPendingOperation","removePendingOperation","hasPendingOperations","clearSnapshot","handleConflict","conflict","snapshot","serverVersion","pendingOperationsCount","clearPendingOperations","conflictHandler","snapshotState","canRetry","getSnapshot","findIndex","op","getPendingOperations","registerConflictHandler","unregisterConflictHandler","retryOperation","retryCallback","total_pending_operations","total_snapshots","has_snapshot","accessibilityManager","liveRegion","componentLiveRegions","focusStates","announcementQueue","announceTimer","createLiveRegion","politeness","region","overflow","createComponentLiveRegion","announce","flushAnnouncements","announcement","componentRegion","captureFocusState","focusState","scrollTop","scrollLeft","keepFocus","restoreFocus","elementToFocus","classes","c","unshift","announceUpdate","updateType","actionMessage","shouldPreserveKeyboardNav","role","has_global_live_region","component_live_regions","tracked_focus_states","pending_announcements","ErrorBoundary","retryStrategies","errorHandlers","maxRetries","retryDelays","standardizedError","standardizeError","handlerError","isRetryable","dispatchErrorEvent","original","retryKey","retryCount","executeAction","params","retryError","existingError","errorEl","messageEl","fontWeight","codeEl","fontSize","marginTop","retryBtn","closeBtn","insertAdjacentElement","registerErrorHandler","clearErrorHandler","clearRetryStrategy","resetRetryStrategies","RequestDeduplicator","pendingRequests","requestCache","cacheTimeout","generateKey","sortedParams","getPendingRequest","registerPendingRequest","promise","getCachedResult","cacheResult","cleanupCache","clearPendingRequests","clearComponent","cachedResults","getStateFromElement","component","parsed","SyntaxError","deserializeState","setStateOnElement","validateState","serializableState","serializeState","ChunkStatus","SessionStatus","ChunkMetadata","hash","retries","UploadSession","totalChunks","uploadedChunks","expectedFileHash","expiresAt","isError","isAborted","canResume","getChunk","getPendingChunks","getUploadingChunks","tooltipManager","tooltips","activeTooltip","hideDelay","maxWidth","tooltip","originalTitle","tooltipPosition","showTimeout","hideTimeout","showTooltip","hideTooltip","hide","_tooltipCleanup","positionTooltip","tooltipId","tooltipRect","pageXOffset","showValidationError","hideValidationError","_validationTooltip","initComponent","cleanupComponent","updateConfig","newConfig","actionLoadingManager","loadingStates","skeletonTemplates","showDelay","transitionDuration","preserveContent","createSkeletonOverlay","template","getSkeletonTemplate","overlay","originalPosition","customTemplate","createFragmentSkeletons","createDefaultSkeleton","offsetHeight","offsetWidth","registerTemplate","unregisterTemplate","isLoading","LiveComponent","debounceTimers","sseClients","componentChannels","lazyLoader","nestedHandler","devTools","errorBoundary","requestDeduplicator","sharedConfig","uiHelper","LiveComponentUIHelper","loadingStateManager","LoadingStateManager","enableDevTools","devToolsInstance","logActionToDevTools","actionName","logAction","logEventToDevTools","logEvent","initLazyLoading","initNestedComponents","pollInterval","pollTimer","setupActionHandlers","setupFileUploadHandlers","startPolling","setupLifecycleObserver","setupSseConnection","setupAccessibility","livePolite","callDestroyHook","sseChannel","sseClient","registerSseHandlers","handleSseComponentUpdate","handleSseComponentFragments","updateSseConnectionStatus","StateSerializer.setStateOnElement","handleServerEvents","updateFragments","componentChannel","sseStatus","_csrf_token","sendBeacon","actionEl","liveAction","formValues","extractFragments","defaultDebounce","debounceMs","liveDebounce","extractParams","debouncedAction","collectFormValues","timerKey","timer","paramKey","paramName","fromAttribute","fragmentsAttr","lcFragments","pendingRequest","cachedResult","loadingConfig","getConfig","optimistic","stateWrapper","StateSerializer.getStateFromElement","_optimistic","requestBody","errorText","substring","parseError","conflictResolution","actualVersion","showConflictNotification","fragmentElement","fragmentNames","dispatchToComponent","targetComponentId","stopPolling","errorHtml","insertAdjacentHTML","notificationHtml","retryButton","dropzone","setupDropzone","showUploadProgress","hideUploadProgress","percent","progressEl","cleanupSseConnection","clearConfig","filtered","h","channelStillInUse","executeBatch","batchRequest","batchResponse","success_count","failure_count","autoApply","applyBatchResults","extractComponentIdFromResult","dispatchComponentEvent","queueBatchOperation","batchQueue","batchQueueTimer","flushDelay","flushBatchQueue","maxConcurrentChunks","retryDelay","enableSSE","apiBase","onInitialized","onChunkProgress","onProgress","onAborted","onSSEProgress","activeSession","initializeSSE","getUserId","handleSSEProgress","session_id","uploaded_chunks","targetPath","initializeSession","uploadChunks","completeUpload","total_chunks","expires_at","batch","uploadChunk","chunkData","readChunk","chunkHash","hashChunk","uploadChunkData","sleep","reader","FileReader","readAsArrayBuffer","hashBuffer","subtle","digest","padStart","chunkIndex","resumed","containerSelector","selectedComponent","componentMetadata","previewInstanceId","componentList","componentSearch","stateEditor","previewContainer","actionTester","metricsDisplay","renderTime","stateSize","actionExecutions","buildUI","loadComponents","attachEventListeners","renderComponentList","actions","has_cache","selectComponent","filterComponents","applyState","resetState","formatJSON","copyCode","searchTerm","term","class","componentName","selectedItem","loadComponentMetadata","renderActions","updateGeneratedCode","jsonText","validationEl","previewComponent","component_name","instance_id","render_time_ms","updateMetrics","parameters","param","actionElement","Number","component_id","action_name","current_state","new_state","alert","writeText","containerElement","showPreviews","showProgress","showFileList","dropZoneText","browseButtonText","uploadButtonText","initializeUploader","browseButton","fileList","fileItems","progressFill","progressText","uploadAllButton","clearAllButton","handleFileAdded","handleFileRemoved","handleUploadStart","handleUploadProgress","handleUploadComplete","handleUploadError","handleAllUploadsComplete","fileElement","createFileElement","updateFileCount","updateFileStatus","progressBar","div","statusClass","getFileIconSvg","truncateFileName","statusElement","progressElement","header","uiManager","activeDialogs","activeNotifications","showDialog","buttons","closeOnBackdrop","closeOnEscape","onConfirm","dialogContent","createDialogContent","showConfirm","confirmText","cancelText","confirmClass","cancelClass","closeDialog","showAlert","buttonText","showNotification","getNotificationColor","hideNotification","notificationOrComponentId","notif","buttonsHtml","btn","btnClass","showLoadingDialog","loadingConfigs","defaultType","configure","loadingType","showSpinner","hideSpinner","hideProgress","spinner","a11yStats","toggleKey","enableTransition","noiseElement","toggle","ctrlKey","metaKey","altKey","settings","speedAttr","defaultSpeed","PerformanceProfiler","maxSamples","samplingInterval","samples","isRecording","recordingStartTime","generateSummary","relativeTime","relativeStartTime","relativeEndTime","sample","functionName","stackTrace","generateFlamegraph","currentNode","funcName","child","generateTimeline","category","categorizeEvent","getEventColor","durations","m","totalMeasures","totalSamples","avgDuration","maxDuration","minDuration","sortedDurations","p50","p90","p99","percentiles","exportToChromeTrace","cat","ph","ts","pid","tid","dur","traceEvents","displayTimeUnit","render","slow","fast","other","unknown","samplesCount","marksCount","measuresCount","timelineEventsCount","recordingDuration","LiveComponentsProfiler","actionCallDepth","instrumentComponent","originalCall","markName","originalSet","originalRender","FlamegraphVisualizer","barPadding","colorScheme","minWidth","selectedNode","createElementNS","fontFamily","borderRadius","totalValue","calculateTotalValue","renderNode","node","getColor","selectNode","getTextColor","truncateText","childX","childY","childWidth","colorMap","network","dom","keyword","hashColor","maxChars","pageX","pageY","firstChild","exportSVG","exportPNG","svgData","XMLSerializer","serializeToString","Image","TimelineVisualizer","trackHeight","handleMouseMove","handleMouseLeave","times","minTime","maxTime","plotWidth","plotHeight","drawAxes","organizeIntoTracks","drawEvent","sortedEvents","eventStart","eventEnd","placed","eStart","eEnd","trackIndex","strokeRect","_bounds","hoveredEvent","timelineEvent","definition","globalProfiler","flamegraphViz","timelineViz","flamegraphContainer","flamegraph","timelineContainer","profiler","flamegraphData","timelineData","exportChromeTrace","createComponentProfiler","LiveComponents","autoInstrument","liveComponents","_profiler","originalRegister","instrumentLiveComponents","RouteGuard","guardFn","to","allowed","BuiltInGuards","auth","guest","requiredRole","requiredPermission","RouteMiddleware","middlewareFn","BuiltInMiddleware","scrollToTop","behavior","Router","mode","base","routes","guards","beforeEachHooks","afterEachHooks","currentRoute","navigations","handlePopState","route","normalizePath","lazy","routesConfig","guard","beforeEach","hook","afterEach","navigate","normalizedPath","guardName","middlewareBlocked","pushState","trackNavigation","renderComponent","HTMLElement","reinitializeModules","updateHistory","getCurrentRoute","totalNavigations","totalErrors","RouterModule","router","getRouter","DependencyManager","modules","dependents","initialized","initializing","initializationOrder","validateDefinition","dep","calculateInitializationOrder","visited","visiting","order","visit","moduleName","checkDependencies","satisfied","markInitialized","markInitializing","getDependents","getModule","isReadyToInitialize","createDefinition","builder","depends","moduleVersion","services","build","setPrototypeOf","defineProperty","enumerable","configurable","dependencyManager","depStatus","scrollSubscription","unsubscribe","subscribe","newPos","oldPos","scrollType","clone","factor","axis","scrollAxis","loopPause","offsetStart","loopOffset","loopLimit","deg","backgroundPosition","activeScrollStep","userConfig","attribute","CsrfManager","tokenName","headerName","refreshInterval","autoRefresh","currentToken","refreshTimer","isRefreshing","getTokenFromPage","startAutoRefresh","updateAllTokens","metaTag","formInput","getToken","refreshToken","newToken","_token","triggerTokenRefreshedEvent","tokenInput","stopAutoRefresh","getTokenHeader","SecurityManager","csrf","xss","sanitizeOnInput","csp","reportOnly","csrfManager","initXssProtection","initCsp","sanitizeInput","originalValue","sanitized","sanitizeHtml","cspHeader","getCspHeader","validateCsp","directives","dir","getCsrfToken","getCsrfTokenHeader","refreshCsrfToken","validateSecurityHeaders","issues","escapeHtml","validateUrl","SecurityModule","securityManager","getSecurityManager","SPARouter","linkSelector","loadingClass","excludeSelector","enableTransitions","skeletonTemplate","createSkeletonTemplate","enableLiveComponentIntegration","preserveLiveComponentState","currentUrl","abortController","handleLinkClick","handleFormSubmit","initLiveComponentIntegration","setupStyles","updateHistoryState","liveComponentIntegration","__vitePreload","__vite_glob_0_12","__VITE_PRELOAD__","default","shiftKey","loadContent","_moduleInstance","AbortController","showLoadingState","signal","newContent","newTitle","jsonData","updateMetaTags","extractMainContent","extractTitle","hideLoadingState","doc","DOMParser","parseFromString","mainElement","fallbackSelectors","titleElement","savedComponentStates","saveLiveComponentStates","transitionOut","initializeLiveComponents","transitionIn","triggerNavigationEvent","states","savedStates","componentElements","replaceState","initAutoFormHandling","metaData","metaDesc","navigateTo","getCurrentUrl","isNavigating","instantTransition","fastTransition","noTransition","getAdaptiveTransition","matchMedia","SPARouterModule","enableSkeletonLoading","spaRouter","handleModuleReinit","handleNavigation","reinitEvent","StateManager$1","StateManager","_e","initialState","persistence","paths","sync","loadPersistedState","initCrossTabSync","defaultValue","lastKey","applyMiddleware","shouldPersist","persistState","broadcastStateChange","dispatch","processedAction","reducer","notifyAllSubscribers","subscribeAll","newValue","pathCallbacks","wildcardCallbacks","pathParts","parentCallbacks","stored","stateToPersist","getPersistedPaths","handleRemoteStateChange","wasSyncEnabled","timeTravel","historyPoint","globalStateManager","getGlobalStateManager","createScopedStateManager","StateManagerModule","getStateManager","createScoped","lastScrollY","activeMap","WeakMap","configCache","scrollDir","wasActive","stepSelector","activeClass","datasetKey","containerOffsetTop","offsetTop","moduleId","containerHeight","stepOffset","nextStepOffset","builtInRules","required","number","integer","isInteger","phone","postalCode","country","DE","US","UK","FR","custom","Validator","schema","customRules","validatedFields","registerRule","rule","fieldSchema","rules","ruleConfig","validateRule","executeRule","ruleName","validateFields","fieldNames","getFieldErrors","isFieldValid","fromForm","validateAttr","customRule","ValidationRule","getName","ValidationModule","WebPushManager","serviceWorkerUrl","vapidPublicKey","onSubscriptionChange","registerServiceWorker","fetchVapidPublicKey","subscription","getSubscription","public_key","ready","pushManager","applicationServerKey","urlBase64ToUint8Array","sendSubscriptionToServer","removeSubscriptionFromServer","isSubscribed","sendTestNotification","subscriptionJson","toJSON","base64String","repeat","rawData","outputArray","getPermissionStatus","webPushManager","moduleConfig","noise","scrollfx","moduleErrorBoundary","crashedModules","recoveryAttempts","maxRecoveryAttempts","recoveryDelay","wrapModule","Proxy","prop","receiver","descriptor","getOwnPropertyDescriptor","handleModuleError","getRecoveryValue","ownKeys","getOwnPropertyNames","errorKey","attempts","scheduleRecovery","markModuleAsPermanentlyFailed","recoveryError","getHealthStatus","totalCrashedModules","toISOString","resetModule","stateOwners","defaultValues","currentModule","subscriptionCounter","setContext","owner","force","subscriptionId","subscriptions","sub","clearModuleSubscriptions","cleared","owners","subs","resetAll","createScope","stateSnapshot","activeModules","initDataModuleElements","moduleData","mod","moduleInstance","_moduleName","forms","formHandlingModule","formOptions","autoOptions","initApp","global","importMeta","glob","eager","__vite_glob_0_0","__vite_glob_0_1","__vite_glob_0_2","__vite_glob_0_3","__vite_glob_0_4","__vite_glob_0_5","__vite_glob_0_6","__vite_glob_0_7","__vite_glob_0_8","__vite_glob_0_9","__vite_glob_0_10","__vite_glob_0_11","__vite_glob_0_13","__vite_glob_0_14","__vite_glob_0_15","__vite_glob_0_16","__vite_glob_0_17","__vite_glob_0_18","__vite_glob_0_19","__vite_glob_0_20","__vite_glob_0_21","__vite_glob_0_22","__vite_glob_0_23","__vite_glob_0_24","__vite_glob_0_25","__vite_glob_0_26","__vite_glob_0_27","__vite_glob_0_28","__vite_glob_0_29","__vite_glob_0_30","__vite_glob_0_31","domModules","coreModules","usedModules","fallbackMode","defaultDef","initOrder","modulePath","depCheck","scopedState","protectedMod","registerModules","spaRouterModule","initSPARouter","videos","net","suffix","newVideo","playsInline","poster","replaceWith","autoLoadResponsiveVideos","moduleHealth","health","FormAutoSave","initializeAll","instances","autosaveInstances"],"ignoreList":[],"sources":["../../../resources/js/core/frameloop.js","../../../resources/js/core/PerformanceMonitor.js","../../../resources/js/core/logger.js","../../../resources/js/modules/analytics/Analytics.js","../../../resources/js/modules/analytics/index.js","../../../resources/js/modules/animation-system/ScrollAnimation.js","../../../resources/js/modules/animation-system/TimelineAnimation.js","../../../resources/js/modules/animation-system/AnimationSystem.js","../../../resources/js/modules/scrollfx/ScrollEngine.js","../../../resources/js/modules/scrollfx/ScrollTrigger.js","../../../resources/js/modules/scrollfx/index.js","../../../resources/js/modules/animation-system/index.js","../../../resources/js/modules/api-manager/ObserverManager.js","../../../resources/js/modules/api-manager/MediaManager.js","../../../resources/js/modules/api-manager/StorageManager.js","../../../resources/js/modules/api-manager/DeviceManager.js","../../../resources/js/modules/api-manager/AnimationManager.js","../../../resources/js/modules/api-manager/WorkerManager.js","../../../resources/js/modules/api-manager/PerformanceManager.js","../../../resources/js/modules/api-manager/PermissionManager.js","../../../resources/js/modules/api-manager/BiometricAuthManager.js","../../../resources/js/modules/api-manager/index.js","../../../resources/js/modules/cache-manager/CacheManager.js","../../../resources/js/modules/cache-manager/CacheStrategy.js","../../../resources/js/modules/cache-manager/index.js","../../../resources/js/core/EventManager.js","../../../resources/js/core/useEvent.js","../../../resources/js/modules/canvas-animations/CanvasManager.js","../../../resources/js/modules/canvas-animations/ScrollEffects.js","../../../resources/js/modules/canvas-animations/InteractiveEffects.js","../../../resources/js/modules/canvas-animations/DataVisualization.js","../../../resources/js/modules/canvas-animations/index.js","../../../resources/js/modules/error-tracking/ErrorTracker.js","../../../resources/js/modules/error-tracking/index.js","../../../resources/js/modules/event-bus/EventBus.js","../../../resources/js/modules/event-bus/index.js","../../../resources/js/modules/example-module/index.js","../../../resources/js/modules/form-handling/FormValidator.js","../../../resources/js/modules/form-handling/FormState.js","../../../resources/js/modules/form-handling/FormHandler.js","../../../resources/js/modules/form-handling/index.js","../../../resources/js/modules/image-manager/index.js","../../../resources/js/modules/inertia-scroll/index.js","../../../resources/js/modules/ui/components/Dialog.js","../../../resources/js/modules/ui/UIManager.js","../../../resources/js/modules/ui/components/Modal.js","../../../resources/js/modules/ui/components/Lightbox.js","../../../resources/js/modules/lightbox-trigger/index.js","../../../resources/js/modules/livecomponent/DomPatcher.js","../../../resources/js/modules/sse/index.js","../../../resources/js/modules/livecomponent/LazyComponentLoader.js","../../../resources/js/modules/livecomponent/NestedComponentHandler.js","../../../resources/js/modules/livecomponent/ComponentFileUploader.js","../../../resources/js/modules/livecomponent/OptimisticStateManager.js","../../../resources/js/modules/livecomponent/AccessibilityManager.js","../../../resources/js/modules/livecomponent/ErrorBoundary.js","../../../resources/js/modules/livecomponent/RequestDeduplicator.js","../../../resources/js/modules/livecomponent/StateSerializer.js","../../../resources/js/modules/livecomponent/ChunkedUploader.js","../../../resources/js/modules/livecomponent/TooltipManager.js","../../../resources/js/modules/livecomponent/ActionLoadingManager.js","../../../resources/js/modules/livecomponent/index.js","../../../resources/js/modules/livecomponent/ComponentPlayground.js","../../../resources/js/modules/livecomponent/FileUploadWidget.js","../../../resources/js/modules/livecomponent/LiveComponentUIHelper.js","../../../resources/js/modules/livecomponent/LoadingStateManager.js","../../../resources/js/modules/noise/index.js","../../../resources/js/modules/parallax/index.js","../../../resources/js/modules/performance-profiler/profiler.js","../../../resources/js/modules/performance-profiler/visualizer.js","../../../resources/js/modules/performance-profiler/index.js","../../../resources/js/modules/router/RouteGuard.js","../../../resources/js/modules/router/RouteMiddleware.js","../../../resources/js/modules/router/Router.js","../../../resources/js/modules/router/index.js","../../../resources/js/core/DependencyManager.js","../../../resources/js/modules/scroll-dependent/index.js","../../../resources/js/modules/scroll-loop/index.js","../../../resources/js/modules/scroll-timeline/steps.js","../../../resources/js/modules/scroll-timeline/index.js","../../../resources/js/modules/security/CsrfManager.js","../../../resources/js/modules/security/SecurityManager.js","../../../resources/js/modules/security/index.js","../../../resources/js/modules/spa-router/SPARouter.js","../../../resources/js/modules/spa-router/transition-config.js","../../../resources/js/modules/spa-router/index.js","../../../resources/js/modules/state-manager/StateManager.js","../../../resources/js/modules/state-manager/index.js","../../../resources/js/modules/sticky-fade/index.js","../../../resources/js/modules/sticky-steps/index.js","../../../resources/js/modules/ui/index.js","../../../resources/js/modules/validation/Validator.js","../../../resources/js/modules/validation/ValidationRule.js","../../../resources/js/modules/validation/index.js","../../../resources/js/modules/webpush/WebPushManager.js","../../../resources/js/modules/webpush/index.js","../../../resources/js/modules/config.js","../../../resources/js/core/ModuleErrorBoundary.js","../../../resources/js/core/StateManager.js","../../../resources/js/modules/index.js","../../../resources/js/core/init.js","../../../resources/js/utils/autoLoadResponsiveVideo.js","../../../resources/js/modules/form-autosave.js","../../../resources/js/main.js"],"sourcesContent":["// modules/core/frameloop.js\nimport {Logger} from \"./logger\";\n\n/**\n * @typedef {Object} FrameTaskOptions\n * @property {boolean} [autoStart=false] - Automatically start the frame loop\n */\n\n/** @type {Map<string, Function>} */\nconst tasks = new Map();\n/** @type {boolean} */\nlet running = false;\n/** @type {boolean} */\nlet showDebug = false;\n\nlet lastTime = performance.now();\nlet frameCount = 0;\nlet fps = 0;\n\n// Create debug overlay\nconst debugOverlay = document.createElement('div');\ndebugOverlay.style.position = 'fixed';\ndebugOverlay.style.bottom = '0';\ndebugOverlay.style.left = '0';\ndebugOverlay.style.font = '12px monospace';\ndebugOverlay.style.color = '#0f0';\ndebugOverlay.style.background = 'rgba(0,0,0,0.75)';\ndebugOverlay.style.padding = '0.25rem 0.5rem';\ndebugOverlay.style.zIndex = '9999';\ndebugOverlay.style.pointerEvents = 'none';\ndebugOverlay.style.display = 'none';\nconst barWidth = Math.min(fps * 2, 100);\nconst bar = `<div style=\"width:${barWidth}%;height:4px;background:#0f0;margin-top:4px;\"></div>`;\ndebugOverlay.innerHTML += bar;\ndebugOverlay.style.lineHeight = '1.4';\ndocument.body.appendChild(debugOverlay);\n\nimport { PerformanceMonitor } from './PerformanceMonitor.js';\n/** @type {PerformanceMonitor} */\nexport const monitor = new PerformanceMonitor();\n\n// Debug toggle with § key\nwindow.addEventListener('keydown', (e) => {\n    if (e.key === '§') {\n        showDebug = !showDebug;\n        debugOverlay.style.display = showDebug ? 'block' : 'none';\n    }\n});\n\n/**\n * Register a task to run on every frame\n * @param {string} id - Unique identifier for the task\n * @param {Function} callback - Function to execute each frame\n * @param {FrameTaskOptions} [options={}] - Task options\n */\nexport function registerFrameTask(id, callback, options = {}) {\n    tasks.set(id, callback);\n    if (options.autoStart && !running) startFrameLoop();\n}\n\n/**\n * Unregister a frame task\n * @param {string} id - Task identifier to remove\n */\nexport function unregisterFrameTask(id) {\n    tasks.delete(id);\n}\n\n/**\n * Clear all registered frame tasks\n */\nexport function clearFrameTasks() {\n    tasks.clear();\n}\n\n/**\n * Start the main frame loop\n */\nexport function startFrameLoop() {\n    if (running) return;\n    running = true;\n\n    function loop() {\n        for (const [id, task] of tasks) {\n            try {\n                if (showDebug) {\n                    monitor.trackTask(id, task);\n                } else {\n                    task();\n                }\n            } catch (err) {\n                Logger.warn(`[Frameloop] Fehler in Task:`, err);\n            }\n        }\n\n        if (showDebug) {\n            monitor.update(tasks);\n        }\n\n        requestAnimationFrame(loop);\n    }\n\n    requestAnimationFrame(loop);\n}\n\n/**\n * Stop the frame loop\n * Note: Loop continues until next frame, this just sets the flag\n */\nexport function stopFrameLoop() {\n    running = false;\n    // Achtung: Loop läuft weiter, solange nicht aktiv gestoppt\n}\n","// modules/core/PerformanceMonitor.js\nexport class PerformanceMonitor {\n    constructor({ fps = true } = {}) {\n        this.fpsEnabled = fps;\n        this.fps = 0;\n        this.frameCount = 0;\n        this.lastTime = performance.now();\n        this.visible = false;\n        this.taskTimings = new Map();\n        this.logs = [];\n\n        this.container = document.createElement('div');\n        this.container.style.position = 'fixed';\n        this.container.style.bottom = '0';\n        this.container.style.left = '0';\n        this.container.style.font = '12px Consolas, monospace';\n        this.container.style.color = '#0f0';\n        this.container.style.background = 'rgba(0,0,0,0.75)';\n        this.container.style.padding = '0.5rem';\n        this.container.style.zIndex = '9999';\n        this.container.style.pointerEvents = 'none';\n        this.container.style.lineHeight = '1.4';\n        this.container.style.whiteSpace = 'pre';\n        this.container.style.display = 'none';\n\n        document.body.appendChild(this.container);\n\n        window.addEventListener('keydown', (e) => {\n            if (e.key === '§') {\n                this.visible = !this.visible;\n                this.container.style.display = this.visible ? 'block' : 'none';\n            }\n        });\n    }\n\n    log(message) {\n        const timestamp = new Date().toLocaleTimeString();\n        this.logs.push(`[${timestamp}] ${message}`);\n        if (this.logs.length > 5) this.logs.shift();\n    }\n\n    update(taskMap = new Map()) {\n        this.frameCount++;\n        const now = performance.now();\n        if (now - this.lastTime >= 1000) {\n            this.fps = this.frameCount;\n            this.frameCount = 0;\n            this.lastTime = now;\n\n            const timings = [];\n            for (const [id, duration] of this.taskTimings.entries()) {\n                timings.push(`${id}: ${duration.toFixed(2)}ms`);\n            }\n\n            const barWidth = Math.min(this.fps * 2, 100);\n            const logOutput = this.logs.slice().reverse().join('\\n');\n\n            this.container.innerHTML = `\nFPS: ${this.fps} | Tasks: ${taskMap.size}\n${timings.join('\\n')}\n<div style=\"width:${barWidth}%;height:4px;background:#0f0;margin-top:4px;\"></div>\n${logOutput ? '\\nLogs:\\n' + logOutput : ''}\n      `;\n        }\n    }\n\n    trackTask(id, callback) {\n        const start = performance.now();\n        callback();\n        const duration = performance.now() - start;\n        this.taskTimings.set(id, duration);\n    }\n}\n","import {monitor} from \"./frameloop\";\n\n/**\n * Centralized logging system with performance monitoring integration\n * @class Logger\n */\nexport class Logger {\n    /** @type {boolean} Enable/disable logging */\n    static enabled = import.meta.env.MODE !== 'production';\n    \n    /** @type {string} Log level: 'debug', 'info', 'warn', 'error', 'none' */\n    static level = import.meta.env.VITE_LOG_LEVEL || (import.meta.env.MODE === 'production' ? 'error' : 'debug');\n    \n    /** @type {Object} Log level priorities */\n    static levels = {\n        debug: 0,\n        info: 1,\n        warn: 2, \n        error: 3,\n        none: 99\n    };\n\n    /**\n     * Log debug messages (development only)\n     * @param {...any} args - Arguments to log\n     */\n    static debug(...args) {\n        this._write('log', '[DEBUG]', args, 'debug');\n    }\n\n    /**\n     * Log general information\n     * @param {...any} args - Arguments to log\n     */\n    static log(...args) {\n        this._write('log', '[LOG]', args, 'info');\n    }\n\n    /**\n     * Log informational messages\n     * @param {...any} args - Arguments to log\n     */\n    static info(...args) {\n        this._write('info', '[INFO]', args, 'info');\n    }\n\n    /**\n     * Log warning messages\n     * @param {...any} args - Arguments to log\n     */\n    static warn(...args) {\n        this._write('warn', '[WARN]', args, 'warn');\n    }\n\n    /**\n     * Log error messages\n     * @param {...any} args - Arguments to log\n     */\n    static error(...args) {\n        this._write('error', '[ERROR]', args, 'error');\n    }\n\n    /**\n     * Internal method to write log messages\n     * @private\n     * @param {string} consoleMethod - Console method to use\n     * @param {string} prefix - Log level prefix\n     * @param {Array} args - Arguments to log\n     * @param {string} logLevel - Log level (debug, info, warn, error)\n     */\n    static _write(consoleMethod, prefix, args, logLevel = 'info') {\n        if (!this.enabled) return;\n        \n        // Check if this log level should be output\n        const currentLevelPriority = this.levels[this.level] || this.levels.info;\n        const messageLevelPriority = this.levels[logLevel] || this.levels.info;\n        \n        if (messageLevelPriority < currentLevelPriority) {\n            return;\n        }\n\n        const date = new Date();\n        const timestamp = date.toLocaleTimeString('de-DE');\n\n        const msg = `${prefix} [${timestamp}] ${args.map(a => {\n            if (a instanceof Error) {\n                return `${a.name}: ${a.message}\\n${a.stack || ''}`;\n            } else if (typeof a === 'object' && a !== null) {\n                try {\n                    return JSON.stringify(a);\n                } catch (e) {\n                    return '[Circular Object]';\n                }\n            }\n            return a;\n        }).join(' ')}`;\n\n        if(typeof console[consoleMethod] === 'function') {\n            console[consoleMethod](msg);\n        }\n\n        // Safe monitor logging\n        if (monitor && typeof monitor.log === 'function') {\n            try {\n                monitor.log(msg);\n            } catch (e) {\n                // Silent fail if monitor fails\n            }\n        }\n    }\n\n    /**\n     * Set log level dynamically\n     * @param {string} level - New log level (debug, info, warn, error, none)\n     */\n    static setLevel(level) {\n        if (this.levels.hasOwnProperty(level)) {\n            this.level = level;\n            this.info(`[Logger] Log level set to: ${level}`);\n        } else {\n            this.warn(`[Logger] Invalid log level: ${level}. Valid levels:`, Object.keys(this.levels));\n        }\n    }\n\n    /**\n     * Enable/disable logging\n     * @param {boolean} enabled - Enable or disable logging\n     */\n    static setEnabled(enabled) {\n        this.enabled = !!enabled;\n        if (enabled) {\n            console.log('[Logger] Logging enabled');\n        }\n    }\n}\n","/**\r\n * Analytics Module\r\n * \r\n * Provides unified analytics system for event tracking, page views, and user behavior.\r\n * Features:\r\n * - Event tracking\r\n * - Page view tracking\r\n * - User behavior tracking\r\n * - Custom events\r\n * - Integration with LiveComponents\r\n * - GDPR compliance\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * AnalyticsProvider - Base class for analytics providers\r\n */\r\nexport class AnalyticsProvider {\r\n    constructor(config = {}) {\r\n        this.config = config;\r\n        this.enabled = config.enabled ?? true;\r\n    }\r\n    \r\n    /**\r\n     * Track event\r\n     */\r\n    async track(eventName, properties = {}) {\r\n        if (!this.enabled) return;\r\n        // Override in subclasses\r\n    }\r\n    \r\n    /**\r\n     * Track page view\r\n     */\r\n    async pageView(path, properties = {}) {\r\n        if (!this.enabled) return;\r\n        // Override in subclasses\r\n    }\r\n    \r\n    /**\r\n     * Identify user\r\n     */\r\n    async identify(userId, traits = {}) {\r\n        if (!this.enabled) return;\r\n        // Override in subclasses\r\n    }\r\n}\r\n\r\n/**\r\n * GoogleAnalyticsProvider - Google Analytics integration\r\n */\r\nexport class GoogleAnalyticsProvider extends AnalyticsProvider {\r\n    constructor(config = {}) {\r\n        super(config);\r\n        this.measurementId = config.measurementId || config.gaId;\r\n    }\r\n    \r\n    async track(eventName, properties = {}) {\r\n        if (typeof gtag !== 'undefined') {\r\n            gtag('event', eventName, properties);\r\n        }\r\n    }\r\n    \r\n    async pageView(path, properties = {}) {\r\n        if (typeof gtag !== 'undefined') {\r\n            gtag('config', this.measurementId, {\r\n                page_path: path,\r\n                ...properties\r\n            });\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * CustomProvider - Custom analytics endpoint\r\n */\r\nexport class CustomProvider extends AnalyticsProvider {\r\n    constructor(config = {}) {\r\n        super(config);\r\n        this.endpoint = config.endpoint || '/api/analytics';\r\n    }\r\n    \r\n    async track(eventName, properties = {}) {\r\n        try {\r\n            await fetch(this.endpoint, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-Requested-With': 'XMLHttpRequest'\r\n                },\r\n                body: JSON.stringify({\r\n                    type: 'event',\r\n                    name: eventName,\r\n                    properties,\r\n                    timestamp: Date.now()\r\n                })\r\n            });\r\n        } catch (error) {\r\n            Logger.error('[Analytics] Failed to track event', error);\r\n        }\r\n    }\r\n    \r\n    async pageView(path, properties = {}) {\r\n        try {\r\n            await fetch(this.endpoint, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-Requested-With': 'XMLHttpRequest'\r\n                },\r\n                body: JSON.stringify({\r\n                    type: 'page_view',\r\n                    path,\r\n                    properties,\r\n                    timestamp: Date.now()\r\n                })\r\n            });\r\n        } catch (error) {\r\n            Logger.error('[Analytics] Failed to track page view', error);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Analytics - Unified analytics system\r\n */\r\nexport class Analytics {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            enabled: config.enabled ?? true,\r\n            providers: config.providers || [],\r\n            gdprCompliant: config.gdprCompliant ?? true,\r\n            requireConsent: config.requireConsent ?? false,\r\n            consentGiven: config.consentGiven ?? false,\r\n            anonymizeIp: config.anonymizeIp ?? true,\r\n            ...config\r\n        };\r\n        \r\n        this.providers = [];\r\n        this.eventQueue = [];\r\n        this.userId = null;\r\n        this.userTraits = {};\r\n        \r\n        // Initialize providers\r\n        this.initProviders();\r\n        \r\n        // Track initial page view\r\n        if (this.config.enabled && this.hasConsent()) {\r\n            this.trackPageView();\r\n        }\r\n        \r\n        Logger.info('[Analytics] Initialized', {\r\n            enabled: this.config.enabled,\r\n            providers: this.providers.length,\r\n            gdprCompliant: this.config.gdprCompliant\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Create a new Analytics instance\r\n     */\r\n    static create(config = {}) {\r\n        return new Analytics(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize providers\r\n     */\r\n    initProviders() {\r\n        for (const providerConfig of this.config.providers) {\r\n            let provider;\r\n            \r\n            if (typeof providerConfig === 'string') {\r\n                // Provider name\r\n                if (providerConfig === 'google-analytics' || providerConfig === 'ga') {\r\n                    provider = new GoogleAnalyticsProvider({});\r\n                } else if (providerConfig === 'custom') {\r\n                    provider = new CustomProvider({});\r\n                }\r\n            } else if (typeof providerConfig === 'object') {\r\n                // Provider config\r\n                if (providerConfig.type === 'google-analytics' || providerConfig.type === 'ga') {\r\n                    provider = new GoogleAnalyticsProvider(providerConfig);\r\n                } else if (providerConfig.type === 'custom') {\r\n                    provider = new CustomProvider(providerConfig);\r\n                } else if (providerConfig instanceof AnalyticsProvider) {\r\n                    provider = providerConfig;\r\n                }\r\n            }\r\n            \r\n            if (provider) {\r\n                this.providers.push(provider);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Check if consent is given (GDPR)\r\n     */\r\n    hasConsent() {\r\n        if (!this.config.requireConsent) {\r\n            return true;\r\n        }\r\n        return this.config.consentGiven;\r\n    }\r\n    \r\n    /**\r\n     * Give consent (GDPR)\r\n     */\r\n    giveConsent() {\r\n        this.config.consentGiven = true;\r\n        \r\n        // Process queued events\r\n        this.processEventQueue();\r\n        \r\n        Logger.info('[Analytics] Consent given');\r\n    }\r\n    \r\n    /**\r\n     * Revoke consent (GDPR)\r\n     */\r\n    revokeConsent() {\r\n        this.config.consentGiven = false;\r\n        Logger.info('[Analytics] Consent revoked');\r\n    }\r\n    \r\n    /**\r\n     * Track event\r\n     */\r\n    async track(eventName, properties = {}) {\r\n        if (!this.config.enabled || !this.hasConsent()) {\r\n            // Queue event if consent required\r\n            if (this.config.requireConsent && !this.config.consentGiven) {\r\n                this.eventQueue.push({ type: 'event', name: eventName, properties });\r\n            }\r\n            return;\r\n        }\r\n        \r\n        const eventData = {\r\n            name: eventName,\r\n            properties: this.anonymizeData(properties),\r\n            timestamp: Date.now(),\r\n            userId: this.userId\r\n        };\r\n        \r\n        // Send to all providers\r\n        for (const provider of this.providers) {\r\n            try {\r\n                await provider.track(eventName, eventData.properties);\r\n            } catch (error) {\r\n                Logger.error('[Analytics] Provider error', error);\r\n            }\r\n        }\r\n        \r\n        Logger.debug('[Analytics] Event tracked', eventData);\r\n        \r\n        // Trigger event\r\n        this.triggerAnalyticsEvent('track', eventData);\r\n    }\r\n    \r\n    /**\r\n     * Track page view\r\n     */\r\n    async trackPageView(path = null, properties = {}) {\r\n        if (!this.config.enabled || !this.hasConsent()) {\r\n            return;\r\n        }\r\n        \r\n        const pagePath = path || window.location.pathname;\r\n        const pageData = {\r\n            path: pagePath,\r\n            title: document.title,\r\n            properties: this.anonymizeData(properties),\r\n            timestamp: Date.now()\r\n        };\r\n        \r\n        // Send to all providers\r\n        for (const provider of this.providers) {\r\n            try {\r\n                await provider.pageView(pagePath, pageData.properties);\r\n            } catch (error) {\r\n                Logger.error('[Analytics] Provider error', error);\r\n            }\r\n        }\r\n        \r\n        Logger.debug('[Analytics] Page view tracked', pageData);\r\n        \r\n        // Trigger event\r\n        this.triggerAnalyticsEvent('page_view', pageData);\r\n    }\r\n    \r\n    /**\r\n     * Identify user\r\n     */\r\n    async identify(userId, traits = {}) {\r\n        if (!this.config.enabled || !this.hasConsent()) {\r\n            return;\r\n        }\r\n        \r\n        this.userId = userId;\r\n        this.userTraits = { ...this.userTraits, ...traits };\r\n        \r\n        // Send to all providers\r\n        for (const provider of this.providers) {\r\n            try {\r\n                if (typeof provider.identify === 'function') {\r\n                    await provider.identify(userId, this.userTraits);\r\n                }\r\n            } catch (error) {\r\n                Logger.error('[Analytics] Provider error', error);\r\n            }\r\n        }\r\n        \r\n        Logger.debug('[Analytics] User identified', { userId, traits: this.userTraits });\r\n    }\r\n    \r\n    /**\r\n     * Track user behavior\r\n     */\r\n    async trackBehavior(action, target, properties = {}) {\r\n        await this.track('user_behavior', {\r\n            action,\r\n            target,\r\n            ...properties\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Anonymize data for GDPR compliance\r\n     */\r\n    anonymizeData(data) {\r\n        if (!this.config.gdprCompliant) {\r\n            return data;\r\n        }\r\n        \r\n        const anonymized = { ...data };\r\n        \r\n        // Anonymize IP if enabled\r\n        if (this.config.anonymizeIp && anonymized.ip) {\r\n            anonymized.ip = anonymized.ip.split('.').slice(0, 3).join('.') + '.0';\r\n        }\r\n        \r\n        // Remove PII if present\r\n        const piiFields = ['email', 'phone', 'address', 'ssn', 'credit_card'];\r\n        piiFields.forEach(field => {\r\n            if (anonymized[field]) {\r\n                delete anonymized[field];\r\n            }\r\n        });\r\n        \r\n        return anonymized;\r\n    }\r\n    \r\n    /**\r\n     * Process queued events\r\n     */\r\n    processEventQueue() {\r\n        while (this.eventQueue.length > 0) {\r\n            const event = this.eventQueue.shift();\r\n            if (event.type === 'event') {\r\n                this.track(event.name, event.properties);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Trigger analytics event\r\n     */\r\n    triggerAnalyticsEvent(type, data) {\r\n        const event = new CustomEvent(`analytics:${type}`, {\r\n            detail: data,\r\n            bubbles: true\r\n        });\r\n        window.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Enable analytics\r\n     */\r\n    enable() {\r\n        this.config.enabled = true;\r\n        Logger.info('[Analytics] Enabled');\r\n    }\r\n    \r\n    /**\r\n     * Disable analytics\r\n     */\r\n    disable() {\r\n        this.config.enabled = false;\r\n        Logger.info('[Analytics] Disabled');\r\n    }\r\n    \r\n    /**\r\n     * Destroy analytics\r\n     */\r\n    destroy() {\r\n        this.providers = [];\r\n        this.eventQueue = [];\r\n        this.userId = null;\r\n        this.userTraits = {};\r\n        \r\n        Logger.info('[Analytics] Destroyed');\r\n    }\r\n}\r\n\r\n","/**\r\n * Analytics Module\r\n * \r\n * Provides unified analytics system for event tracking, page views, and user behavior.\r\n * \r\n * Usage:\r\n * - Add data-module=\"analytics\" to enable global analytics\r\n * - Or import and use directly: import { Analytics } from './modules/analytics/index.js'\r\n * \r\n * Features:\r\n * - Event tracking\r\n * - Page view tracking\r\n * - User behavior tracking\r\n * - Custom events\r\n * - Integration with LiveComponents\r\n * - GDPR compliance\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { Analytics, AnalyticsProvider, GoogleAnalyticsProvider, CustomProvider } from './Analytics.js';\r\n\r\nconst AnalyticsModule = {\r\n    name: 'analytics',\r\n    analytics: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[AnalyticsModule] Module initialized');\r\n        \r\n        // Create analytics instance\r\n        this.analytics = Analytics.create(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.Analytics = this.analytics;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get analytics instance\r\n     */\r\n    getAnalytics() {\r\n        return this.analytics || Analytics.create();\r\n    },\r\n    \r\n    /**\r\n     * Track event\r\n     */\r\n    async track(eventName, properties = {}) {\r\n        const analytics = this.getAnalytics();\r\n        return await analytics.track(eventName, properties);\r\n    },\r\n    \r\n    /**\r\n     * Track page view\r\n     */\r\n    async trackPageView(path = null, properties = {}) {\r\n        const analytics = this.getAnalytics();\r\n        return await analytics.trackPageView(path, properties);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.analytics) {\r\n            this.analytics.destroy();\r\n            this.analytics = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.Analytics) {\r\n            delete window.Analytics;\r\n        }\r\n        \r\n        Logger.info('[AnalyticsModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { Analytics, AnalyticsProvider, GoogleAnalyticsProvider, CustomProvider };\r\n\r\n// Export as default for module system\r\nexport default AnalyticsModule;\r\n\r\n// Export init function for module system\r\nexport const init = AnalyticsModule.init.bind(AnalyticsModule);\r\n\r\n","/**\r\n * Scroll Animation\r\n * \r\n * Handles various scroll-based animations: fade-in, zoom-in, parallax, sticky-fade, sticky-steps\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * ScrollAnimation - Individual scroll animation\r\n */\r\nexport class ScrollAnimation {\r\n    constructor(element, config = {}) {\r\n        this.element = element;\r\n        this.config = {\r\n            type: config.type || 'fade-in',\r\n            offset: config.offset || 0.85,\r\n            delay: config.delay || 0,\r\n            once: config.once !== false,\r\n            speed: config.speed || 0.5,\r\n            fadeStart: config.fadeStart || 0,\r\n            fadeEnd: config.fadeEnd || 1,\r\n            steps: config.steps || 3,\r\n            ...config\r\n        };\r\n        \r\n        this.triggered = false;\r\n        this.needsUpdate = true;\r\n        \r\n        // Initialize based on type\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Initialize animation\r\n     */\r\n    init() {\r\n        switch (this.config.type) {\r\n            case 'fade-in':\r\n            case 'zoom-in':\r\n                this.initFadeIn();\r\n                break;\r\n            case 'parallax':\r\n                this.initParallax();\r\n                break;\r\n            case 'sticky-fade':\r\n                this.initStickyFade();\r\n                break;\r\n            case 'sticky-steps':\r\n                this.initStickySteps();\r\n                break;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Initialize fade-in animation\r\n     */\r\n    initFadeIn() {\r\n        this.element.style.opacity = '0';\r\n        this.element.style.transition = `opacity 0.6s ease, transform 0.6s ease`;\r\n        this.element.style.transitionDelay = `${this.config.delay}s`;\r\n        \r\n        if (this.config.type === 'zoom-in') {\r\n            this.element.style.transform = 'scale(0.9)';\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Initialize parallax animation\r\n     */\r\n    initParallax() {\r\n        // Parallax doesn't need initial setup\r\n        this.needsUpdate = true;\r\n    }\r\n    \r\n    /**\r\n     * Initialize sticky fade animation\r\n     */\r\n    initStickyFade() {\r\n        this.element.style.position = 'sticky';\r\n        this.element.style.top = '0';\r\n    }\r\n    \r\n    /**\r\n     * Initialize sticky steps animation\r\n     */\r\n    initStickySteps() {\r\n        this.element.style.position = 'sticky';\r\n        this.element.style.top = '0';\r\n    }\r\n    \r\n    /**\r\n     * Enter animation (element enters viewport)\r\n     */\r\n    enter() {\r\n        if (this.triggered && this.config.once) {\r\n            return;\r\n        }\r\n        \r\n        this.triggered = true;\r\n        \r\n        switch (this.config.type) {\r\n            case 'fade-in':\r\n                this.element.style.opacity = '1';\r\n                this.element.classList.add('visible', 'entered');\r\n                break;\r\n            case 'zoom-in':\r\n                this.element.style.opacity = '1';\r\n                this.element.style.transform = 'scale(1)';\r\n                this.element.classList.add('visible', 'entered');\r\n                break;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Exit animation (element exits viewport)\r\n     */\r\n    exit() {\r\n        if (this.config.once) {\r\n            return;\r\n        }\r\n        \r\n        this.triggered = false;\r\n        \r\n        switch (this.config.type) {\r\n            case 'fade-in':\r\n                this.element.style.opacity = '0';\r\n                this.element.classList.remove('visible', 'entered');\r\n                break;\r\n            case 'zoom-in':\r\n                this.element.style.opacity = '0';\r\n                this.element.style.transform = 'scale(0.9)';\r\n                this.element.classList.remove('visible', 'entered');\r\n                break;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Update animation (for scroll-based animations)\r\n     */\r\n    update() {\r\n        const rect = this.element.getBoundingClientRect();\r\n        const viewportHeight = window.innerHeight;\r\n        const scrollY = window.scrollY;\r\n        \r\n        switch (this.config.type) {\r\n            case 'parallax':\r\n                this.updateParallax(rect, scrollY);\r\n                break;\r\n            case 'sticky-fade':\r\n                this.updateStickyFade(rect, viewportHeight);\r\n                break;\r\n            case 'sticky-steps':\r\n                this.updateStickySteps(rect, viewportHeight, scrollY);\r\n                break;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Update parallax animation\r\n     */\r\n    updateParallax(rect, scrollY) {\r\n        const elementTop = rect.top + scrollY;\r\n        const scrolled = scrollY - elementTop;\r\n        const translateY = scrolled * this.config.speed;\r\n        \r\n        this.element.style.transform = `translateY(${translateY}px)`;\r\n    }\r\n    \r\n    /**\r\n     * Update sticky fade animation\r\n     */\r\n    updateStickyFade(rect, viewportHeight) {\r\n        const progress = Math.max(0, Math.min(1, (viewportHeight - rect.top) / viewportHeight));\r\n        const opacity = this.config.fadeStart + (this.config.fadeEnd - this.config.fadeStart) * progress;\r\n        \r\n        this.element.style.opacity = opacity.toString();\r\n    }\r\n    \r\n    /**\r\n     * Update sticky steps animation\r\n     */\r\n    updateStickySteps(rect, viewportHeight, scrollY) {\r\n        const elementTop = rect.top + scrollY - viewportHeight;\r\n        const scrollProgress = Math.max(0, Math.min(1, scrollY / (rect.height + viewportHeight)));\r\n        const step = Math.floor(scrollProgress * this.config.steps);\r\n        \r\n        this.element.setAttribute('data-step', step.toString());\r\n        this.element.classList.remove('step-0', 'step-1', 'step-2', 'step-3', 'step-4', 'step-5');\r\n        this.element.classList.add(`step-${step}`);\r\n    }\r\n    \r\n    /**\r\n     * Destroy animation\r\n     */\r\n    destroy() {\r\n        // Reset styles\r\n        this.element.style.opacity = '';\r\n        this.element.style.transform = '';\r\n        this.element.style.transition = '';\r\n        this.element.style.transitionDelay = '';\r\n        this.element.style.position = '';\r\n        this.element.style.top = '';\r\n        \r\n        // Remove classes\r\n        this.element.classList.remove('visible', 'entered');\r\n        \r\n        this.triggered = false;\r\n    }\r\n}\r\n\r\n","/**\r\n * Timeline Animation\r\n * \r\n * Handles scroll timeline animations (scroll-timeline, scroll-loop)\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * TimelineAnimation - Scroll timeline animation\r\n */\r\nexport class TimelineAnimation {\r\n    constructor(element, config = {}) {\r\n        this.element = element;\r\n        this.config = {\r\n            steps: config.steps || null,\r\n            triggerPoint: config.triggerPoint || 0.4,\r\n            loop: config.loop ?? false,\r\n            ...config\r\n        };\r\n        \r\n        this.currentStep = 0;\r\n        this.triggered = false;\r\n        \r\n        // Initialize\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Initialize timeline animation\r\n     */\r\n    init() {\r\n        // Set initial step\r\n        this.element.setAttribute('data-scroll-step', '0');\r\n        this.element.classList.add('scroll-timeline');\r\n    }\r\n    \r\n    /**\r\n     * Enter animation\r\n     */\r\n    enter() {\r\n        if (this.triggered && !this.config.loop) {\r\n            return;\r\n        }\r\n        \r\n        this.triggered = true;\r\n        this.update();\r\n    }\r\n    \r\n    /**\r\n     * Exit animation\r\n     */\r\n    exit() {\r\n        if (this.config.loop) {\r\n            this.currentStep = 0;\r\n            this.update();\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Update animation based on scroll position\r\n     */\r\n    update() {\r\n        const rect = this.element.getBoundingClientRect();\r\n        const viewportHeight = window.innerHeight;\r\n        const triggerY = viewportHeight * this.config.triggerPoint;\r\n        \r\n        if (rect.top < triggerY && rect.bottom > 0) {\r\n            // Calculate progress\r\n            const progress = Math.max(0, Math.min(1, (triggerY - rect.top) / (rect.height + viewportHeight)));\r\n            \r\n            if (this.config.steps) {\r\n                // Step-based animation\r\n                const step = Math.floor(progress * this.config.steps);\r\n                this.setStep(step);\r\n            } else {\r\n                // Continuous animation\r\n                this.setProgress(progress);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Set step\r\n     */\r\n    setStep(step) {\r\n        if (step === this.currentStep) {\r\n            return;\r\n        }\r\n        \r\n        this.currentStep = step;\r\n        this.element.setAttribute('data-scroll-step', step.toString());\r\n        \r\n        // Remove old step classes\r\n        for (let i = 0; i <= this.config.steps; i++) {\r\n            this.element.classList.remove(`step-${i}`);\r\n        }\r\n        \r\n        // Add new step class\r\n        this.element.classList.add(`step-${step}`);\r\n        \r\n        // Trigger event\r\n        this.triggerStepEvent(step);\r\n    }\r\n    \r\n    /**\r\n     * Set progress (continuous)\r\n     */\r\n    setProgress(progress) {\r\n        this.element.setAttribute('data-scroll-progress', progress.toString());\r\n        this.element.style.setProperty('--scroll-progress', progress.toString());\r\n        \r\n        // Trigger event\r\n        this.triggerProgressEvent(progress);\r\n    }\r\n    \r\n    /**\r\n     * Trigger step event\r\n     */\r\n    triggerStepEvent(step) {\r\n        const event = new CustomEvent('scroll-timeline:step', {\r\n            detail: { step, element: this.element },\r\n            bubbles: true\r\n        });\r\n        this.element.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Trigger progress event\r\n     */\r\n    triggerProgressEvent(progress) {\r\n        const event = new CustomEvent('scroll-timeline:progress', {\r\n            detail: { progress, element: this.element },\r\n            bubbles: true\r\n        });\r\n        this.element.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Destroy animation\r\n     */\r\n    destroy() {\r\n        this.element.removeAttribute('data-scroll-step');\r\n        this.element.removeAttribute('data-scroll-progress');\r\n        this.element.style.removeProperty('--scroll-progress');\r\n        this.element.classList.remove('scroll-timeline');\r\n        \r\n        // Remove step classes\r\n        for (let i = 0; i <= 10; i++) {\r\n            this.element.classList.remove(`step-${i}`);\r\n        }\r\n        \r\n        this.currentStep = 0;\r\n        this.triggered = false;\r\n    }\r\n}\r\n\r\n","/**\r\n * Unified Animation System\r\n * \r\n * Consolidates all scroll animation modules into a single, unified system.\r\n * Replaces: scrollfx, parallax, scroll-timeline, scroll-loop, scroll-dependent, sticky-fade, sticky-steps\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { ScrollAnimation } from './ScrollAnimation.js';\r\nimport { TimelineAnimation } from './TimelineAnimation.js';\r\n\r\n/**\r\n * AnimationSystem - Unified animation system\r\n */\r\nexport class AnimationSystem {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            enabled: config.enabled ?? true,\r\n            useIntersectionObserver: config.useIntersectionObserver ?? true,\r\n            throttleDelay: config.throttleDelay || 16, // ~60fps\r\n            ...config\r\n        };\r\n        \r\n        this.animations = new Map(); // Map<element, Animation>\r\n        this.observers = new Map(); // Map<element, IntersectionObserver>\r\n        this.scrollHandler = null;\r\n        this.isScrolling = false;\r\n        \r\n        // Initialize\r\n        if (this.config.enabled) {\r\n            this.init();\r\n        }\r\n        \r\n        Logger.info('[AnimationSystem] Initialized', {\r\n            enabled: this.config.enabled,\r\n            useIntersectionObserver: this.config.useIntersectionObserver\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Create a new AnimationSystem instance\r\n     */\r\n    static create(config = {}) {\r\n        return new AnimationSystem(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize animation system\r\n     */\r\n    init() {\r\n        // Set up scroll handler\r\n        if (!this.config.useIntersectionObserver) {\r\n            this.setupScrollHandler();\r\n        }\r\n        \r\n        // Auto-initialize elements with data attributes\r\n        this.autoInitialize();\r\n    }\r\n    \r\n    /**\r\n     * Set up scroll handler\r\n     */\r\n    setupScrollHandler() {\r\n        let ticking = false;\r\n        \r\n        this.scrollHandler = () => {\r\n            if (!ticking) {\r\n                window.requestAnimationFrame(() => {\r\n                    this.updateAnimations();\r\n                    ticking = false;\r\n                });\r\n                ticking = true;\r\n            }\r\n        };\r\n        \r\n        window.addEventListener('scroll', this.scrollHandler, { passive: true });\r\n    }\r\n    \r\n    /**\r\n     * Auto-initialize elements with data attributes\r\n     */\r\n    autoInitialize() {\r\n        // Fade in on scroll (scrollfx)\r\n        this.initializeFadeIn();\r\n        \r\n        // Parallax\r\n        this.initializeParallax();\r\n        \r\n        // Scroll timeline\r\n        this.initializeTimeline();\r\n        \r\n        // Sticky fade\r\n        this.initializeStickyFade();\r\n        \r\n        // Sticky steps\r\n        this.initializeStickySteps();\r\n    }\r\n    \r\n    /**\r\n     * Initialize fade-in animations (scrollfx)\r\n     */\r\n    initializeFadeIn() {\r\n        const elements = document.querySelectorAll('.fade-in-on-scroll, .zoom-in, [data-animate=\"fade-in\"]');\r\n        elements.forEach(element => {\r\n            this.registerAnimation(element, {\r\n                type: 'fade-in',\r\n                offset: parseFloat(element.dataset.offset) || 0.85,\r\n                delay: parseFloat(element.dataset.delay) || 0,\r\n                once: element.dataset.once !== 'false'\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize parallax animations\r\n     */\r\n    initializeParallax() {\r\n        const elements = document.querySelectorAll('[data-parallax], .parallax');\r\n        elements.forEach(element => {\r\n            const speed = parseFloat(element.dataset.parallax || element.dataset.speed) || 0.5;\r\n            this.registerAnimation(element, {\r\n                type: 'parallax',\r\n                speed\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize timeline animations (scroll-timeline)\r\n     */\r\n    initializeTimeline() {\r\n        const elements = document.querySelectorAll('[data-scroll-timeline], [data-scroll-step]');\r\n        elements.forEach(element => {\r\n            this.registerAnimation(element, {\r\n                type: 'timeline',\r\n                steps: element.dataset.scrollSteps ? parseInt(element.dataset.scrollSteps) : null,\r\n                triggerPoint: parseFloat(element.dataset.triggerPoint) || 0.4\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize sticky fade animations\r\n     */\r\n    initializeStickyFade() {\r\n        const elements = document.querySelectorAll('[data-sticky-fade], .sticky-fade');\r\n        elements.forEach(element => {\r\n            this.registerAnimation(element, {\r\n                type: 'sticky-fade',\r\n                fadeStart: parseFloat(element.dataset.fadeStart) || 0,\r\n                fadeEnd: parseFloat(element.dataset.fadeEnd) || 1\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize sticky steps animations\r\n     */\r\n    initializeStickySteps() {\r\n        const elements = document.querySelectorAll('[data-sticky-steps], .sticky-steps');\r\n        elements.forEach(element => {\r\n            const steps = element.dataset.stickySteps ? parseInt(element.dataset.stickySteps) : 3;\r\n            this.registerAnimation(element, {\r\n                type: 'sticky-steps',\r\n                steps\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Register an animation\r\n     */\r\n    registerAnimation(element, config) {\r\n        if (this.animations.has(element)) {\r\n            Logger.warn('[AnimationSystem] Animation already registered for element', element);\r\n            return;\r\n        }\r\n        \r\n        let animation;\r\n        \r\n        switch (config.type) {\r\n            case 'fade-in':\r\n            case 'zoom-in':\r\n                animation = new ScrollAnimation(element, {\r\n                    type: config.type,\r\n                    offset: config.offset || 0.85,\r\n                    delay: config.delay || 0,\r\n                    once: config.once !== false\r\n                });\r\n                break;\r\n                \r\n            case 'parallax':\r\n                animation = new ScrollAnimation(element, {\r\n                    type: 'parallax',\r\n                    speed: config.speed || 0.5\r\n                });\r\n                break;\r\n                \r\n            case 'timeline':\r\n                animation = new TimelineAnimation(element, {\r\n                    steps: config.steps,\r\n                    triggerPoint: config.triggerPoint || 0.4\r\n                });\r\n                break;\r\n                \r\n            case 'sticky-fade':\r\n                animation = new ScrollAnimation(element, {\r\n                    type: 'sticky-fade',\r\n                    fadeStart: config.fadeStart || 0,\r\n                    fadeEnd: config.fadeEnd || 1\r\n                });\r\n                break;\r\n                \r\n            case 'sticky-steps':\r\n                animation = new ScrollAnimation(element, {\r\n                    type: 'sticky-steps',\r\n                    steps: config.steps || 3\r\n                });\r\n                break;\r\n                \r\n            default:\r\n                Logger.warn('[AnimationSystem] Unknown animation type', config.type);\r\n                return;\r\n        }\r\n        \r\n        this.animations.set(element, animation);\r\n        \r\n        // Set up observer if using IntersectionObserver\r\n        if (this.config.useIntersectionObserver) {\r\n            this.setupObserver(element, animation);\r\n        }\r\n        \r\n        Logger.debug('[AnimationSystem] Animation registered', { element, type: config.type });\r\n    }\r\n    \r\n    /**\r\n     * Set up IntersectionObserver for element\r\n     */\r\n    setupObserver(element, animation) {\r\n        const observer = new IntersectionObserver((entries) => {\r\n            entries.forEach(entry => {\r\n                if (entry.isIntersecting) {\r\n                    animation.enter();\r\n                } else if (!animation.config.once) {\r\n                    animation.exit();\r\n                }\r\n            });\r\n        }, {\r\n            threshold: animation.config.offset || 0.85,\r\n            rootMargin: '0px'\r\n        });\r\n        \r\n        observer.observe(element);\r\n        this.observers.set(element, observer);\r\n    }\r\n    \r\n    /**\r\n     * Update all animations (for scroll-based updates)\r\n     */\r\n    updateAnimations() {\r\n        this.animations.forEach((animation, element) => {\r\n            if (animation.needsUpdate) {\r\n                animation.update();\r\n            }\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Remove animation\r\n     */\r\n    removeAnimation(element) {\r\n        const animation = this.animations.get(element);\r\n        if (animation) {\r\n            animation.destroy();\r\n            this.animations.delete(element);\r\n        }\r\n        \r\n        const observer = this.observers.get(element);\r\n        if (observer) {\r\n            observer.disconnect();\r\n            this.observers.delete(element);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Destroy animation system\r\n     */\r\n    destroy() {\r\n        // Remove all animations\r\n        this.animations.forEach((animation, element) => {\r\n            this.removeAnimation(element);\r\n        });\r\n        \r\n        // Remove scroll handler\r\n        if (this.scrollHandler) {\r\n            window.removeEventListener('scroll', this.scrollHandler);\r\n        }\r\n        \r\n        Logger.info('[AnimationSystem] Destroyed');\r\n    }\r\n}\r\n\r\n","// src/resources/js/scrollfx/ScrollEngine.js\n\nclass ScrollEngine {\n    constructor() {\n        this.triggers = new Set();\n        this.viewportHeight = window.innerHeight;\n        this._loop = this._loop.bind(this);\n\n        window.addEventListener('resize', () => {\n            this.viewportHeight = window.innerHeight;\n        });\n\n        requestAnimationFrame(this._loop);\n    }\n\n    register(trigger) {\n        this.triggers.add(trigger);\n    }\n\n    unregister(trigger) {\n        this.triggers.delete(trigger);\n    }\n\n    clear() {\n        this.triggers.clear();\n    }\n\n    _loop() {\n        this.triggers.forEach(trigger => {\n            trigger.update(this.viewportHeight);\n        });\n        requestAnimationFrame(this._loop);\n    }\n}\n\nexport default new ScrollEngine();\n","// src/resources/js/scrollfx/ScrollTrigger.js\n\nexport default class ScrollTrigger {\n    constructor(config) {\n        this.element = this.resolveElement(config.element);\n        this.target = config.target\n            ? this.element.querySelector(config.target)\n            : this.element;\n\n        if (config.target && !this.target) {\n            throw new Error(`Target selector '${config.target}' not found inside element '${config.element}'.`);\n        }\n\n        this.start = config.start || 'top 80%';\n        this.end = config.end || 'bottom 20%';\n        this.scrub = config.scrub || false;\n        this.onEnter = config.onEnter || null;\n        this.onLeave = config.onLeave || null;\n        this.onUpdate = config.onUpdate || null;\n\n        this._wasVisible = false;\n        this._progress = 0;\n    }\n\n    resolveElement(input) {\n        if (typeof input === 'string') {\n            const els = document.querySelectorAll(input);\n            if (els.length === 1) return els[0];\n            throw new Error(`Selector '${input}' matched ${els.length} elements, expected exactly 1.`);\n        }\n        return input;\n    }\n\n    getScrollProgress(viewportHeight) {\n        const rect = this.element.getBoundingClientRect();\n        const startPx = this.parsePosition(this.start, viewportHeight);\n        const endPx = this.parsePosition(this.end, viewportHeight);\n        const scrollRange = endPx - startPx;\n        const current = rect.top - startPx;\n        return 1 - Math.min(Math.max(current / scrollRange, 0), 1);\n    }\n\n    parsePosition(pos, viewportHeight) {\n        const [edge, value] = pos.split(' ');\n        const edgeOffset = edge === 'top' ? 0 : viewportHeight;\n        const percentage = parseFloat(value) / 100;\n        return edgeOffset - viewportHeight * percentage;\n    }\n\n    update(viewportHeight) {\n        const rect = this.element.getBoundingClientRect();\n        const inViewport = rect.bottom > 0 && rect.top < viewportHeight;\n\n        if (inViewport && !this._wasVisible) {\n            this._wasVisible = true;\n            if (this.onEnter) this.onEnter(this.target);\n        }\n\n        if (!inViewport && this._wasVisible) {\n            this._wasVisible = false;\n            if (this.onLeave) this.onLeave(this.target);\n        }\n\n        if (this.scrub && inViewport) {\n            const progress = this.getScrollProgress(viewportHeight);\n            if (this.onUpdate) this.onUpdate(this.target, progress);\n        }\n    }\n}\n","// src/resources/js/scrollfx/index.js\n\nimport ScrollEngine from './ScrollEngine.js';\nimport ScrollTrigger from './ScrollTrigger.js';\nimport {fadeScrollTrigger, fixedZoomScrollTrigger, zoomScrollTrigger} from \"./Tween\";\n\nexport function createTrigger(config) {\n    const elements = typeof config.element === 'string'\n        ? document.querySelectorAll(config.element)\n        : [config.element];\n\n    const triggers = [];\n\n    elements.forEach(el => {\n        const trigger = new ScrollTrigger({ ...config, element: el });\n        ScrollEngine.register(trigger);\n        triggers.push(trigger);\n    });\n\n    return triggers.length === 1 ? triggers[0] : triggers;\n}\n\nexport function init(config = {}) {\n    const {\n        selector = '.fade-in-on-scroll, .zoom-in, .fade-out, .fade',\n        offset = 0.85,        // z.B. 85 % Viewport-Höhe\n        baseDelay = 0.05,     // delay pro Element (stagger)\n        once = true           // nur 1× triggern?\n    } = config;\n\n    const elements = Array.from(document.querySelectorAll(selector))\n        .map(el => ({ el, triggered: false }));\n\n    function update() {\n        const triggerY = window.innerHeight * offset;\n\n        elements.forEach((obj, index) => {\n            if (obj.triggered && once) return;\n\n            const rect = obj.el.getBoundingClientRect();\n\n            if (rect.top < triggerY) {\n                obj.el.style.transitionDelay = `${index * baseDelay}s`;\n                obj.el.classList.add('visible', 'entered');\n                obj.el.classList.remove('fade-out');\n                obj.triggered = true;\n            } else if (!once) {\n                obj.el.classList.remove('visible', 'entered');\n                obj.triggered = false;\n            }\n        });\n\n        requestAnimationFrame(update);\n    }\n\n    requestAnimationFrame(update);\n}\n","/**\r\n * Animation System Module\r\n * \r\n * Unified animation system consolidating all scroll animation modules.\r\n * \r\n * Replaces:\r\n * - scrollfx\r\n * - parallax\r\n * - scroll-timeline\r\n * - scroll-loop\r\n * - scroll-dependent\r\n * - sticky-fade\r\n * - sticky-steps\r\n * \r\n * Usage:\r\n * - Add data-module=\"animation-system\" to enable animations\r\n * - Or import and use directly: import { AnimationSystem } from './modules/animation-system/index.js'\r\n * \r\n * Features:\r\n * - Fade-in animations\r\n * - Parallax effects\r\n * - Scroll timeline animations\r\n * - Sticky fade animations\r\n * - Sticky steps animations\r\n * - IntersectionObserver support\r\n * - Backward compatibility with old modules\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { AnimationSystem } from './AnimationSystem.js';\r\nimport { ScrollAnimation } from './ScrollAnimation.js';\r\nimport { TimelineAnimation } from './TimelineAnimation.js';\r\n\r\nconst AnimationSystemModule = {\r\n    name: 'animation-system',\r\n    animationSystem: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[AnimationSystemModule] Module initialized');\r\n        \r\n        // Create animation system\r\n        this.animationSystem = AnimationSystem.create(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.AnimationSystem = this.animationSystem;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get animation system instance\r\n     */\r\n    getAnimationSystem() {\r\n        return this.animationSystem || AnimationSystem.create();\r\n    },\r\n    \r\n    /**\r\n     * Register animation\r\n     */\r\n    registerAnimation(element, config) {\r\n        const system = this.getAnimationSystem();\r\n        system.registerAnimation(element, config);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.animationSystem) {\r\n            this.animationSystem.destroy();\r\n            this.animationSystem = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.AnimationSystem) {\r\n            delete window.AnimationSystem;\r\n        }\r\n        \r\n        Logger.info('[AnimationSystemModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { AnimationSystem, ScrollAnimation, TimelineAnimation };\r\n\r\n// Export as default for module system\r\nexport default AnimationSystemModule;\r\n\r\n// Export init function for module system\r\nexport const init = AnimationSystemModule.init.bind(AnimationSystemModule);\r\n\r\n// Backward compatibility exports\r\nexport { createTrigger } from '../scrollfx/index.js';\r\n\r\n","// modules/api-manager/ObserverManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Observer APIs Manager - Intersection, Resize, Mutation, Performance Observers\n */\nexport class ObserverManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.activeObservers = new Map();\n        this.observerInstances = new Map();\n        \n        Logger.info('[ObserverManager] Initialized with support:', {\n            intersection: 'IntersectionObserver' in window,\n            resize: 'ResizeObserver' in window,\n            mutation: 'MutationObserver' in window,\n            performance: 'PerformanceObserver' in window\n        });\n    }\n    \n    /**\n     * Intersection Observer - Viewport intersection detection\n     */\n    intersection(elements, callback, options = {}) {\n        if (!('IntersectionObserver' in window)) {\n            Logger.warn('[ObserverManager] IntersectionObserver not supported');\n            return this.createFallbackObserver('intersection', elements, callback);\n        }\n        \n        const defaultOptions = {\n            root: null,\n            rootMargin: '50px',\n            threshold: [0, 0.1, 0.5, 1.0],\n            ...options\n        };\n        \n        const observerId = this.generateId('intersection');\n        const observer = new IntersectionObserver((entries, obs) => {\n            const processedEntries = entries.map(entry => ({\n                element: entry.target,\n                isIntersecting: entry.isIntersecting,\n                intersectionRatio: entry.intersectionRatio,\n                boundingClientRect: entry.boundingClientRect,\n                rootBounds: entry.rootBounds,\n                intersectionRect: entry.intersectionRect,\n                time: entry.time,\n                // Enhanced data\n                visibility: this.calculateVisibility(entry),\n                direction: this.getScrollDirection(entry),\n                position: this.getElementPosition(entry)\n            }));\n            \n            callback(processedEntries, obs);\n        }, defaultOptions);\n        \n        // Observe elements\n        const elementList = Array.isArray(elements) ? elements : [elements];\n        elementList.forEach(el => {\n            if (el instanceof Element) observer.observe(el);\n        });\n        \n        this.observerInstances.set(observerId, observer);\n        this.activeObservers.set(observerId, {\n            type: 'intersection',\n            elements: elementList,\n            callback,\n            options: defaultOptions\n        });\n        \n        Logger.info(`[ObserverManager] IntersectionObserver created: ${observerId}`);\n        \n        return {\n            id: observerId,\n            observer,\n            unobserve: (element) => observer.unobserve(element),\n            disconnect: () => this.disconnect(observerId),\n            updateThreshold: (threshold) => this.updateIntersectionThreshold(observerId, threshold)\n        };\n    }\n    \n    /**\n     * Resize Observer - Element resize detection\n     */\n    resize(elements, callback, options = {}) {\n        if (!('ResizeObserver' in window)) {\n            Logger.warn('[ObserverManager] ResizeObserver not supported');\n            return this.createFallbackObserver('resize', elements, callback);\n        }\n        \n        const observerId = this.generateId('resize');\n        const observer = new ResizeObserver((entries) => {\n            const processedEntries = entries.map(entry => ({\n                element: entry.target,\n                contentRect: entry.contentRect,\n                borderBoxSize: entry.borderBoxSize,\n                contentBoxSize: entry.contentBoxSize,\n                devicePixelContentBoxSize: entry.devicePixelContentBoxSize,\n                // Enhanced data\n                dimensions: {\n                    width: entry.contentRect.width,\n                    height: entry.contentRect.height,\n                    aspectRatio: entry.contentRect.width / entry.contentRect.height\n                },\n                deltaSize: this.calculateDeltaSize(entry),\n                breakpoint: this.detectBreakpoint(entry.contentRect.width)\n            }));\n            \n            callback(processedEntries);\n        });\n        \n        const elementList = Array.isArray(elements) ? elements : [elements];\n        elementList.forEach(el => {\n            if (el instanceof Element) observer.observe(el);\n        });\n        \n        this.observerInstances.set(observerId, observer);\n        this.activeObservers.set(observerId, {\n            type: 'resize',\n            elements: elementList,\n            callback,\n            options\n        });\n        \n        Logger.info(`[ObserverManager] ResizeObserver created: ${observerId}`);\n        \n        return {\n            id: observerId,\n            observer,\n            unobserve: (element) => observer.unobserve(element),\n            disconnect: () => this.disconnect(observerId)\n        };\n    }\n    \n    /**\n     * Mutation Observer - DOM change detection\n     */\n    mutation(target, callback, options = {}) {\n        if (!('MutationObserver' in window)) {\n            Logger.warn('[ObserverManager] MutationObserver not supported');\n            return null;\n        }\n        \n        const defaultOptions = {\n            childList: true,\n            attributes: true,\n            subtree: true,\n            attributeOldValue: true,\n            characterDataOldValue: true,\n            ...options\n        };\n        \n        const observerId = this.generateId('mutation');\n        const observer = new MutationObserver((mutations) => {\n            const processedMutations = mutations.map(mutation => ({\n                type: mutation.type,\n                target: mutation.target,\n                addedNodes: Array.from(mutation.addedNodes),\n                removedNodes: Array.from(mutation.removedNodes),\n                attributeName: mutation.attributeName,\n                attributeNamespace: mutation.attributeNamespace,\n                oldValue: mutation.oldValue,\n                // Enhanced data\n                summary: this.summarizeMutation(mutation),\n                impact: this.assessMutationImpact(mutation)\n            }));\n            \n            callback(processedMutations);\n        });\n        \n        observer.observe(target, defaultOptions);\n        \n        this.observerInstances.set(observerId, observer);\n        this.activeObservers.set(observerId, {\n            type: 'mutation',\n            target,\n            callback,\n            options: defaultOptions\n        });\n        \n        Logger.info(`[ObserverManager] MutationObserver created: ${observerId}`);\n        \n        return {\n            id: observerId,\n            observer,\n            disconnect: () => this.disconnect(observerId),\n            takeRecords: () => observer.takeRecords()\n        };\n    }\n    \n    /**\n     * Performance Observer - Performance metrics monitoring\n     */\n    performance(callback, options = {}) {\n        if (!('PerformanceObserver' in window)) {\n            Logger.warn('[ObserverManager] PerformanceObserver not supported');\n            return null;\n        }\n        \n        const defaultOptions = {\n            entryTypes: ['measure', 'navigation', 'paint', 'largest-contentful-paint'],\n            buffered: true,\n            ...options\n        };\n        \n        const observerId = this.generateId('performance');\n        const observer = new PerformanceObserver((list) => {\n            const entries = list.getEntries().map(entry => ({\n                name: entry.name,\n                entryType: entry.entryType,\n                startTime: entry.startTime,\n                duration: entry.duration,\n                // Enhanced data based on entry type\n                details: this.enhancePerformanceEntry(entry),\n                timestamp: Date.now()\n            }));\n            \n            callback(entries);\n        });\n        \n        observer.observe(defaultOptions);\n        \n        this.observerInstances.set(observerId, observer);\n        this.activeObservers.set(observerId, {\n            type: 'performance',\n            callback,\n            options: defaultOptions\n        });\n        \n        Logger.info(`[ObserverManager] PerformanceObserver created: ${observerId}`);\n        \n        return {\n            id: observerId,\n            observer,\n            disconnect: () => this.disconnect(observerId),\n            takeRecords: () => observer.takeRecords()\n        };\n    }\n    \n    /**\n     * Lazy Loading Helper - Uses IntersectionObserver\n     */\n    lazyLoad(selector = 'img[data-src], iframe[data-src]', options = {}) {\n        const elements = document.querySelectorAll(selector);\n        \n        return this.intersection(elements, (entries) => {\n            entries.forEach(entry => {\n                if (entry.isIntersecting) {\n                    const element = entry.element;\n                    \n                    // Load image or iframe\n                    if (element.dataset.src) {\n                        element.src = element.dataset.src;\n                        delete element.dataset.src;\n                    }\n                    \n                    // Load srcset if available\n                    if (element.dataset.srcset) {\n                        element.srcset = element.dataset.srcset;\n                        delete element.dataset.srcset;\n                    }\n                    \n                    // Add loaded class\n                    element.classList.add('loaded');\n                    \n                    // Stop observing this element\n                    entry.observer.unobserve(element);\n                    \n                    Logger.info('[ObserverManager] Lazy loaded:', element.src);\n                }\n            });\n        }, {\n            rootMargin: '100px',\n            ...options\n        });\n    }\n    \n    /**\n     * Scroll Trigger Helper - Uses IntersectionObserver\n     */\n    scrollTrigger(elements, callback, options = {}) {\n        return this.intersection(elements, (entries) => {\n            entries.forEach(entry => {\n                const triggerData = {\n                    element: entry.element,\n                    progress: entry.intersectionRatio,\n                    isVisible: entry.isIntersecting,\n                    direction: entry.direction,\n                    position: entry.position\n                };\n                \n                callback(triggerData);\n            });\n        }, {\n            threshold: this.createThresholdArray(options.steps || 10),\n            ...options\n        });\n    }\n    \n    /**\n     * Viewport Detection Helper\n     */\n    viewport(callback, options = {}) {\n        const viewportElement = document.createElement('div');\n        viewportElement.style.cssText = `\n            position: fixed;\n            top: 0;\n            left: 0;\n            width: 100%;\n            height: 100%;\n            pointer-events: none;\n            visibility: hidden;\n        `;\n        document.body.appendChild(viewportElement);\n        \n        return this.resize([viewportElement], (entries) => {\n            const viewport = entries[0];\n            callback({\n                width: viewport.dimensions.width,\n                height: viewport.dimensions.height,\n                aspectRatio: viewport.dimensions.aspectRatio,\n                orientation: viewport.dimensions.width > viewport.dimensions.height ? 'landscape' : 'portrait',\n                breakpoint: viewport.breakpoint\n            });\n        }, options);\n    }\n    \n    // Helper Methods\n    \n    generateId(type) {\n        return `${type}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    disconnect(observerId) {\n        const observer = this.observerInstances.get(observerId);\n        if (observer) {\n            observer.disconnect();\n            this.observerInstances.delete(observerId);\n            this.activeObservers.delete(observerId);\n            Logger.info(`[ObserverManager] Observer disconnected: ${observerId}`);\n        }\n    }\n    \n    disconnectAll() {\n        this.observerInstances.forEach((observer, id) => {\n            observer.disconnect();\n        });\n        this.observerInstances.clear();\n        this.activeObservers.clear();\n        Logger.info('[ObserverManager] All observers disconnected');\n    }\n    \n    calculateVisibility(entry) {\n        if (!entry.isIntersecting) return 0;\n        \n        const visibleArea = entry.intersectionRect.width * entry.intersectionRect.height;\n        const totalArea = entry.boundingClientRect.width * entry.boundingClientRect.height;\n        \n        return totalArea > 0 ? Math.round((visibleArea / totalArea) * 100) : 0;\n    }\n    \n    getScrollDirection(entry) {\n        // This would need to store previous positions to determine direction\n        // For now, return based on intersection ratio change\n        return entry.intersectionRatio > 0.5 ? 'down' : 'up';\n    }\n    \n    getElementPosition(entry) {\n        const rect = entry.boundingClientRect;\n        const viewportHeight = window.innerHeight;\n        \n        if (rect.top < 0 && rect.bottom > 0) return 'entering-top';\n        if (rect.top < viewportHeight && rect.bottom > viewportHeight) return 'entering-bottom';\n        if (rect.top >= 0 && rect.bottom <= viewportHeight) return 'visible';\n        return 'hidden';\n    }\n    \n    calculateDeltaSize(entry) {\n        // Would need to store previous sizes to calculate delta\n        return { width: 0, height: 0 };\n    }\n    \n    detectBreakpoint(width) {\n        if (width < 576) return 'xs';\n        if (width < 768) return 'sm';\n        if (width < 992) return 'md';\n        if (width < 1200) return 'lg';\n        return 'xl';\n    }\n    \n    summarizeMutation(mutation) {\n        return `${mutation.type} on ${mutation.target.tagName}`;\n    }\n    \n    assessMutationImpact(mutation) {\n        // Simple impact assessment\n        if (mutation.type === 'childList') {\n            return mutation.addedNodes.length + mutation.removedNodes.length > 5 ? 'high' : 'low';\n        }\n        return 'medium';\n    }\n    \n    enhancePerformanceEntry(entry) {\n        const details = { raw: entry };\n        \n        switch (entry.entryType) {\n            case 'navigation':\n                details.loadTime = entry.loadEventEnd - entry.navigationStart;\n                details.domContentLoaded = entry.domContentLoadedEventEnd - entry.navigationStart;\n                break;\n            case 'paint':\n                details.paintType = entry.name;\n                break;\n            case 'largest-contentful-paint':\n                details.element = entry.element;\n                details.url = entry.url;\n                break;\n        }\n        \n        return details;\n    }\n    \n    createThresholdArray(steps) {\n        const thresholds = [];\n        for (let i = 0; i <= steps; i++) {\n            thresholds.push(i / steps);\n        }\n        return thresholds;\n    }\n    \n    createFallbackObserver(type, elements, callback) {\n        Logger.warn(`[ObserverManager] Creating fallback for ${type}Observer`);\n        \n        // Simple polling fallback\n        const fallbackId = this.generateId(`fallback_${type}`);\n        let intervalId;\n        \n        switch (type) {\n            case 'intersection':\n                intervalId = setInterval(() => {\n                    const elementList = Array.isArray(elements) ? elements : [elements];\n                    const entries = elementList.map(el => ({\n                        element: el,\n                        isIntersecting: this.isElementInViewport(el),\n                        intersectionRatio: this.calculateIntersectionRatio(el)\n                    }));\n                    callback(entries);\n                }, 100);\n                break;\n        }\n        \n        return {\n            id: fallbackId,\n            disconnect: () => {\n                if (intervalId) clearInterval(intervalId);\n            }\n        };\n    }\n    \n    isElementInViewport(el) {\n        const rect = el.getBoundingClientRect();\n        return (\n            rect.top >= 0 &&\n            rect.left >= 0 &&\n            rect.bottom <= window.innerHeight &&\n            rect.right <= window.innerWidth\n        );\n    }\n    \n    calculateIntersectionRatio(el) {\n        const rect = el.getBoundingClientRect();\n        const viewportHeight = window.innerHeight;\n        const viewportWidth = window.innerWidth;\n        \n        const visibleHeight = Math.min(rect.bottom, viewportHeight) - Math.max(rect.top, 0);\n        const visibleWidth = Math.min(rect.right, viewportWidth) - Math.max(rect.left, 0);\n        \n        if (visibleHeight <= 0 || visibleWidth <= 0) return 0;\n        \n        const visibleArea = visibleHeight * visibleWidth;\n        const totalArea = rect.height * rect.width;\n        \n        return totalArea > 0 ? visibleArea / totalArea : 0;\n    }\n    \n    getActiveObservers() {\n        return Array.from(this.activeObservers.entries()).map(([id, data]) => ({\n            id,\n            ...data\n        }));\n    }\n}","// modules/api-manager/MediaManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Media APIs Manager - Camera, Microphone, WebRTC, Audio, Recording\n */\nexport class MediaManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.activeStreams = new Map();\n        this.activeConnections = new Map();\n        this.audioContext = null;\n        \n        // Check API support\n        this.support = {\n            mediaDevices: navigator.mediaDevices !== undefined,\n            webRTC: 'RTCPeerConnection' in window,\n            webAudio: 'AudioContext' in window || 'webkitAudioContext' in window,\n            mediaRecorder: 'MediaRecorder' in window,\n            screenShare: navigator.mediaDevices?.getDisplayMedia !== undefined\n        };\n        \n        Logger.info('[MediaManager] Initialized with support:', this.support);\n    }\n    \n    /**\n     * Get user camera stream\n     */\n    async getUserCamera(constraints = {}) {\n        if (!this.support.mediaDevices) {\n            throw new Error('MediaDevices API not supported');\n        }\n        \n        const defaultConstraints = {\n            video: {\n                width: { ideal: 1280 },\n                height: { ideal: 720 },\n                facingMode: 'user'\n            },\n            audio: false,\n            ...constraints\n        };\n        \n        try {\n            const stream = await navigator.mediaDevices.getUserMedia(defaultConstraints);\n            const streamId = this.generateId('camera');\n            \n            this.activeStreams.set(streamId, {\n                stream,\n                type: 'camera',\n                constraints: defaultConstraints,\n                tracks: stream.getTracks()\n            });\n            \n            Logger.info(`[MediaManager] Camera stream acquired: ${streamId}`);\n            \n            return {\n                id: streamId,\n                stream,\n                video: stream.getVideoTracks()[0],\n                audio: stream.getAudioTracks()[0],\n                stop: () => this.stopStream(streamId),\n                switchCamera: () => this.switchCamera(streamId),\n                takePhoto: (canvas) => this.takePhoto(stream, canvas),\n                applyFilter: (filter) => this.applyVideoFilter(streamId, filter)\n            };\n        } catch (error) {\n            Logger.warn('[MediaManager] Camera access failed:', error.message);\n            throw error;\n        }\n    }\n    \n    /**\n     * Get user microphone stream\n     */\n    async getUserMicrophone(constraints = {}) {\n        if (!this.support.mediaDevices) {\n            throw new Error('MediaDevices API not supported');\n        }\n        \n        const defaultConstraints = {\n            audio: {\n                echoCancellation: true,\n                noiseSuppression: true,\n                autoGainControl: true,\n                ...constraints.audio\n            },\n            video: false,\n            ...constraints\n        };\n        \n        try {\n            const stream = await navigator.mediaDevices.getUserMedia(defaultConstraints);\n            const streamId = this.generateId('microphone');\n            \n            this.activeStreams.set(streamId, {\n                stream,\n                type: 'microphone',\n                constraints: defaultConstraints,\n                tracks: stream.getTracks()\n            });\n            \n            Logger.info(`[MediaManager] Microphone stream acquired: ${streamId}`);\n            \n            return {\n                id: streamId,\n                stream,\n                audio: stream.getAudioTracks()[0],\n                stop: () => this.stopStream(streamId),\n                getVolume: () => this.getAudioLevel(stream),\n                startRecording: (options) => this.startRecording(stream, options)\n            };\n        } catch (error) {\n            Logger.warn('[MediaManager] Microphone access failed:', error.message);\n            throw error;\n        }\n    }\n    \n    /**\n     * Get screen share stream\n     */\n    async getScreenShare(constraints = {}) {\n        if (!this.support.screenShare) {\n            throw new Error('Screen sharing not supported');\n        }\n        \n        const defaultConstraints = {\n            video: {\n                cursor: 'always'\n            },\n            audio: false,\n            ...constraints\n        };\n        \n        try {\n            const stream = await navigator.mediaDevices.getDisplayMedia(defaultConstraints);\n            const streamId = this.generateId('screen');\n            \n            this.activeStreams.set(streamId, {\n                stream,\n                type: 'screen',\n                constraints: defaultConstraints,\n                tracks: stream.getTracks()\n            });\n            \n            // Auto-cleanup when user stops sharing\n            stream.getTracks().forEach(track => {\n                track.addEventListener('ended', () => {\n                    this.stopStream(streamId);\n                });\n            });\n            \n            Logger.info(`[MediaManager] Screen share acquired: ${streamId}`);\n            \n            return {\n                id: streamId,\n                stream,\n                video: stream.getVideoTracks()[0],\n                audio: stream.getAudioTracks()[0],\n                stop: () => this.stopStream(streamId)\n            };\n        } catch (error) {\n            Logger.warn('[MediaManager] Screen share failed:', error.message);\n            throw error;\n        }\n    }\n    \n    /**\n     * Start recording media stream\n     */\n    async startRecording(stream, options = {}) {\n        if (!this.support.mediaRecorder) {\n            throw new Error('MediaRecorder API not supported');\n        }\n        \n        const defaultOptions = {\n            mimeType: 'video/webm;codecs=vp9',\n            videoBitsPerSecond: 2000000,\n            audioBitsPerSecond: 128000,\n            ...options\n        };\n        \n        // Find supported MIME type\n        const mimeType = this.getSupportedMimeType([\n            'video/webm;codecs=vp9',\n            'video/webm;codecs=vp8',\n            'video/webm',\n            'video/mp4'\n        ]) || defaultOptions.mimeType;\n        \n        const recorder = new MediaRecorder(stream, {\n            ...defaultOptions,\n            mimeType\n        });\n        \n        const recordingId = this.generateId('recording');\n        const chunks = [];\n        \n        recorder.ondataavailable = (event) => {\n            if (event.data.size > 0) {\n                chunks.push(event.data);\n            }\n        };\n        \n        recorder.onstop = () => {\n            const blob = new Blob(chunks, { type: mimeType });\n            this.onRecordingComplete(recordingId, blob);\n        };\n        \n        recorder.start();\n        \n        Logger.info(`[MediaManager] Recording started: ${recordingId}`);\n        \n        return {\n            id: recordingId,\n            recorder,\n            stop: () => {\n                recorder.stop();\n                return new Promise(resolve => {\n                    recorder.onstop = () => {\n                        const blob = new Blob(chunks, { type: mimeType });\n                        resolve({\n                            blob,\n                            url: URL.createObjectURL(blob),\n                            size: blob.size,\n                            type: blob.type,\n                            download: (filename = `recording-${Date.now()}.webm`) => {\n                                this.downloadBlob(blob, filename);\n                            }\n                        });\n                    };\n                });\n            },\n            pause: () => recorder.pause(),\n            resume: () => recorder.resume(),\n            get state() { return recorder.state; }\n        };\n    }\n    \n    /**\n     * Take photo from video stream\n     */\n    takePhoto(stream, canvas) {\n        const video = document.createElement('video');\n        video.srcObject = stream;\n        video.autoplay = true;\n        video.muted = true;\n        \n        return new Promise((resolve) => {\n            video.onloadedmetadata = () => {\n                if (!canvas) {\n                    canvas = document.createElement('canvas');\n                }\n                \n                canvas.width = video.videoWidth;\n                canvas.height = video.videoHeight;\n                \n                const ctx = canvas.getContext('2d');\n                ctx.drawImage(video, 0, 0);\n                \n                canvas.toBlob((blob) => {\n                    resolve({\n                        canvas,\n                        blob,\n                        url: URL.createObjectURL(blob),\n                        dataURL: canvas.toDataURL('image/jpeg', 0.9),\n                        download: (filename = `photo-${Date.now()}.jpg`) => {\n                            this.downloadBlob(blob, filename);\n                        }\n                    });\n                }, 'image/jpeg', 0.9);\n                \n                video.remove();\n            };\n        });\n    }\n    \n    /**\n     * Web Audio Context setup\n     */\n    getAudioContext() {\n        if (!this.audioContext) {\n            if (this.support.webAudio) {\n                this.audioContext = new (window.AudioContext || window.webkitAudioContext)();\n                Logger.info('[MediaManager] Audio context created');\n            } else {\n                Logger.warn('[MediaManager] Web Audio API not supported');\n                return null;\n            }\n        }\n        \n        return this.audioContext;\n    }\n    \n    /**\n     * Create audio analyzer for visualizations\n     */\n    createAudioAnalyzer(stream, options = {}) {\n        const audioContext = this.getAudioContext();\n        if (!audioContext) return null;\n        \n        const source = audioContext.createMediaStreamSource(stream);\n        const analyzer = audioContext.createAnalyser();\n        \n        analyzer.fftSize = options.fftSize || 256;\n        analyzer.smoothingTimeConstant = options.smoothing || 0.8;\n        \n        source.connect(analyzer);\n        \n        const bufferLength = analyzer.frequencyBinCount;\n        const dataArray = new Uint8Array(bufferLength);\n        \n        return {\n            analyzer,\n            bufferLength,\n            dataArray,\n            getFrequencyData: () => {\n                analyzer.getByteFrequencyData(dataArray);\n                return Array.from(dataArray);\n            },\n            getTimeDomainData: () => {\n                analyzer.getByteTimeDomainData(dataArray);\n                return Array.from(dataArray);\n            },\n            getAverageVolume: () => {\n                analyzer.getByteFrequencyData(dataArray);\n                return dataArray.reduce((sum, value) => sum + value, 0) / bufferLength;\n            }\n        };\n    }\n    \n    /**\n     * Simple WebRTC peer connection setup\n     */\n    async createPeerConnection(config = {}) {\n        if (!this.support.webRTC) {\n            throw new Error('WebRTC not supported');\n        }\n        \n        const defaultConfig = {\n            iceServers: [\n                { urls: 'stun:stun.l.google.com:19302' },\n                { urls: 'stun:stun1.l.google.com:19302' }\n            ],\n            ...config\n        };\n        \n        const pc = new RTCPeerConnection(defaultConfig);\n        const connectionId = this.generateId('rtc');\n        \n        this.activeConnections.set(connectionId, pc);\n        \n        // Enhanced peer connection with event handling\n        const enhancedPC = {\n            id: connectionId,\n            connection: pc,\n            \n            // Event handlers\n            onTrack: (callback) => pc.addEventListener('track', callback),\n            onIceCandidate: (callback) => pc.addEventListener('icecandidate', callback),\n            onConnectionStateChange: (callback) => pc.addEventListener('connectionstatechange', callback),\n            \n            // Methods\n            addStream: (stream) => {\n                stream.getTracks().forEach(track => {\n                    pc.addTrack(track, stream);\n                });\n            },\n            \n            createOffer: () => pc.createOffer(),\n            createAnswer: () => pc.createAnswer(),\n            setLocalDescription: (desc) => pc.setLocalDescription(desc),\n            setRemoteDescription: (desc) => pc.setRemoteDescription(desc),\n            addIceCandidate: (candidate) => pc.addIceCandidate(candidate),\n            \n            close: () => {\n                pc.close();\n                this.activeConnections.delete(connectionId);\n            },\n            \n            get connectionState() { return pc.connectionState; },\n            get iceConnectionState() { return pc.iceConnectionState; }\n        };\n        \n        Logger.info(`[MediaManager] Peer connection created: ${connectionId}`);\n        return enhancedPC;\n    }\n    \n    /**\n     * Get available media devices\n     */\n    async getDevices() {\n        if (!this.support.mediaDevices) {\n            return { cameras: [], microphones: [], speakers: [] };\n        }\n        \n        try {\n            const devices = await navigator.mediaDevices.enumerateDevices();\n            \n            return {\n                cameras: devices.filter(d => d.kind === 'videoinput'),\n                microphones: devices.filter(d => d.kind === 'audioinput'),\n                speakers: devices.filter(d => d.kind === 'audiooutput'),\n                all: devices\n            };\n        } catch (error) {\n            Logger.warn('[MediaManager] Device enumeration failed:', error);\n            return { cameras: [], microphones: [], speakers: [] };\n        }\n    }\n    \n    /**\n     * Check device permissions\n     */\n    async checkPermissions() {\n        const permissions = {};\n        \n        try {\n            if (navigator.permissions) {\n                const camera = await navigator.permissions.query({ name: 'camera' });\n                const microphone = await navigator.permissions.query({ name: 'microphone' });\n                \n                permissions.camera = camera.state;\n                permissions.microphone = microphone.state;\n            }\n        } catch (error) {\n            Logger.warn('[MediaManager] Permission check failed:', error);\n        }\n        \n        return permissions;\n    }\n    \n    // Helper methods\n    \n    stopStream(streamId) {\n        const streamData = this.activeStreams.get(streamId);\n        if (streamData) {\n            streamData.tracks.forEach(track => track.stop());\n            this.activeStreams.delete(streamId);\n            Logger.info(`[MediaManager] Stream stopped: ${streamId}`);\n        }\n    }\n    \n    stopAllStreams() {\n        this.activeStreams.forEach((streamData, id) => {\n            streamData.tracks.forEach(track => track.stop());\n        });\n        this.activeStreams.clear();\n        Logger.info('[MediaManager] All streams stopped');\n    }\n    \n    async switchCamera(streamId) {\n        const streamData = this.activeStreams.get(streamId);\n        if (!streamData || streamData.type !== 'camera') return null;\n        \n        const currentFacing = streamData.constraints.video.facingMode;\n        const newFacing = currentFacing === 'user' ? 'environment' : 'user';\n        \n        // Stop current stream\n        this.stopStream(streamId);\n        \n        // Get new stream with switched camera\n        return this.getUserCamera({\n            video: {\n                ...streamData.constraints.video,\n                facingMode: newFacing\n            }\n        });\n    }\n    \n    getAudioLevel(stream) {\n        const audioContext = this.getAudioContext();\n        if (!audioContext) return 0;\n        \n        const source = audioContext.createMediaStreamSource(stream);\n        const analyzer = audioContext.createAnalyser();\n        source.connect(analyzer);\n        \n        const dataArray = new Uint8Array(analyzer.frequencyBinCount);\n        analyzer.getByteFrequencyData(dataArray);\n        \n        return dataArray.reduce((sum, value) => sum + value, 0) / dataArray.length;\n    }\n    \n    getSupportedMimeType(types) {\n        return types.find(type => MediaRecorder.isTypeSupported(type));\n    }\n    \n    downloadBlob(blob, filename) {\n        const url = URL.createObjectURL(blob);\n        const a = document.createElement('a');\n        a.href = url;\n        a.download = filename;\n        document.body.appendChild(a);\n        a.click();\n        document.body.removeChild(a);\n        URL.revokeObjectURL(url);\n    }\n    \n    generateId(prefix = 'media') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    onRecordingComplete(id, blob) {\n        Logger.info(`[MediaManager] Recording completed: ${id}, size: ${blob.size} bytes`);\n        // Custom completion handling can be added here\n    }\n    \n    /**\n     * Apply video filters using CSS filters\n     */\n    applyVideoFilter(streamId, filterName) {\n        const streamData = this.activeStreams.get(streamId);\n        if (!streamData || streamData.type !== 'camera') return;\n        \n        const filters = {\n            none: 'none',\n            blur: 'blur(2px)',\n            brightness: 'brightness(1.2)',\n            contrast: 'contrast(1.3)',\n            grayscale: 'grayscale(1)',\n            sepia: 'sepia(1)',\n            invert: 'invert(1)',\n            vintage: 'sepia(0.8) contrast(1.4) brightness(1.1)',\n            cool: 'hue-rotate(180deg) saturate(1.5)',\n            warm: 'hue-rotate(25deg) saturate(1.2)'\n        };\n        \n        return {\n            filter: filters[filterName] || filterName,\n            apply: (videoElement) => {\n                videoElement.style.filter = filters[filterName] || filterName;\n            }\n        };\n    }\n    \n    /**\n     * Get current status of all media operations\n     */\n    getStatus() {\n        return {\n            activeStreams: this.activeStreams.size,\n            activeConnections: this.activeConnections.size,\n            audioContextState: this.audioContext?.state || 'none',\n            support: this.support,\n            streams: Array.from(this.activeStreams.entries()).map(([id, data]) => ({\n                id,\n                type: data.type,\n                tracks: data.tracks.length,\n                active: data.tracks.some(track => track.readyState === 'live')\n            }))\n        };\n    }\n}","// modules/api-manager/StorageManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Storage APIs Manager - IndexedDB, Cache API, Web Locks, Broadcast Channel\n */\nexport class StorageManager {\n    constructor(config = {}) {\n        this.config = {\n            dbName: config.dbName || 'AppDatabase',\n            dbVersion: config.dbVersion || 1,\n            enableAnalytics: config.enableAnalytics ?? true,\n            enableQuotaMonitoring: config.enableQuotaMonitoring ?? true,\n            quotaWarningThreshold: config.quotaWarningThreshold || 0.8, // 80%\n            ...config\n        };\n        \n        this.db = null;\n        this.cache = null;\n        this.channels = new Map();\n        \n        // Analytics\n        this.analytics = {\n            operations: {\n                get: 0,\n                set: 0,\n                delete: 0,\n                clear: 0\n            },\n            errors: 0,\n            quotaWarnings: 0\n        };\n        \n        // Check API support\n        this.support = {\n            indexedDB: 'indexedDB' in window,\n            cacheAPI: 'caches' in window,\n            webLocks: 'locks' in navigator,\n            broadcastChannel: 'BroadcastChannel' in window,\n            localStorage: 'localStorage' in window,\n            sessionStorage: 'sessionStorage' in window,\n            storageEstimate: 'storage' in navigator && 'estimate' in navigator.storage\n        };\n        \n        Logger.info('[StorageManager] Initialized with support:', this.support);\n        \n        // Initialize databases\n        this.initializeDB();\n        this.initializeCache();\n        \n        // Start quota monitoring if enabled\n        if (this.config.enableQuotaMonitoring) {\n            this.startQuotaMonitoring();\n        }\n    }\n    \n    /**\n     * Initialize IndexedDB\n     */\n    async initializeDB() {\n        if (!this.support.indexedDB) {\n            Logger.warn('[StorageManager] IndexedDB not supported');\n            return;\n        }\n        \n        try {\n            const request = indexedDB.open(this.dbName, this.dbVersion);\n            \n            request.onerror = () => {\n                Logger.error('[StorageManager] IndexedDB failed to open');\n            };\n            \n            request.onupgradeneeded = (event) => {\n                const db = event.target.result;\n                \n                // Create default object stores\n                if (!db.objectStoreNames.contains('keyValue')) {\n                    const store = db.createObjectStore('keyValue', { keyPath: 'key' });\n                    store.createIndex('timestamp', 'timestamp', { unique: false });\n                }\n                \n                if (!db.objectStoreNames.contains('cache')) {\n                    db.createObjectStore('cache', { keyPath: 'key' });\n                }\n                \n                if (!db.objectStoreNames.contains('files')) {\n                    const fileStore = db.createObjectStore('files', { keyPath: 'id', autoIncrement: true });\n                    fileStore.createIndex('name', 'name', { unique: false });\n                    fileStore.createIndex('type', 'type', { unique: false });\n                }\n                \n                Logger.info('[StorageManager] IndexedDB schema updated');\n            };\n            \n            request.onsuccess = (event) => {\n                this.db = event.target.result;\n                Logger.info('[StorageManager] IndexedDB connected');\n            };\n            \n        } catch (error) {\n            Logger.error('[StorageManager] IndexedDB initialization failed:', error);\n        }\n    }\n    \n    /**\n     * Initialize Cache API\n     */\n    async initializeCache() {\n        if (!this.support.cacheAPI) {\n            Logger.warn('[StorageManager] Cache API not supported');\n            return;\n        }\n        \n        try {\n            this.cache = await caches.open(this.config.cacheName || 'app-cache-v1');\n            Logger.info('[StorageManager] Cache API initialized');\n        } catch (error) {\n            Logger.error('[StorageManager] Cache API initialization failed:', error);\n        }\n    }\n    \n    /**\n     * IndexedDB Operations\n     */\n    db = {\n        // Set key-value data\n        set: async (key, value, expiration = null) => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['keyValue'], 'readwrite');\n                const store = transaction.objectStore('keyValue');\n                \n                const data = {\n                    key,\n                    value,\n                    timestamp: Date.now(),\n                    expiration: expiration ? Date.now() + expiration : null\n                };\n                \n                const request = store.put(data);\n                \n                request.onsuccess = () => {\n                    Logger.info(`[StorageManager] DB set: ${key}`);\n                    resolve(data);\n                };\n                \n                request.onerror = () => {\n                    Logger.error(`[StorageManager] DB set failed: ${key}`);\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Get key-value data\n        get: async (key) => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['keyValue'], 'readonly');\n                const store = transaction.objectStore('keyValue');\n                const request = store.get(key);\n                \n                request.onsuccess = () => {\n                    const result = request.result;\n                    \n                    if (!result) {\n                        resolve(null);\n                        return;\n                    }\n                    \n                    // Check expiration\n                    if (result.expiration && Date.now() > result.expiration) {\n                        this.db.delete(key); // Auto-cleanup expired data\n                        resolve(null);\n                        return;\n                    }\n                    \n                    resolve(result.value);\n                };\n                \n                request.onerror = () => {\n                    Logger.error(`[StorageManager] DB get failed: ${key}`);\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Delete key\n        delete: async (key) => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['keyValue'], 'readwrite');\n                const store = transaction.objectStore('keyValue');\n                const request = store.delete(key);\n                \n                request.onsuccess = () => {\n                    Logger.info(`[StorageManager] DB deleted: ${key}`);\n                    resolve(true);\n                };\n                \n                request.onerror = () => {\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Get all keys\n        keys: async () => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['keyValue'], 'readonly');\n                const store = transaction.objectStore('keyValue');\n                const request = store.getAllKeys();\n                \n                request.onsuccess = () => {\n                    resolve(request.result);\n                };\n                \n                request.onerror = () => {\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Clear all data\n        clear: async () => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['keyValue'], 'readwrite');\n                const store = transaction.objectStore('keyValue');\n                const request = store.clear();\n                \n                request.onsuccess = () => {\n                    Logger.info('[StorageManager] DB cleared');\n                    resolve(true);\n                };\n                \n                request.onerror = () => {\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Store files/blobs\n        storeFile: async (name, file, metadata = {}) => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['files'], 'readwrite');\n                const store = transaction.objectStore('files');\n                \n                const fileData = {\n                    name,\n                    file,\n                    type: file.type,\n                    size: file.size,\n                    timestamp: Date.now(),\n                    metadata\n                };\n                \n                const request = store.add(fileData);\n                \n                request.onsuccess = () => {\n                    Logger.info(`[StorageManager] File stored: ${name}`);\n                    resolve({ id: request.result, ...fileData });\n                };\n                \n                request.onerror = () => {\n                    reject(request.error);\n                };\n            });\n        },\n        \n        // Get file\n        getFile: async (id) => {\n            return new Promise((resolve, reject) => {\n                if (!this.db) {\n                    reject(new Error('IndexedDB not available'));\n                    return;\n                }\n                \n                const transaction = this.db.transaction(['files'], 'readonly');\n                const store = transaction.objectStore('files');\n                const request = store.get(id);\n                \n                request.onsuccess = () => {\n                    resolve(request.result);\n                };\n                \n                request.onerror = () => {\n                    reject(request.error);\n                };\n            });\n        }\n    };\n    \n    /**\n     * Cache API Operations\n     */\n    cache = {\n        // Add request/response to cache\n        add: async (request, response = null) => {\n            if (!this.cache) {\n                throw new Error('Cache API not available');\n            }\n            \n            try {\n                if (response) {\n                    await this.cache.put(request, response);\n                } else {\n                    await this.cache.add(request);\n                }\n                Logger.info(`[StorageManager] Cache add: ${request}`);\n            } catch (error) {\n                Logger.error('[StorageManager] Cache add failed:', error);\n                throw error;\n            }\n        },\n        \n        // Get from cache\n        get: async (request) => {\n            if (!this.cache) {\n                throw new Error('Cache API not available');\n            }\n            \n            try {\n                const response = await this.cache.match(request);\n                if (response) {\n                    Logger.info(`[StorageManager] Cache hit: ${request}`);\n                } else {\n                    Logger.info(`[StorageManager] Cache miss: ${request}`);\n                }\n                return response;\n            } catch (error) {\n                Logger.error('[StorageManager] Cache get failed:', error);\n                throw error;\n            }\n        },\n        \n        // Delete from cache\n        delete: async (request) => {\n            if (!this.cache) {\n                throw new Error('Cache API not available');\n            }\n            \n            try {\n                const success = await this.cache.delete(request);\n                if (success) {\n                    Logger.info(`[StorageManager] Cache deleted: ${request}`);\n                }\n                return success;\n            } catch (error) {\n                Logger.error('[StorageManager] Cache delete failed:', error);\n                throw error;\n            }\n        },\n        \n        // Get all cached requests\n        keys: async () => {\n            if (!this.cache) {\n                throw new Error('Cache API not available');\n            }\n            \n            try {\n                return await this.cache.keys();\n            } catch (error) {\n                Logger.error('[StorageManager] Cache keys failed:', error);\n                throw error;\n            }\n        },\n        \n        // Clear cache\n        clear: async () => {\n            if (!this.cache) {\n                throw new Error('Cache API not available');\n            }\n            \n            try {\n                const keys = await this.cache.keys();\n                await Promise.all(keys.map(key => this.cache.delete(key)));\n                Logger.info('[StorageManager] Cache cleared');\n            } catch (error) {\n                Logger.error('[StorageManager] Cache clear failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Broadcast Channel for cross-tab communication\n     */\n    channel = {\n        // Create or get channel\n        create: (channelName, onMessage = null) => {\n            if (!this.support.broadcastChannel) {\n                Logger.warn('[StorageManager] BroadcastChannel not supported');\n                return null;\n            }\n            \n            if (this.channels.has(channelName)) {\n                return this.channels.get(channelName);\n            }\n            \n            const channel = new BroadcastChannel(channelName);\n            \n            if (onMessage) {\n                channel.addEventListener('message', onMessage);\n            }\n            \n            const channelWrapper = {\n                name: channelName,\n                channel,\n                \n                send: (data) => {\n                    channel.postMessage({\n                        data,\n                        timestamp: Date.now(),\n                        sender: 'current-tab'\n                    });\n                    Logger.info(`[StorageManager] Broadcast sent to ${channelName}`);\n                },\n                \n                onMessage: (callback) => {\n                    channel.addEventListener('message', (event) => {\n                        callback(event.data);\n                    });\n                },\n                \n                close: () => {\n                    channel.close();\n                    this.channels.delete(channelName);\n                    Logger.info(`[StorageManager] Channel closed: ${channelName}`);\n                }\n            };\n            \n            this.channels.set(channelName, channelWrapper);\n            Logger.info(`[StorageManager] Channel created: ${channelName}`);\n            \n            return channelWrapper;\n        },\n        \n        // Get existing channel\n        get: (channelName) => {\n            return this.channels.get(channelName) || null;\n        },\n        \n        // Close channel\n        close: (channelName) => {\n            const channel = this.channels.get(channelName);\n            if (channel) {\n                channel.close();\n            }\n        },\n        \n        // Close all channels\n        closeAll: () => {\n            this.channels.forEach(channel => channel.close());\n            this.channels.clear();\n            Logger.info('[StorageManager] All channels closed');\n        }\n    };\n    \n    /**\n     * Web Locks API for resource locking\n     */\n    locks = {\n        // Acquire lock\n        acquire: async (lockName, callback, options = {}) => {\n            if (!this.support.webLocks) {\n                Logger.warn('[StorageManager] Web Locks not supported, executing without lock');\n                return await callback();\n            }\n            \n            try {\n                return await navigator.locks.request(lockName, options, async (lock) => {\n                    Logger.info(`[StorageManager] Lock acquired: ${lockName}`);\n                    const result = await callback(lock);\n                    Logger.info(`[StorageManager] Lock released: ${lockName}`);\n                    return result;\n                });\n            } catch (error) {\n                Logger.error(`[StorageManager] Lock failed: ${lockName}`, error);\n                throw error;\n            }\n        },\n        \n        // Query locks\n        query: async () => {\n            if (!this.support.webLocks) {\n                return { held: [], pending: [] };\n            }\n            \n            try {\n                return await navigator.locks.query();\n            } catch (error) {\n                Logger.error('[StorageManager] Lock query failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Local/Session Storage helpers (with JSON support)\n     */\n    local = {\n        set: (key, value, expiration = null) => {\n            if (!this.support.localStorage) return false;\n            \n            try {\n                const data = {\n                    value,\n                    timestamp: Date.now(),\n                    expiration: expiration ? Date.now() + expiration : null\n                };\n                localStorage.setItem(key, JSON.stringify(data));\n                return true;\n            } catch (error) {\n                Logger.error('[StorageManager] localStorage set failed:', error);\n                return false;\n            }\n        },\n        \n        get: (key) => {\n            if (!this.support.localStorage) return null;\n            \n            try {\n                const item = localStorage.getItem(key);\n                if (!item) return null;\n                \n                const data = JSON.parse(item);\n                \n                // Check expiration\n                if (data.expiration && Date.now() > data.expiration) {\n                    localStorage.removeItem(key);\n                    return null;\n                }\n                \n                return data.value;\n            } catch (error) {\n                Logger.error('[StorageManager] localStorage get failed:', error);\n                return null;\n            }\n        },\n        \n        delete: (key) => {\n            if (!this.support.localStorage) return false;\n            localStorage.removeItem(key);\n            return true;\n        },\n        \n        clear: () => {\n            if (!this.support.localStorage) return false;\n            localStorage.clear();\n            return true;\n        },\n        \n        keys: () => {\n            if (!this.support.localStorage) return [];\n            return Object.keys(localStorage);\n        }\n    };\n    \n    session = {\n        set: (key, value) => {\n            if (!this.support.sessionStorage) return false;\n            \n            try {\n                sessionStorage.setItem(key, JSON.stringify(value));\n                return true;\n            } catch (error) {\n                Logger.error('[StorageManager] sessionStorage set failed:', error);\n                return false;\n            }\n        },\n        \n        get: (key) => {\n            if (!this.support.sessionStorage) return null;\n            \n            try {\n                const item = sessionStorage.getItem(key);\n                return item ? JSON.parse(item) : null;\n            } catch (error) {\n                Logger.error('[StorageManager] sessionStorage get failed:', error);\n                return null;\n            }\n        },\n        \n        delete: (key) => {\n            if (!this.support.sessionStorage) return false;\n            sessionStorage.removeItem(key);\n            return true;\n        },\n        \n        clear: () => {\n            if (!this.support.sessionStorage) return false;\n            sessionStorage.clear();\n            return true;\n        }\n    };\n    \n    /**\n     * Smart caching with automatic expiration\n     */\n    smartCache = {\n        set: async (key, value, options = {}) => {\n            const {\n                storage = 'indexedDB',\n                expiration = null,\n                fallback = true\n            } = options;\n            \n            try {\n                if (storage === 'indexedDB' && this.db) {\n                    return await this.db.set(key, value, expiration);\n                } else if (fallback) {\n                    return this.local.set(key, value, expiration);\n                }\n            } catch (error) {\n                if (fallback) {\n                    return this.local.set(key, value, expiration);\n                }\n                throw error;\n            }\n        },\n        \n        get: async (key, options = {}) => {\n            const { storage = 'indexedDB', fallback = true } = options;\n            \n            try {\n                if (storage === 'indexedDB' && this.db) {\n                    return await this.db.get(key);\n                } else if (fallback) {\n                    return this.local.get(key);\n                }\n            } catch (error) {\n                if (fallback) {\n                    return this.local.get(key);\n                }\n                throw error;\n            }\n        },\n        \n        delete: async (key, options = {}) => {\n            const { storage = 'indexedDB', fallback = true } = options;\n            \n            try {\n                if (storage === 'indexedDB' && this.db) {\n                    await this.db.delete(key);\n                }\n                if (fallback) {\n                    this.local.delete(key);\n                }\n            } catch (error) {\n                if (fallback) {\n                    this.local.delete(key);\n                }\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Get storage usage statistics\n     */\n    async getStorageUsage() {\n        const stats = {\n            quota: 0,\n            usage: 0,\n            available: 0,\n            percentage: 0\n        };\n        \n        if ('storage' in navigator && 'estimate' in navigator.storage) {\n            try {\n                const estimate = await navigator.storage.estimate();\n                stats.quota = estimate.quota || 0;\n                stats.usage = estimate.usage || 0;\n                stats.available = stats.quota - stats.usage;\n                stats.percentage = stats.quota > 0 ? Math.round((stats.usage / stats.quota) * 100) : 0;\n            } catch (error) {\n                Logger.error('[StorageManager] Storage estimate failed:', error);\n            }\n        }\n        \n        return stats;\n    }\n    \n    /**\n     * Cleanup expired data\n     */\n    async cleanup() {\n        Logger.info('[StorageManager] Starting cleanup...');\n        \n        try {\n            // Cleanup IndexedDB expired entries\n            if (this.db) {\n                const transaction = this.db.transaction(['keyValue'], 'readwrite');\n                const store = transaction.objectStore('keyValue');\n                const index = store.index('timestamp');\n                \n                const request = index.openCursor();\n                let cleaned = 0;\n                \n                request.onsuccess = (event) => {\n                    const cursor = event.target.result;\n                    if (cursor) {\n                        const data = cursor.value;\n                        if (data.expiration && Date.now() > data.expiration) {\n                            cursor.delete();\n                            cleaned++;\n                        }\n                        cursor.continue();\n                    } else {\n                        Logger.info(`[StorageManager] Cleanup completed: ${cleaned} expired entries removed`);\n                    }\n                };\n            }\n            \n            // Cleanup localStorage expired entries\n            if (this.support.localStorage) {\n                const keys = Object.keys(localStorage);\n                let localCleaned = 0;\n                \n                keys.forEach(key => {\n                    try {\n                        const item = localStorage.getItem(key);\n                        const data = JSON.parse(item);\n                        \n                        if (data.expiration && Date.now() > data.expiration) {\n                            localStorage.removeItem(key);\n                            localCleaned++;\n                        }\n                    } catch (error) {\n                        // Ignore non-JSON items\n                    }\n                });\n                \n                if (localCleaned > 0) {\n                    Logger.info(`[StorageManager] LocalStorage cleanup: ${localCleaned} expired entries removed`);\n                }\n            }\n            \n        } catch (error) {\n            Logger.error('[StorageManager] Cleanup failed:', error);\n        }\n    }\n    \n    /**\n     * Get comprehensive storage status\n     */\n    async getStatus() {\n        const usage = await this.getStorageUsage();\n        \n        return {\n            support: this.support,\n            usage,\n            activeChannels: this.channels.size,\n            dbConnected: !!this.db,\n            cacheConnected: !!this.cache,\n            channelNames: Array.from(this.channels.keys()),\n            analytics: this.config.enableAnalytics ? this.getAnalytics() : null\n        };\n    }\n    \n    /**\n     * Unified storage API - works with any storage type\n     */\n    storage = {\n        /**\n         * Set value in storage\n         */\n        set: async (key, value, options = {}) => {\n            const {\n                type = 'auto', // 'auto' | 'localStorage' | 'sessionStorage' | 'indexedDB'\n                expiration = null,\n                ...rest\n            } = options;\n            \n            try {\n                // Auto-select storage type based on size\n                let storageType = type;\n                if (type === 'auto') {\n                    const valueSize = JSON.stringify(value).length;\n                    storageType = valueSize > 5 * 1024 * 1024 ? 'indexedDB' : 'localStorage'; // >5MB use IndexedDB\n                }\n                \n                switch (storageType) {\n                    case 'localStorage':\n                        return this.local.set(key, value, expiration);\n                    case 'sessionStorage':\n                        return this.session.set(key, value);\n                    case 'indexedDB':\n                        return await this.db.set(key, value, expiration);\n                    default:\n                        throw new Error(`Unknown storage type: ${storageType}`);\n                }\n            } catch (error) {\n                // Fallback to localStorage if IndexedDB fails\n                if (type === 'indexedDB' || type === 'auto') {\n                    Logger.warn('[StorageManager] Falling back to localStorage', error);\n                    return this.local.set(key, value, expiration);\n                }\n                throw error;\n            } finally {\n                if (this.config.enableAnalytics) {\n                    this.analytics.operations.set++;\n                }\n            }\n        },\n        \n        /**\n         * Get value from storage\n         */\n        get: async (key, options = {}) => {\n            const { type = 'auto', ...rest } = options;\n            \n            try {\n                // Try different storage types in order\n                if (type === 'auto') {\n                    // Try localStorage first (fastest)\n                    const localValue = this.local.get(key);\n                    if (localValue !== null) {\n                        if (this.config.enableAnalytics) {\n                            this.analytics.operations.get++;\n                        }\n                        return localValue;\n                    }\n                    \n                    // Try sessionStorage\n                    const sessionValue = this.session.get(key);\n                    if (sessionValue !== null) {\n                        if (this.config.enableAnalytics) {\n                            this.analytics.operations.get++;\n                        }\n                        return sessionValue;\n                    }\n                    \n                    // Try IndexedDB\n                    if (this.db) {\n                        const dbValue = await this.db.get(key);\n                        if (dbValue !== null) {\n                            if (this.config.enableAnalytics) {\n                                this.analytics.operations.get++;\n                            }\n                            return dbValue;\n                        }\n                    }\n                    \n                    return null;\n                } else {\n                    switch (type) {\n                        case 'localStorage':\n                            const localValue = this.local.get(key);\n                            if (this.config.enableAnalytics) {\n                                this.analytics.operations.get++;\n                            }\n                            return localValue;\n                        case 'sessionStorage':\n                            const sessionValue = this.session.get(key);\n                            if (this.config.enableAnalytics) {\n                                this.analytics.operations.get++;\n                            }\n                            return sessionValue;\n                        case 'indexedDB':\n                            const dbValue = await this.db.get(key);\n                            if (this.config.enableAnalytics) {\n                                this.analytics.operations.get++;\n                            }\n                            return dbValue;\n                        default:\n                            throw new Error(`Unknown storage type: ${type}`);\n                    }\n                }\n            } catch (error) {\n                Logger.error('[StorageManager] Storage get failed', error);\n                if (this.config.enableAnalytics) {\n                    this.analytics.errors++;\n                }\n                throw error;\n            }\n        },\n        \n        /**\n         * Delete value from storage\n         */\n        delete: async (key, options = {}) => {\n            const { type = 'all', ...rest } = options;\n            \n            try {\n                if (type === 'all') {\n                    // Delete from all storage types\n                    this.local.delete(key);\n                    this.session.delete(key);\n                    if (this.db) {\n                        await this.db.delete(key);\n                    }\n                } else {\n                    switch (type) {\n                        case 'localStorage':\n                            this.local.delete(key);\n                            break;\n                        case 'sessionStorage':\n                            this.session.delete(key);\n                            break;\n                        case 'indexedDB':\n                            if (this.db) {\n                                await this.db.delete(key);\n                            }\n                            break;\n                    }\n                }\n                \n                if (this.config.enableAnalytics) {\n                    this.analytics.operations.delete++;\n                }\n            } catch (error) {\n                Logger.error('[StorageManager] Storage delete failed', error);\n                if (this.config.enableAnalytics) {\n                    this.analytics.errors++;\n                }\n                throw error;\n            }\n        },\n        \n        /**\n         * Clear all storage\n         */\n        clear: async (options = {}) => {\n            const { type = 'all', ...rest } = options;\n            \n            try {\n                if (type === 'all') {\n                    this.local.clear();\n                    this.session.clear();\n                    if (this.db) {\n                        await this.db.clear();\n                    }\n                    if (this.cache) {\n                        await this.cache.clear();\n                    }\n                } else {\n                    switch (type) {\n                        case 'localStorage':\n                            this.local.clear();\n                            break;\n                        case 'sessionStorage':\n                            this.session.clear();\n                            break;\n                        case 'indexedDB':\n                            if (this.db) {\n                                await this.db.clear();\n                            }\n                            break;\n                        case 'cache':\n                            if (this.cache) {\n                                await this.cache.clear();\n                            }\n                            break;\n                    }\n                }\n                \n                if (this.config.enableAnalytics) {\n                    this.analytics.operations.clear++;\n                }\n            } catch (error) {\n                Logger.error('[StorageManager] Storage clear failed', error);\n                if (this.config.enableAnalytics) {\n                    this.analytics.errors++;\n                }\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Start quota monitoring\n     */\n    startQuotaMonitoring() {\n        // Check quota periodically\n        setInterval(async () => {\n            try {\n                const usage = await this.getStorageUsage();\n                if (usage.percentage >= this.config.quotaWarningThreshold * 100) {\n                    this.analytics.quotaWarnings++;\n                    Logger.warn('[StorageManager] Storage quota warning', {\n                        usage: usage.percentage + '%',\n                        available: this.formatBytes(usage.available)\n                    });\n                    \n                    // Trigger event\n                    const event = new CustomEvent('storage:quota-warning', {\n                        detail: usage,\n                        bubbles: true\n                    });\n                    window.dispatchEvent(event);\n                }\n            } catch (error) {\n                Logger.error('[StorageManager] Quota monitoring error', error);\n            }\n        }, 60000); // Check every minute\n    }\n    \n    /**\n     * Migrate data between storage types\n     */\n    async migrate(fromType, toType, keys = null) {\n        Logger.info('[StorageManager] Starting migration', { fromType, toType });\n        \n        let sourceKeys = keys;\n        \n        // Get keys from source\n        if (!sourceKeys) {\n            switch (fromType) {\n                case 'localStorage':\n                    sourceKeys = this.local.keys();\n                    break;\n                case 'sessionStorage':\n                    sourceKeys = Object.keys(sessionStorage);\n                    break;\n                case 'indexedDB':\n                    if (this.db) {\n                        sourceKeys = await this.db.keys();\n                    }\n                    break;\n            }\n        }\n        \n        if (!sourceKeys || sourceKeys.length === 0) {\n            Logger.info('[StorageManager] No keys to migrate');\n            return;\n        }\n        \n        let migrated = 0;\n        let failed = 0;\n        \n        for (const key of sourceKeys) {\n            try {\n                // Get value from source\n                let value = null;\n                switch (fromType) {\n                    case 'localStorage':\n                        value = this.local.get(key);\n                        break;\n                    case 'sessionStorage':\n                        value = this.session.get(key);\n                        break;\n                    case 'indexedDB':\n                        if (this.db) {\n                            value = await this.db.get(key);\n                        }\n                        break;\n                }\n                \n                if (value === null) {\n                    continue;\n                }\n                \n                // Set value in destination\n                switch (toType) {\n                    case 'localStorage':\n                        this.local.set(key, value);\n                        break;\n                    case 'sessionStorage':\n                        this.session.set(key, value);\n                        break;\n                    case 'indexedDB':\n                        if (this.db) {\n                            await this.db.set(key, value);\n                        }\n                        break;\n                }\n                \n                migrated++;\n            } catch (error) {\n                Logger.error(`[StorageManager] Failed to migrate key: ${key}`, error);\n                failed++;\n            }\n        }\n        \n        Logger.info('[StorageManager] Migration completed', { migrated, failed });\n        return { migrated, failed };\n    }\n    \n    /**\n     * Get storage analytics\n     */\n    getAnalytics() {\n        return {\n            ...this.analytics,\n            totalOperations: Object.values(this.analytics.operations).reduce((sum, count) => sum + count, 0),\n            errorRate: this.analytics.errors / (this.analytics.operations.get + this.analytics.operations.set || 1)\n        };\n    }\n    \n    /**\n     * Reset analytics\n     */\n    resetAnalytics() {\n        this.analytics = {\n            operations: {\n                get: 0,\n                set: 0,\n                delete: 0,\n                clear: 0\n            },\n            errors: 0,\n            quotaWarnings: 0\n        };\n    }\n    \n    /**\n     * Format bytes for human reading\n     */\n    formatBytes(bytes) {\n        if (bytes === 0) return '0 Bytes';\n        const k = 1024;\n        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n        const i = Math.floor(Math.log(bytes) / Math.log(k));\n        return Math.round(bytes / Math.pow(k, i) * 100) / 100 + ' ' + sizes[i];\n    }\n}","// modules/api-manager/DeviceManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Device APIs Manager - Geolocation, Sensors, Battery, Network, Vibration\n */\nexport class DeviceManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.activeWatchers = new Map();\n        this.sensorData = new Map();\n        \n        // Check API support\n        this.support = {\n            geolocation: 'geolocation' in navigator,\n            deviceMotion: 'DeviceMotionEvent' in window,\n            deviceOrientation: 'DeviceOrientationEvent' in window,\n            vibration: 'vibrate' in navigator,\n            battery: 'getBattery' in navigator,\n            networkInfo: 'connection' in navigator || 'mozConnection' in navigator || 'webkitConnection' in navigator,\n            wakeLock: 'wakeLock' in navigator,\n            bluetooth: 'bluetooth' in navigator,\n            usb: 'usb' in navigator,\n            serial: 'serial' in navigator\n        };\n        \n        Logger.info('[DeviceManager] Initialized with support:', this.support);\n        \n        // Initialize sensors if available\n        this.initializeSensors();\n    }\n    \n    /**\n     * Geolocation API\n     */\n    geolocation = {\n        // Get current position\n        getCurrent: (options = {}) => {\n            return new Promise((resolve, reject) => {\n                if (!this.support.geolocation) {\n                    reject(new Error('Geolocation not supported'));\n                    return;\n                }\n                \n                const defaultOptions = {\n                    enableHighAccuracy: true,\n                    timeout: 10000,\n                    maximumAge: 60000,\n                    ...options\n                };\n                \n                navigator.geolocation.getCurrentPosition(\n                    (position) => {\n                        const location = this.enhanceLocationData(position);\n                        Logger.info('[DeviceManager] Location acquired:', {\n                            lat: location.latitude,\n                            lng: location.longitude,\n                            accuracy: location.accuracy\n                        });\n                        resolve(location);\n                    },\n                    (error) => {\n                        Logger.error('[DeviceManager] Geolocation failed:', error.message);\n                        reject(error);\n                    },\n                    defaultOptions\n                );\n            });\n        },\n        \n        // Watch position changes\n        watch: (callback, options = {}) => {\n            if (!this.support.geolocation) {\n                throw new Error('Geolocation not supported');\n            }\n            \n            const defaultOptions = {\n                enableHighAccuracy: true,\n                timeout: 30000,\n                maximumAge: 10000,\n                ...options\n            };\n            \n            const watchId = navigator.geolocation.watchPosition(\n                (position) => {\n                    const location = this.enhanceLocationData(position);\n                    callback(location);\n                },\n                (error) => {\n                    Logger.error('[DeviceManager] Location watch failed:', error.message);\n                    callback({ error });\n                },\n                defaultOptions\n            );\n            \n            this.activeWatchers.set(`geo_${watchId}`, {\n                type: 'geolocation',\n                id: watchId,\n                stop: () => {\n                    navigator.geolocation.clearWatch(watchId);\n                    this.activeWatchers.delete(`geo_${watchId}`);\n                }\n            });\n            \n            Logger.info('[DeviceManager] Location watch started:', watchId);\n            \n            return {\n                id: watchId,\n                stop: () => {\n                    navigator.geolocation.clearWatch(watchId);\n                    this.activeWatchers.delete(`geo_${watchId}`);\n                    Logger.info('[DeviceManager] Location watch stopped:', watchId);\n                }\n            };\n        },\n        \n        // Calculate distance between two points\n        distance: (pos1, pos2) => {\n            const R = 6371; // Earth's radius in km\n            const dLat = this.toRadians(pos2.latitude - pos1.latitude);\n            const dLon = this.toRadians(pos2.longitude - pos1.longitude);\n            \n            const a = Math.sin(dLat / 2) * Math.sin(dLat / 2) +\n                      Math.cos(this.toRadians(pos1.latitude)) * Math.cos(this.toRadians(pos2.latitude)) *\n                      Math.sin(dLon / 2) * Math.sin(dLon / 2);\n            \n            const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n            const distance = R * c;\n            \n            return {\n                kilometers: distance,\n                miles: distance * 0.621371,\n                meters: distance * 1000\n            };\n        }\n    };\n    \n    /**\n     * Device Motion and Orientation\n     */\n    motion = {\n        // Start motion detection\n        start: (callback, options = {}) => {\n            if (!this.support.deviceMotion) {\n                throw new Error('Device Motion not supported');\n            }\n            \n            const handler = (event) => {\n                const motionData = {\n                    acceleration: event.acceleration,\n                    accelerationIncludingGravity: event.accelerationIncludingGravity,\n                    rotationRate: event.rotationRate,\n                    interval: event.interval,\n                    timestamp: event.timeStamp,\n                    // Enhanced data\n                    totalAcceleration: this.calculateTotalAcceleration(event.acceleration),\n                    shake: this.detectShake(event.accelerationIncludingGravity),\n                    orientation: this.getDeviceOrientation(event)\n                };\n                \n                callback(motionData);\n            };\n            \n            // Request permission for iOS 13+\n            if (typeof DeviceMotionEvent.requestPermission === 'function') {\n                DeviceMotionEvent.requestPermission().then(response => {\n                    if (response === 'granted') {\n                        window.addEventListener('devicemotion', handler);\n                    }\n                });\n            } else {\n                window.addEventListener('devicemotion', handler);\n            }\n            \n            const watcherId = this.generateId('motion');\n            this.activeWatchers.set(watcherId, {\n                type: 'motion',\n                handler,\n                stop: () => {\n                    window.removeEventListener('devicemotion', handler);\n                    this.activeWatchers.delete(watcherId);\n                }\n            });\n            \n            Logger.info('[DeviceManager] Motion detection started');\n            \n            return {\n                id: watcherId,\n                stop: () => {\n                    window.removeEventListener('devicemotion', handler);\n                    this.activeWatchers.delete(watcherId);\n                    Logger.info('[DeviceManager] Motion detection stopped');\n                }\n            };\n        },\n        \n        // Start orientation detection\n        startOrientation: (callback, options = {}) => {\n            if (!this.support.deviceOrientation) {\n                throw new Error('Device Orientation not supported');\n            }\n            \n            const handler = (event) => {\n                const orientationData = {\n                    alpha: event.alpha, // Z axis (0-360)\n                    beta: event.beta,   // X axis (-180 to 180)\n                    gamma: event.gamma, // Y axis (-90 to 90)\n                    absolute: event.absolute,\n                    timestamp: event.timeStamp,\n                    // Enhanced data\n                    compass: this.calculateCompass(event.alpha),\n                    tilt: this.calculateTilt(event.beta, event.gamma),\n                    rotation: this.getRotationState(event)\n                };\n                \n                callback(orientationData);\n            };\n            \n            // Request permission for iOS 13+\n            if (typeof DeviceOrientationEvent.requestPermission === 'function') {\n                DeviceOrientationEvent.requestPermission().then(response => {\n                    if (response === 'granted') {\n                        window.addEventListener('deviceorientation', handler);\n                    }\n                });\n            } else {\n                window.addEventListener('deviceorientation', handler);\n            }\n            \n            const watcherId = this.generateId('orientation');\n            this.activeWatchers.set(watcherId, {\n                type: 'orientation',\n                handler,\n                stop: () => {\n                    window.removeEventListener('deviceorientation', handler);\n                    this.activeWatchers.delete(watcherId);\n                }\n            });\n            \n            Logger.info('[DeviceManager] Orientation detection started');\n            \n            return {\n                id: watcherId,\n                stop: () => {\n                    window.removeEventListener('deviceorientation', handler);\n                    this.activeWatchers.delete(watcherId);\n                    Logger.info('[DeviceManager] Orientation detection stopped');\n                }\n            };\n        }\n    };\n    \n    /**\n     * Vibration API\n     */\n    vibration = {\n        // Simple vibration\n        vibrate: (pattern) => {\n            if (!this.support.vibration) {\n                Logger.warn('[DeviceManager] Vibration not supported');\n                return false;\n            }\n            \n            try {\n                navigator.vibrate(pattern);\n                Logger.info('[DeviceManager] Vibration triggered:', pattern);\n                return true;\n            } catch (error) {\n                Logger.error('[DeviceManager] Vibration failed:', error);\n                return false;\n            }\n        },\n        \n        // Predefined patterns\n        patterns: {\n            short: 200,\n            long: 600,\n            double: [200, 100, 200],\n            triple: [200, 100, 200, 100, 200],\n            sos: [100, 30, 100, 30, 100, 200, 200, 30, 200, 30, 200, 200, 100, 30, 100, 30, 100],\n            heartbeat: [100, 30, 100, 130, 40, 30, 40, 30, 100],\n            notification: [200, 100, 200],\n            success: [100],\n            error: [300, 100, 300],\n            warning: [200, 100, 200, 100, 200]\n        },\n        \n        // Stop vibration\n        stop: () => {\n            if (this.support.vibration) {\n                navigator.vibrate(0);\n                Logger.info('[DeviceManager] Vibration stopped');\n            }\n        },\n        \n        // Haptic feedback helpers\n        success: () => this.vibration.vibrate(this.vibration.patterns.success),\n        error: () => this.vibration.vibrate(this.vibration.patterns.error),\n        warning: () => this.vibration.vibrate(this.vibration.patterns.warning),\n        notification: () => this.vibration.vibrate(this.vibration.patterns.notification)\n    };\n    \n    /**\n     * Battery API\n     */\n    battery = {\n        // Get battery status\n        get: async () => {\n            if (!this.support.battery) {\n                Logger.warn('[DeviceManager] Battery API not supported');\n                return null;\n            }\n            \n            try {\n                const battery = await navigator.getBattery();\n                \n                const batteryInfo = {\n                    level: Math.round(battery.level * 100),\n                    charging: battery.charging,\n                    chargingTime: battery.chargingTime,\n                    dischargingTime: battery.dischargingTime,\n                    // Enhanced data\n                    status: this.getBatteryStatus(battery),\n                    timeRemaining: this.formatBatteryTime(battery)\n                };\n                \n                Logger.info('[DeviceManager] Battery status:', batteryInfo);\n                return batteryInfo;\n            } catch (error) {\n                Logger.error('[DeviceManager] Battery status failed:', error);\n                return null;\n            }\n        },\n        \n        // Watch battery changes\n        watch: async (callback) => {\n            if (!this.support.battery) {\n                throw new Error('Battery API not supported');\n            }\n            \n            try {\n                const battery = await navigator.getBattery();\n                \n                const events = ['chargingchange', 'levelchange', 'chargingtimechange', 'dischargingtimechange'];\n                const handlers = [];\n                \n                events.forEach(eventType => {\n                    const handler = () => {\n                        const batteryInfo = {\n                            level: Math.round(battery.level * 100),\n                            charging: battery.charging,\n                            chargingTime: battery.chargingTime,\n                            dischargingTime: battery.dischargingTime,\n                            status: this.getBatteryStatus(battery),\n                            timeRemaining: this.formatBatteryTime(battery),\n                            event: eventType\n                        };\n                        callback(batteryInfo);\n                    };\n                    \n                    battery.addEventListener(eventType, handler);\n                    handlers.push({ event: eventType, handler });\n                });\n                \n                const watcherId = this.generateId('battery');\n                this.activeWatchers.set(watcherId, {\n                    type: 'battery',\n                    battery,\n                    handlers,\n                    stop: () => {\n                        handlers.forEach(({ event, handler }) => {\n                            battery.removeEventListener(event, handler);\n                        });\n                        this.activeWatchers.delete(watcherId);\n                    }\n                });\n                \n                Logger.info('[DeviceManager] Battery watch started');\n                \n                return {\n                    id: watcherId,\n                    stop: () => {\n                        handlers.forEach(({ event, handler }) => {\n                            battery.removeEventListener(event, handler);\n                        });\n                        this.activeWatchers.delete(watcherId);\n                        Logger.info('[DeviceManager] Battery watch stopped');\n                    }\n                };\n            } catch (error) {\n                Logger.error('[DeviceManager] Battery watch failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Network Information API\n     */\n    network = {\n        // Get connection info\n        get: () => {\n            if (!this.support.networkInfo) {\n                Logger.warn('[DeviceManager] Network Information not supported');\n                return null;\n            }\n            \n            const connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;\n            \n            return {\n                effectiveType: connection.effectiveType,\n                downlink: connection.downlink,\n                rtt: connection.rtt,\n                saveData: connection.saveData,\n                // Enhanced data\n                speed: this.getConnectionSpeed(connection),\n                quality: this.getConnectionQuality(connection),\n                recommendation: this.getNetworkRecommendation(connection)\n            };\n        },\n        \n        // Watch network changes\n        watch: (callback) => {\n            if (!this.support.networkInfo) {\n                throw new Error('Network Information not supported');\n            }\n            \n            const connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;\n            \n            const handler = () => {\n                const networkInfo = {\n                    effectiveType: connection.effectiveType,\n                    downlink: connection.downlink,\n                    rtt: connection.rtt,\n                    saveData: connection.saveData,\n                    speed: this.getConnectionSpeed(connection),\n                    quality: this.getConnectionQuality(connection),\n                    recommendation: this.getNetworkRecommendation(connection)\n                };\n                \n                callback(networkInfo);\n            };\n            \n            connection.addEventListener('change', handler);\n            \n            const watcherId = this.generateId('network');\n            this.activeWatchers.set(watcherId, {\n                type: 'network',\n                connection,\n                handler,\n                stop: () => {\n                    connection.removeEventListener('change', handler);\n                    this.activeWatchers.delete(watcherId);\n                }\n            });\n            \n            Logger.info('[DeviceManager] Network watch started');\n            \n            return {\n                id: watcherId,\n                stop: () => {\n                    connection.removeEventListener('change', handler);\n                    this.activeWatchers.delete(watcherId);\n                    Logger.info('[DeviceManager] Network watch stopped');\n                }\n            };\n        }\n    };\n    \n    /**\n     * Wake Lock API\n     */\n    wakeLock = {\n        // Request wake lock\n        request: async (type = 'screen') => {\n            if (!this.support.wakeLock) {\n                Logger.warn('[DeviceManager] Wake Lock not supported');\n                return null;\n            }\n            \n            try {\n                const wakeLock = await navigator.wakeLock.request(type);\n                Logger.info(`[DeviceManager] Wake lock acquired: ${type}`);\n                \n                return {\n                    type: wakeLock.type,\n                    release: () => {\n                        wakeLock.release();\n                        Logger.info(`[DeviceManager] Wake lock released: ${type}`);\n                    }\n                };\n            } catch (error) {\n                Logger.error('[DeviceManager] Wake lock failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    // Helper methods\n    \n    initializeSensors() {\n        // Initialize any sensors that need setup\n        if (this.support.deviceMotion || this.support.deviceOrientation) {\n            // Store baseline sensor data for comparison\n            this.sensorData.set('motionBaseline', { x: 0, y: 0, z: 0 });\n            this.sensorData.set('shakeThreshold', this.config.shakeThreshold || 15);\n        }\n    }\n    \n    enhanceLocationData(position) {\n        return {\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            accuracy: position.coords.accuracy,\n            altitude: position.coords.altitude,\n            altitudeAccuracy: position.coords.altitudeAccuracy,\n            heading: position.coords.heading,\n            speed: position.coords.speed,\n            timestamp: position.timestamp,\n            // Enhanced data\n            coordinates: `${position.coords.latitude},${position.coords.longitude}`,\n            accuracyLevel: this.getAccuracyLevel(position.coords.accuracy),\n            mapUrl: `https://maps.google.com/?q=${position.coords.latitude},${position.coords.longitude}`\n        };\n    }\n    \n    getAccuracyLevel(accuracy) {\n        if (accuracy <= 5) return 'excellent';\n        if (accuracy <= 10) return 'good';\n        if (accuracy <= 50) return 'fair';\n        return 'poor';\n    }\n    \n    calculateTotalAcceleration(acceleration) {\n        if (!acceleration) return 0;\n        const x = acceleration.x || 0;\n        const y = acceleration.y || 0;\n        const z = acceleration.z || 0;\n        return Math.sqrt(x * x + y * y + z * z);\n    }\n    \n    detectShake(acceleration) {\n        if (!acceleration) return false;\n        \n        const threshold = this.sensorData.get('shakeThreshold');\n        const x = Math.abs(acceleration.x || 0);\n        const y = Math.abs(acceleration.y || 0);\n        const z = Math.abs(acceleration.z || 0);\n        \n        return (x > threshold || y > threshold || z > threshold);\n    }\n    \n    getDeviceOrientation(event) {\n        const acceleration = event.accelerationIncludingGravity;\n        if (!acceleration) return 'unknown';\n        \n        const x = acceleration.x || 0;\n        const y = acceleration.y || 0;\n        const z = acceleration.z || 0;\n        \n        if (Math.abs(x) > Math.abs(y) && Math.abs(x) > Math.abs(z)) {\n            return x > 0 ? 'landscape-right' : 'landscape-left';\n        } else if (Math.abs(y) > Math.abs(z)) {\n            return y > 0 ? 'portrait-upside-down' : 'portrait';\n        } else {\n            return z > 0 ? 'face-down' : 'face-up';\n        }\n    }\n    \n    calculateCompass(alpha) {\n        if (alpha === null) return null;\n        \n        const directions = ['N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW'];\n        const index = Math.round(alpha / 45) % 8;\n        \n        return {\n            degrees: Math.round(alpha),\n            direction: directions[index],\n            cardinal: this.getCardinalDirection(alpha)\n        };\n    }\n    \n    getCardinalDirection(alpha) {\n        if (alpha >= 337.5 || alpha < 22.5) return 'North';\n        if (alpha >= 22.5 && alpha < 67.5) return 'Northeast';\n        if (alpha >= 67.5 && alpha < 112.5) return 'East';\n        if (alpha >= 112.5 && alpha < 157.5) return 'Southeast';\n        if (alpha >= 157.5 && alpha < 202.5) return 'South';\n        if (alpha >= 202.5 && alpha < 247.5) return 'Southwest';\n        if (alpha >= 247.5 && alpha < 292.5) return 'West';\n        if (alpha >= 292.5 && alpha < 337.5) return 'Northwest';\n        return 'Unknown';\n    }\n    \n    calculateTilt(beta, gamma) {\n        return {\n            x: Math.round(beta || 0),\n            y: Math.round(gamma || 0),\n            magnitude: Math.round(Math.sqrt((beta || 0) ** 2 + (gamma || 0) ** 2))\n        };\n    }\n    \n    getRotationState(event) {\n        const { alpha, beta, gamma } = event;\n        \n        // Determine if device is being rotated significantly\n        const rotationThreshold = 10;\n        const isRotating = Math.abs(beta) > rotationThreshold || Math.abs(gamma) > rotationThreshold;\n        \n        return {\n            isRotating,\n            intensity: isRotating ? Math.max(Math.abs(beta), Math.abs(gamma)) : 0\n        };\n    }\n    \n    getBatteryStatus(battery) {\n        const level = battery.level * 100;\n        \n        if (battery.charging) return 'charging';\n        if (level <= 10) return 'critical';\n        if (level <= 20) return 'low';\n        if (level <= 50) return 'medium';\n        return 'high';\n    }\n    \n    formatBatteryTime(battery) {\n        const time = battery.charging ? battery.chargingTime : battery.dischargingTime;\n        \n        if (time === Infinity || isNaN(time)) return 'Unknown';\n        \n        const hours = Math.floor(time / 3600);\n        const minutes = Math.floor((time % 3600) / 60);\n        \n        return `${hours}h ${minutes}m`;\n    }\n    \n    getConnectionSpeed(connection) {\n        const downlink = connection.downlink;\n        \n        if (downlink >= 10) return 'fast';\n        if (downlink >= 1.5) return 'good';\n        if (downlink >= 0.5) return 'slow';\n        return 'very-slow';\n    }\n    \n    getConnectionQuality(connection) {\n        const effectiveType = connection.effectiveType;\n        \n        switch (effectiveType) {\n            case '4g': return 'excellent';\n            case '3g': return 'good';\n            case '2g': return 'poor';\n            case 'slow-2g': return 'very-poor';\n            default: return 'unknown';\n        }\n    }\n    \n    getNetworkRecommendation(connection) {\n        const quality = this.getConnectionQuality(connection);\n        \n        switch (quality) {\n            case 'excellent':\n                return 'Full quality content recommended';\n            case 'good':\n                return 'Moderate quality content recommended';\n            case 'poor':\n                return 'Light content only, avoid large files';\n            case 'very-poor':\n                return 'Text-only content recommended';\n            default:\n                return 'Monitor connection quality';\n        }\n    }\n    \n    toRadians(degrees) {\n        return degrees * (Math.PI / 180);\n    }\n    \n    generateId(prefix = 'device') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    /**\n     * Stop all active watchers\n     */\n    stopAllWatchers() {\n        this.activeWatchers.forEach(watcher => {\n            watcher.stop();\n        });\n        this.activeWatchers.clear();\n        Logger.info('[DeviceManager] All watchers stopped');\n    }\n    \n    /**\n     * Get device capabilities summary\n     */\n    getCapabilities() {\n        return {\n            support: this.support,\n            activeWatchers: this.activeWatchers.size,\n            watcherTypes: Array.from(this.activeWatchers.values()).map(w => w.type)\n        };\n    }\n}","// modules/api-manager/AnimationManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Web Animations API Manager - High-performance animations with timeline control\n */\nexport class AnimationManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.activeAnimations = new Map();\n        this.animationGroups = new Map();\n        this.defaultEasing = config.easing || 'ease-out';\n        this.defaultDuration = config.duration || 300;\n        \n        // Check for Web Animations API support\n        this.supported = 'animate' in Element.prototype;\n        \n        if (!this.supported) {\n            Logger.warn('[AnimationManager] Web Animations API not supported, using fallbacks');\n        } else {\n            Logger.info('[AnimationManager] Initialized with Web Animations API support');\n        }\n    }\n    \n    /**\n     * Animate element using Web Animations API\n     */\n    animate(element, keyframes, options = {}) {\n        if (!element || !keyframes) {\n            Logger.warn('[AnimationManager] Missing element or keyframes');\n            return null;\n        }\n        \n        const animationOptions = {\n            duration: this.defaultDuration,\n            easing: this.defaultEasing,\n            fill: 'forwards',\n            ...options\n        };\n        \n        const animationId = this.generateId();\n        \n        if (this.supported) {\n            const animation = element.animate(keyframes, animationOptions);\n            \n            // Enhanced animation object\n            const enhancedAnimation = this.enhanceAnimation(animation, animationId, {\n                element,\n                keyframes,\n                options: animationOptions\n            });\n            \n            this.activeAnimations.set(animationId, enhancedAnimation);\n            \n            // Auto-cleanup on finish\n            animation.addEventListener('finish', () => {\n                this.activeAnimations.delete(animationId);\n            });\n            \n            Logger.info(`[AnimationManager] Animation started: ${animationId}`);\n            return enhancedAnimation;\n        } else {\n            return this.fallbackAnimate(element, keyframes, animationOptions, animationId);\n        }\n    }\n    \n    /**\n     * Create keyframe animations\n     */\n    keyframes(keyframeSet) {\n        // Convert CSS-like keyframes to Web Animations format\n        if (Array.isArray(keyframeSet)) {\n            return keyframeSet;\n        }\n        \n        // Handle object format: { '0%': {...}, '50%': {...}, '100%': {...} }\n        if (typeof keyframeSet === 'object') {\n            const frames = [];\n            const sortedKeys = Object.keys(keyframeSet).sort((a, b) => {\n                const aPercent = parseFloat(a.replace('%', ''));\n                const bPercent = parseFloat(b.replace('%', ''));\n                return aPercent - bPercent;\n            });\n            \n            sortedKeys.forEach(key => {\n                const offset = parseFloat(key.replace('%', '')) / 100;\n                frames.push({\n                    ...keyframeSet[key],\n                    offset\n                });\n            });\n            \n            return frames;\n        }\n        \n        return keyframeSet;\n    }\n    \n    /**\n     * Pre-defined animation effects\n     */\n    effects = {\n        // Entrance animations\n        fadeIn: (duration = 300) => ([\n            { opacity: 0 },\n            { opacity: 1 }\n        ]),\n        \n        slideInLeft: (distance = '100px', duration = 300) => ([\n            { transform: `translateX(-${distance})`, opacity: 0 },\n            { transform: 'translateX(0)', opacity: 1 }\n        ]),\n        \n        slideInRight: (distance = '100px', duration = 300) => ([\n            { transform: `translateX(${distance})`, opacity: 0 },\n            { transform: 'translateX(0)', opacity: 1 }\n        ]),\n        \n        slideInUp: (distance = '100px', duration = 300) => ([\n            { transform: `translateY(${distance})`, opacity: 0 },\n            { transform: 'translateY(0)', opacity: 1 }\n        ]),\n        \n        slideInDown: (distance = '100px', duration = 300) => ([\n            { transform: `translateY(-${distance})`, opacity: 0 },\n            { transform: 'translateY(0)', opacity: 1 }\n        ]),\n        \n        scaleIn: (scale = 0.8, duration = 300) => ([\n            { transform: `scale(${scale})`, opacity: 0 },\n            { transform: 'scale(1)', opacity: 1 }\n        ]),\n        \n        rotateIn: (rotation = '-180deg', duration = 600) => ([\n            { transform: `rotate(${rotation})`, opacity: 0 },\n            { transform: 'rotate(0deg)', opacity: 1 }\n        ]),\n        \n        // Exit animations\n        fadeOut: (duration = 300) => ([\n            { opacity: 1 },\n            { opacity: 0 }\n        ]),\n        \n        slideOutLeft: (distance = '100px', duration = 300) => ([\n            { transform: 'translateX(0)', opacity: 1 },\n            { transform: `translateX(-${distance})`, opacity: 0 }\n        ]),\n        \n        slideOutRight: (distance = '100px', duration = 300) => ([\n            { transform: 'translateX(0)', opacity: 1 },\n            { transform: `translateX(${distance})`, opacity: 0 }\n        ]),\n        \n        scaleOut: (scale = 0.8, duration = 300) => ([\n            { transform: 'scale(1)', opacity: 1 },\n            { transform: `scale(${scale})`, opacity: 0 }\n        ]),\n        \n        // Attention seekers\n        bounce: (intensity = '20px', duration = 600) => ([\n            { transform: 'translateY(0)' },\n            { transform: `translateY(-${intensity})`, offset: 0.25 },\n            { transform: 'translateY(0)', offset: 0.5 },\n            { transform: `translateY(-${intensity})`, offset: 0.75 },\n            { transform: 'translateY(0)' }\n        ]),\n        \n        pulse: (scale = 1.1, duration = 600) => ([\n            { transform: 'scale(1)' },\n            { transform: `scale(${scale})`, offset: 0.5 },\n            { transform: 'scale(1)' }\n        ]),\n        \n        shake: (distance = '10px', duration = 600) => ([\n            { transform: 'translateX(0)' },\n            { transform: `translateX(-${distance})`, offset: 0.1 },\n            { transform: `translateX(${distance})`, offset: 0.2 },\n            { transform: `translateX(-${distance})`, offset: 0.3 },\n            { transform: `translateX(${distance})`, offset: 0.4 },\n            { transform: `translateX(-${distance})`, offset: 0.5 },\n            { transform: `translateX(${distance})`, offset: 0.6 },\n            { transform: `translateX(-${distance})`, offset: 0.7 },\n            { transform: `translateX(${distance})`, offset: 0.8 },\n            { transform: `translateX(-${distance})`, offset: 0.9 },\n            { transform: 'translateX(0)' }\n        ]),\n        \n        rubberBand: (duration = 1000) => ([\n            { transform: 'scale(1)' },\n            { transform: 'scale(1.25, 0.75)', offset: 0.3 },\n            { transform: 'scale(0.75, 1.25)', offset: 0.4 },\n            { transform: 'scale(1.15, 0.85)', offset: 0.5 },\n            { transform: 'scale(0.95, 1.05)', offset: 0.65 },\n            { transform: 'scale(1.05, 0.95)', offset: 0.75 },\n            { transform: 'scale(1)' }\n        ]),\n        \n        // Loading animations\n        spin: (duration = 1000) => ([\n            { transform: 'rotate(0deg)' },\n            { transform: 'rotate(360deg)' }\n        ]),\n        \n        heartbeat: (scale = 1.3, duration = 1000) => ([\n            { transform: 'scale(1)' },\n            { transform: `scale(${scale})`, offset: 0.14 },\n            { transform: 'scale(1)', offset: 0.28 },\n            { transform: `scale(${scale})`, offset: 0.42 },\n            { transform: 'scale(1)', offset: 0.70 }\n        ])\n    };\n    \n    /**\n     * Predefined easing functions\n     */\n    easings = {\n        linear: 'linear',\n        ease: 'ease',\n        easeIn: 'ease-in',\n        easeOut: 'ease-out',\n        easeInOut: 'ease-in-out',\n        \n        // Custom cubic-bezier easings\n        easeInQuad: 'cubic-bezier(0.25, 0.46, 0.45, 0.94)',\n        easeOutQuad: 'cubic-bezier(0.25, 0.46, 0.45, 0.94)',\n        easeInOutQuad: 'cubic-bezier(0.455, 0.03, 0.515, 0.955)',\n        \n        easeInCubic: 'cubic-bezier(0.32, 0, 0.67, 0)',\n        easeOutCubic: 'cubic-bezier(0.33, 1, 0.68, 1)',\n        easeInOutCubic: 'cubic-bezier(0.65, 0, 0.35, 1)',\n        \n        easeInQuart: 'cubic-bezier(0.5, 0, 0.75, 0)',\n        easeOutQuart: 'cubic-bezier(0.25, 1, 0.5, 1)',\n        easeInOutQuart: 'cubic-bezier(0.76, 0, 0.24, 1)',\n        \n        // Bouncy easings\n        easeOutBack: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n        easeInBack: 'cubic-bezier(0.36, 0, 0.66, -0.56)',\n        easeInOutBack: 'cubic-bezier(0.68, -0.6, 0.32, 1.6)'\n    };\n    \n    /**\n     * Quick effect methods\n     */\n    fadeIn(element, options = {}) {\n        return this.animate(element, this.effects.fadeIn(), {\n            duration: 300,\n            easing: this.easings.easeOut,\n            ...options\n        });\n    }\n    \n    fadeOut(element, options = {}) {\n        return this.animate(element, this.effects.fadeOut(), {\n            duration: 300,\n            easing: this.easings.easeIn,\n            ...options\n        });\n    }\n    \n    slideIn(element, direction = 'up', options = {}) {\n        const effectMap = {\n            up: 'slideInUp',\n            down: 'slideInDown',\n            left: 'slideInLeft',\n            right: 'slideInRight'\n        };\n        \n        return this.animate(element, this.effects[effectMap[direction]](), {\n            duration: 400,\n            easing: this.easings.easeOutBack,\n            ...options\n        });\n    }\n    \n    bounce(element, options = {}) {\n        return this.animate(element, this.effects.bounce(), {\n            duration: 600,\n            easing: this.easings.easeInOut,\n            ...options\n        });\n    }\n    \n    pulse(element, options = {}) {\n        return this.animate(element, this.effects.pulse(), {\n            duration: 600,\n            easing: this.easings.easeInOut,\n            iterations: Infinity,\n            ...options\n        });\n    }\n    \n    /**\n     * Animation groups - animate multiple elements together\n     */\n    group(animations, options = {}) {\n        const groupId = this.generateId('group');\n        const animationPromises = [];\n        \n        animations.forEach(({ element, keyframes, animationOptions = {} }) => {\n            const animation = this.animate(element, keyframes, {\n                ...animationOptions,\n                ...options\n            });\n            \n            if (animation && animation.finished) {\n                animationPromises.push(animation.finished);\n            }\n        });\n        \n        const groupController = {\n            id: groupId,\n            finished: Promise.all(animationPromises),\n            play: () => {\n                animations.forEach(anim => {\n                    if (anim.animation) anim.animation.play();\n                });\n            },\n            pause: () => {\n                animations.forEach(anim => {\n                    if (anim.animation) anim.animation.pause();\n                });\n            },\n            reverse: () => {\n                animations.forEach(anim => {\n                    if (anim.animation) anim.animation.reverse();\n                });\n            },\n            cancel: () => {\n                animations.forEach(anim => {\n                    if (anim.animation) anim.animation.cancel();\n                });\n            }\n        };\n        \n        this.animationGroups.set(groupId, groupController);\n        return groupController;\n    }\n    \n    /**\n     * Staggered animations - animate elements with delay\n     */\n    stagger(elements, keyframes, options = {}) {\n        const staggerDelay = options.staggerDelay || 100;\n        const animations = [];\n        \n        elements.forEach((element, index) => {\n            const delay = index * staggerDelay;\n            const animation = this.animate(element, keyframes, {\n                ...options,\n                delay\n            });\n            animations.push({ element, animation });\n        });\n        \n        return this.group(animations.map(({ element, animation }) => ({\n            element,\n            keyframes,\n            animation\n        })));\n    }\n    \n    /**\n     * Timeline animations - sequence animations\n     */\n    timeline(sequence) {\n        const timelineId = this.generateId('timeline');\n        let currentTime = 0;\n        const animations = [];\n        \n        sequence.forEach(step => {\n            const delay = step.at !== undefined ? step.at : currentTime;\n            const animation = this.animate(step.element, step.keyframes, {\n                ...step.options,\n                delay\n            });\n            \n            animations.push(animation);\n            \n            if (step.at === undefined) {\n                currentTime += step.options?.duration || this.defaultDuration;\n            }\n        });\n        \n        return {\n            id: timelineId,\n            animations,\n            finished: Promise.all(animations.map(a => a.finished)),\n            play: () => animations.forEach(a => a.play()),\n            pause: () => animations.forEach(a => a.pause()),\n            reverse: () => animations.forEach(a => a.reverse()),\n            cancel: () => animations.forEach(a => a.cancel())\n        };\n    }\n    \n    /**\n     * Scroll-triggered animations\n     */\n    onScroll(element, keyframes, options = {}) {\n        const scrollTrigger = options.trigger || element;\n        const startOffset = options.start || 0;\n        const endOffset = options.end || 1;\n        \n        const observer = new IntersectionObserver((entries) => {\n            entries.forEach(entry => {\n                if (entry.isIntersecting) {\n                    const progress = Math.min(Math.max(\n                        (entry.intersectionRatio - startOffset) / (endOffset - startOffset),\n                        0\n                    ), 1);\n                    \n                    if (progress >= 0) {\n                        this.animate(element, keyframes, {\n                            ...options,\n                            duration: options.duration || this.defaultDuration\n                        });\n                    }\n                }\n            });\n        }, {\n            threshold: this.createThresholdArray(20)\n        });\n        \n        observer.observe(scrollTrigger);\n        \n        return {\n            observer,\n            disconnect: () => observer.disconnect()\n        };\n    }\n    \n    // Helper methods\n    \n    enhanceAnimation(animation, id, metadata) {\n        return {\n            id,\n            animation,\n            metadata,\n            \n            // Enhanced controls\n            play: () => animation.play(),\n            pause: () => animation.pause(),\n            reverse: () => animation.reverse(),\n            cancel: () => animation.cancel(),\n            finish: () => animation.finish(),\n            \n            // Properties\n            get currentTime() { return animation.currentTime; },\n            set currentTime(time) { animation.currentTime = time; },\n            \n            get playbackRate() { return animation.playbackRate; },\n            set playbackRate(rate) { animation.playbackRate = rate; },\n            \n            get playState() { return animation.playState; },\n            get finished() { return animation.finished; },\n            \n            // Enhanced methods\n            seek(progress) {\n                animation.currentTime = animation.effect.getTiming().duration * progress;\n            },\n            \n            setProgress(progress) {\n                this.seek(Math.max(0, Math.min(1, progress)));\n            },\n            \n            onFinish(callback) {\n                animation.addEventListener('finish', callback);\n            },\n            \n            onCancel(callback) {\n                animation.addEventListener('cancel', callback);\n            }\n        };\n    }\n    \n    fallbackAnimate(element, keyframes, options, id) {\n        Logger.info('[AnimationManager] Using CSS fallback animation');\n        \n        // Simple CSS transition fallback\n        const finalFrame = keyframes[keyframes.length - 1];\n        element.style.transition = `all ${options.duration}ms ${options.easing}`;\n        \n        // Apply final styles\n        Object.assign(element.style, finalFrame);\n        \n        // Return promise-like object\n        return {\n            id,\n            finished: new Promise(resolve => setTimeout(resolve, options.duration)),\n            play: () => {},\n            pause: () => {},\n            cancel: () => {\n                element.style.transition = '';\n            }\n        };\n    }\n    \n    generateId(prefix = 'anim') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    createThresholdArray(steps) {\n        const thresholds = [];\n        for (let i = 0; i <= steps; i++) {\n            thresholds.push(i / steps);\n        }\n        return thresholds;\n    }\n    \n    /**\n     * Get all active animations\n     */\n    getActiveAnimations() {\n        return Array.from(this.activeAnimations.entries()).map(([id, animation]) => ({\n            id,\n            playState: animation.playState,\n            currentTime: animation.currentTime,\n            metadata: animation.metadata\n        }));\n    }\n    \n    /**\n     * Cancel all active animations\n     */\n    cancelAll() {\n        this.activeAnimations.forEach(animation => {\n            animation.cancel();\n        });\n        this.activeAnimations.clear();\n        Logger.info('[AnimationManager] All animations cancelled');\n    }\n    \n    /**\n     * Pause all active animations\n     */\n    pauseAll() {\n        this.activeAnimations.forEach(animation => {\n            animation.pause();\n        });\n        Logger.info('[AnimationManager] All animations paused');\n    }\n    \n    /**\n     * Resume all paused animations\n     */\n    resumeAll() {\n        this.activeAnimations.forEach(animation => {\n            if (animation.playState === 'paused') {\n                animation.play();\n            }\n        });\n        Logger.info('[AnimationManager] All animations resumed');\n    }\n}","// modules/api-manager/WorkerManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Worker APIs Manager - Web Workers, Service Workers, Shared Workers\n */\nexport class WorkerManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.activeWorkers = new Map();\n        this.messageHandlers = new Map();\n        this.workerScripts = new Map();\n        \n        // Check API support\n        this.support = {\n            webWorkers: 'Worker' in window,\n            serviceWorker: 'serviceWorker' in navigator,\n            sharedWorker: 'SharedWorker' in window,\n            offscreenCanvas: 'OffscreenCanvas' in window\n        };\n        \n        Logger.info('[WorkerManager] Initialized with support:', this.support);\n    }\n    \n    /**\n     * Web Workers for background processing\n     */\n    web = {\n        // Create a new Web Worker\n        create: (script, options = {}) => {\n            if (!this.support.webWorkers) {\n                throw new Error('Web Workers not supported');\n            }\n            \n            let worker;\n            const workerId = this.generateId('worker');\n            \n            try {\n                // Handle different script types\n                if (typeof script === 'string') {\n                    // URL string\n                    worker = new Worker(script, options);\n                } else if (typeof script === 'function') {\n                    // Function to blob\n                    const blob = this.createWorkerBlob(script);\n                    worker = new Worker(URL.createObjectURL(blob), options);\n                } else if (script instanceof Blob) {\n                    // Blob directly\n                    worker = new Worker(URL.createObjectURL(script), options);\n                } else {\n                    throw new Error('Invalid script type');\n                }\n                \n                // Enhanced worker wrapper\n                const workerWrapper = {\n                    id: workerId,\n                    worker,\n                    \n                    // Send message to worker\n                    send: (message, transfer = null) => {\n                        if (transfer) {\n                            worker.postMessage(message, transfer);\n                        } else {\n                            worker.postMessage(message);\n                        }\n                        Logger.info(`[WorkerManager] Message sent to worker: ${workerId}`);\n                    },\n                    \n                    // Listen for messages\n                    onMessage: (callback) => {\n                        worker.addEventListener('message', (event) => {\n                            callback(event.data, event);\n                        });\n                    },\n                    \n                    // Handle errors\n                    onError: (callback) => {\n                        worker.addEventListener('error', callback);\n                        worker.addEventListener('messageerror', callback);\n                    },\n                    \n                    // Terminate worker\n                    terminate: () => {\n                        worker.terminate();\n                        this.activeWorkers.delete(workerId);\n                        Logger.info(`[WorkerManager] Worker terminated: ${workerId}`);\n                    },\n                    \n                    // Execute function in worker\n                    execute: (fn, data = null) => {\n                        return new Promise((resolve, reject) => {\n                            const messageId = this.generateId('msg');\n                            \n                            const handler = (event) => {\n                                if (event.data.id === messageId) {\n                                    worker.removeEventListener('message', handler);\n                                    \n                                    if (event.data.error) {\n                                        reject(new Error(event.data.error));\n                                    } else {\n                                        resolve(event.data.result);\n                                    }\n                                }\n                            };\n                            \n                            worker.addEventListener('message', handler);\n                            \n                            worker.postMessage({\n                                id: messageId,\n                                type: 'execute',\n                                function: fn.toString(),\n                                data\n                            });\n                            \n                            // Timeout after 30 seconds\n                            setTimeout(() => {\n                                worker.removeEventListener('message', handler);\n                                reject(new Error('Worker execution timeout'));\n                            }, 30000);\n                        });\n                    }\n                };\n                \n                this.activeWorkers.set(workerId, workerWrapper);\n                Logger.info(`[WorkerManager] Web Worker created: ${workerId}`);\n                \n                return workerWrapper;\n                \n            } catch (error) {\n                Logger.error('[WorkerManager] Worker creation failed:', error);\n                throw error;\n            }\n        },\n        \n        // Create worker pool for parallel processing\n        createPool: (script, poolSize = navigator.hardwareConcurrency || 4, options = {}) => {\n            const workers = [];\n            \n            for (let i = 0; i < poolSize; i++) {\n                workers.push(this.web.create(script, options));\n            }\n            \n            let currentWorker = 0;\n            \n            const pool = {\n                workers,\n                \n                // Execute task on next available worker\n                execute: async (fn, data = null) => {\n                    const worker = workers[currentWorker];\n                    currentWorker = (currentWorker + 1) % workers.length;\n                    \n                    return worker.execute(fn, data);\n                },\n                \n                // Broadcast message to all workers\n                broadcast: (message) => {\n                    workers.forEach(worker => {\n                        worker.send(message);\n                    });\n                },\n                \n                // Terminate all workers\n                terminate: () => {\n                    workers.forEach(worker => {\n                        worker.terminate();\n                    });\n                    workers.length = 0;\n                    Logger.info('[WorkerManager] Worker pool terminated');\n                }\n            };\n            \n            Logger.info(`[WorkerManager] Worker pool created with ${poolSize} workers`);\n            return pool;\n        },\n        \n        // Common worker tasks\n        tasks: {\n            // Heavy computation\n            compute: (fn, data) => {\n                const workerCode = `\n                    self.addEventListener('message', function(e) {\n                        const { id, function: fnString, data } = e.data;\n                        \n                        try {\n                            const fn = new Function('return ' + fnString)();\n                            const result = fn(data);\n                            self.postMessage({ id, result });\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                `;\n                \n                const worker = this.web.create(workerCode);\n                return worker.execute(fn, data);\n            },\n            \n            // Image processing\n            processImage: (imageData, filters) => {\n                const workerCode = `\n                    self.addEventListener('message', function(e) {\n                        const { id, data: { imageData, filters } } = e.data;\n                        \n                        try {\n                            const pixels = imageData.data;\n                            \n                            for (let i = 0; i < pixels.length; i += 4) {\n                                // Apply filters\n                                if (filters.brightness) {\n                                    pixels[i] *= filters.brightness;     // R\n                                    pixels[i + 1] *= filters.brightness; // G\n                                    pixels[i + 2] *= filters.brightness; // B\n                                }\n                                \n                                if (filters.contrast) {\n                                    const factor = (259 * (filters.contrast * 255 + 255)) / (255 * (259 - filters.contrast * 255));\n                                    pixels[i] = factor * (pixels[i] - 128) + 128;\n                                    pixels[i + 1] = factor * (pixels[i + 1] - 128) + 128;\n                                    pixels[i + 2] = factor * (pixels[i + 2] - 128) + 128;\n                                }\n                                \n                                if (filters.grayscale) {\n                                    const gray = 0.299 * pixels[i] + 0.587 * pixels[i + 1] + 0.114 * pixels[i + 2];\n                                    pixels[i] = gray;\n                                    pixels[i + 1] = gray;\n                                    pixels[i + 2] = gray;\n                                }\n                            }\n                            \n                            self.postMessage({ id, result: imageData }, [imageData.data.buffer]);\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                `;\n                \n                const worker = this.web.create(workerCode);\n                return worker.execute(null, { imageData, filters });\n            },\n            \n            // Data processing\n            processData: (data, processor) => {\n                const workerCode = `\n                    self.addEventListener('message', function(e) {\n                        const { id, data, function: processorString } = e.data;\n                        \n                        try {\n                            const processor = new Function('return ' + processorString)();\n                            const result = data.map(processor);\n                            self.postMessage({ id, result });\n                        } catch (error) {\n                            self.postMessage({ id, error: error.message });\n                        }\n                    });\n                `;\n                \n                const worker = this.web.create(workerCode);\n                return worker.execute(processor, data);\n            }\n        }\n    };\n    \n    /**\n     * Service Workers for caching and background sync\n     */\n    service = {\n        // Register service worker\n        register: async (scriptURL, options = {}) => {\n            if (!this.support.serviceWorker) {\n                throw new Error('Service Worker not supported');\n            }\n            \n            try {\n                const registration = await navigator.serviceWorker.register(scriptURL, options);\n                \n                Logger.info('[WorkerManager] Service Worker registered:', scriptURL);\n                \n                // Enhanced registration wrapper\n                return {\n                    registration,\n                    scope: registration.scope,\n                    \n                    // Update service worker\n                    update: () => registration.update(),\n                    \n                    // Unregister service worker\n                    unregister: () => registration.unregister(),\n                    \n                    // Send message to service worker\n                    postMessage: (message) => {\n                        if (registration.active) {\n                            registration.active.postMessage(message);\n                        }\n                    },\n                    \n                    // Listen for updates\n                    onUpdate: (callback) => {\n                        registration.addEventListener('updatefound', () => {\n                            const newWorker = registration.installing;\n                            \n                            newWorker.addEventListener('statechange', () => {\n                                if (newWorker.state === 'installed' && navigator.serviceWorker.controller) {\n                                    callback(newWorker);\n                                }\n                            });\n                        });\n                    },\n                    \n                    // Check for updates\n                    checkForUpdates: () => {\n                        return registration.update();\n                    }\n                };\n            } catch (error) {\n                Logger.error('[WorkerManager] Service Worker registration failed:', error);\n                throw error;\n            }\n        },\n        \n        // Get registration\n        getRegistration: async (scope = '/') => {\n            if (!this.support.serviceWorker) {\n                return null;\n            }\n            \n            try {\n                return await navigator.serviceWorker.getRegistration(scope);\n            } catch (error) {\n                Logger.error('[WorkerManager] Get registration failed:', error);\n                return null;\n            }\n        },\n        \n        // Get all registrations\n        getRegistrations: async () => {\n            if (!this.support.serviceWorker) {\n                return [];\n            }\n            \n            try {\n                return await navigator.serviceWorker.getRegistrations();\n            } catch (error) {\n                Logger.error('[WorkerManager] Get registrations failed:', error);\n                return [];\n            }\n        }\n    };\n    \n    /**\n     * Shared Workers for cross-tab communication\n     */\n    shared = {\n        // Create shared worker\n        create: (script, options = {}) => {\n            if (!this.support.sharedWorker) {\n                throw new Error('Shared Worker not supported');\n            }\n            \n            try {\n                const sharedWorker = new SharedWorker(script, options);\n                const port = sharedWorker.port;\n                const workerId = this.generateId('shared');\n                \n                // Start the port\n                port.start();\n                \n                const workerWrapper = {\n                    id: workerId,\n                    worker: sharedWorker,\n                    port,\n                    \n                    // Send message\n                    send: (message, transfer = null) => {\n                        if (transfer) {\n                            port.postMessage(message, transfer);\n                        } else {\n                            port.postMessage(message);\n                        }\n                    },\n                    \n                    // Listen for messages\n                    onMessage: (callback) => {\n                        port.addEventListener('message', (event) => {\n                            callback(event.data, event);\n                        });\n                    },\n                    \n                    // Handle errors\n                    onError: (callback) => {\n                        sharedWorker.addEventListener('error', callback);\n                        port.addEventListener('messageerror', callback);\n                    },\n                    \n                    // Close connection\n                    close: () => {\n                        port.close();\n                        this.activeWorkers.delete(workerId);\n                        Logger.info(`[WorkerManager] Shared Worker closed: ${workerId}`);\n                    }\n                };\n                \n                this.activeWorkers.set(workerId, workerWrapper);\n                Logger.info(`[WorkerManager] Shared Worker created: ${workerId}`);\n                \n                return workerWrapper;\n            } catch (error) {\n                Logger.error('[WorkerManager] Shared Worker creation failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    /**\n     * Offscreen Canvas for worker-based rendering\n     */\n    offscreen = {\n        // Create offscreen canvas worker\n        create: (canvas, workerScript = null) => {\n            if (!this.support.offscreenCanvas) {\n                throw new Error('Offscreen Canvas not supported');\n            }\n            \n            try {\n                const offscreenCanvas = canvas.transferControlToOffscreen();\n                \n                const defaultWorkerScript = `\n                    self.addEventListener('message', function(e) {\n                        const { canvas, type, data } = e.data;\n                        \n                        if (type === 'init') {\n                            self.canvas = canvas;\n                            self.ctx = canvas.getContext('2d');\n                        }\n                        \n                        if (type === 'draw' && self.ctx) {\n                            // Basic drawing operations\n                            const { operations } = data;\n                            \n                            operations.forEach(op => {\n                                switch (op.type) {\n                                    case 'fillRect':\n                                        self.ctx.fillRect(...op.args);\n                                        break;\n                                    case 'strokeRect':\n                                        self.ctx.strokeRect(...op.args);\n                                        break;\n                                    case 'fillText':\n                                        self.ctx.fillText(...op.args);\n                                        break;\n                                    case 'setFillStyle':\n                                        self.ctx.fillStyle = op.value;\n                                        break;\n                                    case 'setStrokeStyle':\n                                        self.ctx.strokeStyle = op.value;\n                                        break;\n                                }\n                            });\n                        }\n                    });\n                `;\n                \n                const script = workerScript || defaultWorkerScript;\n                const worker = this.web.create(script);\n                \n                // Initialize worker with canvas\n                worker.send({\n                    type: 'init',\n                    canvas: offscreenCanvas\n                }, [offscreenCanvas]);\n                \n                return {\n                    worker,\n                    \n                    // Draw operations\n                    draw: (operations) => {\n                        worker.send({\n                            type: 'draw',\n                            data: { operations }\n                        });\n                    },\n                    \n                    // Send custom message\n                    send: (message) => worker.send(message),\n                    \n                    // Listen for messages\n                    onMessage: (callback) => worker.onMessage(callback),\n                    \n                    // Terminate worker\n                    terminate: () => worker.terminate()\n                };\n                \n            } catch (error) {\n                Logger.error('[WorkerManager] Offscreen Canvas creation failed:', error);\n                throw error;\n            }\n        }\n    };\n    \n    // Helper methods\n    \n    createWorkerBlob(fn) {\n        const code = `\n            (function() {\n                const workerFunction = ${fn.toString()};\n                \n                if (typeof workerFunction === 'function') {\n                    // If function expects to be called immediately\n                    if (workerFunction.length === 0) {\n                        workerFunction();\n                    }\n                }\n                \n                // Standard worker message handling\n                self.addEventListener('message', function(e) {\n                    if (e.data.type === 'execute' && e.data.function) {\n                        try {\n                            const fn = new Function('return ' + e.data.function)();\n                            const result = fn(e.data.data);\n                            self.postMessage({ \n                                id: e.data.id, \n                                result \n                            });\n                        } catch (error) {\n                            self.postMessage({ \n                                id: e.data.id, \n                                error: error.message \n                            });\n                        }\n                    }\n                });\n            })();\n        `;\n        \n        return new Blob([code], { type: 'application/javascript' });\n    }\n    \n    generateId(prefix = 'worker') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    /**\n     * Terminate all active workers\n     */\n    terminateAll() {\n        this.activeWorkers.forEach(worker => {\n            if (worker.terminate) {\n                worker.terminate();\n            } else if (worker.close) {\n                worker.close();\n            }\n        });\n        this.activeWorkers.clear();\n        Logger.info('[WorkerManager] All workers terminated');\n    }\n    \n    /**\n     * Get worker statistics\n     */\n    getStats() {\n        const workers = Array.from(this.activeWorkers.values());\n        \n        return {\n            total: workers.length,\n            byType: workers.reduce((acc, worker) => {\n                const type = worker.id.split('_')[0];\n                acc[type] = (acc[type] || 0) + 1;\n                return acc;\n            }, {}),\n            support: this.support,\n            hardwareConcurrency: navigator.hardwareConcurrency || 'unknown'\n        };\n    }\n    \n    /**\n     * Create common worker utilities\n     */\n    utils = {\n        // Benchmark function performance\n        benchmark: async (fn, data, iterations = 1000) => {\n            const worker = this.web.create(() => {\n                self.addEventListener('message', (e) => {\n                    const { id, function: fnString, data, iterations } = e.data;\n                    \n                    try {\n                        const fn = new Function('return ' + fnString)();\n                        const start = performance.now();\n                        \n                        for (let i = 0; i < iterations; i++) {\n                            fn(data);\n                        }\n                        \n                        const end = performance.now();\n                        const totalTime = end - start;\n                        const avgTime = totalTime / iterations;\n                        \n                        self.postMessage({\n                            id,\n                            result: {\n                                totalTime,\n                                avgTime,\n                                iterations,\n                                opsPerSecond: 1000 / avgTime\n                            }\n                        });\n                    } catch (error) {\n                        self.postMessage({ id, error: error.message });\n                    }\n                });\n            });\n            \n            const result = await worker.execute(fn, data, iterations);\n            worker.terminate();\n            \n            return result;\n        },\n        \n        // Parallel array processing\n        parallelMap: async (array, fn, chunkSize = null) => {\n            const chunks = chunkSize || Math.ceil(array.length / (navigator.hardwareConcurrency || 4));\n            const pool = this.web.createPool(() => {\n                self.addEventListener('message', (e) => {\n                    const { id, data: { chunk, function: fnString } } = e.data;\n                    \n                    try {\n                        const fn = new Function('return ' + fnString)();\n                        const result = chunk.map(fn);\n                        self.postMessage({ id, result });\n                    } catch (error) {\n                        self.postMessage({ id, error: error.message });\n                    }\n                });\n            });\n            \n            const promises = [];\n            \n            for (let i = 0; i < array.length; i += chunks) {\n                const chunk = array.slice(i, i + chunks);\n                promises.push(pool.execute(fn, chunk));\n            }\n            \n            const results = await Promise.all(promises);\n            pool.terminate();\n            \n            return results.flat();\n        }\n    };\n}","// modules/api-manager/PerformanceManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Performance APIs Manager - Timing, Metrics, Observers, Optimization\n */\nexport class PerformanceManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.marks = new Map();\n        this.measures = new Map();\n        this.observers = new Map();\n        this.metrics = new Map();\n        this.thresholds = {\n            fcp: 2000,  // First Contentful Paint\n            lcp: 2500,  // Largest Contentful Paint\n            fid: 100,   // First Input Delay\n            cls: 0.1,   // Cumulative Layout Shift\n            ...config.thresholds\n        };\n        \n        // Check API support\n        this.support = {\n            performance: 'performance' in window,\n            timing: 'timing' in (window.performance || {}),\n            navigation: 'navigation' in (window.performance || {}),\n            observer: 'PerformanceObserver' in window,\n            memory: 'memory' in (window.performance || {}),\n            userTiming: 'mark' in (window.performance || {}),\n            resourceTiming: 'getEntriesByType' in (window.performance || {}),\n            paintTiming: 'PerformanceObserver' in window && PerformanceObserver.supportedEntryTypes?.includes('paint'),\n            layoutInstability: 'PerformanceObserver' in window && PerformanceObserver.supportedEntryTypes?.includes('layout-shift'),\n            longTask: 'PerformanceObserver' in window && PerformanceObserver.supportedEntryTypes?.includes('longtask')\n        };\n        \n        Logger.info('[PerformanceManager] Initialized with support:', this.support);\n        \n        // Auto-start core metrics collection\n        this.startCoreMetrics();\n    }\n    \n    /**\n     * User Timing API - Marks and Measures\n     */\n    timing = {\n        // Create performance mark\n        mark: (name, options = {}) => {\n            if (!this.support.userTiming) {\n                Logger.warn('[PerformanceManager] User Timing not supported');\n                return null;\n            }\n            \n            try {\n                performance.mark(name, options);\n                this.marks.set(name, {\n                    name,\n                    timestamp: performance.now(),\n                    options\n                });\n                \n                Logger.info(`[PerformanceManager] Mark created: ${name}`);\n                return this.marks.get(name);\n            } catch (error) {\n                Logger.error('[PerformanceManager] Mark creation failed:', error);\n                return null;\n            }\n        },\n        \n        // Create performance measure\n        measure: (name, startMark, endMark, options = {}) => {\n            if (!this.support.userTiming) {\n                Logger.warn('[PerformanceManager] User Timing not supported');\n                return null;\n            }\n            \n            try {\n                performance.measure(name, startMark, endMark, options);\n                const entry = performance.getEntriesByName(name, 'measure')[0];\n                \n                const measure = {\n                    name,\n                    startTime: entry.startTime,\n                    duration: entry.duration,\n                    startMark,\n                    endMark,\n                    options\n                };\n                \n                this.measures.set(name, measure);\n                Logger.info(`[PerformanceManager] Measure created: ${name} (${measure.duration.toFixed(2)}ms)`);\n                \n                return measure;\n            } catch (error) {\n                Logger.error('[PerformanceManager] Measure creation failed:', error);\n                return null;\n            }\n        },\n        \n        // Clear marks and measures\n        clear: (name = null) => {\n            if (!this.support.userTiming) return;\n            \n            try {\n                if (name) {\n                    performance.clearMarks(name);\n                    performance.clearMeasures(name);\n                    this.marks.delete(name);\n                    this.measures.delete(name);\n                } else {\n                    performance.clearMarks();\n                    performance.clearMeasures();\n                    this.marks.clear();\n                    this.measures.clear();\n                }\n                \n                Logger.info(`[PerformanceManager] Cleared: ${name || 'all'}`);\n            } catch (error) {\n                Logger.error('[PerformanceManager] Clear failed:', error);\n            }\n        },\n        \n        // Get all marks\n        getMarks: () => {\n            if (!this.support.userTiming) return [];\n            return Array.from(this.marks.values());\n        },\n        \n        // Get all measures\n        getMeasures: () => {\n            if (!this.support.userTiming) return [];\n            return Array.from(this.measures.values());\n        }\n    };\n    \n    /**\n     * Navigation Timing API\n     */\n    navigation = {\n        // Get navigation timing data\n        get: () => {\n            if (!this.support.navigation) {\n                return this.getLegacyNavigationTiming();\n            }\n            \n            try {\n                const entry = performance.getEntriesByType('navigation')[0];\n                if (!entry) return null;\n                \n                return {\n                    // Navigation phases\n                    redirect: entry.redirectEnd - entry.redirectStart,\n                    dns: entry.domainLookupEnd - entry.domainLookupStart,\n                    connect: entry.connectEnd - entry.connectStart,\n                    ssl: entry.connectEnd - entry.secureConnectionStart,\n                    ttfb: entry.responseStart - entry.requestStart, // Time to First Byte\n                    download: entry.responseEnd - entry.responseStart,\n                    domProcessing: entry.domContentLoadedEventStart - entry.responseEnd,\n                    domComplete: entry.domComplete - entry.domContentLoadedEventStart,\n                    loadComplete: entry.loadEventEnd - entry.loadEventStart,\n                    \n                    // Total times\n                    totalTime: entry.loadEventEnd - entry.startTime,\n                    \n                    // Enhanced metrics\n                    navigationStart: entry.startTime,\n                    unloadTime: entry.unloadEventEnd - entry.unloadEventStart,\n                    redirectCount: entry.redirectCount,\n                    transferSize: entry.transferSize,\n                    encodedBodySize: entry.encodedBodySize,\n                    decodedBodySize: entry.decodedBodySize,\n                    \n                    // Connection info\n                    connectionInfo: {\n                        nextHopProtocol: entry.nextHopProtocol,\n                        renderBlockingStatus: entry.renderBlockingStatus\n                    }\n                };\n            } catch (error) {\n                Logger.error('[PerformanceManager] Navigation timing failed:', error);\n                return null;\n            }\n        },\n        \n        // Get performance insights\n        getInsights: () => {\n            const timing = this.navigation.get();\n            if (!timing) return null;\n            \n            return {\n                insights: {\n                    serverResponseTime: this.getInsight('ttfb', timing.ttfb, 200, 500),\n                    domProcessing: this.getInsight('domProcessing', timing.domProcessing, 500, 1000),\n                    totalLoadTime: this.getInsight('totalTime', timing.totalTime, 2000, 4000),\n                    transferEfficiency: this.getTransferEfficiency(timing)\n                },\n                recommendations: this.getNavigationRecommendations(timing)\n            };\n        }\n    };\n    \n    /**\n     * Resource Timing API\n     */\n    resources = {\n        // Get resource timing data\n        get: (type = null) => {\n            if (!this.support.resourceTiming) {\n                Logger.warn('[PerformanceManager] Resource Timing not supported');\n                return [];\n            }\n            \n            try {\n                const entries = performance.getEntriesByType('resource');\n                const resources = entries.map(entry => ({\n                    name: entry.name,\n                    type: this.getResourceType(entry),\n                    startTime: entry.startTime,\n                    duration: entry.duration,\n                    size: {\n                        transfer: entry.transferSize,\n                        encoded: entry.encodedBodySize,\n                        decoded: entry.decodedBodySize\n                    },\n                    timing: {\n                        redirect: entry.redirectEnd - entry.redirectStart,\n                        dns: entry.domainLookupEnd - entry.domainLookupStart,\n                        connect: entry.connectEnd - entry.connectStart,\n                        ssl: entry.connectEnd - entry.secureConnectionStart,\n                        ttfb: entry.responseStart - entry.requestStart,\n                        download: entry.responseEnd - entry.responseStart\n                    },\n                    protocol: entry.nextHopProtocol,\n                    cached: entry.transferSize === 0 && entry.decodedBodySize > 0\n                }));\n                \n                return type ? resources.filter(r => r.type === type) : resources;\n            } catch (error) {\n                Logger.error('[PerformanceManager] Resource timing failed:', error);\n                return [];\n            }\n        },\n        \n        // Get resource performance summary\n        getSummary: () => {\n            const resources = this.resources.get();\n            \n            const summary = {\n                total: resources.length,\n                types: {},\n                totalSize: 0,\n                totalDuration: 0,\n                cached: 0,\n                slowResources: []\n            };\n            \n            resources.forEach(resource => {\n                const type = resource.type;\n                if (!summary.types[type]) {\n                    summary.types[type] = { count: 0, size: 0, duration: 0 };\n                }\n                \n                summary.types[type].count++;\n                summary.types[type].size += resource.size.transfer;\n                summary.types[type].duration += resource.duration;\n                \n                summary.totalSize += resource.size.transfer;\n                summary.totalDuration += resource.duration;\n                \n                if (resource.cached) summary.cached++;\n                if (resource.duration > 1000) summary.slowResources.push(resource);\n            });\n            \n            return summary;\n        }\n    };\n    \n    /**\n     * Core Web Vitals monitoring\n     */\n    vitals = {\n        // Start monitoring Core Web Vitals\n        start: (callback = null) => {\n            const vitalsData = {};\n            \n            // First Contentful Paint\n            this.observePaint((entries) => {\n                entries.forEach(entry => {\n                    if (entry.name === 'first-contentful-paint') {\n                        vitalsData.fcp = entry.startTime;\n                        this.checkThreshold('fcp', entry.startTime);\n                        if (callback) callback('fcp', entry.startTime);\n                    }\n                });\n            });\n            \n            // Largest Contentful Paint\n            this.observeLCP((entries) => {\n                entries.forEach(entry => {\n                    vitalsData.lcp = entry.startTime;\n                    this.checkThreshold('lcp', entry.startTime);\n                    if (callback) callback('lcp', entry.startTime);\n                });\n            });\n            \n            // First Input Delay\n            this.observeFID((entries) => {\n                entries.forEach(entry => {\n                    vitalsData.fid = entry.processingStart - entry.startTime;\n                    this.checkThreshold('fid', vitalsData.fid);\n                    if (callback) callback('fid', vitalsData.fid);\n                });\n            });\n            \n            // Cumulative Layout Shift\n            this.observeCLS((entries) => {\n                let cls = 0;\n                entries.forEach(entry => {\n                    if (!entry.hadRecentInput) {\n                        cls += entry.value;\n                    }\n                });\n                vitalsData.cls = cls;\n                this.checkThreshold('cls', cls);\n                if (callback) callback('cls', cls);\n            });\n            \n            return vitalsData;\n        },\n        \n        // Get current vitals\n        get: () => {\n            return {\n                fcp: this.getMetric('fcp'),\n                lcp: this.getMetric('lcp'),\n                fid: this.getMetric('fid'),\n                cls: this.getMetric('cls'),\n                ratings: {\n                    fcp: this.getRating('fcp', this.getMetric('fcp')),\n                    lcp: this.getRating('lcp', this.getMetric('lcp')),\n                    fid: this.getRating('fid', this.getMetric('fid')),\n                    cls: this.getRating('cls', this.getMetric('cls'))\n                }\n            };\n        }\n    };\n    \n    /**\n     * Memory monitoring\n     */\n    memory = {\n        // Get memory usage\n        get: () => {\n            if (!this.support.memory) {\n                Logger.warn('[PerformanceManager] Memory API not supported');\n                return null;\n            }\n            \n            try {\n                const memory = performance.memory;\n                return {\n                    used: memory.usedJSHeapSize,\n                    total: memory.totalJSHeapSize,\n                    limit: memory.jsHeapSizeLimit,\n                    percentage: (memory.usedJSHeapSize / memory.jsHeapSizeLimit) * 100,\n                    formatted: {\n                        used: this.formatBytes(memory.usedJSHeapSize),\n                        total: this.formatBytes(memory.totalJSHeapSize),\n                        limit: this.formatBytes(memory.jsHeapSizeLimit)\n                    }\n                };\n            } catch (error) {\n                Logger.error('[PerformanceManager] Memory get failed:', error);\n                return null;\n            }\n        },\n        \n        // Monitor memory usage\n        monitor: (callback, interval = 5000) => {\n            if (!this.support.memory) return null;\n            \n            const intervalId = setInterval(() => {\n                const memoryData = this.memory.get();\n                if (memoryData) {\n                    callback(memoryData);\n                    \n                    // Warn if memory usage is high\n                    if (memoryData.percentage > 80) {\n                        Logger.warn('[PerformanceManager] High memory usage detected:', memoryData.percentage.toFixed(1) + '%');\n                    }\n                }\n            }, interval);\n            \n            return {\n                stop: () => clearInterval(intervalId)\n            };\n        }\n    };\n    \n    /**\n     * Long Task monitoring\n     */\n    longTasks = {\n        // Start monitoring long tasks\n        start: (callback = null) => {\n            if (!this.support.longTask) {\n                Logger.warn('[PerformanceManager] Long Task API not supported');\n                return null;\n            }\n            \n            try {\n                const observer = new PerformanceObserver((list) => {\n                    list.getEntries().forEach(entry => {\n                        const taskInfo = {\n                            duration: entry.duration,\n                            startTime: entry.startTime,\n                            name: entry.name,\n                            attribution: entry.attribution || []\n                        };\n                        \n                        Logger.warn('[PerformanceManager] Long task detected:', taskInfo);\n                        if (callback) callback(taskInfo);\n                    });\n                });\n                \n                observer.observe({ entryTypes: ['longtask'] });\n                \n                const observerId = this.generateId('longtask');\n                this.observers.set(observerId, observer);\n                \n                return {\n                    id: observerId,\n                    stop: () => {\n                        observer.disconnect();\n                        this.observers.delete(observerId);\n                    }\n                };\n            } catch (error) {\n                Logger.error('[PerformanceManager] Long task monitoring failed:', error);\n                return null;\n            }\n        }\n    };\n    \n    /**\n     * Performance optimization utilities\n     */\n    optimize = {\n        // Defer non-critical JavaScript\n        deferScript: (src, callback = null) => {\n            const script = document.createElement('script');\n            script.src = src;\n            script.defer = true;\n            if (callback) script.onload = callback;\n            document.head.appendChild(script);\n            return script;\n        },\n        \n        // Preload critical resources\n        preload: (href, as, crossorigin = false) => {\n            const link = document.createElement('link');\n            link.rel = 'preload';\n            link.href = href;\n            link.as = as;\n            if (crossorigin) link.crossOrigin = 'anonymous';\n            document.head.appendChild(link);\n            return link;\n        },\n        \n        // Prefetch future resources\n        prefetch: (href) => {\n            const link = document.createElement('link');\n            link.rel = 'prefetch';\n            link.href = href;\n            document.head.appendChild(link);\n            return link;\n        },\n        \n        // Optimize images with lazy loading\n        lazyImages: (selector = 'img[data-src]') => {\n            if ('IntersectionObserver' in window) {\n                const images = document.querySelectorAll(selector);\n                const imageObserver = new IntersectionObserver((entries) => {\n                    entries.forEach(entry => {\n                        if (entry.isIntersecting) {\n                            const img = entry.target;\n                            img.src = img.dataset.src;\n                            img.classList.remove('lazy');\n                            imageObserver.unobserve(img);\n                        }\n                    });\n                });\n                \n                images.forEach(img => imageObserver.observe(img));\n                return imageObserver;\n            } else {\n                // Fallback for older browsers\n                const images = document.querySelectorAll(selector);\n                images.forEach(img => {\n                    img.src = img.dataset.src;\n                    img.classList.remove('lazy');\n                });\n            }\n        },\n        \n        // Bundle size analyzer\n        analyzeBundles: () => {\n            const scripts = Array.from(document.querySelectorAll('script[src]'));\n            const styles = Array.from(document.querySelectorAll('link[rel=\"stylesheet\"]'));\n            \n            const analysis = {\n                scripts: scripts.map(script => ({\n                    src: script.src,\n                    async: script.async,\n                    defer: script.defer\n                })),\n                styles: styles.map(style => ({\n                    href: style.href,\n                    media: style.media\n                })),\n                recommendations: []\n            };\n            \n            // Add recommendations\n            if (scripts.length > 10) {\n                analysis.recommendations.push('Consider bundling JavaScript files');\n            }\n            if (styles.length > 5) {\n                analysis.recommendations.push('Consider bundling CSS files');\n            }\n            \n            return analysis;\n        }\n    };\n    \n    // Helper methods\n    \n    startCoreMetrics() {\n        // Auto-start vitals monitoring\n        this.vitals.start((metric, value) => {\n            this.setMetric(metric, value);\n        });\n        \n        // Start memory monitoring if supported\n        if (this.support.memory) {\n            this.memory.monitor((memoryData) => {\n                this.setMetric('memory', memoryData);\n            });\n        }\n    }\n    \n    observePaint(callback) {\n        if (!this.support.paintTiming) return;\n        \n        try {\n            const observer = new PerformanceObserver((list) => {\n                callback(list.getEntries());\n            });\n            observer.observe({ entryTypes: ['paint'] });\n            return observer;\n        } catch (error) {\n            Logger.error('[PerformanceManager] Paint observer failed:', error);\n        }\n    }\n    \n    observeLCP(callback) {\n        if (!this.support.observer) return;\n        \n        try {\n            const observer = new PerformanceObserver((list) => {\n                callback(list.getEntries());\n            });\n            observer.observe({ entryTypes: ['largest-contentful-paint'] });\n            return observer;\n        } catch (error) {\n            Logger.error('[PerformanceManager] LCP observer failed:', error);\n        }\n    }\n    \n    observeFID(callback) {\n        if (!this.support.observer) return;\n        \n        try {\n            const observer = new PerformanceObserver((list) => {\n                callback(list.getEntries());\n            });\n            observer.observe({ entryTypes: ['first-input'] });\n            return observer;\n        } catch (error) {\n            Logger.error('[PerformanceManager] FID observer failed:', error);\n        }\n    }\n    \n    observeCLS(callback) {\n        if (!this.support.layoutInstability) return;\n        \n        try {\n            const observer = new PerformanceObserver((list) => {\n                callback(list.getEntries());\n            });\n            observer.observe({ entryTypes: ['layout-shift'] });\n            return observer;\n        } catch (error) {\n            Logger.error('[PerformanceManager] CLS observer failed:', error);\n        }\n    }\n    \n    getLegacyNavigationTiming() {\n        if (!this.support.timing) return null;\n        \n        const timing = performance.timing;\n        const navigationStart = timing.navigationStart;\n        \n        return {\n            redirect: timing.redirectEnd - timing.redirectStart,\n            dns: timing.domainLookupEnd - timing.domainLookupStart,\n            connect: timing.connectEnd - timing.connectStart,\n            ssl: timing.connectEnd - timing.secureConnectionStart,\n            ttfb: timing.responseStart - timing.requestStart,\n            download: timing.responseEnd - timing.responseStart,\n            domProcessing: timing.domContentLoadedEventStart - timing.responseEnd,\n            domComplete: timing.domComplete - timing.domContentLoadedEventStart,\n            loadComplete: timing.loadEventEnd - timing.loadEventStart,\n            totalTime: timing.loadEventEnd - navigationStart\n        };\n    }\n    \n    getResourceType(entry) {\n        const url = new URL(entry.name);\n        const extension = url.pathname.split('.').pop().toLowerCase();\n        \n        const typeMap = {\n            js: 'script',\n            css: 'stylesheet',\n            png: 'image', jpg: 'image', jpeg: 'image', gif: 'image', svg: 'image', webp: 'image',\n            woff: 'font', woff2: 'font', ttf: 'font', eot: 'font',\n            json: 'fetch', xml: 'fetch'\n        };\n        \n        return typeMap[extension] || entry.initiatorType || 'other';\n    }\n    \n    getInsight(metric, value, good, needs) {\n        if (value < good) return { rating: 'good', message: `Excellent ${metric}` };\n        if (value < needs) return { rating: 'needs-improvement', message: `${metric} needs improvement` };\n        return { rating: 'poor', message: `Poor ${metric} performance` };\n    }\n    \n    getTransferEfficiency(timing) {\n        const compressionRatio = timing.decodedBodySize > 0 ? \n            timing.encodedBodySize / timing.decodedBodySize : 1;\n        \n        return {\n            ratio: compressionRatio,\n            rating: compressionRatio < 0.7 ? 'good' : compressionRatio < 0.9 ? 'fair' : 'poor'\n        };\n    }\n    \n    getNavigationRecommendations(timing) {\n        const recommendations = [];\n        \n        if (timing.ttfb > 500) {\n            recommendations.push('Server response time is slow. Consider optimizing backend performance.');\n        }\n        if (timing.dns > 100) {\n            recommendations.push('DNS lookup time is high. Consider using a faster DNS provider.');\n        }\n        if (timing.connect > 1000) {\n            recommendations.push('Connection time is slow. Check network latency.');\n        }\n        if (timing.domProcessing > 1000) {\n            recommendations.push('DOM processing is slow. Consider optimizing JavaScript execution.');\n        }\n        \n        return recommendations;\n    }\n    \n    checkThreshold(metric, value) {\n        const threshold = this.thresholds[metric];\n        if (threshold && value > threshold) {\n            Logger.warn(`[PerformanceManager] ${metric.toUpperCase()} threshold exceeded: ${value}ms (threshold: ${threshold}ms)`);\n        }\n    }\n    \n    getRating(metric, value) {\n        const thresholds = {\n            fcp: { good: 1800, poor: 3000 },\n            lcp: { good: 2500, poor: 4000 },\n            fid: { good: 100, poor: 300 },\n            cls: { good: 0.1, poor: 0.25 }\n        };\n        \n        const threshold = thresholds[metric];\n        if (!threshold || value === null || value === undefined) return 'unknown';\n        \n        if (value <= threshold.good) return 'good';\n        if (value <= threshold.poor) return 'needs-improvement';\n        return 'poor';\n    }\n    \n    setMetric(key, value) {\n        this.metrics.set(key, {\n            value,\n            timestamp: Date.now()\n        });\n    }\n    \n    getMetric(key) {\n        const metric = this.metrics.get(key);\n        return metric ? metric.value : null;\n    }\n    \n    formatBytes(bytes) {\n        if (bytes === 0) return '0 Bytes';\n        \n        const k = 1024;\n        const sizes = ['Bytes', 'KB', 'MB', 'GB'];\n        const i = Math.floor(Math.log(bytes) / Math.log(k));\n        \n        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];\n    }\n    \n    generateId(prefix = 'perf') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    /**\n     * Stop all observers and clear data\n     */\n    cleanup() {\n        this.observers.forEach(observer => {\n            observer.disconnect();\n        });\n        this.observers.clear();\n        this.metrics.clear();\n        this.marks.clear();\n        this.measures.clear();\n        Logger.info('[PerformanceManager] Cleanup completed');\n    }\n    \n    /**\n     * Get comprehensive performance report\n     */\n    getReport() {\n        return {\n            support: this.support,\n            navigation: this.navigation.get(),\n            resources: this.resources.getSummary(),\n            vitals: this.vitals.get(),\n            memory: this.memory.get(),\n            marks: this.timing.getMarks(),\n            measures: this.timing.getMeasures(),\n            activeObservers: this.observers.size,\n            timestamp: Date.now()\n        };\n    }\n}","// modules/api-manager/PermissionManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Permission Management System for Web APIs\n */\nexport class PermissionManager {\n    constructor(config = {}) {\n        this.config = config;\n        this.permissionCache = new Map();\n        this.permissionWatchers = new Map();\n        this.requestQueue = new Map();\n        \n        // Check Permissions API support\n        this.support = {\n            permissions: 'permissions' in navigator,\n            query: navigator.permissions?.query !== undefined,\n            request: 'requestPermission' in Notification || 'getUserMedia' in (navigator.mediaDevices || {}),\n            geolocation: 'geolocation' in navigator,\n            notifications: 'Notification' in window,\n            camera: navigator.mediaDevices !== undefined,\n            microphone: navigator.mediaDevices !== undefined,\n            clipboard: 'clipboard' in navigator,\n            vibration: 'vibrate' in navigator\n        };\n        \n        // Permission mappings for different APIs\n        this.permissionMap = {\n            camera: { name: 'camera', api: 'mediaDevices' },\n            microphone: { name: 'microphone', api: 'mediaDevices' },\n            geolocation: { name: 'geolocation', api: 'geolocation' },\n            notifications: { name: 'notifications', api: 'notification' },\n            'clipboard-read': { name: 'clipboard-read', api: 'clipboard' },\n            'clipboard-write': { name: 'clipboard-write', api: 'clipboard' },\n            'background-sync': { name: 'background-sync', api: 'serviceWorker' },\n            'persistent-storage': { name: 'persistent-storage', api: 'storage' },\n            'push': { name: 'push', api: 'serviceWorker' },\n            'midi': { name: 'midi', api: 'midi' },\n            'payment-handler': { name: 'payment-handler', api: 'payment' }\n        };\n        \n        Logger.info('[PermissionManager] Initialized with support:', this.support);\n        \n        // Auto-cache current permissions\n        this.cacheCurrentPermissions();\n    }\n    \n    /**\n     * Check permission status for a specific permission\n     */\n    async check(permission) {\n        if (!this.support.permissions || !this.support.query) {\n            Logger.warn('[PermissionManager] Permissions API not supported, using fallback');\n            return this.checkFallback(permission);\n        }\n        \n        try {\n            // Check cache first\n            const cached = this.permissionCache.get(permission);\n            if (cached && Date.now() - cached.timestamp < 30000) { // 30s cache\n                return cached.status;\n            }\n            \n            const permissionDescriptor = this.getPermissionDescriptor(permission);\n            const status = await navigator.permissions.query(permissionDescriptor);\n            \n            const result = {\n                name: permission,\n                state: status.state,\n                timestamp: Date.now(),\n                supported: true\n            };\n            \n            this.permissionCache.set(permission, result);\n            \n            // Watch for changes\n            status.addEventListener('change', () => {\n                this.onPermissionChange(permission, status.state);\n            });\n            \n            Logger.info(`[PermissionManager] Permission checked: ${permission} = ${status.state}`);\n            return result;\n            \n        } catch (error) {\n            Logger.warn(`[PermissionManager] Permission check failed for ${permission}:`, error.message);\n            return this.checkFallback(permission);\n        }\n    }\n    \n    /**\n     * Request permission for a specific API\n     */\n    async request(permission, options = {}) {\n        const { \n            showRationale = true, \n            fallbackMessage = null,\n            timeout = 30000\n        } = options;\n        \n        try {\n            // Check current status first\n            const currentStatus = await this.check(permission);\n            if (currentStatus.state === 'granted') {\n                return { granted: true, state: 'granted', fromCache: true };\n            }\n            \n            if (currentStatus.state === 'denied') {\n                if (showRationale) {\n                    await this.showPermissionRationale(permission, fallbackMessage);\n                }\n                return { granted: false, state: 'denied', reason: 'previously-denied' };\n            }\n            \n            // Add to request queue to prevent multiple simultaneous requests\n            const queueKey = permission;\n            if (this.requestQueue.has(queueKey)) {\n                Logger.info(`[PermissionManager] Permission request already in progress: ${permission}`);\n                return this.requestQueue.get(queueKey);\n            }\n            \n            const requestPromise = this.executePermissionRequest(permission, timeout);\n            this.requestQueue.set(queueKey, requestPromise);\n            \n            const result = await requestPromise;\n            this.requestQueue.delete(queueKey);\n            \n            // Update cache\n            this.permissionCache.set(permission, {\n                name: permission,\n                state: result.state,\n                timestamp: Date.now(),\n                supported: true\n            });\n            \n            return result;\n            \n        } catch (error) {\n            Logger.error(`[PermissionManager] Permission request failed: ${permission}`, error);\n            this.requestQueue.delete(permission);\n            return { granted: false, state: 'error', error: error.message };\n        }\n    }\n    \n    /**\n     * Request multiple permissions at once\n     */\n    async requestMultiple(permissions, options = {}) {\n        const results = {};\n        \n        if (options.sequential) {\n            // Request permissions one by one\n            for (const permission of permissions) {\n                results[permission] = await this.request(permission, options);\n                \n                // Stop if any critical permission is denied\n                if (options.requireAll && !results[permission].granted) {\n                    break;\n                }\n            }\n        } else {\n            // Request permissions in parallel\n            const requests = permissions.map(permission => \n                this.request(permission, options).then(result => [permission, result])\n            );\n            \n            const responses = await Promise.allSettled(requests);\n            responses.forEach(response => {\n                if (response.status === 'fulfilled') {\n                    const [permission, result] = response.value;\n                    results[permission] = result;\n                } else {\n                    Logger.error('[PermissionManager] Batch permission request failed:', response.reason);\n                }\n            });\n        }\n        \n        const summary = {\n            results,\n            granted: Object.values(results).filter(r => r.granted).length,\n            denied: Object.values(results).filter(r => !r.granted).length,\n            total: Object.keys(results).length\n        };\n        \n        Logger.info(`[PermissionManager] Batch permissions: ${summary.granted}/${summary.total} granted`);\n        return summary;\n    }\n    \n    /**\n     * Check if all required permissions are granted\n     */\n    async checkRequired(requiredPermissions) {\n        const statuses = {};\n        const missing = [];\n        \n        for (const permission of requiredPermissions) {\n            const status = await this.check(permission);\n            statuses[permission] = status;\n            \n            if (status.state !== 'granted') {\n                missing.push(permission);\n            }\n        }\n        \n        return {\n            allGranted: missing.length === 0,\n            granted: Object.keys(statuses).filter(p => statuses[p].state === 'granted'),\n            missing,\n            statuses\n        };\n    }\n    \n    /**\n     * Watch permission changes\n     */\n    watch(permission, callback) {\n        const watcherId = this.generateId('watcher');\n        \n        this.permissionWatchers.set(watcherId, {\n            permission,\n            callback,\n            active: true\n        });\n        \n        // Set up the watcher\n        this.setupPermissionWatcher(permission, callback);\n        \n        Logger.info(`[PermissionManager] Permission watcher created: ${permission}`);\n        \n        return {\n            id: watcherId,\n            stop: () => {\n                const watcher = this.permissionWatchers.get(watcherId);\n                if (watcher) {\n                    watcher.active = false;\n                    this.permissionWatchers.delete(watcherId);\n                    Logger.info(`[PermissionManager] Permission watcher stopped: ${permission}`);\n                }\n            }\n        };\n    }\n    \n    /**\n     * Get permission recommendations based on app features\n     */\n    getRecommendations(features = []) {\n        const recommendations = {\n            essential: [],\n            recommended: [],\n            optional: []\n        };\n        \n        const featurePermissionMap = {\n            camera: { permissions: ['camera'], priority: 'essential' },\n            microphone: { permissions: ['microphone'], priority: 'essential' },\n            location: { permissions: ['geolocation'], priority: 'recommended' },\n            notifications: { permissions: ['notifications'], priority: 'recommended' },\n            clipboard: { permissions: ['clipboard-read', 'clipboard-write'], priority: 'optional' },\n            offline: { permissions: ['persistent-storage'], priority: 'recommended' },\n            background: { permissions: ['background-sync', 'push'], priority: 'optional' }\n        };\n        \n        features.forEach(feature => {\n            const mapping = featurePermissionMap[feature];\n            if (mapping) {\n                recommendations[mapping.priority].push(...mapping.permissions);\n            }\n        });\n        \n        // Remove duplicates\n        Object.keys(recommendations).forEach(key => {\n            recommendations[key] = [...new Set(recommendations[key])];\n        });\n        \n        return recommendations;\n    }\n    \n    /**\n     * Create permission onboarding flow\n     */\n    createOnboardingFlow(permissions, options = {}) {\n        const {\n            title = 'Permissions Required',\n            descriptions = {},\n            onComplete = null,\n            onSkip = null\n        } = options;\n        \n        return {\n            permissions,\n            title,\n            descriptions,\n            \n            async start() {\n                Logger.info('[PermissionManager] Starting onboarding flow');\n                \n                const results = [];\n                \n                for (const permission of permissions) {\n                    const description = descriptions[permission] || this.getDefaultDescription(permission);\n                    \n                    // Show permission explanation\n                    const userChoice = await this.showPermissionDialog(permission, description);\n                    \n                    if (userChoice === 'grant') {\n                        const result = await this.request(permission);\n                        results.push({ permission, ...result });\n                    } else if (userChoice === 'skip') {\n                        results.push({ permission, granted: false, skipped: true });\n                    } else {\n                        // User cancelled the entire flow\n                        if (onSkip) onSkip(results);\n                        return { cancelled: true, results };\n                    }\n                }\n                \n                const summary = {\n                    completed: true,\n                    granted: results.filter(r => r.granted).length,\n                    total: results.length,\n                    results\n                };\n                \n                if (onComplete) onComplete(summary);\n                return summary;\n            },\n            \n            getDefaultDescription(permission) {\n                const descriptions = {\n                    camera: 'Take photos and record videos for enhanced functionality',\n                    microphone: 'Record audio for voice features and communication',\n                    geolocation: 'Provide location-based services and content',\n                    notifications: 'Send you important updates and reminders',\n                    'clipboard-read': 'Access clipboard content for convenience features',\n                    'clipboard-write': 'Copy content to clipboard for easy sharing'\n                };\n                \n                return descriptions[permission] || `Allow access to ${permission} functionality`;\n            },\n            \n            async showPermissionDialog(permission, description) {\n                return new Promise(resolve => {\n                    // Create modal dialog\n                    const modal = document.createElement('div');\n                    modal.className = 'permission-dialog-modal';\n                    modal.innerHTML = `\n                        <div class=\"permission-dialog-backdrop\" style=\"\n                            position: fixed;\n                            top: 0;\n                            left: 0;\n                            right: 0;\n                            bottom: 0;\n                            background: rgba(0,0,0,0.5);\n                            z-index: 10000;\n                            display: flex;\n                            align-items: center;\n                            justify-content: center;\n                        \">\n                            <div class=\"permission-dialog\" style=\"\n                                background: white;\n                                border-radius: 8px;\n                                padding: 2rem;\n                                max-width: 400px;\n                                margin: 1rem;\n                                box-shadow: 0 4px 20px rgba(0,0,0,0.3);\n                            \">\n                                <h3 style=\"margin: 0 0 1rem 0; color: #333;\">\n                                    ${this.getPermissionIcon(permission)} ${this.getPermissionTitle(permission)}\n                                </h3>\n                                <p style=\"margin: 0 0 2rem 0; color: #666; line-height: 1.5;\">\n                                    ${description}\n                                </p>\n                                <div style=\"display: flex; gap: 1rem; justify-content: flex-end;\">\n                                    <button class=\"btn-skip\" style=\"\n                                        background: #f5f5f5;\n                                        border: 1px solid #ddd;\n                                        padding: 0.5rem 1rem;\n                                        border-radius: 4px;\n                                        cursor: pointer;\n                                    \">Skip</button>\n                                    <button class=\"btn-grant\" style=\"\n                                        background: #007bff;\n                                        color: white;\n                                        border: none;\n                                        padding: 0.5rem 1rem;\n                                        border-radius: 4px;\n                                        cursor: pointer;\n                                    \">Allow</button>\n                                </div>\n                            </div>\n                        </div>\n                    `;\n                    \n                    document.body.appendChild(modal);\n                    \n                    const skipBtn = modal.querySelector('.btn-skip');\n                    const grantBtn = modal.querySelector('.btn-grant');\n                    \n                    const cleanup = () => document.body.removeChild(modal);\n                    \n                    skipBtn.onclick = () => {\n                        cleanup();\n                        resolve('skip');\n                    };\n                    \n                    grantBtn.onclick = () => {\n                        cleanup();\n                        resolve('grant');\n                    };\n                    \n                    // Close on backdrop click\n                    modal.querySelector('.permission-dialog-backdrop').onclick = (e) => {\n                        if (e.target === e.currentTarget) {\n                            cleanup();\n                            resolve('cancel');\n                        }\n                    };\n                });\n            },\n            \n            getPermissionIcon(permission) {\n                const icons = {\n                    camera: '📷',\n                    microphone: '🎤', \n                    geolocation: '📍',\n                    notifications: '🔔',\n                    'clipboard-read': '📋',\n                    'clipboard-write': '📋'\n                };\n                return icons[permission] || '🔐';\n            },\n            \n            getPermissionTitle(permission) {\n                const titles = {\n                    camera: 'Camera Access',\n                    microphone: 'Microphone Access',\n                    geolocation: 'Location Access',\n                    notifications: 'Notifications',\n                    'clipboard-read': 'Clipboard Access',\n                    'clipboard-write': 'Clipboard Access'\n                };\n                return titles[permission] || `${permission} Permission`;\n            }\n        };\n    }\n    \n    // Helper methods\n    \n    async cacheCurrentPermissions() {\n        if (!this.support.permissions) return;\n        \n        const commonPermissions = ['camera', 'microphone', 'geolocation', 'notifications'];\n        \n        for (const permission of commonPermissions) {\n            try {\n                await this.check(permission);\n            } catch (error) {\n                // Ignore errors during initial caching\n            }\n        }\n    }\n    \n    getPermissionDescriptor(permission) {\n        // Handle different permission descriptor formats\n        switch (permission) {\n            case 'camera':\n                return { name: 'camera' };\n            case 'microphone':\n                return { name: 'microphone' };\n            case 'geolocation':\n                return { name: 'geolocation' };\n            case 'notifications':\n                return { name: 'notifications' };\n            case 'clipboard-read':\n                return { name: 'clipboard-read' };\n            case 'clipboard-write':\n                return { name: 'clipboard-write' };\n            case 'persistent-storage':\n                return { name: 'persistent-storage' };\n            case 'background-sync':\n                return { name: 'background-sync' };\n            case 'push':\n                return { name: 'push', userVisibleOnly: true };\n            default:\n                return { name: permission };\n        }\n    }\n    \n    async checkFallback(permission) {\n        // Fallback checks for browsers without Permissions API\n        const fallbacks = {\n            camera: () => navigator.mediaDevices !== undefined,\n            microphone: () => navigator.mediaDevices !== undefined,\n            geolocation: () => 'geolocation' in navigator,\n            notifications: () => 'Notification' in window,\n            'clipboard-read': () => 'clipboard' in navigator,\n            'clipboard-write': () => 'clipboard' in navigator\n        };\n        \n        const check = fallbacks[permission];\n        const supported = check ? check() : false;\n        \n        return {\n            name: permission,\n            state: supported ? 'prompt' : 'unsupported',\n            timestamp: Date.now(),\n            supported,\n            fallback: true\n        };\n    }\n    \n    async executePermissionRequest(permission, timeout) {\n        return new Promise(async (resolve, reject) => {\n            const timeoutId = setTimeout(() => {\n                reject(new Error('Permission request timeout'));\n            }, timeout);\n            \n            try {\n                let result;\n                \n                switch (permission) {\n                    case 'notifications':\n                        if ('Notification' in window) {\n                            const notificationPermission = await Notification.requestPermission();\n                            result = { granted: notificationPermission === 'granted', state: notificationPermission };\n                        } else {\n                            result = { granted: false, state: 'unsupported' };\n                        }\n                        break;\n                        \n                    case 'camera':\n                    case 'microphone':\n                        try {\n                            const constraints = {};\n                            constraints[permission === 'camera' ? 'video' : 'audio'] = true;\n                            \n                            const stream = await navigator.mediaDevices.getUserMedia(constraints);\n                            stream.getTracks().forEach(track => track.stop()); // Stop immediately\n                            \n                            result = { granted: true, state: 'granted' };\n                        } catch (error) {\n                            result = { \n                                granted: false, \n                                state: error.name === 'NotAllowedError' ? 'denied' : 'error',\n                                error: error.message \n                            };\n                        }\n                        break;\n                        \n                    case 'geolocation':\n                        try {\n                            await new Promise((resolve, reject) => {\n                                navigator.geolocation.getCurrentPosition(resolve, reject, {\n                                    timeout: 10000,\n                                    maximumAge: 0\n                                });\n                            });\n                            result = { granted: true, state: 'granted' };\n                        } catch (error) {\n                            result = { \n                                granted: false, \n                                state: error.code === 1 ? 'denied' : 'error',\n                                error: error.message \n                            };\n                        }\n                        break;\n                        \n                    default:\n                        // Try generic permission request\n                        if (this.support.permissions) {\n                            const status = await navigator.permissions.query(this.getPermissionDescriptor(permission));\n                            result = { granted: status.state === 'granted', state: status.state };\n                        } else {\n                            result = { granted: false, state: 'unsupported' };\n                        }\n                }\n                \n                clearTimeout(timeoutId);\n                resolve(result);\n                \n            } catch (error) {\n                clearTimeout(timeoutId);\n                reject(error);\n            }\n        });\n    }\n    \n    async setupPermissionWatcher(permission, callback) {\n        if (!this.support.permissions) return;\n        \n        try {\n            const status = await navigator.permissions.query(this.getPermissionDescriptor(permission));\n            status.addEventListener('change', () => {\n                callback({\n                    permission,\n                    state: status.state,\n                    timestamp: Date.now()\n                });\n            });\n        } catch (error) {\n            Logger.warn(`[PermissionManager] Could not set up watcher for ${permission}:`, error);\n        }\n    }\n    \n    onPermissionChange(permission, newState) {\n        Logger.info(`[PermissionManager] Permission changed: ${permission} → ${newState}`);\n        \n        // Update cache\n        this.permissionCache.set(permission, {\n            name: permission,\n            state: newState,\n            timestamp: Date.now(),\n            supported: true\n        });\n        \n        // Notify watchers\n        this.permissionWatchers.forEach(watcher => {\n            if (watcher.permission === permission && watcher.active) {\n                watcher.callback({\n                    permission,\n                    state: newState,\n                    timestamp: Date.now()\n                });\n            }\n        });\n    }\n    \n    async showPermissionRationale(permission, customMessage = null) {\n        const rationales = {\n            camera: 'Camera access is needed to take photos and record videos. You can enable this in your browser settings.',\n            microphone: 'Microphone access is needed for audio recording and voice features. Please check your browser settings.',\n            geolocation: 'Location access helps provide relevant local content. You can manage this in your browser settings.',\n            notifications: 'Notifications keep you updated with important information. You can change this anytime in settings.'\n        };\n        \n        const message = customMessage || rationales[permission] || `${permission} permission was denied. Please enable it in your browser settings to use this feature.`;\n        \n        // Simple alert for now - could be enhanced with custom UI\n        if (typeof window !== 'undefined' && window.confirm) {\n            return window.confirm(message + '\\n\\nWould you like to try again?');\n        }\n        \n        return false;\n    }\n    \n    generateId(prefix = 'perm') {\n        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    /**\n     * Get comprehensive permission status report\n     */\n    async getPermissionReport() {\n        const report = {\n            support: this.support,\n            cached: Array.from(this.permissionCache.entries()).map(([name, data]) => ({\n                name,\n                ...data\n            })),\n            watchers: Array.from(this.permissionWatchers.keys()),\n            timestamp: Date.now()\n        };\n        \n        return report;\n    }\n    \n    /**\n     * Clear all cached permissions\n     */\n    clearCache() {\n        this.permissionCache.clear();\n        Logger.info('[PermissionManager] Permission cache cleared');\n    }\n    \n    /**\n     * Stop all watchers and cleanup\n     */\n    cleanup() {\n        this.permissionWatchers.forEach(watcher => {\n            watcher.active = false;\n        });\n        this.permissionWatchers.clear();\n        this.requestQueue.clear();\n        this.permissionCache.clear();\n        \n        Logger.info('[PermissionManager] Cleanup completed');\n    }\n}","// modules/api-manager/BiometricAuthManager.js\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Biometric Authentication Manager - WebAuthn API\n */\nexport class BiometricAuthManager {\n    constructor(config = {}) {\n        this.config = {\n            rpName: config.rpName || 'Custom PHP Framework',\n            rpId: config.rpId || window.location.hostname,\n            timeout: config.timeout || 60000,\n            userVerification: config.userVerification || 'preferred',\n            authenticatorSelection: {\n                authenticatorAttachment: 'platform', // Prefer built-in authenticators\n                userVerification: 'preferred',\n                requireResidentKey: false,\n                ...config.authenticatorSelection\n            },\n            ...config\n        };\n        \n        this.credentials = new Map();\n        this.authSessions = new Map();\n        \n        // Check WebAuthn support\n        this.support = {\n            webAuthn: 'credentials' in navigator && 'create' in navigator.credentials,\n            conditionalUI: 'conditional' in window.PublicKeyCredential || false,\n            userVerifyingPlatformAuthenticator: false,\n            residentKey: false\n        };\n        \n        // Enhanced feature detection\n        this.detectFeatures();\n        \n        Logger.info('[BiometricAuthManager] Initialized with support:', this.support);\n    }\n    \n    async detectFeatures() {\n        if (!this.support.webAuthn) return;\n        \n        try {\n            // Check for user-verifying platform authenticator\n            const available = await window.PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable();\n            this.support.userVerifyingPlatformAuthenticator = available;\n            \n            // Check for resident key support\n            if (window.PublicKeyCredential.isConditionalMediationAvailable) {\n                this.support.conditionalUI = await window.PublicKeyCredential.isConditionalMediationAvailable();\n            }\n            \n            Logger.info('[BiometricAuthManager] Enhanced features detected:', {\n                platform: this.support.userVerifyingPlatformAuthenticator,\n                conditional: this.support.conditionalUI\n            });\n            \n        } catch (error) {\n            Logger.warn('[BiometricAuthManager] Feature detection failed:', error);\n        }\n    }\n    \n    /**\n     * Register new biometric credential\n     */\n    async register(userInfo, options = {}) {\n        if (!this.support.webAuthn) {\n            throw new Error('WebAuthn not supported');\n        }\n        \n        const {\n            challenge = null,\n            excludeCredentials = [],\n            extensions = {}\n        } = options;\n        \n        try {\n            // Generate challenge if not provided\n            const challengeBuffer = challenge ? \n                this.base64ToArrayBuffer(challenge) : \n                crypto.getRandomValues(new Uint8Array(32));\n            \n            // Create credential creation options\n            const createOptions = {\n                rp: {\n                    name: this.config.rpName,\n                    id: this.config.rpId\n                },\n                user: {\n                    id: this.stringToArrayBuffer(userInfo.id || userInfo.username),\n                    name: userInfo.username || userInfo.email,\n                    displayName: userInfo.displayName || userInfo.name || userInfo.username\n                },\n                challenge: challengeBuffer,\n                pubKeyCredParams: [\n                    { type: 'public-key', alg: -7 },  // ES256\n                    { type: 'public-key', alg: -35 }, // ES384\n                    { type: 'public-key', alg: -36 }, // ES512\n                    { type: 'public-key', alg: -257 }, // RS256\n                    { type: 'public-key', alg: -258 }, // RS384\n                    { type: 'public-key', alg: -259 }  // RS512\n                ],\n                authenticatorSelection: this.config.authenticatorSelection,\n                timeout: this.config.timeout,\n                attestation: 'direct',\n                extensions: {\n                    credProps: true,\n                    ...extensions\n                }\n            };\n            \n            // Add exclude list if provided\n            if (excludeCredentials.length > 0) {\n                createOptions.excludeCredentials = excludeCredentials.map(cred => ({\n                    type: 'public-key',\n                    id: typeof cred === 'string' ? this.base64ToArrayBuffer(cred) : cred,\n                    transports: ['internal', 'hybrid']\n                }));\n            }\n            \n            Logger.info('[BiometricAuthManager] Starting registration...');\n            \n            // Create credential\n            const credential = await navigator.credentials.create({\n                publicKey: createOptions\n            });\n            \n            if (!credential) {\n                throw new Error('Credential creation failed');\n            }\n            \n            // Process the credential\n            const processedCredential = this.processCredential(credential, 'registration');\n            \n            // Store credential info locally\n            const credentialInfo = {\n                id: processedCredential.id,\n                rawId: processedCredential.rawId,\n                userId: userInfo.id || userInfo.username,\n                userDisplayName: userInfo.displayName || userInfo.name,\n                createdAt: Date.now(),\n                lastUsed: null,\n                counter: processedCredential.response.counter || 0,\n                transports: credential.response.getTransports?.() || ['internal']\n            };\n            \n            this.credentials.set(processedCredential.id, credentialInfo);\n            \n            Logger.info('[BiometricAuthManager] Registration successful:', {\n                id: processedCredential.id,\n                user: userInfo.username,\n                authenticator: credentialInfo.transports\n            });\n            \n            return {\n                success: true,\n                credential: processedCredential,\n                info: credentialInfo,\n                attestation: this.parseAttestation(credential.response)\n            };\n            \n        } catch (error) {\n            Logger.error('[BiometricAuthManager] Registration failed:', error);\n            return {\n                success: false,\n                error: error.message,\n                name: error.name\n            };\n        }\n    }\n    \n    /**\n     * Authenticate with biometric credential\n     */\n    async authenticate(options = {}) {\n        if (!this.support.webAuthn) {\n            throw new Error('WebAuthn not supported');\n        }\n        \n        const {\n            challenge = null,\n            allowCredentials = [],\n            userVerification = this.config.userVerification,\n            conditional = false,\n            extensions = {}\n        } = options;\n        \n        try {\n            // Generate challenge if not provided\n            const challengeBuffer = challenge ? \n                this.base64ToArrayBuffer(challenge) : \n                crypto.getRandomValues(new Uint8Array(32));\n            \n            // Create authentication options\n            const getOptions = {\n                challenge: challengeBuffer,\n                timeout: this.config.timeout,\n                userVerification,\n                extensions: {\n                    credProps: true,\n                    ...extensions\n                }\n            };\n            \n            // Add allow list if provided\n            if (allowCredentials.length > 0) {\n                getOptions.allowCredentials = allowCredentials.map(cred => ({\n                    type: 'public-key',\n                    id: typeof cred === 'string' ? this.base64ToArrayBuffer(cred) : cred,\n                    transports: ['internal', 'hybrid', 'usb', 'nfc', 'ble']\n                }));\n            }\n            \n            Logger.info('[BiometricAuthManager] Starting authentication...', { conditional });\n            \n            // Authenticate\n            const credential = conditional && this.support.conditionalUI ?\n                await navigator.credentials.get({\n                    publicKey: getOptions,\n                    mediation: 'conditional'\n                }) :\n                await navigator.credentials.get({\n                    publicKey: getOptions\n                });\n            \n            if (!credential) {\n                throw new Error('Authentication failed');\n            }\n            \n            // Process the credential\n            const processedCredential = this.processCredential(credential, 'authentication');\n            \n            // Update credential usage\n            const credentialInfo = this.credentials.get(processedCredential.id);\n            if (credentialInfo) {\n                credentialInfo.lastUsed = Date.now();\n                credentialInfo.counter = processedCredential.response.counter || 0;\n            }\n            \n            // Create authentication session\n            const sessionId = this.generateSessionId();\n            const authSession = {\n                id: sessionId,\n                credentialId: processedCredential.id,\n                userId: credentialInfo?.userId,\n                authenticatedAt: Date.now(),\n                userAgent: navigator.userAgent,\n                ipAddress: await this.getClientIP().catch(() => 'unknown')\n            };\n            \n            this.authSessions.set(sessionId, authSession);\n            \n            Logger.info('[BiometricAuthManager] Authentication successful:', {\n                sessionId,\n                credentialId: processedCredential.id,\n                userId: credentialInfo?.userId\n            });\n            \n            return {\n                success: true,\n                credential: processedCredential,\n                session: authSession,\n                info: credentialInfo\n            };\n            \n        } catch (error) {\n            Logger.error('[BiometricAuthManager] Authentication failed:', error);\n            return {\n                success: false,\n                error: error.message,\n                name: error.name\n            };\n        }\n    }\n    \n    /**\n     * Check if biometric authentication is available\n     */\n    async isAvailable() {\n        const availability = {\n            webAuthn: this.support.webAuthn,\n            platform: this.support.userVerifyingPlatformAuthenticator,\n            conditional: this.support.conditionalUI,\n            hasCredentials: this.credentials.size > 0,\n            recommended: false\n        };\n        \n        // Overall recommendation\n        availability.recommended = availability.webAuthn && \n                                 (availability.platform || availability.hasCredentials);\n        \n        return availability;\n    }\n    \n    /**\n     * Set up conditional UI for seamless authentication\n     */\n    async setupConditionalUI(inputSelector = 'input[type=\"email\"], input[type=\"text\"]', options = {}) {\n        if (!this.support.conditionalUI) {\n            Logger.warn('[BiometricAuthManager] Conditional UI not supported');\n            return null;\n        }\n        \n        const inputs = document.querySelectorAll(inputSelector);\n        if (inputs.length === 0) {\n            Logger.warn('[BiometricAuthManager] No suitable inputs found for conditional UI');\n            return null;\n        }\n        \n        try {\n            // Set up conditional UI\n            inputs.forEach(input => {\n                input.addEventListener('focus', async () => {\n                    Logger.info('[BiometricAuthManager] Setting up conditional authentication');\n                    \n                    try {\n                        const result = await this.authenticate({\n                            ...options,\n                            conditional: true\n                        });\n                        \n                        if (result.success) {\n                            // Trigger custom event for successful authentication\n                            const event = new CustomEvent('biometric-auth-success', {\n                                detail: result\n                            });\n                            input.dispatchEvent(event);\n                            \n                            // Auto-fill username if available\n                            if (result.info?.userDisplayName) {\n                                input.value = result.info.userDisplayName;\n                            }\n                        }\n                    } catch (error) {\n                        Logger.warn('[BiometricAuthManager] Conditional auth failed:', error);\n                    }\n                });\n            });\n            \n            Logger.info('[BiometricAuthManager] Conditional UI setup complete');\n            return { inputs: inputs.length, selector: inputSelector };\n            \n        } catch (error) {\n            Logger.error('[BiometricAuthManager] Conditional UI setup failed:', error);\n            return null;\n        }\n    }\n    \n    /**\n     * Create a complete biometric login flow\n     */\n    createLoginFlow(options = {}) {\n        const {\n            registerSelector = '#register-biometric',\n            loginSelector = '#login-biometric',\n            statusSelector = '#biometric-status',\n            onRegister = null,\n            onLogin = null,\n            onError = null\n        } = options;\n        \n        return {\n            async init() {\n                const availability = await this.isAvailable();\n                \n                // Update status display\n                const statusEl = document.querySelector(statusSelector);\n                if (statusEl) {\n                    statusEl.innerHTML = this.createStatusHTML(availability);\n                }\n                \n                // Set up register button\n                const registerBtn = document.querySelector(registerSelector);\n                if (registerBtn) {\n                    registerBtn.style.display = availability.webAuthn ? 'block' : 'none';\n                    registerBtn.onclick = () => this.handleRegister();\n                }\n                \n                // Set up login button\n                const loginBtn = document.querySelector(loginSelector);\n                if (loginBtn) {\n                    loginBtn.style.display = availability.hasCredentials ? 'block' : 'none';\n                    loginBtn.onclick = () => this.handleLogin();\n                }\n                \n                // Set up conditional UI\n                if (availability.conditional) {\n                    await this.setupConditionalUI();\n                }\n                \n                return availability;\n            },\n            \n            async handleRegister() {\n                try {\n                    // Get user information (could be from form or prompt)\n                    const userInfo = await this.getUserInfo();\n                    if (!userInfo) return;\n                    \n                    const result = await this.register(userInfo);\n                    \n                    if (result.success) {\n                        if (onRegister) onRegister(result);\n                        this.showSuccess('Biometric authentication registered successfully!');\n                    } else {\n                        if (onError) onError(result);\n                        this.showError(result.error);\n                    }\n                } catch (error) {\n                    if (onError) onError({ error: error.message });\n                    this.showError(error.message);\n                }\n            },\n            \n            async handleLogin() {\n                try {\n                    const result = await this.authenticate();\n                    \n                    if (result.success) {\n                        if (onLogin) onLogin(result);\n                        this.showSuccess('Biometric authentication successful!');\n                    } else {\n                        if (onError) onError(result);\n                        this.showError(result.error);\n                    }\n                } catch (error) {\n                    if (onError) onError({ error: error.message });\n                    this.showError(error.message);\n                }\n            },\n            \n            async getUserInfo() {\n                // Try to get from form first\n                const usernameInput = document.querySelector('input[name=\"username\"], input[name=\"email\"]');\n                const nameInput = document.querySelector('input[name=\"name\"], input[name=\"display_name\"]');\n                \n                if (usernameInput?.value) {\n                    return {\n                        id: usernameInput.value,\n                        username: usernameInput.value,\n                        displayName: nameInput?.value || usernameInput.value\n                    };\n                }\n                \n                // Fallback to prompt\n                const username = prompt('Please enter your username or email:');\n                if (!username) return null;\n                \n                const displayName = prompt('Please enter your display name:') || username;\n                \n                return {\n                    id: username,\n                    username,\n                    displayName\n                };\n            },\n            \n            createStatusHTML(availability) {\n                if (!availability.webAuthn) {\n                    return '<div class=\"alert alert-warning\">⚠️ Biometric authentication not supported in this browser</div>';\n                }\n                \n                if (!availability.platform && !availability.hasCredentials) {\n                    return '<div class=\"alert alert-info\">ℹ️ No biometric authenticators available</div>';\n                }\n                \n                if (availability.hasCredentials) {\n                    return '<div class=\"alert alert-success\">✅ Biometric authentication available</div>';\n                }\n                \n                return '<div class=\"alert alert-info\">🔐 Biometric authentication can be set up</div>';\n            },\n            \n            showSuccess(message) {\n                this.showMessage(message, 'success');\n            },\n            \n            showError(message) {\n                this.showMessage(message, 'error');\n            },\n            \n            showMessage(message, type = 'info') {\n                // Create toast notification\n                const toast = document.createElement('div');\n                toast.className = `biometric-toast toast-${type}`;\n                toast.style.cssText = `\n                    position: fixed;\n                    top: 20px;\n                    right: 20px;\n                    background: ${type === 'error' ? '#f44336' : type === 'success' ? '#4caf50' : '#2196f3'};\n                    color: white;\n                    padding: 1rem;\n                    border-radius: 4px;\n                    box-shadow: 0 2px 10px rgba(0,0,0,0.3);\n                    z-index: 10001;\n                    max-width: 300px;\n                `;\n                toast.textContent = message;\n                \n                document.body.appendChild(toast);\n                \n                setTimeout(() => {\n                    if (toast.parentNode) {\n                        document.body.removeChild(toast);\n                    }\n                }, 5000);\n            }\n        };\n    }\n    \n    // Helper methods\n    \n    processCredential(credential, type) {\n        const processed = {\n            id: this.arrayBufferToBase64(credential.rawId),\n            rawId: this.arrayBufferToBase64(credential.rawId),\n            type: credential.type,\n            response: {}\n        };\n        \n        if (type === 'registration') {\n            processed.response = {\n                attestationObject: this.arrayBufferToBase64(credential.response.attestationObject),\n                clientDataJSON: this.arrayBufferToBase64(credential.response.clientDataJSON),\n                transports: credential.response.getTransports?.() || []\n            };\n        } else {\n            processed.response = {\n                authenticatorData: this.arrayBufferToBase64(credential.response.authenticatorData),\n                clientDataJSON: this.arrayBufferToBase64(credential.response.clientDataJSON),\n                signature: this.arrayBufferToBase64(credential.response.signature),\n                userHandle: credential.response.userHandle ? \n                    this.arrayBufferToBase64(credential.response.userHandle) : null\n            };\n        }\n        \n        return processed;\n    }\n    \n    parseAttestation(response) {\n        try {\n            // Basic attestation parsing\n            const clientDataJSON = JSON.parse(this.arrayBufferToString(response.clientDataJSON));\n            \n            return {\n                format: 'packed', // Simplified\n                clientData: clientDataJSON,\n                origin: clientDataJSON.origin,\n                challenge: clientDataJSON.challenge\n            };\n        } catch (error) {\n            Logger.warn('[BiometricAuthManager] Attestation parsing failed:', error);\n            return null;\n        }\n    }\n    \n    async getClientIP() {\n        try {\n            // Use a public IP service (consider privacy implications)\n            const response = await fetch('https://api.ipify.org?format=json');\n            const data = await response.json();\n            return data.ip;\n        } catch (error) {\n            return 'unknown';\n        }\n    }\n    \n    generateSessionId() {\n        return `biometric_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    }\n    \n    // Encoding/decoding utilities\n    \n    arrayBufferToBase64(buffer) {\n        const bytes = new Uint8Array(buffer);\n        let binary = '';\n        for (let i = 0; i < bytes.byteLength; i++) {\n            binary += String.fromCharCode(bytes[i]);\n        }\n        return btoa(binary);\n    }\n    \n    base64ToArrayBuffer(base64) {\n        const binary = atob(base64);\n        const bytes = new Uint8Array(binary.length);\n        for (let i = 0; i < binary.length; i++) {\n            bytes[i] = binary.charCodeAt(i);\n        }\n        return bytes.buffer;\n    }\n    \n    stringToArrayBuffer(str) {\n        const encoder = new TextEncoder();\n        return encoder.encode(str);\n    }\n    \n    arrayBufferToString(buffer) {\n        const decoder = new TextDecoder();\n        return decoder.decode(buffer);\n    }\n    \n    /**\n     * Get all registered credentials\n     */\n    getCredentials() {\n        return Array.from(this.credentials.values());\n    }\n    \n    /**\n     * Get active authentication sessions\n     */\n    getActiveSessions() {\n        return Array.from(this.authSessions.values());\n    }\n    \n    /**\n     * Revoke a credential\n     */\n    revokeCredential(credentialId) {\n        const removed = this.credentials.delete(credentialId);\n        if (removed) {\n            Logger.info(`[BiometricAuthManager] Credential revoked: ${credentialId}`);\n        }\n        return removed;\n    }\n    \n    /**\n     * End authentication session\n     */\n    endSession(sessionId) {\n        const removed = this.authSessions.delete(sessionId);\n        if (removed) {\n            Logger.info(`[BiometricAuthManager] Session ended: ${sessionId}`);\n        }\n        return removed;\n    }\n    \n    /**\n     * Cleanup expired sessions\n     */\n    cleanupSessions(maxAge = 24 * 60 * 60 * 1000) { // 24 hours\n        const now = Date.now();\n        let cleaned = 0;\n        \n        for (const [sessionId, session] of this.authSessions.entries()) {\n            if (now - session.authenticatedAt > maxAge) {\n                this.authSessions.delete(sessionId);\n                cleaned++;\n            }\n        }\n        \n        if (cleaned > 0) {\n            Logger.info(`[BiometricAuthManager] Cleaned up ${cleaned} expired sessions`);\n        }\n        \n        return cleaned;\n    }\n    \n    /**\n     * Get comprehensive status report\n     */\n    async getStatusReport() {\n        const availability = await this.isAvailable();\n        \n        return {\n            availability,\n            credentials: this.credentials.size,\n            sessions: this.authSessions.size,\n            support: this.support,\n            config: {\n                rpName: this.config.rpName,\n                rpId: this.config.rpId,\n                timeout: this.config.timeout\n            },\n            timestamp: Date.now()\n        };\n    }\n}","// modules/api-manager/index.js\nimport { Logger } from '../../core/logger.js';\nimport { ObserverManager } from './ObserverManager.js';\nimport { MediaManager } from './MediaManager.js';\nimport { StorageManager } from './StorageManager.js';\nimport { DeviceManager } from './DeviceManager.js';\nimport { AnimationManager } from './AnimationManager.js';\nimport { WorkerManager } from './WorkerManager.js';\nimport { PerformanceManager } from './PerformanceManager.js';\nimport { PermissionManager } from './PermissionManager.js';\nimport { BiometricAuthManager } from './BiometricAuthManager.js';\n\n/**\n * Centralized API Manager for all Web APIs\n * Provides unified, simplified access to modern browser APIs\n */\nconst APIManagerModule = {\n    name: 'api-manager',\n    \n    // Module-level init (called by module system)\n    init(config = {}, state = null) {\n        Logger.info('[APIManager] Module initialized - All Web APIs available');\n        this.initializeAPIManagers(config);\n        this.exposeGlobalAPI();\n        return this;\n    },\n    \n    /**\n     * Initialize all API managers\n     */\n    initializeAPIManagers(config) {\n        this.observers = new ObserverManager(config.observers || {});\n        this.media = new MediaManager(config.media || {});\n        this.storage = new StorageManager(config.storage || {});\n        this.device = new DeviceManager(config.device || {});\n        this.animation = new AnimationManager(config.animation || {});\n        this.worker = new WorkerManager(config.worker || {});\n        this.performance = new PerformanceManager(config.performance || {});\n        this.permissions = new PermissionManager(config.permissions || {});\n        this.biometric = new BiometricAuthManager(config.biometric || {});\n        \n        Logger.info('[APIManager] All API managers initialized');\n    },\n    \n    /**\n     * Expose global API for easy access\n     */\n    exposeGlobalAPI() {\n        // Make API managers globally available\n        if (typeof window !== 'undefined') {\n            window.API = {\n                observers: this.observers,\n                media: this.media,\n                storage: this.storage,\n                device: this.device,\n                animation: this.animation,\n                worker: this.worker,\n                performance: this.performance,\n                permissions: this.permissions,\n                biometric: this.biometric\n            };\n            \n            Logger.info('[APIManager] Global API exposed at window.API');\n        }\n    },\n    \n    /**\n     * Get specific API manager\n     */\n    getAPI(name) {\n        return this[name] || null;\n    },\n    \n    /**\n     * Check if specific Web API is supported\n     */\n    isSupported(apiName) {\n        const supportMap = {\n            // Observer APIs\n            'IntersectionObserver': 'IntersectionObserver' in window,\n            'ResizeObserver': 'ResizeObserver' in window,\n            'MutationObserver': 'MutationObserver' in window,\n            'PerformanceObserver': 'PerformanceObserver' in window,\n            \n            // Media APIs\n            'MediaDevices': navigator.mediaDevices !== undefined,\n            'WebRTC': 'RTCPeerConnection' in window,\n            'WebAudio': 'AudioContext' in window || 'webkitAudioContext' in window,\n            'MediaRecorder': 'MediaRecorder' in window,\n            \n            // Storage APIs\n            'IndexedDB': 'indexedDB' in window,\n            'CacheAPI': 'caches' in window,\n            'WebLocks': 'locks' in navigator,\n            'BroadcastChannel': 'BroadcastChannel' in window,\n            \n            // Device APIs\n            'Geolocation': 'geolocation' in navigator,\n            'DeviceMotion': 'DeviceMotionEvent' in window,\n            'DeviceOrientation': 'DeviceOrientationEvent' in window,\n            'Vibration': 'vibrate' in navigator,\n            'Battery': 'getBattery' in navigator,\n            'NetworkInfo': 'connection' in navigator,\n            \n            // Animation APIs\n            'WebAnimations': 'animate' in Element.prototype,\n            'VisualViewport': 'visualViewport' in window,\n            \n            // Worker APIs\n            'WebWorkers': 'Worker' in window,\n            'ServiceWorker': 'serviceWorker' in navigator,\n            'SharedWorker': 'SharedWorker' in window,\n            \n            // Performance APIs\n            'PerformanceAPI': 'performance' in window,\n            'NavigationTiming': 'getEntriesByType' in performance,\n            \n            // Permission APIs\n            'Permissions': 'permissions' in navigator,\n            'WebAuthn': 'credentials' in navigator && 'create' in navigator.credentials\n        };\n        \n        return supportMap[apiName] || false;\n    },\n    \n    /**\n     * Get browser capabilities report\n     */\n    getCapabilities() {\n        const capabilities = {};\n        \n        // Check all API support\n        Object.keys(this.getSupportMap()).forEach(api => {\n            capabilities[api] = this.isSupported(api);\n        });\n        \n        return {\n            capabilities,\n            modernBrowser: this.isModernBrowser(),\n            recommendedAPIs: this.getRecommendedAPIs(),\n            summary: this.getCapabilitySummary(capabilities)\n        };\n    },\n    \n    /**\n     * Check if browser is considered modern\n     */\n    isModernBrowser() {\n        const requiredAPIs = [\n            'IntersectionObserver',\n            'ResizeObserver',\n            'WebAnimations',\n            'IndexedDB'\n        ];\n        \n        return requiredAPIs.every(api => this.isSupported(api));\n    },\n    \n    /**\n     * Get recommended APIs for current browser\n     */\n    getRecommendedAPIs() {\n        const recommendations = [];\n        \n        if (this.isSupported('IntersectionObserver')) {\n            recommendations.push({\n                api: 'IntersectionObserver',\n                use: 'Lazy loading, scroll triggers, viewport detection',\n                example: 'API.observers.intersection(elements, callback)'\n            });\n        }\n        \n        if (this.isSupported('WebAnimations')) {\n            recommendations.push({\n                api: 'Web Animations',\n                use: 'High-performance animations with timeline control',\n                example: 'API.animation.animate(element, keyframes, options)'\n            });\n        }\n        \n        if (this.isSupported('IndexedDB')) {\n            recommendations.push({\n                api: 'IndexedDB',\n                use: 'Client-side database for complex data',\n                example: 'API.storage.db.set(key, value)'\n            });\n        }\n        \n        if (this.isSupported('MediaDevices')) {\n            recommendations.push({\n                api: 'Media Devices',\n                use: 'Camera, microphone, screen sharing',\n                example: 'API.media.getUserCamera()'\n            });\n        }\n        \n        return recommendations;\n    },\n    \n    /**\n     * Get capability summary\n     */\n    getCapabilitySummary(capabilities) {\n        const total = Object.keys(capabilities).length;\n        const supported = Object.values(capabilities).filter(Boolean).length;\n        const percentage = Math.round((supported / total) * 100);\n        \n        return {\n            total,\n            supported,\n            percentage,\n            grade: this.getGrade(percentage)\n        };\n    },\n    \n    /**\n     * Get grade based on API support percentage\n     */\n    getGrade(percentage) {\n        if (percentage >= 90) return 'A+';\n        if (percentage >= 80) return 'A';\n        if (percentage >= 70) return 'B';\n        if (percentage >= 60) return 'C';\n        return 'D';\n    },\n    \n    /**\n     * Get support map for reference\n     */\n    getSupportMap() {\n        return {\n            'IntersectionObserver': 'Viewport intersection detection',\n            'ResizeObserver': 'Element resize detection',\n            'MutationObserver': 'DOM change detection',\n            'PerformanceObserver': 'Performance metrics monitoring',\n            'MediaDevices': 'Camera and microphone access',\n            'WebRTC': 'Real-time communication',\n            'WebAudio': 'Audio processing and synthesis',\n            'MediaRecorder': 'Audio/video recording',\n            'IndexedDB': 'Client-side database',\n            'CacheAPI': 'HTTP cache management',\n            'WebLocks': 'Resource locking',\n            'BroadcastChannel': 'Cross-tab communication',\n            'Geolocation': 'GPS and location services',\n            'DeviceMotion': 'Accelerometer and gyroscope',\n            'DeviceOrientation': 'Device orientation',\n            'Vibration': 'Haptic feedback',\n            'Battery': 'Battery status',\n            'NetworkInfo': 'Network connection info',\n            'WebAnimations': 'High-performance animations',\n            'VisualViewport': 'Viewport information',\n            'WebWorkers': 'Background processing',\n            'ServiceWorker': 'Background sync and caching',\n            'SharedWorker': 'Shared background processing',\n            'PerformanceAPI': 'Performance measurement',\n            'NavigationTiming': 'Navigation timing metrics',\n            'Permissions': 'Browser permission management',\n            'WebAuthn': 'Biometric authentication'\n        };\n    }\n};\n\n// Export für module system\nexport const init = APIManagerModule.init.bind(APIManagerModule);\nexport default APIManagerModule;","/**\r\n * Cache Manager Module\r\n * \r\n * Provides intelligent caching for API responses and computed values.\r\n * Features:\r\n * - Memory cache\r\n * - IndexedDB cache\r\n * - Cache invalidation strategies\r\n * - Cache warming\r\n * - Cache analytics\r\n * - Integration with RequestDeduplicator\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * Cache strategies\r\n */\r\nexport const CacheStrategy = {\r\n    NO_CACHE: 'no-cache',\r\n    CACHE_FIRST: 'cache-first',\r\n    NETWORK_FIRST: 'network-first',\r\n    STALE_WHILE_REVALIDATE: 'stale-while-revalidate',\r\n    NETWORK_ONLY: 'network-only',\r\n    CACHE_ONLY: 'cache-only'\r\n};\r\n\r\n/**\r\n * CacheManager - Intelligent caching system\r\n */\r\nexport class CacheManager {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            defaultStrategy: config.defaultStrategy || CacheStrategy.STALE_WHILE_REVALIDATE,\r\n            defaultTTL: config.defaultTTL || 3600000, // 1 hour\r\n            maxMemorySize: config.maxMemorySize || 50, // Max 50 items in memory\r\n            enableIndexedDB: config.enableIndexedDB ?? true,\r\n            indexedDBName: config.indexedDBName || 'app-cache',\r\n            indexedDBVersion: config.indexedDBVersion || 1,\r\n            enableAnalytics: config.enableAnalytics ?? false,\r\n            ...config\r\n        };\r\n        \r\n        this.memoryCache = new Map(); // Map<key, CacheEntry>\r\n        this.indexedDBCache = null;\r\n        this.analytics = {\r\n            hits: 0,\r\n            misses: 0,\r\n            sets: 0,\r\n            deletes: 0\r\n        };\r\n        \r\n        // Initialize\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Create a new CacheManager instance\r\n     */\r\n    static create(config = {}) {\r\n        return new CacheManager(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize cache manager\r\n     */\r\n    async init() {\r\n        // Initialize IndexedDB if enabled\r\n        if (this.config.enableIndexedDB && 'indexedDB' in window) {\r\n            try {\r\n                await this.initIndexedDB();\r\n            } catch (error) {\r\n                Logger.error('[CacheManager] Failed to initialize IndexedDB', error);\r\n                this.config.enableIndexedDB = false;\r\n            }\r\n        }\r\n        \r\n        Logger.info('[CacheManager] Initialized', {\r\n            strategy: this.config.defaultStrategy,\r\n            memoryCache: true,\r\n            indexedDB: this.config.enableIndexedDB\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize IndexedDB\r\n     */\r\n    async initIndexedDB() {\r\n        return new Promise((resolve, reject) => {\r\n            const request = indexedDB.open(this.config.indexedDBName, this.config.indexedDBVersion);\r\n            \r\n            request.onerror = () => reject(request.error);\r\n            request.onsuccess = () => {\r\n                this.indexedDBCache = request.result;\r\n                resolve();\r\n            };\r\n            \r\n            request.onupgradeneeded = (event) => {\r\n                const db = event.target.result;\r\n                if (!db.objectStoreNames.contains('cache')) {\r\n                    db.createObjectStore('cache', { keyPath: 'key' });\r\n                }\r\n            };\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Get value from cache\r\n     */\r\n    async get(key, options = {}) {\r\n        const strategy = options.strategy || this.config.defaultStrategy;\r\n        const ttl = options.ttl || this.config.defaultTTL;\r\n        \r\n        // Check memory cache first\r\n        const memoryEntry = this.memoryCache.get(key);\r\n        if (memoryEntry && !this.isExpired(memoryEntry, ttl)) {\r\n            this.analytics.hits++;\r\n            Logger.debug('[CacheManager] Cache hit (memory)', key);\r\n            return memoryEntry.value;\r\n        }\r\n        \r\n        // Check IndexedDB if enabled\r\n        if (this.config.enableIndexedDB && this.indexedDBCache) {\r\n            try {\r\n                const indexedDBEntry = await this.getFromIndexedDB(key);\r\n                if (indexedDBEntry && !this.isExpired(indexedDBEntry, ttl)) {\r\n                    // Promote to memory cache\r\n                    this.memoryCache.set(key, indexedDBEntry);\r\n                    this.analytics.hits++;\r\n                    Logger.debug('[CacheManager] Cache hit (IndexedDB)', key);\r\n                    return indexedDBEntry.value;\r\n                }\r\n            } catch (error) {\r\n                Logger.error('[CacheManager] IndexedDB get error', error);\r\n            }\r\n        }\r\n        \r\n        this.analytics.misses++;\r\n        Logger.debug('[CacheManager] Cache miss', key);\r\n        return null;\r\n    }\r\n    \r\n    /**\r\n     * Set value in cache\r\n     */\r\n    async set(key, value, options = {}) {\r\n        const ttl = options.ttl || this.config.defaultTTL;\r\n        const strategy = options.strategy || this.config.defaultStrategy;\r\n        \r\n        const entry = {\r\n            key,\r\n            value,\r\n            timestamp: Date.now(),\r\n            ttl,\r\n            strategy\r\n        };\r\n        \r\n        // Store in memory cache\r\n        this.memoryCache.set(key, entry);\r\n        \r\n        // Limit memory cache size\r\n        if (this.memoryCache.size > this.config.maxMemorySize) {\r\n            const firstKey = this.memoryCache.keys().next().value;\r\n            this.memoryCache.delete(firstKey);\r\n        }\r\n        \r\n        // Store in IndexedDB if enabled\r\n        if (this.config.enableIndexedDB && this.indexedDBCache) {\r\n            try {\r\n                await this.setInIndexedDB(entry);\r\n            } catch (error) {\r\n                Logger.error('[CacheManager] IndexedDB set error', error);\r\n            }\r\n        }\r\n        \r\n        this.analytics.sets++;\r\n        Logger.debug('[CacheManager] Cache set', key);\r\n    }\r\n    \r\n    /**\r\n     * Get or compute value (cache-aside pattern)\r\n     */\r\n    async getOrSet(key, computeFn, options = {}) {\r\n        const strategy = options.strategy || this.config.defaultStrategy;\r\n        \r\n        // Try cache first (unless network-only)\r\n        if (strategy !== CacheStrategy.NETWORK_ONLY) {\r\n            const cached = await this.get(key, options);\r\n            if (cached !== null) {\r\n                return cached;\r\n            }\r\n        }\r\n        \r\n        // Compute value\r\n        const value = await computeFn();\r\n        \r\n        // Store in cache (unless no-cache)\r\n        if (strategy !== CacheStrategy.NO_CACHE) {\r\n            await this.set(key, value, options);\r\n        }\r\n        \r\n        return value;\r\n    }\r\n    \r\n    /**\r\n     * Delete value from cache\r\n     */\r\n    async delete(key) {\r\n        // Delete from memory\r\n        this.memoryCache.delete(key);\r\n        \r\n        // Delete from IndexedDB\r\n        if (this.config.enableIndexedDB && this.indexedDBCache) {\r\n            try {\r\n                await this.deleteFromIndexedDB(key);\r\n            } catch (error) {\r\n                Logger.error('[CacheManager] IndexedDB delete error', error);\r\n            }\r\n        }\r\n        \r\n        this.analytics.deletes++;\r\n        Logger.debug('[CacheManager] Cache delete', key);\r\n    }\r\n    \r\n    /**\r\n     * Clear all cache\r\n     */\r\n    async clear() {\r\n        this.memoryCache.clear();\r\n        \r\n        if (this.config.enableIndexedDB && this.indexedDBCache) {\r\n            try {\r\n                await this.clearIndexedDB();\r\n            } catch (error) {\r\n                Logger.error('[CacheManager] IndexedDB clear error', error);\r\n            }\r\n        }\r\n        \r\n        Logger.info('[CacheManager] Cache cleared');\r\n    }\r\n    \r\n    /**\r\n     * Invalidate cache by pattern\r\n     */\r\n    async invalidate(pattern) {\r\n        const keysToDelete = [];\r\n        \r\n        // Find matching keys in memory\r\n        for (const key of this.memoryCache.keys()) {\r\n            if (this.matchesPattern(key, pattern)) {\r\n                keysToDelete.push(key);\r\n            }\r\n        }\r\n        \r\n        // Delete matching keys\r\n        for (const key of keysToDelete) {\r\n            await this.delete(key);\r\n        }\r\n        \r\n        Logger.info('[CacheManager] Invalidated cache', { pattern, count: keysToDelete.length });\r\n    }\r\n    \r\n    /**\r\n     * Check if key matches pattern\r\n     */\r\n    matchesPattern(key, pattern) {\r\n        if (typeof pattern === 'string') {\r\n            return key.includes(pattern);\r\n        }\r\n        if (pattern instanceof RegExp) {\r\n            return pattern.test(key);\r\n        }\r\n        if (typeof pattern === 'function') {\r\n            return pattern(key);\r\n        }\r\n        return false;\r\n    }\r\n    \r\n    /**\r\n     * Check if cache entry is expired\r\n     */\r\n    isExpired(entry, ttl) {\r\n        if (!entry || !entry.timestamp) {\r\n            return true;\r\n        }\r\n        \r\n        const age = Date.now() - entry.timestamp;\r\n        return age > (entry.ttl || ttl);\r\n    }\r\n    \r\n    /**\r\n     * Get from IndexedDB\r\n     */\r\n    async getFromIndexedDB(key) {\r\n        return new Promise((resolve, reject) => {\r\n            const transaction = this.indexedDBCache.transaction(['cache'], 'readonly');\r\n            const store = transaction.objectStore('cache');\r\n            const request = store.get(key);\r\n            \r\n            request.onsuccess = () => resolve(request.result);\r\n            request.onerror = () => reject(request.error);\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Set in IndexedDB\r\n     */\r\n    async setInIndexedDB(entry) {\r\n        return new Promise((resolve, reject) => {\r\n            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');\r\n            const store = transaction.objectStore('cache');\r\n            const request = store.put(entry);\r\n            \r\n            request.onsuccess = () => resolve();\r\n            request.onerror = () => reject(request.error);\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Delete from IndexedDB\r\n     */\r\n    async deleteFromIndexedDB(key) {\r\n        return new Promise((resolve, reject) => {\r\n            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');\r\n            const store = transaction.objectStore('cache');\r\n            const request = store.delete(key);\r\n            \r\n            request.onsuccess = () => resolve();\r\n            request.onerror = () => reject(request.error);\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Clear IndexedDB\r\n     */\r\n    async clearIndexedDB() {\r\n        return new Promise((resolve, reject) => {\r\n            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');\r\n            const store = transaction.objectStore('cache');\r\n            const request = store.clear();\r\n            \r\n            request.onsuccess = () => resolve();\r\n            request.onerror = () => reject(request.error);\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Warm cache (preload values)\r\n     */\r\n    async warm(keys, computeFn) {\r\n        Logger.info('[CacheManager] Warming cache', { count: keys.length });\r\n        \r\n        for (const key of keys) {\r\n            try {\r\n                await this.getOrSet(key, () => computeFn(key));\r\n            } catch (error) {\r\n                Logger.error(`[CacheManager] Failed to warm cache for ${key}`, error);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get cache analytics\r\n     */\r\n    getAnalytics() {\r\n        const total = this.analytics.hits + this.analytics.misses;\r\n        const hitRate = total > 0 ? (this.analytics.hits / total) * 100 : 0;\r\n        \r\n        return {\r\n            ...this.analytics,\r\n            total,\r\n            hitRate: Math.round(hitRate * 100) / 100,\r\n            memorySize: this.memoryCache.size,\r\n            memoryMaxSize: this.config.maxMemorySize\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Reset analytics\r\n     */\r\n    resetAnalytics() {\r\n        this.analytics = {\r\n            hits: 0,\r\n            misses: 0,\r\n            sets: 0,\r\n            deletes: 0\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Destroy cache manager\r\n     */\r\n    destroy() {\r\n        this.memoryCache.clear();\r\n        this.indexedDBCache = null;\r\n        Logger.info('[CacheManager] Destroyed');\r\n    }\r\n}\r\n\r\n","/**\r\n * Cache Strategy Definitions\r\n * \r\n * Defines different caching strategies for the CacheManager.\r\n */\r\n\r\nexport const CacheStrategy = {\r\n    /**\r\n     * No caching - always fetch from source\r\n     */\r\n    NO_CACHE: 'no-cache',\r\n    \r\n    /**\r\n     * Cache first - use cache if available, otherwise fetch\r\n     */\r\n    CACHE_FIRST: 'cache-first',\r\n    \r\n    /**\r\n     * Network first - try network first, fallback to cache\r\n     */\r\n    NETWORK_FIRST: 'network-first',\r\n    \r\n    /**\r\n     * Stale while revalidate - return cache immediately, update in background\r\n     */\r\n    STALE_WHILE_REVALIDATE: 'stale-while-revalidate',\r\n    \r\n    /**\r\n     * Network only - always fetch from network, never use cache\r\n     */\r\n    NETWORK_ONLY: 'network-only',\r\n    \r\n    /**\r\n     * Cache only - only use cache, never fetch from network\r\n     */\r\n    CACHE_ONLY: 'cache-only'\r\n};\r\n\r\n/**\r\n * Get default strategy for a use case\r\n */\r\nexport function getStrategyForUseCase(useCase) {\r\n    const strategies = {\r\n        'api-response': CacheStrategy.STALE_WHILE_REVALIDATE,\r\n        'user-data': CacheStrategy.CACHE_FIRST,\r\n        'real-time': CacheStrategy.NETWORK_ONLY,\r\n        'static-content': CacheStrategy.CACHE_ONLY,\r\n        'computed-value': CacheStrategy.CACHE_FIRST\r\n    };\r\n    \r\n    return strategies[useCase] || CacheStrategy.STALE_WHILE_REVALIDATE;\r\n}\r\n\r\n","/**\r\n * Cache Manager Module\r\n * \r\n * Provides intelligent caching for API responses and computed values.\r\n * \r\n * Usage:\r\n * - Add data-module=\"cache-manager\" to enable global cache manager\r\n * - Or import and use directly: import { CacheManager } from './modules/cache-manager/index.js'\r\n * \r\n * Features:\r\n * - Memory cache\r\n * - IndexedDB cache\r\n * - Cache invalidation strategies\r\n * - Cache warming\r\n * - Cache analytics\r\n * - Integration with RequestDeduplicator\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { CacheManager, CacheStrategy } from './CacheManager.js';\r\nimport { getStrategyForUseCase } from './CacheStrategy.js';\r\n\r\nconst CacheManagerModule = {\r\n    name: 'cache-manager',\r\n    cacheManager: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[CacheManagerModule] Module initialized');\r\n        \r\n        // Create cache manager\r\n        this.cacheManager = CacheManager.create(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.CacheManager = this.cacheManager;\r\n            window.CacheStrategy = CacheStrategy;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get cache manager instance\r\n     */\r\n    getCacheManager() {\r\n        return this.cacheManager || CacheManager.create();\r\n    },\r\n    \r\n    /**\r\n     * Get value from cache\r\n     */\r\n    async get(key, options = {}) {\r\n        const cache = this.getCacheManager();\r\n        return await cache.get(key, options);\r\n    },\r\n    \r\n    /**\r\n     * Set value in cache\r\n     */\r\n    async set(key, value, options = {}) {\r\n        const cache = this.getCacheManager();\r\n        return await cache.set(key, value, options);\r\n    },\r\n    \r\n    /**\r\n     * Get or compute value\r\n     */\r\n    async getOrSet(key, computeFn, options = {}) {\r\n        const cache = this.getCacheManager();\r\n        return await cache.getOrSet(key, computeFn, options);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.cacheManager) {\r\n            this.cacheManager.destroy();\r\n            this.cacheManager = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined') {\r\n            delete window.CacheManager;\r\n            delete window.CacheStrategy;\r\n        }\r\n        \r\n        Logger.info('[CacheManagerModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { CacheManager, CacheStrategy, getStrategyForUseCase };\r\n\r\n// Export as default for module system\r\nexport default CacheManagerModule;\r\n\r\n// Export init function for module system\r\nexport const init = CacheManagerModule.init.bind(CacheManagerModule);\r\n\r\n","// modules/core/EventManager.js\nconst registry = new Map();\n\nexport const EventManager = {\n    /**\n     * Fügt einen EventListener hinzu und speichert ihn im Modul-Kontext\n     */\n    add(target, type, handler, { module = 'global', options = false } = {}) {\n        target.addEventListener(type, handler, options);\n        if (!registry.has(module)) registry.set(module, []);\n        registry.get(module).push([target, type, handler, options]);\n    },\n\n    /**\n     * Entfernt alle Listener, die für ein bestimmtes Modul registriert wurden\n     */\n    removeModule(module) {\n        const entries = registry.get(module);\n        if (!entries) return;\n\n        entries.forEach(([target, type, handler, options]) => {\n            target.removeEventListener(type, handler, options);\n        });\n\n        registry.delete(module);\n    },\n\n    /**\n     * Entfernt alle Event-Listener aus allen Modulen\n     */\n    clearAll() {\n        for (const [module, entries] of registry.entries()) {\n            entries.forEach(([target, type, handler, options]) => {\n                target.removeEventListener(type, handler, options);\n            });\n        }\n        registry.clear();\n    },\n\n    /**\n     * Debug: Gibt die aktuelle Registry in der Konsole aus\n     */\n    debug() {\n        console.table([...registry.entries()].map(([module, events]) => ({\n            module,\n            listeners: events.length\n        })));\n    }\n};\n","// modules/core/useEvent.js\nimport { EventManager } from './EventManager.js';\n\n/**\n * Vereinfachte Kurzform zur Registrierung eines EventListeners\n *\n * @param {EventTarget} target - Das Element, auf das der Event gehört\n * @param {string} type - Der Eventtyp (z.B. 'click')\n * @param {Function} handler - Die Callback-Funktion\n * @param {object} meta - Optionen oder automatisch aus `import.meta` (optional)\n * @param {Object|boolean} options - EventListener-Optionen\n */\nexport function useEvent(target, type, handler, meta = import.meta, options = false) {\n    const module = typeof meta === 'string'\n        ? meta\n        : (meta.url?.split('/').slice(-2, -1)[0] || 'unknown');\n\n    EventManager.add(target, type, handler, { module, options });\n\n    return () => {\n        EventManager.removeModule(module);\n    }\n}\n","// modules/canvas-animations/CanvasManager.js\nimport { useEvent } from '../../core/useEvent.js';\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Canvas Manager - Handles canvas setup, resizing, and basic operations\n */\nexport class CanvasManager {\n    constructor(canvas, options = {}) {\n        this.canvas = canvas;\n        this.ctx = canvas.getContext('2d');\n        this.options = {\n            responsive: true,\n            pixelRatio: window.devicePixelRatio || 1,\n            ...options\n        };\n        \n        this.animationId = null;\n        this.isAnimating = false;\n        \n        this.init();\n    }\n    \n    /**\n     * Initialize canvas manager\n     */\n    init() {\n        this.setupCanvas();\n        \n        if (this.options.responsive) {\n            this.setupResponsive();\n        }\n        \n        Logger.info('[CanvasManager] Initialized', {\n            width: this.canvas.width,\n            height: this.canvas.height,\n            pixelRatio: this.options.pixelRatio\n        });\n    }\n    \n    /**\n     * Setup initial canvas properties\n     */\n    setupCanvas() {\n        this.resize();\n        \n        // Set CSS to prevent blurriness on high-DPI displays\n        this.canvas.style.width = this.canvas.width + 'px';\n        this.canvas.style.height = this.canvas.height + 'px';\n        \n        // Scale context for high-DPI displays\n        if (this.options.pixelRatio > 1) {\n            this.ctx.scale(this.options.pixelRatio, this.options.pixelRatio);\n        }\n    }\n    \n    /**\n     * Setup responsive behavior\n     */\n    setupResponsive() {\n        // Resize on window resize\n        useEvent(window, 'resize', () => {\n            this.resize();\n        }, 'canvas-manager');\n        \n        // Optional: Resize on orientation change for mobile\n        useEvent(window, 'orientationchange', () => {\n            setTimeout(() => this.resize(), 100);\n        }, 'canvas-manager');\n    }\n    \n    /**\n     * Resize canvas to match container or window\n     */\n    resize() {\n        const container = this.canvas.parentElement;\n        const pixelRatio = this.options.pixelRatio;\n        \n        // Get display size\n        let displayWidth, displayHeight;\n        \n        if (container && getComputedStyle(container).position !== 'static') {\n            // Use container size if it has positioning\n            displayWidth = container.clientWidth;\n            displayHeight = container.clientHeight;\n        } else {\n            // Fallback to canvas CSS size or window size\n            displayWidth = this.canvas.clientWidth || window.innerWidth;\n            displayHeight = this.canvas.clientHeight || window.innerHeight;\n        }\n        \n        // Set actual canvas size\n        this.canvas.width = Math.floor(displayWidth * pixelRatio);\n        this.canvas.height = Math.floor(displayHeight * pixelRatio);\n        \n        // Set CSS size\n        this.canvas.style.width = displayWidth + 'px';\n        this.canvas.style.height = displayHeight + 'px';\n        \n        // Re-scale context if needed\n        if (pixelRatio > 1) {\n            this.ctx.scale(pixelRatio, pixelRatio);\n        }\n        \n        Logger.info('[CanvasManager] Resized', {\n            displayWidth,\n            displayHeight,\n            canvasWidth: this.canvas.width,\n            canvasHeight: this.canvas.height\n        });\n    }\n    \n    /**\n     * Clear the entire canvas\n     */\n    clear() {\n        this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n    }\n    \n    /**\n     * Get canvas dimensions (display size, not pixel size)\n     */\n    getSize() {\n        return {\n            width: this.canvas.clientWidth,\n            height: this.canvas.clientHeight,\n            pixelWidth: this.canvas.width,\n            pixelHeight: this.canvas.height\n        };\n    }\n    \n    /**\n     * Get mouse position relative to canvas\n     */\n    getMousePosition(event) {\n        const rect = this.canvas.getBoundingClientRect();\n        return {\n            x: (event.clientX - rect.left) * this.options.pixelRatio,\n            y: (event.clientY - rect.top) * this.options.pixelRatio\n        };\n    }\n    \n    /**\n     * Start animation loop\n     */\n    startAnimation(animationFunction) {\n        if (this.isAnimating) {\n            this.stopAnimation();\n        }\n        \n        this.isAnimating = true;\n        \n        const animate = (timestamp) => {\n            if (!this.isAnimating) return;\n            \n            animationFunction(timestamp);\n            this.animationId = requestAnimationFrame(animate);\n        };\n        \n        this.animationId = requestAnimationFrame(animate);\n        Logger.info('[CanvasManager] Animation started');\n    }\n    \n    /**\n     * Stop animation loop\n     */\n    stopAnimation() {\n        if (this.animationId) {\n            cancelAnimationFrame(this.animationId);\n            this.animationId = null;\n        }\n        this.isAnimating = false;\n        Logger.info('[CanvasManager] Animation stopped');\n    }\n    \n    /**\n     * Cleanup canvas manager\n     */\n    destroy() {\n        this.stopAnimation();\n        // Event cleanup is handled by useEvent system\n        Logger.info('[CanvasManager] Destroyed');\n    }\n}","// modules/canvas-animations/ScrollEffects.js\nimport { CanvasManager } from './CanvasManager.js';\nimport { useEvent } from '../../core/useEvent.js';\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Scroll-based Canvas Effects - Parallax and scroll animations\n */\nexport const ScrollEffects = {\n    \n    /**\n     * Initialize parallax canvas effect\n     */\n    initParallax(canvas, config) {\n        const manager = new CanvasManager(canvas);\n        const elements = this.createParallaxElements(canvas, config);\n        \n        let ticking = false;\n        \n        const updateParallax = () => {\n            if (!ticking) {\n                requestAnimationFrame(() => {\n                    this.renderParallax(manager, elements, config);\n                    ticking = false;\n                });\n                ticking = true;\n            }\n        };\n        \n        // Listen to scroll events\n        useEvent(window, 'scroll', updateParallax, 'scroll-parallax');\n        useEvent(window, 'resize', updateParallax, 'scroll-parallax');\n        \n        // Initial render\n        updateParallax();\n        \n        Logger.info('[ScrollEffects] Parallax initialized with', elements.length, 'elements');\n    },\n    \n    /**\n     * Create parallax elements based on config\n     */\n    createParallaxElements(canvas, config) {\n        const elements = [];\n        const layerCount = config.layers || 3;\n        const elementCount = config.elements || 20;\n        \n        for (let i = 0; i < elementCount; i++) {\n            elements.push({\n                x: Math.random() * canvas.clientWidth,\n                y: Math.random() * canvas.clientHeight * 2, // Allow elements outside viewport\n                size: Math.random() * 20 + 5,\n                layer: Math.floor(Math.random() * layerCount),\n                speed: 0.1 + (Math.random() * 0.5), // Different parallax speeds\n                opacity: Math.random() * 0.7 + 0.3,\n                color: this.getLayerColor(Math.floor(Math.random() * layerCount), config)\n            });\n        }\n        \n        return elements;\n    },\n    \n    /**\n     * Get color for parallax layer\n     */\n    getLayerColor(layer, config) {\n        const colors = config.colors || [\n            'rgba(100, 150, 255, 0.6)',  // Front layer - more opaque\n            'rgba(150, 100, 255, 0.4)',  // Middle layer\n            'rgba(200, 100, 150, 0.2)'   // Back layer - more transparent\n        ];\n        return colors[layer] || colors[0];\n    },\n    \n    /**\n     * Render parallax effect\n     */\n    renderParallax(manager, elements, config) {\n        manager.clear();\n        \n        const scrollY = window.pageYOffset;\n        const canvasRect = manager.canvas.getBoundingClientRect();\n        const canvasTop = canvasRect.top + scrollY;\n        \n        // Calculate relative scroll position\n        const relativeScroll = scrollY - canvasTop;\n        const scrollProgress = relativeScroll / window.innerHeight;\n        \n        elements.forEach(element => {\n            // Apply parallax offset based on layer and scroll\n            const parallaxOffset = scrollProgress * element.speed * 100;\n            const y = element.y - parallaxOffset;\n            \n            // Only render elements that are potentially visible\n            if (y > -element.size && y < manager.canvas.clientHeight + element.size) {\n                manager.ctx.save();\n                manager.ctx.globalAlpha = element.opacity;\n                manager.ctx.fillStyle = element.color;\n                manager.ctx.beginPath();\n                manager.ctx.arc(element.x, y, element.size, 0, Math.PI * 2);\n                manager.ctx.fill();\n                manager.ctx.restore();\n            }\n        });\n    },\n    \n    /**\n     * Initialize scroll-based animations\n     */\n    initScrollAnimation(canvas, config) {\n        const manager = new CanvasManager(canvas);\n        const animationType = config.animation || 'wave';\n        \n        let ticking = false;\n        \n        const updateAnimation = () => {\n            if (!ticking) {\n                requestAnimationFrame(() => {\n                    this.renderScrollAnimation(manager, animationType, config);\n                    ticking = false;\n                });\n                ticking = true;\n            }\n        };\n        \n        useEvent(window, 'scroll', updateAnimation, 'scroll-animation');\n        useEvent(window, 'resize', updateAnimation, 'scroll-animation');\n        \n        // Initial render\n        updateAnimation();\n        \n        Logger.info('[ScrollEffects] Scroll animation initialized:', animationType);\n    },\n    \n    /**\n     * Render scroll-based animations\n     */\n    renderScrollAnimation(manager, animationType, config) {\n        manager.clear();\n        \n        const scrollY = window.pageYOffset;\n        const canvasRect = manager.canvas.getBoundingClientRect();\n        const canvasTop = canvasRect.top + scrollY;\n        const relativeScroll = scrollY - canvasTop;\n        const scrollProgress = Math.max(0, Math.min(1, relativeScroll / window.innerHeight));\n        \n        switch (animationType) {\n            case 'wave':\n                this.renderWaveAnimation(manager, scrollProgress, config);\n                break;\n            case 'progress':\n                this.renderProgressAnimation(manager, scrollProgress, config);\n                break;\n            case 'morph':\n                this.renderMorphAnimation(manager, scrollProgress, config);\n                break;\n            default:\n                this.renderWaveAnimation(manager, scrollProgress, config);\n        }\n    },\n    \n    /**\n     * Render wave animation based on scroll\n     */\n    renderWaveAnimation(manager, progress, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        ctx.strokeStyle = config.color || 'rgba(100, 150, 255, 0.8)';\n        ctx.lineWidth = config.lineWidth || 3;\n        \n        ctx.beginPath();\n        \n        const amplitude = (config.amplitude || 50) * progress;\n        const frequency = config.frequency || 0.02;\n        const phase = progress * Math.PI * 2;\n        \n        for (let x = 0; x <= width; x += 2) {\n            const y = height / 2 + Math.sin(x * frequency + phase) * amplitude;\n            \n            if (x === 0) {\n                ctx.moveTo(x, y);\n            } else {\n                ctx.lineTo(x, y);\n            }\n        }\n        \n        ctx.stroke();\n    },\n    \n    /**\n     * Render progress bar animation\n     */\n    renderProgressAnimation(manager, progress, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        const barHeight = config.barHeight || 10;\n        const y = height / 2 - barHeight / 2;\n        \n        // Background\n        ctx.fillStyle = config.backgroundColor || 'rgba(255, 255, 255, 0.2)';\n        ctx.fillRect(0, y, width, barHeight);\n        \n        // Progress\n        ctx.fillStyle = config.color || 'rgba(100, 150, 255, 0.8)';\n        ctx.fillRect(0, y, width * progress, barHeight);\n    },\n    \n    /**\n     * Render morphing shapes\n     */\n    renderMorphAnimation(manager, progress, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        ctx.fillStyle = config.color || 'rgba(100, 150, 255, 0.6)';\n        \n        const centerX = width / 2;\n        const centerY = height / 2;\n        const maxRadius = Math.min(width, height) / 3;\n        \n        ctx.beginPath();\n        \n        const points = config.points || 6;\n        for (let i = 0; i <= points; i++) {\n            const angle = (i / points) * Math.PI * 2;\n            const radiusVariation = Math.sin(progress * Math.PI * 4 + angle * 3) * 0.3 + 1;\n            const radius = maxRadius * progress * radiusVariation;\n            \n            const x = centerX + Math.cos(angle) * radius;\n            const y = centerY + Math.sin(angle) * radius;\n            \n            if (i === 0) {\n                ctx.moveTo(x, y);\n            } else {\n                ctx.lineTo(x, y);\n            }\n        }\n        \n        ctx.closePath();\n        ctx.fill();\n    }\n};","// modules/canvas-animations/InteractiveEffects.js\nimport { CanvasManager } from './CanvasManager.js';\nimport { useEvent } from '../../core/useEvent.js';\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Interactive Canvas Effects - Mouse/touch interactions, hover effects\n */\nexport const InteractiveEffects = {\n    \n    /**\n     * Initialize interactive canvas\n     */\n    init(canvas, config) {\n        const manager = new CanvasManager(canvas);\n        const effectType = config.effect || 'ripple';\n        \n        const state = {\n            mouse: { x: 0, y: 0, isOver: false },\n            effects: [],\n            lastTime: 0\n        };\n        \n        this.setupInteractionEvents(canvas, manager, state, config);\n        this.startAnimationLoop(manager, state, effectType, config);\n        \n        Logger.info('[InteractiveEffects] Initialized with effect:', effectType);\n    },\n    \n    /**\n     * Setup mouse/touch interaction events\n     */\n    setupInteractionEvents(canvas, manager, state, config) {\n        // Mouse events\n        useEvent(canvas, 'mousemove', (e) => {\n            const pos = manager.getMousePosition(e);\n            state.mouse.x = pos.x;\n            state.mouse.y = pos.y;\n            \n            if (config.effect === 'trail') {\n                this.addTrailPoint(state, pos.x, pos.y);\n            }\n        }, 'interactive-effects');\n        \n        useEvent(canvas, 'mouseenter', () => {\n            state.mouse.isOver = true;\n        }, 'interactive-effects');\n        \n        useEvent(canvas, 'mouseleave', () => {\n            state.mouse.isOver = false;\n        }, 'interactive-effects');\n        \n        useEvent(canvas, 'click', (e) => {\n            const pos = manager.getMousePosition(e);\n            this.addClickEffect(state, pos.x, pos.y, config);\n        }, 'interactive-effects');\n        \n        // Touch events for mobile\n        useEvent(canvas, 'touchstart', (e) => {\n            e.preventDefault();\n            const touch = e.touches[0];\n            const pos = manager.getMousePosition(touch);\n            this.addClickEffect(state, pos.x, pos.y, config);\n        }, 'interactive-effects');\n        \n        useEvent(canvas, 'touchmove', (e) => {\n            e.preventDefault();\n            const touch = e.touches[0];\n            const pos = manager.getMousePosition(touch);\n            state.mouse.x = pos.x;\n            state.mouse.y = pos.y;\n            state.mouse.isOver = true;\n            \n            if (config.effect === 'trail') {\n                this.addTrailPoint(state, pos.x, pos.y);\n            }\n        }, 'interactive-effects');\n        \n        useEvent(canvas, 'touchend', () => {\n            state.mouse.isOver = false;\n        }, 'interactive-effects');\n    },\n    \n    /**\n     * Start animation loop\n     */\n    startAnimationLoop(manager, state, effectType, config) {\n        const animate = (timestamp) => {\n            const deltaTime = timestamp - state.lastTime;\n            state.lastTime = timestamp;\n            \n            manager.clear();\n            \n            switch (effectType) {\n                case 'ripple':\n                    this.renderRippleEffect(manager, state, config);\n                    break;\n                case 'trail':\n                    this.renderTrailEffect(manager, state, config);\n                    break;\n                case 'particles':\n                    this.renderParticleEffect(manager, state, config, deltaTime);\n                    break;\n                case 'magnetic':\n                    this.renderMagneticEffect(manager, state, config);\n                    break;\n                default:\n                    this.renderRippleEffect(manager, state, config);\n            }\n            \n            // Update effects\n            this.updateEffects(state.effects, deltaTime);\n            \n            requestAnimationFrame(animate);\n        };\n        \n        requestAnimationFrame(animate);\n    },\n    \n    /**\n     * Add click effect (ripple, explosion, etc.)\n     */\n    addClickEffect(state, x, y, config) {\n        const effect = {\n            x,\n            y,\n            age: 0,\n            maxAge: config.duration || 1000,\n            type: 'click',\n            intensity: config.intensity || 1\n        };\n        \n        state.effects.push(effect);\n    },\n    \n    /**\n     * Add trail point for mouse trail effect\n     */\n    addTrailPoint(state, x, y) {\n        const point = {\n            x,\n            y,\n            age: 0,\n            maxAge: 500,\n            type: 'trail'\n        };\n        \n        state.effects.push(point);\n        \n        // Limit trail length\n        const trailLength = 20;\n        const trailPoints = state.effects.filter(e => e.type === 'trail');\n        if (trailPoints.length > trailLength) {\n            const oldestIndex = state.effects.indexOf(trailPoints[0]);\n            state.effects.splice(oldestIndex, 1);\n        }\n    },\n    \n    /**\n     * Render ripple effect\n     */\n    renderRippleEffect(manager, state, config) {\n        const { ctx } = manager;\n        \n        // Draw active ripples\n        state.effects.forEach(effect => {\n            if (effect.type === 'click') {\n                const progress = effect.age / effect.maxAge;\n                const radius = progress * (config.maxRadius || 100);\n                const opacity = (1 - progress) * 0.8;\n                \n                ctx.save();\n                ctx.globalAlpha = opacity;\n                ctx.strokeStyle = config.color || 'rgba(100, 150, 255, 1)';\n                ctx.lineWidth = config.lineWidth || 3;\n                ctx.beginPath();\n                ctx.arc(effect.x / manager.options.pixelRatio, effect.y / manager.options.pixelRatio, radius, 0, Math.PI * 2);\n                ctx.stroke();\n                ctx.restore();\n            }\n        });\n        \n        // Draw hover effect\n        if (state.mouse.isOver) {\n            ctx.save();\n            ctx.globalAlpha = 0.3;\n            ctx.fillStyle = config.hoverColor || 'rgba(100, 150, 255, 0.3)';\n            ctx.beginPath();\n            ctx.arc(\n                state.mouse.x / manager.options.pixelRatio, \n                state.mouse.y / manager.options.pixelRatio, \n                config.hoverRadius || 30, \n                0, \n                Math.PI * 2\n            );\n            ctx.fill();\n            ctx.restore();\n        }\n    },\n    \n    /**\n     * Render trail effect\n     */\n    renderTrailEffect(manager, state, config) {\n        const { ctx } = manager;\n        const trailPoints = state.effects.filter(e => e.type === 'trail');\n        \n        if (trailPoints.length < 2) return;\n        \n        ctx.save();\n        ctx.strokeStyle = config.color || 'rgba(100, 150, 255, 0.8)';\n        ctx.lineWidth = config.lineWidth || 5;\n        ctx.lineCap = 'round';\n        ctx.lineJoin = 'round';\n        \n        // Draw trail path\n        ctx.beginPath();\n        trailPoints.forEach((point, index) => {\n            const progress = 1 - (point.age / point.maxAge);\n            const x = point.x / manager.options.pixelRatio;\n            const y = point.y / manager.options.pixelRatio;\n            \n            ctx.globalAlpha = progress * 0.8;\n            \n            if (index === 0) {\n                ctx.moveTo(x, y);\n            } else {\n                ctx.lineTo(x, y);\n            }\n        });\n        \n        ctx.stroke();\n        ctx.restore();\n    },\n    \n    /**\n     * Render particle effect\n     */\n    renderParticleEffect(manager, state, config, deltaTime) {\n        const { ctx } = manager;\n        \n        // Spawn particles on mouse move\n        if (state.mouse.isOver && Math.random() < 0.1) {\n            const particle = {\n                x: state.mouse.x,\n                y: state.mouse.y,\n                vx: (Math.random() - 0.5) * 4,\n                vy: (Math.random() - 0.5) * 4,\n                age: 0,\n                maxAge: 1000,\n                size: Math.random() * 5 + 2,\n                type: 'particle'\n            };\n            state.effects.push(particle);\n        }\n        \n        // Update and draw particles\n        state.effects.forEach(effect => {\n            if (effect.type === 'particle') {\n                // Update position\n                effect.x += effect.vx;\n                effect.y += effect.vy;\n                effect.vy += 0.1; // Gravity\n                \n                const progress = effect.age / effect.maxAge;\n                const opacity = (1 - progress) * 0.8;\n                \n                ctx.save();\n                ctx.globalAlpha = opacity;\n                ctx.fillStyle = config.color || 'rgba(100, 150, 255, 1)';\n                ctx.beginPath();\n                ctx.arc(\n                    effect.x / manager.options.pixelRatio, \n                    effect.y / manager.options.pixelRatio, \n                    effect.size * (1 - progress * 0.5), \n                    0, \n                    Math.PI * 2\n                );\n                ctx.fill();\n                ctx.restore();\n            }\n        });\n    },\n    \n    /**\n     * Render magnetic effect\n     */\n    renderMagneticEffect(manager, state, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        if (!state.mouse.isOver) return;\n        \n        // Draw magnetic field lines\n        const centerX = width / 2;\n        const centerY = height / 2;\n        const mouseX = state.mouse.x / manager.options.pixelRatio;\n        const mouseY = state.mouse.y / manager.options.pixelRatio;\n        \n        ctx.save();\n        ctx.strokeStyle = config.color || 'rgba(100, 150, 255, 0.6)';\n        ctx.lineWidth = 2;\n        \n        const lines = 8;\n        for (let i = 0; i < lines; i++) {\n            const angle = (i / lines) * Math.PI * 2;\n            const startX = centerX + Math.cos(angle) * 50;\n            const startY = centerY + Math.sin(angle) * 50;\n            \n            // Curve towards mouse\n            const controlX = (startX + mouseX) / 2 + Math.sin(angle) * 30;\n            const controlY = (startY + mouseY) / 2 + Math.cos(angle) * 30;\n            \n            ctx.beginPath();\n            ctx.moveTo(startX, startY);\n            ctx.quadraticCurveTo(controlX, controlY, mouseX, mouseY);\n            ctx.stroke();\n        }\n        \n        ctx.restore();\n    },\n    \n    /**\n     * Update all effects (age and cleanup)\n     */\n    updateEffects(effects, deltaTime) {\n        for (let i = effects.length - 1; i >= 0; i--) {\n            effects[i].age += deltaTime;\n            \n            if (effects[i].age >= effects[i].maxAge) {\n                effects.splice(i, 1);\n            }\n        }\n    }\n};","// modules/canvas-animations/DataVisualization.js\nimport { CanvasManager } from './CanvasManager.js';\nimport { Logger } from '../../core/logger.js';\n\n/**\n * Data Visualization Canvas Components - Animated charts and graphs\n */\nexport const DataVisualization = {\n    \n    /**\n     * Initialize data visualization canvas\n     */\n    init(canvas, config) {\n        const manager = new CanvasManager(canvas);\n        const vizType = config.type || 'bar';\n        \n        // Get data from config or data attributes\n        const data = this.parseData(canvas, config);\n        \n        if (!data || data.length === 0) {\n            Logger.warn('[DataVisualization] No data provided for canvas');\n            return;\n        }\n        \n        switch (vizType) {\n            case 'bar':\n                this.createBarChart(manager, data, config);\n                break;\n            case 'line':\n                this.createLineChart(manager, data, config);\n                break;\n            case 'pie':\n                this.createPieChart(manager, data, config);\n                break;\n            case 'progress':\n                this.createProgressChart(manager, data, config);\n                break;\n            default:\n                this.createBarChart(manager, data, config);\n        }\n        \n        Logger.info('[DataVisualization] Initialized', vizType, 'chart with', data.length, 'data points');\n    },\n    \n    /**\n     * Parse data from canvas element or config\n     */\n    parseData(canvas, config) {\n        let data = config.data;\n        \n        // Try to get data from data-canvas-data attribute\n        if (!data && canvas.dataset.canvasData) {\n            try {\n                data = JSON.parse(canvas.dataset.canvasData);\n            } catch (e) {\n                Logger.warn('[DataVisualization] Failed to parse canvas data', e);\n            }\n        }\n        \n        // Try to get data from script tag\n        if (!data) {\n            const scriptTag = canvas.nextElementSibling;\n            if (scriptTag && scriptTag.tagName === 'SCRIPT' && scriptTag.type === 'application/json') {\n                try {\n                    data = JSON.parse(scriptTag.textContent);\n                } catch (e) {\n                    Logger.warn('[DataVisualization] Failed to parse script data', e);\n                }\n            }\n        }\n        \n        // Ensure data is always an array\n        if (!data) {\n            Logger.warn('[DataVisualization] No data found');\n            return [];\n        }\n        \n        // If data is not an array, wrap it or convert it\n        if (!Array.isArray(data)) {\n            // If it's a single number (for progress charts)\n            if (typeof data === 'number') {\n                data = [{ value: data, label: 'Progress' }];\n            }\n            // If it's an object with values, convert to array\n            else if (typeof data === 'object') {\n                data = Object.entries(data).map(([key, value]) => ({\n                    label: key,\n                    value: typeof value === 'object' ? value.value || value : value\n                }));\n            }\n            // Fallback: empty array\n            else {\n                Logger.warn('[DataVisualization] Data format not recognized:', data);\n                return [];\n            }\n        }\n        \n        return data;\n    },\n    \n    /**\n     * Create animated bar chart\n     */\n    createBarChart(manager, data, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        const padding = config.padding || 40;\n        const chartWidth = width - padding * 2;\n        const chartHeight = height - padding * 2;\n        \n        const barWidth = chartWidth / data.length * 0.8;\n        const barSpacing = chartWidth / data.length * 0.2;\n        const maxValue = Math.max(...data.map(d => d.value));\n        \n        let animationProgress = 0;\n        const animationDuration = config.animationDuration || 2000;\n        let startTime = null;\n        \n        const animate = (timestamp) => {\n            if (!startTime) startTime = timestamp;\n            const elapsed = timestamp - startTime;\n            \n            animationProgress = Math.min(elapsed / animationDuration, 1);\n            \n            // Easing function (easeOutCubic)\n            const progress = 1 - Math.pow(1 - animationProgress, 3);\n            \n            manager.clear();\n            this.renderBarChart(manager, data, config, progress, {\n                padding,\n                chartWidth,\n                chartHeight,\n                barWidth,\n                barSpacing,\n                maxValue\n            });\n            \n            if (animationProgress < 1) {\n                requestAnimationFrame(animate);\n            }\n        };\n        \n        requestAnimationFrame(animate);\n    },\n    \n    /**\n     * Render bar chart frame\n     */\n    renderBarChart(manager, data, config, progress, layout) {\n        const { ctx } = manager;\n        const { padding, chartHeight, barWidth, barSpacing, maxValue } = layout;\n        \n        // Draw bars\n        data.forEach((item, index) => {\n            const x = padding + index * (barWidth + barSpacing);\n            const barHeight = (item.value / maxValue) * chartHeight * progress;\n            const y = padding + chartHeight - barHeight;\n            \n            // Bar\n            ctx.fillStyle = item.color || config.barColor || 'rgba(100, 150, 255, 0.8)';\n            ctx.fillRect(x, y, barWidth, barHeight);\n            \n            // Label\n            if (config.showLabels !== false) {\n                ctx.fillStyle = config.textColor || '#333';\n                ctx.font = config.font || '12px Arial';\n                ctx.textAlign = 'center';\n                ctx.fillText(\n                    item.label, \n                    x + barWidth / 2, \n                    padding + chartHeight + 20\n                );\n                \n                // Value\n                if (config.showValues !== false) {\n                    ctx.fillText(\n                        Math.round(item.value * progress), \n                        x + barWidth / 2, \n                        y - 5\n                    );\n                }\n            }\n        });\n        \n        // Draw axes if enabled\n        if (config.showAxes !== false) {\n            ctx.strokeStyle = config.axisColor || '#ccc';\n            ctx.lineWidth = 1;\n            \n            // Y-axis\n            ctx.beginPath();\n            ctx.moveTo(padding, padding);\n            ctx.lineTo(padding, padding + chartHeight);\n            ctx.stroke();\n            \n            // X-axis\n            ctx.beginPath();\n            ctx.moveTo(padding, padding + chartHeight);\n            ctx.lineTo(padding + layout.chartWidth, padding + chartHeight);\n            ctx.stroke();\n        }\n    },\n    \n    /**\n     * Create animated line chart\n     */\n    createLineChart(manager, data, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        const padding = config.padding || 40;\n        const chartWidth = width - padding * 2;\n        const chartHeight = height - padding * 2;\n        \n        const maxValue = Math.max(...data.map(d => d.value));\n        const minValue = Math.min(...data.map(d => d.value));\n        const valueRange = maxValue - minValue;\n        \n        let animationProgress = 0;\n        const animationDuration = config.animationDuration || 2000;\n        let startTime = null;\n        \n        const animate = (timestamp) => {\n            if (!startTime) startTime = timestamp;\n            const elapsed = timestamp - startTime;\n            \n            animationProgress = Math.min(elapsed / animationDuration, 1);\n            \n            manager.clear();\n            this.renderLineChart(manager, data, config, animationProgress, {\n                padding,\n                chartWidth,\n                chartHeight,\n                maxValue,\n                minValue,\n                valueRange\n            });\n            \n            if (animationProgress < 1) {\n                requestAnimationFrame(animate);\n            }\n        };\n        \n        requestAnimationFrame(animate);\n    },\n    \n    /**\n     * Render line chart frame\n     */\n    renderLineChart(manager, data, config, progress, layout) {\n        const { ctx } = manager;\n        const { padding, chartWidth, chartHeight, minValue, valueRange } = layout;\n        \n        const pointsToShow = Math.floor(data.length * progress);\n        \n        ctx.strokeStyle = config.lineColor || 'rgba(100, 150, 255, 0.8)';\n        ctx.lineWidth = config.lineWidth || 3;\n        ctx.lineCap = 'round';\n        ctx.lineJoin = 'round';\n        \n        // Draw line\n        ctx.beginPath();\n        for (let i = 0; i <= pointsToShow && i < data.length; i++) {\n            const x = padding + (i / (data.length - 1)) * chartWidth;\n            const y = padding + chartHeight - ((data[i].value - minValue) / valueRange) * chartHeight;\n            \n            if (i === 0) {\n                ctx.moveTo(x, y);\n            } else {\n                ctx.lineTo(x, y);\n            }\n        }\n        ctx.stroke();\n        \n        // Draw points\n        if (config.showPoints !== false) {\n            ctx.fillStyle = config.pointColor || config.lineColor || 'rgba(100, 150, 255, 0.8)';\n            \n            for (let i = 0; i <= pointsToShow && i < data.length; i++) {\n                const x = padding + (i / (data.length - 1)) * chartWidth;\n                const y = padding + chartHeight - ((data[i].value - minValue) / valueRange) * chartHeight;\n                \n                ctx.beginPath();\n                ctx.arc(x, y, config.pointSize || 4, 0, Math.PI * 2);\n                ctx.fill();\n                \n                // Labels\n                if (config.showLabels !== false && data[i].label) {\n                    ctx.fillStyle = config.textColor || '#333';\n                    ctx.font = config.font || '12px Arial';\n                    ctx.textAlign = 'center';\n                    ctx.fillText(data[i].label, x, padding + chartHeight + 20);\n                }\n            }\n        }\n    },\n    \n    /**\n     * Create animated pie chart\n     */\n    createPieChart(manager, data, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        const centerX = width / 2;\n        const centerY = height / 2;\n        const radius = Math.min(width, height) / 2 * 0.8;\n        \n        const total = data.reduce((sum, item) => sum + item.value, 0);\n        \n        let animationProgress = 0;\n        const animationDuration = config.animationDuration || 2000;\n        let startTime = null;\n        \n        const animate = (timestamp) => {\n            if (!startTime) startTime = timestamp;\n            const elapsed = timestamp - startTime;\n            \n            animationProgress = Math.min(elapsed / animationDuration, 1);\n            \n            manager.clear();\n            this.renderPieChart(manager, data, config, animationProgress, {\n                centerX,\n                centerY,\n                radius,\n                total\n            });\n            \n            if (animationProgress < 1) {\n                requestAnimationFrame(animate);\n            }\n        };\n        \n        requestAnimationFrame(animate);\n    },\n    \n    /**\n     * Render pie chart frame\n     */\n    renderPieChart(manager, data, config, progress, layout) {\n        const { ctx } = manager;\n        const { centerX, centerY, radius, total } = layout;\n        \n        let currentAngle = -Math.PI / 2; // Start at top\n        const maxAngle = currentAngle + (Math.PI * 2 * progress);\n        \n        for (let index = 0; index < data.length; index++) {\n            if (currentAngle >= maxAngle) break;\n            \n            const item = data[index];\n            const sliceAngle = (item.value / total) * Math.PI * 2;\n            const endAngle = Math.min(currentAngle + sliceAngle, maxAngle);\n            \n            if (endAngle > currentAngle) {\n                // Draw slice\n                ctx.fillStyle = item.color || this.getDefaultColor(index);\n                ctx.beginPath();\n                ctx.moveTo(centerX, centerY);\n                ctx.arc(centerX, centerY, radius, currentAngle, endAngle);\n                ctx.closePath();\n                ctx.fill();\n                \n                // Draw labels if enabled\n                if (config.showLabels !== false && endAngle === currentAngle + sliceAngle) {\n                    const labelAngle = currentAngle + sliceAngle / 2;\n                    const labelX = centerX + Math.cos(labelAngle) * radius * 0.7;\n                    const labelY = centerY + Math.sin(labelAngle) * radius * 0.7;\n                    \n                    ctx.fillStyle = config.textColor || '#333';\n                    ctx.font = config.font || '12px Arial';\n                    ctx.textAlign = 'center';\n                    ctx.fillText(item.label, labelX, labelY);\n                }\n            }\n            \n            currentAngle += sliceAngle;\n        }\n    },\n    \n    /**\n     * Create progress visualization\n     */\n    createProgressChart(manager, data, config) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        let animationProgress = 0;\n        const animationDuration = config.animationDuration || 1500;\n        let startTime = null;\n        \n        const animate = (timestamp) => {\n            if (!startTime) startTime = timestamp;\n            const elapsed = timestamp - startTime;\n            \n            animationProgress = Math.min(elapsed / animationDuration, 1);\n            \n            manager.clear();\n            this.renderProgressChart(manager, data, config, animationProgress);\n            \n            if (animationProgress < 1) {\n                requestAnimationFrame(animate);\n            }\n        };\n        \n        requestAnimationFrame(animate);\n    },\n    \n    /**\n     * Render progress chart\n     */\n    renderProgressChart(manager, data, config, progress) {\n        const { ctx } = manager;\n        const { width, height } = manager.getSize();\n        \n        const centerX = width / 2;\n        const centerY = height / 2;\n        const radius = Math.min(width, height) / 2 * 0.8;\n        const lineWidth = config.lineWidth || 20;\n        \n        // Get progress value from data array\n        const value = data[0]?.value || 0;\n        const maxValue = config.maxValue || 100;\n        const progressValue = (value / maxValue) * progress;\n        \n        // Background circle\n        ctx.strokeStyle = config.backgroundColor || 'rgba(200, 200, 200, 0.3)';\n        ctx.lineWidth = lineWidth;\n        ctx.beginPath();\n        ctx.arc(centerX, centerY, radius, 0, Math.PI * 2);\n        ctx.stroke();\n        \n        // Progress arc\n        ctx.strokeStyle = config.color || 'rgba(100, 150, 255, 0.8)';\n        ctx.lineCap = 'round';\n        ctx.beginPath();\n        ctx.arc(centerX, centerY, radius, -Math.PI / 2, -Math.PI / 2 + (progressValue / maxValue) * Math.PI * 2);\n        ctx.stroke();\n        \n        // Center text\n        if (config.showText !== false) {\n            ctx.fillStyle = config.textColor || '#333';\n            ctx.font = config.font || 'bold 24px Arial';\n            ctx.textAlign = 'center';\n            ctx.textBaseline = 'middle';\n            ctx.fillText(Math.round(progressValue) + '%', centerX, centerY);\n        }\n    },\n    \n    /**\n     * Get default color for data point\n     */\n    getDefaultColor(index) {\n        const colors = [\n            'rgba(100, 150, 255, 0.8)',\n            'rgba(255, 100, 150, 0.8)',\n            'rgba(150, 255, 100, 0.8)',\n            'rgba(255, 200, 100, 0.8)',\n            'rgba(200, 100, 255, 0.8)',\n            'rgba(100, 255, 200, 0.8)'\n        ];\n        return colors[index % colors.length];\n    }\n};","// modules/canvas-animations/index.js\nimport { Logger } from '../../core/logger.js';\nimport { CanvasManager } from './CanvasManager.js';\nimport { ScrollEffects } from './ScrollEffects.js';\nimport { InteractiveEffects } from './InteractiveEffects.js';\nimport { DataVisualization } from './DataVisualization.js';\n\nconst CanvasAnimationsModule = {\n    name: 'canvas-animations',\n    \n    // Module-level init (called by module system)\n    init(config = {}, state = null) {\n        Logger.info('[CanvasAnimations] Module initialized');\n        this.initializeCanvasElements();\n        return this;\n    },\n    \n    /**\n     * Initialize all canvas elements with data-canvas attributes\n     */\n    initializeCanvasElements() {\n        // Auto-discover canvas elements\n        const canvasElements = document.querySelectorAll('canvas[data-canvas-type]');\n        \n        canvasElements.forEach(canvas => {\n            this.initElement(canvas);\n        });\n        \n        Logger.info(`[CanvasAnimations] Initialized ${canvasElements.length} canvas elements`);\n    },\n    \n    /**\n     * Initialize individual canvas element\n     */\n    initElement(canvas, options = {}) {\n        const canvasType = canvas.dataset.canvasType;\n        const canvasConfig = this.parseCanvasConfig(canvas);\n        \n        Logger.info(`[CanvasAnimations] Initializing canvas type: ${canvasType}`);\n        \n        switch (canvasType) {\n            case 'interactive':\n                InteractiveEffects.init(canvas, canvasConfig);\n                break;\n            case 'scroll-parallax':\n                ScrollEffects.initParallax(canvas, canvasConfig);\n                break;\n            case 'scroll-animation':\n                ScrollEffects.initScrollAnimation(canvas, canvasConfig);\n                break;\n            case 'data-viz':\n                DataVisualization.init(canvas, canvasConfig);\n                break;\n            case 'background':\n                this.initBackgroundAnimation(canvas, canvasConfig);\n                break;\n            default:\n                Logger.warn(`[CanvasAnimations] Unknown canvas type: ${canvasType}`);\n        }\n    },\n    \n    /**\n     * Parse configuration from data attributes\n     */\n    parseCanvasConfig(canvas) {\n        const config = {};\n        \n        // Parse all data-canvas-* attributes\n        Object.keys(canvas.dataset).forEach(key => {\n            if (key.startsWith('canvas')) {\n                const configKey = key.replace('canvas', '').toLowerCase();\n                let value = canvas.dataset[key];\n                \n                // Try to parse as JSON if it looks like an object/array\n                if ((value.startsWith('{') && value.endsWith('}')) || \n                    (value.startsWith('[') && value.endsWith(']'))) {\n                    try {\n                        value = JSON.parse(value);\n                    } catch (e) {\n                        Logger.warn(`[CanvasAnimations] Failed to parse JSON config: ${key}`, e);\n                    }\n                }\n                // Parse boolean strings\n                else if (value === 'true') value = true;\n                else if (value === 'false') value = false;\n                // Parse numbers\n                else if (!isNaN(value) && value !== '') {\n                    value = parseFloat(value);\n                }\n                \n                config[configKey] = value;\n            }\n        });\n        \n        return config;\n    },\n    \n    /**\n     * Initialize background animation\n     */\n    initBackgroundAnimation(canvas, config) {\n        const manager = new CanvasManager(canvas);\n        \n        // Default background animation: floating particles\n        const particleCount = config.particles || 50;\n        const particles = [];\n        \n        // Create particles\n        for (let i = 0; i < particleCount; i++) {\n            particles.push({\n                x: Math.random() * canvas.width,\n                y: Math.random() * canvas.height,\n                vx: (Math.random() - 0.5) * 0.5,\n                vy: (Math.random() - 0.5) * 0.5,\n                size: Math.random() * 3 + 1,\n                opacity: Math.random() * 0.5 + 0.2\n            });\n        }\n        \n        // Animation loop\n        function animate() {\n            manager.clear();\n            manager.ctx.fillStyle = config.color || 'rgba(100, 150, 255, 0.6)';\n            \n            particles.forEach(particle => {\n                particle.x += particle.vx;\n                particle.y += particle.vy;\n                \n                // Wrap around edges\n                if (particle.x < 0) particle.x = canvas.width;\n                if (particle.x > canvas.width) particle.x = 0;\n                if (particle.y < 0) particle.y = canvas.height;\n                if (particle.y > canvas.height) particle.y = 0;\n                \n                // Draw particle\n                manager.ctx.save();\n                manager.ctx.globalAlpha = particle.opacity;\n                manager.ctx.beginPath();\n                manager.ctx.arc(particle.x, particle.y, particle.size, 0, Math.PI * 2);\n                manager.ctx.fill();\n                manager.ctx.restore();\n            });\n            \n            requestAnimationFrame(animate);\n        }\n        \n        animate();\n    }\n};\n\n// Export für module system\nexport const init = CanvasAnimationsModule.init.bind(CanvasAnimationsModule);\nexport default CanvasAnimationsModule;","/**\r\n * Error Tracking Module\r\n * \r\n * Provides centralized error tracking and reporting.\r\n * Features:\r\n * - Error collection and grouping\r\n * - Error reporting to backend\r\n * - Error analytics\r\n * - Integration with ErrorBoundary\r\n * - Source map support\r\n * - Error filtering and sampling\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * ErrorTracker - Centralized error tracking\r\n */\r\nexport class ErrorTracker {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            endpoint: config.endpoint || '/api/errors',\r\n            enabled: config.enabled ?? true,\r\n            sampleRate: config.sampleRate ?? 1.0, // 0.0 to 1.0\r\n            maxErrors: config.maxErrors || 100,\r\n            groupingWindow: config.groupingWindow || 60000, // 1 minute\r\n            includeStack: config.includeStack ?? true,\r\n            includeContext: config.includeContext ?? true,\r\n            includeUserAgent: config.includeUserAgent ?? true,\r\n            includeUrl: config.includeUrl ?? true,\r\n            filters: config.filters || [],\r\n            beforeSend: config.beforeSend || null,\r\n            ...config\r\n        };\r\n        \r\n        this.errors = [];\r\n        this.errorGroups = new Map(); // Map<fingerprint, ErrorGroup>\r\n        this.reportQueue = [];\r\n        this.isReporting = false;\r\n        \r\n        // Initialize error handlers\r\n        if (this.config.enabled) {\r\n            this.init();\r\n        }\r\n        \r\n        Logger.info('[ErrorTracker] Initialized', {\r\n            enabled: this.config.enabled,\r\n            endpoint: this.config.endpoint,\r\n            sampleRate: this.config.sampleRate\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Create a new ErrorTracker instance\r\n     */\r\n    static create(config = {}) {\r\n        return new ErrorTracker(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize error tracking\r\n     */\r\n    init() {\r\n        // Global error handler\r\n        window.addEventListener('error', (event) => {\r\n            this.captureException(event.error || new Error(event.message), {\r\n                type: 'unhandled',\r\n                filename: event.filename,\r\n                lineno: event.lineno,\r\n                colno: event.colno\r\n            });\r\n        });\r\n        \r\n        // Unhandled promise rejection handler\r\n        window.addEventListener('unhandledrejection', (event) => {\r\n            this.captureException(event.reason, {\r\n                type: 'unhandledrejection'\r\n            });\r\n        });\r\n        \r\n        // Report errors periodically\r\n        this.startReporting();\r\n    }\r\n    \r\n    /**\r\n     * Capture an exception\r\n     */\r\n    captureException(error, context = {}) {\r\n        if (!this.config.enabled) {\r\n            return;\r\n        }\r\n        \r\n        // Sample rate check\r\n        if (Math.random() > this.config.sampleRate) {\r\n            Logger.debug('[ErrorTracker] Error sampled out');\r\n            return;\r\n        }\r\n        \r\n        // Apply filters\r\n        if (this.shouldFilter(error, context)) {\r\n            Logger.debug('[ErrorTracker] Error filtered out');\r\n            return;\r\n        }\r\n        \r\n        // Create error data\r\n        const errorData = this.createErrorData(error, context);\r\n        \r\n        // Apply beforeSend hook\r\n        if (this.config.beforeSend) {\r\n            const modified = this.config.beforeSend(errorData);\r\n            if (modified === null || modified === false) {\r\n                return; // Blocked by beforeSend\r\n            }\r\n            if (modified) {\r\n                Object.assign(errorData, modified);\r\n            }\r\n        }\r\n        \r\n        // Add to errors array\r\n        this.errors.push(errorData);\r\n        \r\n        // Limit errors array size\r\n        if (this.errors.length > this.config.maxErrors) {\r\n            this.errors.shift();\r\n        }\r\n        \r\n        // Group errors\r\n        this.groupError(errorData);\r\n        \r\n        // Queue for reporting\r\n        this.reportQueue.push(errorData);\r\n        \r\n        Logger.debug('[ErrorTracker] Error captured', errorData);\r\n        \r\n        // Trigger error event\r\n        this.triggerErrorEvent(errorData);\r\n    }\r\n    \r\n    /**\r\n     * Create error data object\r\n     */\r\n    createErrorData(error, context = {}) {\r\n        const errorData = {\r\n            message: error?.message || String(error),\r\n            name: error?.name || 'Error',\r\n            stack: this.config.includeStack ? this.getStackTrace(error) : undefined,\r\n            timestamp: Date.now(),\r\n            type: context.type || 'error',\r\n            context: this.config.includeContext ? {\r\n                ...context,\r\n                userAgent: this.config.includeUserAgent ? navigator.userAgent : undefined,\r\n                url: this.config.includeUrl ? window.location.href : undefined,\r\n                referrer: document.referrer || undefined,\r\n                viewport: {\r\n                    width: window.innerWidth,\r\n                    height: window.innerHeight\r\n                }\r\n            } : context\r\n        };\r\n        \r\n        // Add additional error properties\r\n        if (error && typeof error === 'object') {\r\n            Object.keys(error).forEach(key => {\r\n                if (!['message', 'name', 'stack'].includes(key)) {\r\n                    errorData[key] = error[key];\r\n                }\r\n            });\r\n        }\r\n        \r\n        return errorData;\r\n    }\r\n    \r\n    /**\r\n     * Get stack trace\r\n     */\r\n    getStackTrace(error) {\r\n        if (error?.stack) {\r\n            return error.stack;\r\n        }\r\n        \r\n        try {\r\n            throw new Error();\r\n        } catch (e) {\r\n            return e.stack || 'No stack trace available';\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Generate error fingerprint for grouping\r\n     */\r\n    generateFingerprint(errorData) {\r\n        // Group by message and stack trace (first few lines)\r\n        const message = errorData.message || '';\r\n        const stack = errorData.stack || '';\r\n        const stackLines = stack.split('\\n').slice(0, 3).join('\\n');\r\n        \r\n        return `${errorData.name}:${message}:${stackLines}`;\r\n    }\r\n    \r\n    /**\r\n     * Group errors\r\n     */\r\n    groupError(errorData) {\r\n        const fingerprint = this.generateFingerprint(errorData);\r\n        const now = Date.now();\r\n        \r\n        if (!this.errorGroups.has(fingerprint)) {\r\n            this.errorGroups.set(fingerprint, {\r\n                fingerprint,\r\n                count: 0,\r\n                firstSeen: now,\r\n                lastSeen: now,\r\n                errors: []\r\n            });\r\n        }\r\n        \r\n        const group = this.errorGroups.get(fingerprint);\r\n        group.count++;\r\n        group.lastSeen = now;\r\n        group.errors.push(errorData);\r\n        \r\n        // Limit errors in group\r\n        if (group.errors.length > 10) {\r\n            group.errors.shift();\r\n        }\r\n        \r\n        // Clean up old groups\r\n        this.cleanupGroups(now);\r\n    }\r\n    \r\n    /**\r\n     * Clean up old error groups\r\n     */\r\n    cleanupGroups(now) {\r\n        const cutoff = now - this.config.groupingWindow;\r\n        \r\n        for (const [fingerprint, group] of this.errorGroups.entries()) {\r\n            if (group.lastSeen < cutoff) {\r\n                this.errorGroups.delete(fingerprint);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Check if error should be filtered\r\n     */\r\n    shouldFilter(error, context) {\r\n        for (const filter of this.config.filters) {\r\n            if (typeof filter === 'function') {\r\n                if (filter(error, context) === false) {\r\n                    return true; // Filter out\r\n                }\r\n            } else if (filter instanceof RegExp) {\r\n                const message = error?.message || String(error);\r\n                if (filter.test(message)) {\r\n                    return true; // Filter out\r\n                }\r\n            }\r\n        }\r\n        return false;\r\n    }\r\n    \r\n    /**\r\n     * Start reporting errors\r\n     */\r\n    startReporting() {\r\n        // Report errors periodically\r\n        setInterval(() => {\r\n            this.flushReports();\r\n        }, 5000); // Every 5 seconds\r\n    }\r\n    \r\n    /**\r\n     * Flush error reports to backend\r\n     */\r\n    async flushReports() {\r\n        if (this.isReporting || this.reportQueue.length === 0) {\r\n            return;\r\n        }\r\n        \r\n        this.isReporting = true;\r\n        \r\n        try {\r\n            const errorsToReport = [...this.reportQueue];\r\n            this.reportQueue = [];\r\n            \r\n            if (errorsToReport.length === 0) {\r\n                return;\r\n            }\r\n            \r\n            // Send errors to backend\r\n            const response = await fetch(this.config.endpoint, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-Requested-With': 'XMLHttpRequest'\r\n                },\r\n                body: JSON.stringify({\r\n                    errors: errorsToReport,\r\n                    errorGroups: Array.from(this.errorGroups.values()).map(group => ({\r\n                        fingerprint: group.fingerprint,\r\n                        count: group.count,\r\n                        firstSeen: group.firstSeen,\r\n                        lastSeen: group.lastSeen\r\n                    }))\r\n                })\r\n            });\r\n            \r\n            if (!response.ok) {\r\n                throw new Error(`Error reporting failed: ${response.status}`);\r\n            }\r\n            \r\n            Logger.debug('[ErrorTracker] Errors reported', { count: errorsToReport.length });\r\n        } catch (error) {\r\n            Logger.error('[ErrorTracker] Failed to report errors', error);\r\n            // Re-queue errors for retry\r\n            // Note: In production, you might want to limit retries\r\n        } finally {\r\n            this.isReporting = false;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Manually report errors\r\n     */\r\n    async report() {\r\n        await this.flushReports();\r\n    }\r\n    \r\n    /**\r\n     * Get error groups\r\n     */\r\n    getErrorGroups() {\r\n        return Array.from(this.errorGroups.values());\r\n    }\r\n    \r\n    /**\r\n     * Get errors\r\n     */\r\n    getErrors() {\r\n        return [...this.errors];\r\n    }\r\n    \r\n    /**\r\n     * Clear errors\r\n     */\r\n    clearErrors() {\r\n        this.errors = [];\r\n        this.errorGroups.clear();\r\n        this.reportQueue = [];\r\n    }\r\n    \r\n    /**\r\n     * Trigger error event\r\n     */\r\n    triggerErrorEvent(errorData) {\r\n        const event = new CustomEvent('error-tracker:error', {\r\n            detail: errorData,\r\n            bubbles: true\r\n        });\r\n        window.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Destroy error tracker\r\n     */\r\n    destroy() {\r\n        // Flush remaining errors\r\n        this.flushReports();\r\n        \r\n        // Clear data\r\n        this.clearErrors();\r\n        \r\n        Logger.info('[ErrorTracker] Destroyed');\r\n    }\r\n}\r\n\r\n/**\r\n * Create a global error tracker instance\r\n */\r\nlet globalErrorTracker = null;\r\n\r\n/**\r\n * Get or create global error tracker\r\n */\r\nexport function getGlobalErrorTracker(config = {}) {\r\n    if (!globalErrorTracker) {\r\n        globalErrorTracker = ErrorTracker.create(config);\r\n    }\r\n    return globalErrorTracker;\r\n}\r\n\r\n","/**\r\n * Error Tracking Module\r\n * \r\n * Provides centralized error tracking and reporting.\r\n * \r\n * Usage:\r\n * - Add data-module=\"error-tracking\" to enable global error tracking\r\n * - Or import and use directly: import { ErrorTracker } from './modules/error-tracking/index.js'\r\n * \r\n * Features:\r\n * - Error collection and grouping\r\n * - Error reporting to backend\r\n * - Error analytics\r\n * - Integration with ErrorBoundary\r\n * - Source map support\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { ErrorTracker, getGlobalErrorTracker } from './ErrorTracker.js';\r\n\r\nconst ErrorTrackingModule = {\r\n    name: 'error-tracking',\r\n    errorTracker: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[ErrorTrackingModule] Module initialized');\r\n        \r\n        // Create global error tracker\r\n        this.errorTracker = getGlobalErrorTracker(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.ErrorTracker = this.errorTracker;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get error tracker instance\r\n     */\r\n    getErrorTracker() {\r\n        return this.errorTracker || getGlobalErrorTracker();\r\n    },\r\n    \r\n    /**\r\n     * Manually capture an error\r\n     */\r\n    captureException(error, context = {}) {\r\n        const tracker = this.getErrorTracker();\r\n        tracker.captureException(error, context);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.errorTracker) {\r\n            this.errorTracker.destroy();\r\n            this.errorTracker = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.ErrorTracker) {\r\n            delete window.ErrorTracker;\r\n        }\r\n        \r\n        Logger.info('[ErrorTrackingModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { ErrorTracker, getGlobalErrorTracker };\r\n\r\n// Export as default for module system\r\nexport default ErrorTrackingModule;\r\n\r\n// Export init function for module system\r\nexport const init = ErrorTrackingModule.init.bind(ErrorTrackingModule);\r\n\r\n","/**\r\n * Event Bus Module\r\n * \r\n * Provides centralized event system for cross-module communication.\r\n * Features:\r\n * - Pub/sub pattern\r\n * - Namespaced events\r\n * - Event filtering\r\n * - Event history\r\n * - Integration with LiveComponents\r\n * - Integration with SSE\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * EventBus - Centralized event system\r\n */\r\nexport class EventBus {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            enableHistory: config.enableHistory ?? false,\r\n            maxHistorySize: config.maxHistorySize || 100,\r\n            enableWildcards: config.enableWildcards ?? true,\r\n            ...config\r\n        };\r\n        \r\n        this.subscribers = new Map(); // Map<eventName, Set<callback>>\r\n        this.history = [];\r\n        this.middleware = [];\r\n        \r\n        Logger.info('[EventBus] Initialized', {\r\n            enableHistory: this.config.enableHistory,\r\n            enableWildcards: this.config.enableWildcards\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Create a new EventBus instance\r\n     */\r\n    static create(config = {}) {\r\n        return new EventBus(config);\r\n    }\r\n    \r\n    /**\r\n     * Subscribe to an event\r\n     */\r\n    on(eventName, callback, options = {}) {\r\n        if (typeof callback !== 'function') {\r\n            throw new Error('Callback must be a function');\r\n        }\r\n        \r\n        if (!this.subscribers.has(eventName)) {\r\n            this.subscribers.set(eventName, new Set());\r\n        }\r\n        \r\n        const subscriber = {\r\n            callback,\r\n            once: options.once ?? false,\r\n            priority: options.priority || 0,\r\n            filter: options.filter || null\r\n        };\r\n        \r\n        this.subscribers.get(eventName).add(subscriber);\r\n        \r\n        // Sort by priority\r\n        const subscribers = Array.from(this.subscribers.get(eventName));\r\n        subscribers.sort((a, b) => b.priority - a.priority);\r\n        this.subscribers.set(eventName, new Set(subscribers));\r\n        \r\n        // Return unsubscribe function\r\n        return () => {\r\n            const callbacks = this.subscribers.get(eventName);\r\n            if (callbacks) {\r\n                callbacks.delete(subscriber);\r\n                if (callbacks.size === 0) {\r\n                    this.subscribers.delete(eventName);\r\n                }\r\n            }\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Subscribe to an event (once)\r\n     */\r\n    once(eventName, callback, options = {}) {\r\n        return this.on(eventName, callback, { ...options, once: true });\r\n    }\r\n    \r\n    /**\r\n     * Unsubscribe from an event\r\n     */\r\n    off(eventName, callback) {\r\n        if (!this.subscribers.has(eventName)) {\r\n            return;\r\n        }\r\n        \r\n        const callbacks = this.subscribers.get(eventName);\r\n        for (const subscriber of callbacks) {\r\n            if (subscriber.callback === callback) {\r\n                callbacks.delete(subscriber);\r\n                break;\r\n            }\r\n        }\r\n        \r\n        if (callbacks.size === 0) {\r\n            this.subscribers.delete(eventName);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Emit an event\r\n     */\r\n    emit(eventName, data = null, options = {}) {\r\n        // Apply middleware\r\n        let processedData = data;\r\n        for (const middleware of this.middleware) {\r\n            const result = middleware(eventName, processedData, options);\r\n            if (result === null || result === false) {\r\n                return; // Middleware blocked the event\r\n            }\r\n            if (result !== undefined) {\r\n                processedData = result;\r\n            }\r\n        }\r\n        \r\n        // Add to history\r\n        if (this.config.enableHistory) {\r\n            this.addToHistory(eventName, processedData, options);\r\n        }\r\n        \r\n        // Get subscribers for exact event name\r\n        const subscribers = this.subscribers.get(eventName);\r\n        if (subscribers) {\r\n            this.notifySubscribers(subscribers, eventName, processedData, options);\r\n        }\r\n        \r\n        // Handle wildcards\r\n        if (this.config.enableWildcards) {\r\n            this.handleWildcards(eventName, processedData, options);\r\n        }\r\n        \r\n        // Handle namespaced events (e.g., 'user:created' triggers 'user:*')\r\n        this.handleNamespacedEvents(eventName, processedData, options);\r\n        \r\n        Logger.debug('[EventBus] Event emitted', { eventName, data: processedData });\r\n    }\r\n    \r\n    /**\r\n     * Notify subscribers\r\n     */\r\n    notifySubscribers(subscribers, eventName, data, options) {\r\n        const subscribersArray = Array.from(subscribers);\r\n        \r\n        for (const subscriber of subscribersArray) {\r\n            // Apply filter\r\n            if (subscriber.filter && !subscriber.filter(data, options)) {\r\n                continue;\r\n            }\r\n            \r\n            try {\r\n                subscriber.callback(data, eventName, options);\r\n            } catch (error) {\r\n                Logger.error('[EventBus] Subscriber error', error);\r\n            }\r\n            \r\n            // Remove if once\r\n            if (subscriber.once) {\r\n                subscribers.delete(subscriber);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Handle wildcard subscriptions\r\n     */\r\n    handleWildcards(eventName, data, options) {\r\n        // Check for '*' subscribers\r\n        const wildcardSubscribers = this.subscribers.get('*');\r\n        if (wildcardSubscribers) {\r\n            this.notifySubscribers(wildcardSubscribers, eventName, data, options);\r\n        }\r\n        \r\n        // Check for pattern matches (e.g., 'user:*' matches 'user:created')\r\n        for (const [pattern, subscribers] of this.subscribers.entries()) {\r\n            if (pattern.includes('*') && this.matchesPattern(eventName, pattern)) {\r\n                this.notifySubscribers(subscribers, eventName, data, options);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Handle namespaced events\r\n     */\r\n    handleNamespacedEvents(eventName, data, options) {\r\n        const parts = eventName.split(':');\r\n        if (parts.length > 1) {\r\n            // Emit namespace wildcard (e.g., 'user:created' triggers 'user:*')\r\n            const namespacePattern = parts[0] + ':*';\r\n            const namespaceSubscribers = this.subscribers.get(namespacePattern);\r\n            if (namespaceSubscribers) {\r\n                this.notifySubscribers(namespaceSubscribers, eventName, data, options);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Check if event name matches pattern\r\n     */\r\n    matchesPattern(eventName, pattern) {\r\n        const regex = new RegExp('^' + pattern.replace(/\\*/g, '.*') + '$');\r\n        return regex.test(eventName);\r\n    }\r\n    \r\n    /**\r\n     * Add middleware\r\n     */\r\n    use(middleware) {\r\n        if (typeof middleware !== 'function') {\r\n            throw new Error('Middleware must be a function');\r\n        }\r\n        this.middleware.push(middleware);\r\n    }\r\n    \r\n    /**\r\n     * Add event to history\r\n     */\r\n    addToHistory(eventName, data, options) {\r\n        this.history.push({\r\n            eventName,\r\n            data,\r\n            options,\r\n            timestamp: Date.now()\r\n        });\r\n        \r\n        // Limit history size\r\n        if (this.history.length > this.config.maxHistorySize) {\r\n            this.history.shift();\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get event history\r\n     */\r\n    getHistory(filter = null) {\r\n        if (!filter) {\r\n            return [...this.history];\r\n        }\r\n        \r\n        if (typeof filter === 'string') {\r\n            // Filter by event name\r\n            return this.history.filter(event => event.eventName === filter);\r\n        }\r\n        \r\n        if (typeof filter === 'function') {\r\n            // Custom filter function\r\n            return this.history.filter(filter);\r\n        }\r\n        \r\n        return [];\r\n    }\r\n    \r\n    /**\r\n     * Clear event history\r\n     */\r\n    clearHistory() {\r\n        this.history = [];\r\n    }\r\n    \r\n    /**\r\n     * Get all event names\r\n     */\r\n    getEventNames() {\r\n        return Array.from(this.subscribers.keys());\r\n    }\r\n    \r\n    /**\r\n     * Get subscriber count for an event\r\n     */\r\n    getSubscriberCount(eventName) {\r\n        const subscribers = this.subscribers.get(eventName);\r\n        return subscribers ? subscribers.size : 0;\r\n    }\r\n    \r\n    /**\r\n     * Remove all subscribers for an event\r\n     */\r\n    removeAllListeners(eventName = null) {\r\n        if (eventName) {\r\n            this.subscribers.delete(eventName);\r\n        } else {\r\n            this.subscribers.clear();\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Destroy event bus\r\n     */\r\n    destroy() {\r\n        this.subscribers.clear();\r\n        this.history = [];\r\n        this.middleware = [];\r\n        \r\n        Logger.info('[EventBus] Destroyed');\r\n    }\r\n}\r\n\r\n/**\r\n * Create a global event bus instance\r\n */\r\nlet globalEventBus = null;\r\n\r\n/**\r\n * Get or create global event bus\r\n */\r\nexport function getGlobalEventBus(config = {}) {\r\n    if (!globalEventBus) {\r\n        globalEventBus = EventBus.create(config);\r\n    }\r\n    return globalEventBus;\r\n}\r\n\r\n","/**\r\n * Event Bus Module\r\n * \r\n * Provides centralized event system for cross-module communication.\r\n * \r\n * Usage:\r\n * - Add data-module=\"event-bus\" to enable global event bus\r\n * - Or import and use directly: import { EventBus } from './modules/event-bus/index.js'\r\n * \r\n * Features:\r\n * - Pub/sub pattern\r\n * - Namespaced events\r\n * - Event filtering\r\n * - Event history\r\n * - Integration with LiveComponents\r\n * - Integration with SSE\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { EventBus, getGlobalEventBus } from './EventBus.js';\r\n\r\nconst EventBusModule = {\r\n    name: 'event-bus',\r\n    eventBus: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[EventBusModule] Module initialized');\r\n        \r\n        // Create global event bus\r\n        this.eventBus = getGlobalEventBus(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.EventBus = this.eventBus;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get event bus instance\r\n     */\r\n    getEventBus() {\r\n        return this.eventBus || getGlobalEventBus();\r\n    },\r\n    \r\n    /**\r\n     * Emit an event\r\n     */\r\n    emit(eventName, data = null, options = {}) {\r\n        const bus = this.getEventBus();\r\n        bus.emit(eventName, data, options);\r\n    },\r\n    \r\n    /**\r\n     * Subscribe to an event\r\n     */\r\n    on(eventName, callback, options = {}) {\r\n        const bus = this.getEventBus();\r\n        return bus.on(eventName, callback, options);\r\n    },\r\n    \r\n    /**\r\n     * Unsubscribe from an event\r\n     */\r\n    off(eventName, callback) {\r\n        const bus = this.getEventBus();\r\n        bus.off(eventName, callback);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.eventBus) {\r\n            this.eventBus.destroy();\r\n            this.eventBus = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.EventBus) {\r\n            delete window.EventBus;\r\n        }\r\n        \r\n        Logger.info('[EventBusModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { EventBus, getGlobalEventBus };\r\n\r\n// Export as default for module system\r\nexport default EventBusModule;\r\n\r\n// Export init function for module system\r\nexport const init = EventBusModule.init.bind(EventBusModule);\r\n\r\n","// modules/example-module/index.js\nimport { registerFrameTask, unregisterFrameTask } from '../../core/frameloop.js';\nimport { Logger } from '../../core/logger.js';\n\nlet frameId = 'example-module';\nlet resizeHandler = null;\nlet state = null;\n\n/**\n * Initialize example module with state management\n * @param {Object} config - Module configuration\n * @param {Object} stateManager - Scoped state manager\n */\nexport function init(config = {}, stateManager = null) {\n    Logger.info('[example-module] init');\n    state = stateManager;\n\n    // Register module state\n    if (state) {\n        state.register('windowSize', { width: window.innerWidth, height: window.innerHeight });\n        state.register('scrollPosition', { x: 0, y: 0 });\n        state.register('isVisible', true);\n        \n        // Example: Subscribe to global app state (if exists)\n        // state.subscribe('app.theme', (theme) => {\n        //     Logger.info(`[example-module] Theme changed to: ${theme}`);\n        // });\n    }\n\n    // Event-Listener mit State-Updates\n    resizeHandler = () => {\n        const newSize = { width: window.innerWidth, height: window.innerHeight };\n        Logger.info('Fenstergröße geändert:', newSize);\n        \n        if (state) {\n            state.set('windowSize', newSize);\n        }\n    };\n    window.addEventListener('resize', resizeHandler);\n\n    // Frame-Logik mit State-Updates\n    registerFrameTask(frameId, () => {\n        const scrollY = window.scrollY;\n        const scrollX = window.scrollX;\n        \n        if (state) {\n            const currentScroll = state.get('scrollPosition');\n            if (currentScroll.x !== scrollX || currentScroll.y !== scrollY) {\n                state.set('scrollPosition', { x: scrollX, y: scrollY });\n            }\n        }\n    }, { autoStart: true });\n}\n\nexport function destroy() {\n    Logger.info('[example-module] destroy');\n\n    // EventListener entfernen\n    if (resizeHandler) {\n        window.removeEventListener('resize', resizeHandler);\n        resizeHandler = null;\n    }\n\n    // FrameTask entfernen\n    unregisterFrameTask(frameId);\n\n    // State cleanup\n    if (state && typeof state.cleanup === 'function') {\n        state.cleanup();\n    }\n    state = null;\n}","import { Logger } from '../../core/logger.js';\n\nexport class FormValidator {\n    constructor(form) {\n        this.form = form;\n        this.errors = new Map();\n    }\n\n    static create(form) {\n        return new FormValidator(form);\n    }\n\n    validate() {\n        this.errors.clear();\n        const fields = this.form.querySelectorAll('input, textarea, select');\n        \n        for (const field of fields) {\n            if (field.type === 'hidden' || field.disabled) continue;\n            \n            this.validateField(field);\n        }\n        \n        return this.errors.size === 0;\n    }\n\n    validateField(field) {\n        const value = field.value;\n        const fieldName = field.name;\n        \n        // HTML5 required attribute\n        if (field.hasAttribute('required') && (!value || value.trim() === '')) {\n            this.errors.set(fieldName, this.getErrorMessage(field, 'valueMissing') || `${this.getFieldLabel(field)} ist erforderlich`);\n            return;\n        }\n        \n        // Skip further validation if field is empty and not required\n        if (!value || value.trim() === '') return;\n        \n        // HTML5 type validation\n        if (field.type === 'email' && !this.isValidEmail(value)) {\n            this.errors.set(fieldName, this.getErrorMessage(field, 'typeMismatch') || 'Bitte geben Sie eine gültige E-Mail-Adresse ein');\n            return;\n        }\n        \n        if (field.type === 'url' && !this.isValidUrl(value)) {\n            this.errors.set(fieldName, this.getErrorMessage(field, 'typeMismatch') || 'Bitte geben Sie eine gültige URL ein');\n            return;\n        }\n        \n        // HTML5 minlength attribute\n        const minLength = field.getAttribute('minlength');\n        if (minLength && value.length < parseInt(minLength)) {\n            this.errors.set(fieldName, this.getErrorMessage(field, 'tooShort') || `Mindestens ${minLength} Zeichen erforderlich`);\n            return;\n        }\n        \n        // HTML5 maxlength attribute (usually enforced by browser, but for safety)\n        const maxLength = field.getAttribute('maxlength');\n        if (maxLength && value.length > parseInt(maxLength)) {\n            this.errors.set(fieldName, this.getErrorMessage(field, 'tooLong') || `Maximal ${maxLength} Zeichen erlaubt`);\n            return;\n        }\n        \n        // HTML5 min/max for number inputs\n        if (field.type === 'number') {\n            const min = field.getAttribute('min');\n            const max = field.getAttribute('max');\n            const numValue = parseFloat(value);\n            \n            if (min && numValue < parseFloat(min)) {\n                this.errors.set(fieldName, this.getErrorMessage(field, 'rangeUnderflow') || `Wert muss mindestens ${min} sein`);\n                return;\n            }\n            \n            if (max && numValue > parseFloat(max)) {\n                this.errors.set(fieldName, this.getErrorMessage(field, 'rangeOverflow') || `Wert darf maximal ${max} sein`);\n                return;\n            }\n        }\n        \n        // HTML5 pattern attribute\n        const pattern = field.getAttribute('pattern');\n        if (pattern) {\n            const regex = new RegExp(pattern);\n            if (!regex.test(value)) {\n                this.errors.set(fieldName, this.getErrorMessage(field, 'patternMismatch') || 'Ungültiges Format');\n                return;\n            }\n        }\n        \n        // Custom validation via data-validate attribute\n        const customValidation = field.getAttribute('data-validate');\n        if (customValidation) {\n            const result = this.runCustomValidation(customValidation, value, field);\n            if (!result.valid) {\n                this.errors.set(fieldName, result.message);\n                return;\n            }\n        }\n    }\n\n    runCustomValidation(validationType, value, field) {\n        switch (validationType) {\n            case 'phone':\n                const phoneRegex = /^[\\+]?[0-9\\s\\-\\(\\)]{10,}$/;\n                return {\n                    valid: phoneRegex.test(value),\n                    message: 'Bitte geben Sie eine gültige Telefonnummer ein'\n                };\n                \n            case 'postal-code-de':\n                const postalRegex = /^[0-9]{5}$/;\n                return {\n                    valid: postalRegex.test(value),\n                    message: 'Bitte geben Sie eine gültige Postleitzahl ein'\n                };\n                \n            case 'no-html':\n                const hasHtml = /<[^>]*>/g.test(value);\n                return {\n                    valid: !hasHtml,\n                    message: 'HTML-Code ist nicht erlaubt'\n                };\n                \n            default:\n                Logger.warn(`Unknown custom validation: ${validationType}`);\n                return { valid: true, message: '' };\n        }\n    }\n\n    isValidEmail(email) {\n        return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n    }\n\n    isValidUrl(url) {\n        try {\n            new URL(url);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    getFieldLabel(field) {\n        const label = this.form.querySelector(`label[for=\"${field.id}\"]`) || \n                     this.form.querySelector(`label:has([name=\"${field.name}\"])`);\n        \n        return label ? label.textContent.trim().replace(':', '') : field.name;\n    }\n\n    getErrorMessage(field, validityType) {\n        // Check for custom error messages via data-error-* attributes\n        const customMessage = field.getAttribute(`data-error-${validityType}`) || \n                             field.getAttribute('data-error');\n        \n        return customMessage;\n    }\n\n    getErrors() {\n        return Object.fromEntries(this.errors);\n    }\n\n    getFieldError(fieldName) {\n        return this.errors.get(fieldName);\n    }\n\n    hasErrors() {\n        return this.errors.size > 0;\n    }\n\n    clearErrors() {\n        this.errors.clear();\n    }\n\n    // Check HTML5 validity API as fallback\n    validateWithHTML5() {\n        const isValid = this.form.checkValidity();\n        \n        if (!isValid) {\n            const fields = this.form.querySelectorAll('input, textarea, select');\n            for (const field of fields) {\n                if (!field.validity.valid) {\n                    this.errors.set(field.name, field.validationMessage);\n                }\n            }\n        }\n        \n        return isValid;\n    }\n}","import { Logger } from '../../core/logger.js';\n\nexport class FormState {\n    constructor(form) {\n        this.form = form;\n        this.pristineValues = new Map();\n        this.touchedFields = new Set();\n        this.dirtyFields = new Set();\n        \n        this.init();\n    }\n\n    static create(form) {\n        return new FormState(form);\n    }\n\n    init() {\n        // Store initial values\n        this.captureInitialValues();\n        \n        // Track field interactions\n        this.bindEvents();\n        \n        Logger.info(`[FormState] Initialized for form: ${this.form.id || 'unnamed'}`);\n    }\n\n    captureInitialValues() {\n        const fields = this.form.querySelectorAll('input, textarea, select');\n        \n        fields.forEach(field => {\n            let value;\n            \n            switch (field.type) {\n                case 'checkbox':\n                case 'radio':\n                    value = field.checked;\n                    break;\n                default:\n                    value = field.value;\n            }\n            \n            this.pristineValues.set(field.name, value);\n        });\n    }\n\n    bindEvents() {\n        const fields = this.form.querySelectorAll('input, textarea, select');\n        \n        fields.forEach(field => {\n            // Skip hidden fields for interaction tracking (they can't be touched/interacted with)\n            if (field.type === 'hidden') return;\n            \n            // Mark field as touched on first interaction\n            field.addEventListener('focus', () => {\n                this.markAsTouched(field.name);\n            });\n            \n            // Track changes for dirty state\n            field.addEventListener('input', () => {\n                this.checkDirtyState(field);\n            });\n            \n            field.addEventListener('change', () => {\n                this.checkDirtyState(field);\n            });\n        });\n    }\n\n    markAsTouched(fieldName) {\n        this.touchedFields.add(fieldName);\n        this.updateFormClasses();\n    }\n\n    checkDirtyState(field) {\n        const fieldName = field.name;\n        const currentValue = this.getFieldValue(field);\n        const pristineValue = this.pristineValues.get(fieldName);\n        \n        if (currentValue !== pristineValue) {\n            this.dirtyFields.add(fieldName);\n        } else {\n            this.dirtyFields.delete(fieldName);\n        }\n        \n        this.updateFormClasses();\n    }\n\n    getFieldValue(field) {\n        switch (field.type) {\n            case 'checkbox':\n            case 'radio':\n                return field.checked;\n            default:\n                return field.value;\n        }\n    }\n\n    updateFormClasses() {\n        // Update form-level classes based on state\n        if (this.isDirty()) {\n            this.form.classList.add('form-dirty');\n            this.form.classList.remove('form-pristine');\n        } else {\n            this.form.classList.add('form-pristine');\n            this.form.classList.remove('form-dirty');\n        }\n\n        if (this.hasTouchedFields()) {\n            this.form.classList.add('form-touched');\n        } else {\n            this.form.classList.remove('form-touched');\n        }\n    }\n\n    // State check methods\n    isPristine() {\n        return this.dirtyFields.size === 0;\n    }\n\n    isDirty() {\n        return this.dirtyFields.size > 0;\n    }\n\n    hasTouchedFields() {\n        return this.touchedFields.size > 0;\n    }\n\n    isFieldTouched(fieldName) {\n        return this.touchedFields.has(fieldName);\n    }\n\n    isFieldDirty(fieldName) {\n        return this.dirtyFields.has(fieldName);\n    }\n\n    isFieldPristine(fieldName) {\n        return !this.dirtyFields.has(fieldName);\n    }\n\n    // Get field states\n    getFieldState(fieldName) {\n        return {\n            pristine: this.isFieldPristine(fieldName),\n            dirty: this.isFieldDirty(fieldName),\n            touched: this.isFieldTouched(fieldName),\n            pristineValue: this.pristineValues.get(fieldName),\n            currentValue: this.getCurrentFieldValue(fieldName)\n        };\n    }\n\n    getCurrentFieldValue(fieldName) {\n        const field = this.form.querySelector(`[name=\"${fieldName}\"]`);\n        return field ? this.getFieldValue(field) : undefined;\n    }\n\n    // Form-level state\n    getFormState() {\n        return {\n            pristine: this.isPristine(),\n            dirty: this.isDirty(),\n            touched: this.hasTouchedFields(),\n            dirtyFields: Array.from(this.dirtyFields),\n            touchedFields: Array.from(this.touchedFields),\n            totalFields: this.pristineValues.size\n        };\n    }\n\n    // Reset methods\n    reset() {\n        this.touchedFields.clear();\n        this.dirtyFields.clear();\n        \n        // Re-capture values after form reset\n        setTimeout(() => {\n            this.captureInitialValues();\n            this.updateFormClasses();\n        }, 0);\n        \n        Logger.info('[FormState] State reset');\n    }\n\n    resetField(fieldName) {\n        this.touchedFields.delete(fieldName);\n        this.dirtyFields.delete(fieldName);\n        \n        // Reset field to pristine value\n        const field = this.form.querySelector(`[name=\"${fieldName}\"]`);\n        const pristineValue = this.pristineValues.get(fieldName);\n        \n        if (field && pristineValue !== undefined) {\n            switch (field.type) {\n                case 'checkbox':\n                case 'radio':\n                    field.checked = pristineValue;\n                    break;\n                default:\n                    field.value = pristineValue;\n            }\n        }\n        \n        this.updateFormClasses();\n        \n        Logger.info(`[FormState] Field \"${fieldName}\" reset to pristine state`);\n    }\n\n    // Event handling for external state changes\n    triggerStateEvent(eventName, detail = {}) {\n        const event = new CustomEvent(eventName, {\n            detail: {\n                ...detail,\n                formState: this.getFormState()\n            },\n            bubbles: true,\n            cancelable: true\n        });\n        \n        this.form.dispatchEvent(event);\n    }\n\n    // Utility methods\n    hasChanges() {\n        return this.isDirty();\n    }\n\n    getChangedFields() {\n        const changes = {};\n        \n        this.dirtyFields.forEach(fieldName => {\n            changes[fieldName] = {\n                pristineValue: this.pristineValues.get(fieldName),\n                currentValue: this.getCurrentFieldValue(fieldName)\n            };\n        });\n        \n        return changes;\n    }\n\n    // Warning for unsaved changes\n    enableUnsavedChangesWarning() {\n        window.addEventListener('beforeunload', (e) => {\n            if (this.isDirty()) {\n                e.preventDefault();\n                e.returnValue = 'Sie haben ungespeicherte Änderungen. Möchten Sie die Seite wirklich verlassen?';\n                return e.returnValue;\n            }\n        });\n    }\n\n    destroy() {\n        this.pristineValues.clear();\n        this.touchedFields.clear();\n        this.dirtyFields.clear();\n        \n        Logger.info('[FormState] Destroyed');\n    }\n}","import { Logger } from '../../core/logger.js';\nimport { FormValidator } from './FormValidator.js';\nimport { FormState } from './FormState.js';\n\nexport class FormHandler {\n    constructor(form, options = {}) {\n        this.form = form;\n        this.options = {\n            validateOnSubmit: true,\n            validateOnBlur: false,\n            validateOnInput: false,\n            showInlineErrors: true,\n            preventSubmitOnError: true,\n            submitMethod: 'POST',\n            ajaxSubmit: true,\n            // Autosave options\n            enableAutosave: options.enableAutosave ?? form.hasAttribute('data-autosave'),\n            autosaveInterval: options.autosaveInterval || 30000, // 30 seconds\n            autosaveRetentionPeriod: options.autosaveRetentionPeriod || 24 * 60 * 60 * 1000, // 24 hours\n            autosaveStorageKey: options.autosaveStorageKey || null,\n            autosaveStoragePrefix: options.autosaveStoragePrefix || 'form_draft_',\n            autosaveVisualFeedback: options.autosaveVisualFeedback ?? true,\n            autosaveExcludeFields: options.autosaveExcludeFields || [\n                'input[type=\"password\"]',\n                'input[type=\"hidden\"][name=\"_token\"]',\n                'input[type=\"hidden\"][name=\"_form_id\"]',\n                'input[name*=\"password\"]',\n                'input[name*=\"confirm\"]',\n                'input[name*=\"honeypot\"]'\n            ],\n            autosaveImmediateFields: options.autosaveImmediateFields || [\n                'textarea',\n                'input[type=\"email\"]',\n                'input[type=\"text\"]',\n                'select'\n            ],\n            ...options\n        };\n        \n        this.validator = FormValidator.create(form);\n        this.state = FormState.create(form);\n        this.isSubmitting = false;\n        \n        // Autosave state\n        this.autosaveTimer = null;\n        this.lastAutosaveTime = null;\n        this.autosaveStorageKey = null;\n        \n        this.init();\n    }\n\n    static create(form, options = {}) {\n        return new FormHandler(form, options);\n    }\n\n    init() {\n        this.bindEvents();\n        this.setupErrorDisplay();\n        \n        // Initialize autosave if enabled\n        if (this.options.enableAutosave) {\n            this.initAutosave();\n        }\n        \n        // Mark form as enhanced\n        this.form.setAttribute('data-enhanced', 'true');\n        \n        Logger.info(`[FormHandler] Initialized for form: ${this.form.id || 'unnamed'}`);\n    }\n\n    bindEvents() {\n        // Submit event\n        this.form.addEventListener('submit', (e) => this.handleSubmit(e));\n        \n        // Field validation events\n        if (this.options.validateOnBlur || this.options.validateOnInput) {\n            const fields = this.form.querySelectorAll('input, textarea, select');\n            \n            fields.forEach(field => {\n                if (this.options.validateOnBlur) {\n                    field.addEventListener('blur', () => this.validateSingleField(field));\n                }\n                \n                if (this.options.validateOnInput) {\n                    field.addEventListener('input', () => this.validateSingleField(field));\n                }\n            });\n        }\n        \n        // Autosave events\n        if (this.options.enableAutosave) {\n            this.form.addEventListener('input', (e) => this.onAutosaveFieldChange(e));\n            this.form.addEventListener('change', (e) => this.onAutosaveFieldChange(e));\n            \n            // Save on page unload\n            window.addEventListener('beforeunload', () => {\n                if (this.state.isDirty()) {\n                    this.saveAutosaveDraft();\n                }\n            });\n            \n            // Handle page visibility changes\n            document.addEventListener('visibilitychange', () => {\n                if (document.hidden && this.state.isDirty()) {\n                    this.saveAutosaveDraft();\n                }\n            });\n        }\n    }\n\n    async handleSubmit(event) {\n        if (this.isSubmitting) {\n            event.preventDefault();\n            return;\n        }\n\n        // Validate if enabled\n        if (this.options.validateOnSubmit) {\n            const isValid = this.validator.validate();\n            \n            if (!isValid) {\n                event.preventDefault();\n                this.displayErrors();\n                return;\n            }\n        }\n\n        // AJAX submission\n        if (this.options.ajaxSubmit) {\n            event.preventDefault();\n            await this.submitViaAjax();\n        }\n        \n        // If not AJAX, let the form submit naturally\n    }\n\n    async submitViaAjax() {\n        try {\n            this.setSubmitState(true);\n            this.clearErrors();\n            \n            const formData = new FormData(this.form);\n            const url = this.form.action || window.location.href;\n            const method = this.form.method || this.options.submitMethod;\n            \n            const response = await fetch(url, {\n                method: method.toUpperCase(),\n                body: formData,\n                headers: {\n                    'X-Requested-With': 'XMLHttpRequest'\n                }\n            });\n            \n            const data = await this.parseResponse(response);\n            \n            if (response.ok) {\n                this.handleSuccess(data);\n            } else {\n                this.handleError(data);\n            }\n            \n        } catch (error) {\n            Logger.error('[FormHandler] Submit error:', error);\n            this.handleError({\n                message: 'Ein Fehler ist aufgetreten. Bitte versuchen Sie es erneut.',\n                errors: {}\n            });\n        } finally {\n            this.setSubmitState(false);\n        }\n    }\n\n    async parseResponse(response) {\n        const contentType = response.headers.get('content-type');\n        \n        if (contentType?.includes('application/json')) {\n            return await response.json();\n        }\n        \n        const text = await response.text();\n        \n        // Try to parse as JSON, fallback to text\n        try {\n            return JSON.parse(text);\n        } catch {\n            return { message: text };\n        }\n    }\n\n    handleSuccess(data) {\n        Logger.info('[FormHandler] Form submitted successfully');\n        \n        // Clear autosave draft on successful submission\n        if (this.options.enableAutosave) {\n            this.clearAutosaveDraft();\n        }\n        \n        // Clear form if configured\n        if (data.clearForm !== false) {\n            this.form.reset();\n            this.state.reset();\n        }\n        \n        this.showMessage(data.message || 'Formular erfolgreich gesendet!', 'success');\n        \n        // Call success callback\n        this.triggerEvent('form:success', { data });\n    }\n\n    handleError(data) {\n        Logger.warn('[FormHandler] Form submission error:', data);\n        \n        // Handle field-specific errors\n        if (data.errors && typeof data.errors === 'object') {\n            for (const [fieldName, errorMessage] of Object.entries(data.errors)) {\n                this.validator.errors.set(fieldName, errorMessage);\n            }\n            this.displayErrors();\n        }\n        \n        // Show general error message\n        this.showMessage(data.message || 'Ein Fehler ist aufgetreten.', 'error');\n        \n        // Call error callback\n        this.triggerEvent('form:error', { data });\n    }\n\n    validateSingleField(field) {\n        this.validator.errors.delete(field.name);\n        this.validator.validateField(field);\n        \n        this.displayFieldError(field);\n    }\n\n    displayErrors() {\n        if (!this.options.showInlineErrors) return;\n        \n        const errors = this.validator.getErrors();\n        \n        for (const [fieldName, message] of Object.entries(errors)) {\n            const field = this.form.querySelector(`[name=\"${fieldName}\"]`);\n            if (field) {\n                this.displayFieldError(field, message);\n            }\n        }\n    }\n\n    displayFieldError(field, message = null) {\n        const errorMessage = message || this.validator.getFieldError(field.name);\n        const errorElement = this.getOrCreateErrorElement(field);\n        \n        if (errorMessage) {\n            errorElement.textContent = errorMessage;\n            errorElement.style.display = 'block';\n            field.classList.add('error');\n            field.setAttribute('aria-invalid', 'true');\n            field.setAttribute('aria-describedby', errorElement.id);\n        } else {\n            errorElement.textContent = '';\n            errorElement.style.display = 'none';\n            field.classList.remove('error');\n            field.removeAttribute('aria-invalid');\n            field.removeAttribute('aria-describedby');\n        }\n    }\n\n    getOrCreateErrorElement(field) {\n        const errorId = `error-${field.name}`;\n        let errorElement = document.getElementById(errorId);\n        \n        if (!errorElement) {\n            errorElement = document.createElement('div');\n            errorElement.id = errorId;\n            errorElement.className = 'form-error';\n            errorElement.setAttribute('role', 'alert');\n            errorElement.style.display = 'none';\n            \n            // Insert after field or field container\n            const container = field.closest('.form-group') || field.parentElement;\n            container.appendChild(errorElement);\n        }\n        \n        return errorElement;\n    }\n\n    setupErrorDisplay() {\n        // Add CSS for error states if not present\n        if (!document.getElementById('form-handler-styles')) {\n            const styles = document.createElement('style');\n            styles.id = 'form-handler-styles';\n            styles.textContent = `\n                .form-error {\n                    color: #dc2626;\n                    font-size: 0.875rem;\n                    margin-top: 0.25rem;\n                }\n                input.error, textarea.error, select.error {\n                    border-color: #dc2626;\n                    box-shadow: 0 0 0 1px #dc2626;\n                }\n                .form-message {\n                    padding: 0.75rem;\n                    border-radius: 0.375rem;\n                    margin: 1rem 0;\n                }\n                .form-message.success {\n                    background-color: #dcfce7;\n                    color: #166534;\n                    border: 1px solid #bbf7d0;\n                }\n                .form-message.error {\n                    background-color: #fef2f2;\n                    color: #dc2626;\n                    border: 1px solid #fecaca;\n                }\n            `;\n            document.head.appendChild(styles);\n        }\n    }\n\n    showMessage(message, type = 'info') {\n        let messageContainer = this.form.querySelector('.form-messages');\n        \n        if (!messageContainer) {\n            messageContainer = document.createElement('div');\n            messageContainer.className = 'form-messages';\n            this.form.prepend(messageContainer);\n        }\n        \n        const messageElement = document.createElement('div');\n        messageElement.className = `form-message ${type}`;\n        messageElement.textContent = message;\n        messageElement.setAttribute('role', type === 'error' ? 'alert' : 'status');\n        \n        messageContainer.innerHTML = '';\n        messageContainer.appendChild(messageElement);\n        \n        // Auto-hide success messages after 5 seconds\n        if (type === 'success') {\n            setTimeout(() => {\n                if (messageElement.parentElement) {\n                    messageElement.remove();\n                }\n            }, 5000);\n        }\n    }\n\n    clearErrors() {\n        this.validator.clearErrors();\n        \n        // Clear visual error states\n        const errorFields = this.form.querySelectorAll('.error');\n        errorFields.forEach(field => {\n            field.classList.remove('error');\n            field.removeAttribute('aria-invalid');\n            field.removeAttribute('aria-describedby');\n        });\n        \n        // Hide error messages\n        const errorElements = this.form.querySelectorAll('.form-error');\n        errorElements.forEach(element => {\n            element.style.display = 'none';\n            element.textContent = '';\n        });\n        \n        // Clear general messages\n        const messageContainer = this.form.querySelector('.form-messages');\n        if (messageContainer) {\n            messageContainer.innerHTML = '';\n        }\n    }\n\n    setSubmitState(isSubmitting) {\n        this.isSubmitting = isSubmitting;\n        \n        const submitButtons = this.form.querySelectorAll('button[type=\"submit\"], input[type=\"submit\"]');\n        \n        submitButtons.forEach(button => {\n            button.disabled = isSubmitting;\n            \n            if (isSubmitting) {\n                button.setAttribute('data-original-text', button.textContent);\n                button.textContent = 'Wird gesendet...';\n            } else {\n                const originalText = button.getAttribute('data-original-text');\n                if (originalText) {\n                    button.textContent = originalText;\n                    button.removeAttribute('data-original-text');\n                }\n            }\n        });\n    }\n\n    triggerEvent(eventName, detail = {}) {\n        const event = new CustomEvent(eventName, { \n            detail,\n            bubbles: true,\n            cancelable: true \n        });\n        \n        this.form.dispatchEvent(event);\n    }\n\n    /**\n     * Initialize autosave functionality\n     */\n    initAutosave() {\n        // Generate storage key\n        this.autosaveStorageKey = this.options.autosaveStorageKey || \n            this.options.autosaveStoragePrefix + this.generateFormId();\n        \n        // Restore draft on init\n        this.restoreAutosaveDraft();\n        \n        // Start periodic autosave\n        this.startAutosave();\n        \n        Logger.info('[FormHandler] Autosave initialized', { storageKey: this.autosaveStorageKey });\n    }\n    \n    /**\n     * Generate unique form identifier\n     */\n    generateFormId() {\n        const formId = this.form.id || \n                      this.form.getAttribute('data-form-id') ||\n                      this.form.querySelector('input[name=\"_form_id\"]')?.value ||\n                      'form_' + Date.now();\n        \n        return formId.replace(/[^a-zA-Z0-9_-]/g, '_');\n    }\n    \n    /**\n     * Handle field change for autosave\n     */\n    onAutosaveFieldChange(event) {\n        const field = event.target;\n        \n        // Skip excluded fields\n        if (this.isAutosaveFieldExcluded(field)) {\n            return;\n        }\n        \n        // Save immediately for important fields\n        if (this.isAutosaveImmediateField(field)) {\n            this.saveAutosaveDraft();\n        }\n    }\n    \n    /**\n     * Check if field should be excluded from autosave\n     */\n    isAutosaveFieldExcluded(field) {\n        return this.options.autosaveExcludeFields.some(selector => \n            field.matches(selector)\n        );\n    }\n    \n    /**\n     * Check if field should trigger immediate save\n     */\n    isAutosaveImmediateField(field) {\n        return this.options.autosaveImmediateFields.some(selector => \n            field.matches(selector)\n        );\n    }\n    \n    /**\n     * Start periodic autosave\n     */\n    startAutosave() {\n        if (this.autosaveTimer) {\n            return;\n        }\n        \n        this.autosaveTimer = setInterval(() => {\n            if (this.state.isDirty()) {\n                this.saveAutosaveDraft();\n            }\n        }, this.options.autosaveInterval);\n        \n        Logger.debug('[FormHandler] Autosave started', { interval: this.options.autosaveInterval });\n    }\n    \n    /**\n     * Stop periodic autosave\n     */\n    stopAutosave() {\n        if (this.autosaveTimer) {\n            clearInterval(this.autosaveTimer);\n            this.autosaveTimer = null;\n        }\n    }\n    \n    /**\n     * Save form data as draft\n     */\n    saveAutosaveDraft() {\n        if (!this.form || !this.state.isDirty()) {\n            return;\n        }\n        \n        try {\n            const formData = this.extractAutosaveFormData();\n            \n            const draft = {\n                data: formData,\n                timestamp: Date.now(),\n                formId: this.generateFormId(),\n                url: window.location.href,\n                version: '1.0'\n            };\n            \n            localStorage.setItem(this.autosaveStorageKey, JSON.stringify(draft));\n            \n            this.lastAutosaveTime = new Date();\n            \n            Logger.debug('[FormHandler] Draft saved', {\n                fields: Object.keys(formData).length,\n                storageKey: this.autosaveStorageKey\n            });\n            \n            if (this.options.autosaveVisualFeedback) {\n                this.showAutosaveStatus('Draft saved', 'success', 1500);\n            }\n            \n            // Trigger event\n            this.triggerEvent('form:autosave', { draft });\n        } catch (error) {\n            Logger.error('[FormHandler] Failed to save draft', error);\n            \n            if (this.options.autosaveVisualFeedback) {\n                this.showAutosaveStatus('Failed to save draft', 'error', 3000);\n            }\n        }\n    }\n    \n    /**\n     * Restore draft data to form\n     */\n    restoreAutosaveDraft() {\n        try {\n            const draftJson = localStorage.getItem(this.autosaveStorageKey);\n            \n            if (!draftJson) {\n                return;\n            }\n            \n            const draft = JSON.parse(draftJson);\n            \n            // Check if draft is expired\n            const age = Date.now() - draft.timestamp;\n            if (age > this.options.autosaveRetentionPeriod) {\n                localStorage.removeItem(this.autosaveStorageKey);\n                return;\n            }\n            \n            // Restore form data\n            this.restoreAutosaveFormData(draft.data);\n            \n            Logger.info('[FormHandler] Draft restored', {\n                age: Math.floor(age / 1000) + 's',\n                fields: Object.keys(draft.data).length\n            });\n            \n            if (this.options.autosaveVisualFeedback) {\n                const ageText = this.formatDuration(age);\n                this.showAutosaveStatus(`Draft restored from ${ageText} ago`, 'info', 4000);\n            }\n            \n            // Trigger event\n            this.triggerEvent('form:autosave-restored', { draft });\n        } catch (error) {\n            Logger.error('[FormHandler] Failed to restore draft', error);\n            localStorage.removeItem(this.autosaveStorageKey);\n        }\n    }\n    \n    /**\n     * Extract form data for autosave (excluding sensitive fields)\n     */\n    extractAutosaveFormData() {\n        const fields = this.getFormFields();\n        const data = {};\n        \n        fields.forEach(field => {\n            if (!this.isAutosaveFieldExcluded(field)) {\n                const key = field.name || field.id;\n                const value = this.getAutosaveFieldValue(field);\n                \n                if (key && value !== null && value !== undefined && value !== '') {\n                    data[key] = value;\n                }\n            }\n        });\n        \n        return data;\n    }\n    \n    /**\n     * Restore data to form fields\n     */\n    restoreAutosaveFormData(data) {\n        let restoredCount = 0;\n        \n        Object.entries(data).forEach(([key, value]) => {\n            const field = this.form.querySelector(`[name=\"${key}\"], #${key}`);\n            \n            if (field && !this.isAutosaveFieldExcluded(field)) {\n                this.setAutosaveFieldValue(field, value);\n                restoredCount++;\n            }\n        });\n        \n        // Update form state\n        this.state.captureInitialValues();\n        \n        return restoredCount;\n    }\n    \n    /**\n     * Get form fields\n     */\n    getFormFields() {\n        return Array.from(this.form.querySelectorAll(\n            'input:not([type=\"submit\"]):not([type=\"button\"]):not([type=\"reset\"]), ' +\n            'textarea, select'\n        ));\n    }\n    \n    /**\n     * Get field value for autosave\n     */\n    getAutosaveFieldValue(field) {\n        switch (field.type) {\n            case 'checkbox':\n                return field.checked;\n            case 'radio':\n                return field.checked ? field.value : null;\n            case 'file':\n                return null; // Don't save file inputs\n            default:\n                return field.value;\n        }\n    }\n    \n    /**\n     * Set field value for autosave\n     */\n    setAutosaveFieldValue(field, value) {\n        switch (field.type) {\n            case 'checkbox':\n                field.checked = Boolean(value);\n                break;\n            case 'radio':\n                field.checked = (field.value === value);\n                break;\n            case 'file':\n                // Can't restore file inputs\n                break;\n            default:\n                field.value = value;\n                break;\n        }\n    }\n    \n    /**\n     * Clear autosave draft\n     */\n    clearAutosaveDraft() {\n        if (this.autosaveStorageKey) {\n            localStorage.removeItem(this.autosaveStorageKey);\n        }\n        Logger.debug('[FormHandler] Draft cleared');\n    }\n    \n    /**\n     * Format duration for human reading\n     */\n    formatDuration(ms) {\n        const seconds = Math.floor(ms / 1000);\n        const minutes = Math.floor(seconds / 60);\n        const hours = Math.floor(minutes / 60);\n        \n        if (hours > 0) {\n            return `${hours}h ${minutes % 60}m`;\n        } else if (minutes > 0) {\n            return `${minutes}m`;\n        } else {\n            return `${seconds}s`;\n        }\n    }\n    \n    /**\n     * Show autosave status message\n     */\n    showAutosaveStatus(message, type = 'info', duration = 3000) {\n        // Create or update status element\n        let statusEl = document.getElementById('form-autosave-status');\n        \n        if (!statusEl) {\n            statusEl = document.createElement('div');\n            statusEl.id = 'form-autosave-status';\n            statusEl.style.cssText = `\n                position: fixed;\n                bottom: 20px;\n                right: 20px;\n                padding: 8px 12px;\n                border-radius: 4px;\n                font-size: 12px;\n                z-index: 9999;\n                max-width: 250px;\n                box-shadow: 0 2px 8px rgba(0,0,0,0.1);\n                transition: opacity 0.3s ease;\n                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n            `;\n            document.body.appendChild(statusEl);\n        }\n        \n        statusEl.textContent = message;\n        \n        const styles = {\n            info: 'background: #e3f2fd; color: #1565c0; border: 1px solid #bbdefb;',\n            success: 'background: #e8f5e8; color: #2e7d32; border: 1px solid #c8e6c9;',\n            error: 'background: #ffebee; color: #c62828; border: 1px solid #ffcdd2;'\n        };\n        \n        statusEl.style.cssText += styles[type] || styles.info;\n        statusEl.style.opacity = '1';\n        \n        setTimeout(() => {\n            if (statusEl) {\n                statusEl.style.opacity = '0';\n                setTimeout(() => {\n                    if (statusEl && statusEl.parentNode) {\n                        statusEl.parentNode.removeChild(statusEl);\n                    }\n                }, 300);\n            }\n        }, duration);\n    }\n    \n    destroy() {\n        // Stop autosave\n        if (this.options.enableAutosave) {\n            this.stopAutosave();\n        }\n        \n        // Remove event listeners and clean up\n        this.form.removeAttribute('data-enhanced');\n        Logger.info('[FormHandler] Destroyed');\n    }\n}","import { Logger } from '../../core/logger.js';\nimport { FormHandler } from './FormHandler.js';\nimport { FormValidator } from './FormValidator.js';\nimport { FormState } from './FormState.js';\n\n/**\n * Form Handling Module\n * \n * Provides comprehensive form handling with:\n * - HTML5-based validation (reads validation rules from HTML attributes)\n * - AJAX form submission with error handling\n * - Form state management (pristine, dirty, touched)\n * - Progressive enhancement\n * \n * Usage:\n * - Add data-module=\"form-handling\" to any form element\n * - Configure via data-options attribute:\n *   data-options='{\"validateOnBlur\": true, \"ajaxSubmit\": true}'\n * \n * HTML Validation Attributes Supported:\n * - required: Field is required\n * - pattern: Custom regex pattern\n * - minlength/maxlength: String length limits\n * - min/max: Number range limits\n * - type=\"email\": Email validation\n * - type=\"url\": URL validation\n * - data-validate: Custom validation (phone, postal-code-de, no-html)\n * - data-error-*: Custom error messages\n */\n\nconst FormHandlingModule = {\n    name: 'form-handling',\n    \n    // Module-level init (called by module system)\n    init(config = {}, state = null) {\n        Logger.info('[FormHandling] Module initialized (ready for DOM elements)');\n        // Module is now ready - no DOM operations here\n        return this;\n    },\n    \n    // Element-specific init (called for individual form elements)\n    initElement(element, options = {}) {\n        Logger.info(`[FormHandling] Initializing on form: ${element.id || 'unnamed'}`);\n        \n        // Default configuration\n        const config = {\n            validateOnSubmit: true,\n            validateOnBlur: false,\n            validateOnInput: false,\n            showInlineErrors: true,\n            preventSubmitOnError: true,\n            ajaxSubmit: true,\n            submitMethod: 'POST',\n            enableStateTracking: true,\n            enableUnsavedWarning: false,\n            ...options\n        };\n        \n        // Initialize form handler\n        const formHandler = FormHandler.create(element, config);\n        \n        // Store reference for later access\n        element._formHandler = formHandler;\n        element._formValidator = formHandler.validator;\n        element._formState = formHandler.state;\n        \n        // Enable unsaved changes warning if configured\n        if (config.enableUnsavedWarning) {\n            formHandler.state.enableUnsavedChangesWarning();\n        }\n        \n        // Add module-specific CSS classes\n        element.classList.add('form-enhanced');\n        \n        // Trigger initialization event\n        const event = new CustomEvent('form:initialized', {\n            detail: {\n                handler: formHandler,\n                validator: formHandler.validator,\n                state: formHandler.state,\n                config: config\n            },\n            bubbles: true\n        });\n        \n        element.dispatchEvent(event);\n        \n        Logger.info(`[FormHandling] Successfully initialized for form: ${element.id || 'unnamed'}`);\n        \n        return formHandler;\n    },\n    \n    // Element-specific destroy (for form elements)\n    destroyElement(element) {\n        if (element._formHandler) {\n            element._formHandler.destroy();\n            delete element._formHandler;\n            delete element._formValidator;\n            delete element._formState;\n        }\n        \n        element.classList.remove('form-enhanced');\n        element.removeAttribute('data-enhanced');\n        \n        Logger.info(`[FormHandling] Destroyed for form: ${element.id || 'unnamed'}`);\n    },\n    \n    // Module-level destroy\n    destroy() {\n        Logger.info('[FormHandling] Module destroyed');\n    }\n};\n\n// Export individual classes for direct usage\nexport { FormHandler, FormValidator, FormState };\n\n// Export as default for module system\nexport default FormHandlingModule;\n\n// Export init function directly for compatibility with module system\nexport const init = FormHandlingModule.init.bind(FormHandlingModule);\nexport const initElement = FormHandlingModule.initElement.bind(FormHandlingModule);\n\n// Also export named for direct usage\nexport { FormHandlingModule };","import { Logger } from '../../core/logger.js';\r\n\r\nexport const definition = {\r\n    name: 'image-manager',\r\n    version: '1.0.0',\r\n    dependencies: [],\r\n    provides: ['image-upload', 'image-gallery', 'image-modal'],\r\n    priority: 5\r\n};\r\n\r\nconst ImageManagerModule = {\r\n    name: 'image-manager',\r\n    activeGalleries: new Map(),\r\n    activeUploaders: new Map(),\r\n\r\n    async init(config = {}, state) {\r\n        Logger.info('[ImageManager] Module initialized');\r\n\r\n        // Initialize all image gallery elements\r\n        this.initializeGalleries();\r\n\r\n        // Initialize all image uploader elements\r\n        this.initializeUploaders();\r\n\r\n        // Set up modal functionality\r\n        this.initializeModal();\r\n\r\n        return this;\r\n    },\r\n\r\n    initializeGalleries() {\r\n        const galleryElements = document.querySelectorAll('[data-image-gallery]');\r\n        Logger.info(`[ImageManager] Found ${galleryElements.length} gallery elements`);\r\n\r\n        galleryElements.forEach((element, index) => {\r\n            const galleryId = `gallery-${index}`;\r\n            const gallery = new ImageGallery(element, {\r\n                listEndpoint: element.dataset.listEndpoint || '/api/images',\r\n                pageSize: parseInt(element.dataset.pageSize) || 20,\r\n                columns: parseInt(element.dataset.columns) || 4\r\n            });\r\n\r\n            this.activeGalleries.set(galleryId, gallery);\r\n            Logger.info(`[ImageManager] Initialized gallery: ${galleryId}`);\r\n        });\r\n    },\r\n\r\n    initializeUploaders() {\r\n        const uploaderElements = document.querySelectorAll('[data-image-uploader]');\r\n        Logger.info(`[ImageManager] Found ${uploaderElements.length} uploader elements`);\r\n\r\n        uploaderElements.forEach((element, index) => {\r\n            const uploaderId = `uploader-${index}`;\r\n            const uploader = new ImageUploader(element, {\r\n                uploadUrl: element.dataset.uploadUrl || '/api/images',\r\n                maxFileSize: parseInt(element.dataset.maxFileSize) || 10485760,\r\n                allowedTypes: element.dataset.allowedTypes?.split(',') || ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],\r\n                maxFiles: parseInt(element.dataset.maxFiles) || 10\r\n            });\r\n\r\n            this.activeUploaders.set(uploaderId, uploader);\r\n            Logger.info(`[ImageManager] Initialized uploader: ${uploaderId}`);\r\n        });\r\n    },\r\n\r\n    initializeModal() {\r\n        const modal = new ImageModal();\r\n        window.ImageModal = modal;\r\n        Logger.info('[ImageManager] Modal initialized');\r\n    },\r\n\r\n    destroy() {\r\n        // Destroy all galleries\r\n        this.activeGalleries.forEach((gallery, id) => {\r\n            gallery.destroy();\r\n            Logger.info(`[ImageManager] Destroyed gallery: ${id}`);\r\n        });\r\n        this.activeGalleries.clear();\r\n\r\n        // Destroy all uploaders\r\n        this.activeUploaders.forEach((uploader, id) => {\r\n            uploader.destroy();\r\n            Logger.info(`[ImageManager] Destroyed uploader: ${id}`);\r\n        });\r\n        this.activeUploaders.clear();\r\n\r\n        // Clean up modal\r\n        if (window.ImageModal) {\r\n            window.ImageModal.destroy();\r\n            delete window.ImageModal;\r\n        }\r\n\r\n        Logger.info('[ImageManager] Module destroyed');\r\n    }\r\n};\r\n\r\n// Image Gallery Implementation\r\nclass ImageGallery {\r\n    constructor(element, config) {\r\n        this.element = element;\r\n        this.config = config;\r\n        this.currentPage = 1;\r\n        this.images = [];\r\n        this.loading = false;\r\n\r\n        this.init();\r\n    }\r\n\r\n    async init() {\r\n        Logger.info('[ImageGallery] Initializing gallery');\r\n\r\n        // Clear loading state and build UI\r\n        this.element.innerHTML = '';\r\n        this.buildGalleryUI();\r\n\r\n        // Load images\r\n        await this.loadImages();\r\n    }\r\n\r\n    buildGalleryUI() {\r\n        this.element.innerHTML = `\r\n            <div class=\"image-gallery\">\r\n                <div class=\"gallery__controls\">\r\n                    <div class=\"gallery__search-wrapper\">\r\n                        <input type=\"text\" class=\"gallery__search\" placeholder=\"Search images...\">\r\n                        <button type=\"button\" class=\"gallery__search-clear\">&times;</button>\r\n                    </div>\r\n                    <div class=\"gallery__sort-wrapper\">\r\n                        <label>Sort:</label>\r\n                        <select class=\"gallery__sort\">\r\n                            <option value=\"created_desc\">Newest First</option>\r\n                            <option value=\"created_asc\">Oldest First</option>\r\n                            <option value=\"name_asc\">Name A-Z</option>\r\n                            <option value=\"name_desc\">Name Z-A</option>\r\n                        </select>\r\n                    </div>\r\n                </div>\r\n                <div class=\"gallery__grid\" style=\"--columns: ${this.config.columns}\"></div>\r\n                <div class=\"gallery__pagination\">\r\n                    <button type=\"button\" class=\"gallery__load-more\" style=\"display: none;\">Load More</button>\r\n                </div>\r\n                <div class=\"gallery__loading\">\r\n                    <div class=\"loading-spinner\"></div>\r\n                    <p>Loading images...</p>\r\n                </div>\r\n            </div>\r\n        `;\r\n\r\n        // Add event listeners\r\n        this.setupEventListeners();\r\n    }\r\n\r\n    setupEventListeners() {\r\n        const searchInput = this.element.querySelector('.gallery__search');\r\n        const searchClear = this.element.querySelector('.gallery__search-clear');\r\n        const sortSelect = this.element.querySelector('.gallery__sort');\r\n        const loadMoreBtn = this.element.querySelector('.gallery__load-more');\r\n\r\n        // Search functionality\r\n        let searchTimeout;\r\n        searchInput.addEventListener('input', (e) => {\r\n            clearTimeout(searchTimeout);\r\n            searchTimeout = setTimeout(() => {\r\n                this.searchImages(e.target.value);\r\n            }, 300);\r\n        });\r\n\r\n        searchClear.addEventListener('click', () => {\r\n            searchInput.value = '';\r\n            this.searchImages('');\r\n        });\r\n\r\n        // Sort functionality\r\n        sortSelect.addEventListener('change', (e) => {\r\n            this.sortImages(e.target.value);\r\n        });\r\n\r\n        // Load more functionality\r\n        loadMoreBtn.addEventListener('click', () => {\r\n            this.loadMoreImages();\r\n        });\r\n    }\r\n\r\n    async loadImages() {\r\n        if (this.loading) return;\r\n\r\n        this.loading = true;\r\n        this.showLoading();\r\n\r\n        try {\r\n            Logger.info('[ImageGallery] Loading images from:', this.config.listEndpoint);\r\n\r\n            const response = await fetch(`${this.config.listEndpoint}?page=${this.currentPage}&limit=${this.config.pageSize}`);\r\n\r\n            if (!response.ok) {\r\n                throw new Error(`HTTP ${response.status}: ${response.statusText}`);\r\n            }\r\n\r\n            const response_data = await response.json();\r\n            Logger.info('[ImageGallery] API Response:', response_data);\r\n\r\n            // Handle different API response formats\r\n            let images = [];\r\n            let metaInfo = {};\r\n\r\n            if (response_data.data && Array.isArray(response_data.data)) {\r\n                // Format: {data: [...], meta: {...}}\r\n                images = response_data.data;\r\n                metaInfo = response_data.meta || {};\r\n            } else if (response_data.images && Array.isArray(response_data.images)) {\r\n                // Format: {images: [...]}\r\n                images = response_data.images;\r\n                metaInfo = response_data;\r\n            } else if (Array.isArray(response_data)) {\r\n                // Format: [...]\r\n                images = response_data;\r\n                metaInfo = {};\r\n            } else {\r\n                Logger.warn('[ImageGallery] Unexpected API response format:', response_data);\r\n                images = [];\r\n                metaInfo = {};\r\n            }\r\n\r\n            Logger.info('[ImageGallery] Processed images:', images.length);\r\n\r\n            if (this.currentPage === 1) {\r\n                this.images = images;\r\n            } else {\r\n                this.images = [...this.images, ...images];\r\n            }\r\n\r\n            this.renderImages();\r\n            this.updateLoadMoreButton(metaInfo);\r\n\r\n        } catch (error) {\r\n            Logger.error('[ImageGallery] Failed to load images:', error);\r\n            this.showError(`Failed to load images: ${error.message}`);\r\n        } finally {\r\n            this.loading = false;\r\n            this.hideLoading();\r\n        }\r\n    }\r\n\r\n    renderImages() {\r\n        const grid = this.element.querySelector('.gallery__grid');\r\n\r\n        if (this.images.length === 0) {\r\n            grid.innerHTML = `\r\n                <div class=\"gallery__empty\">\r\n                    <div class=\"empty-state__icon\">\r\n                        <svg width=\"48\" height=\"48\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1\">\r\n                            <rect x=\"3\" y=\"3\" width=\"18\" height=\"18\" rx=\"2\" ry=\"2\"></rect>\r\n                            <circle cx=\"8.5\" cy=\"8.5\" r=\"1.5\"></circle>\r\n                            <polyline points=\"21,15 16,10 5,21\"></polyline>\r\n                        </svg>\r\n                    </div>\r\n                    <h3>No images found</h3>\r\n                    <p>Upload some images to get started</p>\r\n                </div>\r\n            `;\r\n            return;\r\n        }\r\n\r\n        grid.innerHTML = this.images.map(image => this.renderImageItem(image)).join('');\r\n\r\n        // Add click handlers to gallery items\r\n        grid.querySelectorAll('.gallery__item').forEach((item, index) => {\r\n            item.addEventListener('click', () => {\r\n                this.showImageModal(this.images[index]);\r\n            });\r\n        });\r\n    }\r\n\r\n    renderImageItem(image) {\r\n        // Handle different API response formats for file size and dimensions\r\n        let fileSize = '0 B';\r\n        let dimensions = '0 × 0';\r\n\r\n        if (image.file_size) {\r\n            if (typeof image.file_size === 'object' && image.file_size.bytes) {\r\n                fileSize = this.formatFileSize(image.file_size.bytes);\r\n            } else if (typeof image.file_size === 'number') {\r\n                fileSize = this.formatFileSize(image.file_size);\r\n            }\r\n        }\r\n\r\n        if (image.dimensions && image.dimensions.width && image.dimensions.height) {\r\n            dimensions = `${image.dimensions.width} × ${image.dimensions.height}`;\r\n        } else if (image.width && image.height) {\r\n            dimensions = `${image.width} × ${image.height}`;\r\n        }\r\n\r\n        return `\r\n            <div class=\"gallery__item\" data-image-id=\"${image.ulid}\">\r\n                <div class=\"gallery__item-inner\">\r\n                    <div class=\"gallery__item-image\">\r\n                        <img src=\"${image.url}\" alt=\"${image.alt_text || image.filename}\" loading=\"lazy\">\r\n                        <div class=\"gallery__item-overlay\">\r\n                            <div class=\"gallery__item-actions\">\r\n                                <button type=\"button\" class=\"action-btn\" title=\"View Details\">👁</button>\r\n                                <button type=\"button\" class=\"action-btn\" title=\"Edit\">✏️</button>\r\n                                <button type=\"button\" class=\"action-btn\" title=\"Delete\">🗑</button>\r\n                            </div>\r\n                        </div>\r\n                    </div>\r\n                    <div class=\"gallery__item-info\">\r\n                        <div class=\"gallery__item-name\" title=\"${image.original_filename || image.filename}\">\r\n                            ${image.original_filename || image.filename}\r\n                        </div>\r\n                        <div class=\"gallery__item-meta\">\r\n                            <span class=\"meta-item\">${dimensions}</span>\r\n                            <span class=\"meta-item\">${fileSize}</span>\r\n                            <span class=\"meta-item\">${(image.mime_type || '').replace('image/', '')}</span>\r\n                        </div>\r\n                    </div>\r\n                </div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    showImageModal(image) {\r\n        if (window.ImageModal) {\r\n            window.ImageModal.show(image);\r\n        }\r\n    }\r\n\r\n    formatFileSize(bytes) {\r\n        const sizes = ['B', 'KB', 'MB', 'GB'];\r\n        if (bytes === 0) return '0 B';\r\n        const i = Math.floor(Math.log(bytes) / Math.log(1024));\r\n        return `${Math.round(bytes / Math.pow(1024, i) * 100) / 100} ${sizes[i]}`;\r\n    }\r\n\r\n    showLoading() {\r\n        const loading = this.element.querySelector('.gallery__loading');\r\n        if (loading) loading.style.display = 'flex';\r\n    }\r\n\r\n    hideLoading() {\r\n        const loading = this.element.querySelector('.gallery__loading');\r\n        if (loading) loading.style.display = 'none';\r\n    }\r\n\r\n    showError(message) {\r\n        const grid = this.element.querySelector('.gallery__grid');\r\n        grid.innerHTML = `\r\n            <div class=\"gallery__error\">\r\n                <div class=\"error-message\">\r\n                    <span>⚠️</span>\r\n                    <span>${message}</span>\r\n                    <button type=\"button\" class=\"error-close\" onclick=\"this.parentElement.parentElement.remove()\">&times;</button>\r\n                </div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    updateLoadMoreButton(metaInfo) {\r\n        const loadMoreBtn = this.element.querySelector('.gallery__load-more');\r\n        const hasMore = metaInfo.has_more || metaInfo.hasMore || metaInfo.pagination?.hasMore || false;\r\n\r\n        if (hasMore) {\r\n            loadMoreBtn.style.display = 'block';\r\n            loadMoreBtn.disabled = false;\r\n        } else {\r\n            loadMoreBtn.style.display = 'none';\r\n        }\r\n    }\r\n\r\n    async loadMoreImages() {\r\n        this.currentPage++;\r\n        await this.loadImages();\r\n    }\r\n\r\n    searchImages(query) {\r\n        // Simple client-side search for now\r\n        // TODO: Implement server-side search\r\n        const filteredImages = this.images.filter(image =>\r\n            (image.filename || '').toLowerCase().includes(query.toLowerCase()) ||\r\n            (image.original_filename || '').toLowerCase().includes(query.toLowerCase()) ||\r\n            (image.alt_text || '').toLowerCase().includes(query.toLowerCase())\r\n        );\r\n\r\n        const grid = this.element.querySelector('.gallery__grid');\r\n        grid.innerHTML = filteredImages.map(image => this.renderImageItem(image)).join('');\r\n    }\r\n\r\n    sortImages(sortType) {\r\n        const sortedImages = [...this.images];\r\n\r\n        switch (sortType) {\r\n            case 'created_desc':\r\n                sortedImages.sort((a, b) => new Date(b.created_at) - new Date(a.created_at));\r\n                break;\r\n            case 'created_asc':\r\n                sortedImages.sort((a, b) => new Date(a.created_at) - new Date(b.created_at));\r\n                break;\r\n            case 'name_asc':\r\n                sortedImages.sort((a, b) => (a.filename || '').localeCompare(b.filename || ''));\r\n                break;\r\n            case 'name_desc':\r\n                sortedImages.sort((a, b) => (b.filename || '').localeCompare(a.filename || ''));\r\n                break;\r\n        }\r\n\r\n        this.images = sortedImages;\r\n        this.renderImages();\r\n    }\r\n\r\n    destroy() {\r\n        // Clean up event listeners and DOM\r\n        this.element.innerHTML = '';\r\n        Logger.info('[ImageGallery] Gallery destroyed');\r\n    }\r\n}\r\n\r\n// Placeholder classes for uploader and modal\r\nclass ImageUploader {\r\n    constructor(element, config) {\r\n        this.element = element;\r\n        this.config = config;\r\n        Logger.info('[ImageUploader] Uploader placeholder initialized');\r\n    }\r\n\r\n    destroy() {\r\n        Logger.info('[ImageUploader] Uploader destroyed');\r\n    }\r\n}\r\n\r\nclass ImageModal {\r\n    constructor() {\r\n        Logger.info('[ImageModal] Modal placeholder initialized');\r\n    }\r\n\r\n    show(image) {\r\n        Logger.info('[ImageModal] Would show modal for image:', image);\r\n    }\r\n\r\n    destroy() {\r\n        Logger.info('[ImageModal] Modal destroyed');\r\n    }\r\n}\r\n\r\n// Export for module system - following exact pattern from working modules\r\nexport const init = ImageManagerModule.init.bind(ImageManagerModule);\r\nexport const destroy = ImageManagerModule.destroy.bind(ImageManagerModule);\r\nexport default ImageManagerModule;","// modules/inertia-scroll/index.js\nimport { registerFrameTask, unregisterFrameTask } from '../../core/frameloop.js';\n\nlet taskId = 'inertia-scroll';\nlet velocity = 0;\nlet lastY = window.scrollY;\nlet active = false;\nlet scrollEndTimer;\nlet damping = 0.9;\nlet minVelocity = 0.2;\n\nexport function init(config = {}) {\n    damping = typeof config.damping === 'number' ? config.damping : 0.9;\n\n    minVelocity = typeof config.minVelocity === 'number' ? contig.minVelocity : 0.1;\n\n    window.addEventListener('scroll', onScroll, { passive: true });\n\n    registerFrameTask(taskId, () => {\n        const root = document.documentElement;\n        const scrollY = window.scrollY;\n        const delta = scrollY - lastY;\n        const direction = delta > 0 ? 'down' : delta < 0 ? 'up' : 'none';\n        const speed = Math.abs(delta);\n\n        if (!active && Math.abs(velocity) > minVelocity) {\n            window.scrollTo(0, scrollY + velocity);\n            velocity *= damping; // Trägheit / Dämpfung\n            root.dataset.scrollState = 'inertia';\n        } else if (active) {\n            velocity = delta;\n            lastY = scrollY;\n            root.dataset.scrollState = 'active';\n        } else {\n            delete root.dataset.scrollState;\n        }\n\n        root.dataset.scrollDirection = direction;\n        root.dataset.scrollSpeed = speed.toFixed(2);\n    }, { autoStart: true });\n}\n\nfunction onScroll() {\n    active = true;\n    clearTimeout(scrollEndTimer);\n    scrollEndTimer = setTimeout(() => {\n        active = false;\n    }, 50);\n}\n\nexport function destroy() {\n    window.removeEventListener('scroll', onScroll);\n    unregisterFrameTask(taskId);\n    velocity = 0;\n    lastY = window.scrollY;\n    active = false;\n    clearTimeout(scrollEndTimer);\n\n    const root = document.documentElement;\n    delete root.dataset.scrollState;\n    delete root.dataset.scrollDirection;\n    delete root.dataset.scrollSpeed;\n}\n","import {useEvent} from \"../../../core/useEvent\";\n\nexport class Dialog {\n    constructor({content = '', className = '', onClose = null} = {}) {\n        this.onClose = onClose;\n        this.className = className;\n        this.isOpenState = false;\n        this.dialog = document.createElement('dialog');\n        this.dialog.className = className;\n        this.eventCleanup = []; // Track cleanup functions\n        \n        this.updateContent(content);\n        this.bindEvents();\n    }\n\n    /**\n     * Bind event handlers to the dialog\n     */\n    bindEvents() {\n        // Clean up any existing event listeners first\n        this.cleanupEvents();\n        \n        // Store references to bound event handlers for cleanup\n        this.clickHandler = (e) => {\n            const isOutside = !e.target.closest('.' + this.className + '-content');\n            if (isOutside) this.close();\n        };\n\n        this.cancelHandler = (e) => {\n            e.preventDefault();\n            this.close();\n        };\n        \n        // Use direct event listeners instead of useEvent to avoid module-based cleanup issues\n        this.dialog.addEventListener('click', this.clickHandler);\n        this.dialog.addEventListener('cancel', this.cancelHandler);\n        \n        // Store cleanup functions\n        this.eventCleanup = [\n            () => this.dialog.removeEventListener('click', this.clickHandler),\n            () => this.dialog.removeEventListener('cancel', this.cancelHandler)\n        ];\n    }\n\n    /**\n     * Clean up existing event listeners\n     */\n    cleanupEvents() {\n        this.eventCleanup.forEach(cleanup => cleanup());\n        this.eventCleanup = [];\n    }\n\n    /**\n     * Update the content of the dialog without recreating it\n     * @param {string} content - New HTML content\n     */\n    updateContent(content) {\n        this.dialog.innerHTML = `\n            <form method=\"dialog\" class=\"${this.className}-content\">\n                ${content}\n                <button class=\"${this.className}-close\" value=\"close\">×</button>\n            </form>\n        `;\n        \n        // No need to rebind events - they're attached to the dialog element itself\n        // which doesn't get replaced by innerHTML\n    }\n\n    open() {\n        // Always ensure dialog is in DOM\n        if (!this.dialog.parentElement) {\n            document.body.appendChild(this.dialog);\n        }\n        \n        // Force close if somehow already open\n        if (this.dialog.hasAttribute('open') || this.dialog.open) {\n            this.dialog.close?.() || this.dialog.removeAttribute('open');\n        }\n        \n        // Now open fresh\n        this.dialog.showModal?.() || this.dialog.setAttribute('open', '');\n        document.documentElement.dataset[`${this.dialog.className}Open`] = 'true';\n        this.isOpenState = true;\n    }\n\n    close() {\n        if (this.isOpenState) {\n            this.dialog.close?.() || this.dialog.removeAttribute('open');\n            delete document.documentElement.dataset[`${this.dialog.className}Open`];\n            this.isOpenState = false;\n            \n            // Keep dialog in DOM for reuse, just hide it\n            // Don't remove from DOM to enable singleton pattern\n            \n            this.onClose?.();\n        }\n    }\n\n    /**\n     * Check if dialog is currently open (checks both state and DOM)\n     * @returns {boolean}\n     */\n    isOpen() {\n        // Check both our internal state and the actual DOM state\n        const domIsOpen = this.dialog && (this.dialog.hasAttribute('open') || this.dialog.open);\n        \n        // Sync our internal state with DOM reality\n        if (domIsOpen !== this.isOpenState) {\n            this.isOpenState = domIsOpen;\n        }\n        \n        return this.isOpenState;\n    }\n\n    /**\n     * Destroy the dialog completely (for cleanup)\n     */\n    destroy() {\n        if (this.isOpenState) {\n            this.close();\n        }\n        this.cleanupEvents();\n        if (this.dialog.parentElement) {\n            this.dialog.remove();\n        }\n    }\n}\n","// modules/ui/UIManager.js\nimport { Modal } from './components/Modal.js';\nimport { Lightbox } from './components/Lightbox.js';\nimport { Logger } from '../../core/logger.js';\n\n/**\n * @typedef {Object} UIComponentProps\n * @property {string} [content] - HTML content for the component\n * @property {Function} [onClose] - Callback when component closes\n */\n\n/**\n * Available UI components\n * @type {Object<string, Function>}\n */\nconst components = {\n    modal: Modal,\n    lightbox: Lightbox,\n};\n\n/**\n * Active component instances (singletons)\n * @type {Object<string, Object>}\n */\nconst activeInstances = {};\n\n/**\n * UI Manager for creating and managing UI components\n * @namespace UIManager\n */\nexport const UIManager = {\n    /**\n     * Open a UI component (reuses existing instance for singletons)\n     * @param {string} type - Component type (e.g., 'modal', 'lightbox')\n     * @param {UIComponentProps} [props={}] - Component properties\n     * @returns {Object|null} Component instance or null if type unknown\n     */\n    open(type, props = {}) {\n        const Component = components[type];\n        if (!Component) {\n            Logger.warn(`[UIManager] Unknown type: ${type}`);\n            return null;\n        }\n        \n        // For lightbox, reuse existing instance for efficiency\n        if (type === 'lightbox') {\n            if (activeInstances.lightbox) {\n                Logger.info('[UIManager] Reusing existing lightbox instance');\n                \n                // Update content and reopen\n                activeInstances.lightbox.updateContent(props.content || '');\n                \n                // Always call open() to ensure it's shown, regardless of current state\n                activeInstances.lightbox.open();\n                \n                return activeInstances.lightbox;\n            } else {\n                Logger.info('[UIManager] Creating new lightbox instance');\n                \n                // Create new instance and store it\n                const instance = new Component({\n                    ...props,\n                    onClose: () => {\n                        // Don't delete the instance, just close it for reuse\n                        Logger.info('[UIManager] Lightbox closed, instance kept for reuse');\n                        if (props.onClose) props.onClose();\n                    }\n                });\n                activeInstances.lightbox = instance;\n                instance.open();\n                return instance;\n            }\n        }\n        \n        // For other components, create new instances\n        const instance = new Component(props);\n        instance.open();\n        return instance;\n    },\n\n    /**\n     * Close a UI component instance\n     * @param {Object} instance - Component instance to close\n     */\n    close(instance) {\n        if (instance?.close) instance.close();\n    },\n\n    /**\n     * Close a component by type\n     * @param {string} type - Component type to close\n     */\n    closeByType(type) {\n        if (activeInstances[type]) {\n            this.close(activeInstances[type]);\n        }\n    },\n\n    /**\n     * Check if a component is currently open\n     * @param {string} type - Component type to check\n     * @returns {boolean}\n     */\n    isOpen(type) {\n        return activeInstances[type]?.isOpen() || false;\n    },\n\n    /**\n     * Destroy all active instances (cleanup)\n     */\n    destroyAll() {\n        Object.values(activeInstances).forEach(instance => {\n            if (instance?.destroy) {\n                instance.destroy();\n            }\n        });\n        Object.keys(activeInstances).forEach(key => {\n            delete activeInstances[key];\n        });\n    }\n};\n","import { Dialog } from './Dialog.js';\nexport class Modal extends Dialog {\n    constructor(props) {\n        super({ ...props, className: 'modal' });\n    }\n}\n","import { Dialog } from './Dialog.js';\nexport class Lightbox extends Dialog {\n    constructor(props) {\n        super({ ...props, className: 'lightbox' });\n    }\n}\n","// modules/lightbox-trigger/index.js\nimport { UIManager } from '../ui/UIManager.js';\nimport { Logger } from '../../core/logger.js';\nimport { useEvent } from '../../core/useEvent.js';\n\nfunction onClick(e) {\n    // Check if the clicked element is an image\n    let img = null;\n    \n    if (e.target.tagName === 'IMG') {\n        img = e.target;\n    } else {\n        // Check if clicked element contains an image\n        img = e.target.querySelector('img');\n    }\n    \n    if (!img) return;\n    \n    // Opt-out mechanism: skip if image has data-lightbox=\"false\"\n    if (img.dataset.lightbox === 'false') return;\n    \n    // Skip very small images (likely icons, thumbnails, decorative)\n    if (img.naturalWidth < 200 || img.naturalHeight < 200) return;\n    \n    // Skip images in specific containers that shouldn't open lightbox\n    if (img.closest('nav, header, footer, .no-lightbox')) return;\n    \n    e.preventDefault();\n    \n    // Get the best quality source for lightbox\n    const lightboxSrc = getBestImageSource(img);\n    const caption = img.alt || img.dataset.caption || img.title || '';\n    \n    // Create responsive picture element for lightbox\n    const pictureElement = img.closest('picture');\n    let lightboxContent;\n    \n    if (pictureElement) {\n        // Clone the entire picture element for responsive display\n        const clonedPicture = pictureElement.cloneNode(true);\n        const clonedImg = clonedPicture.querySelector('img');\n        clonedImg.className = 'lightbox-image';\n        \n        lightboxContent = `\n            <div class=\"lightbox-content\">\n                ${clonedPicture.outerHTML}\n                ${caption ? `<div class=\"lightbox-caption\">${caption}</div>` : ''}\n            </div>\n        `;\n        \n        Logger.info('[Lightbox] Opening responsive image (picture element):', lightboxSrc);\n    } else {\n        // Fallback for standalone img elements\n        lightboxContent = `\n            <div class=\"lightbox-content\">\n                <img src=\"${lightboxSrc}\" alt=\"${caption}\" class=\"lightbox-image\" />\n                ${caption ? `<div class=\"lightbox-caption\">${caption}</div>` : ''}\n            </div>\n        `;\n        \n        Logger.info('[Lightbox] Opening standalone image:', lightboxSrc);\n    }\n    \n    // Use singleton lightbox instance\n    const lightbox = UIManager.open('lightbox', {\n        content: lightboxContent\n    });\n    \n    // Log reuse status\n    if (UIManager.isOpen('lightbox') && lightbox) {\n        Logger.info('[Lightbox] Reused existing lightbox instance');\n    }\n}\n\nfunction getBestImageSource(img) {\n    // Priority order for getting the best image source:\n    // 1. data-lightbox-src (explicitly defined high-res version)\n    // 2. currentSrc (browser-selected responsive source)\n    // 3. src (fallback)\n    \n    if (img.dataset.lightboxSrc) {\n        return img.dataset.lightboxSrc;\n    }\n    \n    if (img.currentSrc) {\n        return img.currentSrc;\n    }\n    \n    return img.src;\n}\n\nexport function init() {\n    Logger.info('[lightbox-trigger] Auto-enabling lightbox for all images (including picture/srcset)');\n    Logger.info('[lightbox-trigger] Use data-lightbox=\"false\" to opt-out');\n    Logger.info('[lightbox-trigger] Use data-lightbox-src for custom high-res versions');\n    \n    useEvent(document, 'click', onClick);\n    \n    // Add visual indicator to lightbox-enabled images\n    enhanceImages();\n}\n\nfunction enhanceImages() {\n    const images = document.querySelectorAll('img:not([data-lightbox=\"false\"])');\n    let enhancedCount = 0;\n    \n    images.forEach(img => {\n        // Skip small images and images in excluded containers\n        if (img.naturalWidth < 200 || img.naturalHeight < 200) return;\n        if (img.closest('nav, header, footer, .no-lightbox')) return;\n        \n        // Add CSS class for styling\n        img.classList.add('lightbox-enabled');\n        \n        // Add cursor pointer\n        img.style.cursor = 'zoom-in';\n        \n        // Add title hint if none exists\n        if (!img.title && !img.alt) {\n            img.title = 'Klicken zum Vergrößern';\n        }\n        \n        enhancedCount++;\n    });\n    \n    Logger.info(`[Lightbox] Enhanced ${enhancedCount} images with lightbox functionality`);\n}\n\nexport function destroy() {\n    Logger.info('[lightbox-trigger] destroy');\n    \n    // Remove enhancements\n    const enhancedImages = document.querySelectorAll('img.lightbox-enabled');\n    enhancedImages.forEach(img => {\n        img.classList.remove('lightbox-enabled');\n        img.style.cursor = '';\n        if (img.title === 'Klicken zum Vergrößern') {\n            img.title = '';\n        }\n    });\n    \n    // Event removal happens automatically via EventManager\n}\n","/**\r\n * Lightweight DOM Patcher for LiveComponent Fragments\r\n *\r\n * Efficiently patches specific DOM fragments without full re-render.\r\n * Optimized for LiveComponent use case with minimal overhead.\r\n *\r\n * Features:\r\n * - Smart element matching by tag and data-lc-fragment attribute\r\n * - Attribute diffing and patching\r\n * - Text content updates\r\n * - Child node reconciliation\r\n * - Preserves focus and scroll position where possible\r\n *\r\n * Philosophy:\r\n * - Keep it simple and focused\r\n * - No external dependencies\r\n * - Framework-compliant modern JavaScript\r\n */\r\nexport class DomPatcher {\r\n    /**\r\n     * Patch a specific fragment within a container\r\n     *\r\n     * @param {HTMLElement} container - Container element to search in\r\n     * @param {string} fragmentName - Fragment name (data-lc-fragment value)\r\n     * @param {string} newHtml - New HTML for the fragment\r\n     * @returns {boolean} - True if fragment was patched, false if not found\r\n     */\r\n    patchFragment(container, fragmentName, newHtml) {\r\n        // Find existing fragment element\r\n        const existingElement = container.querySelector(`[data-lc-fragment=\"${fragmentName}\"]`);\r\n\r\n        if (!existingElement) {\r\n            console.warn(`[DomPatcher] Fragment not found: ${fragmentName}`);\r\n            return false;\r\n        }\r\n\r\n        // Parse new HTML into element\r\n        const temp = document.createElement('div');\r\n        temp.innerHTML = newHtml;\r\n        const newElement = temp.firstElementChild;\r\n\r\n        if (!newElement) {\r\n            console.warn(`[DomPatcher] Invalid HTML for fragment: ${fragmentName}`);\r\n            return false;\r\n        }\r\n\r\n        // Verify fragment name matches\r\n        if (newElement.getAttribute('data-lc-fragment') !== fragmentName) {\r\n            console.warn(`[DomPatcher] Fragment name mismatch: expected ${fragmentName}, got ${newElement.getAttribute('data-lc-fragment')}`);\r\n            return false;\r\n        }\r\n\r\n        // Patch the element in place\r\n        this.patchElement(existingElement, newElement);\r\n\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Patch multiple fragments at once\r\n     *\r\n     * @param {HTMLElement} container - Container element\r\n     * @param {Object.<string, string>} fragments - Map of fragment names to HTML\r\n     * @returns {Object.<string, boolean>} - Map of fragment names to success status\r\n     */\r\n    patchFragments(container, fragments) {\r\n        const results = {};\r\n\r\n        for (const [fragmentName, html] of Object.entries(fragments)) {\r\n            results[fragmentName] = this.patchFragment(container, fragmentName, html);\r\n        }\r\n\r\n        return results;\r\n    }\r\n\r\n    /**\r\n     * Patch an element with new content\r\n     *\r\n     * Core patching logic that efficiently updates only what changed.\r\n     *\r\n     * @param {HTMLElement} oldElement - Existing element to patch\r\n     * @param {HTMLElement} newElement - New element with updated content\r\n     */\r\n    patchElement(oldElement, newElement) {\r\n        // 1. Patch attributes\r\n        this.patchAttributes(oldElement, newElement);\r\n\r\n        // 2. Patch child nodes\r\n        this.patchChildren(oldElement, newElement);\r\n    }\r\n\r\n    /**\r\n     * Patch element attributes\r\n     *\r\n     * Only updates attributes that actually changed.\r\n     *\r\n     * @param {HTMLElement} oldElement - Existing element\r\n     * @param {HTMLElement} newElement - New element\r\n     */\r\n    patchAttributes(oldElement, newElement) {\r\n        // Get all attributes from both elements\r\n        const oldAttrs = new Map();\r\n        const newAttrs = new Map();\r\n\r\n        for (const attr of oldElement.attributes) {\r\n            oldAttrs.set(attr.name, attr.value);\r\n        }\r\n\r\n        for (const attr of newElement.attributes) {\r\n            newAttrs.set(attr.name, attr.value);\r\n        }\r\n\r\n        // Remove attributes that no longer exist\r\n        for (const [name, value] of oldAttrs) {\r\n            if (!newAttrs.has(name)) {\r\n                oldElement.removeAttribute(name);\r\n            }\r\n        }\r\n\r\n        // Add or update attributes\r\n        for (const [name, value] of newAttrs) {\r\n            if (oldAttrs.get(name) !== value) {\r\n                oldElement.setAttribute(name, value);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Patch child nodes\r\n     *\r\n     * Reconciles child nodes between old and new elements.\r\n     * Uses simple key-based matching for efficiency.\r\n     *\r\n     * @param {HTMLElement} oldElement - Existing element\r\n     * @param {HTMLElement} newElement - New element\r\n     */\r\n    patchChildren(oldElement, newElement) {\r\n        const oldChildren = Array.from(oldElement.childNodes);\r\n        const newChildren = Array.from(newElement.childNodes);\r\n\r\n        const maxLength = Math.max(oldChildren.length, newChildren.length);\r\n\r\n        for (let i = 0; i < maxLength; i++) {\r\n            const oldChild = oldChildren[i];\r\n            const newChild = newChildren[i];\r\n\r\n            if (!oldChild && newChild) {\r\n                // New child added - append it\r\n                oldElement.appendChild(newChild.cloneNode(true));\r\n            } else if (oldChild && !newChild) {\r\n                // Child removed - remove it\r\n                oldElement.removeChild(oldChild);\r\n            } else if (oldChild && newChild) {\r\n                // Both exist - patch or replace\r\n                if (this.shouldPatch(oldChild, newChild)) {\r\n                    if (oldChild.nodeType === Node.ELEMENT_NODE) {\r\n                        this.patchElement(oldChild, newChild);\r\n                    } else if (oldChild.nodeType === Node.TEXT_NODE) {\r\n                        if (oldChild.nodeValue !== newChild.nodeValue) {\r\n                            oldChild.nodeValue = newChild.nodeValue;\r\n                        }\r\n                    }\r\n                } else {\r\n                    // Different node types or tags - replace\r\n                    oldElement.replaceChild(newChild.cloneNode(true), oldChild);\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Determine if two nodes should be patched or replaced\r\n     *\r\n     * Nodes should be patched if they are compatible (same type and tag).\r\n     *\r\n     * @param {Node} oldNode - Existing node\r\n     * @param {Node} newNode - New node\r\n     * @returns {boolean} - True if nodes should be patched\r\n     */\r\n    shouldPatch(oldNode, newNode) {\r\n        // Different node types - replace\r\n        if (oldNode.nodeType !== newNode.nodeType) {\r\n            return false;\r\n        }\r\n\r\n        // Text nodes can always be patched\r\n        if (oldNode.nodeType === Node.TEXT_NODE) {\r\n            return true;\r\n        }\r\n\r\n        // Element nodes - check if same tag\r\n        if (oldNode.nodeType === Node.ELEMENT_NODE) {\r\n            if (oldNode.tagName !== newNode.tagName) {\r\n                return false;\r\n            }\r\n\r\n            // Check for special keys that indicate identity\r\n            const oldKey = oldNode.getAttribute('data-lc-key') || oldNode.getAttribute('id');\r\n            const newKey = newNode.getAttribute('data-lc-key') || newNode.getAttribute('id');\r\n\r\n            // If both have keys, they must match\r\n            if (oldKey && newKey) {\r\n                return oldKey === newKey;\r\n            }\r\n\r\n            // Otherwise, assume they match (same tag is enough)\r\n            return true;\r\n        }\r\n\r\n        // Other node types - replace\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Preserve focus state before patching\r\n     *\r\n     * Returns a function to restore focus after patching.\r\n     *\r\n     * @param {HTMLElement} container - Container being patched\r\n     * @returns {Function} - Restore function\r\n     */\r\n    preserveFocus(container) {\r\n        const activeElement = document.activeElement;\r\n\r\n        // Check if focused element is within container\r\n        if (!activeElement || !container.contains(activeElement)) {\r\n            return () => {}; // No-op restore\r\n        }\r\n\r\n        // Get selector for focused element\r\n        const selector = this.getElementSelector(activeElement);\r\n        const selectionStart = activeElement.selectionStart;\r\n        const selectionEnd = activeElement.selectionEnd;\r\n\r\n        // Return restore function\r\n        return () => {\r\n            try {\r\n                if (selector) {\r\n                    const element = container.querySelector(selector);\r\n                    if (element && element.focus) {\r\n                        element.focus();\r\n\r\n                        // Restore selection for input/textarea\r\n                        if (element.setSelectionRange &&\r\n                            typeof selectionStart === 'number' &&\r\n                            typeof selectionEnd === 'number') {\r\n                            element.setSelectionRange(selectionStart, selectionEnd);\r\n                        }\r\n                    }\r\n                }\r\n            } catch (e) {\r\n                // Focus restoration failed - not critical\r\n                console.debug('[DomPatcher] Could not restore focus:', e);\r\n            }\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Get a selector for an element\r\n     *\r\n     * Tries to create a unique selector using ID, name, or data attributes.\r\n     *\r\n     * @param {HTMLElement} element - Element to get selector for\r\n     * @returns {string|null} - CSS selector or null\r\n     */\r\n    getElementSelector(element) {\r\n        if (element.id) {\r\n            return `#${element.id}`;\r\n        }\r\n\r\n        if (element.name) {\r\n            return `[name=\"${element.name}\"]`;\r\n        }\r\n\r\n        const lcKey = element.getAttribute('data-lc-key');\r\n        if (lcKey) {\r\n            return `[data-lc-key=\"${lcKey}\"]`;\r\n        }\r\n\r\n        // Fallback - not guaranteed to be unique\r\n        return element.tagName.toLowerCase();\r\n    }\r\n}\r\n\r\n// Create singleton instance\r\nexport const domPatcher = new DomPatcher();\r\n\r\nexport default domPatcher;\r\n","/**\r\n * SSE (Server-Sent Events) Client Module\r\n *\r\n * Provides real-time server push capabilities for LiveComponents.\r\n *\r\n * Features:\r\n * - Auto-reconnect with exponential backoff\r\n * - Multi-channel subscription\r\n * - Event type routing\r\n * - Heartbeat monitoring\r\n * - Connection state management\r\n *\r\n * @module sse\r\n */\r\n\r\n/**\r\n * Connection states\r\n */\r\nconst ConnectionState = {\r\n    DISCONNECTED: 'disconnected',\r\n    CONNECTING: 'connecting',\r\n    CONNECTED: 'connected',\r\n    ERROR: 'error'\r\n};\r\n\r\n/**\r\n * Reconnection strategy with exponential backoff\r\n */\r\nclass ReconnectionStrategy {\r\n    constructor() {\r\n        this.attempt = 0;\r\n        this.baseDelay = 1000; // 1s\r\n        this.maxDelay = 30000; // 30s\r\n        this.maxAttempts = 10;\r\n    }\r\n\r\n    /**\r\n     * Get delay for current attempt with jitter\r\n     */\r\n    getDelay() {\r\n        const delay = Math.min(\r\n            this.baseDelay * Math.pow(2, this.attempt),\r\n            this.maxDelay\r\n        );\r\n\r\n        // Add jitter (±25%)\r\n        const jitter = delay * 0.25 * (Math.random() - 0.5);\r\n\r\n        return Math.floor(delay + jitter);\r\n    }\r\n\r\n    /**\r\n     * Check if should retry\r\n     */\r\n    shouldRetry() {\r\n        return this.attempt < this.maxAttempts;\r\n    }\r\n\r\n    /**\r\n     * Record a reconnection attempt\r\n     */\r\n    recordAttempt() {\r\n        this.attempt++;\r\n    }\r\n\r\n    /**\r\n     * Reset strategy (connection successful)\r\n     */\r\n    reset() {\r\n        this.attempt = 0;\r\n    }\r\n}\r\n\r\n/**\r\n * SSE Client\r\n *\r\n * Manages Server-Sent Events connection with auto-reconnect.\r\n */\r\nexport class SseClient {\r\n    /**\r\n     * @param {string[]} channels - Channels to subscribe to\r\n     * @param {object} options - Configuration options\r\n     */\r\n    constructor(channels = [], options = {}) {\r\n        this.channels = channels;\r\n        this.options = {\r\n            autoReconnect: true,\r\n            heartbeatTimeout: 45000, // 45s (server sends every 30s)\r\n            ...options\r\n        };\r\n\r\n        this.eventSource = null;\r\n        this.state = ConnectionState.DISCONNECTED;\r\n        this.reconnectionStrategy = new ReconnectionStrategy();\r\n        this.reconnectTimer = null;\r\n        this.heartbeatTimer = null;\r\n        this.lastHeartbeat = null;\r\n        this.eventHandlers = new Map(); // eventType => Set<handler>\r\n        this.stateChangeHandlers = new Set();\r\n        this.connectionId = null;\r\n    }\r\n\r\n    /**\r\n     * Connect to SSE stream\r\n     */\r\n    connect() {\r\n        if (this.state === ConnectionState.CONNECTING || this.state === ConnectionState.CONNECTED) {\r\n            console.warn('[SSE] Already connecting or connected');\r\n            return;\r\n        }\r\n\r\n        this.setState(ConnectionState.CONNECTING);\r\n\r\n        const url = this.buildUrl();\r\n\r\n        try {\r\n            this.eventSource = new EventSource(url);\r\n\r\n            // Connection opened\r\n            this.eventSource.addEventListener('open', () => {\r\n                console.log('[SSE] Connection opened');\r\n                this.setState(ConnectionState.CONNECTED);\r\n                this.reconnectionStrategy.reset();\r\n                this.startHeartbeatMonitoring();\r\n            });\r\n\r\n            // Connection error\r\n            this.eventSource.addEventListener('error', (e) => {\r\n                console.error('[SSE] Connection error', e);\r\n\r\n                if (this.eventSource.readyState === EventSource.CLOSED) {\r\n                    this.handleDisconnect();\r\n                }\r\n            });\r\n\r\n            // Initial connection confirmation\r\n            this.eventSource.addEventListener('connected', (e) => {\r\n                const data = JSON.parse(e.data);\r\n                this.connectionId = data.connection_id;\r\n                console.log('[SSE] Connected with ID:', this.connectionId);\r\n            });\r\n\r\n            // Heartbeat event\r\n            this.eventSource.addEventListener('heartbeat', (e) => {\r\n                this.lastHeartbeat = Date.now();\r\n            });\r\n\r\n            // Disconnected event\r\n            this.eventSource.addEventListener('disconnected', () => {\r\n                console.log('[SSE] Server initiated disconnect');\r\n                this.disconnect();\r\n            });\r\n\r\n            // Error events\r\n            this.eventSource.addEventListener('error', (e) => {\r\n                const data = JSON.parse(e.data);\r\n                console.error('[SSE] Server error:', data);\r\n            });\r\n\r\n        } catch (error) {\r\n            console.error('[SSE] Failed to create EventSource', error);\r\n            this.setState(ConnectionState.ERROR);\r\n            this.scheduleReconnect();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Disconnect from SSE stream\r\n     */\r\n    disconnect() {\r\n        if (this.eventSource) {\r\n            this.eventSource.close();\r\n            this.eventSource = null;\r\n        }\r\n\r\n        this.stopHeartbeatMonitoring();\r\n        this.clearReconnectTimer();\r\n        this.setState(ConnectionState.DISCONNECTED);\r\n        this.connectionId = null;\r\n    }\r\n\r\n    /**\r\n     * Handle disconnection\r\n     */\r\n    handleDisconnect() {\r\n        this.setState(ConnectionState.ERROR);\r\n        this.stopHeartbeatMonitoring();\r\n\r\n        if (this.options.autoReconnect && this.reconnectionStrategy.shouldRetry()) {\r\n            this.scheduleReconnect();\r\n        } else {\r\n            this.setState(ConnectionState.DISCONNECTED);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Schedule reconnection attempt\r\n     */\r\n    scheduleReconnect() {\r\n        const delay = this.reconnectionStrategy.getDelay();\r\n        console.log(`[SSE] Reconnecting in ${delay}ms (attempt ${this.reconnectionStrategy.attempt + 1})`);\r\n\r\n        this.reconnectTimer = setTimeout(() => {\r\n            this.reconnectionStrategy.recordAttempt();\r\n            this.connect();\r\n        }, delay);\r\n    }\r\n\r\n    /**\r\n     * Clear reconnect timer\r\n     */\r\n    clearReconnectTimer() {\r\n        if (this.reconnectTimer) {\r\n            clearTimeout(this.reconnectTimer);\r\n            this.reconnectTimer = null;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Start heartbeat monitoring\r\n     */\r\n    startHeartbeatMonitoring() {\r\n        this.lastHeartbeat = Date.now();\r\n\r\n        this.heartbeatTimer = setInterval(() => {\r\n            const timeSinceHeartbeat = Date.now() - this.lastHeartbeat;\r\n\r\n            if (timeSinceHeartbeat > this.options.heartbeatTimeout) {\r\n                console.warn('[SSE] Heartbeat timeout - connection appears dead');\r\n                this.handleDisconnect();\r\n            }\r\n        }, 5000); // Check every 5s\r\n    }\r\n\r\n    /**\r\n     * Stop heartbeat monitoring\r\n     */\r\n    stopHeartbeatMonitoring() {\r\n        if (this.heartbeatTimer) {\r\n            clearInterval(this.heartbeatTimer);\r\n            this.heartbeatTimer = null;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Build SSE stream URL with channels\r\n     */\r\n    buildUrl() {\r\n        const baseUrl = '/sse/stream';\r\n        const channelParam = this.channels.join(',');\r\n\r\n        return `${baseUrl}?channels=${encodeURIComponent(channelParam)}`;\r\n    }\r\n\r\n    /**\r\n     * Register event handler\r\n     *\r\n     * @param {string} eventType - Event type to listen for\r\n     * @param {function} handler - Event handler function\r\n     */\r\n    on(eventType, handler) {\r\n        if (!this.eventHandlers.has(eventType)) {\r\n            this.eventHandlers.set(eventType, new Set());\r\n\r\n            // Register EventSource listener\r\n            if (this.eventSource) {\r\n                this.eventSource.addEventListener(eventType, (e) => {\r\n                    this.handleEvent(eventType, e);\r\n                });\r\n            }\r\n        }\r\n\r\n        this.eventHandlers.get(eventType).add(handler);\r\n\r\n        return () => this.off(eventType, handler);\r\n    }\r\n\r\n    /**\r\n     * Unregister event handler\r\n     */\r\n    off(eventType, handler) {\r\n        const handlers = this.eventHandlers.get(eventType);\r\n        if (handlers) {\r\n            handlers.delete(handler);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle incoming event\r\n     */\r\n    handleEvent(eventType, event) {\r\n        const handlers = this.eventHandlers.get(eventType);\r\n        if (!handlers || handlers.size === 0) return;\r\n\r\n        let data;\r\n        try {\r\n            data = JSON.parse(event.data);\r\n        } catch (e) {\r\n            console.error('[SSE] Failed to parse event data', e);\r\n            return;\r\n        }\r\n\r\n        handlers.forEach(handler => {\r\n            try {\r\n                handler(data, event);\r\n            } catch (e) {\r\n                console.error('[SSE] Event handler error', e);\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Set connection state\r\n     */\r\n    setState(newState) {\r\n        const oldState = this.state;\r\n        this.state = newState;\r\n\r\n        if (oldState !== newState) {\r\n            this.stateChangeHandlers.forEach(handler => {\r\n                try {\r\n                    handler(newState, oldState);\r\n                } catch (e) {\r\n                    console.error('[SSE] State change handler error', e);\r\n                }\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Register state change handler\r\n     */\r\n    onStateChange(handler) {\r\n        this.stateChangeHandlers.add(handler);\r\n        return () => this.stateChangeHandlers.delete(handler);\r\n    }\r\n\r\n    /**\r\n     * Get current connection state\r\n     */\r\n    getState() {\r\n        return this.state;\r\n    }\r\n\r\n    /**\r\n     * Check if connected\r\n     */\r\n    isConnected() {\r\n        return this.state === ConnectionState.CONNECTED;\r\n    }\r\n\r\n    /**\r\n     * Get connection ID\r\n     */\r\n    getConnectionId() {\r\n        return this.connectionId;\r\n    }\r\n\r\n    /**\r\n     * Subscribe to additional channels (requires reconnect)\r\n     */\r\n    addChannels(...newChannels) {\r\n        const added = newChannels.filter(ch => !this.channels.includes(ch));\r\n        if (added.length > 0) {\r\n            this.channels.push(...added);\r\n            if (this.isConnected()) {\r\n                console.log('[SSE] Reconnecting with new channels:', added);\r\n                this.disconnect();\r\n                this.connect();\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Unsubscribe from channels (requires reconnect)\r\n     */\r\n    removeChannels(...channelsToRemove) {\r\n        const before = this.channels.length;\r\n        this.channels = this.channels.filter(ch => !channelsToRemove.includes(ch));\r\n\r\n        if (this.channels.length !== before && this.isConnected()) {\r\n            console.log('[SSE] Reconnecting with removed channels');\r\n            this.disconnect();\r\n            this.connect();\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Global SSE client instance\r\n */\r\nlet globalSseClient = null;\r\n\r\n/**\r\n * Get or create global SSE client\r\n */\r\nexport function getGlobalSseClient(channels = []) {\r\n    if (!globalSseClient) {\r\n        globalSseClient = new SseClient(channels);\r\n    }\r\n    return globalSseClient;\r\n}\r\n\r\n/**\r\n * Initialize global SSE client and connect\r\n */\r\nexport function initSse(channels = [], autoConnect = true) {\r\n    globalSseClient = new SseClient(channels);\r\n\r\n    if (autoConnect) {\r\n        globalSseClient.connect();\r\n    }\r\n\r\n    return globalSseClient;\r\n}\r\n\r\nexport default {\r\n    SseClient,\r\n    getGlobalSseClient,\r\n    initSse,\r\n    ConnectionState\r\n};\r\n","/**\r\n * Lazy Component Loader\r\n *\r\n * Loads LiveComponents only when they enter the viewport using Intersection Observer API.\r\n * Provides performance optimization for pages with many components.\r\n *\r\n * Features:\r\n * - Viewport-based loading with configurable thresholds\r\n * - Placeholder management during loading\r\n * - Progressive loading with priorities\r\n * - Memory-efficient intersection tracking\r\n * - Automatic cleanup and disconnection\r\n *\r\n * Usage:\r\n * <div data-live-component-lazy=\"notification-center:user-123\"\r\n *      data-lazy-threshold=\"0.1\"\r\n *      data-lazy-priority=\"high\"\r\n *      data-lazy-placeholder=\"Loading notifications...\">\r\n * </div>\r\n */\r\n\r\nexport class LazyComponentLoader {\r\n    constructor(liveComponentManager) {\r\n        this.liveComponentManager = liveComponentManager;\r\n        this.observer = null;\r\n        this.lazyComponents = new Map(); // element → config\r\n        this.loadingQueue = []; // Priority-based loading queue\r\n        this.isProcessingQueue = false;\r\n\r\n        this.defaultOptions = {\r\n            rootMargin: '50px', // Load 50px before entering viewport\r\n            threshold: 0.1 // Trigger when 10% visible\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Initialize lazy loading system\r\n     */\r\n    init() {\r\n        // Create Intersection Observer\r\n        this.observer = new IntersectionObserver(\r\n            (entries) => this.handleIntersection(entries),\r\n            this.defaultOptions\r\n        );\r\n\r\n        // Scan for lazy components\r\n        this.scanLazyComponents();\r\n\r\n        console.log(`[LazyLoader] Initialized with ${this.lazyComponents.size} lazy components`);\r\n    }\r\n\r\n    /**\r\n     * Scan DOM for lazy components\r\n     */\r\n    scanLazyComponents() {\r\n        const lazyElements = document.querySelectorAll('[data-live-component-lazy]');\r\n\r\n        lazyElements.forEach(element => {\r\n            this.registerLazyComponent(element);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Register a lazy component for loading\r\n     *\r\n     * @param {HTMLElement} element - Component container\r\n     */\r\n    registerLazyComponent(element) {\r\n        const componentId = element.dataset.liveComponentLazy;\r\n        if (!componentId) {\r\n            console.warn('[LazyLoader] Lazy component missing componentId:', element);\r\n            return;\r\n        }\r\n\r\n        // Extract configuration\r\n        const config = {\r\n            element,\r\n            componentId,\r\n            threshold: parseFloat(element.dataset.lazyThreshold) || this.defaultOptions.threshold,\r\n            priority: element.dataset.lazyPriority || 'normal', // high, normal, low\r\n            placeholder: element.dataset.lazyPlaceholder || null,\r\n            loaded: false,\r\n            loading: false\r\n        };\r\n\r\n        // Show placeholder\r\n        if (config.placeholder) {\r\n            this.showPlaceholder(element, config.placeholder);\r\n        }\r\n\r\n        // Store config\r\n        this.lazyComponents.set(element, config);\r\n\r\n        // Start observing\r\n        this.observer.observe(element);\r\n\r\n        console.log(`[LazyLoader] Registered lazy component: ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Handle intersection observer callback\r\n     *\r\n     * @param {Array<IntersectionObserverEntry>} entries - Intersection entries\r\n     */\r\n    handleIntersection(entries) {\r\n        entries.forEach(entry => {\r\n            if (entry.isIntersecting) {\r\n                const config = this.lazyComponents.get(entry.target);\r\n                if (config && !config.loaded && !config.loading) {\r\n                    this.queueComponentLoad(config);\r\n                }\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Queue component for loading with priority\r\n     *\r\n     * @param {Object} config - Component config\r\n     */\r\n    queueComponentLoad(config) {\r\n        const priorityWeight = this.getPriorityWeight(config.priority);\r\n\r\n        this.loadingQueue.push({\r\n            config,\r\n            priority: priorityWeight,\r\n            timestamp: Date.now()\r\n        });\r\n\r\n        // Sort by priority (high to low) and then by timestamp (early to late)\r\n        this.loadingQueue.sort((a, b) => {\r\n            if (b.priority !== a.priority) {\r\n                return b.priority - a.priority;\r\n            }\r\n            return a.timestamp - b.timestamp;\r\n        });\r\n\r\n        console.log(`[LazyLoader] Queued: ${config.componentId} (priority: ${config.priority})`);\r\n\r\n        // Process queue\r\n        this.processLoadingQueue();\r\n    }\r\n\r\n    /**\r\n     * Get numeric weight for priority\r\n     *\r\n     * @param {string} priority - Priority level (high, normal, low)\r\n     * @returns {number} Priority weight\r\n     */\r\n    getPriorityWeight(priority) {\r\n        const weights = {\r\n            'high': 3,\r\n            'normal': 2,\r\n            'low': 1\r\n        };\r\n        return weights[priority] || 2;\r\n    }\r\n\r\n    /**\r\n     * Process loading queue\r\n     *\r\n     * Loads components sequentially to avoid overloading server.\r\n     */\r\n    async processLoadingQueue() {\r\n        if (this.isProcessingQueue || this.loadingQueue.length === 0) {\r\n            return;\r\n        }\r\n\r\n        this.isProcessingQueue = true;\r\n\r\n        while (this.loadingQueue.length > 0) {\r\n            const { config } = this.loadingQueue.shift();\r\n\r\n            if (!config.loaded && !config.loading) {\r\n                await this.loadComponent(config);\r\n            }\r\n        }\r\n\r\n        this.isProcessingQueue = false;\r\n    }\r\n\r\n    /**\r\n     * Load component from server\r\n     *\r\n     * @param {Object} config - Component config\r\n     */\r\n    async loadComponent(config) {\r\n        config.loading = true;\r\n\r\n        try {\r\n            console.log(`[LazyLoader] Loading: ${config.componentId}`);\r\n\r\n            // Show loading indicator\r\n            this.showLoadingIndicator(config.element);\r\n\r\n            // Request component HTML from server\r\n            const response = await fetch(`/live-component/${config.componentId}/lazy-load`, {\r\n                method: 'GET',\r\n                headers: {\r\n                    'X-Requested-With': 'XMLHttpRequest',\r\n                    'Accept': 'application/json'\r\n                }\r\n            });\r\n\r\n            if (!response.ok) {\r\n                throw new Error(`HTTP ${response.status}: ${response.statusText}`);\r\n            }\r\n\r\n            const data = await response.json();\r\n\r\n            if (!data.success) {\r\n                throw new Error(data.error || 'Failed to load component');\r\n            }\r\n\r\n            // Replace placeholder with component HTML\r\n            config.element.innerHTML = data.html;\r\n\r\n            // Mark element as regular LiveComponent (no longer lazy)\r\n            config.element.setAttribute('data-live-component', config.componentId);\r\n            config.element.removeAttribute('data-live-component-lazy');\r\n\r\n            // Copy CSRF token to element\r\n            if (data.csrf_token) {\r\n                config.element.dataset.csrfToken = data.csrf_token;\r\n            }\r\n\r\n            // Copy state to element\r\n            if (data.state) {\r\n                // Use StateSerializer for type-safe state handling\r\n                const stateJson = JSON.stringify(data.state);\r\n                config.element.dataset.state = stateJson;\r\n            }\r\n\r\n            // Initialize as regular LiveComponent\r\n            this.liveComponentManager.init(config.element);\r\n\r\n            // Mark as loaded\r\n            config.loaded = true;\r\n            config.loading = false;\r\n\r\n            // Stop observing\r\n            this.observer.unobserve(config.element);\r\n\r\n            console.log(`[LazyLoader] Loaded: ${config.componentId}`);\r\n\r\n            // Dispatch custom event\r\n            config.element.dispatchEvent(new CustomEvent('livecomponent:lazy:loaded', {\r\n                detail: { componentId: config.componentId }\r\n            }));\r\n\r\n        } catch (error) {\r\n            console.error(`[LazyLoader] Failed to load ${config.componentId}:`, error);\r\n\r\n            config.loading = false;\r\n\r\n            // Show error state\r\n            this.showError(config.element, error.message);\r\n\r\n            // Dispatch error event\r\n            config.element.dispatchEvent(new CustomEvent('livecomponent:lazy:error', {\r\n                detail: {\r\n                    componentId: config.componentId,\r\n                    error: error.message\r\n                }\r\n            }));\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Show placeholder\r\n     *\r\n     * @param {HTMLElement} element - Container element\r\n     * @param {string} text - Placeholder text\r\n     */\r\n    showPlaceholder(element, text) {\r\n        element.innerHTML = `\r\n            <div class=\"livecomponent-lazy-placeholder\" style=\"\r\n                padding: 2rem;\r\n                text-align: center;\r\n                color: #666;\r\n                background: #f5f5f5;\r\n                border-radius: 8px;\r\n                border: 1px dashed #ddd;\r\n            \">\r\n                <div style=\"font-size: 1.5rem; margin-bottom: 0.5rem;\">⏳</div>\r\n                <div>${text}</div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Show loading indicator\r\n     *\r\n     * @param {HTMLElement} element - Container element\r\n     */\r\n    showLoadingIndicator(element) {\r\n        element.innerHTML = `\r\n            <div class=\"livecomponent-lazy-loading\" style=\"\r\n                padding: 2rem;\r\n                text-align: center;\r\n                color: #2196F3;\r\n                background: #f5f5f5;\r\n                border-radius: 8px;\r\n                border: 1px solid #e3f2fd;\r\n            \">\r\n                <div class=\"spinner\" style=\"\r\n                    width: 40px;\r\n                    height: 40px;\r\n                    margin: 0 auto 1rem;\r\n                    border: 4px solid #e3f2fd;\r\n                    border-top: 4px solid #2196F3;\r\n                    border-radius: 50%;\r\n                    animation: spin 1s linear infinite;\r\n                \"></div>\r\n                <div>Loading component...</div>\r\n            </div>\r\n            <style>\r\n                @keyframes spin {\r\n                    0% { transform: rotate(0deg); }\r\n                    100% { transform: rotate(360deg); }\r\n                }\r\n            </style>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Show error state\r\n     *\r\n     * @param {HTMLElement} element - Container element\r\n     * @param {string} errorMessage - Error message\r\n     */\r\n    showError(element, errorMessage) {\r\n        element.innerHTML = `\r\n            <div class=\"livecomponent-lazy-error\" style=\"\r\n                padding: 2rem;\r\n                text-align: center;\r\n                color: #d32f2f;\r\n                background: #ffebee;\r\n                border-radius: 8px;\r\n                border: 1px solid #ef9a9a;\r\n            \">\r\n                <div style=\"font-size: 1.5rem; margin-bottom: 0.5rem;\">❌</div>\r\n                <div><strong>Failed to load component</strong></div>\r\n                <div style=\"margin-top: 0.5rem; font-size: 0.9rem; color: #c62828;\">\r\n                    ${errorMessage}\r\n                </div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Unregister lazy component and stop observing\r\n     *\r\n     * @param {HTMLElement} element - Component element\r\n     */\r\n    unregister(element) {\r\n        const config = this.lazyComponents.get(element);\r\n        if (!config) return;\r\n\r\n        // Stop observing\r\n        this.observer.unobserve(element);\r\n\r\n        // Remove from registry\r\n        this.lazyComponents.delete(element);\r\n\r\n        console.log(`[LazyLoader] Unregistered: ${config.componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Destroy lazy loader\r\n     *\r\n     * Clean up all observers and references.\r\n     */\r\n    destroy() {\r\n        // Disconnect observer\r\n        if (this.observer) {\r\n            this.observer.disconnect();\r\n            this.observer = null;\r\n        }\r\n\r\n        // Clear queue\r\n        this.loadingQueue = [];\r\n\r\n        // Clear registry\r\n        this.lazyComponents.clear();\r\n\r\n        console.log('[LazyLoader] Destroyed');\r\n    }\r\n\r\n    /**\r\n     * Get lazy loading statistics\r\n     *\r\n     * @returns {Object} Statistics\r\n     */\r\n    getStats() {\r\n        let loaded = 0;\r\n        let loading = 0;\r\n        let pending = 0;\r\n\r\n        this.lazyComponents.forEach(config => {\r\n            if (config.loaded) loaded++;\r\n            else if (config.loading) loading++;\r\n            else pending++;\r\n        });\r\n\r\n        return {\r\n            total: this.lazyComponents.size,\r\n            loaded,\r\n            loading,\r\n            pending,\r\n            queued: this.loadingQueue.length\r\n        };\r\n    }\r\n}\r\n\r\n// Export for use in LiveComponent module\r\nexport default LazyComponentLoader;\r\n","/**\r\n * Nested Component Handler\r\n *\r\n * Manages parent-child relationships for nested LiveComponents on the client-side.\r\n * Coordinates event bubbling, state synchronization, and lifecycle management.\r\n *\r\n * Features:\r\n * - Parent-child relationship tracking\r\n * - Event bubbling from child to parent\r\n * - Child lifecycle coordination\r\n * - State synchronization between parent and children\r\n * - Automatic cleanup on component destruction\r\n *\r\n * Architecture:\r\n * - Scans DOM for nested components (data-parent-component attribute)\r\n * - Registers hierarchies with LiveComponentManager\r\n * - Intercepts events to enable bubbling\r\n * - Coordinates updates between parents and children\r\n */\r\n\r\nexport class NestedComponentHandler {\r\n    constructor(liveComponentManager) {\r\n        this.liveComponentManager = liveComponentManager;\r\n\r\n        // Registry: componentId → { parentId, childIds, depth }\r\n        this.hierarchyRegistry = new Map();\r\n\r\n        // Parent → [Children] mapping\r\n        this.childrenRegistry = new Map();\r\n\r\n        // Event bubbling callbacks: componentId → [callbacks]\r\n        this.bubbleCallbacks = new Map();\r\n    }\r\n\r\n    /**\r\n     * Initialize nested component system\r\n     * Scans DOM for nested components and registers hierarchies\r\n     */\r\n    init() {\r\n        this.scanNestedComponents();\r\n        console.log(`[NestedComponents] Initialized with ${this.hierarchyRegistry.size} components`);\r\n    }\r\n\r\n    /**\r\n     * Scan DOM for nested components\r\n     * Looks for data-parent-component attribute to establish parent-child relationships\r\n     */\r\n    scanNestedComponents() {\r\n        // Find all components with parent\r\n        const nestedComponents = document.querySelectorAll('[data-parent-component]');\r\n\r\n        nestedComponents.forEach(element => {\r\n            const componentId = element.dataset.liveComponent;\r\n            const parentId = element.dataset.parentComponent;\r\n            const depth = parseInt(element.dataset.nestingDepth) || 1;\r\n\r\n            if (componentId && parentId) {\r\n                this.registerHierarchy(componentId, parentId, depth);\r\n            }\r\n        });\r\n\r\n        // Register root components (no parent)\r\n        const rootComponents = document.querySelectorAll('[data-live-component]:not([data-parent-component])');\r\n\r\n        rootComponents.forEach(element => {\r\n            const componentId = element.dataset.liveComponent;\r\n            if (componentId && !this.hierarchyRegistry.has(componentId)) {\r\n                this.registerRoot(componentId);\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Register root component (no parent)\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     */\r\n    registerRoot(componentId) {\r\n        this.hierarchyRegistry.set(componentId, {\r\n            parentId: null,\r\n            childIds: [],\r\n            depth: 0,\r\n            path: [componentId]\r\n        });\r\n\r\n        console.log(`[NestedComponents] Registered root: ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Register component hierarchy\r\n     *\r\n     * @param {string} componentId - Child component ID\r\n     * @param {string} parentId - Parent component ID\r\n     * @param {number} depth - Nesting depth\r\n     */\r\n    registerHierarchy(componentId, parentId, depth = 1) {\r\n        // Get parent's path\r\n        const parentHierarchy = this.hierarchyRegistry.get(parentId);\r\n        const parentPath = parentHierarchy ? parentHierarchy.path : [parentId];\r\n\r\n        // Create hierarchy entry\r\n        this.hierarchyRegistry.set(componentId, {\r\n            parentId,\r\n            childIds: [],\r\n            depth,\r\n            path: [...parentPath, componentId]\r\n        });\r\n\r\n        // Add to parent's children\r\n        if (!this.childrenRegistry.has(parentId)) {\r\n            this.childrenRegistry.set(parentId, []);\r\n        }\r\n\r\n        const children = this.childrenRegistry.get(parentId);\r\n        if (!children.includes(componentId)) {\r\n            children.push(componentId);\r\n        }\r\n\r\n        console.log(`[NestedComponents] Registered child: ${componentId} (parent: ${parentId}, depth: ${depth})`);\r\n    }\r\n\r\n    /**\r\n     * Register dynamic nested component at runtime\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @param {string} parentId - Parent component ID\r\n     */\r\n    registerDynamicChild(componentId, parentId) {\r\n        const parentHierarchy = this.hierarchyRegistry.get(parentId);\r\n        if (!parentHierarchy) {\r\n            console.warn(`[NestedComponents] Cannot register child - parent not found: ${parentId}`);\r\n            return;\r\n        }\r\n\r\n        const depth = parentHierarchy.depth + 1;\r\n        this.registerHierarchy(componentId, parentId, depth);\r\n    }\r\n\r\n    /**\r\n     * Get component hierarchy\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {Object|null} Hierarchy object or null\r\n     */\r\n    getHierarchy(componentId) {\r\n        return this.hierarchyRegistry.get(componentId) || null;\r\n    }\r\n\r\n    /**\r\n     * Get parent component ID\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {string|null} Parent ID or null if root\r\n     */\r\n    getParentId(componentId) {\r\n        const hierarchy = this.getHierarchy(componentId);\r\n        return hierarchy ? hierarchy.parentId : null;\r\n    }\r\n\r\n    /**\r\n     * Get child component IDs\r\n     *\r\n     * @param {string} componentId - Parent component ID\r\n     * @returns {Array<string>} Array of child IDs\r\n     */\r\n    getChildIds(componentId) {\r\n        return this.childrenRegistry.get(componentId) || [];\r\n    }\r\n\r\n    /**\r\n     * Check if component has children\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {boolean} True if has children\r\n     */\r\n    hasChildren(componentId) {\r\n        const children = this.getChildIds(componentId);\r\n        return children.length > 0;\r\n    }\r\n\r\n    /**\r\n     * Check if component is root\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {boolean} True if root component\r\n     */\r\n    isRoot(componentId) {\r\n        const hierarchy = this.getHierarchy(componentId);\r\n        return hierarchy ? hierarchy.parentId === null : true;\r\n    }\r\n\r\n    /**\r\n     * Get nesting depth\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {number} Nesting depth (0 for root)\r\n     */\r\n    getDepth(componentId) {\r\n        const hierarchy = this.getHierarchy(componentId);\r\n        return hierarchy ? hierarchy.depth : 0;\r\n    }\r\n\r\n    /**\r\n     * Get all ancestors (parent, grandparent, etc.)\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @returns {Array<string>} Array of ancestor IDs (parent first, root last)\r\n     */\r\n    getAncestors(componentId) {\r\n        const hierarchy = this.getHierarchy(componentId);\r\n        if (!hierarchy || !hierarchy.path) {\r\n            return [];\r\n        }\r\n\r\n        // Path includes current component, remove it\r\n        const ancestors = [...hierarchy.path];\r\n        ancestors.pop();\r\n\r\n        // Return in reverse order (parent first, root last)\r\n        return ancestors.reverse();\r\n    }\r\n\r\n    /**\r\n     * Bubble event up through component hierarchy\r\n     *\r\n     * Dispatches custom event to each ancestor until stopped or root reached.\r\n     *\r\n     * @param {string} sourceId - Component that dispatched the event\r\n     * @param {string} eventName - Event name\r\n     * @param {Object} payload - Event payload\r\n     * @returns {boolean} True if bubbled to root, false if stopped\r\n     */\r\n    bubbleEvent(sourceId, eventName, payload) {\r\n        console.log(`[NestedComponents] Bubbling event: ${eventName} from ${sourceId}`, payload);\r\n\r\n        let currentId = sourceId;\r\n        let bubbled = 0;\r\n\r\n        while (true) {\r\n            const parentId = this.getParentId(currentId);\r\n\r\n            // Reached root\r\n            if (parentId === null) {\r\n                console.log(`[NestedComponents] Event bubbled to root (${bubbled} levels)`);\r\n                return true;\r\n            }\r\n\r\n            // Get parent element\r\n            const parentElement = document.querySelector(`[data-live-component=\"${parentId}\"]`);\r\n            if (!parentElement) {\r\n                console.warn(`[NestedComponents] Parent element not found: ${parentId}`);\r\n                return false;\r\n            }\r\n\r\n            // Dispatch custom event to parent\r\n            const bubbleEvent = new CustomEvent(`livecomponent:child:${eventName}`, {\r\n                detail: {\r\n                    sourceId,\r\n                    eventName,\r\n                    payload,\r\n                    currentLevel: bubbled\r\n                },\r\n                bubbles: false, // We handle bubbling manually\r\n                cancelable: true\r\n            });\r\n\r\n            const dispatched = parentElement.dispatchEvent(bubbleEvent);\r\n\r\n            // Event was cancelled - stop bubbling\r\n            if (!dispatched) {\r\n                console.log(`[NestedComponents] Event bubbling stopped at ${parentId}`);\r\n                return false;\r\n            }\r\n\r\n            // Check for registered callbacks\r\n            const callbacks = this.bubbleCallbacks.get(parentId);\r\n            if (callbacks) {\r\n                for (const callback of callbacks) {\r\n                    const shouldContinue = callback(sourceId, eventName, payload);\r\n                    if (shouldContinue === false) {\r\n                        console.log(`[NestedComponents] Event bubbling stopped by callback at ${parentId}`);\r\n                        return false;\r\n                    }\r\n                }\r\n            }\r\n\r\n            // Move to next level\r\n            currentId = parentId;\r\n            bubbled++;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Register callback for child events\r\n     *\r\n     * @param {string} parentId - Parent component ID\r\n     * @param {Function} callback - Callback function (sourceId, eventName, payload) => boolean\r\n     */\r\n    onChildEvent(parentId, callback) {\r\n        if (!this.bubbleCallbacks.has(parentId)) {\r\n            this.bubbleCallbacks.set(parentId, []);\r\n        }\r\n\r\n        this.bubbleCallbacks.get(parentId).push(callback);\r\n\r\n        console.log(`[NestedComponents] Registered child event callback for ${parentId}`);\r\n    }\r\n\r\n    /**\r\n     * Sync state from parent to children\r\n     *\r\n     * Useful for broadcasting shared state to all children.\r\n     *\r\n     * @param {string} parentId - Parent component ID\r\n     * @param {Object} sharedState - State to share with children\r\n     */\r\n    syncStateToChildren(parentId, sharedState) {\r\n        const childIds = this.getChildIds(parentId);\r\n\r\n        console.log(`[NestedComponents] Syncing state to ${childIds.length} children of ${parentId}`);\r\n\r\n        childIds.forEach(childId => {\r\n            const childElement = document.querySelector(`[data-live-component=\"${childId}\"]`);\r\n            if (!childElement) return;\r\n\r\n            // Dispatch state sync event\r\n            childElement.dispatchEvent(new CustomEvent('livecomponent:parent:state-sync', {\r\n                detail: { parentId, sharedState }\r\n            }));\r\n\r\n            // Update child state if applicable\r\n            // Child components can listen to this event and update accordingly\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Update all children when parent changes\r\n     *\r\n     * @param {string} parentId - Parent component ID\r\n     * @param {Object} updates - Updates to apply to children\r\n     */\r\n    async updateChildren(parentId, updates) {\r\n        const childIds = this.getChildIds(parentId);\r\n\r\n        console.log(`[NestedComponents] Updating ${childIds.length} children of ${parentId}`);\r\n\r\n        // Update children in parallel for performance\r\n        const updatePromises = childIds.map(async childId => {\r\n            const childElement = document.querySelector(`[data-live-component=\"${childId}\"]`);\r\n            if (!childElement) return;\r\n\r\n            // Trigger child component update via LiveComponent action\r\n            // This depends on how your components handle updates\r\n            // For now, just dispatch an event\r\n            childElement.dispatchEvent(new CustomEvent('livecomponent:parent:update', {\r\n                detail: { parentId, updates }\r\n            }));\r\n        });\r\n\r\n        await Promise.all(updatePromises);\r\n    }\r\n\r\n    /**\r\n     * Unregister component and cleanup\r\n     *\r\n     * @param {string} componentId - Component to unregister\r\n     */\r\n    unregister(componentId) {\r\n        // Remove from hierarchy registry\r\n        const hierarchy = this.hierarchyRegistry.get(componentId);\r\n        this.hierarchyRegistry.delete(componentId);\r\n\r\n        // Remove from parent's children\r\n        if (hierarchy && hierarchy.parentId) {\r\n            const siblings = this.childrenRegistry.get(hierarchy.parentId);\r\n            if (siblings) {\r\n                const index = siblings.indexOf(componentId);\r\n                if (index !== -1) {\r\n                    siblings.splice(index, 1);\r\n                }\r\n            }\r\n        }\r\n\r\n        // Remove children registry\r\n        this.childrenRegistry.delete(componentId);\r\n\r\n        // Remove bubble callbacks\r\n        this.bubbleCallbacks.delete(componentId);\r\n\r\n        console.log(`[NestedComponents] Unregistered: ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Get hierarchy statistics\r\n     *\r\n     * @returns {Object} Statistics\r\n     */\r\n    getStats() {\r\n        let rootCount = 0;\r\n        let maxDepth = 0;\r\n\r\n        this.hierarchyRegistry.forEach(hierarchy => {\r\n            if (hierarchy.parentId === null) {\r\n                rootCount++;\r\n            }\r\n            maxDepth = Math.max(maxDepth, hierarchy.depth);\r\n        });\r\n\r\n        return {\r\n            total_components: this.hierarchyRegistry.size,\r\n            root_components: rootCount,\r\n            child_components: this.hierarchyRegistry.size - rootCount,\r\n            max_nesting_depth: maxDepth,\r\n            parents_with_children: this.childrenRegistry.size\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Destroy nested component handler\r\n     */\r\n    destroy() {\r\n        this.hierarchyRegistry.clear();\r\n        this.childrenRegistry.clear();\r\n        this.bubbleCallbacks.clear();\r\n        console.log('[NestedComponents] Destroyed');\r\n    }\r\n}\r\n\r\nexport default NestedComponentHandler;\r\n","/**\r\n * ComponentFileUploader - File Upload Module for LiveComponents\r\n *\r\n * Features:\r\n * - Drag & Drop support\r\n * - Multi-file uploads with queue management\r\n * - Progress tracking (per-file and overall)\r\n * - Image/document previews\r\n * - Client-side validation\r\n * - CSRF protection\r\n * - Integration with LiveComponent state management\r\n *\r\n * @package Framework\\LiveComponents\r\n */\r\n\r\n/**\r\n * File Upload Progress Tracker\r\n */\r\nexport class UploadProgress {\r\n    constructor(file, fileId) {\r\n        this.file = file;\r\n        this.fileId = fileId;\r\n        this.uploadedBytes = 0;\r\n        this.totalBytes = file.size;\r\n        this.status = 'pending'; // pending, uploading, processing, complete, error\r\n        this.error = null;\r\n        this.xhr = null;\r\n        this.startTime = null;\r\n        this.endTime = null;\r\n    }\r\n\r\n    get percentage() {\r\n        if (this.totalBytes === 0) return 100;\r\n        return Math.round((this.uploadedBytes / this.totalBytes) * 100);\r\n    }\r\n\r\n    get isComplete() {\r\n        return this.status === 'complete';\r\n    }\r\n\r\n    get hasError() {\r\n        return this.status === 'error';\r\n    }\r\n\r\n    get isUploading() {\r\n        return this.status === 'uploading';\r\n    }\r\n\r\n    get uploadSpeed() {\r\n        if (!this.startTime || !this.isUploading) return 0;\r\n        const elapsed = (Date.now() - this.startTime) / 1000; // seconds\r\n        return elapsed > 0 ? this.uploadedBytes / elapsed : 0; // bytes per second\r\n    }\r\n\r\n    get remainingTime() {\r\n        const speed = this.uploadSpeed;\r\n        if (speed === 0) return 0;\r\n        const remaining = this.totalBytes - this.uploadedBytes;\r\n        return remaining / speed; // seconds\r\n    }\r\n\r\n    updateProgress(loaded, total) {\r\n        this.uploadedBytes = loaded;\r\n        this.totalBytes = total;\r\n    }\r\n\r\n    setStatus(status, error = null) {\r\n        this.status = status;\r\n        this.error = error;\r\n\r\n        if (status === 'uploading' && !this.startTime) {\r\n            this.startTime = Date.now();\r\n        }\r\n\r\n        if (status === 'complete' || status === 'error') {\r\n            this.endTime = Date.now();\r\n        }\r\n    }\r\n\r\n    abort() {\r\n        if (this.xhr) {\r\n            this.xhr.abort();\r\n            this.setStatus('error', 'Upload cancelled');\r\n        }\r\n    }\r\n\r\n    toObject() {\r\n        return {\r\n            fileId: this.fileId,\r\n            fileName: this.file.name,\r\n            fileSize: this.totalBytes,\r\n            uploadedBytes: this.uploadedBytes,\r\n            percentage: this.percentage,\r\n            status: this.status,\r\n            error: this.error,\r\n            uploadSpeed: this.uploadSpeed,\r\n            remainingTime: this.remainingTime\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * File Validator - Client-side validation\r\n */\r\nexport class FileValidator {\r\n    constructor(options = {}) {\r\n        this.maxFileSize = options.maxFileSize || 10 * 1024 * 1024; // 10MB default\r\n        this.allowedMimeTypes = options.allowedMimeTypes || [];\r\n        this.allowedExtensions = options.allowedExtensions || [];\r\n        this.minFileSize = options.minFileSize || 1; // 1 byte minimum\r\n    }\r\n\r\n    validate(file) {\r\n        const errors = [];\r\n\r\n        // File size validation\r\n        if (file.size > this.maxFileSize) {\r\n            errors.push(`File size (${this.formatBytes(file.size)}) exceeds maximum allowed size (${this.formatBytes(this.maxFileSize)})`);\r\n        }\r\n\r\n        if (file.size < this.minFileSize) {\r\n            errors.push(`File size is too small (minimum: ${this.formatBytes(this.minFileSize)})`);\r\n        }\r\n\r\n        // MIME type validation\r\n        if (this.allowedMimeTypes.length > 0 && !this.allowedMimeTypes.includes(file.type)) {\r\n            errors.push(`File type \"${file.type}\" is not allowed. Allowed types: ${this.allowedMimeTypes.join(', ')}`);\r\n        }\r\n\r\n        // Extension validation\r\n        if (this.allowedExtensions.length > 0) {\r\n            const extension = file.name.split('.').pop().toLowerCase();\r\n            if (!this.allowedExtensions.includes(extension)) {\r\n                errors.push(`File extension \".${extension}\" is not allowed. Allowed extensions: ${this.allowedExtensions.join(', ')}`);\r\n            }\r\n        }\r\n\r\n        // File name validation\r\n        if (file.name.length > 255) {\r\n            errors.push('File name is too long (maximum 255 characters)');\r\n        }\r\n\r\n        return errors;\r\n    }\r\n\r\n    isValid(file) {\r\n        return this.validate(file).length === 0;\r\n    }\r\n\r\n    formatBytes(bytes) {\r\n        if (bytes === 0) return '0 B';\r\n        const k = 1024;\r\n        const sizes = ['B', 'KB', 'MB', 'GB'];\r\n        const i = Math.floor(Math.log(bytes) / Math.log(k));\r\n        return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];\r\n    }\r\n}\r\n\r\n/**\r\n * Drag & Drop Zone Manager\r\n */\r\nexport class DragDropZone {\r\n    constructor(element, callbacks = {}) {\r\n        this.element = element;\r\n        this.onFilesDropped = callbacks.onFilesDropped || (() => {});\r\n        this.onDragEnter = callbacks.onDragEnter || (() => {});\r\n        this.onDragLeave = callbacks.onDragLeave || (() => {});\r\n\r\n        this.dragCounter = 0; // Track nested drag events\r\n        this.isActive = false;\r\n\r\n        this.bindEvents();\r\n    }\r\n\r\n    bindEvents() {\r\n        // Prevent default browser behavior for drag events\r\n        ['dragenter', 'dragover', 'dragleave', 'drop'].forEach(eventName => {\r\n            this.element.addEventListener(eventName, (e) => {\r\n                e.preventDefault();\r\n                e.stopPropagation();\r\n            });\r\n        });\r\n\r\n        // Handle drag enter\r\n        this.element.addEventListener('dragenter', (e) => {\r\n            this.dragCounter++;\r\n            if (this.dragCounter === 1) {\r\n                this.isActive = true;\r\n                this.element.classList.add('drag-over');\r\n                this.onDragEnter(e);\r\n            }\r\n        });\r\n\r\n        // Handle drag leave\r\n        this.element.addEventListener('dragleave', (e) => {\r\n            this.dragCounter--;\r\n            if (this.dragCounter === 0) {\r\n                this.isActive = false;\r\n                this.element.classList.remove('drag-over');\r\n                this.onDragLeave(e);\r\n            }\r\n        });\r\n\r\n        // Handle drag over\r\n        this.element.addEventListener('dragover', (e) => {\r\n            // Required to allow drop\r\n        });\r\n\r\n        // Handle drop\r\n        this.element.addEventListener('drop', (e) => {\r\n            this.dragCounter = 0;\r\n            this.isActive = false;\r\n            this.element.classList.remove('drag-over');\r\n\r\n            const files = Array.from(e.dataTransfer?.files || []);\r\n            if (files.length > 0) {\r\n                this.onFilesDropped(files);\r\n            }\r\n        });\r\n    }\r\n\r\n    destroy() {\r\n        this.element.classList.remove('drag-over');\r\n        // Event listeners are automatically removed when element is removed\r\n    }\r\n}\r\n\r\n/**\r\n * Main ComponentFileUploader Class\r\n */\r\nexport class ComponentFileUploader {\r\n    constructor(componentElement, options = {}) {\r\n        this.componentElement = componentElement;\r\n        this.componentId = componentElement.dataset.liveId;\r\n\r\n        // Options\r\n        this.maxFileSize = options.maxFileSize || 10 * 1024 * 1024; // 10MB\r\n        this.allowedMimeTypes = options.allowedMimeTypes || [];\r\n        this.allowedExtensions = options.allowedExtensions || [];\r\n        this.maxFiles = options.maxFiles || 10;\r\n        this.autoUpload = options.autoUpload !== false; // default: true\r\n        this.multiple = options.multiple !== false; // default: true\r\n        this.endpoint = options.endpoint || `/live-component/${this.componentId}/upload`;\r\n\r\n        // Callbacks\r\n        this.onFileAdded = options.onFileAdded || (() => {});\r\n        this.onFileRemoved = options.onFileRemoved || (() => {});\r\n        this.onUploadStart = options.onUploadStart || (() => {});\r\n        this.onUploadProgress = options.onUploadProgress || (() => {});\r\n        this.onUploadComplete = options.onUploadComplete || (() => {});\r\n        this.onUploadError = options.onUploadError || (() => {});\r\n        this.onAllUploadsComplete = options.onAllUploadsComplete || (() => {});\r\n\r\n        // State\r\n        this.files = new Map(); // Map<fileId, UploadProgress>\r\n        this.uploadQueue = [];\r\n        this.activeUploads = 0;\r\n        this.maxConcurrentUploads = options.maxConcurrentUploads || 2;\r\n\r\n        // Validator\r\n        this.validator = new FileValidator({\r\n            maxFileSize: this.maxFileSize,\r\n            allowedMimeTypes: this.allowedMimeTypes,\r\n            allowedExtensions: this.allowedExtensions\r\n        });\r\n\r\n        // UI Elements (optional)\r\n        this.dropZoneElement = options.dropZone;\r\n        this.fileInputElement = options.fileInput;\r\n\r\n        this.initialize();\r\n    }\r\n\r\n    initialize() {\r\n        // Setup drag & drop if dropZone provided\r\n        if (this.dropZoneElement) {\r\n            this.dragDropZone = new DragDropZone(this.dropZoneElement, {\r\n                onFilesDropped: (files) => this.addFiles(files),\r\n                onDragEnter: () => this.dropZoneElement.classList.add('drag-active'),\r\n                onDragLeave: () => this.dropZoneElement.classList.remove('drag-active')\r\n            });\r\n        }\r\n\r\n        // Setup file input if provided\r\n        if (this.fileInputElement) {\r\n            this.fileInputElement.addEventListener('change', (e) => {\r\n                const files = Array.from(e.target.files || []);\r\n                this.addFiles(files);\r\n                e.target.value = ''; // Reset input\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Add files to upload queue\r\n     */\r\n    addFiles(files) {\r\n        const filesToAdd = Array.isArray(files) ? files : [files];\r\n\r\n        // Check max files limit\r\n        if (this.files.size + filesToAdd.length > this.maxFiles) {\r\n            const error = `Cannot add files. Maximum ${this.maxFiles} files allowed.`;\r\n            this.onUploadError({ error, fileCount: filesToAdd.length });\r\n            return;\r\n        }\r\n\r\n        for (const file of filesToAdd) {\r\n            // Generate unique file ID\r\n            const fileId = this.generateFileId(file);\r\n\r\n            // Validate file\r\n            const validationErrors = this.validator.validate(file);\r\n\r\n            const progress = new UploadProgress(file, fileId);\r\n\r\n            if (validationErrors.length > 0) {\r\n                progress.setStatus('error', validationErrors.join(', '));\r\n                this.files.set(fileId, progress);\r\n                this.onUploadError({\r\n                    fileId,\r\n                    file,\r\n                    errors: validationErrors\r\n                });\r\n                continue;\r\n            }\r\n\r\n            // Add to files map\r\n            this.files.set(fileId, progress);\r\n            this.uploadQueue.push(fileId);\r\n\r\n            // Callback\r\n            this.onFileAdded({\r\n                fileId,\r\n                file,\r\n                progress: progress.toObject()\r\n            });\r\n        }\r\n\r\n        // Auto-upload if enabled\r\n        if (this.autoUpload) {\r\n            this.processQueue();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Remove file from queue\r\n     */\r\n    removeFile(fileId) {\r\n        const progress = this.files.get(fileId);\r\n        if (!progress) return;\r\n\r\n        // Abort if uploading\r\n        if (progress.isUploading) {\r\n            progress.abort();\r\n        }\r\n\r\n        // Remove from queue\r\n        const queueIndex = this.uploadQueue.indexOf(fileId);\r\n        if (queueIndex !== -1) {\r\n            this.uploadQueue.splice(queueIndex, 1);\r\n        }\r\n\r\n        // Remove from files map\r\n        this.files.delete(fileId);\r\n\r\n        // Callback\r\n        this.onFileRemoved({ fileId, file: progress.file });\r\n    }\r\n\r\n    /**\r\n     * Start uploading all queued files\r\n     */\r\n    uploadAll() {\r\n        this.processQueue();\r\n    }\r\n\r\n    /**\r\n     * Process upload queue\r\n     */\r\n    async processQueue() {\r\n        while (this.uploadQueue.length > 0 && this.activeUploads < this.maxConcurrentUploads) {\r\n            const fileId = this.uploadQueue.shift();\r\n            const progress = this.files.get(fileId);\r\n\r\n            if (!progress || progress.status !== 'pending') continue;\r\n\r\n            this.activeUploads++;\r\n            this.uploadFile(fileId).finally(() => {\r\n                this.activeUploads--;\r\n                this.processQueue(); // Process next file\r\n\r\n                // Check if all uploads are complete\r\n                if (this.activeUploads === 0 && this.uploadQueue.length === 0) {\r\n                    this.onAllUploadsComplete({\r\n                        totalFiles: this.files.size,\r\n                        successCount: Array.from(this.files.values()).filter(p => p.isComplete).length,\r\n                        errorCount: Array.from(this.files.values()).filter(p => p.hasError).length\r\n                    });\r\n                }\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Upload a single file\r\n     */\r\n    async uploadFile(fileId) {\r\n        const progress = this.files.get(fileId);\r\n        if (!progress) return;\r\n\r\n        try {\r\n            // Get current component state\r\n            const componentState = this.getComponentState();\r\n\r\n            // Get CSRF tokens\r\n            const csrfTokens = await this.getCsrfTokens();\r\n\r\n            // Create FormData\r\n            const formData = new FormData();\r\n            formData.append('file', progress.file);\r\n            formData.append('state', JSON.stringify(componentState));\r\n            formData.append('params', JSON.stringify({ fileId }));\r\n\r\n            // Create XHR request\r\n            const xhr = new XMLHttpRequest();\r\n            progress.xhr = xhr;\r\n\r\n            // Setup progress tracking\r\n            xhr.upload.addEventListener('progress', (e) => {\r\n                if (e.lengthComputable) {\r\n                    progress.updateProgress(e.loaded, e.total);\r\n                    this.onUploadProgress({\r\n                        fileId,\r\n                        ...progress.toObject()\r\n                    });\r\n                }\r\n            });\r\n\r\n            // Setup completion handler\r\n            const uploadPromise = new Promise((resolve, reject) => {\r\n                xhr.addEventListener('load', () => {\r\n                    if (xhr.status >= 200 && xhr.status < 300) {\r\n                        try {\r\n                            const response = JSON.parse(xhr.responseText);\r\n                            if (response.success) {\r\n                                progress.setStatus('complete');\r\n\r\n                                // Update component state if provided\r\n                                if (response.state) {\r\n                                    this.updateComponentState(response.state);\r\n                                }\r\n\r\n                                // Update component HTML if provided\r\n                                if (response.html) {\r\n                                    this.updateComponentHtml(response.html);\r\n                                }\r\n\r\n                                this.onUploadComplete({\r\n                                    fileId,\r\n                                    file: progress.file,\r\n                                    response\r\n                                });\r\n\r\n                                resolve(response);\r\n                            } else {\r\n                                throw new Error(response.error || 'Upload failed');\r\n                            }\r\n                        } catch (e) {\r\n                            reject(e);\r\n                        }\r\n                    } else {\r\n                        reject(new Error(`Upload failed with status ${xhr.status}`));\r\n                    }\r\n                });\r\n\r\n                xhr.addEventListener('error', () => {\r\n                    reject(new Error('Network error during upload'));\r\n                });\r\n\r\n                xhr.addEventListener('abort', () => {\r\n                    reject(new Error('Upload cancelled'));\r\n                });\r\n            });\r\n\r\n            // Set status to uploading\r\n            progress.setStatus('uploading');\r\n            this.onUploadStart({ fileId, file: progress.file });\r\n\r\n            // Open and send request\r\n            xhr.open('POST', this.endpoint);\r\n\r\n            // Set CSRF headers\r\n            xhr.setRequestHeader('X-CSRF-Form-ID', csrfTokens.form_id);\r\n            xhr.setRequestHeader('X-CSRF-Token', csrfTokens.token);\r\n            xhr.setRequestHeader('Accept', 'application/json');\r\n            xhr.setRequestHeader('User-Agent', navigator.userAgent);\r\n\r\n            xhr.send(formData);\r\n\r\n            await uploadPromise;\r\n\r\n        } catch (error) {\r\n            progress.setStatus('error', error.message);\r\n            this.onUploadError({\r\n                fileId,\r\n                file: progress.file,\r\n                error: error.message\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Cancel all uploads\r\n     */\r\n    cancelAll() {\r\n        this.uploadQueue = [];\r\n        this.files.forEach(progress => {\r\n            if (progress.isUploading) {\r\n                progress.abort();\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Clear all files (completed and pending)\r\n     */\r\n    clearAll() {\r\n        this.cancelAll();\r\n        this.files.clear();\r\n    }\r\n\r\n    /**\r\n     * Get overall upload progress\r\n     */\r\n    getOverallProgress() {\r\n        if (this.files.size === 0) return 100;\r\n\r\n        const totalBytes = Array.from(this.files.values()).reduce((sum, p) => sum + p.totalBytes, 0);\r\n        const uploadedBytes = Array.from(this.files.values()).reduce((sum, p) => sum + p.uploadedBytes, 0);\r\n\r\n        return totalBytes > 0 ? Math.round((uploadedBytes / totalBytes) * 100) : 0;\r\n    }\r\n\r\n    /**\r\n     * Get upload statistics\r\n     */\r\n    getStats() {\r\n        const files = Array.from(this.files.values());\r\n        return {\r\n            total: files.length,\r\n            pending: files.filter(p => p.status === 'pending').length,\r\n            uploading: files.filter(p => p.status === 'uploading').length,\r\n            complete: files.filter(p => p.status === 'complete').length,\r\n            error: files.filter(p => p.status === 'error').length,\r\n            overallProgress: this.getOverallProgress()\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Helper: Generate unique file ID\r\n     */\r\n    generateFileId(file) {\r\n        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}-${file.name}`;\r\n    }\r\n\r\n    /**\r\n     * Helper: Get CSRF tokens\r\n     */\r\n    async getCsrfTokens() {\r\n        try {\r\n            const response = await fetch(`/api/csrf/token?action=${encodeURIComponent(this.endpoint)}&method=post`, {\r\n                headers: {\r\n                    'Accept': 'application/json',\r\n                    'User-Agent': navigator.userAgent\r\n                }\r\n            });\r\n\r\n            if (!response.ok) {\r\n                throw new Error(`CSRF token request failed: ${response.status}`);\r\n            }\r\n\r\n            return await response.json();\r\n        } catch (error) {\r\n            console.error('Failed to get CSRF tokens:', error);\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Helper: Get component state from DOM\r\n     */\r\n    getComponentState() {\r\n        const stateElement = this.componentElement.querySelector('[data-live-state]');\r\n        if (stateElement) {\r\n            try {\r\n                return JSON.parse(stateElement.textContent || '{}');\r\n            } catch (e) {\r\n                console.warn('Failed to parse component state:', e);\r\n            }\r\n        }\r\n        return {};\r\n    }\r\n\r\n    /**\r\n     * Helper: Update component state in DOM\r\n     */\r\n    updateComponentState(newState) {\r\n        const stateElement = this.componentElement.querySelector('[data-live-state]');\r\n        if (stateElement) {\r\n            stateElement.textContent = JSON.stringify(newState);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Helper: Update component HTML\r\n     */\r\n    updateComponentHtml(html) {\r\n        // Find the component content container (usually the component itself)\r\n        const contentElement = this.componentElement.querySelector('[data-live-content]') || this.componentElement;\r\n        if (contentElement) {\r\n            contentElement.innerHTML = html;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Cleanup\r\n     */\r\n    destroy() {\r\n        this.cancelAll();\r\n        this.clearAll();\r\n\r\n        if (this.dragDropZone) {\r\n            this.dragDropZone.destroy();\r\n        }\r\n    }\r\n}\r\n\r\nexport default ComponentFileUploader;\r\n","/**\r\n * Optimistic State Manager\r\n *\r\n * Manages optimistic UI updates with version-based conflict resolution.\r\n * Implements the \"Optimistic UI\" pattern where client immediately updates\r\n * the UI before server confirms, then rolls back on conflicts.\r\n *\r\n * Key Features:\r\n * - Immediate UI feedback (no loading spinners)\r\n * - Version-based optimistic concurrency control\r\n * - Automatic conflict detection and rollback\r\n * - Pending operations queue with retry\r\n * - User-friendly conflict resolution\r\n *\r\n * Protocol:\r\n * 1. Client updates UI immediately (optimistic)\r\n * 2. Client sends update to server with version\r\n * 3. Server checks version and either:\r\n *    a) Accepts: version matches, returns new state with version++\r\n *    b) Rejects: version conflict, returns current server state\r\n * 4. Client resolves:\r\n *    a) On accept: commit optimistic state\r\n *    b) On conflict: rollback to server state, show conflict UI\r\n */\r\n\r\nexport class OptimisticStateManager {\r\n    constructor() {\r\n        /**\r\n         * Pending operations queue\r\n         * Map<componentId, PendingOperation[]>\r\n         */\r\n        this.pendingOperations = new Map();\r\n\r\n        /**\r\n         * Rollback snapshots\r\n         * Map<componentId, StateSnapshot>\r\n         */\r\n        this.snapshots = new Map();\r\n\r\n        /**\r\n         * Conflict callbacks\r\n         * Map<componentId, ConflictCallback>\r\n         */\r\n        this.conflictHandlers = new Map();\r\n\r\n        /**\r\n         * Optimistic operation counter\r\n         */\r\n        this.operationIdCounter = 0;\r\n    }\r\n\r\n    /**\r\n     * Apply optimistic update\r\n     *\r\n     * Updates component state immediately without waiting for server confirmation.\r\n     * Creates snapshot for potential rollback.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Object} currentState - Current component state (with version)\r\n     * @param {Function} optimisticUpdate - Function that returns optimistically updated state\r\n     * @param {Object} metadata - Operation metadata (action, params)\r\n     * @returns {Object} Optimistic state with incremented version\r\n     */\r\n    applyOptimisticUpdate(componentId, currentState, optimisticUpdate, metadata = {}) {\r\n        // Create snapshot before applying optimistic update\r\n        if (!this.snapshots.has(componentId)) {\r\n            this.createSnapshot(componentId, currentState);\r\n        }\r\n\r\n        // Extract version from state\r\n        const currentVersion = currentState.version || 1;\r\n\r\n        // Apply optimistic update\r\n        const optimisticState = optimisticUpdate(currentState);\r\n\r\n        // Increment version optimistically\r\n        const newState = {\r\n            ...optimisticState,\r\n            version: currentVersion + 1\r\n        };\r\n\r\n        // Create pending operation\r\n        const operation = {\r\n            id: this.generateOperationId(),\r\n            componentId,\r\n            metadata,\r\n            expectedVersion: currentVersion,\r\n            optimisticState: newState,\r\n            timestamp: Date.now(),\r\n            status: 'pending' // pending, confirmed, failed\r\n        };\r\n\r\n        // Add to pending operations queue\r\n        this.addPendingOperation(componentId, operation);\r\n\r\n        console.log(`[OptimisticUI] Applied optimistic update for ${componentId}`, {\r\n            version: `${currentVersion} → ${currentVersion + 1}`,\r\n            operationId: operation.id,\r\n            pendingCount: this.getPendingOperationsCount(componentId)\r\n        });\r\n\r\n        return newState;\r\n    }\r\n\r\n    /**\r\n     * Confirm operation success\r\n     *\r\n     * Called when server successfully processes the operation.\r\n     * Commits the optimistic state and clears snapshot if no more pending operations.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {string} operationId - Operation ID to confirm\r\n     * @param {Object} serverState - Server-confirmed state (may differ from optimistic)\r\n     * @returns {Object} Final state (server state or optimistic if versions match)\r\n     */\r\n    confirmOperation(componentId, operationId, serverState) {\r\n        const operation = this.getPendingOperation(componentId, operationId);\r\n\r\n        if (!operation) {\r\n            console.warn(`[OptimisticUI] Cannot confirm unknown operation: ${operationId}`);\r\n            return serverState;\r\n        }\r\n\r\n        // Mark operation as confirmed\r\n        operation.status = 'confirmed';\r\n\r\n        // Remove from pending queue\r\n        this.removePendingOperation(componentId, operationId);\r\n\r\n        console.log(`[OptimisticUI] Confirmed operation ${operationId} for ${componentId}`, {\r\n            pendingCount: this.getPendingOperationsCount(componentId)\r\n        });\r\n\r\n        // If no more pending operations, clear snapshot\r\n        if (!this.hasPendingOperations(componentId)) {\r\n            this.clearSnapshot(componentId);\r\n        }\r\n\r\n        return serverState;\r\n    }\r\n\r\n    /**\r\n     * Handle version conflict\r\n     *\r\n     * Called when server rejects operation due to version mismatch.\r\n     * Rolls back to snapshot and applies server state.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {string} operationId - Failed operation ID\r\n     * @param {Object} serverState - Current server state\r\n     * @param {Object} conflict - Conflict information\r\n     * @returns {Object} Resolution result with rollback state and user notification\r\n     */\r\n    handleConflict(componentId, operationId, serverState, conflict = {}) {\r\n        const operation = this.getPendingOperation(componentId, operationId);\r\n\r\n        if (!operation) {\r\n            console.warn(`[OptimisticUI] Cannot handle conflict for unknown operation: ${operationId}`);\r\n            return { state: serverState, notification: null };\r\n        }\r\n\r\n        // Mark operation as failed\r\n        operation.status = 'failed';\r\n\r\n        // Get snapshot for rollback\r\n        const snapshot = this.snapshots.get(componentId);\r\n\r\n        console.warn(`[OptimisticUI] Version conflict detected for ${componentId}`, {\r\n            operationId,\r\n            expectedVersion: operation.expectedVersion,\r\n            serverVersion: serverState.version,\r\n            metadata: operation.metadata,\r\n            pendingOperationsCount: this.getPendingOperationsCount(componentId)\r\n        });\r\n\r\n        // Clear all pending operations (cascade rollback)\r\n        this.clearPendingOperations(componentId);\r\n\r\n        // Clear snapshot\r\n        this.clearSnapshot(componentId);\r\n\r\n        // Call conflict handler if registered\r\n        const conflictHandler = this.conflictHandlers.get(componentId);\r\n        if (conflictHandler) {\r\n            conflictHandler({\r\n                operation,\r\n                serverState,\r\n                snapshotState: snapshot?.state,\r\n                conflict\r\n            });\r\n        }\r\n\r\n        // Create user notification\r\n        const notification = {\r\n            type: 'conflict',\r\n            title: 'Update Conflict',\r\n            message: 'Your changes conflicted with another update. The latest version has been loaded.',\r\n            action: operation.metadata.action || 'unknown',\r\n            canRetry: true,\r\n            operation\r\n        };\r\n\r\n        return {\r\n            state: serverState,\r\n            notification\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Create state snapshot for rollback\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Object} state - Current state to snapshot\r\n     */\r\n    createSnapshot(componentId, state) {\r\n        this.snapshots.set(componentId, {\r\n            state: JSON.parse(JSON.stringify(state)), // Deep clone\r\n            timestamp: Date.now()\r\n        });\r\n\r\n        console.log(`[OptimisticUI] Created snapshot for ${componentId}`, {\r\n            version: state.version\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Clear snapshot after all operations confirmed\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     */\r\n    clearSnapshot(componentId) {\r\n        const snapshot = this.snapshots.get(componentId);\r\n\r\n        if (snapshot) {\r\n            this.snapshots.delete(componentId);\r\n            console.log(`[OptimisticUI] Cleared snapshot for ${componentId}`);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get rollback snapshot\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @returns {Object|null} Snapshot or null if none exists\r\n     */\r\n    getSnapshot(componentId) {\r\n        const snapshot = this.snapshots.get(componentId);\r\n        return snapshot ? snapshot.state : null;\r\n    }\r\n\r\n    /**\r\n     * Add pending operation\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Object} operation - Operation object\r\n     */\r\n    addPendingOperation(componentId, operation) {\r\n        if (!this.pendingOperations.has(componentId)) {\r\n            this.pendingOperations.set(componentId, []);\r\n        }\r\n\r\n        this.pendingOperations.get(componentId).push(operation);\r\n    }\r\n\r\n    /**\r\n     * Remove pending operation\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {string} operationId - Operation ID to remove\r\n     */\r\n    removePendingOperation(componentId, operationId) {\r\n        const operations = this.pendingOperations.get(componentId);\r\n\r\n        if (!operations) {\r\n            return;\r\n        }\r\n\r\n        const index = operations.findIndex(op => op.id === operationId);\r\n\r\n        if (index !== -1) {\r\n            operations.splice(index, 1);\r\n        }\r\n\r\n        // Clean up empty arrays\r\n        if (operations.length === 0) {\r\n            this.pendingOperations.delete(componentId);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get specific pending operation\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {string} operationId - Operation ID\r\n     * @returns {Object|null} Operation or null if not found\r\n     */\r\n    getPendingOperation(componentId, operationId) {\r\n        const operations = this.pendingOperations.get(componentId);\r\n\r\n        if (!operations) {\r\n            return null;\r\n        }\r\n\r\n        return operations.find(op => op.id === operationId) || null;\r\n    }\r\n\r\n    /**\r\n     * Get all pending operations for component\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @returns {Array<Object>} Array of pending operations\r\n     */\r\n    getPendingOperations(componentId) {\r\n        return this.pendingOperations.get(componentId) || [];\r\n    }\r\n\r\n    /**\r\n     * Get pending operations count\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @returns {number} Number of pending operations\r\n     */\r\n    getPendingOperationsCount(componentId) {\r\n        const operations = this.pendingOperations.get(componentId);\r\n        return operations ? operations.length : 0;\r\n    }\r\n\r\n    /**\r\n     * Check if component has pending operations\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @returns {boolean} True if has pending operations\r\n     */\r\n    hasPendingOperations(componentId) {\r\n        return this.getPendingOperationsCount(componentId) > 0;\r\n    }\r\n\r\n    /**\r\n     * Clear all pending operations for component\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     */\r\n    clearPendingOperations(componentId) {\r\n        this.pendingOperations.delete(componentId);\r\n    }\r\n\r\n    /**\r\n     * Register conflict handler\r\n     *\r\n     * Allows components to provide custom conflict resolution UI.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Function} handler - Conflict handler callback\r\n     */\r\n    registerConflictHandler(componentId, handler) {\r\n        this.conflictHandlers.set(componentId, handler);\r\n    }\r\n\r\n    /**\r\n     * Unregister conflict handler\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     */\r\n    unregisterConflictHandler(componentId) {\r\n        this.conflictHandlers.delete(componentId);\r\n    }\r\n\r\n    /**\r\n     * Generate unique operation ID\r\n     *\r\n     * @returns {string} Unique operation ID\r\n     */\r\n    generateOperationId() {\r\n        return `op-${++this.operationIdCounter}-${Date.now()}`;\r\n    }\r\n\r\n    /**\r\n     * Retry failed operation\r\n     *\r\n     * Allows user to retry operation after conflict resolution.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Object} operation - Failed operation to retry\r\n     * @param {Function} retryCallback - Callback to execute retry\r\n     * @returns {Promise} Retry promise\r\n     */\r\n    async retryOperation(componentId, operation, retryCallback) {\r\n        console.log(`[OptimisticUI] Retrying operation ${operation.id} for ${componentId}`);\r\n\r\n        try {\r\n            // Execute retry callback\r\n            const result = await retryCallback(operation.metadata);\r\n\r\n            console.log(`[OptimisticUI] Retry succeeded for ${operation.id}`);\r\n\r\n            return result;\r\n\r\n        } catch (error) {\r\n            console.error(`[OptimisticUI] Retry failed for ${operation.id}:`, error);\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get debugging stats\r\n     *\r\n     * @returns {Object} Statistics about optimistic operations\r\n     */\r\n    getStats() {\r\n        const stats = {\r\n            total_components: this.pendingOperations.size,\r\n            total_pending_operations: 0,\r\n            total_snapshots: this.snapshots.size,\r\n            components: {}\r\n        };\r\n\r\n        this.pendingOperations.forEach((operations, componentId) => {\r\n            stats.total_pending_operations += operations.length;\r\n            stats.components[componentId] = {\r\n                pending: operations.length,\r\n                has_snapshot: this.snapshots.has(componentId)\r\n            };\r\n        });\r\n\r\n        return stats;\r\n    }\r\n\r\n    /**\r\n     * Clear all state (for testing/debugging)\r\n     */\r\n    clear() {\r\n        this.pendingOperations.clear();\r\n        this.snapshots.clear();\r\n        this.conflictHandlers.clear();\r\n        this.operationIdCounter = 0;\r\n\r\n        console.log('[OptimisticUI] Cleared all state');\r\n    }\r\n}\r\n\r\n// Create singleton instance\r\nexport const optimisticStateManager = new OptimisticStateManager();\r\n\r\n// Export for testing and direct use\r\nexport default optimisticStateManager;\r\n","/**\r\n * Accessibility Manager for LiveComponents\r\n *\r\n * Manages accessibility features for dynamic content updates:\r\n * - ARIA live regions for screen reader announcements\r\n * - Focus management with data-lc-keep-focus attribute\r\n * - Keyboard navigation preservation\r\n * - Screen reader-friendly update notifications\r\n *\r\n * WCAG 2.1 Compliance:\r\n * - 4.1.3 Status Messages (Level AA)\r\n * - 2.4.3 Focus Order (Level A)\r\n * - 2.1.1 Keyboard (Level A)\r\n */\r\n\r\nexport class AccessibilityManager {\r\n    constructor() {\r\n        /**\r\n         * ARIA live region element for announcements\r\n         * @type {HTMLElement|null}\r\n         */\r\n        this.liveRegion = null;\r\n\r\n        /**\r\n         * Component-specific live regions\r\n         * Map<componentId, HTMLElement>\r\n         */\r\n        this.componentLiveRegions = new Map();\r\n\r\n        /**\r\n         * Focus tracking for restoration\r\n         * Map<componentId, FocusState>\r\n         */\r\n        this.focusStates = new Map();\r\n\r\n        /**\r\n         * Announcement queue for throttling\r\n         * @type {Array<{message: string, priority: string}>}\r\n         */\r\n        this.announcementQueue = [];\r\n\r\n        /**\r\n         * Announcement throttle timer\r\n         * @type {number|null}\r\n         */\r\n        this.announceTimer = null;\r\n\r\n        /**\r\n         * Throttle delay in milliseconds\r\n         * @type {number}\r\n         */\r\n        this.throttleDelay = 500;\r\n    }\r\n\r\n    /**\r\n     * Initialize accessibility features\r\n     *\r\n     * Creates global live region and sets up initial state.\r\n     */\r\n    initialize() {\r\n        // Create global live region if not exists\r\n        if (!this.liveRegion) {\r\n            this.liveRegion = this.createLiveRegion('livecomponent-announcer', 'polite');\r\n            document.body.appendChild(this.liveRegion);\r\n        }\r\n\r\n        console.log('[AccessibilityManager] Initialized with ARIA live regions');\r\n    }\r\n\r\n    /**\r\n     * Create ARIA live region element\r\n     *\r\n     * @param {string} id - Element ID\r\n     * @param {string} politeness - ARIA politeness level (polite|assertive)\r\n     * @returns {HTMLElement} Live region element\r\n     */\r\n    createLiveRegion(id, politeness = 'polite') {\r\n        const region = document.createElement('div');\r\n        region.id = id;\r\n        region.setAttribute('role', 'status');\r\n        region.setAttribute('aria-live', politeness);\r\n        region.setAttribute('aria-atomic', 'true');\r\n        region.className = 'sr-only'; // Screen reader only styling\r\n\r\n        // Add screen reader only styles\r\n        region.style.position = 'absolute';\r\n        region.style.left = '-10000px';\r\n        region.style.width = '1px';\r\n        region.style.height = '1px';\r\n        region.style.overflow = 'hidden';\r\n\r\n        return region;\r\n    }\r\n\r\n    /**\r\n     * Create component-specific live region\r\n     *\r\n     * Each component can have its own live region for isolated announcements.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {HTMLElement} container - Component container element\r\n     * @param {string} politeness - ARIA politeness level\r\n     * @returns {HTMLElement} Component live region\r\n     */\r\n    createComponentLiveRegion(componentId, container, politeness = 'polite') {\r\n        // Check if already exists\r\n        let liveRegion = this.componentLiveRegions.get(componentId);\r\n\r\n        if (!liveRegion) {\r\n            liveRegion = this.createLiveRegion(`livecomponent-${componentId}-announcer`, politeness);\r\n            container.appendChild(liveRegion);\r\n            this.componentLiveRegions.set(componentId, liveRegion);\r\n        }\r\n\r\n        return liveRegion;\r\n    }\r\n\r\n    /**\r\n     * Announce update to screen readers\r\n     *\r\n     * Uses ARIA live regions to announce updates without stealing focus.\r\n     * Supports throttling to prevent announcement spam.\r\n     *\r\n     * @param {string} message - Message to announce\r\n     * @param {string} priority - Priority level (polite|assertive)\r\n     * @param {string|null} componentId - Optional component-specific announcement\r\n     */\r\n    announce(message, priority = 'polite', componentId = null) {\r\n        // Add to queue\r\n        this.announcementQueue.push({ message, priority, componentId });\r\n\r\n        // Throttle announcements\r\n        if (this.announceTimer) {\r\n            clearTimeout(this.announceTimer);\r\n        }\r\n\r\n        this.announceTimer = setTimeout(() => {\r\n            this.flushAnnouncements();\r\n        }, this.throttleDelay);\r\n    }\r\n\r\n    /**\r\n     * Flush announcement queue\r\n     *\r\n     * Processes queued announcements and clears the queue.\r\n     */\r\n    flushAnnouncements() {\r\n        if (this.announcementQueue.length === 0) return;\r\n\r\n        // Get most recent announcement (others are outdated)\r\n        const announcement = this.announcementQueue[this.announcementQueue.length - 1];\r\n        this.announcementQueue = [];\r\n\r\n        // Determine target live region\r\n        let liveRegion = this.liveRegion;\r\n\r\n        if (announcement.componentId) {\r\n            const componentRegion = this.componentLiveRegions.get(announcement.componentId);\r\n            if (componentRegion) {\r\n                liveRegion = componentRegion;\r\n            }\r\n        }\r\n\r\n        if (!liveRegion) {\r\n            console.warn('[AccessibilityManager] No live region available for announcement');\r\n            return;\r\n        }\r\n\r\n        // Update politeness if needed\r\n        if (announcement.priority === 'assertive') {\r\n            liveRegion.setAttribute('aria-live', 'assertive');\r\n        } else {\r\n            liveRegion.setAttribute('aria-live', 'polite');\r\n        }\r\n\r\n        // Clear and set new message\r\n        liveRegion.textContent = '';\r\n\r\n        // Use setTimeout to ensure screen reader picks up the change\r\n        setTimeout(() => {\r\n            liveRegion.textContent = announcement.message;\r\n        }, 100);\r\n\r\n        console.log(`[AccessibilityManager] Announced: \"${announcement.message}\" (${announcement.priority})`);\r\n    }\r\n\r\n    /**\r\n     * Capture focus state before update\r\n     *\r\n     * Saves current focus state for potential restoration after update.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {HTMLElement} container - Component container element\r\n     * @returns {FocusState} Focus state object\r\n     */\r\n    captureFocusState(componentId, container) {\r\n        const activeElement = document.activeElement;\r\n\r\n        // Check if focus is within container\r\n        if (!activeElement || !container.contains(activeElement)) {\r\n            return null;\r\n        }\r\n\r\n        const focusState = {\r\n            selector: this.getElementSelector(activeElement, container),\r\n            tagName: activeElement.tagName,\r\n            name: activeElement.name || null,\r\n            id: activeElement.id || null,\r\n            selectionStart: activeElement.selectionStart || null,\r\n            selectionEnd: activeElement.selectionEnd || null,\r\n            scrollTop: activeElement.scrollTop || 0,\r\n            scrollLeft: activeElement.scrollLeft || 0,\r\n            keepFocus: activeElement.hasAttribute('data-lc-keep-focus')\r\n        };\r\n\r\n        this.focusStates.set(componentId, focusState);\r\n\r\n        console.log(`[AccessibilityManager] Captured focus state for ${componentId}`, focusState);\r\n\r\n        return focusState;\r\n    }\r\n\r\n    /**\r\n     * Restore focus after update\r\n     *\r\n     * Restores focus to element marked with data-lc-keep-focus or previously focused element.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {HTMLElement} container - Component container element\r\n     * @returns {boolean} True if focus was restored\r\n     */\r\n    restoreFocus(componentId, container) {\r\n        const focusState = this.focusStates.get(componentId);\r\n\r\n        if (!focusState) {\r\n            return false;\r\n        }\r\n\r\n        try {\r\n            // Find element to focus\r\n            let elementToFocus = null;\r\n\r\n            // Priority 1: Element with data-lc-keep-focus attribute\r\n            if (focusState.keepFocus) {\r\n                elementToFocus = container.querySelector('[data-lc-keep-focus]');\r\n            }\r\n\r\n            // Priority 2: Element matching saved selector\r\n            if (!elementToFocus && focusState.selector) {\r\n                elementToFocus = container.querySelector(focusState.selector);\r\n            }\r\n\r\n            // Priority 3: Element with same ID\r\n            if (!elementToFocus && focusState.id) {\r\n                elementToFocus = container.querySelector(`#${focusState.id}`);\r\n            }\r\n\r\n            // Priority 4: Element with same name\r\n            if (!elementToFocus && focusState.name) {\r\n                elementToFocus = container.querySelector(`[name=\"${focusState.name}\"]`);\r\n            }\r\n\r\n            if (elementToFocus && elementToFocus.focus) {\r\n                elementToFocus.focus();\r\n\r\n                // Restore selection for inputs/textareas\r\n                if (elementToFocus.setSelectionRange &&\r\n                    focusState.selectionStart !== null &&\r\n                    focusState.selectionEnd !== null) {\r\n                    elementToFocus.setSelectionRange(\r\n                        focusState.selectionStart,\r\n                        focusState.selectionEnd\r\n                    );\r\n                }\r\n\r\n                // Restore scroll position\r\n                if (focusState.scrollTop > 0) {\r\n                    elementToFocus.scrollTop = focusState.scrollTop;\r\n                }\r\n                if (focusState.scrollLeft > 0) {\r\n                    elementToFocus.scrollLeft = focusState.scrollLeft;\r\n                }\r\n\r\n                console.log(`[AccessibilityManager] Restored focus to ${focusState.selector}`);\r\n\r\n                return true;\r\n            }\r\n\r\n        } catch (error) {\r\n            console.debug('[AccessibilityManager] Could not restore focus:', error);\r\n        } finally {\r\n            // Clean up focus state\r\n            this.focusStates.delete(componentId);\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Get CSS selector for an element within a container\r\n     *\r\n     * @param {HTMLElement} element - Element to get selector for\r\n     * @param {HTMLElement} container - Container element\r\n     * @returns {string|null} CSS selector or null\r\n     */\r\n    getElementSelector(element, container) {\r\n        // Try ID (most specific)\r\n        if (element.id) {\r\n            return `#${element.id}`;\r\n        }\r\n\r\n        // Try name attribute\r\n        if (element.name) {\r\n            return `[name=\"${element.name}\"]`;\r\n        }\r\n\r\n        // Try data-lc-key\r\n        const lcKey = element.getAttribute('data-lc-key');\r\n        if (lcKey) {\r\n            return `[data-lc-key=\"${lcKey}\"]`;\r\n        }\r\n\r\n        // Try to build a path from container\r\n        const path = [];\r\n        let current = element;\r\n\r\n        while (current && current !== container && current !== document.body) {\r\n            let selector = current.tagName.toLowerCase();\r\n\r\n            // Add class if available\r\n            if (current.className && typeof current.className === 'string') {\r\n                const classes = current.className.split(' ').filter(c => c.trim());\r\n                if (classes.length > 0) {\r\n                    selector += '.' + classes.join('.');\r\n                }\r\n            }\r\n\r\n            // Add nth-child if needed for specificity\r\n            if (current.parentElement) {\r\n                const siblings = Array.from(current.parentElement.children);\r\n                const index = siblings.indexOf(current) + 1;\r\n                if (siblings.length > 1) {\r\n                    selector += `:nth-child(${index})`;\r\n                }\r\n            }\r\n\r\n            path.unshift(selector);\r\n            current = current.parentElement;\r\n        }\r\n\r\n        return path.length > 0 ? path.join(' > ') : null;\r\n    }\r\n\r\n    /**\r\n     * Announce component update\r\n     *\r\n     * Convenience method for announcing component updates.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {string} updateType - Type of update (fragment|full|action)\r\n     * @param {Object} metadata - Additional metadata\r\n     */\r\n    announceUpdate(componentId, updateType, metadata = {}) {\r\n        let message = '';\r\n\r\n        switch (updateType) {\r\n            case 'fragment':\r\n                message = `Updated ${metadata.fragmentName || 'content'}`;\r\n                break;\r\n            case 'full':\r\n                message = 'Component updated';\r\n                break;\r\n            case 'action':\r\n                message = metadata.actionMessage || 'Action completed';\r\n                break;\r\n            default:\r\n                message = 'Content updated';\r\n        }\r\n\r\n        this.announce(message, 'polite', componentId);\r\n    }\r\n\r\n    /**\r\n     * Check if element should preserve keyboard navigation\r\n     *\r\n     * @param {HTMLElement} element - Element to check\r\n     * @returns {boolean} True if keyboard navigation should be preserved\r\n     */\r\n    shouldPreserveKeyboardNav(element) {\r\n        // Interactive elements that should always preserve keyboard nav\r\n        const interactiveTags = ['INPUT', 'TEXTAREA', 'SELECT', 'BUTTON', 'A'];\r\n\r\n        if (interactiveTags.includes(element.tagName)) {\r\n            return true;\r\n        }\r\n\r\n        // Elements with tabindex\r\n        if (element.hasAttribute('tabindex')) {\r\n            return true;\r\n        }\r\n\r\n        // Elements with role\r\n        const interactiveRoles = [\r\n            'button', 'link', 'textbox', 'searchbox',\r\n            'combobox', 'listbox', 'option', 'tab'\r\n        ];\r\n\r\n        const role = element.getAttribute('role');\r\n        if (role && interactiveRoles.includes(role)) {\r\n            return true;\r\n        }\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Cleanup component accessibility features\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     */\r\n    cleanup(componentId) {\r\n        // Remove component live region\r\n        const liveRegion = this.componentLiveRegions.get(componentId);\r\n        if (liveRegion && liveRegion.parentElement) {\r\n            liveRegion.parentElement.removeChild(liveRegion);\r\n        }\r\n        this.componentLiveRegions.delete(componentId);\r\n\r\n        // Clear focus state\r\n        this.focusStates.delete(componentId);\r\n\r\n        console.log(`[AccessibilityManager] Cleaned up accessibility for ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Get accessibility stats\r\n     *\r\n     * @returns {Object} Statistics about accessibility manager state\r\n     */\r\n    getStats() {\r\n        return {\r\n            has_global_live_region: this.liveRegion !== null,\r\n            component_live_regions: this.componentLiveRegions.size,\r\n            tracked_focus_states: this.focusStates.size,\r\n            pending_announcements: this.announcementQueue.length\r\n        };\r\n    }\r\n}\r\n\r\n// Create singleton instance\r\nexport const accessibilityManager = new AccessibilityManager();\r\n\r\nexport default accessibilityManager;\r\n","/**\r\n * Error Boundary for LiveComponents\r\n * \r\n * Provides automatic error handling, retry mechanisms, and error recovery\r\n * for LiveComponent operations.\r\n */\r\n\r\n// Note: LiveComponentError type is defined in types/livecomponent.d.ts\r\n// This is a runtime implementation, so we don't need to import the type\r\n\r\nexport class ErrorBoundary {\r\n    constructor(liveComponentManager) {\r\n        this.manager = liveComponentManager;\r\n        this.retryStrategies = new Map();\r\n        this.errorHandlers = new Map();\r\n        this.maxRetries = 3;\r\n        this.retryDelays = [1000, 2000, 5000]; // Progressive backoff\r\n    }\r\n\r\n    /**\r\n     * Handle error from component action\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} action - Action method name\r\n     * @param {Error|LiveComponentError} error - Error object\r\n     * @param {Object} context - Additional context\r\n     * @returns {Promise<boolean>} True if error was handled, false otherwise\r\n     */\r\n    async handleError(componentId, action, error, context = {}) {\r\n        console.error(`[ErrorBoundary] Error in ${componentId}.${action}:`, error);\r\n\r\n        // Convert to standardized error format\r\n        const standardizedError = this.standardizeError(error, componentId, action);\r\n\r\n        // Check for custom error handler\r\n        const handler = this.errorHandlers.get(componentId);\r\n        if (handler) {\r\n            try {\r\n                const handled = await handler(standardizedError, context);\r\n                if (handled) {\r\n                    return true;\r\n                }\r\n            } catch (handlerError) {\r\n                console.error('[ErrorBoundary] Error handler failed:', handlerError);\r\n            }\r\n        }\r\n\r\n        // Check if error is retryable\r\n        if (this.isRetryable(standardizedError)) {\r\n            const retried = await this.retryOperation(componentId, action, context, standardizedError);\r\n            if (retried) {\r\n                return true;\r\n            }\r\n        }\r\n\r\n        // Show error to user\r\n        this.showError(componentId, standardizedError);\r\n\r\n        // Dispatch error event\r\n        this.dispatchErrorEvent(componentId, standardizedError);\r\n\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * Standardize error format\r\n     * \r\n     * @param {Error|LiveComponentError|Object} error - Error object\r\n     * @param {string} componentId - Component ID\r\n     * @param {string} action - Action method name\r\n     * @returns {LiveComponentError} Standardized error\r\n     */\r\n    standardizeError(error, componentId, action) {\r\n        // If already standardized\r\n        if (error && typeof error === 'object' && 'code' in error && 'message' in error) {\r\n            return {\r\n                code: error.code,\r\n                message: error.message,\r\n                details: error.details || {},\r\n                componentId: error.componentId || componentId,\r\n                action: error.action || action,\r\n                timestamp: error.timestamp || Date.now()\r\n            };\r\n        }\r\n\r\n        // If Error object\r\n        if (error instanceof Error) {\r\n            return {\r\n                code: 'INTERNAL_ERROR',\r\n                message: error.message,\r\n                details: {\r\n                    stack: error.stack,\r\n                    name: error.name\r\n                },\r\n                componentId,\r\n                action,\r\n                timestamp: Date.now()\r\n            };\r\n        }\r\n\r\n        // If string\r\n        if (typeof error === 'string') {\r\n            return {\r\n                code: 'INTERNAL_ERROR',\r\n                message: error,\r\n                componentId,\r\n                action,\r\n                timestamp: Date.now()\r\n            };\r\n        }\r\n\r\n        // Default\r\n        return {\r\n            code: 'INTERNAL_ERROR',\r\n            message: 'An unknown error occurred',\r\n            details: { original: error },\r\n            componentId,\r\n            action,\r\n            timestamp: Date.now()\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Check if error is retryable\r\n     * \r\n     * @param {LiveComponentError} error - Standardized error\r\n     * @returns {boolean} True if error is retryable\r\n     */\r\n    isRetryable(error) {\r\n        const retryableCodes = [\r\n            'RATE_LIMIT_EXCEEDED',\r\n            'STATE_CONFLICT',\r\n            'INTERNAL_ERROR'\r\n        ];\r\n\r\n        return retryableCodes.includes(error.code);\r\n    }\r\n\r\n    /**\r\n     * Retry operation with exponential backoff\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} action - Action method name\r\n     * @param {Object} context - Operation context\r\n     * @param {LiveComponentError} error - Error that occurred\r\n     * @returns {Promise<boolean>} True if retry succeeded\r\n     */\r\n    async retryOperation(componentId, action, context, error) {\r\n        const retryKey = `${componentId}:${action}`;\r\n        const retryCount = this.retryStrategies.get(retryKey) || 0;\r\n\r\n        if (retryCount >= this.maxRetries) {\r\n            console.warn(`[ErrorBoundary] Max retries exceeded for ${retryKey}`);\r\n            this.retryStrategies.delete(retryKey);\r\n            return false;\r\n        }\r\n\r\n        // Calculate delay (progressive backoff)\r\n        const delay = this.retryDelays[retryCount] || this.retryDelays[this.retryDelays.length - 1];\r\n\r\n        console.log(`[ErrorBoundary] Retrying ${retryKey} in ${delay}ms (attempt ${retryCount + 1}/${this.maxRetries})`);\r\n\r\n        // Update retry count\r\n        this.retryStrategies.set(retryKey, retryCount + 1);\r\n\r\n        // Wait before retry\r\n        await new Promise(resolve => setTimeout(resolve, delay));\r\n\r\n        try {\r\n            // Retry the operation\r\n            const result = await this.manager.executeAction(\r\n                componentId,\r\n                action,\r\n                context.params || {},\r\n                context.fragments || null\r\n            );\r\n\r\n            // Success - clear retry count\r\n            this.retryStrategies.delete(retryKey);\r\n            console.log(`[ErrorBoundary] Retry succeeded for ${retryKey}`);\r\n            return true;\r\n\r\n        } catch (retryError) {\r\n            // Retry failed - will be handled by next retry or error handler\r\n            console.warn(`[ErrorBoundary] Retry failed for ${retryKey}:`, retryError);\r\n            return false;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Show error to user\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {LiveComponentError} error - Standardized error\r\n     */\r\n    showError(componentId, error) {\r\n        const config = this.manager.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        // Remove existing error\r\n        const existingError = config.element.querySelector('.livecomponent-error-boundary');\r\n        if (existingError) {\r\n            existingError.remove();\r\n        }\r\n\r\n        // Create error element\r\n        const errorEl = document.createElement('div');\r\n        errorEl.className = 'livecomponent-error-boundary';\r\n        errorEl.style.cssText = `\r\n            padding: 1rem;\r\n            background: #fee;\r\n            color: #c00;\r\n            border: 1px solid #faa;\r\n            border-radius: 4px;\r\n            margin-bottom: 1rem;\r\n        `;\r\n\r\n        // Error message\r\n        const messageEl = document.createElement('div');\r\n        messageEl.style.fontWeight = 'bold';\r\n        messageEl.textContent = error.message;\r\n        errorEl.appendChild(messageEl);\r\n\r\n        // Error code (if not generic)\r\n        if (error.code !== 'INTERNAL_ERROR') {\r\n            const codeEl = document.createElement('div');\r\n            codeEl.style.fontSize = '0.875rem';\r\n            codeEl.style.marginTop = '0.5rem';\r\n            codeEl.style.color = '#666';\r\n            codeEl.textContent = `Error Code: ${error.code}`;\r\n            errorEl.appendChild(codeEl);\r\n        }\r\n\r\n        // Retry button (if retryable)\r\n        if (this.isRetryable(error)) {\r\n            const retryBtn = document.createElement('button');\r\n            retryBtn.textContent = 'Retry';\r\n            retryBtn.style.cssText = `\r\n                margin-top: 0.5rem;\r\n                padding: 0.5rem 1rem;\r\n                background: #c00;\r\n                color: white;\r\n                border: none;\r\n                border-radius: 4px;\r\n                cursor: pointer;\r\n            `;\r\n            retryBtn.addEventListener('click', async () => {\r\n                errorEl.remove();\r\n                await this.retryOperation(componentId, error.action || '', {}, error);\r\n            });\r\n            errorEl.appendChild(retryBtn);\r\n        }\r\n\r\n        // Close button\r\n        const closeBtn = document.createElement('button');\r\n        closeBtn.textContent = '×';\r\n        closeBtn.style.cssText = `\r\n            float: right;\r\n            background: transparent;\r\n            border: none;\r\n            font-size: 1.5rem;\r\n            cursor: pointer;\r\n            color: #c00;\r\n        `;\r\n        closeBtn.addEventListener('click', () => {\r\n            errorEl.remove();\r\n        });\r\n        errorEl.appendChild(closeBtn);\r\n\r\n        // Insert at top of component\r\n        config.element.insertAdjacentElement('afterbegin', errorEl);\r\n\r\n        // Auto-remove after 10 seconds\r\n        setTimeout(() => {\r\n            if (errorEl.parentNode) {\r\n                errorEl.remove();\r\n            }\r\n        }, 10000);\r\n    }\r\n\r\n    /**\r\n     * Dispatch error event\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {LiveComponentError} error - Standardized error\r\n     */\r\n    dispatchErrorEvent(componentId, error) {\r\n        // Dispatch custom DOM event\r\n        const event = new CustomEvent('livecomponent:error', {\r\n            detail: {\r\n                componentId,\r\n                error\r\n            },\r\n            bubbles: true\r\n        });\r\n\r\n        const config = this.manager.components.get(componentId);\r\n        if (config) {\r\n            config.element.dispatchEvent(event);\r\n        }\r\n\r\n        // Also dispatch on document\r\n        document.dispatchEvent(event);\r\n    }\r\n\r\n    /**\r\n     * Register custom error handler for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Function} handler - Error handler function\r\n     */\r\n    registerErrorHandler(componentId, handler) {\r\n        if (typeof handler !== 'function') {\r\n            throw new Error('Error handler must be a function');\r\n        }\r\n\r\n        this.errorHandlers.set(componentId, handler);\r\n    }\r\n\r\n    /**\r\n     * Clear error handler for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    clearErrorHandler(componentId) {\r\n        this.errorHandlers.delete(componentId);\r\n    }\r\n\r\n    /**\r\n     * Clear retry strategy for component/action\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} action - Action method name\r\n     */\r\n    clearRetryStrategy(componentId, action) {\r\n        const retryKey = `${componentId}:${action}`;\r\n        this.retryStrategies.delete(retryKey);\r\n    }\r\n\r\n    /**\r\n     * Reset all retry strategies\r\n     */\r\n    resetRetryStrategies() {\r\n        this.retryStrategies.clear();\r\n    }\r\n}\r\n\r\n","/**\r\n * Request Deduplication for LiveComponents\r\n * \r\n * Prevents duplicate requests for the same action with the same parameters.\r\n * Useful for preventing race conditions and reducing server load.\r\n */\r\n\r\nexport class RequestDeduplicator {\r\n    constructor() {\r\n        this.pendingRequests = new Map();\r\n        this.requestCache = new Map();\r\n        this.cacheTimeout = 1000; // 1 second cache\r\n    }\r\n\r\n    /**\r\n     * Generate request key for deduplication\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @returns {string} Request key\r\n     */\r\n    generateKey(componentId, method, params) {\r\n        // Sort params for consistent key generation\r\n        const sortedParams = Object.keys(params)\r\n            .sort()\r\n            .reduce((acc, key) => {\r\n                acc[key] = params[key];\r\n                return acc;\r\n            }, {});\r\n\r\n        const paramsString = JSON.stringify(sortedParams);\r\n        return `${componentId}:${method}:${paramsString}`;\r\n    }\r\n\r\n    /**\r\n     * Check if request is already pending\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @returns {Promise|null} Pending request promise or null\r\n     */\r\n    getPendingRequest(componentId, method, params) {\r\n        const key = this.generateKey(componentId, method, params);\r\n        return this.pendingRequests.get(key) || null;\r\n    }\r\n\r\n    /**\r\n     * Register pending request\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @param {Promise} promise - Request promise\r\n     * @returns {Promise} Request promise\r\n     */\r\n    registerPendingRequest(componentId, method, params, promise) {\r\n        const key = this.generateKey(componentId, method, params);\r\n\r\n        // Store pending request\r\n        this.pendingRequests.set(key, promise);\r\n\r\n        // Clean up when request completes\r\n        promise\r\n            .then(() => {\r\n                this.pendingRequests.delete(key);\r\n            })\r\n            .catch(() => {\r\n                this.pendingRequests.delete(key);\r\n            });\r\n\r\n        return promise;\r\n    }\r\n\r\n    /**\r\n     * Check if request result is cached\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @returns {Object|null} Cached result or null\r\n     */\r\n    getCachedResult(componentId, method, params) {\r\n        const key = this.generateKey(componentId, method, params);\r\n        const cached = this.requestCache.get(key);\r\n\r\n        if (!cached) {\r\n            return null;\r\n        }\r\n\r\n        // Check if cache is still valid\r\n        const now = Date.now();\r\n        if (now - cached.timestamp > this.cacheTimeout) {\r\n            this.requestCache.delete(key);\r\n            return null;\r\n        }\r\n\r\n        return cached.result;\r\n    }\r\n\r\n    /**\r\n     * Cache request result\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @param {Object} result - Request result\r\n     */\r\n    cacheResult(componentId, method, params, result) {\r\n        const key = this.generateKey(componentId, method, params);\r\n        this.requestCache.set(key, {\r\n            result,\r\n            timestamp: Date.now()\r\n        });\r\n\r\n        // Clean up old cache entries\r\n        this.cleanupCache();\r\n    }\r\n\r\n    /**\r\n     * Clean up expired cache entries\r\n     */\r\n    cleanupCache() {\r\n        const now = Date.now();\r\n        for (const [key, cached] of this.requestCache.entries()) {\r\n            if (now - cached.timestamp > this.cacheTimeout) {\r\n                this.requestCache.delete(key);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Clear all pending requests\r\n     */\r\n    clearPendingRequests() {\r\n        this.pendingRequests.clear();\r\n    }\r\n\r\n    /**\r\n     * Clear all cached results\r\n     */\r\n    clearCache() {\r\n        this.requestCache.clear();\r\n    }\r\n\r\n    /**\r\n     * Clear requests and cache for specific component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    clearComponent(componentId) {\r\n        // Clear pending requests\r\n        for (const [key] of this.pendingRequests.entries()) {\r\n            if (key.startsWith(`${componentId}:`)) {\r\n                this.pendingRequests.delete(key);\r\n            }\r\n        }\r\n\r\n        // Clear cache\r\n        for (const [key] of this.requestCache.entries()) {\r\n            if (key.startsWith(`${componentId}:`)) {\r\n                this.requestCache.delete(key);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get statistics\r\n     * \r\n     * @returns {Object} Statistics\r\n     */\r\n    getStats() {\r\n        return {\r\n            pendingRequests: this.pendingRequests.size,\r\n            cachedResults: this.requestCache.size\r\n        };\r\n    }\r\n}\r\n\r\n","/**\r\n * State Serializer for LiveComponents\r\n * \r\n * Provides type-safe state serialization/deserialization with versioning\r\n * and validation.\r\n */\r\n\r\n/**\r\n * Serialize component state\r\n * \r\n * @param {LiveComponentState} state - Component state\r\n * @returns {string} Serialized state JSON\r\n */\r\nexport function serializeState(state) {\r\n    // Validate state structure\r\n    if (!state || typeof state !== 'object') {\r\n        throw new Error('State must be an object');\r\n    }\r\n\r\n    if (!state.id || typeof state.id !== 'string') {\r\n        throw new Error('State must have a valid id');\r\n    }\r\n\r\n    if (!state.component || typeof state.component !== 'string') {\r\n        throw new Error('State must have a valid component name');\r\n    }\r\n\r\n    if (typeof state.version !== 'number' || state.version < 1) {\r\n        throw new Error('State must have a valid version number');\r\n    }\r\n\r\n    // Ensure data is an object\r\n    const data = state.data || {};\r\n    if (typeof data !== 'object' || Array.isArray(data)) {\r\n        throw new Error('State data must be an object');\r\n    }\r\n\r\n    // Create serializable state\r\n    const serializableState = {\r\n        id: state.id,\r\n        component: state.component,\r\n        data: data,\r\n        version: state.version\r\n    };\r\n\r\n    // Serialize to JSON\r\n    try {\r\n        return JSON.stringify(serializableState);\r\n    } catch (error) {\r\n        throw new Error(`Failed to serialize state: ${error.message}`);\r\n    }\r\n}\r\n\r\n/**\r\n * Deserialize component state\r\n * \r\n * @param {string} json - Serialized state JSON\r\n * @returns {LiveComponentState} Deserialized state\r\n */\r\nexport function deserializeState(json) {\r\n    if (typeof json !== 'string') {\r\n        throw new Error('State JSON must be a string');\r\n    }\r\n\r\n    if (json.trim() === '') {\r\n        // Return empty state\r\n        return {\r\n            id: '',\r\n            component: '',\r\n            data: {},\r\n            version: 1\r\n        };\r\n    }\r\n\r\n    try {\r\n        const parsed = JSON.parse(json);\r\n\r\n        // Validate structure\r\n        if (!parsed || typeof parsed !== 'object') {\r\n            throw new Error('Invalid state structure');\r\n        }\r\n\r\n        // Extract state data\r\n        const id = parsed.id || '';\r\n        const component = parsed.component || '';\r\n        const data = parsed.data || {};\r\n        const version = typeof parsed.version === 'number' ? parsed.version : 1;\r\n\r\n        // Validate data is an object\r\n        if (typeof data !== 'object' || Array.isArray(data)) {\r\n            throw new Error('State data must be an object');\r\n        }\r\n\r\n        return {\r\n            id,\r\n            component,\r\n            data,\r\n            version\r\n        };\r\n    } catch (error) {\r\n        if (error instanceof SyntaxError) {\r\n            throw new Error(`Invalid JSON format: ${error.message}`);\r\n        }\r\n        throw error;\r\n    }\r\n}\r\n\r\n/**\r\n * Create state diff (changes between two states)\r\n * \r\n * @param {LiveComponentState} oldState - Previous state\r\n * @param {LiveComponentState} newState - New state\r\n * @returns {Object} State diff\r\n */\r\nexport function createStateDiff(oldState, newState) {\r\n    const diff = {\r\n        changed: false,\r\n        added: {},\r\n        removed: {},\r\n        modified: {},\r\n        versionChange: newState.version - oldState.version\r\n    };\r\n\r\n    const oldData = oldState.data || {};\r\n    const newData = newState.data || {};\r\n\r\n    // Find added keys\r\n    for (const key in newData) {\r\n        if (!(key in oldData)) {\r\n            diff.added[key] = newData[key];\r\n            diff.changed = true;\r\n        }\r\n    }\r\n\r\n    // Find removed keys\r\n    for (const key in oldData) {\r\n        if (!(key in newData)) {\r\n            diff.removed[key] = oldData[key];\r\n            diff.changed = true;\r\n        }\r\n    }\r\n\r\n    // Find modified keys\r\n    for (const key in newData) {\r\n        if (key in oldData) {\r\n            const oldValue = oldData[key];\r\n            const newValue = newData[key];\r\n\r\n            // Deep comparison for objects\r\n            if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {\r\n                diff.modified[key] = {\r\n                    old: oldValue,\r\n                    new: newValue\r\n                };\r\n                diff.changed = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return diff;\r\n}\r\n\r\n/**\r\n * Merge state changes\r\n * \r\n * @param {LiveComponentState} baseState - Base state\r\n * @param {Object} changes - State changes to apply\r\n * @returns {LiveComponentState} Merged state\r\n */\r\nexport function mergeStateChanges(baseState, changes) {\r\n    const baseData = baseState.data || {};\r\n    const mergedData = { ...baseData, ...changes };\r\n\r\n    return {\r\n        ...baseState,\r\n        data: mergedData,\r\n        version: baseState.version + 1\r\n    };\r\n}\r\n\r\n/**\r\n * Validate state structure\r\n * \r\n * @param {LiveComponentState} state - State to validate\r\n * @returns {boolean} True if valid\r\n */\r\nexport function validateState(state) {\r\n    if (!state || typeof state !== 'object') {\r\n        return false;\r\n    }\r\n\r\n    if (!state.id || typeof state.id !== 'string') {\r\n        return false;\r\n    }\r\n\r\n    if (!state.component || typeof state.component !== 'string') {\r\n        return false;\r\n    }\r\n\r\n    if (typeof state.version !== 'number' || state.version < 1) {\r\n        return false;\r\n    }\r\n\r\n    if (state.data && (typeof state.data !== 'object' || Array.isArray(state.data))) {\r\n        return false;\r\n    }\r\n\r\n    return true;\r\n}\r\n\r\n/**\r\n * Get state from DOM element\r\n * \r\n * @param {HTMLElement} element - Component element\r\n * @returns {LiveComponentState|null} State or null if not found\r\n */\r\nexport function getStateFromElement(element) {\r\n    const stateJson = element.dataset.state;\r\n    if (!stateJson) {\r\n        return null;\r\n    }\r\n\r\n    try {\r\n        return deserializeState(stateJson);\r\n    } catch (error) {\r\n        console.error('[StateSerializer] Failed to deserialize state from element:', error);\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Set state on DOM element\r\n * \r\n * @param {HTMLElement} element - Component element\r\n * @param {LiveComponentState} state - State to set\r\n */\r\nexport function setStateOnElement(element, state) {\r\n    if (!validateState(state)) {\r\n        throw new Error('Invalid state structure');\r\n    }\r\n\r\n    const stateJson = serializeState(state);\r\n    element.dataset.state = stateJson;\r\n}\r\n\r\n","/**\r\n * ChunkedUploader - Chunked File Upload Module for Large Files\r\n *\r\n * Features:\r\n * - Break large files into manageable chunks\r\n * - SHA-256 hashing for integrity verification\r\n * - Resume capability for interrupted uploads\r\n * - Real-time progress via SSE\r\n * - Retry logic with exponential backoff\r\n * - Parallel chunk uploads (configurable)\r\n * - Integration with LiveComponent system\r\n *\r\n * @package Framework\\LiveComponents\r\n */\r\n\r\nimport { getGlobalSseClient } from '../sse/index.js';\r\n\r\n/**\r\n * Chunk Upload Status\r\n */\r\nconst ChunkStatus = {\r\n    PENDING: 'pending',\r\n    HASHING: 'hashing',\r\n    UPLOADING: 'uploading',\r\n    COMPLETE: 'complete',\r\n    ERROR: 'error'\r\n};\r\n\r\n/**\r\n * Upload Session Status\r\n */\r\nconst SessionStatus = {\r\n    INITIALIZING: 'initializing',\r\n    INITIALIZED: 'initialized',\r\n    UPLOADING: 'uploading',\r\n    ASSEMBLING: 'assembling',\r\n    COMPLETE: 'complete',\r\n    ABORTED: 'aborted',\r\n    ERROR: 'error'\r\n};\r\n\r\n/**\r\n * Chunk Metadata - Tracks individual chunk state\r\n */\r\nclass ChunkMetadata {\r\n    constructor(index, size, file) {\r\n        this.index = index;\r\n        this.size = size;\r\n        this.status = ChunkStatus.PENDING;\r\n        this.hash = null;\r\n        this.uploadedBytes = 0;\r\n        this.retries = 0;\r\n        this.error = null;\r\n        this.xhr = null;\r\n        this.file = file;\r\n    }\r\n\r\n    get progress() {\r\n        return this.size > 0 ? (this.uploadedBytes / this.size) * 100 : 0;\r\n    }\r\n\r\n    reset() {\r\n        this.status = ChunkStatus.PENDING;\r\n        this.uploadedBytes = 0;\r\n        this.error = null;\r\n        this.xhr = null;\r\n    }\r\n\r\n    abort() {\r\n        if (this.xhr) {\r\n            this.xhr.abort();\r\n            this.xhr = null;\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Upload Session - Manages complete chunked upload session\r\n */\r\nclass UploadSession {\r\n    constructor(file, options) {\r\n        this.file = file;\r\n        this.sessionId = null;\r\n        this.totalChunks = 0;\r\n        this.chunkSize = options.chunkSize;\r\n        this.chunks = [];\r\n        this.status = SessionStatus.INITIALIZING;\r\n        this.uploadedChunks = 0;\r\n        this.expectedFileHash = null;\r\n        this.error = null;\r\n        this.startTime = null;\r\n        this.endTime = null;\r\n        this.expiresAt = null;\r\n    }\r\n\r\n    get progress() {\r\n        if (this.totalChunks === 0) return 0;\r\n        return (this.uploadedChunks / this.totalChunks) * 100;\r\n    }\r\n\r\n    get uploadedBytes() {\r\n        return this.chunks.reduce((sum, chunk) => sum + chunk.uploadedBytes, 0);\r\n    }\r\n\r\n    get totalBytes() {\r\n        return this.file.size;\r\n    }\r\n\r\n    get isComplete() {\r\n        return this.status === SessionStatus.COMPLETE;\r\n    }\r\n\r\n    get isError() {\r\n        return this.status === SessionStatus.ERROR;\r\n    }\r\n\r\n    get isAborted() {\r\n        return this.status === SessionStatus.ABORTED;\r\n    }\r\n\r\n    get canResume() {\r\n        return this.sessionId !== null && !this.isComplete && !this.isAborted;\r\n    }\r\n\r\n    getChunk(index) {\r\n        return this.chunks[index];\r\n    }\r\n\r\n    getPendingChunks() {\r\n        return this.chunks.filter(c => c.status === ChunkStatus.PENDING || c.status === ChunkStatus.ERROR);\r\n    }\r\n\r\n    getUploadingChunks() {\r\n        return this.chunks.filter(c => c.status === ChunkStatus.UPLOADING);\r\n    }\r\n}\r\n\r\n/**\r\n * ChunkedUploader - Main chunked upload manager\r\n */\r\nexport class ChunkedUploader {\r\n    constructor(componentId, options = {}) {\r\n        this.componentId = componentId;\r\n\r\n        // Options\r\n        this.chunkSize = options.chunkSize || 512 * 1024; // 512KB default\r\n        this.maxConcurrentChunks = options.maxConcurrentChunks || 3;\r\n        this.maxRetries = options.maxRetries || 3;\r\n        this.retryDelay = options.retryDelay || 1000; // 1s base delay\r\n        this.enableSSE = options.enableSSE !== false; // SSE enabled by default\r\n        this.apiBase = options.apiBase || '/live-component/upload';\r\n\r\n        // Callbacks\r\n        this.onInitialized = options.onInitialized || (() => {});\r\n        this.onChunkProgress = options.onChunkProgress || (() => {});\r\n        this.onProgress = options.onProgress || (() => {});\r\n        this.onComplete = options.onComplete || (() => {});\r\n        this.onError = options.onError || (() => {});\r\n        this.onAborted = options.onAborted || (() => {});\r\n        this.onSSEProgress = options.onSSEProgress || (() => {});\r\n\r\n        // State\r\n        this.sessions = new Map(); // sessionId => UploadSession\r\n        this.activeSession = null;\r\n        this.sseClient = null;\r\n        this.userId = null;\r\n\r\n        // Initialize SSE if enabled\r\n        if (this.enableSSE) {\r\n            this.initializeSSE();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Initialize SSE connection for real-time progress\r\n     */\r\n    initializeSSE() {\r\n        try {\r\n            // Get user ID from meta tag or data attribute\r\n            this.userId = this.getUserId();\r\n\r\n            if (this.userId) {\r\n                this.sseClient = getGlobalSseClient([`user:${this.userId}`]);\r\n\r\n                // Listen for progress events\r\n                this.sseClient.on('progress', (data) => {\r\n                    this.handleSSEProgress(data);\r\n                });\r\n\r\n                // Connect if not already connected\r\n                if (!this.sseClient.isConnected()) {\r\n                    this.sseClient.connect();\r\n                }\r\n            }\r\n        } catch (error) {\r\n            console.warn('[ChunkedUploader] Failed to initialize SSE:', error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get user ID for SSE channel\r\n     */\r\n    getUserId() {\r\n        // Try meta tag first\r\n        const meta = document.querySelector('meta[name=\"user-id\"]');\r\n        if (meta) return meta.content;\r\n\r\n        // Try data attribute on body\r\n        if (document.body.dataset.userId) {\r\n            return document.body.dataset.userId;\r\n        }\r\n\r\n        return null;\r\n    }\r\n\r\n    /**\r\n     * Handle SSE progress updates\r\n     */\r\n    handleSSEProgress(data) {\r\n        const sessionId = data.session_id;\r\n        const session = this.sessions.get(sessionId);\r\n\r\n        if (session && data.taskId === sessionId) {\r\n            // Update session from SSE data\r\n            if (data.data?.uploaded_chunks !== undefined) {\r\n                session.uploadedChunks = data.data.uploaded_chunks;\r\n            }\r\n\r\n            if (data.data?.phase) {\r\n                switch (data.data.phase) {\r\n                    case 'initialized':\r\n                        session.status = SessionStatus.INITIALIZED;\r\n                        break;\r\n                    case 'uploading':\r\n                        session.status = SessionStatus.UPLOADING;\r\n                        break;\r\n                    case 'completed':\r\n                        session.status = SessionStatus.COMPLETE;\r\n                        break;\r\n                    case 'aborted':\r\n                        session.status = SessionStatus.ABORTED;\r\n                        break;\r\n                    case 'error':\r\n                        session.status = SessionStatus.ERROR;\r\n                        break;\r\n                }\r\n            }\r\n\r\n            // Callback\r\n            this.onSSEProgress({\r\n                sessionId,\r\n                percent: data.percent,\r\n                message: data.message,\r\n                data: data.data\r\n            });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Upload file with chunking\r\n     *\r\n     * @param {File} file - File to upload\r\n     * @param {string} targetPath - Target path for assembled file\r\n     * @returns {Promise<UploadSession>}\r\n     */\r\n    async upload(file, targetPath) {\r\n        // Create upload session\r\n        const session = new UploadSession(file, {\r\n            chunkSize: this.chunkSize\r\n        });\r\n\r\n        this.activeSession = session;\r\n\r\n        try {\r\n            // Calculate chunks\r\n            session.totalChunks = Math.ceil(file.size / this.chunkSize);\r\n            for (let i = 0; i < session.totalChunks; i++) {\r\n                const start = i * this.chunkSize;\r\n                const end = Math.min(start + this.chunkSize, file.size);\r\n                const size = end - start;\r\n                session.chunks.push(new ChunkMetadata(i, size, file));\r\n            }\r\n\r\n            // Initialize session with API\r\n            await this.initializeSession(session);\r\n\r\n            // Store session\r\n            this.sessions.set(session.sessionId, session);\r\n\r\n            // Start uploading chunks\r\n            session.status = SessionStatus.UPLOADING;\r\n            session.startTime = Date.now();\r\n            await this.uploadChunks(session);\r\n\r\n            // Complete upload\r\n            await this.completeUpload(session, targetPath);\r\n\r\n            // Success\r\n            session.status = SessionStatus.COMPLETE;\r\n            session.endTime = Date.now();\r\n\r\n            this.onComplete({\r\n                sessionId: session.sessionId,\r\n                file: session.file,\r\n                totalBytes: session.totalBytes,\r\n                duration: session.endTime - session.startTime\r\n            });\r\n\r\n            return session;\r\n\r\n        } catch (error) {\r\n            session.status = SessionStatus.ERROR;\r\n            session.error = error.message;\r\n\r\n            this.onError({\r\n                sessionId: session.sessionId,\r\n                file: session.file,\r\n                error: error.message\r\n            });\r\n\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Initialize upload session with API\r\n     */\r\n    async initializeSession(session) {\r\n        const response = await fetch(`${this.apiBase}/init`, {\r\n            method: 'POST',\r\n            headers: {\r\n                'Content-Type': 'application/json',\r\n                'Accept': 'application/json',\r\n                'User-Agent': navigator.userAgent\r\n            },\r\n            body: JSON.stringify({\r\n                componentId: this.componentId,\r\n                fileName: session.file.name,\r\n                totalSize: session.file.size,\r\n                chunkSize: this.chunkSize\r\n            })\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`Failed to initialize upload session: ${response.status}`);\r\n        }\r\n\r\n        const data = await response.json();\r\n\r\n        if (!data.success) {\r\n            throw new Error(data.error || 'Failed to initialize upload session');\r\n        }\r\n\r\n        // Update session\r\n        session.sessionId = data.session_id;\r\n        session.totalChunks = data.total_chunks;\r\n        session.expiresAt = new Date(data.expires_at);\r\n        session.status = SessionStatus.INITIALIZED;\r\n\r\n        this.onInitialized({\r\n            sessionId: session.sessionId,\r\n            totalChunks: session.totalChunks,\r\n            expiresAt: session.expiresAt\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Upload all chunks with parallelization\r\n     */\r\n    async uploadChunks(session) {\r\n        const pending = session.getPendingChunks();\r\n\r\n        // Upload chunks in parallel batches\r\n        while (pending.length > 0) {\r\n            const batch = pending.splice(0, this.maxConcurrentChunks);\r\n\r\n            await Promise.all(\r\n                batch.map(chunk => this.uploadChunk(session, chunk))\r\n            );\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Upload a single chunk\r\n     */\r\n    async uploadChunk(session, chunk) {\r\n        let retries = 0;\r\n\r\n        while (retries <= this.maxRetries) {\r\n            try {\r\n                // Hash chunk data\r\n                chunk.status = ChunkStatus.HASHING;\r\n                const chunkData = await this.readChunk(session.file, chunk);\r\n                const chunkHash = await this.hashChunk(chunkData);\r\n\r\n                chunk.hash = chunkHash;\r\n\r\n                // Upload chunk\r\n                chunk.status = ChunkStatus.UPLOADING;\r\n                await this.uploadChunkData(session, chunk, chunkData, chunkHash);\r\n\r\n                // Success\r\n                chunk.status = ChunkStatus.COMPLETE;\r\n                session.uploadedChunks++;\r\n\r\n                this.onProgress({\r\n                    sessionId: session.sessionId,\r\n                    progress: session.progress,\r\n                    uploadedChunks: session.uploadedChunks,\r\n                    totalChunks: session.totalChunks,\r\n                    uploadedBytes: session.uploadedBytes,\r\n                    totalBytes: session.totalBytes\r\n                });\r\n\r\n                return;\r\n\r\n            } catch (error) {\r\n                retries++;\r\n\r\n                if (retries > this.maxRetries) {\r\n                    chunk.status = ChunkStatus.ERROR;\r\n                    chunk.error = error.message;\r\n                    throw new Error(`Chunk ${chunk.index} failed after ${this.maxRetries} retries: ${error.message}`);\r\n                }\r\n\r\n                // Exponential backoff\r\n                const delay = this.retryDelay * Math.pow(2, retries - 1);\r\n                await this.sleep(delay);\r\n\r\n                chunk.reset();\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Read chunk data from file\r\n     */\r\n    readChunk(file, chunk) {\r\n        return new Promise((resolve, reject) => {\r\n            const start = chunk.index * this.chunkSize;\r\n            const end = Math.min(start + chunk.size, file.size);\r\n            const blob = file.slice(start, end);\r\n\r\n            const reader = new FileReader();\r\n\r\n            reader.onload = (e) => resolve(e.target.result);\r\n            reader.onerror = (e) => reject(new Error('Failed to read chunk'));\r\n\r\n            reader.readAsArrayBuffer(blob);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Hash chunk data with SHA-256\r\n     */\r\n    async hashChunk(chunkData) {\r\n        const hashBuffer = await crypto.subtle.digest('SHA-256', chunkData);\r\n        const hashArray = Array.from(new Uint8Array(hashBuffer));\r\n        return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');\r\n    }\r\n\r\n    /**\r\n     * Upload chunk data to server\r\n     */\r\n    uploadChunkData(session, chunk, chunkData, chunkHash) {\r\n        return new Promise((resolve, reject) => {\r\n            const formData = new FormData();\r\n            formData.append('sessionId', session.sessionId);\r\n            formData.append('chunkIndex', chunk.index);\r\n            formData.append('chunkHash', chunkHash);\r\n            formData.append('chunk', new Blob([chunkData]));\r\n\r\n            const xhr = new XMLHttpRequest();\r\n            chunk.xhr = xhr;\r\n\r\n            // Progress tracking\r\n            xhr.upload.addEventListener('progress', (e) => {\r\n                if (e.lengthComputable) {\r\n                    chunk.uploadedBytes = e.loaded;\r\n\r\n                    this.onChunkProgress({\r\n                        sessionId: session.sessionId,\r\n                        chunkIndex: chunk.index,\r\n                        uploadedBytes: e.loaded,\r\n                        totalBytes: e.total,\r\n                        progress: (e.loaded / e.total) * 100\r\n                    });\r\n                }\r\n            });\r\n\r\n            // Load event\r\n            xhr.addEventListener('load', () => {\r\n                if (xhr.status >= 200 && xhr.status < 300) {\r\n                    try {\r\n                        const response = JSON.parse(xhr.responseText);\r\n                        if (response.success) {\r\n                            resolve(response);\r\n                        } else {\r\n                            reject(new Error(response.error || 'Chunk upload failed'));\r\n                        }\r\n                    } catch (e) {\r\n                        reject(e);\r\n                    }\r\n                } else {\r\n                    reject(new Error(`Chunk upload failed with status ${xhr.status}`));\r\n                }\r\n            });\r\n\r\n            // Error events\r\n            xhr.addEventListener('error', () => {\r\n                reject(new Error('Network error during chunk upload'));\r\n            });\r\n\r\n            xhr.addEventListener('abort', () => {\r\n                reject(new Error('Chunk upload cancelled'));\r\n            });\r\n\r\n            // Send request\r\n            xhr.open('POST', `${this.apiBase}/chunk`);\r\n            xhr.setRequestHeader('Accept', 'application/json');\r\n            xhr.setRequestHeader('User-Agent', navigator.userAgent);\r\n            xhr.send(formData);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Complete upload and assemble file\r\n     */\r\n    async completeUpload(session, targetPath) {\r\n        session.status = SessionStatus.ASSEMBLING;\r\n\r\n        const response = await fetch(`${this.apiBase}/complete`, {\r\n            method: 'POST',\r\n            headers: {\r\n                'Content-Type': 'application/json',\r\n                'Accept': 'application/json',\r\n                'User-Agent': navigator.userAgent\r\n            },\r\n            body: JSON.stringify({\r\n                sessionId: session.sessionId,\r\n                targetPath: targetPath\r\n            })\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`Failed to complete upload: ${response.status}`);\r\n        }\r\n\r\n        const data = await response.json();\r\n\r\n        if (!data.success) {\r\n            throw new Error(data.error || 'Failed to complete upload');\r\n        }\r\n\r\n        return data;\r\n    }\r\n\r\n    /**\r\n     * Abort upload\r\n     */\r\n    async abort(sessionId) {\r\n        const session = this.sessions.get(sessionId);\r\n        if (!session) {\r\n            throw new Error('Session not found');\r\n        }\r\n\r\n        // Abort all active chunk uploads\r\n        session.chunks.forEach(chunk => chunk.abort());\r\n\r\n        // Notify server\r\n        try {\r\n            await fetch(`${this.apiBase}/abort`, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'Accept': 'application/json',\r\n                    'User-Agent': navigator.userAgent\r\n                },\r\n                body: JSON.stringify({\r\n                    sessionId: sessionId,\r\n                    reason: 'User cancelled'\r\n                })\r\n            });\r\n        } catch (error) {\r\n            console.warn('[ChunkedUploader] Failed to notify server of abort:', error);\r\n        }\r\n\r\n        // Update session\r\n        session.status = SessionStatus.ABORTED;\r\n\r\n        this.onAborted({\r\n            sessionId,\r\n            uploadedChunks: session.uploadedChunks,\r\n            totalChunks: session.totalChunks\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Get upload status\r\n     */\r\n    async getStatus(sessionId) {\r\n        const response = await fetch(`${this.apiBase}/status/${sessionId}`, {\r\n            headers: {\r\n                'Accept': 'application/json',\r\n                'User-Agent': navigator.userAgent\r\n            }\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`Failed to get upload status: ${response.status}`);\r\n        }\r\n\r\n        const data = await response.json();\r\n\r\n        if (!data.success) {\r\n            throw new Error(data.error || 'Failed to get upload status');\r\n        }\r\n\r\n        return data;\r\n    }\r\n\r\n    /**\r\n     * Resume interrupted upload\r\n     */\r\n    async resume(sessionId, file, targetPath) {\r\n        // Get current status from server\r\n        const status = await this.getStatus(sessionId);\r\n\r\n        // Recreate session\r\n        const session = new UploadSession(file, {\r\n            chunkSize: this.chunkSize\r\n        });\r\n\r\n        session.sessionId = sessionId;\r\n        session.totalChunks = status.total_chunks;\r\n        session.uploadedChunks = status.uploaded_chunks;\r\n        session.status = SessionStatus.UPLOADING;\r\n\r\n        // Recreate chunks\r\n        for (let i = 0; i < session.totalChunks; i++) {\r\n            const start = i * this.chunkSize;\r\n            const end = Math.min(start + this.chunkSize, file.size);\r\n            const size = end - start;\r\n            const chunk = new ChunkMetadata(i, size, file);\r\n\r\n            // Mark already uploaded chunks as complete\r\n            if (i < status.uploaded_chunks) {\r\n                chunk.status = ChunkStatus.COMPLETE;\r\n                chunk.uploadedBytes = chunk.size;\r\n            }\r\n\r\n            session.chunks.push(chunk);\r\n        }\r\n\r\n        // Store and set as active\r\n        this.sessions.set(sessionId, session);\r\n        this.activeSession = session;\r\n\r\n        // Resume uploading\r\n        session.startTime = Date.now();\r\n        await this.uploadChunks(session);\r\n        await this.completeUpload(session, targetPath);\r\n\r\n        session.status = SessionStatus.COMPLETE;\r\n        session.endTime = Date.now();\r\n\r\n        this.onComplete({\r\n            sessionId: session.sessionId,\r\n            file: session.file,\r\n            totalBytes: session.totalBytes,\r\n            duration: session.endTime - session.startTime,\r\n            resumed: true\r\n        });\r\n\r\n        return session;\r\n    }\r\n\r\n    /**\r\n     * Helper: Sleep for delay\r\n     */\r\n    sleep(ms) {\r\n        return new Promise(resolve => setTimeout(resolve, ms));\r\n    }\r\n\r\n    /**\r\n     * Cleanup\r\n     */\r\n    destroy() {\r\n        // Abort all active sessions\r\n        this.sessions.forEach(session => {\r\n            if (session.canResume) {\r\n                session.chunks.forEach(chunk => chunk.abort());\r\n            }\r\n        });\r\n\r\n        this.sessions.clear();\r\n        this.activeSession = null;\r\n    }\r\n}\r\n\r\nexport default ChunkedUploader;\r\n","/**\r\n * Tooltip Manager for LiveComponents\r\n * \r\n * Provides tooltip functionality for LiveComponent elements with:\r\n * - Automatic positioning\r\n * - Validation error tooltips\r\n * - Accessibility support\r\n * - Smooth animations\r\n * - Multiple positioning strategies\r\n */\r\n\r\nexport class TooltipManager {\r\n    constructor() {\r\n        this.tooltips = new Map(); // element → tooltip element\r\n        this.activeTooltip = null;\r\n        this.config = {\r\n            delay: 300, // ms before showing tooltip\r\n            hideDelay: 100, // ms before hiding tooltip\r\n            maxWidth: 300, // px\r\n            offset: 8, // px offset from element\r\n            animationDuration: 200, // ms\r\n            zIndex: 10000\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Initialize tooltip for element\r\n     * \r\n     * @param {HTMLElement} element - Element to attach tooltip to\r\n     * @param {Object} options - Tooltip options\r\n     */\r\n    init(element, options = {}) {\r\n        // Get tooltip content from data attributes or options\r\n        const content = options.content || \r\n                       element.dataset.tooltip || \r\n                       element.getAttribute('title') ||\r\n                       element.getAttribute('aria-label') ||\r\n                       '';\r\n\r\n        if (!content) {\r\n            return; // No tooltip content\r\n        }\r\n\r\n        // Remove native title attribute to prevent default tooltip\r\n        if (element.hasAttribute('title')) {\r\n            element.dataset.originalTitle = element.getAttribute('title');\r\n            element.removeAttribute('title');\r\n        }\r\n\r\n        // Get positioning\r\n        const position = options.position || \r\n                        element.dataset.tooltipPosition || \r\n                        'top';\r\n\r\n        // Setup event listeners\r\n        this.setupEventListeners(element, content, position, options);\r\n    }\r\n\r\n    /**\r\n     * Setup event listeners for tooltip\r\n     * \r\n     * @param {HTMLElement} element - Element\r\n     * @param {string} content - Tooltip content\r\n     * @param {string} position - Position (top, bottom, left, right)\r\n     * @param {Object} options - Additional options\r\n     */\r\n    setupEventListeners(element, content, position, options) {\r\n        let showTimeout;\r\n        let hideTimeout;\r\n\r\n        const showTooltip = () => {\r\n            clearTimeout(hideTimeout);\r\n            showTimeout = setTimeout(() => {\r\n                this.show(element, content, position, options);\r\n            }, this.config.delay);\r\n        };\r\n\r\n        const hideTooltip = () => {\r\n            clearTimeout(showTimeout);\r\n            hideTimeout = setTimeout(() => {\r\n                this.hide(element);\r\n            }, this.config.hideDelay);\r\n        };\r\n\r\n        // Mouse events\r\n        element.addEventListener('mouseenter', showTooltip);\r\n        element.addEventListener('mouseleave', hideTooltip);\r\n        element.addEventListener('focus', showTooltip);\r\n        element.addEventListener('blur', hideTooltip);\r\n\r\n        // Touch events (for mobile)\r\n        element.addEventListener('touchstart', showTooltip, { passive: true });\r\n        element.addEventListener('touchend', hideTooltip, { passive: true });\r\n\r\n        // Store cleanup function\r\n        element._tooltipCleanup = () => {\r\n            clearTimeout(showTimeout);\r\n            clearTimeout(hideTimeout);\r\n            element.removeEventListener('mouseenter', showTooltip);\r\n            element.removeEventListener('mouseleave', hideTooltip);\r\n            element.removeEventListener('focus', showTooltip);\r\n            element.removeEventListener('blur', hideTooltip);\r\n            element.removeEventListener('touchstart', showTooltip);\r\n            element.removeEventListener('touchend', hideTooltip);\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Show tooltip\r\n     * \r\n     * @param {HTMLElement} element - Element\r\n     * @param {string} content - Tooltip content\r\n     * @param {string} position - Position\r\n     * @param {Object} options - Additional options\r\n     */\r\n    show(element, content, position, options = {}) {\r\n        // Hide existing tooltip\r\n        if (this.activeTooltip) {\r\n            this.hide();\r\n        }\r\n\r\n        // Create tooltip element\r\n        const tooltip = document.createElement('div');\r\n        tooltip.className = 'livecomponent-tooltip';\r\n        tooltip.setAttribute('role', 'tooltip');\r\n        tooltip.setAttribute('aria-hidden', 'false');\r\n        tooltip.textContent = content;\r\n\r\n        // Apply styles\r\n        tooltip.style.cssText = `\r\n            position: absolute;\r\n            max-width: ${this.config.maxWidth}px;\r\n            padding: 0.5rem 0.75rem;\r\n            background: #1f2937;\r\n            color: white;\r\n            border-radius: 0.375rem;\r\n            font-size: 0.875rem;\r\n            line-height: 1.4;\r\n            z-index: ${this.config.zIndex};\r\n            pointer-events: none;\r\n            opacity: 0;\r\n            transition: opacity ${this.config.animationDuration}ms ease;\r\n            word-wrap: break-word;\r\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\r\n        `;\r\n\r\n        // Add to DOM\r\n        document.body.appendChild(tooltip);\r\n\r\n        // Position tooltip\r\n        this.positionTooltip(tooltip, element, position);\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            tooltip.style.opacity = '1';\r\n        });\r\n\r\n        // Store references\r\n        this.tooltips.set(element, tooltip);\r\n        this.activeTooltip = tooltip;\r\n\r\n        // Set aria-describedby on element\r\n        const tooltipId = `tooltip-${Date.now()}`;\r\n        tooltip.id = tooltipId;\r\n        element.setAttribute('aria-describedby', tooltipId);\r\n    }\r\n\r\n    /**\r\n     * Position tooltip relative to element\r\n     * \r\n     * @param {HTMLElement} tooltip - Tooltip element\r\n     * @param {HTMLElement} element - Target element\r\n     * @param {string} position - Position (top, bottom, left, right)\r\n     */\r\n    positionTooltip(tooltip, element, position) {\r\n        const rect = element.getBoundingClientRect();\r\n        const tooltipRect = tooltip.getBoundingClientRect();\r\n        const scrollX = window.scrollX || window.pageXOffset;\r\n        const scrollY = window.scrollY || window.pageYOffset;\r\n        const offset = this.config.offset;\r\n\r\n        let top, left;\r\n\r\n        switch (position) {\r\n            case 'top':\r\n                top = rect.top + scrollY - tooltipRect.height - offset;\r\n                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);\r\n                break;\r\n            case 'bottom':\r\n                top = rect.bottom + scrollY + offset;\r\n                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);\r\n                break;\r\n            case 'left':\r\n                top = rect.top + scrollY + (rect.height / 2) - (tooltipRect.height / 2);\r\n                left = rect.left + scrollX - tooltipRect.width - offset;\r\n                break;\r\n            case 'right':\r\n                top = rect.top + scrollY + (rect.height / 2) - (tooltipRect.height / 2);\r\n                left = rect.right + scrollX + offset;\r\n                break;\r\n            default:\r\n                top = rect.top + scrollY - tooltipRect.height - offset;\r\n                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);\r\n        }\r\n\r\n        // Keep tooltip within viewport\r\n        const viewportWidth = window.innerWidth;\r\n        const viewportHeight = window.innerHeight;\r\n\r\n        // Horizontal adjustment\r\n        if (left < scrollX) {\r\n            left = scrollX + 8;\r\n        } else if (left + tooltipRect.width > scrollX + viewportWidth) {\r\n            left = scrollX + viewportWidth - tooltipRect.width - 8;\r\n        }\r\n\r\n        // Vertical adjustment\r\n        if (top < scrollY) {\r\n            top = scrollY + 8;\r\n        } else if (top + tooltipRect.height > scrollY + viewportHeight) {\r\n            top = scrollY + viewportHeight - tooltipRect.height - 8;\r\n        }\r\n\r\n        tooltip.style.top = `${top}px`;\r\n        tooltip.style.left = `${left}px`;\r\n    }\r\n\r\n    /**\r\n     * Hide tooltip\r\n     * \r\n     * @param {HTMLElement} element - Element (optional, hides active tooltip if not provided)\r\n     */\r\n    hide(element = null) {\r\n        const tooltip = element ? this.tooltips.get(element) : this.activeTooltip;\r\n\r\n        if (!tooltip) {\r\n            return;\r\n        }\r\n\r\n        // Animate out\r\n        tooltip.style.opacity = '0';\r\n\r\n        // Remove after animation\r\n        setTimeout(() => {\r\n            if (tooltip.parentNode) {\r\n                tooltip.parentNode.removeChild(tooltip);\r\n            }\r\n\r\n            // Remove aria-describedby\r\n            if (element) {\r\n                element.removeAttribute('aria-describedby');\r\n            }\r\n\r\n            // Clean up references\r\n            if (element) {\r\n                this.tooltips.delete(element);\r\n            }\r\n            if (this.activeTooltip === tooltip) {\r\n                this.activeTooltip = null;\r\n            }\r\n        }, this.config.animationDuration);\r\n    }\r\n\r\n    /**\r\n     * Show validation error tooltip\r\n     * \r\n     * @param {HTMLElement} element - Form element\r\n     * @param {string} message - Error message\r\n     */\r\n    showValidationError(element, message) {\r\n        // Remove existing error tooltip\r\n        this.hideValidationError(element);\r\n\r\n        // Show error tooltip with error styling\r\n        const tooltip = document.createElement('div');\r\n        tooltip.className = 'livecomponent-tooltip livecomponent-tooltip--error';\r\n        tooltip.setAttribute('role', 'alert');\r\n        tooltip.textContent = message;\r\n\r\n        tooltip.style.cssText = `\r\n            position: absolute;\r\n            max-width: ${this.config.maxWidth}px;\r\n            padding: 0.5rem 0.75rem;\r\n            background: #dc2626;\r\n            color: white;\r\n            border-radius: 0.375rem;\r\n            font-size: 0.875rem;\r\n            line-height: 1.4;\r\n            z-index: ${this.config.zIndex};\r\n            pointer-events: none;\r\n            opacity: 0;\r\n            transition: opacity ${this.config.animationDuration}ms ease;\r\n            word-wrap: break-word;\r\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\r\n        `;\r\n\r\n        document.body.appendChild(tooltip);\r\n        this.positionTooltip(tooltip, element, 'top');\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            tooltip.style.opacity = '1';\r\n        });\r\n\r\n        // Store reference\r\n        element._validationTooltip = tooltip;\r\n\r\n        // Add error class to element\r\n        element.classList.add('livecomponent-error');\r\n    }\r\n\r\n    /**\r\n     * Hide validation error tooltip\r\n     * \r\n     * @param {HTMLElement} element - Form element\r\n     */\r\n    hideValidationError(element) {\r\n        const tooltip = element._validationTooltip;\r\n        if (!tooltip) {\r\n            return;\r\n        }\r\n\r\n        // Animate out\r\n        tooltip.style.opacity = '0';\r\n\r\n        setTimeout(() => {\r\n            if (tooltip.parentNode) {\r\n                tooltip.parentNode.removeChild(tooltip);\r\n            }\r\n            delete element._validationTooltip;\r\n            element.classList.remove('livecomponent-error');\r\n        }, this.config.animationDuration);\r\n    }\r\n\r\n    /**\r\n     * Initialize all tooltips in component\r\n     * \r\n     * @param {HTMLElement} container - Component container\r\n     */\r\n    initComponent(container) {\r\n        // Find all elements with tooltip attributes\r\n        const elements = container.querySelectorAll('[data-tooltip], [title], [aria-label]');\r\n        elements.forEach(element => {\r\n            this.init(element);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Cleanup tooltips for component\r\n     * \r\n     * @param {HTMLElement} container - Component container\r\n     */\r\n    cleanupComponent(container) {\r\n        const elements = container.querySelectorAll('[data-tooltip], [title], [aria-label]');\r\n        elements.forEach(element => {\r\n            // Hide tooltip\r\n            this.hide(element);\r\n\r\n            // Cleanup event listeners\r\n            if (element._tooltipCleanup) {\r\n                element._tooltipCleanup();\r\n                delete element._tooltipCleanup;\r\n            }\r\n\r\n            // Restore original title\r\n            if (element.dataset.originalTitle) {\r\n                element.setAttribute('title', element.dataset.originalTitle);\r\n                delete element.dataset.originalTitle;\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Update configuration\r\n     * \r\n     * @param {Object} newConfig - New configuration\r\n     */\r\n    updateConfig(newConfig) {\r\n        this.config = {\r\n            ...this.config,\r\n            ...newConfig\r\n        };\r\n    }\r\n}\r\n\r\n// Create singleton instance\r\nexport const tooltipManager = new TooltipManager();\r\n\r\n","/**\r\n * Action Loading Manager for LiveComponents\r\n * \r\n * Provides skeleton loading states during component actions with:\r\n * - Automatic skeleton overlay during actions\r\n * - Configurable skeleton templates per component\r\n * - Smooth transitions\r\n * - Fragment-aware loading\r\n */\r\n\r\nexport class ActionLoadingManager {\r\n    constructor() {\r\n        this.loadingStates = new Map(); // componentId → loading state\r\n        this.skeletonTemplates = new Map(); // componentId → template\r\n        this.config = {\r\n            showDelay: 150, // ms before showing skeleton\r\n            transitionDuration: 200, // ms for transitions\r\n            preserveContent: true, // Keep content visible under skeleton\r\n            opacity: 0.6 // Skeleton overlay opacity\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Show loading state for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Object} options - Loading options\r\n     */\r\n    showLoading(componentId, element, options = {}) {\r\n        // Check if already loading\r\n        if (this.loadingStates.has(componentId)) {\r\n            return; // Already showing loading state\r\n        }\r\n\r\n        const showDelay = options.showDelay ?? this.config.showDelay;\r\n        const fragments = options.fragments || null;\r\n\r\n        // Delay showing skeleton (for fast responses)\r\n        const timeoutId = setTimeout(() => {\r\n            this.createSkeletonOverlay(componentId, element, fragments, options);\r\n        }, showDelay);\r\n\r\n        // Store loading state\r\n        this.loadingStates.set(componentId, {\r\n            timeoutId,\r\n            element,\r\n            fragments,\r\n            options\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Create skeleton overlay\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Array<string>|null} fragments - Fragment names to show skeleton for\r\n     * @param {Object} options - Options\r\n     */\r\n    createSkeletonOverlay(componentId, element, fragments, options) {\r\n        // Get skeleton template\r\n        const template = this.getSkeletonTemplate(componentId, element, fragments);\r\n\r\n        // Create overlay container\r\n        const overlay = document.createElement('div');\r\n        overlay.className = 'livecomponent-loading-overlay';\r\n        overlay.setAttribute('data-component-id', componentId);\r\n        overlay.setAttribute('aria-busy', 'true');\r\n        overlay.setAttribute('aria-label', 'Loading...');\r\n\r\n        overlay.style.cssText = `\r\n            position: absolute;\r\n            top: 0;\r\n            left: 0;\r\n            right: 0;\r\n            bottom: 0;\r\n            background: rgba(255, 255, 255, ${this.config.opacity});\r\n            z-index: 10;\r\n            display: flex;\r\n            align-items: center;\r\n            justify-content: center;\r\n            opacity: 0;\r\n            transition: opacity ${this.config.transitionDuration}ms ease;\r\n            pointer-events: none;\r\n        `;\r\n\r\n        // Add skeleton content\r\n        overlay.innerHTML = template;\r\n\r\n        // Ensure element has relative positioning\r\n        const originalPosition = element.style.position;\r\n        if (getComputedStyle(element).position === 'static') {\r\n            element.style.position = 'relative';\r\n        }\r\n\r\n        // Append overlay\r\n        element.appendChild(overlay);\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            overlay.style.opacity = '1';\r\n        });\r\n\r\n        // Update loading state\r\n        const state = this.loadingStates.get(componentId);\r\n        if (state) {\r\n            state.overlay = overlay;\r\n            state.originalPosition = originalPosition;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get skeleton template for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Array<string>|null} fragments - Fragment names\r\n     * @returns {string} Skeleton HTML\r\n     */\r\n    getSkeletonTemplate(componentId, element, fragments) {\r\n        // Check for custom template\r\n        const customTemplate = this.skeletonTemplates.get(componentId);\r\n        if (customTemplate) {\r\n            return typeof customTemplate === 'function' \r\n                ? customTemplate(element, fragments)\r\n                : customTemplate;\r\n        }\r\n\r\n        // If fragments specified, create fragment-specific skeletons\r\n        if (fragments && fragments.length > 0) {\r\n            return this.createFragmentSkeletons(fragments);\r\n        }\r\n\r\n        // Default skeleton template\r\n        return this.createDefaultSkeleton(element);\r\n    }\r\n\r\n    /**\r\n     * Create default skeleton template\r\n     * \r\n     * @param {HTMLElement} element - Component element\r\n     * @returns {string} Skeleton HTML\r\n     */\r\n    createDefaultSkeleton(element) {\r\n        const height = element.offsetHeight || 200;\r\n        const width = element.offsetWidth || '100%';\r\n\r\n        return `\r\n            <div class=\"skeleton-container\" style=\"width: ${width}; height: ${height}px; padding: 1.5rem;\">\r\n                <div class=\"skeleton skeleton-text skeleton-text--full\" style=\"margin-bottom: 1rem;\"></div>\r\n                <div class=\"skeleton skeleton-text skeleton-text--80\" style=\"margin-bottom: 0.75rem;\"></div>\r\n                <div class=\"skeleton skeleton-text skeleton-text--60\" style=\"margin-bottom: 0.75rem;\"></div>\r\n                <div class=\"skeleton skeleton-text skeleton-text--full\" style=\"margin-bottom: 1rem;\"></div>\r\n                <div class=\"skeleton skeleton-text skeleton-text--80\"></div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Create fragment-specific skeletons\r\n     * \r\n     * @param {Array<string>} fragments - Fragment names\r\n     * @returns {string} Skeleton HTML\r\n     */\r\n    createFragmentSkeletons(fragments) {\r\n        return fragments.map(fragmentName => `\r\n            <div class=\"skeleton-fragment\" data-fragment=\"${fragmentName}\">\r\n                <div class=\"skeleton skeleton-text skeleton-text--full\" style=\"margin-bottom: 0.75rem;\"></div>\r\n                <div class=\"skeleton skeleton-text skeleton-text--80\"></div>\r\n            </div>\r\n        `).join('');\r\n    }\r\n\r\n    /**\r\n     * Hide loading state\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    hideLoading(componentId) {\r\n        const state = this.loadingStates.get(componentId);\r\n        if (!state) {\r\n            return;\r\n        }\r\n\r\n        // Clear timeout if not yet shown\r\n        if (state.timeoutId) {\r\n            clearTimeout(state.timeoutId);\r\n        }\r\n\r\n        // Remove overlay if exists\r\n        if (state.overlay) {\r\n            // Animate out\r\n            state.overlay.style.opacity = '0';\r\n\r\n            setTimeout(() => {\r\n                if (state.overlay && state.overlay.parentNode) {\r\n                    state.overlay.parentNode.removeChild(state.overlay);\r\n                }\r\n            }, this.config.transitionDuration);\r\n        }\r\n\r\n        // Restore original position\r\n        if (state.originalPosition !== undefined) {\r\n            state.element.style.position = state.originalPosition;\r\n        }\r\n\r\n        // Remove from map\r\n        this.loadingStates.delete(componentId);\r\n    }\r\n\r\n    /**\r\n     * Register custom skeleton template for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string|Function} template - Template HTML or function that returns HTML\r\n     */\r\n    registerTemplate(componentId, template) {\r\n        this.skeletonTemplates.set(componentId, template);\r\n    }\r\n\r\n    /**\r\n     * Unregister skeleton template\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    unregisterTemplate(componentId) {\r\n        this.skeletonTemplates.delete(componentId);\r\n    }\r\n\r\n    /**\r\n     * Check if component is loading\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @returns {boolean} True if loading\r\n     */\r\n    isLoading(componentId) {\r\n        return this.loadingStates.has(componentId);\r\n    }\r\n\r\n    /**\r\n     * Update configuration\r\n     * \r\n     * @param {Object} newConfig - New configuration\r\n     */\r\n    updateConfig(newConfig) {\r\n        this.config = {\r\n            ...this.config,\r\n            ...newConfig\r\n        };\r\n    }\r\n}\r\n\r\n// Create singleton instance\r\nexport const actionLoadingManager = new ActionLoadingManager();\r\n\r\n","/**\r\n * LiveComponent Client-Side Implementation\r\n *\r\n * Handles:\r\n * - Component initialization and lifecycle\r\n * - AJAX action dispatching\r\n * - Server-sent events from component updates\r\n * - Polling for Pollable components\r\n * - Event-driven component-to-component communication\r\n * - Fragment-based partial rendering with DOM patching\r\n * - Real-time SSE updates for reactive components\r\n */\r\n\r\nimport { domPatcher } from './DomPatcher.js';\r\nimport { SseClient } from '../sse/index.js';\r\nimport { LazyComponentLoader } from './LazyComponentLoader.js';\r\nimport { NestedComponentHandler } from './NestedComponentHandler.js';\r\nimport { ComponentPlayground } from './ComponentPlayground.js';\r\nimport { ComponentFileUploader } from './ComponentFileUploader.js';\r\nimport { FileUploadWidget } from './FileUploadWidget.js';\r\nimport { optimisticStateManager } from './OptimisticStateManager.js';\r\nimport { accessibilityManager } from './AccessibilityManager.js';\r\nimport { ErrorBoundary } from './ErrorBoundary.js';\r\nimport { RequestDeduplicator } from './RequestDeduplicator.js';\r\nimport * as StateSerializer from './StateSerializer.js';\r\n\r\nclass LiveComponentManager {\r\n    constructor() {\r\n        this.components = new Map();\r\n        this.eventHandlers = new Map();\r\n        this.debounceTimers = new Map();\r\n        this.domPatcher = domPatcher;\r\n        this.accessibilityManager = accessibilityManager;\r\n        // Note: No global CSRF token - each component has its own token\r\n\r\n        // SSE Integration\r\n        this.sseClients = new Map(); // channel → SseClient\r\n        this.componentChannels = new Map(); // componentId → channel\r\n\r\n        // Lazy Loading Integration\r\n        this.lazyLoader = null; // Initialized in init() or initLazyLoading()\r\n\r\n        // Nested Components Integration\r\n        this.nestedHandler = null; // Initialized in initNestedComponents()\r\n\r\n        // DevTools Integration\r\n        this.devTools = null; // Will be set by DevTools when available\r\n\r\n        // Error Handling\r\n        this.errorBoundary = new ErrorBoundary(this);\r\n\r\n        // Request Deduplication\r\n        this.requestDeduplicator = new RequestDeduplicator();\r\n        \r\n        // Shared Configuration\r\n        this.config = sharedConfig;\r\n\r\n        // Tooltip Manager\r\n        this.tooltipManager = tooltipManager;\r\n\r\n        // Action Loading Manager\r\n        this.actionLoadingManager = actionLoadingManager;\r\n\r\n        // UI Helper\r\n        this.uiHelper = new LiveComponentUIHelper(this);\r\n\r\n        // Loading State Manager\r\n        this.loadingStateManager = new LoadingStateManager(\r\n            this.actionLoadingManager,\r\n            optimisticStateManager\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Enable DevTools integration\r\n     * Called by LiveComponentDevTools during initialization\r\n     */\r\n    enableDevTools(devToolsInstance) {\r\n        this.devTools = devToolsInstance;\r\n        console.log('[LiveComponent] DevTools integration enabled');\r\n    }\r\n\r\n    /**\r\n     * Log action to DevTools if enabled\r\n     */\r\n    logActionToDevTools(componentId, actionName, params, startTime, endTime, success, error = null) {\r\n        if (!this.devTools) return;\r\n\r\n        this.devTools.logAction(componentId, actionName, params, startTime, endTime, success, error);\r\n    }\r\n\r\n    /**\r\n     * Log event to DevTools if enabled\r\n     */\r\n    logEventToDevTools(eventName, data, source = 'server') {\r\n        if (!this.devTools) return;\r\n\r\n        this.devTools.logEvent(eventName, data, source);\r\n    }\r\n\r\n    /**\r\n     * Initialize Lazy Loading system\r\n     * Should be called once during application startup\r\n     */\r\n    initLazyLoading() {\r\n        if (this.lazyLoader) {\r\n            console.warn('[LiveComponent] Lazy loading already initialized');\r\n            return;\r\n        }\r\n\r\n        this.lazyLoader = new LazyComponentLoader(this);\r\n        this.lazyLoader.init();\r\n\r\n        console.log('[LiveComponent] Lazy loading system initialized');\r\n    }\r\n\r\n    /**\r\n     * Initialize Nested Components system\r\n     * Should be called once during application startup\r\n     */\r\n    initNestedComponents() {\r\n        if (this.nestedHandler) {\r\n            console.warn('[LiveComponent] Nested components already initialized');\r\n            return;\r\n        }\r\n\r\n        this.nestedHandler = new NestedComponentHandler(this);\r\n        this.nestedHandler.init();\r\n\r\n        console.log('[LiveComponent] Nested components system initialized');\r\n    }\r\n\r\n    /**\r\n     * Initialize LiveComponent\r\n     */\r\n    init(element) {\r\n        const componentId = element.dataset.liveComponent;\r\n        if (!componentId) return;\r\n\r\n        const config = {\r\n            id: componentId,\r\n            element,\r\n            pollInterval: parseInt(element.dataset.pollInterval) || null,\r\n            pollTimer: null,\r\n            observer: null\r\n        };\r\n\r\n        this.components.set(componentId, config);\r\n\r\n        // Setup action handlers\r\n        this.setupActionHandlers(element);\r\n\r\n        // Setup file upload handlers\r\n        this.setupFileUploadHandlers(element);\r\n\r\n        // Setup polling if component is pollable\r\n        if (config.pollInterval) {\r\n            this.startPolling(componentId);\r\n        }\r\n\r\n        // Setup lifecycle observer for onDestroy hook\r\n        this.setupLifecycleObserver(element, componentId);\r\n\r\n        // Setup SSE connection if component has a channel\r\n        this.setupSseConnection(element, componentId);\r\n\r\n        // Setup accessibility features\r\n        this.setupAccessibility(componentId, element);\r\n\r\n        // Initialize tooltips for component\r\n        this.tooltipManager.initComponent(element);\r\n\r\n        console.log(`[LiveComponent] Initialized: ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Setup accessibility features for component\r\n     */\r\n    setupAccessibility(componentId, element) {\r\n        // Create component-specific ARIA live region\r\n        const politeness = element.dataset.livePolite === 'assertive' ? 'assertive' : 'polite';\r\n        this.accessibilityManager.createComponentLiveRegion(componentId, element, politeness);\r\n\r\n        console.log(`[LiveComponent] Accessibility features enabled for ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Setup MutationObserver to detect component removal from DOM\r\n     * Calls onDestroy() lifecycle hook on server when component is removed\r\n     */\r\n    setupLifecycleObserver(element, componentId) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        // Create observer to watch for element removal\r\n        const observer = new MutationObserver((mutations) => {\r\n            // Check if element is no longer in DOM\r\n            if (!document.contains(element)) {\r\n                console.log(`[LiveComponent] Element removed from DOM: ${componentId}`);\r\n                this.callDestroyHook(componentId);\r\n                observer.disconnect();\r\n            }\r\n        });\r\n\r\n        // Observe parent node for childList changes\r\n        if (element.parentNode) {\r\n            observer.observe(element.parentNode, {\r\n                childList: true,\r\n                subtree: false\r\n            });\r\n        }\r\n\r\n        config.observer = observer;\r\n    }\r\n\r\n    /**\r\n     * Setup SSE connection for component\r\n     * Automatically connects to SSE if component has data-sse-channel attribute\r\n     */\r\n    setupSseConnection(element, componentId) {\r\n        // Check if component has SSE channel\r\n        const sseChannel = element.dataset.sseChannel;\r\n        if (!sseChannel) {\r\n            return; // No SSE channel, skip\r\n        }\r\n\r\n        console.log(`[LiveComponent] Setting up SSE for ${componentId} on channel: ${sseChannel}`);\r\n\r\n        // Track component-channel mapping\r\n        this.componentChannels.set(componentId, sseChannel);\r\n\r\n        // Get or create SSE client for this channel\r\n        let sseClient = this.sseClients.get(sseChannel);\r\n        if (!sseClient) {\r\n            // Create new SSE client for this channel\r\n            sseClient = new SseClient([sseChannel], {\r\n                autoReconnect: true,\r\n                heartbeatTimeout: 45000\r\n            });\r\n\r\n            // Register global handlers for this channel\r\n            this.registerSseHandlers(sseClient, sseChannel);\r\n\r\n            // Connect\r\n            sseClient.connect();\r\n\r\n            this.sseClients.set(sseChannel, sseClient);\r\n            console.log(`[LiveComponent] Created SSE client for channel: ${sseChannel}`);\r\n        }\r\n\r\n        console.log(`[LiveComponent] SSE connection established for ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Register SSE event handlers for a channel\r\n     */\r\n    registerSseHandlers(sseClient, channel) {\r\n        // Handle component-update events\r\n        sseClient.on('component-update', (data) => {\r\n            this.handleSseComponentUpdate(data, channel);\r\n        });\r\n\r\n        // Handle component-fragments events\r\n        sseClient.on('component-fragments', (data) => {\r\n            this.handleSseComponentFragments(data, channel);\r\n        });\r\n\r\n        // Handle connection state changes\r\n        sseClient.on('connected', () => {\r\n            console.log(`[LiveComponent] SSE connected to channel: ${channel}`);\r\n            this.updateSseConnectionStatus(channel, 'connected');\r\n        });\r\n\r\n        sseClient.on('disconnected', () => {\r\n            console.log(`[LiveComponent] SSE disconnected from channel: ${channel}`);\r\n            this.updateSseConnectionStatus(channel, 'disconnected');\r\n        });\r\n\r\n        sseClient.on('reconnecting', (attempt) => {\r\n            console.log(`[LiveComponent] SSE reconnecting to channel ${channel} (attempt ${attempt})`);\r\n            this.updateSseConnectionStatus(channel, 'reconnecting');\r\n        });\r\n\r\n        sseClient.on('error', (error) => {\r\n            console.error(`[LiveComponent] SSE error on channel ${channel}:`, error);\r\n            this.updateSseConnectionStatus(channel, 'error');\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Handle SSE component-update event\r\n     */\r\n    handleSseComponentUpdate(data, channel) {\r\n        const { componentId, state, html, events } = data;\r\n\r\n        console.log(`[LiveComponent] SSE update for ${componentId}:`, { state, html, events });\r\n\r\n        const config = this.components.get(componentId);\r\n        if (!config) {\r\n            console.warn(`[LiveComponent] Received SSE update for unknown component: ${componentId}`);\r\n            return;\r\n        }\r\n\r\n        try {\r\n            // Capture focus before update\r\n            this.accessibilityManager.captureFocusState(componentId, config.element);\r\n\r\n            // Update full HTML if provided\r\n            if (html) {\r\n                config.element.innerHTML = html;\r\n                this.setupActionHandlers(config.element);\r\n                this.setupFileUploadHandlers(config.element);\r\n            }\r\n\r\n            // Update state using StateSerializer\r\n            if (state) {\r\n                StateSerializer.setStateOnElement(config.element, state);\r\n            }\r\n\r\n            // Restore focus after update\r\n            this.accessibilityManager.restoreFocus(componentId, config.element);\r\n\r\n            // Announce update to screen readers\r\n            this.accessibilityManager.announceUpdate(componentId, 'full');\r\n\r\n            // Dispatch events\r\n            if (events && Array.isArray(events)) {\r\n                this.handleServerEvents(events);\r\n            }\r\n\r\n            console.log(`[LiveComponent] SSE update applied to ${componentId}`);\r\n\r\n        } catch (error) {\r\n            console.error(`[LiveComponent] Failed to apply SSE update for ${componentId}:`, error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle SSE component-fragments event\r\n     */\r\n    handleSseComponentFragments(data, channel) {\r\n        const { componentId, fragments } = data;\r\n\r\n        console.log(`[LiveComponent] SSE fragments for ${componentId}:`, fragments);\r\n\r\n        const config = this.components.get(componentId);\r\n        if (!config) {\r\n            console.warn(`[LiveComponent] Received SSE fragments for unknown component: ${componentId}`);\r\n            return;\r\n        }\r\n\r\n        try {\r\n            // Update fragments using DOM patcher\r\n            this.updateFragments(config.element, fragments);\r\n\r\n            console.log(`[LiveComponent] SSE fragments applied to ${componentId}`);\r\n\r\n        } catch (error) {\r\n            console.error(`[LiveComponent] Failed to apply SSE fragments for ${componentId}:`, error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Update SSE connection status indicators\r\n     */\r\n    updateSseConnectionStatus(channel, status) {\r\n        // Find all components on this channel\r\n        this.componentChannels.forEach((componentChannel, componentId) => {\r\n            if (componentChannel === channel) {\r\n                const config = this.components.get(componentId);\r\n                if (!config) return;\r\n\r\n                // Update status attribute\r\n                config.element.dataset.sseStatus = status;\r\n\r\n                // Dispatch custom event for status change\r\n                config.element.dispatchEvent(new CustomEvent('livecomponent:sse:status', {\r\n                    detail: { channel, status }\r\n                }));\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Call onDestroy() lifecycle hook on server\r\n     * Uses navigator.sendBeacon for best-effort delivery even during page unload\r\n     */\r\n    async callDestroyHook(componentId) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        try {\r\n            // Get current state\r\n            const stateJson = config.element.dataset.state || '{}';\r\n            const state = JSON.parse(stateJson);\r\n\r\n            // Get CSRF token\r\n            const csrfToken = config.element.dataset.csrfToken;\r\n\r\n            const payload = JSON.stringify({\r\n                state,\r\n                _csrf_token: csrfToken\r\n            });\r\n\r\n            // Try sendBeacon first for better reliability during page unload\r\n            const url = `/live-component/${componentId}/destroy`;\r\n            const blob = new Blob([payload], { type: 'application/json' });\r\n\r\n            if (navigator.sendBeacon && navigator.sendBeacon(url, blob)) {\r\n                console.log(`[LiveComponent] onDestroy() called via sendBeacon: ${componentId}`);\r\n            } else {\r\n                // Fallback to fetch for normal removal\r\n                await fetch(url, {\r\n                    method: 'POST',\r\n                    headers: {\r\n                        'Content-Type': 'application/json',\r\n                        'X-Requested-With': 'XMLHttpRequest'\r\n                    },\r\n                    body: payload\r\n                });\r\n                console.log(`[LiveComponent] onDestroy() called via fetch: ${componentId}`);\r\n            }\r\n        } catch (error) {\r\n            // Don't throw - component is being destroyed anyway\r\n            console.warn(`[LiveComponent] onDestroy() hook failed: ${componentId}`, error);\r\n        }\r\n\r\n        // Clean up local state\r\n        this.destroy(componentId);\r\n    }\r\n\r\n    /**\r\n     * Setup action click handlers\r\n     */\r\n    setupActionHandlers(element) {\r\n        element.querySelectorAll('[data-live-action]').forEach(actionEl => {\r\n            // Handle form submissions\r\n            if (actionEl.tagName === 'FORM') {\r\n                actionEl.addEventListener('submit', async (e) => {\r\n                    e.preventDefault();\r\n\r\n                    const componentId = element.dataset.liveComponent;\r\n                    const action = actionEl.dataset.liveAction;\r\n\r\n                    // Collect all form values\r\n                    const formValues = {};\r\n                    const formData = new FormData(actionEl);\r\n                    for (const [key, value] of formData.entries()) {\r\n                        formValues[key] = value;\r\n                    }\r\n\r\n                    // Extract fragments for partial rendering\r\n                    const fragments = this.extractFragments(actionEl);\r\n\r\n                    await this.executeAction(componentId, action, formValues, fragments);\r\n                });\r\n            }\r\n            // Handle input elements with debouncing\r\n            else if (actionEl.tagName === 'INPUT' || actionEl.tagName === 'TEXTAREA' || actionEl.tagName === 'SELECT') {\r\n                // Default debounce for text inputs: 300ms, others: 0ms\r\n                const defaultDebounce = (actionEl.type === 'text' || actionEl.type === 'email' || actionEl.type === 'url' || actionEl.type === 'tel' || actionEl.tagName === 'TEXTAREA') ? 300 : 0;\r\n                const debounceMs = parseInt(actionEl.dataset.liveDebounce) ?? defaultDebounce;\r\n\r\n                actionEl.addEventListener('input', async (e) => {\r\n                    const componentId = element.dataset.liveComponent;\r\n                    const action = actionEl.dataset.liveAction;\r\n                    const params = this.extractParams(actionEl);\r\n\r\n                    // Add input value to params\r\n                    if (actionEl.type === 'checkbox') {\r\n                        params[actionEl.name || 'value'] = actionEl.checked ? 'yes' : 'no';\r\n                    } else if (actionEl.type === 'radio') {\r\n                        params[actionEl.name || 'value'] = actionEl.value;\r\n                    } else {\r\n                        params[actionEl.name || 'value'] = actionEl.value;\r\n                    }\r\n\r\n                    // Extract fragments for partial rendering\r\n                    const fragments = this.extractFragments(actionEl);\r\n\r\n                    if (debounceMs > 0) {\r\n                        this.debouncedAction(componentId, action, params, debounceMs, fragments);\r\n                    } else {\r\n                        await this.executeAction(componentId, action, params, fragments);\r\n                    }\r\n                });\r\n\r\n                // For radio buttons and checkboxes, also listen to 'change' event\r\n                if (actionEl.type === 'radio' || actionEl.type === 'checkbox') {\r\n                    actionEl.addEventListener('change', async (e) => {\r\n                        const componentId = element.dataset.liveComponent;\r\n                        const action = actionEl.dataset.liveAction;\r\n                        const params = this.extractParams(actionEl);\r\n\r\n                        if (actionEl.type === 'checkbox') {\r\n                            params[actionEl.name || 'value'] = actionEl.checked ? 'yes' : 'no';\r\n                        } else if (actionEl.type === 'radio') {\r\n                            params[actionEl.name || 'value'] = actionEl.value;\r\n                        }\r\n\r\n                        await this.executeAction(componentId, action, params);\r\n                    });\r\n                }\r\n            } else {\r\n                // Handle button clicks\r\n                actionEl.addEventListener('click', async (e) => {\r\n                    e.preventDefault();\r\n\r\n                    const componentId = element.dataset.liveComponent;\r\n                    const action = actionEl.dataset.liveAction;\r\n                    let params = this.extractParams(actionEl);\r\n\r\n                    // For submit/navigation actions, collect all form values\r\n                    if (action === 'submit' || action === 'nextStep' || action === 'previousStep') {\r\n                        const formValues = this.collectFormValues(element);\r\n                        console.log('[LiveComponent] Collected form values:', formValues);\r\n                        params = { ...formValues, ...params };\r\n                        console.log('[LiveComponent] Final params:', params);\r\n                    }\r\n\r\n                    // Extract fragments for partial rendering\r\n                    const fragments = this.extractFragments(actionEl);\r\n\r\n                    await this.executeAction(componentId, action, params, fragments);\r\n                });\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Debounced action execution\r\n     */\r\n    debouncedAction(componentId, action, params, delay, fragments = null) {\r\n        const timerKey = `${componentId}_${action}`;\r\n\r\n        // Clear existing timer\r\n        if (this.debounceTimers.has(timerKey)) {\r\n            clearTimeout(this.debounceTimers.get(timerKey));\r\n        }\r\n\r\n        // Set new timer\r\n        const timer = setTimeout(async () => {\r\n            await this.executeAction(componentId, action, params, fragments);\r\n            this.debounceTimers.delete(timerKey);\r\n        }, delay);\r\n\r\n        this.debounceTimers.set(timerKey, timer);\r\n    }\r\n\r\n    /**\r\n     * Extract action parameters from element\r\n     */\r\n    extractParams(element) {\r\n        const params = {};\r\n\r\n        // Extract data-param-* attributes\r\n        Object.keys(element.dataset).forEach(key => {\r\n            if (key.startsWith('param')) {\r\n                // Remove 'param' prefix and handle '-from' suffix\r\n                const paramKey = key.replace('param', '');\r\n\r\n                // Check if this is a -from parameter (e.g., data-param-field-from=\"value\")\r\n                if (paramKey.endsWith('From')) {\r\n                    // Extract parameter name (e.g., \"fieldFrom\" -> \"field\")\r\n                    const paramName = paramKey.replace(/From$/, '').toLowerCase();\r\n                    const fromAttribute = element.dataset[key]; // e.g., \"value\"\r\n\r\n                    // Get value from the specified attribute\r\n                    if (fromAttribute === 'value') {\r\n                        params[paramName] = element.value;\r\n                    } else {\r\n                        params[paramName] = element[fromAttribute] || element.getAttribute(fromAttribute);\r\n                    }\r\n                } else {\r\n                    // Regular parameter (e.g., data-param-direction=\"desc\")\r\n                    const paramName = paramKey.toLowerCase();\r\n                    params[paramName] = element.dataset[key];\r\n                }\r\n            }\r\n        });\r\n\r\n        return params;\r\n    }\r\n\r\n    /**\r\n     * Extract fragments from element\r\n     *\r\n     * Gets fragments to update from data-lc-fragments attribute.\r\n     * Format: data-lc-fragments=\"user-stats,recent-activity\"\r\n     *\r\n     * @param {HTMLElement} element - Action element\r\n     * @returns {Array<string>|null} - Array of fragment names or null\r\n     */\r\n    extractFragments(element) {\r\n        const fragmentsAttr = element.dataset.lcFragments;\r\n\r\n        if (!fragmentsAttr) {\r\n            return null;\r\n        }\r\n\r\n        // Split by comma and trim whitespace\r\n        return fragmentsAttr.split(',').map(name => name.trim()).filter(Boolean);\r\n    }\r\n\r\n    /**\r\n     * Collect all form input values from component\r\n     */\r\n    collectFormValues(element) {\r\n        const values = {};\r\n\r\n        // Find all inputs, textareas, and selects within the component\r\n        const inputs = element.querySelectorAll('input, textarea, select');\r\n\r\n        inputs.forEach(input => {\r\n            const name = input.name;\r\n            if (!name) return; // Skip inputs without name\r\n\r\n            if (input.type === 'checkbox') {\r\n                values[name] = input.checked ? 'yes' : 'no';\r\n            } else if (input.type === 'radio') {\r\n                if (input.checked) {\r\n                    values[name] = input.value;\r\n                }\r\n            } else {\r\n                values[name] = input.value;\r\n            }\r\n        });\r\n\r\n        return values;\r\n    }\r\n\r\n    /**\r\n     * Execute component action\r\n     *\r\n     * @param {string} componentId - Component ID\r\n     * @param {string} method - Action method name\r\n     * @param {Object} params - Action parameters\r\n     * @param {Array<string>} fragments - Optional fragment names for partial rendering\r\n     */\r\n    async executeAction(componentId, method, params = {}, fragments = null) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) {\r\n            console.error(`[LiveComponent] Unknown component: ${componentId}`);\r\n            return;\r\n        }\r\n\r\n        // Check for pending duplicate request\r\n        const pendingRequest = this.requestDeduplicator.getPendingRequest(componentId, method, params);\r\n        if (pendingRequest) {\r\n            console.log(`[LiveComponent] Deduplicating request: ${componentId}.${method}`);\r\n            return await pendingRequest;\r\n        }\r\n\r\n        // Check for cached result\r\n        const cachedResult = this.requestDeduplicator.getCachedResult(componentId, method, params);\r\n        if (cachedResult) {\r\n            console.log(`[LiveComponent] Using cached result: ${componentId}.${method}`);\r\n            return cachedResult;\r\n        }\r\n\r\n        let operationId = null;\r\n        const startTime = performance.now();\r\n\r\n        // Show loading state (uses LoadingStateManager for configurable indicators)\r\n        const loadingConfig = this.loadingStateManager.getConfig(componentId);\r\n        this.loadingStateManager.showLoading(componentId, config.element, {\r\n            fragments,\r\n            type: loadingConfig.type,\r\n            optimistic: true // Check optimistic UI first\r\n        });\r\n\r\n        // Create request promise\r\n        const requestPromise = (async () => {\r\n            try {\r\n            // Get current state from element using StateSerializer\r\n            const stateWrapper = StateSerializer.getStateFromElement(config.element) || {\r\n                id: componentId,\r\n                component: '',\r\n                data: {},\r\n                version: 1\r\n            };\r\n\r\n            // Extract actual state data from wrapper format\r\n            // Wrapper format: {id, component, data, version}\r\n            // Server expects just the data object\r\n            const state = stateWrapper.data || {};\r\n\r\n            // Apply optimistic update for immediate UI feedback\r\n            // This updates the UI before server confirmation\r\n            const optimisticState = optimisticStateManager.applyOptimisticUpdate(\r\n                componentId,\r\n                stateWrapper,\r\n                (currentState) => {\r\n                    // Optimistic update function - predict state changes\r\n                    // For now, we just mark that an operation is pending\r\n                    // Component-specific logic could predict actual changes\r\n                    return {\r\n                        ...currentState,\r\n                        data: {\r\n                            ...currentState.data,\r\n                            _optimistic: true\r\n                        }\r\n                    };\r\n                },\r\n                { action: method, params }\r\n            );\r\n\r\n            operationId = optimisticStateManager.getPendingOperations(componentId)[0]?.id;\r\n\r\n            // Get component-specific CSRF token from element\r\n            const csrfToken = config.element.dataset.csrfToken;\r\n            if (!csrfToken) {\r\n                console.error(`[LiveComponent] Missing CSRF token for component: ${componentId}`);\r\n                throw new Error('CSRF token is required for component actions');\r\n            }\r\n\r\n            // Build request body\r\n            const requestBody = {\r\n                method,\r\n                params,\r\n                state,\r\n                _csrf_token: csrfToken\r\n            };\r\n\r\n            // Add fragments parameter if specified\r\n            if (fragments && Array.isArray(fragments) && fragments.length > 0) {\r\n                requestBody.fragments = fragments;\r\n            }\r\n\r\n            // Send AJAX request with CSRF token in body\r\n            // Component ID is in the URL, not in the body\r\n            const response = await fetch(`/live-component/${componentId}`, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'X-Requested-With': 'XMLHttpRequest'\r\n                },\r\n                body: JSON.stringify(requestBody)\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                console.error('[LiveComponent] Server error response:', errorText);\r\n                throw new Error(`HTTP ${response.status}: ${response.statusText}`);\r\n            }\r\n\r\n            const responseText = await response.text();\r\n            console.log('[LiveComponent] Raw response:', responseText.substring(0, 200));\r\n\r\n            let data;\r\n            try {\r\n                data = JSON.parse(responseText);\r\n            } catch (parseError) {\r\n                console.error('[LiveComponent] JSON parse error:', parseError);\r\n                console.error('[LiveComponent] Response text:', responseText);\r\n                throw new Error(`Failed to parse JSON response: ${parseError.message}`);\r\n            }\r\n\r\n            // Check for version conflict\r\n            const serverState = data.state || {};\r\n            const currentVersion = stateWrapper.version || 1;\r\n            const serverVersion = serverState.version || 1;\r\n\r\n            if (serverVersion !== currentVersion + 1) {\r\n                // Version conflict detected - server rejected our optimistic update\r\n                console.warn(`[LiveComponent] Version conflict: expected ${currentVersion + 1}, got ${serverVersion}`);\r\n\r\n                // Handle conflict via OptimisticStateManager\r\n                if (operationId) {\r\n                    const conflictResolution = optimisticStateManager.handleConflict(\r\n                        componentId,\r\n                        operationId,\r\n                        serverState,\r\n                        { expectedVersion: currentVersion + 1, actualVersion: serverVersion }\r\n                    );\r\n\r\n                    // Show conflict notification to user\r\n                    if (conflictResolution.notification) {\r\n                        this.showConflictNotification(componentId, conflictResolution.notification);\r\n                    }\r\n\r\n                    // Use server state (rollback)\r\n                    data.state = conflictResolution.state;\r\n                }\r\n            } else {\r\n                // Success - confirm optimistic operation\r\n                if (operationId) {\r\n                    optimisticStateManager.confirmOperation(componentId, operationId, serverState);\r\n                }\r\n            }\r\n\r\n            // Handle fragment-based response (partial rendering)\r\n            if (data.fragments) {\r\n                this.updateFragments(config.element, data.fragments);\r\n            }\r\n            // Handle full HTML response (fallback or no fragments requested)\r\n            else if (data.html) {\r\n                config.element.innerHTML = data.html;\r\n                this.setupActionHandlers(config.element);\r\n            }\r\n\r\n            // Re-initialize tooltips after DOM update\r\n            this.tooltipManager.initComponent(config.element);\r\n\r\n            // Update component state using StateSerializer\r\n            if (data.state) {\r\n                StateSerializer.setStateOnElement(config.element, data.state);\r\n            }\r\n\r\n            // Handle server events\r\n            if (data.events && data.events.length > 0) {\r\n                this.handleServerEvents(data.events);\r\n            }\r\n\r\n            console.log(`[LiveComponent] Action executed: ${componentId}.${method}`, data);\r\n\r\n                // Log successful action to DevTools\r\n                const endTime = performance.now();\r\n                this.logActionToDevTools(componentId, method, params, startTime, endTime, true);\r\n\r\n                // Cache successful result\r\n                this.requestDeduplicator.cacheResult(componentId, method, params, data);\r\n\r\n                // Hide loading state\r\n                this.loadingStateManager.hideLoading(componentId);\r\n\r\n                return data;\r\n\r\n            } catch (error) {\r\n                console.error(`[LiveComponent] Action failed:`, error);\r\n\r\n                // Log failed action to DevTools\r\n                const endTime = performance.now();\r\n                this.logActionToDevTools(componentId, method, params, startTime, endTime, false, error.message);\r\n\r\n                // Rollback optimistic update on error\r\n                if (operationId) {\r\n                    const snapshot = optimisticStateManager.getSnapshot(componentId);\r\n                    if (snapshot) {\r\n                        StateSerializer.setStateOnElement(config.element, snapshot);\r\n                        optimisticStateManager.clearPendingOperations(componentId);\r\n                        optimisticStateManager.clearSnapshot(componentId);\r\n                    }\r\n                }\r\n\r\n                // Hide loading state on error\r\n                this.loadingStateManager.hideLoading(componentId);\r\n\r\n                // Handle error via ErrorBoundary\r\n                await this.errorBoundary.handleError(componentId, method, error, {\r\n                    params,\r\n                    fragments\r\n                });\r\n\r\n                throw error;\r\n            }\r\n        })();\r\n\r\n        // Register pending request for deduplication\r\n        return this.requestDeduplicator.registerPendingRequest(componentId, method, params, requestPromise);\r\n    }\r\n\r\n    /**\r\n     * Update specific fragments using DOM patching\r\n     *\r\n     * Efficiently patches only the fragments that changed.\r\n     * Includes accessibility features: focus management and ARIA announcements.\r\n     *\r\n     * @param {HTMLElement} container - Component container element\r\n     * @param {Object.<string, string>} fragments - Map of fragment names to HTML\r\n     */\r\n    updateFragments(container, fragments) {\r\n        const componentId = container.dataset.liveComponent;\r\n\r\n        // Capture focus state before patching (with data-lc-keep-focus support)\r\n        if (componentId) {\r\n            this.accessibilityManager.captureFocusState(componentId, container);\r\n        }\r\n\r\n        // Patch each fragment\r\n        const results = this.domPatcher.patchFragments(container, fragments);\r\n\r\n        // Restore focus after patching (respects data-lc-keep-focus)\r\n        if (componentId) {\r\n            this.accessibilityManager.restoreFocus(componentId, container);\r\n        }\r\n\r\n        // Re-setup action handlers for patched fragments\r\n        Object.keys(fragments).forEach(fragmentName => {\r\n            if (results[fragmentName]) {\r\n                const fragmentElement = container.querySelector(`[data-lc-fragment=\"${fragmentName}\"]`);\r\n                if (fragmentElement) {\r\n                    this.setupActionHandlers(fragmentElement);\r\n                }\r\n            }\r\n        });\r\n\r\n        // Announce update to screen readers\r\n        if (componentId) {\r\n            const fragmentNames = Object.keys(fragments).filter(name => results[name]);\r\n            if (fragmentNames.length > 0) {\r\n                this.accessibilityManager.announceUpdate(componentId, 'fragment', {\r\n                    fragmentName: fragmentNames.join(', ')\r\n                });\r\n            }\r\n        }\r\n\r\n        // Log patching results\r\n        const successCount = Object.values(results).filter(Boolean).length;\r\n        console.log(`[LiveComponent] Patched ${successCount}/${Object.keys(fragments).length} fragments`, results);\r\n    }\r\n\r\n    /**\r\n     * Handle server-sent events\r\n     */\r\n    handleServerEvents(events) {\r\n        events.forEach(event => {\r\n            const { name, payload, target } = event;\r\n\r\n            console.log(`[LiveComponent] Server event:`, { name, payload, target });\r\n\r\n            // Log event to DevTools\r\n            this.logEventToDevTools(name, { payload, target }, 'server');\r\n\r\n            if (target) {\r\n                // Targeted event - only for specific component\r\n                this.dispatchToComponent(target, name, payload);\r\n            } else {\r\n                // Broadcast event - to all listening components\r\n                this.broadcast(name, payload);\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Dispatch event to specific component\r\n     */\r\n    dispatchToComponent(targetComponentId, eventName, payload) {\r\n        const handlers = this.eventHandlers.get(eventName) || [];\r\n\r\n        handlers.forEach(handler => {\r\n            if (handler.componentId === targetComponentId) {\r\n                handler.callback(payload);\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Broadcast event to all listeners\r\n     */\r\n    broadcast(eventName, payload) {\r\n        const handlers = this.eventHandlers.get(eventName) || [];\r\n\r\n        handlers.forEach(handler => {\r\n            handler.callback(payload);\r\n        });\r\n\r\n        // Also dispatch as custom DOM event\r\n        document.dispatchEvent(new CustomEvent(`livecomponent:${eventName}`, {\r\n            detail: payload\r\n        }));\r\n    }\r\n\r\n    /**\r\n     * Register event listener\r\n     */\r\n    on(componentId, eventName, callback) {\r\n        if (!this.eventHandlers.has(eventName)) {\r\n            this.eventHandlers.set(eventName, []);\r\n        }\r\n\r\n        this.eventHandlers.get(eventName).push({\r\n            componentId,\r\n            callback\r\n        });\r\n\r\n        console.log(`[LiveComponent] Event listener registered: ${componentId} -> ${eventName}`);\r\n    }\r\n\r\n    /**\r\n     * Start polling for component\r\n     */\r\n    startPolling(componentId) {\r\n        const config = this.components.get(componentId);\r\n        if (!config || !config.pollInterval) return;\r\n\r\n        // Clear existing timer\r\n        if (config.pollTimer) {\r\n            clearInterval(config.pollTimer);\r\n        }\r\n\r\n        // Start new polling interval\r\n        config.pollTimer = setInterval(async () => {\r\n            await this.executeAction(componentId, 'poll', {});\r\n        }, config.pollInterval);\r\n\r\n        console.log(`[LiveComponent] Polling started: ${componentId} (${config.pollInterval}ms)`);\r\n    }\r\n\r\n    /**\r\n     * Stop polling for component\r\n     */\r\n    stopPolling(componentId) {\r\n        const config = this.components.get(componentId);\r\n        if (!config || !config.pollTimer) return;\r\n\r\n        clearInterval(config.pollTimer);\r\n        config.pollTimer = null;\r\n\r\n        console.log(`[LiveComponent] Polling stopped: ${componentId}`);\r\n    }\r\n\r\n    // Note: getCSRFToken() removed - components now have their own tokens in data-csrf-token\r\n\r\n    /**\r\n     * Error handler\r\n     */\r\n    handleError(componentId, error) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        // Show error in component\r\n        const errorHtml = `\r\n            <div class=\"livecomponent-error\" style=\"padding: 1rem; background: #fee; color: #c00; border: 1px solid #faa; border-radius: 4px;\">\r\n                <strong>LiveComponent Error:</strong> ${error.message}\r\n            </div>\r\n        `;\r\n\r\n        config.element.insertAdjacentHTML('beforeend', errorHtml);\r\n\r\n        // Auto-remove error after 5 seconds\r\n        setTimeout(() => {\r\n            config.element.querySelector('.livecomponent-error')?.remove();\r\n        }, 5000);\r\n    }\r\n\r\n    /**\r\n     * Show conflict notification\r\n     *\r\n     * Displays a user-friendly notification when version conflicts occur during optimistic updates.\r\n     *\r\n     * @param {string} componentId - Component identifier\r\n     * @param {Object} notification - Notification object from OptimisticStateManager\r\n     */\r\n    showConflictNotification(componentId, notification) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        // Create conflict notification HTML\r\n        const notificationHtml = `\r\n            <div class=\"livecomponent-conflict\" style=\"\r\n                padding: 1rem;\r\n                background: #fff3cd;\r\n                color: #856404;\r\n                border: 1px solid #ffc107;\r\n                border-radius: 4px;\r\n                margin-bottom: 1rem;\r\n                display: flex;\r\n                align-items: center;\r\n                justify-content: space-between;\r\n            \">\r\n                <div>\r\n                    <strong>${notification.title}</strong>\r\n                    <p style=\"margin: 0.5rem 0 0 0;\">${notification.message}</p>\r\n                </div>\r\n                ${notification.canRetry ? `\r\n                    <button\r\n                        class=\"livecomponent-retry\"\r\n                        style=\"\r\n                            padding: 0.5rem 1rem;\r\n                            background: #ffc107;\r\n                            color: #000;\r\n                            border: none;\r\n                            border-radius: 4px;\r\n                            cursor: pointer;\r\n                            margin-left: 1rem;\r\n                        \"\r\n                        data-operation-id=\"${notification.operation.id}\"\r\n                        data-action=\"${notification.operation.metadata.action}\"\r\n                    >\r\n                        Retry\r\n                    </button>\r\n                ` : ''}\r\n            </div>\r\n        `;\r\n\r\n        // Insert notification at the top of component\r\n        config.element.insertAdjacentHTML('afterbegin', notificationHtml);\r\n\r\n        // Setup retry button if applicable\r\n        if (notification.canRetry) {\r\n            const retryButton = config.element.querySelector('.livecomponent-retry');\r\n            if (retryButton) {\r\n                retryButton.addEventListener('click', async () => {\r\n                    // Remove notification\r\n                    config.element.querySelector('.livecomponent-conflict')?.remove();\r\n\r\n                    // Retry the operation\r\n                    await optimisticStateManager.retryOperation(\r\n                        componentId,\r\n                        notification.operation,\r\n                        async (metadata) => {\r\n                            return await this.executeAction(\r\n                                componentId,\r\n                                metadata.action,\r\n                                metadata.params\r\n                            );\r\n                        }\r\n                    );\r\n                });\r\n            }\r\n        }\r\n\r\n        // Auto-remove notification after 8 seconds\r\n        setTimeout(() => {\r\n            config.element.querySelector('.livecomponent-conflict')?.remove();\r\n        }, 8000);\r\n\r\n        console.log(`[LiveComponent] Conflict notification shown for ${componentId}`, notification);\r\n    }\r\n\r\n    /**\r\n     * Setup file upload handlers\r\n     */\r\n    setupFileUploadHandlers(element) {\r\n        const componentId = element.dataset.liveComponent;\r\n\r\n        // Setup file input handlers\r\n        element.querySelectorAll('input[type=\"file\"][data-live-upload]').forEach(input => {\r\n            input.addEventListener('change', async (e) => {\r\n                const files = e.target.files;\r\n                if (files.length > 0) {\r\n                    await this.uploadFile(componentId, files[0]);\r\n                }\r\n            });\r\n        });\r\n\r\n        // Setup drag & drop zones\r\n        element.querySelectorAll('[data-live-dropzone]').forEach(dropzone => {\r\n            this.setupDropzone(componentId, dropzone);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Setup drag & drop zone\r\n     */\r\n    setupDropzone(componentId, dropzone) {\r\n        // Prevent default drag behaviors\r\n        ['dragenter', 'dragover', 'dragleave', 'drop'].forEach(eventName => {\r\n            dropzone.addEventListener(eventName, (e) => {\r\n                e.preventDefault();\r\n                e.stopPropagation();\r\n            });\r\n        });\r\n\r\n        // Highlight drop zone on drag over\r\n        ['dragenter', 'dragover'].forEach(eventName => {\r\n            dropzone.addEventListener(eventName, () => {\r\n                dropzone.classList.add('drag-over');\r\n            });\r\n        });\r\n\r\n        ['dragleave', 'drop'].forEach(eventName => {\r\n            dropzone.addEventListener(eventName, () => {\r\n                dropzone.classList.remove('drag-over');\r\n            });\r\n        });\r\n\r\n        // Handle file drop\r\n        dropzone.addEventListener('drop', async (e) => {\r\n            const files = e.dataTransfer.files;\r\n            if (files.length > 0) {\r\n                await this.uploadFile(componentId, files[0]);\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Upload file to component\r\n     */\r\n    async uploadFile(componentId, file, params = {}) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) {\r\n            console.error(`[LiveComponent] Unknown component: ${componentId}`);\r\n            return;\r\n        }\r\n\r\n        try {\r\n            // Get current state\r\n            const stateJson = config.element.dataset.state || '{}';\r\n            const state = JSON.parse(stateJson);\r\n\r\n            // Create FormData for file upload\r\n            const formData = new FormData();\r\n            formData.append('file', file);\r\n            formData.append('state', JSON.stringify(state));\r\n            formData.append('params', JSON.stringify(params));\r\n\r\n            // Get component-specific CSRF token\r\n            const csrfToken = config.element.dataset.csrfToken;\r\n            if (!csrfToken) {\r\n                console.error(`[LiveComponent] Missing CSRF token for upload: ${componentId}`);\r\n                throw new Error('CSRF token is required for file uploads');\r\n            }\r\n\r\n            // Add CSRF token to form data\r\n            formData.append('_csrf_token', csrfToken);\r\n\r\n            // Show upload progress (optional)\r\n            this.showUploadProgress(componentId, 0);\r\n\r\n            // Send upload request\r\n            const response = await fetch(`/live-component/${componentId}/upload`, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'X-Requested-With': 'XMLHttpRequest'\r\n                },\r\n                body: formData\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorData = await response.json();\r\n                throw new Error(errorData.error || 'Upload failed');\r\n            }\r\n\r\n            const data = await response.json();\r\n\r\n            if (!data.success) {\r\n                throw new Error(data.error || 'Upload failed');\r\n            }\r\n\r\n            // Update component HTML\r\n            if (data.html) {\r\n                config.element.innerHTML = data.html;\r\n                this.setupActionHandlers(config.element);\r\n                this.setupFileUploadHandlers(config.element);\r\n            }\r\n\r\n            // Update component state using StateSerializer\r\n            if (data.state) {\r\n                StateSerializer.setStateOnElement(config.element, data.state);\r\n            }\r\n\r\n            // Handle server events\r\n            if (data.events && data.events.length > 0) {\r\n                this.handleServerEvents(data.events);\r\n            }\r\n\r\n            // Hide upload progress\r\n            this.hideUploadProgress(componentId);\r\n\r\n            console.log(`[LiveComponent] File uploaded: ${componentId}`, data.file);\r\n\r\n            // Dispatch upload success event\r\n            document.dispatchEvent(new CustomEvent('livecomponent:upload:success', {\r\n                detail: { componentId, file: data.file }\r\n            }));\r\n\r\n        } catch (error) {\r\n            console.error(`[LiveComponent] Upload failed:`, error);\r\n            this.hideUploadProgress(componentId);\r\n            this.handleError(componentId, error);\r\n\r\n            // Dispatch upload error event\r\n            document.dispatchEvent(new CustomEvent('livecomponent:upload:error', {\r\n                detail: { componentId, error: error.message }\r\n            }));\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Show upload progress indicator\r\n     */\r\n    showUploadProgress(componentId, percent) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        let progressEl = config.element.querySelector('.livecomponent-upload-progress');\r\n\r\n        if (!progressEl) {\r\n            progressEl = document.createElement('div');\r\n            progressEl.className = 'livecomponent-upload-progress';\r\n            progressEl.style.cssText = `\r\n                position: absolute;\r\n                top: 0;\r\n                left: 0;\r\n                right: 0;\r\n                height: 3px;\r\n                background: #e0e0e0;\r\n                z-index: 1000;\r\n            `;\r\n\r\n            const bar = document.createElement('div');\r\n            bar.className = 'progress-bar';\r\n            bar.style.cssText = `\r\n                height: 100%;\r\n                background: #2196F3;\r\n                transition: width 0.3s ease;\r\n                width: ${percent}%;\r\n            `;\r\n\r\n            progressEl.appendChild(bar);\r\n            config.element.style.position = 'relative';\r\n            config.element.appendChild(progressEl);\r\n        } else {\r\n            const bar = progressEl.querySelector('.progress-bar');\r\n            bar.style.width = `${percent}%`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Hide upload progress indicator\r\n     */\r\n    hideUploadProgress(componentId) {\r\n        const config = this.components.get(componentId);\r\n        if (!config) return;\r\n\r\n        const progressEl = config.element.querySelector('.livecomponent-upload-progress');\r\n        if (progressEl) {\r\n            progressEl.remove();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Destroy component instance\r\n     * Clean up timers, observers, event handlers, SSE connections, and accessibility features\r\n     */\r\n    destroy(componentId) {\r\n        const config = this.components.get(componentId);\r\n\r\n        // Stop polling\r\n        this.stopPolling(componentId);\r\n\r\n        // Disconnect MutationObserver\r\n        if (config && config.observer) {\r\n            config.observer.disconnect();\r\n        }\r\n\r\n        // Cleanup SSE connection\r\n        this.cleanupSseConnection(componentId);\r\n\r\n        // Cleanup accessibility features\r\n        this.accessibilityManager.cleanup(componentId);\r\n\r\n        // Cleanup error handler\r\n        this.errorBoundary.clearErrorHandler(componentId);\r\n\r\n        // Cleanup request deduplication\r\n        this.requestDeduplicator.clearComponent(componentId);\r\n\r\n        // Cleanup tooltips\r\n        this.tooltipManager.cleanupComponent(config.element);\r\n\r\n        // Hide any active loading states\r\n        this.loadingStateManager.hideLoading(componentId);\r\n        this.loadingStateManager.clearConfig(componentId);\r\n\r\n        // Cleanup UI components\r\n        this.uiHelper.cleanup(componentId);\r\n\r\n        // Remove from registry\r\n        this.components.delete(componentId);\r\n\r\n        // Remove event handlers for this component\r\n        this.eventHandlers.forEach((handlers, eventName) => {\r\n            const filtered = handlers.filter(h => h.componentId !== componentId);\r\n            this.eventHandlers.set(eventName, filtered);\r\n        });\r\n\r\n        console.log(`[LiveComponent] Destroyed: ${componentId}`);\r\n    }\r\n\r\n    /**\r\n     * Cleanup SSE connection when component is destroyed\r\n     */\r\n    cleanupSseConnection(componentId) {\r\n        const channel = this.componentChannels.get(componentId);\r\n        if (!channel) {\r\n            return; // No SSE connection for this component\r\n        }\r\n\r\n        // Remove component-channel mapping\r\n        this.componentChannels.delete(componentId);\r\n\r\n        // Check if any other components are using this channel\r\n        let channelStillInUse = false;\r\n        for (const [, componentChannel] of this.componentChannels) {\r\n            if (componentChannel === channel) {\r\n                channelStillInUse = true;\r\n                break;\r\n            }\r\n        }\r\n\r\n        // If no other components use this channel, disconnect the SSE client\r\n        if (!channelStillInUse) {\r\n            const sseClient = this.sseClients.get(channel);\r\n            if (sseClient) {\r\n                sseClient.disconnect();\r\n                this.sseClients.delete(channel);\r\n                console.log(`[LiveComponent] Disconnected SSE client for channel: ${channel}`);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Execute batch of operations\r\n     *\r\n     * Sends multiple component actions in a single HTTP request.\r\n     * Reduces HTTP overhead by 60-80% for multi-component updates.\r\n     *\r\n     * @param {Array<Object>} operations - Array of operation objects\r\n     * @param {Object} options - Batch options\r\n     * @returns {Promise<Object>} Batch response with results\r\n     *\r\n     * Example:\r\n     * await LiveComponent.executeBatch([\r\n     *   {\r\n     *     componentId: 'counter:demo',\r\n     *     method: 'increment',\r\n     *     params: { amount: 5 },\r\n     *     fragments: ['counter-display'],\r\n     *     operationId: 'op-1'\r\n     *   },\r\n     *   {\r\n     *     componentId: 'user-stats:123',\r\n     *     method: 'refresh',\r\n     *     operationId: 'op-2'\r\n     *   }\r\n     * ]);\r\n     */\r\n    async executeBatch(operations, options = {}) {\r\n        if (!Array.isArray(operations) || operations.length === 0) {\r\n            throw new Error('Operations must be a non-empty array');\r\n        }\r\n\r\n        // Build batch request\r\n        const batchRequest = {\r\n            operations: operations.map(op => ({\r\n                componentId: op.componentId,\r\n                method: op.method,\r\n                params: op.params || {},\r\n                fragments: op.fragments || null,\r\n                operationId: op.operationId || null\r\n            }))\r\n        };\r\n\r\n        console.log(`[LiveComponent] Executing batch with ${operations.length} operations`, batchRequest);\r\n\r\n        try {\r\n            const response = await fetch('/live-component/batch', {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    'Accept': 'application/json'\r\n                },\r\n                body: JSON.stringify(batchRequest)\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorData = await response.json();\r\n                throw new Error(errorData.error || 'Batch request failed');\r\n            }\r\n\r\n            const batchResponse = await response.json();\r\n\r\n            console.log(`[LiveComponent] Batch completed: ${batchResponse.success_count} succeeded, ${batchResponse.failure_count} failed`);\r\n\r\n            // Process results and update components\r\n            if (options.autoApply !== false) {\r\n                await this.applyBatchResults(batchResponse.results);\r\n            }\r\n\r\n            return batchResponse;\r\n\r\n        } catch (error) {\r\n            console.error('[LiveComponent] Batch execution failed:', error);\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Apply batch results to components\r\n     *\r\n     * Updates component HTML/fragments and state based on batch response.\r\n     *\r\n     * @param {Array<Object>} results - Batch results array\r\n     */\r\n    async applyBatchResults(results) {\r\n        for (const result of results) {\r\n            if (!result.success) {\r\n                console.warn(`[LiveComponent] Batch operation failed:`, result);\r\n                continue;\r\n            }\r\n\r\n            // Extract componentId from operationId or results\r\n            // (We need to track which component each result belongs to)\r\n            const componentId = result.componentId || this.extractComponentIdFromResult(result);\r\n            if (!componentId) continue;\r\n\r\n            const config = this.components.get(componentId);\r\n            if (!config) continue;\r\n\r\n            try {\r\n                // Update fragments if present\r\n                if (result.fragments) {\r\n                    this.updateFragments(config.element, result.fragments);\r\n                }\r\n                // Update full HTML if present\r\n                else if (result.html) {\r\n                    config.element.innerHTML = result.html;\r\n                    this.setupActionHandlers(config.element);\r\n                }\r\n\r\n                // Update state using StateSerializer\r\n                if (result.state) {\r\n                    StateSerializer.setStateOnElement(config.element, result.state);\r\n                }\r\n\r\n                // Dispatch events\r\n                if (result.events && Array.isArray(result.events)) {\r\n                    result.events.forEach(event => {\r\n                        this.dispatchComponentEvent(componentId, event.name, event.payload || {});\r\n                    });\r\n                }\r\n\r\n            } catch (error) {\r\n                console.error(`[LiveComponent] Failed to apply batch result for ${componentId}:`, error);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Helper to extract component ID from batch result\r\n     * (Since we don't store componentId in result, we need to track it)\r\n     */\r\n    extractComponentIdFromResult(result) {\r\n        // This is a placeholder - in production you'd track componentId per operation\r\n        // For now, we rely on the caller to provide componentId in custom data\r\n        return result.componentId || null;\r\n    }\r\n\r\n    /**\r\n     * Queue batch operation\r\n     *\r\n     * Allows batching multiple operations with automatic flush.\r\n     * Useful for collecting multiple updates that happen close together.\r\n     *\r\n     * @param {Object} operation - Operation to queue\r\n     * @param {Object} options - Queue options (flushDelay)\r\n     */\r\n    queueBatchOperation(operation, options = {}) {\r\n        if (!this.batchQueue) {\r\n            this.batchQueue = [];\r\n            this.batchQueueTimer = null;\r\n        }\r\n\r\n        this.batchQueue.push(operation);\r\n\r\n        // Clear existing timer\r\n        if (this.batchQueueTimer) {\r\n            clearTimeout(this.batchQueueTimer);\r\n        }\r\n\r\n        // Auto-flush after delay\r\n        const flushDelay = options.flushDelay || 50; // 50ms default\r\n        this.batchQueueTimer = setTimeout(() => {\r\n            this.flushBatchQueue();\r\n        }, flushDelay);\r\n    }\r\n\r\n    /**\r\n     * Flush batch queue\r\n     *\r\n     * Executes all queued operations in a single batch request.\r\n     */\r\n    async flushBatchQueue() {\r\n        if (!this.batchQueue || this.batchQueue.length === 0) {\r\n            return;\r\n        }\r\n\r\n        const operations = [...this.batchQueue];\r\n        this.batchQueue = [];\r\n        this.batchQueueTimer = null;\r\n\r\n        try {\r\n            await this.executeBatch(operations);\r\n        } catch (error) {\r\n            console.error('[LiveComponent] Batch queue flush failed:', error);\r\n        }\r\n    }\r\n}\r\n\r\n// Create global LiveComponent instance\r\nconst LiveComponent = new LiveComponentManager();\r\n\r\n// Make LiveComponent globally accessible\r\nwindow.LiveComponent = LiveComponent;\r\n\r\n// Auto-initialize on DOM ready\r\nif (document.readyState === 'loading') {\r\n    document.addEventListener('DOMContentLoaded', () => {\r\n        document.querySelectorAll('[data-live-component]').forEach(el => {\r\n            LiveComponent.init(el);\r\n        });\r\n    });\r\n}\r\n\r\n// Framework module definition\r\nexport const definition = {\r\n    name: 'livecomponent',\r\n    version: '1.0.0',\r\n    dependencies: [],\r\n    provides: ['LiveComponent'],\r\n    priority: 0\r\n};\r\n\r\n// Framework module initialization (global setup)\r\nexport async function init(config = {}, state = {}) {\r\n    console.log('[LiveComponent] Module initializing...');\r\n\r\n    // Initialize Accessibility Manager (global live regions)\r\n    accessibilityManager.initialize();\r\n\r\n    // Initialize Lazy Loading system first\r\n    LiveComponent.initLazyLoading();\r\n\r\n    // Initialize Nested Components system\r\n    LiveComponent.initNestedComponents();\r\n\r\n    // Initialize all regular LiveComponents in the page\r\n    // This is needed when loaded as a core module (not via data-module attributes)\r\n    const components = document.querySelectorAll('[data-live-component]');\r\n    console.log(`[LiveComponent] Found ${components.length} regular components to initialize`);\r\n\r\n    components.forEach(el => {\r\n        LiveComponent.init(el);\r\n    });\r\n\r\n    // Lazy components are automatically initialized by LazyComponentLoader\r\n    const lazyComponents = document.querySelectorAll('[data-live-component-lazy]');\r\n    console.log(`[LiveComponent] Found ${lazyComponents.length} lazy components (will load on demand)`);\r\n\r\n    // Log nested component stats\r\n    if (LiveComponent.nestedHandler) {\r\n        const stats = LiveComponent.nestedHandler.getStats();\r\n        console.log(`[LiveComponent] Nested components: ${stats.child_components} children across ${stats.root_components} roots (max depth: ${stats.max_nesting_depth})`);\r\n    }\r\n\r\n    // Log accessibility stats\r\n    const a11yStats = accessibilityManager.getStats();\r\n    console.log(`[LiveComponent] Accessibility: ${a11yStats.component_live_regions} component regions, ${a11yStats.tracked_focus_states} tracked focus states`);\r\n\r\n    console.log('[LiveComponent] Module initialized');\r\n\r\n    return {\r\n        manager: LiveComponent,\r\n        state\r\n    };\r\n}\r\n\r\n// Framework DOM element initialization (called by framework for data-module elements)\r\nexport function initElement(element, options = {}) {\r\n    console.log('[LiveComponent] Initializing element with data-module:', element);\r\n\r\n    // Find all LiveComponents within this element (or the element itself)\r\n    const components = element.querySelectorAll('[data-live-component]');\r\n\r\n    if (components.length === 0 && element.hasAttribute('data-live-component')) {\r\n        // Element itself is a LiveComponent\r\n        LiveComponent.init(element);\r\n    } else {\r\n        // Initialize all child LiveComponents\r\n        components.forEach(el => LiveComponent.init(el));\r\n    }\r\n\r\n    return LiveComponent;\r\n}\r\n\r\n// Export LiveComponent class for direct use\r\nexport { LiveComponent };\r\nexport { ComponentPlayground };\r\nexport { ComponentFileUploader } from './ComponentFileUploader.js';\r\nexport { FileUploadWidget } from './FileUploadWidget.js';\r\nexport { ChunkedUploader } from './ChunkedUploader.js';\r\n\r\n// Export UI integration modules\r\nexport { tooltipManager } from './TooltipManager.js';\r\nexport { actionLoadingManager } from './ActionLoadingManager.js';\r\nexport { LiveComponentUIHelper } from './LiveComponentUIHelper.js';\r\nexport { LoadingStateManager } from './LoadingStateManager.js';\r\n\r\nexport default LiveComponent;\r\n","/**\r\n * ComponentPlayground\r\n *\r\n * Interactive development tool for LiveComponents.\r\n *\r\n * Features:\r\n * - Component browser with search and filtering\r\n * - Live component preview with auto-refresh\r\n * - JSON state editor with validation\r\n * - Action tester with parameter support\r\n * - Performance metrics visualization\r\n * - Template code generator\r\n *\r\n * Usage:\r\n * import { ComponentPlayground } from './modules/livecomponent/ComponentPlayground';\r\n *\r\n * const playground = new ComponentPlayground('#playground-container');\r\n * playground.init();\r\n */\r\n\r\nexport class ComponentPlayground {\r\n    /**\r\n     * @param {string} containerSelector - Container element selector\r\n     */\r\n    constructor(containerSelector) {\r\n        this.container = document.querySelector(containerSelector);\r\n        if (!this.container) {\r\n            throw new Error(`Container not found: ${containerSelector}`);\r\n        }\r\n\r\n        // State\r\n        this.components = [];\r\n        this.selectedComponent = null;\r\n        this.componentMetadata = null;\r\n        this.currentState = {};\r\n        this.previewInstanceId = `playground-${Date.now()}`;\r\n\r\n        // UI Elements (will be created in init())\r\n        this.componentList = null;\r\n        this.componentSearch = null;\r\n        this.stateEditor = null;\r\n        this.previewContainer = null;\r\n        this.actionTester = null;\r\n        this.metricsDisplay = null;\r\n\r\n        // Performance tracking\r\n        this.metrics = {\r\n            renderTime: 0,\r\n            stateSize: 0,\r\n            actionExecutions: 0\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Initialize playground\r\n     */\r\n    async init() {\r\n        this.buildUI();\r\n        await this.loadComponents();\r\n        this.attachEventListeners();\r\n    }\r\n\r\n    /**\r\n     * Build playground UI structure\r\n     */\r\n    buildUI() {\r\n        this.container.innerHTML = `\r\n            <div class=\"playground\">\r\n                <!-- Header -->\r\n                <header class=\"playground__header\">\r\n                    <h1 class=\"playground__title\">LiveComponent Playground</h1>\r\n                    <p class=\"playground__subtitle\">Interactive development tool for testing LiveComponents</p>\r\n                </header>\r\n\r\n                <!-- Main Layout -->\r\n                <div class=\"playground__layout\">\r\n                    <!-- Sidebar: Component Selector -->\r\n                    <aside class=\"playground__sidebar\">\r\n                        <div class=\"playground__search\">\r\n                            <input\r\n                                type=\"text\"\r\n                                id=\"component-search\"\r\n                                class=\"playground__search-input\"\r\n                                placeholder=\"Search components...\"\r\n                                autocomplete=\"off\"\r\n                            />\r\n                        </div>\r\n                        <div id=\"component-list\" class=\"playground__component-list\">\r\n                            <div class=\"playground__loading\">Loading components...</div>\r\n                        </div>\r\n                    </aside>\r\n\r\n                    <!-- Main Content -->\r\n                    <main class=\"playground__main\">\r\n                        <!-- State Editor -->\r\n                        <section class=\"playground__section\">\r\n                            <h2 class=\"playground__section-title\">Component State</h2>\r\n                            <div class=\"playground__state-editor\">\r\n                                <textarea\r\n                                    id=\"state-editor\"\r\n                                    class=\"playground__textarea\"\r\n                                    placeholder='{\\n  \"property\": \"value\"\\n}'\r\n                                    rows=\"10\"\r\n                                ></textarea>\r\n                                <div class=\"playground__editor-actions\">\r\n                                    <button id=\"apply-state\" class=\"playground__button playground__button--primary\">\r\n                                        Apply State\r\n                                    </button>\r\n                                    <button id=\"reset-state\" class=\"playground__button\">\r\n                                        Reset\r\n                                    </button>\r\n                                    <button id=\"format-json\" class=\"playground__button\">\r\n                                        Format JSON\r\n                                    </button>\r\n                                </div>\r\n                                <div id=\"state-validation\" class=\"playground__validation\"></div>\r\n                            </div>\r\n                        </section>\r\n\r\n                        <!-- Live Preview -->\r\n                        <section class=\"playground__section\">\r\n                            <h2 class=\"playground__section-title\">Live Preview</h2>\r\n                            <div id=\"preview-container\" class=\"playground__preview\">\r\n                                <div class=\"playground__empty\">\r\n                                    Select a component to preview\r\n                                </div>\r\n                            </div>\r\n                            <div id=\"metrics-display\" class=\"playground__metrics\"></div>\r\n                        </section>\r\n\r\n                        <!-- Action Tester -->\r\n                        <section class=\"playground__section\">\r\n                            <h2 class=\"playground__section-title\">Actions</h2>\r\n                            <div id=\"action-tester\" class=\"playground__actions\">\r\n                                <div class=\"playground__empty\">\r\n                                    Select a component to test actions\r\n                                </div>\r\n                            </div>\r\n                        </section>\r\n\r\n                        <!-- Code Generator -->\r\n                        <section class=\"playground__section\">\r\n                            <h2 class=\"playground__section-title\">Template Code</h2>\r\n                            <div class=\"playground__code-generator\">\r\n                                <pre id=\"generated-code\" class=\"playground__code\"><code>Select a component to generate code</code></pre>\r\n                                <button id=\"copy-code\" class=\"playground__button\">\r\n                                    Copy to Clipboard\r\n                                </button>\r\n                            </div>\r\n                        </section>\r\n                    </main>\r\n                </div>\r\n            </div>\r\n        `;\r\n\r\n        // Cache UI elements\r\n        this.componentList = this.container.querySelector('#component-list');\r\n        this.componentSearch = this.container.querySelector('#component-search');\r\n        this.stateEditor = this.container.querySelector('#state-editor');\r\n        this.previewContainer = this.container.querySelector('#preview-container');\r\n        this.actionTester = this.container.querySelector('#action-tester');\r\n        this.metricsDisplay = this.container.querySelector('#metrics-display');\r\n    }\r\n\r\n    /**\r\n     * Load all available components\r\n     */\r\n    async loadComponents() {\r\n        try {\r\n            const response = await fetch('/playground/api/components');\r\n            const data = await response.json();\r\n\r\n            this.components = data.components || [];\r\n            this.renderComponentList(this.components);\r\n        } catch (error) {\r\n            this.componentList.innerHTML = `\r\n                <div class=\"playground__error\">\r\n                    Failed to load components: ${error.message}\r\n                </div>\r\n            `;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render component list\r\n     */\r\n    renderComponentList(components) {\r\n        if (components.length === 0) {\r\n            this.componentList.innerHTML = '<div class=\"playground__empty\">No components found</div>';\r\n            return;\r\n        }\r\n\r\n        this.componentList.innerHTML = components.map(component => `\r\n            <div class=\"playground__component-item\" data-component=\"${component.name}\">\r\n                <div class=\"playground__component-name\">${component.name}</div>\r\n                <div class=\"playground__component-meta\">\r\n                    <span class=\"playground__badge\">${component.properties} props</span>\r\n                    <span class=\"playground__badge\">${component.actions} actions</span>\r\n                    ${component.has_cache ? '<span class=\"playground__badge playground__badge--cache\">cached</span>' : ''}\r\n                </div>\r\n            </div>\r\n        `).join('');\r\n    }\r\n\r\n    /**\r\n     * Attach event listeners\r\n     */\r\n    attachEventListeners() {\r\n        // Component selection\r\n        this.componentList.addEventListener('click', (e) => {\r\n            const item = e.target.closest('.playground__component-item');\r\n            if (item) {\r\n                this.selectComponent(item.dataset.component);\r\n            }\r\n        });\r\n\r\n        // Component search\r\n        this.componentSearch.addEventListener('input', (e) => {\r\n            this.filterComponents(e.target.value);\r\n        });\r\n\r\n        // State editor actions\r\n        this.container.querySelector('#apply-state').addEventListener('click', () => {\r\n            this.applyState();\r\n        });\r\n\r\n        this.container.querySelector('#reset-state').addEventListener('click', () => {\r\n            this.resetState();\r\n        });\r\n\r\n        this.container.querySelector('#format-json').addEventListener('click', () => {\r\n            this.formatJSON();\r\n        });\r\n\r\n        // Copy code\r\n        this.container.querySelector('#copy-code').addEventListener('click', () => {\r\n            this.copyCode();\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Filter components by search term\r\n     */\r\n    filterComponents(searchTerm) {\r\n        const term = searchTerm.toLowerCase().trim();\r\n\r\n        if (!term) {\r\n            this.renderComponentList(this.components);\r\n            return;\r\n        }\r\n\r\n        const filtered = this.components.filter(component =>\r\n            component.name.toLowerCase().includes(term) ||\r\n            component.class.toLowerCase().includes(term)\r\n        );\r\n\r\n        this.renderComponentList(filtered);\r\n    }\r\n\r\n    /**\r\n     * Select component\r\n     */\r\n    async selectComponent(componentName) {\r\n        // Update active state\r\n        this.componentList.querySelectorAll('.playground__component-item').forEach(item => {\r\n            item.classList.remove('playground__component-item--active');\r\n        });\r\n\r\n        const selectedItem = this.componentList.querySelector(`[data-component=\"${componentName}\"]`);\r\n        if (selectedItem) {\r\n            selectedItem.classList.add('playground__component-item--active');\r\n        }\r\n\r\n        this.selectedComponent = componentName;\r\n\r\n        // Load metadata\r\n        await this.loadComponentMetadata(componentName);\r\n\r\n        // Reset state\r\n        this.resetState();\r\n\r\n        // Render actions\r\n        this.renderActions();\r\n\r\n        // Generate code\r\n        this.updateGeneratedCode();\r\n    }\r\n\r\n    /**\r\n     * Load component metadata\r\n     */\r\n    async loadComponentMetadata(componentName) {\r\n        try {\r\n            const response = await fetch(`/playground/api/component/${componentName}`);\r\n            const data = await response.json();\r\n\r\n            if (data.success) {\r\n                this.componentMetadata = data.data;\r\n            } else {\r\n                console.error('Failed to load metadata:', data.error);\r\n            }\r\n        } catch (error) {\r\n            console.error('Error loading metadata:', error);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Apply state from editor\r\n     */\r\n    async applyState() {\r\n        const jsonText = this.stateEditor.value.trim();\r\n        const validationEl = this.container.querySelector('#state-validation');\r\n\r\n        // Validate JSON\r\n        try {\r\n            const state = jsonText ? JSON.parse(jsonText) : {};\r\n            this.currentState = state;\r\n\r\n            validationEl.innerHTML = '<span class=\"playground__success\">✓ Valid JSON</span>';\r\n\r\n            // Preview component with new state\r\n            await this.previewComponent();\r\n        } catch (error) {\r\n            validationEl.innerHTML = `<span class=\"playground__error\">✗ Invalid JSON: ${error.message}</span>`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reset state to default\r\n     */\r\n    resetState() {\r\n        this.currentState = {};\r\n        this.stateEditor.value = '{}';\r\n        this.container.querySelector('#state-validation').innerHTML = '';\r\n\r\n        if (this.selectedComponent) {\r\n            this.previewComponent();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Format JSON in editor\r\n     */\r\n    formatJSON() {\r\n        try {\r\n            const json = JSON.parse(this.stateEditor.value || '{}');\r\n            this.stateEditor.value = JSON.stringify(json, null, 2);\r\n            this.container.querySelector('#state-validation').innerHTML = '<span class=\"playground__success\">✓ Formatted</span>';\r\n        } catch (error) {\r\n            this.container.querySelector('#state-validation').innerHTML = `<span class=\"playground__error\">✗ Invalid JSON</span>`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Preview component with current state\r\n     */\r\n    async previewComponent() {\r\n        if (!this.selectedComponent) return;\r\n\r\n        this.previewContainer.innerHTML = '<div class=\"playground__loading\">Loading preview...</div>';\r\n\r\n        try {\r\n            const startTime = performance.now();\r\n\r\n            const response = await fetch('/playground/api/preview', {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json'\r\n                },\r\n                body: JSON.stringify({\r\n                    component_name: this.selectedComponent,\r\n                    state: this.currentState,\r\n                    instance_id: this.previewInstanceId\r\n                })\r\n            });\r\n\r\n            const data = await response.json();\r\n            const endTime = performance.now();\r\n\r\n            if (data.success) {\r\n                this.previewContainer.innerHTML = data.html;\r\n\r\n                // Update metrics\r\n                this.metrics.renderTime = data.render_time_ms;\r\n                this.metrics.stateSize = JSON.stringify(data.state).length;\r\n                this.updateMetrics();\r\n\r\n                // Initialize LiveComponent in preview\r\n                if (window.LiveComponent) {\r\n                    window.LiveComponent.initComponent(this.previewContainer.firstElementChild);\r\n                }\r\n            } else {\r\n                this.previewContainer.innerHTML = `\r\n                    <div class=\"playground__error\">\r\n                        Preview failed: ${data.error}\r\n                    </div>\r\n                `;\r\n            }\r\n        } catch (error) {\r\n            this.previewContainer.innerHTML = `\r\n                <div class=\"playground__error\">\r\n                    Error: ${error.message}\r\n                </div>\r\n            `;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render actions for selected component\r\n     */\r\n    renderActions() {\r\n        if (!this.componentMetadata || !this.componentMetadata.actions) {\r\n            this.actionTester.innerHTML = '<div class=\"playground__empty\">No actions available</div>';\r\n            return;\r\n        }\r\n\r\n        const actions = this.componentMetadata.actions.filter(action =>\r\n            !['onMount', 'onUpdated', 'onDestroy'].includes(action.name)\r\n        );\r\n\r\n        if (actions.length === 0) {\r\n            this.actionTester.innerHTML = '<div class=\"playground__empty\">No actions available</div>';\r\n            return;\r\n        }\r\n\r\n        this.actionTester.innerHTML = actions.map(action => `\r\n            <div class=\"playground__action\">\r\n                <button\r\n                    class=\"playground__button playground__button--action\"\r\n                    data-action=\"${action.name}\"\r\n                >\r\n                    ${action.name}()\r\n                </button>\r\n                ${action.parameters.length > 0 ? `\r\n                    <div class=\"playground__action-params\">\r\n                        ${action.parameters.map(param => `\r\n                            <label>\r\n                                ${param.name} (${param.type}):\r\n                                <input type=\"text\" data-param=\"${param.name}\" placeholder=\"${param.type}\" />\r\n                            </label>\r\n                        `).join('')}\r\n                    </div>\r\n                ` : ''}\r\n            </div>\r\n        `).join('');\r\n\r\n        // Attach action button listeners\r\n        this.actionTester.querySelectorAll('[data-action]').forEach(button => {\r\n            button.addEventListener('click', () => {\r\n                this.executeAction(button.dataset.action, button.closest('.playground__action'));\r\n            });\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Execute component action\r\n     */\r\n    async executeAction(actionName, actionElement) {\r\n        // Get parameters\r\n        const parameters = {};\r\n        if (actionElement) {\r\n            actionElement.querySelectorAll('[data-param]').forEach(input => {\r\n                const paramName = input.dataset.param;\r\n                let value = input.value;\r\n\r\n                // Try to parse as number or boolean\r\n                if (value === 'true') value = true;\r\n                else if (value === 'false') value = false;\r\n                else if (!isNaN(value) && value !== '') value = Number(value);\r\n\r\n                parameters[paramName] = value;\r\n            });\r\n        }\r\n\r\n        try {\r\n            const response = await fetch('/playground/api/action', {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json'\r\n                },\r\n                body: JSON.stringify({\r\n                    component_id: `${this.selectedComponent}:${this.previewInstanceId}`,\r\n                    action_name: actionName,\r\n                    parameters: parameters,\r\n                    current_state: this.currentState\r\n                })\r\n            });\r\n\r\n            const data = await response.json();\r\n\r\n            if (data.success) {\r\n                // Update current state\r\n                this.currentState = data.new_state;\r\n                this.stateEditor.value = JSON.stringify(this.currentState, null, 2);\r\n\r\n                // Update preview\r\n                this.previewContainer.innerHTML = data.html;\r\n\r\n                // Update metrics\r\n                this.metrics.actionExecutions++;\r\n                this.updateMetrics();\r\n\r\n                // Re-initialize LiveComponent\r\n                if (window.LiveComponent) {\r\n                    window.LiveComponent.initComponent(this.previewContainer.firstElementChild);\r\n                }\r\n            } else {\r\n                alert(`Action failed: ${data.error}`);\r\n            }\r\n        } catch (error) {\r\n            alert(`Error executing action: ${error.message}`);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Update metrics display\r\n     */\r\n    updateMetrics() {\r\n        this.metricsDisplay.innerHTML = `\r\n            <div class=\"playground__metrics-grid\">\r\n                <div class=\"playground__metric\">\r\n                    <span class=\"playground__metric-label\">Render Time</span>\r\n                    <span class=\"playground__metric-value\">${this.metrics.renderTime.toFixed(2)}ms</span>\r\n                </div>\r\n                <div class=\"playground__metric\">\r\n                    <span class=\"playground__metric-label\">State Size</span>\r\n                    <span class=\"playground__metric-value\">${this.metrics.stateSize} bytes</span>\r\n                </div>\r\n                <div class=\"playground__metric\">\r\n                    <span class=\"playground__metric-label\">Actions Executed</span>\r\n                    <span class=\"playground__metric-value\">${this.metrics.actionExecutions}</span>\r\n                </div>\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Update generated template code\r\n     */\r\n    updateGeneratedCode() {\r\n        if (!this.selectedComponent) return;\r\n\r\n        const code = `<!-- Use in your template -->\\n{{{ ${this.selectedComponent} }}}`;\r\n\r\n        this.container.querySelector('#generated-code code').textContent = code;\r\n    }\r\n\r\n    /**\r\n     * Copy generated code to clipboard\r\n     */\r\n    async copyCode() {\r\n        const code = this.container.querySelector('#generated-code code').textContent;\r\n\r\n        try {\r\n            await navigator.clipboard.writeText(code);\r\n            const button = this.container.querySelector('#copy-code');\r\n            const originalText = button.textContent;\r\n            button.textContent = '✓ Copied!';\r\n            setTimeout(() => {\r\n                button.textContent = originalText;\r\n            }, 2000);\r\n        } catch (error) {\r\n            alert('Failed to copy code to clipboard');\r\n        }\r\n    }\r\n}\r\n\r\nexport default ComponentPlayground;\r\n","/**\r\n * FileUploadWidget - Pre-built UI Component for File Uploads in LiveComponents\r\n *\r\n * Provides a complete upload interface with:\r\n * - Drag & Drop zone\r\n * - File list with thumbnails\r\n * - Progress bars\r\n * - File validation feedback\r\n * - Remove/cancel capabilities\r\n *\r\n * @package Framework\\LiveComponents\r\n */\r\n\r\nimport { ComponentFileUploader } from './ComponentFileUploader.js';\r\n\r\n/**\r\n * FileUploadWidget - Ready-to-use Upload UI\r\n */\r\nexport class FileUploadWidget {\r\n    constructor(containerElement, options = {}) {\r\n        this.container = containerElement;\r\n        this.componentElement = containerElement.closest('[data-live-id]');\r\n\r\n        if (!this.componentElement) {\r\n            throw new Error('FileUploadWidget must be used inside a LiveComponent');\r\n        }\r\n\r\n        // Widget options\r\n        this.options = {\r\n            maxFileSize: options.maxFileSize || 10 * 1024 * 1024,\r\n            allowedMimeTypes: options.allowedMimeTypes || [],\r\n            allowedExtensions: options.allowedExtensions || [],\r\n            maxFiles: options.maxFiles || 10,\r\n            showPreviews: options.showPreviews !== false,\r\n            showProgress: options.showProgress !== false,\r\n            showFileList: options.showFileList !== false,\r\n            autoUpload: options.autoUpload !== false,\r\n            multiple: options.multiple !== false,\r\n            dropZoneText: options.dropZoneText || 'Drag & drop files here or click to browse',\r\n            browseButtonText: options.browseButtonText || 'Browse Files',\r\n            uploadButtonText: options.uploadButtonText || 'Upload All',\r\n            ...options\r\n        };\r\n\r\n        this.files = new Map(); // Map<fileId, FileUIElement>\r\n\r\n        this.buildUI();\r\n        this.initializeUploader();\r\n    }\r\n\r\n    /**\r\n     * Build the widget UI\r\n     */\r\n    buildUI() {\r\n        // Create widget structure\r\n        this.container.innerHTML = `\r\n            <div class=\"file-upload-widget\">\r\n                <!-- Drop Zone -->\r\n                <div class=\"file-upload-dropzone\" data-dropzone>\r\n                    <div class=\"dropzone-content\">\r\n                        <svg class=\"dropzone-icon\" width=\"48\" height=\"48\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\">\r\n                            <path d=\"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4\"></path>\r\n                            <polyline points=\"17 8 12 3 7 8\"></polyline>\r\n                            <line x1=\"12\" y1=\"3\" x2=\"12\" y2=\"15\"></line>\r\n                        </svg>\r\n                        <p class=\"dropzone-text\">${this.options.dropZoneText}</p>\r\n                        <button type=\"button\" class=\"btn btn-primary dropzone-button\" data-browse-button>\r\n                            ${this.options.browseButtonText}\r\n                        </button>\r\n                        <input\r\n                            type=\"file\"\r\n                            class=\"dropzone-input\"\r\n                            data-file-input\r\n                            ${this.options.multiple ? 'multiple' : ''}\r\n                            ${this.options.allowedMimeTypes.length > 0 ? `accept=\"${this.options.allowedMimeTypes.join(',')}\"` : ''}\r\n                            style=\"display: none;\"\r\n                        />\r\n                    </div>\r\n                </div>\r\n\r\n                <!-- File List -->\r\n                ${this.options.showFileList ? `\r\n                <div class=\"file-upload-list\" data-file-list style=\"display: none;\">\r\n                    <div class=\"file-list-header\">\r\n                        <h4>Files (0)</h4>\r\n                        <div class=\"file-list-actions\">\r\n                            ${!this.options.autoUpload ? `<button type=\"button\" class=\"btn btn-primary btn-sm\" data-upload-all>${this.options.uploadButtonText}</button>` : ''}\r\n                            <button type=\"button\" class=\"btn btn-secondary btn-sm\" data-clear-all>Clear All</button>\r\n                        </div>\r\n                    </div>\r\n                    <div class=\"file-list-items\" data-file-items></div>\r\n                </div>\r\n                ` : ''}\r\n\r\n                <!-- Overall Progress (shown when uploading) -->\r\n                ${this.options.showProgress ? `\r\n                <div class=\"file-upload-progress\" data-overall-progress style=\"display: none;\">\r\n                    <div class=\"progress-info\">\r\n                        <span class=\"progress-label\">Uploading files...</span>\r\n                        <span class=\"progress-percentage\" data-progress-text>0%</span>\r\n                    </div>\r\n                    <div class=\"progress-bar\">\r\n                        <div class=\"progress-fill\" data-progress-fill style=\"width: 0%\"></div>\r\n                    </div>\r\n                </div>\r\n                ` : ''}\r\n            </div>\r\n        `;\r\n\r\n        // Cache DOM elements\r\n        this.dropZone = this.container.querySelector('[data-dropzone]');\r\n        this.fileInput = this.container.querySelector('[data-file-input]');\r\n        this.browseButton = this.container.querySelector('[data-browse-button]');\r\n        this.fileList = this.container.querySelector('[data-file-list]');\r\n        this.fileItems = this.container.querySelector('[data-file-items]');\r\n        this.overallProgress = this.container.querySelector('[data-overall-progress]');\r\n        this.progressFill = this.container.querySelector('[data-progress-fill]');\r\n        this.progressText = this.container.querySelector('[data-progress-text]');\r\n        this.uploadAllButton = this.container.querySelector('[data-upload-all]');\r\n        this.clearAllButton = this.container.querySelector('[data-clear-all]');\r\n\r\n        // Bind UI events\r\n        this.browseButton?.addEventListener('click', () => this.fileInput.click());\r\n        this.uploadAllButton?.addEventListener('click', () => this.uploader.uploadAll());\r\n        this.clearAllButton?.addEventListener('click', () => this.clearAll());\r\n    }\r\n\r\n    /**\r\n     * Initialize the uploader\r\n     */\r\n    initializeUploader() {\r\n        this.uploader = new ComponentFileUploader(this.componentElement, {\r\n            ...this.options,\r\n            dropZone: this.dropZone,\r\n            fileInput: this.fileInput,\r\n            onFileAdded: (data) => this.handleFileAdded(data),\r\n            onFileRemoved: (data) => this.handleFileRemoved(data),\r\n            onUploadStart: (data) => this.handleUploadStart(data),\r\n            onUploadProgress: (data) => this.handleUploadProgress(data),\r\n            onUploadComplete: (data) => this.handleUploadComplete(data),\r\n            onUploadError: (data) => this.handleUploadError(data),\r\n            onAllUploadsComplete: (data) => this.handleAllUploadsComplete(data)\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Handle file added\r\n     */\r\n    handleFileAdded({ fileId, file, progress }) {\r\n        if (!this.options.showFileList) return;\r\n\r\n        // Show file list\r\n        if (this.fileList) {\r\n            this.fileList.style.display = 'block';\r\n        }\r\n\r\n        // Create file UI element\r\n        const fileElement = this.createFileElement(fileId, file, progress);\r\n        this.fileItems.appendChild(fileElement);\r\n        this.files.set(fileId, fileElement);\r\n\r\n        // Update file count\r\n        this.updateFileCount();\r\n    }\r\n\r\n    /**\r\n     * Handle file removed\r\n     */\r\n    handleFileRemoved({ fileId }) {\r\n        const fileElement = this.files.get(fileId);\r\n        if (fileElement) {\r\n            fileElement.remove();\r\n            this.files.delete(fileId);\r\n        }\r\n\r\n        // Update file count\r\n        this.updateFileCount();\r\n\r\n        // Hide file list if empty\r\n        if (this.files.size === 0 && this.fileList) {\r\n            this.fileList.style.display = 'none';\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle upload start\r\n     */\r\n    handleUploadStart({ fileId }) {\r\n        this.updateFileStatus(fileId, 'uploading');\r\n\r\n        // Show overall progress\r\n        if (this.overallProgress) {\r\n            this.overallProgress.style.display = 'block';\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle upload progress\r\n     */\r\n    handleUploadProgress({ fileId, percentage, uploadedBytes, totalBytes, uploadSpeed, remainingTime }) {\r\n        // Update file progress bar\r\n        const fileElement = this.files.get(fileId);\r\n        if (fileElement) {\r\n            const progressBar = fileElement.querySelector('.file-progress-fill');\r\n            const progressText = fileElement.querySelector('.file-progress-text');\r\n\r\n            if (progressBar) {\r\n                progressBar.style.width = `${percentage}%`;\r\n            }\r\n\r\n            if (progressText) {\r\n                progressText.textContent = `${percentage}%`;\r\n            }\r\n        }\r\n\r\n        // Update overall progress\r\n        const stats = this.uploader.getStats();\r\n        if (this.progressFill) {\r\n            this.progressFill.style.width = `${stats.overallProgress}%`;\r\n        }\r\n        if (this.progressText) {\r\n            this.progressText.textContent = `${stats.overallProgress}%`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle upload complete\r\n     */\r\n    handleUploadComplete({ fileId, response }) {\r\n        this.updateFileStatus(fileId, 'complete');\r\n    }\r\n\r\n    /**\r\n     * Handle upload error\r\n     */\r\n    handleUploadError({ fileId, error }) {\r\n        this.updateFileStatus(fileId, 'error', error);\r\n    }\r\n\r\n    /**\r\n     * Handle all uploads complete\r\n     */\r\n    handleAllUploadsComplete({ totalFiles, successCount, errorCount }) {\r\n        // Hide overall progress after a delay\r\n        setTimeout(() => {\r\n            if (this.overallProgress) {\r\n                this.overallProgress.style.display = 'none';\r\n            }\r\n        }, 2000);\r\n    }\r\n\r\n    /**\r\n     * Create file UI element\r\n     */\r\n    createFileElement(fileId, file, progress) {\r\n        const div = document.createElement('div');\r\n        div.className = 'file-item';\r\n        div.dataset.fileId = fileId;\r\n\r\n        const statusClass = progress.error ? 'error' : 'pending';\r\n\r\n        div.innerHTML = `\r\n            <div class=\"file-preview\">\r\n                ${this.options.showPreviews && file.type.startsWith('image/') ?\r\n                    `<img class=\"file-thumbnail\" src=\"${URL.createObjectURL(file)}\" alt=\"${file.name}\" />` :\r\n                    this.getFileIconSvg(file.type)\r\n                }\r\n            </div>\r\n            <div class=\"file-info\">\r\n                <div class=\"file-name\" title=\"${file.name}\">${this.truncateFileName(file.name, 40)}</div>\r\n                <div class=\"file-meta\">\r\n                    <span class=\"file-size\">${this.formatBytes(file.size)}</span>\r\n                    <span class=\"file-status\" data-status=\"${statusClass}\">${progress.error || 'Pending'}</span>\r\n                </div>\r\n                ${this.options.showProgress ? `\r\n                <div class=\"file-progress\" style=\"display: none;\">\r\n                    <div class=\"file-progress-bar\">\r\n                        <div class=\"file-progress-fill\" style=\"width: 0%\"></div>\r\n                    </div>\r\n                    <span class=\"file-progress-text\">0%</span>\r\n                </div>\r\n                ` : ''}\r\n                ${progress.error ? `\r\n                <div class=\"file-error\">${progress.error}</div>\r\n                ` : ''}\r\n            </div>\r\n            <div class=\"file-actions\">\r\n                <button type=\"button\" class=\"btn-icon\" data-remove-file title=\"Remove\">\r\n                    <svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\">\r\n                        <line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"></line>\r\n                        <line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"></line>\r\n                    </svg>\r\n                </button>\r\n            </div>\r\n        `;\r\n\r\n        // Bind remove button\r\n        const removeButton = div.querySelector('[data-remove-file]');\r\n        removeButton.addEventListener('click', () => this.uploader.removeFile(fileId));\r\n\r\n        return div;\r\n    }\r\n\r\n    /**\r\n     * Update file status in UI\r\n     */\r\n    updateFileStatus(fileId, status, errorMessage = null) {\r\n        const fileElement = this.files.get(fileId);\r\n        if (!fileElement) return;\r\n\r\n        const statusElement = fileElement.querySelector('.file-status');\r\n        const progressElement = fileElement.querySelector('.file-progress');\r\n        const errorElement = fileElement.querySelector('.file-error');\r\n\r\n        // Update status text and class\r\n        if (statusElement) {\r\n            statusElement.dataset.status = status;\r\n\r\n            const statusText = {\r\n                pending: 'Pending',\r\n                uploading: 'Uploading...',\r\n                complete: 'Complete',\r\n                error: 'Error'\r\n            }[status] || status;\r\n\r\n            statusElement.textContent = statusText;\r\n        }\r\n\r\n        // Show/hide progress\r\n        if (progressElement) {\r\n            progressElement.style.display = status === 'uploading' ? 'flex' : 'none';\r\n        }\r\n\r\n        // Handle errors\r\n        if (status === 'error' && errorMessage) {\r\n            if (errorElement) {\r\n                errorElement.textContent = errorMessage;\r\n                errorElement.style.display = 'block';\r\n            }\r\n        }\r\n\r\n        // Add completion/error visual feedback\r\n        fileElement.classList.remove('file-uploading', 'file-complete', 'file-error');\r\n        if (status === 'uploading') fileElement.classList.add('file-uploading');\r\n        if (status === 'complete') fileElement.classList.add('file-complete');\r\n        if (status === 'error') fileElement.classList.add('file-error');\r\n    }\r\n\r\n    /**\r\n     * Update file count in header\r\n     */\r\n    updateFileCount() {\r\n        const header = this.container.querySelector('.file-list-header h4');\r\n        if (header) {\r\n            header.textContent = `Files (${this.files.size})`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Clear all files\r\n     */\r\n    clearAll() {\r\n        this.uploader.clearAll();\r\n        this.fileItems.innerHTML = '';\r\n        this.files.clear();\r\n\r\n        if (this.fileList) {\r\n            this.fileList.style.display = 'none';\r\n        }\r\n\r\n        this.updateFileCount();\r\n    }\r\n\r\n    /**\r\n     * Helper: Format bytes\r\n     */\r\n    formatBytes(bytes) {\r\n        if (bytes === 0) return '0 B';\r\n        const k = 1024;\r\n        const sizes = ['B', 'KB', 'MB', 'GB'];\r\n        const i = Math.floor(Math.log(bytes) / Math.log(k));\r\n        return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];\r\n    }\r\n\r\n    /**\r\n     * Helper: Truncate file name\r\n     */\r\n    truncateFileName(name, maxLength) {\r\n        if (name.length <= maxLength) return name;\r\n        const extension = name.split('.').pop();\r\n        const baseName = name.substring(0, name.length - extension.length - 1);\r\n        const truncated = baseName.substring(0, maxLength - extension.length - 4);\r\n        return `${truncated}...${extension}`;\r\n    }\r\n\r\n    /**\r\n     * Helper: Get file icon SVG\r\n     */\r\n    getFileIconSvg(mimeType) {\r\n        // Document icon\r\n        return `\r\n            <svg class=\"file-icon\" width=\"40\" height=\"40\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\">\r\n                <path d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z\"></path>\r\n                <polyline points=\"14 2 14 8 20 8\"></polyline>\r\n            </svg>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Cleanup\r\n     */\r\n    destroy() {\r\n        this.uploader.destroy();\r\n        this.container.innerHTML = '';\r\n        this.files.clear();\r\n    }\r\n}\r\n\r\nexport default FileUploadWidget;\r\n","/**\r\n * LiveComponent UI Helper\r\n * \r\n * Provides unified API for UI components (Dialogs, Modals, Notifications)\r\n * integrated with LiveComponents.\r\n */\r\n\r\nimport { UIManager } from '../ui/UIManager.js';\r\n\r\nexport class LiveComponentUIHelper {\r\n    constructor(liveComponentManager) {\r\n        this.manager = liveComponentManager;\r\n        this.uiManager = UIManager;\r\n        this.activeDialogs = new Map(); // componentId → dialog instances\r\n        this.activeNotifications = new Map(); // componentId → notification instances\r\n    }\r\n\r\n    /**\r\n     * Show dialog from LiveComponent action\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Object} options - Dialog options\r\n     * @returns {Object} Dialog instance\r\n     */\r\n    showDialog(componentId, options = {}) {\r\n        const {\r\n            title = '',\r\n            content = '',\r\n            size = 'medium',\r\n            buttons = [],\r\n            closeOnBackdrop = true,\r\n            closeOnEscape = true,\r\n            onClose = null,\r\n            onConfirm = null\r\n        } = options;\r\n\r\n        // Create dialog content\r\n        const dialogContent = this.createDialogContent(title, content, buttons, {\r\n            onClose,\r\n            onConfirm\r\n        });\r\n\r\n        // Show modal via UIManager\r\n        const modal = this.uiManager.open('modal', {\r\n            content: dialogContent,\r\n            className: `livecomponent-dialog livecomponent-dialog--${size}`,\r\n            onClose: () => {\r\n                if (onClose) {\r\n                    onClose();\r\n                }\r\n                this.activeDialogs.delete(componentId);\r\n            }\r\n        });\r\n\r\n        // Store reference\r\n        this.activeDialogs.set(componentId, modal);\r\n\r\n        return modal;\r\n    }\r\n\r\n    /**\r\n     * Show confirmation dialog\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Object} options - Confirmation options\r\n     * @returns {Promise<boolean>} Promise resolving to true if confirmed\r\n     */\r\n    showConfirm(componentId, options = {}) {\r\n        return new Promise((resolve) => {\r\n            const {\r\n                title = 'Confirm',\r\n                message = 'Are you sure?',\r\n                confirmText = 'Confirm',\r\n                cancelText = 'Cancel',\r\n                confirmClass = 'btn-primary',\r\n                cancelClass = 'btn-secondary'\r\n            } = options;\r\n\r\n            const buttons = [\r\n                {\r\n                    text: cancelText,\r\n                    class: cancelClass,\r\n                    action: () => {\r\n                        this.closeDialog(componentId);\r\n                        resolve(false);\r\n                    }\r\n                },\r\n                {\r\n                    text: confirmText,\r\n                    class: confirmClass,\r\n                    action: () => {\r\n                        this.closeDialog(componentId);\r\n                        resolve(true);\r\n                    }\r\n                }\r\n            ];\r\n\r\n            this.showDialog(componentId, {\r\n                title,\r\n                content: `<p>${message}</p>`,\r\n                buttons,\r\n                size: 'small'\r\n            });\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Show alert dialog\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Object} options - Alert options\r\n     */\r\n    showAlert(componentId, options = {}) {\r\n        const {\r\n            title = 'Alert',\r\n            message = '',\r\n            buttonText = 'OK',\r\n            type = 'info' // info, success, warning, error\r\n        } = options;\r\n\r\n        const buttons = [\r\n            {\r\n                text: buttonText,\r\n                class: `btn-${type}`,\r\n                action: () => {\r\n                    this.closeDialog(componentId);\r\n                }\r\n            }\r\n        ];\r\n\r\n        return this.showDialog(componentId, {\r\n            title,\r\n            content: `<p class=\"alert-message alert-message--${type}\">${message}</p>`,\r\n            buttons,\r\n            size: 'small'\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Close dialog\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    closeDialog(componentId) {\r\n        const dialog = this.activeDialogs.get(componentId);\r\n        if (dialog && typeof dialog.close === 'function') {\r\n            dialog.close();\r\n            this.activeDialogs.delete(componentId);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Show notification\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Object} options - Notification options\r\n     */\r\n    showNotification(componentId, options = {}) {\r\n        const {\r\n            message = '',\r\n            type = 'info', // info, success, warning, error\r\n            duration = 5000,\r\n            position = 'top-right',\r\n            action = null\r\n        } = options;\r\n\r\n        // Create notification element\r\n        const notification = document.createElement('div');\r\n        notification.className = `livecomponent-notification livecomponent-notification--${type} livecomponent-notification--${position}`;\r\n        notification.setAttribute('role', 'alert');\r\n        notification.setAttribute('aria-live', 'polite');\r\n\r\n        notification.innerHTML = `\r\n            <div class=\"notification-content\">\r\n                <span class=\"notification-message\">${message}</span>\r\n                ${action ? `<button class=\"notification-action\">${action.text}</button>` : ''}\r\n                <button class=\"notification-close\" aria-label=\"Close\">×</button>\r\n            </div>\r\n        `;\r\n\r\n        // Add styles\r\n        notification.style.cssText = `\r\n            position: fixed;\r\n            ${position.includes('top') ? 'top' : 'bottom'}: 1rem;\r\n            ${position.includes('left') ? 'left' : 'right'}: 1rem;\r\n            max-width: 400px;\r\n            padding: 1rem;\r\n            background: ${this.getNotificationColor(type)};\r\n            color: white;\r\n            border-radius: 0.5rem;\r\n            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);\r\n            z-index: 10000;\r\n            opacity: 0;\r\n            transform: translateY(${position.includes('top') ? '-20px' : '20px'});\r\n            transition: opacity 0.3s ease, transform 0.3s ease;\r\n        `;\r\n\r\n        // Add to DOM\r\n        document.body.appendChild(notification);\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            notification.style.opacity = '1';\r\n            notification.style.transform = 'translateY(0)';\r\n        });\r\n\r\n        // Setup close button\r\n        const closeBtn = notification.querySelector('.notification-close');\r\n        closeBtn.addEventListener('click', () => {\r\n            this.hideNotification(notification);\r\n        });\r\n\r\n        // Setup action button\r\n        if (action) {\r\n            const actionBtn = notification.querySelector('.notification-action');\r\n            actionBtn.addEventListener('click', () => {\r\n                if (action.handler) {\r\n                    action.handler();\r\n                }\r\n                this.hideNotification(notification);\r\n            });\r\n        }\r\n\r\n        // Auto-hide after duration\r\n        if (duration > 0) {\r\n            setTimeout(() => {\r\n                this.hideNotification(notification);\r\n            }, duration);\r\n        }\r\n\r\n        // Store reference\r\n        this.activeNotifications.set(componentId, notification);\r\n\r\n        return notification;\r\n    }\r\n\r\n    /**\r\n     * Hide notification\r\n     * \r\n     * @param {HTMLElement|string} notificationOrComponentId - Notification element or component ID\r\n     */\r\n    hideNotification(notificationOrComponentId) {\r\n        const notification = typeof notificationOrComponentId === 'string'\r\n            ? this.activeNotifications.get(notificationOrComponentId)\r\n            : notificationOrComponentId;\r\n\r\n        if (!notification) {\r\n            return;\r\n        }\r\n\r\n        // Animate out\r\n        notification.style.opacity = '0';\r\n        notification.style.transform = `translateY(${notification.classList.contains('livecomponent-notification--top') ? '-20px' : '20px'})`;\r\n\r\n        setTimeout(() => {\r\n            if (notification.parentNode) {\r\n                notification.parentNode.removeChild(notification);\r\n            }\r\n\r\n            // Remove from map\r\n            for (const [componentId, notif] of this.activeNotifications.entries()) {\r\n                if (notif === notification) {\r\n                    this.activeNotifications.delete(componentId);\r\n                    break;\r\n                }\r\n            }\r\n        }, 300);\r\n    }\r\n\r\n    /**\r\n     * Create dialog content HTML\r\n     * \r\n     * @param {string} title - Dialog title\r\n     * @param {string} content - Dialog content\r\n     * @param {Array} buttons - Button configurations\r\n     * @param {Object} callbacks - Callback functions\r\n     * @returns {string} HTML content\r\n     */\r\n    createDialogContent(title, content, buttons, callbacks) {\r\n        const buttonsHtml = buttons.map((btn, index) => {\r\n            const btnClass = btn.class || 'btn-secondary';\r\n            const btnAction = btn.action || (() => {});\r\n            return `<button class=\"btn ${btnClass}\" data-dialog-action=\"${index}\">${btn.text || 'Button'}</button>`;\r\n        }).join('');\r\n\r\n        return `\r\n            <div class=\"livecomponent-dialog-content\">\r\n                ${title ? `<div class=\"dialog-header\"><h3>${title}</h3></div>` : ''}\r\n                <div class=\"dialog-body\">${content}</div>\r\n                ${buttons.length > 0 ? `<div class=\"dialog-footer\">${buttonsHtml}</div>` : ''}\r\n            </div>\r\n        `;\r\n    }\r\n\r\n    /**\r\n     * Get notification color by type\r\n     * \r\n     * @param {string} type - Notification type\r\n     * @returns {string} Color value\r\n     */\r\n    getNotificationColor(type) {\r\n        const colors = {\r\n            info: '#3b82f6',\r\n            success: '#10b981',\r\n            warning: '#f59e0b',\r\n            error: '#ef4444'\r\n        };\r\n        return colors[type] || colors.info;\r\n    }\r\n\r\n    /**\r\n     * Show loading dialog\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {string} message - Loading message\r\n     * @returns {Object} Dialog instance\r\n     */\r\n    showLoadingDialog(componentId, message = 'Loading...') {\r\n        return this.showDialog(componentId, {\r\n            title: '',\r\n            content: `\r\n                <div class=\"loading-dialog\">\r\n                    <div class=\"spinner\"></div>\r\n                    <p>${message}</p>\r\n                </div>\r\n            `,\r\n            size: 'small',\r\n            buttons: [],\r\n            closeOnBackdrop: false,\r\n            closeOnEscape: false\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Cleanup all UI components for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    cleanup(componentId) {\r\n        // Close dialogs\r\n        this.closeDialog(componentId);\r\n\r\n        // Hide notifications\r\n        this.hideNotification(componentId);\r\n    }\r\n}\r\n\r\n","/**\r\n * Loading State Manager for LiveComponents\r\n * \r\n * Manages different loading indicators (skeleton, spinner, progress) during actions.\r\n * Integrates with OptimisticStateManager and ActionLoadingManager.\r\n */\r\n\r\nexport class LoadingStateManager {\r\n    constructor(actionLoadingManager, optimisticStateManager) {\r\n        this.actionLoadingManager = actionLoadingManager;\r\n        this.optimisticStateManager = optimisticStateManager;\r\n        this.loadingConfigs = new Map(); // componentId → loading config\r\n        this.config = {\r\n            defaultType: 'skeleton', // skeleton, spinner, progress, none\r\n            showDelay: 150,\r\n            hideDelay: 0\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Configure loading state for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {Object} config - Loading configuration\r\n     */\r\n    configure(componentId, config) {\r\n        this.loadingConfigs.set(componentId, {\r\n            type: config.type || this.config.defaultType,\r\n            showDelay: config.showDelay ?? this.config.showDelay,\r\n            hideDelay: config.hideDelay ?? this.config.hideDelay,\r\n            template: config.template || null,\r\n            ...config\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Show loading state for action\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Object} options - Loading options\r\n     */\r\n    showLoading(componentId, element, options = {}) {\r\n        const config = this.loadingConfigs.get(componentId) || {\r\n            type: this.config.defaultType,\r\n            showDelay: this.config.showDelay\r\n        };\r\n\r\n        const loadingType = options.type || config.type;\r\n\r\n        // Skip if type is 'none' or optimistic UI is enabled\r\n        if (loadingType === 'none') {\r\n            return;\r\n        }\r\n\r\n        // Check if optimistic UI is active (no loading needed)\r\n        const pendingOps = this.optimisticStateManager.getPendingOperations(componentId);\r\n        if (pendingOps.length > 0 && options.optimistic !== false) {\r\n            // Optimistic UI is active - skip loading indicator\r\n            return;\r\n        }\r\n\r\n        switch (loadingType) {\r\n            case 'skeleton':\r\n                this.actionLoadingManager.showLoading(componentId, element, {\r\n                    ...options,\r\n                    showDelay: config.showDelay\r\n                });\r\n                break;\r\n\r\n            case 'spinner':\r\n                this.showSpinner(componentId, element, config);\r\n                break;\r\n\r\n            case 'progress':\r\n                this.showProgress(componentId, element, config);\r\n                break;\r\n\r\n            default:\r\n                // Fallback to skeleton\r\n                this.actionLoadingManager.showLoading(componentId, element, options);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Hide loading state\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    hideLoading(componentId) {\r\n        // Hide skeleton loading\r\n        this.actionLoadingManager.hideLoading(componentId);\r\n\r\n        // Hide spinner\r\n        this.hideSpinner(componentId);\r\n\r\n        // Hide progress\r\n        this.hideProgress(componentId);\r\n    }\r\n\r\n    /**\r\n     * Show spinner loading indicator\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Object} config - Configuration\r\n     */\r\n    showSpinner(componentId, element, config) {\r\n        // Remove existing spinner\r\n        this.hideSpinner(componentId);\r\n\r\n        const spinner = document.createElement('div');\r\n        spinner.className = 'livecomponent-loading-spinner';\r\n        spinner.setAttribute('data-component-id', componentId);\r\n        spinner.setAttribute('aria-busy', 'true');\r\n        spinner.setAttribute('aria-label', 'Loading...');\r\n\r\n        spinner.innerHTML = `\r\n            <div class=\"spinner\"></div>\r\n            <span class=\"spinner-text\">Loading...</span>\r\n        `;\r\n\r\n        spinner.style.cssText = `\r\n            position: absolute;\r\n            top: 0;\r\n            left: 0;\r\n            right: 0;\r\n            bottom: 0;\r\n            background: rgba(255, 255, 255, 0.8);\r\n            display: flex;\r\n            flex-direction: column;\r\n            align-items: center;\r\n            justify-content: center;\r\n            gap: 1rem;\r\n            z-index: 10;\r\n            opacity: 0;\r\n            transition: opacity ${this.config.showDelay}ms ease;\r\n        `;\r\n\r\n        // Ensure element has relative positioning\r\n        if (getComputedStyle(element).position === 'static') {\r\n            element.style.position = 'relative';\r\n        }\r\n\r\n        element.appendChild(spinner);\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            spinner.style.opacity = '1';\r\n        });\r\n\r\n        // Store reference\r\n        const loadingConfig = this.loadingConfigs.get(componentId) || {};\r\n        loadingConfig.spinner = spinner;\r\n        this.loadingConfigs.set(componentId, loadingConfig);\r\n    }\r\n\r\n    /**\r\n     * Hide spinner\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    hideSpinner(componentId) {\r\n        const config = this.loadingConfigs.get(componentId);\r\n        if (!config || !config.spinner) {\r\n            return;\r\n        }\r\n\r\n        const spinner = config.spinner;\r\n        spinner.style.opacity = '0';\r\n\r\n        setTimeout(() => {\r\n            if (spinner.parentNode) {\r\n                spinner.parentNode.removeChild(spinner);\r\n            }\r\n            delete config.spinner;\r\n        }, 200);\r\n    }\r\n\r\n    /**\r\n     * Show progress bar\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {HTMLElement} element - Component element\r\n     * @param {Object} config - Configuration\r\n     */\r\n    showProgress(componentId, element, config) {\r\n        // Remove existing progress\r\n        this.hideProgress(componentId);\r\n\r\n        const progress = document.createElement('div');\r\n        progress.className = 'livecomponent-loading-progress';\r\n        progress.setAttribute('data-component-id', componentId);\r\n        progress.setAttribute('aria-busy', 'true');\r\n\r\n        progress.innerHTML = `\r\n            <div class=\"progress-bar\" style=\"width: 0%;\"></div>\r\n        `;\r\n\r\n        progress.style.cssText = `\r\n            position: absolute;\r\n            top: 0;\r\n            left: 0;\r\n            right: 0;\r\n            height: 3px;\r\n            background: #e0e0e0;\r\n            z-index: 10;\r\n            opacity: 0;\r\n            transition: opacity ${this.config.showDelay}ms ease;\r\n        `;\r\n\r\n        const progressBar = progress.querySelector('.progress-bar');\r\n        progressBar.style.cssText = `\r\n            height: 100%;\r\n            background: #2196F3;\r\n            transition: width 0.3s ease;\r\n        `;\r\n\r\n        // Ensure element has relative positioning\r\n        if (getComputedStyle(element).position === 'static') {\r\n            element.style.position = 'relative';\r\n        }\r\n\r\n        element.appendChild(progress);\r\n\r\n        // Animate in\r\n        requestAnimationFrame(() => {\r\n            progress.style.opacity = '1';\r\n            // Simulate progress (can be updated via updateProgress)\r\n            this.updateProgress(componentId, 30);\r\n        });\r\n\r\n        // Store reference\r\n        const loadingConfig = this.loadingConfigs.get(componentId) || {};\r\n        loadingConfig.progress = progress;\r\n        this.loadingConfigs.set(componentId, loadingConfig);\r\n    }\r\n\r\n    /**\r\n     * Update progress bar\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @param {number} percent - Progress percentage (0-100)\r\n     */\r\n    updateProgress(componentId, percent) {\r\n        const config = this.loadingConfigs.get(componentId);\r\n        if (!config || !config.progress) {\r\n            return;\r\n        }\r\n\r\n        const progressBar = config.progress.querySelector('.progress-bar');\r\n        if (progressBar) {\r\n            progressBar.style.width = `${Math.min(100, Math.max(0, percent))}%`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Hide progress bar\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    hideProgress(componentId) {\r\n        const config = this.loadingConfigs.get(componentId);\r\n        if (!config || !config.progress) {\r\n            return;\r\n        }\r\n\r\n        const progress = config.progress;\r\n        \r\n        // Complete progress bar\r\n        this.updateProgress(componentId, 100);\r\n\r\n        setTimeout(() => {\r\n            progress.style.opacity = '0';\r\n            setTimeout(() => {\r\n                if (progress.parentNode) {\r\n                    progress.parentNode.removeChild(progress);\r\n                }\r\n                delete config.progress;\r\n            }, 200);\r\n        }, 300);\r\n    }\r\n\r\n    /**\r\n     * Get loading configuration for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     * @returns {Object} Loading configuration\r\n     */\r\n    getConfig(componentId) {\r\n        return this.loadingConfigs.get(componentId) || {\r\n            type: this.config.defaultType,\r\n            showDelay: this.config.showDelay\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Clear configuration for component\r\n     * \r\n     * @param {string} componentId - Component ID\r\n     */\r\n    clearConfig(componentId) {\r\n        this.hideLoading(componentId);\r\n        this.loadingConfigs.delete(componentId);\r\n    }\r\n}\r\n\r\n","// js/noise-toggle.js\n\nimport { Logger } from \"../../core/logger.js\";\n\nexport function init(config = {}) {\n    Logger.log('Noise Toggle Init', config);\n\n    const {\n        selector = \".noise-overlay\",\n        toggleKey = \"g\",\n        className = \"grainy\",\n        enableTransition = true,\n    } = config;\n\n    const body = document.body;\n    const noiseElement = document.querySelector(selector);\n\n    if (!noiseElement) return;\n\n    const isInput = noiseElement => [\"input\", \"textarea\"].includes(noiseElement.tagName.toLowerCase());\n\n    function update() {\n        if (enableTransition) {\n            noiseElement.classList.toggle(\"hidden\", !body.classList.contains(className));\n        } else {\n            noiseElement.style.display = body.classList.contains(className) ? \"block\" : \"none\";\n        }\n    }\n\n    update();\n\n    document.addEventListener(\"keydown\", (e) => {\n        if (\n            e.key.toLowerCase() === toggleKey &&\n            !e.ctrlKey && !e.metaKey && !e.altKey &&\n            !isInput(e.target)\n        ) {\n            body.classList.toggle(className);\n            update();\n        }\n    })\n}\n","// modules/parallax/index.js\nimport { Logger } from '../../core/logger.js';\nimport { registerFrameTask } from '../../core/frameloop.js';\n\nexport function init(config = {}) {\n    Logger.info('Parallax init');\n\n    const defaultConfig = {\n        selector: '[data-parallax]',\n        speedAttr: 'data-parallax-speed',\n        defaultSpeed: 0.5\n    };\n\n    const settings = { ...defaultConfig, ...config };\n    const elements = document.querySelectorAll(settings.selector);\n\n    function updateParallax() {\n        const scrollY = window.scrollY;\n        elements.forEach(el => {\n            const speed = parseFloat(el.getAttribute(settings.speedAttr)) || settings.defaultSpeed;\n            const offset = scrollY * speed;\n            el.style.transform = `translateY(${offset}px)`;\n        });\n    }\n\n    registerFrameTask('parallax', updateParallax, { autoStart: true });\n}\n","/**\r\n * LiveComponents Performance Profiler\r\n *\r\n * Provides detailed performance profiling with flamegraph and timeline visualization.\r\n *\r\n * Features:\r\n * - Real-time performance metrics collection\r\n * - Flamegraph generation for call stack visualization\r\n * - Timeline visualization for event sequencing\r\n * - Export to Chrome DevTools format\r\n * - Integration with Performance API\r\n *\r\n * @module PerformanceProfiler\r\n */\r\n\r\nexport class PerformanceProfiler {\r\n    constructor(options = {}) {\r\n        this.enabled = options.enabled ?? false;\r\n        this.maxSamples = options.maxSamples ?? 1000;\r\n        this.samplingInterval = options.samplingInterval ?? 10; // ms\r\n        this.autoStart = options.autoStart ?? false;\r\n\r\n        this.samples = [];\r\n        this.timeline = [];\r\n        this.marks = new Map();\r\n        this.measures = new Map();\r\n        this.isRecording = false;\r\n        this.recordingStartTime = null;\r\n\r\n        if (this.autoStart && this.enabled) {\r\n            this.start();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Start performance profiling\r\n     */\r\n    start() {\r\n        if (this.isRecording) {\r\n            console.warn('[PerformanceProfiler] Already recording');\r\n            return;\r\n        }\r\n\r\n        this.isRecording = true;\r\n        this.recordingStartTime = performance.now();\r\n        this.samples = [];\r\n        this.timeline = [];\r\n\r\n        console.log('[PerformanceProfiler] Started recording');\r\n    }\r\n\r\n    /**\r\n     * Stop performance profiling\r\n     * @returns {Object} Profiling results\r\n     */\r\n    stop() {\r\n        if (!this.isRecording) {\r\n            console.warn('[PerformanceProfiler] Not recording');\r\n            return null;\r\n        }\r\n\r\n        this.isRecording = false;\r\n        const duration = performance.now() - this.recordingStartTime;\r\n\r\n        const results = {\r\n            duration,\r\n            samples: this.samples,\r\n            timeline: this.timeline,\r\n            marks: Array.from(this.marks.entries()),\r\n            measures: Array.from(this.measures.entries()),\r\n            summary: this.generateSummary()\r\n        };\r\n\r\n        console.log('[PerformanceProfiler] Stopped recording', results);\r\n        return results;\r\n    }\r\n\r\n    /**\r\n     * Mark a specific point in time\r\n     * @param {string} name - Mark name\r\n     * @param {Object} metadata - Additional metadata\r\n     */\r\n    mark(name, metadata = {}) {\r\n        if (!this.isRecording && !this.enabled) return;\r\n\r\n        const timestamp = performance.now();\r\n        const mark = {\r\n            name,\r\n            timestamp,\r\n            relativeTime: timestamp - this.recordingStartTime,\r\n            metadata\r\n        };\r\n\r\n        this.marks.set(name, mark);\r\n\r\n        // Also use native Performance API\r\n        if (performance.mark) {\r\n            performance.mark(name);\r\n        }\r\n\r\n        // Add to timeline\r\n        this.timeline.push({\r\n            type: 'mark',\r\n            ...mark\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Measure duration between two marks\r\n     * @param {string} name - Measure name\r\n     * @param {string} startMark - Start mark name\r\n     * @param {string} endMark - End mark name (optional, defaults to now)\r\n     */\r\n    measure(name, startMark, endMark = null) {\r\n        if (!this.isRecording && !this.enabled) return;\r\n\r\n        const start = this.marks.get(startMark);\r\n        if (!start) {\r\n            console.warn(`[PerformanceProfiler] Start mark \"${startMark}\" not found`);\r\n            return;\r\n        }\r\n\r\n        const endTime = endMark\r\n            ? this.marks.get(endMark)?.timestamp\r\n            : performance.now();\r\n\r\n        if (!endTime) {\r\n            console.warn(`[PerformanceProfiler] End mark \"${endMark}\" not found`);\r\n            return;\r\n        }\r\n\r\n        const duration = endTime - start.timestamp;\r\n        const measure = {\r\n            name,\r\n            startMark,\r\n            endMark,\r\n            duration,\r\n            startTime: start.timestamp,\r\n            endTime,\r\n            relativeStartTime: start.relativeTime,\r\n            relativeEndTime: endTime - this.recordingStartTime\r\n        };\r\n\r\n        this.measures.set(name, measure);\r\n\r\n        // Native Performance API\r\n        if (performance.measure && endMark) {\r\n            try {\r\n                performance.measure(name, startMark, endMark);\r\n            } catch (e) {\r\n                // Ignore if marks don't exist in native API\r\n            }\r\n        }\r\n\r\n        // Add to timeline\r\n        this.timeline.push({\r\n            type: 'measure',\r\n            ...measure\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Record a sample for flamegraph\r\n     * @param {string} functionName - Function name\r\n     * @param {Array<string>} stackTrace - Call stack\r\n     * @param {number} duration - Execution duration\r\n     */\r\n    sample(functionName, stackTrace = [], duration = 0) {\r\n        if (!this.isRecording) return;\r\n\r\n        if (this.samples.length >= this.maxSamples) {\r\n            console.warn('[PerformanceProfiler] Max samples reached');\r\n            return;\r\n        }\r\n\r\n        this.samples.push({\r\n            timestamp: performance.now(),\r\n            relativeTime: performance.now() - this.recordingStartTime,\r\n            functionName,\r\n            stackTrace,\r\n            duration\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Generate flamegraph data\r\n     * @returns {Object} Flamegraph data structure\r\n     */\r\n    generateFlamegraph() {\r\n        if (this.samples.length === 0) {\r\n            return null;\r\n        }\r\n\r\n        // Build call tree from samples\r\n        const root = {\r\n            name: '(root)',\r\n            value: 0,\r\n            children: []\r\n        };\r\n\r\n        for (const sample of this.samples) {\r\n            let currentNode = root;\r\n            const stack = [sample.functionName, ...sample.stackTrace].reverse();\r\n\r\n            for (const funcName of stack) {\r\n                let child = currentNode.children.find(c => c.name === funcName);\r\n\r\n                if (!child) {\r\n                    child = {\r\n                        name: funcName,\r\n                        value: 0,\r\n                        children: []\r\n                    };\r\n                    currentNode.children.push(child);\r\n                }\r\n\r\n                child.value += sample.duration || 1;\r\n                currentNode = child;\r\n            }\r\n        }\r\n\r\n        return root;\r\n    }\r\n\r\n    /**\r\n     * Generate timeline data for visualization\r\n     * @returns {Array} Timeline events\r\n     */\r\n    generateTimeline() {\r\n        return this.timeline.map(event => ({\r\n            ...event,\r\n            category: this.categorizeEvent(event),\r\n            color: this.getEventColor(event)\r\n        }));\r\n    }\r\n\r\n    /**\r\n     * Generate summary statistics\r\n     * @returns {Object} Summary data\r\n     */\r\n    generateSummary() {\r\n        const durations = Array.from(this.measures.values()).map(m => m.duration);\r\n\r\n        if (durations.length === 0) {\r\n            return {\r\n                totalMeasures: 0,\r\n                totalSamples: this.samples.length,\r\n                totalDuration: 0\r\n            };\r\n        }\r\n\r\n        const totalDuration = durations.reduce((sum, d) => sum + d, 0);\r\n        const avgDuration = totalDuration / durations.length;\r\n        const maxDuration = Math.max(...durations);\r\n        const minDuration = Math.min(...durations);\r\n\r\n        // Calculate percentiles\r\n        const sortedDurations = [...durations].sort((a, b) => a - b);\r\n        const p50 = sortedDurations[Math.floor(sortedDurations.length * 0.5)];\r\n        const p90 = sortedDurations[Math.floor(sortedDurations.length * 0.9)];\r\n        const p99 = sortedDurations[Math.floor(sortedDurations.length * 0.99)];\r\n\r\n        return {\r\n            totalMeasures: this.measures.size,\r\n            totalSamples: this.samples.length,\r\n            totalDuration,\r\n            avgDuration,\r\n            maxDuration,\r\n            minDuration,\r\n            percentiles: { p50, p90, p99 }\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Export to Chrome DevTools Performance format\r\n     * @returns {Object} Chrome DevTools trace event format\r\n     */\r\n    exportToChromeTrace() {\r\n        const events = [];\r\n\r\n        // Add marks\r\n        for (const [name, mark] of this.marks.entries()) {\r\n            events.push({\r\n                name,\r\n                cat: 'mark',\r\n                ph: 'R', // Instant event\r\n                ts: mark.timestamp * 1000, // microseconds\r\n                pid: 1,\r\n                tid: 1,\r\n                args: mark.metadata\r\n            });\r\n        }\r\n\r\n        // Add measures as duration events\r\n        for (const [name, measure] of this.measures.entries()) {\r\n            events.push({\r\n                name,\r\n                cat: 'measure',\r\n                ph: 'B', // Begin\r\n                ts: measure.startTime * 1000,\r\n                pid: 1,\r\n                tid: 1\r\n            });\r\n            events.push({\r\n                name,\r\n                cat: 'measure',\r\n                ph: 'E', // End\r\n                ts: measure.endTime * 1000,\r\n                pid: 1,\r\n                tid: 1\r\n            });\r\n        }\r\n\r\n        // Add samples\r\n        for (const sample of this.samples) {\r\n            events.push({\r\n                name: sample.functionName,\r\n                cat: 'sample',\r\n                ph: 'X', // Complete event\r\n                ts: sample.timestamp * 1000,\r\n                dur: (sample.duration || 1) * 1000,\r\n                pid: 1,\r\n                tid: 1,\r\n                args: {\r\n                    stackTrace: sample.stackTrace\r\n                }\r\n            });\r\n        }\r\n\r\n        return {\r\n            traceEvents: events.sort((a, b) => a.ts - b.ts),\r\n            displayTimeUnit: 'ms',\r\n            metadata: {\r\n                'clock-domain': 'PERFORMANCE_NOW'\r\n            }\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Categorize timeline event\r\n     * @private\r\n     */\r\n    categorizeEvent(event) {\r\n        if (event.type === 'mark') {\r\n            if (event.name.includes('action')) return 'action';\r\n            if (event.name.includes('render')) return 'render';\r\n            if (event.name.includes('state')) return 'state';\r\n            return 'other';\r\n        }\r\n\r\n        if (event.type === 'measure') {\r\n            if (event.duration > 100) return 'slow';\r\n            if (event.duration > 16) return 'normal';\r\n            return 'fast';\r\n        }\r\n\r\n        return 'unknown';\r\n    }\r\n\r\n    /**\r\n     * Get color for event visualization\r\n     * @private\r\n     */\r\n    getEventColor(event) {\r\n        const colorMap = {\r\n            action: '#4CAF50',\r\n            render: '#2196F3',\r\n            state: '#FF9800',\r\n            slow: '#F44336',\r\n            normal: '#FFC107',\r\n            fast: '#8BC34A',\r\n            other: '#9E9E9E',\r\n            unknown: '#607D8B'\r\n        };\r\n\r\n        return colorMap[this.categorizeEvent(event)] || '#607D8B';\r\n    }\r\n\r\n    /**\r\n     * Clear all profiling data\r\n     */\r\n    clear() {\r\n        this.samples = [];\r\n        this.timeline = [];\r\n        this.marks.clear();\r\n        this.measures.clear();\r\n        this.recordingStartTime = null;\r\n\r\n        // Clear native Performance API\r\n        if (performance.clearMarks) {\r\n            performance.clearMarks();\r\n        }\r\n        if (performance.clearMeasures) {\r\n            performance.clearMeasures();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get current profiling status\r\n     * @returns {Object} Status information\r\n     */\r\n    getStatus() {\r\n        return {\r\n            enabled: this.enabled,\r\n            isRecording: this.isRecording,\r\n            samplesCount: this.samples.length,\r\n            marksCount: this.marks.size,\r\n            measuresCount: this.measures.size,\r\n            timelineEventsCount: this.timeline.length,\r\n            recordingDuration: this.isRecording\r\n                ? performance.now() - this.recordingStartTime\r\n                : 0\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * LiveComponents Performance Integration\r\n *\r\n * Automatic profiling for LiveComponents actions and lifecycle events\r\n */\r\nexport class LiveComponentsProfiler extends PerformanceProfiler {\r\n    constructor(component, options = {}) {\r\n        super(options);\r\n        this.component = component;\r\n        this.actionCallDepth = 0;\r\n\r\n        if (this.enabled) {\r\n            this.instrumentComponent();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Instrument component for automatic profiling\r\n     * @private\r\n     */\r\n    instrumentComponent() {\r\n        // Hook into action calls\r\n        const originalCall = this.component.call.bind(this.component);\r\n        this.component.call = (actionName, params, options) => {\r\n            this.actionCallDepth++;\r\n            const markName = `action:${actionName}:${this.actionCallDepth}`;\r\n\r\n            this.mark(`${markName}:start`, {\r\n                actionName,\r\n                params,\r\n                depth: this.actionCallDepth\r\n            });\r\n\r\n            const result = originalCall(actionName, params, options);\r\n\r\n            // Handle promise results\r\n            if (result instanceof Promise) {\r\n                return result.finally(() => {\r\n                    this.mark(`${markName}:end`);\r\n                    this.measure(`action:${actionName}`, `${markName}:start`, `${markName}:end`);\r\n                    this.actionCallDepth--;\r\n                });\r\n            }\r\n\r\n            this.mark(`${markName}:end`);\r\n            this.measure(`action:${actionName}`, `${markName}:start`, `${markName}:end`);\r\n            this.actionCallDepth--;\r\n\r\n            return result;\r\n        };\r\n\r\n        // Hook into state updates\r\n        if (this.component.state) {\r\n            const originalSet = this.component.state.set.bind(this.component.state);\r\n            this.component.state.set = (key, value) => {\r\n                this.mark(`state:set:${key}`, { key, value });\r\n                return originalSet(key, value);\r\n            };\r\n        }\r\n\r\n        // Hook into renders\r\n        if (this.component.render) {\r\n            const originalRender = this.component.render.bind(this.component);\r\n            this.component.render = () => {\r\n                this.mark('render:start');\r\n                const result = originalRender();\r\n\r\n                if (result instanceof Promise) {\r\n                    return result.finally(() => {\r\n                        this.mark('render:end');\r\n                        this.measure('render', 'render:start', 'render:end');\r\n                    });\r\n                }\r\n\r\n                this.mark('render:end');\r\n                this.measure('render', 'render:start', 'render:end');\r\n                return result;\r\n            };\r\n        }\r\n    }\r\n}\r\n\r\n// Export default instance\r\nexport default PerformanceProfiler;\r\n","/**\r\n * Performance Visualization Components\r\n *\r\n * Provides flamegraph and timeline visualization for performance profiling data.\r\n *\r\n * @module PerformanceVisualizer\r\n */\r\n\r\n/**\r\n * Flamegraph Visualizer\r\n *\r\n * Renders interactive flamegraph from profiling samples\r\n */\r\nexport class FlamegraphVisualizer {\r\n    constructor(container, options = {}) {\r\n        this.container = typeof container === 'string'\r\n            ? document.querySelector(container)\r\n            : container;\r\n\r\n        if (!this.container) {\r\n            throw new Error('Container element not found');\r\n        }\r\n\r\n        this.options = {\r\n            width: options.width ?? this.container.clientWidth,\r\n            height: options.height ?? 400,\r\n            barHeight: options.barHeight ?? 20,\r\n            barPadding: options.barPadding ?? 2,\r\n            colorScheme: options.colorScheme ?? 'category', // 'category', 'duration', 'monochrome'\r\n            minWidth: options.minWidth ?? 0.5, // Minimum width in pixels to render\r\n            ...options\r\n        };\r\n\r\n        this.data = null;\r\n        this.svg = null;\r\n        this.tooltip = null;\r\n        this.selectedNode = null;\r\n\r\n        this.init();\r\n    }\r\n\r\n    /**\r\n     * Initialize SVG canvas\r\n     * @private\r\n     */\r\n    init() {\r\n        // Create SVG element\r\n        this.svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');\r\n        this.svg.setAttribute('width', this.options.width);\r\n        this.svg.setAttribute('height', this.options.height);\r\n        this.svg.style.fontFamily = 'monospace';\r\n        this.svg.style.fontSize = '12px';\r\n\r\n        // Create tooltip\r\n        this.tooltip = document.createElement('div');\r\n        this.tooltip.style.position = 'absolute';\r\n        this.tooltip.style.padding = '8px';\r\n        this.tooltip.style.background = 'rgba(0, 0, 0, 0.8)';\r\n        this.tooltip.style.color = 'white';\r\n        this.tooltip.style.borderRadius = '4px';\r\n        this.tooltip.style.pointerEvents = 'none';\r\n        this.tooltip.style.display = 'none';\r\n        this.tooltip.style.zIndex = '1000';\r\n        this.tooltip.style.fontSize = '12px';\r\n\r\n        this.container.style.position = 'relative';\r\n        this.container.appendChild(this.svg);\r\n        this.container.appendChild(this.tooltip);\r\n    }\r\n\r\n    /**\r\n     * Render flamegraph from data\r\n     * @param {Object} data - Flamegraph data (hierarchical structure)\r\n     */\r\n    render(data) {\r\n        this.data = data;\r\n        this.clear();\r\n\r\n        if (!data) {\r\n            return;\r\n        }\r\n\r\n        // Calculate total value for width scaling\r\n        const totalValue = this.calculateTotalValue(data);\r\n\r\n        // Render nodes recursively\r\n        this.renderNode(data, 0, 0, this.options.width, totalValue);\r\n    }\r\n\r\n    /**\r\n     * Render a single flamegraph node\r\n     * @private\r\n     */\r\n    renderNode(node, x, y, width, totalValue) {\r\n        const { barHeight, barPadding, minWidth } = this.options;\r\n\r\n        // Skip if too small to render\r\n        if (width < minWidth) {\r\n            return;\r\n        }\r\n\r\n        // Create rectangle\r\n        const rect = document.createElementNS('http://www.w3.org/2000/svg', 'rect');\r\n        rect.setAttribute('x', x);\r\n        rect.setAttribute('y', y);\r\n        rect.setAttribute('width', width);\r\n        rect.setAttribute('height', barHeight - barPadding);\r\n        rect.setAttribute('fill', this.getColor(node));\r\n        rect.setAttribute('stroke', '#fff');\r\n        rect.setAttribute('stroke-width', '0.5');\r\n        rect.style.cursor = 'pointer';\r\n\r\n        // Add interactivity\r\n        rect.addEventListener('mouseenter', (e) => this.showTooltip(e, node));\r\n        rect.addEventListener('mouseleave', () => this.hideTooltip());\r\n        rect.addEventListener('click', () => this.selectNode(node));\r\n\r\n        this.svg.appendChild(rect);\r\n\r\n        // Create text label\r\n        const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');\r\n        text.setAttribute('x', x + 4);\r\n        text.setAttribute('y', y + barHeight / 2 + 4);\r\n        text.setAttribute('fill', this.getTextColor(node));\r\n        text.setAttribute('pointer-events', 'none');\r\n        text.textContent = this.truncateText(node.name, width);\r\n\r\n        this.svg.appendChild(text);\r\n\r\n        // Render children\r\n        if (node.children && node.children.length > 0) {\r\n            let childX = x;\r\n            const childY = y + barHeight;\r\n\r\n            for (const child of node.children) {\r\n                const childWidth = (child.value / node.value) * width;\r\n                this.renderNode(child, childX, childY, childWidth, totalValue);\r\n                childX += childWidth;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Calculate total value in tree\r\n     * @private\r\n     */\r\n    calculateTotalValue(node) {\r\n        if (!node.children || node.children.length === 0) {\r\n            return node.value;\r\n        }\r\n\r\n        return node.children.reduce((sum, child) => {\r\n            return sum + this.calculateTotalValue(child);\r\n        }, 0);\r\n    }\r\n\r\n    /**\r\n     * Get color for node based on color scheme\r\n     * @private\r\n     */\r\n    getColor(node) {\r\n        if (this.options.colorScheme === 'monochrome') {\r\n            return '#3b82f6';\r\n        }\r\n\r\n        if (this.options.colorScheme === 'duration') {\r\n            // Color based on node value (duration)\r\n            const intensity = Math.min(node.value / 100, 1);\r\n            const r = Math.floor(255 * intensity);\r\n            const g = Math.floor(255 * (1 - intensity));\r\n            return `rgb(${r}, ${g}, 100)`;\r\n        }\r\n\r\n        // Category-based coloring (default)\r\n        const colorMap = {\r\n            'action': '#4CAF50',\r\n            'render': '#2196F3',\r\n            'state': '#FF9800',\r\n            'network': '#9C27B0',\r\n            'dom': '#F44336',\r\n            'compute': '#00BCD4'\r\n        };\r\n\r\n        // Determine category from function name\r\n        for (const [keyword, color] of Object.entries(colorMap)) {\r\n            if (node.name.toLowerCase().includes(keyword)) {\r\n                return color;\r\n            }\r\n        }\r\n\r\n        // Hash-based color for consistency\r\n        return this.hashColor(node.name);\r\n    }\r\n\r\n    /**\r\n     * Get text color for contrast\r\n     * @private\r\n     */\r\n    getTextColor(node) {\r\n        return '#fff'; // White text for all colors (good contrast)\r\n    }\r\n\r\n    /**\r\n     * Hash function for consistent colors\r\n     * @private\r\n     */\r\n    hashColor(str) {\r\n        let hash = 0;\r\n        for (let i = 0; i < str.length; i++) {\r\n            hash = str.charCodeAt(i) + ((hash << 5) - hash);\r\n        }\r\n\r\n        const hue = hash % 360;\r\n        return `hsl(${hue}, 70%, 50%)`;\r\n    }\r\n\r\n    /**\r\n     * Truncate text to fit width\r\n     * @private\r\n     */\r\n    truncateText(text, width) {\r\n        const charWidth = 7; // Approximate character width\r\n        const maxChars = Math.floor(width / charWidth) - 2;\r\n\r\n        if (text.length <= maxChars) {\r\n            return text;\r\n        }\r\n\r\n        return text.substring(0, maxChars) + '…';\r\n    }\r\n\r\n    /**\r\n     * Show tooltip with node information\r\n     * @private\r\n     */\r\n    showTooltip(event, node) {\r\n        const percentage = this.data\r\n            ? ((node.value / this.calculateTotalValue(this.data)) * 100).toFixed(2)\r\n            : '0';\r\n\r\n        this.tooltip.innerHTML = `\r\n            <strong>${node.name}</strong><br>\r\n            Time: ${node.value.toFixed(2)}ms<br>\r\n            ${percentage}% of total<br>\r\n            ${node.children ? `${node.children.length} child(ren)` : 'Leaf node'}\r\n        `;\r\n\r\n        this.tooltip.style.display = 'block';\r\n        this.tooltip.style.left = `${event.pageX + 10}px`;\r\n        this.tooltip.style.top = `${event.pageY + 10}px`;\r\n    }\r\n\r\n    /**\r\n     * Hide tooltip\r\n     * @private\r\n     */\r\n    hideTooltip() {\r\n        this.tooltip.style.display = 'none';\r\n    }\r\n\r\n    /**\r\n     * Select node (zoom/highlight)\r\n     * @private\r\n     */\r\n    selectNode(node) {\r\n        this.selectedNode = node;\r\n        console.log('[Flamegraph] Selected node:', node);\r\n\r\n        // Could implement zoom functionality here\r\n        // this.render(node);\r\n    }\r\n\r\n    /**\r\n     * Clear flamegraph\r\n     */\r\n    clear() {\r\n        while (this.svg.firstChild) {\r\n            this.svg.removeChild(this.svg.firstChild);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Export flamegraph as SVG\r\n     * @returns {string} SVG string\r\n     */\r\n    exportSVG() {\r\n        return this.svg.outerHTML;\r\n    }\r\n\r\n    /**\r\n     * Export flamegraph as PNG\r\n     * @returns {Promise<Blob>} PNG image blob\r\n     */\r\n    async exportPNG() {\r\n        const svgData = new XMLSerializer().serializeToString(this.svg);\r\n        const canvas = document.createElement('canvas');\r\n        canvas.width = this.options.width;\r\n        canvas.height = this.options.height;\r\n\r\n        const ctx = canvas.getContext('2d');\r\n        const img = new Image();\r\n\r\n        return new Promise((resolve, reject) => {\r\n            img.onload = () => {\r\n                ctx.drawImage(img, 0, 0);\r\n                canvas.toBlob(resolve, 'image/png');\r\n            };\r\n            img.onerror = reject;\r\n            img.src = 'data:image/svg+xml;base64,' + btoa(svgData);\r\n        });\r\n    }\r\n}\r\n\r\n/**\r\n * Timeline Visualizer\r\n *\r\n * Renders interactive timeline from profiling events\r\n */\r\nexport class TimelineVisualizer {\r\n    constructor(container, options = {}) {\r\n        this.container = typeof container === 'string'\r\n            ? document.querySelector(container)\r\n            : container;\r\n\r\n        if (!this.container) {\r\n            throw new Error('Container element not found');\r\n        }\r\n\r\n        this.options = {\r\n            width: options.width ?? this.container.clientWidth,\r\n            height: options.height ?? 200,\r\n            trackHeight: options.trackHeight ?? 30,\r\n            padding: options.padding ?? { top: 20, right: 20, bottom: 30, left: 60 },\r\n            ...options\r\n        };\r\n\r\n        this.events = [];\r\n        this.canvas = null;\r\n        this.ctx = null;\r\n        this.tooltip = null;\r\n        this.scale = { x: 1, y: 1 };\r\n        this.offset = { x: 0, y: 0 };\r\n\r\n        this.init();\r\n    }\r\n\r\n    /**\r\n     * Initialize canvas\r\n     * @private\r\n     */\r\n    init() {\r\n        // Create canvas\r\n        this.canvas = document.createElement('canvas');\r\n        this.canvas.width = this.options.width;\r\n        this.canvas.height = this.options.height;\r\n        this.canvas.style.cursor = 'crosshair';\r\n\r\n        this.ctx = this.canvas.getContext('2d');\r\n\r\n        // Create tooltip\r\n        this.tooltip = document.createElement('div');\r\n        this.tooltip.style.position = 'absolute';\r\n        this.tooltip.style.padding = '8px';\r\n        this.tooltip.style.background = 'rgba(0, 0, 0, 0.8)';\r\n        this.tooltip.style.color = 'white';\r\n        this.tooltip.style.borderRadius = '4px';\r\n        this.tooltip.style.pointerEvents = 'none';\r\n        this.tooltip.style.display = 'none';\r\n        this.tooltip.style.zIndex = '1000';\r\n        this.tooltip.style.fontSize = '12px';\r\n\r\n        this.container.style.position = 'relative';\r\n        this.container.appendChild(this.canvas);\r\n        this.container.appendChild(this.tooltip);\r\n\r\n        // Add mouse events\r\n        this.canvas.addEventListener('mousemove', this.handleMouseMove.bind(this));\r\n        this.canvas.addEventListener('mouseleave', this.handleMouseLeave.bind(this));\r\n    }\r\n\r\n    /**\r\n     * Render timeline from events\r\n     * @param {Array} events - Timeline events\r\n     */\r\n    render(events) {\r\n        this.events = events;\r\n        this.clear();\r\n\r\n        if (!events || events.length === 0) {\r\n            return;\r\n        }\r\n\r\n        // Calculate time range\r\n        const times = events.map(e => e.timestamp || e.relativeTime || 0);\r\n        const minTime = Math.min(...times);\r\n        const maxTime = Math.max(...times);\r\n        const duration = maxTime - minTime;\r\n\r\n        // Calculate scale\r\n        const { padding } = this.options;\r\n        const plotWidth = this.options.width - padding.left - padding.right;\r\n        const plotHeight = this.options.height - padding.top - padding.bottom;\r\n\r\n        this.scale.x = plotWidth / duration;\r\n\r\n        // Draw axes\r\n        this.drawAxes(minTime, maxTime, duration);\r\n\r\n        // Draw events\r\n        const tracks = this.organizeIntoTracks(events);\r\n        this.scale.y = plotHeight / tracks.length;\r\n\r\n        tracks.forEach((track, index) => {\r\n            track.forEach(event => {\r\n                this.drawEvent(event, index, minTime);\r\n            });\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Organize events into non-overlapping tracks\r\n     * @private\r\n     */\r\n    organizeIntoTracks(events) {\r\n        const tracks = [];\r\n        const sortedEvents = [...events].sort((a, b) => {\r\n            const aTime = a.timestamp || a.relativeTime || 0;\r\n            const bTime = b.timestamp || b.relativeTime || 0;\r\n            return aTime - bTime;\r\n        });\r\n\r\n        for (const event of sortedEvents) {\r\n            const eventStart = event.timestamp || event.relativeTime || 0;\r\n            const eventEnd = event.type === 'measure'\r\n                ? eventStart + event.duration\r\n                : eventStart + 0.1;\r\n\r\n            // Find track where event fits\r\n            let placed = false;\r\n            for (const track of tracks) {\r\n                const conflicts = track.some(e => {\r\n                    const eStart = e.timestamp || e.relativeTime || 0;\r\n                    const eEnd = e.type === 'measure'\r\n                        ? eStart + e.duration\r\n                        : eStart + 0.1;\r\n                    return eventStart < eEnd && eventEnd > eStart;\r\n                });\r\n\r\n                if (!conflicts) {\r\n                    track.push(event);\r\n                    placed = true;\r\n                    break;\r\n                }\r\n            }\r\n\r\n            if (!placed) {\r\n                tracks.push([event]);\r\n            }\r\n        }\r\n\r\n        return tracks;\r\n    }\r\n\r\n    /**\r\n     * Draw axes and grid\r\n     * @private\r\n     */\r\n    drawAxes(minTime, maxTime, duration) {\r\n        const { padding } = this.options;\r\n        const { ctx } = this;\r\n\r\n        ctx.strokeStyle = '#ccc';\r\n        ctx.lineWidth = 1;\r\n\r\n        // Y-axis\r\n        ctx.beginPath();\r\n        ctx.moveTo(padding.left, padding.top);\r\n        ctx.lineTo(padding.left, this.options.height - padding.bottom);\r\n        ctx.stroke();\r\n\r\n        // X-axis\r\n        ctx.beginPath();\r\n        ctx.moveTo(padding.left, this.options.height - padding.bottom);\r\n        ctx.lineTo(this.options.width - padding.right, this.options.height - padding.bottom);\r\n        ctx.stroke();\r\n\r\n        // Time labels\r\n        ctx.fillStyle = '#666';\r\n        ctx.font = '10px monospace';\r\n        ctx.textAlign = 'center';\r\n\r\n        const numLabels = 5;\r\n        for (let i = 0; i <= numLabels; i++) {\r\n            const time = minTime + (duration / numLabels) * i;\r\n            const x = padding.left + (time - minTime) * this.scale.x;\r\n            const y = this.options.height - padding.bottom + 15;\r\n\r\n            ctx.fillText(`${time.toFixed(1)}ms`, x, y);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Draw a single event\r\n     * @private\r\n     */\r\n    drawEvent(event, trackIndex, minTime) {\r\n        const { padding } = this.options;\r\n        const { ctx } = this;\r\n\r\n        const startTime = event.timestamp || event.relativeTime || 0;\r\n        const x = padding.left + (startTime - minTime) * this.scale.x;\r\n        const y = padding.top + trackIndex * this.scale.y;\r\n        const height = this.scale.y - 4;\r\n\r\n        if (event.type === 'mark') {\r\n            // Draw mark as vertical line\r\n            ctx.strokeStyle = event.color || '#2196F3';\r\n            ctx.lineWidth = 2;\r\n            ctx.beginPath();\r\n            ctx.moveTo(x, y);\r\n            ctx.lineTo(x, y + height);\r\n            ctx.stroke();\r\n\r\n            // Draw marker\r\n            ctx.fillStyle = event.color || '#2196F3';\r\n            ctx.beginPath();\r\n            ctx.arc(x, y + height / 2, 4, 0, Math.PI * 2);\r\n            ctx.fill();\r\n        } else if (event.type === 'measure') {\r\n            // Draw measure as rectangle\r\n            const width = Math.max(event.duration * this.scale.x, 2);\r\n\r\n            ctx.fillStyle = event.color || '#4CAF50';\r\n            ctx.fillRect(x, y, width, height);\r\n\r\n            ctx.strokeStyle = '#fff';\r\n            ctx.lineWidth = 0.5;\r\n            ctx.strokeRect(x, y, width, height);\r\n\r\n            // Draw label if wide enough\r\n            if (width > 30) {\r\n                ctx.fillStyle = '#fff';\r\n                ctx.font = '10px monospace';\r\n                ctx.textAlign = 'left';\r\n                ctx.fillText(event.name, x + 4, y + height / 2 + 4);\r\n            }\r\n        }\r\n\r\n        // Store event bounds for hover detection\r\n        event._bounds = {\r\n            x,\r\n            y,\r\n            width: event.type === 'measure' ? event.duration * this.scale.x : 8,\r\n            height\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Handle mouse move for tooltip\r\n     * @private\r\n     */\r\n    handleMouseMove(e) {\r\n        const rect = this.canvas.getBoundingClientRect();\r\n        const mouseX = e.clientX - rect.left;\r\n        const mouseY = e.clientY - rect.top;\r\n\r\n        // Find hovered event\r\n        const hoveredEvent = this.events.find(event => {\r\n            if (!event._bounds) return false;\r\n            const { x, y, width, height } = event._bounds;\r\n            return mouseX >= x && mouseX <= x + width &&\r\n                   mouseY >= y && mouseY <= y + height;\r\n        });\r\n\r\n        if (hoveredEvent) {\r\n            this.showTooltip(e, hoveredEvent);\r\n        } else {\r\n            this.hideTooltip();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Handle mouse leave\r\n     * @private\r\n     */\r\n    handleMouseLeave() {\r\n        this.hideTooltip();\r\n    }\r\n\r\n    /**\r\n     * Show tooltip with event information\r\n     * @private\r\n     */\r\n    showTooltip(event, timelineEvent) {\r\n        const time = timelineEvent.timestamp || timelineEvent.relativeTime || 0;\r\n\r\n        this.tooltip.innerHTML = `\r\n            <strong>${timelineEvent.name}</strong><br>\r\n            Type: ${timelineEvent.type}<br>\r\n            Time: ${time.toFixed(2)}ms<br>\r\n            ${timelineEvent.duration ? `Duration: ${timelineEvent.duration.toFixed(2)}ms` : ''}\r\n        `;\r\n\r\n        this.tooltip.style.display = 'block';\r\n        this.tooltip.style.left = `${event.pageX + 10}px`;\r\n        this.tooltip.style.top = `${event.pageY + 10}px`;\r\n    }\r\n\r\n    /**\r\n     * Hide tooltip\r\n     * @private\r\n     */\r\n    hideTooltip() {\r\n        this.tooltip.style.display = 'none';\r\n    }\r\n\r\n    /**\r\n     * Clear timeline\r\n     */\r\n    clear() {\r\n        this.ctx.clearRect(0, 0, this.options.width, this.options.height);\r\n    }\r\n\r\n    /**\r\n     * Export timeline as PNG\r\n     * @returns {Promise<Blob>} PNG image blob\r\n     */\r\n    async exportPNG() {\r\n        return new Promise((resolve) => {\r\n            this.canvas.toBlob(resolve, 'image/png');\r\n        });\r\n    }\r\n}\r\n\r\nexport default { FlamegraphVisualizer, TimelineVisualizer };\r\n","/**\r\n * Performance Profiler Module\r\n *\r\n * Provides performance profiling with flamegraph and timeline visualization\r\n * for LiveComponents and general application performance analysis.\r\n *\r\n * @module performance-profiler\r\n */\r\n\r\nimport { PerformanceProfiler, LiveComponentsProfiler } from './profiler.js';\r\nimport { FlamegraphVisualizer, TimelineVisualizer } from './visualizer.js';\r\n\r\nexport const definition = {\r\n    name: 'performance-profiler',\r\n    version: '1.0.0',\r\n    dependencies: [],\r\n    provides: ['performance-profiling', 'flamegraph', 'timeline'],\r\n    priority: 0\r\n};\r\n\r\nlet globalProfiler = null;\r\nlet flamegraphViz = null;\r\nlet timelineViz = null;\r\n\r\n/**\r\n * Initialize performance profiler module\r\n * @param {Object} config - Module configuration\r\n * @param {Object} state - Module state manager\r\n */\r\nexport async function init(config = {}, state) {\r\n    console.log('[PerformanceProfiler] Initializing performance profiler module');\r\n\r\n    const enabled = config.enabled ?? false;\r\n\r\n    // Create global profiler instance\r\n    globalProfiler = new PerformanceProfiler({\r\n        enabled,\r\n        maxSamples: config.maxSamples ?? 1000,\r\n        samplingInterval: config.samplingInterval ?? 10,\r\n        autoStart: config.autoStart ?? false\r\n    });\r\n\r\n    // Initialize visualizers if containers exist\r\n    if (config.flamegraphContainer) {\r\n        const container = document.querySelector(config.flamegraphContainer);\r\n        if (container) {\r\n            flamegraphViz = new FlamegraphVisualizer(container, config.flamegraph ?? {});\r\n            console.log('[PerformanceProfiler] Flamegraph visualizer initialized');\r\n        }\r\n    }\r\n\r\n    if (config.timelineContainer) {\r\n        const container = document.querySelector(config.timelineContainer);\r\n        if (container) {\r\n            timelineViz = new TimelineVisualizer(container, config.timeline ?? {});\r\n            console.log('[PerformanceProfiler] Timeline visualizer initialized');\r\n        }\r\n    }\r\n\r\n    // Expose global API\r\n    if (typeof window !== 'undefined') {\r\n        window.PerformanceProfiler = {\r\n            profiler: globalProfiler,\r\n            flamegraph: flamegraphViz,\r\n            timeline: timelineViz,\r\n\r\n            // Convenience methods\r\n            start: () => globalProfiler.start(),\r\n            stop: () => {\r\n                const results = globalProfiler.stop();\r\n                if (results) {\r\n                    console.log('[PerformanceProfiler] Profiling results:', results);\r\n\r\n                    // Auto-render visualizations if available\r\n                    if (flamegraphViz) {\r\n                        const flamegraphData = globalProfiler.generateFlamegraph();\r\n                        flamegraphViz.render(flamegraphData);\r\n                    }\r\n\r\n                    if (timelineViz) {\r\n                        const timelineData = globalProfiler.generateTimeline();\r\n                        timelineViz.render(timelineData);\r\n                    }\r\n                }\r\n                return results;\r\n            },\r\n\r\n            mark: (name, metadata) => globalProfiler.mark(name, metadata),\r\n            measure: (name, start, end) => globalProfiler.measure(name, start, end),\r\n\r\n            exportChromeTrace: () => globalProfiler.exportToChromeTrace(),\r\n\r\n            createComponentProfiler: (component, options) => {\r\n                return new LiveComponentsProfiler(component, {\r\n                    ...options,\r\n                    enabled: enabled || options?.enabled\r\n                });\r\n            }\r\n        };\r\n\r\n        console.log('[PerformanceProfiler] Global API available at window.PerformanceProfiler');\r\n    }\r\n\r\n    // Auto-instrument LiveComponents if available\r\n    if (typeof window !== 'undefined' && window.LiveComponents && config.autoInstrument !== false) {\r\n        instrumentLiveComponents();\r\n    }\r\n\r\n    console.log('[PerformanceProfiler] Module initialized');\r\n}\r\n\r\n/**\r\n * Auto-instrument all LiveComponents\r\n * @private\r\n */\r\nfunction instrumentLiveComponents() {\r\n    const liveComponents = window.LiveComponents;\r\n\r\n    if (!liveComponents || !liveComponents.registry) {\r\n        console.warn('[PerformanceProfiler] LiveComponents not available for instrumentation');\r\n        return;\r\n    }\r\n\r\n    // Instrument existing components\r\n    for (const [id, component] of liveComponents.registry.entries()) {\r\n        const profiler = new LiveComponentsProfiler(component, {\r\n            enabled: true\r\n        });\r\n\r\n        // Store profiler reference\r\n        component._profiler = profiler;\r\n\r\n        console.log(`[PerformanceProfiler] Instrumented component: ${id}`);\r\n    }\r\n\r\n    // Instrument future components\r\n    const originalRegister = liveComponents.register.bind(liveComponents);\r\n    liveComponents.register = (id, component) => {\r\n        const result = originalRegister(id, component);\r\n\r\n        const profiler = new LiveComponentsProfiler(component, {\r\n            enabled: true\r\n        });\r\n\r\n        component._profiler = profiler;\r\n\r\n        console.log(`[PerformanceProfiler] Instrumented component: ${id}`);\r\n\r\n        return result;\r\n    };\r\n\r\n    console.log('[PerformanceProfiler] LiveComponents instrumentation enabled');\r\n}\r\n\r\n/**\r\n * Destroy performance profiler module\r\n */\r\nexport function destroy() {\r\n    if (globalProfiler) {\r\n        globalProfiler.clear();\r\n    }\r\n\r\n    if (flamegraphViz) {\r\n        flamegraphViz.clear();\r\n    }\r\n\r\n    if (timelineViz) {\r\n        timelineViz.clear();\r\n    }\r\n\r\n    if (typeof window !== 'undefined') {\r\n        delete window.PerformanceProfiler;\r\n    }\r\n\r\n    console.log('[PerformanceProfiler] Module destroyed');\r\n}\r\n\r\n// Export classes for advanced usage\r\nexport { PerformanceProfiler, LiveComponentsProfiler, FlamegraphVisualizer, TimelineVisualizer };\r\n\r\nexport default { init, destroy, definition };\r\n","/**\r\n * Route Guard\r\n * \r\n * Provides route-level access control and guards.\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * RouteGuard - Route access control\r\n */\r\nexport class RouteGuard {\r\n    constructor(name, guardFn) {\r\n        this.name = name;\r\n        this.guardFn = guardFn;\r\n    }\r\n    \r\n    /**\r\n     * Create a new RouteGuard\r\n     */\r\n    static create(name, guardFn) {\r\n        return new RouteGuard(name, guardFn);\r\n    }\r\n    \r\n    /**\r\n     * Execute guard\r\n     */\r\n    async execute(to, from, context = {}) {\r\n        try {\r\n            const result = await this.guardFn(to, from, context);\r\n            return {\r\n                allowed: result !== false && result !== null,\r\n                redirect: typeof result === 'string' ? result : null,\r\n                reason: typeof result === 'object' && result.reason ? result.reason : null\r\n            };\r\n        } catch (error) {\r\n            Logger.error(`[RouteGuard] Guard \"${this.name}\" error:`, error);\r\n            return {\r\n                allowed: false,\r\n                redirect: null,\r\n                reason: error.message\r\n            };\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Built-in guards\r\n */\r\nexport const BuiltInGuards = {\r\n    /**\r\n     * Require authentication\r\n     */\r\n    auth: RouteGuard.create('auth', async (to, from) => {\r\n        // Check if user is authenticated\r\n        // This would need to be implemented based on your auth system\r\n        const isAuthenticated = checkAuth(); // Placeholder\r\n        if (!isAuthenticated) {\r\n            return '/login';\r\n        }\r\n        return true;\r\n    }),\r\n    \r\n    /**\r\n     * Require guest (not authenticated)\r\n     */\r\n    guest: RouteGuard.create('guest', async (to, from) => {\r\n        const isAuthenticated = checkAuth(); // Placeholder\r\n        if (isAuthenticated) {\r\n            return '/';\r\n        }\r\n        return true;\r\n    }),\r\n    \r\n    /**\r\n     * Require specific role\r\n     */\r\n    role: (requiredRole) => RouteGuard.create('role', async (to, from) => {\r\n        const userRole = getUserRole(); // Placeholder\r\n        if (userRole !== requiredRole) {\r\n            return '/unauthorized';\r\n        }\r\n        return true;\r\n    }),\r\n    \r\n    /**\r\n     * Require permission\r\n     */\r\n    permission: (requiredPermission) => RouteGuard.create('permission', async (to, from) => {\r\n        const hasPermission = checkPermission(requiredPermission); // Placeholder\r\n        if (!hasPermission) {\r\n            return '/unauthorized';\r\n        }\r\n        return true;\r\n    })\r\n};\r\n\r\n// Placeholder functions (would be implemented based on auth system)\r\nfunction checkAuth() {\r\n    // Implementation depends on auth system\r\n    return false;\r\n}\r\n\r\nfunction getUserRole() {\r\n    // Implementation depends on auth system\r\n    return null;\r\n}\r\n\r\nfunction checkPermission(permission) {\r\n    // Implementation depends on auth system\r\n    return false;\r\n}\r\n\r\n","/**\r\n * Route Middleware\r\n * \r\n * Provides route-level middleware for cross-cutting concerns.\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * RouteMiddleware - Route middleware\r\n */\r\nexport class RouteMiddleware {\r\n    constructor(name, middlewareFn) {\r\n        this.name = name;\r\n        this.middlewareFn = middlewareFn;\r\n    }\r\n    \r\n    /**\r\n     * Create a new RouteMiddleware\r\n     */\r\n    static create(name, middlewareFn) {\r\n        return new RouteMiddleware(name, middlewareFn);\r\n    }\r\n    \r\n    /**\r\n     * Execute middleware\r\n     */\r\n    async execute(to, from, next, context = {}) {\r\n        try {\r\n            await this.middlewareFn(to, from, next, context);\r\n        } catch (error) {\r\n            Logger.error(`[RouteMiddleware] Middleware \"${this.name}\" error:`, error);\r\n            next(false); // Block navigation\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Built-in middleware\r\n */\r\nexport const BuiltInMiddleware = {\r\n    /**\r\n     * Analytics middleware\r\n     */\r\n    analytics: RouteMiddleware.create('analytics', async (to, from, next) => {\r\n        // Track page view\r\n        if (typeof window !== 'undefined' && window.analytics) {\r\n            window.analytics.track('page_view', {\r\n                path: to.path,\r\n                title: to.title\r\n            });\r\n        }\r\n        next();\r\n    }),\r\n    \r\n    /**\r\n     * Loading middleware\r\n     */\r\n    loading: RouteMiddleware.create('loading', async (to, from, next) => {\r\n        // Show loading indicator\r\n        document.body.classList.add('route-loading');\r\n        next();\r\n        \r\n        // Hide loading indicator after navigation\r\n        setTimeout(() => {\r\n            document.body.classList.remove('route-loading');\r\n        }, 100);\r\n    }),\r\n    \r\n    /**\r\n     * Scroll to top middleware\r\n     */\r\n    scrollToTop: RouteMiddleware.create('scroll-to-top', async (to, from, next) => {\r\n        next();\r\n        window.scrollTo({ top: 0, behavior: 'smooth' });\r\n    })\r\n};\r\n\r\n","/**\r\n * Enhanced Router\r\n * \r\n * Provides enhanced routing with guards, middleware, lazy loading, and analytics.\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { RouteGuard, BuiltInGuards } from './RouteGuard.js';\r\nimport { RouteMiddleware, BuiltInMiddleware } from './RouteMiddleware.js';\r\n\r\n/**\r\n * Router - Enhanced routing system\r\n */\r\nexport class Router {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            mode: config.mode || 'history', // 'history' | 'hash'\r\n            base: config.base || '/',\r\n            enableAnalytics: config.enableAnalytics ?? true,\r\n            ...config\r\n        };\r\n        \r\n        this.routes = new Map();\r\n        this.guards = new Map();\r\n        this.middleware = [];\r\n        this.beforeEachHooks = [];\r\n        this.afterEachHooks = [];\r\n        this.currentRoute = null;\r\n        this.analytics = {\r\n            navigations: [],\r\n            errors: []\r\n        };\r\n        \r\n        // Initialize\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Create a new Router instance\r\n     */\r\n    static create(config = {}) {\r\n        return new Router(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize router\r\n     */\r\n    init() {\r\n        // Handle browser navigation\r\n        window.addEventListener('popstate', (event) => {\r\n            this.handlePopState(event);\r\n        });\r\n        \r\n        Logger.info('[Router] Initialized', {\r\n            mode: this.config.mode,\r\n            base: this.config.base\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Register a route\r\n     */\r\n    route(path, config) {\r\n        const route = {\r\n            path: this.normalizePath(path),\r\n            component: config.component,\r\n            name: config.name || path,\r\n            title: config.title || null,\r\n            meta: config.meta || {},\r\n            guards: config.guards || [],\r\n            middleware: config.middleware || [],\r\n            lazy: config.lazy ?? false,\r\n            ...config\r\n        };\r\n        \r\n        this.routes.set(route.path, route);\r\n        \r\n        Logger.debug('[Router] Route registered', route);\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Register multiple routes\r\n     */\r\n    routes(routesConfig) {\r\n        routesConfig.forEach(route => {\r\n            this.route(route.path, route);\r\n        });\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Register a guard\r\n     */\r\n    guard(name, guardFn) {\r\n        const guard = RouteGuard.create(name, guardFn);\r\n        this.guards.set(name, guard);\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Register middleware\r\n     */\r\n    use(middleware) {\r\n        if (typeof middleware === 'function') {\r\n            this.middleware.push(RouteMiddleware.create('anonymous', middleware));\r\n        } else if (middleware instanceof RouteMiddleware) {\r\n            this.middleware.push(middleware);\r\n        } else if (typeof middleware === 'string' && BuiltInMiddleware[middleware]) {\r\n            this.middleware.push(BuiltInMiddleware[middleware]);\r\n        }\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Add beforeEach hook\r\n     */\r\n    beforeEach(hook) {\r\n        this.beforeEachHooks.push(hook);\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Add afterEach hook\r\n     */\r\n    afterEach(hook) {\r\n        this.afterEachHooks.push(hook);\r\n        return this;\r\n    }\r\n    \r\n    /**\r\n     * Navigate to a route\r\n     */\r\n    async navigate(path, options = {}) {\r\n        const normalizedPath = this.normalizePath(path);\r\n        const route = this.routes.get(normalizedPath);\r\n        \r\n        if (!route) {\r\n            Logger.warn('[Router] Route not found', normalizedPath);\r\n            return false;\r\n        }\r\n        \r\n        const from = this.currentRoute;\r\n        const to = {\r\n            path: normalizedPath,\r\n            name: route.name,\r\n            title: route.title,\r\n            meta: route.meta,\r\n            component: route.component\r\n        };\r\n        \r\n        // Execute beforeEach hooks\r\n        for (const hook of this.beforeEachHooks) {\r\n            const result = await hook(to, from);\r\n            if (result === false || typeof result === 'string') {\r\n                if (typeof result === 'string') {\r\n                    return await this.navigate(result);\r\n                }\r\n                return false;\r\n            }\r\n        }\r\n        \r\n        // Execute guards\r\n        for (const guardName of route.guards) {\r\n            const guard = this.guards.get(guardName) || BuiltInGuards[guardName];\r\n            if (!guard) {\r\n                Logger.warn('[Router] Guard not found', guardName);\r\n                continue;\r\n            }\r\n            \r\n            const result = await guard.execute(to, from);\r\n            if (!result.allowed) {\r\n                if (result.redirect) {\r\n                    return await this.navigate(result.redirect);\r\n                }\r\n                Logger.warn('[Router] Navigation blocked by guard', guardName);\r\n                return false;\r\n            }\r\n        }\r\n        \r\n        // Execute middleware\r\n        let middlewareBlocked = false;\r\n        for (const middleware of [...this.middleware, ...route.middleware]) {\r\n            await new Promise((resolve) => {\r\n                middleware.execute(to, from, (allowed) => {\r\n                    if (allowed === false) {\r\n                        middlewareBlocked = true;\r\n                    }\r\n                    resolve();\r\n                });\r\n            });\r\n            \r\n            if (middlewareBlocked) {\r\n                return false;\r\n            }\r\n        }\r\n        \r\n        // Load component if lazy\r\n        if (route.lazy && typeof route.component === 'function') {\r\n            try {\r\n                route.component = await route.component();\r\n            } catch (error) {\r\n                Logger.error('[Router] Failed to load lazy component', error);\r\n                return false;\r\n            }\r\n        }\r\n        \r\n        // Update current route\r\n        this.currentRoute = to;\r\n        \r\n        // Update browser history\r\n        if (this.config.mode === 'history') {\r\n            history.pushState({ route: to }, route.title || '', normalizedPath);\r\n        } else {\r\n            window.location.hash = normalizedPath;\r\n        }\r\n        \r\n        // Update page title\r\n        if (route.title) {\r\n            document.title = route.title;\r\n        }\r\n        \r\n        // Track analytics\r\n        if (this.config.enableAnalytics) {\r\n            this.trackNavigation(to, from);\r\n        }\r\n        \r\n        // Execute afterEach hooks\r\n        for (const hook of this.afterEachHooks) {\r\n            await hook(to, from);\r\n        }\r\n        \r\n        // Render component\r\n        await this.renderComponent(route, options);\r\n        \r\n        Logger.info('[Router] Navigated', { to: normalizedPath });\r\n        return true;\r\n    }\r\n    \r\n    /**\r\n     * Render component\r\n     */\r\n    async renderComponent(route, options = {}) {\r\n        const container = options.container || document.querySelector('main');\r\n        \r\n        if (!container) {\r\n            Logger.error('[Router] Container not found');\r\n            return;\r\n        }\r\n        \r\n        if (typeof route.component === 'function') {\r\n            // Component is a function (render function)\r\n            const content = await route.component(route, options);\r\n            if (typeof content === 'string') {\r\n                container.innerHTML = content;\r\n            } else if (content instanceof HTMLElement) {\r\n                container.innerHTML = '';\r\n                container.appendChild(content);\r\n            }\r\n        } else if (typeof route.component === 'string') {\r\n            // Component is a selector or HTML\r\n            const element = document.querySelector(route.component);\r\n            if (element) {\r\n                container.innerHTML = '';\r\n                container.appendChild(element.cloneNode(true));\r\n            } else {\r\n                container.innerHTML = route.component;\r\n            }\r\n        }\r\n        \r\n        // Re-initialize modules in new content\r\n        this.reinitializeModules(container);\r\n    }\r\n    \r\n    /**\r\n     * Re-initialize modules in container\r\n     */\r\n    reinitializeModules(container) {\r\n        // Trigger module re-initialization\r\n        const event = new CustomEvent('router:content-updated', {\r\n            detail: { container },\r\n            bubbles: true\r\n        });\r\n        document.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Handle popstate event\r\n     */\r\n    handlePopState(event) {\r\n        const path = this.config.mode === 'history' \r\n            ? window.location.pathname \r\n            : window.location.hash.slice(1);\r\n        \r\n        this.navigate(path, { updateHistory: false });\r\n    }\r\n    \r\n    /**\r\n     * Normalize path\r\n     */\r\n    normalizePath(path) {\r\n        // Remove base if present\r\n        if (path.startsWith(this.config.base)) {\r\n            path = path.slice(this.config.base.length);\r\n        }\r\n        \r\n        // Ensure leading slash\r\n        if (!path.startsWith('/')) {\r\n            path = '/' + path;\r\n        }\r\n        \r\n        // Remove trailing slash (except root)\r\n        if (path !== '/' && path.endsWith('/')) {\r\n            path = path.slice(0, -1);\r\n        }\r\n        \r\n        return path;\r\n    }\r\n    \r\n    /**\r\n     * Track navigation for analytics\r\n     */\r\n    trackNavigation(to, from) {\r\n        const navigation = {\r\n            to: to.path,\r\n            from: from?.path || null,\r\n            timestamp: Date.now(),\r\n            duration: from ? Date.now() - (from.timestamp || Date.now()) : 0\r\n        };\r\n        \r\n        this.analytics.navigations.push(navigation);\r\n        \r\n        // Limit analytics size\r\n        if (this.analytics.navigations.length > 100) {\r\n            this.analytics.navigations.shift();\r\n        }\r\n        \r\n        // Trigger analytics event\r\n        const event = new CustomEvent('router:navigation', {\r\n            detail: navigation,\r\n            bubbles: true\r\n        });\r\n        window.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Get current route\r\n     */\r\n    getCurrentRoute() {\r\n        return this.currentRoute;\r\n    }\r\n    \r\n    /**\r\n     * Get analytics\r\n     */\r\n    getAnalytics() {\r\n        return {\r\n            ...this.analytics,\r\n            totalNavigations: this.analytics.navigations.length,\r\n            totalErrors: this.analytics.errors.length\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Destroy router\r\n     */\r\n    destroy() {\r\n        this.routes.clear();\r\n        this.guards.clear();\r\n        this.middleware = [];\r\n        this.beforeEachHooks = [];\r\n        this.afterEachHooks = [];\r\n        this.currentRoute = null;\r\n        \r\n        Logger.info('[Router] Destroyed');\r\n    }\r\n}\r\n\r\n","/**\r\n * Router Enhancement Module\r\n * \r\n * Provides enhanced routing with guards, middleware, lazy loading, and analytics.\r\n * \r\n * Usage:\r\n * - Add data-module=\"router\" to enable enhanced router\r\n * - Or import and use directly: import { Router } from './modules/router/index.js'\r\n * \r\n * Features:\r\n * - Route guards (auth, permissions)\r\n * - Route middleware\r\n * - Lazy route loading\r\n * - Route analytics\r\n * - Integration with LiveComponents\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { Router } from './Router.js';\r\nimport { RouteGuard, BuiltInGuards } from './RouteGuard.js';\r\nimport { RouteMiddleware, BuiltInMiddleware } from './RouteMiddleware.js';\r\n\r\nconst RouterModule = {\r\n    name: 'router',\r\n    router: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[RouterModule] Module initialized');\r\n        \r\n        // Create router\r\n        this.router = Router.create(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.Router = this.router;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get router instance\r\n     */\r\n    getRouter() {\r\n        return this.router || Router.create();\r\n    },\r\n    \r\n    /**\r\n     * Register routes\r\n     */\r\n    routes(routesConfig) {\r\n        const router = this.getRouter();\r\n        router.routes(routesConfig);\r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Navigate to route\r\n     */\r\n    async navigate(path, options = {}) {\r\n        const router = this.getRouter();\r\n        return await router.navigate(path, options);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.router) {\r\n            this.router.destroy();\r\n            this.router = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.Router) {\r\n            delete window.Router;\r\n        }\r\n        \r\n        Logger.info('[RouterModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { Router, RouteGuard, RouteMiddleware, BuiltInGuards, BuiltInMiddleware };\r\n\r\n// Export as default for module system\r\nexport default RouterModule;\r\n\r\n// Export init function for module system\r\nexport const init = RouterModule.init.bind(RouterModule);\r\n\r\n","/**\n * Dependency Management System für Module\n * Verwaltet Dependencies und Initialisierungsreihenfolge\n */\nimport { Logger } from './logger.js';\n\n/**\n * @typedef {Object} ModuleDependency\n * @property {string} name - Module name\n * @property {string} version - Required version (semver)\n * @property {boolean} optional - Whether dependency is optional\n */\n\n/**\n * @typedef {Object} ModuleDefinition\n * @property {string} name - Module name\n * @property {string} version - Module version\n * @property {ModuleDependency[]} dependencies - Required dependencies\n * @property {string[]} provides - Services this module provides\n * @property {number} priority - Initialization priority (higher = earlier)\n */\n\nexport class DependencyManager {\n    constructor() {\n        /** @type {Map<string, ModuleDefinition>} */\n        this.modules = new Map();\n        \n        /** @type {Map<string, string[]>} */\n        this.dependents = new Map(); // who depends on this module\n        \n        /** @type {Set<string>} */\n        this.initialized = new Set();\n        \n        /** @type {Set<string>} */\n        this.initializing = new Set();\n        \n        /** @type {string[]} */\n        this.initializationOrder = [];\n    }\n\n    /**\n     * Register a module with its dependencies\n     * @param {ModuleDefinition} definition - Module definition\n     */\n    register(definition) {\n        if (this.modules.has(definition.name)) {\n            Logger.warn(`[DependencyManager] Module '${definition.name}' already registered`);\n            return;\n        }\n\n        // Validate definition\n        if (!this.validateDefinition(definition)) {\n            return;\n        }\n\n        this.modules.set(definition.name, definition);\n        \n        // Build dependents map\n        definition.dependencies.forEach(dep => {\n            if (!this.dependents.has(dep.name)) {\n                this.dependents.set(dep.name, []);\n            }\n            this.dependents.get(dep.name).push(definition.name);\n        });\n\n        Logger.info(`[DependencyManager] Registered '${definition.name}' v${definition.version}`);\n    }\n\n    /**\n     * Calculate initialization order based on dependencies\n     * @returns {string[]} Ordered list of module names\n     */\n    calculateInitializationOrder() {\n        const visited = new Set();\n        const visiting = new Set();\n        const order = [];\n\n        /**\n         * Depth-first search with cycle detection\n         * @param {string} moduleName \n         */\n        const visit = (moduleName) => {\n            if (visiting.has(moduleName)) {\n                throw new Error(`Circular dependency detected involving '${moduleName}'`);\n            }\n            \n            if (visited.has(moduleName)) {\n                return;\n            }\n\n            const module = this.modules.get(moduleName);\n            if (!module) {\n                return; // Module not registered, might be optional\n            }\n\n            visiting.add(moduleName);\n\n            // Visit dependencies first\n            module.dependencies.forEach(dep => {\n                if (!dep.optional || this.modules.has(dep.name)) {\n                    visit(dep.name);\n                }\n            });\n\n            visiting.delete(moduleName);\n            visited.add(moduleName);\n            order.push(moduleName);\n        };\n\n        // Sort by priority first, then resolve dependencies\n        const modulesByPriority = Array.from(this.modules.entries())\n            .sort(([, a], [, b]) => (b.priority || 0) - (a.priority || 0))\n            .map(([name]) => name);\n\n        modulesByPriority.forEach(moduleName => {\n            if (!visited.has(moduleName)) {\n                visit(moduleName);\n            }\n        });\n\n        this.initializationOrder = order;\n        Logger.info(`[DependencyManager] Initialization order: ${order.join(' → ')}`);\n        \n        return order;\n    }\n\n    /**\n     * Check if all dependencies for a module are satisfied\n     * @param {string} moduleName - Module to check\n     * @returns {Object} Dependency check result\n     */\n    checkDependencies(moduleName) {\n        const module = this.modules.get(moduleName);\n        if (!module) {\n            return { satisfied: false, missing: [], reason: `Module '${moduleName}' not registered` };\n        }\n\n        const missing = [];\n        const optional = [];\n\n        module.dependencies.forEach(dep => {\n            const depModule = this.modules.get(dep.name);\n            \n            if (!depModule) {\n                if (dep.optional) {\n                    optional.push(dep.name);\n                } else {\n                    missing.push(dep.name);\n                }\n            } else if (!this.initialized.has(dep.name)) {\n                if (!dep.optional) {\n                    missing.push(`${dep.name} (not initialized)`);\n                }\n            }\n        });\n\n        return {\n            satisfied: missing.length === 0,\n            missing,\n            optional,\n            reason: missing.length > 0 ? `Missing: ${missing.join(', ')}` : 'OK'\n        };\n    }\n\n    /**\n     * Mark module as initialized\n     * @param {string} moduleName - Module name\n     */\n    markInitialized(moduleName) {\n        this.initialized.add(moduleName);\n        this.initializing.delete(moduleName);\n        Logger.info(`[DependencyManager] '${moduleName}' initialized`);\n    }\n\n    /**\n     * Mark module as initializing\n     * @param {string} moduleName - Module name\n     */\n    markInitializing(moduleName) {\n        this.initializing.add(moduleName);\n    }\n\n    /**\n     * Get modules that depend on the given module\n     * @param {string} moduleName - Module name\n     * @returns {string[]} Dependent module names\n     */\n    getDependents(moduleName) {\n        return this.dependents.get(moduleName) || [];\n    }\n\n    /**\n     * Get module definition\n     * @param {string} moduleName - Module name\n     * @returns {ModuleDefinition|undefined} Module definition\n     */\n    getModule(moduleName) {\n        return this.modules.get(moduleName);\n    }\n\n    /**\n     * Check if module is ready to initialize\n     * @param {string} moduleName - Module name\n     * @returns {boolean} Ready status\n     */\n    isReadyToInitialize(moduleName) {\n        if (this.initialized.has(moduleName) || this.initializing.has(moduleName)) {\n            return false;\n        }\n\n        const check = this.checkDependencies(moduleName);\n        return check.satisfied;\n    }\n\n    /**\n     * Get initialization status\n     * @returns {Object} Status report\n     */\n    getStatus() {\n        const total = this.modules.size;\n        const initialized = this.initialized.size;\n        const initializing = this.initializing.size;\n        const pending = total - initialized - initializing;\n\n        return {\n            total,\n            initialized,\n            initializing,\n            pending,\n            modules: {\n                initialized: Array.from(this.initialized),\n                initializing: Array.from(this.initializing),\n                pending: Array.from(this.modules.keys()).filter(name => \n                    !this.initialized.has(name) && !this.initializing.has(name)\n                )\n            }\n        };\n    }\n\n    /**\n     * Validate module definition\n     * @private\n     * @param {ModuleDefinition} definition - Module definition to validate\n     * @returns {boolean} Validation result\n     */\n    validateDefinition(definition) {\n        if (!definition.name || typeof definition.name !== 'string') {\n            Logger.error('[DependencyManager] Module name is required and must be string');\n            return false;\n        }\n\n        if (!definition.version || typeof definition.version !== 'string') {\n            Logger.error(`[DependencyManager] Version is required for module '${definition.name}'`);\n            return false;\n        }\n\n        if (!Array.isArray(definition.dependencies)) {\n            Logger.error(`[DependencyManager] Dependencies must be array for module '${definition.name}'`);\n            return false;\n        }\n\n        // Validate dependencies\n        for (const dep of definition.dependencies) {\n            if (!dep.name || typeof dep.name !== 'string') {\n                Logger.error(`[DependencyManager] Invalid dependency in module '${definition.name}': missing name`);\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n    /**\n     * Reset dependency manager\n     */\n    reset() {\n        this.modules.clear();\n        this.dependents.clear();\n        this.initialized.clear();\n        this.initializing.clear();\n        this.initializationOrder = [];\n        Logger.info('[DependencyManager] Reset complete');\n    }\n\n    /**\n     * Create module definition helper\n     * @param {string} name - Module name\n     * @param {string} version - Module version\n     * @returns {Object} Module definition builder\n     */\n    static createDefinition(name, version) {\n        const definition = {\n            name,\n            version,\n            dependencies: [],\n            provides: [],\n            priority: 0\n        };\n        \n        // Create a chainable API\n        const builder = {\n            depends(moduleName, moduleVersion = '*', optional = false) {\n                definition.dependencies.push({\n                    name: moduleName,\n                    version: moduleVersion,\n                    optional\n                });\n                return this;\n            },\n            \n            provides(...services) {\n                definition.provides.push(...services);\n                return this;\n            },\n            \n            priority(level) {\n                definition.priority = level;\n                return this;\n            },\n            \n            // Return the final definition\n            build() {\n                return definition;\n            }\n        };\n        \n        // Make the builder return the definition when accessed as an object\n        Object.setPrototypeOf(builder, definition);\n        \n        // Allow direct access to the definition properties\n        Object.keys(definition).forEach(key => {\n            if (!(key in builder)) {\n                Object.defineProperty(builder, key, {\n                    get() { return definition[key]; },\n                    set(value) { definition[key] = value; },\n                    enumerable: true,\n                    configurable: true\n                });\n            }\n        });\n        \n        return builder;\n    }\n}\n\n// Global instance\nexport const dependencyManager = new DependencyManager();\n\n// Debug access\nif (typeof window !== 'undefined') {\n    window.dependencyManager = dependencyManager;\n    window.depStatus = () => dependencyManager.getStatus();\n}","// modules/scroll-dependent/index.js\nimport { Logger } from '../../core/logger.js';\nimport { DependencyManager } from '../../core/DependencyManager.js';\n\n// Module definition with explicit dependencies\nexport const definition = DependencyManager.createDefinition('scroll-dependent', '1.0.0')\n    .depends('example-module', '1.0.0')  // Required dependency\n    .depends('scrollfx', '1.0.0', true) // Optional dependency\n    .provides('scroll-coordination')\n    .priority(10); // Lower priority = later initialization\n\nlet scrollSubscription = null;\nlet state = null;\n\n/**\n * Initialize scroll-dependent module\n * @param {Object} config - Module configuration\n * @param {Object} stateManager - Scoped state manager\n */\nexport function init(config = {}, stateManager = null) {\n    Logger.info('[scroll-dependent] init');\n    state = stateManager;\n\n    // Register own state\n    if (state) {\n        state.register('isScrolling', false);\n        state.register('scrollDirection', 'none');\n        \n        // Subscribe to dependency state\n        scrollSubscription = state.subscribe('example-module.scrollPosition', (newPos, oldPos) => {\n            if (oldPos.y !== newPos.y) {\n                const direction = newPos.y > oldPos.y ? 'down' : 'up';\n                state.set('scrollDirection', direction);\n                state.set('isScrolling', true);\n                \n                // Reset scrolling state after delay\n                setTimeout(() => {\n                    if (state) {\n                        state.set('isScrolling', false);\n                    }\n                }, 150);\n                \n                Logger.info(`[scroll-dependent] Scroll ${direction}: ${newPos.y}`);\n            }\n        });\n    }\n}\n\nexport function destroy() {\n    Logger.info('[scroll-dependent] destroy');\n    \n    if (scrollSubscription && state) {\n        state.unsubscribe(scrollSubscription);\n        scrollSubscription = null;\n    }\n    \n    if (state && typeof state.cleanup === 'function') {\n        state.cleanup();\n    }\n    state = null;\n}","// modules/scroll-loop/index.js\nimport { registerFrameTask } from '../../core/frameloop.js';\n\nexport function init(config = {}) {\n    const elements = document.querySelectorAll('[data-scroll-loop]');\n\n    elements.forEach(el => {\n        const type = el.dataset.scrollType || 'translate';\n        if (type === 'translate' && el.children.length === 1) {\n            const clone = el.firstElementChild.cloneNode(true);\n            clone.setAttribute('aria-hidden', 'true');\n            el.appendChild(clone);\n        }\n    });\n\n    registerFrameTask('scroll-loop', () => {\n        const scrollY = window.scrollY;\n        const scrollX = window.scrollX;\n\n        elements.forEach(el => {\n            const factor = parseFloat(el.dataset.scrollSpeed || config.speed || 0.2);\n            const axis = el.dataset.scrollAxis || 'y';\n            const type = el.dataset.scrollType || 'translate';\n            const pause = el.dataset.loopPause === 'true';\n            const offsetStart = parseFloat(el.dataset.loopOffset || 0);\n            const limit = parseFloat(el.dataset.loopLimit || 0);\n\n            const input = axis === 'x' ? scrollX : scrollY;\n            if (limit && input > limit) return;\n            if (pause && (el.matches(':hover') || el.matches(':active'))) return;\n\n            const offset = (input + offsetStart) * factor;\n\n            switch (type) {\n                case 'translate': {\n                    const base = axis === 'x' ? el.offsetWidth : el.offsetHeight;\n                    const value = -(offset % base);\n                    const transform = axis === 'x' ? `translateX(${value}px)` : `translateY(${value}px)`;\n                    el.style.transform = transform;\n                    break;\n                }\n                case 'rotate': {\n                    const deg = offset % 360;\n                    el.style.transform = `rotate(${deg}deg)`;\n                    break;\n                }\n                case 'background': {\n                    const pos = offset % 100;\n                    if (axis === 'x') {\n                        el.style.backgroundPosition = `${pos}% center`;\n                    } else {\n                        el.style.backgroundPosition = `center ${pos}%`;\n                    }\n                    break;\n                }\n                case 'scale': {\n                    const scale = 1 + Math.sin(offset * 0.01) * 0.1;\n                    el.style.transform = `scale(${scale.toFixed(3)})`;\n                    break;\n                }\n                default:\n                    break;\n            }\n        });\n    }, { autoStart: true });\n}\n","import { Logger } from '../../core/logger.js';\n\nexport const scrollSteps = {\n    onEnter(index, el) {\n        el.classList.add('active');\n        document.body.dataset.activeScrollStep = index;\n        Logger.info(`[ScrollStep] Enter: ${index}`);\n        // Beispielaktionen\n        if (index === 1) showIntro();\n        if (index === 2) activateChart();\n        if (index === 3) revealQuote();\n    },\n\n    onLeave(index, el) {\n        el.classList.remove('active');\n        el.style.transitionDelay = '';\n        Logger.info(`[ScrollStep] Leave: ${index}`);\n\n        if (document.body.dataset.activeScrollStep === String(index)) {\n            delete document.body.dataset.activeScrollStep;\n        }\n\n        if (index === 1) hideIntro();\n        if (index === 2) deactivateChart();\n        if (index === 3) hideQuote();\n    }\n};\n\n\nfunction showIntro()   { Logger.info('Intro sichtbar'); }\nfunction hideIntro()   { Logger.info('Intro ausgeblendet'); }\nfunction activateChart() { Logger.info('Chart aktiviert'); }\nfunction deactivateChart() { Logger.info('Chart deaktiviert'); }\nfunction revealQuote() { Logger.info('Zitat eingeblendet'); }\nfunction hideQuote()   { Logger.info('Zitat ausgeblendet'); }\n","// modules/scroll-timeline/index.js\nimport { Logger } from '../../core/logger.js';\nimport { scrollSteps } from './steps.js';\nimport {registerFrameTask, unregisterFrameTask} from '../../core/frameloop.js';\n\nexport function init(userConfig = {}) {\n    Logger.info('ScrollTimeline init');\n\n    const defaultConfig = {\n        attribute: 'data-scroll-step',\n        triggerPoint: 0.4,\n        once: true\n    };\n\n    const config = { ...defaultConfig, ...userConfig };\n\n    const steps = Array.from(document.querySelectorAll(`[${config.attribute}]`)).map(el => ({\n        el,\n        index: parseInt(el.getAttribute(config.attribute), 10),\n        active: false\n    }));\n\n    function update() {\n        const triggerY = window.innerHeight * config.triggerPoint;\n\n        steps.forEach(step => {\n            const rect = step.el.getBoundingClientRect();\n            const isVisible = rect.top < triggerY && rect.bottom > 0;\n\n            if (isVisible && !step.active) {\n                step.active = true;\n                step.el.classList.add('active');\n                Logger.log(`➡️ ENTER step ${step.index}`);\n                scrollSteps.onEnter?.(step.index, step.el);\n            }\n\n            if (!isVisible && step.active) {\n                step.active = false;\n                step.el.classList.remove('active');\n                Logger.log(`⬅️ LEAVE step ${step.index}`);\n                if (!config.once) {\n                    scrollSteps.onLeave?.(step.index, step.el);\n                }\n            }\n        });\n    }\n\n    registerFrameTask('scroll-timeline', update, { autoStart: true });\n}\n\nexport function destroy () {\n    unregisterFrameTask('scroll-timeline');\n}\n","/**\r\n * CSRF Manager\r\n * \r\n * Handles CSRF token management including automatic refresh.\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * CsrfManager - CSRF token management\r\n */\r\nexport class CsrfManager {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            tokenName: config.tokenName || '_token',\r\n            headerName: config.headerName || 'X-CSRF-TOKEN',\r\n            refreshInterval: config.refreshInterval || 30 * 60 * 1000, // 30 minutes\r\n            autoRefresh: config.autoRefresh ?? true,\r\n            endpoint: config.endpoint || '/api/csrf-token',\r\n            ...config\r\n        };\r\n        \r\n        this.currentToken = null;\r\n        this.refreshTimer = null;\r\n        this.isRefreshing = false;\r\n        \r\n        // Initialize\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Create a new CsrfManager instance\r\n     */\r\n    static create(config = {}) {\r\n        return new CsrfManager(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize CSRF manager\r\n     */\r\n    init() {\r\n        // Get initial token from meta tag or form\r\n        this.currentToken = this.getTokenFromPage();\r\n        \r\n        if (!this.currentToken) {\r\n            Logger.warn('[CsrfManager] No CSRF token found on page');\r\n        } else {\r\n            Logger.info('[CsrfManager] Initialized with token');\r\n        }\r\n        \r\n        // Set up auto-refresh if enabled\r\n        if (this.config.autoRefresh) {\r\n            this.startAutoRefresh();\r\n        }\r\n        \r\n        // Update all forms and meta tags\r\n        this.updateAllTokens();\r\n    }\r\n    \r\n    /**\r\n     * Get token from page (meta tag or form)\r\n     */\r\n    getTokenFromPage() {\r\n        // Try meta tag first\r\n        const metaTag = document.querySelector('meta[name=\"csrf-token\"]');\r\n        if (metaTag) {\r\n            return metaTag.getAttribute('content');\r\n        }\r\n        \r\n        // Try form input\r\n        const formInput = document.querySelector(`input[name=\"${this.config.tokenName}\"]`);\r\n        if (formInput) {\r\n            return formInput.value;\r\n        }\r\n        \r\n        return null;\r\n    }\r\n    \r\n    /**\r\n     * Get current CSRF token\r\n     */\r\n    getToken() {\r\n        return this.currentToken;\r\n    }\r\n    \r\n    /**\r\n     * Refresh CSRF token\r\n     */\r\n    async refreshToken() {\r\n        if (this.isRefreshing) {\r\n            Logger.debug('[CsrfManager] Token refresh already in progress');\r\n            return;\r\n        }\r\n        \r\n        this.isRefreshing = true;\r\n        \r\n        try {\r\n            const response = await fetch(this.config.endpoint, {\r\n                method: 'GET',\r\n                headers: {\r\n                    'X-Requested-With': 'XMLHttpRequest',\r\n                    'Accept': 'application/json'\r\n                }\r\n            });\r\n            \r\n            if (!response.ok) {\r\n                throw new Error(`Failed to refresh token: ${response.status}`);\r\n            }\r\n            \r\n            const data = await response.json();\r\n            const newToken = data.token || data.csrf_token || data._token;\r\n            \r\n            if (!newToken) {\r\n                throw new Error('No token in response');\r\n            }\r\n            \r\n            this.currentToken = newToken;\r\n            this.updateAllTokens();\r\n            \r\n            Logger.info('[CsrfManager] Token refreshed');\r\n            \r\n            // Trigger event\r\n            this.triggerTokenRefreshedEvent(newToken);\r\n            \r\n        } catch (error) {\r\n            Logger.error('[CsrfManager] Failed to refresh token', error);\r\n            throw error;\r\n        } finally {\r\n            this.isRefreshing = false;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Update all tokens on the page\r\n     */\r\n    updateAllTokens() {\r\n        if (!this.currentToken) {\r\n            return;\r\n        }\r\n        \r\n        // Update meta tag\r\n        const metaTag = document.querySelector('meta[name=\"csrf-token\"]');\r\n        if (metaTag) {\r\n            metaTag.setAttribute('content', this.currentToken);\r\n        }\r\n        \r\n        // Update all form inputs\r\n        const formInputs = document.querySelectorAll(`input[name=\"${this.config.tokenName}\"]`);\r\n        formInputs.forEach(input => {\r\n            input.value = this.currentToken;\r\n        });\r\n        \r\n        // Update LiveComponent tokens\r\n        const liveComponents = document.querySelectorAll('[data-live-component]');\r\n        liveComponents.forEach(element => {\r\n            const tokenInput = element.querySelector(`input[name=\"${this.config.tokenName}\"]`);\r\n            if (tokenInput) {\r\n                tokenInput.value = this.currentToken;\r\n            }\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Start auto-refresh timer\r\n     */\r\n    startAutoRefresh() {\r\n        if (this.refreshTimer) {\r\n            return;\r\n        }\r\n        \r\n        this.refreshTimer = setInterval(() => {\r\n            this.refreshToken().catch(error => {\r\n                Logger.error('[CsrfManager] Auto-refresh failed', error);\r\n            });\r\n        }, this.config.refreshInterval);\r\n        \r\n        Logger.debug('[CsrfManager] Auto-refresh started', {\r\n            interval: this.config.refreshInterval\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Stop auto-refresh timer\r\n     */\r\n    stopAutoRefresh() {\r\n        if (this.refreshTimer) {\r\n            clearInterval(this.refreshTimer);\r\n            this.refreshTimer = null;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get token for use in fetch requests\r\n     */\r\n    getTokenHeader() {\r\n        return {\r\n            [this.config.headerName]: this.currentToken\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Trigger token refreshed event\r\n     */\r\n    triggerTokenRefreshedEvent(token) {\r\n        const event = new CustomEvent('csrf:token-refreshed', {\r\n            detail: { token },\r\n            bubbles: true\r\n        });\r\n        window.dispatchEvent(event);\r\n    }\r\n    \r\n    /**\r\n     * Destroy CSRF manager\r\n     */\r\n    destroy() {\r\n        this.stopAutoRefresh();\r\n        this.currentToken = null;\r\n        Logger.info('[CsrfManager] Destroyed');\r\n    }\r\n}\r\n\r\n","/**\r\n * Security Manager\r\n * \r\n * Provides security-related utilities including CSRF, XSS protection, and CSP helpers.\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { CsrfManager } from './CsrfManager.js';\r\n\r\n/**\r\n * SecurityManager - Centralized security utilities\r\n */\r\nexport class SecurityManager {\r\n    constructor(config = {}) {\r\n        this.config = {\r\n            csrf: config.csrf || {},\r\n            xss: {\r\n                enabled: config.xss?.enabled ?? true,\r\n                sanitizeOnInput: config.xss?.sanitizeOnInput ?? false\r\n            },\r\n            csp: {\r\n                enabled: config.csp?.enabled ?? false,\r\n                reportOnly: config.csp?.reportOnly ?? false\r\n            },\r\n            ...config\r\n        };\r\n        \r\n        this.csrfManager = null;\r\n        \r\n        // Initialize\r\n        this.init();\r\n    }\r\n    \r\n    /**\r\n     * Create a new SecurityManager instance\r\n     */\r\n    static create(config = {}) {\r\n        return new SecurityManager(config);\r\n    }\r\n    \r\n    /**\r\n     * Initialize security manager\r\n     */\r\n    init() {\r\n        // Initialize CSRF manager\r\n        this.csrfManager = CsrfManager.create(this.config.csrf);\r\n        \r\n        // Initialize XSS protection if enabled\r\n        if (this.config.xss.enabled) {\r\n            this.initXssProtection();\r\n        }\r\n        \r\n        // Initialize CSP if enabled\r\n        if (this.config.csp.enabled) {\r\n            this.initCsp();\r\n        }\r\n        \r\n        Logger.info('[SecurityManager] Initialized', {\r\n            csrf: !!this.csrfManager,\r\n            xss: this.config.xss.enabled,\r\n            csp: this.config.csp.enabled\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Initialize XSS protection\r\n     */\r\n    initXssProtection() {\r\n        // Add input sanitization if enabled\r\n        if (this.config.xss.sanitizeOnInput) {\r\n            document.addEventListener('input', (event) => {\r\n                if (event.target.tagName === 'INPUT' || event.target.tagName === 'TEXTAREA') {\r\n                    this.sanitizeInput(event.target);\r\n                }\r\n            }, true);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Sanitize input value\r\n     */\r\n    sanitizeInput(element) {\r\n        const originalValue = element.value;\r\n        const sanitized = this.sanitizeHtml(originalValue);\r\n        \r\n        if (sanitized !== originalValue) {\r\n            element.value = sanitized;\r\n            Logger.warn('[SecurityManager] Sanitized potentially dangerous input', {\r\n                field: element.name || element.id\r\n            });\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Sanitize HTML string\r\n     */\r\n    sanitizeHtml(html) {\r\n        if (typeof html !== 'string') {\r\n            return html;\r\n        }\r\n        \r\n        // Remove script tags and event handlers\r\n        return html\r\n            .replace(/<script\\b[^<]*(?:(?!<\\/script>)<[^<]*)*<\\/script>/gi, '')\r\n            .replace(/on\\w+\\s*=\\s*[\"'][^\"']*[\"']/gi, '')\r\n            .replace(/javascript:/gi, '')\r\n            .replace(/data:text\\/html/gi, '');\r\n    }\r\n    \r\n    /**\r\n     * Initialize Content Security Policy\r\n     */\r\n    initCsp() {\r\n        // CSP is typically set server-side, but we can validate it client-side\r\n        const cspHeader = this.getCspHeader();\r\n        \r\n        if (cspHeader) {\r\n            Logger.debug('[SecurityManager] CSP header found', cspHeader);\r\n            this.validateCsp(cspHeader);\r\n        } else {\r\n            Logger.warn('[SecurityManager] No CSP header found');\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get CSP header from meta tag or response headers\r\n     */\r\n    getCspHeader() {\r\n        // Try meta tag\r\n        const metaTag = document.querySelector('meta[http-equiv=\"Content-Security-Policy\"]');\r\n        if (metaTag) {\r\n            return metaTag.getAttribute('content');\r\n        }\r\n        \r\n        // Note: Response headers are not accessible from JavaScript\r\n        // This would need to be passed from server or checked server-side\r\n        return null;\r\n    }\r\n    \r\n    /**\r\n     * Validate CSP header\r\n     */\r\n    validateCsp(cspHeader) {\r\n        // Basic validation - check for common security directives\r\n        const requiredDirectives = ['default-src', 'script-src', 'style-src'];\r\n        const directives = cspHeader.split(';').map(d => d.trim().split(' ')[0]);\r\n        \r\n        const missing = requiredDirectives.filter(dir => \r\n            !directives.some(d => d.toLowerCase() === dir.toLowerCase())\r\n        );\r\n        \r\n        if (missing.length > 0) {\r\n            Logger.warn('[SecurityManager] CSP missing recommended directives', missing);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get CSRF token\r\n     */\r\n    getCsrfToken() {\r\n        return this.csrfManager?.getToken() || null;\r\n    }\r\n    \r\n    /**\r\n     * Get CSRF token header\r\n     */\r\n    getCsrfTokenHeader() {\r\n        return this.csrfManager?.getTokenHeader() || {};\r\n    }\r\n    \r\n    /**\r\n     * Refresh CSRF token\r\n     */\r\n    async refreshCsrfToken() {\r\n        if (this.csrfManager) {\r\n            return await this.csrfManager.refreshToken();\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Validate security headers\r\n     */\r\n    validateSecurityHeaders() {\r\n        const issues = [];\r\n        \r\n        // Check for HTTPS\r\n        if (location.protocol !== 'https:' && location.hostname !== 'localhost') {\r\n            issues.push('Not using HTTPS');\r\n        }\r\n        \r\n        // Check for CSP\r\n        if (!this.getCspHeader()) {\r\n            issues.push('No Content Security Policy header');\r\n        }\r\n        \r\n        // Check for X-Frame-Options\r\n        // Note: Headers are not accessible from JavaScript, would need server-side check\r\n        \r\n        return {\r\n            valid: issues.length === 0,\r\n            issues\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Escape HTML to prevent XSS\r\n     */\r\n    escapeHtml(text) {\r\n        if (typeof text !== 'string') {\r\n            return text;\r\n        }\r\n        \r\n        const map = {\r\n            '&': '&amp;',\r\n            '<': '&lt;',\r\n            '>': '&gt;',\r\n            '\"': '&quot;',\r\n            \"'\": '&#039;'\r\n        };\r\n        \r\n        return text.replace(/[&<>\"']/g, m => map[m]);\r\n    }\r\n    \r\n    /**\r\n     * Validate URL to prevent XSS\r\n     */\r\n    validateUrl(url) {\r\n        try {\r\n            const parsed = new URL(url, window.location.origin);\r\n            \r\n            // Block javascript: and data: URLs\r\n            if (parsed.protocol === 'javascript:' || parsed.protocol === 'data:') {\r\n                return false;\r\n            }\r\n            \r\n            return true;\r\n        } catch {\r\n            return false;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Destroy security manager\r\n     */\r\n    destroy() {\r\n        if (this.csrfManager) {\r\n            this.csrfManager.destroy();\r\n            this.csrfManager = null;\r\n        }\r\n        \r\n        Logger.info('[SecurityManager] Destroyed');\r\n    }\r\n}\r\n\r\n","/**\r\n * Security Module\r\n * \r\n * Provides security-related utilities including CSRF, XSS protection, and CSP helpers.\r\n * \r\n * Usage:\r\n * - Add data-module=\"security\" to enable global security features\r\n * - Or import and use directly: import { SecurityManager } from './modules/security/index.js'\r\n * \r\n * Features:\r\n * - CSRF token management and auto-refresh\r\n * - XSS protection helpers\r\n * - Content Security Policy helpers\r\n * - Security headers validation\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { SecurityManager } from './SecurityManager.js';\r\nimport { CsrfManager } from './CsrfManager.js';\r\n\r\nconst SecurityModule = {\r\n    name: 'security',\r\n    securityManager: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[SecurityModule] Module initialized');\r\n        \r\n        // Create security manager\r\n        this.securityManager = SecurityManager.create(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.SecurityManager = this.securityManager;\r\n            window.CsrfManager = this.securityManager.csrfManager;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get security manager instance\r\n     */\r\n    getSecurityManager() {\r\n        return this.securityManager || SecurityManager.create();\r\n    },\r\n    \r\n    /**\r\n     * Get CSRF token\r\n     */\r\n    getCsrfToken() {\r\n        return this.securityManager?.getCsrfToken() || null;\r\n    },\r\n    \r\n    /**\r\n     * Refresh CSRF token\r\n     */\r\n    async refreshCsrfToken() {\r\n        if (this.securityManager) {\r\n            return await this.securityManager.refreshCsrfToken();\r\n        }\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.securityManager) {\r\n            this.securityManager.destroy();\r\n            this.securityManager = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined') {\r\n            delete window.SecurityManager;\r\n            delete window.CsrfManager;\r\n        }\r\n        \r\n        Logger.info('[SecurityModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { SecurityManager, CsrfManager };\r\n\r\n// Export as default for module system\r\nexport default SecurityModule;\r\n\r\n// Export init function for module system\r\nexport const init = SecurityModule.init.bind(SecurityModule);\r\n\r\n","import { Logger } from '../../core/logger.js';\n\nexport class SPARouter {\n    constructor(options = {}) {\n        this.options = {\n            containerSelector: 'main',\n            linkSelector: 'a[href^=\"/\"]', // All internal links\n            loadingClass: 'spa-loading',\n            excludeSelector: '[data-spa=\"false\"], [download], [target=\"_blank\"], [href^=\"mailto:\"], [href^=\"tel:\"], [href^=\"#\"]',\n            enableTransitions: true,\n            transitionDuration: 100, // Beschleunigt von 300ms auf 100ms\n            skeletonTemplate: this.createSkeletonTemplate(),\n            // LiveComponent integration options\n            enableLiveComponentIntegration: options.enableLiveComponentIntegration ?? true,\n            preserveLiveComponentState: options.preserveLiveComponentState ?? false,\n            ...options\n        };\n        \n        this.container = null;\n        this.isLoading = false;\n        this.currentUrl = window.location.href;\n        this.abortController = null;\n        this.liveComponentManager = null;\n        \n        // Bind event handlers to preserve context for removal\n        this.handleLinkClick = this.handleLinkClick.bind(this);\n        this.handlePopState = this.handlePopState.bind(this);\n        this.handleFormSubmit = this.handleFormSubmit.bind(this);\n        \n        this.init();\n    }\n\n    static create(options = {}) {\n        return new SPARouter(options);\n    }\n\n    init() {\n        this.container = document.querySelector(this.options.containerSelector);\n        \n        if (!this.container) {\n            Logger.error(`[SPARouter] Container \"${this.options.containerSelector}\" not found`);\n            return;\n        }\n        \n        // Initialize LiveComponent integration if enabled\n        if (this.options.enableLiveComponentIntegration) {\n            this.initLiveComponentIntegration();\n        }\n        \n        this.bindEvents();\n        this.setupStyles();\n        \n        // Handle initial page load for history\n        this.updateHistoryState(window.location.href, document.title);\n        \n        Logger.info('[SPARouter] Initialized', {\n            liveComponentIntegration: this.options.enableLiveComponentIntegration\n        });\n    }\n    \n    /**\n     * Initialize LiveComponent integration\n     */\n    initLiveComponentIntegration() {\n        // Try to get LiveComponent instance\n        // Check if it's available globally or via module system\n        if (typeof window !== 'undefined' && window.LiveComponent) {\n            this.liveComponentManager = window.LiveComponent;\n        } else {\n            // Try to import dynamically\n            import('../livecomponent/index.js').then(module => {\n                if (module.LiveComponent) {\n                    this.liveComponentManager = module.LiveComponent;\n                } else if (module.default) {\n                    this.liveComponentManager = module.default;\n                }\n            }).catch(error => {\n                Logger.warn('[SPARouter] LiveComponent not available', error);\n            });\n        }\n        \n        Logger.debug('[SPARouter] LiveComponent integration initialized');\n    }\n\n    bindEvents() {\n        // Intercept link clicks\n        document.addEventListener('click', this.handleLinkClick);\n        \n        // Handle browser back/forward\n        window.addEventListener('popstate', this.handlePopState);\n        \n        // Handle form submissions that might redirect\n        document.addEventListener('submit', this.handleFormSubmit);\n    }\n\n    handleLinkClick(event) {\n        const link = event.target.closest(this.options.linkSelector);\n        \n        if (!link) return;\n        \n        // Check for exclusions\n        if (link.matches(this.options.excludeSelector)) return;\n        \n        // Check for modifier keys (Ctrl, Cmd, etc.)\n        if (event.ctrlKey || event.metaKey || event.shiftKey) return;\n        \n        event.preventDefault();\n        \n        const href = link.href;\n        const title = link.title || link.textContent.trim();\n        \n        this.navigate(href, title);\n    }\n\n    handlePopState(event) {\n        const url = window.location.href;\n        \n        if (url !== this.currentUrl) {\n            this.loadContent(url, false); // Don't update history on popstate\n        }\n    }\n\n    handleFormSubmit(event) {\n        const form = event.target;\n        \n        // Only handle forms that might redirect (non-AJAX forms)\n        if (form.hasAttribute('data-spa') && form.getAttribute('data-spa') === 'false') return;\n        if (form._moduleInstance) return; // Skip forms with form-handling module\n        \n        // For now, let forms submit normally\n        // Could be enhanced later to handle form submissions via SPA\n    }\n\n    async navigate(url, title = '') {\n        if (this.isLoading) {\n            Logger.warn(`[SPARouter] Already loading, aborting previous request`);\n            this.abortController?.abort();\n        }\n        \n        if (url === this.currentUrl) {\n            Logger.info(`[SPARouter] Already at ${url}, skipping navigation`);\n            return;\n        }\n        \n        Logger.info(`[SPARouter] Navigating to: ${url}`);\n        \n        try {\n            await this.loadContent(url, true, title);\n        } catch (error) {\n            if (error.name !== 'AbortError') {\n                Logger.error('[SPARouter] Navigation failed:', error);\n                // Fallback to normal navigation\n                window.location.href = url;\n            }\n        }\n    }\n\n    async loadContent(url, updateHistory = true, title = '') {\n        // Prevent loading the same URL that's already current\n        if (url === this.currentUrl && !updateHistory) {\n            return;\n        }\n        \n        if (this.isLoading) {\n            this.abortController?.abort();\n        }\n        \n        this.isLoading = true;\n        this.abortController = new AbortController();\n        \n        try {\n            // Show loading state\n            this.showLoadingState();\n            \n            // Request only the main content\n            const response = await fetch(url, {\n                headers: {\n                    'X-Requested-With': 'XMLHttpRequest',\n                    'X-SPA-Request': 'true', // Signal to backend this is an SPA request\n                    'Accept': 'application/json, text/html'\n                },\n                signal: this.abortController.signal\n            });\n            \n            if (!response.ok) {\n                throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n            }\n            \n            // Check content type to determine how to parse response\n            const contentType = response.headers.get('content-type');\n            let newContent, newTitle;\n            \n            if (contentType?.includes('application/json')) {\n                // Backend sent JSON SPA response\n                const jsonData = await response.json();\n                newContent = jsonData.html;\n                newTitle = jsonData.title || title;\n                \n                // Update meta tags if provided\n                if (jsonData.meta) {\n                    this.updateMetaTags(jsonData.meta);\n                }\n            } else {\n                // Backend sent full HTML response - extract content\n                const html = await response.text();\n                newContent = this.extractMainContent(html);\n                newTitle = this.extractTitle(html) || title;\n            }\n            \n            // Update content\n            await this.updateContent(newContent, newTitle);\n            \n            // Update browser history\n            if (updateHistory) {\n                this.updateHistoryState(url, newTitle);\n            }\n            \n            this.currentUrl = url;\n            \n            Logger.info(`[SPARouter] Successfully loaded: ${url}`);\n            \n        } catch (error) {\n            if (error.name !== 'AbortError') {\n                this.hideLoadingState();\n                throw error;\n            }\n        } finally {\n            this.isLoading = false;\n            this.abortController = null;\n        }\n    }\n\n    extractMainContent(html) {\n        // Create a temporary DOM to parse the response\n        const parser = new DOMParser();\n        const doc = parser.parseFromString(html, 'text/html');\n        \n        const mainElement = doc.querySelector('main');\n        \n        if (mainElement) {\n            return mainElement.innerHTML;\n        }\n        \n        // Fallback: try to find content in common containers\n        const fallbackSelectors = ['[role=\"main\"]', '.main-content', '#main', '.content'];\n        \n        for (const selector of fallbackSelectors) {\n            const element = doc.querySelector(selector);\n            if (element) {\n                Logger.warn(`[SPARouter] Using fallback selector: ${selector}`);\n                return element.innerHTML;\n            }\n        }\n        \n        // Last resort: use the entire body\n        Logger.warn('[SPARouter] No main element found, using entire body');\n        return doc.body.innerHTML;\n    }\n\n    extractTitle(html) {\n        const parser = new DOMParser();\n        const doc = parser.parseFromString(html, 'text/html');\n        \n        const titleElement = doc.querySelector('title');\n        return titleElement ? titleElement.textContent.trim() : '';\n    }\n\n    async updateContent(newContent, newTitle) {\n        // Save LiveComponent state before navigation if enabled\n        let savedComponentStates = null;\n        if (this.options.enableLiveComponentIntegration && this.options.preserveLiveComponentState && this.liveComponentManager) {\n            savedComponentStates = this.saveLiveComponentStates();\n        }\n        \n        // Update page title\n        if (newTitle) {\n            document.title = newTitle;\n        }\n        \n        // Smooth transition\n        if (this.options.enableTransitions) {\n            await this.transitionOut();\n        }\n        \n        // Update content\n        this.container.innerHTML = newContent;\n        \n        // Re-initialize modules for new content\n        this.reinitializeModules();\n        \n        // Initialize LiveComponents in new content\n        if (this.options.enableLiveComponentIntegration) {\n            await this.initializeLiveComponents(savedComponentStates);\n        }\n        \n        // Smooth transition in\n        if (this.options.enableTransitions) {\n            await this.transitionIn();\n        }\n        \n        this.hideLoadingState();\n        \n        // Scroll to top\n        window.scrollTo({ top: 0, behavior: 'smooth' });\n        \n        // Trigger custom event\n        this.triggerNavigationEvent();\n    }\n    \n    /**\n     * Save LiveComponent states before navigation\n     */\n    saveLiveComponentStates() {\n        if (!this.liveComponentManager) {\n            return null;\n        }\n        \n        const states = {};\n        const components = this.container.querySelectorAll('[data-live-component]');\n        \n        components.forEach(element => {\n            const componentId = element.getAttribute('data-live-component');\n            if (componentId && this.liveComponentManager.components) {\n                const component = this.liveComponentManager.components.get(componentId);\n                if (component) {\n                    // Get state from element's dataset\n                    const stateJson = element.dataset.state;\n                    if (stateJson) {\n                        try {\n                            states[componentId] = JSON.parse(stateJson);\n                        } catch (e) {\n                            Logger.warn(`[SPARouter] Failed to parse state for ${componentId}`, e);\n                        }\n                    }\n                }\n            }\n        });\n        \n        Logger.debug('[SPARouter] Saved LiveComponent states', Object.keys(states));\n        return states;\n    }\n    \n    /**\n     * Initialize LiveComponents in new content\n     */\n    async initializeLiveComponents(savedStates = null) {\n        if (!this.liveComponentManager) {\n            // Try to get LiveComponentManager again\n            this.initLiveComponentIntegration();\n            \n            // Wait a bit for async initialization\n            await new Promise(resolve => setTimeout(resolve, 100));\n            \n            if (!this.liveComponentManager) {\n                Logger.warn('[SPARouter] LiveComponentManager not available, skipping initialization');\n                return;\n            }\n        }\n        \n        // Find all LiveComponent elements in new content\n        const componentElements = this.container.querySelectorAll('[data-live-component]');\n        \n        if (componentElements.length === 0) {\n            return;\n        }\n        \n        Logger.info(`[SPARouter] Initializing ${componentElements.length} LiveComponents`);\n        \n        // Initialize each component\n        for (const element of componentElements) {\n            try {\n                // Restore state if available\n                if (savedStates) {\n                    const componentId = element.getAttribute('data-live-component');\n                    if (componentId && savedStates[componentId]) {\n                        const stateJson = JSON.stringify(savedStates[componentId]);\n                        element.dataset.state = stateJson;\n                    }\n                }\n                \n                // Initialize component using LiveComponent instance\n                if (this.liveComponentManager && typeof this.liveComponentManager.init === 'function') {\n                    this.liveComponentManager.init(element);\n                }\n            } catch (error) {\n                Logger.error('[SPARouter] Failed to initialize LiveComponent', error);\n            }\n        }\n        \n        Logger.debug('[SPARouter] LiveComponents initialized');\n    }\n\n    showLoadingState() {\n        document.body.classList.add(this.options.loadingClass);\n        \n        // Show skeleton loader\n        if (this.options.enableTransitions) {\n            this.container.classList.add('spa-transitioning-out');\n        }\n    }\n\n    hideLoadingState() {\n        document.body.classList.remove(this.options.loadingClass);\n    }\n\n    async transitionOut() {\n        return new Promise(resolve => {\n            // Verwende schnellere cubic-bezier für snappigere Animation\n            this.container.style.transition = `opacity ${this.options.transitionDuration}ms cubic-bezier(0.4, 0, 1, 1)`;\n            this.container.style.opacity = '0';\n            \n            setTimeout(() => {\n                resolve();\n            }, this.options.transitionDuration);\n        });\n    }\n\n    async transitionIn() {\n        return new Promise(resolve => {\n            this.container.style.opacity = '0';\n            \n            // Reduziere Verzögerung von 50ms auf 10ms\n            setTimeout(() => {\n                // Verwende schnellere cubic-bezier für snappigere Animation\n                this.container.style.transition = `opacity ${this.options.transitionDuration}ms cubic-bezier(0, 0, 0.2, 1)`;\n                this.container.style.opacity = '1';\n                \n                setTimeout(() => {\n                    this.container.style.transition = '';\n                    this.container.classList.remove('spa-transitioning-out');\n                    resolve();\n                }, this.options.transitionDuration);\n            }, 10); // Von 50ms auf 10ms reduziert\n        });\n    }\n\n    updateHistoryState(url, title) {\n        const state = { url, title, timestamp: Date.now() };\n        \n        if (url !== window.location.href) {\n            history.pushState(state, title, url);\n        } else {\n            history.replaceState(state, title, url);\n        }\n    }\n\n    reinitializeModules() {\n        // Re-run form auto-enhancement for new content\n        if (window.initAutoFormHandling) {\n            window.initAutoFormHandling();\n        }\n        \n        // Re-initialize any data-module elements in new content\n        const moduleElements = this.container.querySelectorAll('[data-module]');\n        \n        moduleElements.forEach(element => {\n            const moduleName = element.dataset.module;\n            \n            // Skip LiveComponent initialization here (handled separately)\n            if (moduleName === 'livecomponent') {\n                return;\n            }\n            \n            Logger.info(`[SPARouter] Re-initializing module \"${moduleName}\" on new content`);\n            \n            // Trigger module initialization (would need access to module system)\n            const event = new CustomEvent('spa:reinit-module', {\n                detail: { element, moduleName },\n                bubbles: true\n            });\n            element.dispatchEvent(event);\n        });\n    }\n\n    createSkeletonTemplate() {\n        return `\n            <div class=\"spa-skeleton\">\n                <div class=\"spa-skeleton-header\"></div>\n                <div class=\"spa-skeleton-content\">\n                    <div class=\"spa-skeleton-line\"></div>\n                    <div class=\"spa-skeleton-line\"></div>\n                    <div class=\"spa-skeleton-line short\"></div>\n                </div>\n            </div>\n        `;\n    }\n\n    setupStyles() {\n        if (document.getElementById('spa-router-styles')) return;\n        \n        const styles = document.createElement('style');\n        styles.id = 'spa-router-styles';\n        styles.textContent = `\n            /* SPA Router Transitions */\n            .spa-loading {\n                cursor: progress;\n            }\n            \n            .spa-transitioning-out {\n                pointer-events: none;\n            }\n            \n            /* Skeleton Loading Styles */\n            .spa-skeleton {\n                animation: spa-pulse 1.5s ease-in-out infinite alternate;\n            }\n            \n            .spa-skeleton-header {\n                height: 2rem;\n                background: #e5e7eb;\n                border-radius: 0.375rem;\n                margin-bottom: 1rem;\n                width: 60%;\n            }\n            \n            .spa-skeleton-content {\n                space-y: 0.75rem;\n            }\n            \n            .spa-skeleton-line {\n                height: 1rem;\n                background: #e5e7eb;\n                border-radius: 0.375rem;\n                margin-bottom: 0.75rem;\n            }\n            \n            .spa-skeleton-line.short {\n                width: 75%;\n            }\n            \n            @keyframes spa-pulse {\n                0% {\n                    opacity: 1;\n                }\n                100% {\n                    opacity: 0.4;\n                }\n            }\n            \n            /* Dark mode support */\n            @media (prefers-color-scheme: dark) {\n                .spa-skeleton-header,\n                .spa-skeleton-line {\n                    background: #374151;\n                }\n            }\n        `;\n        \n        document.head.appendChild(styles);\n    }\n\n    updateMetaTags(metaData) {\n        // Update meta description\n        if (metaData.description) {\n            let metaDesc = document.querySelector('meta[name=\"description\"]');\n            if (metaDesc) {\n                metaDesc.content = metaData.description;\n            } else {\n                metaDesc = document.createElement('meta');\n                metaDesc.name = 'description';\n                metaDesc.content = metaData.description;\n                document.head.appendChild(metaDesc);\n            }\n        }\n        \n        // Add other meta tag updates as needed\n        Object.entries(metaData).forEach(([key, value]) => {\n            if (key !== 'description' && value) {\n                let metaTag = document.querySelector(`meta[name=\"${key}\"]`);\n                if (metaTag) {\n                    metaTag.content = value;\n                } else {\n                    metaTag = document.createElement('meta');\n                    metaTag.name = key;\n                    metaTag.content = value;\n                    document.head.appendChild(metaTag);\n                }\n            }\n        });\n    }\n\n    triggerNavigationEvent() {\n        const event = new CustomEvent('spa:navigated', {\n            detail: {\n                url: this.currentUrl,\n                container: this.container,\n                timestamp: Date.now()\n            },\n            bubbles: true\n        });\n        \n        document.dispatchEvent(event);\n    }\n\n    // Public API\n    navigateTo(url, title) {\n        return this.navigate(url, title);\n    }\n\n    getCurrentUrl() {\n        return this.currentUrl;\n    }\n\n    isNavigating() {\n        return this.isLoading;\n    }\n\n    destroy() {\n        this.abortController?.abort();\n        \n        // Remove event listeners\n        document.removeEventListener('click', this.handleLinkClick);\n        window.removeEventListener('popstate', this.handlePopState);\n        document.removeEventListener('submit', this.handleFormSubmit);\n        \n        // Remove styles\n        const styles = document.getElementById('spa-router-styles');\n        if (styles) {\n            styles.remove();\n        }\n        \n        Logger.info('[SPARouter] Destroyed');\n    }\n}","/**\n * SPA Router Transition Configuration\n * \n * Verschiedene Transition-Presets für unterschiedliche Use-Cases\n */\n\n// Ultra-schnelle Transitions (fast keine sichtbare Animation)\nexport const instantTransition = {\n    enableTransitions: true,\n    transitionDuration: 50  // 50ms - kaum wahrnehmbar\n};\n\n// Schnelle Transitions (snappy, aber noch sichtbar)\nexport const fastTransition = {\n    enableTransitions: true,\n    transitionDuration: 100  // 100ms - schnell und responsiv\n};\n\n// Standard Transitions (balanced)\nexport const standardTransition = {\n    enableTransitions: true,\n    transitionDuration: 200  // 200ms - ausgewogen\n};\n\n// Langsame Transitions (smooth, aber träge)\nexport const slowTransition = {\n    enableTransitions: true,\n    transitionDuration: 300  // 300ms - original Wert\n};\n\n// Keine Transitions (instant switch)\nexport const noTransition = {\n    enableTransitions: false,\n    transitionDuration: 0\n};\n\n// Performance-basierte Konfiguration\nexport function getAdaptiveTransition() {\n    // Check for reduced motion preference\n    if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) {\n        return noTransition;\n    }\n    \n    // Check device performance\n    const connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;\n    \n    if (connection) {\n        // Schnelle Verbindung = schnellere Transitions\n        if (connection.effectiveType === '4g') {\n            return instantTransition;\n        } else if (connection.effectiveType === '3g') {\n            return fastTransition;\n        }\n    }\n    \n    // Check if device is likely mobile (rough detection)\n    const isMobile = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);\n    \n    if (isMobile) {\n        return fastTransition; // Mobile devices: schnellere Transitions\n    }\n    \n    return fastTransition; // Default zu schnell\n}\n\n// Export default configuration\nexport default fastTransition;","import { Logger } from '../../core/logger.js';\nimport { SPARouter } from './SPARouter.js';\nimport { getAdaptiveTransition, fastTransition } from './transition-config.js';\n\n/**\n * SPA Router Module\n * \n * Provides Single Page Application navigation:\n * - Intercepts internal links and loads content via AJAX\n * - Updates only the <main> element, keeping header/footer unchanged\n * - Manages browser history (back/forward buttons work)\n * - Shows skeleton loading states during navigation\n * - Progressive enhancement (falls back to normal navigation on errors)\n * \n * Features:\n * - Automatic link interception for all internal links (href=\"/...\")\n * - Opt-out via data-spa=\"false\"\n * - Browser history management with pushState\n * - Loading states and smooth transitions\n * - Module re-initialization after content changes\n * - Skeleton loading animation\n * \n * Backend Integration:\n * - Sends X-SPA-Request header to signal SPA navigation\n * - Backend can return only <main> content for SPA requests\n * - Falls back to full page load if SPA request fails\n */\n\nconst SPARouterModule = {\n    name: 'spa-router',\n    router: null,\n    initialized: false,\n    \n    init(config = {}) {\n        // Prevent multiple initialization\n        if (this.initialized && this.router) {\n            Logger.warn('[SPARouterModule] SPA Router already initialized, returning existing instance');\n            return this.router;\n        }\n        \n        Logger.info('[SPARouterModule] Initializing SPA Router');\n        \n        // Default configuration mit schnelleren Transitions\n        const defaultConfig = {\n            containerSelector: 'main',\n            linkSelector: 'a[href^=\"/\"]',\n            excludeSelector: '[data-spa=\"false\"], [download], [target=\"_blank\"], [href^=\"mailto:\"], [href^=\"tel:\"], [href^=\"#\"]',\n            enableSkeletonLoading: true,\n            ...fastTransition, // Verwende schnelle Transitions als Standard\n            ...getAdaptiveTransition() // Überschreibe mit adaptiven Einstellungen\n        };\n        \n        const options = { ...defaultConfig, ...config };\n        \n        // Initialize router\n        this.router = SPARouter.create(options);\n        this.initialized = true;\n        \n        // Set up global access\n        if (typeof window !== 'undefined') {\n            window.spaRouter = this.router;\n        }\n        \n        // Listen for module re-initialization events\n        document.addEventListener('spa:reinit-module', this.handleModuleReinit.bind(this));\n        \n        // Listen for navigation events for debugging\n        document.addEventListener('spa:navigated', this.handleNavigation.bind(this));\n        \n        Logger.info('[SPARouterModule] SPA Router initialized successfully');\n        \n        return this.router;\n    },\n    \n    handleModuleReinit(event) {\n        const { element, moduleName } = event.detail;\n        \n        Logger.info(`[SPARouterModule] Re-initializing module: ${moduleName}`, element);\n        \n        // This would need access to the main module system\n        // For now, we'll just log and let the main init system handle it\n        \n        // Trigger a custom event that the main module system can listen to\n        const reinitEvent = new CustomEvent('module:reinit-needed', {\n            detail: { element, moduleName },\n            bubbles: true\n        });\n        \n        document.dispatchEvent(reinitEvent);\n    },\n    \n    handleNavigation(event) {\n        const { url, timestamp } = event.detail;\n        \n        Logger.info(`[SPARouterModule] Navigation completed to: ${url}`);\n        \n        // Re-run auto form enhancement for new content\n        if (typeof window.initAutoFormHandling === 'function') {\n            // Only re-initialize forms that are not already enhanced\n            setTimeout(() => {\n                window.initAutoFormHandling();\n            }, 100);\n        }\n        \n        // Trigger analytics or other tracking if needed\n        if (typeof window.gtag === 'function') {\n            window.gtag('config', 'GA_TRACKING_ID', {\n                page_path: new URL(url).pathname\n            });\n        }\n    },\n    \n    // Public API methods\n    navigateTo(url, title) {\n        if (this.router) {\n            return this.router.navigateTo(url, title);\n        }\n        Logger.warn('[SPARouterModule] Router not initialized');\n    },\n    \n    getCurrentUrl() {\n        return this.router?.getCurrentUrl() || window.location.href;\n    },\n    \n    isNavigating() {\n        return this.router?.isNavigating() || false;\n    },\n    \n    destroy() {\n        if (this.router) {\n            this.router.destroy();\n            this.router = null;\n        }\n        \n        this.initialized = false;\n        \n        // Remove global reference\n        if (typeof window !== 'undefined' && window.spaRouter) {\n            delete window.spaRouter;\n        }\n        \n        document.removeEventListener('spa:reinit-module', this.handleModuleReinit);\n        document.removeEventListener('spa:navigated', this.handleNavigation);\n        \n        Logger.info('[SPARouterModule] SPA Router destroyed');\n    }\n};\n\n// Export the router class for direct usage\nexport { SPARouter };\n\n// Export as default for module system\nexport default SPARouterModule;\n\n// Export init function directly for compatibility with module system\nexport const init = SPARouterModule.init.bind(SPARouterModule);\n\n// Also export named for direct usage\nexport { SPARouterModule };","/**\r\n * State Management Module\r\n * \r\n * Provides centralized, reactive state management for client-side state.\r\n * Features:\r\n * - Reactive state store (similar to Redux/Vuex)\r\n * - State persistence (localStorage, sessionStorage)\r\n * - State synchronization across tabs (BroadcastChannel)\r\n * - Integration with LiveComponents\r\n * - Time-travel debugging support\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * StateManager - Centralized state management\r\n */\r\nexport class StateManager {\r\n    constructor(config = {}) {\r\n        this.state = config.initialState || {};\r\n        this.subscribers = new Map(); // Map<path, Set<callback>>\r\n        this.middleware = [];\r\n        this.history = []; // For time-travel debugging\r\n        this.maxHistorySize = config.maxHistorySize || 50;\r\n        this.enableHistory = config.enableHistory ?? false;\r\n        \r\n        // Persistence configuration\r\n        this.persistence = {\r\n            enabled: config.persistence?.enabled ?? false,\r\n            storage: config.persistence?.storage || 'localStorage', // 'localStorage' | 'sessionStorage'\r\n            key: config.persistence?.key || 'app-state',\r\n            paths: config.persistence?.paths || [] // Only persist these paths\r\n        };\r\n        \r\n        // Cross-tab synchronization\r\n        this.sync = {\r\n            enabled: config.sync?.enabled ?? false,\r\n            channel: null\r\n        };\r\n        \r\n        // Load persisted state\r\n        if (this.persistence.enabled) {\r\n            this.loadPersistedState();\r\n        }\r\n        \r\n        // Initialize cross-tab sync\r\n        if (this.sync.enabled && typeof BroadcastChannel !== 'undefined') {\r\n            this.initCrossTabSync();\r\n        }\r\n        \r\n        Logger.info('[StateManager] Initialized', {\r\n            persistence: this.persistence.enabled,\r\n            sync: this.sync.enabled,\r\n            history: this.enableHistory\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Create a new StateManager instance\r\n     */\r\n    static create(config = {}) {\r\n        return new StateManager(config);\r\n    }\r\n    \r\n    /**\r\n     * Get current state\r\n     */\r\n    getState() {\r\n        return this.state;\r\n    }\r\n    \r\n    /**\r\n     * Get state at a specific path\r\n     */\r\n    get(path, defaultValue = undefined) {\r\n        const keys = path.split('.');\r\n        let value = this.state;\r\n        \r\n        for (const key of keys) {\r\n            if (value === null || value === undefined || typeof value !== 'object') {\r\n                return defaultValue;\r\n            }\r\n            value = value[key];\r\n        }\r\n        \r\n        return value !== undefined ? value : defaultValue;\r\n    }\r\n    \r\n    /**\r\n     * Set state at a specific path\r\n     */\r\n    set(path, value) {\r\n        const keys = path.split('.');\r\n        const newState = { ...this.state };\r\n        let current = newState;\r\n        \r\n        // Navigate/create nested structure\r\n        for (let i = 0; i < keys.length - 1; i++) {\r\n            const key = keys[i];\r\n            if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {\r\n                current[key] = {};\r\n            } else {\r\n                current[key] = { ...current[key] };\r\n            }\r\n            current = current[key];\r\n        }\r\n        \r\n        // Set the value\r\n        const lastKey = keys[keys.length - 1];\r\n        const oldValue = this.get(path);\r\n        current[lastKey] = value;\r\n        \r\n        // Apply middleware\r\n        const action = { type: 'SET', path, value, oldValue };\r\n        const processedAction = this.applyMiddleware(action);\r\n        \r\n        if (processedAction === null) {\r\n            return; // Middleware blocked the action\r\n        }\r\n        \r\n        // Update state\r\n        this.state = newState;\r\n        \r\n        // Save to history\r\n        if (this.enableHistory) {\r\n            this.addToHistory(action);\r\n        }\r\n        \r\n        // Persist if enabled\r\n        if (this.persistence.enabled && this.shouldPersist(path)) {\r\n            this.persistState();\r\n        }\r\n        \r\n        // Sync across tabs\r\n        if (this.sync.enabled) {\r\n            this.broadcastStateChange(action);\r\n        }\r\n        \r\n        // Notify subscribers\r\n        this.notifySubscribers(path, value, oldValue);\r\n        \r\n        Logger.debug('[StateManager] State updated', { path, value });\r\n    }\r\n    \r\n    /**\r\n     * Dispatch an action (similar to Redux)\r\n     */\r\n    dispatch(action) {\r\n        if (typeof action === 'function') {\r\n            // Thunk support\r\n            return action(this.dispatch.bind(this), this.getState.bind(this));\r\n        }\r\n        \r\n        if (!action.type) {\r\n            throw new Error('Action must have a type property');\r\n        }\r\n        \r\n        // Apply middleware\r\n        const processedAction = this.applyMiddleware(action);\r\n        if (processedAction === null) {\r\n            return; // Middleware blocked the action\r\n        }\r\n        \r\n        // Execute action (reducer pattern)\r\n        const newState = this.reducer(this.state, processedAction);\r\n        \r\n        if (newState !== this.state) {\r\n            const oldState = this.state;\r\n            this.state = newState;\r\n            \r\n            // Save to history\r\n            if (this.enableHistory) {\r\n                this.addToHistory(processedAction);\r\n            }\r\n            \r\n            // Persist if enabled\r\n            if (this.persistence.enabled) {\r\n                this.persistState();\r\n            }\r\n            \r\n            // Sync across tabs\r\n            if (this.sync.enabled) {\r\n                this.broadcastStateChange(processedAction);\r\n            }\r\n            \r\n            // Notify all subscribers\r\n            this.notifyAllSubscribers();\r\n        }\r\n        \r\n        Logger.debug('[StateManager] Action dispatched', processedAction);\r\n    }\r\n    \r\n    /**\r\n     * Default reducer (can be overridden)\r\n     */\r\n    reducer(state, action) {\r\n        // Default reducer handles SET actions\r\n        if (action.type === 'SET' && action.path) {\r\n            const keys = action.path.split('.');\r\n            const newState = { ...state };\r\n            let current = newState;\r\n            \r\n            for (let i = 0; i < keys.length - 1; i++) {\r\n                const key = keys[i];\r\n                if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {\r\n                    current[key] = {};\r\n                } else {\r\n                    current[key] = { ...current[key] };\r\n                }\r\n                current = current[key];\r\n            }\r\n            \r\n            current[keys[keys.length - 1]] = action.value;\r\n            return newState;\r\n        }\r\n        \r\n        return state;\r\n    }\r\n    \r\n    /**\r\n     * Subscribe to state changes\r\n     */\r\n    subscribe(path, callback) {\r\n        if (!this.subscribers.has(path)) {\r\n            this.subscribers.set(path, new Set());\r\n        }\r\n        \r\n        this.subscribers.get(path).add(callback);\r\n        \r\n        // Return unsubscribe function\r\n        return () => {\r\n            const callbacks = this.subscribers.get(path);\r\n            if (callbacks) {\r\n                callbacks.delete(callback);\r\n                if (callbacks.size === 0) {\r\n                    this.subscribers.delete(path);\r\n                }\r\n            }\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Subscribe to all state changes\r\n     */\r\n    subscribeAll(callback) {\r\n        return this.subscribe('*', callback);\r\n    }\r\n    \r\n    /**\r\n     * Notify subscribers of a state change\r\n     */\r\n    notifySubscribers(path, newValue, oldValue) {\r\n        // Notify path-specific subscribers\r\n        const pathCallbacks = this.subscribers.get(path);\r\n        if (pathCallbacks) {\r\n            pathCallbacks.forEach(callback => {\r\n                try {\r\n                    callback(newValue, oldValue, path);\r\n                } catch (error) {\r\n                    Logger.error('[StateManager] Subscriber error', error);\r\n                }\r\n            });\r\n        }\r\n        \r\n        // Notify wildcard subscribers\r\n        const wildcardCallbacks = this.subscribers.get('*');\r\n        if (wildcardCallbacks) {\r\n            wildcardCallbacks.forEach(callback => {\r\n                try {\r\n                    callback(this.state, path);\r\n                } catch (error) {\r\n                    Logger.error('[StateManager] Subscriber error', error);\r\n                }\r\n            });\r\n        }\r\n        \r\n        // Notify parent path subscribers\r\n        const pathParts = path.split('.');\r\n        for (let i = pathParts.length - 1; i > 0; i--) {\r\n            const parentPath = pathParts.slice(0, i).join('.');\r\n            const parentCallbacks = this.subscribers.get(parentPath);\r\n            if (parentCallbacks) {\r\n                parentCallbacks.forEach(callback => {\r\n                    try {\r\n                        callback(this.get(parentPath), parentPath);\r\n                    } catch (error) {\r\n                        Logger.error('[StateManager] Subscriber error', error);\r\n                    }\r\n                });\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Notify all subscribers (for full state changes)\r\n     */\r\n    notifyAllSubscribers() {\r\n        this.subscribers.forEach((callbacks, path) => {\r\n            callbacks.forEach(callback => {\r\n                try {\r\n                    if (path === '*') {\r\n                        callback(this.state);\r\n                    } else {\r\n                        const value = this.get(path);\r\n                        callback(value, path);\r\n                    }\r\n                } catch (error) {\r\n                    Logger.error('[StateManager] Subscriber error', error);\r\n                }\r\n            });\r\n        });\r\n    }\r\n    \r\n    /**\r\n     * Add middleware\r\n     */\r\n    use(middleware) {\r\n        if (typeof middleware !== 'function') {\r\n            throw new Error('Middleware must be a function');\r\n        }\r\n        this.middleware.push(middleware);\r\n    }\r\n    \r\n    /**\r\n     * Apply middleware chain\r\n     */\r\n    applyMiddleware(action) {\r\n        let processedAction = action;\r\n        \r\n        for (const middleware of this.middleware) {\r\n            processedAction = middleware(processedAction, this.getState.bind(this));\r\n            if (processedAction === null) {\r\n                return null; // Middleware blocked the action\r\n            }\r\n        }\r\n        \r\n        return processedAction;\r\n    }\r\n    \r\n    /**\r\n     * Load persisted state\r\n     */\r\n    loadPersistedState() {\r\n        try {\r\n            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;\r\n            const stored = storage.getItem(this.persistence.key);\r\n            \r\n            if (stored) {\r\n                const parsed = JSON.parse(stored);\r\n                this.state = { ...this.state, ...parsed };\r\n                Logger.info('[StateManager] Loaded persisted state');\r\n            }\r\n        } catch (error) {\r\n            Logger.error('[StateManager] Failed to load persisted state', error);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Persist state\r\n     */\r\n    persistState() {\r\n        try {\r\n            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;\r\n            const stateToPersist = this.persistence.paths.length > 0\r\n                ? this.getPersistedPaths()\r\n                : this.state;\r\n            \r\n            storage.setItem(this.persistence.key, JSON.stringify(stateToPersist));\r\n            Logger.debug('[StateManager] State persisted');\r\n        } catch (error) {\r\n            Logger.error('[StateManager] Failed to persist state', error);\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get only paths that should be persisted\r\n     */\r\n    getPersistedPaths() {\r\n        const result = {};\r\n        for (const path of this.persistence.paths) {\r\n            const value = this.get(path);\r\n            if (value !== undefined) {\r\n                const keys = path.split('.');\r\n                let current = result;\r\n                for (let i = 0; i < keys.length - 1; i++) {\r\n                    if (!(keys[i] in current)) {\r\n                        current[keys[i]] = {};\r\n                    }\r\n                    current = current[keys[i]];\r\n                }\r\n                current[keys[keys.length - 1]] = value;\r\n            }\r\n        }\r\n        return result;\r\n    }\r\n    \r\n    /**\r\n     * Check if path should be persisted\r\n     */\r\n    shouldPersist(path) {\r\n        if (this.persistence.paths.length === 0) {\r\n            return true; // Persist all if no paths specified\r\n        }\r\n        return this.persistence.paths.some(p => path.startsWith(p));\r\n    }\r\n    \r\n    /**\r\n     * Initialize cross-tab synchronization\r\n     */\r\n    initCrossTabSync() {\r\n        try {\r\n            this.sync.channel = new BroadcastChannel('state-manager-sync');\r\n            \r\n            this.sync.channel.addEventListener('message', (event) => {\r\n                if (event.data.type === 'STATE_CHANGE') {\r\n                    this.handleRemoteStateChange(event.data.action);\r\n                }\r\n            });\r\n            \r\n            Logger.info('[StateManager] Cross-tab sync initialized');\r\n        } catch (error) {\r\n            Logger.error('[StateManager] Failed to initialize cross-tab sync', error);\r\n            this.sync.enabled = false;\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Broadcast state change to other tabs\r\n     */\r\n    broadcastStateChange(action) {\r\n        if (this.sync.channel) {\r\n            try {\r\n                this.sync.channel.postMessage({\r\n                    type: 'STATE_CHANGE',\r\n                    action,\r\n                    timestamp: Date.now()\r\n                });\r\n            } catch (error) {\r\n                Logger.error('[StateManager] Failed to broadcast state change', error);\r\n            }\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Handle remote state change from another tab\r\n     */\r\n    handleRemoteStateChange(action) {\r\n        // Apply the action without broadcasting (to avoid loops)\r\n        const wasSyncEnabled = this.sync.enabled;\r\n        this.sync.enabled = false;\r\n        \r\n        if (action.type === 'SET' && action.path) {\r\n            this.set(action.path, action.value);\r\n        } else {\r\n            this.dispatch(action);\r\n        }\r\n        \r\n        this.sync.enabled = wasSyncEnabled;\r\n    }\r\n    \r\n    /**\r\n     * Add action to history\r\n     */\r\n    addToHistory(action) {\r\n        this.history.push({\r\n            action,\r\n            state: JSON.parse(JSON.stringify(this.state)),\r\n            timestamp: Date.now()\r\n        });\r\n        \r\n        // Limit history size\r\n        if (this.history.length > this.maxHistorySize) {\r\n            this.history.shift();\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Get history\r\n     */\r\n    getHistory() {\r\n        return [...this.history];\r\n    }\r\n    \r\n    /**\r\n     * Time-travel to a specific history point\r\n     */\r\n    timeTravel(index) {\r\n        if (index < 0 || index >= this.history.length) {\r\n            throw new Error('Invalid history index');\r\n        }\r\n        \r\n        const historyPoint = this.history[index];\r\n        this.state = JSON.parse(JSON.stringify(historyPoint.state));\r\n        this.notifyAllSubscribers();\r\n        \r\n        Logger.info('[StateManager] Time-traveled to history point', index);\r\n    }\r\n    \r\n    /**\r\n     * Reset state to initial state\r\n     */\r\n    reset() {\r\n        this.state = {};\r\n        this.history = [];\r\n        this.notifyAllSubscribers();\r\n        \r\n        if (this.persistence.enabled) {\r\n            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;\r\n            storage.removeItem(this.persistence.key);\r\n        }\r\n        \r\n        Logger.info('[StateManager] State reset');\r\n    }\r\n    \r\n    /**\r\n     * Destroy state manager\r\n     */\r\n    destroy() {\r\n        // Unsubscribe all\r\n        this.subscribers.clear();\r\n        \r\n        // Close cross-tab sync\r\n        if (this.sync.channel) {\r\n            this.sync.channel.close();\r\n            this.sync.channel = null;\r\n        }\r\n        \r\n        // Clear history\r\n        this.history = [];\r\n        \r\n        Logger.info('[StateManager] Destroyed');\r\n    }\r\n}\r\n\r\n/**\r\n * Create a global state manager instance\r\n */\r\nlet globalStateManager = null;\r\n\r\n/**\r\n * Get or create global state manager\r\n */\r\nexport function getGlobalStateManager(config = {}) {\r\n    if (!globalStateManager) {\r\n        globalStateManager = StateManager.create(config);\r\n    }\r\n    return globalStateManager;\r\n}\r\n\r\n/**\r\n * Create a scoped state manager (for component-specific state)\r\n */\r\nexport function createScopedStateManager(config = {}) {\r\n    return StateManager.create(config);\r\n}\r\n\r\n","/**\r\n * State Manager Module\r\n * \r\n * Provides centralized, reactive state management for client-side state.\r\n * \r\n * Usage:\r\n * - Add data-module=\"state-manager\" to enable global state management\r\n * - Or import and use directly: import { StateManager } from './modules/state-manager/index.js'\r\n * \r\n * Features:\r\n * - Reactive state store\r\n * - State persistence (localStorage, sessionStorage)\r\n * - Cross-tab synchronization\r\n * - Integration with LiveComponents\r\n * - Time-travel debugging\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { StateManager, getGlobalStateManager, createScopedStateManager } from './StateManager.js';\r\n\r\nconst StateManagerModule = {\r\n    name: 'state-manager',\r\n    stateManager: null,\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[StateManagerModule] Module initialized');\r\n        \r\n        // Create global state manager\r\n        this.stateManager = getGlobalStateManager(config);\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.StateManager = this.stateManager;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Get state manager instance\r\n     */\r\n    getStateManager() {\r\n        return this.stateManager || getGlobalStateManager();\r\n    },\r\n    \r\n    /**\r\n     * Create a scoped state manager\r\n     */\r\n    createScoped(config = {}) {\r\n        return createScopedStateManager(config);\r\n    },\r\n    \r\n    destroy() {\r\n        if (this.stateManager) {\r\n            this.stateManager.destroy();\r\n            this.stateManager = null;\r\n        }\r\n        \r\n        if (typeof window !== 'undefined' && window.StateManager) {\r\n            delete window.StateManager;\r\n        }\r\n        \r\n        Logger.info('[StateManagerModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { StateManager, getGlobalStateManager, createScopedStateManager };\r\n\r\n// Export as default for module system\r\nexport default StateManagerModule;\r\n\r\n// Export init function for module system\r\nexport const init = StateManagerModule.init.bind(StateManagerModule);\r\n\r\n","// modules/sticky-fade/index.js\nimport { registerFrameTask, unregisterFrameTask } from '../../core/frameloop.js';\n\nlet taskId = 'sticky-fade';\nlet elements = [];\nlet lastScrollY = window.scrollY;\nlet activeMap = new WeakMap();\nlet configCache = {\n    direction: false,\n    reset: false,\n};\n\n\nexport function init(config = {}) {\n    elements = Array.from(document.querySelectorAll('[data-sticky-fade]'));\n    if (elements.length === 0) return;\n\n    configCache.direction = config.direction ?? false;\n    configCache.reset = config.reset ?? false;\n\n    registerFrameTask(taskId, () => {\n        const scrollY = window.scrollY;\n        const direction = scrollY > lastScrollY ? 'down' : scrollY < lastScrollY ? 'up' : 'none';\n        lastScrollY = scrollY;\n\n        const viewportHeight = window.innerHeight;\n\n        elements.forEach(el => {\n            const rect = el.getBoundingClientRect();\n            const progress = 1 - Math.min(Math.max(rect.top / viewportHeight, 0), 1);\n\n            el.style.opacity = progress.toFixed(3);\n            el.style.transform = `translateY(${(1 - progress) * 20}px)`;\n\n            if(configCache.direction) {\n                el.dataset.scrollDir = direction;\n            }\n\n            if (configCache.reset) {\n                const isVisible = progress >= 1;\n                const wasActive = activeMap.get(el) || false;\n\n                if(isVisible && !wasActive) {\n                    el.classList.add('visible');\n                    activeMap.set(el, true);\n                } else if(!isVisible && wasActive) {\n                    el.classList.remove('visible');\n                    activeMap.set(el, false);\n                }\n            }\n        });\n    }, { autoStart: true });\n}\n\nexport function destroy() {\n    unregisterFrameTask(taskId);\n\n    elements.forEach(el => {\n        el.style.opacity = '';\n        el.style.transform = '';\n        el.classList.remove('visible');\n        delete el.dataset.scrollDir;\n    });\n\n    elements = [];\n    activeMap = new WeakMap();\n}\n","// modules/sticky-steps/index.js\nimport { Logger } from '../../core/logger.js';\nimport {registerFrameTask, unregisterFrameTask} from '../../core/frameloop.js';\n\nexport function init(config = {}) {\n    Logger.info('StickySteps init');\n\n    const defaultConfig = {\n        containerSelector: '[data-sticky-container]',\n        stepSelector: '[data-sticky-step]',\n        activeClass: 'is-sticky-active',\n        datasetKey: 'activeStickyStep'\n    };\n\n    const settings = { ...defaultConfig, ...config };\n    const containers = document.querySelectorAll(settings.containerSelector);\n\n    containers.forEach(container => {\n        const steps = container.querySelectorAll(settings.stepSelector);\n        const containerOffsetTop = container.offsetTop;\n\n        function update() {\n            const scrollY = window.scrollY;\n            const containerHeight = container.offsetHeight;\n\n            steps.forEach((step, index) => {\n                const stepOffset = containerOffsetTop + index * (containerHeight / steps.length);\n                const nextStepOffset = containerOffsetTop + (index + 1) * (containerHeight / steps.length);\n\n                const isActive = scrollY >= stepOffset && scrollY < nextStepOffset;\n                step.classList.toggle(settings.activeClass, isActive);\n\n                if (isActive) {\n                    container.dataset[settings.datasetKey] = index;\n                }\n            });\n        }\n\n        registerFrameTask(`sticky-steps-${container.dataset.moduleId || Math.random()}`, update, { autoStart: true });\n    });\n}\n\nexport function destroy() {\n    unregisterFrameTask('sticky-steps');\n}\n","import { UIManager } from './UIManager.js';\nimport { Logger } from '../../core/logger.js';\n\nexport function init() {\n\n    /*UIManager.open('modal', {\n        content: '<p>Hallo!</p><button class=\"modal-close\">OK</button>',\n        onClose: () => Logger.info('Modal wurde geschlossen')\n    });*/\n}\n","/**\r\n * Validation Module\r\n * \r\n * Provides standalone validation system for fields, forms, and data.\r\n * Features:\r\n * - Schema-based validation\r\n * - Field-level validation\r\n * - Async validation\r\n * - Custom validation rules\r\n * - Integration with form-handling\r\n * - Integration with LiveComponents\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\n\r\n/**\r\n * Built-in validation rules\r\n */\r\nconst builtInRules = {\r\n    required: (value, options = {}) => {\r\n        if (value === null || value === undefined || value === '') {\r\n            return options.message || 'This field is required';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    email: (value, options = {}) => {\r\n        if (!value) return true; // Optional if not required\r\n        const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\r\n        if (!emailRegex.test(value)) {\r\n            return options.message || 'Invalid email address';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    url: (value, options = {}) => {\r\n        if (!value) return true;\r\n        try {\r\n            new URL(value);\r\n            return true;\r\n        } catch {\r\n            return options.message || 'Invalid URL';\r\n        }\r\n    },\r\n    \r\n    min: (value, options = {}) => {\r\n        if (!value && value !== 0) return true;\r\n        const min = parseFloat(options.value);\r\n        const numValue = typeof value === 'string' ? parseFloat(value) : value;\r\n        if (isNaN(numValue) || numValue < min) {\r\n            return options.message || `Value must be at least ${min}`;\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    max: (value, options = {}) => {\r\n        if (!value && value !== 0) return true;\r\n        const max = parseFloat(options.value);\r\n        const numValue = typeof value === 'string' ? parseFloat(value) : value;\r\n        if (isNaN(numValue) || numValue > max) {\r\n            return options.message || `Value must be at most ${max}`;\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    minLength: (value, options = {}) => {\r\n        if (!value) return true;\r\n        const min = parseInt(options.value, 10);\r\n        if (typeof value !== 'string' || value.length < min) {\r\n            return options.message || `Must be at least ${min} characters`;\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    maxLength: (value, options = {}) => {\r\n        if (!value) return true;\r\n        const max = parseInt(options.value, 10);\r\n        if (typeof value !== 'string' || value.length > max) {\r\n            return options.message || `Must be at most ${max} characters`;\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    pattern: (value, options = {}) => {\r\n        if (!value) return true;\r\n        const regex = new RegExp(options.value);\r\n        if (!regex.test(value)) {\r\n            return options.message || 'Invalid format';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    number: (value, options = {}) => {\r\n        if (!value && value !== 0) return true;\r\n        if (isNaN(parseFloat(value))) {\r\n            return options.message || 'Must be a number';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    integer: (value, options = {}) => {\r\n        if (!value && value !== 0) return true;\r\n        if (!Number.isInteger(parseFloat(value))) {\r\n            return options.message || 'Must be an integer';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    phone: (value, options = {}) => {\r\n        if (!value) return true;\r\n        const phoneRegex = /^[\\d\\s\\-\\+\\(\\)]+$/;\r\n        if (!phoneRegex.test(value)) {\r\n            return options.message || 'Invalid phone number';\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    postalCode: (value, options = {}) => {\r\n        if (!value) return true;\r\n        const country = options.country || 'DE';\r\n        const patterns = {\r\n            DE: /^\\d{5}$/,\r\n            US: /^\\d{5}(-\\d{4})?$/,\r\n            UK: /^[A-Z]{1,2}\\d{1,2}[A-Z]?\\s?\\d[A-Z]{2}$/i,\r\n            FR: /^\\d{5}$/\r\n        };\r\n        const pattern = patterns[country] || patterns.DE;\r\n        if (!pattern.test(value)) {\r\n            return options.message || `Invalid postal code for ${country}`;\r\n        }\r\n        return true;\r\n    },\r\n    \r\n    custom: (value, options = {}) => {\r\n        if (!options.validator || typeof options.validator !== 'function') {\r\n            return 'Custom validator function required';\r\n        }\r\n        return options.validator(value, options);\r\n    }\r\n};\r\n\r\n/**\r\n * Validator - Schema-based validation\r\n */\r\nexport class Validator {\r\n    constructor(schema = {}) {\r\n        this.schema = schema;\r\n        this.customRules = new Map();\r\n        this.errors = {};\r\n        this.validatedFields = new Set();\r\n    }\r\n    \r\n    /**\r\n     * Create a new Validator instance\r\n     */\r\n    static create(schema = {}) {\r\n        return new Validator(schema);\r\n    }\r\n    \r\n    /**\r\n     * Register a custom validation rule\r\n     */\r\n    registerRule(name, rule) {\r\n        if (typeof rule !== 'function') {\r\n            throw new Error('Validation rule must be a function');\r\n        }\r\n        this.customRules.set(name, rule);\r\n    }\r\n    \r\n    /**\r\n     * Validate a single field\r\n     */\r\n    async validateField(fieldName, value, schema = null) {\r\n        const fieldSchema = schema || this.schema[fieldName];\r\n        \r\n        if (!fieldSchema) {\r\n            return { valid: true, errors: [] };\r\n        }\r\n        \r\n        const errors = [];\r\n        \r\n        // Handle array of rules\r\n        const rules = Array.isArray(fieldSchema) ? fieldSchema : [fieldSchema];\r\n        \r\n        for (const ruleConfig of rules) {\r\n            const result = await this.validateRule(value, ruleConfig);\r\n            if (result !== true) {\r\n                errors.push(result);\r\n            }\r\n        }\r\n        \r\n        // Store errors\r\n        if (errors.length > 0) {\r\n            this.errors[fieldName] = errors;\r\n        } else {\r\n            delete this.errors[fieldName];\r\n        }\r\n        \r\n        this.validatedFields.add(fieldName);\r\n        \r\n        return {\r\n            valid: errors.length === 0,\r\n            errors\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Validate a single rule\r\n     */\r\n    async validateRule(value, ruleConfig) {\r\n        if (typeof ruleConfig === 'function') {\r\n            // Custom validator function\r\n            const result = await ruleConfig(value);\r\n            return result === true ? true : (result || 'Validation failed');\r\n        }\r\n        \r\n        if (typeof ruleConfig === 'string') {\r\n            // Rule name only\r\n            return this.executeRule(ruleConfig, value, {});\r\n        }\r\n        \r\n        if (typeof ruleConfig === 'object' && ruleConfig !== null) {\r\n            // Rule with options\r\n            const ruleName = ruleConfig.rule || ruleConfig.type || Object.keys(ruleConfig)[0];\r\n            const options = ruleConfig.options || ruleConfig[ruleName] || {};\r\n            \r\n            // Check for async validation\r\n            if (ruleConfig.async && typeof ruleConfig.validator === 'function') {\r\n                const result = await ruleConfig.validator(value, options);\r\n                return result === true ? true : (result || options.message || 'Validation failed');\r\n            }\r\n            \r\n            return this.executeRule(ruleName, value, options);\r\n        }\r\n        \r\n        return true;\r\n    }\r\n    \r\n    /**\r\n     * Execute a validation rule\r\n     */\r\n    executeRule(ruleName, value, options) {\r\n        // Check custom rules first\r\n        if (this.customRules.has(ruleName)) {\r\n            const result = this.customRules.get(ruleName)(value, options);\r\n            return result === true ? true : (result || options.message || 'Validation failed');\r\n        }\r\n        \r\n        // Check built-in rules\r\n        if (builtInRules[ruleName]) {\r\n            const result = builtInRules[ruleName](value, options);\r\n            return result === true ? true : (result || options.message || 'Validation failed');\r\n        }\r\n        \r\n        Logger.warn(`[Validator] Unknown validation rule: ${ruleName}`);\r\n        return true; // Unknown rules pass by default\r\n    }\r\n    \r\n    /**\r\n     * Validate entire schema\r\n     */\r\n    async validate(data) {\r\n        this.errors = {};\r\n        this.validatedFields.clear();\r\n        \r\n        const results = {};\r\n        let isValid = true;\r\n        \r\n        for (const fieldName in this.schema) {\r\n            const value = data[fieldName];\r\n            const result = await this.validateField(fieldName, value);\r\n            results[fieldName] = result;\r\n            \r\n            if (!result.valid) {\r\n                isValid = false;\r\n            }\r\n        }\r\n        \r\n        return {\r\n            valid: isValid,\r\n            errors: this.errors,\r\n            results\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Validate specific fields\r\n     */\r\n    async validateFields(data, fieldNames) {\r\n        this.errors = {};\r\n        \r\n        const results = {};\r\n        let isValid = true;\r\n        \r\n        for (const fieldName of fieldNames) {\r\n            if (!(fieldName in this.schema)) {\r\n                continue;\r\n            }\r\n            \r\n            const value = data[fieldName];\r\n            const result = await this.validateField(fieldName, value);\r\n            results[fieldName] = result;\r\n            \r\n            if (!result.valid) {\r\n                isValid = false;\r\n            }\r\n        }\r\n        \r\n        return {\r\n            valid: isValid,\r\n            errors: this.errors,\r\n            results\r\n        };\r\n    }\r\n    \r\n    /**\r\n     * Get errors for a specific field\r\n     */\r\n    getFieldErrors(fieldName) {\r\n        return this.errors[fieldName] || [];\r\n    }\r\n    \r\n    /**\r\n     * Get all errors\r\n     */\r\n    getErrors() {\r\n        return { ...this.errors };\r\n    }\r\n    \r\n    /**\r\n     * Check if field is valid\r\n     */\r\n    isFieldValid(fieldName) {\r\n        return !this.errors[fieldName] || this.errors[fieldName].length === 0;\r\n    }\r\n    \r\n    /**\r\n     * Check if all fields are valid\r\n     */\r\n    isValid() {\r\n        return Object.keys(this.errors).length === 0;\r\n    }\r\n    \r\n    /**\r\n     * Clear errors\r\n     */\r\n    clearErrors(fieldName = null) {\r\n        if (fieldName) {\r\n            delete this.errors[fieldName];\r\n        } else {\r\n            this.errors = {};\r\n        }\r\n    }\r\n    \r\n    /**\r\n     * Reset validator\r\n     */\r\n    reset() {\r\n        this.errors = {};\r\n        this.validatedFields.clear();\r\n    }\r\n    \r\n    /**\r\n     * Create validator from HTML form\r\n     */\r\n    static fromForm(form) {\r\n        const schema = {};\r\n        const fields = form.querySelectorAll('input, textarea, select');\r\n        \r\n        fields.forEach(field => {\r\n            if (!field.name) return;\r\n            \r\n            const rules = [];\r\n            \r\n            // Required\r\n            if (field.hasAttribute('required')) {\r\n                rules.push('required');\r\n            }\r\n            \r\n            // Type-based validation\r\n            if (field.type === 'email') {\r\n                rules.push('email');\r\n            } else if (field.type === 'url') {\r\n                rules.push('url');\r\n            } else if (field.type === 'number') {\r\n                rules.push('number');\r\n            }\r\n            \r\n            // Min/Max length\r\n            if (field.hasAttribute('minlength')) {\r\n                rules.push({\r\n                    rule: 'minLength',\r\n                    options: { value: field.getAttribute('minlength') }\r\n                });\r\n            }\r\n            if (field.hasAttribute('maxlength')) {\r\n                rules.push({\r\n                    rule: 'maxLength',\r\n                    options: { value: field.getAttribute('maxlength') }\r\n                });\r\n            }\r\n            \r\n            // Min/Max (for numbers)\r\n            if (field.hasAttribute('min')) {\r\n                rules.push({\r\n                    rule: 'min',\r\n                    options: { value: field.getAttribute('min') }\r\n                });\r\n            }\r\n            if (field.hasAttribute('max')) {\r\n                rules.push({\r\n                    rule: 'max',\r\n                    options: { value: field.getAttribute('max') }\r\n                });\r\n            }\r\n            \r\n            // Pattern\r\n            if (field.hasAttribute('pattern')) {\r\n                rules.push({\r\n                    rule: 'pattern',\r\n                    options: {\r\n                        value: field.getAttribute('pattern'),\r\n                        message: field.getAttribute('data-error-pattern') || 'Invalid format'\r\n                    }\r\n                });\r\n            }\r\n            \r\n            // Custom validation\r\n            if (field.hasAttribute('data-validate')) {\r\n                const validateAttr = field.getAttribute('data-validate');\r\n                try {\r\n                    const customRule = JSON.parse(validateAttr);\r\n                    rules.push(customRule);\r\n                } catch {\r\n                    // Treat as rule name\r\n                    rules.push(validateAttr);\r\n                }\r\n            }\r\n            \r\n            if (rules.length > 0) {\r\n                schema[field.name] = rules;\r\n            }\r\n        });\r\n        \r\n        return new Validator(schema);\r\n    }\r\n}\r\n\r\n/**\r\n * ValidationRule - Individual validation rule\r\n */\r\nexport class ValidationRule {\r\n    constructor(name, validator, options = {}) {\r\n        this.name = name;\r\n        this.validator = validator;\r\n        this.options = options;\r\n    }\r\n    \r\n    async validate(value) {\r\n        if (typeof this.validator === 'function') {\r\n            const result = await this.validator(value, this.options);\r\n            return result === true ? true : (result || this.options.message || 'Validation failed');\r\n        }\r\n        return true;\r\n    }\r\n}\r\n\r\n","/**\r\n * ValidationRule - Individual validation rule\r\n * \r\n * Represents a single validation rule with its configuration.\r\n */\r\n\r\nexport class ValidationRule {\r\n    constructor(name, validator, options = {}) {\r\n        this.name = name;\r\n        this.validator = validator;\r\n        this.options = options;\r\n    }\r\n    \r\n    /**\r\n     * Validate a value against this rule\r\n     */\r\n    async validate(value) {\r\n        if (typeof this.validator === 'function') {\r\n            const result = await this.validator(value, this.options);\r\n            return result === true ? true : (result || this.options.message || 'Validation failed');\r\n        }\r\n        return true;\r\n    }\r\n    \r\n    /**\r\n     * Get rule name\r\n     */\r\n    getName() {\r\n        return this.name;\r\n    }\r\n    \r\n    /**\r\n     * Get rule options\r\n     */\r\n    getOptions() {\r\n        return { ...this.options };\r\n    }\r\n    \r\n    /**\r\n     * Create a validation rule\r\n     */\r\n    static create(name, validator, options = {}) {\r\n        return new ValidationRule(name, validator, options);\r\n    }\r\n}\r\n\r\n","/**\r\n * Validation Module\r\n * \r\n * Provides standalone validation system for fields, forms, and data.\r\n * \r\n * Usage:\r\n * - Import and use directly: import { Validator } from './modules/validation/index.js'\r\n * - Or use with form-handling module\r\n * - Or use with LiveComponents\r\n * \r\n * Features:\r\n * - Schema-based validation\r\n * - Field-level validation\r\n * - Async validation\r\n * - Custom validation rules\r\n * - Integration with form-handling\r\n * - Integration with LiveComponents\r\n */\r\n\r\nimport { Logger } from '../../core/logger.js';\r\nimport { Validator } from './Validator.js';\r\nimport { ValidationRule } from './ValidationRule.js';\r\n\r\nconst ValidationModule = {\r\n    name: 'validation',\r\n    \r\n    init(config = {}, state = null) {\r\n        Logger.info('[ValidationModule] Module initialized');\r\n        \r\n        // Expose globally for easy access\r\n        if (typeof window !== 'undefined') {\r\n            window.Validator = Validator;\r\n            window.ValidationRule = ValidationRule;\r\n        }\r\n        \r\n        return this;\r\n    },\r\n    \r\n    /**\r\n     * Create a validator from a schema\r\n     */\r\n    create(schema = {}) {\r\n        return Validator.create(schema);\r\n    },\r\n    \r\n    /**\r\n     * Create a validator from a form element\r\n     */\r\n    fromForm(form) {\r\n        return Validator.fromForm(form);\r\n    },\r\n    \r\n    destroy() {\r\n        if (typeof window !== 'undefined') {\r\n            delete window.Validator;\r\n            delete window.ValidationRule;\r\n        }\r\n        \r\n        Logger.info('[ValidationModule] Module destroyed');\r\n    }\r\n};\r\n\r\n// Export for direct usage\r\nexport { Validator, ValidationRule };\r\n\r\n// Export as default for module system\r\nexport default ValidationModule;\r\n\r\n// Export init function for module system\r\nexport const init = ValidationModule.init.bind(ValidationModule);\r\n\r\n","/**\n * Web Push Manager Module\n *\n * Handles Web Push Notification subscriptions and management.\n */\n\nexport class WebPushManager {\n    constructor(options = {}) {\n        this.apiBase = options.apiBase || '/api/push';\n        this.serviceWorkerUrl = options.serviceWorkerUrl || '/js/sw-push.js';\n        this.vapidPublicKey = options.vapidPublicKey || null;\n        this.onSubscriptionChange = options.onSubscriptionChange || null;\n    }\n\n    /**\n     * Initialize Web Push Manager\n     */\n    async init() {\n        if (!('serviceWorker' in navigator)) {\n            throw new Error('Service Workers are not supported in this browser');\n        }\n\n        if (!('PushManager' in window)) {\n            throw new Error('Push API is not supported in this browser');\n        }\n\n        // Register Service Worker\n        await this.registerServiceWorker();\n\n        // Get VAPID public key from server if not provided\n        if (!this.vapidPublicKey) {\n            await this.fetchVapidPublicKey();\n        }\n\n        // Check current subscription status\n        const subscription = await this.getSubscription();\n\n        if (this.onSubscriptionChange) {\n            this.onSubscriptionChange(subscription);\n        }\n\n        return subscription !== null;\n    }\n\n    /**\n     * Register Service Worker\n     */\n    async registerServiceWorker() {\n        try {\n            const registration = await navigator.serviceWorker.register(this.serviceWorkerUrl);\n            console.log('[WebPush] Service Worker registered', registration);\n            return registration;\n        } catch (error) {\n            console.error('[WebPush] Service Worker registration failed', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Fetch VAPID public key from server\n     */\n    async fetchVapidPublicKey() {\n        try {\n            const response = await fetch(`${this.apiBase}/vapid-key`);\n            const data = await response.json();\n\n            if (!data.public_key) {\n                throw new Error('VAPID public key not available');\n            }\n\n            this.vapidPublicKey = data.public_key;\n            console.log('[WebPush] VAPID public key fetched');\n        } catch (error) {\n            console.error('[WebPush] Failed to fetch VAPID public key', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Request notification permission\n     */\n    async requestPermission() {\n        const permission = await Notification.requestPermission();\n        console.log('[WebPush] Permission:', permission);\n\n        if (permission !== 'granted') {\n            throw new Error('Notification permission denied');\n        }\n\n        return permission;\n    }\n\n    /**\n     * Subscribe to push notifications\n     */\n    async subscribe() {\n        try {\n            // Request permission first\n            await this.requestPermission();\n\n            // Get Service Worker registration\n            const registration = await navigator.serviceWorker.ready;\n\n            // Check if already subscribed\n            let subscription = await registration.pushManager.getSubscription();\n\n            if (subscription) {\n                console.log('[WebPush] Already subscribed', subscription);\n            } else {\n                // Subscribe\n                subscription = await registration.pushManager.subscribe({\n                    userVisibleOnly: true,\n                    applicationServerKey: this.urlBase64ToUint8Array(this.vapidPublicKey)\n                });\n\n                console.log('[WebPush] Subscribed', subscription);\n            }\n\n            // Send subscription to server\n            await this.sendSubscriptionToServer(subscription);\n\n            if (this.onSubscriptionChange) {\n                this.onSubscriptionChange(subscription);\n            }\n\n            return subscription;\n        } catch (error) {\n            console.error('[WebPush] Subscription failed', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Unsubscribe from push notifications\n     */\n    async unsubscribe() {\n        try {\n            const registration = await navigator.serviceWorker.ready;\n            const subscription = await registration.pushManager.getSubscription();\n\n            if (!subscription) {\n                console.log('[WebPush] Not subscribed');\n                return false;\n            }\n\n            // Unsubscribe from browser\n            const success = await subscription.unsubscribe();\n\n            if (success) {\n                console.log('[WebPush] Unsubscribed from browser');\n\n                // Remove from server\n                await this.removeSubscriptionFromServer(subscription);\n\n                if (this.onSubscriptionChange) {\n                    this.onSubscriptionChange(null);\n                }\n            }\n\n            return success;\n        } catch (error) {\n            console.error('[WebPush] Unsubscribe failed', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get current subscription\n     */\n    async getSubscription() {\n        try {\n            const registration = await navigator.serviceWorker.ready;\n            return await registration.pushManager.getSubscription();\n        } catch (error) {\n            console.error('[WebPush] Failed to get subscription', error);\n            return null;\n        }\n    }\n\n    /**\n     * Check if subscribed\n     */\n    async isSubscribed() {\n        const subscription = await this.getSubscription();\n        return subscription !== null;\n    }\n\n    /**\n     * Send test notification\n     */\n    async sendTestNotification(title, body) {\n        try {\n            const subscription = await this.getSubscription();\n\n            if (!subscription) {\n                throw new Error('Not subscribed');\n            }\n\n            const response = await fetch(`${this.apiBase}/test`, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json'\n                },\n                body: JSON.stringify({\n                    endpoint: subscription.endpoint,\n                    title: title || 'Test Notification',\n                    body: body || 'This is a test notification!'\n                })\n            });\n\n            const result = await response.json();\n            console.log('[WebPush] Test notification sent', result);\n\n            return result;\n        } catch (error) {\n            console.error('[WebPush] Test notification failed', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Send subscription to server\n     */\n    async sendSubscriptionToServer(subscription) {\n        try {\n            const subscriptionJson = subscription.toJSON();\n\n            const response = await fetch(`${this.apiBase}/subscribe`, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json'\n                },\n                body: JSON.stringify(subscriptionJson)\n            });\n\n            if (!response.ok) {\n                throw new Error(`Server returned ${response.status}`);\n            }\n\n            const result = await response.json();\n            console.log('[WebPush] Subscription sent to server', result);\n\n            return result;\n        } catch (error) {\n            console.error('[WebPush] Failed to send subscription to server', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Remove subscription from server\n     */\n    async removeSubscriptionFromServer(subscription) {\n        try {\n            const response = await fetch(`${this.apiBase}/unsubscribe`, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json'\n                },\n                body: JSON.stringify({\n                    endpoint: subscription.endpoint\n                })\n            });\n\n            if (!response.ok) {\n                throw new Error(`Server returned ${response.status}`);\n            }\n\n            const result = await response.json();\n            console.log('[WebPush] Subscription removed from server', result);\n\n            return result;\n        } catch (error) {\n            console.error('[WebPush] Failed to remove subscription from server', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Convert Base64 URL to Uint8Array (for VAPID key)\n     */\n    urlBase64ToUint8Array(base64String) {\n        const padding = '='.repeat((4 - base64String.length % 4) % 4);\n        const base64 = (base64String + padding)\n            .replace(/-/g, '+')\n            .replace(/_/g, '/');\n\n        const rawData = window.atob(base64);\n        const outputArray = new Uint8Array(rawData.length);\n\n        for (let i = 0; i < rawData.length; ++i) {\n            outputArray[i] = rawData.charCodeAt(i);\n        }\n\n        return outputArray;\n    }\n\n    /**\n     * Get notification permission status\n     */\n    getPermissionStatus() {\n        return Notification.permission;\n    }\n\n    /**\n     * Check if browser supports Web Push\n     */\n    static isSupported() {\n        return ('serviceWorker' in navigator) && ('PushManager' in window);\n    }\n}\n\nexport default WebPushManager;\n","/**\n * Web Push Module Entry Point\n */\n\nimport { WebPushManager } from './WebPushManager.js';\n\nexport { WebPushManager };\n\n/**\n * Initialize WebPush Module\n * Called by framework module system\n */\nexport function init(config = {}, context = null) {\n    const apiBase = config.apiBase || '/api/push';\n\n    // Use absolute path from site root\n    // This ensures the Service Worker has the correct scope\n    const serviceWorkerUrl = config.serviceWorkerUrl || '/js/sw-push.js';\n\n    // Check browser support\n    if (!WebPushManager.isSupported()) {\n        console.warn('⚠️ WebPush not supported in this browser');\n        console.warn('Service Worker support:', 'serviceWorker' in navigator);\n        console.warn('Push Manager support:', 'PushManager' in window);\n        return null;\n    }\n\n    try {\n        // Create global instance\n        window.webPushManager = new WebPushManager({\n            apiBase,\n            serviceWorkerUrl,\n            onSubscriptionChange: (subscription) => {\n                console.log('🔔 Push subscription changed:', subscription ? 'Subscribed' : 'Unsubscribed');\n            }\n        });\n\n        console.log('🔔 WebPush Manager initialized (use window.webPushManager)');\n        console.log('Service Worker URL:', serviceWorkerUrl);\n        console.log('API Base:', apiBase);\n        console.log('');\n        console.log('💡 Usage:');\n        console.log('  await window.webPushManager.init()           // Initialize and register service worker');\n        console.log('  await window.webPushManager.subscribe()      // Subscribe to notifications');\n        console.log('  await window.webPushManager.unsubscribe()    // Unsubscribe');\n        console.log('  await window.webPushManager.sendTestNotification()  // Send test');\n\n        return window.webPushManager;\n    } catch (error) {\n        console.error('❌ Failed to initialize WebPush Manager:', error);\n        return null;\n    }\n}\n","export const moduleConfig = {\n    'noise': {\n        selector: '.noise-overlay',\n        toggleKey: 'g',\n        className: 'grainy',\n        enableTransition: true\n    },\n    'shortcut-handler.js': {\n        debug: false\n    },\n    'scrollfx': {\n        selector: '.fade-in-on-scroll, .zoom-in',\n        offset: 0.8,\n        baseDelay: 0.075,\n        once: true\n    },\n    'scroll-timeline': {\n        attribute: 'data-scroll-step',\n        triggerPoint: 0.4,\n        once: false\n    },\n    'smooth-scroll': {\n        'speed': 0.2,\n    },\n    'performance-profiler': {\n        enabled: false, // Enable via data-module=\"performance-profiler\" or in dev mode\n        maxSamples: 1000,\n        samplingInterval: 10,\n        autoStart: false,\n        autoInstrument: true, // Auto-instrument LiveComponents\n        flamegraphContainer: '#flamegraph-container',\n        timelineContainer: '#timeline-container',\n        flamegraph: {\n            width: 1200,\n            height: 400,\n            barHeight: 20,\n            barPadding: 2,\n            colorScheme: 'category', // 'category', 'duration', 'monochrome'\n            minWidth: 0.5\n        },\n        timeline: {\n            width: 1200,\n            height: 200,\n            trackHeight: 30,\n            padding: { top: 20, right: 20, bottom: 30, left: 60 }\n        }\n    }\n};\n","/**\n * Error Boundary System für Module\n * Bietet Schutz vor Module-Crashes und Recovery-Mechanismen\n */\nimport { Logger } from './logger.js';\n\nexport class ModuleErrorBoundary {\n    constructor() {\n        this.crashedModules = new Set();\n        this.recoveryAttempts = new Map();\n        this.maxRecoveryAttempts = 3;\n        this.recoveryDelay = 1000; // 1 second\n    }\n\n    /**\n     * Wraps a module with error handling\n     * @param {Object} module - The module to wrap\n     * @param {string} moduleName - Name of the module for logging\n     * @returns {Proxy} - Protected module instance\n     */\n    wrapModule(module, moduleName) {\n        if (!module || typeof module !== 'object') {\n            Logger.warn(`[ErrorBoundary] Cannot wrap non-object module: ${moduleName}`);\n            return module;\n        }\n\n        return new Proxy(module, {\n            get: (target, prop, receiver) => {\n                const originalValue = target[prop];\n\n                // If property is not a function, return as-is\n                if (typeof originalValue !== 'function') {\n                    return originalValue;\n                }\n\n                // Check if property is non-configurable - return original if so\n                const descriptor = Object.getOwnPropertyDescriptor(target, prop);\n                if (descriptor && !descriptor.configurable) {\n                    return originalValue;\n                }\n\n                // Return wrapped function with error handling\n                return (...args) => {\n                    try {\n                        const result = originalValue.apply(target, args);\n                        \n                        // Handle async functions\n                        if (result && typeof result.catch === 'function') {\n                            return result.catch(error => {\n                                this.handleModuleError(error, moduleName, prop, args);\n                                return this.getRecoveryValue(moduleName, prop);\n                            });\n                        }\n                        \n                        return result;\n                    } catch (error) {\n                        this.handleModuleError(error, moduleName, prop, args);\n                        return this.getRecoveryValue(moduleName, prop);\n                    }\n                };\n            },\n            getOwnPropertyDescriptor: (target, prop) => {\n                const descriptor = Object.getOwnPropertyDescriptor(target, prop);\n                \n                // For non-configurable properties, return original descriptor\n                if (descriptor && !descriptor.configurable) {\n                    return descriptor;\n                }\n                \n                return descriptor;\n            },\n            has: (target, prop) => {\n                return prop in target;\n            },\n            ownKeys: (target) => {\n                return Object.getOwnPropertyNames(target);\n            }\n        });\n    }\n\n    /**\n     * Handles module errors with recovery logic\n     * @param {Error} error - The error that occurred\n     * @param {string} moduleName - Name of the failing module\n     * @param {string} method - Method that failed\n     * @param {Array} args - Arguments passed to the method\n     */\n    handleModuleError(error, moduleName, method, args) {\n        const errorKey = `${moduleName}.${method}`;\n        \n        Logger.error(`[ErrorBoundary] Module ${moduleName} crashed in ${method}():`, error);\n        \n        // Track crashed modules\n        this.crashedModules.add(moduleName);\n        \n        // Track recovery attempts\n        const attempts = this.recoveryAttempts.get(errorKey) || 0;\n        this.recoveryAttempts.set(errorKey, attempts + 1);\n        \n        // Emit custom event for external handling\n        window.dispatchEvent(new CustomEvent('module-error', {\n            detail: {\n                moduleName,\n                method,\n                error: error.message,\n                args,\n                attempts: attempts + 1\n            }\n        }));\n\n        // Attempt recovery if under limit\n        if (attempts < this.maxRecoveryAttempts) {\n            this.scheduleRecovery(moduleName, method, args);\n        } else {\n            Logger.error(`[ErrorBoundary] Module ${moduleName} exceeded recovery attempts. Marking as permanently failed.`);\n            this.markModuleAsPermanentlyFailed(moduleName);\n        }\n    }\n\n    /**\n     * Schedules a recovery attempt for a failed module method\n     * @param {string} moduleName - Name of the module\n     * @param {string} method - Method to retry\n     * @param {Array} args - Original arguments\n     */\n    scheduleRecovery(moduleName, method, args) {\n        setTimeout(() => {\n            try {\n                Logger.info(`[ErrorBoundary] Attempting recovery for ${moduleName}.${method}()`);\n                // This would need module registry integration\n                // For now, just log the attempt\n            } catch (recoveryError) {\n                Logger.error(`[ErrorBoundary] Recovery failed for ${moduleName}.${method}():`, recoveryError);\n            }\n        }, this.recoveryDelay);\n    }\n\n    /**\n     * Returns a safe fallback value for failed module methods\n     * @param {string} moduleName - Name of the module\n     * @param {string} method - Method that failed\n     * @returns {*} - Safe fallback value\n     */\n    getRecoveryValue(moduleName, method) {\n        // Return safe defaults based on common method names\n        switch (method) {\n            case 'init':\n            case 'destroy':\n            case 'update':\n            case 'render':\n                return Promise.resolve();\n            case 'getData':\n            case 'getConfig':\n                return {};\n            case 'isEnabled':\n            case 'isActive':\n                return false;\n            default:\n                return undefined;\n        }\n    }\n\n    /**\n     * Marks a module as permanently failed\n     * @param {string} moduleName - Name of the module\n     */\n    markModuleAsPermanentlyFailed(moduleName) {\n        window.dispatchEvent(new CustomEvent('module-permanent-failure', {\n            detail: { moduleName }\n        }));\n    }\n\n    /**\n     * Gets health status of all modules\n     * @returns {Object} - Health status report\n     */\n    getHealthStatus() {\n        return {\n            totalCrashedModules: this.crashedModules.size,\n            crashedModules: Array.from(this.crashedModules),\n            recoveryAttempts: Object.fromEntries(this.recoveryAttempts),\n            timestamp: new Date().toISOString()\n        };\n    }\n\n    /**\n     * Resets error tracking for a module (useful for hot reload)\n     * @param {string} moduleName - Name of the module to reset\n     */\n    resetModule(moduleName) {\n        this.crashedModules.delete(moduleName);\n        \n        // Remove all recovery attempts for this module\n        for (const [key] of this.recoveryAttempts) {\n            if (key.startsWith(`${moduleName}.`)) {\n                this.recoveryAttempts.delete(key);\n            }\n        }\n        \n        Logger.info(`[ErrorBoundary] Reset error tracking for module: ${moduleName}`);\n    }\n\n    /**\n     * Clears all error tracking\n     */\n    reset() {\n        this.crashedModules.clear();\n        this.recoveryAttempts.clear();\n        Logger.info('[ErrorBoundary] Reset all error tracking');\n    }\n}\n\n// Global instance\nexport const moduleErrorBoundary = new ModuleErrorBoundary();\n\n// Global error handlers\nwindow.addEventListener('error', (event) => {\n    Logger.error('[Global] Unhandled error:', event.error || event.message);\n});\n\nwindow.addEventListener('unhandledrejection', (event) => {\n    Logger.error('[Global] Unhandled promise rejection:', event.reason);\n});","/**\n * Reactive State Management System für Module-Kommunikation\n * Ermöglicht type-safe state sharing zwischen Modulen\n */\nimport { Logger } from './logger.js';\n\n/**\n * @typedef {Object} StateChangeEvent\n * @property {string} key - State key that changed\n * @property {*} value - New value\n * @property {*} oldValue - Previous value\n * @property {string} source - Module that triggered the change\n */\n\n/**\n * @typedef {Object} StateSubscription\n * @property {string} id - Unique subscription ID\n * @property {Function} callback - Callback function\n * @property {string} subscriber - Module name that subscribed\n */\n\nexport class StateManager {\n    constructor() {\n        /** @type {Map<string, any>} */\n        this.state = new Map();\n        \n        /** @type {Map<string, StateSubscription[]>} */\n        this.subscribers = new Map();\n        \n        /** @type {Map<string, string>} */\n        this.stateOwners = new Map();\n        \n        /** @type {Map<string, any>} */\n        this.defaultValues = new Map();\n        \n        /** @type {string} */\n        this.currentModule = 'unknown';\n        \n        this.subscriptionCounter = 0;\n    }\n\n    /**\n     * Set the current module context for state operations\n     * @param {string} moduleName - Name of the module\n     */\n    setContext(moduleName) {\n        this.currentModule = moduleName;\n    }\n\n    /**\n     * Register a state key with default value and owner\n     * @param {string} key - State key\n     * @param {*} defaultValue - Default value\n     * @param {string} [owner] - Module that owns this state\n     */\n    register(key, defaultValue, owner = this.currentModule) {\n        if (this.state.has(key)) {\n            Logger.warn(`[StateManager] State key '${key}' already registered by ${this.stateOwners.get(key)}`);\n            return;\n        }\n\n        this.state.set(key, defaultValue);\n        this.defaultValues.set(key, defaultValue);\n        this.stateOwners.set(key, owner);\n        this.subscribers.set(key, []);\n\n        Logger.info(`[StateManager] Registered '${key}' (owner: ${owner})`);\n    }\n\n    /**\n     * Get current value of state key\n     * @param {string} key - State key\n     * @returns {*} Current value or undefined\n     */\n    get(key) {\n        if (!this.state.has(key)) {\n            Logger.warn(`[StateManager] Unknown state key: '${key}'`);\n            return undefined;\n        }\n        return this.state.get(key);\n    }\n\n    /**\n     * Set value for state key (with ownership check)\n     * @param {string} key - State key\n     * @param {*} value - New value\n     * @param {boolean} [force=false] - Force set even if not owner\n     * @returns {boolean} Success status\n     */\n    set(key, value, force = false) {\n        if (!this.state.has(key)) {\n            Logger.warn(`[StateManager] Cannot set unknown state key: '${key}'`);\n            return false;\n        }\n\n        const owner = this.stateOwners.get(key);\n        if (!force && owner !== this.currentModule) {\n            Logger.warn(`[StateManager] Module '${this.currentModule}' cannot modify '${key}' (owned by ${owner})`);\n            return false;\n        }\n\n        const oldValue = this.state.get(key);\n        if (oldValue === value) {\n            return true; // No change\n        }\n\n        this.state.set(key, value);\n        this.notifySubscribers(key, value, oldValue);\n\n        Logger.info(`[StateManager] Updated '${key}' by ${this.currentModule}`);\n        return true;\n    }\n\n    /**\n     * Subscribe to state changes\n     * @param {string} key - State key to watch\n     * @param {Function} callback - Callback function (value, oldValue, key) => void\n     * @param {string} [subscriber] - Subscriber module name\n     * @returns {string} Subscription ID for unsubscribing\n     */\n    subscribe(key, callback, subscriber = this.currentModule) {\n        if (!this.state.has(key)) {\n            Logger.warn(`[StateManager] Cannot subscribe to unknown state key: '${key}'`);\n            return null;\n        }\n\n        const subscriptionId = `${subscriber}_${++this.subscriptionCounter}`;\n        const subscription = {\n            id: subscriptionId,\n            callback,\n            subscriber\n        };\n\n        if (!this.subscribers.has(key)) {\n            this.subscribers.set(key, []);\n        }\n\n        this.subscribers.get(key).push(subscription);\n        Logger.info(`[StateManager] Subscribed '${subscriber}' to '${key}'`);\n\n        return subscriptionId;\n    }\n\n    /**\n     * Unsubscribe from state changes\n     * @param {string} subscriptionId - Subscription ID from subscribe()\n     */\n    unsubscribe(subscriptionId) {\n        for (const [key, subscriptions] of this.subscribers.entries()) {\n            const index = subscriptions.findIndex(sub => sub.id === subscriptionId);\n            if (index !== -1) {\n                const subscription = subscriptions[index];\n                subscriptions.splice(index, 1);\n                Logger.info(`[StateManager] Unsubscribed '${subscription.subscriber}' from '${key}'`);\n                return;\n            }\n        }\n        Logger.warn(`[StateManager] Subscription ID not found: ${subscriptionId}`);\n    }\n\n    /**\n     * Notify all subscribers of a state change\n     * @private\n     * @param {string} key - State key\n     * @param {*} value - New value\n     * @param {*} oldValue - Previous value\n     */\n    notifySubscribers(key, value, oldValue) {\n        const subscriptions = this.subscribers.get(key) || [];\n        \n        subscriptions.forEach(subscription => {\n            try {\n                subscription.callback(value, oldValue, key);\n            } catch (error) {\n                Logger.error(`[StateManager] Error in subscriber '${subscription.subscriber}' for '${key}':`, error);\n            }\n        });\n    }\n\n    /**\n     * Reset state key to default value\n     * @param {string} key - State key to reset\n     * @returns {boolean} Success status\n     */\n    reset(key) {\n        if (!this.state.has(key)) {\n            Logger.warn(`[StateManager] Cannot reset unknown state key: '${key}'`);\n            return false;\n        }\n\n        const defaultValue = this.defaultValues.get(key);\n        return this.set(key, defaultValue, true);\n    }\n\n    /**\n     * Clear all subscriptions for a module (useful for cleanup)\n     * @param {string} moduleName - Module name\n     */\n    clearModuleSubscriptions(moduleName) {\n        let cleared = 0;\n        \n        for (const [key, subscriptions] of this.subscribers.entries()) {\n            const filtered = subscriptions.filter(sub => sub.subscriber !== moduleName);\n            cleared += subscriptions.length - filtered.length;\n            this.subscribers.set(key, filtered);\n        }\n\n        if (cleared > 0) {\n            Logger.info(`[StateManager] Cleared ${cleared} subscriptions for module '${moduleName}'`);\n        }\n    }\n\n    /**\n     * Get current state snapshot (for debugging)\n     * @returns {Object} Current state and metadata\n     */\n    getSnapshot() {\n        const snapshot = {\n            state: Object.fromEntries(this.state),\n            owners: Object.fromEntries(this.stateOwners),\n            subscriptions: {}\n        };\n\n        for (const [key, subs] of this.subscribers.entries()) {\n            snapshot.subscriptions[key] = subs.map(sub => ({\n                id: sub.id,\n                subscriber: sub.subscriber\n            }));\n        }\n\n        return snapshot;\n    }\n\n    /**\n     * Reset entire state manager (useful for testing)\n     */\n    resetAll() {\n        this.state.clear();\n        this.subscribers.clear();\n        this.stateOwners.clear();\n        this.defaultValues.clear();\n        this.subscriptionCounter = 0;\n        Logger.info('[StateManager] Reset complete');\n    }\n\n    /**\n     * Create a scoped state manager for a specific module\n     * @param {string} moduleName - Module name\n     * @returns {Object} Scoped state interface\n     */\n    createScope(moduleName) {\n        return {\n            register: (key, defaultValue) => {\n                this.setContext(moduleName);\n                return this.register(key, defaultValue, moduleName);\n            },\n            \n            get: (key) => this.get(key),\n            \n            set: (key, value) => {\n                this.setContext(moduleName);\n                return this.set(key, value);\n            },\n            \n            subscribe: (key, callback) => {\n                this.setContext(moduleName);\n                return this.subscribe(key, callback, moduleName);\n            },\n            \n            unsubscribe: (subscriptionId) => this.unsubscribe(subscriptionId),\n            \n            reset: (key) => this.reset(key),\n            \n            cleanup: () => this.clearModuleSubscriptions(moduleName)\n        };\n    }\n}\n\n// Global instance\nexport const stateManager = new StateManager();\n\n// Debug access\nif (typeof window !== 'undefined') {\n    window.stateManager = stateManager;\n    window.stateSnapshot = () => stateManager.getSnapshot();\n}","import { moduleConfig } from './config.js';\nimport { Logger } from '../core/logger.js';\nimport { moduleErrorBoundary } from '../core/ModuleErrorBoundary.js';\nimport { stateManager } from '../core/StateManager.js';\nimport { dependencyManager } from '../core/DependencyManager.js';\n\nexport const activeModules = new Map(); // key: modulename → { mod, config, state }\n\nexport async function registerModules() {\n    // Use EAGER loading for single bundle - all modules in one chunk\n    let modules;\n    if (typeof global !== 'undefined' && global.importMeta?.glob) {\n        modules = global.importMeta.glob('./*/index.js', { eager: true });\n    } else {\n        modules = import.meta.glob('./*/index.js', { eager: true });\n    }\n    \n    Logger.info('[Modules] Found modules:', Object.keys(modules));\n\n    const domModules = new Set(\n        Array.from(document.querySelectorAll('[data-module]')).map(el => el.dataset.module).filter(Boolean)\n    );\n\n    // Always load these core modules\n    const coreModules = new Set(['spa-router', 'form-handling', 'api-manager', 'image-manager', 'livecomponent']);\n    \n    const usedModules = new Set([...domModules, ...coreModules]);\n    const fallbackMode = usedModules.size === coreModules.size && domModules.size === 0;\n    \n    Logger.info('[Modules] DOM modules found:', [...domModules]);\n    Logger.info('[Modules] Core modules:', [...coreModules]);\n    Logger.info('[Modules] Used modules:', [...usedModules]);\n    Logger.info('[Modules] Fallback mode:', fallbackMode);\n\n    // Phase 1: Register only USED modules with dependency manager\n    console.log('🔍 [Modules] Starting Phase 1 - Module Registration');\n    console.log('🔍 [Modules] All discovered modules:', Object.keys(modules));\n    console.log('🔍 [Modules] Used modules:', [...usedModules]);\n    console.log('🔍 [Modules] Fallback mode:', fallbackMode);\n\n    Object.entries(modules).forEach(([path, mod]) => {\n        const name = path.split('/').slice(-2, -1)[0];\n        console.log(`🔍 [Module] Processing: ${name} from ${path}`);\n        console.log(`🔍 [Module] Used modules has ${name}:`, usedModules.has(name));\n\n        if(!fallbackMode && !usedModules.has(name)) {\n            console.log(`⏭️ [Module] Skipping unused module: ${name}`);\n            return;\n        }\n\n        console.log(`✅ [Module] Registering ${name} with dependency manager`);\n\n        // Register module definition if provided\n        if (typeof mod.definition === 'object') {\n            Logger.info(`📋 [Module] Using definition for ${name}:`, mod.definition);\n            dependencyManager.register(mod.definition);\n        } else {\n            // Create default definition for modules without explicit dependencies\n            const defaultDef = {\n                name,\n                version: '1.0.0',\n                dependencies: [],\n                provides: [],\n                priority: 0\n            };\n            Logger.info(`📋 [Module] Using default definition for ${name}:`, defaultDef);\n            dependencyManager.register(defaultDef);\n        }\n    });\n\n    // Phase 2: Calculate initialization order\n    const initOrder = dependencyManager.calculateInitializationOrder();\n    console.log('🔍 [Modules] Phase 2 - Initialization Order:', initOrder);\n\n    // Phase 3: Initialize modules in dependency order\n    for (const name of initOrder) {\n        console.log(`🔍 [Module] Phase 3 - Processing ${name} for initialization`);\n        console.log(`🔍 [Module] Used modules has ${name}:`, usedModules.has(name));\n        console.log(`🔍 [Module] Fallback mode:`, fallbackMode);\n\n        if(!fallbackMode && !usedModules.has(name)) {\n            console.log(`⏭️ [Module] Skipped (not used in DOM): ${name}`);\n            continue;\n        }\n\n        const modulePath = Object.keys(modules).find(path =>\n            path.split('/').slice(-2, -1)[0] === name\n        );\n\n        console.log(`🔍 [Module] Looking for module path for ${name}, found:`, modulePath);\n\n        if (!modulePath) {\n            console.log(`⛔ [Module] No implementation found for: ${name}`);\n            continue;\n        }\n\n        const mod = modules[modulePath];\n        const config = moduleConfig[name] || {};\n\n        console.log(`🔍 [Module] Module ${name} object:`, mod);\n        console.log(`🔍 [Module] Config for ${name}:`, config);\n\n        // Check dependencies before initialization\n        const depCheck = dependencyManager.checkDependencies(name);\n        console.log(`🔍 [Module] Dependency check for ${name}:`, depCheck);\n\n        if (!depCheck.satisfied) {\n            console.log(`❌ [Module] Cannot initialize ${name}: ${depCheck.reason}`);\n            activeModules.set(name, { mod: null, config, error: new Error(depCheck.reason), original: mod });\n            continue;\n        }\n\n        console.log(`🔍 [Module] Checking init function for ${name}:`, typeof mod.init, mod.init);\n        console.log(`🔍 [Module] Module object keys for ${name}:`, Object.keys(mod));\n        console.log(`🔍 [Module] Full module object for ${name}:`, mod);\n\n        if (typeof mod.init === 'function') {\n            try {\n                Logger.info(`🚀 [Module] Starting initialization for ${name}`);\n                dependencyManager.markInitializing(name);\n\n                // Create scoped state manager for module\n                const scopedState = stateManager.createScope(name);\n\n                // Wrap module with error boundary\n                const protectedMod = moduleErrorBoundary.wrapModule(mod, name);\n\n                // Initialize module with config and state\n                await protectedMod.init(config, scopedState);\n\n                dependencyManager.markInitialized(name);\n                activeModules.set(name, {\n                    mod: protectedMod,\n                    config,\n                    state: scopedState,\n                    original: mod\n                });\n                Logger.info(`✅ [Module] Initialized: ${name}`);\n            } catch (error) {\n                Logger.error(`❌ [Module] Failed to initialize ${name}:`, error);\n                activeModules.set(name, { mod: null, config, error, original: mod });\n            }\n        } else {\n            Logger.warn(`⛔ [Module] No init() in ${name} - typeof:`, typeof mod.init);\n            Logger.warn(`⛔ [Module] Available properties:`, Object.getOwnPropertyNames(mod));\n        }\n    }\n\n    if (fallbackMode) {\n        Logger.info('⚠️ [Module] No data-module usage detected, fallback to full init mode');\n    }\n}\n\nexport function destroyModules() {\n    for (const [name, { mod, state }] of activeModules.entries()) {\n        if (mod && typeof mod.destroy === 'function') {\n            try {\n                mod.destroy();\n                Logger.info(`🧹 [Module] Destroyed: ${name}`);\n            } catch (error) {\n                Logger.error(`❌ [Module] Failed to destroy ${name}:`, error);\n            }\n        }\n        \n        // Clean up state subscriptions\n        if (state && typeof state.cleanup === 'function') {\n            state.cleanup();\n        }\n    }\n    activeModules.clear();\n    moduleErrorBoundary.reset();\n    stateManager.reset();\n    dependencyManager.reset();\n}\n\n/**\n * Gets health status of all active modules\n * @returns {Object} Module health report\n */\nexport function getModuleHealth() {\n    const health = {\n        total: activeModules.size,\n        active: 0,\n        failed: 0,\n        modules: {},\n        errorBoundary: moduleErrorBoundary.getHealthStatus()\n    };\n\n    for (const [name, { mod, error }] of activeModules.entries()) {\n        if (error) {\n            health.failed++;\n            health.modules[name] = { status: 'failed', error: error.message };\n        } else if (mod) {\n            health.active++;\n            health.modules[name] = { status: 'active' };\n        } else {\n            health.modules[name] = { status: 'unknown' };\n        }\n    }\n\n    return health;\n}\n\n// Debug function - access via console\nif (typeof window !== 'undefined') {\n    window.moduleHealth = getModuleHealth;\n    window.activeModules = activeModules;\n}\n","\n\nimport { registerModules, activeModules } from \"../modules/index.js\";\nimport { Logger } from './logger.js';\nimport {useEvent} from \"./useEvent\";\n\n\n\n/*import { createTrigger, destroyTrigger, destroyAllTriggers } from './scrollfx/index.js';\n\ncreateTrigger({\n    element: 'section',\n    target: '.fade',\n    start: 'top 80%',\n    end: 'bottom 30%',\n    scrub: true,\n    onUpdate: (() => {\n        const progressMap = new WeakMap();\n\n        return (el, progress) => {\n            if (!el) return;\n\n            let current = progressMap.get(el) || 0;\n            current += (progress - current) * 0.1;\n            progressMap.set(el, current);\n\n            el.style.opacity = current;\n            el.style.transform = `translateY(${30 - 30 * current}px)`;\n        };\n    })(),\n\n    onEnter: el => el.classList.add('entered'),\n    onLeave: el => {\n        el.classList.remove('entered');\n        el.style.opacity = 0;\n        el.style.transform = 'translateY(30px)';\n    }\n});*/\n\n\n\n\n\n/*\nlet lastScrollY = window.scrollY;\n\nconst fadeElements = document.querySelectorAll('.fade-in-on-scroll');\n\n// Observer 1: Einblenden beim Runterscrollen\nconst fadeInObserver = new IntersectionObserver((entries) => {\n    const scrollingDown = window.scrollY > lastScrollY;\n    lastScrollY = window.scrollY;\n\n    entries.forEach(entry => {\n        if (entry.isIntersecting && scrollingDown) {\n            entry.target.classList.add('visible');\n        }\n    });\n}, {\n    threshold: 0.4,\n    rootMargin: '0px 0px -10% 0px'\n});\n\n// Observer 2: Ausblenden beim Hochscrollen\nconst fadeOutObserver = new IntersectionObserver((entries) => {\n    const scrollingUp = window.scrollY < lastScrollY;\n    lastScrollY = window.scrollY;\n\n    entries.forEach(entry => {\n        if (!entry.isIntersecting && scrollingUp) {\n            entry.target.classList.remove('visible');\n        }\n    });\n}, {\n    threshold: 0.5,\n    rootMargin: '0% 0px 50% 0px' // früher triggern beim Hochscrollen\n});\n\n// Alle Elemente mit beiden Observern beobachten\nfadeElements.forEach(el => {\n    fadeInObserver.observe(el);\n    fadeOutObserver.observe(el);\n});\n*/\n\n\n/*\nconst newContent = '<h1>Neue Seite</h1>'; // dein AJAX-Inhalt z. B.\nconst container = document.querySelector('main');\n\ndocument.startViewTransition(() => {\n    container.innerHTML = newContent;\n});*/\n\nimport {autoLoadResponsiveVideos} from \"../utils/autoLoadResponsiveVideo\";\n\n/**\n * Initialize DOM elements with data-module attributes\n */\nfunction initDataModuleElements() {\n    const elements = document.querySelectorAll('[data-module]');\n    Logger.info(`[DOMInit] Found ${elements.length} elements with data-module attributes`);\n    \n    elements.forEach(element => {\n        const moduleName = element.dataset.module;\n        const moduleData = activeModules.get(moduleName);\n        \n        if (!moduleData || !moduleData.mod) {\n            Logger.warn(`[DOMInit] Module \"${moduleName}\" not found or failed to initialize`);\n            return;\n        }\n        \n        // Parse options from data-options attribute\n        let options = {};\n        try {\n            if (element.dataset.options) {\n                options = JSON.parse(element.dataset.options);\n            }\n        } catch (error) {\n            Logger.warn(`[DOMInit] Invalid JSON in data-options for ${moduleName}:`, error);\n        }\n        \n        // Initialize the module on this element\n        try {\n            const moduleInstance = moduleData.mod;\n            \n            // Check for element-specific init method first, then fallback to general init\n            if (typeof moduleInstance.initElement === 'function') {\n                const result = moduleInstance.initElement(element, options);\n                Logger.info(`[DOMInit] Initialized ${moduleName} on element:`, element);\n                \n                // Store reference for cleanup\n                element._moduleInstance = result;\n                element._moduleName = moduleName;\n            } else if (typeof moduleInstance.init === 'function') {\n                const result = moduleInstance.init(element, options);\n                Logger.info(`[DOMInit] Initialized ${moduleName} on element:`, element);\n                \n                // Store reference for cleanup\n                element._moduleInstance = result;\n                element._moduleName = moduleName;\n            } else {\n                Logger.warn(`[DOMInit] Module ${moduleName} has no init method for DOM elements`);\n            }\n        } catch (error) {\n            Logger.error(`[DOMInit] Failed to initialize ${moduleName} on element:`, error, element);\n        }\n    });\n}\n\n/**\n * Initialize SPA Router for seamless navigation\n */\nfunction initSPARouter() {\n    const spaRouterModule = activeModules.get('spa-router');\n    \n    if (!spaRouterModule || !spaRouterModule.mod) {\n        Logger.info('[Init] SPA Router module not available, skipping');\n        return;\n    }\n    \n    try {\n        // Initialize SPA Router with default configuration\n        const router = spaRouterModule.mod.init({\n            containerSelector: 'main',\n            enableTransitions: true,\n            transitionDuration: 300\n        });\n        \n        // Make functions globally available for re-initialization\n        window.initAutoFormHandling = initAutoFormHandling;\n        window.initDataModuleElements = initDataModuleElements;\n        \n        Logger.info('[Init] SPA Router initialized successfully');\n    } catch (error) {\n        Logger.error('[Init] Failed to initialize SPA Router:', error);\n    }\n}\n\n/**\n * Auto-initialize all forms with form-handling (opt-out approach)\n */\nfunction initAutoFormHandling() {\n    // Find all forms except those explicitly opting out and those already enhanced\n    const forms = document.querySelectorAll('form:not([data-form-handling=\"false\"]):not([data-auto-enhanced])');\n    Logger.info(`[AutoForms] Found ${forms.length} forms for auto-enhancement`);\n    \n    if (forms.length === 0) return;\n    \n    // Check if form-handling module is available\n    const formHandlingModule = activeModules.get('form-handling');\n    if (!formHandlingModule || !formHandlingModule.mod) {\n        Logger.warn('[AutoForms] form-handling module not available, skipping auto-init');\n        return;\n    }\n    \n    forms.forEach(form => {\n        // Skip forms that already have explicit data-module\n        if (form.hasAttribute('data-module')) {\n            Logger.info(`[AutoForms] Skipping form with explicit data-module:`, form);\n            return;\n        }\n        \n        // Skip forms that are already enhanced (double-check)\n        if (form.hasAttribute('data-auto-enhanced')) {\n            return;\n        }\n        \n        // Parse options from data-form-options attribute\n        let options = {};\n        try {\n            if (form.dataset.formOptions) {\n                options = JSON.parse(form.dataset.formOptions);\n            }\n        } catch (error) {\n            Logger.warn('[AutoForms] Invalid JSON in data-form-options:', error);\n        }\n        \n        // Set default options for auto-enhanced forms\n        const autoOptions = {\n            validateOnSubmit: true,\n            validateOnBlur: false,\n            validateOnInput: false,\n            showInlineErrors: true,\n            ajaxSubmit: true,\n            enableStateTracking: false, // Conservative default\n            ...options\n        };\n        \n        // Initialize form handling\n        try {\n            // Use initElement for DOM-specific initialization\n            const result = formHandlingModule.mod.initElement ? \n                formHandlingModule.mod.initElement(form, autoOptions) :\n                formHandlingModule.mod.init(form, autoOptions);\n                \n            Logger.info('[AutoForms] Auto-enhanced form:', {\n                id: form.id || 'unnamed',\n                action: form.action || 'none',\n                method: form.method || 'get',\n                elements: form.elements.length\n            });\n            \n            // Mark as auto-enhanced\n            form.setAttribute('data-auto-enhanced', 'true');\n            form._moduleInstance = result;\n            form._moduleName = 'form-handling';\n        } catch (error) {\n            Logger.error('[AutoForms] Failed to auto-enhance form:', error, form);\n        }\n    });\n}\n\n/**\n * Initialize the application\n * Sets up all modules and core functionality\n * @async\n * @function initApp\n * @returns {Promise<void>}\n */\nexport async function initApp() {\n\n    await registerModules();\n    \n    // Initialize DOM elements after modules are registered\n    initDataModuleElements();\n    \n    // Auto-enhance all forms with form-handling\n    initAutoFormHandling();\n    \n    // Initialize SPA Router for seamless navigation\n    initSPARouter();\n\n    autoLoadResponsiveVideos();\n\n    /*initNoiseToggle({\n        selector: '.noise-overlay',\n        toggleKey: 'g',            // Taste zum Umschalten\n        className: 'grainy',       // Klasse auf <body>\n        enableTransition: true     // Smooth fade\n    });\n\n\n    fadeScrollTrigger('.fade');\n    zoomScrollTrigger('.zoomed');\n\n    fixedZoomScrollTrigger('h1');*/\n}\n","// 📦 Automatischer Video-Loader (Bandbreiten- & Auflösungs-bewusst)\n// Erkennt automatisch <video data-src=\"basename\"> Elemente\n// Lädt passende Variante: basename-480.webm, -720.webm, -1080.webm etc.\n\nexport function autoLoadResponsiveVideos() {\n    const videos = document.querySelectorAll('video[data-src]');\n    const width = window.innerWidth;\n    const connection = navigator.connection || {};\n    const net = connection.effectiveType || '4g';\n\n    videos.forEach(video => {\n        const base = video.dataset.src;\n        let suffix = '480';\n\n        if (net === '2g' || net === 'slow-2g') {\n            suffix = '480';\n        } else if (net === '3g') {\n            suffix = width >= 1200 ? '720' : '480';\n        } else {\n            suffix = width >= 1200 ? '1080' : width >= 800 ? '720' : '480';\n        }\n\n        const src = `${base}-${suffix}.webm`;\n\n        const newVideo = document.createElement('video');\n        newVideo.autoplay = true;\n        newVideo.loop = true;\n        newVideo.muted = true;\n        newVideo.playsInline = true;\n        newVideo.poster = video.getAttribute('poster') || '';\n        newVideo.setAttribute('width', video.getAttribute('width') || '100%');\n\n        const source = document.createElement('source');\n        source.src = src;\n        source.type = 'video/webm';\n\n        newVideo.appendChild(source);\n        video.replaceWith(newVideo);\n    });\n}\n\n/*\n\n\n<video data-src=\"/media/video\" poster=\"/media/preview.jpg\" width=\"100%\">\n    <!-- Optionaler Fallback -->\n    <source src=\"/media/video-480.mp4\" type=\"video/mp4\"/>\n</video>\n\n*/\n","import { FormHandler } from './form-handling/FormHandler.js';\r\nimport { Logger } from '../core/logger.js';\r\n\r\n/**\r\n * FormAutoSave - Wrapper for FormHandler autosave functionality\r\n * \r\n * This module provides a simple interface to initialize autosave\r\n * for all forms on the page. The actual autosave logic is implemented\r\n * in FormHandler.\r\n */\r\nexport class FormAutoSave {\r\n    /**\r\n     * Initialize autosave for all forms on the page\r\n     * @param {Object} options - Options for autosave initialization\r\n     * @returns {Array} Array of initialized FormHandler instances\r\n     */\r\n    static initializeAll(options = {}) {\r\n        const forms = document.querySelectorAll('form[data-autosave]');\r\n        const instances = [];\r\n\r\n        forms.forEach(form => {\r\n            try {\r\n                const handler = FormHandler.create(form, {\r\n                    enableAutosave: true,\r\n                    ...options\r\n                });\r\n                instances.push(handler);\r\n            } catch (error) {\r\n                Logger.error('[FormAutoSave] Failed to initialize autosave for form', {\r\n                    form: form.id || 'unnamed',\r\n                    error\r\n                });\r\n            }\r\n        });\r\n\r\n        Logger.info(`[FormAutoSave] Initialized autosave for ${instances.length} forms`);\r\n        return instances;\r\n    }\r\n\r\n    /**\r\n     * Initialize autosave for a specific form\r\n     * @param {HTMLFormElement} form - The form element\r\n     * @param {Object} options - Options for autosave\r\n     * @returns {FormHandler} The FormHandler instance\r\n     */\r\n    static initialize(form, options = {}) {\r\n        return FormHandler.create(form, {\r\n            enableAutosave: true,\r\n            ...options\r\n        });\r\n    }\r\n}\r\n\r\n","import '../css/styles.css';\n\nimport { initApp } from './core/init.js';\nimport { Logger } from './core/logger.js';\nimport { FormAutoSave } from './modules/form-autosave.js';\n// WebPushManager is now loaded via framework module system\n// LiveComponent is now loaded via framework module system\n\n// Import DevTools in development\nif (import.meta.env.DEV) {\n    import('./modules/LiveComponentDevTools.js').then(() => {\n        console.log('🛠️ LiveComponent DevTools loaded (Ctrl+Shift+D to toggle)');\n    });\n}\n\n// Import Hot Reload in development\nif (import.meta.env.DEV) {\n    import('./modules/hot-reload.js').then(({ HotReload }) => {\n        console.log('🔥 Hot Reload module loaded');\n    });\n}\n\n// PWA Service Worker temporarily disabled\n// TODO: Re-enable after fixing build issues\n\ndocument.addEventListener(\"DOMContentLoaded\", async () => {\n    try {\n        console.log('🚀 Starting app initialization...');\n        await initApp();\n        console.log('✅ App initialized successfully!');\n\n        // Initialize Form Auto-Save for all forms\n        const autosaveInstances = FormAutoSave.initializeAll();\n        console.log(`💾 Form Auto-Save initialized for ${autosaveInstances.length} forms`);\n\n        // WebPush Manager is initialized by framework module system\n        // Access via window.webPushManager after module initialization\n\n        // Debug info\n        setTimeout(() => {\n            console.log('📊 Debug Info:');\n            console.log('- Forms found:', document.querySelectorAll('form').length);\n            console.log('- Links found:', document.querySelectorAll('a[href^=\"/\"]').length);\n            console.log('- SPA Router:', window.spaRouter ? 'Active' : 'Missing');\n            console.log('- Enhanced forms:', document.querySelectorAll('form[data-auto-enhanced]').length);\n            console.log('- CSRF protected forms:', document.querySelectorAll('input[name=\"_token\"]').length);\n        }, 500);\n    } catch (error) {\n        console.error('❌ App initialization failed:', error);\n        console.error('Stack trace:', error.stack);\n    }\n});\n\nfunction isHtmlAttributeSupported(elementName, attribute) {\n    const element = document.createElement(elementName);\n    return attribute in element;\n}\n\n\n/*let closedAttr = document.getElementById('my-dialog');\nif(closedAttr && !('closedby' in closedAttr)) {\n    alert('oh no');\n}*/\n\n/*\nif (isHtmlAttributeSupported('dialog', 'closedby')) {\n    alert('Attribut wird unterstützt!');\n} else {\n    alert('Nicht unterstützt!');\n}\n*/\n"],"file":"assets/js/main-C52nFCDL.js"}
\ No newline at end of file
diff --git a/resources/css/admin/01-settings/_generated-tokens.css b/resources/css/admin/01-settings/_generated-tokens.css
new file mode 100644
index 00000000..3ebe4fec
--- /dev/null
+++ b/resources/css/admin/01-settings/_generated-tokens.css
@@ -0,0 +1,19 @@
+/**
+ * Generated Design Tokens - DO NOT EDIT MANUALLY
+ * 
+ * This file is automatically generated from AdminTokenRegistry.
+ * To modify tokens, edit: src/Application/Admin/ValueObjects/AdminTokenRegistry.php
+ * 
+ * Generated: 2025-11-07 (Placeholder - run 'php console.php design:generate-tokens --scope=admin' to regenerate)
+ * Source: AdminTokenRegistry
+ * Scope: admin
+ * Architecture: ITCSS
+ * 
+ * NOTE: This is a placeholder file. Run the following command to generate the actual tokens:
+ * php console.php design:generate-tokens --scope=admin
+ */
+
+@layer admin-settings {
+  /* Placeholder - tokens will be generated by design:generate-tokens command */
+}
+
diff --git a/resources/css/admin/admin.css b/resources/css/admin/admin.css
index eeb06468..cde4f02e 100644
--- a/resources/css/admin/admin.css
+++ b/resources/css/admin/admin.css
@@ -14,7 +14,7 @@
  */
 
 /* Layer 1: Settings */
-@import "./01-settings/_tokens.css";
+@import "./01-settings/_generated-tokens.css";
 @import "./01-settings/_breakpoints.css";
 
 /* Layer 2: Tools */
diff --git a/resources/js/main.js b/resources/js/main.js
index e4ceff01..c9047d40 100644
--- a/resources/js/main.js
+++ b/resources/js/main.js
@@ -2,7 +2,6 @@ import '../css/styles.css';
 
 import { initApp } from './core/init.js';
 import { Logger } from './core/logger.js';
-import { CsrfAutoRefresh } from './modules/csrf-auto-refresh.js';
 import { FormAutoSave } from './modules/form-autosave.js';
 // WebPushManager is now loaded via framework module system
 // LiveComponent is now loaded via framework module system
@@ -29,11 +28,7 @@ document.addEventListener("DOMContentLoaded", async () => {
         console.log('🚀 Starting app initialization...');
         await initApp();
         console.log('✅ App initialized successfully!');
-        
-        // Initialize CSRF Auto-Refresh for all forms
-        const csrfInstances = CsrfAutoRefresh.initializeAll();
-        console.log(`🔒 CSRF Auto-Refresh initialized for ${csrfInstances.length} forms`);
-        
+
         // Initialize Form Auto-Save for all forms
         const autosaveInstances = FormAutoSave.initializeAll();
         console.log(`💾 Form Auto-Save initialized for ${autosaveInstances.length} forms`);
diff --git a/resources/js/modules/LiveComponentDevTools.js b/resources/js/modules/LiveComponentDevTools.js
index 92b1b329..d130251d 100644
--- a/resources/js/modules/LiveComponentDevTools.js
+++ b/resources/js/modules/LiveComponentDevTools.js
@@ -13,6 +13,8 @@
  */
 
 import { Core } from '../core.js';
+import { PerformanceProfiler, LiveComponentsProfiler } from '../performance-profiler/profiler.js';
+import { FlamegraphVisualizer, TimelineVisualizer } from '../performance-profiler/visualizer.js';
 
 export class LiveComponentDevTools {
     constructor() {
@@ -26,12 +28,21 @@ export class LiveComponentDevTools {
         this.domBadges = new Map(); // Track DOM badges for cleanup
         this.badgesEnabled = true; // Badge visibility toggle
 
-        // Performance profiling state
+        // Performance profiling state - using PerformanceProfiler
+        this.profiler = new PerformanceProfiler({
+            enabled: true,
+            maxSamples: 1000,
+            samplingInterval: 10,
+            autoStart: false
+        });
+        this.flamegraphVisualizer = null;
+        this.timelineVisualizer = null;
         this.isRecording = false;
-        this.performanceRecording = [];
+        this.performanceRecording = []; // Legacy data for backward compatibility
         this.componentRenderTimes = new Map();
         this.actionExecutionTimes = new Map();
         this.memorySnapshots = [];
+        this.componentProfilers = new Map(); // Track profilers for each component
 
         this.overlay = null;
         this.isEnabled = this.checkIfEnabled();
@@ -163,8 +174,14 @@ export class LiveComponentDevTools {
                             <button class="lc-devtools__btn lc-devtools__btn--small" data-action="clear-performance">
                                 Clear
                             </button>
+                            <button class="lc-devtools__btn lc-devtools__btn--small" data-action="export-performance">
+                                Export
+                            </button>
+                        </div>
+                        <div class="lc-devtools__metrics" data-content="performance">
+                            <div id="lc-flamegraph-container" style="margin-bottom: 16px;"></div>
+                            <div id="lc-timeline-container" style="margin-bottom: 16px;"></div>
                         </div>
-                        <div class="lc-devtools__metrics" data-content="performance"></div>
                     </div>
 
                     <div class="lc-devtools__pane" data-pane="network">
@@ -500,6 +517,10 @@ export class LiveComponentDevTools {
             this.clearPerformanceData();
         });
 
+        this.overlay.querySelector('[data-action="export-performance"]')?.addEventListener('click', () => {
+            this.exportPerformanceData();
+        });
+
         this.overlay.querySelector('[data-action="clear-network"]')?.addEventListener('click', () => {
             this.clearNetworkLog();
         });
@@ -616,6 +637,11 @@ export class LiveComponentDevTools {
             pane.classList.toggle('lc-devtools__pane--active', pane.dataset.pane === tabName);
         });
 
+        // Initialize visualizers when switching to performance tab
+        if (tabName === 'performance') {
+            this.initializePerformanceVisualizers();
+        }
+
         // Refresh content for active tab
         this.refreshActiveTab();
     }
@@ -956,14 +982,80 @@ export class LiveComponentDevTools {
      * Clear performance data
      */
     clearPerformanceData() {
+        // Clear profiler data
+        this.profiler.clear();
+        
+        // Clear legacy data
         this.performanceData = [];
         this.performanceRecording = [];
         this.componentRenderTimes.clear();
         this.actionExecutionTimes.clear();
         this.memorySnapshots = [];
+        
+        // Clear visualizers
+        if (this.flamegraphVisualizer) {
+            this.flamegraphVisualizer.clear();
+        }
+        if (this.timelineVisualizer) {
+            this.timelineVisualizer.clear();
+        }
+        
         this.renderPerformanceData();
     }
 
+    /**
+     * Export performance data
+     */
+    exportPerformanceData() {
+        const status = this.profiler.getStatus();
+        
+        if (status.measuresCount === 0 && status.marksCount === 0 && status.samplesCount === 0) {
+            alert('No performance data to export. Start recording first.');
+            return;
+        }
+
+        // Export Chrome DevTools trace format
+        const traceData = this.profiler.exportToChromeTrace();
+        
+        // Create download
+        const blob = new Blob([JSON.stringify(traceData, null, 2)], { type: 'application/json' });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = `livecomponent-performance-${Date.now()}.json`;
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        URL.revokeObjectURL(url);
+
+        console.log('[LiveComponent DevTools] Performance data exported');
+    }
+
+    /**
+     * Initialize performance visualizers
+     */
+    initializePerformanceVisualizers() {
+        const flamegraphContainer = this.overlay.querySelector('#lc-flamegraph-container');
+        const timelineContainer = this.overlay.querySelector('#lc-timeline-container');
+
+        if (flamegraphContainer && !this.flamegraphVisualizer) {
+            this.flamegraphVisualizer = new FlamegraphVisualizer(flamegraphContainer, {
+                width: flamegraphContainer.clientWidth || 750,
+                height: 300,
+                barHeight: 20,
+                colorScheme: 'category'
+            });
+        }
+
+        if (timelineContainer && !this.timelineVisualizer) {
+            this.timelineVisualizer = new TimelineVisualizer(timelineContainer, {
+                width: timelineContainer.clientWidth || 750,
+                height: 200,
+                trackHeight: 30
+            });
+        }
+    }
+
     /**
      * Toggle performance recording
      */
@@ -989,6 +1081,11 @@ export class LiveComponentDevTools {
      */
     startPerformanceRecording() {
         console.log('[LiveComponent DevTools] Performance recording started');
+        
+        // Start the profiler
+        this.profiler.start();
+        
+        // Clear legacy data
         this.performanceRecording = [];
         this.memorySnapshots = [];
 
@@ -1011,6 +1108,12 @@ export class LiveComponentDevTools {
     stopPerformanceRecording() {
         console.log('[LiveComponent DevTools] Performance recording stopped');
 
+        // Stop the profiler and get results
+        const results = this.profiler.stop();
+        if (results) {
+            console.log('[LiveComponent DevTools] Performance results:', results);
+        }
+
         if (this.memorySnapshotInterval) {
             clearInterval(this.memorySnapshotInterval);
         }
@@ -1027,6 +1130,31 @@ export class LiveComponentDevTools {
      * Record action execution for performance profiling
      */
     recordActionExecution(componentId, actionName, duration, startTime, endTime) {
+        // Use profiler marks and measures if recording
+        if (this.profiler.isRecording) {
+            // Create synthetic marks based on the actual times
+            // Note: The profiler uses performance.now() internally, so we need to adjust
+            const markStart = `action:${componentId}:${actionName}:start`;
+            const markEnd = `action:${componentId}:${actionName}:end`;
+            const measureName = `action:${componentId}:${actionName}`;
+
+            // Record start mark (using current time as reference)
+            this.profiler.mark(markStart, {
+                componentId,
+                actionName,
+                type: 'action',
+                originalStartTime: startTime,
+                originalEndTime: endTime
+            });
+            
+            // Record end mark immediately (profiler will calculate duration from marks)
+            this.profiler.mark(markEnd);
+            
+            // Create measure - the profiler will calculate duration from the marks
+            this.profiler.measure(measureName, markStart, markEnd);
+        }
+
+        // Legacy recording for backward compatibility
         this.performanceRecording.push({
             type: 'action',
             componentId,
@@ -1054,8 +1182,30 @@ export class LiveComponentDevTools {
      * Record component render for performance profiling
      */
     recordComponentRender(componentId, duration, startTime, endTime) {
-        if (!this.isRecording) return;
+        if (!this.isRecording && !this.profiler.isRecording) return;
 
+        // Use profiler marks and measures if recording
+        if (this.profiler.isRecording) {
+            const markStart = `render:${componentId}:start`;
+            const markEnd = `render:${componentId}:end`;
+            const measureName = `render:${componentId}`;
+
+            // Record start mark
+            this.profiler.mark(markStart, {
+                componentId,
+                type: 'render',
+                originalStartTime: startTime,
+                originalEndTime: endTime
+            });
+            
+            // Record end mark immediately
+            this.profiler.mark(markEnd);
+            
+            // Create measure
+            this.profiler.measure(measureName, markStart, markEnd);
+        }
+
+        // Legacy recording for backward compatibility
         this.performanceRecording.push({
             type: 'render',
             componentId,
@@ -1103,40 +1253,99 @@ export class LiveComponentDevTools {
         const container = this.overlay.querySelector('[data-content="performance"]');
         if (!container) return;
 
-        if (this.performanceRecording.length === 0 && this.memorySnapshots.length === 0) {
-            container.innerHTML = `
-                <div style="color: #969696; text-align: center; padding: 40px;">
+        // Get profiler status
+        const status = this.profiler.getStatus();
+        const hasData = status.samplesCount > 0 || status.marksCount > 0 || status.measuresCount > 0;
+        const hasLegacyData = this.performanceRecording.length > 0 || this.memorySnapshots.length > 0;
+
+        // Initialize visualizers if not already done
+        this.initializePerformanceVisualizers();
+
+        // Get containers for visualizers (they should already exist in the DOM)
+        const flamegraphContainer = this.overlay.querySelector('#lc-flamegraph-container');
+        const timelineContainer = this.overlay.querySelector('#lc-timeline-container');
+
+        if (!hasData && !hasLegacyData) {
+            // Clear visualizers
+            if (this.flamegraphVisualizer) {
+                this.flamegraphVisualizer.clear();
+            }
+            if (this.timelineVisualizer) {
+                this.timelineVisualizer.clear();
+            }
+            
+            // Show empty state but preserve visualizer containers
+            const existingContent = container.querySelector('.lc-perf-empty-state');
+            if (!existingContent) {
+                const emptyState = document.createElement('div');
+                emptyState.className = 'lc-perf-empty-state';
+                emptyState.style.cssText = 'color: #969696; text-align: center; padding: 40px;';
+                emptyState.innerHTML = `
                     <p>No performance data recorded</p>
                     <p style="font-size: 12px; margin-top: 12px;">Click "● Record" to start profiling</p>
-                </div>
-            `;
+                `;
+                container.insertBefore(emptyState, flamegraphContainer);
+            }
             return;
         }
 
-        let html = '<div class="lc-performance-view" style="padding: 0;">';
-
-        // Performance Summary
-        html += this.renderPerformanceSummary();
-
-        // Flamegraph
-        html += this.renderFlamegraph();
-
-        // Timeline
-        html += this.renderPerformanceTimeline();
-
-        // Memory Usage Chart
-        if (this.memorySnapshots.length > 0) {
-            html += this.renderMemoryChart();
+        // Remove empty state if present
+        const emptyState = container.querySelector('.lc-perf-empty-state');
+        if (emptyState) {
+            emptyState.remove();
         }
 
-        html += '</div>';
-        container.innerHTML = html;
+        // Render summary
+        const summaryHtml = this.renderPerformanceSummary();
+        
+        // Insert or update summary (before visualizer containers)
+        const existingSummary = container.querySelector('.lc-perf-summary');
+        if (existingSummary) {
+            existingSummary.outerHTML = summaryHtml;
+        } else {
+            container.insertAdjacentHTML('afterbegin', summaryHtml);
+        }
+
+        // Render flamegraph if we have data
+        if (this.flamegraphVisualizer && hasData && flamegraphContainer) {
+            const flamegraphData = this.profiler.generateFlamegraph();
+            if (flamegraphData) {
+                this.flamegraphVisualizer.render(flamegraphData);
+            } else {
+                this.flamegraphVisualizer.clear();
+            }
+        }
+
+        // Render timeline if we have data
+        if (this.timelineVisualizer && hasData && timelineContainer) {
+            const timelineData = this.profiler.generateTimeline();
+            if (timelineData && timelineData.length > 0) {
+                this.timelineVisualizer.render(timelineData);
+            } else {
+                this.timelineVisualizer.clear();
+            }
+        }
+
+        // Render legacy memory chart if available
+        if (this.memorySnapshots.length > 0) {
+            const existingMemoryChart = container.querySelector('.lc-memory-chart');
+            const memoryChartHtml = this.renderMemoryChart();
+            if (existingMemoryChart) {
+                existingMemoryChart.outerHTML = memoryChartHtml;
+            } else {
+                container.insertAdjacentHTML('beforeend', memoryChartHtml);
+            }
+        }
     }
 
     /**
      * Render performance summary
      */
     renderPerformanceSummary() {
+        const status = this.profiler.getStatus();
+        const summary = this.profiler.generateSummary();
+        
+        // Legacy data counts
         const actionCount = this.performanceRecording.filter(r => r.type === 'action').length;
         const renderCount = this.performanceRecording.filter(r => r.type === 'render').length;
 
@@ -1144,15 +1353,9 @@ export class LiveComponentDevTools {
             ? this.performanceRecording
                 .filter(r => r.type === 'action')
                 .reduce((sum, r) => sum + r.duration, 0) / actionCount
-            : 0;
+            : (summary.avgDuration || 0);
 
-        const avgRenderTime = renderCount > 0
-            ? this.performanceRecording
-                .filter(r => r.type === 'render')
-                .reduce((sum, r) => sum + r.duration, 0) / renderCount
-            : 0;
-
-        const totalDuration = this.performanceRecording.reduce((sum, r) => sum + r.duration, 0);
+        const totalDuration = summary.totalDuration || this.performanceRecording.reduce((sum, r) => sum + r.duration, 0);
 
         return `
             <div class="lc-perf-summary" style="padding: 16px; border-bottom: 1px solid #3c3c3c; background: #252526;">
@@ -1160,18 +1363,18 @@ export class LiveComponentDevTools {
                 <div style="display: grid; grid-template-columns: repeat(5, 1fr); gap: 12px; font-size: 12px;">
                     <div>
                         <div style="color: #858585; margin-bottom: 4px;">Total Events</div>
-                        <div style="color: #4ec9b0; font-size: 18px; font-weight: 600;">${this.performanceRecording.length}</div>
+                        <div style="color: #4ec9b0; font-size: 18px; font-weight: 600;">${status.timelineEventsCount || this.performanceRecording.length}</div>
                     </div>
                     <div>
-                        <div style="color: #858585; margin-bottom: 4px;">Actions</div>
-                        <div style="color: #dcdcaa; font-size: 18px; font-weight: 600;">${actionCount}</div>
+                        <div style="color: #858585; margin-bottom: 4px;">Measures</div>
+                        <div style="color: #dcdcaa; font-size: 18px; font-weight: 600;">${status.measuresCount || actionCount}</div>
                     </div>
                     <div>
-                        <div style="color: #858585; margin-bottom: 4px;">Renders</div>
-                        <div style="color: #569cd6; font-size: 18px; font-weight: 600;">${renderCount}</div>
+                        <div style="color: #858585; margin-bottom: 4px;">Samples</div>
+                        <div style="color: #569cd6; font-size: 18px; font-weight: 600;">${status.samplesCount}</div>
                     </div>
                     <div>
-                        <div style="color: #858585; margin-bottom: 4px;">Avg Action</div>
+                        <div style="color: #858585; margin-bottom: 4px;">Avg Duration</div>
                         <div style="color: #dcdcaa; font-size: 18px; font-weight: 600;">${avgActionTime.toFixed(2)}ms</div>
                     </div>
                     <div>
@@ -1179,6 +1382,13 @@ export class LiveComponentDevTools {
                         <div style="color: #f48771; font-size: 18px; font-weight: 600;">${totalDuration.toFixed(2)}ms</div>
                     </div>
                 </div>
+                ${summary.percentiles ? `
+                <div style="margin-top: 12px; padding-top: 12px; border-top: 1px solid #3c3c3c; font-size: 11px; color: #858585;">
+                    <strong>Percentiles:</strong> P50: ${summary.percentiles.p50?.toFixed(2) || 'N/A'}ms | 
+                    P90: ${summary.percentiles.p90?.toFixed(2) || 'N/A'}ms | 
+                    P99: ${summary.percentiles.p99?.toFixed(2) || 'N/A'}ms
+                </div>
+                ` : ''}
             </div>
         `;
     }
diff --git a/resources/js/modules/analytics/Analytics.js b/resources/js/modules/analytics/Analytics.js
new file mode 100644
index 00000000..2b5f9c31
--- /dev/null
+++ b/resources/js/modules/analytics/Analytics.js
@@ -0,0 +1,406 @@
+/**
+ * Analytics Module
+ * 
+ * Provides unified analytics system for event tracking, page views, and user behavior.
+ * Features:
+ * - Event tracking
+ * - Page view tracking
+ * - User behavior tracking
+ * - Custom events
+ * - Integration with LiveComponents
+ * - GDPR compliance
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * AnalyticsProvider - Base class for analytics providers
+ */
+export class AnalyticsProvider {
+    constructor(config = {}) {
+        this.config = config;
+        this.enabled = config.enabled ?? true;
+    }
+    
+    /**
+     * Track event
+     */
+    async track(eventName, properties = {}) {
+        if (!this.enabled) return;
+        // Override in subclasses
+    }
+    
+    /**
+     * Track page view
+     */
+    async pageView(path, properties = {}) {
+        if (!this.enabled) return;
+        // Override in subclasses
+    }
+    
+    /**
+     * Identify user
+     */
+    async identify(userId, traits = {}) {
+        if (!this.enabled) return;
+        // Override in subclasses
+    }
+}
+
+/**
+ * GoogleAnalyticsProvider - Google Analytics integration
+ */
+export class GoogleAnalyticsProvider extends AnalyticsProvider {
+    constructor(config = {}) {
+        super(config);
+        this.measurementId = config.measurementId || config.gaId;
+    }
+    
+    async track(eventName, properties = {}) {
+        if (typeof gtag !== 'undefined') {
+            gtag('event', eventName, properties);
+        }
+    }
+    
+    async pageView(path, properties = {}) {
+        if (typeof gtag !== 'undefined') {
+            gtag('config', this.measurementId, {
+                page_path: path,
+                ...properties
+            });
+        }
+    }
+}
+
+/**
+ * CustomProvider - Custom analytics endpoint
+ */
+export class CustomProvider extends AnalyticsProvider {
+    constructor(config = {}) {
+        super(config);
+        this.endpoint = config.endpoint || '/api/analytics';
+    }
+    
+    async track(eventName, properties = {}) {
+        try {
+            await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Requested-With': 'XMLHttpRequest'
+                },
+                body: JSON.stringify({
+                    type: 'event',
+                    name: eventName,
+                    properties,
+                    timestamp: Date.now()
+                })
+            });
+        } catch (error) {
+            Logger.error('[Analytics] Failed to track event', error);
+        }
+    }
+    
+    async pageView(path, properties = {}) {
+        try {
+            await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Requested-With': 'XMLHttpRequest'
+                },
+                body: JSON.stringify({
+                    type: 'page_view',
+                    path,
+                    properties,
+                    timestamp: Date.now()
+                })
+            });
+        } catch (error) {
+            Logger.error('[Analytics] Failed to track page view', error);
+        }
+    }
+}
+
+/**
+ * Analytics - Unified analytics system
+ */
+export class Analytics {
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            providers: config.providers || [],
+            gdprCompliant: config.gdprCompliant ?? true,
+            requireConsent: config.requireConsent ?? false,
+            consentGiven: config.consentGiven ?? false,
+            anonymizeIp: config.anonymizeIp ?? true,
+            ...config
+        };
+        
+        this.providers = [];
+        this.eventQueue = [];
+        this.userId = null;
+        this.userTraits = {};
+        
+        // Initialize providers
+        this.initProviders();
+        
+        // Track initial page view
+        if (this.config.enabled && this.hasConsent()) {
+            this.trackPageView();
+        }
+        
+        Logger.info('[Analytics] Initialized', {
+            enabled: this.config.enabled,
+            providers: this.providers.length,
+            gdprCompliant: this.config.gdprCompliant
+        });
+    }
+    
+    /**
+     * Create a new Analytics instance
+     */
+    static create(config = {}) {
+        return new Analytics(config);
+    }
+    
+    /**
+     * Initialize providers
+     */
+    initProviders() {
+        for (const providerConfig of this.config.providers) {
+            let provider;
+            
+            if (typeof providerConfig === 'string') {
+                // Provider name
+                if (providerConfig === 'google-analytics' || providerConfig === 'ga') {
+                    provider = new GoogleAnalyticsProvider({});
+                } else if (providerConfig === 'custom') {
+                    provider = new CustomProvider({});
+                }
+            } else if (typeof providerConfig === 'object') {
+                // Provider config
+                if (providerConfig.type === 'google-analytics' || providerConfig.type === 'ga') {
+                    provider = new GoogleAnalyticsProvider(providerConfig);
+                } else if (providerConfig.type === 'custom') {
+                    provider = new CustomProvider(providerConfig);
+                } else if (providerConfig instanceof AnalyticsProvider) {
+                    provider = providerConfig;
+                }
+            }
+            
+            if (provider) {
+                this.providers.push(provider);
+            }
+        }
+    }
+    
+    /**
+     * Check if consent is given (GDPR)
+     */
+    hasConsent() {
+        if (!this.config.requireConsent) {
+            return true;
+        }
+        return this.config.consentGiven;
+    }
+    
+    /**
+     * Give consent (GDPR)
+     */
+    giveConsent() {
+        this.config.consentGiven = true;
+        
+        // Process queued events
+        this.processEventQueue();
+        
+        Logger.info('[Analytics] Consent given');
+    }
+    
+    /**
+     * Revoke consent (GDPR)
+     */
+    revokeConsent() {
+        this.config.consentGiven = false;
+        Logger.info('[Analytics] Consent revoked');
+    }
+    
+    /**
+     * Track event
+     */
+    async track(eventName, properties = {}) {
+        if (!this.config.enabled || !this.hasConsent()) {
+            // Queue event if consent required
+            if (this.config.requireConsent && !this.config.consentGiven) {
+                this.eventQueue.push({ type: 'event', name: eventName, properties });
+            }
+            return;
+        }
+        
+        const eventData = {
+            name: eventName,
+            properties: this.anonymizeData(properties),
+            timestamp: Date.now(),
+            userId: this.userId
+        };
+        
+        // Send to all providers
+        for (const provider of this.providers) {
+            try {
+                await provider.track(eventName, eventData.properties);
+            } catch (error) {
+                Logger.error('[Analytics] Provider error', error);
+            }
+        }
+        
+        Logger.debug('[Analytics] Event tracked', eventData);
+        
+        // Trigger event
+        this.triggerAnalyticsEvent('track', eventData);
+    }
+    
+    /**
+     * Track page view
+     */
+    async trackPageView(path = null, properties = {}) {
+        if (!this.config.enabled || !this.hasConsent()) {
+            return;
+        }
+        
+        const pagePath = path || window.location.pathname;
+        const pageData = {
+            path: pagePath,
+            title: document.title,
+            properties: this.anonymizeData(properties),
+            timestamp: Date.now()
+        };
+        
+        // Send to all providers
+        for (const provider of this.providers) {
+            try {
+                await provider.pageView(pagePath, pageData.properties);
+            } catch (error) {
+                Logger.error('[Analytics] Provider error', error);
+            }
+        }
+        
+        Logger.debug('[Analytics] Page view tracked', pageData);
+        
+        // Trigger event
+        this.triggerAnalyticsEvent('page_view', pageData);
+    }
+    
+    /**
+     * Identify user
+     */
+    async identify(userId, traits = {}) {
+        if (!this.config.enabled || !this.hasConsent()) {
+            return;
+        }
+        
+        this.userId = userId;
+        this.userTraits = { ...this.userTraits, ...traits };
+        
+        // Send to all providers
+        for (const provider of this.providers) {
+            try {
+                if (typeof provider.identify === 'function') {
+                    await provider.identify(userId, this.userTraits);
+                }
+            } catch (error) {
+                Logger.error('[Analytics] Provider error', error);
+            }
+        }
+        
+        Logger.debug('[Analytics] User identified', { userId, traits: this.userTraits });
+    }
+    
+    /**
+     * Track user behavior
+     */
+    async trackBehavior(action, target, properties = {}) {
+        await this.track('user_behavior', {
+            action,
+            target,
+            ...properties
+        });
+    }
+    
+    /**
+     * Anonymize data for GDPR compliance
+     */
+    anonymizeData(data) {
+        if (!this.config.gdprCompliant) {
+            return data;
+        }
+        
+        const anonymized = { ...data };
+        
+        // Anonymize IP if enabled
+        if (this.config.anonymizeIp && anonymized.ip) {
+            anonymized.ip = anonymized.ip.split('.').slice(0, 3).join('.') + '.0';
+        }
+        
+        // Remove PII if present
+        const piiFields = ['email', 'phone', 'address', 'ssn', 'credit_card'];
+        piiFields.forEach(field => {
+            if (anonymized[field]) {
+                delete anonymized[field];
+            }
+        });
+        
+        return anonymized;
+    }
+    
+    /**
+     * Process queued events
+     */
+    processEventQueue() {
+        while (this.eventQueue.length > 0) {
+            const event = this.eventQueue.shift();
+            if (event.type === 'event') {
+                this.track(event.name, event.properties);
+            }
+        }
+    }
+    
+    /**
+     * Trigger analytics event
+     */
+    triggerAnalyticsEvent(type, data) {
+        const event = new CustomEvent(`analytics:${type}`, {
+            detail: data,
+            bubbles: true
+        });
+        window.dispatchEvent(event);
+    }
+    
+    /**
+     * Enable analytics
+     */
+    enable() {
+        this.config.enabled = true;
+        Logger.info('[Analytics] Enabled');
+    }
+    
+    /**
+     * Disable analytics
+     */
+    disable() {
+        this.config.enabled = false;
+        Logger.info('[Analytics] Disabled');
+    }
+    
+    /**
+     * Destroy analytics
+     */
+    destroy() {
+        this.providers = [];
+        this.eventQueue = [];
+        this.userId = null;
+        this.userTraits = {};
+        
+        Logger.info('[Analytics] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/analytics/AnalyticsProvider.js b/resources/js/modules/analytics/AnalyticsProvider.js
new file mode 100644
index 00000000..962a9e76
--- /dev/null
+++ b/resources/js/modules/analytics/AnalyticsProvider.js
@@ -0,0 +1,8 @@
+/**
+ * Analytics Provider Base Classes
+ * 
+ * Base classes and implementations for analytics providers.
+ */
+
+export { AnalyticsProvider, GoogleAnalyticsProvider, CustomProvider } from './Analytics.js';
+
diff --git a/resources/js/modules/analytics/index.js b/resources/js/modules/analytics/index.js
new file mode 100644
index 00000000..234437d5
--- /dev/null
+++ b/resources/js/modules/analytics/index.js
@@ -0,0 +1,85 @@
+/**
+ * Analytics Module
+ * 
+ * Provides unified analytics system for event tracking, page views, and user behavior.
+ * 
+ * Usage:
+ * - Add data-module="analytics" to enable global analytics
+ * - Or import and use directly: import { Analytics } from './modules/analytics/index.js'
+ * 
+ * Features:
+ * - Event tracking
+ * - Page view tracking
+ * - User behavior tracking
+ * - Custom events
+ * - Integration with LiveComponents
+ * - GDPR compliance
+ */
+
+import { Logger } from '../../core/logger.js';
+import { Analytics, AnalyticsProvider, GoogleAnalyticsProvider, CustomProvider } from './Analytics.js';
+
+const AnalyticsModule = {
+    name: 'analytics',
+    analytics: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[AnalyticsModule] Module initialized');
+        
+        // Create analytics instance
+        this.analytics = Analytics.create(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.Analytics = this.analytics;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get analytics instance
+     */
+    getAnalytics() {
+        return this.analytics || Analytics.create();
+    },
+    
+    /**
+     * Track event
+     */
+    async track(eventName, properties = {}) {
+        const analytics = this.getAnalytics();
+        return await analytics.track(eventName, properties);
+    },
+    
+    /**
+     * Track page view
+     */
+    async trackPageView(path = null, properties = {}) {
+        const analytics = this.getAnalytics();
+        return await analytics.trackPageView(path, properties);
+    },
+    
+    destroy() {
+        if (this.analytics) {
+            this.analytics.destroy();
+            this.analytics = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.Analytics) {
+            delete window.Analytics;
+        }
+        
+        Logger.info('[AnalyticsModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { Analytics, AnalyticsProvider, GoogleAnalyticsProvider, CustomProvider };
+
+// Export as default for module system
+export default AnalyticsModule;
+
+// Export init function for module system
+export const init = AnalyticsModule.init.bind(AnalyticsModule);
+
diff --git a/resources/js/modules/animation-system/AnimationSystem.js b/resources/js/modules/animation-system/AnimationSystem.js
new file mode 100644
index 00000000..ab199d58
--- /dev/null
+++ b/resources/js/modules/animation-system/AnimationSystem.js
@@ -0,0 +1,302 @@
+/**
+ * Unified Animation System
+ * 
+ * Consolidates all scroll animation modules into a single, unified system.
+ * Replaces: scrollfx, parallax, scroll-timeline, scroll-loop, scroll-dependent, sticky-fade, sticky-steps
+ */
+
+import { Logger } from '../../core/logger.js';
+import { ScrollAnimation } from './ScrollAnimation.js';
+import { TimelineAnimation } from './TimelineAnimation.js';
+
+/**
+ * AnimationSystem - Unified animation system
+ */
+export class AnimationSystem {
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            useIntersectionObserver: config.useIntersectionObserver ?? true,
+            throttleDelay: config.throttleDelay || 16, // ~60fps
+            ...config
+        };
+        
+        this.animations = new Map(); // Map<element, Animation>
+        this.observers = new Map(); // Map<element, IntersectionObserver>
+        this.scrollHandler = null;
+        this.isScrolling = false;
+        
+        // Initialize
+        if (this.config.enabled) {
+            this.init();
+        }
+        
+        Logger.info('[AnimationSystem] Initialized', {
+            enabled: this.config.enabled,
+            useIntersectionObserver: this.config.useIntersectionObserver
+        });
+    }
+    
+    /**
+     * Create a new AnimationSystem instance
+     */
+    static create(config = {}) {
+        return new AnimationSystem(config);
+    }
+    
+    /**
+     * Initialize animation system
+     */
+    init() {
+        // Set up scroll handler
+        if (!this.config.useIntersectionObserver) {
+            this.setupScrollHandler();
+        }
+        
+        // Auto-initialize elements with data attributes
+        this.autoInitialize();
+    }
+    
+    /**
+     * Set up scroll handler
+     */
+    setupScrollHandler() {
+        let ticking = false;
+        
+        this.scrollHandler = () => {
+            if (!ticking) {
+                window.requestAnimationFrame(() => {
+                    this.updateAnimations();
+                    ticking = false;
+                });
+                ticking = true;
+            }
+        };
+        
+        window.addEventListener('scroll', this.scrollHandler, { passive: true });
+    }
+    
+    /**
+     * Auto-initialize elements with data attributes
+     */
+    autoInitialize() {
+        // Fade in on scroll (scrollfx)
+        this.initializeFadeIn();
+        
+        // Parallax
+        this.initializeParallax();
+        
+        // Scroll timeline
+        this.initializeTimeline();
+        
+        // Sticky fade
+        this.initializeStickyFade();
+        
+        // Sticky steps
+        this.initializeStickySteps();
+    }
+    
+    /**
+     * Initialize fade-in animations (scrollfx)
+     */
+    initializeFadeIn() {
+        const elements = document.querySelectorAll('.fade-in-on-scroll, .zoom-in, [data-animate="fade-in"]');
+        elements.forEach(element => {
+            this.registerAnimation(element, {
+                type: 'fade-in',
+                offset: parseFloat(element.dataset.offset) || 0.85,
+                delay: parseFloat(element.dataset.delay) || 0,
+                once: element.dataset.once !== 'false'
+            });
+        });
+    }
+    
+    /**
+     * Initialize parallax animations
+     */
+    initializeParallax() {
+        const elements = document.querySelectorAll('[data-parallax], .parallax');
+        elements.forEach(element => {
+            const speed = parseFloat(element.dataset.parallax || element.dataset.speed) || 0.5;
+            this.registerAnimation(element, {
+                type: 'parallax',
+                speed
+            });
+        });
+    }
+    
+    /**
+     * Initialize timeline animations (scroll-timeline)
+     */
+    initializeTimeline() {
+        const elements = document.querySelectorAll('[data-scroll-timeline], [data-scroll-step]');
+        elements.forEach(element => {
+            this.registerAnimation(element, {
+                type: 'timeline',
+                steps: element.dataset.scrollSteps ? parseInt(element.dataset.scrollSteps) : null,
+                triggerPoint: parseFloat(element.dataset.triggerPoint) || 0.4
+            });
+        });
+    }
+    
+    /**
+     * Initialize sticky fade animations
+     */
+    initializeStickyFade() {
+        const elements = document.querySelectorAll('[data-sticky-fade], .sticky-fade');
+        elements.forEach(element => {
+            this.registerAnimation(element, {
+                type: 'sticky-fade',
+                fadeStart: parseFloat(element.dataset.fadeStart) || 0,
+                fadeEnd: parseFloat(element.dataset.fadeEnd) || 1
+            });
+        });
+    }
+    
+    /**
+     * Initialize sticky steps animations
+     */
+    initializeStickySteps() {
+        const elements = document.querySelectorAll('[data-sticky-steps], .sticky-steps');
+        elements.forEach(element => {
+            const steps = element.dataset.stickySteps ? parseInt(element.dataset.stickySteps) : 3;
+            this.registerAnimation(element, {
+                type: 'sticky-steps',
+                steps
+            });
+        });
+    }
+    
+    /**
+     * Register an animation
+     */
+    registerAnimation(element, config) {
+        if (this.animations.has(element)) {
+            Logger.warn('[AnimationSystem] Animation already registered for element', element);
+            return;
+        }
+        
+        let animation;
+        
+        switch (config.type) {
+            case 'fade-in':
+            case 'zoom-in':
+                animation = new ScrollAnimation(element, {
+                    type: config.type,
+                    offset: config.offset || 0.85,
+                    delay: config.delay || 0,
+                    once: config.once !== false
+                });
+                break;
+                
+            case 'parallax':
+                animation = new ScrollAnimation(element, {
+                    type: 'parallax',
+                    speed: config.speed || 0.5
+                });
+                break;
+                
+            case 'timeline':
+                animation = new TimelineAnimation(element, {
+                    steps: config.steps,
+                    triggerPoint: config.triggerPoint || 0.4
+                });
+                break;
+                
+            case 'sticky-fade':
+                animation = new ScrollAnimation(element, {
+                    type: 'sticky-fade',
+                    fadeStart: config.fadeStart || 0,
+                    fadeEnd: config.fadeEnd || 1
+                });
+                break;
+                
+            case 'sticky-steps':
+                animation = new ScrollAnimation(element, {
+                    type: 'sticky-steps',
+                    steps: config.steps || 3
+                });
+                break;
+                
+            default:
+                Logger.warn('[AnimationSystem] Unknown animation type', config.type);
+                return;
+        }
+        
+        this.animations.set(element, animation);
+        
+        // Set up observer if using IntersectionObserver
+        if (this.config.useIntersectionObserver) {
+            this.setupObserver(element, animation);
+        }
+        
+        Logger.debug('[AnimationSystem] Animation registered', { element, type: config.type });
+    }
+    
+    /**
+     * Set up IntersectionObserver for element
+     */
+    setupObserver(element, animation) {
+        const observer = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                if (entry.isIntersecting) {
+                    animation.enter();
+                } else if (!animation.config.once) {
+                    animation.exit();
+                }
+            });
+        }, {
+            threshold: animation.config.offset || 0.85,
+            rootMargin: '0px'
+        });
+        
+        observer.observe(element);
+        this.observers.set(element, observer);
+    }
+    
+    /**
+     * Update all animations (for scroll-based updates)
+     */
+    updateAnimations() {
+        this.animations.forEach((animation, element) => {
+            if (animation.needsUpdate) {
+                animation.update();
+            }
+        });
+    }
+    
+    /**
+     * Remove animation
+     */
+    removeAnimation(element) {
+        const animation = this.animations.get(element);
+        if (animation) {
+            animation.destroy();
+            this.animations.delete(element);
+        }
+        
+        const observer = this.observers.get(element);
+        if (observer) {
+            observer.disconnect();
+            this.observers.delete(element);
+        }
+    }
+    
+    /**
+     * Destroy animation system
+     */
+    destroy() {
+        // Remove all animations
+        this.animations.forEach((animation, element) => {
+            this.removeAnimation(element);
+        });
+        
+        // Remove scroll handler
+        if (this.scrollHandler) {
+            window.removeEventListener('scroll', this.scrollHandler);
+        }
+        
+        Logger.info('[AnimationSystem] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/animation-system/ScrollAnimation.js b/resources/js/modules/animation-system/ScrollAnimation.js
new file mode 100644
index 00000000..6deaf570
--- /dev/null
+++ b/resources/js/modules/animation-system/ScrollAnimation.js
@@ -0,0 +1,211 @@
+/**
+ * Scroll Animation
+ * 
+ * Handles various scroll-based animations: fade-in, zoom-in, parallax, sticky-fade, sticky-steps
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * ScrollAnimation - Individual scroll animation
+ */
+export class ScrollAnimation {
+    constructor(element, config = {}) {
+        this.element = element;
+        this.config = {
+            type: config.type || 'fade-in',
+            offset: config.offset || 0.85,
+            delay: config.delay || 0,
+            once: config.once !== false,
+            speed: config.speed || 0.5,
+            fadeStart: config.fadeStart || 0,
+            fadeEnd: config.fadeEnd || 1,
+            steps: config.steps || 3,
+            ...config
+        };
+        
+        this.triggered = false;
+        this.needsUpdate = true;
+        
+        // Initialize based on type
+        this.init();
+    }
+    
+    /**
+     * Initialize animation
+     */
+    init() {
+        switch (this.config.type) {
+            case 'fade-in':
+            case 'zoom-in':
+                this.initFadeIn();
+                break;
+            case 'parallax':
+                this.initParallax();
+                break;
+            case 'sticky-fade':
+                this.initStickyFade();
+                break;
+            case 'sticky-steps':
+                this.initStickySteps();
+                break;
+        }
+    }
+    
+    /**
+     * Initialize fade-in animation
+     */
+    initFadeIn() {
+        this.element.style.opacity = '0';
+        this.element.style.transition = `opacity 0.6s ease, transform 0.6s ease`;
+        this.element.style.transitionDelay = `${this.config.delay}s`;
+        
+        if (this.config.type === 'zoom-in') {
+            this.element.style.transform = 'scale(0.9)';
+        }
+    }
+    
+    /**
+     * Initialize parallax animation
+     */
+    initParallax() {
+        // Parallax doesn't need initial setup
+        this.needsUpdate = true;
+    }
+    
+    /**
+     * Initialize sticky fade animation
+     */
+    initStickyFade() {
+        this.element.style.position = 'sticky';
+        this.element.style.top = '0';
+    }
+    
+    /**
+     * Initialize sticky steps animation
+     */
+    initStickySteps() {
+        this.element.style.position = 'sticky';
+        this.element.style.top = '0';
+    }
+    
+    /**
+     * Enter animation (element enters viewport)
+     */
+    enter() {
+        if (this.triggered && this.config.once) {
+            return;
+        }
+        
+        this.triggered = true;
+        
+        switch (this.config.type) {
+            case 'fade-in':
+                this.element.style.opacity = '1';
+                this.element.classList.add('visible', 'entered');
+                break;
+            case 'zoom-in':
+                this.element.style.opacity = '1';
+                this.element.style.transform = 'scale(1)';
+                this.element.classList.add('visible', 'entered');
+                break;
+        }
+    }
+    
+    /**
+     * Exit animation (element exits viewport)
+     */
+    exit() {
+        if (this.config.once) {
+            return;
+        }
+        
+        this.triggered = false;
+        
+        switch (this.config.type) {
+            case 'fade-in':
+                this.element.style.opacity = '0';
+                this.element.classList.remove('visible', 'entered');
+                break;
+            case 'zoom-in':
+                this.element.style.opacity = '0';
+                this.element.style.transform = 'scale(0.9)';
+                this.element.classList.remove('visible', 'entered');
+                break;
+        }
+    }
+    
+    /**
+     * Update animation (for scroll-based animations)
+     */
+    update() {
+        const rect = this.element.getBoundingClientRect();
+        const viewportHeight = window.innerHeight;
+        const scrollY = window.scrollY;
+        
+        switch (this.config.type) {
+            case 'parallax':
+                this.updateParallax(rect, scrollY);
+                break;
+            case 'sticky-fade':
+                this.updateStickyFade(rect, viewportHeight);
+                break;
+            case 'sticky-steps':
+                this.updateStickySteps(rect, viewportHeight, scrollY);
+                break;
+        }
+    }
+    
+    /**
+     * Update parallax animation
+     */
+    updateParallax(rect, scrollY) {
+        const elementTop = rect.top + scrollY;
+        const scrolled = scrollY - elementTop;
+        const translateY = scrolled * this.config.speed;
+        
+        this.element.style.transform = `translateY(${translateY}px)`;
+    }
+    
+    /**
+     * Update sticky fade animation
+     */
+    updateStickyFade(rect, viewportHeight) {
+        const progress = Math.max(0, Math.min(1, (viewportHeight - rect.top) / viewportHeight));
+        const opacity = this.config.fadeStart + (this.config.fadeEnd - this.config.fadeStart) * progress;
+        
+        this.element.style.opacity = opacity.toString();
+    }
+    
+    /**
+     * Update sticky steps animation
+     */
+    updateStickySteps(rect, viewportHeight, scrollY) {
+        const elementTop = rect.top + scrollY - viewportHeight;
+        const scrollProgress = Math.max(0, Math.min(1, scrollY / (rect.height + viewportHeight)));
+        const step = Math.floor(scrollProgress * this.config.steps);
+        
+        this.element.setAttribute('data-step', step.toString());
+        this.element.classList.remove('step-0', 'step-1', 'step-2', 'step-3', 'step-4', 'step-5');
+        this.element.classList.add(`step-${step}`);
+    }
+    
+    /**
+     * Destroy animation
+     */
+    destroy() {
+        // Reset styles
+        this.element.style.opacity = '';
+        this.element.style.transform = '';
+        this.element.style.transition = '';
+        this.element.style.transitionDelay = '';
+        this.element.style.position = '';
+        this.element.style.top = '';
+        
+        // Remove classes
+        this.element.classList.remove('visible', 'entered');
+        
+        this.triggered = false;
+    }
+}
+
diff --git a/resources/js/modules/animation-system/TimelineAnimation.js b/resources/js/modules/animation-system/TimelineAnimation.js
new file mode 100644
index 00000000..9cf9759f
--- /dev/null
+++ b/resources/js/modules/animation-system/TimelineAnimation.js
@@ -0,0 +1,157 @@
+/**
+ * Timeline Animation
+ * 
+ * Handles scroll timeline animations (scroll-timeline, scroll-loop)
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * TimelineAnimation - Scroll timeline animation
+ */
+export class TimelineAnimation {
+    constructor(element, config = {}) {
+        this.element = element;
+        this.config = {
+            steps: config.steps || null,
+            triggerPoint: config.triggerPoint || 0.4,
+            loop: config.loop ?? false,
+            ...config
+        };
+        
+        this.currentStep = 0;
+        this.triggered = false;
+        
+        // Initialize
+        this.init();
+    }
+    
+    /**
+     * Initialize timeline animation
+     */
+    init() {
+        // Set initial step
+        this.element.setAttribute('data-scroll-step', '0');
+        this.element.classList.add('scroll-timeline');
+    }
+    
+    /**
+     * Enter animation
+     */
+    enter() {
+        if (this.triggered && !this.config.loop) {
+            return;
+        }
+        
+        this.triggered = true;
+        this.update();
+    }
+    
+    /**
+     * Exit animation
+     */
+    exit() {
+        if (this.config.loop) {
+            this.currentStep = 0;
+            this.update();
+        }
+    }
+    
+    /**
+     * Update animation based on scroll position
+     */
+    update() {
+        const rect = this.element.getBoundingClientRect();
+        const viewportHeight = window.innerHeight;
+        const triggerY = viewportHeight * this.config.triggerPoint;
+        
+        if (rect.top < triggerY && rect.bottom > 0) {
+            // Calculate progress
+            const progress = Math.max(0, Math.min(1, (triggerY - rect.top) / (rect.height + viewportHeight)));
+            
+            if (this.config.steps) {
+                // Step-based animation
+                const step = Math.floor(progress * this.config.steps);
+                this.setStep(step);
+            } else {
+                // Continuous animation
+                this.setProgress(progress);
+            }
+        }
+    }
+    
+    /**
+     * Set step
+     */
+    setStep(step) {
+        if (step === this.currentStep) {
+            return;
+        }
+        
+        this.currentStep = step;
+        this.element.setAttribute('data-scroll-step', step.toString());
+        
+        // Remove old step classes
+        for (let i = 0; i <= this.config.steps; i++) {
+            this.element.classList.remove(`step-${i}`);
+        }
+        
+        // Add new step class
+        this.element.classList.add(`step-${step}`);
+        
+        // Trigger event
+        this.triggerStepEvent(step);
+    }
+    
+    /**
+     * Set progress (continuous)
+     */
+    setProgress(progress) {
+        this.element.setAttribute('data-scroll-progress', progress.toString());
+        this.element.style.setProperty('--scroll-progress', progress.toString());
+        
+        // Trigger event
+        this.triggerProgressEvent(progress);
+    }
+    
+    /**
+     * Trigger step event
+     */
+    triggerStepEvent(step) {
+        const event = new CustomEvent('scroll-timeline:step', {
+            detail: { step, element: this.element },
+            bubbles: true
+        });
+        this.element.dispatchEvent(event);
+    }
+    
+    /**
+     * Trigger progress event
+     */
+    triggerProgressEvent(progress) {
+        const event = new CustomEvent('scroll-timeline:progress', {
+            detail: { progress, element: this.element },
+            bubbles: true
+        });
+        this.element.dispatchEvent(event);
+    }
+    
+    /**
+     * Destroy animation
+     */
+    destroy() {
+        this.element.removeAttribute('data-scroll-step');
+        this.element.removeAttribute('data-scroll-progress');
+        this.element.style.removeProperty('--scroll-progress');
+        this.element.classList.remove('scroll-timeline');
+        
+        // Remove step classes
+        for (let i = 0; i <= 10; i++) {
+            this.element.classList.remove(`step-${i}`);
+        }
+        
+        this.currentStep = 0;
+        this.triggered = false;
+    }
+}
+
diff --git a/resources/js/modules/animation-system/index.js b/resources/js/modules/animation-system/index.js
new file mode 100644
index 00000000..23d74a52
--- /dev/null
+++ b/resources/js/modules/animation-system/index.js
@@ -0,0 +1,92 @@
+/**
+ * Animation System Module
+ * 
+ * Unified animation system consolidating all scroll animation modules.
+ * 
+ * Replaces:
+ * - scrollfx
+ * - parallax
+ * - scroll-timeline
+ * - scroll-loop
+ * - scroll-dependent
+ * - sticky-fade
+ * - sticky-steps
+ * 
+ * Usage:
+ * - Add data-module="animation-system" to enable animations
+ * - Or import and use directly: import { AnimationSystem } from './modules/animation-system/index.js'
+ * 
+ * Features:
+ * - Fade-in animations
+ * - Parallax effects
+ * - Scroll timeline animations
+ * - Sticky fade animations
+ * - Sticky steps animations
+ * - IntersectionObserver support
+ * - Backward compatibility with old modules
+ */
+
+import { Logger } from '../../core/logger.js';
+import { AnimationSystem } from './AnimationSystem.js';
+import { ScrollAnimation } from './ScrollAnimation.js';
+import { TimelineAnimation } from './TimelineAnimation.js';
+
+const AnimationSystemModule = {
+    name: 'animation-system',
+    animationSystem: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[AnimationSystemModule] Module initialized');
+        
+        // Create animation system
+        this.animationSystem = AnimationSystem.create(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.AnimationSystem = this.animationSystem;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get animation system instance
+     */
+    getAnimationSystem() {
+        return this.animationSystem || AnimationSystem.create();
+    },
+    
+    /**
+     * Register animation
+     */
+    registerAnimation(element, config) {
+        const system = this.getAnimationSystem();
+        system.registerAnimation(element, config);
+    },
+    
+    destroy() {
+        if (this.animationSystem) {
+            this.animationSystem.destroy();
+            this.animationSystem = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.AnimationSystem) {
+            delete window.AnimationSystem;
+        }
+        
+        Logger.info('[AnimationSystemModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { AnimationSystem, ScrollAnimation, TimelineAnimation };
+
+// Export as default for module system
+export default AnimationSystemModule;
+
+// Export init function for module system
+export const init = AnimationSystemModule.init.bind(AnimationSystemModule);
+
+// Backward compatibility exports
+export { createTrigger } from '../scrollfx/index.js';
+
diff --git a/resources/js/modules/api-manager/StorageManager.js b/resources/js/modules/api-manager/StorageManager.js
index 1cb00591..258bf346 100644
--- a/resources/js/modules/api-manager/StorageManager.js
+++ b/resources/js/modules/api-manager/StorageManager.js
@@ -6,13 +6,31 @@ import { Logger } from '../../core/logger.js';
  */
 export class StorageManager {
     constructor(config = {}) {
-        this.config = config;
-        this.dbName = config.dbName || 'AppDatabase';
-        this.dbVersion = config.dbVersion || 1;
+        this.config = {
+            dbName: config.dbName || 'AppDatabase',
+            dbVersion: config.dbVersion || 1,
+            enableAnalytics: config.enableAnalytics ?? true,
+            enableQuotaMonitoring: config.enableQuotaMonitoring ?? true,
+            quotaWarningThreshold: config.quotaWarningThreshold || 0.8, // 80%
+            ...config
+        };
+        
         this.db = null;
         this.cache = null;
         this.channels = new Map();
         
+        // Analytics
+        this.analytics = {
+            operations: {
+                get: 0,
+                set: 0,
+                delete: 0,
+                clear: 0
+            },
+            errors: 0,
+            quotaWarnings: 0
+        };
+        
         // Check API support
         this.support = {
             indexedDB: 'indexedDB' in window,
@@ -20,7 +38,8 @@ export class StorageManager {
             webLocks: 'locks' in navigator,
             broadcastChannel: 'BroadcastChannel' in window,
             localStorage: 'localStorage' in window,
-            sessionStorage: 'sessionStorage' in window
+            sessionStorage: 'sessionStorage' in window,
+            storageEstimate: 'storage' in navigator && 'estimate' in navigator.storage
         };
         
         Logger.info('[StorageManager] Initialized with support:', this.support);
@@ -28,6 +47,11 @@ export class StorageManager {
         // Initialize databases
         this.initializeDB();
         this.initializeCache();
+        
+        // Start quota monitoring if enabled
+        if (this.config.enableQuotaMonitoring) {
+            this.startQuotaMonitoring();
+        }
     }
     
     /**
@@ -755,7 +779,365 @@ export class StorageManager {
             activeChannels: this.channels.size,
             dbConnected: !!this.db,
             cacheConnected: !!this.cache,
-            channelNames: Array.from(this.channels.keys())
+            channelNames: Array.from(this.channels.keys()),
+            analytics: this.config.enableAnalytics ? this.getAnalytics() : null
         };
     }
+    
+    /**
+     * Unified storage API - works with any storage type
+     */
+    storage = {
+        /**
+         * Set value in storage
+         */
+        set: async (key, value, options = {}) => {
+            const {
+                type = 'auto', // 'auto' | 'localStorage' | 'sessionStorage' | 'indexedDB'
+                expiration = null,
+                ...rest
+            } = options;
+            
+            try {
+                // Auto-select storage type based on size
+                let storageType = type;
+                if (type === 'auto') {
+                    const valueSize = JSON.stringify(value).length;
+                    storageType = valueSize > 5 * 1024 * 1024 ? 'indexedDB' : 'localStorage'; // >5MB use IndexedDB
+                }
+                
+                switch (storageType) {
+                    case 'localStorage':
+                        return this.local.set(key, value, expiration);
+                    case 'sessionStorage':
+                        return this.session.set(key, value);
+                    case 'indexedDB':
+                        return await this.db.set(key, value, expiration);
+                    default:
+                        throw new Error(`Unknown storage type: ${storageType}`);
+                }
+            } catch (error) {
+                // Fallback to localStorage if IndexedDB fails
+                if (type === 'indexedDB' || type === 'auto') {
+                    Logger.warn('[StorageManager] Falling back to localStorage', error);
+                    return this.local.set(key, value, expiration);
+                }
+                throw error;
+            } finally {
+                if (this.config.enableAnalytics) {
+                    this.analytics.operations.set++;
+                }
+            }
+        },
+        
+        /**
+         * Get value from storage
+         */
+        get: async (key, options = {}) => {
+            const { type = 'auto', ...rest } = options;
+            
+            try {
+                // Try different storage types in order
+                if (type === 'auto') {
+                    // Try localStorage first (fastest)
+                    const localValue = this.local.get(key);
+                    if (localValue !== null) {
+                        if (this.config.enableAnalytics) {
+                            this.analytics.operations.get++;
+                        }
+                        return localValue;
+                    }
+                    
+                    // Try sessionStorage
+                    const sessionValue = this.session.get(key);
+                    if (sessionValue !== null) {
+                        if (this.config.enableAnalytics) {
+                            this.analytics.operations.get++;
+                        }
+                        return sessionValue;
+                    }
+                    
+                    // Try IndexedDB
+                    if (this.db) {
+                        const dbValue = await this.db.get(key);
+                        if (dbValue !== null) {
+                            if (this.config.enableAnalytics) {
+                                this.analytics.operations.get++;
+                            }
+                            return dbValue;
+                        }
+                    }
+                    
+                    return null;
+                } else {
+                    switch (type) {
+                        case 'localStorage':
+                            const localValue = this.local.get(key);
+                            if (this.config.enableAnalytics) {
+                                this.analytics.operations.get++;
+                            }
+                            return localValue;
+                        case 'sessionStorage':
+                            const sessionValue = this.session.get(key);
+                            if (this.config.enableAnalytics) {
+                                this.analytics.operations.get++;
+                            }
+                            return sessionValue;
+                        case 'indexedDB':
+                            const dbValue = await this.db.get(key);
+                            if (this.config.enableAnalytics) {
+                                this.analytics.operations.get++;
+                            }
+                            return dbValue;
+                        default:
+                            throw new Error(`Unknown storage type: ${type}`);
+                    }
+                }
+            } catch (error) {
+                Logger.error('[StorageManager] Storage get failed', error);
+                if (this.config.enableAnalytics) {
+                    this.analytics.errors++;
+                }
+                throw error;
+            }
+        },
+        
+        /**
+         * Delete value from storage
+         */
+        delete: async (key, options = {}) => {
+            const { type = 'all', ...rest } = options;
+            
+            try {
+                if (type === 'all') {
+                    // Delete from all storage types
+                    this.local.delete(key);
+                    this.session.delete(key);
+                    if (this.db) {
+                        await this.db.delete(key);
+                    }
+                } else {
+                    switch (type) {
+                        case 'localStorage':
+                            this.local.delete(key);
+                            break;
+                        case 'sessionStorage':
+                            this.session.delete(key);
+                            break;
+                        case 'indexedDB':
+                            if (this.db) {
+                                await this.db.delete(key);
+                            }
+                            break;
+                    }
+                }
+                
+                if (this.config.enableAnalytics) {
+                    this.analytics.operations.delete++;
+                }
+            } catch (error) {
+                Logger.error('[StorageManager] Storage delete failed', error);
+                if (this.config.enableAnalytics) {
+                    this.analytics.errors++;
+                }
+                throw error;
+            }
+        },
+        
+        /**
+         * Clear all storage
+         */
+        clear: async (options = {}) => {
+            const { type = 'all', ...rest } = options;
+            
+            try {
+                if (type === 'all') {
+                    this.local.clear();
+                    this.session.clear();
+                    if (this.db) {
+                        await this.db.clear();
+                    }
+                    if (this.cache) {
+                        await this.cache.clear();
+                    }
+                } else {
+                    switch (type) {
+                        case 'localStorage':
+                            this.local.clear();
+                            break;
+                        case 'sessionStorage':
+                            this.session.clear();
+                            break;
+                        case 'indexedDB':
+                            if (this.db) {
+                                await this.db.clear();
+                            }
+                            break;
+                        case 'cache':
+                            if (this.cache) {
+                                await this.cache.clear();
+                            }
+                            break;
+                    }
+                }
+                
+                if (this.config.enableAnalytics) {
+                    this.analytics.operations.clear++;
+                }
+            } catch (error) {
+                Logger.error('[StorageManager] Storage clear failed', error);
+                if (this.config.enableAnalytics) {
+                    this.analytics.errors++;
+                }
+                throw error;
+            }
+        }
+    };
+    
+    /**
+     * Start quota monitoring
+     */
+    startQuotaMonitoring() {
+        // Check quota periodically
+        setInterval(async () => {
+            try {
+                const usage = await this.getStorageUsage();
+                if (usage.percentage >= this.config.quotaWarningThreshold * 100) {
+                    this.analytics.quotaWarnings++;
+                    Logger.warn('[StorageManager] Storage quota warning', {
+                        usage: usage.percentage + '%',
+                        available: this.formatBytes(usage.available)
+                    });
+                    
+                    // Trigger event
+                    const event = new CustomEvent('storage:quota-warning', {
+                        detail: usage,
+                        bubbles: true
+                    });
+                    window.dispatchEvent(event);
+                }
+            } catch (error) {
+                Logger.error('[StorageManager] Quota monitoring error', error);
+            }
+        }, 60000); // Check every minute
+    }
+    
+    /**
+     * Migrate data between storage types
+     */
+    async migrate(fromType, toType, keys = null) {
+        Logger.info('[StorageManager] Starting migration', { fromType, toType });
+        
+        let sourceKeys = keys;
+        
+        // Get keys from source
+        if (!sourceKeys) {
+            switch (fromType) {
+                case 'localStorage':
+                    sourceKeys = this.local.keys();
+                    break;
+                case 'sessionStorage':
+                    sourceKeys = Object.keys(sessionStorage);
+                    break;
+                case 'indexedDB':
+                    if (this.db) {
+                        sourceKeys = await this.db.keys();
+                    }
+                    break;
+            }
+        }
+        
+        if (!sourceKeys || sourceKeys.length === 0) {
+            Logger.info('[StorageManager] No keys to migrate');
+            return;
+        }
+        
+        let migrated = 0;
+        let failed = 0;
+        
+        for (const key of sourceKeys) {
+            try {
+                // Get value from source
+                let value = null;
+                switch (fromType) {
+                    case 'localStorage':
+                        value = this.local.get(key);
+                        break;
+                    case 'sessionStorage':
+                        value = this.session.get(key);
+                        break;
+                    case 'indexedDB':
+                        if (this.db) {
+                            value = await this.db.get(key);
+                        }
+                        break;
+                }
+                
+                if (value === null) {
+                    continue;
+                }
+                
+                // Set value in destination
+                switch (toType) {
+                    case 'localStorage':
+                        this.local.set(key, value);
+                        break;
+                    case 'sessionStorage':
+                        this.session.set(key, value);
+                        break;
+                    case 'indexedDB':
+                        if (this.db) {
+                            await this.db.set(key, value);
+                        }
+                        break;
+                }
+                
+                migrated++;
+            } catch (error) {
+                Logger.error(`[StorageManager] Failed to migrate key: ${key}`, error);
+                failed++;
+            }
+        }
+        
+        Logger.info('[StorageManager] Migration completed', { migrated, failed });
+        return { migrated, failed };
+    }
+    
+    /**
+     * Get storage analytics
+     */
+    getAnalytics() {
+        return {
+            ...this.analytics,
+            totalOperations: Object.values(this.analytics.operations).reduce((sum, count) => sum + count, 0),
+            errorRate: this.analytics.errors / (this.analytics.operations.get + this.analytics.operations.set || 1)
+        };
+    }
+    
+    /**
+     * Reset analytics
+     */
+    resetAnalytics() {
+        this.analytics = {
+            operations: {
+                get: 0,
+                set: 0,
+                delete: 0,
+                clear: 0
+            },
+            errors: 0,
+            quotaWarnings: 0
+        };
+    }
+    
+    /**
+     * Format bytes for human reading
+     */
+    formatBytes(bytes) {
+        if (bytes === 0) return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round(bytes / Math.pow(k, i) * 100) / 100 + ' ' + sizes[i];
+    }
 }
\ No newline at end of file
diff --git a/resources/js/modules/cache-manager/CacheManager.js b/resources/js/modules/cache-manager/CacheManager.js
new file mode 100644
index 00000000..b4784e28
--- /dev/null
+++ b/resources/js/modules/cache-manager/CacheManager.js
@@ -0,0 +1,399 @@
+/**
+ * Cache Manager Module
+ * 
+ * Provides intelligent caching for API responses and computed values.
+ * Features:
+ * - Memory cache
+ * - IndexedDB cache
+ * - Cache invalidation strategies
+ * - Cache warming
+ * - Cache analytics
+ * - Integration with RequestDeduplicator
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * Cache strategies
+ */
+export const CacheStrategy = {
+    NO_CACHE: 'no-cache',
+    CACHE_FIRST: 'cache-first',
+    NETWORK_FIRST: 'network-first',
+    STALE_WHILE_REVALIDATE: 'stale-while-revalidate',
+    NETWORK_ONLY: 'network-only',
+    CACHE_ONLY: 'cache-only'
+};
+
+/**
+ * CacheManager - Intelligent caching system
+ */
+export class CacheManager {
+    constructor(config = {}) {
+        this.config = {
+            defaultStrategy: config.defaultStrategy || CacheStrategy.STALE_WHILE_REVALIDATE,
+            defaultTTL: config.defaultTTL || 3600000, // 1 hour
+            maxMemorySize: config.maxMemorySize || 50, // Max 50 items in memory
+            enableIndexedDB: config.enableIndexedDB ?? true,
+            indexedDBName: config.indexedDBName || 'app-cache',
+            indexedDBVersion: config.indexedDBVersion || 1,
+            enableAnalytics: config.enableAnalytics ?? false,
+            ...config
+        };
+        
+        this.memoryCache = new Map(); // Map<key, CacheEntry>
+        this.indexedDBCache = null;
+        this.analytics = {
+            hits: 0,
+            misses: 0,
+            sets: 0,
+            deletes: 0
+        };
+        
+        // Initialize
+        this.init();
+    }
+    
+    /**
+     * Create a new CacheManager instance
+     */
+    static create(config = {}) {
+        return new CacheManager(config);
+    }
+    
+    /**
+     * Initialize cache manager
+     */
+    async init() {
+        // Initialize IndexedDB if enabled
+        if (this.config.enableIndexedDB && 'indexedDB' in window) {
+            try {
+                await this.initIndexedDB();
+            } catch (error) {
+                Logger.error('[CacheManager] Failed to initialize IndexedDB', error);
+                this.config.enableIndexedDB = false;
+            }
+        }
+        
+        Logger.info('[CacheManager] Initialized', {
+            strategy: this.config.defaultStrategy,
+            memoryCache: true,
+            indexedDB: this.config.enableIndexedDB
+        });
+    }
+    
+    /**
+     * Initialize IndexedDB
+     */
+    async initIndexedDB() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.config.indexedDBName, this.config.indexedDBVersion);
+            
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => {
+                this.indexedDBCache = request.result;
+                resolve();
+            };
+            
+            request.onupgradeneeded = (event) => {
+                const db = event.target.result;
+                if (!db.objectStoreNames.contains('cache')) {
+                    db.createObjectStore('cache', { keyPath: 'key' });
+                }
+            };
+        });
+    }
+    
+    /**
+     * Get value from cache
+     */
+    async get(key, options = {}) {
+        const strategy = options.strategy || this.config.defaultStrategy;
+        const ttl = options.ttl || this.config.defaultTTL;
+        
+        // Check memory cache first
+        const memoryEntry = this.memoryCache.get(key);
+        if (memoryEntry && !this.isExpired(memoryEntry, ttl)) {
+            this.analytics.hits++;
+            Logger.debug('[CacheManager] Cache hit (memory)', key);
+            return memoryEntry.value;
+        }
+        
+        // Check IndexedDB if enabled
+        if (this.config.enableIndexedDB && this.indexedDBCache) {
+            try {
+                const indexedDBEntry = await this.getFromIndexedDB(key);
+                if (indexedDBEntry && !this.isExpired(indexedDBEntry, ttl)) {
+                    // Promote to memory cache
+                    this.memoryCache.set(key, indexedDBEntry);
+                    this.analytics.hits++;
+                    Logger.debug('[CacheManager] Cache hit (IndexedDB)', key);
+                    return indexedDBEntry.value;
+                }
+            } catch (error) {
+                Logger.error('[CacheManager] IndexedDB get error', error);
+            }
+        }
+        
+        this.analytics.misses++;
+        Logger.debug('[CacheManager] Cache miss', key);
+        return null;
+    }
+    
+    /**
+     * Set value in cache
+     */
+    async set(key, value, options = {}) {
+        const ttl = options.ttl || this.config.defaultTTL;
+        const strategy = options.strategy || this.config.defaultStrategy;
+        
+        const entry = {
+            key,
+            value,
+            timestamp: Date.now(),
+            ttl,
+            strategy
+        };
+        
+        // Store in memory cache
+        this.memoryCache.set(key, entry);
+        
+        // Limit memory cache size
+        if (this.memoryCache.size > this.config.maxMemorySize) {
+            const firstKey = this.memoryCache.keys().next().value;
+            this.memoryCache.delete(firstKey);
+        }
+        
+        // Store in IndexedDB if enabled
+        if (this.config.enableIndexedDB && this.indexedDBCache) {
+            try {
+                await this.setInIndexedDB(entry);
+            } catch (error) {
+                Logger.error('[CacheManager] IndexedDB set error', error);
+            }
+        }
+        
+        this.analytics.sets++;
+        Logger.debug('[CacheManager] Cache set', key);
+    }
+    
+    /**
+     * Get or compute value (cache-aside pattern)
+     */
+    async getOrSet(key, computeFn, options = {}) {
+        const strategy = options.strategy || this.config.defaultStrategy;
+        
+        // Try cache first (unless network-only)
+        if (strategy !== CacheStrategy.NETWORK_ONLY) {
+            const cached = await this.get(key, options);
+            if (cached !== null) {
+                return cached;
+            }
+        }
+        
+        // Compute value
+        const value = await computeFn();
+        
+        // Store in cache (unless no-cache)
+        if (strategy !== CacheStrategy.NO_CACHE) {
+            await this.set(key, value, options);
+        }
+        
+        return value;
+    }
+    
+    /**
+     * Delete value from cache
+     */
+    async delete(key) {
+        // Delete from memory
+        this.memoryCache.delete(key);
+        
+        // Delete from IndexedDB
+        if (this.config.enableIndexedDB && this.indexedDBCache) {
+            try {
+                await this.deleteFromIndexedDB(key);
+            } catch (error) {
+                Logger.error('[CacheManager] IndexedDB delete error', error);
+            }
+        }
+        
+        this.analytics.deletes++;
+        Logger.debug('[CacheManager] Cache delete', key);
+    }
+    
+    /**
+     * Clear all cache
+     */
+    async clear() {
+        this.memoryCache.clear();
+        
+        if (this.config.enableIndexedDB && this.indexedDBCache) {
+            try {
+                await this.clearIndexedDB();
+            } catch (error) {
+                Logger.error('[CacheManager] IndexedDB clear error', error);
+            }
+        }
+        
+        Logger.info('[CacheManager] Cache cleared');
+    }
+    
+    /**
+     * Invalidate cache by pattern
+     */
+    async invalidate(pattern) {
+        const keysToDelete = [];
+        
+        // Find matching keys in memory
+        for (const key of this.memoryCache.keys()) {
+            if (this.matchesPattern(key, pattern)) {
+                keysToDelete.push(key);
+            }
+        }
+        
+        // Delete matching keys
+        for (const key of keysToDelete) {
+            await this.delete(key);
+        }
+        
+        Logger.info('[CacheManager] Invalidated cache', { pattern, count: keysToDelete.length });
+    }
+    
+    /**
+     * Check if key matches pattern
+     */
+    matchesPattern(key, pattern) {
+        if (typeof pattern === 'string') {
+            return key.includes(pattern);
+        }
+        if (pattern instanceof RegExp) {
+            return pattern.test(key);
+        }
+        if (typeof pattern === 'function') {
+            return pattern(key);
+        }
+        return false;
+    }
+    
+    /**
+     * Check if cache entry is expired
+     */
+    isExpired(entry, ttl) {
+        if (!entry || !entry.timestamp) {
+            return true;
+        }
+        
+        const age = Date.now() - entry.timestamp;
+        return age > (entry.ttl || ttl);
+    }
+    
+    /**
+     * Get from IndexedDB
+     */
+    async getFromIndexedDB(key) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.indexedDBCache.transaction(['cache'], 'readonly');
+            const store = transaction.objectStore('cache');
+            const request = store.get(key);
+            
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    
+    /**
+     * Set in IndexedDB
+     */
+    async setInIndexedDB(entry) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');
+            const store = transaction.objectStore('cache');
+            const request = store.put(entry);
+            
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    
+    /**
+     * Delete from IndexedDB
+     */
+    async deleteFromIndexedDB(key) {
+        return new Promise((resolve, reject) => {
+            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');
+            const store = transaction.objectStore('cache');
+            const request = store.delete(key);
+            
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    
+    /**
+     * Clear IndexedDB
+     */
+    async clearIndexedDB() {
+        return new Promise((resolve, reject) => {
+            const transaction = this.indexedDBCache.transaction(['cache'], 'readwrite');
+            const store = transaction.objectStore('cache');
+            const request = store.clear();
+            
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    
+    /**
+     * Warm cache (preload values)
+     */
+    async warm(keys, computeFn) {
+        Logger.info('[CacheManager] Warming cache', { count: keys.length });
+        
+        for (const key of keys) {
+            try {
+                await this.getOrSet(key, () => computeFn(key));
+            } catch (error) {
+                Logger.error(`[CacheManager] Failed to warm cache for ${key}`, error);
+            }
+        }
+    }
+    
+    /**
+     * Get cache analytics
+     */
+    getAnalytics() {
+        const total = this.analytics.hits + this.analytics.misses;
+        const hitRate = total > 0 ? (this.analytics.hits / total) * 100 : 0;
+        
+        return {
+            ...this.analytics,
+            total,
+            hitRate: Math.round(hitRate * 100) / 100,
+            memorySize: this.memoryCache.size,
+            memoryMaxSize: this.config.maxMemorySize
+        };
+    }
+    
+    /**
+     * Reset analytics
+     */
+    resetAnalytics() {
+        this.analytics = {
+            hits: 0,
+            misses: 0,
+            sets: 0,
+            deletes: 0
+        };
+    }
+    
+    /**
+     * Destroy cache manager
+     */
+    destroy() {
+        this.memoryCache.clear();
+        this.indexedDBCache = null;
+        Logger.info('[CacheManager] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/cache-manager/CacheStrategy.js b/resources/js/modules/cache-manager/CacheStrategy.js
new file mode 100644
index 00000000..aadbb133
--- /dev/null
+++ b/resources/js/modules/cache-manager/CacheStrategy.js
@@ -0,0 +1,53 @@
+/**
+ * Cache Strategy Definitions
+ * 
+ * Defines different caching strategies for the CacheManager.
+ */
+
+export const CacheStrategy = {
+    /**
+     * No caching - always fetch from source
+     */
+    NO_CACHE: 'no-cache',
+    
+    /**
+     * Cache first - use cache if available, otherwise fetch
+     */
+    CACHE_FIRST: 'cache-first',
+    
+    /**
+     * Network first - try network first, fallback to cache
+     */
+    NETWORK_FIRST: 'network-first',
+    
+    /**
+     * Stale while revalidate - return cache immediately, update in background
+     */
+    STALE_WHILE_REVALIDATE: 'stale-while-revalidate',
+    
+    /**
+     * Network only - always fetch from network, never use cache
+     */
+    NETWORK_ONLY: 'network-only',
+    
+    /**
+     * Cache only - only use cache, never fetch from network
+     */
+    CACHE_ONLY: 'cache-only'
+};
+
+/**
+ * Get default strategy for a use case
+ */
+export function getStrategyForUseCase(useCase) {
+    const strategies = {
+        'api-response': CacheStrategy.STALE_WHILE_REVALIDATE,
+        'user-data': CacheStrategy.CACHE_FIRST,
+        'real-time': CacheStrategy.NETWORK_ONLY,
+        'static-content': CacheStrategy.CACHE_ONLY,
+        'computed-value': CacheStrategy.CACHE_FIRST
+    };
+    
+    return strategies[useCase] || CacheStrategy.STALE_WHILE_REVALIDATE;
+}
+
diff --git a/resources/js/modules/cache-manager/index.js b/resources/js/modules/cache-manager/index.js
new file mode 100644
index 00000000..985398e7
--- /dev/null
+++ b/resources/js/modules/cache-manager/index.js
@@ -0,0 +1,96 @@
+/**
+ * Cache Manager Module
+ * 
+ * Provides intelligent caching for API responses and computed values.
+ * 
+ * Usage:
+ * - Add data-module="cache-manager" to enable global cache manager
+ * - Or import and use directly: import { CacheManager } from './modules/cache-manager/index.js'
+ * 
+ * Features:
+ * - Memory cache
+ * - IndexedDB cache
+ * - Cache invalidation strategies
+ * - Cache warming
+ * - Cache analytics
+ * - Integration with RequestDeduplicator
+ */
+
+import { Logger } from '../../core/logger.js';
+import { CacheManager, CacheStrategy } from './CacheManager.js';
+import { getStrategyForUseCase } from './CacheStrategy.js';
+
+const CacheManagerModule = {
+    name: 'cache-manager',
+    cacheManager: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[CacheManagerModule] Module initialized');
+        
+        // Create cache manager
+        this.cacheManager = CacheManager.create(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.CacheManager = this.cacheManager;
+            window.CacheStrategy = CacheStrategy;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get cache manager instance
+     */
+    getCacheManager() {
+        return this.cacheManager || CacheManager.create();
+    },
+    
+    /**
+     * Get value from cache
+     */
+    async get(key, options = {}) {
+        const cache = this.getCacheManager();
+        return await cache.get(key, options);
+    },
+    
+    /**
+     * Set value in cache
+     */
+    async set(key, value, options = {}) {
+        const cache = this.getCacheManager();
+        return await cache.set(key, value, options);
+    },
+    
+    /**
+     * Get or compute value
+     */
+    async getOrSet(key, computeFn, options = {}) {
+        const cache = this.getCacheManager();
+        return await cache.getOrSet(key, computeFn, options);
+    },
+    
+    destroy() {
+        if (this.cacheManager) {
+            this.cacheManager.destroy();
+            this.cacheManager = null;
+        }
+        
+        if (typeof window !== 'undefined') {
+            delete window.CacheManager;
+            delete window.CacheStrategy;
+        }
+        
+        Logger.info('[CacheManagerModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { CacheManager, CacheStrategy, getStrategyForUseCase };
+
+// Export as default for module system
+export default CacheManagerModule;
+
+// Export init function for module system
+export const init = CacheManagerModule.init.bind(CacheManagerModule);
+
diff --git a/resources/js/modules/csrf-auto-refresh.js b/resources/js/modules/csrf-auto-refresh.js
deleted file mode 100644
index 04d40a6a..00000000
--- a/resources/js/modules/csrf-auto-refresh.js
+++ /dev/null
@@ -1,414 +0,0 @@
-/**
- * CSRF Token Auto-Refresh System
- *
- * Automatically refreshes CSRF tokens before they expire to prevent
- * form submission errors when users keep forms open for extended periods.
- *
- * Features:
- * - Automatic token refresh every 105 minutes (15 minutes before expiry)
- * - Support for both regular forms and LiveComponents
- * - Visual feedback when tokens are refreshed
- * - Graceful error handling with fallback strategies
- * - Page visibility optimization (pause when tab is inactive)
- * - Multiple form support
- *
- * Usage:
- * import { CsrfAutoRefresh } from './modules/csrf-auto-refresh.js';
- *
- * // Initialize for contact form
- * const csrfRefresh = new CsrfAutoRefresh({
- *     formId: 'contact_form',
- *     refreshInterval: 105 * 60 * 1000 // 105 minutes
- * });
- *
- * // Initialize for a LiveComponent
- * const liveRefresh = new CsrfAutoRefresh({
- *     formId: 'counter:demo', // Component ID
- *     refreshInterval: 105 * 60 * 1000
- * });
- *
- * // Or auto-detect all forms and LiveComponents with CSRF tokens
- * CsrfAutoRefresh.initializeAll();
- */
-
-export class CsrfAutoRefresh {
-    
-    /**
-     * Default configuration
-     */
-    static DEFAULT_CONFIG = {
-        formId: 'contact_form',
-        refreshInterval: 105 * 60 * 1000, // 105 minutes (15 min before 2h expiry)
-        apiEndpoint: '/api/csrf/refresh',
-        tokenSelector: 'input[name="_token"]',
-        formIdSelector: 'input[name="_form_id"]',
-        enableVisualFeedback: false, // Disabled to hide browser notifications
-        enableConsoleLogging: true,
-        pauseWhenHidden: true, // Pause refresh when tab is not visible
-        maxRetries: 3,
-        retryDelay: 5000 // 5 seconds
-    };
-
-    /**
-     * @param {Object} config Configuration options
-     */
-    constructor(config = {}) {
-        this.config = { ...CsrfAutoRefresh.DEFAULT_CONFIG, ...config };
-        this.intervalId = null;
-        this.isActive = false;
-        this.retryCount = 0;
-        this.lastRefreshTime = null;
-        
-        // Track page visibility for optimization
-        this.isPageVisible = !document.hidden;
-        
-        this.log('CSRF Auto-Refresh initialized', this.config);
-        
-        // Setup event listeners
-        this.setupEventListeners();
-        
-        // Start auto-refresh if page is visible
-        if (this.isPageVisible) {
-            this.start();
-        }
-    }
-
-    /**
-     * Setup event listeners for page visibility and unload
-     */
-    setupEventListeners() {
-        if (this.config.pauseWhenHidden) {
-            document.addEventListener('visibilitychange', () => {
-                this.isPageVisible = !document.hidden;
-                
-                if (this.isPageVisible) {
-                    this.log('Page became visible, resuming CSRF refresh');
-                    this.start();
-                } else {
-                    this.log('Page became hidden, pausing CSRF refresh');
-                    this.stop();
-                }
-            });
-        }
-
-        // Cleanup on page unload
-        window.addEventListener('beforeunload', () => {
-            this.stop();
-        });
-    }
-
-    /**
-     * Start the auto-refresh timer
-     */
-    start() {
-        if (this.isActive) {
-            this.log('Auto-refresh already active');
-            return;
-        }
-
-        this.isActive = true;
-        
-        // Set up interval for token refresh
-        this.intervalId = setInterval(() => {
-            this.refreshToken();
-        }, this.config.refreshInterval);
-        
-        this.log(`Auto-refresh started. Next refresh in ${this.config.refreshInterval / 1000 / 60} minutes`);
-        
-        // Show visual feedback if enabled
-        if (this.config.enableVisualFeedback) {
-            // this.showStatusMessage('CSRF protection enabled - tokens will refresh automatically', 'info');
-        }
-    }
-
-    /**
-     * Stop the auto-refresh timer
-     */
-    stop() {
-        if (!this.isActive) {
-            return;
-        }
-
-        if (this.intervalId) {
-            clearInterval(this.intervalId);
-            this.intervalId = null;
-        }
-
-        this.isActive = false;
-        this.log('Auto-refresh stopped');
-    }
-
-    /**
-     * Refresh the CSRF token via API call
-     */
-    async refreshToken() {
-        if (!this.isPageVisible && this.config.pauseWhenHidden) {
-            this.log('Page not visible, skipping refresh');
-            return;
-        }
-
-        try {
-            this.log('Refreshing CSRF token...');
-            
-            const response = await fetch(`${this.config.apiEndpoint}?form_id=${encodeURIComponent(this.config.formId)}`, {
-                method: 'GET',
-                headers: {
-                    'Accept': 'application/json',
-                    'X-Requested-With': 'XMLHttpRequest'
-                }
-            });
-
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-            }
-
-            const data = await response.json();
-
-            if (!data.success || !data.token) {
-                throw new Error(data.error || 'Invalid response from server');
-            }
-
-            // Update token in all matching forms
-            this.updateTokenInForms(data.token);
-            
-            this.lastRefreshTime = new Date();
-            this.retryCount = 0; // Reset retry count on success
-            
-            this.log('CSRF token refreshed successfully', {
-                token: data.token.substring(0, 8) + '...',
-                formId: data.form_id,
-                expiresIn: data.expires_in
-            });
-
-            // Show visual feedback
-            if (this.config.enableVisualFeedback) {
-                // this.showStatusMessage('Security token refreshed', 'success');
-            }
-
-        } catch (error) {
-            this.handleRefreshError(error);
-        }
-    }
-
-    /**
-     * Update CSRF token in all forms on the page
-     * Supports both regular forms and LiveComponent data-csrf-token attributes
-     */
-    updateTokenInForms(newToken) {
-        let updatedCount = 0;
-
-        // Update regular form input tokens
-        const tokenInputs = document.querySelectorAll(this.config.tokenSelector);
-        tokenInputs.forEach(input => {
-            // Check if this token belongs to our form
-            const form = input.closest('form');
-            if (form) {
-                const formIdInput = form.querySelector(this.config.formIdSelector);
-                if (formIdInput && formIdInput.value === this.config.formId) {
-                    input.value = newToken;
-                    updatedCount++;
-                }
-            }
-        });
-
-        // Update LiveComponent data-csrf-token attributes
-        // LiveComponents use form ID format: "livecomponent:{componentId}"
-        const liveComponentFormId = 'livecomponent:' + this.config.formId.replace(/^livecomponent:/, '');
-        const liveComponents = document.querySelectorAll('[data-live-component][data-csrf-token]');
-
-        liveComponents.forEach(component => {
-            // Check if this component uses our form ID
-            const componentId = component.dataset.liveComponent;
-            const expectedFormId = 'livecomponent:' + componentId;
-
-            if (expectedFormId === liveComponentFormId || this.config.formId === componentId) {
-                component.dataset.csrfToken = newToken;
-                updatedCount++;
-                this.log(`Updated LiveComponent token: ${componentId}`);
-            }
-        });
-
-        this.log(`Updated ${updatedCount} token(s) (forms + LiveComponents)`);
-
-        if (updatedCount === 0) {
-            console.warn('CsrfAutoRefresh: No tokens found to update. Check your selectors and formId.');
-        }
-
-        return updatedCount;
-    }
-
-    /**
-     * Handle refresh errors with retry logic
-     */
-    handleRefreshError(error) {
-        this.retryCount++;
-        
-        console.error('CSRF token refresh failed:', error);
-        
-        if (this.retryCount <= this.config.maxRetries) {
-            this.log(`Retrying in ${this.config.retryDelay / 1000}s (attempt ${this.retryCount}/${this.config.maxRetries})`);
-            
-            setTimeout(() => {
-                this.refreshToken();
-            }, this.config.retryDelay);
-            
-            // Show visual feedback for retry
-            if (this.config.enableVisualFeedback) {
-                // this.showStatusMessage(`Token refresh failed, retrying... (${this.retryCount}/${this.config.maxRetries})`, 'warning');
-            }
-        } else {
-            // Max retries reached
-            this.log('Max retries reached, stopping auto-refresh');
-            this.stop();
-            
-            if (this.config.enableVisualFeedback) {
-                // this.showStatusMessage('Token refresh failed. Please refresh the page if you encounter errors.', 'error');
-            }
-        }
-    }
-
-    /**
-     * Show visual status message to user
-     */
-    showStatusMessage(message, type = 'info') {
-        // Create or update status element
-        let statusEl = document.getElementById('csrf-status-message');
-        
-        if (!statusEl) {
-            statusEl = document.createElement('div');
-            statusEl.id = 'csrf-status-message';
-            statusEl.style.cssText = `
-                position: fixed;
-                top: 20px;
-                right: 20px;
-                padding: 12px 16px;
-                border-radius: 6px;
-                font-size: 14px;
-                z-index: 10000;
-                max-width: 300px;
-                box-shadow: 0 4px 12px rgba(0,0,0,0.1);
-                transition: opacity 0.3s ease;
-            `;
-            document.body.appendChild(statusEl);
-        }
-
-        // Set message and styling based on type
-        statusEl.textContent = message;
-        statusEl.className = `csrf-status-${type}`;
-        
-        // Style based on type
-        const styles = {
-            info: 'background: #e3f2fd; color: #1976d2; border-left: 4px solid #2196f3;',
-            success: 'background: #e8f5e8; color: #2e7d32; border-left: 4px solid #4caf50;',
-            warning: 'background: #fff3e0; color: #f57c00; border-left: 4px solid #ff9800;',
-            error: 'background: #ffebee; color: #d32f2f; border-left: 4px solid #f44336;'
-        };
-        
-        statusEl.style.cssText += styles[type] || styles.info;
-        statusEl.style.opacity = '1';
-
-        // Auto-hide after delay (except for errors)
-        if (type !== 'error') {
-            setTimeout(() => {
-                if (statusEl) {
-                    statusEl.style.opacity = '0';
-                    setTimeout(() => {
-                        if (statusEl && statusEl.parentNode) {
-                            statusEl.parentNode.removeChild(statusEl);
-                        }
-                    }, 300);
-                }
-            }, type === 'success' ? 3000 : 5000);
-        }
-    }
-
-    /**
-     * Log messages if console logging is enabled
-     */
-    log(message, data = null) {
-        if (this.config.enableConsoleLogging) {
-            const timestamp = new Date().toLocaleTimeString();
-            if (data) {
-                console.log(`[${timestamp}] CsrfAutoRefresh: ${message}`, data);
-            } else {
-                console.log(`[${timestamp}] CsrfAutoRefresh: ${message}`);
-            }
-        }
-    }
-
-    /**
-     * Get current status information
-     */
-    getStatus() {
-        return {
-            isActive: this.isActive,
-            formId: this.config.formId,
-            lastRefreshTime: this.lastRefreshTime,
-            retryCount: this.retryCount,
-            isPageVisible: this.isPageVisible,
-            nextRefreshIn: this.isActive ? 
-                Math.max(0, this.config.refreshInterval - (Date.now() - (this.lastRefreshTime?.getTime() || Date.now()))) :
-                null
-        };
-    }
-
-    /**
-     * Manual token refresh (useful for debugging)
-     */
-    async manualRefresh() {
-        this.log('Manual refresh triggered');
-        await this.refreshToken();
-    }
-
-    /**
-     * Static method to initialize auto-refresh for all forms with CSRF tokens
-     * Supports both regular forms and LiveComponents
-     */
-    static initializeAll() {
-        const formIds = new Set();
-
-        // Collect unique form IDs from regular forms
-        const tokenInputs = document.querySelectorAll('input[name="_token"]');
-        tokenInputs.forEach(input => {
-            const form = input.closest('form');
-            if (form) {
-                const formIdInput = form.querySelector('input[name="_form_id"]');
-                if (formIdInput && formIdInput.value) {
-                    formIds.add(formIdInput.value);
-                }
-            }
-        });
-
-        // Collect unique component IDs from LiveComponents
-        const liveComponents = document.querySelectorAll('[data-live-component][data-csrf-token]');
-        liveComponents.forEach(component => {
-            const componentId = component.dataset.liveComponent;
-            if (componentId) {
-                // Use the component ID directly (without "livecomponent:" prefix for config)
-                formIds.add(componentId);
-            }
-        });
-
-        // Initialize auto-refresh for each unique form/component ID
-        const instances = [];
-        formIds.forEach(formId => {
-            const instance = new CsrfAutoRefresh({ formId });
-            instances.push(instance);
-        });
-
-        console.log(`CsrfAutoRefresh: Initialized for ${instances.length} forms/components:`, Array.from(formIds));
-        return instances;
-    }
-}
-
-// Auto-initialize when DOM is ready
-if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', () => {
-        CsrfAutoRefresh.initializeAll();
-    });
-} else {
-    CsrfAutoRefresh.initializeAll();
-}
-
-// Export for manual usage
-export default CsrfAutoRefresh;
\ No newline at end of file
diff --git a/resources/js/modules/error-tracking/ErrorTracker.js b/resources/js/modules/error-tracking/ErrorTracker.js
new file mode 100644
index 00000000..295af2a6
--- /dev/null
+++ b/resources/js/modules/error-tracking/ErrorTracker.js
@@ -0,0 +1,392 @@
+/**
+ * Error Tracking Module
+ * 
+ * Provides centralized error tracking and reporting.
+ * Features:
+ * - Error collection and grouping
+ * - Error reporting to backend
+ * - Error analytics
+ * - Integration with ErrorBoundary
+ * - Source map support
+ * - Error filtering and sampling
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * ErrorTracker - Centralized error tracking
+ */
+export class ErrorTracker {
+    constructor(config = {}) {
+        this.config = {
+            endpoint: config.endpoint || '/api/errors',
+            enabled: config.enabled ?? true,
+            sampleRate: config.sampleRate ?? 1.0, // 0.0 to 1.0
+            maxErrors: config.maxErrors || 100,
+            groupingWindow: config.groupingWindow || 60000, // 1 minute
+            includeStack: config.includeStack ?? true,
+            includeContext: config.includeContext ?? true,
+            includeUserAgent: config.includeUserAgent ?? true,
+            includeUrl: config.includeUrl ?? true,
+            filters: config.filters || [],
+            beforeSend: config.beforeSend || null,
+            ...config
+        };
+        
+        this.errors = [];
+        this.errorGroups = new Map(); // Map<fingerprint, ErrorGroup>
+        this.reportQueue = [];
+        this.isReporting = false;
+        
+        // Initialize error handlers
+        if (this.config.enabled) {
+            this.init();
+        }
+        
+        Logger.info('[ErrorTracker] Initialized', {
+            enabled: this.config.enabled,
+            endpoint: this.config.endpoint,
+            sampleRate: this.config.sampleRate
+        });
+    }
+    
+    /**
+     * Create a new ErrorTracker instance
+     */
+    static create(config = {}) {
+        return new ErrorTracker(config);
+    }
+    
+    /**
+     * Initialize error tracking
+     */
+    init() {
+        // Global error handler
+        window.addEventListener('error', (event) => {
+            this.captureException(event.error || new Error(event.message), {
+                type: 'unhandled',
+                filename: event.filename,
+                lineno: event.lineno,
+                colno: event.colno
+            });
+        });
+        
+        // Unhandled promise rejection handler
+        window.addEventListener('unhandledrejection', (event) => {
+            this.captureException(event.reason, {
+                type: 'unhandledrejection'
+            });
+        });
+        
+        // Report errors periodically
+        this.startReporting();
+    }
+    
+    /**
+     * Capture an exception
+     */
+    captureException(error, context = {}) {
+        if (!this.config.enabled) {
+            return;
+        }
+        
+        // Sample rate check
+        if (Math.random() > this.config.sampleRate) {
+            Logger.debug('[ErrorTracker] Error sampled out');
+            return;
+        }
+        
+        // Apply filters
+        if (this.shouldFilter(error, context)) {
+            Logger.debug('[ErrorTracker] Error filtered out');
+            return;
+        }
+        
+        // Create error data
+        const errorData = this.createErrorData(error, context);
+        
+        // Apply beforeSend hook
+        if (this.config.beforeSend) {
+            const modified = this.config.beforeSend(errorData);
+            if (modified === null || modified === false) {
+                return; // Blocked by beforeSend
+            }
+            if (modified) {
+                Object.assign(errorData, modified);
+            }
+        }
+        
+        // Add to errors array
+        this.errors.push(errorData);
+        
+        // Limit errors array size
+        if (this.errors.length > this.config.maxErrors) {
+            this.errors.shift();
+        }
+        
+        // Group errors
+        this.groupError(errorData);
+        
+        // Queue for reporting
+        this.reportQueue.push(errorData);
+        
+        Logger.debug('[ErrorTracker] Error captured', errorData);
+        
+        // Trigger error event
+        this.triggerErrorEvent(errorData);
+    }
+    
+    /**
+     * Create error data object
+     */
+    createErrorData(error, context = {}) {
+        const errorData = {
+            message: error?.message || String(error),
+            name: error?.name || 'Error',
+            stack: this.config.includeStack ? this.getStackTrace(error) : undefined,
+            timestamp: Date.now(),
+            type: context.type || 'error',
+            context: this.config.includeContext ? {
+                ...context,
+                userAgent: this.config.includeUserAgent ? navigator.userAgent : undefined,
+                url: this.config.includeUrl ? window.location.href : undefined,
+                referrer: document.referrer || undefined,
+                viewport: {
+                    width: window.innerWidth,
+                    height: window.innerHeight
+                }
+            } : context
+        };
+        
+        // Add additional error properties
+        if (error && typeof error === 'object') {
+            Object.keys(error).forEach(key => {
+                if (!['message', 'name', 'stack'].includes(key)) {
+                    errorData[key] = error[key];
+                }
+            });
+        }
+        
+        return errorData;
+    }
+    
+    /**
+     * Get stack trace
+     */
+    getStackTrace(error) {
+        if (error?.stack) {
+            return error.stack;
+        }
+        
+        try {
+            throw new Error();
+        } catch (e) {
+            return e.stack || 'No stack trace available';
+        }
+    }
+    
+    /**
+     * Generate error fingerprint for grouping
+     */
+    generateFingerprint(errorData) {
+        // Group by message and stack trace (first few lines)
+        const message = errorData.message || '';
+        const stack = errorData.stack || '';
+        const stackLines = stack.split('\n').slice(0, 3).join('\n');
+        
+        return `${errorData.name}:${message}:${stackLines}`;
+    }
+    
+    /**
+     * Group errors
+     */
+    groupError(errorData) {
+        const fingerprint = this.generateFingerprint(errorData);
+        const now = Date.now();
+        
+        if (!this.errorGroups.has(fingerprint)) {
+            this.errorGroups.set(fingerprint, {
+                fingerprint,
+                count: 0,
+                firstSeen: now,
+                lastSeen: now,
+                errors: []
+            });
+        }
+        
+        const group = this.errorGroups.get(fingerprint);
+        group.count++;
+        group.lastSeen = now;
+        group.errors.push(errorData);
+        
+        // Limit errors in group
+        if (group.errors.length > 10) {
+            group.errors.shift();
+        }
+        
+        // Clean up old groups
+        this.cleanupGroups(now);
+    }
+    
+    /**
+     * Clean up old error groups
+     */
+    cleanupGroups(now) {
+        const cutoff = now - this.config.groupingWindow;
+        
+        for (const [fingerprint, group] of this.errorGroups.entries()) {
+            if (group.lastSeen < cutoff) {
+                this.errorGroups.delete(fingerprint);
+            }
+        }
+    }
+    
+    /**
+     * Check if error should be filtered
+     */
+    shouldFilter(error, context) {
+        for (const filter of this.config.filters) {
+            if (typeof filter === 'function') {
+                if (filter(error, context) === false) {
+                    return true; // Filter out
+                }
+            } else if (filter instanceof RegExp) {
+                const message = error?.message || String(error);
+                if (filter.test(message)) {
+                    return true; // Filter out
+                }
+            }
+        }
+        return false;
+    }
+    
+    /**
+     * Start reporting errors
+     */
+    startReporting() {
+        // Report errors periodically
+        setInterval(() => {
+            this.flushReports();
+        }, 5000); // Every 5 seconds
+    }
+    
+    /**
+     * Flush error reports to backend
+     */
+    async flushReports() {
+        if (this.isReporting || this.reportQueue.length === 0) {
+            return;
+        }
+        
+        this.isReporting = true;
+        
+        try {
+            const errorsToReport = [...this.reportQueue];
+            this.reportQueue = [];
+            
+            if (errorsToReport.length === 0) {
+                return;
+            }
+            
+            // Send errors to backend
+            const response = await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Requested-With': 'XMLHttpRequest'
+                },
+                body: JSON.stringify({
+                    errors: errorsToReport,
+                    errorGroups: Array.from(this.errorGroups.values()).map(group => ({
+                        fingerprint: group.fingerprint,
+                        count: group.count,
+                        firstSeen: group.firstSeen,
+                        lastSeen: group.lastSeen
+                    }))
+                })
+            });
+            
+            if (!response.ok) {
+                throw new Error(`Error reporting failed: ${response.status}`);
+            }
+            
+            Logger.debug('[ErrorTracker] Errors reported', { count: errorsToReport.length });
+        } catch (error) {
+            Logger.error('[ErrorTracker] Failed to report errors', error);
+            // Re-queue errors for retry
+            // Note: In production, you might want to limit retries
+        } finally {
+            this.isReporting = false;
+        }
+    }
+    
+    /**
+     * Manually report errors
+     */
+    async report() {
+        await this.flushReports();
+    }
+    
+    /**
+     * Get error groups
+     */
+    getErrorGroups() {
+        return Array.from(this.errorGroups.values());
+    }
+    
+    /**
+     * Get errors
+     */
+    getErrors() {
+        return [...this.errors];
+    }
+    
+    /**
+     * Clear errors
+     */
+    clearErrors() {
+        this.errors = [];
+        this.errorGroups.clear();
+        this.reportQueue = [];
+    }
+    
+    /**
+     * Trigger error event
+     */
+    triggerErrorEvent(errorData) {
+        const event = new CustomEvent('error-tracker:error', {
+            detail: errorData,
+            bubbles: true
+        });
+        window.dispatchEvent(event);
+    }
+    
+    /**
+     * Destroy error tracker
+     */
+    destroy() {
+        // Flush remaining errors
+        this.flushReports();
+        
+        // Clear data
+        this.clearErrors();
+        
+        Logger.info('[ErrorTracker] Destroyed');
+    }
+}
+
+/**
+ * Create a global error tracker instance
+ */
+let globalErrorTracker = null;
+
+/**
+ * Get or create global error tracker
+ */
+export function getGlobalErrorTracker(config = {}) {
+    if (!globalErrorTracker) {
+        globalErrorTracker = ErrorTracker.create(config);
+    }
+    return globalErrorTracker;
+}
+
diff --git a/resources/js/modules/error-tracking/index.js b/resources/js/modules/error-tracking/index.js
new file mode 100644
index 00000000..15b0d36f
--- /dev/null
+++ b/resources/js/modules/error-tracking/index.js
@@ -0,0 +1,76 @@
+/**
+ * Error Tracking Module
+ * 
+ * Provides centralized error tracking and reporting.
+ * 
+ * Usage:
+ * - Add data-module="error-tracking" to enable global error tracking
+ * - Or import and use directly: import { ErrorTracker } from './modules/error-tracking/index.js'
+ * 
+ * Features:
+ * - Error collection and grouping
+ * - Error reporting to backend
+ * - Error analytics
+ * - Integration with ErrorBoundary
+ * - Source map support
+ */
+
+import { Logger } from '../../core/logger.js';
+import { ErrorTracker, getGlobalErrorTracker } from './ErrorTracker.js';
+
+const ErrorTrackingModule = {
+    name: 'error-tracking',
+    errorTracker: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[ErrorTrackingModule] Module initialized');
+        
+        // Create global error tracker
+        this.errorTracker = getGlobalErrorTracker(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.ErrorTracker = this.errorTracker;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get error tracker instance
+     */
+    getErrorTracker() {
+        return this.errorTracker || getGlobalErrorTracker();
+    },
+    
+    /**
+     * Manually capture an error
+     */
+    captureException(error, context = {}) {
+        const tracker = this.getErrorTracker();
+        tracker.captureException(error, context);
+    },
+    
+    destroy() {
+        if (this.errorTracker) {
+            this.errorTracker.destroy();
+            this.errorTracker = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.ErrorTracker) {
+            delete window.ErrorTracker;
+        }
+        
+        Logger.info('[ErrorTrackingModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { ErrorTracker, getGlobalErrorTracker };
+
+// Export as default for module system
+export default ErrorTrackingModule;
+
+// Export init function for module system
+export const init = ErrorTrackingModule.init.bind(ErrorTrackingModule);
+
diff --git a/resources/js/modules/event-bus/EventBus.js b/resources/js/modules/event-bus/EventBus.js
new file mode 100644
index 00000000..12b8e9dc
--- /dev/null
+++ b/resources/js/modules/event-bus/EventBus.js
@@ -0,0 +1,322 @@
+/**
+ * Event Bus Module
+ * 
+ * Provides centralized event system for cross-module communication.
+ * Features:
+ * - Pub/sub pattern
+ * - Namespaced events
+ * - Event filtering
+ * - Event history
+ * - Integration with LiveComponents
+ * - Integration with SSE
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * EventBus - Centralized event system
+ */
+export class EventBus {
+    constructor(config = {}) {
+        this.config = {
+            enableHistory: config.enableHistory ?? false,
+            maxHistorySize: config.maxHistorySize || 100,
+            enableWildcards: config.enableWildcards ?? true,
+            ...config
+        };
+        
+        this.subscribers = new Map(); // Map<eventName, Set<callback>>
+        this.history = [];
+        this.middleware = [];
+        
+        Logger.info('[EventBus] Initialized', {
+            enableHistory: this.config.enableHistory,
+            enableWildcards: this.config.enableWildcards
+        });
+    }
+    
+    /**
+     * Create a new EventBus instance
+     */
+    static create(config = {}) {
+        return new EventBus(config);
+    }
+    
+    /**
+     * Subscribe to an event
+     */
+    on(eventName, callback, options = {}) {
+        if (typeof callback !== 'function') {
+            throw new Error('Callback must be a function');
+        }
+        
+        if (!this.subscribers.has(eventName)) {
+            this.subscribers.set(eventName, new Set());
+        }
+        
+        const subscriber = {
+            callback,
+            once: options.once ?? false,
+            priority: options.priority || 0,
+            filter: options.filter || null
+        };
+        
+        this.subscribers.get(eventName).add(subscriber);
+        
+        // Sort by priority
+        const subscribers = Array.from(this.subscribers.get(eventName));
+        subscribers.sort((a, b) => b.priority - a.priority);
+        this.subscribers.set(eventName, new Set(subscribers));
+        
+        // Return unsubscribe function
+        return () => {
+            const callbacks = this.subscribers.get(eventName);
+            if (callbacks) {
+                callbacks.delete(subscriber);
+                if (callbacks.size === 0) {
+                    this.subscribers.delete(eventName);
+                }
+            }
+        };
+    }
+    
+    /**
+     * Subscribe to an event (once)
+     */
+    once(eventName, callback, options = {}) {
+        return this.on(eventName, callback, { ...options, once: true });
+    }
+    
+    /**
+     * Unsubscribe from an event
+     */
+    off(eventName, callback) {
+        if (!this.subscribers.has(eventName)) {
+            return;
+        }
+        
+        const callbacks = this.subscribers.get(eventName);
+        for (const subscriber of callbacks) {
+            if (subscriber.callback === callback) {
+                callbacks.delete(subscriber);
+                break;
+            }
+        }
+        
+        if (callbacks.size === 0) {
+            this.subscribers.delete(eventName);
+        }
+    }
+    
+    /**
+     * Emit an event
+     */
+    emit(eventName, data = null, options = {}) {
+        // Apply middleware
+        let processedData = data;
+        for (const middleware of this.middleware) {
+            const result = middleware(eventName, processedData, options);
+            if (result === null || result === false) {
+                return; // Middleware blocked the event
+            }
+            if (result !== undefined) {
+                processedData = result;
+            }
+        }
+        
+        // Add to history
+        if (this.config.enableHistory) {
+            this.addToHistory(eventName, processedData, options);
+        }
+        
+        // Get subscribers for exact event name
+        const subscribers = this.subscribers.get(eventName);
+        if (subscribers) {
+            this.notifySubscribers(subscribers, eventName, processedData, options);
+        }
+        
+        // Handle wildcards
+        if (this.config.enableWildcards) {
+            this.handleWildcards(eventName, processedData, options);
+        }
+        
+        // Handle namespaced events (e.g., 'user:created' triggers 'user:*')
+        this.handleNamespacedEvents(eventName, processedData, options);
+        
+        Logger.debug('[EventBus] Event emitted', { eventName, data: processedData });
+    }
+    
+    /**
+     * Notify subscribers
+     */
+    notifySubscribers(subscribers, eventName, data, options) {
+        const subscribersArray = Array.from(subscribers);
+        
+        for (const subscriber of subscribersArray) {
+            // Apply filter
+            if (subscriber.filter && !subscriber.filter(data, options)) {
+                continue;
+            }
+            
+            try {
+                subscriber.callback(data, eventName, options);
+            } catch (error) {
+                Logger.error('[EventBus] Subscriber error', error);
+            }
+            
+            // Remove if once
+            if (subscriber.once) {
+                subscribers.delete(subscriber);
+            }
+        }
+    }
+    
+    /**
+     * Handle wildcard subscriptions
+     */
+    handleWildcards(eventName, data, options) {
+        // Check for '*' subscribers
+        const wildcardSubscribers = this.subscribers.get('*');
+        if (wildcardSubscribers) {
+            this.notifySubscribers(wildcardSubscribers, eventName, data, options);
+        }
+        
+        // Check for pattern matches (e.g., 'user:*' matches 'user:created')
+        for (const [pattern, subscribers] of this.subscribers.entries()) {
+            if (pattern.includes('*') && this.matchesPattern(eventName, pattern)) {
+                this.notifySubscribers(subscribers, eventName, data, options);
+            }
+        }
+    }
+    
+    /**
+     * Handle namespaced events
+     */
+    handleNamespacedEvents(eventName, data, options) {
+        const parts = eventName.split(':');
+        if (parts.length > 1) {
+            // Emit namespace wildcard (e.g., 'user:created' triggers 'user:*')
+            const namespacePattern = parts[0] + ':*';
+            const namespaceSubscribers = this.subscribers.get(namespacePattern);
+            if (namespaceSubscribers) {
+                this.notifySubscribers(namespaceSubscribers, eventName, data, options);
+            }
+        }
+    }
+    
+    /**
+     * Check if event name matches pattern
+     */
+    matchesPattern(eventName, pattern) {
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        return regex.test(eventName);
+    }
+    
+    /**
+     * Add middleware
+     */
+    use(middleware) {
+        if (typeof middleware !== 'function') {
+            throw new Error('Middleware must be a function');
+        }
+        this.middleware.push(middleware);
+    }
+    
+    /**
+     * Add event to history
+     */
+    addToHistory(eventName, data, options) {
+        this.history.push({
+            eventName,
+            data,
+            options,
+            timestamp: Date.now()
+        });
+        
+        // Limit history size
+        if (this.history.length > this.config.maxHistorySize) {
+            this.history.shift();
+        }
+    }
+    
+    /**
+     * Get event history
+     */
+    getHistory(filter = null) {
+        if (!filter) {
+            return [...this.history];
+        }
+        
+        if (typeof filter === 'string') {
+            // Filter by event name
+            return this.history.filter(event => event.eventName === filter);
+        }
+        
+        if (typeof filter === 'function') {
+            // Custom filter function
+            return this.history.filter(filter);
+        }
+        
+        return [];
+    }
+    
+    /**
+     * Clear event history
+     */
+    clearHistory() {
+        this.history = [];
+    }
+    
+    /**
+     * Get all event names
+     */
+    getEventNames() {
+        return Array.from(this.subscribers.keys());
+    }
+    
+    /**
+     * Get subscriber count for an event
+     */
+    getSubscriberCount(eventName) {
+        const subscribers = this.subscribers.get(eventName);
+        return subscribers ? subscribers.size : 0;
+    }
+    
+    /**
+     * Remove all subscribers for an event
+     */
+    removeAllListeners(eventName = null) {
+        if (eventName) {
+            this.subscribers.delete(eventName);
+        } else {
+            this.subscribers.clear();
+        }
+    }
+    
+    /**
+     * Destroy event bus
+     */
+    destroy() {
+        this.subscribers.clear();
+        this.history = [];
+        this.middleware = [];
+        
+        Logger.info('[EventBus] Destroyed');
+    }
+}
+
+/**
+ * Create a global event bus instance
+ */
+let globalEventBus = null;
+
+/**
+ * Get or create global event bus
+ */
+export function getGlobalEventBus(config = {}) {
+    if (!globalEventBus) {
+        globalEventBus = EventBus.create(config);
+    }
+    return globalEventBus;
+}
+
diff --git a/resources/js/modules/event-bus/index.js b/resources/js/modules/event-bus/index.js
new file mode 100644
index 00000000..9b1ce49d
--- /dev/null
+++ b/resources/js/modules/event-bus/index.js
@@ -0,0 +1,93 @@
+/**
+ * Event Bus Module
+ * 
+ * Provides centralized event system for cross-module communication.
+ * 
+ * Usage:
+ * - Add data-module="event-bus" to enable global event bus
+ * - Or import and use directly: import { EventBus } from './modules/event-bus/index.js'
+ * 
+ * Features:
+ * - Pub/sub pattern
+ * - Namespaced events
+ * - Event filtering
+ * - Event history
+ * - Integration with LiveComponents
+ * - Integration with SSE
+ */
+
+import { Logger } from '../../core/logger.js';
+import { EventBus, getGlobalEventBus } from './EventBus.js';
+
+const EventBusModule = {
+    name: 'event-bus',
+    eventBus: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[EventBusModule] Module initialized');
+        
+        // Create global event bus
+        this.eventBus = getGlobalEventBus(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.EventBus = this.eventBus;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get event bus instance
+     */
+    getEventBus() {
+        return this.eventBus || getGlobalEventBus();
+    },
+    
+    /**
+     * Emit an event
+     */
+    emit(eventName, data = null, options = {}) {
+        const bus = this.getEventBus();
+        bus.emit(eventName, data, options);
+    },
+    
+    /**
+     * Subscribe to an event
+     */
+    on(eventName, callback, options = {}) {
+        const bus = this.getEventBus();
+        return bus.on(eventName, callback, options);
+    },
+    
+    /**
+     * Unsubscribe from an event
+     */
+    off(eventName, callback) {
+        const bus = this.getEventBus();
+        bus.off(eventName, callback);
+    },
+    
+    destroy() {
+        if (this.eventBus) {
+            this.eventBus.destroy();
+            this.eventBus = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.EventBus) {
+            delete window.EventBus;
+        }
+        
+        Logger.info('[EventBusModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { EventBus, getGlobalEventBus };
+
+// Export as default for module system
+export default EventBusModule;
+
+// Export init function for module system
+export const init = EventBusModule.init.bind(EventBusModule);
+
diff --git a/resources/js/modules/form-autosave.js b/resources/js/modules/form-autosave.js
index b7a7dec6..d596fae7 100644
--- a/resources/js/modules/form-autosave.js
+++ b/resources/js/modules/form-autosave.js
@@ -1,674 +1,53 @@
+import { FormHandler } from './form-handling/FormHandler.js';
+import { Logger } from '../core/logger.js';
+
 /**
- * Form Auto-Save System
+ * FormAutoSave - Wrapper for FormHandler autosave functionality
  * 
- * Automatically saves form data to localStorage and restores it when the user
- * returns to the page. Helps prevent data loss from browser crashes, accidental
- * navigation, network issues, or other interruptions.
- * 
- * Features:
- * - Automatic saving every 30 seconds
- * - Smart field change detection
- * - Secure storage (excludes passwords and sensitive data)
- * - Configurable retention period (default 24 hours)
- * - Visual indicators when data is saved/restored
- * - Privacy-conscious (excludes honeypot fields)
- * - Multiple form support
- * - Graceful cleanup of expired drafts
- * 
- * Usage:
- * import { FormAutoSave } from './modules/form-autosave.js';
- * 
- * // Initialize for specific form
- * const autosave = new FormAutoSave({
- *     formSelector: '#contact-form',
- *     storageKey: 'contact_form_draft'
- * });
- * 
- * // Or auto-initialize all forms
- * FormAutoSave.initializeAll();
+ * This module provides a simple interface to initialize autosave
+ * for all forms on the page. The actual autosave logic is implemented
+ * in FormHandler.
  */
-
 export class FormAutoSave {
-
     /**
-     * Default configuration
+     * Initialize autosave for all forms on the page
+     * @param {Object} options - Options for autosave initialization
+     * @returns {Array} Array of initialized FormHandler instances
      */
-    static DEFAULT_CONFIG = {
-        formSelector: 'form[data-autosave]',
-        saveInterval: 30000, // 30 seconds
-        retentionPeriod: 24 * 60 * 60 * 1000, // 24 hours
-        storagePrefix: 'form_draft_',
-        enableVisualFeedback: true,
-        enableConsoleLogging: true,
-        
-        // Security settings
-        excludeFields: [
-            'input[type="password"]',
-            'input[type="hidden"][name="_token"]',
-            'input[type="hidden"][name="_form_id"]',
-            'input[name*="password"]',
-            'input[name*="confirm"]',
-            'input[name*="honeypot"]',
-            'input[name="email_confirm"]',
-            'input[name="website_url"]',
-            'input[name="user_name"]',
-            'input[name="company_name"]'
-        ],
-        
-        // Fields that trigger immediate save (important fields)
-        immediateFields: [
-            'textarea',
-            'input[type="email"]',
-            'input[type="text"]',
-            'select'
-        ],
-        
-        // Cleanup settings
-        maxDraftAge: 7 * 24 * 60 * 60 * 1000, // 7 days max storage
-        cleanupOnInit: true
-    };
-
-    /**
-     * @param {Object} config Configuration options
-     */
-    constructor(config = {}) {
-        this.config = { ...FormAutoSave.DEFAULT_CONFIG, ...config };
-        this.form = null;
-        this.storageKey = null;
-        this.saveTimer = null;
-        this.lastSaveTime = null;
-        this.hasChanges = false;
-        this.isInitialized = false;
-        this.fieldValues = new Map();
-
-        this.log('FormAutoSave initializing', this.config);
-        
-        // Initialize the form
-        this.initialize();
-    }
-
-    /**
-     * Initialize the autosave system for the form
-     */
-    initialize() {
-        // Find the form
-        this.form = document.querySelector(this.config.formSelector);
-        
-        if (!this.form) {
-            this.log('Form not found with selector:', this.config.formSelector);
-            return;
-        }
-
-        // Generate storage key based on form or use provided key
-        this.storageKey = this.config.storageKey || 
-            this.config.storagePrefix + this.generateFormId();
-
-        this.log('Form found, storage key:', this.storageKey);
-
-        // Cleanup old drafts if enabled
-        if (this.config.cleanupOnInit) {
-            this.cleanupExpiredDrafts();
-        }
-
-        // Setup event listeners
-        this.setupEventListeners();
-
-        // Store initial field values
-        this.storeInitialValues();
-
-        // Restore saved data
-        this.restoreDraft();
-
-        // Start periodic saving
-        this.startAutoSave();
-
-        this.isInitialized = true;
-        this.log('FormAutoSave initialized successfully');
-        
-        // Show status if enabled
-        if (this.config.enableVisualFeedback) {
-            this.showStatus('Auto-save enabled', 'info', 3000);
-        }
-    }
-
-    /**
-     * Generate a unique form identifier
-     */
-    generateFormId() {
-        // Try to get form ID from various sources
-        const formId = this.form.id || 
-                      this.form.getAttribute('data-form-id') ||
-                      this.form.querySelector('input[name="_form_id"]')?.value ||
-                      'form_' + Date.now();
-        
-        return formId.replace(/[^a-zA-Z0-9_-]/g, '_');
-    }
-
-    /**
-     * Setup form event listeners
-     */
-    setupEventListeners() {
-        // Listen for all input changes
-        this.form.addEventListener('input', (e) => {
-            this.onFieldChange(e);
-        });
-
-        this.form.addEventListener('change', (e) => {
-            this.onFieldChange(e);
-        });
-
-        // Listen for form submission to clear draft
-        this.form.addEventListener('submit', () => {
-            this.onFormSubmit();
-        });
-
-        // Save on page unload
-        window.addEventListener('beforeunload', () => {
-            if (this.hasChanges) {
-                this.saveDraft();
-            }
-        });
-
-        // Handle page visibility changes
-        document.addEventListener('visibilitychange', () => {
-            if (document.hidden && this.hasChanges) {
-                this.saveDraft();
-            }
-        });
-    }
-
-    /**
-     * Store initial field values to detect changes
-     */
-    storeInitialValues() {
-        const fields = this.getFormFields();
-        
-        fields.forEach(field => {
-            const key = this.getFieldKey(field);
-            const value = this.getFieldValue(field);
-            this.fieldValues.set(key, value);
-        });
-        
-        this.log(`Stored initial values for ${fields.length} fields`);
-    }
-
-    /**
-     * Handle field value changes
-     */
-    onFieldChange(event) {
-        const field = event.target;
-        
-        // Skip excluded fields
-        if (this.isFieldExcluded(field)) {
-            return;
-        }
-
-        const key = this.getFieldKey(field);
-        const newValue = this.getFieldValue(field);
-        const oldValue = this.fieldValues.get(key);
-
-        // Check if value actually changed
-        if (newValue !== oldValue) {
-            this.fieldValues.set(key, newValue);
-            this.hasChanges = true;
-
-            this.log(`Field changed: ${key} = "${newValue}"`);
-
-            // Save immediately for important fields
-            if (this.isImmediateField(field)) {
-                this.saveDraft();
-            }
-        }
-    }
-
-    /**
-     * Handle form submission
-     */
-    onFormSubmit() {
-        this.log('Form submitted, clearing draft');
-        this.clearDraft();
-        this.stopAutoSave();
-        
-        if (this.config.enableVisualFeedback) {
-            this.showStatus('Form submitted, draft cleared', 'success', 2000);
-        }
-    }
-
-    /**
-     * Start periodic auto-save
-     */
-    startAutoSave() {
-        if (this.saveTimer) {
-            return;
-        }
-
-        this.saveTimer = setInterval(() => {
-            if (this.hasChanges) {
-                this.saveDraft();
-            }
-        }, this.config.saveInterval);
-
-        this.log(`Auto-save started, interval: ${this.config.saveInterval}ms`);
-    }
-
-    /**
-     * Stop periodic auto-save
-     */
-    stopAutoSave() {
-        if (this.saveTimer) {
-            clearInterval(this.saveTimer);
-            this.saveTimer = null;
-            this.log('Auto-save stopped');
-        }
-    }
-
-    /**
-     * Save current form data as draft
-     */
-    saveDraft() {
-        if (!this.form || !this.hasChanges) {
-            return;
-        }
-
-        try {
-            const formData = this.extractFormData();
-            
-            const draft = {
-                data: formData,
-                timestamp: Date.now(),
-                formId: this.generateFormId(),
-                url: window.location.href,
-                version: '1.0'
-            };
-
-            localStorage.setItem(this.storageKey, JSON.stringify(draft));
-            
-            this.lastSaveTime = new Date();
-            this.hasChanges = false;
-            
-            this.log('Draft saved', {
-                fields: Object.keys(formData).length,
-                size: JSON.stringify(draft).length + ' chars'
-            });
-
-            if (this.config.enableVisualFeedback) {
-                this.showStatus('Draft saved', 'success', 1500);
-            }
-
-        } catch (error) {
-            console.error('Failed to save form draft:', error);
-            
-            if (this.config.enableVisualFeedback) {
-                this.showStatus('Failed to save draft', 'error', 3000);
-            }
-        }
-    }
-
-    /**
-     * Restore draft data to form
-     */
-    restoreDraft() {
-        try {
-            const draftJson = localStorage.getItem(this.storageKey);
-            
-            if (!draftJson) {
-                this.log('No draft found');
-                return;
-            }
-
-            const draft = JSON.parse(draftJson);
-            
-            // Check if draft is expired
-            if (this.isDraftExpired(draft)) {
-                this.log('Draft expired, removing');
-                localStorage.removeItem(this.storageKey);
-                return;
-            }
-
-            // Check if draft is from same form/URL (optional)
-            if (draft.url && draft.url !== window.location.href) {
-                this.log('Draft from different URL, skipping restore');
-                return;
-            }
-
-            // Restore form data
-            this.restoreFormData(draft.data);
-            
-            const age = this.formatDuration(Date.now() - draft.timestamp);
-            this.log(`Draft restored (age: ${age})`, draft.data);
-
-            if (this.config.enableVisualFeedback) {
-                this.showStatus(`Draft restored from ${age} ago`, 'info', 4000);
-            }
-
-        } catch (error) {
-            console.error('Failed to restore draft:', error);
-            // Remove corrupted draft
-            localStorage.removeItem(this.storageKey);
-        }
-    }
-
-    /**
-     * Extract form data (excluding sensitive fields)
-     */
-    extractFormData() {
-        const fields = this.getFormFields();
-        const data = {};
-
-        fields.forEach(field => {
-            if (!this.isFieldExcluded(field)) {
-                const key = this.getFieldKey(field);
-                const value = this.getFieldValue(field);
-                
-                if (value !== null && value !== undefined && value !== '') {
-                    data[key] = value;
-                }
-            }
-        });
-
-        return data;
-    }
-
-    /**
-     * Restore data to form fields
-     */
-    restoreFormData(data) {
-        let restoredCount = 0;
-
-        Object.entries(data).forEach(([key, value]) => {
-            const field = this.findFieldByKey(key);
-            
-            if (field && !this.isFieldExcluded(field)) {
-                this.setFieldValue(field, value);
-                this.fieldValues.set(key, value);
-                restoredCount++;
-            }
-        });
-
-        this.log(`Restored ${restoredCount} field values`);
-        
-        // Trigger change events for any listeners
-        const fields = this.getFormFields();
-        fields.forEach(field => {
-            if (!this.isFieldExcluded(field)) {
-                field.dispatchEvent(new Event('change', { bubbles: true }));
-            }
-        });
-
-        return restoredCount;
-    }
-
-    /**
-     * Get all form fields
-     */
-    getFormFields() {
-        return Array.from(this.form.querySelectorAll(
-            'input:not([type="submit"]):not([type="button"]):not([type="reset"]), ' +
-            'textarea, select'
-        ));
-    }
-
-    /**
-     * Check if field should be excluded from saving
-     */
-    isFieldExcluded(field) {
-        return this.config.excludeFields.some(selector => 
-            field.matches(selector)
-        );
-    }
-
-    /**
-     * Check if field should trigger immediate save
-     */
-    isImmediateField(field) {
-        return this.config.immediateFields.some(selector => 
-            field.matches(selector)
-        );
-    }
-
-    /**
-     * Generate unique key for field
-     */
-    getFieldKey(field) {
-        return field.name || field.id || `field_${field.type}_${Date.now()}`;
-    }
-
-    /**
-     * Get field value based on field type
-     */
-    getFieldValue(field) {
-        switch (field.type) {
-            case 'checkbox':
-                return field.checked;
-            case 'radio':
-                return field.checked ? field.value : null;
-            case 'file':
-                return null; // Don't save file inputs
-            default:
-                return field.value;
-        }
-    }
-
-    /**
-     * Set field value based on field type
-     */
-    setFieldValue(field, value) {
-        switch (field.type) {
-            case 'checkbox':
-                field.checked = Boolean(value);
-                break;
-            case 'radio':
-                field.checked = (field.value === value);
-                break;
-            case 'file':
-                // Can't restore file inputs
-                break;
-            default:
-                field.value = value;
-                break;
-        }
-    }
-
-    /**
-     * Find field by key
-     */
-    findFieldByKey(key) {
-        return this.form.querySelector(`[name="${key}"], #${key}`);
-    }
-
-    /**
-     * Check if draft has expired
-     */
-    isDraftExpired(draft) {
-        const age = Date.now() - draft.timestamp;
-        return age > this.config.retentionPeriod;
-    }
-
-    /**
-     * Clear the current draft
-     */
-    clearDraft() {
-        localStorage.removeItem(this.storageKey);
-        this.hasChanges = false;
-        this.log('Draft cleared');
-    }
-
-    /**
-     * Cleanup all expired drafts
-     */
-    cleanupExpiredDrafts() {
-        let cleaned = 0;
-        const prefix = this.config.storagePrefix;
-
-        for (let i = localStorage.length - 1; i >= 0; i--) {
-            const key = localStorage.key(i);
-            
-            if (key && key.startsWith(prefix)) {
-                try {
-                    const draft = JSON.parse(localStorage.getItem(key));
-                    const age = Date.now() - draft.timestamp;
-                    
-                    if (age > this.config.maxDraftAge) {
-                        localStorage.removeItem(key);
-                        cleaned++;
-                    }
-                } catch (error) {
-                    // Remove corrupted entries
-                    localStorage.removeItem(key);
-                    cleaned++;
-                }
-            }
-        }
-
-        if (cleaned > 0) {
-            this.log(`Cleaned up ${cleaned} expired drafts`);
-        }
-    }
-
-    /**
-     * Format duration for human reading
-     */
-    formatDuration(ms) {
-        const seconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        
-        if (hours > 0) {
-            return `${hours}h ${minutes % 60}m`;
-        } else if (minutes > 0) {
-            return `${minutes}m`;
-        } else {
-            return `${seconds}s`;
-        }
-    }
-
-    /**
-     * Show visual status message
-     */
-    showStatus(message, type = 'info', duration = 3000) {
-        // Create or update status element
-        let statusEl = document.getElementById('form-autosave-status');
-        
-        if (!statusEl) {
-            statusEl = document.createElement('div');
-            statusEl.id = 'form-autosave-status';
-            statusEl.style.cssText = `
-                position: fixed;
-                bottom: 20px;
-                right: 20px;
-                padding: 8px 12px;
-                border-radius: 4px;
-                font-size: 12px;
-                z-index: 9999;
-                max-width: 250px;
-                box-shadow: 0 2px 8px rgba(0,0,0,0.1);
-                transition: opacity 0.3s ease;
-                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-            `;
-            document.body.appendChild(statusEl);
-        }
-
-        statusEl.textContent = message;
-        statusEl.className = `autosave-status-${type}`;
-        
-        const styles = {
-            info: 'background: #e3f2fd; color: #1565c0; border: 1px solid #bbdefb;',
-            success: 'background: #e8f5e8; color: #2e7d32; border: 1px solid #c8e6c9;',
-            error: 'background: #ffebee; color: #c62828; border: 1px solid #ffcdd2;'
-        };
-        
-        statusEl.style.cssText += styles[type] || styles.info;
-        statusEl.style.opacity = '1';
-
-        setTimeout(() => {
-            if (statusEl) {
-                statusEl.style.opacity = '0';
-                setTimeout(() => {
-                    if (statusEl && statusEl.parentNode) {
-                        statusEl.parentNode.removeChild(statusEl);
-                    }
-                }, 300);
-            }
-        }, duration);
-    }
-
-    /**
-     * Log messages if console logging is enabled
-     */
-    log(message, data = null) {
-        if (this.config.enableConsoleLogging) {
-            const timestamp = new Date().toLocaleTimeString();
-            const prefix = `[${timestamp}] FormAutoSave`;
-            
-            if (data) {
-                console.log(`${prefix}: ${message}`, data);
-            } else {
-                console.log(`${prefix}: ${message}`);
-            }
-        }
-    }
-
-    /**
-     * Get current status
-     */
-    getStatus() {
-        return {
-            isInitialized: this.isInitialized,
-            formId: this.generateFormId(),
-            storageKey: this.storageKey,
-            hasChanges: this.hasChanges,
-            lastSaveTime: this.lastSaveTime,
-            fieldCount: this.fieldValues.size,
-            draftExists: !!localStorage.getItem(this.storageKey)
-        };
-    }
-
-    /**
-     * Manual save (for debugging/testing)
-     */
-    forceSave() {
-        this.hasChanges = true;
-        this.saveDraft();
-    }
-
-    /**
-     * Destroy the autosave instance
-     */
-    destroy() {
-        this.stopAutoSave();
-        this.isInitialized = false;
-        this.log('FormAutoSave destroyed');
-    }
-
-    /**
-     * Static method to initialize all forms with autosave
-     */
-    static initializeAll() {
-        const forms = document.querySelectorAll('form[data-autosave], form:has(input[name="_token"])');
+    static initializeAll(options = {}) {
+        const forms = document.querySelectorAll('form[data-autosave]');
         const instances = [];
 
-        forms.forEach((form, index) => {
-            const formId = form.id || 
-                          form.getAttribute('data-form-id') || 
-                          form.querySelector('input[name="_form_id"]')?.value ||
-                          `form_${index}`;
-
-            const instance = new FormAutoSave({
-                formSelector: `#${form.id || 'form_' + index}`,
-                storageKey: `form_draft_${formId}`
-            });
-
-            if (!form.id) {
-                form.id = `form_${index}`;
+        forms.forEach(form => {
+            try {
+                const handler = FormHandler.create(form, {
+                    enableAutosave: true,
+                    ...options
+                });
+                instances.push(handler);
+            } catch (error) {
+                Logger.error('[FormAutoSave] Failed to initialize autosave for form', {
+                    form: form.id || 'unnamed',
+                    error
+                });
             }
-
-            instances.push(instance);
         });
 
-        console.log(`FormAutoSave: Initialized for ${instances.length} forms`);
+        Logger.info(`[FormAutoSave] Initialized autosave for ${instances.length} forms`);
         return instances;
     }
+
+    /**
+     * Initialize autosave for a specific form
+     * @param {HTMLFormElement} form - The form element
+     * @param {Object} options - Options for autosave
+     * @returns {FormHandler} The FormHandler instance
+     */
+    static initialize(form, options = {}) {
+        return FormHandler.create(form, {
+            enableAutosave: true,
+            ...options
+        });
+    }
 }
 
-// Export for manual usage
-export default FormAutoSave;
\ No newline at end of file
diff --git a/resources/js/modules/form-handling/FormHandler.js b/resources/js/modules/form-handling/FormHandler.js
index 07f79547..208b3c43 100644
--- a/resources/js/modules/form-handling/FormHandler.js
+++ b/resources/js/modules/form-handling/FormHandler.js
@@ -13,6 +13,27 @@ export class FormHandler {
             preventSubmitOnError: true,
             submitMethod: 'POST',
             ajaxSubmit: true,
+            // Autosave options
+            enableAutosave: options.enableAutosave ?? form.hasAttribute('data-autosave'),
+            autosaveInterval: options.autosaveInterval || 30000, // 30 seconds
+            autosaveRetentionPeriod: options.autosaveRetentionPeriod || 24 * 60 * 60 * 1000, // 24 hours
+            autosaveStorageKey: options.autosaveStorageKey || null,
+            autosaveStoragePrefix: options.autosaveStoragePrefix || 'form_draft_',
+            autosaveVisualFeedback: options.autosaveVisualFeedback ?? true,
+            autosaveExcludeFields: options.autosaveExcludeFields || [
+                'input[type="password"]',
+                'input[type="hidden"][name="_token"]',
+                'input[type="hidden"][name="_form_id"]',
+                'input[name*="password"]',
+                'input[name*="confirm"]',
+                'input[name*="honeypot"]'
+            ],
+            autosaveImmediateFields: options.autosaveImmediateFields || [
+                'textarea',
+                'input[type="email"]',
+                'input[type="text"]',
+                'select'
+            ],
             ...options
         };
         
@@ -20,6 +41,11 @@ export class FormHandler {
         this.state = FormState.create(form);
         this.isSubmitting = false;
         
+        // Autosave state
+        this.autosaveTimer = null;
+        this.lastAutosaveTime = null;
+        this.autosaveStorageKey = null;
+        
         this.init();
     }
 
@@ -31,6 +57,11 @@ export class FormHandler {
         this.bindEvents();
         this.setupErrorDisplay();
         
+        // Initialize autosave if enabled
+        if (this.options.enableAutosave) {
+            this.initAutosave();
+        }
+        
         // Mark form as enhanced
         this.form.setAttribute('data-enhanced', 'true');
         
@@ -55,6 +86,26 @@ export class FormHandler {
                 }
             });
         }
+        
+        // Autosave events
+        if (this.options.enableAutosave) {
+            this.form.addEventListener('input', (e) => this.onAutosaveFieldChange(e));
+            this.form.addEventListener('change', (e) => this.onAutosaveFieldChange(e));
+            
+            // Save on page unload
+            window.addEventListener('beforeunload', () => {
+                if (this.state.isDirty()) {
+                    this.saveAutosaveDraft();
+                }
+            });
+            
+            // Handle page visibility changes
+            document.addEventListener('visibilitychange', () => {
+                if (document.hidden && this.state.isDirty()) {
+                    this.saveAutosaveDraft();
+                }
+            });
+        }
     }
 
     async handleSubmit(event) {
@@ -139,6 +190,11 @@ export class FormHandler {
     handleSuccess(data) {
         Logger.info('[FormHandler] Form submitted successfully');
         
+        // Clear autosave draft on successful submission
+        if (this.options.enableAutosave) {
+            this.clearAutosaveDraft();
+        }
+        
         // Clear form if configured
         if (data.clearForm !== false) {
             this.form.reset();
@@ -345,7 +401,351 @@ export class FormHandler {
         this.form.dispatchEvent(event);
     }
 
+    /**
+     * Initialize autosave functionality
+     */
+    initAutosave() {
+        // Generate storage key
+        this.autosaveStorageKey = this.options.autosaveStorageKey || 
+            this.options.autosaveStoragePrefix + this.generateFormId();
+        
+        // Restore draft on init
+        this.restoreAutosaveDraft();
+        
+        // Start periodic autosave
+        this.startAutosave();
+        
+        Logger.info('[FormHandler] Autosave initialized', { storageKey: this.autosaveStorageKey });
+    }
+    
+    /**
+     * Generate unique form identifier
+     */
+    generateFormId() {
+        const formId = this.form.id || 
+                      this.form.getAttribute('data-form-id') ||
+                      this.form.querySelector('input[name="_form_id"]')?.value ||
+                      'form_' + Date.now();
+        
+        return formId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    }
+    
+    /**
+     * Handle field change for autosave
+     */
+    onAutosaveFieldChange(event) {
+        const field = event.target;
+        
+        // Skip excluded fields
+        if (this.isAutosaveFieldExcluded(field)) {
+            return;
+        }
+        
+        // Save immediately for important fields
+        if (this.isAutosaveImmediateField(field)) {
+            this.saveAutosaveDraft();
+        }
+    }
+    
+    /**
+     * Check if field should be excluded from autosave
+     */
+    isAutosaveFieldExcluded(field) {
+        return this.options.autosaveExcludeFields.some(selector => 
+            field.matches(selector)
+        );
+    }
+    
+    /**
+     * Check if field should trigger immediate save
+     */
+    isAutosaveImmediateField(field) {
+        return this.options.autosaveImmediateFields.some(selector => 
+            field.matches(selector)
+        );
+    }
+    
+    /**
+     * Start periodic autosave
+     */
+    startAutosave() {
+        if (this.autosaveTimer) {
+            return;
+        }
+        
+        this.autosaveTimer = setInterval(() => {
+            if (this.state.isDirty()) {
+                this.saveAutosaveDraft();
+            }
+        }, this.options.autosaveInterval);
+        
+        Logger.debug('[FormHandler] Autosave started', { interval: this.options.autosaveInterval });
+    }
+    
+    /**
+     * Stop periodic autosave
+     */
+    stopAutosave() {
+        if (this.autosaveTimer) {
+            clearInterval(this.autosaveTimer);
+            this.autosaveTimer = null;
+        }
+    }
+    
+    /**
+     * Save form data as draft
+     */
+    saveAutosaveDraft() {
+        if (!this.form || !this.state.isDirty()) {
+            return;
+        }
+        
+        try {
+            const formData = this.extractAutosaveFormData();
+            
+            const draft = {
+                data: formData,
+                timestamp: Date.now(),
+                formId: this.generateFormId(),
+                url: window.location.href,
+                version: '1.0'
+            };
+            
+            localStorage.setItem(this.autosaveStorageKey, JSON.stringify(draft));
+            
+            this.lastAutosaveTime = new Date();
+            
+            Logger.debug('[FormHandler] Draft saved', {
+                fields: Object.keys(formData).length,
+                storageKey: this.autosaveStorageKey
+            });
+            
+            if (this.options.autosaveVisualFeedback) {
+                this.showAutosaveStatus('Draft saved', 'success', 1500);
+            }
+            
+            // Trigger event
+            this.triggerEvent('form:autosave', { draft });
+        } catch (error) {
+            Logger.error('[FormHandler] Failed to save draft', error);
+            
+            if (this.options.autosaveVisualFeedback) {
+                this.showAutosaveStatus('Failed to save draft', 'error', 3000);
+            }
+        }
+    }
+    
+    /**
+     * Restore draft data to form
+     */
+    restoreAutosaveDraft() {
+        try {
+            const draftJson = localStorage.getItem(this.autosaveStorageKey);
+            
+            if (!draftJson) {
+                return;
+            }
+            
+            const draft = JSON.parse(draftJson);
+            
+            // Check if draft is expired
+            const age = Date.now() - draft.timestamp;
+            if (age > this.options.autosaveRetentionPeriod) {
+                localStorage.removeItem(this.autosaveStorageKey);
+                return;
+            }
+            
+            // Restore form data
+            this.restoreAutosaveFormData(draft.data);
+            
+            Logger.info('[FormHandler] Draft restored', {
+                age: Math.floor(age / 1000) + 's',
+                fields: Object.keys(draft.data).length
+            });
+            
+            if (this.options.autosaveVisualFeedback) {
+                const ageText = this.formatDuration(age);
+                this.showAutosaveStatus(`Draft restored from ${ageText} ago`, 'info', 4000);
+            }
+            
+            // Trigger event
+            this.triggerEvent('form:autosave-restored', { draft });
+        } catch (error) {
+            Logger.error('[FormHandler] Failed to restore draft', error);
+            localStorage.removeItem(this.autosaveStorageKey);
+        }
+    }
+    
+    /**
+     * Extract form data for autosave (excluding sensitive fields)
+     */
+    extractAutosaveFormData() {
+        const fields = this.getFormFields();
+        const data = {};
+        
+        fields.forEach(field => {
+            if (!this.isAutosaveFieldExcluded(field)) {
+                const key = field.name || field.id;
+                const value = this.getAutosaveFieldValue(field);
+                
+                if (key && value !== null && value !== undefined && value !== '') {
+                    data[key] = value;
+                }
+            }
+        });
+        
+        return data;
+    }
+    
+    /**
+     * Restore data to form fields
+     */
+    restoreAutosaveFormData(data) {
+        let restoredCount = 0;
+        
+        Object.entries(data).forEach(([key, value]) => {
+            const field = this.form.querySelector(`[name="${key}"], #${key}`);
+            
+            if (field && !this.isAutosaveFieldExcluded(field)) {
+                this.setAutosaveFieldValue(field, value);
+                restoredCount++;
+            }
+        });
+        
+        // Update form state
+        this.state.captureInitialValues();
+        
+        return restoredCount;
+    }
+    
+    /**
+     * Get form fields
+     */
+    getFormFields() {
+        return Array.from(this.form.querySelectorAll(
+            'input:not([type="submit"]):not([type="button"]):not([type="reset"]), ' +
+            'textarea, select'
+        ));
+    }
+    
+    /**
+     * Get field value for autosave
+     */
+    getAutosaveFieldValue(field) {
+        switch (field.type) {
+            case 'checkbox':
+                return field.checked;
+            case 'radio':
+                return field.checked ? field.value : null;
+            case 'file':
+                return null; // Don't save file inputs
+            default:
+                return field.value;
+        }
+    }
+    
+    /**
+     * Set field value for autosave
+     */
+    setAutosaveFieldValue(field, value) {
+        switch (field.type) {
+            case 'checkbox':
+                field.checked = Boolean(value);
+                break;
+            case 'radio':
+                field.checked = (field.value === value);
+                break;
+            case 'file':
+                // Can't restore file inputs
+                break;
+            default:
+                field.value = value;
+                break;
+        }
+    }
+    
+    /**
+     * Clear autosave draft
+     */
+    clearAutosaveDraft() {
+        if (this.autosaveStorageKey) {
+            localStorage.removeItem(this.autosaveStorageKey);
+        }
+        Logger.debug('[FormHandler] Draft cleared');
+    }
+    
+    /**
+     * Format duration for human reading
+     */
+    formatDuration(ms) {
+        const seconds = Math.floor(ms / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        } else if (minutes > 0) {
+            return `${minutes}m`;
+        } else {
+            return `${seconds}s`;
+        }
+    }
+    
+    /**
+     * Show autosave status message
+     */
+    showAutosaveStatus(message, type = 'info', duration = 3000) {
+        // Create or update status element
+        let statusEl = document.getElementById('form-autosave-status');
+        
+        if (!statusEl) {
+            statusEl = document.createElement('div');
+            statusEl.id = 'form-autosave-status';
+            statusEl.style.cssText = `
+                position: fixed;
+                bottom: 20px;
+                right: 20px;
+                padding: 8px 12px;
+                border-radius: 4px;
+                font-size: 12px;
+                z-index: 9999;
+                max-width: 250px;
+                box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+                transition: opacity 0.3s ease;
+                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            `;
+            document.body.appendChild(statusEl);
+        }
+        
+        statusEl.textContent = message;
+        
+        const styles = {
+            info: 'background: #e3f2fd; color: #1565c0; border: 1px solid #bbdefb;',
+            success: 'background: #e8f5e8; color: #2e7d32; border: 1px solid #c8e6c9;',
+            error: 'background: #ffebee; color: #c62828; border: 1px solid #ffcdd2;'
+        };
+        
+        statusEl.style.cssText += styles[type] || styles.info;
+        statusEl.style.opacity = '1';
+        
+        setTimeout(() => {
+            if (statusEl) {
+                statusEl.style.opacity = '0';
+                setTimeout(() => {
+                    if (statusEl && statusEl.parentNode) {
+                        statusEl.parentNode.removeChild(statusEl);
+                    }
+                }, 300);
+            }
+        }, duration);
+    }
+    
     destroy() {
+        // Stop autosave
+        if (this.options.enableAutosave) {
+            this.stopAutosave();
+        }
+        
         // Remove event listeners and clean up
         this.form.removeAttribute('data-enhanced');
         Logger.info('[FormHandler] Destroyed');
diff --git a/resources/js/modules/livecomponent/ActionLoadingManager.js b/resources/js/modules/livecomponent/ActionLoadingManager.js
new file mode 100644
index 00000000..9c603fe2
--- /dev/null
+++ b/resources/js/modules/livecomponent/ActionLoadingManager.js
@@ -0,0 +1,256 @@
+/**
+ * Action Loading Manager for LiveComponents
+ * 
+ * Provides skeleton loading states during component actions with:
+ * - Automatic skeleton overlay during actions
+ * - Configurable skeleton templates per component
+ * - Smooth transitions
+ * - Fragment-aware loading
+ */
+
+export class ActionLoadingManager {
+    constructor() {
+        this.loadingStates = new Map(); // componentId → loading state
+        this.skeletonTemplates = new Map(); // componentId → template
+        this.config = {
+            showDelay: 150, // ms before showing skeleton
+            transitionDuration: 200, // ms for transitions
+            preserveContent: true, // Keep content visible under skeleton
+            opacity: 0.6 // Skeleton overlay opacity
+        };
+    }
+
+    /**
+     * Show loading state for component
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Object} options - Loading options
+     */
+    showLoading(componentId, element, options = {}) {
+        // Check if already loading
+        if (this.loadingStates.has(componentId)) {
+            return; // Already showing loading state
+        }
+
+        const showDelay = options.showDelay ?? this.config.showDelay;
+        const fragments = options.fragments || null;
+
+        // Delay showing skeleton (for fast responses)
+        const timeoutId = setTimeout(() => {
+            this.createSkeletonOverlay(componentId, element, fragments, options);
+        }, showDelay);
+
+        // Store loading state
+        this.loadingStates.set(componentId, {
+            timeoutId,
+            element,
+            fragments,
+            options
+        });
+    }
+
+    /**
+     * Create skeleton overlay
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Array<string>|null} fragments - Fragment names to show skeleton for
+     * @param {Object} options - Options
+     */
+    createSkeletonOverlay(componentId, element, fragments, options) {
+        // Get skeleton template
+        const template = this.getSkeletonTemplate(componentId, element, fragments);
+
+        // Create overlay container
+        const overlay = document.createElement('div');
+        overlay.className = 'livecomponent-loading-overlay';
+        overlay.setAttribute('data-component-id', componentId);
+        overlay.setAttribute('aria-busy', 'true');
+        overlay.setAttribute('aria-label', 'Loading...');
+
+        overlay.style.cssText = `
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background: rgba(255, 255, 255, ${this.config.opacity});
+            z-index: 10;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            opacity: 0;
+            transition: opacity ${this.config.transitionDuration}ms ease;
+            pointer-events: none;
+        `;
+
+        // Add skeleton content
+        overlay.innerHTML = template;
+
+        // Ensure element has relative positioning
+        const originalPosition = element.style.position;
+        if (getComputedStyle(element).position === 'static') {
+            element.style.position = 'relative';
+        }
+
+        // Append overlay
+        element.appendChild(overlay);
+
+        // Animate in
+        requestAnimationFrame(() => {
+            overlay.style.opacity = '1';
+        });
+
+        // Update loading state
+        const state = this.loadingStates.get(componentId);
+        if (state) {
+            state.overlay = overlay;
+            state.originalPosition = originalPosition;
+        }
+    }
+
+    /**
+     * Get skeleton template for component
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Array<string>|null} fragments - Fragment names
+     * @returns {string} Skeleton HTML
+     */
+    getSkeletonTemplate(componentId, element, fragments) {
+        // Check for custom template
+        const customTemplate = this.skeletonTemplates.get(componentId);
+        if (customTemplate) {
+            return typeof customTemplate === 'function' 
+                ? customTemplate(element, fragments)
+                : customTemplate;
+        }
+
+        // If fragments specified, create fragment-specific skeletons
+        if (fragments && fragments.length > 0) {
+            return this.createFragmentSkeletons(fragments);
+        }
+
+        // Default skeleton template
+        return this.createDefaultSkeleton(element);
+    }
+
+    /**
+     * Create default skeleton template
+     * 
+     * @param {HTMLElement} element - Component element
+     * @returns {string} Skeleton HTML
+     */
+    createDefaultSkeleton(element) {
+        const height = element.offsetHeight || 200;
+        const width = element.offsetWidth || '100%';
+
+        return `
+            <div class="skeleton-container" style="width: ${width}; height: ${height}px; padding: 1.5rem;">
+                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 1rem;"></div>
+                <div class="skeleton skeleton-text skeleton-text--80" style="margin-bottom: 0.75rem;"></div>
+                <div class="skeleton skeleton-text skeleton-text--60" style="margin-bottom: 0.75rem;"></div>
+                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 1rem;"></div>
+                <div class="skeleton skeleton-text skeleton-text--80"></div>
+            </div>
+        `;
+    }
+
+    /**
+     * Create fragment-specific skeletons
+     * 
+     * @param {Array<string>} fragments - Fragment names
+     * @returns {string} Skeleton HTML
+     */
+    createFragmentSkeletons(fragments) {
+        return fragments.map(fragmentName => `
+            <div class="skeleton-fragment" data-fragment="${fragmentName}">
+                <div class="skeleton skeleton-text skeleton-text--full" style="margin-bottom: 0.75rem;"></div>
+                <div class="skeleton skeleton-text skeleton-text--80"></div>
+            </div>
+        `).join('');
+    }
+
+    /**
+     * Hide loading state
+     * 
+     * @param {string} componentId - Component ID
+     */
+    hideLoading(componentId) {
+        const state = this.loadingStates.get(componentId);
+        if (!state) {
+            return;
+        }
+
+        // Clear timeout if not yet shown
+        if (state.timeoutId) {
+            clearTimeout(state.timeoutId);
+        }
+
+        // Remove overlay if exists
+        if (state.overlay) {
+            // Animate out
+            state.overlay.style.opacity = '0';
+
+            setTimeout(() => {
+                if (state.overlay && state.overlay.parentNode) {
+                    state.overlay.parentNode.removeChild(state.overlay);
+                }
+            }, this.config.transitionDuration);
+        }
+
+        // Restore original position
+        if (state.originalPosition !== undefined) {
+            state.element.style.position = state.originalPosition;
+        }
+
+        // Remove from map
+        this.loadingStates.delete(componentId);
+    }
+
+    /**
+     * Register custom skeleton template for component
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string|Function} template - Template HTML or function that returns HTML
+     */
+    registerTemplate(componentId, template) {
+        this.skeletonTemplates.set(componentId, template);
+    }
+
+    /**
+     * Unregister skeleton template
+     * 
+     * @param {string} componentId - Component ID
+     */
+    unregisterTemplate(componentId) {
+        this.skeletonTemplates.delete(componentId);
+    }
+
+    /**
+     * Check if component is loading
+     * 
+     * @param {string} componentId - Component ID
+     * @returns {boolean} True if loading
+     */
+    isLoading(componentId) {
+        return this.loadingStates.has(componentId);
+    }
+
+    /**
+     * Update configuration
+     * 
+     * @param {Object} newConfig - New configuration
+     */
+    updateConfig(newConfig) {
+        this.config = {
+            ...this.config,
+            ...newConfig
+        };
+    }
+}
+
+// Create singleton instance
+export const actionLoadingManager = new ActionLoadingManager();
+
diff --git a/resources/js/modules/livecomponent/ErrorBoundary.js b/resources/js/modules/livecomponent/ErrorBoundary.js
new file mode 100644
index 00000000..05f49ccb
--- /dev/null
+++ b/resources/js/modules/livecomponent/ErrorBoundary.js
@@ -0,0 +1,347 @@
+/**
+ * Error Boundary for LiveComponents
+ * 
+ * Provides automatic error handling, retry mechanisms, and error recovery
+ * for LiveComponent operations.
+ */
+
+// Note: LiveComponentError type is defined in types/livecomponent.d.ts
+// This is a runtime implementation, so we don't need to import the type
+
+export class ErrorBoundary {
+    constructor(liveComponentManager) {
+        this.manager = liveComponentManager;
+        this.retryStrategies = new Map();
+        this.errorHandlers = new Map();
+        this.maxRetries = 3;
+        this.retryDelays = [1000, 2000, 5000]; // Progressive backoff
+    }
+
+    /**
+     * Handle error from component action
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} action - Action method name
+     * @param {Error|LiveComponentError} error - Error object
+     * @param {Object} context - Additional context
+     * @returns {Promise<boolean>} True if error was handled, false otherwise
+     */
+    async handleError(componentId, action, error, context = {}) {
+        console.error(`[ErrorBoundary] Error in ${componentId}.${action}:`, error);
+
+        // Convert to standardized error format
+        const standardizedError = this.standardizeError(error, componentId, action);
+
+        // Check for custom error handler
+        const handler = this.errorHandlers.get(componentId);
+        if (handler) {
+            try {
+                const handled = await handler(standardizedError, context);
+                if (handled) {
+                    return true;
+                }
+            } catch (handlerError) {
+                console.error('[ErrorBoundary] Error handler failed:', handlerError);
+            }
+        }
+
+        // Check if error is retryable
+        if (this.isRetryable(standardizedError)) {
+            const retried = await this.retryOperation(componentId, action, context, standardizedError);
+            if (retried) {
+                return true;
+            }
+        }
+
+        // Show error to user
+        this.showError(componentId, standardizedError);
+
+        // Dispatch error event
+        this.dispatchErrorEvent(componentId, standardizedError);
+
+        return false;
+    }
+
+    /**
+     * Standardize error format
+     * 
+     * @param {Error|LiveComponentError|Object} error - Error object
+     * @param {string} componentId - Component ID
+     * @param {string} action - Action method name
+     * @returns {LiveComponentError} Standardized error
+     */
+    standardizeError(error, componentId, action) {
+        // If already standardized
+        if (error && typeof error === 'object' && 'code' in error && 'message' in error) {
+            return {
+                code: error.code,
+                message: error.message,
+                details: error.details || {},
+                componentId: error.componentId || componentId,
+                action: error.action || action,
+                timestamp: error.timestamp || Date.now()
+            };
+        }
+
+        // If Error object
+        if (error instanceof Error) {
+            return {
+                code: 'INTERNAL_ERROR',
+                message: error.message,
+                details: {
+                    stack: error.stack,
+                    name: error.name
+                },
+                componentId,
+                action,
+                timestamp: Date.now()
+            };
+        }
+
+        // If string
+        if (typeof error === 'string') {
+            return {
+                code: 'INTERNAL_ERROR',
+                message: error,
+                componentId,
+                action,
+                timestamp: Date.now()
+            };
+        }
+
+        // Default
+        return {
+            code: 'INTERNAL_ERROR',
+            message: 'An unknown error occurred',
+            details: { original: error },
+            componentId,
+            action,
+            timestamp: Date.now()
+        };
+    }
+
+    /**
+     * Check if error is retryable
+     * 
+     * @param {LiveComponentError} error - Standardized error
+     * @returns {boolean} True if error is retryable
+     */
+    isRetryable(error) {
+        const retryableCodes = [
+            'RATE_LIMIT_EXCEEDED',
+            'STATE_CONFLICT',
+            'INTERNAL_ERROR'
+        ];
+
+        return retryableCodes.includes(error.code);
+    }
+
+    /**
+     * Retry operation with exponential backoff
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} action - Action method name
+     * @param {Object} context - Operation context
+     * @param {LiveComponentError} error - Error that occurred
+     * @returns {Promise<boolean>} True if retry succeeded
+     */
+    async retryOperation(componentId, action, context, error) {
+        const retryKey = `${componentId}:${action}`;
+        const retryCount = this.retryStrategies.get(retryKey) || 0;
+
+        if (retryCount >= this.maxRetries) {
+            console.warn(`[ErrorBoundary] Max retries exceeded for ${retryKey}`);
+            this.retryStrategies.delete(retryKey);
+            return false;
+        }
+
+        // Calculate delay (progressive backoff)
+        const delay = this.retryDelays[retryCount] || this.retryDelays[this.retryDelays.length - 1];
+
+        console.log(`[ErrorBoundary] Retrying ${retryKey} in ${delay}ms (attempt ${retryCount + 1}/${this.maxRetries})`);
+
+        // Update retry count
+        this.retryStrategies.set(retryKey, retryCount + 1);
+
+        // Wait before retry
+        await new Promise(resolve => setTimeout(resolve, delay));
+
+        try {
+            // Retry the operation
+            const result = await this.manager.executeAction(
+                componentId,
+                action,
+                context.params || {},
+                context.fragments || null
+            );
+
+            // Success - clear retry count
+            this.retryStrategies.delete(retryKey);
+            console.log(`[ErrorBoundary] Retry succeeded for ${retryKey}`);
+            return true;
+
+        } catch (retryError) {
+            // Retry failed - will be handled by next retry or error handler
+            console.warn(`[ErrorBoundary] Retry failed for ${retryKey}:`, retryError);
+            return false;
+        }
+    }
+
+    /**
+     * Show error to user
+     * 
+     * @param {string} componentId - Component ID
+     * @param {LiveComponentError} error - Standardized error
+     */
+    showError(componentId, error) {
+        const config = this.manager.components.get(componentId);
+        if (!config) return;
+
+        // Remove existing error
+        const existingError = config.element.querySelector('.livecomponent-error-boundary');
+        if (existingError) {
+            existingError.remove();
+        }
+
+        // Create error element
+        const errorEl = document.createElement('div');
+        errorEl.className = 'livecomponent-error-boundary';
+        errorEl.style.cssText = `
+            padding: 1rem;
+            background: #fee;
+            color: #c00;
+            border: 1px solid #faa;
+            border-radius: 4px;
+            margin-bottom: 1rem;
+        `;
+
+        // Error message
+        const messageEl = document.createElement('div');
+        messageEl.style.fontWeight = 'bold';
+        messageEl.textContent = error.message;
+        errorEl.appendChild(messageEl);
+
+        // Error code (if not generic)
+        if (error.code !== 'INTERNAL_ERROR') {
+            const codeEl = document.createElement('div');
+            codeEl.style.fontSize = '0.875rem';
+            codeEl.style.marginTop = '0.5rem';
+            codeEl.style.color = '#666';
+            codeEl.textContent = `Error Code: ${error.code}`;
+            errorEl.appendChild(codeEl);
+        }
+
+        // Retry button (if retryable)
+        if (this.isRetryable(error)) {
+            const retryBtn = document.createElement('button');
+            retryBtn.textContent = 'Retry';
+            retryBtn.style.cssText = `
+                margin-top: 0.5rem;
+                padding: 0.5rem 1rem;
+                background: #c00;
+                color: white;
+                border: none;
+                border-radius: 4px;
+                cursor: pointer;
+            `;
+            retryBtn.addEventListener('click', async () => {
+                errorEl.remove();
+                await this.retryOperation(componentId, error.action || '', {}, error);
+            });
+            errorEl.appendChild(retryBtn);
+        }
+
+        // Close button
+        const closeBtn = document.createElement('button');
+        closeBtn.textContent = '×';
+        closeBtn.style.cssText = `
+            float: right;
+            background: transparent;
+            border: none;
+            font-size: 1.5rem;
+            cursor: pointer;
+            color: #c00;
+        `;
+        closeBtn.addEventListener('click', () => {
+            errorEl.remove();
+        });
+        errorEl.appendChild(closeBtn);
+
+        // Insert at top of component
+        config.element.insertAdjacentElement('afterbegin', errorEl);
+
+        // Auto-remove after 10 seconds
+        setTimeout(() => {
+            if (errorEl.parentNode) {
+                errorEl.remove();
+            }
+        }, 10000);
+    }
+
+    /**
+     * Dispatch error event
+     * 
+     * @param {string} componentId - Component ID
+     * @param {LiveComponentError} error - Standardized error
+     */
+    dispatchErrorEvent(componentId, error) {
+        // Dispatch custom DOM event
+        const event = new CustomEvent('livecomponent:error', {
+            detail: {
+                componentId,
+                error
+            },
+            bubbles: true
+        });
+
+        const config = this.manager.components.get(componentId);
+        if (config) {
+            config.element.dispatchEvent(event);
+        }
+
+        // Also dispatch on document
+        document.dispatchEvent(event);
+    }
+
+    /**
+     * Register custom error handler for component
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Function} handler - Error handler function
+     */
+    registerErrorHandler(componentId, handler) {
+        if (typeof handler !== 'function') {
+            throw new Error('Error handler must be a function');
+        }
+
+        this.errorHandlers.set(componentId, handler);
+    }
+
+    /**
+     * Clear error handler for component
+     * 
+     * @param {string} componentId - Component ID
+     */
+    clearErrorHandler(componentId) {
+        this.errorHandlers.delete(componentId);
+    }
+
+    /**
+     * Clear retry strategy for component/action
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} action - Action method name
+     */
+    clearRetryStrategy(componentId, action) {
+        const retryKey = `${componentId}:${action}`;
+        this.retryStrategies.delete(retryKey);
+    }
+
+    /**
+     * Reset all retry strategies
+     */
+    resetRetryStrategies() {
+        this.retryStrategies.clear();
+    }
+}
+
diff --git a/resources/js/modules/livecomponent/LazyComponentLoader.js b/resources/js/modules/livecomponent/LazyComponentLoader.js
index 37e952af..88c04253 100644
--- a/resources/js/modules/livecomponent/LazyComponentLoader.js
+++ b/resources/js/modules/livecomponent/LazyComponentLoader.js
@@ -226,7 +226,9 @@ export class LazyComponentLoader {
 
             // Copy state to element
             if (data.state) {
-                config.element.dataset.state = JSON.stringify(data.state);
+                // Use StateSerializer for type-safe state handling
+                const stateJson = JSON.stringify(data.state);
+                config.element.dataset.state = stateJson;
             }
 
             // Initialize as regular LiveComponent
diff --git a/resources/js/modules/livecomponent/LiveComponentUIHelper.js b/resources/js/modules/livecomponent/LiveComponentUIHelper.js
new file mode 100644
index 00000000..ced2323e
--- /dev/null
+++ b/resources/js/modules/livecomponent/LiveComponentUIHelper.js
@@ -0,0 +1,347 @@
+/**
+ * LiveComponent UI Helper
+ * 
+ * Provides unified API for UI components (Dialogs, Modals, Notifications)
+ * integrated with LiveComponents.
+ */
+
+import { UIManager } from '../ui/UIManager.js';
+
+export class LiveComponentUIHelper {
+    constructor(liveComponentManager) {
+        this.manager = liveComponentManager;
+        this.uiManager = UIManager;
+        this.activeDialogs = new Map(); // componentId → dialog instances
+        this.activeNotifications = new Map(); // componentId → notification instances
+    }
+
+    /**
+     * Show dialog from LiveComponent action
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Object} options - Dialog options
+     * @returns {Object} Dialog instance
+     */
+    showDialog(componentId, options = {}) {
+        const {
+            title = '',
+            content = '',
+            size = 'medium',
+            buttons = [],
+            closeOnBackdrop = true,
+            closeOnEscape = true,
+            onClose = null,
+            onConfirm = null
+        } = options;
+
+        // Create dialog content
+        const dialogContent = this.createDialogContent(title, content, buttons, {
+            onClose,
+            onConfirm
+        });
+
+        // Show modal via UIManager
+        const modal = this.uiManager.open('modal', {
+            content: dialogContent,
+            className: `livecomponent-dialog livecomponent-dialog--${size}`,
+            onClose: () => {
+                if (onClose) {
+                    onClose();
+                }
+                this.activeDialogs.delete(componentId);
+            }
+        });
+
+        // Store reference
+        this.activeDialogs.set(componentId, modal);
+
+        return modal;
+    }
+
+    /**
+     * Show confirmation dialog
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Object} options - Confirmation options
+     * @returns {Promise<boolean>} Promise resolving to true if confirmed
+     */
+    showConfirm(componentId, options = {}) {
+        return new Promise((resolve) => {
+            const {
+                title = 'Confirm',
+                message = 'Are you sure?',
+                confirmText = 'Confirm',
+                cancelText = 'Cancel',
+                confirmClass = 'btn-primary',
+                cancelClass = 'btn-secondary'
+            } = options;
+
+            const buttons = [
+                {
+                    text: cancelText,
+                    class: cancelClass,
+                    action: () => {
+                        this.closeDialog(componentId);
+                        resolve(false);
+                    }
+                },
+                {
+                    text: confirmText,
+                    class: confirmClass,
+                    action: () => {
+                        this.closeDialog(componentId);
+                        resolve(true);
+                    }
+                }
+            ];
+
+            this.showDialog(componentId, {
+                title,
+                content: `<p>${message}</p>`,
+                buttons,
+                size: 'small'
+            });
+        });
+    }
+
+    /**
+     * Show alert dialog
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Object} options - Alert options
+     */
+    showAlert(componentId, options = {}) {
+        const {
+            title = 'Alert',
+            message = '',
+            buttonText = 'OK',
+            type = 'info' // info, success, warning, error
+        } = options;
+
+        const buttons = [
+            {
+                text: buttonText,
+                class: `btn-${type}`,
+                action: () => {
+                    this.closeDialog(componentId);
+                }
+            }
+        ];
+
+        return this.showDialog(componentId, {
+            title,
+            content: `<p class="alert-message alert-message--${type}">${message}</p>`,
+            buttons,
+            size: 'small'
+        });
+    }
+
+    /**
+     * Close dialog
+     * 
+     * @param {string} componentId - Component ID
+     */
+    closeDialog(componentId) {
+        const dialog = this.activeDialogs.get(componentId);
+        if (dialog && typeof dialog.close === 'function') {
+            dialog.close();
+            this.activeDialogs.delete(componentId);
+        }
+    }
+
+    /**
+     * Show notification
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Object} options - Notification options
+     */
+    showNotification(componentId, options = {}) {
+        const {
+            message = '',
+            type = 'info', // info, success, warning, error
+            duration = 5000,
+            position = 'top-right',
+            action = null
+        } = options;
+
+        // Create notification element
+        const notification = document.createElement('div');
+        notification.className = `livecomponent-notification livecomponent-notification--${type} livecomponent-notification--${position}`;
+        notification.setAttribute('role', 'alert');
+        notification.setAttribute('aria-live', 'polite');
+
+        notification.innerHTML = `
+            <div class="notification-content">
+                <span class="notification-message">${message}</span>
+                ${action ? `<button class="notification-action">${action.text}</button>` : ''}
+                <button class="notification-close" aria-label="Close">×</button>
+            </div>
+        `;
+
+        // Add styles
+        notification.style.cssText = `
+            position: fixed;
+            ${position.includes('top') ? 'top' : 'bottom'}: 1rem;
+            ${position.includes('left') ? 'left' : 'right'}: 1rem;
+            max-width: 400px;
+            padding: 1rem;
+            background: ${this.getNotificationColor(type)};
+            color: white;
+            border-radius: 0.5rem;
+            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+            z-index: 10000;
+            opacity: 0;
+            transform: translateY(${position.includes('top') ? '-20px' : '20px'});
+            transition: opacity 0.3s ease, transform 0.3s ease;
+        `;
+
+        // Add to DOM
+        document.body.appendChild(notification);
+
+        // Animate in
+        requestAnimationFrame(() => {
+            notification.style.opacity = '1';
+            notification.style.transform = 'translateY(0)';
+        });
+
+        // Setup close button
+        const closeBtn = notification.querySelector('.notification-close');
+        closeBtn.addEventListener('click', () => {
+            this.hideNotification(notification);
+        });
+
+        // Setup action button
+        if (action) {
+            const actionBtn = notification.querySelector('.notification-action');
+            actionBtn.addEventListener('click', () => {
+                if (action.handler) {
+                    action.handler();
+                }
+                this.hideNotification(notification);
+            });
+        }
+
+        // Auto-hide after duration
+        if (duration > 0) {
+            setTimeout(() => {
+                this.hideNotification(notification);
+            }, duration);
+        }
+
+        // Store reference
+        this.activeNotifications.set(componentId, notification);
+
+        return notification;
+    }
+
+    /**
+     * Hide notification
+     * 
+     * @param {HTMLElement|string} notificationOrComponentId - Notification element or component ID
+     */
+    hideNotification(notificationOrComponentId) {
+        const notification = typeof notificationOrComponentId === 'string'
+            ? this.activeNotifications.get(notificationOrComponentId)
+            : notificationOrComponentId;
+
+        if (!notification) {
+            return;
+        }
+
+        // Animate out
+        notification.style.opacity = '0';
+        notification.style.transform = `translateY(${notification.classList.contains('livecomponent-notification--top') ? '-20px' : '20px'})`;
+
+        setTimeout(() => {
+            if (notification.parentNode) {
+                notification.parentNode.removeChild(notification);
+            }
+
+            // Remove from map
+            for (const [componentId, notif] of this.activeNotifications.entries()) {
+                if (notif === notification) {
+                    this.activeNotifications.delete(componentId);
+                    break;
+                }
+            }
+        }, 300);
+    }
+
+    /**
+     * Create dialog content HTML
+     * 
+     * @param {string} title - Dialog title
+     * @param {string} content - Dialog content
+     * @param {Array} buttons - Button configurations
+     * @param {Object} callbacks - Callback functions
+     * @returns {string} HTML content
+     */
+    createDialogContent(title, content, buttons, callbacks) {
+        const buttonsHtml = buttons.map((btn, index) => {
+            const btnClass = btn.class || 'btn-secondary';
+            const btnAction = btn.action || (() => {});
+            return `<button class="btn ${btnClass}" data-dialog-action="${index}">${btn.text || 'Button'}</button>`;
+        }).join('');
+
+        return `
+            <div class="livecomponent-dialog-content">
+                ${title ? `<div class="dialog-header"><h3>${title}</h3></div>` : ''}
+                <div class="dialog-body">${content}</div>
+                ${buttons.length > 0 ? `<div class="dialog-footer">${buttonsHtml}</div>` : ''}
+            </div>
+        `;
+    }
+
+    /**
+     * Get notification color by type
+     * 
+     * @param {string} type - Notification type
+     * @returns {string} Color value
+     */
+    getNotificationColor(type) {
+        const colors = {
+            info: '#3b82f6',
+            success: '#10b981',
+            warning: '#f59e0b',
+            error: '#ef4444'
+        };
+        return colors[type] || colors.info;
+    }
+
+    /**
+     * Show loading dialog
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} message - Loading message
+     * @returns {Object} Dialog instance
+     */
+    showLoadingDialog(componentId, message = 'Loading...') {
+        return this.showDialog(componentId, {
+            title: '',
+            content: `
+                <div class="loading-dialog">
+                    <div class="spinner"></div>
+                    <p>${message}</p>
+                </div>
+            `,
+            size: 'small',
+            buttons: [],
+            closeOnBackdrop: false,
+            closeOnEscape: false
+        });
+    }
+
+    /**
+     * Cleanup all UI components for component
+     * 
+     * @param {string} componentId - Component ID
+     */
+    cleanup(componentId) {
+        // Close dialogs
+        this.closeDialog(componentId);
+
+        // Hide notifications
+        this.hideNotification(componentId);
+    }
+}
+
diff --git a/resources/js/modules/livecomponent/LoadingStateManager.js b/resources/js/modules/livecomponent/LoadingStateManager.js
new file mode 100644
index 00000000..3c00b00f
--- /dev/null
+++ b/resources/js/modules/livecomponent/LoadingStateManager.js
@@ -0,0 +1,307 @@
+/**
+ * Loading State Manager for LiveComponents
+ * 
+ * Manages different loading indicators (skeleton, spinner, progress) during actions.
+ * Integrates with OptimisticStateManager and ActionLoadingManager.
+ */
+
+export class LoadingStateManager {
+    constructor(actionLoadingManager, optimisticStateManager) {
+        this.actionLoadingManager = actionLoadingManager;
+        this.optimisticStateManager = optimisticStateManager;
+        this.loadingConfigs = new Map(); // componentId → loading config
+        this.config = {
+            defaultType: 'skeleton', // skeleton, spinner, progress, none
+            showDelay: 150,
+            hideDelay: 0
+        };
+    }
+
+    /**
+     * Configure loading state for component
+     * 
+     * @param {string} componentId - Component ID
+     * @param {Object} config - Loading configuration
+     */
+    configure(componentId, config) {
+        this.loadingConfigs.set(componentId, {
+            type: config.type || this.config.defaultType,
+            showDelay: config.showDelay ?? this.config.showDelay,
+            hideDelay: config.hideDelay ?? this.config.hideDelay,
+            template: config.template || null,
+            ...config
+        });
+    }
+
+    /**
+     * Show loading state for action
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Object} options - Loading options
+     */
+    showLoading(componentId, element, options = {}) {
+        const config = this.loadingConfigs.get(componentId) || {
+            type: this.config.defaultType,
+            showDelay: this.config.showDelay
+        };
+
+        const loadingType = options.type || config.type;
+
+        // Skip if type is 'none' or optimistic UI is enabled
+        if (loadingType === 'none') {
+            return;
+        }
+
+        // Check if optimistic UI is active (no loading needed)
+        const pendingOps = this.optimisticStateManager.getPendingOperations(componentId);
+        if (pendingOps.length > 0 && options.optimistic !== false) {
+            // Optimistic UI is active - skip loading indicator
+            return;
+        }
+
+        switch (loadingType) {
+            case 'skeleton':
+                this.actionLoadingManager.showLoading(componentId, element, {
+                    ...options,
+                    showDelay: config.showDelay
+                });
+                break;
+
+            case 'spinner':
+                this.showSpinner(componentId, element, config);
+                break;
+
+            case 'progress':
+                this.showProgress(componentId, element, config);
+                break;
+
+            default:
+                // Fallback to skeleton
+                this.actionLoadingManager.showLoading(componentId, element, options);
+        }
+    }
+
+    /**
+     * Hide loading state
+     * 
+     * @param {string} componentId - Component ID
+     */
+    hideLoading(componentId) {
+        // Hide skeleton loading
+        this.actionLoadingManager.hideLoading(componentId);
+
+        // Hide spinner
+        this.hideSpinner(componentId);
+
+        // Hide progress
+        this.hideProgress(componentId);
+    }
+
+    /**
+     * Show spinner loading indicator
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Object} config - Configuration
+     */
+    showSpinner(componentId, element, config) {
+        // Remove existing spinner
+        this.hideSpinner(componentId);
+
+        const spinner = document.createElement('div');
+        spinner.className = 'livecomponent-loading-spinner';
+        spinner.setAttribute('data-component-id', componentId);
+        spinner.setAttribute('aria-busy', 'true');
+        spinner.setAttribute('aria-label', 'Loading...');
+
+        spinner.innerHTML = `
+            <div class="spinner"></div>
+            <span class="spinner-text">Loading...</span>
+        `;
+
+        spinner.style.cssText = `
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background: rgba(255, 255, 255, 0.8);
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            justify-content: center;
+            gap: 1rem;
+            z-index: 10;
+            opacity: 0;
+            transition: opacity ${this.config.showDelay}ms ease;
+        `;
+
+        // Ensure element has relative positioning
+        if (getComputedStyle(element).position === 'static') {
+            element.style.position = 'relative';
+        }
+
+        element.appendChild(spinner);
+
+        // Animate in
+        requestAnimationFrame(() => {
+            spinner.style.opacity = '1';
+        });
+
+        // Store reference
+        const loadingConfig = this.loadingConfigs.get(componentId) || {};
+        loadingConfig.spinner = spinner;
+        this.loadingConfigs.set(componentId, loadingConfig);
+    }
+
+    /**
+     * Hide spinner
+     * 
+     * @param {string} componentId - Component ID
+     */
+    hideSpinner(componentId) {
+        const config = this.loadingConfigs.get(componentId);
+        if (!config || !config.spinner) {
+            return;
+        }
+
+        const spinner = config.spinner;
+        spinner.style.opacity = '0';
+
+        setTimeout(() => {
+            if (spinner.parentNode) {
+                spinner.parentNode.removeChild(spinner);
+            }
+            delete config.spinner;
+        }, 200);
+    }
+
+    /**
+     * Show progress bar
+     * 
+     * @param {string} componentId - Component ID
+     * @param {HTMLElement} element - Component element
+     * @param {Object} config - Configuration
+     */
+    showProgress(componentId, element, config) {
+        // Remove existing progress
+        this.hideProgress(componentId);
+
+        const progress = document.createElement('div');
+        progress.className = 'livecomponent-loading-progress';
+        progress.setAttribute('data-component-id', componentId);
+        progress.setAttribute('aria-busy', 'true');
+
+        progress.innerHTML = `
+            <div class="progress-bar" style="width: 0%;"></div>
+        `;
+
+        progress.style.cssText = `
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            height: 3px;
+            background: #e0e0e0;
+            z-index: 10;
+            opacity: 0;
+            transition: opacity ${this.config.showDelay}ms ease;
+        `;
+
+        const progressBar = progress.querySelector('.progress-bar');
+        progressBar.style.cssText = `
+            height: 100%;
+            background: #2196F3;
+            transition: width 0.3s ease;
+        `;
+
+        // Ensure element has relative positioning
+        if (getComputedStyle(element).position === 'static') {
+            element.style.position = 'relative';
+        }
+
+        element.appendChild(progress);
+
+        // Animate in
+        requestAnimationFrame(() => {
+            progress.style.opacity = '1';
+            // Simulate progress (can be updated via updateProgress)
+            this.updateProgress(componentId, 30);
+        });
+
+        // Store reference
+        const loadingConfig = this.loadingConfigs.get(componentId) || {};
+        loadingConfig.progress = progress;
+        this.loadingConfigs.set(componentId, loadingConfig);
+    }
+
+    /**
+     * Update progress bar
+     * 
+     * @param {string} componentId - Component ID
+     * @param {number} percent - Progress percentage (0-100)
+     */
+    updateProgress(componentId, percent) {
+        const config = this.loadingConfigs.get(componentId);
+        if (!config || !config.progress) {
+            return;
+        }
+
+        const progressBar = config.progress.querySelector('.progress-bar');
+        if (progressBar) {
+            progressBar.style.width = `${Math.min(100, Math.max(0, percent))}%`;
+        }
+    }
+
+    /**
+     * Hide progress bar
+     * 
+     * @param {string} componentId - Component ID
+     */
+    hideProgress(componentId) {
+        const config = this.loadingConfigs.get(componentId);
+        if (!config || !config.progress) {
+            return;
+        }
+
+        const progress = config.progress;
+        
+        // Complete progress bar
+        this.updateProgress(componentId, 100);
+
+        setTimeout(() => {
+            progress.style.opacity = '0';
+            setTimeout(() => {
+                if (progress.parentNode) {
+                    progress.parentNode.removeChild(progress);
+                }
+                delete config.progress;
+            }, 200);
+        }, 300);
+    }
+
+    /**
+     * Get loading configuration for component
+     * 
+     * @param {string} componentId - Component ID
+     * @returns {Object} Loading configuration
+     */
+    getConfig(componentId) {
+        return this.loadingConfigs.get(componentId) || {
+            type: this.config.defaultType,
+            showDelay: this.config.showDelay
+        };
+    }
+
+    /**
+     * Clear configuration for component
+     * 
+     * @param {string} componentId - Component ID
+     */
+    clearConfig(componentId) {
+        this.hideLoading(componentId);
+        this.loadingConfigs.delete(componentId);
+    }
+}
+
diff --git a/resources/js/modules/livecomponent/RequestDeduplicator.js b/resources/js/modules/livecomponent/RequestDeduplicator.js
new file mode 100644
index 00000000..94fa54a4
--- /dev/null
+++ b/resources/js/modules/livecomponent/RequestDeduplicator.js
@@ -0,0 +1,180 @@
+/**
+ * Request Deduplication for LiveComponents
+ * 
+ * Prevents duplicate requests for the same action with the same parameters.
+ * Useful for preventing race conditions and reducing server load.
+ */
+
+export class RequestDeduplicator {
+    constructor() {
+        this.pendingRequests = new Map();
+        this.requestCache = new Map();
+        this.cacheTimeout = 1000; // 1 second cache
+    }
+
+    /**
+     * Generate request key for deduplication
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} method - Action method name
+     * @param {Object} params - Action parameters
+     * @returns {string} Request key
+     */
+    generateKey(componentId, method, params) {
+        // Sort params for consistent key generation
+        const sortedParams = Object.keys(params)
+            .sort()
+            .reduce((acc, key) => {
+                acc[key] = params[key];
+                return acc;
+            }, {});
+
+        const paramsString = JSON.stringify(sortedParams);
+        return `${componentId}:${method}:${paramsString}`;
+    }
+
+    /**
+     * Check if request is already pending
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} method - Action method name
+     * @param {Object} params - Action parameters
+     * @returns {Promise|null} Pending request promise or null
+     */
+    getPendingRequest(componentId, method, params) {
+        const key = this.generateKey(componentId, method, params);
+        return this.pendingRequests.get(key) || null;
+    }
+
+    /**
+     * Register pending request
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} method - Action method name
+     * @param {Object} params - Action parameters
+     * @param {Promise} promise - Request promise
+     * @returns {Promise} Request promise
+     */
+    registerPendingRequest(componentId, method, params, promise) {
+        const key = this.generateKey(componentId, method, params);
+
+        // Store pending request
+        this.pendingRequests.set(key, promise);
+
+        // Clean up when request completes
+        promise
+            .then(() => {
+                this.pendingRequests.delete(key);
+            })
+            .catch(() => {
+                this.pendingRequests.delete(key);
+            });
+
+        return promise;
+    }
+
+    /**
+     * Check if request result is cached
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} method - Action method name
+     * @param {Object} params - Action parameters
+     * @returns {Object|null} Cached result or null
+     */
+    getCachedResult(componentId, method, params) {
+        const key = this.generateKey(componentId, method, params);
+        const cached = this.requestCache.get(key);
+
+        if (!cached) {
+            return null;
+        }
+
+        // Check if cache is still valid
+        const now = Date.now();
+        if (now - cached.timestamp > this.cacheTimeout) {
+            this.requestCache.delete(key);
+            return null;
+        }
+
+        return cached.result;
+    }
+
+    /**
+     * Cache request result
+     * 
+     * @param {string} componentId - Component ID
+     * @param {string} method - Action method name
+     * @param {Object} params - Action parameters
+     * @param {Object} result - Request result
+     */
+    cacheResult(componentId, method, params, result) {
+        const key = this.generateKey(componentId, method, params);
+        this.requestCache.set(key, {
+            result,
+            timestamp: Date.now()
+        });
+
+        // Clean up old cache entries
+        this.cleanupCache();
+    }
+
+    /**
+     * Clean up expired cache entries
+     */
+    cleanupCache() {
+        const now = Date.now();
+        for (const [key, cached] of this.requestCache.entries()) {
+            if (now - cached.timestamp > this.cacheTimeout) {
+                this.requestCache.delete(key);
+            }
+        }
+    }
+
+    /**
+     * Clear all pending requests
+     */
+    clearPendingRequests() {
+        this.pendingRequests.clear();
+    }
+
+    /**
+     * Clear all cached results
+     */
+    clearCache() {
+        this.requestCache.clear();
+    }
+
+    /**
+     * Clear requests and cache for specific component
+     * 
+     * @param {string} componentId - Component ID
+     */
+    clearComponent(componentId) {
+        // Clear pending requests
+        for (const [key] of this.pendingRequests.entries()) {
+            if (key.startsWith(`${componentId}:`)) {
+                this.pendingRequests.delete(key);
+            }
+        }
+
+        // Clear cache
+        for (const [key] of this.requestCache.entries()) {
+            if (key.startsWith(`${componentId}:`)) {
+                this.requestCache.delete(key);
+            }
+        }
+    }
+
+    /**
+     * Get statistics
+     * 
+     * @returns {Object} Statistics
+     */
+    getStats() {
+        return {
+            pendingRequests: this.pendingRequests.size,
+            cachedResults: this.requestCache.size
+        };
+    }
+}
+
diff --git a/resources/js/modules/livecomponent/SharedConfig.js b/resources/js/modules/livecomponent/SharedConfig.js
new file mode 100644
index 00000000..15038816
--- /dev/null
+++ b/resources/js/modules/livecomponent/SharedConfig.js
@@ -0,0 +1,124 @@
+/**
+ * Shared Configuration between PHP and JavaScript
+ * 
+ * Provides unified configuration management for LiveComponents
+ * that can be synchronized between server and client.
+ */
+
+export class SharedConfig {
+    constructor() {
+        this.config = {
+            // Request settings
+            requestTimeout: 30000, // 30 seconds
+            retryAttempts: 3,
+            retryDelays: [1000, 2000, 5000], // Progressive backoff
+            
+            // State settings
+            stateVersioning: true,
+            stateValidation: true,
+            
+            // Performance settings
+            requestDeduplication: true,
+            requestCacheTimeout: 1000, // 1 second
+            batchFlushDelay: 50, // 50ms
+            
+            // Error handling
+            errorBoundary: true,
+            autoRetry: true,
+            showErrorUI: true,
+            
+            // DevTools
+            devToolsEnabled: false
+        };
+    }
+
+    /**
+     * Load configuration from server
+     * 
+     * @param {Object} serverConfig - Configuration from server
+     */
+    loadFromServer(serverConfig) {
+        if (serverConfig && typeof serverConfig === 'object') {
+            this.config = {
+                ...this.config,
+                ...serverConfig
+            };
+        }
+    }
+
+    /**
+     * Load configuration from DOM
+     * 
+     * Looks for data-livecomponent-config attribute on document or body
+     */
+    loadFromDOM() {
+        const configElement = document.querySelector('[data-livecomponent-config]') || document.body;
+        const configJson = configElement.dataset.livecomponentConfig;
+        
+        if (configJson) {
+            try {
+                const parsed = JSON.parse(configJson);
+                this.loadFromServer(parsed);
+            } catch (error) {
+                console.warn('[SharedConfig] Failed to parse config from DOM:', error);
+            }
+        }
+    }
+
+    /**
+     * Get configuration value
+     * 
+     * @param {string} key - Configuration key
+     * @param {*} defaultValue - Default value if key not found
+     * @returns {*} Configuration value
+     */
+    get(key, defaultValue = null) {
+        return this.config[key] ?? defaultValue;
+    }
+
+    /**
+     * Set configuration value
+     * 
+     * @param {string} key - Configuration key
+     * @param {*} value - Configuration value
+     */
+    set(key, value) {
+        this.config[key] = value;
+    }
+
+    /**
+     * Get all configuration
+     * 
+     * @returns {Object} Full configuration object
+     */
+    getAll() {
+        return { ...this.config };
+    }
+
+    /**
+     * Merge configuration
+     * 
+     * @param {Object} newConfig - Configuration to merge
+     */
+    merge(newConfig) {
+        this.config = {
+            ...this.config,
+            ...newConfig
+        };
+    }
+}
+
+// Create singleton instance
+export const sharedConfig = new SharedConfig();
+
+// Auto-load from DOM on initialization
+if (typeof document !== 'undefined') {
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', () => {
+            sharedConfig.loadFromDOM();
+        });
+    } else {
+        sharedConfig.loadFromDOM();
+    }
+}
+
diff --git a/resources/js/modules/livecomponent/StateSerializer.js b/resources/js/modules/livecomponent/StateSerializer.js
new file mode 100644
index 00000000..80b2131f
--- /dev/null
+++ b/resources/js/modules/livecomponent/StateSerializer.js
@@ -0,0 +1,245 @@
+/**
+ * State Serializer for LiveComponents
+ * 
+ * Provides type-safe state serialization/deserialization with versioning
+ * and validation.
+ */
+
+/**
+ * Serialize component state
+ * 
+ * @param {LiveComponentState} state - Component state
+ * @returns {string} Serialized state JSON
+ */
+export function serializeState(state) {
+    // Validate state structure
+    if (!state || typeof state !== 'object') {
+        throw new Error('State must be an object');
+    }
+
+    if (!state.id || typeof state.id !== 'string') {
+        throw new Error('State must have a valid id');
+    }
+
+    if (!state.component || typeof state.component !== 'string') {
+        throw new Error('State must have a valid component name');
+    }
+
+    if (typeof state.version !== 'number' || state.version < 1) {
+        throw new Error('State must have a valid version number');
+    }
+
+    // Ensure data is an object
+    const data = state.data || {};
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        throw new Error('State data must be an object');
+    }
+
+    // Create serializable state
+    const serializableState = {
+        id: state.id,
+        component: state.component,
+        data: data,
+        version: state.version
+    };
+
+    // Serialize to JSON
+    try {
+        return JSON.stringify(serializableState);
+    } catch (error) {
+        throw new Error(`Failed to serialize state: ${error.message}`);
+    }
+}
+
+/**
+ * Deserialize component state
+ * 
+ * @param {string} json - Serialized state JSON
+ * @returns {LiveComponentState} Deserialized state
+ */
+export function deserializeState(json) {
+    if (typeof json !== 'string') {
+        throw new Error('State JSON must be a string');
+    }
+
+    if (json.trim() === '') {
+        // Return empty state
+        return {
+            id: '',
+            component: '',
+            data: {},
+            version: 1
+        };
+    }
+
+    try {
+        const parsed = JSON.parse(json);
+
+        // Validate structure
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('Invalid state structure');
+        }
+
+        // Extract state data
+        const id = parsed.id || '';
+        const component = parsed.component || '';
+        const data = parsed.data || {};
+        const version = typeof parsed.version === 'number' ? parsed.version : 1;
+
+        // Validate data is an object
+        if (typeof data !== 'object' || Array.isArray(data)) {
+            throw new Error('State data must be an object');
+        }
+
+        return {
+            id,
+            component,
+            data,
+            version
+        };
+    } catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON format: ${error.message}`);
+        }
+        throw error;
+    }
+}
+
+/**
+ * Create state diff (changes between two states)
+ * 
+ * @param {LiveComponentState} oldState - Previous state
+ * @param {LiveComponentState} newState - New state
+ * @returns {Object} State diff
+ */
+export function createStateDiff(oldState, newState) {
+    const diff = {
+        changed: false,
+        added: {},
+        removed: {},
+        modified: {},
+        versionChange: newState.version - oldState.version
+    };
+
+    const oldData = oldState.data || {};
+    const newData = newState.data || {};
+
+    // Find added keys
+    for (const key in newData) {
+        if (!(key in oldData)) {
+            diff.added[key] = newData[key];
+            diff.changed = true;
+        }
+    }
+
+    // Find removed keys
+    for (const key in oldData) {
+        if (!(key in newData)) {
+            diff.removed[key] = oldData[key];
+            diff.changed = true;
+        }
+    }
+
+    // Find modified keys
+    for (const key in newData) {
+        if (key in oldData) {
+            const oldValue = oldData[key];
+            const newValue = newData[key];
+
+            // Deep comparison for objects
+            if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {
+                diff.modified[key] = {
+                    old: oldValue,
+                    new: newValue
+                };
+                diff.changed = true;
+            }
+        }
+    }
+
+    return diff;
+}
+
+/**
+ * Merge state changes
+ * 
+ * @param {LiveComponentState} baseState - Base state
+ * @param {Object} changes - State changes to apply
+ * @returns {LiveComponentState} Merged state
+ */
+export function mergeStateChanges(baseState, changes) {
+    const baseData = baseState.data || {};
+    const mergedData = { ...baseData, ...changes };
+
+    return {
+        ...baseState,
+        data: mergedData,
+        version: baseState.version + 1
+    };
+}
+
+/**
+ * Validate state structure
+ * 
+ * @param {LiveComponentState} state - State to validate
+ * @returns {boolean} True if valid
+ */
+export function validateState(state) {
+    if (!state || typeof state !== 'object') {
+        return false;
+    }
+
+    if (!state.id || typeof state.id !== 'string') {
+        return false;
+    }
+
+    if (!state.component || typeof state.component !== 'string') {
+        return false;
+    }
+
+    if (typeof state.version !== 'number' || state.version < 1) {
+        return false;
+    }
+
+    if (state.data && (typeof state.data !== 'object' || Array.isArray(state.data))) {
+        return false;
+    }
+
+    return true;
+}
+
+/**
+ * Get state from DOM element
+ * 
+ * @param {HTMLElement} element - Component element
+ * @returns {LiveComponentState|null} State or null if not found
+ */
+export function getStateFromElement(element) {
+    const stateJson = element.dataset.state;
+    if (!stateJson) {
+        return null;
+    }
+
+    try {
+        return deserializeState(stateJson);
+    } catch (error) {
+        console.error('[StateSerializer] Failed to deserialize state from element:', error);
+        return null;
+    }
+}
+
+/**
+ * Set state on DOM element
+ * 
+ * @param {HTMLElement} element - Component element
+ * @param {LiveComponentState} state - State to set
+ */
+export function setStateOnElement(element, state) {
+    if (!validateState(state)) {
+        throw new Error('Invalid state structure');
+    }
+
+    const stateJson = serializeState(state);
+    element.dataset.state = stateJson;
+}
+
diff --git a/resources/js/modules/livecomponent/TooltipManager.js b/resources/js/modules/livecomponent/TooltipManager.js
new file mode 100644
index 00000000..260e310a
--- /dev/null
+++ b/resources/js/modules/livecomponent/TooltipManager.js
@@ -0,0 +1,388 @@
+/**
+ * Tooltip Manager for LiveComponents
+ * 
+ * Provides tooltip functionality for LiveComponent elements with:
+ * - Automatic positioning
+ * - Validation error tooltips
+ * - Accessibility support
+ * - Smooth animations
+ * - Multiple positioning strategies
+ */
+
+export class TooltipManager {
+    constructor() {
+        this.tooltips = new Map(); // element → tooltip element
+        this.activeTooltip = null;
+        this.config = {
+            delay: 300, // ms before showing tooltip
+            hideDelay: 100, // ms before hiding tooltip
+            maxWidth: 300, // px
+            offset: 8, // px offset from element
+            animationDuration: 200, // ms
+            zIndex: 10000
+        };
+    }
+
+    /**
+     * Initialize tooltip for element
+     * 
+     * @param {HTMLElement} element - Element to attach tooltip to
+     * @param {Object} options - Tooltip options
+     */
+    init(element, options = {}) {
+        // Get tooltip content from data attributes or options
+        const content = options.content || 
+                       element.dataset.tooltip || 
+                       element.getAttribute('title') ||
+                       element.getAttribute('aria-label') ||
+                       '';
+
+        if (!content) {
+            return; // No tooltip content
+        }
+
+        // Remove native title attribute to prevent default tooltip
+        if (element.hasAttribute('title')) {
+            element.dataset.originalTitle = element.getAttribute('title');
+            element.removeAttribute('title');
+        }
+
+        // Get positioning
+        const position = options.position || 
+                        element.dataset.tooltipPosition || 
+                        'top';
+
+        // Setup event listeners
+        this.setupEventListeners(element, content, position, options);
+    }
+
+    /**
+     * Setup event listeners for tooltip
+     * 
+     * @param {HTMLElement} element - Element
+     * @param {string} content - Tooltip content
+     * @param {string} position - Position (top, bottom, left, right)
+     * @param {Object} options - Additional options
+     */
+    setupEventListeners(element, content, position, options) {
+        let showTimeout;
+        let hideTimeout;
+
+        const showTooltip = () => {
+            clearTimeout(hideTimeout);
+            showTimeout = setTimeout(() => {
+                this.show(element, content, position, options);
+            }, this.config.delay);
+        };
+
+        const hideTooltip = () => {
+            clearTimeout(showTimeout);
+            hideTimeout = setTimeout(() => {
+                this.hide(element);
+            }, this.config.hideDelay);
+        };
+
+        // Mouse events
+        element.addEventListener('mouseenter', showTooltip);
+        element.addEventListener('mouseleave', hideTooltip);
+        element.addEventListener('focus', showTooltip);
+        element.addEventListener('blur', hideTooltip);
+
+        // Touch events (for mobile)
+        element.addEventListener('touchstart', showTooltip, { passive: true });
+        element.addEventListener('touchend', hideTooltip, { passive: true });
+
+        // Store cleanup function
+        element._tooltipCleanup = () => {
+            clearTimeout(showTimeout);
+            clearTimeout(hideTimeout);
+            element.removeEventListener('mouseenter', showTooltip);
+            element.removeEventListener('mouseleave', hideTooltip);
+            element.removeEventListener('focus', showTooltip);
+            element.removeEventListener('blur', hideTooltip);
+            element.removeEventListener('touchstart', showTooltip);
+            element.removeEventListener('touchend', hideTooltip);
+        };
+    }
+
+    /**
+     * Show tooltip
+     * 
+     * @param {HTMLElement} element - Element
+     * @param {string} content - Tooltip content
+     * @param {string} position - Position
+     * @param {Object} options - Additional options
+     */
+    show(element, content, position, options = {}) {
+        // Hide existing tooltip
+        if (this.activeTooltip) {
+            this.hide();
+        }
+
+        // Create tooltip element
+        const tooltip = document.createElement('div');
+        tooltip.className = 'livecomponent-tooltip';
+        tooltip.setAttribute('role', 'tooltip');
+        tooltip.setAttribute('aria-hidden', 'false');
+        tooltip.textContent = content;
+
+        // Apply styles
+        tooltip.style.cssText = `
+            position: absolute;
+            max-width: ${this.config.maxWidth}px;
+            padding: 0.5rem 0.75rem;
+            background: #1f2937;
+            color: white;
+            border-radius: 0.375rem;
+            font-size: 0.875rem;
+            line-height: 1.4;
+            z-index: ${this.config.zIndex};
+            pointer-events: none;
+            opacity: 0;
+            transition: opacity ${this.config.animationDuration}ms ease;
+            word-wrap: break-word;
+            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+        `;
+
+        // Add to DOM
+        document.body.appendChild(tooltip);
+
+        // Position tooltip
+        this.positionTooltip(tooltip, element, position);
+
+        // Animate in
+        requestAnimationFrame(() => {
+            tooltip.style.opacity = '1';
+        });
+
+        // Store references
+        this.tooltips.set(element, tooltip);
+        this.activeTooltip = tooltip;
+
+        // Set aria-describedby on element
+        const tooltipId = `tooltip-${Date.now()}`;
+        tooltip.id = tooltipId;
+        element.setAttribute('aria-describedby', tooltipId);
+    }
+
+    /**
+     * Position tooltip relative to element
+     * 
+     * @param {HTMLElement} tooltip - Tooltip element
+     * @param {HTMLElement} element - Target element
+     * @param {string} position - Position (top, bottom, left, right)
+     */
+    positionTooltip(tooltip, element, position) {
+        const rect = element.getBoundingClientRect();
+        const tooltipRect = tooltip.getBoundingClientRect();
+        const scrollX = window.scrollX || window.pageXOffset;
+        const scrollY = window.scrollY || window.pageYOffset;
+        const offset = this.config.offset;
+
+        let top, left;
+
+        switch (position) {
+            case 'top':
+                top = rect.top + scrollY - tooltipRect.height - offset;
+                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);
+                break;
+            case 'bottom':
+                top = rect.bottom + scrollY + offset;
+                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);
+                break;
+            case 'left':
+                top = rect.top + scrollY + (rect.height / 2) - (tooltipRect.height / 2);
+                left = rect.left + scrollX - tooltipRect.width - offset;
+                break;
+            case 'right':
+                top = rect.top + scrollY + (rect.height / 2) - (tooltipRect.height / 2);
+                left = rect.right + scrollX + offset;
+                break;
+            default:
+                top = rect.top + scrollY - tooltipRect.height - offset;
+                left = rect.left + scrollX + (rect.width / 2) - (tooltipRect.width / 2);
+        }
+
+        // Keep tooltip within viewport
+        const viewportWidth = window.innerWidth;
+        const viewportHeight = window.innerHeight;
+
+        // Horizontal adjustment
+        if (left < scrollX) {
+            left = scrollX + 8;
+        } else if (left + tooltipRect.width > scrollX + viewportWidth) {
+            left = scrollX + viewportWidth - tooltipRect.width - 8;
+        }
+
+        // Vertical adjustment
+        if (top < scrollY) {
+            top = scrollY + 8;
+        } else if (top + tooltipRect.height > scrollY + viewportHeight) {
+            top = scrollY + viewportHeight - tooltipRect.height - 8;
+        }
+
+        tooltip.style.top = `${top}px`;
+        tooltip.style.left = `${left}px`;
+    }
+
+    /**
+     * Hide tooltip
+     * 
+     * @param {HTMLElement} element - Element (optional, hides active tooltip if not provided)
+     */
+    hide(element = null) {
+        const tooltip = element ? this.tooltips.get(element) : this.activeTooltip;
+
+        if (!tooltip) {
+            return;
+        }
+
+        // Animate out
+        tooltip.style.opacity = '0';
+
+        // Remove after animation
+        setTimeout(() => {
+            if (tooltip.parentNode) {
+                tooltip.parentNode.removeChild(tooltip);
+            }
+
+            // Remove aria-describedby
+            if (element) {
+                element.removeAttribute('aria-describedby');
+            }
+
+            // Clean up references
+            if (element) {
+                this.tooltips.delete(element);
+            }
+            if (this.activeTooltip === tooltip) {
+                this.activeTooltip = null;
+            }
+        }, this.config.animationDuration);
+    }
+
+    /**
+     * Show validation error tooltip
+     * 
+     * @param {HTMLElement} element - Form element
+     * @param {string} message - Error message
+     */
+    showValidationError(element, message) {
+        // Remove existing error tooltip
+        this.hideValidationError(element);
+
+        // Show error tooltip with error styling
+        const tooltip = document.createElement('div');
+        tooltip.className = 'livecomponent-tooltip livecomponent-tooltip--error';
+        tooltip.setAttribute('role', 'alert');
+        tooltip.textContent = message;
+
+        tooltip.style.cssText = `
+            position: absolute;
+            max-width: ${this.config.maxWidth}px;
+            padding: 0.5rem 0.75rem;
+            background: #dc2626;
+            color: white;
+            border-radius: 0.375rem;
+            font-size: 0.875rem;
+            line-height: 1.4;
+            z-index: ${this.config.zIndex};
+            pointer-events: none;
+            opacity: 0;
+            transition: opacity ${this.config.animationDuration}ms ease;
+            word-wrap: break-word;
+            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+        `;
+
+        document.body.appendChild(tooltip);
+        this.positionTooltip(tooltip, element, 'top');
+
+        // Animate in
+        requestAnimationFrame(() => {
+            tooltip.style.opacity = '1';
+        });
+
+        // Store reference
+        element._validationTooltip = tooltip;
+
+        // Add error class to element
+        element.classList.add('livecomponent-error');
+    }
+
+    /**
+     * Hide validation error tooltip
+     * 
+     * @param {HTMLElement} element - Form element
+     */
+    hideValidationError(element) {
+        const tooltip = element._validationTooltip;
+        if (!tooltip) {
+            return;
+        }
+
+        // Animate out
+        tooltip.style.opacity = '0';
+
+        setTimeout(() => {
+            if (tooltip.parentNode) {
+                tooltip.parentNode.removeChild(tooltip);
+            }
+            delete element._validationTooltip;
+            element.classList.remove('livecomponent-error');
+        }, this.config.animationDuration);
+    }
+
+    /**
+     * Initialize all tooltips in component
+     * 
+     * @param {HTMLElement} container - Component container
+     */
+    initComponent(container) {
+        // Find all elements with tooltip attributes
+        const elements = container.querySelectorAll('[data-tooltip], [title], [aria-label]');
+        elements.forEach(element => {
+            this.init(element);
+        });
+    }
+
+    /**
+     * Cleanup tooltips for component
+     * 
+     * @param {HTMLElement} container - Component container
+     */
+    cleanupComponent(container) {
+        const elements = container.querySelectorAll('[data-tooltip], [title], [aria-label]');
+        elements.forEach(element => {
+            // Hide tooltip
+            this.hide(element);
+
+            // Cleanup event listeners
+            if (element._tooltipCleanup) {
+                element._tooltipCleanup();
+                delete element._tooltipCleanup;
+            }
+
+            // Restore original title
+            if (element.dataset.originalTitle) {
+                element.setAttribute('title', element.dataset.originalTitle);
+                delete element.dataset.originalTitle;
+            }
+        });
+    }
+
+    /**
+     * Update configuration
+     * 
+     * @param {Object} newConfig - New configuration
+     */
+    updateConfig(newConfig) {
+        this.config = {
+            ...this.config,
+            ...newConfig
+        };
+    }
+}
+
+// Create singleton instance
+export const tooltipManager = new TooltipManager();
+
diff --git a/resources/js/modules/livecomponent/index.js b/resources/js/modules/livecomponent/index.js
index 90ac3a1d..e9430567 100644
--- a/resources/js/modules/livecomponent/index.js
+++ b/resources/js/modules/livecomponent/index.js
@@ -20,6 +20,9 @@ import { ComponentFileUploader } from './ComponentFileUploader.js';
 import { FileUploadWidget } from './FileUploadWidget.js';
 import { optimisticStateManager } from './OptimisticStateManager.js';
 import { accessibilityManager } from './AccessibilityManager.js';
+import { ErrorBoundary } from './ErrorBoundary.js';
+import { RequestDeduplicator } from './RequestDeduplicator.js';
+import * as StateSerializer from './StateSerializer.js';
 
 class LiveComponentManager {
     constructor() {
@@ -42,6 +45,30 @@ class LiveComponentManager {
 
         // DevTools Integration
         this.devTools = null; // Will be set by DevTools when available
+
+        // Error Handling
+        this.errorBoundary = new ErrorBoundary(this);
+
+        // Request Deduplication
+        this.requestDeduplicator = new RequestDeduplicator();
+        
+        // Shared Configuration
+        this.config = sharedConfig;
+
+        // Tooltip Manager
+        this.tooltipManager = tooltipManager;
+
+        // Action Loading Manager
+        this.actionLoadingManager = actionLoadingManager;
+
+        // UI Helper
+        this.uiHelper = new LiveComponentUIHelper(this);
+
+        // Loading State Manager
+        this.loadingStateManager = new LoadingStateManager(
+            this.actionLoadingManager,
+            optimisticStateManager
+        );
     }
 
     /**
@@ -140,6 +167,9 @@ class LiveComponentManager {
         // Setup accessibility features
         this.setupAccessibility(componentId, element);
 
+        // Initialize tooltips for component
+        this.tooltipManager.initComponent(element);
+
         console.log(`[LiveComponent] Initialized: ${componentId}`);
     }
 
@@ -282,9 +312,9 @@ class LiveComponentManager {
                 this.setupFileUploadHandlers(config.element);
             }
 
-            // Update state
+            // Update state using StateSerializer
             if (state) {
-                config.element.dataset.state = JSON.stringify(state);
+                StateSerializer.setStateOnElement(config.element, state);
             }
 
             // Restore focus after update
@@ -614,18 +644,46 @@ class LiveComponentManager {
             return;
         }
 
+        // Check for pending duplicate request
+        const pendingRequest = this.requestDeduplicator.getPendingRequest(componentId, method, params);
+        if (pendingRequest) {
+            console.log(`[LiveComponent] Deduplicating request: ${componentId}.${method}`);
+            return await pendingRequest;
+        }
+
+        // Check for cached result
+        const cachedResult = this.requestDeduplicator.getCachedResult(componentId, method, params);
+        if (cachedResult) {
+            console.log(`[LiveComponent] Using cached result: ${componentId}.${method}`);
+            return cachedResult;
+        }
+
         let operationId = null;
         const startTime = performance.now();
 
-        try {
-            // Get current state from element
-            const stateJson = config.element.dataset.state || '{}';
-            const stateWrapper = JSON.parse(stateJson);
+        // Show loading state (uses LoadingStateManager for configurable indicators)
+        const loadingConfig = this.loadingStateManager.getConfig(componentId);
+        this.loadingStateManager.showLoading(componentId, config.element, {
+            fragments,
+            type: loadingConfig.type,
+            optimistic: true // Check optimistic UI first
+        });
+
+        // Create request promise
+        const requestPromise = (async () => {
+            try {
+            // Get current state from element using StateSerializer
+            const stateWrapper = StateSerializer.getStateFromElement(config.element) || {
+                id: componentId,
+                component: '',
+                data: {},
+                version: 1
+            };
 
             // Extract actual state data from wrapper format
             // Wrapper format: {id, component, data, version}
             // Server expects just the data object
-            const state = stateWrapper.data || stateWrapper;
+            const state = stateWrapper.data || {};
 
             // Apply optimistic update for immediate UI feedback
             // This updates the UI before server confirmation
@@ -741,9 +799,12 @@ class LiveComponentManager {
                 this.setupActionHandlers(config.element);
             }
 
-            // Update component state
+            // Re-initialize tooltips after DOM update
+            this.tooltipManager.initComponent(config.element);
+
+            // Update component state using StateSerializer
             if (data.state) {
-                config.element.dataset.state = JSON.stringify(data.state);
+                StateSerializer.setStateOnElement(config.element, data.state);
             }
 
             // Handle server events
@@ -753,29 +814,50 @@ class LiveComponentManager {
 
             console.log(`[LiveComponent] Action executed: ${componentId}.${method}`, data);
 
-            // Log successful action to DevTools
-            const endTime = performance.now();
-            this.logActionToDevTools(componentId, method, params, startTime, endTime, true);
+                // Log successful action to DevTools
+                const endTime = performance.now();
+                this.logActionToDevTools(componentId, method, params, startTime, endTime, true);
 
-        } catch (error) {
-            console.error(`[LiveComponent] Action failed:`, error);
+                // Cache successful result
+                this.requestDeduplicator.cacheResult(componentId, method, params, data);
 
-            // Log failed action to DevTools
-            const endTime = performance.now();
-            this.logActionToDevTools(componentId, method, params, startTime, endTime, false, error.message);
+                // Hide loading state
+                this.loadingStateManager.hideLoading(componentId);
 
-            // Rollback optimistic update on error
-            if (operationId) {
-                const snapshot = optimisticStateManager.getSnapshot(componentId);
-                if (snapshot) {
-                    config.element.dataset.state = JSON.stringify(snapshot);
-                    optimisticStateManager.clearPendingOperations(componentId);
-                    optimisticStateManager.clearSnapshot(componentId);
+                return data;
+
+            } catch (error) {
+                console.error(`[LiveComponent] Action failed:`, error);
+
+                // Log failed action to DevTools
+                const endTime = performance.now();
+                this.logActionToDevTools(componentId, method, params, startTime, endTime, false, error.message);
+
+                // Rollback optimistic update on error
+                if (operationId) {
+                    const snapshot = optimisticStateManager.getSnapshot(componentId);
+                    if (snapshot) {
+                        StateSerializer.setStateOnElement(config.element, snapshot);
+                        optimisticStateManager.clearPendingOperations(componentId);
+                        optimisticStateManager.clearSnapshot(componentId);
+                    }
                 }
-            }
 
-            this.handleError(componentId, error);
-        }
+                // Hide loading state on error
+                this.loadingStateManager.hideLoading(componentId);
+
+                // Handle error via ErrorBoundary
+                await this.errorBoundary.handleError(componentId, method, error, {
+                    params,
+                    fragments
+                });
+
+                throw error;
+            }
+        })();
+
+        // Register pending request for deduplication
+        return this.requestDeduplicator.registerPendingRequest(componentId, method, params, requestPromise);
     }
 
     /**
@@ -1154,9 +1236,9 @@ class LiveComponentManager {
                 this.setupFileUploadHandlers(config.element);
             }
 
-            // Update component state
+            // Update component state using StateSerializer
             if (data.state) {
-                config.element.dataset.state = JSON.stringify(data.state);
+                StateSerializer.setStateOnElement(config.element, data.state);
             }
 
             // Handle server events
@@ -1260,6 +1342,22 @@ class LiveComponentManager {
         // Cleanup accessibility features
         this.accessibilityManager.cleanup(componentId);
 
+        // Cleanup error handler
+        this.errorBoundary.clearErrorHandler(componentId);
+
+        // Cleanup request deduplication
+        this.requestDeduplicator.clearComponent(componentId);
+
+        // Cleanup tooltips
+        this.tooltipManager.cleanupComponent(config.element);
+
+        // Hide any active loading states
+        this.loadingStateManager.hideLoading(componentId);
+        this.loadingStateManager.clearConfig(componentId);
+
+        // Cleanup UI components
+        this.uiHelper.cleanup(componentId);
+
         // Remove from registry
         this.components.delete(componentId);
 
@@ -1413,9 +1511,9 @@ class LiveComponentManager {
                     this.setupActionHandlers(config.element);
                 }
 
-                // Update state
+                // Update state using StateSerializer
                 if (result.state) {
-                    config.element.dataset.state = JSON.stringify(result.state);
+                    StateSerializer.setStateOnElement(config.element, result.state);
                 }
 
                 // Dispatch events
@@ -1584,4 +1682,11 @@ export { ComponentPlayground };
 export { ComponentFileUploader } from './ComponentFileUploader.js';
 export { FileUploadWidget } from './FileUploadWidget.js';
 export { ChunkedUploader } from './ChunkedUploader.js';
+
+// Export UI integration modules
+export { tooltipManager } from './TooltipManager.js';
+export { actionLoadingManager } from './ActionLoadingManager.js';
+export { LiveComponentUIHelper } from './LiveComponentUIHelper.js';
+export { LoadingStateManager } from './LoadingStateManager.js';
+
 export default LiveComponent;
diff --git a/resources/js/modules/router/RouteGuard.js b/resources/js/modules/router/RouteGuard.js
new file mode 100644
index 00000000..b46168c4
--- /dev/null
+++ b/resources/js/modules/router/RouteGuard.js
@@ -0,0 +1,113 @@
+/**
+ * Route Guard
+ * 
+ * Provides route-level access control and guards.
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * RouteGuard - Route access control
+ */
+export class RouteGuard {
+    constructor(name, guardFn) {
+        this.name = name;
+        this.guardFn = guardFn;
+    }
+    
+    /**
+     * Create a new RouteGuard
+     */
+    static create(name, guardFn) {
+        return new RouteGuard(name, guardFn);
+    }
+    
+    /**
+     * Execute guard
+     */
+    async execute(to, from, context = {}) {
+        try {
+            const result = await this.guardFn(to, from, context);
+            return {
+                allowed: result !== false && result !== null,
+                redirect: typeof result === 'string' ? result : null,
+                reason: typeof result === 'object' && result.reason ? result.reason : null
+            };
+        } catch (error) {
+            Logger.error(`[RouteGuard] Guard "${this.name}" error:`, error);
+            return {
+                allowed: false,
+                redirect: null,
+                reason: error.message
+            };
+        }
+    }
+}
+
+/**
+ * Built-in guards
+ */
+export const BuiltInGuards = {
+    /**
+     * Require authentication
+     */
+    auth: RouteGuard.create('auth', async (to, from) => {
+        // Check if user is authenticated
+        // This would need to be implemented based on your auth system
+        const isAuthenticated = checkAuth(); // Placeholder
+        if (!isAuthenticated) {
+            return '/login';
+        }
+        return true;
+    }),
+    
+    /**
+     * Require guest (not authenticated)
+     */
+    guest: RouteGuard.create('guest', async (to, from) => {
+        const isAuthenticated = checkAuth(); // Placeholder
+        if (isAuthenticated) {
+            return '/';
+        }
+        return true;
+    }),
+    
+    /**
+     * Require specific role
+     */
+    role: (requiredRole) => RouteGuard.create('role', async (to, from) => {
+        const userRole = getUserRole(); // Placeholder
+        if (userRole !== requiredRole) {
+            return '/unauthorized';
+        }
+        return true;
+    }),
+    
+    /**
+     * Require permission
+     */
+    permission: (requiredPermission) => RouteGuard.create('permission', async (to, from) => {
+        const hasPermission = checkPermission(requiredPermission); // Placeholder
+        if (!hasPermission) {
+            return '/unauthorized';
+        }
+        return true;
+    })
+};
+
+// Placeholder functions (would be implemented based on auth system)
+function checkAuth() {
+    // Implementation depends on auth system
+    return false;
+}
+
+function getUserRole() {
+    // Implementation depends on auth system
+    return null;
+}
+
+function checkPermission(permission) {
+    // Implementation depends on auth system
+    return false;
+}
+
diff --git a/resources/js/modules/router/RouteMiddleware.js b/resources/js/modules/router/RouteMiddleware.js
new file mode 100644
index 00000000..2caac7cd
--- /dev/null
+++ b/resources/js/modules/router/RouteMiddleware.js
@@ -0,0 +1,78 @@
+/**
+ * Route Middleware
+ * 
+ * Provides route-level middleware for cross-cutting concerns.
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * RouteMiddleware - Route middleware
+ */
+export class RouteMiddleware {
+    constructor(name, middlewareFn) {
+        this.name = name;
+        this.middlewareFn = middlewareFn;
+    }
+    
+    /**
+     * Create a new RouteMiddleware
+     */
+    static create(name, middlewareFn) {
+        return new RouteMiddleware(name, middlewareFn);
+    }
+    
+    /**
+     * Execute middleware
+     */
+    async execute(to, from, next, context = {}) {
+        try {
+            await this.middlewareFn(to, from, next, context);
+        } catch (error) {
+            Logger.error(`[RouteMiddleware] Middleware "${this.name}" error:`, error);
+            next(false); // Block navigation
+        }
+    }
+}
+
+/**
+ * Built-in middleware
+ */
+export const BuiltInMiddleware = {
+    /**
+     * Analytics middleware
+     */
+    analytics: RouteMiddleware.create('analytics', async (to, from, next) => {
+        // Track page view
+        if (typeof window !== 'undefined' && window.analytics) {
+            window.analytics.track('page_view', {
+                path: to.path,
+                title: to.title
+            });
+        }
+        next();
+    }),
+    
+    /**
+     * Loading middleware
+     */
+    loading: RouteMiddleware.create('loading', async (to, from, next) => {
+        // Show loading indicator
+        document.body.classList.add('route-loading');
+        next();
+        
+        // Hide loading indicator after navigation
+        setTimeout(() => {
+            document.body.classList.remove('route-loading');
+        }, 100);
+    }),
+    
+    /**
+     * Scroll to top middleware
+     */
+    scrollToTop: RouteMiddleware.create('scroll-to-top', async (to, from, next) => {
+        next();
+        window.scrollTo({ top: 0, behavior: 'smooth' });
+    })
+};
+
diff --git a/resources/js/modules/router/Router.js b/resources/js/modules/router/Router.js
new file mode 100644
index 00000000..8fadfdc4
--- /dev/null
+++ b/resources/js/modules/router/Router.js
@@ -0,0 +1,378 @@
+/**
+ * Enhanced Router
+ * 
+ * Provides enhanced routing with guards, middleware, lazy loading, and analytics.
+ */
+
+import { Logger } from '../../core/logger.js';
+import { RouteGuard, BuiltInGuards } from './RouteGuard.js';
+import { RouteMiddleware, BuiltInMiddleware } from './RouteMiddleware.js';
+
+/**
+ * Router - Enhanced routing system
+ */
+export class Router {
+    constructor(config = {}) {
+        this.config = {
+            mode: config.mode || 'history', // 'history' | 'hash'
+            base: config.base || '/',
+            enableAnalytics: config.enableAnalytics ?? true,
+            ...config
+        };
+        
+        this.routes = new Map();
+        this.guards = new Map();
+        this.middleware = [];
+        this.beforeEachHooks = [];
+        this.afterEachHooks = [];
+        this.currentRoute = null;
+        this.analytics = {
+            navigations: [],
+            errors: []
+        };
+        
+        // Initialize
+        this.init();
+    }
+    
+    /**
+     * Create a new Router instance
+     */
+    static create(config = {}) {
+        return new Router(config);
+    }
+    
+    /**
+     * Initialize router
+     */
+    init() {
+        // Handle browser navigation
+        window.addEventListener('popstate', (event) => {
+            this.handlePopState(event);
+        });
+        
+        Logger.info('[Router] Initialized', {
+            mode: this.config.mode,
+            base: this.config.base
+        });
+    }
+    
+    /**
+     * Register a route
+     */
+    route(path, config) {
+        const route = {
+            path: this.normalizePath(path),
+            component: config.component,
+            name: config.name || path,
+            title: config.title || null,
+            meta: config.meta || {},
+            guards: config.guards || [],
+            middleware: config.middleware || [],
+            lazy: config.lazy ?? false,
+            ...config
+        };
+        
+        this.routes.set(route.path, route);
+        
+        Logger.debug('[Router] Route registered', route);
+        return this;
+    }
+    
+    /**
+     * Register multiple routes
+     */
+    routes(routesConfig) {
+        routesConfig.forEach(route => {
+            this.route(route.path, route);
+        });
+        return this;
+    }
+    
+    /**
+     * Register a guard
+     */
+    guard(name, guardFn) {
+        const guard = RouteGuard.create(name, guardFn);
+        this.guards.set(name, guard);
+        return this;
+    }
+    
+    /**
+     * Register middleware
+     */
+    use(middleware) {
+        if (typeof middleware === 'function') {
+            this.middleware.push(RouteMiddleware.create('anonymous', middleware));
+        } else if (middleware instanceof RouteMiddleware) {
+            this.middleware.push(middleware);
+        } else if (typeof middleware === 'string' && BuiltInMiddleware[middleware]) {
+            this.middleware.push(BuiltInMiddleware[middleware]);
+        }
+        return this;
+    }
+    
+    /**
+     * Add beforeEach hook
+     */
+    beforeEach(hook) {
+        this.beforeEachHooks.push(hook);
+        return this;
+    }
+    
+    /**
+     * Add afterEach hook
+     */
+    afterEach(hook) {
+        this.afterEachHooks.push(hook);
+        return this;
+    }
+    
+    /**
+     * Navigate to a route
+     */
+    async navigate(path, options = {}) {
+        const normalizedPath = this.normalizePath(path);
+        const route = this.routes.get(normalizedPath);
+        
+        if (!route) {
+            Logger.warn('[Router] Route not found', normalizedPath);
+            return false;
+        }
+        
+        const from = this.currentRoute;
+        const to = {
+            path: normalizedPath,
+            name: route.name,
+            title: route.title,
+            meta: route.meta,
+            component: route.component
+        };
+        
+        // Execute beforeEach hooks
+        for (const hook of this.beforeEachHooks) {
+            const result = await hook(to, from);
+            if (result === false || typeof result === 'string') {
+                if (typeof result === 'string') {
+                    return await this.navigate(result);
+                }
+                return false;
+            }
+        }
+        
+        // Execute guards
+        for (const guardName of route.guards) {
+            const guard = this.guards.get(guardName) || BuiltInGuards[guardName];
+            if (!guard) {
+                Logger.warn('[Router] Guard not found', guardName);
+                continue;
+            }
+            
+            const result = await guard.execute(to, from);
+            if (!result.allowed) {
+                if (result.redirect) {
+                    return await this.navigate(result.redirect);
+                }
+                Logger.warn('[Router] Navigation blocked by guard', guardName);
+                return false;
+            }
+        }
+        
+        // Execute middleware
+        let middlewareBlocked = false;
+        for (const middleware of [...this.middleware, ...route.middleware]) {
+            await new Promise((resolve) => {
+                middleware.execute(to, from, (allowed) => {
+                    if (allowed === false) {
+                        middlewareBlocked = true;
+                    }
+                    resolve();
+                });
+            });
+            
+            if (middlewareBlocked) {
+                return false;
+            }
+        }
+        
+        // Load component if lazy
+        if (route.lazy && typeof route.component === 'function') {
+            try {
+                route.component = await route.component();
+            } catch (error) {
+                Logger.error('[Router] Failed to load lazy component', error);
+                return false;
+            }
+        }
+        
+        // Update current route
+        this.currentRoute = to;
+        
+        // Update browser history
+        if (this.config.mode === 'history') {
+            history.pushState({ route: to }, route.title || '', normalizedPath);
+        } else {
+            window.location.hash = normalizedPath;
+        }
+        
+        // Update page title
+        if (route.title) {
+            document.title = route.title;
+        }
+        
+        // Track analytics
+        if (this.config.enableAnalytics) {
+            this.trackNavigation(to, from);
+        }
+        
+        // Execute afterEach hooks
+        for (const hook of this.afterEachHooks) {
+            await hook(to, from);
+        }
+        
+        // Render component
+        await this.renderComponent(route, options);
+        
+        Logger.info('[Router] Navigated', { to: normalizedPath });
+        return true;
+    }
+    
+    /**
+     * Render component
+     */
+    async renderComponent(route, options = {}) {
+        const container = options.container || document.querySelector('main');
+        
+        if (!container) {
+            Logger.error('[Router] Container not found');
+            return;
+        }
+        
+        if (typeof route.component === 'function') {
+            // Component is a function (render function)
+            const content = await route.component(route, options);
+            if (typeof content === 'string') {
+                container.innerHTML = content;
+            } else if (content instanceof HTMLElement) {
+                container.innerHTML = '';
+                container.appendChild(content);
+            }
+        } else if (typeof route.component === 'string') {
+            // Component is a selector or HTML
+            const element = document.querySelector(route.component);
+            if (element) {
+                container.innerHTML = '';
+                container.appendChild(element.cloneNode(true));
+            } else {
+                container.innerHTML = route.component;
+            }
+        }
+        
+        // Re-initialize modules in new content
+        this.reinitializeModules(container);
+    }
+    
+    /**
+     * Re-initialize modules in container
+     */
+    reinitializeModules(container) {
+        // Trigger module re-initialization
+        const event = new CustomEvent('router:content-updated', {
+            detail: { container },
+            bubbles: true
+        });
+        document.dispatchEvent(event);
+    }
+    
+    /**
+     * Handle popstate event
+     */
+    handlePopState(event) {
+        const path = this.config.mode === 'history' 
+            ? window.location.pathname 
+            : window.location.hash.slice(1);
+        
+        this.navigate(path, { updateHistory: false });
+    }
+    
+    /**
+     * Normalize path
+     */
+    normalizePath(path) {
+        // Remove base if present
+        if (path.startsWith(this.config.base)) {
+            path = path.slice(this.config.base.length);
+        }
+        
+        // Ensure leading slash
+        if (!path.startsWith('/')) {
+            path = '/' + path;
+        }
+        
+        // Remove trailing slash (except root)
+        if (path !== '/' && path.endsWith('/')) {
+            path = path.slice(0, -1);
+        }
+        
+        return path;
+    }
+    
+    /**
+     * Track navigation for analytics
+     */
+    trackNavigation(to, from) {
+        const navigation = {
+            to: to.path,
+            from: from?.path || null,
+            timestamp: Date.now(),
+            duration: from ? Date.now() - (from.timestamp || Date.now()) : 0
+        };
+        
+        this.analytics.navigations.push(navigation);
+        
+        // Limit analytics size
+        if (this.analytics.navigations.length > 100) {
+            this.analytics.navigations.shift();
+        }
+        
+        // Trigger analytics event
+        const event = new CustomEvent('router:navigation', {
+            detail: navigation,
+            bubbles: true
+        });
+        window.dispatchEvent(event);
+    }
+    
+    /**
+     * Get current route
+     */
+    getCurrentRoute() {
+        return this.currentRoute;
+    }
+    
+    /**
+     * Get analytics
+     */
+    getAnalytics() {
+        return {
+            ...this.analytics,
+            totalNavigations: this.analytics.navigations.length,
+            totalErrors: this.analytics.errors.length
+        };
+    }
+    
+    /**
+     * Destroy router
+     */
+    destroy() {
+        this.routes.clear();
+        this.guards.clear();
+        this.middleware = [];
+        this.beforeEachHooks = [];
+        this.afterEachHooks = [];
+        this.currentRoute = null;
+        
+        Logger.info('[Router] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/router/index.js b/resources/js/modules/router/index.js
new file mode 100644
index 00000000..870b00e8
--- /dev/null
+++ b/resources/js/modules/router/index.js
@@ -0,0 +1,87 @@
+/**
+ * Router Enhancement Module
+ * 
+ * Provides enhanced routing with guards, middleware, lazy loading, and analytics.
+ * 
+ * Usage:
+ * - Add data-module="router" to enable enhanced router
+ * - Or import and use directly: import { Router } from './modules/router/index.js'
+ * 
+ * Features:
+ * - Route guards (auth, permissions)
+ * - Route middleware
+ * - Lazy route loading
+ * - Route analytics
+ * - Integration with LiveComponents
+ */
+
+import { Logger } from '../../core/logger.js';
+import { Router } from './Router.js';
+import { RouteGuard, BuiltInGuards } from './RouteGuard.js';
+import { RouteMiddleware, BuiltInMiddleware } from './RouteMiddleware.js';
+
+const RouterModule = {
+    name: 'router',
+    router: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[RouterModule] Module initialized');
+        
+        // Create router
+        this.router = Router.create(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.Router = this.router;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get router instance
+     */
+    getRouter() {
+        return this.router || Router.create();
+    },
+    
+    /**
+     * Register routes
+     */
+    routes(routesConfig) {
+        const router = this.getRouter();
+        router.routes(routesConfig);
+        return this;
+    },
+    
+    /**
+     * Navigate to route
+     */
+    async navigate(path, options = {}) {
+        const router = this.getRouter();
+        return await router.navigate(path, options);
+    },
+    
+    destroy() {
+        if (this.router) {
+            this.router.destroy();
+            this.router = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.Router) {
+            delete window.Router;
+        }
+        
+        Logger.info('[RouterModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { Router, RouteGuard, RouteMiddleware, BuiltInGuards, BuiltInMiddleware };
+
+// Export as default for module system
+export default RouterModule;
+
+// Export init function for module system
+export const init = RouterModule.init.bind(RouterModule);
+
diff --git a/resources/js/modules/security/CsrfManager.js b/resources/js/modules/security/CsrfManager.js
new file mode 100644
index 00000000..a5583c65
--- /dev/null
+++ b/resources/js/modules/security/CsrfManager.js
@@ -0,0 +1,221 @@
+/**
+ * CSRF Manager
+ * 
+ * Handles CSRF token management including automatic refresh.
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * CsrfManager - CSRF token management
+ */
+export class CsrfManager {
+    constructor(config = {}) {
+        this.config = {
+            tokenName: config.tokenName || '_token',
+            headerName: config.headerName || 'X-CSRF-TOKEN',
+            refreshInterval: config.refreshInterval || 30 * 60 * 1000, // 30 minutes
+            autoRefresh: config.autoRefresh ?? true,
+            endpoint: config.endpoint || '/api/csrf-token',
+            ...config
+        };
+        
+        this.currentToken = null;
+        this.refreshTimer = null;
+        this.isRefreshing = false;
+        
+        // Initialize
+        this.init();
+    }
+    
+    /**
+     * Create a new CsrfManager instance
+     */
+    static create(config = {}) {
+        return new CsrfManager(config);
+    }
+    
+    /**
+     * Initialize CSRF manager
+     */
+    init() {
+        // Get initial token from meta tag or form
+        this.currentToken = this.getTokenFromPage();
+        
+        if (!this.currentToken) {
+            Logger.warn('[CsrfManager] No CSRF token found on page');
+        } else {
+            Logger.info('[CsrfManager] Initialized with token');
+        }
+        
+        // Set up auto-refresh if enabled
+        if (this.config.autoRefresh) {
+            this.startAutoRefresh();
+        }
+        
+        // Update all forms and meta tags
+        this.updateAllTokens();
+    }
+    
+    /**
+     * Get token from page (meta tag or form)
+     */
+    getTokenFromPage() {
+        // Try meta tag first
+        const metaTag = document.querySelector('meta[name="csrf-token"]');
+        if (metaTag) {
+            return metaTag.getAttribute('content');
+        }
+        
+        // Try form input
+        const formInput = document.querySelector(`input[name="${this.config.tokenName}"]`);
+        if (formInput) {
+            return formInput.value;
+        }
+        
+        return null;
+    }
+    
+    /**
+     * Get current CSRF token
+     */
+    getToken() {
+        return this.currentToken;
+    }
+    
+    /**
+     * Refresh CSRF token
+     */
+    async refreshToken() {
+        if (this.isRefreshing) {
+            Logger.debug('[CsrfManager] Token refresh already in progress');
+            return;
+        }
+        
+        this.isRefreshing = true;
+        
+        try {
+            const response = await fetch(this.config.endpoint, {
+                method: 'GET',
+                headers: {
+                    'X-Requested-With': 'XMLHttpRequest',
+                    'Accept': 'application/json'
+                }
+            });
+            
+            if (!response.ok) {
+                throw new Error(`Failed to refresh token: ${response.status}`);
+            }
+            
+            const data = await response.json();
+            const newToken = data.token || data.csrf_token || data._token;
+            
+            if (!newToken) {
+                throw new Error('No token in response');
+            }
+            
+            this.currentToken = newToken;
+            this.updateAllTokens();
+            
+            Logger.info('[CsrfManager] Token refreshed');
+            
+            // Trigger event
+            this.triggerTokenRefreshedEvent(newToken);
+            
+        } catch (error) {
+            Logger.error('[CsrfManager] Failed to refresh token', error);
+            throw error;
+        } finally {
+            this.isRefreshing = false;
+        }
+    }
+    
+    /**
+     * Update all tokens on the page
+     */
+    updateAllTokens() {
+        if (!this.currentToken) {
+            return;
+        }
+        
+        // Update meta tag
+        const metaTag = document.querySelector('meta[name="csrf-token"]');
+        if (metaTag) {
+            metaTag.setAttribute('content', this.currentToken);
+        }
+        
+        // Update all form inputs
+        const formInputs = document.querySelectorAll(`input[name="${this.config.tokenName}"]`);
+        formInputs.forEach(input => {
+            input.value = this.currentToken;
+        });
+        
+        // Update LiveComponent tokens
+        const liveComponents = document.querySelectorAll('[data-live-component]');
+        liveComponents.forEach(element => {
+            const tokenInput = element.querySelector(`input[name="${this.config.tokenName}"]`);
+            if (tokenInput) {
+                tokenInput.value = this.currentToken;
+            }
+        });
+    }
+    
+    /**
+     * Start auto-refresh timer
+     */
+    startAutoRefresh() {
+        if (this.refreshTimer) {
+            return;
+        }
+        
+        this.refreshTimer = setInterval(() => {
+            this.refreshToken().catch(error => {
+                Logger.error('[CsrfManager] Auto-refresh failed', error);
+            });
+        }, this.config.refreshInterval);
+        
+        Logger.debug('[CsrfManager] Auto-refresh started', {
+            interval: this.config.refreshInterval
+        });
+    }
+    
+    /**
+     * Stop auto-refresh timer
+     */
+    stopAutoRefresh() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+    
+    /**
+     * Get token for use in fetch requests
+     */
+    getTokenHeader() {
+        return {
+            [this.config.headerName]: this.currentToken
+        };
+    }
+    
+    /**
+     * Trigger token refreshed event
+     */
+    triggerTokenRefreshedEvent(token) {
+        const event = new CustomEvent('csrf:token-refreshed', {
+            detail: { token },
+            bubbles: true
+        });
+        window.dispatchEvent(event);
+    }
+    
+    /**
+     * Destroy CSRF manager
+     */
+    destroy() {
+        this.stopAutoRefresh();
+        this.currentToken = null;
+        Logger.info('[CsrfManager] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/security/SecurityManager.js b/resources/js/modules/security/SecurityManager.js
new file mode 100644
index 00000000..e7c7439e
--- /dev/null
+++ b/resources/js/modules/security/SecurityManager.js
@@ -0,0 +1,254 @@
+/**
+ * Security Manager
+ * 
+ * Provides security-related utilities including CSRF, XSS protection, and CSP helpers.
+ */
+
+import { Logger } from '../../core/logger.js';
+import { CsrfManager } from './CsrfManager.js';
+
+/**
+ * SecurityManager - Centralized security utilities
+ */
+export class SecurityManager {
+    constructor(config = {}) {
+        this.config = {
+            csrf: config.csrf || {},
+            xss: {
+                enabled: config.xss?.enabled ?? true,
+                sanitizeOnInput: config.xss?.sanitizeOnInput ?? false
+            },
+            csp: {
+                enabled: config.csp?.enabled ?? false,
+                reportOnly: config.csp?.reportOnly ?? false
+            },
+            ...config
+        };
+        
+        this.csrfManager = null;
+        
+        // Initialize
+        this.init();
+    }
+    
+    /**
+     * Create a new SecurityManager instance
+     */
+    static create(config = {}) {
+        return new SecurityManager(config);
+    }
+    
+    /**
+     * Initialize security manager
+     */
+    init() {
+        // Initialize CSRF manager
+        this.csrfManager = CsrfManager.create(this.config.csrf);
+        
+        // Initialize XSS protection if enabled
+        if (this.config.xss.enabled) {
+            this.initXssProtection();
+        }
+        
+        // Initialize CSP if enabled
+        if (this.config.csp.enabled) {
+            this.initCsp();
+        }
+        
+        Logger.info('[SecurityManager] Initialized', {
+            csrf: !!this.csrfManager,
+            xss: this.config.xss.enabled,
+            csp: this.config.csp.enabled
+        });
+    }
+    
+    /**
+     * Initialize XSS protection
+     */
+    initXssProtection() {
+        // Add input sanitization if enabled
+        if (this.config.xss.sanitizeOnInput) {
+            document.addEventListener('input', (event) => {
+                if (event.target.tagName === 'INPUT' || event.target.tagName === 'TEXTAREA') {
+                    this.sanitizeInput(event.target);
+                }
+            }, true);
+        }
+    }
+    
+    /**
+     * Sanitize input value
+     */
+    sanitizeInput(element) {
+        const originalValue = element.value;
+        const sanitized = this.sanitizeHtml(originalValue);
+        
+        if (sanitized !== originalValue) {
+            element.value = sanitized;
+            Logger.warn('[SecurityManager] Sanitized potentially dangerous input', {
+                field: element.name || element.id
+            });
+        }
+    }
+    
+    /**
+     * Sanitize HTML string
+     */
+    sanitizeHtml(html) {
+        if (typeof html !== 'string') {
+            return html;
+        }
+        
+        // Remove script tags and event handlers
+        return html
+            .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+            .replace(/on\w+\s*=\s*["'][^"']*["']/gi, '')
+            .replace(/javascript:/gi, '')
+            .replace(/data:text\/html/gi, '');
+    }
+    
+    /**
+     * Initialize Content Security Policy
+     */
+    initCsp() {
+        // CSP is typically set server-side, but we can validate it client-side
+        const cspHeader = this.getCspHeader();
+        
+        if (cspHeader) {
+            Logger.debug('[SecurityManager] CSP header found', cspHeader);
+            this.validateCsp(cspHeader);
+        } else {
+            Logger.warn('[SecurityManager] No CSP header found');
+        }
+    }
+    
+    /**
+     * Get CSP header from meta tag or response headers
+     */
+    getCspHeader() {
+        // Try meta tag
+        const metaTag = document.querySelector('meta[http-equiv="Content-Security-Policy"]');
+        if (metaTag) {
+            return metaTag.getAttribute('content');
+        }
+        
+        // Note: Response headers are not accessible from JavaScript
+        // This would need to be passed from server or checked server-side
+        return null;
+    }
+    
+    /**
+     * Validate CSP header
+     */
+    validateCsp(cspHeader) {
+        // Basic validation - check for common security directives
+        const requiredDirectives = ['default-src', 'script-src', 'style-src'];
+        const directives = cspHeader.split(';').map(d => d.trim().split(' ')[0]);
+        
+        const missing = requiredDirectives.filter(dir => 
+            !directives.some(d => d.toLowerCase() === dir.toLowerCase())
+        );
+        
+        if (missing.length > 0) {
+            Logger.warn('[SecurityManager] CSP missing recommended directives', missing);
+        }
+    }
+    
+    /**
+     * Get CSRF token
+     */
+    getCsrfToken() {
+        return this.csrfManager?.getToken() || null;
+    }
+    
+    /**
+     * Get CSRF token header
+     */
+    getCsrfTokenHeader() {
+        return this.csrfManager?.getTokenHeader() || {};
+    }
+    
+    /**
+     * Refresh CSRF token
+     */
+    async refreshCsrfToken() {
+        if (this.csrfManager) {
+            return await this.csrfManager.refreshToken();
+        }
+    }
+    
+    /**
+     * Validate security headers
+     */
+    validateSecurityHeaders() {
+        const issues = [];
+        
+        // Check for HTTPS
+        if (location.protocol !== 'https:' && location.hostname !== 'localhost') {
+            issues.push('Not using HTTPS');
+        }
+        
+        // Check for CSP
+        if (!this.getCspHeader()) {
+            issues.push('No Content Security Policy header');
+        }
+        
+        // Check for X-Frame-Options
+        // Note: Headers are not accessible from JavaScript, would need server-side check
+        
+        return {
+            valid: issues.length === 0,
+            issues
+        };
+    }
+    
+    /**
+     * Escape HTML to prevent XSS
+     */
+    escapeHtml(text) {
+        if (typeof text !== 'string') {
+            return text;
+        }
+        
+        const map = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#039;'
+        };
+        
+        return text.replace(/[&<>"']/g, m => map[m]);
+    }
+    
+    /**
+     * Validate URL to prevent XSS
+     */
+    validateUrl(url) {
+        try {
+            const parsed = new URL(url, window.location.origin);
+            
+            // Block javascript: and data: URLs
+            if (parsed.protocol === 'javascript:' || parsed.protocol === 'data:') {
+                return false;
+            }
+            
+            return true;
+        } catch {
+            return false;
+        }
+    }
+    
+    /**
+     * Destroy security manager
+     */
+    destroy() {
+        if (this.csrfManager) {
+            this.csrfManager.destroy();
+            this.csrfManager = null;
+        }
+        
+        Logger.info('[SecurityManager] Destroyed');
+    }
+}
+
diff --git a/resources/js/modules/security/index.js b/resources/js/modules/security/index.js
new file mode 100644
index 00000000..03129ea9
--- /dev/null
+++ b/resources/js/modules/security/index.js
@@ -0,0 +1,86 @@
+/**
+ * Security Module
+ * 
+ * Provides security-related utilities including CSRF, XSS protection, and CSP helpers.
+ * 
+ * Usage:
+ * - Add data-module="security" to enable global security features
+ * - Or import and use directly: import { SecurityManager } from './modules/security/index.js'
+ * 
+ * Features:
+ * - CSRF token management and auto-refresh
+ * - XSS protection helpers
+ * - Content Security Policy helpers
+ * - Security headers validation
+ */
+
+import { Logger } from '../../core/logger.js';
+import { SecurityManager } from './SecurityManager.js';
+import { CsrfManager } from './CsrfManager.js';
+
+const SecurityModule = {
+    name: 'security',
+    securityManager: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[SecurityModule] Module initialized');
+        
+        // Create security manager
+        this.securityManager = SecurityManager.create(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.SecurityManager = this.securityManager;
+            window.CsrfManager = this.securityManager.csrfManager;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get security manager instance
+     */
+    getSecurityManager() {
+        return this.securityManager || SecurityManager.create();
+    },
+    
+    /**
+     * Get CSRF token
+     */
+    getCsrfToken() {
+        return this.securityManager?.getCsrfToken() || null;
+    },
+    
+    /**
+     * Refresh CSRF token
+     */
+    async refreshCsrfToken() {
+        if (this.securityManager) {
+            return await this.securityManager.refreshCsrfToken();
+        }
+    },
+    
+    destroy() {
+        if (this.securityManager) {
+            this.securityManager.destroy();
+            this.securityManager = null;
+        }
+        
+        if (typeof window !== 'undefined') {
+            delete window.SecurityManager;
+            delete window.CsrfManager;
+        }
+        
+        Logger.info('[SecurityModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { SecurityManager, CsrfManager };
+
+// Export as default for module system
+export default SecurityModule;
+
+// Export init function for module system
+export const init = SecurityModule.init.bind(SecurityModule);
+
diff --git a/resources/js/modules/spa-router/SPARouter.js b/resources/js/modules/spa-router/SPARouter.js
index f44dbe43..e646bab5 100644
--- a/resources/js/modules/spa-router/SPARouter.js
+++ b/resources/js/modules/spa-router/SPARouter.js
@@ -10,6 +10,9 @@ export class SPARouter {
             enableTransitions: true,
             transitionDuration: 100, // Beschleunigt von 300ms auf 100ms
             skeletonTemplate: this.createSkeletonTemplate(),
+            // LiveComponent integration options
+            enableLiveComponentIntegration: options.enableLiveComponentIntegration ?? true,
+            preserveLiveComponentState: options.preserveLiveComponentState ?? false,
             ...options
         };
         
@@ -17,6 +20,7 @@ export class SPARouter {
         this.isLoading = false;
         this.currentUrl = window.location.href;
         this.abortController = null;
+        this.liveComponentManager = null;
         
         // Bind event handlers to preserve context for removal
         this.handleLinkClick = this.handleLinkClick.bind(this);
@@ -38,13 +42,44 @@ export class SPARouter {
             return;
         }
         
+        // Initialize LiveComponent integration if enabled
+        if (this.options.enableLiveComponentIntegration) {
+            this.initLiveComponentIntegration();
+        }
+        
         this.bindEvents();
         this.setupStyles();
         
         // Handle initial page load for history
         this.updateHistoryState(window.location.href, document.title);
         
-        Logger.info('[SPARouter] Initialized');
+        Logger.info('[SPARouter] Initialized', {
+            liveComponentIntegration: this.options.enableLiveComponentIntegration
+        });
+    }
+    
+    /**
+     * Initialize LiveComponent integration
+     */
+    initLiveComponentIntegration() {
+        // Try to get LiveComponent instance
+        // Check if it's available globally or via module system
+        if (typeof window !== 'undefined' && window.LiveComponent) {
+            this.liveComponentManager = window.LiveComponent;
+        } else {
+            // Try to import dynamically
+            import('../livecomponent/index.js').then(module => {
+                if (module.LiveComponent) {
+                    this.liveComponentManager = module.LiveComponent;
+                } else if (module.default) {
+                    this.liveComponentManager = module.default;
+                }
+            }).catch(error => {
+                Logger.warn('[SPARouter] LiveComponent not available', error);
+            });
+        }
+        
+        Logger.debug('[SPARouter] LiveComponent integration initialized');
     }
 
     bindEvents() {
@@ -231,6 +266,12 @@ export class SPARouter {
     }
 
     async updateContent(newContent, newTitle) {
+        // Save LiveComponent state before navigation if enabled
+        let savedComponentStates = null;
+        if (this.options.enableLiveComponentIntegration && this.options.preserveLiveComponentState && this.liveComponentManager) {
+            savedComponentStates = this.saveLiveComponentStates();
+        }
+        
         // Update page title
         if (newTitle) {
             document.title = newTitle;
@@ -247,6 +288,11 @@ export class SPARouter {
         // Re-initialize modules for new content
         this.reinitializeModules();
         
+        // Initialize LiveComponents in new content
+        if (this.options.enableLiveComponentIntegration) {
+            await this.initializeLiveComponents(savedComponentStates);
+        }
+        
         // Smooth transition in
         if (this.options.enableTransitions) {
             await this.transitionIn();
@@ -260,6 +306,89 @@ export class SPARouter {
         // Trigger custom event
         this.triggerNavigationEvent();
     }
+    
+    /**
+     * Save LiveComponent states before navigation
+     */
+    saveLiveComponentStates() {
+        if (!this.liveComponentManager) {
+            return null;
+        }
+        
+        const states = {};
+        const components = this.container.querySelectorAll('[data-live-component]');
+        
+        components.forEach(element => {
+            const componentId = element.getAttribute('data-live-component');
+            if (componentId && this.liveComponentManager.components) {
+                const component = this.liveComponentManager.components.get(componentId);
+                if (component) {
+                    // Get state from element's dataset
+                    const stateJson = element.dataset.state;
+                    if (stateJson) {
+                        try {
+                            states[componentId] = JSON.parse(stateJson);
+                        } catch (e) {
+                            Logger.warn(`[SPARouter] Failed to parse state for ${componentId}`, e);
+                        }
+                    }
+                }
+            }
+        });
+        
+        Logger.debug('[SPARouter] Saved LiveComponent states', Object.keys(states));
+        return states;
+    }
+    
+    /**
+     * Initialize LiveComponents in new content
+     */
+    async initializeLiveComponents(savedStates = null) {
+        if (!this.liveComponentManager) {
+            // Try to get LiveComponentManager again
+            this.initLiveComponentIntegration();
+            
+            // Wait a bit for async initialization
+            await new Promise(resolve => setTimeout(resolve, 100));
+            
+            if (!this.liveComponentManager) {
+                Logger.warn('[SPARouter] LiveComponentManager not available, skipping initialization');
+                return;
+            }
+        }
+        
+        // Find all LiveComponent elements in new content
+        const componentElements = this.container.querySelectorAll('[data-live-component]');
+        
+        if (componentElements.length === 0) {
+            return;
+        }
+        
+        Logger.info(`[SPARouter] Initializing ${componentElements.length} LiveComponents`);
+        
+        // Initialize each component
+        for (const element of componentElements) {
+            try {
+                // Restore state if available
+                if (savedStates) {
+                    const componentId = element.getAttribute('data-live-component');
+                    if (componentId && savedStates[componentId]) {
+                        const stateJson = JSON.stringify(savedStates[componentId]);
+                        element.dataset.state = stateJson;
+                    }
+                }
+                
+                // Initialize component using LiveComponent instance
+                if (this.liveComponentManager && typeof this.liveComponentManager.init === 'function') {
+                    this.liveComponentManager.init(element);
+                }
+            } catch (error) {
+                Logger.error('[SPARouter] Failed to initialize LiveComponent', error);
+            }
+        }
+        
+        Logger.debug('[SPARouter] LiveComponents initialized');
+    }
 
     showLoadingState() {
         document.body.classList.add(this.options.loadingClass);
@@ -326,6 +455,12 @@ export class SPARouter {
         
         moduleElements.forEach(element => {
             const moduleName = element.dataset.module;
+            
+            // Skip LiveComponent initialization here (handled separately)
+            if (moduleName === 'livecomponent') {
+                return;
+            }
+            
             Logger.info(`[SPARouter] Re-initializing module "${moduleName}" on new content`);
             
             // Trigger module initialization (would need access to module system)
diff --git a/resources/js/modules/state-manager/StateManager.js b/resources/js/modules/state-manager/StateManager.js
new file mode 100644
index 00000000..99edfc06
--- /dev/null
+++ b/resources/js/modules/state-manager/StateManager.js
@@ -0,0 +1,556 @@
+/**
+ * State Management Module
+ * 
+ * Provides centralized, reactive state management for client-side state.
+ * Features:
+ * - Reactive state store (similar to Redux/Vuex)
+ * - State persistence (localStorage, sessionStorage)
+ * - State synchronization across tabs (BroadcastChannel)
+ * - Integration with LiveComponents
+ * - Time-travel debugging support
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * StateManager - Centralized state management
+ */
+export class StateManager {
+    constructor(config = {}) {
+        this.state = config.initialState || {};
+        this.subscribers = new Map(); // Map<path, Set<callback>>
+        this.middleware = [];
+        this.history = []; // For time-travel debugging
+        this.maxHistorySize = config.maxHistorySize || 50;
+        this.enableHistory = config.enableHistory ?? false;
+        
+        // Persistence configuration
+        this.persistence = {
+            enabled: config.persistence?.enabled ?? false,
+            storage: config.persistence?.storage || 'localStorage', // 'localStorage' | 'sessionStorage'
+            key: config.persistence?.key || 'app-state',
+            paths: config.persistence?.paths || [] // Only persist these paths
+        };
+        
+        // Cross-tab synchronization
+        this.sync = {
+            enabled: config.sync?.enabled ?? false,
+            channel: null
+        };
+        
+        // Load persisted state
+        if (this.persistence.enabled) {
+            this.loadPersistedState();
+        }
+        
+        // Initialize cross-tab sync
+        if (this.sync.enabled && typeof BroadcastChannel !== 'undefined') {
+            this.initCrossTabSync();
+        }
+        
+        Logger.info('[StateManager] Initialized', {
+            persistence: this.persistence.enabled,
+            sync: this.sync.enabled,
+            history: this.enableHistory
+        });
+    }
+    
+    /**
+     * Create a new StateManager instance
+     */
+    static create(config = {}) {
+        return new StateManager(config);
+    }
+    
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    
+    /**
+     * Get state at a specific path
+     */
+    get(path, defaultValue = undefined) {
+        const keys = path.split('.');
+        let value = this.state;
+        
+        for (const key of keys) {
+            if (value === null || value === undefined || typeof value !== 'object') {
+                return defaultValue;
+            }
+            value = value[key];
+        }
+        
+        return value !== undefined ? value : defaultValue;
+    }
+    
+    /**
+     * Set state at a specific path
+     */
+    set(path, value) {
+        const keys = path.split('.');
+        const newState = { ...this.state };
+        let current = newState;
+        
+        // Navigate/create nested structure
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {
+                current[key] = {};
+            } else {
+                current[key] = { ...current[key] };
+            }
+            current = current[key];
+        }
+        
+        // Set the value
+        const lastKey = keys[keys.length - 1];
+        const oldValue = this.get(path);
+        current[lastKey] = value;
+        
+        // Apply middleware
+        const action = { type: 'SET', path, value, oldValue };
+        const processedAction = this.applyMiddleware(action);
+        
+        if (processedAction === null) {
+            return; // Middleware blocked the action
+        }
+        
+        // Update state
+        this.state = newState;
+        
+        // Save to history
+        if (this.enableHistory) {
+            this.addToHistory(action);
+        }
+        
+        // Persist if enabled
+        if (this.persistence.enabled && this.shouldPersist(path)) {
+            this.persistState();
+        }
+        
+        // Sync across tabs
+        if (this.sync.enabled) {
+            this.broadcastStateChange(action);
+        }
+        
+        // Notify subscribers
+        this.notifySubscribers(path, value, oldValue);
+        
+        Logger.debug('[StateManager] State updated', { path, value });
+    }
+    
+    /**
+     * Dispatch an action (similar to Redux)
+     */
+    dispatch(action) {
+        if (typeof action === 'function') {
+            // Thunk support
+            return action(this.dispatch.bind(this), this.getState.bind(this));
+        }
+        
+        if (!action.type) {
+            throw new Error('Action must have a type property');
+        }
+        
+        // Apply middleware
+        const processedAction = this.applyMiddleware(action);
+        if (processedAction === null) {
+            return; // Middleware blocked the action
+        }
+        
+        // Execute action (reducer pattern)
+        const newState = this.reducer(this.state, processedAction);
+        
+        if (newState !== this.state) {
+            const oldState = this.state;
+            this.state = newState;
+            
+            // Save to history
+            if (this.enableHistory) {
+                this.addToHistory(processedAction);
+            }
+            
+            // Persist if enabled
+            if (this.persistence.enabled) {
+                this.persistState();
+            }
+            
+            // Sync across tabs
+            if (this.sync.enabled) {
+                this.broadcastStateChange(processedAction);
+            }
+            
+            // Notify all subscribers
+            this.notifyAllSubscribers();
+        }
+        
+        Logger.debug('[StateManager] Action dispatched', processedAction);
+    }
+    
+    /**
+     * Default reducer (can be overridden)
+     */
+    reducer(state, action) {
+        // Default reducer handles SET actions
+        if (action.type === 'SET' && action.path) {
+            const keys = action.path.split('.');
+            const newState = { ...state };
+            let current = newState;
+            
+            for (let i = 0; i < keys.length - 1; i++) {
+                const key = keys[i];
+                if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {
+                    current[key] = {};
+                } else {
+                    current[key] = { ...current[key] };
+                }
+                current = current[key];
+            }
+            
+            current[keys[keys.length - 1]] = action.value;
+            return newState;
+        }
+        
+        return state;
+    }
+    
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(path, callback) {
+        if (!this.subscribers.has(path)) {
+            this.subscribers.set(path, new Set());
+        }
+        
+        this.subscribers.get(path).add(callback);
+        
+        // Return unsubscribe function
+        return () => {
+            const callbacks = this.subscribers.get(path);
+            if (callbacks) {
+                callbacks.delete(callback);
+                if (callbacks.size === 0) {
+                    this.subscribers.delete(path);
+                }
+            }
+        };
+    }
+    
+    /**
+     * Subscribe to all state changes
+     */
+    subscribeAll(callback) {
+        return this.subscribe('*', callback);
+    }
+    
+    /**
+     * Notify subscribers of a state change
+     */
+    notifySubscribers(path, newValue, oldValue) {
+        // Notify path-specific subscribers
+        const pathCallbacks = this.subscribers.get(path);
+        if (pathCallbacks) {
+            pathCallbacks.forEach(callback => {
+                try {
+                    callback(newValue, oldValue, path);
+                } catch (error) {
+                    Logger.error('[StateManager] Subscriber error', error);
+                }
+            });
+        }
+        
+        // Notify wildcard subscribers
+        const wildcardCallbacks = this.subscribers.get('*');
+        if (wildcardCallbacks) {
+            wildcardCallbacks.forEach(callback => {
+                try {
+                    callback(this.state, path);
+                } catch (error) {
+                    Logger.error('[StateManager] Subscriber error', error);
+                }
+            });
+        }
+        
+        // Notify parent path subscribers
+        const pathParts = path.split('.');
+        for (let i = pathParts.length - 1; i > 0; i--) {
+            const parentPath = pathParts.slice(0, i).join('.');
+            const parentCallbacks = this.subscribers.get(parentPath);
+            if (parentCallbacks) {
+                parentCallbacks.forEach(callback => {
+                    try {
+                        callback(this.get(parentPath), parentPath);
+                    } catch (error) {
+                        Logger.error('[StateManager] Subscriber error', error);
+                    }
+                });
+            }
+        }
+    }
+    
+    /**
+     * Notify all subscribers (for full state changes)
+     */
+    notifyAllSubscribers() {
+        this.subscribers.forEach((callbacks, path) => {
+            callbacks.forEach(callback => {
+                try {
+                    if (path === '*') {
+                        callback(this.state);
+                    } else {
+                        const value = this.get(path);
+                        callback(value, path);
+                    }
+                } catch (error) {
+                    Logger.error('[StateManager] Subscriber error', error);
+                }
+            });
+        });
+    }
+    
+    /**
+     * Add middleware
+     */
+    use(middleware) {
+        if (typeof middleware !== 'function') {
+            throw new Error('Middleware must be a function');
+        }
+        this.middleware.push(middleware);
+    }
+    
+    /**
+     * Apply middleware chain
+     */
+    applyMiddleware(action) {
+        let processedAction = action;
+        
+        for (const middleware of this.middleware) {
+            processedAction = middleware(processedAction, this.getState.bind(this));
+            if (processedAction === null) {
+                return null; // Middleware blocked the action
+            }
+        }
+        
+        return processedAction;
+    }
+    
+    /**
+     * Load persisted state
+     */
+    loadPersistedState() {
+        try {
+            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;
+            const stored = storage.getItem(this.persistence.key);
+            
+            if (stored) {
+                const parsed = JSON.parse(stored);
+                this.state = { ...this.state, ...parsed };
+                Logger.info('[StateManager] Loaded persisted state');
+            }
+        } catch (error) {
+            Logger.error('[StateManager] Failed to load persisted state', error);
+        }
+    }
+    
+    /**
+     * Persist state
+     */
+    persistState() {
+        try {
+            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;
+            const stateToPersist = this.persistence.paths.length > 0
+                ? this.getPersistedPaths()
+                : this.state;
+            
+            storage.setItem(this.persistence.key, JSON.stringify(stateToPersist));
+            Logger.debug('[StateManager] State persisted');
+        } catch (error) {
+            Logger.error('[StateManager] Failed to persist state', error);
+        }
+    }
+    
+    /**
+     * Get only paths that should be persisted
+     */
+    getPersistedPaths() {
+        const result = {};
+        for (const path of this.persistence.paths) {
+            const value = this.get(path);
+            if (value !== undefined) {
+                const keys = path.split('.');
+                let current = result;
+                for (let i = 0; i < keys.length - 1; i++) {
+                    if (!(keys[i] in current)) {
+                        current[keys[i]] = {};
+                    }
+                    current = current[keys[i]];
+                }
+                current[keys[keys.length - 1]] = value;
+            }
+        }
+        return result;
+    }
+    
+    /**
+     * Check if path should be persisted
+     */
+    shouldPersist(path) {
+        if (this.persistence.paths.length === 0) {
+            return true; // Persist all if no paths specified
+        }
+        return this.persistence.paths.some(p => path.startsWith(p));
+    }
+    
+    /**
+     * Initialize cross-tab synchronization
+     */
+    initCrossTabSync() {
+        try {
+            this.sync.channel = new BroadcastChannel('state-manager-sync');
+            
+            this.sync.channel.addEventListener('message', (event) => {
+                if (event.data.type === 'STATE_CHANGE') {
+                    this.handleRemoteStateChange(event.data.action);
+                }
+            });
+            
+            Logger.info('[StateManager] Cross-tab sync initialized');
+        } catch (error) {
+            Logger.error('[StateManager] Failed to initialize cross-tab sync', error);
+            this.sync.enabled = false;
+        }
+    }
+    
+    /**
+     * Broadcast state change to other tabs
+     */
+    broadcastStateChange(action) {
+        if (this.sync.channel) {
+            try {
+                this.sync.channel.postMessage({
+                    type: 'STATE_CHANGE',
+                    action,
+                    timestamp: Date.now()
+                });
+            } catch (error) {
+                Logger.error('[StateManager] Failed to broadcast state change', error);
+            }
+        }
+    }
+    
+    /**
+     * Handle remote state change from another tab
+     */
+    handleRemoteStateChange(action) {
+        // Apply the action without broadcasting (to avoid loops)
+        const wasSyncEnabled = this.sync.enabled;
+        this.sync.enabled = false;
+        
+        if (action.type === 'SET' && action.path) {
+            this.set(action.path, action.value);
+        } else {
+            this.dispatch(action);
+        }
+        
+        this.sync.enabled = wasSyncEnabled;
+    }
+    
+    /**
+     * Add action to history
+     */
+    addToHistory(action) {
+        this.history.push({
+            action,
+            state: JSON.parse(JSON.stringify(this.state)),
+            timestamp: Date.now()
+        });
+        
+        // Limit history size
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+    }
+    
+    /**
+     * Get history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    
+    /**
+     * Time-travel to a specific history point
+     */
+    timeTravel(index) {
+        if (index < 0 || index >= this.history.length) {
+            throw new Error('Invalid history index');
+        }
+        
+        const historyPoint = this.history[index];
+        this.state = JSON.parse(JSON.stringify(historyPoint.state));
+        this.notifyAllSubscribers();
+        
+        Logger.info('[StateManager] Time-traveled to history point', index);
+    }
+    
+    /**
+     * Reset state to initial state
+     */
+    reset() {
+        this.state = {};
+        this.history = [];
+        this.notifyAllSubscribers();
+        
+        if (this.persistence.enabled) {
+            const storage = this.persistence.storage === 'sessionStorage' ? sessionStorage : localStorage;
+            storage.removeItem(this.persistence.key);
+        }
+        
+        Logger.info('[StateManager] State reset');
+    }
+    
+    /**
+     * Destroy state manager
+     */
+    destroy() {
+        // Unsubscribe all
+        this.subscribers.clear();
+        
+        // Close cross-tab sync
+        if (this.sync.channel) {
+            this.sync.channel.close();
+            this.sync.channel = null;
+        }
+        
+        // Clear history
+        this.history = [];
+        
+        Logger.info('[StateManager] Destroyed');
+    }
+}
+
+/**
+ * Create a global state manager instance
+ */
+let globalStateManager = null;
+
+/**
+ * Get or create global state manager
+ */
+export function getGlobalStateManager(config = {}) {
+    if (!globalStateManager) {
+        globalStateManager = StateManager.create(config);
+    }
+    return globalStateManager;
+}
+
+/**
+ * Create a scoped state manager (for component-specific state)
+ */
+export function createScopedStateManager(config = {}) {
+    return StateManager.create(config);
+}
+
diff --git a/resources/js/modules/state-manager/index.js b/resources/js/modules/state-manager/index.js
new file mode 100644
index 00000000..42d49573
--- /dev/null
+++ b/resources/js/modules/state-manager/index.js
@@ -0,0 +1,75 @@
+/**
+ * State Manager Module
+ * 
+ * Provides centralized, reactive state management for client-side state.
+ * 
+ * Usage:
+ * - Add data-module="state-manager" to enable global state management
+ * - Or import and use directly: import { StateManager } from './modules/state-manager/index.js'
+ * 
+ * Features:
+ * - Reactive state store
+ * - State persistence (localStorage, sessionStorage)
+ * - Cross-tab synchronization
+ * - Integration with LiveComponents
+ * - Time-travel debugging
+ */
+
+import { Logger } from '../../core/logger.js';
+import { StateManager, getGlobalStateManager, createScopedStateManager } from './StateManager.js';
+
+const StateManagerModule = {
+    name: 'state-manager',
+    stateManager: null,
+    
+    init(config = {}, state = null) {
+        Logger.info('[StateManagerModule] Module initialized');
+        
+        // Create global state manager
+        this.stateManager = getGlobalStateManager(config);
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.StateManager = this.stateManager;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Get state manager instance
+     */
+    getStateManager() {
+        return this.stateManager || getGlobalStateManager();
+    },
+    
+    /**
+     * Create a scoped state manager
+     */
+    createScoped(config = {}) {
+        return createScopedStateManager(config);
+    },
+    
+    destroy() {
+        if (this.stateManager) {
+            this.stateManager.destroy();
+            this.stateManager = null;
+        }
+        
+        if (typeof window !== 'undefined' && window.StateManager) {
+            delete window.StateManager;
+        }
+        
+        Logger.info('[StateManagerModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { StateManager, getGlobalStateManager, createScopedStateManager };
+
+// Export as default for module system
+export default StateManagerModule;
+
+// Export init function for module system
+export const init = StateManagerModule.init.bind(StateManagerModule);
+
diff --git a/resources/js/modules/validation/ValidationRule.js b/resources/js/modules/validation/ValidationRule.js
new file mode 100644
index 00000000..db825364
--- /dev/null
+++ b/resources/js/modules/validation/ValidationRule.js
@@ -0,0 +1,46 @@
+/**
+ * ValidationRule - Individual validation rule
+ * 
+ * Represents a single validation rule with its configuration.
+ */
+
+export class ValidationRule {
+    constructor(name, validator, options = {}) {
+        this.name = name;
+        this.validator = validator;
+        this.options = options;
+    }
+    
+    /**
+     * Validate a value against this rule
+     */
+    async validate(value) {
+        if (typeof this.validator === 'function') {
+            const result = await this.validator(value, this.options);
+            return result === true ? true : (result || this.options.message || 'Validation failed');
+        }
+        return true;
+    }
+    
+    /**
+     * Get rule name
+     */
+    getName() {
+        return this.name;
+    }
+    
+    /**
+     * Get rule options
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    
+    /**
+     * Create a validation rule
+     */
+    static create(name, validator, options = {}) {
+        return new ValidationRule(name, validator, options);
+    }
+}
+
diff --git a/resources/js/modules/validation/Validator.js b/resources/js/modules/validation/Validator.js
new file mode 100644
index 00000000..ac38f3c6
--- /dev/null
+++ b/resources/js/modules/validation/Validator.js
@@ -0,0 +1,467 @@
+/**
+ * Validation Module
+ * 
+ * Provides standalone validation system for fields, forms, and data.
+ * Features:
+ * - Schema-based validation
+ * - Field-level validation
+ * - Async validation
+ * - Custom validation rules
+ * - Integration with form-handling
+ * - Integration with LiveComponents
+ */
+
+import { Logger } from '../../core/logger.js';
+
+/**
+ * Built-in validation rules
+ */
+const builtInRules = {
+    required: (value, options = {}) => {
+        if (value === null || value === undefined || value === '') {
+            return options.message || 'This field is required';
+        }
+        return true;
+    },
+    
+    email: (value, options = {}) => {
+        if (!value) return true; // Optional if not required
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        if (!emailRegex.test(value)) {
+            return options.message || 'Invalid email address';
+        }
+        return true;
+    },
+    
+    url: (value, options = {}) => {
+        if (!value) return true;
+        try {
+            new URL(value);
+            return true;
+        } catch {
+            return options.message || 'Invalid URL';
+        }
+    },
+    
+    min: (value, options = {}) => {
+        if (!value && value !== 0) return true;
+        const min = parseFloat(options.value);
+        const numValue = typeof value === 'string' ? parseFloat(value) : value;
+        if (isNaN(numValue) || numValue < min) {
+            return options.message || `Value must be at least ${min}`;
+        }
+        return true;
+    },
+    
+    max: (value, options = {}) => {
+        if (!value && value !== 0) return true;
+        const max = parseFloat(options.value);
+        const numValue = typeof value === 'string' ? parseFloat(value) : value;
+        if (isNaN(numValue) || numValue > max) {
+            return options.message || `Value must be at most ${max}`;
+        }
+        return true;
+    },
+    
+    minLength: (value, options = {}) => {
+        if (!value) return true;
+        const min = parseInt(options.value, 10);
+        if (typeof value !== 'string' || value.length < min) {
+            return options.message || `Must be at least ${min} characters`;
+        }
+        return true;
+    },
+    
+    maxLength: (value, options = {}) => {
+        if (!value) return true;
+        const max = parseInt(options.value, 10);
+        if (typeof value !== 'string' || value.length > max) {
+            return options.message || `Must be at most ${max} characters`;
+        }
+        return true;
+    },
+    
+    pattern: (value, options = {}) => {
+        if (!value) return true;
+        const regex = new RegExp(options.value);
+        if (!regex.test(value)) {
+            return options.message || 'Invalid format';
+        }
+        return true;
+    },
+    
+    number: (value, options = {}) => {
+        if (!value && value !== 0) return true;
+        if (isNaN(parseFloat(value))) {
+            return options.message || 'Must be a number';
+        }
+        return true;
+    },
+    
+    integer: (value, options = {}) => {
+        if (!value && value !== 0) return true;
+        if (!Number.isInteger(parseFloat(value))) {
+            return options.message || 'Must be an integer';
+        }
+        return true;
+    },
+    
+    phone: (value, options = {}) => {
+        if (!value) return true;
+        const phoneRegex = /^[\d\s\-\+\(\)]+$/;
+        if (!phoneRegex.test(value)) {
+            return options.message || 'Invalid phone number';
+        }
+        return true;
+    },
+    
+    postalCode: (value, options = {}) => {
+        if (!value) return true;
+        const country = options.country || 'DE';
+        const patterns = {
+            DE: /^\d{5}$/,
+            US: /^\d{5}(-\d{4})?$/,
+            UK: /^[A-Z]{1,2}\d{1,2}[A-Z]?\s?\d[A-Z]{2}$/i,
+            FR: /^\d{5}$/
+        };
+        const pattern = patterns[country] || patterns.DE;
+        if (!pattern.test(value)) {
+            return options.message || `Invalid postal code for ${country}`;
+        }
+        return true;
+    },
+    
+    custom: (value, options = {}) => {
+        if (!options.validator || typeof options.validator !== 'function') {
+            return 'Custom validator function required';
+        }
+        return options.validator(value, options);
+    }
+};
+
+/**
+ * Validator - Schema-based validation
+ */
+export class Validator {
+    constructor(schema = {}) {
+        this.schema = schema;
+        this.customRules = new Map();
+        this.errors = {};
+        this.validatedFields = new Set();
+    }
+    
+    /**
+     * Create a new Validator instance
+     */
+    static create(schema = {}) {
+        return new Validator(schema);
+    }
+    
+    /**
+     * Register a custom validation rule
+     */
+    registerRule(name, rule) {
+        if (typeof rule !== 'function') {
+            throw new Error('Validation rule must be a function');
+        }
+        this.customRules.set(name, rule);
+    }
+    
+    /**
+     * Validate a single field
+     */
+    async validateField(fieldName, value, schema = null) {
+        const fieldSchema = schema || this.schema[fieldName];
+        
+        if (!fieldSchema) {
+            return { valid: true, errors: [] };
+        }
+        
+        const errors = [];
+        
+        // Handle array of rules
+        const rules = Array.isArray(fieldSchema) ? fieldSchema : [fieldSchema];
+        
+        for (const ruleConfig of rules) {
+            const result = await this.validateRule(value, ruleConfig);
+            if (result !== true) {
+                errors.push(result);
+            }
+        }
+        
+        // Store errors
+        if (errors.length > 0) {
+            this.errors[fieldName] = errors;
+        } else {
+            delete this.errors[fieldName];
+        }
+        
+        this.validatedFields.add(fieldName);
+        
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    
+    /**
+     * Validate a single rule
+     */
+    async validateRule(value, ruleConfig) {
+        if (typeof ruleConfig === 'function') {
+            // Custom validator function
+            const result = await ruleConfig(value);
+            return result === true ? true : (result || 'Validation failed');
+        }
+        
+        if (typeof ruleConfig === 'string') {
+            // Rule name only
+            return this.executeRule(ruleConfig, value, {});
+        }
+        
+        if (typeof ruleConfig === 'object' && ruleConfig !== null) {
+            // Rule with options
+            const ruleName = ruleConfig.rule || ruleConfig.type || Object.keys(ruleConfig)[0];
+            const options = ruleConfig.options || ruleConfig[ruleName] || {};
+            
+            // Check for async validation
+            if (ruleConfig.async && typeof ruleConfig.validator === 'function') {
+                const result = await ruleConfig.validator(value, options);
+                return result === true ? true : (result || options.message || 'Validation failed');
+            }
+            
+            return this.executeRule(ruleName, value, options);
+        }
+        
+        return true;
+    }
+    
+    /**
+     * Execute a validation rule
+     */
+    executeRule(ruleName, value, options) {
+        // Check custom rules first
+        if (this.customRules.has(ruleName)) {
+            const result = this.customRules.get(ruleName)(value, options);
+            return result === true ? true : (result || options.message || 'Validation failed');
+        }
+        
+        // Check built-in rules
+        if (builtInRules[ruleName]) {
+            const result = builtInRules[ruleName](value, options);
+            return result === true ? true : (result || options.message || 'Validation failed');
+        }
+        
+        Logger.warn(`[Validator] Unknown validation rule: ${ruleName}`);
+        return true; // Unknown rules pass by default
+    }
+    
+    /**
+     * Validate entire schema
+     */
+    async validate(data) {
+        this.errors = {};
+        this.validatedFields.clear();
+        
+        const results = {};
+        let isValid = true;
+        
+        for (const fieldName in this.schema) {
+            const value = data[fieldName];
+            const result = await this.validateField(fieldName, value);
+            results[fieldName] = result;
+            
+            if (!result.valid) {
+                isValid = false;
+            }
+        }
+        
+        return {
+            valid: isValid,
+            errors: this.errors,
+            results
+        };
+    }
+    
+    /**
+     * Validate specific fields
+     */
+    async validateFields(data, fieldNames) {
+        this.errors = {};
+        
+        const results = {};
+        let isValid = true;
+        
+        for (const fieldName of fieldNames) {
+            if (!(fieldName in this.schema)) {
+                continue;
+            }
+            
+            const value = data[fieldName];
+            const result = await this.validateField(fieldName, value);
+            results[fieldName] = result;
+            
+            if (!result.valid) {
+                isValid = false;
+            }
+        }
+        
+        return {
+            valid: isValid,
+            errors: this.errors,
+            results
+        };
+    }
+    
+    /**
+     * Get errors for a specific field
+     */
+    getFieldErrors(fieldName) {
+        return this.errors[fieldName] || [];
+    }
+    
+    /**
+     * Get all errors
+     */
+    getErrors() {
+        return { ...this.errors };
+    }
+    
+    /**
+     * Check if field is valid
+     */
+    isFieldValid(fieldName) {
+        return !this.errors[fieldName] || this.errors[fieldName].length === 0;
+    }
+    
+    /**
+     * Check if all fields are valid
+     */
+    isValid() {
+        return Object.keys(this.errors).length === 0;
+    }
+    
+    /**
+     * Clear errors
+     */
+    clearErrors(fieldName = null) {
+        if (fieldName) {
+            delete this.errors[fieldName];
+        } else {
+            this.errors = {};
+        }
+    }
+    
+    /**
+     * Reset validator
+     */
+    reset() {
+        this.errors = {};
+        this.validatedFields.clear();
+    }
+    
+    /**
+     * Create validator from HTML form
+     */
+    static fromForm(form) {
+        const schema = {};
+        const fields = form.querySelectorAll('input, textarea, select');
+        
+        fields.forEach(field => {
+            if (!field.name) return;
+            
+            const rules = [];
+            
+            // Required
+            if (field.hasAttribute('required')) {
+                rules.push('required');
+            }
+            
+            // Type-based validation
+            if (field.type === 'email') {
+                rules.push('email');
+            } else if (field.type === 'url') {
+                rules.push('url');
+            } else if (field.type === 'number') {
+                rules.push('number');
+            }
+            
+            // Min/Max length
+            if (field.hasAttribute('minlength')) {
+                rules.push({
+                    rule: 'minLength',
+                    options: { value: field.getAttribute('minlength') }
+                });
+            }
+            if (field.hasAttribute('maxlength')) {
+                rules.push({
+                    rule: 'maxLength',
+                    options: { value: field.getAttribute('maxlength') }
+                });
+            }
+            
+            // Min/Max (for numbers)
+            if (field.hasAttribute('min')) {
+                rules.push({
+                    rule: 'min',
+                    options: { value: field.getAttribute('min') }
+                });
+            }
+            if (field.hasAttribute('max')) {
+                rules.push({
+                    rule: 'max',
+                    options: { value: field.getAttribute('max') }
+                });
+            }
+            
+            // Pattern
+            if (field.hasAttribute('pattern')) {
+                rules.push({
+                    rule: 'pattern',
+                    options: {
+                        value: field.getAttribute('pattern'),
+                        message: field.getAttribute('data-error-pattern') || 'Invalid format'
+                    }
+                });
+            }
+            
+            // Custom validation
+            if (field.hasAttribute('data-validate')) {
+                const validateAttr = field.getAttribute('data-validate');
+                try {
+                    const customRule = JSON.parse(validateAttr);
+                    rules.push(customRule);
+                } catch {
+                    // Treat as rule name
+                    rules.push(validateAttr);
+                }
+            }
+            
+            if (rules.length > 0) {
+                schema[field.name] = rules;
+            }
+        });
+        
+        return new Validator(schema);
+    }
+}
+
+/**
+ * ValidationRule - Individual validation rule
+ */
+export class ValidationRule {
+    constructor(name, validator, options = {}) {
+        this.name = name;
+        this.validator = validator;
+        this.options = options;
+    }
+    
+    async validate(value) {
+        if (typeof this.validator === 'function') {
+            const result = await this.validator(value, this.options);
+            return result === true ? true : (result || this.options.message || 'Validation failed');
+        }
+        return true;
+    }
+}
+
diff --git a/resources/js/modules/validation/index.js b/resources/js/modules/validation/index.js
new file mode 100644
index 00000000..02112b63
--- /dev/null
+++ b/resources/js/modules/validation/index.js
@@ -0,0 +1,71 @@
+/**
+ * Validation Module
+ * 
+ * Provides standalone validation system for fields, forms, and data.
+ * 
+ * Usage:
+ * - Import and use directly: import { Validator } from './modules/validation/index.js'
+ * - Or use with form-handling module
+ * - Or use with LiveComponents
+ * 
+ * Features:
+ * - Schema-based validation
+ * - Field-level validation
+ * - Async validation
+ * - Custom validation rules
+ * - Integration with form-handling
+ * - Integration with LiveComponents
+ */
+
+import { Logger } from '../../core/logger.js';
+import { Validator } from './Validator.js';
+import { ValidationRule } from './ValidationRule.js';
+
+const ValidationModule = {
+    name: 'validation',
+    
+    init(config = {}, state = null) {
+        Logger.info('[ValidationModule] Module initialized');
+        
+        // Expose globally for easy access
+        if (typeof window !== 'undefined') {
+            window.Validator = Validator;
+            window.ValidationRule = ValidationRule;
+        }
+        
+        return this;
+    },
+    
+    /**
+     * Create a validator from a schema
+     */
+    create(schema = {}) {
+        return Validator.create(schema);
+    },
+    
+    /**
+     * Create a validator from a form element
+     */
+    fromForm(form) {
+        return Validator.fromForm(form);
+    },
+    
+    destroy() {
+        if (typeof window !== 'undefined') {
+            delete window.Validator;
+            delete window.ValidationRule;
+        }
+        
+        Logger.info('[ValidationModule] Module destroyed');
+    }
+};
+
+// Export for direct usage
+export { Validator, ValidationRule };
+
+// Export as default for module system
+export default ValidationModule;
+
+// Export init function for module system
+export const init = ValidationModule.init.bind(ValidationModule);
+
diff --git a/resources/js/schemas/livecomponent-action-request.schema.json b/resources/js/schemas/livecomponent-action-request.schema.json
new file mode 100644
index 00000000..a165c226
--- /dev/null
+++ b/resources/js/schemas/livecomponent-action-request.schema.json
@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "LiveComponent Action Request",
+  "description": "Schema for validating LiveComponent action requests",
+  "type": "object",
+  "required": ["method", "params", "state", "_csrf_token"],
+  "properties": {
+    "method": {
+      "type": "string",
+      "description": "Component action method name",
+      "minLength": 1,
+      "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$"
+    },
+    "params": {
+      "type": "object",
+      "description": "Action parameters (key-value pairs)",
+      "additionalProperties": true
+    },
+    "state": {
+      "type": "object",
+      "description": "Current component state",
+      "additionalProperties": true
+    },
+    "_csrf_token": {
+      "type": "string",
+      "description": "CSRF token for security validation",
+      "minLength": 1
+    },
+    "fragments": {
+      "type": "array",
+      "description": "Optional fragment names for partial rendering",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true
+    }
+  },
+  "additionalProperties": false
+}
+
diff --git a/resources/js/schemas/livecomponent-action-response.schema.json b/resources/js/schemas/livecomponent-action-response.schema.json
new file mode 100644
index 00000000..76d03895
--- /dev/null
+++ b/resources/js/schemas/livecomponent-action-response.schema.json
@@ -0,0 +1,105 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "LiveComponent Action Response",
+  "description": "Schema for validating LiveComponent action responses",
+  "oneOf": [
+    {
+      "type": "object",
+      "title": "Full HTML Response",
+      "required": ["html", "state"],
+      "properties": {
+        "html": {
+          "type": "string",
+          "description": "Rendered component HTML"
+        },
+        "state": {
+          "$ref": "#/definitions/componentState"
+        },
+        "events": {
+          "type": "array",
+          "description": "Component events to dispatch",
+          "items": {
+            "$ref": "#/definitions/componentEvent"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "title": "Fragment Response",
+      "required": ["fragments", "state"],
+      "properties": {
+        "fragments": {
+          "type": "object",
+          "description": "Fragment map for partial rendering",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "state": {
+          "$ref": "#/definitions/componentState"
+        },
+        "events": {
+          "type": "array",
+          "description": "Component events to dispatch",
+          "items": {
+            "$ref": "#/definitions/componentEvent"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  ],
+  "definitions": {
+    "componentState": {
+      "type": "object",
+      "required": ["id", "component", "data", "version"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Component ID (format: component-name:instance-id)",
+          "pattern": "^[a-z0-9_-]+:[a-z0-9_.-]+$"
+        },
+        "component": {
+          "type": "string",
+          "description": "Component name",
+          "minLength": 1
+        },
+        "data": {
+          "type": "object",
+          "description": "Component state data",
+          "additionalProperties": true
+        },
+        "version": {
+          "type": "integer",
+          "description": "State version number",
+          "minimum": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "componentEvent": {
+      "type": "object",
+      "required": ["name", "payload"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Event name",
+          "minLength": 1
+        },
+        "payload": {
+          "type": "object",
+          "description": "Event payload data",
+          "additionalProperties": true
+        },
+        "target": {
+          "type": ["string", "null"],
+          "description": "Target component ID (null for broadcast)"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}
+
diff --git a/resources/js/schemas/livecomponent-error.schema.json b/resources/js/schemas/livecomponent-error.schema.json
new file mode 100644
index 00000000..538b6761
--- /dev/null
+++ b/resources/js/schemas/livecomponent-error.schema.json
@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "LiveComponent Error Response",
+  "description": "Schema for standardized error responses from LiveComponent API",
+  "type": "object",
+  "required": ["success", "error"],
+  "properties": {
+    "success": {
+      "type": "boolean",
+      "const": false
+    },
+    "error": {
+      "type": "object",
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Error code identifier",
+          "enum": [
+            "VALIDATION_ERROR",
+            "COMPONENT_NOT_FOUND",
+            "ACTION_NOT_FOUND",
+            "CSRF_TOKEN_INVALID",
+            "RATE_LIMIT_EXCEEDED",
+            "STATE_CONFLICT",
+            "UPLOAD_FAILED",
+            "PERMISSION_DENIED",
+            "INTERNAL_ERROR"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message",
+          "minLength": 1
+        },
+        "details": {
+          "type": "object",
+          "description": "Additional error details",
+          "additionalProperties": true
+        },
+        "componentId": {
+          "type": "string",
+          "description": "Component ID where error occurred"
+        },
+        "action": {
+          "type": "string",
+          "description": "Action method name that caused the error"
+        },
+        "timestamp": {
+          "type": "number",
+          "description": "Unix timestamp of error occurrence"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}
+
diff --git a/resources/js/types/analytics.d.ts b/resources/js/types/analytics.d.ts
new file mode 100644
index 00000000..2663c32e
--- /dev/null
+++ b/resources/js/types/analytics.d.ts
@@ -0,0 +1,76 @@
+/**
+ * TypeScript definitions for Analytics Module
+ */
+
+export interface AnalyticsConfig {
+    enabled?: boolean;
+    providers?: Array<string | AnalyticsProviderConfig | AnalyticsProvider>;
+    gdprCompliant?: boolean;
+    requireConsent?: boolean;
+    consentGiven?: boolean;
+    anonymizeIp?: boolean;
+}
+
+export interface AnalyticsProviderConfig {
+    type: 'google-analytics' | 'ga' | 'custom';
+    enabled?: boolean;
+    measurementId?: string;
+    gaId?: string;
+    endpoint?: string;
+    [key: string]: any;
+}
+
+export interface AnalyticsEvent {
+    name: string;
+    properties: Record<string, any>;
+    timestamp: number;
+    userId?: string | null;
+}
+
+export interface PageViewData {
+    path: string;
+    title: string;
+    properties: Record<string, any>;
+    timestamp: number;
+}
+
+export declare class AnalyticsProvider {
+    constructor(config?: AnalyticsProviderConfig);
+    
+    enabled: boolean;
+    
+    track(eventName: string, properties?: Record<string, any>): Promise<void>;
+    pageView(path: string, properties?: Record<string, any>): Promise<void>;
+    identify(userId: string, traits?: Record<string, any>): Promise<void>;
+}
+
+export declare class GoogleAnalyticsProvider extends AnalyticsProvider {
+    constructor(config?: AnalyticsProviderConfig);
+    measurementId?: string;
+}
+
+export declare class CustomProvider extends AnalyticsProvider {
+    constructor(config?: AnalyticsProviderConfig);
+    endpoint: string;
+}
+
+export declare class Analytics {
+    constructor(config?: AnalyticsConfig);
+    
+    static create(config?: AnalyticsConfig): Analytics;
+    
+    track(eventName: string, properties?: Record<string, any>): Promise<void>;
+    trackPageView(path?: string | null, properties?: Record<string, any>): Promise<void>;
+    identify(userId: string, traits?: Record<string, any>): Promise<void>;
+    trackBehavior(action: string, target: string, properties?: Record<string, any>): Promise<void>;
+    
+    giveConsent(): void;
+    revokeConsent(): void;
+    hasConsent(): boolean;
+    
+    enable(): void;
+    disable(): void;
+    
+    destroy(): void;
+}
+
diff --git a/resources/js/types/animation-system.d.ts b/resources/js/types/animation-system.d.ts
new file mode 100644
index 00000000..53e6d953
--- /dev/null
+++ b/resources/js/types/animation-system.d.ts
@@ -0,0 +1,67 @@
+/**
+ * TypeScript definitions for Animation System Module
+ */
+
+export interface AnimationConfig {
+    type: 'fade-in' | 'zoom-in' | 'parallax' | 'timeline' | 'sticky-fade' | 'sticky-steps';
+    offset?: number;
+    delay?: number;
+    once?: boolean;
+    speed?: number;
+    fadeStart?: number;
+    fadeEnd?: number;
+    steps?: number;
+    triggerPoint?: number;
+    loop?: boolean;
+}
+
+export interface AnimationSystemConfig {
+    enabled?: boolean;
+    useIntersectionObserver?: boolean;
+    throttleDelay?: number;
+}
+
+export declare class ScrollAnimation {
+    constructor(element: HTMLElement, config: AnimationConfig);
+    
+    element: HTMLElement;
+    config: AnimationConfig;
+    triggered: boolean;
+    needsUpdate: boolean;
+    
+    init(): void;
+    enter(): void;
+    exit(): void;
+    update(): void;
+    destroy(): void;
+}
+
+export declare class TimelineAnimation {
+    constructor(element: HTMLElement, config: AnimationConfig);
+    
+    element: HTMLElement;
+    config: AnimationConfig;
+    currentStep: number;
+    triggered: boolean;
+    
+    init(): void;
+    enter(): void;
+    exit(): void;
+    update(): void;
+    setStep(step: number): void;
+    setProgress(progress: number): void;
+    destroy(): void;
+}
+
+export declare class AnimationSystem {
+    constructor(config?: AnimationSystemConfig);
+    
+    static create(config?: AnimationSystemConfig): AnimationSystem;
+    
+    init(): void;
+    registerAnimation(element: HTMLElement, config: AnimationConfig): void;
+    removeAnimation(element: HTMLElement): void;
+    updateAnimations(): void;
+    destroy(): void;
+}
+
diff --git a/resources/js/types/cache-manager.d.ts b/resources/js/types/cache-manager.d.ts
new file mode 100644
index 00000000..796eeaf4
--- /dev/null
+++ b/resources/js/types/cache-manager.d.ts
@@ -0,0 +1,70 @@
+/**
+ * TypeScript definitions for Cache Manager Module
+ */
+
+export declare const CacheStrategy: {
+    readonly NO_CACHE: 'no-cache';
+    readonly CACHE_FIRST: 'cache-first';
+    readonly NETWORK_FIRST: 'network-first';
+    readonly STALE_WHILE_REVALIDATE: 'stale-while-revalidate';
+    readonly NETWORK_ONLY: 'network-only';
+    readonly CACHE_ONLY: 'cache-only';
+};
+
+export interface CacheManagerConfig {
+    defaultStrategy?: keyof typeof CacheStrategy;
+    defaultTTL?: number;
+    maxMemorySize?: number;
+    enableIndexedDB?: boolean;
+    indexedDBName?: string;
+    indexedDBVersion?: number;
+    enableAnalytics?: boolean;
+}
+
+export interface CacheOptions {
+    strategy?: keyof typeof CacheStrategy;
+    ttl?: number;
+}
+
+export interface CacheEntry {
+    key: string;
+    value: any;
+    timestamp: number;
+    ttl: number;
+    strategy: string;
+}
+
+export interface CacheAnalytics {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    total: number;
+    hitRate: number;
+    memorySize: number;
+    memoryMaxSize: number;
+}
+
+export type CachePattern = string | RegExp | ((key: string) => boolean);
+export type CacheComputeFn = () => Promise<any> | any;
+
+export declare class CacheManager {
+    constructor(config?: CacheManagerConfig);
+    
+    static create(config?: CacheManagerConfig): CacheManager;
+    
+    init(): Promise<void>;
+    get(key: string, options?: CacheOptions): Promise<any>;
+    set(key: string, value: any, options?: CacheOptions): Promise<void>;
+    getOrSet(key: string, computeFn: CacheComputeFn, options?: CacheOptions): Promise<any>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    invalidate(pattern: CachePattern): Promise<void>;
+    warm(keys: string[], computeFn: (key: string) => Promise<any> | any): Promise<void>;
+    getAnalytics(): CacheAnalytics;
+    resetAnalytics(): void;
+    destroy(): void;
+}
+
+export declare function getStrategyForUseCase(useCase: string): keyof typeof CacheStrategy;
+
diff --git a/resources/js/types/error-tracking.d.ts b/resources/js/types/error-tracking.d.ts
new file mode 100644
index 00000000..797a9b40
--- /dev/null
+++ b/resources/js/types/error-tracking.d.ts
@@ -0,0 +1,70 @@
+/**
+ * TypeScript definitions for Error Tracking Module
+ */
+
+export interface ErrorTrackerConfig {
+    endpoint?: string;
+    enabled?: boolean;
+    sampleRate?: number; // 0.0 to 1.0
+    maxErrors?: number;
+    groupingWindow?: number; // milliseconds
+    includeStack?: boolean;
+    includeContext?: boolean;
+    includeUserAgent?: boolean;
+    includeUrl?: boolean;
+    filters?: Array<((error: any, context: ErrorContext) => boolean) | RegExp>;
+    beforeSend?: (errorData: ErrorData) => ErrorData | null | false | void;
+}
+
+export interface ErrorContext {
+    type?: string;
+    filename?: string;
+    lineno?: number;
+    colno?: number;
+    userAgent?: string;
+    url?: string;
+    referrer?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    [key: string]: any;
+}
+
+export interface ErrorData {
+    message: string;
+    name: string;
+    stack?: string;
+    timestamp: number;
+    type: string;
+    context?: ErrorContext;
+    [key: string]: any;
+}
+
+export interface ErrorGroup {
+    fingerprint: string;
+    count: number;
+    firstSeen: number;
+    lastSeen: number;
+    errors: ErrorData[];
+}
+
+export declare class ErrorTracker {
+    constructor(config?: ErrorTrackerConfig);
+    
+    static create(config?: ErrorTrackerConfig): ErrorTracker;
+    
+    init(): void;
+    captureException(error: any, context?: ErrorContext): void;
+    flushReports(): Promise<void>;
+    report(): Promise<void>;
+    
+    getErrorGroups(): ErrorGroup[];
+    getErrors(): ErrorData[];
+    clearErrors(): void;
+    
+    destroy(): void;
+}
+
+export declare function getGlobalErrorTracker(config?: ErrorTrackerConfig): ErrorTracker;
+
diff --git a/resources/js/types/event-bus.d.ts b/resources/js/types/event-bus.d.ts
new file mode 100644
index 00000000..00348933
--- /dev/null
+++ b/resources/js/types/event-bus.d.ts
@@ -0,0 +1,51 @@
+/**
+ * TypeScript definitions for Event Bus Module
+ */
+
+export interface EventBusConfig {
+    enableHistory?: boolean;
+    maxHistorySize?: number;
+    enableWildcards?: boolean;
+}
+
+export interface EventOptions {
+    once?: boolean;
+    priority?: number;
+    filter?: (data: any, options?: EventOptions) => boolean;
+}
+
+export interface EventHistoryItem {
+    eventName: string;
+    data: any;
+    options: EventOptions;
+    timestamp: number;
+}
+
+export type EventCallback = (data: any, eventName?: string, options?: EventOptions) => void;
+export type EventMiddleware = (eventName: string, data: any, options?: EventOptions) => any | null | false | void;
+export type EventFilter = (item: EventHistoryItem) => boolean;
+
+export declare class EventBus {
+    constructor(config?: EventBusConfig);
+    
+    static create(config?: EventBusConfig): EventBus;
+    
+    on(eventName: string, callback: EventCallback, options?: EventOptions): () => void;
+    once(eventName: string, callback: EventCallback, options?: EventOptions): () => void;
+    off(eventName: string, callback: EventCallback): void;
+    emit(eventName: string, data?: any, options?: EventOptions): void;
+    
+    use(middleware: EventMiddleware): void;
+    
+    getHistory(filter?: string | EventFilter): EventHistoryItem[];
+    clearHistory(): void;
+    
+    getEventNames(): string[];
+    getSubscriberCount(eventName: string): number;
+    removeAllListeners(eventName?: string): void;
+    
+    destroy(): void;
+}
+
+export declare function getGlobalEventBus(config?: EventBusConfig): EventBus;
+
diff --git a/resources/js/types/livecomponent.d.ts b/resources/js/types/livecomponent.d.ts
new file mode 100644
index 00000000..43d442cd
--- /dev/null
+++ b/resources/js/types/livecomponent.d.ts
@@ -0,0 +1,233 @@
+/**
+ * LiveComponent TypeScript Definitions
+ * 
+ * Type-safe definitions for LiveComponent API communication between PHP and JavaScript
+ */
+
+/**
+ * Component ID format: "component-name:instance-id"
+ */
+export type ComponentId = string;
+
+/**
+ * Component state structure
+ */
+export interface LiveComponentState {
+    id: ComponentId;
+    component: string;
+    data: Record<string, unknown>;
+    version: number;
+}
+
+/**
+ * Action parameters (key-value pairs)
+ */
+export type ActionParams = Record<string, unknown>;
+
+/**
+ * Component event payload
+ */
+export interface EventPayload {
+    [key: string]: unknown;
+}
+
+/**
+ * Component event structure
+ */
+export interface ComponentEvent {
+    name: string;
+    payload: EventPayload;
+    target?: ComponentId | null;
+}
+
+/**
+ * Fragment map for partial rendering
+ */
+export interface FragmentMap {
+    [fragmentName: string]: string;
+}
+
+/**
+ * Action request payload
+ */
+export interface ActionRequest {
+    method: string;
+    params: ActionParams;
+    state: Record<string, unknown>;
+    _csrf_token: string;
+    fragments?: string[] | null;
+}
+
+/**
+ * Action response with full HTML
+ */
+export interface ActionResponseHtml {
+    html: string;
+    state: LiveComponentState;
+    events?: ComponentEvent[];
+}
+
+/**
+ * Action response with fragments (partial rendering)
+ */
+export interface ActionResponseFragments {
+    fragments: FragmentMap;
+    state: LiveComponentState;
+    events?: ComponentEvent[];
+}
+
+/**
+ * Union type for action responses
+ */
+export type ActionResponse = ActionResponseHtml | ActionResponseFragments;
+
+/**
+ * Standardized error format
+ */
+export interface LiveComponentError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+    componentId?: ComponentId;
+    action?: string;
+    timestamp?: number;
+}
+
+/**
+ * Error response structure
+ */
+export interface ErrorResponse {
+    success: false;
+    error: LiveComponentError;
+}
+
+/**
+ * Upload request payload
+ */
+export interface UploadRequest {
+    file: File;
+    state: Record<string, unknown>;
+    params?: ActionParams;
+    _csrf_token: string;
+}
+
+/**
+ * Upload response
+ */
+export interface UploadResponse {
+    success: true;
+    html?: string;
+    state?: LiveComponentState;
+    events?: ComponentEvent[];
+    file?: {
+        name: string;
+        size: number;
+        type: string;
+        url?: string;
+    };
+}
+
+/**
+ * Batch operation request
+ */
+export interface BatchOperation {
+    componentId: ComponentId;
+    method: string;
+    params?: ActionParams;
+    fragments?: string[] | null;
+    operationId?: string;
+}
+
+/**
+ * Batch request payload
+ */
+export interface BatchRequest {
+    operations: BatchOperation[];
+}
+
+/**
+ * Batch operation result
+ */
+export interface BatchOperationResult {
+    success: boolean;
+    componentId?: ComponentId;
+    operationId?: string;
+    html?: string;
+    fragments?: FragmentMap;
+    state?: LiveComponentState;
+    events?: ComponentEvent[];
+    error?: LiveComponentError;
+}
+
+/**
+ * Batch response
+ */
+export interface BatchResponse {
+    success_count: number;
+    failure_count: number;
+    results: BatchOperationResult[];
+}
+
+/**
+ * Component configuration
+ */
+export interface ComponentConfig {
+    id: ComponentId;
+    element: HTMLElement;
+    pollInterval?: number | null;
+    pollTimer?: number | null;
+    observer?: MutationObserver | null;
+    sseChannel?: string | null;
+}
+
+/**
+ * LiveComponent Manager interface
+ */
+export interface LiveComponentManager {
+    components: Map<ComponentId, ComponentConfig>;
+    
+    init(element: HTMLElement): void;
+    executeAction(
+        componentId: ComponentId,
+        method: string,
+        params?: ActionParams,
+        fragments?: string[] | null
+    ): Promise<ActionResponse>;
+    
+    uploadFile(
+        componentId: ComponentId,
+        file: File,
+        params?: ActionParams
+    ): Promise<UploadResponse>;
+    
+    executeBatch(
+        operations: BatchOperation[],
+        options?: { autoApply?: boolean }
+    ): Promise<BatchResponse>;
+    
+    on(
+        componentId: ComponentId,
+        eventName: string,
+        callback: (payload: EventPayload) => void
+    ): void;
+    
+    broadcast(eventName: string, payload: EventPayload): void;
+    
+    startPolling(componentId: ComponentId): void;
+    stopPolling(componentId: ComponentId): void;
+    
+    destroy(componentId: ComponentId): void;
+}
+
+/**
+ * Global LiveComponent instance
+ */
+declare global {
+    interface Window {
+        LiveComponent: LiveComponentManager;
+        liveComponents?: LiveComponentManager; // Legacy support
+    }
+}
+
+export {};
+
diff --git a/resources/js/types/router.d.ts b/resources/js/types/router.d.ts
new file mode 100644
index 00000000..b3bfa625
--- /dev/null
+++ b/resources/js/types/router.d.ts
@@ -0,0 +1,110 @@
+/**
+ * TypeScript definitions for Router Enhancement Module
+ */
+
+export interface RouteConfig {
+    path: string;
+    component: string | Function | HTMLElement;
+    name?: string;
+    title?: string;
+    meta?: Record<string, any>;
+    guards?: string[];
+    middleware?: (RouteMiddleware | string)[];
+    lazy?: boolean;
+}
+
+export interface Route {
+    path: string;
+    component: string | Function | HTMLElement;
+    name: string;
+    title: string | null;
+    meta: Record<string, any>;
+    guards: string[];
+    middleware: RouteMiddleware[];
+    lazy: boolean;
+}
+
+export interface RouterConfig {
+    mode?: 'history' | 'hash';
+    base?: string;
+    enableAnalytics?: boolean;
+}
+
+export interface NavigationContext {
+    [key: string]: any;
+}
+
+export type GuardFunction = (to: Route, from: Route | null, context?: NavigationContext) => Promise<boolean | string | { allowed: boolean; redirect?: string; reason?: string }>;
+export type MiddlewareFunction = (to: Route, from: Route | null, next: (allowed?: boolean) => void, context?: NavigationContext) => Promise<void> | void;
+export type BeforeEachHook = (to: Route, from: Route | null) => Promise<boolean | string | void> | boolean | string | void;
+export type AfterEachHook = (to: Route, from: Route | null) => Promise<void> | void;
+
+export interface GuardResult {
+    allowed: boolean;
+    redirect: string | null;
+    reason: string | null;
+}
+
+export interface RouterAnalytics {
+    navigations: Array<{
+        to: string;
+        from: string | null;
+        timestamp: number;
+        duration: number;
+    }>;
+    errors: any[];
+    totalNavigations: number;
+    totalErrors: number;
+}
+
+export declare class RouteGuard {
+    constructor(name: string, guardFn: GuardFunction);
+    
+    static create(name: string, guardFn: GuardFunction): RouteGuard;
+    
+    execute(to: Route, from: Route | null, context?: NavigationContext): Promise<GuardResult>;
+}
+
+export declare class RouteMiddleware {
+    constructor(name: string, middlewareFn: MiddlewareFunction);
+    
+    static create(name: string, middlewareFn: MiddlewareFunction): RouteMiddleware;
+    
+    execute(to: Route, from: Route | null, next: (allowed?: boolean) => void, context?: NavigationContext): Promise<void>;
+}
+
+export declare class Router {
+    constructor(config?: RouterConfig);
+    
+    static create(config?: RouterConfig): Router;
+    
+    route(path: string, config: RouteConfig): Router;
+    routes(routesConfig: RouteConfig[]): Router;
+    
+    guard(name: string, guardFn: GuardFunction): Router;
+    use(middleware: RouteMiddleware | MiddlewareFunction | string): Router;
+    
+    beforeEach(hook: BeforeEachHook): Router;
+    afterEach(hook: AfterEachHook): Router;
+    
+    navigate(path: string, options?: { container?: HTMLElement; updateHistory?: boolean }): Promise<boolean>;
+    
+    getCurrentRoute(): Route | null;
+    getAnalytics(): RouterAnalytics;
+    
+    destroy(): void;
+}
+
+export declare const BuiltInGuards: {
+    auth: RouteGuard;
+    guest: RouteGuard;
+    role: (requiredRole: string) => RouteGuard;
+    permission: (requiredPermission: string) => RouteGuard;
+};
+
+export declare const BuiltInMiddleware: {
+    analytics: RouteMiddleware;
+    loading: RouteMiddleware;
+    scrollToTop: RouteMiddleware;
+};
+
diff --git a/resources/js/types/security.d.ts b/resources/js/types/security.d.ts
new file mode 100644
index 00000000..cf109ed7
--- /dev/null
+++ b/resources/js/types/security.d.ts
@@ -0,0 +1,64 @@
+/**
+ * TypeScript definitions for Security Module
+ */
+
+export interface CsrfManagerConfig {
+    tokenName?: string;
+    headerName?: string;
+    refreshInterval?: number;
+    autoRefresh?: boolean;
+    endpoint?: string;
+}
+
+export interface XssConfig {
+    enabled?: boolean;
+    sanitizeOnInput?: boolean;
+}
+
+export interface CspConfig {
+    enabled?: boolean;
+    reportOnly?: boolean;
+}
+
+export interface SecurityManagerConfig {
+    csrf?: CsrfManagerConfig;
+    xss?: XssConfig;
+    csp?: CspConfig;
+}
+
+export interface SecurityHeadersValidation {
+    valid: boolean;
+    issues: string[];
+}
+
+export declare class CsrfManager {
+    constructor(config?: CsrfManagerConfig);
+    
+    static create(config?: CsrfManagerConfig): CsrfManager;
+    
+    init(): void;
+    getToken(): string | null;
+    refreshToken(): Promise<void>;
+    updateAllTokens(): void;
+    startAutoRefresh(): void;
+    stopAutoRefresh(): void;
+    getTokenHeader(): Record<string, string>;
+    destroy(): void;
+}
+
+export declare class SecurityManager {
+    constructor(config?: SecurityManagerConfig);
+    
+    static create(config?: SecurityManagerConfig): SecurityManager;
+    
+    init(): void;
+    getCsrfToken(): string | null;
+    getCsrfTokenHeader(): Record<string, string>;
+    refreshCsrfToken(): Promise<void>;
+    validateSecurityHeaders(): SecurityHeadersValidation;
+    escapeHtml(text: string): string;
+    validateUrl(url: string): boolean;
+    sanitizeHtml(html: string): string;
+    destroy(): void;
+}
+
diff --git a/resources/js/types/state-manager.d.ts b/resources/js/types/state-manager.d.ts
new file mode 100644
index 00000000..02cdb3e1
--- /dev/null
+++ b/resources/js/types/state-manager.d.ts
@@ -0,0 +1,64 @@
+/**
+ * TypeScript definitions for State Manager Module
+ */
+
+export interface StateManagerConfig {
+    initialState?: Record<string, any>;
+    maxHistorySize?: number;
+    enableHistory?: boolean;
+    persistence?: {
+        enabled?: boolean;
+        storage?: 'localStorage' | 'sessionStorage';
+        key?: string;
+        paths?: string[];
+    };
+    sync?: {
+        enabled?: boolean;
+    };
+}
+
+export interface StateAction {
+    type: string;
+    path?: string;
+    value?: any;
+    oldValue?: any;
+    [key: string]: any;
+}
+
+export interface HistoryPoint {
+    action: StateAction;
+    state: Record<string, any>;
+    timestamp: number;
+}
+
+export type StateSubscriber = (newValue: any, oldValue?: any, path?: string) => void;
+export type StateMiddleware = (action: StateAction, getState: () => Record<string, any>) => StateAction | null;
+export type StateReducer = (state: Record<string, any>, action: StateAction) => Record<string, any>;
+export type StateThunk = (dispatch: (action: StateAction | StateThunk) => void, getState: () => Record<string, any>) => any;
+
+export declare class StateManager {
+    constructor(config?: StateManagerConfig);
+    
+    static create(config?: StateManagerConfig): StateManager;
+    
+    getState(): Record<string, any>;
+    get(path: string, defaultValue?: any): any;
+    set(path: string, value: any): void;
+    dispatch(action: StateAction | StateThunk): void;
+    reducer(state: Record<string, any>, action: StateAction): Record<string, any>;
+    
+    subscribe(path: string, callback: StateSubscriber): () => void;
+    subscribeAll(callback: StateSubscriber): () => void;
+    
+    use(middleware: StateMiddleware): void;
+    
+    getHistory(): HistoryPoint[];
+    timeTravel(index: number): void;
+    
+    reset(): void;
+    destroy(): void;
+}
+
+export declare function getGlobalStateManager(config?: StateManagerConfig): StateManager;
+export declare function createScopedStateManager(config?: StateManagerConfig): StateManager;
+
diff --git a/resources/js/types/validation.d.ts b/resources/js/types/validation.d.ts
new file mode 100644
index 00000000..27e4a15d
--- /dev/null
+++ b/resources/js/types/validation.d.ts
@@ -0,0 +1,76 @@
+/**
+ * TypeScript definitions for Validation Module
+ */
+
+export interface ValidationSchema {
+    [fieldName: string]: ValidationRuleConfig | ValidationRuleConfig[];
+}
+
+export type ValidationRuleConfig =
+    | string
+    | ValidationRuleObject
+    | ValidationRuleFunction;
+
+export interface ValidationRuleObject {
+    rule?: string;
+    type?: string;
+    options?: ValidationRuleOptions;
+    async?: boolean;
+    validator?: (value: any, options?: ValidationRuleOptions) => boolean | string | Promise<boolean | string>;
+    message?: string;
+    [key: string]: any;
+}
+
+export interface ValidationRuleOptions {
+    value?: any;
+    message?: string;
+    country?: string;
+    validator?: (value: any, options?: ValidationRuleOptions) => boolean | string | Promise<boolean | string>;
+    [key: string]: any;
+}
+
+export type ValidationRuleFunction = (value: any) => boolean | string | Promise<boolean | string>;
+
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+
+export interface ValidationResults {
+    valid: boolean;
+    errors: Record<string, string[]>;
+    results: Record<string, ValidationResult>;
+}
+
+export declare class Validator {
+    constructor(schema?: ValidationSchema);
+    
+    static create(schema?: ValidationSchema): Validator;
+    static fromForm(form: HTMLFormElement): Validator;
+    
+    registerRule(name: string, rule: ValidationRuleFunction): void;
+    
+    validateField(fieldName: string, value: any, schema?: ValidationRuleConfig | ValidationRuleConfig[]): Promise<ValidationResult>;
+    validate(data: Record<string, any>): Promise<ValidationResults>;
+    validateFields(data: Record<string, any>, fieldNames: string[]): Promise<ValidationResults>;
+    
+    getFieldErrors(fieldName: string): string[];
+    getErrors(): Record<string, string[]>;
+    
+    isFieldValid(fieldName: string): boolean;
+    isValid(): boolean;
+    
+    clearErrors(fieldName?: string): void;
+    reset(): void;
+}
+
+export declare class ValidationRule {
+    constructor(name: string, validator: ValidationRuleFunction, options?: ValidationRuleOptions);
+    
+    static create(name: string, validator: ValidationRuleFunction, options?: ValidationRuleOptions): ValidationRule;
+    
+    validate(value: any): Promise<boolean | string>;
+    getName(): string;
+    getOptions(): ValidationRuleOptions;
+}
+
diff --git a/resources/views/errors/404.view.php b/resources/views/errors/404.view.php
new file mode 100644
index 00000000..78b9cd87
--- /dev/null
+++ b/resources/views/errors/404.view.php
@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>404 - Not Found</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            line-height: 1.6;
+            color: #333;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 2rem;
+            background: #f5f5f5;
+            text-align: center;
+        }
+        .error-container {
+            background: white;
+            border-radius: 8px;
+            padding: 3rem 2rem;
+            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+        }
+        h1 {
+            color: #d32f2f;
+            font-size: 4rem;
+            margin: 0;
+        }
+        h2 {
+            color: #666;
+            margin-top: 0.5rem;
+        }
+        .error-message {
+            background: #fff3cd;
+            border-left: 4px solid #ffc107;
+            padding: 1rem;
+            margin: 2rem 0;
+        }
+    </style>
+</head>
+<body>
+    <div class="error-container">
+        <h1>404</h1>
+        <h2>Page Not Found</h2>
+        <div class="error-message">
+            <p>The page you are looking for could not be found.</p>
+        </div>
+    </div>
+</body>
+</html>
+
diff --git a/resources/views/errors/500.view.php b/resources/views/errors/500.view.php
new file mode 100644
index 00000000..f5125d77
--- /dev/null
+++ b/resources/views/errors/500.view.php
@@ -0,0 +1,89 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>500 - Internal Server Error</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            line-height: 1.6;
+            color: #333;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 2rem;
+            background: #f5f5f5;
+        }
+        .error-container {
+            background: white;
+            border-radius: 8px;
+            padding: 2rem;
+            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+        }
+        h1 {
+            color: #d32f2f;
+            margin-top: 0;
+        }
+        .error-message {
+            background: #fff3cd;
+            border-left: 4px solid #ffc107;
+            padding: 1rem;
+            margin: 1rem 0;
+        }
+    </style>
+    <style if="$isDebugMode">
+        .debug-info {
+            background: #f8f9fa;
+            border: 1px solid #dee2e6;
+            border-radius: 4px;
+            padding: 1rem;
+            margin-top: 2rem;
+            font-family: 'Courier New', monospace;
+            font-size: 0.9rem;
+        }
+        .debug-info pre {
+            margin: 0;
+            white-space: pre-wrap;
+            word-wrap: break-word;
+        }
+        .context-item {
+            margin: 0.5rem 0;
+        }
+        .context-label {
+            font-weight: bold;
+            color: #666;
+        }
+    </style>
+</head>
+<body>
+    <div class="error-container">
+        <h1>500 - Internal Server Error</h1>
+        <div class="error-message">
+            <p>{{ $message }}</p>
+        </div>
+        <div class="debug-info" if="$isDebugMode">
+            <h3>Debug Information</h3>
+            <div class="context-item">
+                <span class="context-label">Exception:</span> {{ $exceptionClass }}
+            </div>
+            <div class="context-item" if="$debug">
+                <span class="context-label">File:</span> {{ $debug['file'] }}:{{ $debug['line'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Operation:</span> {{ $context['operation'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Component:</span> {{ $context['component'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Request ID:</span> {{ $context['request_id'] }}
+            </div>
+            <div if="$debug['trace']">
+                <h4>Stack Trace:</h4>
+                <pre>{{ $debug['trace'] }}</pre>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+
diff --git a/resources/views/errors/error.view.php b/resources/views/errors/error.view.php
new file mode 100644
index 00000000..f2739fae
--- /dev/null
+++ b/resources/views/errors/error.view.php
@@ -0,0 +1,92 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ $title }}</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            line-height: 1.6;
+            color: #333;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 2rem;
+            background: #f5f5f5;
+        }
+        .error-container {
+            background: white;
+            border-radius: 8px;
+            padding: 2rem;
+            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+        }
+        h1 {
+            color: #d32f2f;
+            margin-top: 0;
+        }
+        .error-message {
+            background: #fff3cd;
+            border-left: 4px solid #ffc107;
+            padding: 1rem;
+            margin: 1rem 0;
+        }
+    </style>
+    <style if="$isDebugMode">
+        .debug-info {
+            background: #f8f9fa;
+            border: 1px solid #dee2e6;
+            border-radius: 4px;
+            padding: 1rem;
+            margin-top: 2rem;
+            font-family: 'Courier New', monospace;
+            font-size: 0.9rem;
+        }
+        .debug-info pre {
+            margin: 0;
+            white-space: pre-wrap;
+            word-wrap: break-word;
+        }
+        .context-item {
+            margin: 0.5rem 0;
+        }
+        .context-label {
+            font-weight: bold;
+            color: #666;
+        }
+    </style>
+</head>
+<body>
+    <div class="error-container">
+        <h1>{{ $title }}</h1>
+        <div class="error-message">
+            <p>{{ $message }}</p>
+        </div>
+        <div class="debug-info" if="$isDebugMode">
+            <h3>Debug Information</h3>
+            <div class="context-item">
+                <span class="context-label">Exception:</span> {{ $exceptionClass }}
+            </div>
+            <div class="context-item" if="$debug">
+                <span class="context-label">File:</span> {{ $debug['file'] }}:{{ $debug['line'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Operation:</span> {{ $context['operation'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Component:</span> {{ $context['component'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Request ID:</span> {{ $context['request_id'] }}
+            </div>
+            <div class="context-item" if="$context">
+                <span class="context-label">Occurred At:</span> {{ $context['occurred_at'] }}
+            </div>
+            <div if="$debug['trace']">
+                <h4>Stack Trace:</h4>
+                <pre>{{ $debug['trace'] }}</pre>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+
diff --git a/build.sh b/scripts/build/build.sh
similarity index 100%
rename from build.sh
rename to scripts/build/build.sh
diff --git a/scripts/delete-all-workflow-runs.sh b/scripts/ci/delete-all-workflow-runs.sh
similarity index 100%
rename from scripts/delete-all-workflow-runs.sh
rename to scripts/ci/delete-all-workflow-runs.sh
diff --git a/scripts/extract-ci-token.yml b/scripts/ci/extract-ci-token.yml
similarity index 100%
rename from scripts/extract-ci-token.yml
rename to scripts/ci/extract-ci-token.yml
diff --git a/scripts/get-ci-token-from-vault.sh b/scripts/ci/get-ci-token-from-vault.sh
similarity index 100%
rename from scripts/get-ci-token-from-vault.sh
rename to scripts/ci/get-ci-token-from-vault.sh
diff --git a/public/chat.html b/scripts/debug/chat.html
similarity index 100%
rename from public/chat.html
rename to scripts/debug/chat.html
diff --git a/debug-component-registry.php b/scripts/debug/debug-component-registry.php
similarity index 100%
rename from debug-component-registry.php
rename to scripts/debug/debug-component-registry.php
diff --git a/scripts/debug/debug_mapper_config.php b/scripts/debug/debug_mapper_config.php
index 6604385d..3c28a8d2 100644
--- a/scripts/debug/debug_mapper_config.php
+++ b/scripts/debug/debug_mapper_config.php
@@ -7,7 +7,7 @@ require_once __DIR__ . '/vendor/autoload.php';
 use App\Framework\Console\ConsoleCommandMapper;
 use App\Framework\Console\ConsoleCommand;
 use App\Framework\Console\DemoCommand;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 echo "Testing ConsoleCommandMapper..." . PHP_EOL;
 
diff --git a/public/qr-test-all.html b/scripts/debug/qr-test-all.html
similarity index 100%
rename from public/qr-test-all.html
rename to scripts/debug/qr-test-all.html
diff --git a/public/qrcode-test.html b/scripts/debug/qrcode-test.html
similarity index 100%
rename from public/qrcode-test.html
rename to scripts/debug/qrcode-test.html
diff --git a/public/test-hot-reload.css b/scripts/debug/test-hot-reload.css
similarity index 100%
rename from public/test-hot-reload.css
rename to scripts/debug/test-hot-reload.css
diff --git a/public/test-hot-reload.html b/scripts/debug/test-hot-reload.html
similarity index 100%
rename from public/test-hot-reload.html
rename to scripts/debug/test-hot-reload.html
diff --git a/public/test-hot-reload.js b/scripts/debug/test-hot-reload.js
similarity index 100%
rename from public/test-hot-reload.js
rename to scripts/debug/test-hot-reload.js
diff --git a/public/test.html b/scripts/debug/test.html
similarity index 100%
rename from public/test.html
rename to scripts/debug/test.html
diff --git a/scripts/health-check.sh b/scripts/deployment/health-check.sh
similarity index 100%
rename from scripts/health-check.sh
rename to scripts/deployment/health-check.sh
diff --git a/scripts/migrate-env-to-base-override.sh b/scripts/deployment/migrate-env-to-base-override.sh
similarity index 100%
rename from scripts/migrate-env-to-base-override.sh
rename to scripts/deployment/migrate-env-to-base-override.sh
diff --git a/scripts/prepare-secrets.sh b/scripts/deployment/prepare-secrets.sh
similarity index 100%
rename from scripts/prepare-secrets.sh
rename to scripts/deployment/prepare-secrets.sh
diff --git a/scripts/setup-autossh.sh b/scripts/deployment/setup-autossh.sh
similarity index 100%
rename from scripts/setup-autossh.sh
rename to scripts/deployment/setup-autossh.sh
diff --git a/scripts/setup-gitea-secrets-interactive.sh b/scripts/deployment/setup-gitea-secrets-interactive.sh
similarity index 100%
rename from scripts/setup-gitea-secrets-interactive.sh
rename to scripts/deployment/setup-gitea-secrets-interactive.sh
diff --git a/scripts/setup-gitea-secrets-with-token.sh b/scripts/deployment/setup-gitea-secrets-with-token.sh
similarity index 100%
rename from scripts/setup-gitea-secrets-with-token.sh
rename to scripts/deployment/setup-gitea-secrets-with-token.sh
diff --git a/scripts/setup-gitea-secrets.sh b/scripts/deployment/setup-gitea-secrets.sh
similarity index 100%
rename from scripts/setup-gitea-secrets.sh
rename to scripts/deployment/setup-gitea-secrets.sh
diff --git a/scripts/setup-production-secrets.sh b/scripts/deployment/setup-production-secrets.sh
similarity index 100%
rename from scripts/setup-production-secrets.sh
rename to scripts/deployment/setup-production-secrets.sh
diff --git a/setup-production-ssl.sh b/scripts/deployment/setup-production-ssl.sh
similarity index 100%
rename from setup-production-ssl.sh
rename to scripts/deployment/setup-production-ssl.sh
diff --git a/scripts/setup-secrets-interactive.sh b/scripts/deployment/setup-secrets-interactive.sh
similarity index 100%
rename from scripts/setup-secrets-interactive.sh
rename to scripts/deployment/setup-secrets-interactive.sh
diff --git a/install-php85.sh b/scripts/install/install-php85.sh
similarity index 100%
rename from install-php85.sh
rename to scripts/install/install-php85.sh
diff --git a/scripts/backup.sh b/scripts/maintenance/backup.sh
similarity index 100%
rename from scripts/backup.sh
rename to scripts/maintenance/backup.sh
diff --git a/scripts/maintenance/bootstrap-discovery.php b/scripts/maintenance/bootstrap-discovery.php
index 5b42d1af..7082381e 100644
--- a/scripts/maintenance/bootstrap-discovery.php
+++ b/scripts/maintenance/bootstrap-discovery.php
@@ -19,7 +19,7 @@ use App\Framework\Discovery\Storage\DiscoveryStorageService;
 use App\Framework\Filesystem\FileScanner;
 use App\Framework\Filesystem\FileSystemService;
 use App\Framework\Logging\NullLogger;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 echo "🚀 Bootstrapping Discovery System...\n\n";
 $totalStart = microtime(true);
diff --git a/scripts/fix-worker-permissions.sh b/scripts/maintenance/fix-worker-permissions.sh
similarity index 100%
rename from scripts/fix-worker-permissions.sh
rename to scripts/maintenance/fix-worker-permissions.sh
diff --git a/fix_admin_layout.sh b/scripts/maintenance/fix_admin_layout.sh
similarity index 100%
rename from fix_admin_layout.sh
rename to scripts/maintenance/fix_admin_layout.sh
diff --git a/generate-vapid-keys.php b/scripts/maintenance/generate-vapid-keys.php
similarity index 100%
rename from generate-vapid-keys.php
rename to scripts/maintenance/generate-vapid-keys.php
diff --git a/scripts/seed-ml-models.php b/scripts/maintenance/seed-ml-models.php
similarity index 100%
rename from scripts/seed-ml-models.php
rename to scripts/maintenance/seed-ml-models.php
diff --git a/scripts/seed-notifications.php b/scripts/maintenance/seed-notifications.php
similarity index 100%
rename from scripts/seed-notifications.php
rename to scripts/maintenance/seed-notifications.php
diff --git a/generate_ssl_certificates.sh b/scripts/ssl/generate_ssl_certificates.sh
similarity index 100%
rename from generate_ssl_certificates.sh
rename to scripts/ssl/generate_ssl_certificates.sh
diff --git a/scripts/ssl-init.sh b/scripts/ssl/ssl-init.sh
similarity index 100%
rename from scripts/ssl-init.sh
rename to scripts/ssl/ssl-init.sh
diff --git a/scripts/ssl-test.sh b/scripts/ssl/ssl-test.sh
similarity index 100%
rename from scripts/ssl-test.sh
rename to scripts/ssl/ssl-test.sh
diff --git a/scripts/test-deployment-secrets.sh b/scripts/test/test-deployment-secrets.sh
similarity index 100%
rename from scripts/test-deployment-secrets.sh
rename to scripts/test/test-deployment-secrets.sh
diff --git a/scripts/test-registry-credentials.sh b/scripts/test/test-registry-credentials.sh
similarity index 100%
rename from scripts/test-registry-credentials.sh
rename to scripts/test/test-registry-credentials.sh
diff --git a/test-security.sh b/scripts/test/test-security.sh
similarity index 100%
rename from test-security.sh
rename to scripts/test/test-security.sh
diff --git a/test-simple.sh b/scripts/test/test-simple.sh
similarity index 95%
rename from test-simple.sh
rename to scripts/test/test-simple.sh
index 95d0a7ac..97410e1c 100644
--- a/test-simple.sh
+++ b/scripts/test/test-simple.sh
@@ -7,7 +7,7 @@ BASE_URL="https://localhost"
 USER_AGENT="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
 
 echo ""
-echo "📋 Test 1: CSRF Token Generation" 
+echo "📋 Test 1: CSRF Token Generation"
 echo "--------------------------------"
 
 CSRF_RESPONSE=$(curl -k -s -H "User-Agent: $USER_AGENT" -H "Accept: application/json" "$BASE_URL/api/csrf/token?action=/api/images&method=post")
@@ -15,7 +15,7 @@ CSRF_RESPONSE=$(curl -k -s -H "User-Agent: $USER_AGENT" -H "Accept: application/
 if [ $? -eq 0 ] && [[ $CSRF_RESPONSE == *"form_id"* ]]; then
     echo "✅ CSRF API working"
     echo "Response: $CSRF_RESPONSE"
-else  
+else
     echo "❌ CSRF API failed"
     exit 1
 fi
diff --git a/test-ssl.sh b/scripts/test/test-ssl.sh
similarity index 100%
rename from test-ssl.sh
rename to scripts/test/test-ssl.sh
diff --git a/test-upload-system.sh b/scripts/test/test-upload-system.sh
similarity index 100%
rename from test-upload-system.sh
rename to scripts/test/test-upload-system.sh
diff --git a/test-workflow.sh b/scripts/test/test-workflow.sh
similarity index 100%
rename from test-workflow.sh
rename to scripts/test/test-workflow.sh
diff --git a/src/Application/Admin/Analytics/AnalyticsController.php b/src/Application/Admin/Analytics/AnalyticsController.php
index 39a86fe2..37cc302f 100644
--- a/src/Application/Admin/Analytics/AnalyticsController.php
+++ b/src/Application/Admin/Analytics/AnalyticsController.php
@@ -12,14 +12,16 @@ use App\Framework\Analytics\AnalyticsCategory;
 use App\Framework\Analytics\AnalyticsCollector;
 use App\Framework\Analytics\Storage\AnalyticsStorage;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Http\Method;
 use App\Framework\Http\Status;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\ViewResult;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 
+#[AdminSection(name: 'Analytics', icon: 'chart-bar', order: 4, description: 'Analytics and reporting')]
 final class AnalyticsController
 {
     public function __construct(
@@ -32,7 +34,7 @@ final class AnalyticsController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Analytics Dashboard', icon: 'chart-bar', section: 'Analytics', order: 10)]
     #[Route(path: '/admin/analytics', method: Method::GET, name: AdminRoutes::ANALYTICS_DASHBOARD)]
     public function dashboard(): ViewResult
     {
diff --git a/src/Application/Admin/Content/ImageManagerController.php b/src/Application/Admin/Content/ImageManagerController.php
index b52547af..4e93267c 100644
--- a/src/Application/Admin/Content/ImageManagerController.php
+++ b/src/Application/Admin/Content/ImageManagerController.php
@@ -7,13 +7,15 @@ namespace App\Application\Admin\Content;
 use App\Application\Admin\Service\AdminLayoutProcessor;
 use App\Domain\Media\ImageRepository;
 use App\Domain\Media\ImageSlotRepository;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 final readonly class ImageManagerController
 {
     public function __construct(
@@ -24,8 +26,8 @@ final readonly class ImageManagerController
     ) {
     }
 
+    #[AdminPage(title: 'Images', icon: 'images', section: 'Content', order: 10)]
     #[Route(path: '/admin/content/images', method: Method::GET, name: 'admin.content.images')]
-    // #[Auth(strategy: 'ip', allowedIps: ['127.0.0.1', '::1'])]
     public function show(): ViewResult
     {
         $slots = $this->slotRepository->findAllWithImages();
diff --git a/src/Application/Admin/Content/ImageSlotsController.php b/src/Application/Admin/Content/ImageSlotsController.php
index 9792ff68..98b0faa6 100644
--- a/src/Application/Admin/Content/ImageSlotsController.php
+++ b/src/Application/Admin/Content/ImageSlotsController.php
@@ -7,14 +7,16 @@ namespace App\Application\Admin\Content;
 use App\Application\Admin\Service\AdminLayoutProcessor;
 use App\Domain\Media\ImageSlot;
 use App\Domain\Media\ImageSlotRepository;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
 use App\Framework\Http\Request;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 final readonly class ImageSlotsController
 {
     public function __construct(
@@ -24,7 +26,7 @@ final readonly class ImageSlotsController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Image Slots', icon: 'image', section: 'Content', order: 20)]
     #[Route('/admin/content/image-slots', name: 'admin.content.image-slots')]
     public function show(): ViewResult
     {
@@ -41,7 +43,6 @@ final readonly class ImageSlotsController
         return new ViewResult('imageslots', new MetaData('Image Slots', 'Image Slots Management'), $finalData);
     }
 
-    #[Auth]
     #[Route('/admin/content/image-slots/{slotName}', method: Method::POST)]
     public function update(string $slotName): ViewResult
     {
@@ -59,7 +60,6 @@ final readonly class ImageSlotsController
         return new ViewResult('imageslot', new MetaData('Edit Image Slot', 'Image Slot Management'), $finalData);
     }
 
-    #[Auth]
     #[Route('/admin/imageslots/create', method: Method::POST)]
     public function create(Request $request): void
     {
@@ -72,7 +72,6 @@ final readonly class ImageSlotsController
         // TODO: Return proper response or redirect
     }
 
-    #[Auth]
     #[Route('/admin/imageslots/edit/{id}', method: Method::PUT)]
     public function edit(Request $request, string $id): void
     {
diff --git a/src/Application/Admin/Dashboard.php b/src/Application/Admin/Dashboard.php
index 52826d48..42878447 100644
--- a/src/Application/Admin/Dashboard.php
+++ b/src/Application/Admin/Dashboard.php
@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace App\Application\Admin;
 
+use App\Framework\Admin\Attributes\AdminPage;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Core\VersionInfo;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
@@ -25,7 +25,7 @@ final readonly class Dashboard
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Dashboard', icon: 'dashboard', section: null, order: 0)]
     #[Route(path: '/admin', method: Method::GET, name: AdminRoutes::DASHBOARD)]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/Database/DatabaseBrowserController.php b/src/Application/Admin/Database/DatabaseBrowserController.php
new file mode 100644
index 00000000..518ee44b
--- /dev/null
+++ b/src/Application/Admin/Database/DatabaseBrowserController.php
@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\Database;
+
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\AdminPageRenderer;
+use App\Framework\Attributes\Route;
+use App\Framework\Database\Browser\Registry\DatabaseRegistry;
+use App\Framework\Database\Browser\Registry\TableRegistry;
+use App\Framework\Meta\MetaData;
+use App\Framework\Pagination\PaginationService;
+use App\Framework\Pagination\ValueObjects\PaginationRequest;
+use App\Framework\Router\Result\ViewResult;
+use App\Framework\View\Table\Generators\DatabaseTableGenerator;
+
+#[AdminSection(name: 'Database', icon: 'database', order: 30)]
+final readonly class DatabaseBrowserController
+{
+    public function __construct(
+        private DatabaseRegistry $databaseRegistry,
+        private TableRegistry $tableRegistry,
+        private AdminPageRenderer $pageRenderer,
+        private AdminLayoutProcessor $layoutProcessor,
+        private PaginationService $paginationService,
+        private DatabaseTableGenerator $tableGenerator,
+    ) {
+    }
+
+    #[AdminPage(title: 'Database Browser', icon: 'database', section: 'Database', order: 10)]
+    #[Route('/admin/database', name: 'admin.database.browser')]
+    public function index(): ViewResult
+    {
+        $database = $this->databaseRegistry->getCurrentDatabase();
+        $tables = $this->tableRegistry->getAllTables();
+
+        // Convert to array for pagination
+        $tablesArray = array_map(fn ($table) => $table->toArray(), $tables);
+
+        // Paginate tables
+        $paginationRequest = PaginationRequest::first(limit: 50, sortField: 'name');
+        $paginator = $this->paginationService->forArray($tablesArray);
+        $paginationResponse = $paginator->paginate($paginationRequest);
+
+        // Generate table
+        $tableData = array_map(
+            fn ($table) => [
+                'name' => $table['name'],
+                'row_count' => $table['row_count'],
+                'size_mb' => $table['size_mb'],
+                'engine' => $table['engine'],
+                'collation' => $table['collation'],
+            ],
+            $paginationResponse->data
+        );
+
+        $table = $this->tableGenerator->generate($tableData);
+
+        $data = [
+            'title' => 'Database Browser',
+            'database' => $database->toArray(),
+            'table' => $table->render(),
+            'table_count' => count($tables),
+            'pagination' => [
+                'current_page' => $paginationResponse->meta->currentPage,
+                'total_pages' => $paginationResponse->meta->totalPages,
+                'total_items' => $paginationResponse->meta->totalCount,
+                'items_per_page' => $paginationResponse->request->limit,
+            ],
+        ];
+
+        $finalData = $this->layoutProcessor->processLayoutFromArray($data);
+
+        return new ViewResult(
+            template: 'database/browser',
+            metaData: new MetaData('Database Browser', 'Admin - Database Browser'),
+            data: $finalData
+        );
+    }
+}
+
diff --git a/src/Application/Admin/Database/TableBrowserController.php b/src/Application/Admin/Database/TableBrowserController.php
new file mode 100644
index 00000000..94fb9a2d
--- /dev/null
+++ b/src/Application/Admin/Database/TableBrowserController.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\Database;
+
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Attributes\Route;
+use App\Framework\Database\Browser\Registry\TableRegistry;
+use App\Framework\Meta\MetaData;
+use App\Framework\Router\Result\ViewResult;
+use App\Framework\View\Table\Generators\DatabaseMetadataTableGenerator;
+
+final readonly class TableBrowserController
+{
+    public function __construct(
+        private TableRegistry $tableRegistry,
+        private AdminLayoutProcessor $layoutProcessor,
+        private DatabaseMetadataTableGenerator $metadataTableGenerator,
+    ) {
+    }
+
+    #[AdminPage(title: 'Table Details', icon: 'table', section: 'Database', order: 20, hidden: true)]
+    #[Route('/admin/database/table/{table}', name: 'admin.database.table')]
+    public function show(string $table): ViewResult
+    {
+        $tableSchema = $this->tableRegistry->getTableSchema($table);
+
+        if ($tableSchema === null) {
+            $data = [
+                'title' => 'Table Not Found',
+                'error' => "Table '{$table}' not found",
+            ];
+
+            $finalData = $this->layoutProcessor->processLayoutFromArray($data);
+
+            return new ViewResult(
+                template: 'database/table-detail',
+                metaData: new MetaData('Table Not Found', 'Admin - Table Not Found'),
+                data: $finalData
+            );
+        }
+
+        // Generate tables for columns, indexes, and foreign keys
+        $columnsTable = $this->metadataTableGenerator->generateColumns($tableSchema->columns);
+        $indexesTable = $this->metadataTableGenerator->generateIndexes($tableSchema->indexes);
+        $foreignKeysTable = $this->metadataTableGenerator->generateForeignKeys($tableSchema->foreignKeys);
+
+        $data = [
+            'title' => "Table: {$tableSchema->name}",
+            'table' => $tableSchema->toArray(),
+            'columns_table' => $columnsTable->render(),
+            'indexes_table' => $indexesTable->render(),
+            'foreign_keys_table' => $foreignKeysTable->render(),
+            'has_indexes' => !empty($tableSchema->indexes),
+            'has_foreign_keys' => !empty($tableSchema->foreignKeys),
+        ];
+
+        $finalData = $this->layoutProcessor->processLayoutFromArray($data);
+
+        return new ViewResult(
+            template: 'database/table-detail',
+            metaData: new MetaData("Table: {$tableSchema->name}", "Admin - Table: {$tableSchema->name}"),
+            data: $finalData
+        );
+    }
+}
+
diff --git a/src/Application/Admin/DeploymentDashboardController.php b/src/Application/Admin/DeploymentDashboardController.php
index 02361e3b..42fe8474 100644
--- a/src/Application/Admin/DeploymentDashboardController.php
+++ b/src/Application/Admin/DeploymentDashboardController.php
@@ -4,12 +4,15 @@ declare(strict_types=1);
 
 namespace App\Application\Admin;
 
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
 use App\Framework\Deployment\Pipeline\Services\PipelineHistoryService;
 use App\Framework\Deployment\Pipeline\ValueObjects\DeploymentEnvironment;
 use App\Framework\Deployment\Pipeline\ValueObjects\PipelineStatus;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
+use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\ViewResult;
 use App\Framework\Core\ValueObjects\Duration;
 
@@ -22,13 +25,15 @@ use App\Framework\Core\ValueObjects\Duration;
  * - Environment-specific metrics
  * - Recent deployments overview
  */
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class DeploymentDashboardController
 {
     public function __construct(
         private PipelineHistoryService $historyService
     ) {}
 
-    #[Route(path: '/admin/deployment/dashboard', method: Method::GET)]
+    #[AdminPage(title: 'Deployment Dashboard', icon: 'server', section: 'Infrastructure', order: 60)]
+    #[Route(path: '/admin/deployment/dashboard', method: Method::GET, name: AdminRoutes::DEPLOYMENT_DASHBOARD)]
     public function dashboard(): ViewResult
     {
         // Get overall statistics
diff --git a/src/Application/Admin/Development/DesignSystemController.php b/src/Application/Admin/Development/DesignSystemController.php
index 1d1fba84..3881946d 100644
--- a/src/Application/Admin/Development/DesignSystemController.php
+++ b/src/Application/Admin/Development/DesignSystemController.php
@@ -20,9 +20,13 @@ use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\ViewResult;
 
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+
 /**
  * Design System Documentation Controller
  */
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final readonly class DesignSystemController
 {
     public function __construct(
@@ -34,6 +38,7 @@ final readonly class DesignSystemController
     ) {
     }
 
+    #[AdminPage(title: 'Design System', icon: 'tools', section: 'Development', order: 20)]
     #[Route(path: '/admin/dev/design-system', method: Method::GET, name: 'admin.dev.design-system')]
     public function dashboard(HttpRequest $request): ViewResult
     {
diff --git a/src/Application/Admin/Development/RoutesController.php b/src/Application/Admin/Development/RoutesController.php
index 00a48f15..e2975187 100644
--- a/src/Application/Admin/Development/RoutesController.php
+++ b/src/Application/Admin/Development/RoutesController.php
@@ -5,12 +5,14 @@ declare(strict_types=1);
 namespace App\Application\Admin\Development;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final readonly class RoutesController
 {
     public function __construct(
@@ -19,7 +21,7 @@ final readonly class RoutesController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Routes', icon: 'list', section: 'Development', order: 10)]
     #[Route('/admin/dev/routes', name: 'admin.dev.routes')]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/Development/StyleguideController.php b/src/Application/Admin/Development/StyleguideController.php
index 3e64ea8a..0ac477a0 100644
--- a/src/Application/Admin/Development/StyleguideController.php
+++ b/src/Application/Admin/Development/StyleguideController.php
@@ -21,7 +21,11 @@ use App\Framework\View\Components\FormInput;
 use App\Framework\View\Components\FormRadio;
 use App\Framework\View\Components\FormSelect;
 use App\Framework\View\Components\FormTextarea;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Framework\Router\AdminRoutes;
 
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final readonly class StyleguideController
 {
     public function __construct(
@@ -30,7 +34,8 @@ final readonly class StyleguideController
     ) {
     }
 
-    #[Route(path: '/admin/dev/styleguide', method: Method::GET)]
+    #[AdminPage(title: 'Styleguide', icon: 'tools', section: 'Development', order: 40)]
+    #[Route(path: '/admin/dev/styleguide', method: Method::GET, name: AdminRoutes::DEV_STYLEGUIDE)]
     public function showStyleguide(): ViewResult
     {
         $metaData = new MetaData(
diff --git a/src/Application/Admin/Development/WafTestController.php b/src/Application/Admin/Development/WafTestController.php
index d59a8581..510bb35c 100644
--- a/src/Application/Admin/Development/WafTestController.php
+++ b/src/Application/Admin/Development/WafTestController.php
@@ -31,9 +31,13 @@ use App\Framework\Waf\Rules\RuleEngine;
 use App\Framework\Waf\ThreatAssessmentService;
 use App\Framework\Waf\WafEngine;
 
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+
 /**
  * Test controller for WAF functionality
  */
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final class WafTestController
 {
     private ?WafEngine $wafEngine = null;
@@ -46,6 +50,7 @@ final class WafTestController
     ) {
     }
 
+    #[AdminPage(title: 'WAF Test', icon: 'bug', section: 'Development', order: 30)]
     #[Route(path: '/admin/dev/waf-test', method: Method::GET, name: 'admin.dev.waf-test')]
     public function showTestPage(): ViewResult
     {
diff --git a/src/Application/Admin/Images.php b/src/Application/Admin/Images.php
index a0542008..5b99313b 100644
--- a/src/Application/Admin/Images.php
+++ b/src/Application/Admin/Images.php
@@ -6,12 +6,14 @@ namespace App\Application\Admin;
 
 use App\Domain\Media\Image;
 use App\Domain\Media\ImageRepository;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 final readonly class Images
 {
-    #[Auth]
+    #[AdminPage(title: 'Images (Debug)', icon: 'images', section: 'Content', order: 60, hidden: true)]
     #[Route('/admin/images')]
     public function showAll(ImageRepository $imageRepository): never
     {
diff --git a/src/Application/Admin/Infrastructure/CacheMetricsController.php b/src/Application/Admin/Infrastructure/CacheMetricsController.php
index f3a3e0b2..48962b0e 100644
--- a/src/Application/Admin/Infrastructure/CacheMetricsController.php
+++ b/src/Application/Admin/Infrastructure/CacheMetricsController.php
@@ -5,8 +5,9 @@ declare(strict_types=1);
 namespace App\Application\Admin\Infrastructure;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Cache\Metrics\CacheMetricsInterface;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
@@ -15,6 +16,7 @@ use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class CacheMetricsController
 {
     public function __construct(
@@ -24,7 +26,7 @@ final readonly class CacheMetricsController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Cache Metrics', icon: 'cache', section: 'Infrastructure', order: 20)]
     #[Route('/admin/infrastructure/cache', Method::GET, name: AdminRoutes::INFRASTRUCTURE_CACHE)]
     public function showDashboard(): ViewResult
     {
diff --git a/src/Application/Admin/Infrastructure/DockerController.php b/src/Application/Admin/Infrastructure/DockerController.php
new file mode 100644
index 00000000..6fb1c25a
--- /dev/null
+++ b/src/Application/Admin/Infrastructure/DockerController.php
@@ -0,0 +1,169 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\Infrastructure;
+
+use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Framework\Attributes\Route;
+use App\Framework\DateTime\Clock;
+use App\Framework\Http\Method;
+use App\Framework\Meta\MetaData;
+use App\Framework\Process\Services\DockerService;
+use App\Framework\Process\ValueObjects\Docker\DockerContainer;
+use App\Framework\Router\AdminRoutes;
+use App\Framework\Router\Result\JsonResult;
+use App\Framework\Router\Result\ViewResult;
+
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
+final readonly class DockerController
+{
+    public function __construct(
+        private DockerService $dockerService,
+        private AdminLayoutProcessor $layoutProcessor,
+        private Clock $clock,
+    ) {
+    }
+
+    #[AdminPage(title: 'Docker', icon: 'docker', section: 'Infrastructure', order: 80)]
+    #[Route(path: '/admin/infrastructure/docker', method: Method::GET, name: AdminRoutes::INFRASTRUCTURE_DOCKER)]
+    public function dashboard(): ViewResult
+    {
+        $containers = $this->dockerService->listContainers(all: true);
+        $dockerVersion = $this->dockerService->getVersion();
+        $isRunning = $this->dockerService->isRunning();
+
+        // Get stats for running containers
+        $containerStats = [];
+        foreach ($containers as $container) {
+            if ($container->isRunning) {
+                $stats = $this->dockerService->getContainerStats($container->id);
+                if ($stats !== null) {
+                    $containerStats[$container->id] = $stats->toArray();
+                }
+            }
+        }
+
+        // Prepare container data
+        $containerData = [];
+        foreach ($containers as $container) {
+            $stats = $containerStats[$container->id] ?? null;
+            $containerData[] = [
+                'id' => $container->id,
+                'name' => $container->name,
+                'image' => $container->image,
+                'status' => $container->status,
+                'is_running' => $container->isRunning,
+                'stats' => $stats,
+            ];
+        }
+
+        $data = [
+            'title' => 'Docker Dashboard',
+            'docker_version' => $dockerVersion,
+            'is_running' => $isRunning,
+            'containers' => $containerData,
+            'total_containers' => count($containers),
+            'running_containers' => count(array_filter($containers, fn($c) => $c->isRunning)),
+            'stopped_containers' => count(array_filter($containers, fn($c) => !$c->isRunning)),
+            'current_year' => $this->clock->now()->format('Y'),
+        ];
+
+        $finalData = $this->layoutProcessor->processLayoutFromArray($data);
+
+        return new ViewResult(
+            template: 'docker-dashboard',
+            metaData: new MetaData('Docker Dashboard', 'Docker container management and monitoring'),
+            data: $finalData
+        );
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers', method: Method::GET)]
+    public function apiContainers(): JsonResult
+    {
+        $containers = $this->dockerService->listContainers(all: true);
+        $containerData = array_map(fn($c) => $c->toArray(), $containers);
+
+        return new JsonResult([
+            'success' => true,
+            'data' => $containerData,
+        ]);
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers/{containerId}/stats', method: Method::GET)]
+    public function apiContainerStats(string $containerId): JsonResult
+    {
+        $stats = $this->dockerService->getContainerStats($containerId);
+
+        if ($stats === null) {
+            return new JsonResult([
+                'success' => false,
+                'error' => 'Container not found or not running',
+            ], 404);
+        }
+
+        return new JsonResult([
+            'success' => true,
+            'data' => $stats->toArray(),
+        ]);
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers/{containerId}/logs', method: Method::GET)]
+    public function apiContainerLogs(string $containerId): JsonResult
+    {
+        $lines = 100;
+        $logs = $this->dockerService->getContainerLogs($containerId, $lines);
+
+        if ($logs === null) {
+            return new JsonResult([
+                'success' => false,
+                'error' => 'Failed to retrieve logs',
+            ], 404);
+        }
+
+        return new JsonResult([
+            'success' => true,
+            'data' => [
+                'container_id' => $containerId,
+                'logs' => $logs,
+                'lines' => $lines,
+            ],
+        ]);
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers/{containerId}/start', method: Method::POST)]
+    public function apiStartContainer(string $containerId): JsonResult
+    {
+        $success = $this->dockerService->startContainer($containerId);
+
+        return new JsonResult([
+            'success' => $success,
+            'message' => $success ? 'Container started' : 'Failed to start container',
+        ]);
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers/{containerId}/stop', method: Method::POST)]
+    public function apiStopContainer(string $containerId): JsonResult
+    {
+        $success = $this->dockerService->stopContainer($containerId);
+
+        return new JsonResult([
+            'success' => $success,
+            'message' => $success ? 'Container stopped' : 'Failed to stop container',
+        ]);
+    }
+
+    #[Route(path: '/admin/infrastructure/docker/api/containers/{containerId}/restart', method: Method::POST)]
+    public function apiRestartContainer(string $containerId): JsonResult
+    {
+        $success = $this->dockerService->restartContainer($containerId);
+
+        return new JsonResult([
+            'success' => $success,
+            'message' => $success ? 'Container restarted' : 'Failed to restart container',
+        ]);
+    }
+}
+
diff --git a/src/Application/Admin/Infrastructure/LogViewerController.php b/src/Application/Admin/Infrastructure/LogViewerController.php
index 026667e1..c89478fa 100644
--- a/src/Application/Admin/Infrastructure/LogViewerController.php
+++ b/src/Application/Admin/Infrastructure/LogViewerController.php
@@ -5,6 +5,8 @@ declare(strict_types=1);
 namespace App\Application\Admin\Infrastructure;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
 use App\Framework\Core\ValueObjects\Duration;
 use App\Framework\DateTime\Clock;
@@ -15,10 +17,12 @@ use App\Framework\Http\SseStream;
 use App\Framework\Http\Status;
 use App\Framework\Logging\LogViewer;
 use App\Framework\Meta\MetaData;
+use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\SseResult;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class LogViewerController
 {
     public function __construct(
@@ -29,7 +33,8 @@ final readonly class LogViewerController
     ) {
     }
 
-    #[Route('/admin/infrastructure/logs', Method::GET)]
+    #[AdminPage(title: 'Log Viewer', icon: 'logs', section: 'Infrastructure', order: 40)]
+    #[Route('/admin/infrastructure/logs', Method::GET, name: AdminRoutes::INFRASTRUCTURE_LOGS)]
     public function showLogViewer(): ViewResult
     {
         $metaData = new MetaData(
diff --git a/src/Application/Admin/Infrastructure/RedisController.php b/src/Application/Admin/Infrastructure/RedisController.php
index 99a028c9..fc4a32e4 100644
--- a/src/Application/Admin/Infrastructure/RedisController.php
+++ b/src/Application/Admin/Infrastructure/RedisController.php
@@ -5,14 +5,16 @@ declare(strict_types=1);
 namespace App\Application\Admin\Infrastructure;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Redis\Services\RedisMonitoringService;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class RedisController
 {
     public function __construct(
@@ -22,7 +24,7 @@ final readonly class RedisController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Redis', icon: 'redis', section: 'Infrastructure', order: 10)]
     #[Route(path: '/admin/infrastructure/redis', method: Method::GET, name: 'admin.infrastructure.redis')]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/Infrastructure/ServicesController.php b/src/Application/Admin/Infrastructure/ServicesController.php
index c5b9a4df..45cc4e2a 100644
--- a/src/Application/Admin/Infrastructure/ServicesController.php
+++ b/src/Application/Admin/Infrastructure/ServicesController.php
@@ -5,14 +5,16 @@ declare(strict_types=1);
 namespace App\Application\Admin\Infrastructure;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class ServicesController
 {
     public function __construct(
@@ -22,7 +24,7 @@ final readonly class ServicesController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Services', icon: 'server', section: 'Infrastructure', order: 30)]
     #[Route(path: '/admin/infrastructure/services', method: Method::GET, name: 'admin.infrastructure.services')]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/JobDashboardController.php b/src/Application/Admin/JobDashboardController.php
index 2f30e0a2..cb6ccd87 100644
--- a/src/Application/Admin/JobDashboardController.php
+++ b/src/Application/Admin/JobDashboardController.php
@@ -22,6 +22,9 @@ use App\Framework\Queue\Services\JobMetricsManagerInterface;
 use App\Framework\Queue\Services\WorkerRegistry;
 use App\Framework\Router\Result\ViewResult;
 use App\Framework\Scheduler\Services\SchedulerService;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Framework\Router\AdminRoutes;
 
 /**
  * Job Dashboard Controller
@@ -34,6 +37,7 @@ use App\Framework\Scheduler\Services\SchedulerService;
  *
  * Uses composable LiveComponents for modular, reusable UI.
  */
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class JobDashboardController
 {
     public function __construct(
@@ -44,7 +48,8 @@ final readonly class JobDashboardController
         private SchedulerService $scheduler
     ) {}
 
-    #[Route(path: '/admin/jobs/dashboard', method: Method::GET)]
+    #[AdminPage(title: 'Job Dashboard', icon: 'terminal', section: 'Infrastructure', order: 70)]
+    #[Route(path: '/admin/jobs/dashboard', method: Method::GET, name: AdminRoutes::JOBS_DASHBOARD)]
     public function dashboard(): ViewResult
     {
         // Create composable LiveComponents
diff --git a/src/Application/Admin/MachineLearning/MLDashboardAdminController.php b/src/Application/Admin/MachineLearning/MLDashboardAdminController.php
index 02c40514..2b9add82 100644
--- a/src/Application/Admin/MachineLearning/MLDashboardAdminController.php
+++ b/src/Application/Admin/MachineLearning/MLDashboardAdminController.php
@@ -6,7 +6,6 @@ namespace App\Application\Admin\MachineLearning;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Core\ValueObjects\Duration;
 use App\Framework\Http\HttpRequest;
 use App\Framework\Http\Method;
@@ -15,7 +14,10 @@ use App\Framework\MachineLearning\ModelManagement\ModelRegistry;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\ViewResult;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 
+#[AdminSection(name: 'Machine Learning', icon: 'brain', order: 7, description: 'Machine Learning model management')]
 final readonly class MLDashboardAdminController
 {
     public function __construct(
@@ -24,7 +26,7 @@ final readonly class MLDashboardAdminController
         private AdminLayoutProcessor $layoutProcessor
     ) {}
 
-    #[Auth]
+    #[AdminPage(title: 'ML Dashboard', icon: 'brain', section: 'Machine Learning', order: 10)]
     #[Route(path: '/admin/ml/dashboard', method: Method::GET, name: AdminRoutes::ML_DASHBOARD)]
     public function dashboard(HttpRequest $request): ViewResult
     {
diff --git a/src/Application/Admin/MigrationStatus.php b/src/Application/Admin/MigrationStatus.php
index 729ab351..b3e911b1 100644
--- a/src/Application/Admin/MigrationStatus.php
+++ b/src/Application/Admin/MigrationStatus.php
@@ -5,8 +5,9 @@ declare(strict_types=1);
 namespace App\Application\Admin;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Database\Migration\MigrationLoader;
 use App\Framework\Database\Migration\MigrationRunner;
 use App\Framework\Http\Method;
@@ -17,6 +18,7 @@ use App\Framework\View\Table\Table;
 use App\Framework\View\Table\TableBuilder;
 use App\Framework\View\Table\ValueObjects\ColumnDefinition;
 
+#[AdminSection(name: 'Infrastructure', icon: 'database', order: 2, description: 'Infrastructure monitoring and management')]
 final readonly class MigrationStatus
 {
     public function __construct(
@@ -26,7 +28,7 @@ final readonly class MigrationStatus
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Migrations', icon: 'database', section: 'Infrastructure', order: 50)]
     #[Route(path: '/admin/infrastructure/migrations', method: Method::GET, name: AdminRoutes::MIGRATIONS)]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/Notifications/NotificationsAdminController.php b/src/Application/Admin/Notifications/NotificationsAdminController.php
index 238b90ea..0bf12689 100644
--- a/src/Application/Admin/Notifications/NotificationsAdminController.php
+++ b/src/Application/Admin/Notifications/NotificationsAdminController.php
@@ -13,12 +13,16 @@ use App\Framework\Http\Responses\JsonResponse;
 use App\Framework\Notification\Storage\NotificationRepository;
 use App\Framework\Notification\ValueObjects\NotificationId;
 use App\Framework\Meta\MetaData;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Framework\Router\AdminRoutes;
 
 /**
  * Admin Notifications Controller
  *
  * Displays and manages system notifications for administrators
  */
+#[AdminSection(name: 'Notifications', icon: 'bell', order: 6, description: 'System notifications')]
 final readonly class NotificationsAdminController
 {
     public function __construct(
@@ -28,7 +32,8 @@ final readonly class NotificationsAdminController
     /**
      * Display notifications list
      */
-    #[Route(path: '/admin/notifications', method: Method::GET)]
+    #[AdminPage(title: 'Notifications', icon: 'bell', section: 'Notifications', order: 10)]
+    #[Route(path: '/admin/notifications', method: Method::GET, name: AdminRoutes::NOTIFICATIONS)]
     public function index(HttpRequest $request): ViewResult
     {
         // For now, use 'admin' as recipient ID
diff --git a/src/Application/Admin/PreSaveCampaignAdminController.php b/src/Application/Admin/PreSaveCampaignAdminController.php
index a071ad43..fad6adbb 100644
--- a/src/Application/Admin/PreSaveCampaignAdminController.php
+++ b/src/Application/Admin/PreSaveCampaignAdminController.php
@@ -24,12 +24,15 @@ use App\Framework\Http\Method;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\Redirect;
 use App\Framework\Router\Result\ViewResult;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 
 /**
  * Pre-Save Campaign Admin Controller
  *
  * Admin interface for managing pre-save campaigns
  */
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 #[AdminResource(
     name: 'presave-campaigns',
     singularName: 'Pre-Save Campaign',
@@ -52,6 +55,7 @@ final readonly class PreSaveCampaignAdminController
     /**
      * List all campaigns
      */
+    #[AdminPage(title: 'Pre-Save Campaigns', icon: 'music', section: 'Content', order: 40)]
     #[Route('/admin/presave-campaigns', Method::GET)]
     public function index(): ViewResult
     {
@@ -121,6 +125,7 @@ final readonly class PreSaveCampaignAdminController
     /**
      * Show campaign statistics
      */
+    #[AdminPage(title: 'Pre-Save Campaign', icon: 'music', section: 'Content', order: 40, hidden: true)]
     #[Route('/admin/presave-campaigns/{id}', Method::GET)]
     public function show(int $id): ViewResult
     {
diff --git a/src/Application/Admin/PreSaveCampaignController.php b/src/Application/Admin/PreSaveCampaignController.php
index fdd56fc3..96dfcbb9 100644
--- a/src/Application/Admin/PreSaveCampaignController.php
+++ b/src/Application/Admin/PreSaveCampaignController.php
@@ -8,7 +8,6 @@ use App\Domain\PreSave\PreSaveCampaign;
 use App\Domain\PreSave\PreSaveCampaignRepository;
 use App\Domain\PreSave\PreSaveRegistrationRepository;
 use App\Domain\PreSave\ValueObjects\CampaignStatus;
-use App\Framework\Attributes\Auth;
 use App\Framework\Attributes\Route;
 use App\Framework\Core\Method;
 use App\Framework\Exception\ErrorCode;
@@ -17,11 +16,13 @@ use App\Framework\Http\HttpRequest;
 use App\Framework\Http\JsonResult;
 use App\Framework\Http\Redirect;
 use App\Framework\Http\ViewResult;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 
 /**
- * Admin Controller for Pre-Save Campaign Management
+ * Admin Controller for Pre-Save Campaign Management (Legacy)
  */
-#[Auth(strategy: 'ip', allowedIps: ['127.0.0.1', '::1'])]
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 final readonly class PreSaveCampaignController
 {
     public function __construct(
@@ -33,6 +34,7 @@ final readonly class PreSaveCampaignController
     /**
      * Show all campaigns overview
      */
+    #[AdminPage(title: 'Pre-Save Campaigns (Legacy)', icon: 'music', section: 'Content', order: 70, hidden: true)]
     #[Route(path: '/admin/presave/campaigns', method: Method::GET)]
     public function index(HttpRequest $request): ViewResult
     {
diff --git a/src/Application/Admin/Registry/AdminNavigationRegistry.php b/src/Application/Admin/Registry/AdminNavigationRegistry.php
new file mode 100644
index 00000000..d37565cc
--- /dev/null
+++ b/src/Application/Admin/Registry/AdminNavigationRegistry.php
@@ -0,0 +1,272 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\Registry;
+
+use App\Application\Admin\Service\AdminPageDiscovery;
+use App\Application\Admin\ValueObjects\AdminPageMetadata;
+use App\Application\Admin\ValueObjects\AdminSectionMetadata;
+use App\Application\Admin\ValueObjects\NavigationItem;
+use App\Application\Admin\ValueObjects\NavigationMenu;
+use App\Application\Admin\ValueObjects\NavigationSection;
+use App\Framework\Icon\Icon;
+use App\Framework\Icon\IconRegistry;
+use App\Framework\Router\UrlGenerator;
+
+/**
+ * AdminNavigationRegistry
+ *
+ * Central registry for admin navigation structure.
+ * Groups pages by section and provides navigation menu generation.
+ */
+final class AdminNavigationRegistry
+{
+    /** @var array<string, AdminPageMetadata> */
+    private array $pages = [];
+
+    /** @var array<string, AdminSectionMetadata> */
+    private array $sections = [];
+
+    private bool $initialized = false;
+
+    public function __construct(
+        private readonly AdminPageDiscovery $pageDiscovery,
+        private readonly UrlGenerator       $urlGenerator,
+        private readonly IconRegistry       $iconRegistry
+    ) {
+    }
+
+    /**
+     * Initialize registry by discovering pages
+     */
+    public function initialize(): void
+    {
+        if ($this->initialized) {
+            return;
+        }
+
+        $pages = $this->pageDiscovery->discoverPages();
+        $sectionMetadata = $this->pageDiscovery->discoverSections();
+
+        // Build pages index
+        foreach ($pages as $page) {
+            $this->pages[$page->path] = $page;
+        }
+
+        // Build sections index
+        foreach ($sectionMetadata as $sectionName => $metadata) {
+            $this->sections[$sectionName] = new AdminSectionMetadata(
+                name: $metadata['name'],
+                icon: $metadata['icon'] ?? null,
+                order: $metadata['order'] ?? 0,
+                description: $metadata['description'] ?? null
+            );
+        }
+
+        $this->initialized = true;
+    }
+
+    /**
+     * Get navigation menu grouped by sections
+     */
+    public function getNavigationMenu(string $currentPath): NavigationMenu
+    {
+        $this->initialize();
+
+        // Group pages by section
+        $pagesBySection = [];
+        foreach ($this->pages as $page) {
+            $sectionName = $page->section ?? 'Other';
+            if (! isset($pagesBySection[$sectionName])) {
+                $pagesBySection[$sectionName] = [];
+            }
+            $pagesBySection[$sectionName][] = $page;
+        }
+
+        // Sort pages within each section by order
+        foreach ($pagesBySection as $sectionName => $pages) {
+            usort($pages, fn (AdminPageMetadata $a, AdminPageMetadata $b) => $a->order <=> $b->order);
+            $pagesBySection[$sectionName] = $pages;
+        }
+
+        // Build navigation sections
+        $navigationSections = [];
+        foreach ($pagesBySection as $sectionName => $pages) {
+            $items = [];
+            foreach ($pages as $page) {
+                $url = $this->getUrlForPage($page);
+                $icon = $page->getIcon();
+                $items[] = new NavigationItem(
+                    name: $page->title,
+                    url: $url,
+                    icon: $icon,
+                    isActive: $this->isPageActive($page, $currentPath)
+                );
+            }
+
+            // Get section metadata or create default
+            $sectionMetadata = $this->sections[$sectionName] ?? new AdminSectionMetadata(
+                name: $sectionName,
+                icon: $this->getDefaultSectionIcon($sectionName),
+                order: $this->getDefaultSectionOrder($sectionName)
+            );
+
+            $navigationSections[] = new NavigationSection(
+                name: $sectionMetadata->name,
+                items: $items,
+                icon: $sectionMetadata->icon
+            );
+        }
+
+        // Sort sections by order
+        usort($navigationSections, function (NavigationSection $a, NavigationSection $b) {
+            $orderA = $this->sections[$a->name]?->order ?? $this->getDefaultSectionOrder($a->name);
+            $orderB = $this->sections[$b->name]?->order ?? $this->getDefaultSectionOrder($b->name);
+            return $orderA <=> $orderB;
+        });
+
+        return new NavigationMenu($navigationSections);
+    }
+
+    /**
+     * Get breadcrumbs for current path
+     *
+     * @return array<array{name: string, url: string|null}>
+     */
+    public function getBreadcrumbs(string $currentPath): array
+    {
+        $this->initialize();
+
+        $adminDashboardUrl = '/admin';
+        try {
+            $adminDashboardUrl = $this->urlGenerator->route('admin.dashboard');
+        } catch (\Exception) {
+            // Fallback to default
+        }
+
+        $breadcrumbs = [
+            ['name' => 'Admin', 'url' => $adminDashboardUrl],
+        ];
+
+        // Find page matching current path
+        $currentPage = null;
+        foreach ($this->pages as $page) {
+            if ($page->path === $currentPath || str_starts_with($currentPath, $page->path)) {
+                $currentPage = $page;
+                break;
+            }
+        }
+
+        if ($currentPage === null) {
+            return $breadcrumbs;
+        }
+
+        // Add section if available
+        if ($currentPage->section !== null && $currentPage->section !== 'Other') {
+            $breadcrumbs[] = ['name' => $currentPage->section, 'url' => null];
+        }
+
+        // Add current page
+        $breadcrumbs[] = [
+            'name' => $currentPage->title,
+            'url' => $this->getUrlForPage($currentPage),
+        ];
+
+        return $breadcrumbs;
+    }
+
+    /**
+     * Get all pages
+     *
+     * @return array<AdminPageMetadata>
+     */
+    public function getAllPages(): array
+    {
+        $this->initialize();
+        return array_values($this->pages);
+    }
+
+    /**
+     * Get pages by section
+     *
+     * @return array<string, array<AdminPageMetadata>>
+     */
+    public function getPagesBySection(): array
+    {
+        $this->initialize();
+
+        $pagesBySection = [];
+        foreach ($this->pages as $page) {
+            $sectionName = $page->section ?? 'Other';
+            if (! isset($pagesBySection[$sectionName])) {
+                $pagesBySection[$sectionName] = [];
+            }
+            $pagesBySection[$sectionName][] = $page;
+        }
+
+        return $pagesBySection;
+    }
+
+    /**
+     * Get URL for a page
+     */
+    private function getUrlForPage(AdminPageMetadata $page): string
+    {
+        // Try to use route name if available
+        if (! empty($page->routeName)) {
+            try {
+                return $this->urlGenerator->route($page->routeName);
+            } catch (\Exception) {
+                // Fallback to path
+            }
+        }
+
+        return $page->path;
+    }
+
+    /**
+     * Check if page is active
+     */
+    private function isPageActive(AdminPageMetadata $page, string $currentPath): bool
+    {
+        return $page->path === $currentPath || str_starts_with($currentPath, $page->path . '/');
+    }
+
+    /**
+     * Get default icon for section
+     */
+    private function getDefaultSectionIcon(string $sectionName): Icon|string|null
+    {
+        $iconName = match (strtolower($sectionName)) {
+            'system' => 'server',
+            'infrastructure' => 'database',
+            'content' => 'photo',
+            'analytics' => 'chart-bar',
+            'development' => 'code',
+            'notifications' => 'bell',
+            'machinelearning' => 'brain',
+            default => 'file',
+        };
+
+        return $this->iconRegistry->get($iconName) ?? Icon::font($iconName);
+    }
+
+    /**
+     * Get default order for section
+     */
+    private function getDefaultSectionOrder(string $sectionName): int
+    {
+        return match (strtolower($sectionName)) {
+            'system' => 1,
+            'infrastructure' => 2,
+            'content' => 3,
+            'analytics' => 4,
+            'development' => 5,
+            'notifications' => 6,
+            'machinelearning' => 7,
+            default => 99,
+        };
+    }
+}
+
diff --git a/src/Application/Admin/Service/AdminNavigationService.php b/src/Application/Admin/Service/AdminNavigationService.php
index 47658926..02d9af04 100644
--- a/src/Application/Admin/Service/AdminNavigationService.php
+++ b/src/Application/Admin/Service/AdminNavigationService.php
@@ -4,135 +4,57 @@ declare(strict_types=1);
 
 namespace App\Application\Admin\Service;
 
+use App\Application\Admin\Registry\AdminNavigationRegistry;
+use App\Framework\Http\HttpRequest;
+use App\Framework\Icon\IconRegistry;
 use App\Framework\Router\UrlGenerator;
 
 final readonly class AdminNavigationService
 {
     public function __construct(
-        private UrlGenerator $urlGenerator
+        private AdminNavigationRegistry $navigationRegistry,
+        private UrlGenerator $urlGenerator,
+        private HttpRequest $request,
+        private IconRegistry $iconRegistry
     ) {
     }
 
+    /**
+     * Get navigation menu as array (backward compatible format)
+     *
+     * @return array<string, array{icon: string, items: array<string, string>}>
+     */
     public function getNavigationMenu(): array
     {
-        error_log("AdminNavigationService: Starting navigation menu generation");
-
-        $menuDefinition = [
-            'System' => [
-                'icon' => 'server',
-                'routes' => [
-                    'Dashboard' => 'admin.dashboard',
-                    'Performance' => 'admin.system.performance',
-                    'Environment' => 'admin.system.environment',
-                    'Health Check' => 'admin.system.health',
-                    'PHP Info' => 'admin.system.phpinfo',
-                ],
-            ],
-            'Infrastructure' => [
-                'icon' => 'database',
-                'routes' => [
-                    'Redis' => 'admin.infrastructure.redis',
-                    'Cache Metrics' => 'admin.infrastructure.cache',
-                    'Services' => 'admin.infrastructure.services',
-                ],
-                'static' => [
-                    'Logs' => '/admin/infrastructure/logs', // TODO: Add named route
-                ],
-            ],
-            'Development' => [
-                'icon' => 'code',
-                'routes' => [
-                    'Routes' => 'admin.dev.routes',
-                    'Design System' => 'admin.dev.design-system',
-                    'WAF Testing' => 'admin.dev.waf-test',
-                ],
-                'static' => [
-                    'Style Guide' => '/admin/dev/styleguide', // TODO: Add named route
-                ],
-            ],
-            'Analytics' => [
-                'icon' => 'chart-bar',
-                'routes' => [
-                    'Dashboard' => 'admin.analytics.dashboard',
-                ],
-            ],
-            'Content' => [
-                'icon' => 'photo',
-                'routes' => [
-                    'Image Manager' => 'admin.content.images',
-                    'Image Slots' => 'admin.content.image-slots',
-                ],
-            ],
-        ];
+        $currentPath = $this->request->getPath();
+        $navigationMenu = $this->navigationRegistry->getNavigationMenu($currentPath);
 
+        // Convert NavigationMenu to legacy array format for backward compatibility
         $menu = [];
-
-        foreach ($menuDefinition as $sectionName => $sectionData) {
-            error_log("AdminNavigationService: Processing section '{$sectionName}'");
-
+        foreach ($navigationMenu->sections as $section) {
             $items = [];
-
-            // Process routes
-            if (isset($sectionData['routes'])) {
-                foreach ($sectionData['routes'] as $itemName => $routeName) {
-                    try {
-                        $items[$itemName] = $this->urlGenerator->route($routeName);
-                        error_log("AdminNavigationService: Successfully generated route '{$routeName}' for '{$itemName}'");
-                    } catch (\Exception $e) {
-                        error_log("AdminNavigationService: Failed to generate route '{$routeName}' for '{$itemName}': " . $e->getMessage());
-
-                        // Generate fallback URL from route name - better mapping
-                        $fallbackUrl = match ($routeName) {
-                            'admin.dashboard' => '/admin',
-                            'admin.system.health' => '/admin/system/health',
-                            'admin.system.phpinfo' => '/admin/system/phpinfo',
-                            'admin.system.performance' => '/admin/system/performance',
-                            'admin.system.environment' => '/admin/system/environment',
-                            'admin.infrastructure.redis' => '/admin/infrastructure/redis',
-                            'admin.infrastructure.cache' => '/admin/infrastructure/cache',
-                            'admin.infrastructure.services' => '/admin/infrastructure/services',
-                            'admin.dev.routes' => '/admin/dev/routes',
-                            'admin.dev.design-system' => '/admin/dev/design-system',
-                            'admin.dev.waf-test' => '/admin/dev/waf-test',
-                            'admin.analytics.dashboard' => '/admin/analytics/dashboard',
-                            'admin.content.images' => '/admin/content/images',
-                            'admin.content.image-slots' => '/admin/content/image-slots',
-                            default => '/' . str_replace('.', '/', $routeName)
-                        };
-
-                        $items[$itemName] = $fallbackUrl;
-                        error_log("AdminNavigationService: Using fallback URL '{$fallbackUrl}' for '{$itemName}'");
-                    }
-                }
+            foreach ($section->items as $item) {
+                $items[$item->name] = $item->url;
             }
 
-            // Add static routes
-            if (isset($sectionData['static'])) {
-                foreach ($sectionData['static'] as $itemName => $url) {
-                    $items[$itemName] = $url;
-                    error_log("AdminNavigationService: Added static route '{$url}' for '{$itemName}'");
-                }
-            }
-
-            $menu[$sectionName] = [
-                'icon' => $sectionData['icon'],
+            $icon = $section->getIcon();
+            $menu[$section->name] = [
+                'icon' => $icon?->toString() ?? 'file',
                 'items' => $items,
             ];
         }
 
-        error_log("AdminNavigationService: Successfully completed navigation menu generation");
-
         return $menu;
     }
 
     public function getCurrentSection(string $currentPath): ?string
     {
-        $menu = $this->getNavigationMenu();
+        $navigationMenu = $this->navigationRegistry->getNavigationMenu($currentPath);
 
-        foreach ($menu as $section => $data) {
-            foreach ($data['items'] as $name => $url) {
-                if (str_starts_with($currentPath, $url)) {
-                    return $section;
+        foreach ($navigationMenu->sections as $section) {
+            foreach ($section->items as $item) {
+                if (str_starts_with($currentPath, $item->url)) {
+                    return $section->name;
                 }
             }
         }
@@ -140,37 +62,24 @@ final readonly class AdminNavigationService
         return null;
     }
 
+    /**
+     * Get breadcrumbs for current path
+     *
+     * @return array<array{name: string, url: string|null}>
+     */
     public function getBreadcrumbs(string $currentPath): array
     {
-        $menu = $this->getNavigationMenu();
-        $breadcrumbs = [
-            ['name' => 'Admin', 'url' => $this->urlGenerator->route('admin.dashboard')],
-        ];
-
-        foreach ($menu as $section => $data) {
-            foreach ($data['items'] as $name => $url) {
-                if ($currentPath === $url || str_starts_with($currentPath, $url)) {
-                    if ($url !== $this->urlGenerator->route('admin.dashboard')) {
-                        $breadcrumbs[] = ['name' => $section, 'url' => null];
-                        $breadcrumbs[] = ['name' => $name, 'url' => $url];
-                    }
-
-                    return $breadcrumbs;
-                }
-            }
-        }
-
-        return $breadcrumbs;
+        return $this->navigationRegistry->getBreadcrumbs($currentPath);
     }
 
     public function getActiveMenuItem(string $currentPath): ?string
     {
-        $menu = $this->getNavigationMenu();
+        $navigationMenu = $this->navigationRegistry->getNavigationMenu($currentPath);
 
-        foreach ($menu as $section => $data) {
-            foreach ($data['items'] as $name => $url) {
-                if ($currentPath === $url || str_starts_with($currentPath, $url)) {
-                    return $name;
+        foreach ($navigationMenu->sections as $section) {
+            foreach ($section->items as $item) {
+                if ($currentPath === $item->url || str_starts_with($currentPath, $item->url)) {
+                    return $item->name;
                 }
             }
         }
diff --git a/src/Application/Admin/Service/AdminPageDiscovery.php b/src/Application/Admin/Service/AdminPageDiscovery.php
new file mode 100644
index 00000000..fe48ff6b
--- /dev/null
+++ b/src/Application/Admin/Service/AdminPageDiscovery.php
@@ -0,0 +1,356 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\Service;
+
+use App\Application\Admin\ValueObjects\AdminPageMetadata;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
+use App\Framework\Attributes\Route;
+use App\Framework\Auth\Auth;
+use App\Framework\Discovery\Results\DiscoveryRegistry;
+use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
+use App\Framework\Icon\Icon;
+use App\Framework\Icon\IconRegistry;
+use App\Framework\Http\Method;
+
+/**
+ * AdminPageDiscovery Service
+ *
+ * Automatically discovers admin pages from Route attributes and optional AdminPage attributes.
+ * Filters routes starting with /admin/ and extracts metadata for navigation.
+ */
+final readonly class AdminPageDiscovery
+{
+    public function __construct(
+        private DiscoveryRegistry $discoveryRegistry,
+        private IconRegistry $iconRegistry
+    ) {
+    }
+
+    /**
+     * Discover all admin pages from routes
+     *
+     * @return array<AdminPageMetadata>
+     */
+    public function discoverPages(): array
+    {
+        $routeAttributes = $this->discoveryRegistry->attributes->get(Route::class);
+        $adminPages = [];
+
+        foreach ($routeAttributes as $routeAttribute) {
+            $path = $this->extractPath($routeAttribute);
+            
+            // Only process admin routes
+            if (! str_starts_with($path, '/admin/')) {
+                continue;
+            }
+
+            // Only process GET routes for navigation (exclude API routes)
+            $method = $this->extractMethod($routeAttribute);
+            if ($method !== Method::GET || str_starts_with($path, '/admin/api/')) {
+                continue;
+            }
+
+            // Extract metadata
+            $pageMetadata = $this->buildPageMetadata($routeAttribute, $path);
+            
+            if ($pageMetadata !== null && ! $pageMetadata->hidden) {
+                $adminPages[] = $pageMetadata;
+            }
+        }
+
+        return $adminPages;
+    }
+
+    /**
+     * Extract section metadata from controller class
+     *
+     * @return array<string, mixed>
+     */
+    public function discoverSections(): array
+    {
+        $sections = [];
+        $routeAttributes = $this->discoveryRegistry->attributes->get(Route::class);
+
+        // Get all unique controller classes with admin routes
+        $controllerClasses = [];
+        foreach ($routeAttributes as $routeAttribute) {
+            $path = $this->extractPath($routeAttribute);
+            if (str_starts_with($path, '/admin/')) {
+                $controllerClass = $routeAttribute->className->getFullyQualified();
+                if (! isset($controllerClasses[$controllerClass])) {
+                    $controllerClasses[$controllerClass] = $routeAttribute;
+                }
+            }
+        }
+
+        // Check for AdminSection attributes on controllers
+        foreach ($controllerClasses as $controllerClass => $routeAttribute) {
+            $sectionMetadata = $this->extractSectionMetadata($controllerClass);
+            if ($sectionMetadata !== null) {
+                $sectionName = $sectionMetadata['name'];
+                if (! isset($sections[$sectionName])) {
+                    $sections[$sectionName] = $sectionMetadata;
+                }
+            }
+        }
+
+        return $sections;
+    }
+
+    /**
+     * Build page metadata from route attribute
+     */
+    private function buildPageMetadata(DiscoveredAttribute $routeAttribute, string $path): ?AdminPageMetadata
+    {
+        $controllerClass = $routeAttribute->className->getFullyQualified();
+        $methodName = $routeAttribute->methodName?->toString() ?? '';
+        $routeName = $this->extractRouteName($routeAttribute);
+
+        // Extract AdminPage attribute if present
+        $adminPageAttribute = $this->extractAdminPageAttribute($routeAttribute);
+
+        // Generate default title from method/controller name
+        $title = $adminPageAttribute?->title ?? $this->generateTitle($methodName, $controllerClass, $path);
+
+        // Generate default section from namespace
+        $section = $adminPageAttribute?->section ?? $this->extractSectionFromNamespace($controllerClass);
+
+        // Generate default icon
+        $icon = $adminPageAttribute?->getIcon() ?? $this->generateDefaultIcon($section);
+
+        return new AdminPageMetadata(
+            path: $path,
+            title: $title,
+            routeName: $routeName,
+            controllerClass: $controllerClass,
+            methodName: $methodName,
+            icon: $icon,
+            section: $section,
+            order: $adminPageAttribute?->order ?? 0,
+            hidden: $adminPageAttribute?->hidden ?? false,
+            description: $adminPageAttribute?->description
+        );
+    }
+
+    /**
+     * Extract AdminPage attribute from route attribute
+     */
+    private function extractAdminPageAttribute(DiscoveredAttribute $routeAttribute): ?AdminPage
+    {
+        // Check if AdminPage attribute exists on the same method
+        $controllerClass = $routeAttribute->className->getFullyQualified();
+        $methodName = $routeAttribute->methodName?->toString();
+
+        if ($methodName === null) {
+            return null;
+        }
+
+        try {
+            $reflection = new \ReflectionMethod($controllerClass, $methodName);
+            $attributes = $reflection->getAttributes(AdminPage::class);
+
+            if (! empty($attributes)) {
+                return $attributes[0]->newInstance();
+            }
+        } catch (\ReflectionException) {
+            // Ignore reflection errors
+        }
+
+        return null;
+    }
+
+    /**
+     * Extract AdminSection attribute from controller class
+     *
+     * @return array<string, mixed>|null
+     */
+    private function extractSectionMetadata(string $controllerClass): ?array
+    {
+        try {
+            $reflection = new \ReflectionClass($controllerClass);
+            $attributes = $reflection->getAttributes(AdminSection::class);
+
+            if (! empty($attributes)) {
+                $sectionAttribute = $attributes[0]->newInstance();
+                $icon = $sectionAttribute->getIcon();
+                return [
+                    'name' => $sectionAttribute->name ?? $this->extractSectionFromNamespace($controllerClass),
+                    'icon' => $icon?->toString(),
+                    'order' => $sectionAttribute->order,
+                    'description' => $sectionAttribute->description,
+                ];
+            }
+        } catch (\ReflectionException) {
+            // Ignore reflection errors
+        }
+
+        return null;
+    }
+
+    /**
+     * Extract section name from namespace
+     */
+    private function extractSectionFromNamespace(string $controllerClass): string
+    {
+        // Extract namespace segment after Application\Admin
+        // e.g., App\Application\Admin\System\HealthController -> System
+        if (preg_match('/App\\\Application\\\Admin\\\\([^\\\\]+)/', $controllerClass, $matches)) {
+            return $matches[1];
+        }
+
+        // Fallback: use last namespace segment
+        $parts = explode('\\', $controllerClass);
+        $className = end($parts);
+        
+        // Remove "Controller" suffix if present
+        if (str_ends_with($className, 'Controller')) {
+            $className = substr($className, 0, -10);
+        }
+
+        return $className;
+    }
+
+    /**
+     * Generate title from method/controller name
+     */
+    private function generateTitle(string $methodName, string $controllerClass, string $path): string
+    {
+        // Try to extract from route name first
+        $routeName = $this->extractRouteNameFromPath($path);
+        if ($routeName !== null) {
+            return $this->formatTitle($routeName);
+        }
+
+        // Use method name (e.g., "show" -> "Show", "index" -> "Index")
+        if ($methodName !== '') {
+            return $this->formatTitle($methodName);
+        }
+
+        // Extract from controller class name
+        $parts = explode('\\', $controllerClass);
+        $className = end($parts);
+        
+        // Remove "Controller" suffix
+        if (str_ends_with($className, 'Controller')) {
+            $className = substr($className, 0, -10);
+        }
+
+        return $this->formatTitle($className);
+    }
+
+    /**
+     * Format string as title (e.g., "health_check" -> "Health Check")
+     */
+    private function formatTitle(string $text): string
+    {
+        // Replace underscores and dashes with spaces
+        $text = str_replace(['_', '-'], ' ', $text);
+        
+        // Capitalize words
+        return ucwords(strtolower($text));
+    }
+
+    /**
+     * Generate default icon based on section
+     */
+    private function generateDefaultIcon(?string $section): ?Icon
+    {
+        if ($section === null) {
+            return null;
+        }
+
+        $iconName = match (strtolower($section)) {
+            'system' => 'server',
+            'infrastructure' => 'database',
+            'content' => 'photo',
+            'analytics' => 'chart-bar',
+            'development' => 'code',
+            'notifications' => 'bell',
+            'machinelearning' => 'brain',
+            default => 'file',
+        };
+
+        return $this->iconRegistry->get($iconName) ?? Icon::font($iconName);
+    }
+
+    /**
+     * Extract path from route attribute
+     */
+    private function extractPath(DiscoveredAttribute $routeAttribute): string
+    {
+        $path = $routeAttribute->additionalData['path'] ?? '';
+        
+        if (empty($path) && isset($routeAttribute->arguments['path'])) {
+            $path = $routeAttribute->arguments['path'];
+            if (is_object($path) && method_exists($path, 'toString')) {
+                $path = $path->toString();
+            }
+        }
+
+        return (string) $path;
+    }
+
+    /**
+     * Extract HTTP method from route attribute
+     */
+    private function extractMethod(DiscoveredAttribute $routeAttribute): Method
+    {
+        $method = $routeAttribute->additionalData['method'] ?? null;
+        
+        if ($method === null && isset($routeAttribute->arguments['method'])) {
+            $method = $routeAttribute->arguments['method'];
+        }
+
+        if ($method instanceof Method) {
+            return $method;
+        }
+
+        if (is_string($method)) {
+            return Method::from(strtoupper($method));
+        }
+
+        // Default to GET
+        return Method::GET;
+    }
+
+    /**
+     * Extract route name from route attribute
+     */
+    private function extractRouteName(DiscoveredAttribute $routeAttribute): string
+    {
+        $name = $routeAttribute->additionalData['name'] ?? '';
+        
+        if (empty($name) && isset($routeAttribute->arguments['name'])) {
+            $name = $routeAttribute->arguments['name'];
+            if (is_object($name) && method_exists($name, 'value')) {
+                $name = $name->value;
+            }
+        }
+
+        return (string) $name;
+    }
+
+    /**
+     * Extract route name from path as fallback
+     */
+    private function extractRouteNameFromPath(string $path): ?string
+    {
+        // Remove /admin prefix
+        $path = str_replace('/admin/', '', $path);
+        
+        // Remove leading slash
+        $path = ltrim($path, '/');
+        
+        if (empty($path)) {
+            return null;
+        }
+
+        // Use last segment as name
+        $parts = explode('/', $path);
+        return end($parts);
+    }
+}
+
diff --git a/src/Application/Admin/ShowDiscovery.php b/src/Application/Admin/ShowDiscovery.php
index 12dedc0d..f73722fa 100644
--- a/src/Application/Admin/ShowDiscovery.php
+++ b/src/Application/Admin/ShowDiscovery.php
@@ -4,11 +4,13 @@ declare(strict_types=1);
 
 namespace App\Application\Admin;
 
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Cache\Cache;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final readonly class ShowDiscovery
 {
     public function __construct(
@@ -16,7 +18,7 @@ final readonly class ShowDiscovery
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Discovery (Debug)', icon: 'code', section: 'Development', order: 50, hidden: true)]
     #[Route('/admin/discovery')]
     public function show(
         #Cache $cache
diff --git a/src/Application/Admin/ShowImageManager.php b/src/Application/Admin/ShowImageManager.php
index 06e85fc2..01467f86 100644
--- a/src/Application/Admin/ShowImageManager.php
+++ b/src/Application/Admin/ShowImageManager.php
@@ -7,6 +7,8 @@ namespace App\Application\Admin;
 use App\Application\Admin\Service\AdminLayoutProcessor;
 use App\Application\LiveComponents\ImageGallery\ImageGalleryComponent;
 use App\Domain\Media\ImageRepository;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
 use App\Framework\Http\HttpRequest;
 use App\Framework\Http\Method;
@@ -15,6 +17,7 @@ use App\Framework\LiveComponents\ValueObjects\ComponentId;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 final readonly class ShowImageManager
 {
     public function __construct(
@@ -24,6 +27,7 @@ final readonly class ShowImageManager
     ) {
     }
 
+    #[AdminPage(title: 'Image Manager (Legacy)', icon: 'images', section: 'Content', order: 50, hidden: true)]
     #[Route(path: '/admin/images', method: Method::GET)]
     public function __invoke(HttpRequest $request): ViewResult
     {
diff --git a/src/Application/Admin/ShowImageUpload.php b/src/Application/Admin/ShowImageUpload.php
index e49e1793..fc0d8c1e 100644
--- a/src/Application/Admin/ShowImageUpload.php
+++ b/src/Application/Admin/ShowImageUpload.php
@@ -10,7 +10,6 @@ use App\Domain\Media\ImageRepository;
 use App\Domain\Media\ImageResizer;
 use App\Domain\Media\ImageVariantRepository;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Core\PathProvider;
 use App\Framework\Http\Method;
 use App\Framework\Http\Request;
@@ -33,7 +32,6 @@ final readonly class ShowImageUpload
     ) {
     }
 
-    #[Auth]
     #[Route('/upload')]
     public function __invoke(): ViewResult
     {
@@ -61,7 +59,6 @@ final readonly class ShowImageUpload
         return new ViewResult('upload-form', $metaData, $finalData);
     }
 
-    #[Auth]
     #[Route('/upload', Method::POST)]
     public function upload(Request $request, Ulid $ulid, ImageRepository $imageRepository, ImageVariantRepository $imageVariantRepository): ViewResult
     {
diff --git a/src/Application/Admin/ShowUploadTest.php b/src/Application/Admin/ShowUploadTest.php
index ffd64cb5..be7889c9 100644
--- a/src/Application/Admin/ShowUploadTest.php
+++ b/src/Application/Admin/ShowUploadTest.php
@@ -5,11 +5,13 @@ declare(strict_types=1);
 namespace App\Application\Admin;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'Development', icon: 'code', order: 5, description: 'Development tools and utilities')]
 final readonly class ShowUploadTest
 {
     public function __construct(
@@ -17,7 +19,7 @@ final readonly class ShowUploadTest
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Upload Test', icon: 'file-upload', section: 'Development', order: 60, hidden: true)]
     #[Route('/admin/test/upload')]
     public function __invoke(): ViewResult
     {
diff --git a/src/Application/Admin/System/EnvironmentController.php b/src/Application/Admin/System/EnvironmentController.php
index 969785a7..e67a1e1e 100644
--- a/src/Application/Admin/System/EnvironmentController.php
+++ b/src/Application/Admin/System/EnvironmentController.php
@@ -5,8 +5,9 @@ declare(strict_types=1);
 namespace App\Application\Admin\System;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Config\Environment;
 use App\Framework\DateTime\Clock;
 use App\Framework\DI\DefaultContainer;
@@ -14,6 +15,7 @@ use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'System', icon: 'server', order: 1, description: 'System monitoring and configuration')]
 final readonly class EnvironmentController
 {
     public function __construct(
@@ -23,7 +25,7 @@ final readonly class EnvironmentController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Environment Variables', icon: 'settings', section: 'System', order: 4)]
     #[Route(path: '/admin/system/environment', method: Method::GET, name: 'admin.system.environment')]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/System/HealthController.php b/src/Application/Admin/System/HealthController.php
index 47e6746b..885f10ef 100644
--- a/src/Application/Admin/System/HealthController.php
+++ b/src/Application/Admin/System/HealthController.php
@@ -5,8 +5,9 @@ declare(strict_types=1);
 namespace App\Application\Admin\System;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\Health\HealthCheckCategory;
 use App\Framework\Health\HealthCheckManager;
@@ -16,6 +17,7 @@ use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\ViewResult;
 use App\Framework\View\Table\Generators\HealthCheckTableGenerator;
 
+#[AdminSection(name: 'System', icon: 'server', order: 1, description: 'System monitoring and configuration')]
 final readonly class HealthController
 {
     public function __construct(
@@ -26,7 +28,7 @@ final readonly class HealthController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'System Health', icon: 'health', section: 'System', order: 2)]
     #[Route(path: '/admin/system/health', method: Method::GET, name: 'admin.system.health')]
     public function showDashboard(): ViewResult
     {
diff --git a/src/Application/Admin/System/PerformanceController.php b/src/Application/Admin/System/PerformanceController.php
index 90c4c6e5..94bdc7b6 100644
--- a/src/Application/Admin/System/PerformanceController.php
+++ b/src/Application/Admin/System/PerformanceController.php
@@ -5,8 +5,9 @@ declare(strict_types=1);
 namespace App\Application\Admin\System;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Core\ValueObjects\Byte;
 use App\Framework\Core\ValueObjects\Percentage;
 use App\Framework\DateTime\Clock;
@@ -17,6 +18,7 @@ use App\Framework\Performance\MemoryMonitor;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'System', icon: 'server', order: 1, description: 'System monitoring and configuration')]
 final readonly class PerformanceController
 {
     public function __construct(
@@ -26,7 +28,7 @@ final readonly class PerformanceController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'Performance', icon: 'performance', section: 'System', order: 3)]
     #[Route(path: '/admin/system/performance', method: Method::GET, name: 'admin.system.performance')]
     public function show(): ViewResult
     {
@@ -80,7 +82,6 @@ final readonly class PerformanceController
         );
     }
 
-    #[Auth]
     #[Route(path: '/admin/system/performance/api/realtime', method: Method::GET)]
     public function getRealtimeMetrics(Request $request): JsonResult
     {
diff --git a/src/Application/Admin/System/PhpInfoController.php b/src/Application/Admin/System/PhpInfoController.php
index 89fb561a..872e2e9d 100644
--- a/src/Application/Admin/System/PhpInfoController.php
+++ b/src/Application/Admin/System/PhpInfoController.php
@@ -6,13 +6,15 @@ namespace App\Application\Admin\System;
 
 use App\Application\Admin\Service\AdminLayoutProcessor;
 use App\Application\Admin\System\Service\PhpInfoService;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\DateTime\Clock;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'System', icon: 'server', order: 1, description: 'System monitoring and configuration')]
 final readonly class PhpInfoController
 {
     public function __construct(
@@ -22,7 +24,7 @@ final readonly class PhpInfoController
     ) {
     }
 
-    #[Auth]
+    #[AdminPage(title: 'PHP Information', icon: 'code', section: 'System', order: 5)]
     #[Route(path: '/admin/system/phpinfo', method: Method::GET, name: 'admin.system.phpinfo')]
     public function show(): ViewResult
     {
diff --git a/src/Application/Admin/System/SystemDashboardController.php b/src/Application/Admin/System/SystemDashboardController.php
index cb8e923f..b346e00c 100644
--- a/src/Application/Admin/System/SystemDashboardController.php
+++ b/src/Application/Admin/System/SystemDashboardController.php
@@ -4,8 +4,9 @@ declare(strict_types=1);
 
 namespace App\Application\Admin\System;
 
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 use App\Framework\Attributes\Route;
-use App\Framework\Auth\Auth;
 use App\Framework\Config\TypedConfiguration;
 use App\Framework\Core\VersionInfo;
 use App\Framework\DateTime\Clock;
@@ -14,8 +15,10 @@ use App\Framework\Http\Method;
 use App\Framework\Http\Session\SessionManager;
 use App\Framework\Meta\MetaData;
 use App\Framework\Performance\MemoryMonitor;
+use App\Framework\Router\AdminRoutes;
 use App\Framework\Router\Result\ViewResult;
 
+#[AdminSection(name: 'System', icon: 'server', order: 1, description: 'System monitoring and configuration')]
 final readonly class SystemDashboardController
 {
     public function __construct(
@@ -27,8 +30,8 @@ final readonly class SystemDashboardController
     ) {
     }
 
-    #[Auth]
-    #[Route(path: '/admin/system', method: Method::GET)]
+    #[AdminPage(title: 'System Dashboard', icon: 'dashboard', section: 'System', order: 1)]
+    #[Route(path: '/admin/system', method: Method::GET, name: AdminRoutes::SYSTEM_DASHBOARD)]
     public function show(): ViewResult
     {
         /** @var array<string, mixed> $stats */
diff --git a/src/Application/Admin/UserAdminController.php b/src/Application/Admin/UserAdminController.php
index 94668e66..30d61045 100644
--- a/src/Application/Admin/UserAdminController.php
+++ b/src/Application/Admin/UserAdminController.php
@@ -18,6 +18,8 @@ use App\Framework\Http\Method;
 use App\Framework\Router\Result\JsonResult;
 use App\Framework\Router\Result\Redirect;
 use App\Framework\Router\Result\ViewResult;
+use App\Framework\Admin\Attributes\AdminPage;
+use App\Framework\Admin\Attributes\AdminSection;
 
 /**
  * Example Admin Controller demonstrating the Admin Framework
@@ -28,6 +30,7 @@ use App\Framework\Router\Result\ViewResult;
  * - AdminPageRenderer for consistent rendering
  * - AdminApiHandler for auto-generated CRUD API
  */
+#[AdminSection(name: 'Content', icon: 'photo', order: 3, description: 'Content management')]
 #[AdminResource(
     name: 'users',
     singularName: 'User',
@@ -50,6 +53,7 @@ final readonly class UserAdminController
     /**
      * List all users with table, search, and pagination
      */
+    #[AdminPage(title: 'Users', icon: 'users', section: 'Content', order: 30)]
     #[Route('/admin/users', Method::GET)]
     public function index(): ViewResult
     {
diff --git a/src/Application/Admin/ValueObjects/AdminPageMetadata.php b/src/Application/Admin/ValueObjects/AdminPageMetadata.php
new file mode 100644
index 00000000..50a68606
--- /dev/null
+++ b/src/Application/Admin/ValueObjects/AdminPageMetadata.php
@@ -0,0 +1,137 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\ValueObjects;
+
+use App\Framework\Icon\Icon;
+
+final readonly class AdminPageMetadata
+{
+    public function __construct(
+        public string $path,
+        public string $title,
+        public string $routeName,
+        public string $controllerClass,
+        public string $methodName,
+        public Icon|string|null $icon = null,
+        public ?string $section = null,
+        public int $order = 0,
+        public bool $hidden = false,
+        public ?string $description = null
+    ) {
+    }
+
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): ?Icon
+    {
+        if ($this->icon === null) {
+            return null;
+        }
+
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            path: $data['path'],
+            title: $data['title'],
+            routeName: $data['route_name'] ?? '',
+            controllerClass: $data['controller_class'],
+            methodName: $data['method_name'],
+            icon: $data['icon'] ?? null, // Can be string or Icon
+            section: $data['section'] ?? null,
+            order: $data['order'] ?? 0,
+            hidden: $data['hidden'] ?? false,
+            description: $data['description'] ?? null
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'path' => $this->path,
+            'title' => $this->title,
+            'route_name' => $this->routeName,
+            'controller_class' => $this->controllerClass,
+            'method_name' => $this->methodName,
+            'icon' => $this->icon instanceof Icon ? $this->icon->toString() : $this->icon,
+            'section' => $this->section,
+            'order' => $this->order,
+            'hidden' => $this->hidden,
+            'description' => $this->description,
+        ];
+    }
+
+    public function withTitle(string $title): self
+    {
+        return new self(
+            path: $this->path,
+            title: $title,
+            routeName: $this->routeName,
+            controllerClass: $this->controllerClass,
+            methodName: $this->methodName,
+            icon: $this->icon,
+            section: $this->section,
+            order: $this->order,
+            hidden: $this->hidden,
+            description: $this->description
+        );
+    }
+
+    public function withSection(?string $section): self
+    {
+        return new self(
+            path: $this->path,
+            title: $this->title,
+            routeName: $this->routeName,
+            controllerClass: $this->controllerClass,
+            methodName: $this->methodName,
+            icon: $this->icon,
+            section: $section,
+            order: $this->order,
+            hidden: $this->hidden,
+            description: $this->description
+        );
+    }
+
+    public function withOrder(int $order): self
+    {
+        return new self(
+            path: $this->path,
+            title: $this->title,
+            routeName: $this->routeName,
+            controllerClass: $this->controllerClass,
+            methodName: $this->methodName,
+            icon: $this->icon,
+            section: $this->section,
+            order: $order,
+            hidden: $this->hidden,
+            description: $this->description
+        );
+    }
+
+    public function withHidden(bool $hidden): self
+    {
+        return new self(
+            path: $this->path,
+            title: $this->title,
+            routeName: $this->routeName,
+            controllerClass: $this->controllerClass,
+            methodName: $this->methodName,
+            icon: $this->icon,
+            section: $this->section,
+            order: $this->order,
+            hidden: $hidden,
+            description: $this->description
+        );
+    }
+}
+
diff --git a/src/Application/Admin/ValueObjects/AdminSectionMetadata.php b/src/Application/Admin/ValueObjects/AdminSectionMetadata.php
new file mode 100644
index 00000000..f68d02d8
--- /dev/null
+++ b/src/Application/Admin/ValueObjects/AdminSectionMetadata.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Admin\ValueObjects;
+
+use App\Framework\Icon\Icon;
+
+final readonly class AdminSectionMetadata
+{
+    public function __construct(
+        public string $name,
+        public Icon|string|null $icon = null,
+        public int $order = 0,
+        public ?string $description = null
+    ) {
+    }
+
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): ?Icon
+    {
+        if ($this->icon === null) {
+            return null;
+        }
+
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            name: $data['name'],
+            icon: $data['icon'] ?? null, // Can be string or Icon
+            order: $data['order'] ?? 0,
+            description: $data['description'] ?? null
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'icon' => $this->icon instanceof Icon ? $this->icon->toString() : $this->icon,
+            'order' => $this->order,
+            'description' => $this->description,
+        ];
+    }
+
+    public function withIcon(Icon|string|null $icon): self
+    {
+        return new self(
+            name: $this->name,
+            icon: $icon,
+            order: $this->order,
+            description: $this->description
+        );
+    }
+
+    public function withOrder(int $order): self
+    {
+        return new self(
+            name: $this->name,
+            icon: $this->icon,
+            order: $order,
+            description: $this->description
+        );
+    }
+}
+
diff --git a/src/Application/Admin/ValueObjects/AdminTokenRegistry.php b/src/Application/Admin/ValueObjects/AdminTokenRegistry.php
index faef77b5..19097ffe 100644
--- a/src/Application/Admin/ValueObjects/AdminTokenRegistry.php
+++ b/src/Application/Admin/ValueObjects/AdminTokenRegistry.php
@@ -4,345 +4,276 @@ declare(strict_types=1);
 
 namespace App\Application\Admin\ValueObjects;
 
-use App\Framework\Design\ValueObjects\CssColor;
-use App\Framework\Design\ValueObjects\DesignToken;
 use App\Framework\Design\ValueObjects\ColorFormat;
+use App\Framework\Design\ValueObjects\ColorPalette;
+use App\Framework\Design\ValueObjects\ColorVariation;
+use App\Framework\Design\ValueObjects\CssColor;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Design\ValueObjects\Tokens\ColorToken;
+use App\Framework\Design\ValueObjects\Tokens\SpacingToken;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TypographyToken;
 
 /**
  * Admin Token Registry
  *
  * Central registry for all admin design tokens.
- * Uses framework's DesignToken system for compatibility.
+ * Uses ColorVariation for organized color management.
  */
-final readonly class AdminTokenRegistry
+final readonly class AdminTokenRegistry extends TokenRegistry
 {
-    /**
-     * @var array<string, DesignToken>
-     */
-    private array $tokens;
-
-    public function __construct()
+    protected function initializeTokens(): array
     {
-        $this->tokens = $this->initializeTokens();
+        $colorPalette = $this->createColorPalette();
+        $tokens = $colorPalette->getAllTokens('admin');
+
+        // Add spacing tokens
+        $tokens = array_merge($tokens, $this->createSpacingTokens());
+
+        // Add typography tokens
+        $tokens = array_merge($tokens, $this->createTypographyTokens());
+
+        return $tokens;
     }
 
     /**
-     * Get token by name
+     * Create color palette with variations
      */
-    public function get(string $name): ?DesignToken
+    private function createColorPalette(): ColorPalette
     {
-        return $this->tokens[$name] ?? null;
-    }
-
-    /**
-     * Get all tokens
-     * @return array<string, DesignToken>
-     */
-    public function all(): array
-    {
-        return $this->tokens;
-    }
-
-    /**
-     * Get tokens by category
-     * @return array<string, DesignToken>
-     */
-    public function byCategory(string $category): array
-    {
-        return array_filter(
-            $this->tokens,
-            fn(DesignToken $token) => str_starts_with($token->name, $category . '-')
-        );
-    }
-
-    /**
-     * Get all color tokens
-     * @return array<string, DesignToken>
-     */
-    public function colors(): array
-    {
-        return array_filter(
-            $this->tokens,
-            fn(DesignToken $token) => $token->value instanceof CssColor
-        );
-    }
-
-    /**
-     * Get all spacing tokens
-     * @return array<string, DesignToken>
-     */
-    public function spacing(): array
-    {
-        return $this->byCategory('spacing');
-    }
-
-    /**
-     * Generate CSS custom properties
-     */
-    public function toCss(): string
-    {
-        $css = ":root {\n";
-
-        foreach ($this->tokens as $token) {
-            $css .= "    " . $token->toCssCustomProperty() . "\n";
-        }
-
-        $css .= "}\n";
-
-        return $css;
-    }
-
-    /**
-     * Generate dark mode CSS overrides
-     */
-    public function toDarkModeCss(): string
-    {
-        $css = "@media (prefers-color-scheme: dark) {\n";
-        $css .= "    :root {\n";
-
-        foreach ($this->colors() as $token) {
-            $darkColor = $this->getDarkModeColor($token);
-            if ($darkColor) {
-                $css .= "        --{$token->name}: {$darkColor->toString()};\n";
-            }
-        }
-
-        $css .= "    }\n";
-        $css .= "}\n";
-
-        return $css;
-    }
-
-    /**
-     * Initialize all admin design tokens
-     * @return array<string, DesignToken>
-     */
-    private function initializeTokens(): array
-    {
-        return [
+        return new ColorPalette([
             // Background Colors
-            'admin-bg-primary' => DesignToken::color(
-                'admin-bg-primary',
-                new CssColor('oklch(98% 0.01 280)', ColorFormat::OKLCH),
-                'Primary background color'
+            new ColorVariation(
+                name: 'bg-primary',
+                light: new CssColor('oklch(98% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Primary background color'
             ),
-            'admin-bg-secondary' => DesignToken::color(
-                'admin-bg-secondary',
-                new CssColor('oklch(95% 0.01 280)', ColorFormat::OKLCH),
-                'Secondary background color'
+            new ColorVariation(
+                name: 'bg-secondary',
+                light: new CssColor('oklch(95% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(23% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Secondary background color'
             ),
-            'admin-bg-tertiary' => DesignToken::color(
-                'admin-bg-tertiary',
-                new CssColor('oklch(92% 0.01 280)', ColorFormat::OKLCH),
-                'Tertiary background color'
+            new ColorVariation(
+                name: 'bg-tertiary',
+                light: new CssColor('oklch(92% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(26% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Tertiary background color'
             ),
 
             // Sidebar Colors
-            'admin-sidebar-bg' => DesignToken::color(
-                'admin-sidebar-bg',
-                new CssColor('oklch(25% 0.02 280)', ColorFormat::OKLCH),
-                'Sidebar background color'
+            new ColorVariation(
+                name: 'sidebar-bg',
+                light: new CssColor('oklch(25% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(15% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Sidebar background color'
             ),
-            'admin-sidebar-text' => DesignToken::color(
-                'admin-sidebar-text',
-                new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
-                'Sidebar text color'
+            new ColorVariation(
+                name: 'sidebar-text',
+                light: new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(75% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Sidebar text color'
             ),
-            'admin-sidebar-text-hover' => DesignToken::color(
-                'admin-sidebar-text-hover',
-                new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
-                'Sidebar text hover color'
+            new ColorVariation(
+                name: 'sidebar-text-hover',
+                light: new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(95% 0.01 280)', ColorFormat::OKLCH),
+                description: 'Sidebar text hover color'
             ),
-            'admin-sidebar-active' => DesignToken::color(
-                'admin-sidebar-active',
-                new CssColor('oklch(45% 0.15 280)', ColorFormat::OKLCH),
-                'Sidebar active item color'
+            new ColorVariation(
+                name: 'sidebar-active',
+                light: new CssColor('oklch(45% 0.15 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(35% 0.2 280)', ColorFormat::OKLCH),
+                description: 'Sidebar active item color'
             ),
-            'admin-sidebar-border' => DesignToken::color(
-                'admin-sidebar-border',
-                new CssColor('oklch(30% 0.02 280)', ColorFormat::OKLCH),
-                'Sidebar border color'
+            new ColorVariation(
+                name: 'sidebar-border',
+                light: new CssColor('oklch(30% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(25% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Sidebar border color'
             ),
 
             // Header Colors
-            'admin-header-bg' => DesignToken::color(
-                'admin-header-bg',
-                new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
-                'Header background color'
+            new ColorVariation(
+                name: 'header-bg',
+                light: new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(18% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Header background color'
             ),
-            'admin-header-border' => DesignToken::color(
-                'admin-header-border',
-                new CssColor('oklch(85% 0.01 280)', ColorFormat::OKLCH),
-                'Header border color'
+            new ColorVariation(
+                name: 'header-border',
+                light: new CssColor('oklch(85% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(30% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Header border color'
             ),
-            'admin-header-text' => DesignToken::color(
-                'admin-header-text',
-                new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
-                'Header text color'
+            new ColorVariation(
+                name: 'header-text',
+                light: new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
+                description: 'Header text color'
             ),
 
             // Content Colors
-            'admin-content-bg' => DesignToken::color(
-                'admin-content-bg',
-                new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
-                'Content background color'
+            new ColorVariation(
+                name: 'content-bg',
+                light: new CssColor('oklch(100% 0 0)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Content background color'
             ),
-            'admin-content-text' => DesignToken::color(
-                'admin-content-text',
-                new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
-                'Content text color'
+            new ColorVariation(
+                name: 'content-text',
+                light: new CssColor('oklch(20% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
+                description: 'Content text color'
             ),
 
             // Interactive Colors
-            'admin-link-color' => DesignToken::color(
-                'admin-link-color',
-                new CssColor('oklch(55% 0.2 260)', ColorFormat::OKLCH),
-                'Link color'
+            new ColorVariation(
+                name: 'link-color',
+                light: new CssColor('oklch(55% 0.2 260)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(70% 0.2 260)', ColorFormat::OKLCH),
+                description: 'Link color'
             ),
-            'admin-link-hover' => DesignToken::color(
-                'admin-link-hover',
-                new CssColor('oklch(45% 0.25 260)', ColorFormat::OKLCH),
-                'Link hover color'
+            new ColorVariation(
+                name: 'link-hover',
+                light: new CssColor('oklch(45% 0.25 260)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(80% 0.22 260)', ColorFormat::OKLCH),
+                description: 'Link hover color'
             ),
-            'admin-link-active' => DesignToken::color(
-                'admin-link-active',
-                new CssColor('oklch(35% 0.3 260)', ColorFormat::OKLCH),
-                'Link active color'
+            new ColorVariation(
+                name: 'link-active',
+                light: new CssColor('oklch(35% 0.3 260)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(85% 0.25 260)', ColorFormat::OKLCH),
+                description: 'Link active color'
             ),
 
             // Accent Colors
-            'admin-accent-primary' => DesignToken::color(
-                'admin-accent-primary',
-                new CssColor('oklch(60% 0.2 280)', ColorFormat::OKLCH),
-                'Primary accent color'
+            new ColorVariation(
+                name: 'accent-primary',
+                light: new CssColor('oklch(60% 0.2 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(65% 0.22 280)', ColorFormat::OKLCH),
+                description: 'Primary accent color'
             ),
-            'admin-accent-success' => DesignToken::color(
-                'admin-accent-success',
-                new CssColor('oklch(65% 0.2 145)', ColorFormat::OKLCH),
-                'Success accent color'
+            new ColorVariation(
+                name: 'accent-success',
+                light: new CssColor('oklch(65% 0.2 145)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(70% 0.22 145)', ColorFormat::OKLCH),
+                description: 'Success accent color'
             ),
-            'admin-accent-warning' => DesignToken::color(
-                'admin-accent-warning',
-                new CssColor('oklch(70% 0.2 85)', ColorFormat::OKLCH),
-                'Warning accent color'
+            new ColorVariation(
+                name: 'accent-warning',
+                light: new CssColor('oklch(70% 0.2 85)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(75% 0.22 85)', ColorFormat::OKLCH),
+                description: 'Warning accent color'
             ),
-            'admin-accent-error' => DesignToken::color(
-                'admin-accent-error',
-                new CssColor('oklch(60% 0.25 25)', ColorFormat::OKLCH),
-                'Error accent color'
+            new ColorVariation(
+                name: 'accent-error',
+                light: new CssColor('oklch(60% 0.25 25)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(65% 0.27 25)', ColorFormat::OKLCH),
+                description: 'Error accent color'
             ),
-            'admin-accent-info' => DesignToken::color(
-                'admin-accent-info',
-                new CssColor('oklch(65% 0.2 240)', ColorFormat::OKLCH),
-                'Info accent color'
+            new ColorVariation(
+                name: 'accent-info',
+                light: new CssColor('oklch(65% 0.2 240)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(70% 0.22 240)', ColorFormat::OKLCH),
+                description: 'Info accent color'
             ),
 
             // Border Colors
-            'admin-border-light' => DesignToken::color(
-                'admin-border-light',
-                new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
-                'Light border color'
+            new ColorVariation(
+                name: 'border-light',
+                light: new CssColor('oklch(90% 0.01 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(30% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Light border color'
             ),
-            'admin-border-medium' => DesignToken::color(
-                'admin-border-medium',
-                new CssColor('oklch(80% 0.02 280)', ColorFormat::OKLCH),
-                'Medium border color'
+            new ColorVariation(
+                name: 'border-medium',
+                light: new CssColor('oklch(80% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(35% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Medium border color'
             ),
-            'admin-border-dark' => DesignToken::color(
-                'admin-border-dark',
-                new CssColor('oklch(70% 0.02 280)', ColorFormat::OKLCH),
-                'Dark border color'
+            new ColorVariation(
+                name: 'border-dark',
+                light: new CssColor('oklch(70% 0.02 280)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(40% 0.02 280)', ColorFormat::OKLCH),
+                description: 'Dark border color'
             ),
 
             // Focus/Hover States
-            'admin-focus-ring' => DesignToken::color(
-                'admin-focus-ring',
-                new CssColor('oklch(55% 0.2 260)', ColorFormat::OKLCH),
-                'Focus ring color'
+            new ColorVariation(
+                name: 'focus-ring',
+                light: new CssColor('oklch(55% 0.2 260)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(70% 0.2 260)', ColorFormat::OKLCH),
+                description: 'Focus ring color'
             ),
-            'admin-hover-overlay' => DesignToken::color(
-                'admin-hover-overlay',
-                new CssColor('oklch(0% 0 0 / 0.05)', ColorFormat::OKLCH),
-                'Hover overlay color'
+            new ColorVariation(
+                name: 'hover-overlay',
+                light: new CssColor('oklch(0% 0 0 / 0.05)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(100% 0 0 / 0.05)', ColorFormat::OKLCH),
+                description: 'Hover overlay color'
             ),
+        ], 'admin');
+    }
 
-            // Spacing Tokens
-            'spacing-xs' => DesignToken::spacing('spacing-xs', '0.25rem', 'Extra small spacing'),
-            'spacing-sm' => DesignToken::spacing('spacing-sm', '0.5rem', 'Small spacing'),
-            'spacing-md' => DesignToken::spacing('spacing-md', '1rem', 'Medium spacing'),
-            'spacing-lg' => DesignToken::spacing('spacing-lg', '1.5rem', 'Large spacing'),
-            'spacing-xl' => DesignToken::spacing('spacing-xl', '2rem', 'Extra large spacing'),
-            'spacing-2xl' => DesignToken::spacing('spacing-2xl', '3rem', 'Double extra large spacing'),
+    /**
+     * Create spacing tokens
+     * @return array<string, TokenInterface>
+     */
+    private function createSpacingTokens(): array
+    {
+        return [
+            'admin-spacing-xs' => new SpacingToken('admin-spacing-xs', '0.25rem', 'Extra small spacing'),
+            'admin-spacing-sm' => new SpacingToken('admin-spacing-sm', '0.5rem', 'Small spacing'),
+            'admin-spacing-md' => new SpacingToken('admin-spacing-md', '1rem', 'Medium spacing'),
+            'admin-spacing-lg' => new SpacingToken('admin-spacing-lg', '1.5rem', 'Large spacing'),
+            'admin-spacing-xl' => new SpacingToken('admin-spacing-xl', '2rem', 'Extra large spacing'),
+            'admin-spacing-2xl' => new SpacingToken('admin-spacing-2xl', '3rem', 'Double extra large spacing'),
 
             // Layout Spacing
-            'spacing-sidebar' => DesignToken::spacing('spacing-sidebar', '250px', 'Sidebar width'),
-            'spacing-sidebar-wide' => DesignToken::spacing('spacing-sidebar-wide', '280px', 'Sidebar width on wide screens'),
-            'spacing-header' => DesignToken::spacing('spacing-header', '4rem', 'Header height'),
-            'spacing-content-padding' => DesignToken::spacing('spacing-content-padding', '2rem', 'Content padding'),
-            'spacing-content-max-width' => DesignToken::spacing('spacing-content-max-width', '1400px', 'Content maximum width'),
-
-            // Typography Tokens
-            'font-size-xs' => DesignToken::typography('font-size-xs', '0.75rem', 'Extra small font size'),
-            'font-size-sm' => DesignToken::typography('font-size-sm', '0.875rem', 'Small font size'),
-            'font-size-base' => DesignToken::typography('font-size-base', '1rem', 'Base font size'),
-            'font-size-lg' => DesignToken::typography('font-size-lg', '1.125rem', 'Large font size'),
-            'font-size-xl' => DesignToken::typography('font-size-xl', '1.25rem', 'Extra large font size'),
-            'font-size-2xl' => DesignToken::typography('font-size-2xl', '1.5rem', 'Double extra large font size'),
-            'font-size-3xl' => DesignToken::typography('font-size-3xl', '1.875rem', 'Triple extra large font size'),
+            'admin-spacing-sidebar' => new SpacingToken('admin-spacing-sidebar', '250px', 'Sidebar width'),
+            'admin-spacing-sidebar-wide' => new SpacingToken('admin-spacing-sidebar-wide', '280px', 'Sidebar width on wide screens'),
+            'admin-spacing-header' => new SpacingToken('admin-spacing-header', '4rem', 'Header height'),
+            'admin-spacing-content-padding' => new SpacingToken('admin-spacing-content-padding', '2rem', 'Content padding'),
+            'admin-spacing-content-max-width' => new SpacingToken('admin-spacing-content-max-width', '1400px', 'Content maximum width'),
         ];
     }
 
     /**
-     * Get dark mode variant of a color
+     * Create typography tokens
+     * @return array<string, TokenInterface>
      */
-    private function getDarkModeColor(DesignToken $token): ?CssColor
+    private function createTypographyTokens(): array
     {
-        if (!($token->value instanceof CssColor)) {
-            return null;
-        }
-
-        // Dark mode color mappings
-        $darkModeMap = [
-            // Backgrounds
-            'admin-bg-primary' => 'oklch(20% 0.02 280)',
-            'admin-bg-secondary' => 'oklch(23% 0.02 280)',
-            'admin-bg-tertiary' => 'oklch(26% 0.02 280)',
-
-            // Sidebar
-            'admin-sidebar-bg' => 'oklch(15% 0.02 280)',
-            'admin-sidebar-text' => 'oklch(75% 0.02 280)',
-            'admin-sidebar-text-hover' => 'oklch(95% 0.01 280)',
-            'admin-sidebar-active' => 'oklch(35% 0.2 280)',
-            'admin-sidebar-border' => 'oklch(25% 0.02 280)',
-
-            // Header
-            'admin-header-bg' => 'oklch(18% 0.02 280)',
-            'admin-header-border' => 'oklch(30% 0.02 280)',
-            'admin-header-text' => 'oklch(90% 0.01 280)',
-
-            // Content
-            'admin-content-bg' => 'oklch(20% 0.02 280)',
-            'admin-content-text' => 'oklch(90% 0.01 280)',
-
-            // Interactive
-            'admin-link-color' => 'oklch(70% 0.2 260)',
-            'admin-link-hover' => 'oklch(80% 0.22 260)',
-            'admin-link-active' => 'oklch(85% 0.25 260)',
-
-            // Borders
-            'admin-border-light' => 'oklch(30% 0.02 280)',
-            'admin-border-medium' => 'oklch(35% 0.02 280)',
-            'admin-border-dark' => 'oklch(40% 0.02 280)',
-
-            // Focus
-            'admin-focus-ring' => 'oklch(70% 0.2 260)',
-            'admin-hover-overlay' => 'oklch(100% 0 0 / 0.05)',
+        return [
+            'admin-font-size-xs' => new TypographyToken('admin-font-size-xs', '0.75rem', 'Extra small font size'),
+            'admin-font-size-sm' => new TypographyToken('admin-font-size-sm', '0.875rem', 'Small font size'),
+            'admin-font-size-base' => new TypographyToken('admin-font-size-base', '1rem', 'Base font size'),
+            'admin-font-size-lg' => new TypographyToken('admin-font-size-lg', '1.125rem', 'Large font size'),
+            'admin-font-size-xl' => new TypographyToken('admin-font-size-xl', '1.25rem', 'Extra large font size'),
+            'admin-font-size-2xl' => new TypographyToken('admin-font-size-2xl', '1.5rem', 'Double extra large font size'),
+            'admin-font-size-3xl' => new TypographyToken('admin-font-size-3xl', '1.875rem', 'Triple extra large font size'),
         ];
+    }
 
-        if (isset($darkModeMap[$token->name])) {
-            return new CssColor($darkModeMap[$token->name], ColorFormat::OKLCH);
-        }
+    protected function getLayerName(): string
+    {
+        return 'admin-settings';
+    }
 
-        return null;
+    /**
+     * Generate CSS custom properties (admin-specific layer)
+     */
+    public function toCss(string $layerName = 'admin-settings', bool $includeHdr = true): string
+    {
+        return parent::toCss($layerName, $includeHdr);
+    }
+
+    /**
+     * Generate dark mode CSS overrides (deprecated - use toCss() which includes dark mode)
+     */
+    public function toDarkModeCss(string $layerName = 'admin-settings'): string
+    {
+        return parent::toDarkModeCss($layerName);
     }
 }
diff --git a/src/Application/Admin/ValueObjects/NavigationItem.php b/src/Application/Admin/ValueObjects/NavigationItem.php
index 521790e3..6c5f424c 100644
--- a/src/Application/Admin/ValueObjects/NavigationItem.php
+++ b/src/Application/Admin/ValueObjects/NavigationItem.php
@@ -4,22 +4,40 @@ declare(strict_types=1);
 
 namespace App\Application\Admin\ValueObjects;
 
+use App\Framework\Icon\Icon;
+
 final readonly class NavigationItem
 {
     public function __construct(
         public string $name,
         public string $url,
-        public ?string $icon = null,
+        public Icon|string|null $icon = null,
         public bool $isActive = false
     ) {
     }
 
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): ?Icon
+    {
+        if ($this->icon === null) {
+            return null;
+        }
+
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+
     public static function fromArray(array $data): self
     {
         return new self(
             name: $data['name'] ?? '',
             url: $data['url'] ?? '',
-            icon: $data['icon'] ?? null,
+            icon: $data['icon'] ?? null, // Can be string or Icon
             isActive: $data['is_active'] ?? false
         );
     }
@@ -29,7 +47,7 @@ final readonly class NavigationItem
         return [
             'name' => $this->name,
             'url' => $this->url,
-            'icon' => $this->icon,
+            'icon' => $this->icon instanceof Icon ? $this->icon->toString() : $this->icon,
             'is_active' => $this->isActive,
         ];
     }
diff --git a/src/Application/Admin/ValueObjects/NavigationSection.php b/src/Application/Admin/ValueObjects/NavigationSection.php
index 9f7ed57f..4dbdf5de 100644
--- a/src/Application/Admin/ValueObjects/NavigationSection.php
+++ b/src/Application/Admin/ValueObjects/NavigationSection.php
@@ -24,7 +24,7 @@ final readonly class NavigationSection
         return new self(
             name: $data['section'] ?? $data['name'] ?? '',
             items: $items,
-            icon: $data['icon'] ?? null
+            icon: $data['icon'] ?? null // Can be string or Icon
         );
     }
 
@@ -37,7 +37,7 @@ final readonly class NavigationSection
                 fn (NavigationItem $item) => $item->toArray(),
                 $this->items
             ),
-            'icon' => $this->icon,
+            'icon' => $this->icon instanceof Icon ? $this->icon->toString() : $this->icon,
         ];
     }
 
diff --git a/src/Application/Admin/templates/admin-form.view.php b/src/Application/Admin/templates/admin-form.view.php
index bb7d1bf2..80a9aeec 100644
--- a/src/Application/Admin/templates/admin-form.view.php
+++ b/src/Application/Admin/templates/admin-form.view.php
@@ -2,16 +2,14 @@
 
 <div class="admin-page">
     <div class="page-header">
-        <h1>{{ title }}</h1>
-        <if condition="{{ subtitle }}">
-            <p class="subtitle">{{ subtitle }}</p>
-        </if>
+        <h1>{{$title}}</h1>
+        <p class="subtitle" if="{{$subtitle}}">{{$subtitle}}</p>
     </div>
 
     <div class="form-container">
         <div class="card">
             <div class="card-body">
-                {{ form }}
+                {{$form}}
             </div>
         </div>
     </div>
diff --git a/src/Application/Admin/templates/admin-index.view.php b/src/Application/Admin/templates/admin-index.view.php
index a7e21811..35ffe398 100644
--- a/src/Application/Admin/templates/admin-index.view.php
+++ b/src/Application/Admin/templates/admin-index.view.php
@@ -2,34 +2,26 @@
 
 <div class="admin-page">
     <div class="page-header">
-        <h1>{{ title }}</h1>
+        <h1>{{$title}}</h1>
 
         <div class="page-actions">
-            <if condition="{{ actions }}">
-                <for items="{{ actions }}" value="action">
-                    <a href="{{ action.url }}" class="btn btn-primary">
-                        <if condition="{{ action.icon }}">
-                            <i class="icon-{{ action.icon }}"></i>
-                        </if>
-                        {{ action.label }}
-                    </a>
-                </for>
-            </if>
+            <a href="{{$action['url']}}" class="btn btn-primary" foreach="$actions as $action">
+                <i class="icon-{{$action['icon']}}" if="{{$action['icon']}}"></i>
+                {{$action['label']}}
+            </a>
         </div>
     </div>
 
-    <if condition="{{ searchable }}">
-        <div class="table-controls">
-            <input type="text"
-                   class="form-control search-input"
-                   data-table-search="{{ resource }}"
-                   placeholder="Search...">
-        </div>
-    </if>
+    <div class="table-controls" if="{{$searchable}}">
+        <input type="text"
+               class="form-control search-input"
+               data-table-search="{{$resource}}"
+               placeholder="Search...">
+    </div>
 
     <div class="table-container">
-        {{ table }}
+        {{$table}}
     </div>
 
-    <div class="pagination-container" data-table-pagination="{{ resource }}"></div>
+    <div class="pagination-container" data-table-pagination="{{$resource}}"></div>
 </div>
diff --git a/src/Application/Admin/templates/admin.view.php b/src/Application/Admin/templates/admin.view.php
index ecfa3859..3a064911 100644
--- a/src/Application/Admin/templates/admin.view.php
+++ b/src/Application/Admin/templates/admin.view.php
@@ -1,11 +1,11 @@
 <!doctype html>
-<html lang="de" data-theme="{theme ?? 'auto'}">
+<html lang="de" data-theme="{{ $theme ?? 'auto' }}">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta http-equiv="X-UA-Compatible" content="ie=edge">
-    <title>{title} | Admin Panel</title>
-    <meta name="description" content="{description}">
+    <title>{{ $title }} | Admin Panel</title>
+    <meta name="description" content="{{ $description }}">
     <meta property="og:type" content="website">
 
     <!-- Theme Meta -->
@@ -27,14 +27,14 @@
     <!-- Admin Layout Grid -->
     <div class="admin-layout">
         <!-- Sidebar Navigation -->
-        <x-admin-sidebar currentPath="{current_path}" />
+        <x-admin-sidebar currentPath="{{ $current_path }}" navigation-menu='{{ json_encode($navigation_menu) }}' />
 
         <!-- Header with Search & User Menu -->
-        <x-admin-header pageTitle="{page_title}" />
+        <x-admin-header pageTitle="{{ $page_title }}" />
 
         <!-- Main Content Area -->
         <main class="admin-content" id="main-content" role="main">
-            {content}
+            {{ $content }}
         </main>
     </div>
 
diff --git a/src/Application/Admin/templates/analytics-dashboard.view.php b/src/Application/Admin/templates/analytics-dashboard.view.php
index c5b842c7..ccbeec3d 100644
--- a/src/Application/Admin/templates/analytics-dashboard.view.php
+++ b/src/Application/Admin/templates/analytics-dashboard.view.php
@@ -5,31 +5,30 @@
     <div class="stats-grid">
         <div class="stat-card">
             <h3>Page Views</h3>
-            <p><strong>Today:</strong> {{ today_page_views }}</p>
-            <p><strong>This Week:</strong> {{ week_page_views }}</p>
-            <p><strong>This Month:</strong> {{ month_page_views }}</p>
+            <p><strong>Today:</strong> {{$today_page_views}}</p>
+            <p><strong>This Week:</strong> {{$week_page_views}}</p>
+            <p><strong>This Month:</strong> {{$month_page_views}}</p>
         </div>
 
         <div class="stat-card">
             <h3>Unique Visitors</h3>
-            <p><strong>Today:</strong> {{ today_visitors }}</p>
-            <p><strong>This Week:</strong> {{ week_visitors }}</p>
-            <p><strong>This Month:</strong> {{ month_visitors }}</p>
+            <p><strong>Today:</strong> {{$today_visitors}}</p>
+            <p><strong>This Week:</strong> {{$week_visitors}}</p>
+            <p><strong>This Month:</strong> {{$month_visitors}}</p>
         </div>
 
         <div class="stat-card">
             <h3>Performance</h3>
-            <p><strong>Avg. Load Time:</strong> {{ avg_load_time }}</p>
-            <p><strong>Bounce Rate:</strong> {{ bounce_rate }}</p>
-            <p><strong>Session Duration:</strong> {{ avg_session_duration }}</p>
+            <p><strong>Avg. Load Time:</strong> {{$avg_load_time}}</p>
+            <p><strong>Bounce Rate:</strong> {{$bounce_rate}}</p>
+            <p><strong>Session Duration:</strong> {{$avg_session_duration}}</p>
         </div>
     </div>
 
     <div class="stats-grid">
         <div class="stat-card full-width">
             <h3>Top Pages</h3>
-            <if condition="{{ top_pages }}">
-            <table>
+            <table if="{{$top_pages}}">
                 <thead>
                     <tr>
                         <th>Page</th>
@@ -39,44 +38,37 @@
                     </tr>
                 </thead>
                 <tbody>
-                    <for items="{{ top_pages }}" value="page">
-                    <tr>
-                        <td>{{ page.path }}</td>
-                        <td>{{ page.views }}</td>
-                        <td>{{ page.unique_visitors }}</td>
-                        <td>{{ page.avg_time }}</td>
+                    <tr foreach="$top_pages as $page">
+                        <td>{{$page['path']}}</td>
+                        <td>{{$page['views']}}</td>
+                        <td>{{$page['unique_visitors']}}</td>
+                        <td>{{$page['avg_time']}}</td>
                     </tr>
-                    </for>
                 </tbody>
             </table>
-            <else>
-            <p>No analytics data available yet.</p>
-            <p>The analytics system will start collecting data once visitors start using your website.</p>
-            </if>
+            <div if="{{!$top_pages}}">
+                <p>No analytics data available yet.</p>
+                <p>The analytics system will start collecting data once visitors start using your website.</p>
+            </div>
         </div>
     </div>
 
     <div class="stats-grid">
         <div class="stat-card">
             <h3>Traffic Sources</h3>
-            <if condition="{{ traffic_sources }}">
-            <ul style="list-style: none; padding: 0;">
-                <for items="{{ traffic_sources }}" key="source" value="percentage">
-                <li style="margin: 8px 0;">
-                    <strong>{{ source }}:</strong> {{ percentage }}%
+            <ul style="list-style: none; padding: 0;" if="{{$traffic_sources}}">
+                <li style="margin: 8px 0;" foreach="$traffic_sources as $source => $percentage">
+                    <strong>{{$source}}:</strong> {{$percentage}}%
                 </li>
-                </for>
             </ul>
-            <else>
-            <p>No traffic source data available.</p>
-            </if>
+            <p if="{{!$traffic_sources}}">No traffic source data available.</p>
         </div>
 
         <div class="stat-card">
             <h3>System Status</h3>
             <p><strong>Analytics Status:</strong> <span style="color: var(--success);">Active</span></p>
             <p><strong>Data Collection:</strong> <span style="color: var(--success);">Running</span></p>
-            <p><strong>Last Update:</strong> {{ last_update }}</p>
+            <p><strong>Last Update:</strong> {{$last_update}}</p>
         </div>
     </div>
 </div>
\ No newline at end of file
diff --git a/src/Application/Admin/templates/cache-metrics.view.php b/src/Application/Admin/templates/cache-metrics.view.php
index 0c0575bc..eee97221 100644
--- a/src/Application/Admin/templates/cache-metrics.view.php
+++ b/src/Application/Admin/templates/cache-metrics.view.php
@@ -7,31 +7,31 @@
             <!-- Cache Overview Cards -->
             <div class="admin-grid admin-grid--4col">
                 <div class="admin-card metric-card">
-                    <div class="metric-card__value">{{ hit_rate }}%</div>
+                    <div class="metric-card__value">{{$hit_rate}}%</div>
                     <div class="metric-card__label">Hit Rate</div>
-                    <div class="metric-card__change metric-card__change--{{ hit_rate >= 80 ? 'positive' : 'negative' }}">
-                        {{ hit_rate >= 80 ? 'Excellent' : (hit_rate >= 60 ? 'Good' : 'Needs Improvement') }}
+                    <div class="metric-card__change metric-card__change--{{$hit_rate >= 80 ? 'positive' : 'negative'}}">
+                        {{$hit_rate >= 80 ? 'Excellent' : ($hit_rate >= 60 ? 'Good' : 'Needs Improvement')}}
                     </div>
                 </div>
 
                 <div class="admin-card metric-card">
-                    <div class="metric-card__value">{{ total_operations }}</div>
+                    <div class="metric-card__value">{{$total_operations}}</div>
                     <div class="metric-card__label">Total Operations</div>
                     <div class="metric-card__change">Since startup</div>
                 </div>
 
                 <div class="admin-card metric-card">
-                    <div class="metric-card__value">{{ avg_latency_ms }}ms</div>
+                    <div class="metric-card__value">{{$avg_latency_ms}}ms</div>
                     <div class="metric-card__label">Average Latency</div>
-                    <div class="metric-card__change metric-card__change--{{ avg_latency_ms <= 5 ? 'positive' : 'negative' }}">
-                        {{ avg_latency_ms <= 5 ? 'Fast' : 'Slow' }}
+                    <div class="metric-card__change metric-card__change--{{$avg_latency_ms <= 5 ? 'positive' : 'negative'}}">
+                        {{$avg_latency_ms <= 5 ? 'Fast' : 'Slow'}}
                     </div>
                 </div>
 
                 <div class="admin-card metric-card">
-                    <div class="metric-card__value">{{ total_size_mb }}MB</div>
+                    <div class="metric-card__value">{{$total_size_mb}}MB</div>
                     <div class="metric-card__label">Total Cache Size</div>
-                    <div class="metric-card__change">{{ active_drivers }} active drivers</div>
+                    <div class="metric-card__change">{{$active_drivers}} active drivers</div>
                 </div>
             </div>
 
@@ -39,53 +39,47 @@
             <div class="admin-card">
                 <div class="admin-card__header">
                     <h3 class="admin-card__title">Cache Health Status</h3>
-                    <span class="admin-table__status admin-table__status--{{ health_status === 'healthy' ? 'success' : (health_status === 'warning' ? 'warning' : 'error') }}">
-                        <span class="status-indicator status-indicator--{{ health_status === 'healthy' ? 'success' : (health_status === 'warning' ? 'warning' : 'error') }}"></span>
-                        {{ health_status|upper }}
+                    <span class="admin-table__status admin-table__status--{{$health_status === 'healthy' ? 'success' : ($health_status === 'warning' ? 'warning' : 'error')}}">
+                        <span class="status-indicator status-indicator--{{$health_status === 'healthy' ? 'success' : ($health_status === 'warning' ? 'warning' : 'error')}}"></span>
+                        {{strtoupper($health_status)}}
                     </span>
                 </div>
                 <div class="admin-card__content">
-                    <p>Cache system efficiency rating: <strong>{{ efficiency_rating }}</strong></p>
-                    <if condition="{{ recommendations_count > 0 }}">
-                        <p class="text-warning">{{ recommendations_count }} recommendations available for optimization.</p>
-                    </if>
+                    <p>Cache system efficiency rating: <strong>{{$efficiency_rating}}</strong></p>
+                    <p class="text-warning" if="{{$recommendations_count > 0}}">{{$recommendations_count}} recommendations available for optimization.</p>
                 </div>
             </div>
 
             <!-- Driver Statistics -->
-            <if condition="{{ active_drivers > 0 }}">
-                <div class="admin-card">
-                    <div class="admin-card__header">
-                        <h3 class="admin-card__title">Driver Statistics</h3>
-                    </div>
-                    <div class="admin-card__content">
-                        <div class="admin-table-wrapper">
-                            <table class="admin-table">
-                                <thead>
-                                    <tr>
-                                        <th>Driver</th>
-                                        <th>Hit Rate</th>
-                                        <th>Operations</th>
-                                        <th>Avg Latency</th>
-                                        <th>Size (MB)</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    <for items="{{ driver_stats }}" key="driver" value="stats">
-                                        <tr>
-                                            <td class="font-mono">{{ driver }}</td>
-                                            <td>{{ stats.hit_rate }}%</td>
-                                            <td>{{ stats.operations }}</td>
-                                            <td>{{ stats.avg_latency }}ms</td>
-                                            <td>{{ stats.size }}MB</td>
-                                        </tr>
-                                    </for>
-                                </tbody>
-                            </table>
-                        </div>
+            <div class="admin-card" if="{{$active_drivers > 0}}">
+                <div class="admin-card__header">
+                    <h3 class="admin-card__title">Driver Statistics</h3>
+                </div>
+                <div class="admin-card__content">
+                    <div class="admin-table-wrapper">
+                        <table class="admin-table">
+                            <thead>
+                                <tr>
+                                    <th>Driver</th>
+                                    <th>Hit Rate</th>
+                                    <th>Operations</th>
+                                    <th>Avg Latency</th>
+                                    <th>Size (MB)</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <tr foreach="$driver_stats as $driver => $stats">
+                                    <td class="font-mono">{{$driver}}</td>
+                                    <td>{{$stats['hit_rate']}}%</td>
+                                    <td>{{$stats['operations']}}</td>
+                                    <td>{{$stats['avg_latency']}}ms</td>
+                                    <td>{{$stats['size']}}MB</td>
+                                </tr>
+                            </tbody>
+                        </table>
                     </div>
                 </div>
-            </if>
+            </div>
 
             <!-- Real-time Metrics (JavaScript will update these) -->
             <div class="admin-card">
diff --git a/src/Application/Admin/templates/components/breadcrumbs.component.php b/src/Application/Admin/templates/components/breadcrumbs.component.php
index 5e513152..545fce80 100644
--- a/src/Application/Admin/templates/components/breadcrumbs.component.php
+++ b/src/Application/Admin/templates/components/breadcrumbs.component.php
@@ -13,30 +13,21 @@
         </li>
 
         <!-- LinkCollection Items -->
-        <if condition="breadcrumbs && breadcrumbs.count() > 0">
-            <for items="breadcrumbs" as="link" index="index">
-                <!-- Separator -->
-                <li class="admin-breadcrumbs__separator" aria-hidden="true">
-                    <svg class="admin-breadcrumbs__separator-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"/>
-                    </svg>
-                </li>
+        <li class="admin-breadcrumbs__separator" aria-hidden="true" foreach="$breadcrumbs as $link">
+            <svg class="admin-breadcrumbs__separator-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"/>
+            </svg>
+        </li>
 
-                <!-- Breadcrumb Item -->
-                <li class="admin-breadcrumbs__item">
-                    <!-- Check if current page (AccessibleLink with aria-current) -->
-                    <if condition="link.hasAttribute('aria-current')">
-                        <span class="admin-breadcrumbs__current" aria-current="page">
-                            {link.text}
-                        </span>
-                    <else>
-                        <a href="{link.href}" class="admin-breadcrumbs__link">
-                            {link.text}
-                        </a>
-                    </else>
-                    </if>
-                </li>
-            </for>
-        </if>
+        <!-- Breadcrumb Item -->
+        <li class="admin-breadcrumbs__item" foreach="$breadcrumbs as $link">
+            <!-- Check if current page (AccessibleLink with aria-current) -->
+            <span class="admin-breadcrumbs__current" aria-current="page" if="{{$link->hasAttribute('aria-current')}}">
+                {{$link->text}}
+            </span>
+            <a href="{{$link->href}}" class="admin-breadcrumbs__link" if="{{!$link->hasAttribute('aria-current')}}">
+                {{$link->text}}
+            </a>
+        </li>
     </ol>
 </nav>
diff --git a/src/Application/Admin/templates/components/sidebar.component.php b/src/Application/Admin/templates/components/sidebar.component.php
index 725de7e3..6ca81d24 100644
--- a/src/Application/Admin/templates/components/sidebar.component.php
+++ b/src/Application/Admin/templates/components/sidebar.component.php
@@ -15,7 +15,7 @@
         <div class="admin-nav__section">
             <ul class="admin-nav__list" role="list">
                 <li class="admin-nav__item">
-                    <a href="/admin" class="admin-nav__link" aria-current="{current_path === '/admin' ? 'page' : null}">
+                    <a href="/admin" class="admin-nav__link" aria-current="{{$current_path === '/admin' ? 'page' : null}}">
                         <svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"/>
                         </svg>
@@ -30,7 +30,7 @@
             <h2 class="admin-nav__section-title">Content</h2>
             <ul class="admin-nav__list" role="list">
                 <li class="admin-nav__item">
-                    <a href="/admin/pages" class="admin-nav__link" aria-current="{current_path === '/admin/pages' ? 'page' : null}">
+                    <a href="/admin/pages" class="admin-nav__link" aria-current="{{$current_path === '/admin/pages' ? 'page' : null}}">
                         <svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
                         </svg>
@@ -38,7 +38,7 @@
                     </a>
                 </li>
                 <li class="admin-nav__item">
-                    <a href="/admin/media" class="admin-nav__link" aria-current="{current_path === '/admin/media' ? 'page' : null}">
+                    <a href="/admin/media" class="admin-nav__link" aria-current="{{$current_path === '/admin/media' ? 'page' : null}}">
                         <svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z"/>
                         </svg>
@@ -53,7 +53,7 @@
             <h2 class="admin-nav__section-title">System</h2>
             <ul class="admin-nav__list" role="list">
                 <li class="admin-nav__item">
-                    <a href="/admin/users" class="admin-nav__link" aria-current="{current_path === '/admin/users' ? 'page' : null}">
+                    <a href="/admin/users" class="admin-nav__link" aria-current="{{$current_path === '/admin/users' ? 'page' : null}}">
                         <svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
                         </svg>
@@ -61,7 +61,7 @@
                     </a>
                 </li>
                 <li class="admin-nav__item">
-                    <a href="/admin/settings" class="admin-nav__link" aria-current="{current_path === '/admin/settings' ? 'page' : null}">
+                    <a href="/admin/settings" class="admin-nav__link" aria-current="{{$current_path === '/admin/settings' ? 'page' : null}}">
                         <svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"/>
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
@@ -77,15 +77,15 @@
     <div class="admin-sidebar__footer">
         <a href="/admin/profile" class="admin-sidebar__user">
             <img
-                src="{user.avatar ?? '/assets/default-avatar.png'}"
-                alt="{user.name}"
+                src="{{$user['avatar'] ?? '/assets/default-avatar.png'}}"
+                alt="{{$user['name']}}"
                 class="admin-sidebar__avatar"
                 width="32"
                 height="32"
             />
             <div class="admin-sidebar__user-info">
-                <span class="admin-sidebar__user-name">{user.name}</span>
-                <span class="admin-sidebar__user-role">{user.role}</span>
+                <span class="admin-sidebar__user-name">{{$user['name']}}</span>
+                <span class="admin-sidebar__user-role">{{$user['role']}}</span>
             </div>
         </a>
     </div>
diff --git a/src/Application/Admin/templates/dashboard.view.php b/src/Application/Admin/templates/dashboard.view.php
index 274f5533..59f16dd1 100644
--- a/src/Application/Admin/templates/dashboard.view.php
+++ b/src/Application/Admin/templates/dashboard.view.php
@@ -25,11 +25,11 @@
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Uptime</span>
-                    <span class="admin-stat-list__value">{{ uptime_formatted }}</span>
+                    <span class="admin-stat-list__value">{{$uptime_formatted}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Version</span>
-                    <span class="admin-stat-list__value">{{ $framework_version }}</span>
+                    <span class="admin-stat-list__value">{{$framework_version}}</span>
                 </div>
             </div>
         </div>
@@ -43,15 +43,15 @@
             <div class="admin-stat-list">
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Memory Usage</span>
-                    <span class="admin-stat-list__value">{{ memory_usage_formatted }}</span>
+                    <span class="admin-stat-list__value">{{$memory_usage_formatted}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Peak Memory</span>
-                    <span class="admin-stat-list__value">{{ peak_memory_formatted }}</span>
+                    <span class="admin-stat-list__value">{{$peak_memory_formatted}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Load Average</span>
-                    <span class="admin-stat-list__value">{{ load_average }}</span>
+                    <span class="admin-stat-list__value">{{$load_average}}</span>
                 </div>
             </div>
         </div>
@@ -69,11 +69,11 @@
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Pool Size</span>
-                    <span class="admin-stat-list__value">{{ db_pool_size }}</span>
+                    <span class="admin-stat-list__value">{{$db_pool_size}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Active Connections</span>
-                    <span class="admin-stat-list__value">{{ db_active_connections }}</span>
+                    <span class="admin-stat-list__value">{{$db_active_connections}}</span>
                 </div>
             </div>
         </div>
@@ -90,11 +90,11 @@
             <div class="admin-stat-list">
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Hit Rate</span>
-                    <span class="admin-stat-list__value">{{ cache_hit_rate }}</span>
+                    <span class="admin-stat-list__value">{{$cache_hit_rate}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Total Operations</span>
-                    <span class="admin-stat-list__value">{{ cache_total_operations }}</span>
+                    <span class="admin-stat-list__value">{{$cache_total_operations}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Status</span>
@@ -112,15 +112,15 @@
             <div class="admin-stat-list">
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Requests Today</span>
-                    <span class="admin-stat-list__value">{{ requests_today }}</span>
+                    <span class="admin-stat-list__value">{{$requests_today}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Errors</span>
-                    <span class="admin-stat-list__value">{{ errors_today }}</span>
+                    <span class="admin-stat-list__value">{{$errors_today}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Last Deployment</span>
-                    <span class="admin-stat-list__value">{{ last_deployment }}</span>
+                    <span class="admin-stat-list__value">{{$last_deployment}}</span>
                 </div>
             </div>
         </div>
@@ -132,9 +132,9 @@
         </div>
         <div class="admin-card__content">
             <div class="admin-cluster">
-                <x-a href="{{ clear_cache_url }}" class="admin-btn admin-btn--primary">Clear Cache</x-a>
-                <x-a href="{{ logs_url }}" class="admin-btn admin-btn--secondary">View Logs</x-a>
-                <x-a href="{{ migrations_url }}" class="admin-btn admin-btn--accent">Migrations</x-a>
+                <x-a href="{{$clear_cache_url}}" class="admin-btn admin-btn--primary">Clear Cache</x-a>
+                <x-a href="{{$logs_url}}" class="admin-btn admin-btn--secondary">View Logs</x-a>
+                <x-a href="{{$migrations_url}}" class="admin-btn admin-btn--accent">Migrations</x-a>
             </div>
         </div>
     </div>
diff --git a/src/Application/Admin/templates/database/browser.view.php b/src/Application/Admin/templates/database/browser.view.php
new file mode 100644
index 00000000..e60dd535
--- /dev/null
+++ b/src/Application/Admin/templates/database/browser.view.php
@@ -0,0 +1,33 @@
+<layout name="admin" />
+
+<div class="admin-page">
+    <div class="page-header">
+        <h1>{{ $title }}</h1>
+    </div>
+
+    <div class="stats-grid">
+        <div class="stat-card">
+            <h3>Database Information</h3>
+            <p><strong>Name:</strong> {{$database['name']}}</p>
+            <p if="{{$database['charset']}}"><strong>Charset:</strong> {{$database['charset']}}</p>
+            <p if="{{$database['collation']}}"><strong>Collation:</strong> {{$database['collation']}}</p>
+            <p><strong>Total Tables:</strong> {{$table_count}}</p>
+            <p if="{{$database['size_mb']}}"><strong>Total Size:</strong> {{number_format($database['size_mb'], 2)}} MB</p>
+        </div>
+    </div>
+
+    <div class="admin-card">
+        <h2>Tables</h2>
+        <div class="table-container">
+            {{$table}}
+        </div>
+
+        <div class="pagination-info" if="{{$pagination}}">
+            <p>
+                Showing page {{$pagination['current_page']}} of {{$pagination['total_pages']}}
+                ({{$pagination['total_items']}} total tables)
+            </p>
+        </div>
+    </div>
+</div>
+
diff --git a/src/Application/Admin/templates/database/table-detail.view.php b/src/Application/Admin/templates/database/table-detail.view.php
new file mode 100644
index 00000000..f3a336f7
--- /dev/null
+++ b/src/Application/Admin/templates/database/table-detail.view.php
@@ -0,0 +1,49 @@
+<layout name="admin" />
+
+<div class="admin-page">
+    <div class="page-header">
+        <h1>{{ $title }}</h1>
+        <div class="page-actions">
+            <a href="/admin/database" class="btn btn-secondary">Back to Database</a>
+        </div>
+    </div>
+
+    <div class="alert alert-error" if="{{$error}}">
+        {{$error}}
+    </div>
+
+    <div if="{{$table}}">
+        <div class="stats-grid">
+            <div class="stat-card">
+                <h3>Table Information</h3>
+                <p><strong>Name:</strong> {{$table['name']}}</p>
+                <p if="{{$table['row_count']}}"><strong>Rows:</strong> {{number_format($table['row_count'])}}</p>
+                <p if="{{$table['size_mb']}}"><strong>Size:</strong> {{number_format($table['size_mb'], 2)}} MB</p>
+                <p if="{{$table['engine']}}"><strong>Engine:</strong> {{$table['engine']}}</p>
+                <p if="{{$table['collation']}}"><strong>Collation:</strong> {{$table['collation']}}</p>
+            </div>
+        </div>
+
+        <div class="admin-card">
+            <h2>Columns</h2>
+            <div class="table-container">
+                {{$columns_table}}
+            </div>
+        </div>
+
+        <div class="admin-card" if="{{$has_indexes}}">
+            <h2>Indexes</h2>
+            <div class="table-container">
+                {{$indexes_table}}
+            </div>
+        </div>
+
+        <div class="admin-card" if="{{$has_foreign_keys}}">
+            <h2>Foreign Keys</h2>
+            <div class="table-container">
+                {{$foreign_keys_table}}
+            </div>
+        </div>
+    </div>
+</div>
+
diff --git a/src/Application/Admin/templates/deployment-dashboard.view.php b/src/Application/Admin/templates/deployment-dashboard.view.php
index ffee7436..9aab630f 100644
--- a/src/Application/Admin/templates/deployment-dashboard.view.php
+++ b/src/Application/Admin/templates/deployment-dashboard.view.php
@@ -19,7 +19,7 @@
         </div>
         <div class="admin-card__content">
             <div class="admin-stat-big">
-                <span class="admin-stat-big__value">{{ $totalDeployments }}</span>
+                <span class="admin-stat-big__value">{{$totalDeployments}}</span>
                 <span class="admin-stat-big__label">All Time</span>
             </div>
         </div>
@@ -31,7 +31,7 @@
         </div>
         <div class="admin-card__content">
             <div class="admin-stat-big">
-                <span class="admin-stat-big__value">{{ $successRate }}%</span>
+                <span class="admin-stat-big__value">{{$successRate}}%</span>
                 <span class="admin-stat-big__label">Success</span>
             </div>
         </div>
@@ -43,7 +43,7 @@
         </div>
         <div class="admin-card__content">
             <div class="admin-stat-big">
-                <span class="admin-stat-big__value">{{ $failedDeployments }}</span>
+                <span class="admin-stat-big__value">{{$failedDeployments}}</span>
                 <span class="admin-stat-big__label">Failures</span>
             </div>
         </div>
@@ -55,7 +55,7 @@
         </div>
         <div class="admin-card__content">
             <div class="admin-stat-big">
-                <span class="admin-stat-big__value">{{ $averageDurationFormatted }}</span>
+                <span class="admin-stat-big__value">{{$averageDurationFormatted}}</span>
                 <span class="admin-stat-big__label">Avg Time</span>
             </div>
         </div>
@@ -72,19 +72,19 @@
             <div class="admin-stat-list">
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Total Deployments</span>
-                    <span class="admin-stat-list__value">{{ $productionStats['total_deployments'] }}</span>
+                    <span class="admin-stat-list__value">{{$productionStats['total_deployments']}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Success Rate</span>
-                    <span class="admin-stat-list__value">{{ $productionStats['success_rate'] }}%</span>
+                    <span class="admin-stat-list__value">{{$productionStats['success_rate']}}%</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Failed</span>
-                    <span class="admin-stat-list__value">{{ $productionStats['failed'] }}</span>
+                    <span class="admin-stat-list__value">{{$productionStats['failed']}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Rolled Back</span>
-                    <span class="admin-stat-list__value">{{ $productionStats['rolled_back'] }}</span>
+                    <span class="admin-stat-list__value">{{$productionStats['rolled_back']}}</span>
                 </div>
             </div>
         </div>
@@ -98,19 +98,19 @@
             <div class="admin-stat-list">
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Total Deployments</span>
-                    <span class="admin-stat-list__value">{{ $stagingStats['total_deployments'] }}</span>
+                    <span class="admin-stat-list__value">{{$stagingStats['total_deployments']}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Success Rate</span>
-                    <span class="admin-stat-list__value">{{ $stagingStats['success_rate'] }}%</span>
+                    <span class="admin-stat-list__value">{{$stagingStats['success_rate']}}%</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Failed</span>
-                    <span class="admin-stat-list__value">{{ $stagingStats['failed'] }}</span>
+                    <span class="admin-stat-list__value">{{$stagingStats['failed']}}</span>
                 </div>
                 <div class="admin-stat-list__item">
                     <span class="admin-stat-list__label">Rolled Back</span>
-                    <span class="admin-stat-list__value">{{ $stagingStats['rolled_back'] }}</span>
+                    <span class="admin-stat-list__value">{{$stagingStats['rolled_back']}}</span>
                 </div>
             </div>
         </div>
@@ -123,7 +123,7 @@
         <h3 class="admin-card__title">Recent Deployments</h3>
     </div>
     <div class="admin-card__content">
-        <div if="count($recentDeployments) > 0">
+        <div if="{{count($recentDeployments) > 0}}">
             <table class="admin-table">
                 <thead>
                     <tr>
@@ -138,31 +138,29 @@
                     </tr>
                 </thead>
                 <tbody>
-                    <for items="recentDeployments" as="deployment">
-                        <tr>
-                            <td><code>{{ $deployment['pipelineId'] }}</code></td>
-                            <td>
-                                <span class="admin-badge admin-badge--neutral">
-                                    {{ $deployment['environment'] }}
-                                </span>
-                            </td>
-                            <td>
-                                <span class="admin-badge {{ $deployment['statusBadgeClass'] }}">
-                                    {{ $deployment['status'] }}
-                                </span>
-                                <span if="$deployment['wasRolledBack']" class="admin-badge admin-badge--warning">Rolled Back</span>
-                            </td>
-                            <td>{{ $deployment['durationFormatted'] }}</td>
-                            <td>{{ $deployment['stageCount'] }}</td>
-                            <td>{{ $deployment['successRate'] }}%</td>
-                            <td>{{ $deployment['startedAt'] }}</td>
-                            <td>{{ $deployment['completedAt'] }}</td>
-                        </tr>
-                    </for>
+                    <tr foreach="$recentDeployments as $deployment">
+                        <td><code>{{$deployment['pipelineId']}}</code></td>
+                        <td>
+                            <span class="admin-badge admin-badge--neutral">
+                                {{$deployment['environment']}}
+                            </span>
+                        </td>
+                        <td>
+                            <span class="admin-badge {{$deployment['statusBadgeClass']}}">
+                                {{$deployment['status']}}
+                            </span>
+                            <span if="{{$deployment['wasRolledBack']}}" class="admin-badge admin-badge--warning">Rolled Back</span>
+                        </td>
+                        <td>{{$deployment['durationFormatted']}}</td>
+                        <td>{{$deployment['stageCount']}}</td>
+                        <td>{{$deployment['successRate']}}%</td>
+                        <td>{{$deployment['startedAt']}}</td>
+                        <td>{{$deployment['completedAt']}}</td>
+                    </tr>
                 </tbody>
             </table>
         </div>
-        <div if="count($recentDeployments) === 0">
+        <div if="{{count($recentDeployments) === 0}}">
             <div class="admin-empty-state">
                 <p class="admin-empty-state__text">No deployments found</p>
             </div>
@@ -171,7 +169,7 @@
 </div>
 
 <!-- Failed Deployments Section -->
-<div if="count($failedDeployments) > 0" class="admin-card" style="margin-top: var(--admin-spacing-xl);">
+    <div class="admin-card" style="margin-top: var(--admin-spacing-xl);" if="{{count($failedDeployments) > 0}}">
     <div class="admin-card__header">
         <h3 class="admin-card__title">Recent Failed Deployments</h3>
     </div>
@@ -188,30 +186,28 @@
                 </tr>
             </thead>
             <tbody>
-                <for items="failedDeployments" as="deployment">
-                    <tr>
-                        <td><code>{{ $deployment['pipelineId'] }}</code></td>
-                        <td>
-                            <span class="admin-badge admin-badge--neutral">
-                                {{ $deployment['environment'] }}
-                            </span>
-                        </td>
-                        <td>
-                            <span if="$deployment['failedStage'] !== null" class="admin-badge admin-badge--danger">
-                                {{ $deployment['failedStage'] }}
-                            </span>
-                            <span if="$deployment['failedStage'] === null" class="admin-badge admin-badge--neutral">N/A</span>
-                        </td>
-                        <td>
-                            <span if="$deployment['error'] !== null" class="admin-text-truncate" title="{{ $deployment['error'] }}">
-                                {{ $deployment['error'] }}
-                            </span>
-                            <span if="$deployment['error'] === null" class="admin-text-muted">No error message</span>
-                        </td>
-                        <td>{{ $deployment['durationFormatted'] }}</td>
-                        <td>{{ $deployment['startedAt'] }}</td>
-                    </tr>
-                </for>
+                <tr foreach="$failedDeployments as $deployment">
+                    <td><code>{{$deployment['pipelineId']}}</code></td>
+                    <td>
+                        <span class="admin-badge admin-badge--neutral">
+                            {{$deployment['environment']}}
+                        </span>
+                    </td>
+                    <td>
+                        <span if="{{$deployment['failedStage'] !== null}}" class="admin-badge admin-badge--danger">
+                            {{$deployment['failedStage']}}
+                        </span>
+                        <span if="{{$deployment['failedStage'] === null}}" class="admin-badge admin-badge--neutral">N/A</span>
+                    </td>
+                    <td>
+                        <span if="{{$deployment['error'] !== null}}" class="admin-text-truncate" title="{{$deployment['error']}}">
+                            {{$deployment['error']}}
+                        </span>
+                        <span if="{{$deployment['error'] === null}}" class="admin-text-muted">No error message</span>
+                    </td>
+                    <td>{{$deployment['durationFormatted']}}</td>
+                    <td>{{$deployment['startedAt']}}</td>
+                </tr>
             </tbody>
         </table>
     </div>
diff --git a/src/Application/Admin/templates/docker-dashboard.view.php b/src/Application/Admin/templates/docker-dashboard.view.php
new file mode 100644
index 00000000..4fac4eb8
--- /dev/null
+++ b/src/Application/Admin/templates/docker-dashboard.view.php
@@ -0,0 +1,11 @@
+<layout name="admin" />
+
+<div class="admin-page">
+    <div class="page-header">
+        <h1>{{$title}}</h1>
+    </div>
+    
+    <!-- LiveComponent for real-time Docker container monitoring -->
+    <x-docker-containers id="docker-dashboard" />
+
+
diff --git a/src/Application/Admin/templates/environment.view.php b/src/Application/Admin/templates/environment.view.php
index 6f401bf1..545a3d99 100644
--- a/src/Application/Admin/templates/environment.view.php
+++ b/src/Application/Admin/templates/environment.view.php
@@ -1,7 +1,7 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>Umgebungsvariablen</h2>
+    <h2>{{$title}}</h2>
 
     <div class="admin-tools">
         <input type="text" id="envFilter" placeholder="Variablen filtern..." style="padding: 8px 12px; border: 1px solid var(--gray-300); border-radius: 6px; width: 300px;">
diff --git a/src/Application/Admin/templates/health-dashboard.view.php b/src/Application/Admin/templates/health-dashboard.view.php
index 27eca3bc..35292c7c 100644
--- a/src/Application/Admin/templates/health-dashboard.view.php
+++ b/src/Application/Admin/templates/health-dashboard.view.php
@@ -1,84 +1,12 @@
 <layout name="admin" />
-<!-- Cache invalidation: 2025-01-20 16:11 -->
+
 <div class="section">
-    <h2>{{ title }}</h2>
-
-    <div class="admin-card">
-        <div class="admin-card__header">
-            <h3 class="admin-card__title">System Overview</h3>
-        </div>
-        <div class="admin-card__content">
-            <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--space-md); margin-bottom: var(--space-lg);">
-                <div class="metric-card">
-                    <div class="metric-card__value" style="color: var(--success);">
-                        {{ overall_status }}
-                    </div>
-                    <div class="metric-card__label">Overall Status</div>
-                </div>
-                <div class="metric-card">
-                    <div class="metric-card__value">{{ total_checks }}</div>
-                    <div class="metric-card__label">Total Checks</div>
-                </div>
-                <div class="metric-card">
-                    <div class="metric-card__value" style="color: var(--success);">{{ healthy_checks }}</div>
-                    <div class="metric-card__label">Healthy</div>
-                </div>
-                <div class="metric-card">
-                    <div class="metric-card__value" style="color: var(--warning);">{{ warning_checks }}</div>
-                    <div class="metric-card__label">Warnings</div>
-                </div>
-                <div class="metric-card">
-                    <div class="metric-card__value" style="color: var(--error);">{{ failed_checks }}</div>
-                    <div class="metric-card__label">Failed</div>
-                </div>
-            </div>
-        </div>
-    </div>
-
-    <div class="admin-card" style="margin-top: var(--space-lg);">
-        <div class="admin-card__header">
-            <h3 class="admin-card__title">Health Check Details</h3>
-            <button class="admin-button admin-button--small" onclick="refreshHealthChecks()" style="margin-left: auto;">
-                🔄 Refresh
-            </button>
-        </div>
-        <table-data source="health_check_table" container-class="admin-card" />
-    </div>
+    <h2>{{$title}}</h2>
+    
+    <!-- LiveComponent for real-time health status -->
+    <x-health-status id="health-dashboard" />
 </div>
 
-<script>
-function toggleDetails(id) {
-    const element = document.getElementById(id);
-    if (element) {
-        element.style.display = element.style.display === 'none' ? 'table-row' : 'none';
-    }
-}
-
-function refreshHealthChecks() {
-    window.location.reload();
-}
-
-// Auto-refresh health status every 60 seconds
-setInterval(function() {
-    window.location.reload();
-}, 60000);
-</script>
-
-<style>
-.metric-card {
-    text-align: center;
-    padding: var(--space-md);
-    border: 1px solid var(--border);
-    border-radius: var(--radius-md);
-    background: var(--bg-alt);
-}
-
-.metric-card__value {
-    font-size: 2rem;
-    font-weight: 700;
-    margin-bottom: var(--space-sm);
-}
-
 .metric-card__label {
     color: var(--muted);
     font-size: 0.875rem;
diff --git a/src/Application/Admin/templates/image-manager.view.php b/src/Application/Admin/templates/image-manager.view.php
index fc2aa4ef..9a6b1c9b 100644
--- a/src/Application/Admin/templates/image-manager.view.php
+++ b/src/Application/Admin/templates/image-manager.view.php
@@ -3,8 +3,8 @@
 <div class="section">
     <div class="page-header-actions">
         <div>
-            <h2>{{ title }}</h2>
-            <p>{{ subtitle }}</p>
+            <h2>{{$title}}</h2>
+            <p>{{$subtitle}}</p>
         </div>
     </div>
 
@@ -68,24 +68,22 @@
         </p>
 
         <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 20px;">
-            <for var="slot" in="slots">
-                <div class="stat-card slot-item" data-slot-id="{{ slot.id }}">
-                    <div style="display: flex; justify-content: space-between; align-items: center;">
-                        <div>
-                            <h4>{{ slot.slotName }}</h4>
-                            <p style="color: var(--gray-600); margin: 0;">ID: {{ slot.id }}</p>
-                        </div>
-                        <div class="slot-image-container" style="width: 100px; height: 100px;">
-                            <div style="border: 2px dashed var(--gray-300); display: flex; align-items: center; justify-content: center; height: 100%; border-radius: 4px; cursor: pointer;"
-                                 ondrop="handleDrop(event, '{{ slot.id }}')"
-                                 ondragover="handleDragOver(event)"
-                                 ondragleave="handleDragLeave(event)">
-                                <span style="color: var(--gray-500); font-size: 12px; text-align: center;">Drop image here</span>
-                            </div>
+            <div class="stat-card slot-item" data-slot-id="{{$slot->id}}" foreach="$slots as $slot">
+                <div style="display: flex; justify-content: space-between; align-items: center;">
+                    <div>
+                        <h4>{{$slot->slotName}}</h4>
+                        <p style="color: var(--gray-600); margin: 0;">ID: {{$slot->id}}</p>
+                    </div>
+                    <div class="slot-image-container" style="width: 100px; height: 100px;">
+                        <div style="border: 2px dashed var(--gray-300); display: flex; align-items: center; justify-content: center; height: 100%; border-radius: 4px; cursor: pointer;"
+                             ondrop="handleDrop(event, '{{$slot->id}}')"
+                             ondragover="handleDragOver(event)"
+                             ondragleave="handleDragLeave(event)">
+                            <span style="color: var(--gray-500); font-size: 12px; text-align: center;">Drop image here</span>
                         </div>
                     </div>
                 </div>
-            </for>
+            </div>
         </div>
     </div>
 </div>
diff --git a/src/Application/Admin/templates/imageslot.view.php b/src/Application/Admin/templates/imageslot.view.php
index 789f2d81..4454a8ee 100644
--- a/src/Application/Admin/templates/imageslot.view.php
+++ b/src/Application/Admin/templates/imageslot.view.php
@@ -1,10 +1,10 @@
 <layout src="admin-main"/>
 
-<form action='/admin/imageslots/edit/{{ id }}' method='post'>
+<form action='/admin/imageslots/edit/{{$id}}' method='post'>
     <input type='hidden' name='_method' value='PUT'/>
 
     <label>Slot Name:
-        <input type='text' name='slotName' value='{{ slotName }}'/>
+        <input type='text' name='slotName' value='{{$slotName}}'/>
     </label>
     <input type='submit' value='Update'/>
 
diff --git a/src/Application/Admin/templates/imageslots.view.php b/src/Application/Admin/templates/imageslots.view.php
index 6fa0fef0..5d037013 100644
--- a/src/Application/Admin/templates/imageslots.view.php
+++ b/src/Application/Admin/templates/imageslots.view.php
@@ -1,47 +1,39 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
+    <h2>{{$title}}</h2>
 
     <div class="admin-card">
         <div class="admin-card__header">
             <h3 class="admin-card__title">Existing Image Slots</h3>
         </div>
         <div class="admin-card__content">
-            <if condition="slots">
-                <div class="admin-table-wrapper">
-                    <table class="admin-table">
-                        <thead>
-                            <tr>
-                                <th>Slot Name</th>
-                                <th>Current Image</th>
-                                <th>Actions</th>
-                            </tr>
-                        </thead>
-                        <tbody>
-                            <for var="slot" in="slots">
-                                <tr>
-                                    <td>{{ slot.slotName }}</td>
-                                    <td>
-                                        <if condition="slot.image">
-                                            {{ slot.image.filename }}
-                                        <else/>
-                                            <span style="color: var(--muted);">No image assigned</span>
-                                        </if>
-                                    </td>
-                                    <td class="admin-table__actions">
-                                        <form action="/admin/content/image-slots/{{ slot.slotName }}" method="post" style="display: inline;">
-                                            <button type="submit" class="admin-table__action">Edit</button>
-                                        </form>
-                                    </td>
-                                </tr>
-                            </for>
-                        </tbody>
-                    </table>
-                </div>
-            <else/>
-                <p style="color: var(--muted); text-align: center; padding: var(--space-lg);">No image slots created yet.</p>
-            </if>
+            <div class="admin-table-wrapper" if="{{$slots}}">
+                <table class="admin-table">
+                    <thead>
+                        <tr>
+                            <th>Slot Name</th>
+                            <th>Current Image</th>
+                            <th>Actions</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr foreach="$slots as $slot">
+                            <td>{{$slot->slotName}}</td>
+                            <td>
+                                <span if="{{$slot->image}}">{{$slot->image->filename}}</span>
+                                <span style="color: var(--muted);" if="{{!$slot->image}}">No image assigned</span>
+                            </td>
+                            <td class="admin-table__actions">
+                                <form action="/admin/content/image-slots/{{$slot->slotName}}" method="post" style="display: inline;">
+                                    <button type="submit" class="admin-table__action">Edit</button>
+                                </form>
+                            </td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <p style="color: var(--muted); text-align: center; padding: var(--space-lg);" if="{{!$slots}}">No image slots created yet.</p>
         </div>
     </div>
 
diff --git a/src/Application/Admin/templates/log-viewer.view.php b/src/Application/Admin/templates/log-viewer.view.php
index f3ddecc0..5b1d8aee 100644
--- a/src/Application/Admin/templates/log-viewer.view.php
+++ b/src/Application/Admin/templates/log-viewer.view.php
@@ -1,7 +1,7 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>📄 {{ title }}</h2>
+    <h2>📄 {{$title}}</h2>
 
     <div class="admin-card">
         <div class="admin-card__header">
diff --git a/src/Application/Admin/templates/migrations.view.php b/src/Application/Admin/templates/migrations.view.php
index abe925e4..ca0e0550 100644
--- a/src/Application/Admin/templates/migrations.view.php
+++ b/src/Application/Admin/templates/migrations.view.php
@@ -1,29 +1,24 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
+    <h2>{{$title}}</h2>
 
     <div class="stats-grid">
         <div class="stat-card">
             <h3>Migration Status</h3>
-            <p><strong>Total Migrations:</strong> {{ total_migrations }}</p>
-            <p><strong>Applied:</strong> <span style="color: var(--success);">{{ applied_count }}</span></p>
-            <p><strong>Pending:</strong> <span style="color: var(--warning);">{{ pending_count }}</span></p>
+            <p><strong>Total Migrations:</strong> {{$total_migrations}}</p>
+            <p><strong>Applied:</strong> <span style="color: var(--success);">{{$applied_count}}</span></p>
+            <p><strong>Pending:</strong> <span style="color: var(--warning);">{{$pending_count}}</span></p>
         </div>
 
         <div class="stat-card">
             <h3>Database State</h3>
-            <p><strong>Pending Count:</strong> {{ pending_count }}</p>
+            <p><strong>Pending Count:</strong> {{$pending_count}}</p>
             <p><strong>Status:</strong>
-                <if condition="{{ has_pending }}">
-                    <span style="color: var(--warning);">⚠️ {{ pending_count }} Migration(s) pending</span>
-                <else/>
-                    <span style="color: var(--success);">✅ Database is up to date</span>
-                </if>
+                <span style="color: var(--warning);" if="{{$has_pending}}">⚠️ {{$pending_count}} Migration(s) pending</span>
+                <span style="color: var(--success);" if="{{!$has_pending}}">✅ Database is up to date</span>
             </p>
-            <if condition="{{ has_pending }}">
-                <p><strong>Action Required:</strong> <span style="color: var(--error);">Run migrations to update database</span></p>
-            </if>
+            <p if="{{$has_pending}}"><strong>Action Required:</strong> <span style="color: var(--error);">Run migrations to update database</span></p>
         </div>
     </div>
 
diff --git a/src/Application/Admin/templates/ml-dashboard.view.php b/src/Application/Admin/templates/ml-dashboard.view.php
index a68dddd3..6a2b8a95 100644
--- a/src/Application/Admin/templates/ml-dashboard.view.php
+++ b/src/Application/Admin/templates/ml-dashboard.view.php
@@ -33,20 +33,20 @@
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Overall Status</span>
                         <span class="admin-stat-item__value">
-                            <span class="admin-badge admin-badge--{{ $overall_badge }}">{{ $overall_status }}</span>
+                            <span class="admin-badge admin-badge--{{$overall_badge}}">{{$overall_status}}</span>
                         </span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Health Percentage</span>
-                        <span class="admin-stat-item__value">{{ $health_percentage }}%</span>
+                        <span class="admin-stat-item__value">{{$health_percentage}}%</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Average Accuracy</span>
-                        <span class="admin-stat-item__value">{{ $average_accuracy }}%</span>
+                        <span class="admin-stat-item__value">{{$average_accuracy}}%</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Time Window</span>
-                        <span class="admin-stat-item__value">{{ $time_window_hours }} hours</span>
+                        <span class="admin-stat-item__value">{{$time_window_hours}} hours</span>
                     </div>
                 </div>
             </div>
@@ -61,24 +61,24 @@
                 <div class="admin-stat-list">
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Total Models</span>
-                        <span class="admin-stat-item__value">{{ $total_models }}</span>
+                        <span class="admin-stat-item__value">{{$total_models}}</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Healthy</span>
                         <span class="admin-stat-item__value">
-                            <span class="admin-badge admin-badge--success">{{ $healthy_models }}</span>
+                            <span class="admin-badge admin-badge--success">{{$healthy_models}}</span>
                         </span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Degraded</span>
                         <span class="admin-stat-item__value">
-                            <span class="admin-badge admin-badge--warning">{{ $degraded_models }}</span>
+                            <span class="admin-badge admin-badge--warning">{{$degraded_models}}</span>
                         </span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Critical</span>
                         <span class="admin-stat-item__value">
-                            <span class="admin-badge admin-badge--danger">{{ $critical_models }}</span>
+                            <span class="admin-badge admin-badge--danger">{{$critical_models}}</span>
                         </span>
                     </div>
                 </div>
@@ -94,19 +94,19 @@
                 <div class="admin-stat-list">
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Total Predictions</span>
-                        <span class="admin-stat-item__value">{{ $total_predictions }}</span>
+                        <span class="admin-stat-item__value">{{$total_predictions}}</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Supervised Models</span>
-                        <span class="admin-stat-item__value">{{ $supervised_count }}</span>
+                        <span class="admin-stat-item__value">{{$supervised_count}}</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Unsupervised Models</span>
-                        <span class="admin-stat-item__value">{{ $unsupervised_count }}</span>
+                        <span class="admin-stat-item__value">{{$unsupervised_count}}</span>
                     </div>
                     <div class="admin-stat-item">
                         <span class="admin-stat-item__label">Reinforcement Models</span>
-                        <span class="admin-stat-item__value">{{ $reinforcement_count }}</span>
+                        <span class="admin-stat-item__value">{{$reinforcement_count}}</span>
                     </div>
                 </div>
             </div>
@@ -114,11 +114,11 @@
     </div>
 
     <!-- Degradation Alerts Section -->
-    <div class="admin-card" if="{{ $has_alerts }}">
+    <div class="admin-card" if="{{$has_alerts}}">
         <div class="admin-card__header">
             <h3 class="admin-card__title">
                 Degradation Alerts
-                <span class="admin-badge admin-badge--danger">{{ $alert_count }}</span>
+                <span class="admin-badge admin-badge--danger">{{$alert_count}}</span>
             </h3>
         </div>
         <div class="admin-card__content">
@@ -137,23 +137,23 @@
                     <tbody>
                         <tr foreach="$alerts as $alert">
                             <td>
-                                <strong>{{ $alert['model_name'] }}</strong>
+                                <strong>{{$alert['model_name']}}</strong>
                             </td>
                             <td>
-                                <code>{{ $alert['version'] }}</code>
+                                <code>{{$alert['version']}}</code>
                             </td>
                             <td>
-                                <span class="admin-badge admin-badge--{{ $alert['severity_badge'] }}">
-                                    {{ $alert['current_accuracy'] }}%
+                                <span class="admin-badge admin-badge--{{$alert['severity_badge']}}">
+                                    {{$alert['current_accuracy']}}%
                                 </span>
                             </td>
-                            <td>{{ $alert['threshold'] }}%</td>
+                            <td>{{$alert['threshold']}}%</td>
                             <td>
-                                <span class="admin-badge admin-badge--{{ $alert['severity_badge'] }}">
-                                    {{ $alert['severity'] }}
+                                <span class="admin-badge admin-badge--{{$alert['severity_badge']}}">
+                                    {{$alert['severity']}}
                                 </span>
                             </td>
-                            <td>{{ $alert['recommendation'] }}</td>
+                            <td>{{$alert['recommendation']}}</td>
                         </tr>
                     </tbody>
                 </table>
@@ -187,38 +187,38 @@
                     <tbody>
                         <tr foreach="$models as $model">
                             <td>
-                                <strong>{{ $model['model_name'] }}</strong>
+                                <strong>{{$model['model_name']}}</strong>
                             </td>
                             <td>
-                                <code>{{ $model['version'] }}</code>
+                                <code>{{$model['version']}}</code>
                             </td>
                             <td>
                                 <span class="admin-badge admin-badge--info">
-                                    {{ $model['type'] }}
+                                    {{$model['type']}}
                                 </span>
                             </td>
-                            <td>{{ $model['accuracy'] }}%</td>
+                            <td>{{$model['accuracy']}}%</td>
                             <td>
-                                <span if="!{{ $model['precision'] }}">-</span>
-                                <span if="{{ $model['precision'] }}">{{ $model['precision'] }}%</span>
+                                <span if="{{!$model['precision']}}">-</span>
+                                <span if="{{$model['precision']}}">{{$model['precision']}}%</span>
                             </td>
                             <td>
-                                <span if="!{{ $model['recall'] }}">-</span>
-                                <span if="{{ $model['recall'] }}">{{ $model['recall'] }}%</span>
+                                <span if="{{!$model['recall']}}">-</span>
+                                <span if="{{$model['recall']}}">{{$model['recall']}}%</span>
                             </td>
                             <td>
-                                <span if="!{{ $model['f1_score'] }}">-</span>
-                                <span if="{{ $model['f1_score'] }}">{{ $model['f1_score'] }}%</span>
+                                <span if="{{!$model['f1_score']}}">-</span>
+                                <span if="{{$model['f1_score']}}">{{$model['f1_score']}}%</span>
                             </td>
-                            <td>{{ $model['total_predictions'] }}</td>
+                            <td>{{$model['total_predictions']}}</td>
                             <td>
-                                <span if="!{{ $model['average_confidence'] }}">-</span>
-                                <span if="{{ $model['average_confidence'] }}">{{ $model['average_confidence'] }}%</span>
+                                <span if="{{!$model['average_confidence']}}">-</span>
+                                <span if="{{$model['average_confidence']}}">{{$model['average_confidence']}}%</span>
                             </td>
-                            <td>{{ $model['threshold'] }}</td>
+                            <td>{{$model['threshold']}}</td>
                             <td>
-                                <span class="admin-badge admin-badge--{{ $model['status_badge'] }}">
-                                    {{ $model['status'] }}
+                                <span class="admin-badge admin-badge--{{$model['status_badge']}}">
+                                    {{$model['status']}}
                                 </span>
                             </td>
                         </tr>
@@ -229,39 +229,39 @@
     </div>
 
     <!-- Confusion Matrices Section -->
-    <div class="admin-card" if="{{ $has_confusion_matrices }}">
+    <div class="admin-card" if="{{$has_confusion_matrices}}">
         <div class="admin-card__header">
             <h3 class="admin-card__title">Classification Performance (Confusion Matrices)</h3>
         </div>
         <div class="admin-card__content">
             <div class="admin-grid admin-grid--2-col">
                 <div foreach="$confusion_matrices as $matrix" class="confusion-matrix-card">
-                    <h4 class="confusion-matrix-card__title">{{ $matrix['model_name'] }} v{{ $matrix['version'] }}</h4>
+                    <h4 class="confusion-matrix-card__title">{{$matrix['model_name']}} v{{$matrix['version']}}</h4>
 
                     <div class="confusion-matrix">
                         <div class="confusion-matrix__grid">
                             <!-- True Positive -->
                             <div class="confusion-matrix__cell confusion-matrix__cell--tp">
                                 <div class="confusion-matrix__cell-label">True Positive</div>
-                                <div class="confusion-matrix__cell-value">{{ $matrix['true_positives'] }}</div>
+                                <div class="confusion-matrix__cell-value">{{$matrix['true_positives']}}</div>
                             </div>
 
                             <!-- False Positive -->
                             <div class="confusion-matrix__cell confusion-matrix__cell--fp">
                                 <div class="confusion-matrix__cell-label">False Positive</div>
-                                <div class="confusion-matrix__cell-value">{{ $matrix['false_positives'] }}</div>
+                                <div class="confusion-matrix__cell-value">{{$matrix['false_positives']}}</div>
                             </div>
 
                             <!-- False Negative -->
                             <div class="confusion-matrix__cell confusion-matrix__cell--fn">
                                 <div class="confusion-matrix__cell-label">False Negative</div>
-                                <div class="confusion-matrix__cell-value">{{ $matrix['false_negatives'] }}</div>
+                                <div class="confusion-matrix__cell-value">{{$matrix['false_negatives']}}</div>
                             </div>
 
                             <!-- True Negative -->
                             <div class="confusion-matrix__cell confusion-matrix__cell--tn">
                                 <div class="confusion-matrix__cell-label">True Negative</div>
-                                <div class="confusion-matrix__cell-value">{{ $matrix['true_negatives'] }}</div>
+                                <div class="confusion-matrix__cell-value">{{$matrix['true_negatives']}}</div>
                             </div>
                         </div>
 
@@ -269,16 +269,16 @@
                             <div class="admin-stat-item">
                                 <span class="admin-stat-item__label">False Positive Rate</span>
                                 <span class="admin-stat-item__value">
-                                    <span class="admin-badge admin-badge--{{ $matrix['fp_rate_badge'] }}">
-                                        {{ $matrix['fp_rate_percent'] }}%
+                                    <span class="admin-badge admin-badge--{{$matrix['fp_rate_badge']}}">
+                                        {{$matrix['fp_rate_percent']}}%
                                     </span>
                                 </span>
                             </div>
                             <div class="admin-stat-item">
                                 <span class="admin-stat-item__label">False Negative Rate</span>
                                 <span class="admin-stat-item__value">
-                                    <span class="admin-badge admin-badge--{{ $matrix['fn_rate_badge'] }}">
-                                        {{ $matrix['fn_rate_percent'] }}%
+                                    <span class="admin-badge admin-badge--{{$matrix['fn_rate_badge']}}">
+                                        {{$matrix['fn_rate_percent']}}%
                                     </span>
                                 </span>
                             </div>
@@ -290,7 +290,7 @@
     </div>
 
     <!-- Model Registry Summary -->
-    <div class="admin-card" if="{{ $has_registry_summary }}">
+    <div class="admin-card" if="{{$has_registry_summary}}">
         <div class="admin-card__header">
             <h3 class="admin-card__title">Model Registry Summary</h3>
         </div>
@@ -298,18 +298,18 @@
             <div class="admin-grid admin-grid--3-col">
                 <div class="admin-stat-item">
                     <span class="admin-stat-item__label">Total Versions</span>
-                    <span class="admin-stat-item__value">{{ $registry_total_versions }}</span>
+                    <span class="admin-stat-item__value">{{$registry_total_versions}}</span>
                 </div>
                 <div class="admin-stat-item">
                     <span class="admin-stat-item__label">Production Models</span>
                     <span class="admin-stat-item__value">
-                        <span class="admin-badge admin-badge--success">{{ $registry_production_count }}</span>
+                        <span class="admin-badge admin-badge--success">{{$registry_production_count}}</span>
                     </span>
                 </div>
                 <div class="admin-stat-item">
                     <span class="admin-stat-item__label">Development Models</span>
                     <span class="admin-stat-item__value">
-                        <span class="admin-badge admin-badge--info">{{ $registry_development_count }}</span>
+                        <span class="admin-badge admin-badge--info">{{$registry_development_count}}</span>
                     </span>
                 </div>
             </div>
@@ -327,15 +327,15 @@
                     </thead>
                     <tbody>
                         <tr foreach="$registry_models as $regModel">
-                            <td><strong>{{ $regModel['model_name'] }}</strong></td>
-                            <td>{{ $regModel['version_count'] }}</td>
+                            <td><strong>{{$regModel['model_name']}}</strong></td>
+                            <td>{{$regModel['version_count']}}</td>
                             <td>
-                                <span class="admin-badge admin-badge--info">{{ $regModel['type'] }}</span>
+                                <span class="admin-badge admin-badge--info">{{$regModel['type']}}</span>
                             </td>
-                            <td><code>{{ $regModel['latest_version'] }}</code></td>
+                            <td><code>{{$regModel['latest_version']}}</code></td>
                             <td>
-                                <span class="admin-badge admin-badge--{{ $regModel['environment'] === 'production' ? 'success' : 'info' }}">
-                                    {{ $regModel['environment'] }}
+                                <span class="admin-badge admin-badge--{{$regModel['environment'] === 'production' ? 'success' : 'info'}}">
+                                    {{$regModel['environment']}}
                                 </span>
                             </td>
                         </tr>
@@ -355,13 +355,13 @@
                 <div class="admin-stat-item">
                     <span class="admin-stat-item__label">Dashboard Data</span>
                     <span class="admin-stat-item__value">
-                        <code>GET {{ $api_dashboard_url }}</code>
+                        <code>GET {{$api_dashboard_url}}</code>
                     </span>
                 </div>
                 <div class="admin-stat-item">
                     <span class="admin-stat-item__label">Health Check</span>
                     <span class="admin-stat-item__value">
-                        <code>GET {{ $api_health_url }}</code>
+                        <code>GET {{$api_health_url}}</code>
                     </span>
                 </div>
                 <div class="admin-stat-item">
diff --git a/src/Application/Admin/templates/performance.view.php b/src/Application/Admin/templates/performance.view.php
index c080cea8..2a7686c1 100644
--- a/src/Application/Admin/templates/performance.view.php
+++ b/src/Application/Admin/templates/performance.view.php
@@ -2,197 +2,7 @@
 
 <div class="section">
     <h2>Performance Übersicht</h2>
-    <div class="stats-grid">
-        <div class="stat-card">
-            <h3>💾 Speicher <span id="realtime-indicator" class="indicator"></span></h3>
-            <p><strong>Aktuell:</strong> <span id="current-memory">{{ performance.currentMemoryUsage }}</span></p>
-            <p><strong>Peak:</strong> <span id="peak-memory">{{ performance.peakMemoryUsage }}</span></p>
-            <p><strong>Limit:</strong> {{ performance.memoryLimit }}</p>
-            <p><strong>Auslastung:</strong> <span id="memory-percentage">{{ performance.memoryUsagePercentage }}</span>%</p>
-            <div class="progress-bar">
-                <div class="progress-fill" id="memory-progress" style="width: {{ performance.memoryUsagePercentage }}%"></div>
-            </div>
-        </div>
-
-        <div class="stat-card">
-            <h3>System</h3>
-            <p><strong>Ausführungszeit:</strong> {{ performance.executionTime }}</p>
-            <p><strong>Geladene Dateien:</strong> {{ performance.includedFiles }}</p>
-            <p><strong>OPCache:</strong> {{ performance.opcacheEnabled }}</p>
-        </div>
-
-        <if condition="{{ performance.opcacheMemoryUsage }}">
-            <div class="stat-card">
-                <h3>OPCache</h3>
-                <p><strong>Speicher:</strong> {{ performance.opcacheMemoryUsage }}</p>
-                <p><strong>Cache Hits:</strong> {{ performance.opcacheCacheHits }}</p>
-                <p><strong>Miss Rate:</strong> {{ performance.opcacheMissRate }}</p>
-            </div>
-        </if>
-    </div>
-
-    <!-- Real-time Controls -->
-    <div class="admin-card" style="margin-top: var(--space-lg);">
-        <div class="admin-card__header">
-            <h3 class="admin-card__title">⚙️ Real-time Monitoring</h3>
-        </div>
-        <div class="admin-card__content">
-            <label style="display: flex; align-items: center; gap: 10px;">
-                <input type="checkbox" id="realtime-toggle">
-                <span>Enable Real-time Updates</span>
-                <span id="realtime-status" class="status-indicator"></span>
-            </label>
-            <p style="margin-top: 10px; font-size: 0.9em; color: var(--text-muted);">
-                <span id="last-update">Last Updated: {{ timestamp }}</span>
-            </p>
-        </div>
-    </div>
-</div>
-
-<style>
-    .progress-bar {
-        height: 8px;
-        background: var(--bg-muted);
-        border-radius: 4px;
-        overflow: hidden;
-        margin: 8px 0;
-    }
-
-    .progress-fill {
-        height: 100%;
-        background: linear-gradient(90deg, var(--success), var(--success-dark));
-        transition: width 0.3s ease;
-    }
-
-    .indicator {
-        display: inline-block;
-        width: 8px;
-        height: 8px;
-        border-radius: 50%;
-        background: var(--text-muted);
-        margin-left: 8px;
-    }
-
-    .indicator.active {
-        background: var(--success);
-        animation: pulse 1s infinite;
-    }
-
-    .status-indicator {
-        width: 10px;
-        height: 10px;
-        border-radius: 50%;
-        background: var(--text-muted);
-        display: inline-block;
-    }
-
-    .status-indicator.active {
-        background: var(--success);
-        animation: pulse 1s infinite;
-    }
-
-    @keyframes pulse {
-        0%, 100% { opacity: 1; }
-        50% { opacity: 0.5; }
-    }
-
-    .stats-grid {
-        display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
-        gap: var(--space-lg);
-        margin-bottom: var(--space-lg);
-    }
-
-    .stat-card {
-        background: var(--bg-surface);
-        border: 1px solid var(--border-color);
-        border-radius: var(--radius-md);
-        padding: var(--space-lg);
-    }
-
-    .stat-card h3 {
-        margin: 0 0 var(--space-md) 0;
-        color: var(--text-primary);
-        display: flex;
-        align-items: center;
-    }
-
-    .stat-card p {
-        margin: var(--space-sm) 0;
-        color: var(--text-secondary);
-    }
-</style>
-
-<script>
-document.addEventListener('DOMContentLoaded', function() {
-    const toggle = document.getElementById('realtime-toggle');
-    const statusIndicator = document.getElementById('realtime-status');
-    const realtimeIndicator = document.getElementById('realtime-indicator');
-    const lastUpdate = document.getElementById('last-update');
-    let updateInterval = null;
-
-    toggle?.addEventListener('change', function() {
-        if (this.checked) {
-            startRealtimeUpdates();
-        } else {
-            stopRealtimeUpdates();
-        }
-    });
-
-    function startRealtimeUpdates() {
-        statusIndicator?.classList.add('active');
-        realtimeIndicator?.classList.add('active');
-
-        updateInterval = setInterval(async () => {
-            try {
-                const response = await fetch('/admin/system/performance/api/realtime');
-                const data = await response.json();
-                updateMetrics(data);
-            } catch (error) {
-                console.error('Failed to fetch realtime metrics:', error);
-                stopRealtimeUpdates();
-                toggle.checked = false;
-            }
-        }, 3000); // Update every 3 seconds
-    }
-
-    function stopRealtimeUpdates() {
-        statusIndicator?.classList.remove('active');
-        realtimeIndicator?.classList.remove('active');
-
-        if (updateInterval) {
-            clearInterval(updateInterval);
-            updateInterval = null;
-        }
-    }
-
-    function updateMetrics(data) {
-        // Update memory metrics
-        const currentMemory = document.getElementById('current-memory');
-        if (currentMemory && data.memory?.current) {
-            currentMemory.textContent = data.memory.current;
-        }
-
-        const peakMemory = document.getElementById('peak-memory');
-        if (peakMemory && data.memory?.peak) {
-            peakMemory.textContent = data.memory.peak;
-        }
-
-        const memoryPercentage = document.getElementById('memory-percentage');
-        const memoryProgress = document.getElementById('memory-progress');
-        if (data.memory?.usage_percentage !== undefined) {
-            if (memoryPercentage) {
-                memoryPercentage.textContent = data.memory.usage_percentage.toFixed(1);
-            }
-            if (memoryProgress) {
-                memoryProgress.style.width = data.memory.usage_percentage + '%';
-            }
-        }
-
-        // Update timestamp
-        if (lastUpdate && data.timestamp) {
-            lastUpdate.textContent = 'Last Updated: ' + data.timestamp;
-        }
-    }
-});
-</script>
\ No newline at end of file
+    
+    <!-- LiveComponent for real-time performance metrics -->
+    <x-performance-metrics id="performance-dashboard" />
+</div>
\ No newline at end of file
diff --git a/src/Application/Admin/templates/phpinfo.view.php b/src/Application/Admin/templates/phpinfo.view.php
index 860d132f..ec823786 100644
--- a/src/Application/Admin/templates/phpinfo.view.php
+++ b/src/Application/Admin/templates/phpinfo.view.php
@@ -1,7 +1,7 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
+    <h2>{{$title}}</h2>
 
     <div class="admin-card">
         <div class="admin-card__header">
@@ -24,17 +24,15 @@
         <div class="admin-card__content">
             <div style="margin-bottom: var(--space-md);">
                 <div class="metric-card" style="display: inline-block; margin-right: var(--space-md);">
-                    <div class="metric-card__value">{{ extensions_count }}</div>
+                    <div class="metric-card__value">{{$extensions_count}}</div>
                     <div class="metric-card__label">Total Extensions</div>
                 </div>
             </div>
 
             <div style="display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: var(--space-sm);">
-                <for var="extension" in="extensions_list">
-                    <div style="padding: var(--space-sm); background: var(--bg-alt); border: 1px solid var(--border); border-radius: var(--radius-sm); font-size: 0.875rem;">
-                        {{ extension }}
-                    </div>
-                </for>
+                <div style="padding: var(--space-sm); background: var(--bg-alt); border: 1px solid var(--border); border-radius: var(--radius-sm); font-size: 0.875rem;" foreach="$extensions_list as $extension">
+                    {{$extension}}
+                </div>
             </div>
         </div>
     </div>
diff --git a/src/Application/Admin/templates/presave/campaigns/edit.view.php b/src/Application/Admin/templates/presave/campaigns/edit.view.php
index 83b629e6..324f08f3 100644
--- a/src/Application/Admin/templates/presave/campaigns/edit.view.php
+++ b/src/Application/Admin/templates/presave/campaigns/edit.view.php
@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Edit Campaign - {campaign.title}</title>
+    <title>Edit Campaign - {{$campaign->title}}</title>
     <link rel="stylesheet" href="/css/styles.css">
 </head>
 <body>
@@ -11,10 +11,10 @@
         <div class="container">
             <div class="page-header">
                 <h1>Edit Campaign</h1>
-                <a href="/admin/presave/campaigns/{campaign.id}" class="btn btn-secondary">Back to Details</a>
+                <a href="/admin/presave/campaigns/{{$campaign->id}}" class="btn btn-secondary">Back to Details</a>
             </div>
 
-            <form action="/admin/presave/campaigns/{campaign.id}" method="POST" class="campaign-form">
+            <form action="/admin/presave/campaigns/{{$campaign->id}}" method="POST" class="campaign-form">
                 <csrf-token />
                 <input type="hidden" name="_method" value="PUT">
 
@@ -23,23 +23,23 @@
 
                     <div class="form-group">
                         <label for="title">Campaign Title *</label>
-                        <input type="text" id="title" name="title" value="{campaign.title}" required class="form-control">
+                        <input type="text" id="title" name="title" value="{{$campaign->title}}" required class="form-control">
                     </div>
 
                     <div class="form-group">
                         <label for="artist_name">Artist Name *</label>
-                        <input type="text" id="artist_name" name="artist_name" value="{campaign.artistName}" required class="form-control">
+                        <input type="text" id="artist_name" name="artist_name" value="{{$campaign->artistName}}" required class="form-control">
                     </div>
 
                     <div class="form-group">
                         <label for="cover_image_url">Cover Image URL *</label>
-                        <input type="url" id="cover_image_url" name="cover_image_url" value="{campaign.coverImageUrl}" required class="form-control">
+                        <input type="url" id="cover_image_url" name="cover_image_url" value="{{$campaign->coverImageUrl}}" required class="form-control">
                         <small>Direct URL to album/single cover image</small>
                     </div>
 
                     <div class="form-group">
                         <label for="description">Description</label>
-                        <textarea id="description" name="description" rows="4" class="form-control">{campaign.description}</textarea>
+                        <textarea id="description" name="description" rows="4" class="form-control">{{$campaign->description}}</textarea>
                     </div>
                 </div>
 
@@ -48,7 +48,7 @@
 
                     <div class="form-group">
                         <label for="release_date">Release Date *</label>
-                        <input type="datetime-local" id="release_date" name="release_date" value="{campaign.releaseDate|datetime_input}" required class="form-control">
+                        <input type="datetime-local" id="release_date" name="release_date" value="{{$campaign->releaseDate}}" required class="form-control">
                     </div>
                 </div>
 
@@ -58,23 +58,23 @@
 
                     <div class="form-group">
                         <label for="spotify_url">Spotify URL</label>
-                        <input type="url" id="spotify_url" name="spotify_url" value="{campaign.trackUrls.spotify}" class="form-control" placeholder="https://open.spotify.com/album/...">
+                        <input type="url" id="spotify_url" name="spotify_url" value="{{$campaign->trackUrls['spotify'] ?? ''}}" class="form-control" placeholder="https://open.spotify.com/album/...">
                     </div>
 
                     <div class="form-group">
                         <label for="apple_music_url">Apple Music URL</label>
-                        <input type="url" id="apple_music_url" name="apple_music_url" value="{campaign.trackUrls.apple_music}" class="form-control" placeholder="https://music.apple.com/album/...">
+                        <input type="url" id="apple_music_url" name="apple_music_url" value="{{$campaign->trackUrls['apple_music'] ?? ''}}" class="form-control" placeholder="https://music.apple.com/album/...">
                     </div>
 
                     <div class="form-group">
                         <label for="tidal_url">Tidal URL</label>
-                        <input type="url" id="tidal_url" name="tidal_url" value="{campaign.trackUrls.tidal}" class="form-control" placeholder="https://tidal.com/browse/album/...">
+                        <input type="url" id="tidal_url" name="tidal_url" value="{{$campaign->trackUrls['tidal'] ?? ''}}" class="form-control" placeholder="https://tidal.com/browse/album/...">
                     </div>
                 </div>
 
                 <div class="form-actions">
                     <button type="submit" class="btn btn-primary">Update Campaign</button>
-                    <a href="/admin/presave/campaigns/{campaign.id}" class="btn btn-secondary">Cancel</a>
+                    <a href="/admin/presave/campaigns/{{$campaign->id}}" class="btn btn-secondary">Cancel</a>
                 </div>
             </form>
         </div>
@@ -82,7 +82,7 @@
 
     <script>
         // Convert timestamp to datetime-local format
-        const releaseDate = new Date({campaign.releaseDate} * 1000);
+        const releaseDate = new Date({{$campaign->releaseDate}} * 1000);
         document.getElementById('release_date').value = releaseDate.toISOString().slice(0, 16);
     </script>
 </body>
diff --git a/src/Application/Admin/templates/presave/campaigns/index.view.php b/src/Application/Admin/templates/presave/campaigns/index.view.php
index 80f34d8e..a91fed8b 100644
--- a/src/Application/Admin/templates/presave/campaigns/index.view.php
+++ b/src/Application/Admin/templates/presave/campaigns/index.view.php
@@ -14,73 +14,61 @@
                 <a href="/admin/presave/campaigns/create" class="btn btn-primary">New Campaign</a>
             </div>
 
-            <if condition="{stats}">
-                <div class="stats-grid">
-                    <div class="stat-card">
-                        <h3>Total Campaigns</h3>
-                        <p class="stat-value">{stats.total}</p>
-                    </div>
-                    <div class="stat-card">
-                        <h3>Active</h3>
-                        <p class="stat-value">{stats.active}</p>
-                    </div>
-                    <div class="stat-card">
-                        <h3>Total Registrations</h3>
-                        <p class="stat-value">{stats.total_registrations}</p>
-                    </div>
-                    <div class="stat-card">
-                        <h3>Completed</h3>
-                        <p class="stat-value">{stats.completed}</p>
-                    </div>
+            <div class="stats-grid" if="{{$stats}}">
+                <div class="stat-card">
+                    <h3>Total Campaigns</h3>
+                    <p class="stat-value">{{$stats['total']}}</p>
                 </div>
-            </if>
+                <div class="stat-card">
+                    <h3>Active</h3>
+                    <p class="stat-value">{{$stats['active']}}</p>
+                </div>
+                <div class="stat-card">
+                    <h3>Total Registrations</h3>
+                    <p class="stat-value">{{$stats['total_registrations']}}</p>
+                </div>
+                <div class="stat-card">
+                    <h3>Completed</h3>
+                    <p class="stat-value">{{$stats['completed']}}</p>
+                </div>
+            </div>
 
-            <if condition="{campaigns}">
-                <div class="campaigns-list">
-                    <for items="{campaigns}" as="campaign">
-                        <div class="campaign-card">
-                            <div class="campaign-header">
-                                <img src="{campaign.coverImageUrl}" alt="{campaign.title}" class="campaign-cover">
-                                <div class="campaign-info">
-                                    <h3>{campaign.title}</h3>
-                                    <p class="artist">{campaign.artistName}</p>
-                                    <p class="release-date">Release: {campaign.releaseDate|date}</p>
-                                </div>
-                                <div class="campaign-status">
-                                    <span class="badge badge-{campaign.status.value}">{campaign.status.value}</span>
-                                </div>
-                            </div>
-                            <div class="campaign-actions">
-                                <a href="/admin/presave/campaigns/{campaign.id}" class="btn btn-sm">View</a>
-                                <a href="/admin/presave/campaigns/{campaign.id}/edit" class="btn btn-sm">Edit</a>
-
-                                <if condition="{campaign.status.value === 'draft'}">
-                                    <form action="/admin/presave/campaigns/{campaign.id}/activate" method="POST" style="display: inline;">
-                                        <csrf-token />
-                                        <button type="submit" class="btn btn-sm btn-success">Activate</button>
-                                    </form>
-                                </if>
-
-                                <if condition="{campaign.status.value === 'active'}">
-                                    <form action="/admin/presave/campaigns/{campaign.id}/pause" method="POST" style="display: inline;">
-                                        <csrf-token />
-                                        <button type="submit" class="btn btn-sm btn-warning">Pause</button>
-                                    </form>
-                                </if>
-
-                                <button class="btn btn-sm btn-danger" onclick="deleteCampaign({campaign.id})">Delete</button>
-                            </div>
+            <div class="campaigns-list" if="{{$campaigns}}">
+                <div class="campaign-card" foreach="$campaigns as $campaign">
+                    <div class="campaign-header">
+                        <img src="{{$campaign->coverImageUrl}}" alt="{{$campaign->title}}" class="campaign-cover">
+                        <div class="campaign-info">
+                            <h3>{{$campaign->title}}</h3>
+                            <p class="artist">{{$campaign->artistName}}</p>
+                            <p class="release-date">Release: {{$campaign->releaseDate}}</p>
                         </div>
-                    </for>
-                </div>
-            </if>
+                        <div class="campaign-status">
+                            <span class="badge badge-{{$campaign->status->value}}">{{$campaign->status->value}}</span>
+                        </div>
+                    </div>
+                    <div class="campaign-actions">
+                        <a href="/admin/presave/campaigns/{{$campaign->id}}" class="btn btn-sm">View</a>
+                        <a href="/admin/presave/campaigns/{{$campaign->id}}/edit" class="btn btn-sm">Edit</a>
 
-            <if condition="{!campaigns || campaigns.length === 0}">
-                <div class="empty-state">
-                    <p>No campaigns yet.</p>
-                    <a href="/admin/presave/campaigns/create" class="btn btn-primary">Create your first campaign</a>
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/activate" method="POST" style="display: inline;" if="{{$campaign->status->value === 'draft'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-sm btn-success">Activate</button>
+                        </form>
+
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/pause" method="POST" style="display: inline;" if="{{$campaign->status->value === 'active'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-sm btn-warning">Pause</button>
+                        </form>
+
+                        <button class="btn btn-sm btn-danger" onclick="deleteCampaign({{$campaign->id}})">Delete</button>
+                    </div>
                 </div>
-            </if>
+            </div>
+
+            <div class="empty-state" if="{{!$campaigns || count($campaigns) === 0}}">
+                <p>No campaigns yet.</p>
+                <a href="/admin/presave/campaigns/create" class="btn btn-primary">Create your first campaign</a>
+            </div>
         </div>
     </layout>
 
diff --git a/src/Application/Admin/templates/presave/campaigns/show.view.php b/src/Application/Admin/templates/presave/campaigns/show.view.php
index 254c9b31..8b9c71ff 100644
--- a/src/Application/Admin/templates/presave/campaigns/show.view.php
+++ b/src/Application/Admin/templates/presave/campaigns/show.view.php
@@ -3,48 +3,44 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{campaign.title} - Campaign Details</title>
+    <title>{{$campaign->title}} - Campaign Details</title>
     <link rel="stylesheet" href="/css/styles.css">
 </head>
 <body>
     <layout name="admin">
         <div class="container">
             <div class="page-header">
-                <h1>{campaign.title}</h1>
+                <h1>{{$campaign->title}}</h1>
                 <div class="header-actions">
-                    <a href="/admin/presave/campaigns/{campaign.id}/edit" class="btn btn-primary">Edit</a>
+                    <a href="/admin/presave/campaigns/{{$campaign->id}}/edit" class="btn btn-primary">Edit</a>
                     <a href="/admin/presave/campaigns" class="btn btn-secondary">Back to List</a>
                 </div>
             </div>
 
             <div class="campaign-details">
                 <div class="campaign-cover-large">
-                    <img src="{campaign.coverImageUrl}" alt="{campaign.title}">
+                    <img src="{{$campaign->coverImageUrl}}" alt="{{$campaign->title}}">
                 </div>
 
                 <div class="campaign-info-section">
                     <h2>Campaign Information</h2>
                     <dl class="info-list">
                         <dt>Artist</dt>
-                        <dd>{campaign.artistName}</dd>
+                        <dd>{{$campaign->artistName}}</dd>
 
                         <dt>Status</dt>
-                        <dd><span class="badge badge-{campaign.status.value}">{campaign.status.value}</span></dd>
+                        <dd><span class="badge badge-{{$campaign->status->value}}">{{$campaign->status->value}}</span></dd>
 
                         <dt>Release Date</dt>
-                        <dd>{campaign.releaseDate|date}</dd>
+                        <dd>{{$campaign->releaseDate}}</dd>
 
-                        <if condition="{campaign.description}">
-                            <dt>Description</dt>
-                            <dd>{campaign.description}</dd>
-                        </if>
+                        <dt if="{{$campaign->description}}">Description</dt>
+                        <dd if="{{$campaign->description}}">{{$campaign->description}}</dd>
 
                         <dt>Available Platforms</dt>
                         <dd>
                             <div class="platform-links">
-                                <for items="{campaign.trackUrls}" as="platform=>url">
-                                    <a href="{url}" target="_blank" class="platform-badge">{platform}</a>
-                                </for>
+                                <a href="{{$url}}" target="_blank" class="platform-badge" foreach="$campaign->trackUrls as $platform => $url">{{$platform}}</a>
                             </div>
                         </dd>
                     </dl>
@@ -55,19 +51,19 @@
                     <div class="stats-grid">
                         <div class="stat-card">
                             <h3>Total Registrations</h3>
-                            <p class="stat-value">{stats.total_registrations}</p>
+                            <p class="stat-value">{{$stats['total_registrations']}}</p>
                         </div>
                         <div class="stat-card">
                             <h3>Pending</h3>
-                            <p class="stat-value">{stats.pending}</p>
+                            <p class="stat-value">{{$stats['pending']}}</p>
                         </div>
                         <div class="stat-card">
                             <h3>Completed</h3>
-                            <p class="stat-value">{stats.completed}</p>
+                            <p class="stat-value">{{$stats['completed']}}</p>
                         </div>
                         <div class="stat-card">
                             <h3>Failed</h3>
-                            <p class="stat-value">{stats.failed}</p>
+                            <p class="stat-value">{{$stats['failed']}}</p>
                         </div>
                     </div>
 
@@ -75,15 +71,15 @@
                     <div class="platform-stats">
                         <div class="platform-stat">
                             <span class="platform-name">Spotify</span>
-                            <span class="platform-count">{stats.by_platform.spotify}</span>
+                            <span class="platform-count">{{$stats['by_platform']['spotify']}}</span>
                         </div>
                         <div class="platform-stat">
                             <span class="platform-name">Apple Music</span>
-                            <span class="platform-count">{stats.by_platform.apple_music}</span>
+                            <span class="platform-count">{{$stats['by_platform']['apple_music']}}</span>
                         </div>
                         <div class="platform-stat">
                             <span class="platform-name">Tidal</span>
-                            <span class="platform-count">{stats.by_platform.tidal}</span>
+                            <span class="platform-count">{{$stats['by_platform']['tidal']}}</span>
                         </div>
                     </div>
                 </div>
@@ -91,83 +87,61 @@
                 <div class="campaign-actions-section">
                     <h2>Campaign Actions</h2>
                     <div class="action-buttons">
-                        <if condition="{campaign.status.value === 'draft'}">
-                            <form action="/admin/presave/campaigns/{campaign.id}/activate" method="POST">
-                                <csrf-token />
-                                <button type="submit" class="btn btn-success">Activate Campaign</button>
-                            </form>
-                        </if>
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/activate" method="POST" if="{{$campaign->status->value === 'draft'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-success">Activate Campaign</button>
+                        </form>
 
-                        <if condition="{campaign.status.value === 'active'}">
-                            <form action="/admin/presave/campaigns/{campaign.id}/pause" method="POST">
-                                <csrf-token />
-                                <button type="submit" class="btn btn-warning">Pause Campaign</button>
-                            </form>
-                        </if>
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/pause" method="POST" if="{{$campaign->status->value === 'active'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-warning">Pause Campaign</button>
+                        </form>
 
-                        <if condition="{campaign.status.value === 'paused'}">
-                            <form action="/admin/presave/campaigns/{campaign.id}/activate" method="POST">
-                                <csrf-token />
-                                <button type="submit" class="btn btn-success">Resume Campaign</button>
-                            </form>
-                        </if>
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/activate" method="POST" if="{{$campaign->status->value === 'paused'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-success">Resume Campaign</button>
+                        </form>
 
-                        <if condition="{campaign.status.value !== 'completed'}">
-                            <form action="/admin/presave/campaigns/{campaign.id}/complete" method="POST">
-                                <csrf-token />
-                                <button type="submit" class="btn btn-primary">Mark as Completed</button>
-                            </form>
-                        </if>
+                        <form action="/admin/presave/campaigns/{{$campaign->id}}/complete" method="POST" if="{{$campaign->status->value !== 'completed'}}">
+                            <csrf-token />
+                            <button type="submit" class="btn btn-primary">Mark as Completed</button>
+                        </form>
                     </div>
                 </div>
 
                 <div class="registrations-section">
                     <h2>Registrations</h2>
-                    <if condition="{registrations && registrations.length > 0}">
-                        <table class="data-table">
-                            <thead>
-                                <tr>
-                                    <th>User ID</th>
-                                    <th>Platform</th>
-                                    <th>Status</th>
-                                    <th>Registered</th>
-                                    <th>Processed</th>
-                                    <th>Error</th>
-                                </tr>
-                            </thead>
-                            <tbody>
-                                <for items="{registrations}" as="registration">
-                                    <tr>
-                                        <td>{registration.userId}</td>
-                                        <td>{registration.platform.value}</td>
-                                        <td><span class="badge badge-{registration.status.value}">{registration.status.value}</span></td>
-                                        <td>{registration.registeredAt|datetime}</td>
-                                        <td>
-                                            <if condition="{registration.processedAt}">
-                                                {registration.processedAt|datetime}
-                                            </if>
-                                            <if condition="{!registration.processedAt}">
-                                                -
-                                            </if>
-                                        </td>
-                                        <td>
-                                            <if condition="{registration.errorMessage}">
-                                                <span class="error-message" title="{registration.errorMessage}">
-                                                    {registration.errorMessage|truncate:50}
-                                                </span>
-                                            </if>
-                                            <if condition="{!registration.errorMessage}">
-                                                -
-                                            </if>
-                                        </td>
-                                    </tr>
-                                </for>
-                            </tbody>
-                        </table>
-                    </if>
-                    <if condition="{!registrations || registrations.length === 0}">
-                        <p class="text-muted">No registrations yet.</p>
-                    </if>
+                    <table class="data-table" if="{{$registrations && count($registrations) > 0}}">
+                        <thead>
+                            <tr>
+                                <th>User ID</th>
+                                <th>Platform</th>
+                                <th>Status</th>
+                                <th>Registered</th>
+                                <th>Processed</th>
+                                <th>Error</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr foreach="$registrations as $registration">
+                                <td>{{$registration->userId}}</td>
+                                <td>{{$registration->platform->value}}</td>
+                                <td><span class="badge badge-{{$registration->status->value}}">{{$registration->status->value}}</span></td>
+                                <td>{{$registration->registeredAt}}</td>
+                                <td>
+                                    <span if="{{$registration->processedAt}}">{{$registration->processedAt}}</span>
+                                    <span if="{{!$registration->processedAt}}">-</span>
+                                </td>
+                                <td>
+                                    <span class="error-message" title="{{$registration->errorMessage}}" if="{{$registration->errorMessage}}">
+                                        {{substr($registration->errorMessage, 0, 50)}}
+                                    </span>
+                                    <span if="{{!$registration->errorMessage}}">-</span>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
+                    <p class="text-muted" if="{{!$registrations || count($registrations) === 0}}">No registrations yet.</p>
                 </div>
             </div>
         </div>
diff --git a/src/Application/Admin/templates/redis.view.php b/src/Application/Admin/templates/redis.view.php
index dcbc2cad..f1c94cf3 100644
--- a/src/Application/Admin/templates/redis.view.php
+++ b/src/Application/Admin/templates/redis.view.php
@@ -1,24 +1,24 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
+    <h2>{{$title}}</h2>
 
     <!-- Connection Status -->
     <div class="stats-grid">
         <div class="stat-card">
             <h3>Connection Status</h3>
-            <p><strong>Status:</strong> {{ redis.status }}</p>
-            <p><strong>Connected:</strong> {{ redis.is_connected }}</p>
+            <p><strong>Status:</strong> {{$redis['status']}}</p>
+            <p><strong>Connected:</strong> {{$redis['is_connected']}}</p>
         </div>
     </div>
 
     <!-- TODO: Conditional sections will work once ForProcessor/IfProcessor are fixed -->
     <div class="stat-card">
         <h3>Debug Information</h3>
-        <p><strong>Has Basic Info:</strong> {{ redis.has_basic_info }}</p>
-        <p><strong>Has Error:</strong> {{ redis.has_error }}</p>
-        <p><strong>Has Databases:</strong> {{ redis.has_databases }}</p>
-        <p><strong>Has Cache Patterns:</strong> {{ redis.has_cache_patterns }}</p>
+        <p><strong>Has Basic Info:</strong> {{$redis['has_basic_info']}}</p>
+        <p><strong>Has Error:</strong> {{$redis['has_error']}}</p>
+        <p><strong>Has Databases:</strong> {{$redis['has_databases']}}</p>
+        <p><strong>Has Cache Patterns:</strong> {{$redis['has_cache_patterns']}}</p>
     </div>
 </div>
 
diff --git a/src/Application/Admin/templates/routes-overview.view.php b/src/Application/Admin/templates/routes-overview.view.php
index aa5ee1af..02f9f32f 100644
--- a/src/Application/Admin/templates/routes-overview.view.php
+++ b/src/Application/Admin/templates/routes-overview.view.php
@@ -5,23 +5,23 @@
     <div class="stats-grid">
         <div class="stat-card">
             <h3>Overview</h3>
-            <p><strong>Total Routes:</strong> {{ total_routes }}</p>
-            <p><strong>Admin Routes:</strong> {{ admin_routes_count }}</p>
-            <p><strong>API Routes:</strong> {{ api_routes_count }}</p>
+            <p><strong>Total Routes:</strong> {{$total_routes}}</p>
+            <p><strong>Admin Routes:</strong> {{$admin_routes_count}}</p>
+            <p><strong>API Routes:</strong> {{$api_routes_count}}</p>
         </div>
 
         <div class="stat-card">
             <h3>HTTP Methods</h3>
-            <p><strong>GET:</strong> {{ get_routes_count }}</p>
-            <p><strong>POST:</strong> {{ post_routes_count }}</p>
-            <p><strong>PUT/PATCH:</strong> {{ put_routes_count }}</p>
-            <p><strong>DELETE:</strong> {{ delete_routes_count }}</p>
+            <p><strong>GET:</strong> {{$get_routes_count}}</p>
+            <p><strong>POST:</strong> {{$post_routes_count}}</p>
+            <p><strong>PUT/PATCH:</strong> {{$put_routes_count}}</p>
+            <p><strong>DELETE:</strong> {{$delete_routes_count}}</p>
         </div>
 
         <div class="stat-card">
             <h3>Authentication</h3>
-            <p><strong>Protected Routes:</strong> {{ protected_routes_count }}</p>
-            <p><strong>Public Routes:</strong> {{ public_routes_count }}</p>
+            <p><strong>Protected Routes:</strong> {{$protected_routes_count}}</p>
+            <p><strong>Public Routes:</strong> {{$public_routes_count}}</p>
         </div>
     </div>
 
@@ -32,8 +32,7 @@
         </div>
     </div>
 
-    <if condition="{{ middlewares }}">
-    <div class="stats-grid">
+    <div class="stats-grid" if="{{$middlewares}}">
         <div class="stat-card full-width">
             <h3>Middleware Usage</h3>
             <table>
@@ -45,16 +44,13 @@
                     </tr>
                 </thead>
                 <tbody>
-                    <for items="{{ middlewares }}" key="middleware" value="data">
-                    <tr>
-                        <td>{{ middleware }}</td>
-                        <td>{{ data.count }}</td>
-                        <td style="font-size: 12px;">{{ data.routes }}</td>
+                    <tr foreach="$middlewares as $middleware => $data">
+                        <td>{{$middleware}}</td>
+                        <td>{{$data['count']}}</td>
+                        <td style="font-size: 12px;">{{$data['routes']}}</td>
                     </tr>
-                    </for>
                 </tbody>
             </table>
         </div>
     </div>
-    </if>
 </div>
\ No newline at end of file
diff --git a/src/Application/Admin/templates/services.view.php b/src/Application/Admin/templates/services.view.php
index 8f714d8f..a60d6245 100644
--- a/src/Application/Admin/templates/services.view.php
+++ b/src/Application/Admin/templates/services.view.php
@@ -6,19 +6,15 @@
     <div style="margin-bottom: 20px; display: flex; justify-content: space-between; align-items: center;">
         <input type="text" id="serviceFilter" placeholder="Dienste filtern..."
                style="padding: 8px 12px; border: 1px solid var(--gray-300); border-radius: 6px; width: 300px;">
-        <span class="services-count" style="color: var(--gray-600);">{{ servicesCount }} Dienste insgesamt</span>
+        <span class="services-count" style="color: var(--gray-600);">{{$servicesCount}} Dienste insgesamt</span>
     </div>
 
     <div class="stats-grid" id="serviceList">
-        <for var="service" in="services">
-            <div class="stat-card service-item">
-                <h3>{{ service.name }}</h3>
-                <p><strong>Kategorie:</strong> {{ service.category }}</p>
-                <if condition="{{ service.subCategory }}">
-                    <p><strong>Unterkategorie:</strong> {{ service.subCategory }}</p>
-                </if>
-            </div>
-        </for>
+        <div class="stat-card service-item" foreach="$services as $service">
+            <h3>{{$service['name']}}</h3>
+            <p><strong>Kategorie:</strong> {{$service['category']}}</p>
+            <p if="{{$service['subCategory']}}"><strong>Unterkategorie:</strong> {{$service['subCategory']}}</p>
+        </div>
     </div>
 </div>
 
@@ -36,6 +32,6 @@ document.getElementById('serviceFilter').addEventListener('input', function() {
     });
 
     document.querySelector('.services-count').textContent =
-        visibleCount + ' von {{ servicesCount }} Diensten';
+        visibleCount + ' von {{$servicesCount}} Diensten';
 });
 </script>
\ No newline at end of file
diff --git a/src/Application/Admin/templates/upload-form.view.php b/src/Application/Admin/templates/upload-form.view.php
index 9f31eecf..ccc4c914 100644
--- a/src/Application/Admin/templates/upload-form.view.php
+++ b/src/Application/Admin/templates/upload-form.view.php
@@ -1,25 +1,19 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
+    <h2>{{$title}}</h2>
 
-    <if condition="{{ success }}">
-        <div class="alert alert-success">
-            <strong>Erfolg!</strong> {{ description }}
-        </div>
-    <else>
-        <if condition="{{ error }}">
-            <div class="alert alert-danger">
-                <strong>Fehler:</strong> {{ description }}
-            </div>
-        <else>
-            <p>{{ description }}</p>
-        </if>
-    </if>
+    <div class="alert alert-success" if="{{$success}}">
+        <strong>Erfolg!</strong> {{$description}}
+    </div>
+    <div class="alert alert-danger" if="{{$error}}">
+        <strong>Fehler:</strong> {{$description}}
+    </div>
+    <p if="{{!$success && !$error}}">{{$description}}</p>
 
     <div class="stat-card">
         <h3>Bild hochladen</h3>
-        {{formHtml}}
+        {{$formHtml}}
     </div>
 </div>
 
diff --git a/src/Application/Admin/templates/upload-test.view.php b/src/Application/Admin/templates/upload-test.view.php
index d6d814dc..47801e92 100644
--- a/src/Application/Admin/templates/upload-test.view.php
+++ b/src/Application/Admin/templates/upload-test.view.php
@@ -1,8 +1,8 @@
 <layout name="admin" />
 
 <div class="section">
-    <h2>{{ title }}</h2>
-    <p>{{ description }}</p>
+    <h2>{{$title}}</h2>
+    <p>{{$description}}</p>
 
     <div class="stat-card">
         <h3>JavaScript Upload Test</h3>
diff --git a/src/Application/Asset/Api/Requests/UploadAssetRequest.php b/src/Application/Asset/Api/Requests/UploadAssetRequest.php
new file mode 100644
index 00000000..3b43c461
--- /dev/null
+++ b/src/Application/Asset/Api/Requests/UploadAssetRequest.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Asset\Api\Requests;
+
+use App\Framework\Validation\Attributes\MaxLength;
+use App\Framework\Validation\Attributes\MinLength;
+
+final class UploadAssetRequest
+{
+    public ?string $bucket = null;
+
+    /**
+     * @var string[]|null
+     */
+    public ?array $tags = null;
+
+    /**
+     * @var array<string, mixed>|null
+     */
+    public ?array $meta = null;
+}
+
diff --git a/src/Application/Asset/Api/V1/AssetsController.php b/src/Application/Asset/Api/V1/AssetsController.php
new file mode 100644
index 00000000..5bfcce37
--- /dev/null
+++ b/src/Application/Asset/Api/V1/AssetsController.php
@@ -0,0 +1,302 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Asset\Api\V1;
+
+use App\Application\Asset\Api\Requests\UploadAssetRequest;
+use App\Domain\Asset\Exceptions\AssetNotFoundException;
+use App\Domain\Asset\Services\AssetService;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Domain\Asset\ValueObjects\VariantName;
+use App\Framework\Attributes\Route;
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Http\Headers;
+use App\Framework\Http\HttpResponse;
+use App\Framework\Http\Method;
+use App\Framework\Http\Request;
+use App\Framework\Http\Status;
+use App\Framework\Serializer\Json\JsonSerializer;
+use App\Framework\Serializer\Json\JsonSerializerConfig;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+final readonly class AssetsController
+{
+    public function __construct(
+        private AssetService $assetService,
+        private AssetStorageInterface $storage,
+        private JsonSerializer $jsonSerializer
+    ) {
+    }
+
+    #[Route(path: '/api/v1/assets/upload', method: Method::POST)]
+    public function upload(Request $request, UploadAssetRequest $uploadRequest): HttpResponse
+    {
+        try {
+            // Get file from request (multipart/form-data)
+            $files = $request->files;
+            if (empty($files) || ! isset($files['file'])) {
+                return $this->errorResponse('File is required', Status::BAD_REQUEST);
+            }
+
+            $file = $files['file'];
+            if (! isset($file['tmp_name']) || ! is_uploaded_file($file['tmp_name'])) {
+                return $this->errorResponse('Invalid file upload', Status::BAD_REQUEST);
+            }
+
+            $content = file_get_contents($file['tmp_name']);
+            if ($content === false) {
+                return $this->errorResponse('Could not read file', Status::BAD_REQUEST);
+            }
+
+            // Determine MIME type
+            $mimeType = $file['type'] ?? mime_content_type($file['tmp_name']) ?? 'application/octet-stream';
+            $mime = \App\Framework\Http\MimeType::tryFrom($mimeType)
+                ?? \App\Framework\Http\CustomMimeType::fromString($mimeType);
+
+            // Determine bucket
+            $bucket = $uploadRequest->bucket !== null
+                ? BucketName::fromString($uploadRequest->bucket)
+                : BucketName::fromString('media');
+
+            // Parse metadata
+            $meta = null;
+            if ($uploadRequest->meta !== null) {
+                $meta = AssetMetadata::fromArray($uploadRequest->meta);
+            }
+
+            // Parse tags
+            $tags = $uploadRequest->tags ?? [];
+
+            // Upload asset
+            $asset = $this->assetService->upload(
+                content: $content,
+                bucket: $bucket,
+                mime: $mime,
+                meta: $meta,
+                tags: $tags
+            );
+
+            $data = $this->serializeAsset($asset);
+
+            return new HttpResponse(
+                status: Status::CREATED,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        } catch (\Throwable $e) {
+            return $this->errorResponse('Upload failed: ' . $e->getMessage(), Status::INTERNAL_SERVER_ERROR);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}', method: Method::GET)]
+    public function show(string $id): HttpResponse
+    {
+        try {
+            $asset = $this->assetService->findById(AssetId::fromString($id));
+            $variants = $this->assetService->getVariants($asset->id);
+            $tags = $this->assetService->getTags($asset->id);
+
+            $data = $this->serializeAsset($asset, $variants, $tags);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}/variants', method: Method::GET)]
+    public function variants(string $id): HttpResponse
+    {
+        try {
+            $asset = $this->assetService->findById(AssetId::fromString($id));
+            $variants = $this->assetService->getVariants($asset->id);
+
+            $data = array_map(fn ($variant) => $this->serializeVariant($variant), $variants);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}/variants/{variant}', method: Method::GET)]
+    public function variant(string $id, string $variant): HttpResponse
+    {
+        try {
+            $asset = $this->assetService->findById(AssetId::fromString($id));
+            $variantEntity = $this->assetService->getVariant($asset->id, VariantName::fromString($variant));
+
+            if ($variantEntity === null) {
+                return $this->errorResponse('Variant not found', Status::NOT_FOUND);
+            }
+
+            $data = $this->serializeVariant($variantEntity);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}/url', method: Method::GET)]
+    public function url(string $id): HttpResponse
+    {
+        try {
+            $asset = $this->assetService->findById(AssetId::fromString($id));
+            $url = $this->storage->getUrl($asset);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig(['url' => $url], JsonSerializerConfig::pretty())
+            );
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}/signed-url', method: Method::GET)]
+    public function signedUrl(Request $request, string $id): HttpResponse
+    {
+        try {
+            $asset = $this->assetService->findById(AssetId::fromString($id));
+
+            $expires = (int) ($request->query['expires'] ?? 3600);
+            $url = $this->storage->getSignedUrl($asset, $expires);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig(['url' => $url], JsonSerializerConfig::pretty())
+            );
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets/{id}', method: Method::DELETE)]
+    public function delete(string $id): HttpResponse
+    {
+        try {
+            $this->assetService->delete(AssetId::fromString($id));
+
+            return new HttpResponse(Status::NO_CONTENT);
+        } catch (AssetNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/assets', method: Method::GET)]
+    public function index(Request $request): HttpResponse
+    {
+        try {
+            $bucket = $request->query['bucket'] ?? null;
+            $tag = $request->query['tag'] ?? null;
+
+            $assets = [];
+            if ($tag !== null) {
+                $assets = $this->assetService->findByTag($tag);
+            } elseif ($bucket !== null) {
+                $assets = $this->assetService->findByBucket(BucketName::fromString($bucket));
+            }
+
+            $data = array_map(fn ($asset) => $this->serializeAsset($asset), $assets);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    private function serializeAsset(
+        \App\Domain\Asset\Entities\Asset $asset,
+        array $variants = [],
+        array $tags = []
+    ): array {
+        $variantData = array_map(fn ($v) => [
+            'variant' => $v->variant->toString(),
+            'url' => $this->storage->getUrl($this->createAssetFromVariant($v)),
+        ], $variants);
+
+        $tagData = array_map(fn ($t) => $t->tag, $tags);
+
+        return [
+            'id' => $asset->id->toString(),
+            'bucket' => $asset->bucket->toString(),
+            'key' => $asset->key->toString(),
+            'mime' => $asset->mime->value,
+            'bytes' => $asset->bytes->bytes->toBytes(),
+            'sha256' => $asset->sha256->toString(),
+            'meta' => $asset->meta->toArray(),
+            'url' => $this->storage->getUrl($asset),
+            'variants' => $variantData,
+            'tags' => $tagData,
+            'created_at' => $asset->createdAt->toIso8601(),
+        ];
+    }
+
+    private function serializeVariant(\App\Domain\Asset\Entities\AssetVariant $variant): array
+    {
+        $tempAsset = $this->createAssetFromVariant($variant);
+
+        return [
+            'asset_id' => $variant->assetId->toString(),
+            'variant' => $variant->variant->toString(),
+            'bucket' => $variant->bucket->toString(),
+            'key' => $variant->key->toString(),
+            'mime' => $variant->mime->value,
+            'bytes' => $variant->bytes->bytes->toBytes(),
+            'meta' => $variant->meta->toArray(),
+            'url' => $this->storage->getUrl($tempAsset),
+        ];
+    }
+
+    private function createAssetFromVariant(\App\Domain\Asset\Entities\AssetVariant $variant): \App\Domain\Asset\Entities\Asset
+    {
+        return new \App\Domain\Asset\Entities\Asset(
+            id: $variant->assetId,
+            bucket: $variant->bucket,
+            key: $variant->key,
+            mime: $variant->mime,
+            bytes: $variant->bytes,
+            sha256: \App\Framework\Core\ValueObjects\Hash::fromString('0000000000000000000000000000000000000000000000000000000000000000', \App\Framework\Core\ValueObjects\HashAlgorithm::SHA256),
+            meta: $variant->meta,
+            createdAt: \App\Framework\Core\ValueObjects\Timestamp::now()
+        );
+    }
+
+    private function errorResponse(string $message, Status $status): HttpResponse
+    {
+        return new HttpResponse(
+            status: $status,
+            headers: new Headers(['Content-Type' => 'application/json']),
+            body: $this->jsonSerializer->serializeWithConfig(['error' => $message], JsonSerializerConfig::pretty())
+        );
+    }
+}
+
diff --git a/src/Application/Cms/Api/Requests/CreateContentRequest.php b/src/Application/Cms/Api/Requests/CreateContentRequest.php
new file mode 100644
index 00000000..5e59c950
--- /dev/null
+++ b/src/Application/Cms/Api/Requests/CreateContentRequest.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\Requests;
+
+use App\Framework\Validation\Attributes\MaxLength;
+use App\Framework\Validation\Attributes\Required;
+
+final class CreateContentRequest
+{
+    #[Required]
+    #[MaxLength(255)]
+    public ?string $content_type_id = null;
+
+    #[MaxLength(255)]
+    public ?string $slug = null;
+
+    #[Required]
+    #[MaxLength(255)]
+    public ?string $title = null;
+
+    #[Required]
+    public ?array $blocks = null;
+
+    public ?array $meta_data = null;
+
+    public ?string $author_id = null;
+}
+
diff --git a/src/Application/Cms/Api/Requests/CreateContentTypeRequest.php b/src/Application/Cms/Api/Requests/CreateContentTypeRequest.php
new file mode 100644
index 00000000..9b3feae3
--- /dev/null
+++ b/src/Application/Cms/Api/Requests/CreateContentTypeRequest.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\Requests;
+
+use App\Framework\Validation\Attributes\MaxLength;
+use App\Framework\Validation\Attributes\MinLength;
+use App\Framework\Validation\Attributes\Pattern;
+use App\Framework\Validation\Attributes\Required;
+
+final class CreateContentTypeRequest
+{
+    #[Required]
+    #[MinLength(1)]
+    #[MaxLength(255)]
+    public ?string $name = null;
+
+    #[Required]
+    #[MinLength(1)]
+    #[MaxLength(255)]
+    #[Pattern('^[a-z0-9_-]+$')]
+    public ?string $slug = null;
+
+    #[MaxLength(1000)]
+    public ?string $description = null;
+
+    public bool $is_system = false;
+}
+
diff --git a/src/Application/Cms/Api/Requests/UpdateContentRequest.php b/src/Application/Cms/Api/Requests/UpdateContentRequest.php
new file mode 100644
index 00000000..75dd01ef
--- /dev/null
+++ b/src/Application/Cms/Api/Requests/UpdateContentRequest.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\Requests;
+
+use App\Framework\Validation\Attributes\MaxLength;
+
+final class UpdateContentRequest
+{
+    #[MaxLength(255)]
+    public ?string $title = null;
+
+    #[MaxLength(255)]
+    public ?string $slug = null;
+
+    public ?array $blocks = null;
+
+    public ?array $meta_data = null;
+}
+
diff --git a/src/Application/Cms/Api/Requests/UpdateContentTypeRequest.php b/src/Application/Cms/Api/Requests/UpdateContentTypeRequest.php
new file mode 100644
index 00000000..eca3d9d4
--- /dev/null
+++ b/src/Application/Cms/Api/Requests/UpdateContentTypeRequest.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\Requests;
+
+use App\Framework\Validation\Attributes\MaxLength;
+use App\Framework\Validation\Attributes\MinLength;
+use App\Framework\Validation\Attributes\Pattern;
+
+final class UpdateContentTypeRequest
+{
+    #[MinLength(1)]
+    #[MaxLength(255)]
+    public ?string $name = null;
+
+    #[MinLength(1)]
+    #[MaxLength(255)]
+    #[Pattern('^[a-z0-9_-]+$')]
+    public ?string $slug = null;
+
+    #[MaxLength(1000)]
+    public ?string $description = null;
+}
+
diff --git a/src/Application/Cms/Api/V1/ContentTypesController.php b/src/Application/Cms/Api/V1/ContentTypesController.php
new file mode 100644
index 00000000..82e5a474
--- /dev/null
+++ b/src/Application/Cms/Api/V1/ContentTypesController.php
@@ -0,0 +1,193 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\V1;
+
+use App\Application\Cms\Api\Requests\CreateContentTypeRequest;
+use App\Application\Cms\Api\Requests\UpdateContentTypeRequest;
+use App\Domain\Cms\Exceptions\CannotDeleteSystemContentTypeException;
+use App\Domain\Cms\Exceptions\ContentTypeNotFoundException;
+use App\Domain\Cms\Exceptions\DuplicateContentTypeSlugException;
+use App\Domain\Cms\Services\ContentTypeService;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\Attributes\Route;
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Http\Headers;
+use App\Framework\Http\HttpResponse;
+use App\Framework\Http\Method;
+use App\Framework\Http\Request;
+use App\Framework\Http\Status;
+use App\Framework\Serializer\Json\JsonSerializer;
+use App\Framework\Serializer\Json\JsonSerializerConfig;
+
+final readonly class ContentTypesController
+{
+    public function __construct(
+        private ContentTypeService $contentTypeService,
+        private JsonSerializer $jsonSerializer
+    ) {
+    }
+
+    #[Route(path: '/api/v1/cms/content-types', method: Method::GET)]
+    public function index(Request $request): HttpResponse
+    {
+        $contentTypes = $this->contentTypeService->findAll();
+        $data = array_map(fn ($contentType) => $this->serializeContentType($contentType), $contentTypes);
+
+        return new HttpResponse(
+            status: Status::OK,
+            headers: new Headers(['Content-Type' => 'application/json']),
+            body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+        );
+    }
+
+    #[Route(path: '/api/v1/cms/content-types/{id}', method: Method::GET)]
+    public function show(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentTypeId::fromString($request->queryParams['id'] ?? '');
+            $contentType = $this->contentTypeService->findById($id);
+            $data = $this->serializeContentType($contentType);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (ContentTypeNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/content-types', method: Method::POST)]
+    public function create(Request $request, CreateContentTypeRequest $createRequest): HttpResponse
+    {
+        try {
+            $requestData = $this->jsonSerializer->deserialize($request->body);
+            if (! is_array($requestData)) {
+                return $this->errorResponse('Invalid request body', Status::BAD_REQUEST);
+            }
+
+            // Map request data to CreateContentTypeRequest
+            $createRequest->name = $requestData['name'] ?? null;
+            $createRequest->slug = $requestData['slug'] ?? null;
+            $createRequest->description = $requestData['description'] ?? null;
+            $createRequest->is_system = $requestData['is_system'] ?? false;
+
+            // Validate required fields
+            if ($createRequest->name === null || $createRequest->slug === null) {
+                return $this->errorResponse('name and slug are required', Status::BAD_REQUEST);
+            }
+
+            $contentType = $this->contentTypeService->create(
+                name: $createRequest->name,
+                slug: $createRequest->slug,
+                description: $createRequest->description,
+                isSystem: $createRequest->is_system
+            );
+
+            $data = $this->serializeContentType($contentType);
+
+            return new HttpResponse(
+                status: Status::CREATED,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (DuplicateContentTypeSlugException $e) {
+            return $this->errorResponse($e->getMessage(), Status::CONFLICT);
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/content-types/{id}', method: Method::PUT)]
+    public function update(Request $request, UpdateContentTypeRequest $updateRequest): HttpResponse
+    {
+        try {
+            $id = ContentTypeId::fromString($request->queryParams['id'] ?? '');
+            $requestData = $this->jsonSerializer->deserialize($request->body);
+            if (! is_array($requestData)) {
+                return $this->errorResponse('Invalid request body', Status::BAD_REQUEST);
+            }
+
+            // Map request data to UpdateContentTypeRequest
+            $updateRequest->name = $requestData['name'] ?? null;
+            $updateRequest->slug = $requestData['slug'] ?? null;
+            $updateRequest->description = $requestData['description'] ?? null;
+
+            $contentType = $this->contentTypeService->update(
+                id: $id,
+                name: $updateRequest->name,
+                slug: $updateRequest->slug,
+                description: $updateRequest->description
+            );
+
+            $data = $this->serializeContentType($contentType);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (ContentTypeNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        } catch (DuplicateContentTypeSlugException $e) {
+            return $this->errorResponse($e->getMessage(), Status::CONFLICT);
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/content-types/{id}', method: Method::DELETE)]
+    public function delete(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentTypeId::fromString($request->queryParams['id'] ?? '');
+            $this->contentTypeService->delete($id);
+
+            return new HttpResponse(
+                status: Status::NO_CONTENT,
+                headers: new Headers(['Content-Type' => 'application/json'])
+            );
+        } catch (ContentTypeNotFoundException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        } catch (CannotDeleteSystemContentTypeException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        } catch (\InvalidArgumentException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function serializeContentType(\App\Domain\Cms\Entities\ContentType $contentType): array
+    {
+        return [
+            'id' => $contentType->id->toString(),
+            'name' => $contentType->name,
+            'slug' => $contentType->slug,
+            'description' => $contentType->description,
+            'is_system' => $contentType->isSystem,
+            'created_at' => $contentType->createdAt->format('Y-m-d\TH:i:s\Z'),
+            'updated_at' => $contentType->updatedAt->format('Y-m-d\TH:i:s\Z'),
+        ];
+    }
+
+    private function errorResponse(string $message, Status $status): HttpResponse
+    {
+        return new HttpResponse(
+            status: $status,
+            headers: new Headers(['Content-Type' => 'application/json']),
+            body: $this->jsonSerializer->serializeWithConfig(['error' => $message], JsonSerializerConfig::pretty())
+        );
+    }
+}
+
diff --git a/src/Application/Cms/Api/V1/ContentsController.php b/src/Application/Cms/Api/V1/ContentsController.php
new file mode 100644
index 00000000..cdf94de2
--- /dev/null
+++ b/src/Application/Cms/Api/V1/ContentsController.php
@@ -0,0 +1,260 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Cms\Api\V1;
+
+use App\Application\Cms\Api\Requests\CreateContentRequest;
+use App\Application\Cms\Api\Requests\UpdateContentRequest;
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Domain\Cms\Services\ContentService;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\Attributes\Route;
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Http\Headers;
+use App\Framework\Http\HttpResponse;
+use App\Framework\Http\Method;
+use App\Framework\Http\Request;
+use App\Framework\Http\Status;
+use App\Framework\Serializer\Json\JsonSerializer;
+use App\Framework\Serializer\Json\JsonSerializerConfig;
+
+final readonly class ContentsController
+{
+    public function __construct(
+        private ContentService $contentService,
+        private JsonSerializer $jsonSerializer
+    ) {
+    }
+
+    #[Route(path: '/api/v1/cms/contents', method: Method::GET)]
+    public function index(Request $request): HttpResponse
+    {
+        $contentTypeId = $request->queryParams['content_type_id'] ?? null;
+        $status = $request->queryParams['status'] ?? null;
+
+        $contents = [];
+        if ($contentTypeId !== null) {
+            $typeId = ContentTypeId::fromString($contentTypeId);
+            $contentStatus = $status !== null ? ContentStatus::from($status) : null;
+            $contents = $this->contentService->findByType($typeId, $contentStatus);
+        } else {
+            $contents = $status === ContentStatus::PUBLISHED->value
+                ? $this->contentService->findPublished()
+                : [];
+        }
+
+        $data = array_map(fn ($content) => $this->serializeContent($content), $contents);
+
+        return new HttpResponse(
+            status: Status::OK,
+            headers: new Headers(['Content-Type' => 'application/json']),
+            body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+        );
+    }
+
+    #[Route(path: '/api/v1/cms/contents/{id}', method: Method::GET)]
+    public function show(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentId::fromString($request->queryParams['id'] ?? '');
+            $content = $this->contentService->findById($id);
+            $data = $this->serializeContent($content);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/contents', method: Method::POST)]
+    public function create(Request $request, CreateContentRequest $createRequest): HttpResponse
+    {
+        try {
+            $requestData = $this->jsonSerializer->deserialize($request->body);
+            if (! is_array($requestData)) {
+                return $this->errorResponse('Invalid request body', Status::BAD_REQUEST);
+            }
+
+            // Map request data to CreateContentRequest
+            $createRequest->content_type_id = $requestData['content_type_id'] ?? null;
+            $createRequest->title = $requestData['title'] ?? null;
+            $createRequest->slug = $requestData['slug'] ?? null;
+            $createRequest->blocks = $requestData['blocks'] ?? null;
+            $createRequest->meta_data = $requestData['meta_data'] ?? null;
+            $createRequest->author_id = $requestData['author_id'] ?? null;
+
+            // Validate required fields
+            if ($createRequest->content_type_id === null || $createRequest->title === null || $createRequest->blocks === null) {
+                return $this->errorResponse('content_type_id, title, and blocks are required', Status::BAD_REQUEST);
+            }
+
+            $contentTypeId = ContentTypeId::fromString($createRequest->content_type_id);
+            $blocks = ContentBlocks::fromArray($createRequest->blocks);
+            $slug = $createRequest->slug !== null ? ContentSlug::fromString($createRequest->slug) : null;
+            $metaData = $createRequest->meta_data !== null ? BlockData::fromArray($createRequest->meta_data) : null;
+            $defaultLocale = isset($requestData['default_locale'])
+                ? Locale::fromString($requestData['default_locale'])
+                : Locale::english();
+
+            $content = $this->contentService->create(
+                contentTypeId: $contentTypeId,
+                title: $createRequest->title,
+                blocks: $blocks,
+                defaultLocale: $defaultLocale,
+                slug: $slug,
+                authorId: $createRequest->author_id,
+                metaData: $metaData
+            );
+
+            $data = $this->serializeContent($content);
+
+            return new HttpResponse(
+                status: Status::CREATED,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/contents/{id}', method: Method::PUT)]
+    public function update(Request $request, UpdateContentRequest $updateRequest): HttpResponse
+    {
+        try {
+            $id = ContentId::fromString($request->queryParams['id'] ?? '');
+            $requestData = $this->jsonSerializer->deserialize($request->body);
+
+            if (! is_array($requestData)) {
+                return $this->errorResponse('Invalid request body', Status::BAD_REQUEST);
+            }
+
+            // Map request data
+            $updateRequest->title = $requestData['title'] ?? null;
+            $updateRequest->slug = $requestData['slug'] ?? null;
+            $updateRequest->blocks = $requestData['blocks'] ?? null;
+            $updateRequest->meta_data = $requestData['meta_data'] ?? null;
+
+            $content = $this->contentService->findById($id);
+
+            if ($updateRequest->title !== null) {
+                $content = $this->contentService->updateTitle($id, $updateRequest->title);
+            }
+
+            if ($updateRequest->slug !== null) {
+                $content = $this->contentService->updateSlug($id, ContentSlug::fromString($updateRequest->slug));
+            }
+
+            if ($updateRequest->blocks !== null) {
+                $content = $this->contentService->updateBlocks($id, ContentBlocks::fromArray($updateRequest->blocks));
+            }
+
+            if ($updateRequest->meta_data !== null) {
+                $content = $this->contentService->updateMetaData($id, BlockData::fromArray($updateRequest->meta_data));
+            }
+
+            $data = $this->serializeContent($content);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/contents/{id}', method: Method::DELETE)]
+    public function delete(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentId::fromString($request->queryParams['id'] ?? '');
+            $this->contentService->delete($id);
+
+            return new HttpResponse(
+                status: Status::NO_CONTENT,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: ''
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::NOT_FOUND);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/contents/{id}/publish', method: Method::POST)]
+    public function publish(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentId::fromString($request->queryParams['id'] ?? '');
+            $content = $this->contentService->publish($id);
+            $data = $this->serializeContent($content);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    #[Route(path: '/api/v1/cms/contents/{id}/unpublish', method: Method::POST)]
+    public function unpublish(Request $request): HttpResponse
+    {
+        try {
+            $id = ContentId::fromString($request->queryParams['id'] ?? '');
+            $content = $this->contentService->unpublish($id);
+            $data = $this->serializeContent($content);
+
+            return new HttpResponse(
+                status: Status::OK,
+                headers: new Headers(['Content-Type' => 'application/json']),
+                body: $this->jsonSerializer->serializeWithConfig($data, JsonSerializerConfig::pretty())
+            );
+        } catch (FrameworkException $e) {
+            return $this->errorResponse($e->getMessage(), Status::BAD_REQUEST);
+        }
+    }
+
+    private function serializeContent($content): array
+    {
+        return [
+            'id' => $content->id->toString(),
+            'content_type_id' => $content->contentTypeId->toString(),
+            'slug' => $content->slug->toString(),
+            'title' => $content->title,
+            'blocks' => $content->blocks->toArray(),
+            'meta_data' => $content->metaData?->toArray(),
+            'status' => $content->status->value,
+            'author_id' => $content->authorId,
+            'default_locale' => $content->defaultLocale->toString(),
+            'published_at' => $content->publishedAt?->format('Y-m-d\TH:i:s\Z'),
+            'created_at' => $content->createdAt->format('Y-m-d\TH:i:s\Z'),
+            'updated_at' => $content->updatedAt->format('Y-m-d\TH:i:s\Z'),
+        ];
+    }
+
+    private function errorResponse(string $message, Status $status): HttpResponse
+    {
+        return new HttpResponse(
+            status: $status,
+            headers: new Headers(['Content-Type' => 'application/json']),
+            body: $this->jsonSerializer->serialize([
+                'error' => $message,
+            ])
+        );
+    }
+}
+
diff --git a/src/Application/Console/Commands/Design/GenerateTokensCommand.php b/src/Application/Console/Commands/Design/GenerateTokensCommand.php
new file mode 100644
index 00000000..99646a9b
--- /dev/null
+++ b/src/Application/Console/Commands/Design/GenerateTokensCommand.php
@@ -0,0 +1,189 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Console\Commands\Design;
+
+use App\Application\Admin\ValueObjects\AdminTokenRegistry;
+use App\Framework\Design\Repositories\DatabaseTokenRepository;
+use App\Framework\Design\ValueObjects\FrameworkTokenRegistry;
+use App\Framework\Design\ValueObjects\HybridTokenRegistry;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Console\CommandGroup;
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutputInterface;
+use App\Framework\Console\ExitCode;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+#[CommandGroup(
+    name: 'Design',
+    description: 'Design system and token management commands',
+    icon: '🎨',
+    priority: 70
+)]
+final readonly class GenerateTokensCommand
+{
+    public function __construct(
+        private AdminTokenRegistry $adminTokenRegistry,
+        private FrameworkTokenRegistry $frameworkTokenRegistry,
+        private ?DatabaseTokenRepository $dbRepository = null
+    ) {
+    }
+
+    #[ConsoleCommand('design:generate-tokens', 'Generate CSS file from PHP design tokens')]
+    public function generateTokens(ConsoleInput $input, ConsoleOutputInterface $output): ExitCode
+    {
+        $output->writeLine('🎨 Generating Design Tokens CSS...', ConsoleColor::BRIGHT_CYAN);
+        $output->newLine();
+
+        // Parse options
+        $scope = $input->getOption('scope') ?? 'admin'; // 'framework' or 'admin'
+        $format = $input->getOption('format') ?? 'itcss'; // 'itcss' or 'cube'
+        $outputPathOption = $input->getOption('output');
+        $useDb = $input->getOption('use-db') === true || $input->getOption('use-db') === 'true';
+
+        // Select base token registry based on scope
+        $baseRegistry = match($scope) {
+            'framework' => $this->frameworkTokenRegistry,
+            'admin' => $this->adminTokenRegistry,
+            default => throw new \InvalidArgumentException("Invalid scope: {$scope}. Use 'framework' or 'admin'.")
+        };
+
+        // Use hybrid registry if DB is enabled and repository is available
+        $tokenRegistry = ($useDb && $this->dbRepository !== null)
+            ? new HybridTokenRegistry($baseRegistry, $this->dbRepository)
+            : $baseRegistry;
+
+        // Determine output path
+        $outputPath = $this->determineOutputPath($scope, $format, $outputPathOption);
+
+        // Ensure directory exists
+        $directoryPath = $outputPath->getDirectory()->toString();
+        if (! is_dir($directoryPath)) {
+            if (! mkdir($directoryPath, 0755, true) && ! is_dir($directoryPath)) {
+                $output->writeLine(
+                    sprintf('❌ Failed to create directory: %s', $directoryPath),
+                    ConsoleColor::RED
+                );
+
+                return ExitCode::IO_ERROR;
+            }
+        }
+
+        // Generate CSS content
+        $css = $this->generateCssContent($tokenRegistry, $scope, $format);
+
+        // Write file
+        $bytesWritten = file_put_contents($outputPath->toString(), $css);
+
+        if ($bytesWritten === false) {
+            $output->writeLine(
+                sprintf('❌ Failed to write file: %s', $outputPath->toString()),
+                ConsoleColor::RED
+            );
+
+            return ExitCode::IO_ERROR;
+        }
+
+        // Calculate statistics
+        $tokenCount = count($tokenRegistry->all());
+        $fileSize = $bytesWritten;
+        $fileSizeFormatted = $this->formatBytes($fileSize);
+
+        // Success message
+        $output->writeLine('✅ Design tokens generated successfully!', ConsoleColor::GREEN);
+        $output->newLine();
+
+        $output->writeLine('📊 Summary:', ConsoleColor::BRIGHT_CYAN);
+        $output->writeLine(sprintf('   • Scope: %s', $scope));
+        $output->writeLine(sprintf('   • Format: %s', strtoupper($format)));
+        $output->writeLine(sprintf('   • Database: %s', $useDb && $this->dbRepository !== null ? 'Yes' : 'No'));
+        $output->writeLine(sprintf('   • Output file: %s', $outputPath->toString()));
+        $output->writeLine(sprintf('   • Tokens generated: %d', $tokenCount));
+        $output->writeLine(sprintf('   • File size: %s', $fileSizeFormatted));
+        $output->newLine();
+
+        $output->writeLine(
+            '💡 This file is auto-generated. Do not edit manually.',
+            ConsoleColor::YELLOW
+        );
+
+        return ExitCode::SUCCESS;
+    }
+
+    /**
+     * Determine output path based on scope and format
+     */
+    private function determineOutputPath(string $scope, string $format, ?string $customPath): FilePath
+    {
+        if ($customPath) {
+            return FilePath::create($customPath);
+        }
+
+        // Default paths based on scope and format
+        return match([$scope, $format]) {
+            ['framework', 'itcss'] => FilePath::create('resources/css/settings/_generated-tokens.css'),
+            ['framework', 'cube'] => FilePath::create('resources/css/settings/_generated-tokens.css'),
+            ['admin', 'itcss'] => FilePath::create('resources/css/admin/01-settings/_generated-tokens.css'),
+            ['admin', 'cube'] => FilePath::create('resources/css/admin/settings/_generated-tokens.css'),
+            default => FilePath::create('resources/css/admin/01-settings/_generated-tokens.css'),
+        };
+    }
+
+    /**
+     * Generate complete CSS content with header
+     */
+    private function generateCssContent(TokenRegistry $tokenRegistry, string $scope, string $format): string
+    {
+        $timestamp = date('Y-m-d H:i:s');
+        $sourceClass = $scope === 'framework' 
+            ? 'FrameworkTokenRegistry' 
+            : 'AdminTokenRegistry';
+        $sourcePath = $scope === 'framework'
+            ? 'src/Framework/Design/ValueObjects/FrameworkTokenRegistry.php'
+            : 'src/Application/Admin/ValueObjects/AdminTokenRegistry.php';
+
+        $header = <<<'CSS'
+/**
+ * Generated Design Tokens - DO NOT EDIT MANUALLY
+ * 
+ * This file is automatically generated from {SOURCE_CLASS}.
+ * To modify tokens, edit: {SOURCE_PATH}
+ * 
+ * Generated: {TIMESTAMP}
+ * Source: {SOURCE_CLASS}
+ * Scope: {SCOPE}
+ * Architecture: {ARCHITECTURE}
+ */
+
+CSS;
+
+        $header = str_replace('{TIMESTAMP}', $timestamp, $header);
+        $header = str_replace('{SOURCE_CLASS}', $sourceClass, $header);
+        $header = str_replace('{SOURCE_PATH}', $sourcePath, $header);
+        $header = str_replace('{SCOPE}', $scope, $header);
+        $header = str_replace('{ARCHITECTURE}', strtoupper($format), $header);
+
+        $layerName = $scope === 'framework' ? 'framework-settings' : 'admin-settings';
+        $css = $tokenRegistry->toCss($layerName, includeHdr: true);
+
+        return $header . $css;
+    }
+
+    /**
+     * Format bytes to human-readable format
+     */
+    private function formatBytes(int $bytes): string
+    {
+        $units = ['B', 'KB', 'MB', 'GB'];
+        $bytes = max($bytes, 0);
+        $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
+        $pow = min($pow, count($units) - 1);
+        $bytes /= (1 << (10 * $pow));
+
+        return round($bytes, 2) . ' ' . $units[$pow];
+    }
+}
+
diff --git a/src/Application/Console/Commands/Design/LintTokensCommand.php b/src/Application/Console/Commands/Design/LintTokensCommand.php
new file mode 100644
index 00000000..9606d35d
--- /dev/null
+++ b/src/Application/Console/Commands/Design/LintTokensCommand.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Console\Commands\Design;
+
+use App\Application\Admin\ValueObjects\AdminTokenRegistry;
+use App\Framework\Design\Linters\TokenLinter;
+use App\Framework\Design\ValueObjects\FrameworkTokenRegistry;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Console\CommandGroup;
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutputInterface;
+use App\Framework\Console\ExitCode;
+
+#[CommandGroup(
+    name: 'Design',
+    description: 'Design system and token management commands',
+    icon: '🎨',
+    priority: 70
+)]
+final readonly class LintTokensCommand
+{
+    public function __construct(
+        private AdminTokenRegistry $adminTokenRegistry,
+        private FrameworkTokenRegistry $frameworkTokenRegistry,
+        private TokenLinter $linter
+    ) {
+    }
+
+    #[ConsoleCommand('design:lint-tokens', 'Lint design tokens for code quality')]
+    public function lintTokens(ConsoleInput $input, ConsoleOutputInterface $output): ExitCode
+    {
+        $output->writeLine('🔍 Linting Design Tokens...', ConsoleColor::BRIGHT_CYAN);
+        $output->newLine();
+
+        $scope = $input->getOption('scope') ?? 'all'; // 'framework', 'admin', or 'all'
+        $usedTokens = $input->getOption('used-tokens') ? explode(',', $input->getOption('used-tokens')) : [];
+
+        $results = [];
+
+        if ($scope === 'all' || $scope === 'framework') {
+            $output->writeLine('Linting framework tokens...', ConsoleColor::CYAN);
+            $results['framework'] = $this->linter->lintRegistry($this->frameworkTokenRegistry, $usedTokens);
+        }
+
+        if ($scope === 'all' || $scope === 'admin') {
+            $output->writeLine('Linting admin tokens...', ConsoleColor::CYAN);
+            $results['admin'] = $this->linter->lintRegistry($this->adminTokenRegistry, $usedTokens);
+        }
+
+        $output->newLine();
+
+        // Display results
+        $hasIssues = false;
+        foreach ($results as $scopeName => $result) {
+            $output->writeLine("📊 {$scopeName} tokens:", ConsoleColor::BRIGHT_CYAN);
+
+            if (! $result->hasIssues()) {
+                $output->writeLine('  ✅ No linting issues found!', ConsoleColor::GREEN);
+            } else {
+                $hasIssues = true;
+                $issuesBySeverity = $result->getIssuesBySeverity();
+
+                foreach (['error', 'warning', 'info'] as $severity) {
+                    if (! isset($issuesBySeverity[$severity])) {
+                        continue;
+                    }
+
+                    $color = match($severity) {
+                        'error' => ConsoleColor::RED,
+                        'warning' => ConsoleColor::YELLOW,
+                        default => ConsoleColor::CYAN
+                    };
+
+                    $icon = match($severity) {
+                        'error' => '❌',
+                        'warning' => '⚠️',
+                        default => 'ℹ️'
+                    };
+
+                    $issueCount = count($issuesBySeverity[$severity]);
+                    $output->writeLine("  {$icon} {$severity} ({$issueCount}):", $color);
+                    foreach ($issuesBySeverity[$severity] as $issue) {
+                        $output->writeLine("    • {$issue->toString()}", $color);
+                    }
+                }
+            }
+
+            $output->newLine();
+        }
+
+        // Summary
+        $output->writeLine('📋 Summary:', ConsoleColor::BRIGHT_CYAN);
+        foreach ($results as $scopeName => $result) {
+            $output->writeLine("  • {$scopeName}: {$result->getSummary()}");
+        }
+
+        $output->newLine();
+
+        if ($hasIssues) {
+            $output->writeLine('⚠️  Linting found issues!', ConsoleColor::YELLOW);
+            return ExitCode::VALIDATION_ERROR;
+        }
+
+        $output->writeLine('✅ Linting passed!', ConsoleColor::GREEN);
+        return ExitCode::SUCCESS;
+    }
+}
+
diff --git a/src/Application/Console/Commands/Design/ValidateTokensCommand.php b/src/Application/Console/Commands/Design/ValidateTokensCommand.php
new file mode 100644
index 00000000..c63a89bd
--- /dev/null
+++ b/src/Application/Console/Commands/Design/ValidateTokensCommand.php
@@ -0,0 +1,101 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\Console\Commands\Design;
+
+use App\Application\Admin\ValueObjects\AdminTokenRegistry;
+use App\Framework\Design\Validators\TokenValidator;
+use App\Framework\Design\ValueObjects\FrameworkTokenRegistry;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Console\CommandGroup;
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutputInterface;
+use App\Framework\Console\ExitCode;
+
+#[CommandGroup(
+    name: 'Design',
+    description: 'Design system and token management commands',
+    icon: '🎨',
+    priority: 70
+)]
+final readonly class ValidateTokensCommand
+{
+    public function __construct(
+        private AdminTokenRegistry $adminTokenRegistry,
+        private FrameworkTokenRegistry $frameworkTokenRegistry,
+        private TokenValidator $validator
+    ) {
+    }
+
+    #[ConsoleCommand('design:validate-tokens', 'Validate design tokens for correctness')]
+    public function validateTokens(ConsoleInput $input, ConsoleOutputInterface $output): ExitCode
+    {
+        $output->writeLine('🔍 Validating Design Tokens...', ConsoleColor::BRIGHT_CYAN);
+        $output->newLine();
+
+        $scope = $input->getOption('scope') ?? 'all'; // 'framework', 'admin', or 'all'
+
+        $results = [];
+
+        if ($scope === 'all' || $scope === 'framework') {
+            $output->writeLine('Validating framework tokens...', ConsoleColor::CYAN);
+            $results['framework'] = $this->validator->validateRegistry($this->frameworkTokenRegistry);
+        }
+
+        if ($scope === 'all' || $scope === 'admin') {
+            $output->writeLine('Validating admin tokens...', ConsoleColor::CYAN);
+            $results['admin'] = $this->validator->validateRegistry($this->adminTokenRegistry);
+        }
+
+        $output->newLine();
+
+        // Display results
+        $hasErrors = false;
+        foreach ($results as $scopeName => $result) {
+            $output->writeLine("📊 {$scopeName} tokens:", ConsoleColor::BRIGHT_CYAN);
+
+            if (empty($result->errors) && empty($result->warnings)) {
+                $output->writeLine('  ✅ All tokens are valid!', ConsoleColor::GREEN);
+            } else {
+                if (! empty($result->errors)) {
+                    $hasErrors = true;
+                    $errorCount = count($result->errors);
+                    $output->writeLine("  ❌ Errors ({$errorCount}):", ConsoleColor::RED);
+                    foreach ($result->errors as $error) {
+                        $output->writeLine("    • {$error->toString()}", ConsoleColor::RED);
+                    }
+                }
+
+                if (! empty($result->warnings)) {
+                    $warningCount = count($result->warnings);
+                    $output->writeLine("  ⚠️  Warnings ({$warningCount}):", ConsoleColor::YELLOW);
+                    foreach ($result->warnings as $warning) {
+                        $output->writeLine("    • {$warning->toString()}", ConsoleColor::YELLOW);
+                    }
+                }
+            }
+
+            $output->newLine();
+        }
+
+        // Summary
+        $output->writeLine('📋 Summary:', ConsoleColor::BRIGHT_CYAN);
+        foreach ($results as $scopeName => $result) {
+            $output->writeLine("  • {$scopeName}: {$result->getSummary()}");
+        }
+
+        $output->newLine();
+
+        if ($hasErrors) {
+            $output->writeLine('❌ Validation failed!', ConsoleColor::RED);
+            return ExitCode::VALIDATION_ERROR;
+        }
+
+        $output->writeLine('✅ Validation passed!', ConsoleColor::GREEN);
+        return ExitCode::SUCCESS;
+    }
+}
+
diff --git a/src/Application/Contact/ShowContact.php b/src/Application/Contact/ShowContact.php
index c90f6075..cd01f428 100644
--- a/src/Application/Contact/ShowContact.php
+++ b/src/Application/Contact/ShowContact.php
@@ -6,6 +6,7 @@ namespace App\Application\Contact;
 
 use App\Framework\Attributes\Route;
 use App\Framework\CommandBus\CommandBus;
+use App\Framework\Display\Formatters\AutoFormatter;
 use App\Framework\Http\Method;
 use App\Framework\Meta\MetaData;
 use App\Framework\Meta\StaticPageMetaResolver;
@@ -16,12 +17,14 @@ use App\Framework\Router\ActionResult;
 use App\Framework\Router\Result\Redirect;
 use App\Framework\Router\Result\ViewResult;
 use App\Framework\Router\WebRoutes;
+use App\Framework\SyntaxHighlighter\SyntaxHighlighter;
 
 final readonly class ShowContact
 {
     #[Route(path: '/kontakt', name: WebRoutes::CONTACT)]
     public function __invoke(): ViewResult
     {
+        throw new \Exception((string)time());
         return new ViewResult(
             'contact',
             new StaticPageMetaResolver(
diff --git a/src/Application/LiveComponents/Dashboard/DockerContainersComponent.php b/src/Application/LiveComponents/Dashboard/DockerContainersComponent.php
new file mode 100644
index 00000000..49d52ebe
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/DockerContainersComponent.php
@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\Attributes\LiveComponent;
+use App\Framework\LiveComponents\Contracts\LiveComponentContract;
+use App\Framework\LiveComponents\Contracts\Pollable;
+use App\Framework\LiveComponents\ValueObjects\ComponentId;
+use App\Framework\LiveComponents\ValueObjects\ComponentRenderData;
+use App\Framework\Process\Services\DockerService;
+
+/**
+ * Docker Containers LiveComponent
+ *
+ * Displays real-time Docker container status and metrics:
+ * - Docker daemon status
+ * - Container list with status
+ * - Container statistics (CPU, memory)
+ *
+ * Polls every 5 seconds for real-time monitoring.
+ */
+#[LiveComponent('docker-containers')]
+final readonly class DockerContainersComponent implements LiveComponentContract, Pollable
+{
+    public function __construct(
+        public ComponentId $id,
+        public DockerContainersState $state,
+        private DockerService $dockerService
+    ) {}
+
+    public function getRenderData(): ComponentRenderData
+    {
+        // Initial poll if state is empty (lastUpdated is empty string)
+        $state = $this->state->lastUpdated === ''
+            ? $this->poll()
+            : $this->state;
+
+        return new ComponentRenderData(
+            templatePath: 'livecomponent-docker-containers',
+            data: [
+                // LiveComponent integration
+                'componentId' => $this->id->toString(),
+                'stateJson' => json_encode($state->toArray()),
+                'pollInterval' => $this->getPollInterval(),
+
+                // Component data
+                'isRunning' => $state->isRunning,
+                'dockerVersion' => $state->dockerVersion,
+                'totalContainers' => $state->totalContainers,
+                'runningContainers' => $state->runningContainers,
+                'stoppedContainers' => $state->stoppedContainers,
+                'containers' => $state->containers,
+                'lastUpdated' => $state->lastUpdated,
+            ]
+        );
+    }
+
+    #[Action]
+    public function poll(): DockerContainersState
+    {
+        $containers = $this->dockerService->listContainers(all: true);
+        $dockerVersion = $this->dockerService->getVersion();
+        $isRunning = $this->dockerService->isRunning();
+
+        // Get stats for running containers
+        $containerStats = [];
+        foreach ($containers as $container) {
+            if ($container->isRunning) {
+                $stats = $this->dockerService->getContainerStats($container->id);
+                if ($stats !== null) {
+                    $containerStats[$container->id] = $stats->toArray();
+                }
+            }
+        }
+
+        // Prepare container data
+        $containerData = [];
+        foreach ($containers as $container) {
+            $stats = $containerStats[$container->id] ?? null;
+            $containerData[] = [
+                'id' => $container->id,
+                'name' => $container->name,
+                'image' => $container->image,
+                'status' => $container->status,
+                'is_running' => $container->isRunning,
+                'stats' => $stats,
+            ];
+        }
+
+        return $this->state->withContainers(
+            isRunning: $isRunning,
+            dockerVersion: $dockerVersion,
+            containers: $containerData
+        );
+    }
+
+    public function getPollInterval(): int
+    {
+        return 5000; // Poll every 5 seconds for real-time updates
+    }
+}
+
diff --git a/src/Application/LiveComponents/Dashboard/DockerContainersState.php b/src/Application/LiveComponents/Dashboard/DockerContainersState.php
new file mode 100644
index 00000000..aafd9af8
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/DockerContainersState.php
@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Application\LiveComponents\LiveComponentState;
+
+/**
+ * Type-safe state for DockerContainersComponent
+ *
+ * Provides real-time Docker container status and metrics.
+ * Immutable value object - transformations return new instances.
+ */
+final readonly class DockerContainersState implements LiveComponentState
+{
+    /**
+     * @param array<int, array{id: string, name: string, image: string, status: string, is_running: bool, stats: array<string, mixed>|null}> $containers
+     */
+    public function __construct(
+        public bool $isRunning = false,
+        public string $dockerVersion = '',
+        public int $totalContainers = 0,
+        public int $runningContainers = 0,
+        public int $stoppedContainers = 0,
+        public array $containers = [],
+        public string $lastUpdated = ''
+    ) {}
+
+    /**
+     * Create from array data (from client or storage)
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            isRunning: (bool) ($data['isRunning'] ?? $data['is_running'] ?? false),
+            dockerVersion: (string) ($data['dockerVersion'] ?? $data['docker_version'] ?? ''),
+            totalContainers: (int) ($data['totalContainers'] ?? $data['total_containers'] ?? 0),
+            runningContainers: (int) ($data['runningContainers'] ?? $data['running_containers'] ?? 0),
+            stoppedContainers: (int) ($data['stoppedContainers'] ?? $data['stopped_containers'] ?? 0),
+            containers: (array) ($data['containers'] ?? []),
+            lastUpdated: (string) ($data['lastUpdated'] ?? $data['last_updated'] ?? '')
+        );
+    }
+
+    /**
+     * Create empty state with defaults
+     */
+    public static function empty(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Update with fresh Docker container data
+     *
+     * @param array<int, array{id: string, name: string, image: string, status: string, is_running: bool, stats: array<string, mixed>|null}> $containers
+     */
+    public function withContainers(
+        bool $isRunning,
+        string $dockerVersion,
+        array $containers
+    ): self {
+        $runningCount = count(array_filter($containers, fn($c) => $c['is_running'] ?? false));
+        $stoppedCount = count($containers) - $runningCount;
+
+        return new self(
+            isRunning: $isRunning,
+            dockerVersion: $dockerVersion,
+            totalContainers: count($containers),
+            runningContainers: $runningCount,
+            stoppedContainers: $stoppedCount,
+            containers: $containers,
+            lastUpdated: date('H:i:s')
+        );
+    }
+
+    /**
+     * Update timestamp
+     */
+    public function withLastUpdated(string $timestamp): self
+    {
+        return new self(
+            isRunning: $this->isRunning,
+            dockerVersion: $this->dockerVersion,
+            totalContainers: $this->totalContainers,
+            runningContainers: $this->runningContainers,
+            stoppedContainers: $this->stoppedContainers,
+            containers: $this->containers,
+            lastUpdated: $timestamp
+        );
+    }
+
+    /**
+     * Convert to array for template rendering
+     */
+    public function toArray(): array
+    {
+        return [
+            'isRunning' => $this->isRunning,
+            'dockerVersion' => $this->dockerVersion,
+            'totalContainers' => $this->totalContainers,
+            'runningContainers' => $this->runningContainers,
+            'stoppedContainers' => $this->stoppedContainers,
+            'containers' => $this->containers,
+            'lastUpdated' => $this->lastUpdated,
+        ];
+    }
+}
+
diff --git a/src/Application/LiveComponents/Dashboard/HealthStatusComponent.php b/src/Application/LiveComponents/Dashboard/HealthStatusComponent.php
new file mode 100644
index 00000000..30460c2d
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/HealthStatusComponent.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Framework\Health\HealthCheckManager;
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\Attributes\LiveComponent;
+use App\Framework\LiveComponents\Contracts\LiveComponentContract;
+use App\Framework\LiveComponents\Contracts\Pollable;
+use App\Framework\LiveComponents\ValueObjects\ComponentId;
+use App\Framework\LiveComponents\ValueObjects\ComponentRenderData;
+use App\Framework\View\Table\Generators\HealthCheckTableGenerator;
+
+/**
+ * Health Status LiveComponent
+ *
+ * Displays real-time system health status:
+ * - Overall health status
+ * - Individual health check results
+ * - Health check statistics
+ *
+ * Polls every 5 seconds for real-time monitoring.
+ */
+#[LiveComponent('health-status')]
+final readonly class HealthStatusComponent implements LiveComponentContract, Pollable
+{
+    public function __construct(
+        public ComponentId $id,
+        public HealthStatusState $state,
+        private HealthCheckManager $healthManager,
+        private HealthCheckTableGenerator $tableGenerator
+    ) {}
+
+    public function getRenderData(): ComponentRenderData
+    {
+        // Initial poll if state is empty (lastUpdated is empty string)
+        $state = $this->state->lastUpdated === ''
+            ? $this->poll()
+            : $this->state;
+
+        // Generate table for health checks
+        $healthCheckTable = $this->tableGenerator->generate($state->healthChecks);
+
+        return new ComponentRenderData(
+            templatePath: 'livecomponent-health-status',
+            data: [
+                // LiveComponent integration
+                'componentId' => $this->id->toString(),
+                'stateJson' => json_encode($state->toArray()),
+                'pollInterval' => $this->getPollInterval(),
+
+                // Component data
+                'overallStatus' => $state->overallStatus,
+                'totalChecks' => $state->totalChecks,
+                'healthyChecks' => $state->healthyChecks,
+                'warningChecks' => $state->warningChecks,
+                'failedChecks' => $state->failedChecks,
+                'healthChecks' => $state->healthChecks,
+                'healthCheckTable' => $healthCheckTable,
+                'lastUpdated' => $state->lastUpdated,
+            ]
+        );
+    }
+
+    #[Action]
+    public function poll(): HealthStatusState
+    {
+        // Run all health checks
+        $healthReport = $this->healthManager->runAllChecks();
+
+        // Convert HealthReport to array format for template
+        $healthChecks = [];
+        foreach ($healthReport->results as $componentName => $result) {
+            $statusText = match ($result->status->value) {
+                'healthy' => 'healthy',
+                'warning' => 'warning',
+                'unhealthy' => 'unhealthy',
+                default => 'unknown',
+            };
+
+            $statusClass = match ($result->status->value) {
+                'healthy' => 'success',
+                'warning' => 'warning',
+                'unhealthy' => 'danger',
+                default => 'secondary',
+            };
+
+            $healthChecks[] = [
+                'componentName' => $componentName,
+                'status' => $result->status->value,
+                'statusText' => $statusText,
+                'statusClass' => $statusClass,
+                'message' => $result->message->toString(),
+                'responseTime' => $result->responseTime?->toString(),
+            ];
+        }
+
+        return $this->state->withHealthChecks(
+            overallStatus: $healthReport->overallStatus->value,
+            healthChecks: $healthChecks
+        );
+    }
+
+    public function getPollInterval(): int
+    {
+        return 5000; // Poll every 5 seconds for real-time updates
+    }
+}
+
diff --git a/src/Application/LiveComponents/Dashboard/HealthStatusState.php b/src/Application/LiveComponents/Dashboard/HealthStatusState.php
new file mode 100644
index 00000000..ec71a069
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/HealthStatusState.php
@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Application\LiveComponents\LiveComponentState;
+
+/**
+ * Type-safe state for HealthStatusComponent
+ *
+ * Provides real-time health check status and metrics.
+ * Immutable value object - transformations return new instances.
+ */
+final readonly class HealthStatusState implements LiveComponentState
+{
+    /**
+     * @param array<int, array{componentName: string, status: string, statusText: string, statusClass: string, message: string, responseTime: string|null}> $healthChecks
+     */
+    public function __construct(
+        public string $overallStatus = 'HEALTHY',
+        public int $totalChecks = 0,
+        public int $healthyChecks = 0,
+        public int $warningChecks = 0,
+        public int $failedChecks = 0,
+        public array $healthChecks = [],
+        public string $lastUpdated = ''
+    ) {}
+
+    /**
+     * Create from array data (from client or storage)
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            overallStatus: (string) ($data['overallStatus'] ?? $data['overall_status'] ?? 'HEALTHY'),
+            totalChecks: (int) ($data['totalChecks'] ?? $data['total_checks'] ?? 0),
+            healthyChecks: (int) ($data['healthyChecks'] ?? $data['healthy_checks'] ?? 0),
+            warningChecks: (int) ($data['warningChecks'] ?? $data['warning_checks'] ?? 0),
+            failedChecks: (int) ($data['failedChecks'] ?? $data['failed_checks'] ?? 0),
+            healthChecks: (array) ($data['healthChecks'] ?? $data['health_checks'] ?? []),
+            lastUpdated: (string) ($data['lastUpdated'] ?? $data['last_updated'] ?? '')
+        );
+    }
+
+    /**
+     * Create empty state with defaults
+     */
+    public static function empty(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Update with fresh health check data
+     *
+     * @param array<int, array{componentName: string, status: string, statusText: string, statusClass: string, message: string, responseTime: string|null}> $healthChecks
+     */
+    public function withHealthChecks(
+        string $overallStatus,
+        array $healthChecks
+    ): self {
+        $healthyCount = 0;
+        $warningCount = 0;
+        $failedCount = 0;
+
+        foreach ($healthChecks as $check) {
+            $status = $check['status'] ?? $check['statusText'] ?? 'unknown';
+            if ($status === 'healthy' || $status === 'HEALTHY' || ($check['statusClass'] ?? '') === 'success') {
+                $healthyCount++;
+            } elseif ($status === 'warning' || $status === 'WARNING' || ($check['statusClass'] ?? '') === 'warning') {
+                $warningCount++;
+            } else {
+                $failedCount++;
+            }
+        }
+
+        return new self(
+            overallStatus: $overallStatus,
+            totalChecks: count($healthChecks),
+            healthyChecks: $healthyCount,
+            warningChecks: $warningCount,
+            failedChecks: $failedCount,
+            healthChecks: $healthChecks,
+            lastUpdated: date('H:i:s')
+        );
+    }
+
+    /**
+     * Update timestamp
+     */
+    public function withLastUpdated(string $timestamp): self
+    {
+        return new self(
+            overallStatus: $this->overallStatus,
+            totalChecks: $this->totalChecks,
+            healthyChecks: $this->healthyChecks,
+            warningChecks: $this->warningChecks,
+            failedChecks: $this->failedChecks,
+            healthChecks: $this->healthChecks,
+            lastUpdated: $timestamp
+        );
+    }
+
+    /**
+     * Convert to array for template rendering
+     */
+    public function toArray(): array
+    {
+        return [
+            'overallStatus' => $this->overallStatus,
+            'totalChecks' => $this->totalChecks,
+            'healthyChecks' => $this->healthyChecks,
+            'warningChecks' => $this->warningChecks,
+            'failedChecks' => $this->failedChecks,
+            'healthChecks' => $this->healthChecks,
+            'lastUpdated' => $this->lastUpdated,
+        ];
+    }
+}
+
diff --git a/src/Application/LiveComponents/Dashboard/PerformanceMetricsComponent.php b/src/Application/LiveComponents/Dashboard/PerformanceMetricsComponent.php
new file mode 100644
index 00000000..13972547
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/PerformanceMetricsComponent.php
@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Framework\Core\ValueObjects\Byte;
+use App\Framework\Core\ValueObjects\Percentage;
+use App\Framework\DateTime\Clock;
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\Attributes\LiveComponent;
+use App\Framework\LiveComponents\Contracts\LiveComponentContract;
+use App\Framework\LiveComponents\Contracts\Pollable;
+use App\Framework\LiveComponents\ValueObjects\ComponentId;
+use App\Framework\LiveComponents\ValueObjects\ComponentRenderData;
+use App\Framework\Performance\MemoryMonitor;
+
+/**
+ * Performance Metrics LiveComponent
+ *
+ * Displays real-time performance metrics:
+ * - Memory usage (current, peak, limit, percentage)
+ * - Load average
+ * - Execution time
+ * - OPCache statistics
+ *
+ * Polls every 3 seconds for real-time monitoring.
+ */
+#[LiveComponent('performance-metrics')]
+final readonly class PerformanceMetricsComponent implements LiveComponentContract, Pollable
+{
+    public function __construct(
+        public ComponentId $id,
+        public PerformanceMetricsState $state,
+        private MemoryMonitor $memoryMonitor,
+        private Clock $clock
+    ) {}
+
+    public function getRenderData(): ComponentRenderData
+    {
+        // Initial poll if state is empty (lastUpdated is empty string)
+        $state = $this->state->lastUpdated === ''
+            ? $this->poll()
+            : $this->state;
+
+        return new ComponentRenderData(
+            templatePath: 'livecomponent-performance-metrics',
+            data: [
+                // LiveComponent integration
+                'componentId' => $this->id->toString(),
+                'stateJson' => json_encode($state->toArray()),
+                'pollInterval' => $this->getPollInterval(),
+
+                // Component data
+                'currentMemory' => $state->currentMemory,
+                'peakMemory' => $state->peakMemory,
+                'memoryLimit' => $state->memoryLimit,
+                'memoryUsagePercentage' => $state->memoryUsagePercentage,
+                'loadAverage' => $state->loadAverage,
+                'executionTime' => $state->executionTime,
+                'includedFiles' => $state->includedFiles,
+                'opcacheEnabled' => $state->opcacheEnabled,
+                'opcacheMemoryUsage' => $state->opcacheMemoryUsage,
+                'opcacheCacheHits' => $state->opcacheCacheHits,
+                'opcacheMissRate' => $state->opcacheMissRate,
+                'lastUpdated' => $state->lastUpdated,
+            ]
+        );
+    }
+
+    #[Action]
+    public function poll(): PerformanceMetricsState
+    {
+        // Get memory metrics
+        $currentMemory = $this->memoryMonitor->getCurrentMemory();
+        $peakMemory = $this->memoryMonitor->getPeakMemory();
+        $memoryLimit = $this->memoryMonitor->getMemoryLimit();
+        $usagePercentage = $this->memoryMonitor->getMemoryUsagePercentage();
+
+        // Get load average
+        $loadAverage = function_exists('sys_getloadavg') ? sys_getloadavg() : ['N/A', 'N/A', 'N/A'];
+
+        // Calculate execution time
+        $executionTime = number_format(
+            microtime(true) - ($_SERVER['REQUEST_TIME_FLOAT'] ?? microtime(true)),
+            4
+        ) . ' Sekunden';
+
+        // Get included files count
+        $includedFiles = count(get_included_files());
+
+        // Check OPCache status
+        $opcacheEnabled = function_exists('opcache_get_status');
+        $opcacheMemoryUsage = null;
+        $opcacheCacheHits = null;
+        $opcacheMissRate = null;
+
+        if ($opcacheEnabled) {
+            try {
+                $opcacheStatus = opcache_get_status(false);
+                if ($opcacheStatus !== false) {
+                    $memoryUsed = Byte::fromBytes($opcacheStatus['memory_usage']['used_memory']);
+                    $opcacheMemoryUsage = $memoryUsed->toHumanReadable();
+                    $opcacheCacheHits = number_format($opcacheStatus['opcache_statistics']['hits']);
+
+                    $hits = $opcacheStatus['opcache_statistics']['hits'];
+                    $misses = $opcacheStatus['opcache_statistics']['misses'];
+                    $total = $hits + $misses;
+                    if ($total > 0) {
+                        $missRate = Percentage::from(($misses / $total) * 100);
+                        $opcacheMissRate = $missRate->format(2) . '%';
+                    }
+                }
+            } catch (\Throwable) {
+                // Ignore errors
+            }
+        }
+
+        return $this->state->withMetrics(
+            currentMemory: $currentMemory->toHumanReadable(),
+            peakMemory: $peakMemory->toHumanReadable(),
+            memoryLimit: $memoryLimit->toHumanReadable(),
+            memoryUsagePercentage: (float) $usagePercentage->format(2),
+            loadAverage: $loadAverage,
+            executionTime: $executionTime,
+            includedFiles: $includedFiles,
+            opcacheEnabled: $opcacheEnabled,
+            opcacheMemoryUsage: $opcacheMemoryUsage,
+            opcacheCacheHits: $opcacheCacheHits,
+            opcacheMissRate: $opcacheMissRate
+        );
+    }
+
+    public function getPollInterval(): int
+    {
+        return 3000; // Poll every 3 seconds for real-time updates
+    }
+}
+
diff --git a/src/Application/LiveComponents/Dashboard/PerformanceMetricsState.php b/src/Application/LiveComponents/Dashboard/PerformanceMetricsState.php
new file mode 100644
index 00000000..9c969776
--- /dev/null
+++ b/src/Application/LiveComponents/Dashboard/PerformanceMetricsState.php
@@ -0,0 +1,140 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Dashboard;
+
+use App\Application\LiveComponents\LiveComponentState;
+
+/**
+ * Type-safe state for PerformanceMetricsComponent
+ *
+ * Provides real-time performance metrics:
+ * - Memory usage (current, peak, limit, percentage)
+ * - Load average
+ * - Execution time
+ * - OPCache statistics
+ *
+ * Immutable value object - transformations return new instances.
+ */
+final readonly class PerformanceMetricsState implements LiveComponentState
+{
+    public function __construct(
+        public string $currentMemory = '',
+        public string $peakMemory = '',
+        public string $memoryLimit = '',
+        public float $memoryUsagePercentage = 0.0,
+        public array $loadAverage = [],
+        public string $executionTime = '',
+        public int $includedFiles = 0,
+        public bool $opcacheEnabled = false,
+        public ?string $opcacheMemoryUsage = null,
+        public ?string $opcacheCacheHits = null,
+        public ?string $opcacheMissRate = null,
+        public string $lastUpdated = ''
+    ) {}
+
+    /**
+     * Create from array data (from client or storage)
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            currentMemory: (string) ($data['currentMemory'] ?? $data['current_memory'] ?? ''),
+            peakMemory: (string) ($data['peakMemory'] ?? $data['peak_memory'] ?? ''),
+            memoryLimit: (string) ($data['memoryLimit'] ?? $data['memory_limit'] ?? ''),
+            memoryUsagePercentage: (float) ($data['memoryUsagePercentage'] ?? $data['memory_usage_percentage'] ?? 0.0),
+            loadAverage: (array) ($data['loadAverage'] ?? $data['load_average'] ?? []),
+            executionTime: (string) ($data['executionTime'] ?? $data['execution_time'] ?? ''),
+            includedFiles: (int) ($data['includedFiles'] ?? $data['included_files'] ?? 0),
+            opcacheEnabled: (bool) ($data['opcacheEnabled'] ?? $data['opcache_enabled'] ?? false),
+            opcacheMemoryUsage: isset($data['opcacheMemoryUsage']) ? (string) $data['opcacheMemoryUsage'] : (isset($data['opcache_memory_usage']) ? (string) $data['opcache_memory_usage'] : null),
+            opcacheCacheHits: isset($data['opcacheCacheHits']) ? (string) $data['opcacheCacheHits'] : (isset($data['opcache_cache_hits']) ? (string) $data['opcache_cache_hits'] : null),
+            opcacheMissRate: isset($data['opcacheMissRate']) ? (string) $data['opcacheMissRate'] : (isset($data['opcache_miss_rate']) ? (string) $data['opcache_miss_rate'] : null),
+            lastUpdated: (string) ($data['lastUpdated'] ?? $data['last_updated'] ?? '')
+        );
+    }
+
+    /**
+     * Create empty state with defaults
+     */
+    public static function empty(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Update with fresh performance metrics
+     */
+    public function withMetrics(
+        string $currentMemory,
+        string $peakMemory,
+        string $memoryLimit,
+        float $memoryUsagePercentage,
+        array $loadAverage,
+        string $executionTime,
+        int $includedFiles,
+        bool $opcacheEnabled,
+        ?string $opcacheMemoryUsage = null,
+        ?string $opcacheCacheHits = null,
+        ?string $opcacheMissRate = null
+    ): self {
+        return new self(
+            currentMemory: $currentMemory,
+            peakMemory: $peakMemory,
+            memoryLimit: $memoryLimit,
+            memoryUsagePercentage: $memoryUsagePercentage,
+            loadAverage: $loadAverage,
+            executionTime: $executionTime,
+            includedFiles: $includedFiles,
+            opcacheEnabled: $opcacheEnabled,
+            opcacheMemoryUsage: $opcacheMemoryUsage,
+            opcacheCacheHits: $opcacheCacheHits,
+            opcacheMissRate: $opcacheMissRate,
+            lastUpdated: date('H:i:s')
+        );
+    }
+
+    /**
+     * Update timestamp
+     */
+    public function withLastUpdated(string $timestamp): self
+    {
+        return new self(
+            currentMemory: $this->currentMemory,
+            peakMemory: $this->peakMemory,
+            memoryLimit: $this->memoryLimit,
+            memoryUsagePercentage: $this->memoryUsagePercentage,
+            loadAverage: $this->loadAverage,
+            executionTime: $this->executionTime,
+            includedFiles: $this->includedFiles,
+            opcacheEnabled: $this->opcacheEnabled,
+            opcacheMemoryUsage: $this->opcacheMemoryUsage,
+            opcacheCacheHits: $this->opcacheCacheHits,
+            opcacheMissRate: $this->opcacheMissRate,
+            lastUpdated: $timestamp
+        );
+    }
+
+    /**
+     * Convert to array for template rendering
+     */
+    public function toArray(): array
+    {
+        return [
+            'currentMemory' => $this->currentMemory,
+            'peakMemory' => $this->peakMemory,
+            'memoryLimit' => $this->memoryLimit,
+            'memoryUsagePercentage' => $this->memoryUsagePercentage,
+            'loadAverage' => $this->loadAverage,
+            'executionTime' => $this->executionTime,
+            'includedFiles' => $this->includedFiles,
+            'opcacheEnabled' => $this->opcacheEnabled,
+            'opcacheMemoryUsage' => $this->opcacheMemoryUsage,
+            'opcacheCacheHits' => $this->opcacheCacheHits,
+            'opcacheMissRate' => $this->opcacheMissRate,
+            'lastUpdated' => $this->lastUpdated,
+        ];
+    }
+}
+
diff --git a/src/Application/LiveComponents/Notification/NotificationComponent.php b/src/Application/LiveComponents/Notification/NotificationComponent.php
new file mode 100644
index 00000000..aa27ab6e
--- /dev/null
+++ b/src/Application/LiveComponents/Notification/NotificationComponent.php
@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Notification;
+
+use App\Framework\LiveComponents\Attributes\Action;
+use App\Framework\LiveComponents\Attributes\LiveComponent;
+use App\Framework\LiveComponents\Contracts\LiveComponentContract;
+use App\Framework\LiveComponents\ValueObjects\ComponentData;
+use App\Framework\LiveComponents\ValueObjects\ComponentId;
+use App\Framework\LiveComponents\ValueObjects\ComponentRenderData;
+
+/**
+ * NotificationComponent - Toast notifications for LiveComponents
+ *
+ * Features:
+ * - Multiple notification types (info, success, warning, error)
+ * - Configurable positions (top-right, top-left, bottom-right, bottom-left)
+ * - Auto-dismiss with configurable duration
+ * - Action buttons
+ * - Icons support
+ */
+#[LiveComponent('notification')]
+final readonly class NotificationComponent implements LiveComponentContract
+{
+    public ComponentId $id;
+
+    public NotificationState $state;
+
+    public function __construct(
+        ComponentId $id,
+        ?ComponentData $initialData = null,
+        string $message = '',
+        string $type = 'info',
+        string $position = 'top-right',
+        int $duration = 5000,
+        bool $isVisible = false,
+        ?string $actionText = null,
+        ?string $actionUrl = null,
+        ?string $icon = null
+    ) {
+        $this->id = $id;
+
+        // If initialData is provided (from state update), use it
+        if ($initialData !== null) {
+            $this->state = NotificationState::fromComponentData($initialData);
+
+            return;
+        }
+
+        // Otherwise, initialize with provided parameters
+        $this->state = new NotificationState(
+            message: $message,
+            type: $type,
+            position: $position,
+            duration: $duration,
+            isVisible: $isVisible,
+            actionText: $actionText,
+            actionUrl: $actionUrl,
+            icon: $icon
+        );
+    }
+
+    public function getRenderData(): ComponentRenderData
+    {
+        return new ComponentRenderData(
+            templatePath: 'livecomponent-notification',
+            data: [
+                'componentId' => $this->id->toString(),
+                'stateJson' => json_encode($this->state->toArray()),
+                'message' => $this->state->message,
+                'type' => $this->state->type,
+                'position' => $this->state->position,
+                'duration' => $this->state->duration,
+                'is_visible' => $this->state->isVisible,
+                'action_text' => $this->state->actionText,
+                'action_url' => $this->state->actionUrl,
+                'icon' => $this->state->icon,
+                'type_class' => $this->state->getTypeClass(),
+                'position_class' => $this->state->getPositionClass(),
+                'has_action' => $this->state->hasAction(),
+            ]
+        );
+    }
+
+    /**
+     * Show notification action
+     * 
+     * @return NotificationState New state
+     */
+    #[Action]
+    public function showNotification(string $message, string $type = 'info'): NotificationState
+    {
+        return $this->state->withMessage($message)->show();
+    }
+
+    /**
+     * Hide notification action
+     * 
+     * @return NotificationState New state
+     */
+    #[Action]
+    public function hide(): NotificationState
+    {
+        return $this->state->hide();
+    }
+
+    /**
+     * Handle action button click
+     * 
+     * @return NotificationState New state
+     */
+    #[Action]
+    public function handleAction(string $actionUrl): NotificationState
+    {
+        // Hide notification after action
+        return $this->state->hide();
+    }
+}
+
diff --git a/src/Application/LiveComponents/Notification/NotificationState.php b/src/Application/LiveComponents/Notification/NotificationState.php
new file mode 100644
index 00000000..c9d2ff45
--- /dev/null
+++ b/src/Application/LiveComponents/Notification/NotificationState.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Application\LiveComponents\Notification;
+
+use App\Application\LiveComponents\LiveComponentState;
+use App\Framework\LiveComponents\ValueObjects\ComponentData;
+
+/**
+ * Type-safe state for NotificationComponent
+ *
+ * Provides compile-time type safety for notification functionality.
+ * All properties are readonly and immutable - transformations return new instances.
+ */
+final readonly class NotificationState implements LiveComponentState
+{
+    public function __construct(
+        public string $message = '',
+        public string $type = 'info', // info, success, warning, error
+        public string $position = 'top-right', // top-right, top-left, bottom-right, bottom-left
+        public int $duration = 5000, // milliseconds, 0 = persistent
+        public bool $isVisible = false,
+        public ?string $actionText = null,
+        public ?string $actionUrl = null,
+        public ?string $icon = null
+    ) {
+    }
+
+    /**
+     * Create from ComponentData (Framework → Domain conversion)
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            message: (string) ($data['message'] ?? ''),
+            type: (string) ($data['type'] ?? 'info'),
+            position: (string) ($data['position'] ?? 'top-right'),
+            duration: (int) ($data['duration'] ?? 5000),
+            isVisible: (bool) ($data['is_visible'] ?? false),
+            actionText: isset($data['action_text']) ? (string) $data['action_text'] : null,
+            actionUrl: isset($data['action_url']) ? (string) $data['action_url'] : null,
+            icon: isset($data['icon']) ? (string) $data['icon'] : null
+        );
+    }
+
+    /**
+     * Create empty state with defaults
+     */
+    public static function empty(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Convert to ComponentData (Domain → Framework conversion)
+     */
+    public function toArray(): array
+    {
+        return [
+            'message' => $this->message,
+            'type' => $this->type,
+            'position' => $this->position,
+            'duration' => $this->duration,
+            'is_visible' => $this->isVisible,
+            'action_text' => $this->actionText,
+            'action_url' => $this->actionUrl,
+            'icon' => $this->icon,
+        ];
+    }
+
+    /**
+     * Create notification with message
+     */
+    public function withMessage(string $message): self
+    {
+        return new self(
+            message: $message,
+            type: $this->type,
+            position: $this->position,
+            duration: $this->duration,
+            isVisible: true,
+            actionText: $this->actionText,
+            actionUrl: $this->actionUrl,
+            icon: $this->icon
+        );
+    }
+
+    /**
+     * Show notification
+     */
+    public function show(): self
+    {
+        return new self(
+            message: $this->message,
+            type: $this->type,
+            position: $this->position,
+            duration: $this->duration,
+            isVisible: true,
+            actionText: $this->actionText,
+            actionUrl: $this->actionUrl,
+            icon: $this->icon
+        );
+    }
+
+    /**
+     * Hide notification
+     */
+    public function hide(): self
+    {
+        return new self(
+            message: $this->message,
+            type: $this->type,
+            position: $this->position,
+            duration: $this->duration,
+            isVisible: false,
+            actionText: $this->actionText,
+            actionUrl: $this->actionUrl,
+            icon: $this->icon
+        );
+    }
+
+    /**
+     * Get CSS class for notification type
+     */
+    public function getTypeClass(): string
+    {
+        return "notification--{$this->type}";
+    }
+
+    /**
+     * Get CSS class for position
+     */
+    public function getPositionClass(): string
+    {
+        return "notification--{$this->position}";
+    }
+
+    /**
+     * Check if notification has action
+     */
+    public function hasAction(): bool
+    {
+        return $this->actionText !== null && $this->actionUrl !== null;
+    }
+}
+
diff --git a/src/Application/Website/ShowHome.php b/src/Application/Website/ShowHome.php
index 10d2d0ce..26db3cf1 100644
--- a/src/Application/Website/ShowHome.php
+++ b/src/Application/Website/ShowHome.php
@@ -17,7 +17,6 @@ final readonly class ShowHome
     #[Route(path: '/', method: Method::GET, name: WebRoutes::HOME)]
     public function home(HomeRequest $request, string $test = 'hallo'): ViewResult
     {
-        throw new \Exception('test');
 
         // Production deployment trigger - scp from /workspace/repo
         $model = new HomeViewModel('Hallo Welt!');
diff --git a/src/Application/Website/ShowImpressum.php b/src/Application/Website/ShowImpressum.php
index 74a8fb30..85f1f35a 100644
--- a/src/Application/Website/ShowImpressum.php
+++ b/src/Application/Website/ShowImpressum.php
@@ -17,14 +17,8 @@ final readonly class ShowImpressum
     #[Route(path: '/impressum', name: WebRoutes::IMPRESSUM)]
     public function impressum(): ViewResult
     {
-        // Media cleanup logic moved to App\Application\Media\MediaCleanupService
-        // This eliminates the 600ms+ performance issue caused by:
-        // - RecursiveDirectoryIterator over all files
-        // - Database queries for every file
-        // - File system operations during web request
-
         return new ViewResult(
-            'impressum',
+            'test',
             new StaticPageMetaResolver(
                 'Impressum',
                 'Hallo Welt!',
diff --git a/src/Domain/AI/Exception/AiProviderUnavailableException.php b/src/Domain/AI/Exception/AiProviderUnavailableException.php
index 4fa76696..7fe9778f 100644
--- a/src/Domain/AI/Exception/AiProviderUnavailableException.php
+++ b/src/Domain/AI/Exception/AiProviderUnavailableException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Domain\AI\Exception;
 
 use App\Domain\AI\AiProvider;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 class AiProviderUnavailableException extends FrameworkException
@@ -19,12 +18,7 @@ class AiProviderUnavailableException extends FrameworkException
 
         parent::__construct(
             message: $message,
-            context: ExceptionContext::forOperation('ai_provider_connection', 'AI')
-                ->withData([
-                    'provider' => $provider->value,
-                    'reason' => $reason,
-                    'unavailable' => true,
-                ])
+            code: 0
         );
     }
 }
diff --git a/src/Domain/Asset/Commands/ProcessDerivatCommand.php b/src/Domain/Asset/Commands/ProcessDerivatCommand.php
new file mode 100644
index 00000000..5cd974bd
--- /dev/null
+++ b/src/Domain/Asset/Commands/ProcessDerivatCommand.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Commands;
+
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Framework\CommandBus\ShouldQueue;
+
+#[ShouldQueue]
+final readonly class ProcessDerivatCommand
+{
+    public function __construct(
+        public AssetId $assetId
+    ) {
+    }
+
+    public static function forAsset(AssetId $assetId): self
+    {
+        return new self($assetId);
+    }
+}
+
diff --git a/src/Domain/Asset/Commands/ProcessDerivatCommandHandler.php b/src/Domain/Asset/Commands/ProcessDerivatCommandHandler.php
new file mode 100644
index 00000000..bbfaac38
--- /dev/null
+++ b/src/Domain/Asset/Commands/ProcessDerivatCommandHandler.php
@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Commands;
+
+use App\Domain\Asset\Pipeline\DerivatPipelineRegistry;
+use App\Domain\Asset\Repositories\AssetRepository;
+use App\Domain\Asset\Repositories\AssetVariantRepository;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+use App\Framework\CommandBus\CommandHandler;
+use App\Framework\Logging\Logger;
+
+final readonly class ProcessDerivatCommandHandler
+{
+    public function __construct(
+        private AssetRepository $assetRepository,
+        private AssetVariantRepository $assetVariantRepository,
+        private AssetStorageInterface $storage,
+        private DerivatPipelineRegistry $pipelineRegistry,
+        private Logger $logger
+    ) {
+    }
+
+    #[CommandHandler]
+    public function handle(ProcessDerivatCommand $command): void
+    {
+        $asset = $this->assetRepository->findById($command->assetId);
+        if ($asset === null) {
+            $this->logger->warning('Asset not found for derivat processing', [
+                'asset_id' => $command->assetId->toString(),
+            ]);
+
+            return;
+        }
+
+        $pipeline = $this->pipelineRegistry->getPipelineForAsset($asset);
+        if ($pipeline === null) {
+            $this->logger->info('No pipeline found for asset type', [
+                'asset_id' => $asset->id->toString(),
+                'mime' => $asset->mime->value,
+            ]);
+
+            return;
+        }
+
+        try {
+            // Get asset content from storage
+            $content = $this->storage->get($asset);
+
+            // Process asset through pipeline
+            $variants = $pipeline->process($asset, $content, $this->storage);
+
+            // Save variants to database
+            foreach ($variants as $variant) {
+                $this->assetVariantRepository->save($variant);
+            }
+
+            $this->logger->info('Asset derivat processing completed', [
+                'asset_id' => $asset->id->toString(),
+                'variants_count' => count($variants),
+            ]);
+        } catch (\Throwable $e) {
+            $this->logger->error('Asset derivat processing failed', [
+                'asset_id' => $asset->id->toString(),
+                'error' => $e->getMessage(),
+                'trace' => $e->getTraceAsString(),
+            ]);
+
+            throw $e;
+        }
+    }
+}
+
diff --git a/src/Domain/Asset/DI/AssetServiceInitializer.php b/src/Domain/Asset/DI/AssetServiceInitializer.php
new file mode 100644
index 00000000..a21f26d4
--- /dev/null
+++ b/src/Domain/Asset/DI/AssetServiceInitializer.php
@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\DI;
+
+use App\Domain\Asset\Commands\ProcessDerivatCommandHandler;
+use App\Domain\Asset\Pipeline\DerivatPipelineRegistry;
+use App\Domain\Asset\Pipeline\ImageDerivatPipeline;
+use App\Domain\Asset\Repositories\AssetRepository;
+use App\Domain\Asset\Repositories\AssetTagRepository;
+use App\Domain\Asset\Repositories\AssetVariantRepository;
+use App\Domain\Asset\Repositories\DatabaseAssetRepository;
+use App\Domain\Asset\Repositories\DatabaseAssetTagRepository;
+use App\Domain\Asset\Repositories\DatabaseAssetVariantRepository;
+use App\Domain\Asset\Services\AssetService;
+use App\Domain\Asset\Services\DeduplicationService;
+use App\Domain\Asset\Services\MetadataExtractor;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+use App\Domain\Asset\Storage\ObjectStorageAdapterFactory;
+use App\Framework\CommandBus\CommandBus;
+use App\Framework\Config\Environment;
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+use App\Framework\DateTime\Clock;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+final readonly class AssetServiceInitializer
+{
+    #[Initializer]
+    public function __invoke(Container $container): void
+    {
+        // Storage Adapter
+        $container->singleton(
+            AssetStorageInterface::class,
+            fn (Container $c) => $c->get(ObjectStorageAdapterFactory::class)->create()
+        );
+
+        $container->singleton(
+            ObjectStorageAdapterFactory::class,
+            fn (Container $c) => new ObjectStorageAdapterFactory(
+                storageInitializer: $c->get(\App\Framework\Storage\StorageInitializer::class),
+                environment: $c->get(Environment::class)
+            )
+        );
+
+        // Repositories
+        $container->singleton(
+            AssetRepository::class,
+            fn (Container $c) => new DatabaseAssetRepository(
+                connection: $c->get(\App\Framework\Database\ConnectionInterface::class)
+            )
+        );
+
+        $container->singleton(
+            AssetVariantRepository::class,
+            fn (Container $c) => new DatabaseAssetVariantRepository(
+                connection: $c->get(\App\Framework\Database\ConnectionInterface::class)
+            )
+        );
+
+        $container->singleton(
+            AssetTagRepository::class,
+            fn (Container $c) => new DatabaseAssetTagRepository(
+                connection: $c->get(\App\Framework\Database\ConnectionInterface::class)
+            )
+        );
+
+        // Services
+        $container->singleton(
+            MetadataExtractor::class,
+            fn () => new MetadataExtractor()
+        );
+
+        $container->singleton(
+            DeduplicationService::class,
+            fn (Container $c) => new DeduplicationService(
+                assetRepository: $c->get(AssetRepository::class)
+            )
+        );
+
+        // Derivat Pipeline Registry
+        $container->singleton(
+            DerivatPipelineRegistry::class,
+            function (Container $c) {
+                $env = $c->get(Environment::class);
+                $variantBucket = BucketName::fromString($env->get('ASSET_VARIANT_BUCKET', 'variants'));
+
+                $registry = new DerivatPipelineRegistry();
+                $registry->register(new ImageDerivatPipeline($variantBucket));
+
+                return $registry;
+            }
+        );
+
+        // Asset Service
+        $container->singleton(
+            AssetService::class,
+            fn (Container $c) => new AssetService(
+                assetRepository: $c->get(AssetRepository::class),
+                assetVariantRepository: $c->get(AssetVariantRepository::class),
+                assetTagRepository: $c->get(AssetTagRepository::class),
+                storage: $c->get(AssetStorageInterface::class),
+                deduplicationService: $c->get(DeduplicationService::class),
+                metadataExtractor: $c->get(MetadataExtractor::class),
+                commandBus: $c->get(CommandBus::class),
+                clock: $c->get(Clock::class)
+            )
+        );
+
+        // Command Handler
+        $container->singleton(
+            ProcessDerivatCommandHandler::class,
+            fn (Container $c) => new ProcessDerivatCommandHandler(
+                assetRepository: $c->get(AssetRepository::class),
+                assetVariantRepository: $c->get(AssetVariantRepository::class),
+                storage: $c->get(AssetStorageInterface::class),
+                pipelineRegistry: $c->get(DerivatPipelineRegistry::class),
+                logger: $c->get(\App\Framework\Logging\Logger::class)
+            )
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Entities/Asset.php b/src/Domain/Asset/Entities/Asset.php
new file mode 100644
index 00000000..e4cca406
--- /dev/null
+++ b/src/Domain/Asset/Entities/Asset.php
@@ -0,0 +1,109 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Entities;
+
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Core\ValueObjects\Hash;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\DateTime\Clock;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+use App\Framework\Storage\ValueObjects\ObjectKey;
+
+final readonly class Asset
+{
+    public function __construct(
+        public AssetId $id,
+        public BucketName $bucket,
+        public ObjectKey $key,
+        public MimeType $mime,
+        public FileSize $bytes,
+        public Hash $sha256,
+        public AssetMetadata $meta,
+        public Timestamp $createdAt
+    ) {
+    }
+
+    public static function create(
+        Clock $clock,
+        BucketName $bucket,
+        ObjectKey $key,
+        MimeType $mime,
+        FileSize $bytes,
+        Hash $sha256,
+        AssetMetadata $meta
+    ): self {
+        return new self(
+            id: AssetId::generate($clock),
+            bucket: $bucket,
+            key: $key,
+            mime: $mime,
+            bytes: $bytes,
+            sha256: $sha256,
+            meta: $meta,
+            createdAt: Timestamp::fromClock($clock)
+        );
+    }
+
+    public function withMeta(AssetMetadata $meta): self
+    {
+        return new self(
+            id: $this->id,
+            bucket: $this->bucket,
+            key: $this->key,
+            mime: $this->mime,
+            bytes: $this->bytes,
+            sha256: $this->sha256,
+            meta: $meta,
+            createdAt: $this->createdAt
+        );
+    }
+
+    public function isImage(): bool
+    {
+        return str_starts_with($this->mime->value, 'image/');
+    }
+
+    public function isVideo(): bool
+    {
+        return str_starts_with($this->mime->value, 'video/');
+    }
+
+    public function isAudio(): bool
+    {
+        return str_starts_with($this->mime->value, 'audio/');
+    }
+
+    public function isDocument(): bool
+    {
+        return in_array($this->mime->value, [
+            'application/pdf',
+            'application/msword',
+            'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            'application/vnd.ms-excel',
+            'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        ], true);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id->toString(),
+            'bucket' => $this->bucket->toString(),
+            'key' => $this->key->toString(),
+            'mime' => $this->mime->value,
+            'bytes' => $this->bytes->bytes->toBytes(),
+            'sha256' => $this->sha256->toString(),
+            'meta' => $this->meta->toArray(),
+            'created_at' => $this->createdAt->toIso8601(),
+        ];
+    }
+}
+
diff --git a/src/Domain/Asset/Entities/AssetTag.php b/src/Domain/Asset/Entities/AssetTag.php
new file mode 100644
index 00000000..a503c0b5
--- /dev/null
+++ b/src/Domain/Asset/Entities/AssetTag.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Entities;
+
+use App\Domain\Asset\ValueObjects\AssetId;
+
+final readonly class AssetTag
+{
+    public function __construct(
+        public AssetId $assetId,
+        public string $tag
+    ) {
+        if (empty($tag)) {
+            throw new \InvalidArgumentException('Tag cannot be empty');
+        }
+
+        if (strlen($tag) > 100) {
+            throw new \InvalidArgumentException('Tag cannot exceed 100 characters');
+        }
+
+        // Tags should be lowercase alphanumeric with hyphens and underscores
+        if (! preg_match('/^[a-z0-9_-]+$/', $tag)) {
+            throw new \InvalidArgumentException('Tag must contain only lowercase letters, numbers, hyphens, and underscores');
+        }
+    }
+
+    public static function create(AssetId $assetId, string $tag): self
+    {
+        return new self(
+            assetId: $assetId,
+            tag: strtolower(trim($tag))
+        );
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function toArray(): array
+    {
+        return [
+            'asset_id' => $this->assetId->toString(),
+            'tag' => $this->tag,
+        ];
+    }
+}
+
diff --git a/src/Domain/Asset/Entities/AssetVariant.php b/src/Domain/Asset/Entities/AssetVariant.php
new file mode 100644
index 00000000..5938e927
--- /dev/null
+++ b/src/Domain/Asset/Entities/AssetVariant.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Entities;
+
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Domain\Asset\ValueObjects\VariantName;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+use App\Framework\Storage\ValueObjects\ObjectKey;
+
+final readonly class AssetVariant
+{
+    public function __construct(
+        public AssetId $assetId,
+        public VariantName $variant,
+        public BucketName $bucket,
+        public ObjectKey $key,
+        public MimeType $mime,
+        public FileSize $bytes,
+        public AssetMetadata $meta
+    ) {
+    }
+
+    public static function create(
+        AssetId $assetId,
+        VariantName $variant,
+        BucketName $bucket,
+        ObjectKey $key,
+        MimeType $mime,
+        FileSize $bytes,
+        AssetMetadata $meta
+    ): self {
+        return new self(
+            assetId: $assetId,
+            variant: $variant,
+            bucket: $bucket,
+            key: $key,
+            mime: $mime,
+            bytes: $bytes,
+            meta: $meta
+        );
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'asset_id' => $this->assetId->toString(),
+            'variant' => $this->variant->toString(),
+            'bucket' => $this->bucket->toString(),
+            'key' => $this->key->toString(),
+            'mime' => $this->mime->value,
+            'bytes' => $this->bytes->bytes->toBytes(),
+            'meta' => $this->meta->toArray(),
+        ];
+    }
+}
+
diff --git a/src/Domain/Asset/Exceptions/AssetNotFoundException.php b/src/Domain/Asset/Exceptions/AssetNotFoundException.php
new file mode 100644
index 00000000..023a03dc
--- /dev/null
+++ b/src/Domain/Asset/Exceptions/AssetNotFoundException.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Exceptions;
+
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class AssetNotFoundException extends FrameworkException
+{
+    public static function forId(AssetId $id): self
+    {
+        return new self(
+            sprintf('Asset with ID "%s" not found', $id->toString()),
+            (int) DatabaseErrorCode::ENTITY_NOT_FOUND->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Migrations/CreateAssetTagsTable.php b/src/Domain/Asset/Migrations/CreateAssetTagsTable.php
new file mode 100644
index 00000000..2e25f1f8
--- /dev/null
+++ b/src/Domain/Asset/Migrations/CreateAssetTagsTable.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateAssetTagsTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('asset_tags', function (Blueprint $table) {
+            $table->string('asset_id', 26)->notNull();
+            $table->string('tag', 100)->notNull();
+
+            $table->primary(['asset_id', 'tag']);
+            $table->foreign('asset_id')->references('id')->on('assets')->onDelete('cascade');
+            $table->index('tag'); // Für Suche/Filter
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+        $schema->dropIfExists('asset_tags');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000012');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create asset_tags table for asset tagging';
+    }
+}
+
diff --git a/src/Domain/Asset/Migrations/CreateAssetVariantsTable.php b/src/Domain/Asset/Migrations/CreateAssetVariantsTable.php
new file mode 100644
index 00000000..0b418c1e
--- /dev/null
+++ b/src/Domain/Asset/Migrations/CreateAssetVariantsTable.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateAssetVariantsTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('asset_variants', function (Blueprint $table) {
+            $table->string('asset_id', 26)->notNull();
+            $table->string('variant', 100)->notNull();
+            $table->string('bucket', 100)->notNull();
+            $table->string('key', 500)->notNull();
+            $table->string('mime', 100)->notNull();
+            $table->bigInteger('bytes')->notNull();
+            $table->json('meta')->nullable(); // JSONB für PostgreSQL, JSON für MySQL
+
+            $table->primary(['asset_id', 'variant']);
+            $table->foreign('asset_id')->references('id')->on('assets')->onDelete('cascade');
+            $table->index('asset_id');
+            $table->index('variant');
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+        $schema->dropIfExists('asset_variants');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000011');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create asset_variants table for asset derivatives';
+    }
+}
+
diff --git a/src/Domain/Asset/Migrations/CreateAssetsTable.php b/src/Domain/Asset/Migrations/CreateAssetsTable.php
new file mode 100644
index 00000000..814b539b
--- /dev/null
+++ b/src/Domain/Asset/Migrations/CreateAssetsTable.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateAssetsTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('assets', function (Blueprint $table) {
+            $table->string('id', 26)->primary(); // ULID
+            $table->string('bucket', 100)->notNull();
+            $table->string('key', 500)->notNull();
+            $table->string('mime', 100)->notNull();
+            $table->bigInteger('bytes')->notNull();
+            $table->string('sha256', 64)->unique()->notNull(); // Für Dedupe
+            $table->json('meta')->nullable(); // JSONB für PostgreSQL, JSON für MySQL
+            $table->timestamp('created_at')->notNull();
+
+            $table->index('bucket');
+            $table->index('sha256');
+            $table->index('created_at');
+            // GIN Index für JSONB Queries (PostgreSQL specific - wird in down() ignoriert)
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+        $schema->dropIfExists('assets');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000010');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create assets table for modern asset management';
+    }
+}
+
diff --git a/src/Domain/Asset/Pipeline/DerivatPipelineInterface.php b/src/Domain/Asset/Pipeline/DerivatPipelineInterface.php
new file mode 100644
index 00000000..8cfd2edb
--- /dev/null
+++ b/src/Domain/Asset/Pipeline/DerivatPipelineInterface.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Pipeline;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+
+interface DerivatPipelineInterface
+{
+    /**
+     * Process an asset and create variants.
+     *
+     * @return \App\Domain\Asset\Entities\AssetVariant[]
+     */
+    public function process(Asset $asset, string $content, AssetStorageInterface $storage): array;
+
+    /**
+     * @return string[] Supported MIME types
+     */
+    public function getSupportedFormats(): array;
+}
+
diff --git a/src/Domain/Asset/Pipeline/DerivatPipelineRegistry.php b/src/Domain/Asset/Pipeline/DerivatPipelineRegistry.php
new file mode 100644
index 00000000..c5b08e2e
--- /dev/null
+++ b/src/Domain/Asset/Pipeline/DerivatPipelineRegistry.php
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Pipeline;
+
+use App\Domain\Asset\Entities\Asset;
+
+final class DerivatPipelineRegistry
+{
+    /** @var array<string, DerivatPipelineInterface> */
+    private array $pipelines = [];
+
+    public function register(DerivatPipelineInterface $pipeline): void
+    {
+        foreach ($pipeline->getSupportedFormats() as $mimeType) {
+            $this->pipelines[$mimeType] = $pipeline;
+        }
+    }
+
+    public function getPipelineForAsset(Asset $asset): ?DerivatPipelineInterface
+    {
+        return $this->pipelines[$asset->mime->value] ?? null;
+    }
+
+    /**
+     * @return DerivatPipelineInterface[]
+     */
+    public function getAllPipelines(): array
+    {
+        return array_unique(array_values($this->pipelines));
+    }
+}
+
diff --git a/src/Domain/Asset/Pipeline/ImageDerivatPipeline.php b/src/Domain/Asset/Pipeline/ImageDerivatPipeline.php
new file mode 100644
index 00000000..861b0e5d
--- /dev/null
+++ b/src/Domain/Asset/Pipeline/ImageDerivatPipeline.php
@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Pipeline;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\Entities\AssetVariant;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Domain\Asset\ValueObjects\ObjectKeyGenerator;
+use App\Domain\Asset\ValueObjects\VariantName;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+final readonly class ImageDerivatPipeline implements DerivatPipelineInterface
+{
+    public function __construct(
+        private BucketName $variantBucket
+    ) {
+    }
+
+    public function process(Asset $asset, string $content, AssetStorageInterface $storage): array
+    {
+        if (! $asset->isImage()) {
+            return [];
+        }
+
+        $variants = [];
+
+        // Generate responsive variants
+        $variants[] = $this->createVariant($asset, $content, '1200w', 1200, MimeType::IMAGE_WEBP, $storage);
+        $variants[] = $this->createVariant($asset, $content, '800w', 800, MimeType::IMAGE_WEBP, $storage);
+
+        // Generate thumbnail variants
+        $variants[] = $this->createVariant($asset, $content, 'thumb@1x', 200, MimeType::IMAGE_WEBP, $storage);
+        $variants[] = $this->createVariant($asset, $content, 'thumb@2x', 400, MimeType::IMAGE_WEBP, $storage);
+
+        return array_filter($variants);
+    }
+
+    public function getSupportedFormats(): array
+    {
+        return [
+            'image/jpeg',
+            'image/png',
+            'image/gif',
+            'image/webp',
+        ];
+    }
+
+    private function createVariant(
+        Asset $asset,
+        string $originalContent,
+        string $variantName,
+        int $maxWidth,
+        MimeType $targetMime,
+        AssetStorageInterface $storage
+    ): ?AssetVariant {
+        try {
+            // Create image resource from content
+            $image = @imagecreatefromstring($originalContent);
+            if ($image === false) {
+                return null;
+            }
+
+            $originalWidth = imagesx($image);
+            $originalHeight = imagesy($image);
+
+            // Calculate new dimensions
+            $ratio = $originalWidth / $originalHeight;
+            $newWidth = min($maxWidth, $originalWidth);
+            $newHeight = (int) ($newWidth / $ratio);
+
+            // Resize image
+            $resized = imagecreatetruecolor($newWidth, $newHeight);
+            imagecopyresampled($resized, $image, 0, 0, 0, 0, $newWidth, $newHeight, $originalWidth, $originalHeight);
+
+            // Convert to WebP and get content
+            ob_start();
+            imagewebp($resized, null, 85);
+            $variantContent = ob_get_clean();
+
+            imagedestroy($image);
+            imagedestroy($resized);
+
+            // Create variant
+            $variantKey = ObjectKeyGenerator::generateVariantKey($asset->id, VariantName::fromString($variantName));
+            $variant = AssetVariant::create(
+                assetId: $asset->id,
+                variant: VariantName::fromString($variantName),
+                bucket: $this->variantBucket,
+                key: $variantKey,
+                mime: $targetMime,
+                bytes: FileSize::fromBytes(strlen($variantContent)),
+                meta: AssetMetadata::empty()
+                    ->withDimensions($newWidth, $newHeight)
+            );
+
+            // Store variant
+            // We need to create a temporary Asset for storage
+            $tempAsset = new Asset(
+                id: $asset->id,
+                bucket: $this->variantBucket,
+                key: $variantKey,
+                mime: $targetMime,
+                bytes: FileSize::fromBytes(strlen($variantContent)),
+                sha256: $asset->sha256, // Use original hash for now
+                meta: $variant->meta,
+                createdAt: $asset->createdAt
+            );
+
+            $storage->put($tempAsset, $variantContent);
+
+            return $variant;
+        } catch (\Throwable $e) {
+            // Log error but continue with other variants
+            return null;
+        }
+    }
+}
+
diff --git a/src/Domain/Asset/README.md b/src/Domain/Asset/README.md
new file mode 100644
index 00000000..0c2400f7
--- /dev/null
+++ b/src/Domain/Asset/README.md
@@ -0,0 +1,526 @@
+# Modern Asset Management System
+
+Ein modernes, CDN-fähiges Asset Management System mit bucket/key Layout, automatischer Derivat-Pipeline und SHA256-basierter Deduplizierung.
+
+## Übersicht
+
+Das Asset Management System bietet:
+
+- **Bucket/Key Layout**: S3-ähnliche Struktur für flexible Asset-Organisation
+- **CDN-fähig**: Unterstützt Filesystem und S3-kompatible Storage-Backends
+- **Automatische Derivat-Pipeline**: Asynchrone Generierung von Varianten (Thumbnails, responsive Images, etc.)
+- **Deduplizierung**: SHA256-basierte Erkennung von Duplikaten
+- **Tag-System**: Flexible Suche und Filterung von Assets
+- **Type-Safe**: Alle Value Objects für maximalen Type-Safety
+- **Immutable**: Alle Entities sind readonly und immutable
+
+## Architektur
+
+### Domain Model
+
+#### Entities
+
+**`Asset`**
+- Repräsentiert ein hochgeladenes Asset
+- Properties:
+  - `AssetId $id` - ULID-basierte eindeutige ID
+  - `BucketName $bucket` - Storage Bucket
+  - `ObjectKey $key` - Storage Key (z.B. `orig/2025/01/15/{ulid}.jpg`)
+  - `MimeType $mime` - MIME-Type des Assets
+  - `FileSize $bytes` - Dateigröße in Bytes
+  - `Hash $sha256` - SHA256 Hash für Deduplizierung
+  - `AssetMetadata $meta` - JSON-Metadaten (width, height, EXIF, etc.)
+  - `Timestamp $createdAt` - Erstellungszeitpunkt
+
+**`AssetVariant`**
+- Repräsentiert eine generierte Variante eines Assets
+- Properties:
+  - `AssetId $assetId` - Referenz zum Original-Asset
+  - `VariantName $variant` - Name der Variante (z.B. `1200w.webp`, `thumb@2x`)
+  - `BucketName $bucket` - Storage Bucket für Variante
+  - `ObjectKey $key` - Storage Key
+  - `MimeType $mime` - MIME-Type der Variante
+  - `FileSize $bytes` - Dateigröße
+  - `AssetMetadata $meta` - Varianten-spezifische Metadaten
+
+**`AssetTag`**
+- Tag für Asset-Kategorisierung
+- Properties:
+  - `AssetId $assetId` - Referenz zum Asset
+  - `string $tag` - Tag-Name (lowercase, alphanumeric mit Unterstrichen)
+
+#### Value Objects
+
+**`AssetId`**
+- ULID-basierte Asset-ID
+- Factory: `AssetId::generate(Clock $clock)`
+- Validation: Prüft ULID-Format
+
+**`AssetMetadata`**
+- Type-safe JSON-Metadaten
+- Unterstützte Felder:
+  - `width`, `height` - Bilddimensionen
+  - `duration` - Video/Audio-Dauer
+  - `exif` - EXIF-Daten (Bilder)
+  - `iptc` - IPTC-Daten
+  - `colorProfile` - Farbprofil
+  - `focalPoint` - Fokuspunkte (x, y)
+  - `dominantColor` - Dominante Farbe (Hex)
+  - `blurhash` - Blurhash für Lazy Loading
+- Factory: `AssetMetadata::empty()`, `AssetMetadata::fromArray(array $data)`
+
+**`VariantName`**
+- Validierter Variantenname
+- Format: `{name}[@{scale}]?[.{ext}]?`
+- Beispiele: `1200w.webp`, `thumb@1x`, `thumb@2x.webp`, `waveform.json`
+- Factory: `VariantName::fromString(string $value)`
+
+**`ObjectKeyGenerator`**
+- Helper für Key-Generierung
+- Methoden:
+  - `generateKey(AssetId $id, string $extension, ?string $prefix = 'orig')` - Original Key
+  - `generateVariantKey(AssetId $id, VariantName $variant, ?string $prefix = 'variants')` - Variant Key
+- Format: `{prefix}/{year}/{month}/{day}/{assetId}.{ext}`
+
+### Storage System
+
+Das Storage-System verwendet das Framework `ObjectStorage` Interface und unterstützt:
+
+- **Filesystem**: Lokale Dateispeicherung
+- **S3/MinIO**: S3-kompatible Storage-Backends
+
+**`AssetStorageInterface`**
+- `put(Asset $asset, string $content): void` - Asset speichern
+- `get(Asset $asset): string` - Asset abrufen
+- `exists(Asset $asset): bool` - Asset existiert?
+- `delete(Asset $asset): void` - Asset löschen
+- `getUrl(Asset $asset): string` - Public URL
+- `getSignedUrl(Asset $asset, int $expiresIn): string` - Temporäre URL
+
+**Konfiguration**
+- Environment Variable: `ASSET_STORAGE_TYPE` (filesystem/s3/minio)
+- Environment Variable: `ASSET_CDN_BASE_URL` (optional, für CDN URLs)
+
+### Derivat Pipeline
+
+Die Derivat-Pipeline generiert automatisch Varianten von Assets:
+
+**`DerivatPipelineInterface`**
+- `process(Asset $asset, string $content, AssetStorageInterface $storage): array` - Erstellt Varianten
+- `getSupportedFormats(): array` - Unterstützte MIME-Types
+
+**`ImageDerivatPipeline`**
+- Generiert automatisch:
+  - Responsive Varianten: `1200w.webp`, `800w.webp`
+  - Thumbnails: `thumb@1x.webp`, `thumb@2x.webp`
+- Konvertiert zu WebP für bessere Kompression
+
+**Asynchrone Verarbeitung**
+- `ProcessDerivatCommand` mit `#[ShouldQueue]` Attribut
+- Wird automatisch über Command Bus gequeued
+- `ProcessDerivatCommandHandler` verarbeitet im Hintergrund
+
+### Deduplizierung
+
+Das System verwendet SHA256-Hashes zur Erkennung von Duplikaten:
+
+- Beim Upload wird SHA256 berechnet
+- `DeduplicationService` prüft auf existierende Assets
+- Wenn Duplikat gefunden: Rückgabe des existierenden Assets
+- Tags werden zum existierenden Asset hinzugefügt
+
+### Metadata Extraction
+
+`MetadataExtractor` extrahiert automatisch Metadaten:
+
+- **Bilder**: Dimensionen, EXIF-Daten (via GD/ext_read_data)
+- **Videos**: Duration (TODO: FFmpeg Integration)
+- **Audio**: Duration (TODO: Audio Library Integration)
+
+## REST API
+
+### Upload Asset
+
+```http
+POST /api/v1/assets/upload
+Content-Type: multipart/form-data
+
+file: [binary]
+bucket: media (optional, default: "media")
+tags: ["hero", "landing-page"] (optional)
+meta: {"width": 1920, "height": 1080} (optional)
+```
+
+**Response:**
+```json
+{
+  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+  "bucket": "media",
+  "key": "orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+  "mime": "image/jpeg",
+  "bytes": 245678,
+  "sha256": "a1b2c3d4...",
+  "meta": {
+    "width": 1920,
+    "height": 1080
+  },
+  "url": "https://cdn.example.com/media/orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+  "variants": [],
+  "tags": ["hero", "landing-page"],
+  "created_at": "2025-01-15T10:30:00Z"
+}
+```
+
+### Get Asset
+
+```http
+GET /api/v1/assets/{id}
+```
+
+**Response:**
+```json
+{
+  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+  "bucket": "media",
+  "key": "orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+  "mime": "image/jpeg",
+  "bytes": 245678,
+  "sha256": "a1b2c3d4...",
+  "meta": {
+    "width": 1920,
+    "height": 1080
+  },
+  "url": "https://cdn.example.com/media/orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+  "variants": [
+    {
+      "variant": "1200w.webp",
+      "url": "https://cdn.example.com/variants/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV/1200w.webp"
+    },
+    {
+      "variant": "thumb@1x.webp",
+      "url": "https://cdn.example.com/variants/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV/thumb@1x.webp"
+    }
+  ],
+  "tags": ["hero", "landing-page"],
+  "created_at": "2025-01-15T10:30:00Z"
+}
+```
+
+### Get Variants
+
+```http
+GET /api/v1/assets/{id}/variants
+```
+
+**Response:**
+```json
+[
+  {
+    "asset_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+    "variant": "1200w.webp",
+    "bucket": "variants",
+    "key": "variants/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV/1200w.webp",
+    "mime": "image/webp",
+    "bytes": 123456,
+    "meta": {
+      "width": 1200,
+      "height": 675
+    },
+    "url": "https://cdn.example.com/variants/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV/1200w.webp"
+  }
+]
+```
+
+### Get Specific Variant
+
+```http
+GET /api/v1/assets/{id}/variants/{variant}
+```
+
+### Get Asset URL
+
+```http
+GET /api/v1/assets/{id}/url
+```
+
+**Response:**
+```json
+{
+  "url": "https://cdn.example.com/media/orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg"
+}
+```
+
+### Get Signed URL
+
+```http
+GET /api/v1/assets/{id}/signed-url?expires=3600
+```
+
+**Response:**
+```json
+{
+  "url": "https://cdn.example.com/media/orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg?signature=..."
+}
+```
+
+### Delete Asset
+
+```http
+DELETE /api/v1/assets/{id}
+```
+
+**Response:** `204 No Content`
+
+### List Assets
+
+```http
+GET /api/v1/assets?bucket=media
+GET /api/v1/assets?tag=hero
+GET /api/v1/assets?bucket=media&tag=hero
+```
+
+**Response:**
+```json
+[
+  {
+    "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+    "bucket": "media",
+    "key": "orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+    "mime": "image/jpeg",
+    "bytes": 245678,
+    "sha256": "a1b2c3d4...",
+    "meta": {},
+    "url": "https://cdn.example.com/media/orig/2025/01/15/01ARZ3NDEKTSV4RRFFQ69G5FAV.jpg",
+    "variants": [],
+    "tags": [],
+    "created_at": "2025-01-15T10:30:00Z"
+  }
+]
+```
+
+## Verwendung
+
+### Asset Upload (Service Layer)
+
+```php
+use App\Domain\Asset\Services\AssetService;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+$assetService = $container->get(AssetService::class);
+
+// Upload Asset
+$asset = $assetService->upload(
+    content: file_get_contents('/path/to/image.jpg'),
+    bucket: BucketName::fromString('media'),
+    mime: MimeType::IMAGE_JPEG,
+    meta: AssetMetadata::empty()
+        ->withDimensions(1920, 1080)
+        ->withExif(['ISO' => 400]),
+    tags: ['hero', 'landing-page']
+);
+
+// Asset abrufen
+$asset = $assetService->findById(AssetId::fromString('01ARZ3NDEKTSV4RRFFQ69G5FAV'));
+
+// Varianten abrufen
+$variants = $assetService->getVariants($asset->id);
+
+// Tags hinzufügen
+$assetService->addTags($asset->id, ['new-tag']);
+
+// Nach Tag suchen
+$assets = $assetService->findByTag('hero');
+
+// Asset löschen
+$assetService->delete($asset->id);
+```
+
+### Custom Derivat Pipeline
+
+```php
+use App\Domain\Asset\Pipeline\DerivatPipelineInterface;
+use App\Domain\Asset\Pipeline\DerivatPipelineRegistry;
+
+final readonly class CustomVideoPipeline implements DerivatPipelineInterface
+{
+    public function process(Asset $asset, string $content, AssetStorageInterface $storage): array
+    {
+        // Video-Varianten generieren
+        // ...
+    }
+
+    public function getSupportedFormats(): array
+    {
+        return ['video/mp4', 'video/webm'];
+    }
+}
+
+// In AssetServiceInitializer registrieren:
+$registry->register(new CustomVideoPipeline());
+```
+
+## Konfiguration
+
+### Environment Variables
+
+```bash
+# Storage Backend
+ASSET_STORAGE_TYPE=filesystem  # oder: s3, minio
+ASSET_CDN_BASE_URL=https://cdn.example.com
+
+# Variant Bucket
+ASSET_VARIANT_BUCKET=variants
+
+# Storage Backend Konfiguration (für S3/MinIO)
+STORAGE_DRIVER=s3  # oder: filesystem, minio
+MINIO_ENDPOINT=http://minio:9000
+MINIO_ACCESS_KEY=minioadmin
+MINIO_SECRET_KEY=minioadmin
+MINIO_REGION=us-east-1
+```
+
+## Datenbank Schema
+
+### `assets` Tabelle
+
+```sql
+CREATE TABLE assets (
+    id VARCHAR(26) PRIMARY KEY,          -- ULID
+    bucket VARCHAR(100) NOT NULL,
+    key VARCHAR(500) NOT NULL,
+    mime VARCHAR(100) NOT NULL,
+    bytes BIGINT NOT NULL,
+    sha256 VARCHAR(64) UNIQUE NOT NULL,  -- Für Dedupe
+    meta JSON,                           -- JSONB in PostgreSQL
+    created_at TIMESTAMP NOT NULL,
+    INDEX idx_bucket (bucket),
+    INDEX idx_sha256 (sha256),
+    INDEX idx_created_at (created_at)
+);
+```
+
+### `asset_variants` Tabelle
+
+```sql
+CREATE TABLE asset_variants (
+    asset_id VARCHAR(26) NOT NULL,
+    variant VARCHAR(100) NOT NULL,
+    bucket VARCHAR(100) NOT NULL,
+    key VARCHAR(500) NOT NULL,
+    mime VARCHAR(100) NOT NULL,
+    bytes BIGINT NOT NULL,
+    meta JSON,
+    PRIMARY KEY (asset_id, variant),
+    FOREIGN KEY (asset_id) REFERENCES assets(id) ON DELETE CASCADE,
+    INDEX idx_asset_id (asset_id),
+    INDEX idx_variant (variant)
+);
+```
+
+### `asset_tags` Tabelle
+
+```sql
+CREATE TABLE asset_tags (
+    asset_id VARCHAR(26) NOT NULL,
+    tag VARCHAR(100) NOT NULL,
+    PRIMARY KEY (asset_id, tag),
+    FOREIGN KEY (asset_id) REFERENCES assets(id) ON DELETE CASCADE,
+    INDEX idx_tag (tag)  -- Für Suche/Filter
+);
+```
+
+## Entwicklung
+
+### Erweiterung der Derivat Pipeline
+
+1. Neue Pipeline-Klasse implementieren:
+```php
+final readonly class VideoDerivatPipeline implements DerivatPipelineInterface
+{
+    public function process(Asset $asset, string $content, AssetStorageInterface $storage): array
+    {
+        // Video-Varianten generieren
+        // ...
+    }
+
+    public function getSupportedFormats(): array
+    {
+        return ['video/mp4', 'video/webm'];
+    }
+}
+```
+
+2. In `AssetServiceInitializer` registrieren:
+```php
+$registry->register(new VideoDerivatPipeline());
+```
+
+### Custom Metadata Extraction
+
+Erweitere `MetadataExtractor` für zusätzliche Metadaten:
+
+```php
+public function extractVideoMetadata(string $content): AssetMetadata
+{
+    // FFmpeg Integration
+    // ...
+}
+```
+
+## Best Practices
+
+1. **Bucket Organisation**: Verwende sinnvolle Bucket-Namen (`media`, `documents`, `user-uploads`)
+2. **Tags**: Verwende konsistente Tag-Namen (lowercase, mit Unterstrichen)
+3. **Varianten**: Definiere Varianten-Namen klar (z.B. `1200w.webp` für 1200px Breite)
+4. **Deduplizierung**: Nutze SHA256-Hashes für automatische Deduplizierung
+5. **CDN**: Konfiguriere CDN-Base-URL für Production-Umgebungen
+6. **Storage**: Verwende S3/MinIO für Production, Filesystem für Development
+
+## Migration von Legacy Assets
+
+Das Legacy Media Modul wird als separate Einheit betrachtet. Für Migration:
+
+1. Erstelle Migrations-Script, das Legacy-Assets lädt
+2. Konvertiere zu neuen Asset-Entities
+3. Berechne SHA256-Hashes
+4. Migriere Metadaten zu `AssetMetadata`
+5. Optionale: Generiere Varianten nachträglich
+
+## Integration mit CMS
+
+Das Asset Management System kann mit dem CMS-Modul integriert werden:
+
+```php
+// In CMS Block Data
+{
+  "type": "image",
+  "data": {
+    "asset_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+    "variant": "1200w.webp",  // Optional
+    "alt": "Hero Image"
+  }
+}
+```
+
+## Troubleshooting
+
+### Varianten werden nicht generiert
+
+1. Prüfe Command Bus Queue: Läuft der Worker?
+2. Prüfe Logs: `ProcessDerivatCommandHandler` Logs
+3. Prüfe Pipeline Registry: Ist Pipeline für MIME-Type registriert?
+
+### Storage-URLs funktionieren nicht
+
+1. Prüfe `ASSET_CDN_BASE_URL` Konfiguration
+2. Prüfe `ObjectStorage::url()` Implementierung
+3. Prüfe Bucket/Key Permissions (für S3)
+
+### Deduplizierung funktioniert nicht
+
+1. Prüfe SHA256-Berechnung: Identisch für identische Dateien?
+2. Prüfe Database Index: `sha256` Index vorhanden?
+3. Prüfe Repository: `findBySha256()` Implementierung
+
diff --git a/src/Domain/Asset/Repositories/AssetRepository.php b/src/Domain/Asset/Repositories/AssetRepository.php
new file mode 100644
index 00000000..785300da
--- /dev/null
+++ b/src/Domain/Asset/Repositories/AssetRepository.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Framework\Core\ValueObjects\Hash;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+interface AssetRepository
+{
+    public function save(Asset $asset): void;
+
+    public function findById(AssetId $id): ?Asset;
+
+    public function findBySha256(Hash $sha256): ?Asset;
+
+    /**
+     * @return Asset[]
+     */
+    public function findByBucket(BucketName $bucket): array;
+
+    public function delete(AssetId $id): void;
+}
+
diff --git a/src/Domain/Asset/Repositories/AssetTagRepository.php b/src/Domain/Asset/Repositories/AssetTagRepository.php
new file mode 100644
index 00000000..fdc06e77
--- /dev/null
+++ b/src/Domain/Asset/Repositories/AssetTagRepository.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\AssetTag;
+use App\Domain\Asset\ValueObjects\AssetId;
+
+interface AssetTagRepository
+{
+    public function addTag(AssetId $assetId, string $tag): void;
+
+    public function removeTag(AssetId $assetId, string $tag): void;
+
+    /**
+     * @param string[] $tags
+     */
+    public function addTags(AssetId $assetId, array $tags): void;
+
+    /**
+     * @param string[] $tags
+     */
+    public function removeTags(AssetId $assetId, array $tags): void;
+
+    /**
+     * @return AssetTag[]
+     */
+    public function findByTag(string $tag): array;
+
+    /**
+     * @return AssetTag[]
+     */
+    public function getTags(AssetId $assetId): array;
+
+    public function deleteByAsset(AssetId $assetId): void;
+}
+
diff --git a/src/Domain/Asset/Repositories/AssetVariantRepository.php b/src/Domain/Asset/Repositories/AssetVariantRepository.php
new file mode 100644
index 00000000..56c9bc4a
--- /dev/null
+++ b/src/Domain/Asset/Repositories/AssetVariantRepository.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\AssetVariant;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\VariantName;
+
+interface AssetVariantRepository
+{
+    public function save(AssetVariant $variant): void;
+
+    /**
+     * @return AssetVariant[]
+     */
+    public function findByAsset(AssetId $assetId): array;
+
+    public function findByAssetAndVariant(AssetId $assetId, VariantName $variant): ?AssetVariant;
+
+    public function deleteByAsset(AssetId $assetId): void;
+}
+
diff --git a/src/Domain/Asset/Repositories/DatabaseAssetRepository.php b/src/Domain/Asset/Repositories/DatabaseAssetRepository.php
new file mode 100644
index 00000000..78b60206
--- /dev/null
+++ b/src/Domain/Asset/Repositories/DatabaseAssetRepository.php
@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Core\ValueObjects\Hash;
+use App\Framework\Core\ValueObjects\HashAlgorithm;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+use App\Framework\Http\CustomMimeType;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+use App\Framework\Storage\ValueObjects\ObjectKey;
+
+final readonly class DatabaseAssetRepository implements AssetRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function save(Asset $asset): void
+    {
+        $sql = 'INSERT INTO assets (id, bucket, key, mime, bytes, sha256, meta, created_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE
+                bucket = VALUES(bucket),
+                key = VALUES(key),
+                mime = VALUES(mime),
+                bytes = VALUES(bytes),
+                sha256 = VALUES(sha256),
+                meta = VALUES(meta)';
+
+        $query = SqlQuery::create($sql, [
+            $asset->id->toString(),
+            $asset->bucket->toString(),
+            $asset->key->toString(),
+            $asset->mime->value,
+            $asset->bytes->bytes->toBytes(),
+            $asset->sha256->toString(),
+            json_encode($asset->meta->toArray(), JSON_THROW_ON_ERROR),
+            $asset->createdAt->format('Y-m-d H:i:s'),
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function findById(AssetId $id): ?Asset
+    {
+        $sql = 'SELECT * FROM assets WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findBySha256(Hash $sha256): ?Asset
+    {
+        $sql = 'SELECT * FROM assets WHERE sha256 = ?';
+        $query = SqlQuery::create($sql, [$sha256->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findByBucket(BucketName $bucket): array
+    {
+        $sql = 'SELECT * FROM assets WHERE bucket = ? ORDER BY created_at DESC';
+        $query = SqlQuery::create($sql, [$bucket->toString()]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function delete(AssetId $id): void
+    {
+        $sql = 'DELETE FROM assets WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $this->connection->execute($query);
+    }
+
+    private function hydrate(array $row): Asset
+    {
+        $metaData = ! empty($row['meta']) ? json_decode($row['meta'], true, 512, JSON_THROW_ON_ERROR) : [];
+        $mimeType = MimeType::tryFrom($row['mime']) ?? CustomMimeType::fromString($row['mime']);
+
+        return new Asset(
+            id: AssetId::fromString($row['id']),
+            bucket: BucketName::fromString($row['bucket']),
+            key: ObjectKey::fromString($row['key']),
+            mime: $mimeType,
+            bytes: FileSize::fromBytes((int) $row['bytes']),
+            sha256: Hash::fromString($row['sha256'], HashAlgorithm::SHA256),
+            meta: AssetMetadata::fromArray($metaData),
+            createdAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['created_at']))
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Repositories/DatabaseAssetTagRepository.php b/src/Domain/Asset/Repositories/DatabaseAssetTagRepository.php
new file mode 100644
index 00000000..108e79c0
--- /dev/null
+++ b/src/Domain/Asset/Repositories/DatabaseAssetTagRepository.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\AssetTag;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class DatabaseAssetTagRepository implements AssetTagRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function addTag(AssetId $assetId, string $tag): void
+    {
+        $assetTag = AssetTag::create($assetId, $tag);
+
+        $sql = 'INSERT IGNORE INTO asset_tags (asset_id, tag) VALUES (?, ?)';
+        $query = SqlQuery::create($sql, [
+            $assetTag->assetId->toString(),
+            $assetTag->tag,
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function removeTag(AssetId $assetId, string $tag): void
+    {
+        $assetTag = AssetTag::create($assetId, $tag);
+
+        $sql = 'DELETE FROM asset_tags WHERE asset_id = ? AND tag = ?';
+        $query = SqlQuery::create($sql, [
+            $assetTag->assetId->toString(),
+            $assetTag->tag,
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function addTags(AssetId $assetId, array $tags): void
+    {
+        foreach ($tags as $tag) {
+            $this->addTag($assetId, $tag);
+        }
+    }
+
+    public function removeTags(AssetId $assetId, array $tags): void
+    {
+        foreach ($tags as $tag) {
+            $this->removeTag($assetId, $tag);
+        }
+    }
+
+    public function findByTag(string $tag): array
+    {
+        $sql = 'SELECT * FROM asset_tags WHERE tag = ? ORDER BY asset_id ASC';
+        $query = SqlQuery::create($sql, [strtolower(trim($tag))]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function getTags(AssetId $assetId): array
+    {
+        $sql = 'SELECT * FROM asset_tags WHERE asset_id = ? ORDER BY tag ASC';
+        $query = SqlQuery::create($sql, [$assetId->toString()]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function deleteByAsset(AssetId $assetId): void
+    {
+        $sql = 'DELETE FROM asset_tags WHERE asset_id = ?';
+        $query = SqlQuery::create($sql, [$assetId->toString()]);
+        $this->connection->execute($query);
+    }
+
+    private function hydrate(array $row): AssetTag
+    {
+        return AssetTag::create(
+            AssetId::fromString($row['asset_id']),
+            $row['tag']
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Repositories/DatabaseAssetVariantRepository.php b/src/Domain/Asset/Repositories/DatabaseAssetVariantRepository.php
new file mode 100644
index 00000000..9a278be7
--- /dev/null
+++ b/src/Domain/Asset/Repositories/DatabaseAssetVariantRepository.php
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Repositories;
+
+use App\Domain\Asset\Entities\AssetVariant;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Domain\Asset\ValueObjects\VariantName;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+use App\Framework\Http\CustomMimeType;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+use App\Framework\Storage\ValueObjects\ObjectKey;
+
+final readonly class DatabaseAssetVariantRepository implements AssetVariantRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function save(AssetVariant $variant): void
+    {
+        $sql = 'INSERT INTO asset_variants (asset_id, variant, bucket, key, mime, bytes, meta)
+             VALUES (?, ?, ?, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE
+                bucket = VALUES(bucket),
+                key = VALUES(key),
+                mime = VALUES(mime),
+                bytes = VALUES(bytes),
+                meta = VALUES(meta)';
+
+        $query = SqlQuery::create($sql, [
+            $variant->assetId->toString(),
+            $variant->variant->toString(),
+            $variant->bucket->toString(),
+            $variant->key->toString(),
+            $variant->mime->value,
+            $variant->bytes->bytes->toBytes(),
+            json_encode($variant->meta->toArray(), JSON_THROW_ON_ERROR),
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function findByAsset(AssetId $assetId): array
+    {
+        $sql = 'SELECT * FROM asset_variants WHERE asset_id = ? ORDER BY variant ASC';
+        $query = SqlQuery::create($sql, [$assetId->toString()]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function findByAssetAndVariant(AssetId $assetId, VariantName $variant): ?AssetVariant
+    {
+        $sql = 'SELECT * FROM asset_variants WHERE asset_id = ? AND variant = ?';
+        $query = SqlQuery::create($sql, [$assetId->toString(), $variant->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function deleteByAsset(AssetId $assetId): void
+    {
+        $sql = 'DELETE FROM asset_variants WHERE asset_id = ?';
+        $query = SqlQuery::create($sql, [$assetId->toString()]);
+        $this->connection->execute($query);
+    }
+
+    private function hydrate(array $row): AssetVariant
+    {
+        $metaData = ! empty($row['meta']) ? json_decode($row['meta'], true, 512, JSON_THROW_ON_ERROR) : [];
+        $mimeType = MimeType::tryFrom($row['mime']) ?? CustomMimeType::fromString($row['mime']);
+
+        return new AssetVariant(
+            assetId: AssetId::fromString($row['asset_id']),
+            variant: VariantName::fromString($row['variant']),
+            bucket: BucketName::fromString($row['bucket']),
+            key: ObjectKey::fromString($row['key']),
+            mime: $mimeType,
+            bytes: FileSize::fromBytes((int) $row['bytes']),
+            meta: AssetMetadata::fromArray($metaData)
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Services/AssetService.php b/src/Domain/Asset/Services/AssetService.php
new file mode 100644
index 00000000..413b7d80
--- /dev/null
+++ b/src/Domain/Asset/Services/AssetService.php
@@ -0,0 +1,241 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Services;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\Exceptions\AssetNotFoundException;
+use App\Domain\Asset\Repositories\AssetRepository;
+use App\Domain\Asset\Repositories\AssetTagRepository;
+use App\Domain\Asset\Repositories\AssetVariantRepository;
+use App\Domain\Asset\Storage\AssetStorageInterface;
+use App\Domain\Asset\ValueObjects\AssetId;
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+use App\Domain\Asset\ValueObjects\ObjectKeyGenerator;
+use App\Domain\Asset\ValueObjects\VariantName;
+use App\Domain\Asset\Commands\ProcessDerivatCommand;
+use App\Framework\CommandBus\CommandBus;
+use App\Framework\Core\ValueObjects\FileSize;
+use App\Framework\Core\ValueObjects\Hash;
+use App\Framework\Core\ValueObjects\HashAlgorithm;
+use App\Framework\DateTime\Clock;
+use App\Framework\Http\CustomMimeType;
+use App\Framework\Http\MimeType;
+use App\Framework\Storage\ValueObjects\BucketName;
+
+final readonly class AssetService
+{
+    public function __construct(
+        private AssetRepository $assetRepository,
+        private AssetVariantRepository $assetVariantRepository,
+        private AssetTagRepository $assetTagRepository,
+        private AssetStorageInterface $storage,
+        private DeduplicationService $deduplicationService,
+        private MetadataExtractor $metadataExtractor,
+        private CommandBus $commandBus,
+        private Clock $clock
+    ) {
+    }
+
+    public function upload(
+        string $content,
+        BucketName $bucket,
+        MimeType $mime,
+        ?AssetMetadata $meta = null,
+        array $tags = []
+    ): Asset {
+        // Calculate SHA256 hash
+        $sha256 = Hash::create($content, HashAlgorithm::SHA256);
+
+        // Check for duplicate
+        $existingAsset = $this->deduplicationService->checkDuplicate($sha256);
+        if ($existingAsset !== null) {
+            // Return existing asset, but add tags if provided
+            if (! empty($tags)) {
+                $this->assetTagRepository->addTags($existingAsset->id, $tags);
+            }
+
+            return $existingAsset;
+        }
+
+        // Extract metadata if not provided
+        if ($meta === null) {
+            $meta = $this->extractMetadata($content, $mime);
+        }
+
+        // Generate asset ID first
+        $assetId = AssetId::generate($this->clock);
+
+        // Generate object key
+        $extension = $this->getExtensionFromMime($mime);
+        $key = ObjectKeyGenerator::generateKey(
+            $assetId,
+            $extension
+        );
+
+        // Create asset
+        $asset = new Asset(
+            id: $assetId,
+            bucket: $bucket,
+            key: $key,
+            mime: $mime,
+            bytes: FileSize::fromBytes(strlen($content)),
+            sha256: $sha256,
+            meta: $meta,
+            createdAt: \App\Framework\Core\ValueObjects\Timestamp::fromClock($this->clock)
+        );
+
+        // Store in storage
+        $this->storage->put($asset, $content);
+
+        // Save to database
+        $this->assetRepository->save($asset);
+
+        // Add tags
+        if (! empty($tags)) {
+            $this->assetTagRepository->addTags($asset->id, $tags);
+        }
+
+        // Trigger derivat pipeline via Command Bus
+        $this->commandBus->dispatch(ProcessDerivatCommand::forAsset($asset->id));
+
+        return $asset;
+    }
+
+    public function findById(AssetId $id): Asset
+    {
+        $asset = $this->assetRepository->findById($id);
+        if ($asset === null) {
+            throw AssetNotFoundException::forId($id);
+        }
+
+        return $asset;
+    }
+
+    public function findBySha256(Hash $sha256): ?Asset
+    {
+        return $this->assetRepository->findBySha256($sha256);
+    }
+
+    public function delete(AssetId $id): void
+    {
+        $asset = $this->assetRepository->findById($id);
+        if ($asset === null) {
+            throw AssetNotFoundException::forId($id);
+        }
+
+        // Delete from storage
+        $this->storage->delete($asset);
+
+        // Delete variants
+        $variants = $this->assetVariantRepository->findByAsset($id);
+        foreach ($variants as $variant) {
+            $this->storage->delete($this->createAssetFromVariant($variant));
+        }
+        $this->assetVariantRepository->deleteByAsset($id);
+
+        // Delete tags
+        $this->assetTagRepository->deleteByAsset($id);
+
+        // Delete asset
+        $this->assetRepository->delete($id);
+    }
+
+    /**
+     * @return \App\Domain\Asset\Entities\AssetVariant[]
+     */
+    public function getVariants(AssetId $id): array
+    {
+        return $this->assetVariantRepository->findByAsset($id);
+    }
+
+    public function getVariant(AssetId $id, VariantName $variant): ?\App\Domain\Asset\Entities\AssetVariant
+    {
+        return $this->assetVariantRepository->findByAssetAndVariant($id, $variant);
+    }
+
+    public function addTags(AssetId $id, array $tags): void
+    {
+        $this->assetTagRepository->addTags($id, $tags);
+    }
+
+    public function removeTags(AssetId $id, array $tags): void
+    {
+        $this->assetTagRepository->removeTags($id, $tags);
+    }
+
+    /**
+     * @return Asset[]
+     */
+    public function findByTag(string $tag): array
+    {
+        $assetTags = $this->assetTagRepository->findByTag($tag);
+        $assets = [];
+
+        foreach ($assetTags as $assetTag) {
+            $asset = $this->assetRepository->findById($assetTag->assetId);
+            if ($asset !== null) {
+                $assets[] = $asset;
+            }
+        }
+
+        return $assets;
+    }
+
+    /**
+     * @return \App\Domain\Asset\Entities\AssetTag[]
+     */
+    public function getTags(AssetId $id): array
+    {
+        return $this->assetTagRepository->getTags($id);
+    }
+
+    /**
+     * @return Asset[]
+     */
+    public function findByBucket(\App\Framework\Storage\ValueObjects\BucketName $bucket): array
+    {
+        return $this->assetRepository->findByBucket($bucket);
+    }
+
+    private function extractMetadata(string $content, MimeType $mime): AssetMetadata
+    {
+        return match (true) {
+            str_starts_with($mime->value, 'image/') => $this->metadataExtractor->extractImageMetadata($content),
+            str_starts_with($mime->value, 'video/') => $this->metadataExtractor->extractVideoMetadata($content),
+            str_starts_with($mime->value, 'audio/') => $this->metadataExtractor->extractAudioMetadata($content),
+            default => AssetMetadata::empty(),
+        };
+    }
+
+    private function getExtensionFromMime(MimeType $mime): string
+    {
+        return match ($mime) {
+            MimeType::IMAGE_JPEG => 'jpg',
+            MimeType::IMAGE_PNG => 'png',
+            MimeType::IMAGE_GIF => 'gif',
+            MimeType::IMAGE_WEBP => 'webp',
+            MimeType::IMAGE_SVG => 'svg',
+            default => 'bin',
+        };
+    }
+
+    private function createAssetFromVariant(\App\Domain\Asset\Entities\AssetVariant $variant): Asset
+    {
+        // Create a temporary Asset entity for storage operations
+        // This is a workaround since we need Asset for storage.delete()
+        // In a real implementation, we might want to refactor storage to accept AssetVariant
+        return new Asset(
+            id: $variant->assetId,
+            bucket: $variant->bucket,
+            key: $variant->key,
+            mime: $variant->mime,
+            bytes: $variant->bytes,
+            sha256: Hash::fromString('0000000000000000000000000000000000000000000000000000000000000000', HashAlgorithm::SHA256), // Dummy hash
+            meta: $variant->meta,
+            createdAt: \App\Framework\Core\ValueObjects\Timestamp::now()
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Services/DeduplicationService.php b/src/Domain/Asset/Services/DeduplicationService.php
new file mode 100644
index 00000000..867c5675
--- /dev/null
+++ b/src/Domain/Asset/Services/DeduplicationService.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Services;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Domain\Asset\Repositories\AssetRepository;
+use App\Framework\Core\ValueObjects\Hash;
+
+final readonly class DeduplicationService
+{
+    public function __construct(
+        private AssetRepository $assetRepository
+    ) {
+    }
+
+    public function checkDuplicate(Hash $sha256): ?Asset
+    {
+        return $this->assetRepository->findBySha256($sha256);
+    }
+
+    public function isDuplicate(Hash $sha256): bool
+    {
+        return $this->checkDuplicate($sha256) !== null;
+    }
+}
+
diff --git a/src/Domain/Asset/Services/MetadataExtractor.php b/src/Domain/Asset/Services/MetadataExtractor.php
new file mode 100644
index 00000000..fe4b79e3
--- /dev/null
+++ b/src/Domain/Asset/Services/MetadataExtractor.php
@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Services;
+
+use App\Domain\Asset\ValueObjects\AssetMetadata;
+
+final readonly class MetadataExtractor
+{
+    public function extractImageMetadata(string $content): AssetMetadata
+    {
+        $meta = AssetMetadata::empty();
+
+        // Use GD or ImageMagick to extract metadata
+        $image = @imagecreatefromstring($content);
+        if ($image !== false) {
+            $width = imagesx($image);
+            $height = imagesy($image);
+
+            $meta = $meta->withDimensions($width, $height);
+
+            imagedestroy($image);
+        }
+
+        // Try to extract EXIF data if available
+        $tempFile = tmpfile();
+        if ($tempFile !== false) {
+            $tempPath = stream_get_meta_data($tempFile)['uri'];
+            file_put_contents($tempPath, $content);
+
+            $exif = @exif_read_data($tempPath);
+            if ($exif !== false) {
+                $meta = $meta->withExif($exif);
+            }
+
+            fclose($tempFile);
+        }
+
+        return $meta;
+    }
+
+    public function extractVideoMetadata(string $content): AssetMetadata
+    {
+        $meta = AssetMetadata::empty();
+
+        // Video metadata extraction would require FFmpeg or similar
+        // For now, return empty metadata
+        // TODO: Implement FFmpeg integration for video metadata
+
+        return $meta;
+    }
+
+    public function extractAudioMetadata(string $content): AssetMetadata
+    {
+        $meta = AssetMetadata::empty();
+
+        // Audio metadata extraction would require audio libraries
+        // For now, return empty metadata
+        // TODO: Implement audio metadata extraction
+
+        return $meta;
+    }
+
+    public function generateBlurhash(string $content): ?string
+    {
+        // Blurhash generation requires image processing
+        // For now, return null
+        // TODO: Implement blurhash generation
+
+        return null;
+    }
+
+    public function extractDominantColor(string $content): ?string
+    {
+        // Dominant color extraction requires image processing
+        // For now, return null
+        // TODO: Implement dominant color extraction
+
+        return null;
+    }
+}
+
diff --git a/src/Domain/Asset/Storage/AssetStorageInterface.php b/src/Domain/Asset/Storage/AssetStorageInterface.php
new file mode 100644
index 00000000..f7f2c91a
--- /dev/null
+++ b/src/Domain/Asset/Storage/AssetStorageInterface.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Storage;
+
+use App\Domain\Asset\Entities\Asset;
+
+interface AssetStorageInterface
+{
+    public function put(Asset $asset, string $content): void;
+
+    public function get(Asset $asset): string;
+
+    public function exists(Asset $asset): bool;
+
+    public function delete(Asset $asset): void;
+
+    public function getUrl(Asset $asset): string;
+
+    public function getSignedUrl(Asset $asset, int $expiresIn): string;
+}
+
diff --git a/src/Domain/Asset/Storage/ObjectStorageAdapter.php b/src/Domain/Asset/Storage/ObjectStorageAdapter.php
new file mode 100644
index 00000000..82d2480c
--- /dev/null
+++ b/src/Domain/Asset/Storage/ObjectStorageAdapter.php
@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Storage;
+
+use App\Domain\Asset\Entities\Asset;
+use App\Framework\Storage\ObjectStorage;
+
+final readonly class ObjectStorageAdapter implements AssetStorageInterface
+{
+    public function __construct(
+        private ObjectStorage $objectStorage,
+        private ?string $cdnBaseUrl = null
+    ) {
+    }
+
+    public function put(Asset $asset, string $content): void
+    {
+        $this->objectStorage->put(
+            $asset->bucket->toString(),
+            $asset->key->toString(),
+            $content
+        );
+    }
+
+    public function get(Asset $asset): string
+    {
+        return $this->objectStorage->get(
+            $asset->bucket->toString(),
+            $asset->key->toString()
+        );
+    }
+
+    public function exists(Asset $asset): bool
+    {
+        return $this->objectStorage->exists(
+            $asset->bucket->toString(),
+            $asset->key->toString()
+        );
+    }
+
+    public function delete(Asset $asset): void
+    {
+        $this->objectStorage->delete(
+            $asset->bucket->toString(),
+            $asset->key->toString()
+        );
+    }
+
+    public function getUrl(Asset $asset): string
+    {
+        // Try to get URL from ObjectStorage first
+        $url = $this->objectStorage->url(
+            $asset->bucket->toString(),
+            $asset->key->toString()
+        );
+
+        if ($url !== null) {
+            return $url;
+        }
+
+        // Fallback to CDN URL if configured
+        if ($this->cdnBaseUrl !== null) {
+            return rtrim($this->cdnBaseUrl, '/') . '/' . $asset->bucket->toString() . '/' . $asset->key->toString();
+        }
+
+        // Last resort: return storage path
+        return $asset->bucket->toString() . '/' . $asset->key->toString();
+    }
+
+    public function getSignedUrl(Asset $asset, int $expiresIn): string
+    {
+        $ttl = new \DateInterval('PT' . $expiresIn . 'S');
+
+        return $this->objectStorage->temporaryUrl(
+            $asset->bucket->toString(),
+            $asset->key->toString(),
+            $ttl
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/Storage/ObjectStorageAdapterFactory.php b/src/Domain/Asset/Storage/ObjectStorageAdapterFactory.php
new file mode 100644
index 00000000..176633e8
--- /dev/null
+++ b/src/Domain/Asset/Storage/ObjectStorageAdapterFactory.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\Storage;
+
+use App\Framework\Config\Environment;
+use App\Framework\Config\EnvKey;
+use App\Framework\Storage\ObjectStorage;
+use App\Framework\Storage\StorageInitializer;
+
+final readonly class ObjectStorageAdapterFactory
+{
+    public function __construct(
+        private StorageInitializer $storageInitializer,
+        private Environment $environment
+    ) {
+    }
+
+    public function create(): AssetStorageInterface
+    {
+        $storageType = $this->environment->get('ASSET_STORAGE_TYPE', 'filesystem');
+        $cdnBaseUrl = $this->environment->get('ASSET_CDN_BASE_URL');
+
+        $objectStorage = $this->storageInitializer->getObjectStorage($storageType);
+
+        return new ObjectStorageAdapter(
+            objectStorage: $objectStorage,
+            cdnBaseUrl: $cdnBaseUrl
+        );
+    }
+}
+
diff --git a/src/Domain/Asset/ValueObjects/AssetId.php b/src/Domain/Asset/ValueObjects/AssetId.php
new file mode 100644
index 00000000..a6da1c82
--- /dev/null
+++ b/src/Domain/Asset/ValueObjects/AssetId.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\ValueObjects;
+
+use App\Framework\DateTime\Clock;
+use App\Framework\Id\Ulid\Ulid;
+
+final readonly class AssetId
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (! Ulid::isValid($value)) {
+            throw new \InvalidArgumentException('Invalid Asset ID format');
+        }
+    }
+
+    public static function generate(Clock $clock): self
+    {
+        $ulid = new Ulid($clock);
+
+        return new self($ulid->__toString());
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Domain/Asset/ValueObjects/AssetMetadata.php b/src/Domain/Asset/ValueObjects/AssetMetadata.php
new file mode 100644
index 00000000..f4ae90d8
--- /dev/null
+++ b/src/Domain/Asset/ValueObjects/AssetMetadata.php
@@ -0,0 +1,215 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\ValueObjects;
+
+final readonly class AssetMetadata
+{
+    /**
+     * @param array<string, mixed> $data
+     */
+    private function __construct(
+        private array $data
+    ) {
+    }
+
+    public static function empty(): self
+    {
+        return new self([]);
+    }
+
+    /**
+     * @param array<string, mixed> $data
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self($data);
+    }
+
+    public function getWidth(): ?int
+    {
+        return $this->data['width'] ?? null;
+    }
+
+    public function getHeight(): ?int
+    {
+        return $this->data['height'] ?? null;
+    }
+
+    public function getDuration(): ?int
+    {
+        return $this->data['duration'] ?? null;
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    public function getExif(): ?array
+    {
+        return $this->data['exif'] ?? null;
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    public function getIptc(): ?array
+    {
+        return $this->data['iptc'] ?? null;
+    }
+
+    public function getColorProfile(): ?string
+    {
+        return $this->data['colorProfile'] ?? $this->data['color_profile'] ?? null;
+    }
+
+    /**
+     * @return array{x: float, y: float}|null
+     */
+    public function getFocalPoint(): ?array
+    {
+        return $this->data['focalPoint'] ?? $this->data['focal_point'] ?? null;
+    }
+
+    public function getDominantColor(): ?string
+    {
+        return $this->data['dominantColor'] ?? $this->data['dominant_color'] ?? null;
+    }
+
+    public function getBlurhash(): ?string
+    {
+        return $this->data['blurhash'] ?? null;
+    }
+
+    public function withWidth(?int $width): self
+    {
+        $newData = $this->data;
+        if ($width !== null) {
+            $newData['width'] = $width;
+        } else {
+            unset($newData['width']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withHeight(?int $height): self
+    {
+        $newData = $this->data;
+        if ($height !== null) {
+            $newData['height'] = $height;
+        } else {
+            unset($newData['height']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withDimensions(int $width, int $height): self
+    {
+        return $this->withWidth($width)->withHeight($height);
+    }
+
+    public function withDuration(?int $duration): self
+    {
+        $newData = $this->data;
+        if ($duration !== null) {
+            $newData['duration'] = $duration;
+        } else {
+            unset($newData['duration']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withExif(?array $exif): self
+    {
+        $newData = $this->data;
+        if ($exif !== null) {
+            $newData['exif'] = $exif;
+        } else {
+            unset($newData['exif']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withIptc(?array $iptc): self
+    {
+        $newData = $this->data;
+        if ($iptc !== null) {
+            $newData['iptc'] = $iptc;
+        } else {
+            unset($newData['iptc']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withColorProfile(?string $colorProfile): self
+    {
+        $newData = $this->data;
+        if ($colorProfile !== null) {
+            $newData['colorProfile'] = $colorProfile;
+        } else {
+            unset($newData['colorProfile'], $newData['color_profile']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withFocalPoint(?array $focalPoint): self
+    {
+        $newData = $this->data;
+        if ($focalPoint !== null) {
+            $newData['focalPoint'] = $focalPoint;
+        } else {
+            unset($newData['focalPoint'], $newData['focal_point']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withDominantColor(?string $dominantColor): self
+    {
+        $newData = $this->data;
+        if ($dominantColor !== null) {
+            $newData['dominantColor'] = $dominantColor;
+        } else {
+            unset($newData['dominantColor'], $newData['dominant_color']);
+        }
+
+        return new self($newData);
+    }
+
+    public function withBlurhash(?string $blurhash): self
+    {
+        $newData = $this->data;
+        if ($blurhash !== null) {
+            $newData['blurhash'] = $blurhash;
+        } else {
+            unset($newData['blurhash']);
+        }
+
+        return new self($newData);
+    }
+
+    public function get(string $key, mixed $default = null): mixed
+    {
+        return $this->data[$key] ?? $default;
+    }
+
+    public function has(string $key): bool
+    {
+        return isset($this->data[$key]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return $this->data;
+    }
+}
+
diff --git a/src/Domain/Asset/ValueObjects/ObjectKeyGenerator.php b/src/Domain/Asset/ValueObjects/ObjectKeyGenerator.php
new file mode 100644
index 00000000..318ece91
--- /dev/null
+++ b/src/Domain/Asset/ValueObjects/ObjectKeyGenerator.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\ValueObjects;
+
+use App\Framework\Storage\ValueObjects\ObjectKey;
+
+final readonly class ObjectKeyGenerator
+{
+    public static function generateKey(
+        AssetId $assetId,
+        string $extension,
+        ?string $prefix = 'orig'
+    ): ObjectKey {
+        $now = new \DateTimeImmutable();
+        $year = $now->format('Y');
+        $month = $now->format('m');
+        $day = $now->format('d');
+
+        $key = sprintf(
+            '%s/%s/%s/%s/%s.%s',
+            $prefix,
+            $year,
+            $month,
+            $day,
+            $assetId->toString(),
+            ltrim($extension, '.')
+        );
+
+        return ObjectKey::fromString($key);
+    }
+
+    public static function generateVariantKey(
+        AssetId $assetId,
+        VariantName $variant,
+        ?string $prefix = 'variants'
+    ): ObjectKey {
+        $now = new \DateTimeImmutable();
+        $year = $now->format('Y');
+        $month = $now->format('m');
+        $day = $now->format('d');
+
+        $key = sprintf(
+            '%s/%s/%s/%s/%s/%s',
+            $prefix,
+            $year,
+            $month,
+            $day,
+            $assetId->toString(),
+            $variant->toString()
+        );
+
+        return ObjectKey::fromString($key);
+    }
+}
+
diff --git a/src/Domain/Asset/ValueObjects/VariantName.php b/src/Domain/Asset/ValueObjects/VariantName.php
new file mode 100644
index 00000000..6d5a8fac
--- /dev/null
+++ b/src/Domain/Asset/ValueObjects/VariantName.php
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Asset\ValueObjects;
+
+final readonly class VariantName
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Variant name cannot be empty');
+        }
+
+        // Variant names: "1200w.webp", "cover@1x", "thumb@2x", "waveform.json"
+        // Pattern: {name}[@{scale}]?[.{ext}]?
+        if (! preg_match('/^[a-z0-9_-]+(@[0-9]+x)?(\.[a-z0-9]+)?$/', $value)) {
+            throw new \InvalidArgumentException('Invalid variant name format. Expected: name[@scale]?[.ext]?');
+        }
+
+        if (strlen($value) > 100) {
+            throw new \InvalidArgumentException('Variant name cannot exceed 100 characters');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function getScale(): ?string
+    {
+        if (preg_match('/@([0-9]+x)$/', $this->value, $matches)) {
+            return $matches[1];
+        }
+
+        return null;
+    }
+
+    public function getExtension(): ?string
+    {
+        $parts = explode('.', $this->value);
+        if (count($parts) > 1) {
+            return end($parts);
+        }
+
+        return null;
+    }
+}
+
diff --git a/src/Domain/Cms/DI/CmsServiceInitializer.php b/src/Domain/Cms/DI/CmsServiceInitializer.php
new file mode 100644
index 00000000..bb62f6d9
--- /dev/null
+++ b/src/Domain/Cms/DI/CmsServiceInitializer.php
@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\DI;
+
+use App\Domain\Cms\Repositories\ContentRepository;
+use App\Domain\Cms\Repositories\ContentTypeRepository;
+use App\Domain\Cms\Repositories\DatabaseContentRepository;
+use App\Domain\Cms\Repositories\DatabaseContentTypeRepository;
+use App\Domain\Cms\Rendering\BlockRendererRegistry;
+use App\Domain\Cms\Rendering\DefaultBlockRenderer;
+use App\Domain\Cms\Rendering\HeroBlockRenderer;
+use App\Domain\Cms\Rendering\ImageBlockRenderer;
+use App\Domain\Cms\Rendering\TextBlockRenderer;
+use App\Domain\Cms\Repositories\ContentTranslationRepository;
+use App\Domain\Cms\Repositories\DatabaseContentTranslationRepository;
+use App\Domain\Cms\Services\BlockTypeRegistry;
+use App\Domain\Cms\Services\BlockValidator;
+use App\Domain\Cms\Services\ContentLocalizationService;
+use App\Domain\Cms\Services\ContentRenderer;
+use App\Domain\Cms\Services\ContentService;
+use App\Domain\Cms\Services\ContentTypeService;
+use App\Domain\Cms\Services\SlugGenerator;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\DateTime\Clock;
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+use App\Framework\View\ComponentRenderer;
+
+/**
+ * CMS Domain Service Registration
+ *
+ * Registers all CMS domain services in the DI container.
+ */
+final readonly class CmsServiceInitializer
+{
+    #[Initializer]
+    public function __invoke(Container $container): void
+    {
+        // Repository Bindings
+        $container->singleton(
+            ContentRepository::class,
+            fn (Container $c) => new DatabaseContentRepository(
+                $c->get(ConnectionInterface::class)
+            )
+        );
+
+        $container->singleton(
+            ContentTypeRepository::class,
+            fn (Container $c) => new DatabaseContentTypeRepository(
+                $c->get(ConnectionInterface::class)
+            )
+        );
+
+        // Block Type Registry
+        $container->singleton(
+            BlockTypeRegistry::class,
+            fn () => new BlockTypeRegistry()
+        );
+
+        // Services
+        $container->singleton(
+            BlockValidator::class,
+            fn (Container $c) => new BlockValidator(
+                $c->get(BlockTypeRegistry::class)
+            )
+        );
+
+        $container->singleton(
+            SlugGenerator::class,
+            fn (Container $c) => new SlugGenerator(
+                $c->get(ContentRepository::class)
+            )
+        );
+
+        $container->singleton(
+            ContentService::class,
+            fn (Container $c) => new ContentService(
+                $c->get(ContentRepository::class),
+                $c->get(BlockValidator::class),
+                $c->get(SlugGenerator::class),
+                $c->get(Clock::class)
+            )
+        );
+
+        $container->singleton(
+            ContentTypeService::class,
+            fn (Container $c) => new ContentTypeService(
+                $c->get(ContentTypeRepository::class),
+                $c->get(Clock::class)
+            )
+        );
+
+        // Content Translation Repository
+        $container->singleton(
+            ContentTranslationRepository::class,
+            fn (Container $c) => new DatabaseContentTranslationRepository(
+                $c->get(ConnectionInterface::class)
+            )
+        );
+
+        // Content Localization Service
+        $container->singleton(
+            ContentLocalizationService::class,
+            fn (Container $c) => new ContentLocalizationService(
+                $c->get(ContentTranslationRepository::class),
+                $c->get(Clock::class)
+            )
+        );
+
+        // Block Renderer Registry
+        $container->singleton(
+            BlockRendererRegistry::class,
+            function (Container $c) {
+                $registry = new BlockRendererRegistry();
+
+                // Register default renderers
+                $registry->registerForType('hero', new HeroBlockRenderer());
+                $registry->registerForType('text', new TextBlockRenderer());
+                $registry->registerForType('image', new ImageBlockRenderer());
+
+                return $registry;
+            }
+        );
+
+        // Content Renderer
+        $container->singleton(
+            ContentRenderer::class,
+            fn (Container $c) => new ContentRenderer(
+                $c->get(BlockRendererRegistry::class),
+                $c->get(ComponentRenderer::class),
+                $c->get(ContentLocalizationService::class),
+                new DefaultBlockRenderer()
+            )
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Entities/Content.php b/src/Domain/Cms/Entities/Content.php
new file mode 100644
index 00000000..5b84bb6e
--- /dev/null
+++ b/src/Domain/Cms/Entities/Content.php
@@ -0,0 +1,188 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Entities;
+
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Domain\Cms\Exceptions\InvalidContentStatusException;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\DateTime\Clock;
+
+final readonly class Content
+{
+    public function __construct(
+        public ContentId $id,
+        public ContentTypeId $contentTypeId,
+        public ContentSlug $slug,
+        public string $title,
+        public ContentBlocks $blocks,
+        public ContentStatus $status,
+        public ?string $authorId,
+        public ?Timestamp $publishedAt,
+        public ?BlockData $metaData,
+        public Locale $defaultLocale,
+        public Timestamp $createdAt,
+        public Timestamp $updatedAt
+    ) {
+        if (empty($this->title)) {
+            throw new \InvalidArgumentException('Content title cannot be empty');
+        }
+    }
+
+    public static function create(
+        Clock $clock,
+        ContentTypeId $contentTypeId,
+        ContentSlug $slug,
+        string $title,
+        ContentBlocks $blocks,
+        Locale $defaultLocale,
+        ?string $authorId = null,
+        ?BlockData $metaData = null
+    ): self {
+        return new self(
+            id: ContentId::generate($clock),
+            contentTypeId: $contentTypeId,
+            slug: $slug,
+            title: $title,
+            blocks: $blocks,
+            status: ContentStatus::DRAFT,
+            authorId: $authorId,
+            publishedAt: null,
+            metaData: $metaData,
+            defaultLocale: $defaultLocale,
+            createdAt: Timestamp::now(),
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withStatus(ContentStatus $status): self
+    {
+        if (! $this->status->canTransitionTo($status)) {
+            throw InvalidContentStatusException::invalidTransition($this->status, $status);
+        }
+
+        $publishedAt = $this->publishedAt;
+        if ($status === ContentStatus::PUBLISHED && $this->publishedAt === null) {
+            $publishedAt = Timestamp::now();
+        }
+
+        return new self(
+            id: $this->id,
+            contentTypeId: $this->contentTypeId,
+            slug: $this->slug,
+            title: $this->title,
+            blocks: $this->blocks,
+            status: $status,
+            authorId: $this->authorId,
+            publishedAt: $publishedAt,
+            metaData: $this->metaData,
+            defaultLocale: $this->defaultLocale,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withTitle(string $title): self
+    {
+        if (empty($title)) {
+            throw new \InvalidArgumentException('Content title cannot be empty');
+        }
+
+        return new self(
+            id: $this->id,
+            contentTypeId: $this->contentTypeId,
+            slug: $this->slug,
+            title: $title,
+            blocks: $this->blocks,
+            status: $this->status,
+            authorId: $this->authorId,
+            publishedAt: $this->publishedAt,
+            metaData: $this->metaData,
+            defaultLocale: $this->defaultLocale,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withSlug(ContentSlug $slug): self
+    {
+        return new self(
+            id: $this->id,
+            contentTypeId: $this->contentTypeId,
+            slug: $slug,
+            title: $this->title,
+            blocks: $this->blocks,
+            status: $this->status,
+            authorId: $this->authorId,
+            publishedAt: $this->publishedAt,
+            metaData: $this->metaData,
+            defaultLocale: $this->defaultLocale,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withBlocks(ContentBlocks $blocks): self
+    {
+        return new self(
+            id: $this->id,
+            contentTypeId: $this->contentTypeId,
+            slug: $this->slug,
+            title: $this->title,
+            blocks: $blocks,
+            status: $this->status,
+            authorId: $this->authorId,
+            publishedAt: $this->publishedAt,
+            metaData: $this->metaData,
+            defaultLocale: $this->defaultLocale,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withMetaData(?BlockData $metaData): self
+    {
+        return new self(
+            id: $this->id,
+            contentTypeId: $this->contentTypeId,
+            slug: $this->slug,
+            title: $this->title,
+            blocks: $this->blocks,
+            status: $this->status,
+            authorId: $this->authorId,
+            publishedAt: $this->publishedAt,
+            metaData: $metaData,
+            defaultLocale: $this->defaultLocale,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function isPublished(): bool
+    {
+        return $this->status === ContentStatus::PUBLISHED;
+    }
+
+    public function isDraft(): bool
+    {
+        return $this->status === ContentStatus::DRAFT;
+    }
+
+    public function canBeEdited(): bool
+    {
+        return $this->status->canBeEdited();
+    }
+
+    public function isPublic(): bool
+    {
+        return $this->status->isPublic();
+    }
+}
+
diff --git a/src/Domain/Cms/Entities/ContentTranslation.php b/src/Domain/Cms/Entities/ContentTranslation.php
new file mode 100644
index 00000000..a84fa5f9
--- /dev/null
+++ b/src/Domain/Cms/Entities/ContentTranslation.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Entities;
+
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\DateTime\Clock;
+
+final readonly class ContentTranslation
+{
+    public function __construct(
+        public ContentId $contentId,
+        public Locale $locale,
+        public string $title,
+        public ContentBlocks $blocks,
+        public Timestamp $createdAt,
+        public Timestamp $updatedAt
+    ) {
+        if (empty($this->title)) {
+            throw new \InvalidArgumentException('Translation title cannot be empty');
+        }
+    }
+
+    public static function create(
+        Clock $clock,
+        ContentId $contentId,
+        Locale $locale,
+        string $title,
+        ContentBlocks $blocks
+    ): self {
+        return new self(
+            contentId: $contentId,
+            locale: $locale,
+            title: $title,
+            blocks: $blocks,
+            createdAt: Timestamp::now(),
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withTitle(string $title): self
+    {
+        if (empty($title)) {
+            throw new \InvalidArgumentException('Translation title cannot be empty');
+        }
+
+        return new self(
+            contentId: $this->contentId,
+            locale: $this->locale,
+            title: $title,
+            blocks: $this->blocks,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withBlocks(ContentBlocks $blocks): self
+    {
+        return new self(
+            contentId: $this->contentId,
+            locale: $this->locale,
+            title: $this->title,
+            blocks: $blocks,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Entities/ContentType.php b/src/Domain/Cms/Entities/ContentType.php
new file mode 100644
index 00000000..fa90c746
--- /dev/null
+++ b/src/Domain/Cms/Entities/ContentType.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Entities;
+
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\DateTime\Clock;
+
+final readonly class ContentType
+{
+    public function __construct(
+        public ContentTypeId $id,
+        public string $name,
+        public string $slug,
+        public ?string $description,
+        public bool $isSystem,
+        public Timestamp $createdAt,
+        public Timestamp $updatedAt
+    ) {
+        if (empty($this->name)) {
+            throw new \InvalidArgumentException('Content type name cannot be empty');
+        }
+
+        if (empty($this->slug)) {
+            throw new \InvalidArgumentException('Content type slug cannot be empty');
+        }
+    }
+
+    public static function create(
+        Clock $clock,
+        ContentTypeId $id,
+        string $name,
+        string $slug,
+        ?string $description = null,
+        bool $isSystem = false
+    ): self {
+        return new self(
+            id: $id,
+            name: $name,
+            slug: $slug,
+            description: $description,
+            isSystem: $isSystem,
+            createdAt: Timestamp::now(),
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withName(string $name): self
+    {
+        if (empty($name)) {
+            throw new \InvalidArgumentException('Content type name cannot be empty');
+        }
+
+        return new self(
+            id: $this->id,
+            name: $name,
+            slug: $this->slug,
+            description: $this->description,
+            isSystem: $this->isSystem,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+
+    public function withDescription(?string $description): self
+    {
+        return new self(
+            id: $this->id,
+            name: $this->name,
+            slug: $this->slug,
+            description: $description,
+            isSystem: $this->isSystem,
+            createdAt: $this->createdAt,
+            updatedAt: Timestamp::now()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Enums/ContentStatus.php b/src/Domain/Cms/Enums/ContentStatus.php
new file mode 100644
index 00000000..d2c08d80
--- /dev/null
+++ b/src/Domain/Cms/Enums/ContentStatus.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Enums;
+
+enum ContentStatus: string
+{
+    case DRAFT = 'draft';
+    case PUBLISHED = 'published';
+    case ARCHIVED = 'archived';
+
+    public function getLabel(): string
+    {
+        return match ($this) {
+            self::DRAFT => 'Draft',
+            self::PUBLISHED => 'Published',
+            self::ARCHIVED => 'Archived',
+        };
+    }
+
+    public function isPublic(): bool
+    {
+        return match ($this) {
+            self::PUBLISHED => true,
+            default => false,
+        };
+    }
+
+    public function canBeEdited(): bool
+    {
+        return match ($this) {
+            self::DRAFT, self::PUBLISHED => true,
+            self::ARCHIVED => false,
+        };
+    }
+
+    public function canTransitionTo(self $newStatus): bool
+    {
+        return match ([$this, $newStatus]) {
+            // From DRAFT
+            [self::DRAFT, self::PUBLISHED] => true,
+            [self::DRAFT, self::ARCHIVED] => true,
+
+            // From PUBLISHED
+            [self::PUBLISHED, self::DRAFT] => true,
+            [self::PUBLISHED, self::ARCHIVED] => true,
+
+            // From ARCHIVED
+            [self::ARCHIVED, self::DRAFT] => true,
+
+            default => false,
+        };
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/CannotDeleteSystemContentTypeException.php b/src/Domain/Cms/Exceptions/CannotDeleteSystemContentTypeException.php
new file mode 100644
index 00000000..1044b70a
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/CannotDeleteSystemContentTypeException.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\Exception\Core\ValidationErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class CannotDeleteSystemContentTypeException extends FrameworkException
+{
+    public static function forId(ContentTypeId $id): self
+    {
+        return new self(
+            sprintf('Cannot delete system content type with ID "%s"', $id->toString()),
+            (int) ValidationErrorCode::BUSINESS_RULE_VIOLATION->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/ContentNotFoundException.php b/src/Domain/Cms/Exceptions/ContentNotFoundException.php
new file mode 100644
index 00000000..13d6d5de
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/ContentNotFoundException.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class ContentNotFoundException extends FrameworkException
+{
+    public static function forId(ContentId $id): self
+    {
+        return new self(
+            sprintf('Content with ID "%s" not found', $id->toString()),
+            (int) DatabaseErrorCode::ENTITY_NOT_FOUND->getNumericCode()
+        );
+    }
+
+    public static function forSlug(ContentSlug $slug): self
+    {
+        return new self(
+            sprintf('Content with slug "%s" not found', $slug->toString()),
+            (int) DatabaseErrorCode::ENTITY_NOT_FOUND->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/ContentTypeNotFoundException.php b/src/Domain/Cms/Exceptions/ContentTypeNotFoundException.php
new file mode 100644
index 00000000..dab2800e
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/ContentTypeNotFoundException.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class ContentTypeNotFoundException extends FrameworkException
+{
+    public static function forId(ContentTypeId $id): self
+    {
+        return new self(
+            sprintf('Content type with ID "%s" not found', $id->toString()),
+            (int) DatabaseErrorCode::ENTITY_NOT_FOUND->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/DuplicateContentTypeSlugException.php b/src/Domain/Cms/Exceptions/DuplicateContentTypeSlugException.php
new file mode 100644
index 00000000..b50556bc
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/DuplicateContentTypeSlugException.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class DuplicateContentTypeSlugException extends FrameworkException
+{
+    public static function forSlug(string $slug): self
+    {
+        return new self(
+            sprintf('Content type with slug "%s" already exists', $slug),
+            (int) DatabaseErrorCode::CONSTRAINT_VIOLATION->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/DuplicateSlugException.php b/src/Domain/Cms/Exceptions/DuplicateSlugException.php
new file mode 100644
index 00000000..76549d05
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/DuplicateSlugException.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class DuplicateSlugException extends FrameworkException
+{
+    public static function forSlug(ContentSlug $slug): self
+    {
+        return new self(
+            sprintf('Content with slug "%s" already exists', $slug->toString()),
+            (int) DatabaseErrorCode::CONSTRAINT_VIOLATION->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/InvalidBlockException.php b/src/Domain/Cms/Exceptions/InvalidBlockException.php
new file mode 100644
index 00000000..edc23fe3
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/InvalidBlockException.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\ValueObjects\BlockId;
+use App\Framework\Exception\Core\ValidationErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class InvalidBlockException extends FrameworkException
+{
+    public static function invalidBlockData(BlockId $blockId, string $reason): self
+    {
+        return new self(
+            sprintf('Invalid block data for block "%s": %s', $blockId->toString(), $reason),
+            (int) ValidationErrorCode::INVALID_INPUT->getNumericCode()
+        );
+    }
+
+    public static function missingRequiredField(BlockId $blockId, string $field): self
+    {
+        return new self(
+            sprintf('Missing required field "%s" in block "%s"', $field, $blockId->toString()),
+            (int) ValidationErrorCode::REQUIRED_FIELD_MISSING->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Exceptions/InvalidContentStatusException.php b/src/Domain/Cms/Exceptions/InvalidContentStatusException.php
new file mode 100644
index 00000000..0e26b6b6
--- /dev/null
+++ b/src/Domain/Cms/Exceptions/InvalidContentStatusException.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Exceptions;
+
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Framework\Exception\Core\ValidationErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+final class InvalidContentStatusException extends FrameworkException
+{
+    public static function invalidTransition(ContentStatus $from, ContentStatus $to): self
+    {
+        return new self(
+            sprintf('Cannot transition content from "%s" to "%s"', $from->value, $to->value),
+            (int) ValidationErrorCode::BUSINESS_RULE_VIOLATION->getNumericCode()
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Migrations/CreateContentTranslationsTable.php b/src/Domain/Cms/Migrations/CreateContentTranslationsTable.php
new file mode 100644
index 00000000..aaf920e5
--- /dev/null
+++ b/src/Domain/Cms/Migrations/CreateContentTranslationsTable.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateContentTranslationsTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('content_translations', function (Blueprint $table) {
+            $table->string('content_id', 26); // ULID
+            $table->string('locale', 10); // e.g., 'en', 'en-US'
+            $table->string('title', 255);
+            $table->json('blocks'); // ContentBlocks array
+            $table->timestamp('created_at');
+            $table->timestamp('updated_at');
+
+            $table->primary(['content_id', 'locale']);
+            $table->foreign('content_id')->references('id')->on('contents');
+            $table->index('content_id');
+            $table->index('locale');
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->dropIfExists('content_translations');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000003');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create content_translations table for localization support';
+    }
+}
+
diff --git a/src/Domain/Cms/Migrations/CreateContentTypesTable.php b/src/Domain/Cms/Migrations/CreateContentTypesTable.php
new file mode 100644
index 00000000..0b8614cc
--- /dev/null
+++ b/src/Domain/Cms/Migrations/CreateContentTypesTable.php
@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateContentTypesTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('content_types', function (Blueprint $table) {
+            $table->string('id', 255)->primary();
+            $table->string('name', 255);
+            $table->string('slug', 255)->unique();
+            $table->text('description')->nullable();
+            $table->boolean('is_system')->default(false);
+            $table->timestamp('created_at');
+            $table->timestamp('updated_at');
+
+            $table->index('slug');
+            $table->index('is_system');
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->dropIfExists('content_types');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000001');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create content_types table';
+    }
+}
+
diff --git a/src/Domain/Cms/Migrations/CreateContentsTable.php b/src/Domain/Cms/Migrations/CreateContentsTable.php
new file mode 100644
index 00000000..99031820
--- /dev/null
+++ b/src/Domain/Cms/Migrations/CreateContentsTable.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Migration\SafelyReversible;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateContentsTable implements Migration, SafelyReversible
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->create('contents', function (Blueprint $table) {
+            $table->string('id', 26)->primary(); // ULID
+            $table->string('content_type_id', 255);
+            $table->string('slug', 255)->unique();
+            $table->string('title', 255);
+            $table->json('blocks'); // ContentBlocks array
+            $table->json('meta_data')->nullable(); // SEO, Open Graph, etc.
+            $table->enum('status', ['draft', 'published', 'archived'])->default('draft');
+            $table->string('author_id', 36)->nullable();
+            $table->string('default_locale', 10)->default('en'); // e.g., 'en', 'en-US'
+            $table->timestamp('published_at')->nullable();
+            $table->timestamp('created_at');
+            $table->timestamp('updated_at');
+
+            $table->foreign('content_type_id')->references('id')->on('content_types');
+            $table->index('content_type_id');
+            $table->index('slug');
+            $table->index('status');
+            $table->index('published_at');
+            $table->index('author_id');
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->dropIfExists('contents');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_000002');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create contents table with JSON blocks column';
+    }
+}
+
diff --git a/src/Domain/Cms/README.md b/src/Domain/Cms/README.md
new file mode 100644
index 00000000..71b2caf6
--- /dev/null
+++ b/src/Domain/Cms/README.md
@@ -0,0 +1,193 @@
+# Headless CMS Modul
+
+Ein Block-basiertes Headless CMS System für das Custom PHP Framework.
+
+## Übersicht
+
+Das CMS Modul ermöglicht die Verwaltung von Content durch ein flexibles Block-System, ähnlich WordPress Blocks, Storyblok oder Contentful. Content besteht aus einer geordneten Liste von Content-Blöcken, die als JSON in der Datenbank gespeichert werden.
+
+## Architektur
+
+### Block-basiertes System
+
+Content besteht aus einer **geordneten Liste von Content-Blöcken**. Jeder Block hat:
+- **Block Type**: HERO, TEXT, IMAGE, GALLERY, CTA, VIDEO, etc.
+- **Block Data**: Typed Value Object mit block-spezifischen Daten
+- **Block ID**: Eindeutige ID innerhalb des Contents
+- **Block Settings**: Optionale Konfiguration (Styling, Visibility)
+
+### Beispiel: Landing Page
+
+```php
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Enums\BlockType;
+use App\Domain\Cms\ValueObjects\*;
+
+$content = Content::create(
+    clock: $clock,
+    contentTypeId: ContentTypeId::fromString('landing_page'),
+    slug: ContentSlug::fromString('homepage'),
+    title: 'Welcome to Our Product',
+    blocks: ContentBlocks::fromArray([
+        ContentBlock::create(
+            blockType: BlockType::HERO,
+            blockId: 'hero-1',
+            data: BlockData::fromArray([
+                'title' => 'Revolutionary Product',
+                'subtitle' => 'Transform your workflow',
+                'backgroundImage' => 'img-123', // MediaId als String
+                'ctaText' => 'Get Started',
+                'ctaLink' => '/signup'
+            ])
+        ),
+        ContentBlock::create(
+            blockType: BlockType::TEXT,
+            blockId: 'text-1',
+            data: BlockData::fromArray([
+                'content' => '<p>Our product is...</p>',
+                'alignment' => 'center'
+            ])
+        )
+    ])
+);
+```
+
+## Datenbank-Schema
+
+### content_types
+
+Speichert Content Type Definitionen:
+- `id` (VARCHAR) - Content Type Identifier
+- `name` (VARCHAR) - Display Name
+- `slug` (VARCHAR) - URL-freundlicher Slug
+- `description` (TEXT) - Beschreibung
+- `is_system` (BOOLEAN) - System Content Type
+
+### contents
+
+Speichert Content Instanzen:
+- `id` (VARCHAR) - ULID Identifier
+- `content_type_id` (VARCHAR) - Foreign Key zu content_types
+- `slug` (VARCHAR) - URL-freundlicher Slug (unique)
+- `title` (VARCHAR) - Content Titel
+- `blocks` (JSON) - Array von Block-Objekten
+- `meta_data` (JSON) - SEO, Open Graph Metadaten
+- `status` (ENUM) - draft, published, archived
+- `author_id` (VARCHAR) - Author User ID
+- `published_at` (TIMESTAMP) - Veröffentlichungsdatum
+- `created_at`, `updated_at` (TIMESTAMP)
+
+## Verwendung
+
+### ContentService
+
+```php
+use App\Domain\Cms\Services\ContentService;
+use App\Domain\Cms\ValueObjects\*;
+
+// Content erstellen
+$content = $contentService->create(
+    contentTypeId: ContentTypeId::fromString('landing_page'),
+    title: 'Welcome Page',
+    blocks: ContentBlocks::fromArray([...]),
+    slug: ContentSlug::fromString('homepage')
+);
+
+// Content finden
+$content = $contentService->findBySlug(ContentSlug::fromString('homepage'));
+
+// Content veröffentlichen
+$published = $contentService->publish($content->id);
+
+// Content aktualisieren
+$updated = $contentService->updateBlocks(
+    $content->id,
+    ContentBlocks::fromArray([...])
+);
+```
+
+## REST API
+
+### Endpoints
+
+- `GET /api/v1/cms/contents` - Liste aller Contents
+- `GET /api/v1/cms/contents/{id}` - Content Details
+- `POST /api/v1/cms/contents` - Content erstellen
+- `PUT /api/v1/cms/contents/{id}` - Content aktualisieren
+- `DELETE /api/v1/cms/contents/{id}` - Content löschen
+- `POST /api/v1/cms/contents/{id}/publish` - Content veröffentlichen
+- `POST /api/v1/cms/contents/{id}/unpublish` - Content zurückziehen
+
+### Beispiel Request
+
+```json
+POST /api/v1/cms/contents
+{
+  "content_type_id": "landing_page",
+  "slug": "homepage",
+  "title": "Welcome Page",
+  "blocks": [
+    {
+      "id": "hero-1",
+      "type": "hero",
+      "data": {
+        "title": "Revolutionary Product",
+        "subtitle": "Transform your workflow",
+        "backgroundImage": "img-123",
+        "ctaText": "Get Started",
+        "ctaLink": "/signup"
+      },
+      "settings": {
+        "fullWidth": true
+      }
+    }
+  ],
+  "status": "draft"
+}
+```
+
+## Block Types
+
+- `HERO` - Hero Section mit Titel, Bild, CTA
+- `TEXT` - Rich Text Block
+- `IMAGE` - Einzelnes Bild mit Caption
+- `GALLERY` - Bildergalerie
+- `CTA` - Call-to-Action Block
+- `VIDEO` - Video Embed
+- `FORM` - Formular Integration
+- `COLUMNS` - Multi-Column Layout
+- `QUOTE` - Zitat Block
+- `SEPARATOR` - Trenner/Divider
+
+## Integration mit anderen Domains
+
+### Media Domain
+
+Block Data kann MediaId als String enthalten:
+```php
+BlockData::fromArray([
+    'imageId' => 'img-123', // MediaId als String
+    'caption' => 'Product Screenshot'
+])
+```
+
+### Meta Domain
+
+SEO-Metadaten können in `meta_data` gespeichert werden:
+```php
+$content = $content->withMetaData(BlockData::fromArray([
+    'title' => 'SEO Title',
+    'description' => 'SEO Description',
+    'og_title' => 'OG Title',
+    'og_image' => 'og-image.jpg'
+]));
+```
+
+## Migration
+
+```bash
+php console.php db:migrate
+```
+
+Die Migrations erstellen die Tabellen `content_types` und `contents` mit JSON-Spalten für Blocks.
+
diff --git a/src/Domain/Cms/Rendering/BlockRendererInterface.php b/src/Domain/Cms/Rendering/BlockRendererInterface.php
new file mode 100644
index 00000000..c64dbc12
--- /dev/null
+++ b/src/Domain/Cms/Rendering/BlockRendererInterface.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+interface BlockRendererInterface
+{
+    /**
+     * Render a content block to framework component format
+     *
+     * Returns an array with component name and data that can be used
+     * by the framework's ComponentRenderer
+     *
+     * @return array{component: string, data: array<string, mixed>}
+     */
+    public function render(ContentBlock $block): array;
+
+    /**
+     * Check if this renderer supports the given block type
+     */
+    public function supports(string $blockType): bool;
+}
+
diff --git a/src/Domain/Cms/Rendering/BlockRendererRegistry.php b/src/Domain/Cms/Rendering/BlockRendererRegistry.php
new file mode 100644
index 00000000..de0cf44d
--- /dev/null
+++ b/src/Domain/Cms/Rendering/BlockRendererRegistry.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+final readonly class BlockRendererRegistry
+{
+    /**
+     * @var array<string, BlockRendererInterface>
+     */
+    private array $renderers;
+
+    public function register(BlockRendererInterface $renderer): void
+    {
+        // Register renderer for all supported block types
+        // This assumes renderer supports multiple types or we need to query it
+        $this->renderers[$renderer::class] = $renderer;
+    }
+
+    public function registerForType(string $blockType, BlockRendererInterface $renderer): void
+    {
+        $this->renderers[$blockType] = $renderer;
+    }
+
+    public function getRenderer(string $blockType): ?BlockRendererInterface
+    {
+        // First try direct type mapping
+        if (isset($this->renderers[$blockType])) {
+            $renderer = $this->renderers[$blockType];
+            if ($renderer instanceof BlockRendererInterface) {
+                return $renderer;
+            }
+        }
+
+        // Fallback: find renderer that supports this type
+        foreach ($this->renderers as $renderer) {
+            if ($renderer instanceof BlockRendererInterface && $renderer->supports($blockType)) {
+                return $renderer;
+            }
+        }
+
+        return null;
+    }
+
+    public function hasRenderer(string $blockType): bool
+    {
+        return $this->getRenderer($blockType) !== null;
+    }
+
+    /**
+     * @return array<string, BlockRendererInterface>
+     */
+    public function getAllRenderers(): array
+    {
+        return $this->renderers;
+    }
+}
+
diff --git a/src/Domain/Cms/Rendering/DefaultBlockRenderer.php b/src/Domain/Cms/Rendering/DefaultBlockRenderer.php
new file mode 100644
index 00000000..d2310848
--- /dev/null
+++ b/src/Domain/Cms/Rendering/DefaultBlockRenderer.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+/**
+ * Default renderer for blocks that don't have a specific renderer
+ *
+ * Falls back to a generic component with all block data
+ */
+final readonly class DefaultBlockRenderer implements BlockRendererInterface
+{
+    public function render(ContentBlock $block): array
+    {
+        return [
+            'component' => 'cms/block',
+            'data' => [
+                'blockType' => $block->type->toString(),
+                'blockId' => $block->blockId->toString(),
+                'data' => $block->data->toArray(),
+                'settings' => $block->settings?->toArray() ?? [],
+            ],
+        ];
+    }
+
+    public function supports(string $blockType): bool
+    {
+        // Default renderer supports all block types as fallback
+        return true;
+    }
+}
+
diff --git a/src/Domain/Cms/Rendering/HeroBlockRenderer.php b/src/Domain/Cms/Rendering/HeroBlockRenderer.php
new file mode 100644
index 00000000..506b8c9f
--- /dev/null
+++ b/src/Domain/Cms/Rendering/HeroBlockRenderer.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+final readonly class HeroBlockRenderer implements BlockRendererInterface
+{
+    public function render(ContentBlock $block): array
+    {
+        $data = $block->data->toArray();
+        $settings = $block->settings?->toArray() ?? [];
+
+        return [
+            'component' => 'cms/hero',
+            'data' => [
+                'title' => $data['title'] ?? '',
+                'subtitle' => $data['subtitle'] ?? null,
+                'backgroundImage' => $data['backgroundImage'] ?? $data['background_image'] ?? null,
+                'ctaText' => $data['ctaText'] ?? $data['cta_text'] ?? null,
+                'ctaLink' => $data['ctaLink'] ?? $data['cta_link'] ?? null,
+                'fullWidth' => $settings['fullWidth'] ?? $settings['full_width'] ?? false,
+                'padding' => $settings['padding'] ?? 'medium',
+            ],
+        ];
+    }
+
+    public function supports(string $blockType): bool
+    {
+        return $blockType === \App\Domain\Cms\ValueObjects\BlockType::HERO;
+    }
+}
+
diff --git a/src/Domain/Cms/Rendering/ImageBlockRenderer.php b/src/Domain/Cms/Rendering/ImageBlockRenderer.php
new file mode 100644
index 00000000..8ee7f212
--- /dev/null
+++ b/src/Domain/Cms/Rendering/ImageBlockRenderer.php
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+final readonly class ImageBlockRenderer implements BlockRendererInterface
+{
+    public function render(ContentBlock $block): array
+    {
+        $data = $block->data->toArray();
+        $settings = $block->settings?->toArray() ?? [];
+
+        return [
+            'component' => 'cms/image',
+            'data' => [
+                'imageId' => $data['imageId'] ?? $data['image_id'] ?? null,
+                'imageUrl' => $data['imageUrl'] ?? $data['image_url'] ?? null,
+                'caption' => $data['caption'] ?? null,
+                'alt' => $data['alt'] ?? $data['caption'] ?? '',
+                'width' => $settings['width'] ?? null,
+                'height' => $settings['height'] ?? null,
+            ],
+        ];
+    }
+
+    public function supports(string $blockType): bool
+    {
+        return $blockType === \App\Domain\Cms\ValueObjects\BlockType::IMAGE;
+    }
+}
+
diff --git a/src/Domain/Cms/Rendering/TextBlockRenderer.php b/src/Domain/Cms/Rendering/TextBlockRenderer.php
new file mode 100644
index 00000000..e17f1756
--- /dev/null
+++ b/src/Domain/Cms/Rendering/TextBlockRenderer.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Rendering;
+
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+final readonly class TextBlockRenderer implements BlockRendererInterface
+{
+    public function render(ContentBlock $block): array
+    {
+        $data = $block->data->toArray();
+        $settings = $block->settings?->toArray() ?? [];
+
+        return [
+            'component' => 'cms/text',
+            'data' => [
+                'content' => $data['content'] ?? '',
+                'alignment' => $data['alignment'] ?? 'left',
+                'maxWidth' => $settings['maxWidth'] ?? $settings['max_width'] ?? null,
+            ],
+        ];
+    }
+
+    public function supports(string $blockType): bool
+    {
+        return $blockType === \App\Domain\Cms\ValueObjects\BlockType::TEXT;
+    }
+}
+
diff --git a/src/Domain/Cms/Repositories/ContentRepository.php b/src/Domain/Cms/Repositories/ContentRepository.php
new file mode 100644
index 00000000..c2304da2
--- /dev/null
+++ b/src/Domain/Cms/Repositories/ContentRepository.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+
+interface ContentRepository
+{
+    public function save(Content $content): void;
+
+    public function findById(ContentId $id): ?Content;
+
+    public function findBySlug(ContentSlug $slug): ?Content;
+
+    public function findByType(ContentTypeId $typeId, ?ContentStatus $status = null): array;
+
+    public function existsSlug(ContentSlug $slug): bool;
+
+    public function delete(ContentId $id): void;
+
+    public function findPublished(?ContentTypeId $typeId = null): array;
+}
+
diff --git a/src/Domain/Cms/Repositories/ContentTranslationRepository.php b/src/Domain/Cms/Repositories/ContentTranslationRepository.php
new file mode 100644
index 00000000..8233afcf
--- /dev/null
+++ b/src/Domain/Cms/Repositories/ContentTranslationRepository.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\ContentTranslation;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\Locale;
+
+interface ContentTranslationRepository
+{
+    public function save(ContentTranslation $translation): void;
+
+    public function findByContentAndLocale(ContentId $contentId, Locale $locale): ?ContentTranslation;
+
+    public function findByContent(ContentId $contentId): array;
+
+    public function delete(ContentId $contentId, Locale $locale): void;
+}
+
diff --git a/src/Domain/Cms/Repositories/ContentTypeRepository.php b/src/Domain/Cms/Repositories/ContentTypeRepository.php
new file mode 100644
index 00000000..b245cc01
--- /dev/null
+++ b/src/Domain/Cms/Repositories/ContentTypeRepository.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\ContentType;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+
+interface ContentTypeRepository
+{
+    public function save(ContentType $contentType): void;
+
+    public function findById(ContentTypeId $id): ?ContentType;
+
+    public function findBySlug(string $slug): ?ContentType;
+
+    public function findAll(): array;
+
+    public function exists(ContentTypeId $id): bool;
+
+    public function delete(ContentTypeId $id): void;
+}
+
diff --git a/src/Domain/Cms/Repositories/DatabaseContentRepository.php b/src/Domain/Cms/Repositories/DatabaseContentRepository.php
new file mode 100644
index 00000000..b977e62a
--- /dev/null
+++ b/src/Domain/Cms/Repositories/DatabaseContentRepository.php
@@ -0,0 +1,156 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class DatabaseContentRepository implements ContentRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function save(Content $content): void
+    {
+        $sql = 'INSERT INTO contents (id, content_type_id, slug, title, blocks, meta_data, status, author_id, default_locale, published_at, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE
+                content_type_id = VALUES(content_type_id),
+                slug = VALUES(slug),
+                title = VALUES(title),
+                blocks = VALUES(blocks),
+                meta_data = VALUES(meta_data),
+                status = VALUES(status),
+                author_id = VALUES(author_id),
+                default_locale = VALUES(default_locale),
+                published_at = VALUES(published_at),
+                updated_at = VALUES(updated_at)';
+
+        $query = SqlQuery::create($sql, [
+            $content->id->toString(),
+            $content->contentTypeId->toString(),
+            $content->slug->toString(),
+            $content->title,
+            json_encode($content->blocks->toArray(), JSON_THROW_ON_ERROR),
+            $content->metaData ? json_encode($content->metaData->toArray(), JSON_THROW_ON_ERROR) : null,
+            $content->status->value,
+            $content->authorId,
+            $content->defaultLocale->toString(),
+            $content->publishedAt?->format('Y-m-d H:i:s'),
+            $content->createdAt->format('Y-m-d H:i:s'),
+            $content->updatedAt->format('Y-m-d H:i:s'),
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function findById(ContentId $id): ?Content
+    {
+        $sql = 'SELECT * FROM contents WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findBySlug(ContentSlug $slug): ?Content
+    {
+        $sql = 'SELECT * FROM contents WHERE slug = ?';
+        $query = SqlQuery::create($sql, [$slug->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findByType(ContentTypeId $typeId, ?ContentStatus $status = null): array
+    {
+        if ($status !== null) {
+            $sql = 'SELECT * FROM contents WHERE content_type_id = ? AND status = ? ORDER BY created_at DESC';
+            $query = SqlQuery::create($sql, [$typeId->toString(), $status->value]);
+        } else {
+            $sql = 'SELECT * FROM contents WHERE content_type_id = ? ORDER BY created_at DESC';
+            $query = SqlQuery::create($sql, [$typeId->toString()]);
+        }
+
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function existsSlug(ContentSlug $slug): bool
+    {
+        $sql = 'SELECT COUNT(*) as count FROM contents WHERE slug = ?';
+        $query = SqlQuery::create($sql, [$slug->toString()]);
+        $result = $this->connection->query($query);
+        $count = $result->fetch();
+
+        return ($count['count'] ?? 0) > 0;
+    }
+
+    public function delete(ContentId $id): void
+    {
+        $sql = 'DELETE FROM contents WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $this->connection->execute($query);
+    }
+
+    public function findPublished(?ContentTypeId $typeId = null): array
+    {
+        if ($typeId !== null) {
+            $sql = 'SELECT * FROM contents WHERE status = ? AND content_type_id = ? ORDER BY published_at DESC';
+            $query = SqlQuery::create($sql, [ContentStatus::PUBLISHED->value, $typeId->toString()]);
+        } else {
+            $sql = 'SELECT * FROM contents WHERE status = ? ORDER BY published_at DESC';
+            $query = SqlQuery::create($sql, [ContentStatus::PUBLISHED->value]);
+        }
+
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    private function hydrate(array $row): Content
+    {
+        $blocksData = json_decode($row['blocks'], true, 512, JSON_THROW_ON_ERROR);
+        $metaData = null;
+        if (! empty($row['meta_data'])) {
+            $metaDataArray = json_decode($row['meta_data'], true, 512, JSON_THROW_ON_ERROR);
+            $metaData = BlockData::fromArray($metaDataArray);
+        }
+
+        return new Content(
+            id: ContentId::fromString($row['id']),
+            contentTypeId: ContentTypeId::fromString($row['content_type_id']),
+            slug: ContentSlug::fromString($row['slug']),
+            title: $row['title'],
+            blocks: ContentBlocks::fromArray($blocksData),
+            status: ContentStatus::from($row['status']),
+            authorId: $row['author_id'],
+            publishedAt: $row['published_at']
+                ? Timestamp::fromDateTime(new \DateTimeImmutable($row['published_at']))
+                : null,
+            metaData: $metaData,
+            defaultLocale: Locale::fromString($row['default_locale'] ?? 'en'),
+            createdAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['created_at'])),
+            updatedAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['updated_at']))
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Repositories/DatabaseContentTranslationRepository.php b/src/Domain/Cms/Repositories/DatabaseContentTranslationRepository.php
new file mode 100644
index 00000000..7cafe59f
--- /dev/null
+++ b/src/Domain/Cms/Repositories/DatabaseContentTranslationRepository.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\ContentTranslation;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class DatabaseContentTranslationRepository implements ContentTranslationRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function save(ContentTranslation $translation): void
+    {
+        $sql = 'INSERT INTO content_translations (content_id, locale, title, blocks, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE
+                title = VALUES(title),
+                blocks = VALUES(blocks),
+                updated_at = VALUES(updated_at)';
+
+        $query = SqlQuery::create($sql, [
+            $translation->contentId->toString(),
+            $translation->locale->toString(),
+            $translation->title,
+            json_encode($translation->blocks->toArray(), JSON_THROW_ON_ERROR),
+            $translation->createdAt->format('Y-m-d H:i:s'),
+            $translation->updatedAt->format('Y-m-d H:i:s'),
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function findByContentAndLocale(ContentId $contentId, Locale $locale): ?ContentTranslation
+    {
+        $sql = 'SELECT * FROM content_translations WHERE content_id = ? AND locale = ?';
+        $query = SqlQuery::create($sql, [$contentId->toString(), $locale->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findByContent(ContentId $contentId): array
+    {
+        $sql = 'SELECT * FROM content_translations WHERE content_id = ? ORDER BY locale ASC';
+        $query = SqlQuery::create($sql, [$contentId->toString()]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function delete(ContentId $contentId, Locale $locale): void
+    {
+        $sql = 'DELETE FROM content_translations WHERE content_id = ? AND locale = ?';
+        $query = SqlQuery::create($sql, [$contentId->toString(), $locale->toString()]);
+        $this->connection->execute($query);
+    }
+
+    private function hydrate(array $row): ContentTranslation
+    {
+        $blocksData = json_decode($row['blocks'], true, 512, JSON_THROW_ON_ERROR);
+
+        return new ContentTranslation(
+            contentId: ContentId::fromString($row['content_id']),
+            locale: Locale::fromString($row['locale']),
+            title: $row['title'],
+            blocks: ContentBlocks::fromArray($blocksData),
+            createdAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['created_at'])),
+            updatedAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['updated_at']))
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Repositories/DatabaseContentTypeRepository.php b/src/Domain/Cms/Repositories/DatabaseContentTypeRepository.php
new file mode 100644
index 00000000..f2ecee25
--- /dev/null
+++ b/src/Domain/Cms/Repositories/DatabaseContentTypeRepository.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Repositories;
+
+use App\Domain\Cms\Entities\ContentType;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class DatabaseContentTypeRepository implements ContentTypeRepository
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    public function save(ContentType $contentType): void
+    {
+        $sql = 'INSERT INTO content_types (id, name, slug, description, is_system, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?)
+             ON DUPLICATE KEY UPDATE
+                name = VALUES(name),
+                slug = VALUES(slug),
+                description = VALUES(description),
+                is_system = VALUES(is_system),
+                updated_at = VALUES(updated_at)';
+
+        $query = SqlQuery::create($sql, [
+            $contentType->id->toString(),
+            $contentType->name,
+            $contentType->slug,
+            $contentType->description,
+            $contentType->isSystem ? 1 : 0,
+            $contentType->createdAt->format('Y-m-d H:i:s'),
+            $contentType->updatedAt->format('Y-m-d H:i:s'),
+        ]);
+
+        $this->connection->execute($query);
+    }
+
+    public function findById(ContentTypeId $id): ?ContentType
+    {
+        $sql = 'SELECT * FROM content_types WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findBySlug(string $slug): ?ContentType
+    {
+        $sql = 'SELECT * FROM content_types WHERE slug = ?';
+        $query = SqlQuery::create($sql, [$slug]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row ? $this->hydrate($row) : null;
+    }
+
+    public function findAll(): array
+    {
+        $sql = 'SELECT * FROM content_types ORDER BY name ASC';
+        $query = SqlQuery::create($sql);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        return array_map(fn (array $row) => $this->hydrate($row), $rows);
+    }
+
+    public function exists(ContentTypeId $id): bool
+    {
+        $sql = 'SELECT COUNT(*) as count FROM content_types WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $result = $this->connection->query($query);
+        $count = $result->fetch();
+
+        return ($count['count'] ?? 0) > 0;
+    }
+
+    public function delete(ContentTypeId $id): void
+    {
+        $sql = 'DELETE FROM content_types WHERE id = ?';
+        $query = SqlQuery::create($sql, [$id->toString()]);
+        $this->connection->execute($query);
+    }
+
+    private function hydrate(array $row): ContentType
+    {
+        return new ContentType(
+            id: ContentTypeId::fromString($row['id']),
+            name: $row['name'],
+            slug: $row['slug'],
+            description: $row['description'],
+            isSystem: (bool) $row['is_system'],
+            createdAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['created_at'])),
+            updatedAt: Timestamp::fromDateTime(new \DateTimeImmutable($row['updated_at']))
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/Services/BlockTypeRegistry.php b/src/Domain/Cms/Services/BlockTypeRegistry.php
new file mode 100644
index 00000000..b1450db3
--- /dev/null
+++ b/src/Domain/Cms/Services/BlockTypeRegistry.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\ValueObjects\BlockType;
+
+final readonly class BlockTypeRegistry
+{
+    /**
+     * @var array<string, BlockType>
+     */
+    private array $registeredTypes;
+
+    public function __construct()
+    {
+        $this->registerSystemTypes();
+    }
+
+    private function registerSystemTypes(): void
+    {
+        $systemTypes = [
+            BlockType::hero(),
+            BlockType::text(),
+            BlockType::image(),
+            BlockType::gallery(),
+            BlockType::cta(),
+            BlockType::video(),
+            BlockType::form(),
+            BlockType::columns(),
+            BlockType::quote(),
+            BlockType::separator(),
+        ];
+
+        foreach ($systemTypes as $type) {
+            $this->registeredTypes[$type->toString()] = $type;
+        }
+    }
+
+    public function register(BlockType $blockType): void
+    {
+        if (isset($this->registeredTypes[$blockType->toString()])) {
+            throw new \InvalidArgumentException("Block type '{$blockType->toString()}' is already registered");
+        }
+
+        $this->registeredTypes[$blockType->toString()] = $blockType;
+    }
+
+    public function get(string $value): ?BlockType
+    {
+        return $this->registeredTypes[$value] ?? null;
+    }
+
+    public function has(string $value): bool
+    {
+        return isset($this->registeredTypes[$value]);
+    }
+
+    /**
+     * @return array<string, BlockType>
+     */
+    public function getAll(): array
+    {
+        return $this->registeredTypes;
+    }
+
+    /**
+     * @return BlockType[]
+     */
+    public function getSystemTypes(): array
+    {
+        return array_filter(
+            $this->registeredTypes,
+            fn (BlockType $type) => $type->isSystem()
+        );
+    }
+
+    /**
+     * @return BlockType[]
+     */
+    public function getCustomTypes(): array
+    {
+        return array_filter(
+            $this->registeredTypes,
+            fn (BlockType $type) => ! $type->isSystem()
+        );
+    }
+
+    public function validate(BlockType $blockType): void
+    {
+        if (! $this->has($blockType->toString())) {
+            throw new \InvalidArgumentException("Block type '{$blockType->toString()}' is not registered");
+        }
+    }
+}
+
diff --git a/src/Domain/Cms/Services/BlockValidator.php b/src/Domain/Cms/Services/BlockValidator.php
new file mode 100644
index 00000000..02583060
--- /dev/null
+++ b/src/Domain/Cms/Services/BlockValidator.php
@@ -0,0 +1,143 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Exceptions\InvalidBlockException;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\BlockId;
+use App\Domain\Cms\ValueObjects\BlockType;
+use App\Domain\Cms\ValueObjects\ContentBlock;
+
+final readonly class BlockValidator
+{
+    public function __construct(
+        private BlockTypeRegistry $blockTypeRegistry
+    ) {
+    }
+
+    public function validate(ContentBlock $block): void
+    {
+        // Validate block type is registered
+        $this->blockTypeRegistry->validate($block->type);
+
+        // Validate based on block type
+        $blockTypeString = $block->type->toString();
+        match ($blockTypeString) {
+            BlockType::HERO => $this->validateHeroBlock($block->blockId, $block->data),
+            BlockType::TEXT => $this->validateTextBlock($block->blockId, $block->data),
+            BlockType::IMAGE => $this->validateImageBlock($block->blockId, $block->data),
+            BlockType::GALLERY => $this->validateGalleryBlock($block->blockId, $block->data),
+            BlockType::CTA => $this->validateCtaBlock($block->blockId, $block->data),
+            BlockType::VIDEO => $this->validateVideoBlock($block->blockId, $block->data),
+            BlockType::FORM => $this->validateFormBlock($block->blockId, $block->data),
+            BlockType::COLUMNS => $this->validateColumnsBlock($block->blockId, $block->data),
+            BlockType::QUOTE => $this->validateQuoteBlock($block->blockId, $block->data),
+            BlockType::SEPARATOR => $this->validateSeparatorBlock($block->blockId, $block->data),
+            default => $this->validateGenericBlock($block->blockId, $block->data),
+        };
+    }
+
+    private function validateGenericBlock(BlockId $blockId, BlockData $data): void
+    {
+        // For custom block types, only validate that data is present
+        // Custom validation can be added via BlockTypeRegistry extensions
+    }
+
+    private function validateHeroBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('title')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'title');
+        }
+
+        if (! is_string($data->get('title'))) {
+            throw InvalidBlockException::invalidBlockData($blockId, 'title must be a string');
+        }
+    }
+
+    private function validateTextBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('content')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'content');
+        }
+
+        if (! is_string($data->get('content'))) {
+            throw InvalidBlockException::invalidBlockData($blockId, 'content must be a string');
+        }
+    }
+
+    private function validateImageBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('imageId') && ! $data->has('image_url')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'imageId or image_url');
+        }
+    }
+
+    private function validateGalleryBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('images')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'images');
+        }
+
+        $images = $data->get('images');
+        if (! is_array($images)) {
+            throw InvalidBlockException::invalidBlockData($blockId, 'images must be an array');
+        }
+    }
+
+    private function validateCtaBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('buttonText') && ! $data->has('button_text')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'buttonText or button_text');
+        }
+
+        if (! $data->has('buttonLink') && ! $data->has('button_link')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'buttonLink or button_link');
+        }
+    }
+
+    private function validateVideoBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('videoId') && ! $data->has('video_url') && ! $data->has('embed_url')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'videoId, video_url, or embed_url');
+        }
+    }
+
+    private function validateFormBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('formId') && ! $data->has('form_id')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'formId or form_id');
+        }
+    }
+
+    private function validateColumnsBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('columns')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'columns');
+        }
+
+        $columns = $data->get('columns');
+        if (! is_array($columns)) {
+            throw InvalidBlockException::invalidBlockData($blockId, 'columns must be an array');
+        }
+    }
+
+    private function validateQuoteBlock(BlockId $blockId, BlockData $data): void
+    {
+        if (! $data->has('quote')) {
+            throw InvalidBlockException::missingRequiredField($blockId, 'quote');
+        }
+
+        if (! is_string($data->get('quote'))) {
+            throw InvalidBlockException::invalidBlockData($blockId, 'quote must be a string');
+        }
+    }
+
+    private function validateSeparatorBlock(BlockId $blockId, BlockData $data): void
+    {
+        // Separator blocks don't require any data
+        // But they can have optional styling data
+    }
+}
+
diff --git a/src/Domain/Cms/Services/ContentLocalizationService.php b/src/Domain/Cms/Services/ContentLocalizationService.php
new file mode 100644
index 00000000..656c6fc0
--- /dev/null
+++ b/src/Domain/Cms/Services/ContentLocalizationService.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Entities\ContentTranslation;
+use App\Domain\Cms\Repositories\ContentTranslationRepository;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\DateTime\Clock;
+
+final readonly class ContentLocalizationService
+{
+    public function __construct(
+        private ContentTranslationRepository $translationRepository,
+        private Clock $clock
+    ) {
+    }
+
+    public function createTranslation(
+        ContentId $contentId,
+        Locale $locale,
+        string $title,
+        ContentBlocks $blocks
+    ): ContentTranslation {
+        $translation = ContentTranslation::create(
+            clock: $this->clock,
+            contentId: $contentId,
+            locale: $locale,
+            title: $title,
+            blocks: $blocks
+        );
+
+        $this->translationRepository->save($translation);
+
+        return $translation;
+    }
+
+    public function updateTranslation(
+        ContentId $contentId,
+        Locale $locale,
+        ?string $title = null,
+        ?ContentBlocks $blocks = null
+    ): ContentTranslation {
+        $translation = $this->translationRepository->findByContentAndLocale($contentId, $locale);
+
+        if ($translation === null) {
+            throw new \DomainException("Translation for content '{$contentId->toString()}' and locale '{$locale->toString()}' not found");
+        }
+
+        if ($title !== null) {
+            $translation = $translation->withTitle($title);
+        }
+
+        if ($blocks !== null) {
+            $translation = $translation->withBlocks($blocks);
+        }
+
+        $this->translationRepository->save($translation);
+
+        return $translation;
+    }
+
+    public function getTranslation(ContentId $contentId, Locale $locale): ?ContentTranslation
+    {
+        return $this->translationRepository->findByContentAndLocale($contentId, $locale);
+    }
+
+    public function getContentForLocale(Content $content, Locale $locale): Content
+    {
+        // If locale matches default locale, return original content
+        if ($content->defaultLocale->equals($locale)) {
+            return $content;
+        }
+
+        // Try to find translation
+        $translation = $this->getTranslation($content->id, $locale);
+
+        if ($translation === null) {
+            // Fallback to default locale
+            return $content;
+        }
+
+        // Return content with translated data
+        return $content->withTitle($translation->title)->withBlocks($translation->blocks);
+    }
+
+    /**
+     * @return ContentTranslation[]
+     */
+    public function getAllTranslations(ContentId $contentId): array
+    {
+        return $this->translationRepository->findByContent($contentId);
+    }
+
+    public function deleteTranslation(ContentId $contentId, Locale $locale): void
+    {
+        $this->translationRepository->delete($contentId, $locale);
+    }
+}
+
diff --git a/src/Domain/Cms/Services/ContentRenderer.php b/src/Domain/Cms/Services/ContentRenderer.php
new file mode 100644
index 00000000..28cecede
--- /dev/null
+++ b/src/Domain/Cms/Services/ContentRenderer.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Rendering\BlockRendererInterface;
+use App\Domain\Cms\Rendering\BlockRendererRegistry;
+use App\Domain\Cms\Rendering\DefaultBlockRenderer;
+use App\Domain\Cms\ValueObjects\ContentBlock;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\View\ComponentRenderer;
+
+final readonly class ContentRenderer
+{
+    public function __construct(
+        private BlockRendererRegistry $blockRendererRegistry,
+        private ComponentRenderer $componentRenderer,
+        private ContentLocalizationService $localizationService,
+        private DefaultBlockRenderer $defaultRenderer
+    ) {
+    }
+
+    /**
+     * Render content to HTML
+     *
+     * @param Locale|null $locale Optional locale. If not provided, uses content's default locale
+     * @return string Rendered HTML
+     */
+    public function render(Content $content, ?Locale $locale = null): string
+    {
+        // Get localized content if locale is provided
+        $targetLocale = $locale ?? $content->defaultLocale;
+        $contentToRender = $this->localizationService->getContentForLocale($content, $targetLocale);
+
+        $html = [];
+        foreach ($contentToRender->blocks as $block) {
+            $html[] = $this->renderBlock($block);
+        }
+
+        return implode("\n", $html);
+    }
+
+    /**
+     * Render a single block to HTML
+     */
+    public function renderBlock(ContentBlock $block): string
+    {
+        $renderer = $this->blockRendererRegistry->getRenderer($block->type->toString());
+
+        if ($renderer === null) {
+            $renderer = $this->defaultRenderer;
+        }
+
+        $rendered = $renderer->render($block);
+
+        return $this->componentRenderer->render(
+            $rendered['component'],
+            $rendered['data']
+        );
+    }
+
+    /**
+     * Render blocks to component data array (for JSON API responses)
+     *
+     * @return array<array{component: string, data: array<string, mixed>}>
+     */
+    public function renderBlocksToComponentData(Content $content, ?Locale $locale = null): array
+    {
+        $targetLocale = $locale ?? $content->defaultLocale;
+        $contentToRender = $this->localizationService->getContentForLocale($content, $targetLocale);
+
+        $componentData = [];
+        foreach ($contentToRender->blocks as $block) {
+            $renderer = $this->blockRendererRegistry->getRenderer($block->type->toString());
+            $renderer = $renderer ?? $this->defaultRenderer;
+
+            $componentData[] = $renderer->render($block);
+        }
+
+        return $componentData;
+    }
+}
+
diff --git a/src/Domain/Cms/Services/ContentService.php b/src/Domain/Cms/Services/ContentService.php
new file mode 100644
index 00000000..7ac4a863
--- /dev/null
+++ b/src/Domain/Cms/Services/ContentService.php
@@ -0,0 +1,202 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Entities\Content;
+use App\Domain\Cms\Enums\ContentStatus;
+use App\Domain\Cms\Exceptions\ContentNotFoundException;
+use App\Domain\Cms\Exceptions\DuplicateSlugException;
+use App\Domain\Cms\Exceptions\InvalidContentStatusException;
+use App\Domain\Cms\Repositories\ContentRepository;
+use App\Domain\Cms\ValueObjects\BlockData;
+use App\Domain\Cms\ValueObjects\ContentBlocks;
+use App\Domain\Cms\ValueObjects\ContentId;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Domain\Cms\ValueObjects\Locale;
+use App\Framework\DateTime\Clock;
+
+final readonly class ContentService
+{
+    public function __construct(
+        private ContentRepository $contentRepository,
+        private BlockValidator $blockValidator,
+        private SlugGenerator $slugGenerator,
+        private Clock $clock
+    ) {
+    }
+
+    public function create(
+        ContentTypeId $contentTypeId,
+        string $title,
+        ContentBlocks $blocks,
+        Locale $defaultLocale,
+        ?ContentSlug $slug = null,
+        ?string $authorId = null,
+        ?BlockData $metaData = null
+    ): Content {
+        // Validate all blocks
+        foreach ($blocks as $block) {
+            $this->blockValidator->validate($block);
+        }
+
+        // Generate slug if not provided
+        $contentSlug = $slug ?? $this->slugGenerator->generateUniqueFromTitle($title);
+
+        // Check for duplicate slug
+        if ($this->contentRepository->existsSlug($contentSlug)) {
+            throw DuplicateSlugException::forSlug($contentSlug);
+        }
+
+        // Create content
+        $content = Content::create(
+            clock: $this->clock,
+            contentTypeId: $contentTypeId,
+            slug: $contentSlug,
+            title: $title,
+            blocks: $blocks,
+            defaultLocale: $defaultLocale,
+            authorId: $authorId,
+            metaData: $metaData
+        );
+
+        // Save to repository
+        $this->contentRepository->save($content);
+
+        return $content;
+    }
+
+    public function findById(ContentId $id): Content
+    {
+        $content = $this->contentRepository->findById($id);
+
+        if ($content === null) {
+            throw ContentNotFoundException::forId($id);
+        }
+
+        return $content;
+    }
+
+    public function findBySlug(ContentSlug $slug): Content
+    {
+        $content = $this->contentRepository->findBySlug($slug);
+
+        if ($content === null) {
+            throw ContentNotFoundException::forSlug($slug);
+        }
+
+        return $content;
+    }
+
+    public function updateTitle(ContentId $id, string $title): Content
+    {
+        $content = $this->findById($id);
+        $updated = $content->withTitle($title);
+
+        $this->contentRepository->save($updated);
+
+        return $updated;
+    }
+
+    public function updateSlug(ContentId $id, ContentSlug $slug): Content
+    {
+        // Check for duplicate slug (excluding current content)
+        $existing = $this->contentRepository->findBySlug($slug);
+        if ($existing !== null && ! $existing->id->equals($this->findById($id)->id)) {
+            throw DuplicateSlugException::forSlug($slug);
+        }
+
+        $content = $this->findById($id);
+        $updated = $content->withSlug($slug);
+
+        $this->contentRepository->save($updated);
+
+        return $updated;
+    }
+
+    public function updateBlocks(ContentId $id, ContentBlocks $blocks): Content
+    {
+        // Validate all blocks
+        foreach ($blocks as $block) {
+            $this->blockValidator->validate($block);
+        }
+
+        $content = $this->findById($id);
+        $updated = $content->withBlocks($blocks);
+
+        $this->contentRepository->save($updated);
+
+        return $updated;
+    }
+
+    public function updateMetaData(ContentId $id, ?BlockData $metaData): Content
+    {
+        $content = $this->findById($id);
+        $updated = $content->withMetaData($metaData);
+
+        $this->contentRepository->save($updated);
+
+        return $updated;
+    }
+
+    public function publish(ContentId $id): Content
+    {
+        $content = $this->findById($id);
+
+        if (! $content->status->canTransitionTo(ContentStatus::PUBLISHED)) {
+            throw InvalidContentStatusException::invalidTransition($content->status, ContentStatus::PUBLISHED);
+        }
+
+        $published = $content->withStatus(ContentStatus::PUBLISHED);
+        $this->contentRepository->save($published);
+
+        return $published;
+    }
+
+    public function unpublish(ContentId $id): Content
+    {
+        $content = $this->findById($id);
+
+        if (! $content->status->canTransitionTo(ContentStatus::DRAFT)) {
+            throw InvalidContentStatusException::invalidTransition($content->status, ContentStatus::DRAFT);
+        }
+
+        $unpublished = $content->withStatus(ContentStatus::DRAFT);
+        $this->contentRepository->save($unpublished);
+
+        return $unpublished;
+    }
+
+    public function archive(ContentId $id): Content
+    {
+        $content = $this->findById($id);
+
+        if (! $content->status->canTransitionTo(ContentStatus::ARCHIVED)) {
+            throw InvalidContentStatusException::invalidTransition($content->status, ContentStatus::ARCHIVED);
+        }
+
+        $archived = $content->withStatus(ContentStatus::ARCHIVED);
+        $this->contentRepository->save($archived);
+
+        return $archived;
+    }
+
+    public function delete(ContentId $id): void
+    {
+        $content = $this->findById($id);
+        $this->contentRepository->delete($content->id);
+    }
+
+    public function findByType(ContentTypeId $typeId, ?ContentStatus $status = null): array
+    {
+        return $this->contentRepository->findByType($typeId, $status);
+    }
+
+    public function findPublished(?ContentTypeId $typeId = null): array
+    {
+        return $this->contentRepository->findPublished($typeId);
+    }
+}
+
diff --git a/src/Domain/Cms/Services/ContentTypeService.php b/src/Domain/Cms/Services/ContentTypeService.php
new file mode 100644
index 00000000..3816b980
--- /dev/null
+++ b/src/Domain/Cms/Services/ContentTypeService.php
@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Entities\ContentType;
+use App\Domain\Cms\Exceptions\CannotDeleteSystemContentTypeException;
+use App\Domain\Cms\Exceptions\ContentTypeNotFoundException;
+use App\Domain\Cms\Exceptions\DuplicateContentTypeSlugException;
+use App\Domain\Cms\Repositories\ContentTypeRepository;
+use App\Domain\Cms\ValueObjects\ContentTypeId;
+use App\Framework\DateTime\Clock;
+
+final readonly class ContentTypeService
+{
+    public function __construct(
+        private ContentTypeRepository $contentTypeRepository,
+        private Clock $clock
+    ) {
+    }
+
+    public function create(
+        string $name,
+        string $slug,
+        ?string $description = null,
+        bool $isSystem = false
+    ): ContentType {
+        // Prüfe auf doppelte Slugs
+        if ($this->contentTypeRepository->findBySlug($slug) !== null) {
+            throw DuplicateContentTypeSlugException::forSlug($slug);
+        }
+
+        $contentType = ContentType::create(
+            clock: $this->clock,
+            id: ContentTypeId::fromString($slug),
+            name: $name,
+            slug: $slug,
+            description: $description,
+            isSystem: $isSystem
+        );
+
+        $this->contentTypeRepository->save($contentType);
+
+        return $contentType;
+    }
+
+    public function update(
+        ContentTypeId $id,
+        ?string $name = null,
+        ?string $slug = null,
+        ?string $description = null
+    ): ContentType {
+        $contentType = $this->contentTypeRepository->findById($id);
+        if ($contentType === null) {
+            throw ContentTypeNotFoundException::forId($id);
+        }
+
+        // Prüfe auf doppelte Slugs, wenn Slug geändert wird
+        if ($slug !== null && $slug !== $contentType->slug) {
+            if ($this->contentTypeRepository->findBySlug($slug) !== null) {
+                throw DuplicateContentTypeSlugException::forSlug($slug);
+            }
+        }
+
+        if ($name !== null) {
+            $contentType = $contentType->withName($name);
+        }
+
+        if ($slug !== null) {
+            // Slug kann nicht direkt geändert werden, da es Teil der ID ist
+            // Für Slug-Änderung müsste ein neuer ContentType erstellt werden
+            // Hier nur Validierung, keine Änderung
+            if ($slug !== $contentType->slug) {
+                throw new \InvalidArgumentException('ContentType slug cannot be changed after creation');
+            }
+        }
+
+        if ($description !== null) {
+            $contentType = $contentType->withDescription($description);
+        }
+
+        $this->contentTypeRepository->save($contentType);
+
+        return $contentType;
+    }
+
+    public function findById(ContentTypeId $id): ContentType
+    {
+        $contentType = $this->contentTypeRepository->findById($id);
+        if ($contentType === null) {
+            throw ContentTypeNotFoundException::forId($id);
+        }
+
+        return $contentType;
+    }
+
+    public function findBySlug(string $slug): ContentType
+    {
+        $contentType = $this->contentTypeRepository->findBySlug($slug);
+        if ($contentType === null) {
+            throw new \RuntimeException("Content type with slug '{$slug}' not found");
+        }
+
+        return $contentType;
+    }
+
+    /**
+     * @return ContentType[]
+     */
+    public function findAll(): array
+    {
+        return $this->contentTypeRepository->findAll();
+    }
+
+    public function delete(ContentTypeId $id): void
+    {
+        $contentType = $this->contentTypeRepository->findById($id);
+        if ($contentType === null) {
+            throw ContentTypeNotFoundException::forId($id);
+        }
+
+        if ($contentType->isSystem) {
+            throw CannotDeleteSystemContentTypeException::forId($id);
+        }
+
+        // TODO: Optional - Prüfe ob ContentType noch von Content verwendet wird
+        // $this->checkContentTypeInUse($id);
+
+        $this->contentTypeRepository->delete($id);
+    }
+}
+
diff --git a/src/Domain/Cms/Services/SlugGenerator.php b/src/Domain/Cms/Services/SlugGenerator.php
new file mode 100644
index 00000000..0445780c
--- /dev/null
+++ b/src/Domain/Cms/Services/SlugGenerator.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\Services;
+
+use App\Domain\Cms\Repositories\ContentRepository;
+use App\Domain\Cms\ValueObjects\ContentSlug;
+
+final readonly class SlugGenerator
+{
+    public function __construct(
+        private ContentRepository $contentRepository
+    ) {
+    }
+
+    public function generateFromTitle(string $title): ContentSlug
+    {
+        // Convert to lowercase
+        $slug = mb_strtolower($title, 'UTF-8');
+
+        // Replace spaces and special characters with hyphens
+        $slug = preg_replace('/[^a-z0-9]+/', '-', $slug);
+
+        // Remove leading/trailing hyphens
+        $slug = trim($slug, '-');
+
+        // Limit length
+        if (strlen($slug) > 255) {
+            $slug = substr($slug, 0, 255);
+            $slug = rtrim($slug, '-');
+        }
+
+        // Ensure slug is not empty
+        if (empty($slug)) {
+            $slug = 'content-' . time();
+        }
+
+        return ContentSlug::fromString($slug);
+    }
+
+    public function generateUniqueFromTitle(string $title): ContentSlug
+    {
+        $baseSlug = $this->generateFromTitle($title);
+        $slug = $baseSlug;
+
+        $counter = 1;
+        while ($this->contentRepository->existsSlug($slug)) {
+            $slugString = $baseSlug->toString() . '-' . $counter;
+            $slug = ContentSlug::fromString($slugString);
+            $counter++;
+        }
+
+        return $slug;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/BlockData.php b/src/Domain/Cms/ValueObjects/BlockData.php
new file mode 100644
index 00000000..d97c4ec2
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/BlockData.php
@@ -0,0 +1,125 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class BlockData
+{
+    /**
+     * @param array<string, mixed> $data
+     */
+    public function __construct(
+        private array $data
+    ) {
+        $this->validate();
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self($data);
+    }
+
+    public static function empty(): self
+    {
+        return new self([]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return $this->data;
+    }
+
+    public function get(string $key, mixed $default = null): mixed
+    {
+        return $this->data[$key] ?? $default;
+    }
+
+    public function has(string $key): bool
+    {
+        return array_key_exists($key, $this->data);
+    }
+
+    public function with(string $key, mixed $value): self
+    {
+        $newData = $this->data;
+        $newData[$key] = $value;
+
+        return new self($newData);
+    }
+
+    public function without(string $key): self
+    {
+        $newData = $this->data;
+        unset($newData[$key]);
+
+        return new self($newData);
+    }
+
+    public function merge(array $data): self
+    {
+        return new self(array_merge($this->data, $data));
+    }
+
+    private function validate(): void
+    {
+        // Validate that all keys are strings
+        foreach (array_keys($this->data) as $key) {
+            if (! is_string($key)) {
+                throw new \InvalidArgumentException('BlockData keys must be strings');
+            }
+        }
+
+        // Validate that values are serializable
+        foreach ($this->data as $key => $value) {
+            if (! $this->isValidValue($value)) {
+                throw new \InvalidArgumentException("BlockData value for key '{$key}' is not serializable");
+            }
+        }
+    }
+
+    private function isValidValue(mixed $value): bool
+    {
+        // Allow scalar values and null
+        if (is_scalar($value) || is_null($value)) {
+            return true;
+        }
+
+        // Allow objects that can be converted to string
+        if (is_object($value)) {
+            return method_exists($value, '__toString') ||
+                   $value instanceof \Stringable ||
+                   $value instanceof \BackedEnum ||
+                   $value instanceof \JsonSerializable;
+        }
+
+        // For arrays, check if it's a simple list of scalar values
+        if (is_array($value)) {
+            if (empty($value)) {
+                return true;
+            }
+
+            // Check if it's a list (sequential numeric keys starting from 0)
+            if (array_is_list($value)) {
+                return array_reduce(
+                    $value,
+                    fn (bool $carry, mixed $item) => $carry && $this->isValidValue($item),
+                    true
+                );
+            }
+
+            // For associative arrays, recursively validate
+            return array_reduce(
+                array_keys($value),
+                fn (bool $carry, mixed $key) => $carry && is_string($key) && $this->isValidValue($value[$key]),
+                true
+            );
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/BlockId.php b/src/Domain/Cms/ValueObjects/BlockId.php
new file mode 100644
index 00000000..558e1332
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/BlockId.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class BlockId
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Block ID cannot be empty');
+        }
+
+        // Block IDs should be alphanumeric with hyphens and underscores
+        if (! preg_match('/^[a-z0-9\-_]+$/', $value)) {
+            throw new \InvalidArgumentException('Block ID must contain only lowercase letters, numbers, hyphens, and underscores');
+        }
+
+        // Max length for block IDs
+        if (strlen($value) > 100) {
+            throw new \InvalidArgumentException('Block ID cannot exceed 100 characters');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public static function generate(string $prefix = 'block'): self
+    {
+        $unique = $prefix . '_' . uniqid('', true);
+        $unique = str_replace('.', '_', $unique);
+
+        return new self($unique);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/BlockSettings.php b/src/Domain/Cms/ValueObjects/BlockSettings.php
new file mode 100644
index 00000000..7a0bdebc
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/BlockSettings.php
@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class BlockSettings
+{
+    /**
+     * @param array<string, mixed> $settings
+     */
+    public function __construct(
+        private array $settings
+    ) {
+        $this->validate();
+    }
+
+    public static function fromArray(array $settings): self
+    {
+        return new self($settings);
+    }
+
+    public static function empty(): self
+    {
+        return new self([]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return $this->settings;
+    }
+
+    public function get(string $key, mixed $default = null): mixed
+    {
+        return $this->settings[$key] ?? $default;
+    }
+
+    public function has(string $key): bool
+    {
+        return array_key_exists($key, $this->settings);
+    }
+
+    public function with(string $key, mixed $value): self
+    {
+        $newSettings = $this->settings;
+        $newSettings[$key] = $value;
+
+        return new self($newSettings);
+    }
+
+    public function without(string $key): self
+    {
+        $newSettings = $this->settings;
+        unset($newSettings[$key]);
+
+        return new self($newSettings);
+    }
+
+    private function validate(): void
+    {
+        // Validate that all keys are strings
+        foreach (array_keys($this->settings) as $key) {
+            if (! is_string($key)) {
+                throw new \InvalidArgumentException('BlockSettings keys must be strings');
+            }
+        }
+
+        // Validate that values are serializable
+        foreach ($this->settings as $key => $value) {
+            if (! $this->isValidValue($value)) {
+                throw new \InvalidArgumentException("BlockSettings value for key '{$key}' is not serializable");
+            }
+        }
+    }
+
+    private function isValidValue(mixed $value): bool
+    {
+        // Allow scalar values and null
+        if (is_scalar($value) || is_null($value)) {
+            return true;
+        }
+
+        // Allow objects that can be converted to string
+        if (is_object($value)) {
+            return method_exists($value, '__toString') ||
+                   $value instanceof \Stringable ||
+                   $value instanceof \BackedEnum ||
+                   $value instanceof \JsonSerializable;
+        }
+
+        // For arrays, recursively validate
+        if (is_array($value)) {
+            if (empty($value)) {
+                return true;
+            }
+
+            if (array_is_list($value)) {
+                return array_reduce(
+                    $value,
+                    fn (bool $carry, mixed $item) => $carry && $this->isValidValue($item),
+                    true
+                );
+            }
+
+            return array_reduce(
+                array_keys($value),
+                fn (bool $carry, mixed $key) => $carry && is_string($key) && $this->isValidValue($value[$key]),
+                true
+            );
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/BlockType.php b/src/Domain/Cms/ValueObjects/BlockType.php
new file mode 100644
index 00000000..7c965efb
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/BlockType.php
@@ -0,0 +1,141 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class BlockType
+{
+    // System Block Types
+    public const string HERO = 'hero';
+    public const string TEXT = 'text';
+    public const string IMAGE = 'image';
+    public const string GALLERY = 'gallery';
+    public const string CTA = 'cta';
+    public const string VIDEO = 'video';
+    public const string FORM = 'form';
+    public const string COLUMNS = 'columns';
+    public const string QUOTE = 'quote';
+    public const string SEPARATOR = 'separator';
+
+    private function __construct(
+        private string $value,
+        private bool $isSystem
+    ) {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Block type cannot be empty');
+        }
+
+        // Block types should be lowercase alphanumeric with hyphens/underscores
+        if (! preg_match('/^[a-z0-9\-_]+$/', $value)) {
+            throw new \InvalidArgumentException('Block type must contain only lowercase letters, numbers, hyphens, and underscores');
+        }
+
+        if (strlen($value) > 50) {
+            throw new \InvalidArgumentException('Block type cannot exceed 50 characters');
+        }
+    }
+
+    public static function fromString(string $value, bool $isSystem = false): self
+    {
+        return new self($value, $isSystem);
+    }
+
+    public static function hero(): self
+    {
+        return new self(self::HERO, true);
+    }
+
+    public static function text(): self
+    {
+        return new self(self::TEXT, true);
+    }
+
+    public static function image(): self
+    {
+        return new self(self::IMAGE, true);
+    }
+
+    public static function gallery(): self
+    {
+        return new self(self::GALLERY, true);
+    }
+
+    public static function cta(): self
+    {
+        return new self(self::CTA, true);
+    }
+
+    public static function video(): self
+    {
+        return new self(self::VIDEO, true);
+    }
+
+    public static function form(): self
+    {
+        return new self(self::FORM, true);
+    }
+
+    public static function columns(): self
+    {
+        return new self(self::COLUMNS, true);
+    }
+
+    public static function quote(): self
+    {
+        return new self(self::QUOTE, true);
+    }
+
+    public static function separator(): self
+    {
+        return new self(self::SEPARATOR, true);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function isSystem(): bool
+    {
+        return $this->isSystem;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function requiresMedia(): bool
+    {
+        return in_array($this->value, [
+            self::HERO,
+            self::IMAGE,
+            self::GALLERY,
+            self::VIDEO,
+        ], true);
+    }
+
+    public function getLabel(): string
+    {
+        return match ($this->value) {
+            self::HERO => 'Hero Section',
+            self::TEXT => 'Text Block',
+            self::IMAGE => 'Image',
+            self::GALLERY => 'Gallery',
+            self::CTA => 'Call to Action',
+            self::VIDEO => 'Video',
+            self::FORM => 'Form',
+            self::COLUMNS => 'Columns',
+            self::QUOTE => 'Quote',
+            self::SEPARATOR => 'Separator',
+            default => ucfirst(str_replace(['-', '_'], ' ', $this->value)),
+        };
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/ContentBlock.php b/src/Domain/Cms/ValueObjects/ContentBlock.php
new file mode 100644
index 00000000..7be2ac21
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/ContentBlock.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+use App\Domain\Cms\ValueObjects\BlockType;
+
+final readonly class ContentBlock
+{
+    public function __construct(
+        public BlockType $type,
+        public BlockId $blockId,
+        public BlockData $data,
+        public ?BlockSettings $settings = null
+    ) {
+    }
+
+    public static function create(
+        BlockType $type,
+        BlockId $blockId,
+        BlockData $data,
+        ?BlockSettings $settings = null
+    ): self {
+        return new self($type, $blockId, $data, $settings);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->blockId->toString(),
+            'type' => $this->type->toString(),
+            'data' => $this->data->toArray(),
+            'settings' => $this->settings?->toArray(),
+        ];
+    }
+
+    /**
+     * @param array<string, mixed> $data
+     */
+    public static function fromArray(array $data): self
+    {
+        if (! isset($data['id']) || ! isset($data['type']) || ! isset($data['data'])) {
+            throw new \InvalidArgumentException('Invalid block data: missing required fields (id, type, data)');
+        }
+
+        return new self(
+            type: BlockType::fromString($data['type']),
+            blockId: BlockId::fromString($data['id']),
+            data: BlockData::fromArray($data['data']),
+            settings: isset($data['settings']) && is_array($data['settings'])
+                ? BlockSettings::fromArray($data['settings'])
+                : null
+        );
+    }
+
+    public function withData(BlockData $data): self
+    {
+        return new self(
+            type: $this->type,
+            blockId: $this->blockId,
+            data: $data,
+            settings: $this->settings
+        );
+    }
+
+    public function withSettings(?BlockSettings $settings): self
+    {
+        return new self(
+            type: $this->type,
+            blockId: $this->blockId,
+            data: $this->data,
+            settings: $settings
+        );
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/ContentBlocks.php b/src/Domain/Cms/ValueObjects/ContentBlocks.php
new file mode 100644
index 00000000..1430b89b
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/ContentBlocks.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class ContentBlocks implements \IteratorAggregate, \Countable
+{
+    /**
+     * @param ContentBlock[] $blocks
+     */
+    public function __construct(
+        private array $blocks
+    ) {
+        $this->validateUniqueBlockIds();
+    }
+
+    /**
+     * @param array<array<string, mixed>> $blocks
+     */
+    public static function fromArray(array $blocks): self
+    {
+        return new self(
+            array_map(
+                fn (array $block) => ContentBlock::fromArray($block),
+                $blocks
+            )
+        );
+    }
+
+    public static function empty(): self
+    {
+        return new self([]);
+    }
+
+    public function add(ContentBlock $block): self
+    {
+        // Prüfe auf doppelte Block IDs
+        foreach ($this->blocks as $existing) {
+            if ($existing->blockId === $block->blockId) {
+                throw new \DomainException("Duplicate block ID: {$block->blockId}");
+            }
+        }
+
+        return new self([...$this->blocks, $block]);
+    }
+
+    public function remove(BlockId $blockId): self
+    {
+        $filtered = array_filter(
+            $this->blocks,
+            fn (ContentBlock $block) => ! $block->blockId->equals($blockId)
+        );
+
+        return new self(array_values($filtered));
+    }
+
+    public function getIterator(): \Traversable
+    {
+        return new \ArrayIterator($this->blocks);
+    }
+
+    public function count(): int
+    {
+        return count($this->blocks);
+    }
+
+    public function isEmpty(): bool
+    {
+        return $this->count() === 0;
+    }
+
+    /**
+     * @return array<array<string, mixed>>
+     */
+    public function toArray(): array
+    {
+        return array_map(fn (ContentBlock $block) => $block->toArray(), $this->blocks);
+    }
+
+    /**
+     * @return ContentBlock[]
+     */
+    public function getBlocks(): array
+    {
+        return $this->blocks;
+    }
+
+    public function findById(BlockId $blockId): ?ContentBlock
+    {
+        foreach ($this->blocks as $block) {
+            if ($block->blockId->equals($blockId)) {
+                return $block;
+            }
+        }
+
+        return null;
+    }
+
+    private function validateUniqueBlockIds(): void
+    {
+        $ids = [];
+        foreach ($this->blocks as $block) {
+            $idString = $block->blockId->toString();
+            if (isset($ids[$idString])) {
+                throw new \InvalidArgumentException("Duplicate block ID: {$idString}");
+            }
+            $ids[$idString] = true;
+        }
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/ContentId.php b/src/Domain/Cms/ValueObjects/ContentId.php
new file mode 100644
index 00000000..5120d763
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/ContentId.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+use App\Framework\DateTime\Clock;
+use App\Framework\Id\Ulid\Ulid;
+
+final readonly class ContentId
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (! Ulid::isValid($value)) {
+            throw new \InvalidArgumentException('Invalid Content ID format');
+        }
+    }
+
+    public static function generate(Clock $clock): self
+    {
+        $ulid = new Ulid($clock);
+
+        return new self($ulid->__toString());
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/ContentSlug.php b/src/Domain/Cms/ValueObjects/ContentSlug.php
new file mode 100644
index 00000000..a136123a
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/ContentSlug.php
@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class ContentSlug
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Content slug cannot be empty');
+        }
+
+        if (! preg_match('/^[a-z0-9\-_]+$/', $value)) {
+            throw new \InvalidArgumentException('Content slug must contain only lowercase letters, numbers, hyphens, and underscores');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/ContentTypeId.php b/src/Domain/Cms/ValueObjects/ContentTypeId.php
new file mode 100644
index 00000000..6d57cac4
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/ContentTypeId.php
@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class ContentTypeId
+{
+    private function __construct(
+        private string $value
+    ) {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('ContentType ID cannot be empty');
+        }
+
+        if (! preg_match('/^[a-z0-9_]+$/', $value)) {
+            throw new \InvalidArgumentException('ContentType ID must contain only lowercase letters, numbers, and underscores');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Domain/Cms/ValueObjects/Locale.php b/src/Domain/Cms/ValueObjects/Locale.php
new file mode 100644
index 00000000..1fa75859
--- /dev/null
+++ b/src/Domain/Cms/ValueObjects/Locale.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Cms\ValueObjects;
+
+final readonly class Locale
+{
+    private function __construct(
+        private string $value
+    ) {
+        // Validate locale format (e.g., "en", "en-US", "de", "de-CH")
+        if (! preg_match('/^[a-z]{2}(-[A-Z]{2})?$/', $value)) {
+            throw new \InvalidArgumentException("Invalid locale format: {$value}. Expected format: 'en' or 'en-US'");
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public static function english(): self
+    {
+        return new self('en');
+    }
+
+    public static function german(): self
+    {
+        return new self('de');
+    }
+
+    public static function french(): self
+    {
+        return new self('fr');
+    }
+
+    public static function spanish(): self
+    {
+        return new self('es');
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function getLanguage(): string
+    {
+        return explode('-', $this->value)[0];
+    }
+
+    public function getRegion(): ?string
+    {
+        $parts = explode('-', $this->value);
+        return isset($parts[1]) ? $parts[1] : null;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Framework/Admin/Attributes/AdminPage.php b/src/Framework/Admin/Attributes/AdminPage.php
new file mode 100644
index 00000000..c9fe2ef8
--- /dev/null
+++ b/src/Framework/Admin/Attributes/AdminPage.php
@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Admin\Attributes;
+
+use App\Framework\Icon\Icon;
+use Attribute;
+
+/**
+ * AdminPage Attribute
+ *
+ * Provides metadata for admin pages to enable automatic discovery and navigation.
+ * This attribute is optional - pages without it will be auto-discovered with default values.
+ */
+#[Attribute(Attribute::TARGET_METHOD)]
+final readonly class AdminPage
+{
+    public function __construct(
+        public ?string $title = null,
+        public string|Icon|null $icon = null,
+        public ?string $section = null,
+        public int $order = 0,
+        public bool $hidden = false,
+        public ?string $description = null
+    ) {
+    }
+
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): ?Icon
+    {
+        if ($this->icon === null) {
+            return null;
+        }
+
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+}
+
diff --git a/src/Framework/Admin/Attributes/AdminResource.php b/src/Framework/Admin/Attributes/AdminResource.php
index 22695d27..286a144a 100644
--- a/src/Framework/Admin/Attributes/AdminResource.php
+++ b/src/Framework/Admin/Attributes/AdminResource.php
@@ -16,13 +16,25 @@ final readonly class AdminResource
         public string $name,
         public string $singularName,
         public string $pluralName,
-        public string $icon = 'file',
+        public string|Icon $icon = 'file',
         public bool $enableApi = true,
         public bool $enableCrud = true,
         public array $permissions = [],
     ) {
     }
 
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): Icon
+    {
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+
     public function getApiEndpoint(): string
     {
         return "/admin/api/{$this->name}";
diff --git a/src/Framework/Admin/Attributes/AdminSection.php b/src/Framework/Admin/Attributes/AdminSection.php
new file mode 100644
index 00000000..ebf094d8
--- /dev/null
+++ b/src/Framework/Admin/Attributes/AdminSection.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Admin\Attributes;
+
+use App\Framework\Icon\Icon;
+use Attribute;
+
+/**
+ * AdminSection Attribute
+ *
+ * Provides metadata for admin sections to enable automatic grouping and navigation.
+ * Can be applied to controllers to define section-level configuration.
+ */
+#[Attribute(Attribute::TARGET_CLASS)]
+final readonly class AdminSection
+{
+    public function __construct(
+        public ?string $name = null,
+        public string|Icon|null $icon = null,
+        public int $order = 0,
+        public ?string $description = null
+    ) {
+    }
+
+    /**
+     * Get icon as Icon object
+     */
+    public function getIcon(): ?Icon
+    {
+        if ($this->icon === null) {
+            return null;
+        }
+
+        if ($this->icon instanceof Icon) {
+            return $this->icon;
+        }
+
+        return Icon::fromString($this->icon);
+    }
+}
+
diff --git a/src/Framework/Api/ApiException.php b/src/Framework/Api/ApiException.php
index f280dbf7..061987bd 100644
--- a/src/Framework/Api/ApiException.php
+++ b/src/Framework/Api/ApiException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Api;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 use App\Framework\HttpClient\ClientResponse;
 
@@ -15,7 +14,7 @@ class ApiException extends FrameworkException
         int $code,
         private readonly ClientResponse $response
     ) {
-        parent::__construct($message, ExceptionContext::empty(), $code);
+        parent::__construct($message, $code);
     }
 
     public function getResponse(): ClientResponse
diff --git a/src/Framework/ApiGateway/ApiGateway.php b/src/Framework/ApiGateway/ApiGateway.php
index f13e82f7..6ec83288 100644
--- a/src/Framework/ApiGateway/ApiGateway.php
+++ b/src/Framework/ApiGateway/ApiGateway.php
@@ -63,7 +63,7 @@ final readonly class ApiGateway
         $operationId = "api_gateway.{$service}.{$requestName}." . uniqid();
         $snapshot = $this->operationTracker->startOperation(
             operationId: $operationId,
-            category: PerformanceCategory::HTTP,
+            category: PerformanceCategory::API,
             contextData: [
                 'service' => $service,
                 'request_name' => $requestName,
@@ -175,7 +175,7 @@ final readonly class ApiGateway
     private function buildClientRequest(ApiRequest $request): ClientRequest
     {
         // Convert timeout Duration to seconds for ClientOptions
-        $timeoutSeconds = $request->getTimeout()->toSeconds();
+        $timeoutSeconds = (int) $request->getTimeout()->toSeconds();
 
         $options = new ClientOptions(
             timeout: $timeoutSeconds,
@@ -276,7 +276,7 @@ final readonly class ApiGateway
     private function recordMetrics(
         string $service,
         string $requestName,
-        \App\Framework\Performance\PerformanceSnapshot $snapshot,
+        \App\Framework\Performance\ValueObjects\PerformanceSnapshot $snapshot,
         bool $success,
         int $retryAttempts,
         bool $circuitBreakerTriggered
diff --git a/src/Framework/Async/AsyncTimeoutException.php b/src/Framework/Async/AsyncTimeoutException.php
index 03ff4330..7f7ae529 100644
--- a/src/Framework/Async/AsyncTimeoutException.php
+++ b/src/Framework/Async/AsyncTimeoutException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Async;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -14,6 +13,6 @@ class AsyncTimeoutException extends FrameworkException
 {
     public function __construct(string $message = 'Async operation timed out', int $code = 0, ?\Throwable $previous = null)
     {
-        parent::__construct($message, ExceptionContext::empty(), $code, $previous);
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/AsyncExamples/Http/HttpException.php b/src/Framework/AsyncExamples/Http/HttpException.php
index d9e0ad05..c7aa82ae 100644
--- a/src/Framework/AsyncExamples/Http/HttpException.php
+++ b/src/Framework/AsyncExamples/Http/HttpException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\AsyncExamples\Http;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -18,12 +17,6 @@ class HttpException extends FrameworkException
         ?\Throwable $previous = null,
         public readonly ?HttpResponse $response = null
     ) {
-        $context = ExceptionContext::forOperation('http.request', 'http')
-            ->withData([
-                'response_code' => $response?->statusCode ?? null,
-                'response_headers' => $response?->headers ?? null,
-            ]);
-
-        parent::__construct($message, $context, $code, $previous);
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/Auth/RouteAuthorizationServiceInitializer.php b/src/Framework/Auth/RouteAuthorizationServiceInitializer.php
index 87a8bacc..69957fc0 100644
--- a/src/Framework/Auth/RouteAuthorizationServiceInitializer.php
+++ b/src/Framework/Auth/RouteAuthorizationServiceInitializer.php
@@ -21,25 +21,12 @@ final readonly class RouteAuthorizationServiceInitializer
     {
         // Configure namespace-based access control
         $namespaceConfig = [
-            // Example: Block all Admin controllers by default
-            // 'App\Application\Admin\*' => [
-            //     'visibility' => 'admin',  // IP-based restriction
-            //     'access_policy' => NamespaceAccessPolicy::blocked()  // Block all
-            // ],
-
-            // Example: Block Admin except specific controllers
-            // 'App\Application\Admin\*' => [
-            //     'visibility' => 'public',
-            //     'access_policy' => NamespaceAccessPolicy::blockedExcept(
-            //         \App\Application\Admin\LoginController::class,
-            //         \App\Application\Admin\HealthCheckController::class
-            //     )
-            // ],
-
-            // Example: IP restriction only (no namespace blocking)
-            // 'App\Application\Admin\*' => [
-            //     'visibility' => 'admin',  // Only admin IPs allowed
-            // ],
+            // All Admin routes are automatically protected via IP-based restriction
+            // No need for explicit #[Auth] attributes in Admin controllers
+            'App\Application\Admin\*' => [
+                'visibility' => 'admin',  // IP-based restriction (localhost/WireGuard)
+                // No access_policy - all Admin routes are accessible but IP-restricted
+            ],
         ];
 
         return new RouteAuthorizationService(
diff --git a/src/Framework/Cache/CacheInitializer.php b/src/Framework/Cache/CacheInitializer.php
index 5b2a9820..95fcb005 100644
--- a/src/Framework/Cache/CacheInitializer.php
+++ b/src/Framework/Cache/CacheInitializer.php
@@ -14,6 +14,7 @@ use App\Framework\Cache\Driver\RedisCache;
 use App\Framework\Cache\Metrics\CacheMetrics;
 use App\Framework\Cache\Metrics\CacheMetricsInterface;
 use App\Framework\Cache\Metrics\MetricsDecoratedCache;
+use App\Framework\Core\PathProvider;
 use App\Framework\DI\Container;
 use App\Framework\DI\Initializer;
 use App\Framework\Performance\Contracts\PerformanceCollectorInterface;
@@ -69,7 +70,8 @@ final readonly class CacheInitializer
 
             error_log('Redis not available, falling back to file cache: ' . $e->getMessage());
 
-            $redisCache = new GeneralCache(new FileCache(), $serializer, $compression);
+            $pathProvider = $this->container->get(PathProvider::class);
+            $redisCache = new GeneralCache(new FileCache(pathProvider: $pathProvider), $serializer, $compression);
         }
 
         #$redisCache->clear();
diff --git a/src/Framework/Cache/Driver/FileCache.php b/src/Framework/Cache/Driver/FileCache.php
index 03e8f425..f0761648 100644
--- a/src/Framework/Cache/Driver/FileCache.php
+++ b/src/Framework/Cache/Driver/FileCache.php
@@ -9,25 +9,52 @@ use App\Framework\Cache\CacheItem;
 use App\Framework\Cache\CacheKey;
 use App\Framework\Cache\CacheResult;
 use App\Framework\Cache\Contracts\Scannable;
+use App\Framework\Core\PathProvider;
 use App\Framework\Filesystem\FileStorage;
 use App\Framework\Filesystem\LockableStorage;
 use App\Framework\Filesystem\Storage;
 
 final readonly class FileCache implements CacheDriver, Scannable
 {
-    private const string CACHE_PATH = '/var/www/html/storage/cache';
+    private string $cachePath;
 
     public function __construct(
         private Storage $fileSystem = new FileStorage(),
+        ?PathProvider $pathProvider = null,
+        ?string $cachePath = null,
     ) {
-        $this->fileSystem->createDirectory(self::CACHE_PATH);
+        $this->cachePath = $this->normalizeCachePath(
+            $cachePath
+                ?? $pathProvider?->getCachePath()
+                ?? $this->detectCachePath()
+        );
+
+        // Create cache directory with explicit error handling
+        try {
+            $this->fileSystem->createDirectory($this->cachePath, 0755, true);
+            
+            // Verify directory is writable after creation
+            if (!is_dir($this->cachePath)) {
+                error_log("FileCache: Failed to create cache directory: {$this->cachePath}");
+            } elseif (!is_writable($this->cachePath)) {
+                error_log("FileCache: Cache directory is not writable: {$this->cachePath}");
+                // Try to fix permissions (only if we can)
+                @chmod($this->cachePath, 0755);
+                if (!is_writable($this->cachePath)) {
+                    error_log("FileCache: Could not fix permissions for cache directory: {$this->cachePath}");
+                }
+            }
+        } catch (\Throwable $e) {
+            error_log("FileCache: Failed to create cache directory '{$this->cachePath}': " . $e->getMessage());
+            // Continue anyway - operations will fail gracefully
+        }
     }
 
     private function getFileName(CacheKey $key, ?int $expiresAt): string
     {
         $hash = $this->getHashForKey($key);
 
-        return self::CACHE_PATH . DIRECTORY_SEPARATOR . $hash . '_' . ($expiresAt ?? 0) . '.cache.php';
+        return $this->cachePath . DIRECTORY_SEPARATOR . $hash . '_' . ($expiresAt ?? 0) . '.cache.php';
     }
 
     /**
@@ -47,7 +74,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     private function getFilesForKey(CacheKey $key): array
     {
         try {
-            $allFiles = $this->fileSystem->listDirectory(self::CACHE_PATH);
+            $allFiles = $this->fileSystem->listDirectory($this->cachePath);
         } catch (\App\Framework\Filesystem\Exceptions\DirectoryCreateException $e) {
             // Directory doesn't exist - return empty array
             return [];
@@ -61,7 +88,7 @@ final readonly class FileCache implements CacheDriver, Scannable
         // Filter files matching the hash pattern
         return array_filter($allFiles, function (string $file) use ($hash): bool {
             // Convert relative path to absolute if needed
-            $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+            $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
             $basename = basename($fullPath);
 
             // Match: hash_*.cache.php
@@ -74,7 +101,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     {
         $hash = $this->getHashForKey($key);
 
-        return self::CACHE_PATH . DIRECTORY_SEPARATOR . $hash . '.lock';
+        return $this->cachePath . DIRECTORY_SEPARATOR . $hash . '.lock';
     }
 
     /**
@@ -177,7 +204,7 @@ final readonly class FileCache implements CacheDriver, Scannable
 
         foreach ($files as $file) {
             // Convert to absolute path if needed
-            $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+            $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
             $basename = basename($fullPath);
 
             // Extract expiration time from filename: hash_expires.cache.php
@@ -292,9 +319,19 @@ final readonly class FileCache implements CacheDriver, Scannable
                 $file = $this->getFileName($item->key, $expiresAt);
 
                 // Store value directly as string (no serialization)
-                $this->fileSystem->put($file, $item->value);
-
-                return true;
+                try {
+                    $this->fileSystem->put($file, $item->value);
+                    return true;
+                } catch (\App\Framework\Filesystem\Exceptions\FilePermissionException $e) {
+                    error_log("FileCache: Permission denied writing cache file '{$file}': " . $e->getMessage());
+                    return false;
+                } catch (\App\Framework\Filesystem\Exceptions\DirectoryCreateException $e) {
+                    error_log("FileCache: Failed to create directory for cache file '{$file}': " . $e->getMessage());
+                    return false;
+                } catch (\Throwable $e) {
+                    error_log("FileCache: Failed to write cache file '{$file}': " . $e->getMessage());
+                    return false;
+                }
             });
 
             $success = $success && $result;
@@ -359,7 +396,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     public function clear(): bool
     {
         try {
-            $allFiles = $this->fileSystem->listDirectory(self::CACHE_PATH);
+            $allFiles = $this->fileSystem->listDirectory($this->cachePath);
         } catch (\Throwable $e) {
             // Directory doesn't exist or can't be accessed - nothing to clear
             return true;
@@ -374,7 +411,7 @@ final readonly class FileCache implements CacheDriver, Scannable
         foreach ($cacheFiles as $file) {
             try {
                 // Convert to absolute path if needed
-                $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+                $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
                 $this->fileSystem->delete($fullPath);
             } catch (\App\Framework\Filesystem\Exceptions\FilePermissionException $e) {
                 // Permission denied - continue with other files (graceful degradation)
@@ -397,7 +434,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     public function scan(string $pattern, int $limit = 1000): array
     {
         try {
-            $allFiles = $this->fileSystem->listDirectory(self::CACHE_PATH);
+            $allFiles = $this->fileSystem->listDirectory($this->cachePath);
         } catch (\Throwable $e) {
             // Directory doesn't exist or can't be accessed - return empty
             return [];
@@ -419,7 +456,7 @@ final readonly class FileCache implements CacheDriver, Scannable
             }
 
             // Convert to absolute path if needed
-            $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+            $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
             $key = $this->fileToKey($fullPath);
 
             if (preg_match($regex, $key)) {
@@ -434,7 +471,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     public function scanPrefix(string $prefix, int $limit = 1000): array
     {
         try {
-            $allFiles = $this->fileSystem->listDirectory(self::CACHE_PATH);
+            $allFiles = $this->fileSystem->listDirectory($this->cachePath);
         } catch (\Throwable $e) {
             // Directory doesn't exist or can't be accessed - return empty
             return [];
@@ -455,7 +492,7 @@ final readonly class FileCache implements CacheDriver, Scannable
             }
 
             // Convert to absolute path if needed
-            $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+            $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
             $key = $this->fileToKey($fullPath);
 
             if (str_starts_with($key, $prefix)) {
@@ -470,7 +507,7 @@ final readonly class FileCache implements CacheDriver, Scannable
     public function getAllKeys(int $limit = 1000): array
     {
         try {
-            $allFiles = $this->fileSystem->listDirectory(self::CACHE_PATH);
+            $allFiles = $this->fileSystem->listDirectory($this->cachePath);
         } catch (\Throwable $e) {
             // Directory doesn't exist or can't be accessed - return empty
             return [];
@@ -491,7 +528,7 @@ final readonly class FileCache implements CacheDriver, Scannable
             }
 
             // Convert to absolute path if needed
-            $fullPath = str_starts_with($file, '/') ? $file : self::CACHE_PATH . DIRECTORY_SEPARATOR . $file;
+            $fullPath = str_starts_with($file, '/') ? $file : $this->cachePath . DIRECTORY_SEPARATOR . $file;
             $keys[] = $this->fileToKey($fullPath);
             $count++;
         }
@@ -508,6 +545,31 @@ final readonly class FileCache implements CacheDriver, Scannable
         ];
     }
 
+    private function normalizeCachePath(string $path): string
+    {
+        $normalized = rtrim($path, DIRECTORY_SEPARATOR);
+
+        return $normalized === '' ? DIRECTORY_SEPARATOR : $normalized;
+    }
+
+    private function detectCachePath(): string
+    {
+        $basePath = getenv('APP_BASE_PATH');
+
+        if (is_string($basePath) && $basePath !== '') {
+            return rtrim($basePath, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . 'storage/cache';
+        }
+
+        $workingDirectory = getcwd();
+        if (is_string($workingDirectory) && $workingDirectory !== '') {
+            return rtrim($workingDirectory, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . 'storage/cache';
+        }
+
+        $projectRoot = dirname(__DIR__, 4);
+
+        return rtrim($projectRoot, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . 'storage/cache';
+    }
+
     /**
      * Convert filename back to cache key
      */
diff --git a/src/Framework/CircuitBreaker/CircuitBreakerException.php b/src/Framework/CircuitBreaker/CircuitBreakerException.php
index 9b6563e2..c25fca8b 100644
--- a/src/Framework/CircuitBreaker/CircuitBreakerException.php
+++ b/src/Framework/CircuitBreaker/CircuitBreakerException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\CircuitBreaker;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -22,33 +20,10 @@ final class CircuitBreakerException extends FrameworkException
     ) {
         $message = "Circuit breaker for service '{$service}' is {$state->value}. Service unavailable after {$failureCount} failures.";
 
-        $context = new ExceptionContext(
-            operation: 'circuit_breaker_check',
-            component: 'CircuitBreaker',
-            data: [
-                'service' => $service,
-                'state' => $state->value,
-                'failure_count' => $failureCount,
-                'retry_after_seconds' => $retryAfterSeconds,
-            ],
-            metadata: [
-                'requires_alert' => true,
-                'recoverable' => true,
-                'error_code' => ErrorCode::SERVICE_CIRCUIT_OPEN->value,
-                'http_status' => 503,
-                'additional_headers' => [
-                    'Retry-After' => (string) $retryAfterSeconds,
-                ],
-            ]
-        );
-
         parent::__construct(
             message: $message,
-            context: $context,
             code: 503,
-            previous: $previous,
-            errorCode: ErrorCode::SERVICE_CIRCUIT_OPEN,
-            retryAfter: $retryAfterSeconds
+            previous: $previous
         );
     }
 }
diff --git a/src/Framework/CommandBus/CommandHandlerMapper.php b/src/Framework/CommandBus/CommandHandlerMapper.php
index eb12dd91..e4b1062c 100644
--- a/src/Framework/CommandBus/CommandHandlerMapper.php
+++ b/src/Framework/CommandBus/CommandHandlerMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\CommandBus;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 use RuntimeException;
 
 final class CommandHandlerMapper implements AttributeMapper
diff --git a/src/Framework/Config/Exceptions/RequiredEnvironmentVariableException.php b/src/Framework/Config/Exceptions/RequiredEnvironmentVariableException.php
index 2c241592..43444045 100644
--- a/src/Framework/Config/Exceptions/RequiredEnvironmentVariableException.php
+++ b/src/Framework/Config/Exceptions/RequiredEnvironmentVariableException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Config\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 class RequiredEnvironmentVariableException extends FrameworkException
@@ -14,10 +13,6 @@ class RequiredEnvironmentVariableException extends FrameworkException
      */
     public function __construct(string $key)
     {
-        parent::__construct(
-            message: "Required environment variable '$key' is not set.",
-            context: ExceptionContext::forOperation('config_validation', 'Configuration')
-                ->withData(['environment_variable' => $key])
-        );
+        parent::__construct("Required environment variable '$key' is not set.");
     }
 }
diff --git a/src/Framework/Console/Animation/Animation.php b/src/Framework/Console/Animation/Animation.php
new file mode 100644
index 00000000..8c694009
--- /dev/null
+++ b/src/Framework/Console/Animation/Animation.php
@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+/**
+ * Base interface for all animations
+ */
+interface Animation
+{
+    /**
+     * Start the animation
+     */
+    public function start(): void;
+
+    /**
+     * Stop the animation
+     */
+    public function stop(): void;
+
+    /**
+     * Pause the animation
+     */
+    public function pause(): void;
+
+    /**
+     * Resume the animation
+     */
+    public function resume(): void;
+
+    /**
+     * Update the animation with delta time
+     * @param float $deltaTime Time elapsed since last update in seconds
+     * @return bool Returns true if animation is still active, false if finished
+     */
+    public function update(float $deltaTime): bool;
+
+    /**
+     * Check if animation is currently active
+     */
+    public function isActive(): bool;
+
+    /**
+     * Get current animation progress (0.0-1.0)
+     */
+    public function getProgress(): float;
+
+    /**
+     * Get animation duration in seconds
+     */
+    public function getDuration(): float;
+
+    /**
+     * Get animation delay in seconds
+     */
+    public function getDelay(): float;
+
+    /**
+     * Check if animation loops
+     */
+    public function isLooping(): bool;
+
+    /**
+     * Set callback for when animation starts
+     */
+    public function onStart(callable $callback): self;
+
+    /**
+     * Set callback for when animation completes
+     */
+    public function onComplete(callable $callback): self;
+
+    /**
+     * Set callback for when animation is paused
+     */
+    public function onPause(callable $callback): self;
+
+    /**
+     * Set callback for when animation is resumed
+     */
+    public function onResume(callable $callback): self;
+}
+
diff --git a/src/Framework/Console/Animation/AnimationBuilder.php b/src/Framework/Console/Animation/AnimationBuilder.php
new file mode 100644
index 00000000..ef83ae17
--- /dev/null
+++ b/src/Framework/Console/Animation/AnimationBuilder.php
@@ -0,0 +1,212 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\BaseAnimation;
+use Closure;
+
+/**
+ * Fluent builder for creating and configuring animations
+ */
+final class AnimationBuilder
+{
+    private ?float $duration = null;
+
+    private float $delay = 0.0;
+
+    private bool $loop = false;
+
+    private ?EasingFunction $easing = null;
+
+    /**
+     * @var Closure[]
+     */
+    private array $onStartCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    private array $onCompleteCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    private array $onPauseCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    private array $onResumeCallbacks = [];
+
+    /**
+     * @param Animation|class-string<Animation> $animation The animation instance or class name to build
+     */
+    public function __construct(
+        private Animation|string $animation
+    ) {
+    }
+
+    /**
+     * Set animation duration
+     */
+    public function duration(float $seconds): self
+    {
+        $this->duration = max(0.0, $seconds);
+        return $this;
+    }
+
+    /**
+     * Set animation delay
+     */
+    public function delay(float $seconds): self
+    {
+        $this->delay = max(0.0, $seconds);
+        return $this;
+    }
+
+    /**
+     * Enable or disable looping
+     */
+    public function loop(bool $loop = true): self
+    {
+        $this->loop = $loop;
+        return $this;
+    }
+
+    /**
+     * Set easing function
+     */
+    public function easing(EasingFunction $easing): self
+    {
+        $this->easing = $easing;
+        return $this;
+    }
+
+    /**
+     * Add callback for when animation starts
+     */
+    public function onStart(callable $callback): self
+    {
+        $this->onStartCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    /**
+     * Add callback for when animation completes
+     */
+    public function onComplete(callable $callback): self
+    {
+        $this->onCompleteCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    /**
+     * Add callback for when animation is paused
+     */
+    public function onPause(callable $callback): self
+    {
+        $this->onPauseCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    /**
+     * Add callback for when animation is resumed
+     */
+    public function onResume(callable $callback): self
+    {
+        $this->onResumeCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    /**
+     * Build and return the configured animation
+     */
+    public function build(): Animation
+    {
+        $animation = $this->createAnimation();
+        
+        // Apply configuration
+        if ($animation instanceof BaseAnimation) {
+            if ($this->duration !== null) {
+                // Use reflection to set duration if possible
+                // For now, animations should be created with proper duration in constructor
+            }
+            
+            // Apply callbacks
+            foreach ($this->onStartCallbacks as $callback) {
+                $animation->onStart($callback);
+            }
+            
+            foreach ($this->onCompleteCallbacks as $callback) {
+                $animation->onComplete($callback);
+            }
+            
+            foreach ($this->onPauseCallbacks as $callback) {
+                $animation->onPause($callback);
+            }
+            
+            foreach ($this->onResumeCallbacks as $callback) {
+                $animation->onResume($callback);
+            }
+        }
+        
+        return $animation;
+    }
+
+    /**
+     * Create animation instance
+     */
+    private function createAnimation(): Animation
+    {
+        if ($this->animation instanceof Animation) {
+            return $this->animation;
+        }
+
+        // If it's a class name, we need to create it
+        // This is a simplified version - in practice, you'd need more parameters
+        if (is_string($this->animation)) {
+            throw new \InvalidArgumentException('Class name animation creation requires additional parameters. Use AnimationFactory or create instance directly.');
+        }
+
+        return $this->animation;
+    }
+
+    /**
+     * Create a new builder for a fade animation
+     */
+    public static function fade(float $startOpacity = 0.0, float $endOpacity = 1.0): self
+    {
+        $animation = AnimationFactory::fade(1.0, $startOpacity, $endOpacity);
+        return new self($animation);
+    }
+
+    /**
+     * Create a new builder for a slide animation
+     */
+    public static function slide(Types\SlideDirection $direction, int $distance): self
+    {
+        $animation = AnimationFactory::slide($direction, $distance);
+        return new self($animation);
+    }
+
+    /**
+     * Create a new builder for a typewriter animation
+     */
+    public static function typewriter(string $text): self
+    {
+        $animation = AnimationFactory::typewriter($text);
+        return new self($animation);
+    }
+
+    /**
+     * Create a new builder for a pulse animation
+     */
+    public static function pulse(): self
+    {
+        $animation = AnimationFactory::pulse();
+        return new self($animation);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/AnimationFactory.php b/src/Framework/Console/Animation/AnimationFactory.php
new file mode 100644
index 00000000..8035ba42
--- /dev/null
+++ b/src/Framework/Console/Animation/AnimationFactory.php
@@ -0,0 +1,132 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\FadeAnimation;
+use App\Framework\Console\Animation\Types\MarqueeAnimation;
+use App\Framework\Console\Animation\Types\PulseAnimation;
+use App\Framework\Console\Animation\Types\SlideAnimation;
+use App\Framework\Console\Animation\Types\SpinnerAnimation;
+use App\Framework\Console\Animation\Types\TypewriterAnimation;
+use App\Framework\Console\SpinnerStyle;
+
+/**
+ * Factory for creating animations easily
+ */
+final readonly class AnimationFactory
+{
+    /**
+     * Create a fade animation
+     */
+    public static function fade(
+        float $duration = 1.0,
+        float $startOpacity = 0.0,
+        float $endOpacity = 1.0,
+        EasingFunction $easing = EasingFunction::EASE_IN_OUT
+    ): FadeAnimation {
+        return new FadeAnimation($duration, 0.0, false, $startOpacity, $endOpacity, $easing);
+    }
+
+    /**
+     * Create a fade-in animation
+     */
+    public static function fadeIn(float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_IN): FadeAnimation
+    {
+        return FadeAnimation::fadeIn($duration, $easing);
+    }
+
+    /**
+     * Create a fade-out animation
+     */
+    public static function fadeOut(float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): FadeAnimation
+    {
+        return FadeAnimation::fadeOut($duration, $easing);
+    }
+
+    /**
+     * Create a slide animation
+     */
+    public static function slide(
+        Types\SlideDirection $direction,
+        int                  $distance,
+        float                $duration = 1.0,
+        EasingFunction       $easing = EasingFunction::EASE_OUT
+    ): SlideAnimation {
+        return new SlideAnimation($direction, $distance, $duration, 0.0, false, 0, $easing);
+    }
+
+    /**
+     * Create a slide-in from left
+     */
+    public static function slideInFromLeft(int $distance, float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): SlideAnimation
+    {
+        return SlideAnimation::slideInFromLeft($distance, $duration, $easing);
+    }
+
+    /**
+     * Create a slide-in from right
+     */
+    public static function slideInFromRight(int $distance, float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): SlideAnimation
+    {
+        return SlideAnimation::slideInFromRight($distance, $duration, $easing);
+    }
+
+    /**
+     * Create a typewriter animation
+     */
+    public static function typewriter(
+        string $text,
+        float $charactersPerSecond = 10.0
+    ): TypewriterAnimation {
+        return new TypewriterAnimation($text, $charactersPerSecond);
+    }
+
+    /**
+     * Create a marquee animation
+     */
+    public static function marquee(
+        string $text,
+        int $width = 80,
+        float $speed = 1.0,
+        bool $loop = true
+    ): MarqueeAnimation {
+        return new MarqueeAnimation($text, $width, $speed, $loop, true);
+    }
+
+    /**
+     * Create a pulse animation
+     */
+    public static function pulse(
+        float $duration = 1.0,
+        float $scaleStart = 1.0,
+        float $scaleEnd = 1.2,
+        float $pulseSpeed = 2.0
+    ): PulseAnimation {
+        return new PulseAnimation($duration, 0.0, true, $scaleStart, $scaleEnd, $pulseSpeed);
+    }
+
+    /**
+     * Create a spinner animation
+     */
+    public static function spinner(
+        SpinnerStyle|array $frames,
+        string $message = 'Loading...',
+        float $frameInterval = 0.1
+    ): SpinnerAnimation {
+        return new SpinnerAnimation($frames, $message, $frameInterval, true);
+    }
+
+    /**
+     * Create a keyframe animation
+     */
+    public static function keyframe(
+        array $keyframes,
+        float $duration = 1.0,
+        bool $loop = false
+    ): KeyframeAnimation {
+        return new KeyframeAnimation($keyframes, $duration, 0.0, $loop);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/AnimationFrame.php b/src/Framework/Console/Animation/AnimationFrame.php
new file mode 100644
index 00000000..de0c8f4d
--- /dev/null
+++ b/src/Framework/Console/Animation/AnimationFrame.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+/**
+ * Value object for animation keyframes
+ */
+final readonly class AnimationFrame
+{
+    /**
+     * @param float $time Animation time (0.0-1.0) when this keyframe occurs
+     * @param mixed $value The value at this keyframe
+     * @param EasingFunction $easing Easing function to use when interpolating to next keyframe
+     */
+    public function __construct(
+        public float $time,
+        public mixed $value,
+        public EasingFunction $easing = EasingFunction::LINEAR
+    ) {
+        if ($time < 0.0 || $time > 1.0) {
+            throw new \InvalidArgumentException("Animation frame time must be between 0.0 and 1.0. Got: {$time}");
+        }
+    }
+}
+
diff --git a/src/Framework/Console/Animation/AnimationManager.php b/src/Framework/Console/Animation/AnimationManager.php
new file mode 100644
index 00000000..83b375c0
--- /dev/null
+++ b/src/Framework/Console/Animation/AnimationManager.php
@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+/**
+ * Manages multiple animations simultaneously
+ * Handles updates and lifecycle of all registered animations
+ */
+final class AnimationManager
+{
+    /**
+     * @var Animation[]
+     */
+    private array $animations = [];
+
+    private float $lastUpdateTime = 0.0;
+
+    /**
+     * Add an animation to the manager
+     */
+    public function add(Animation $animation): void
+    {
+        $this->animations[] = $animation;
+
+        // Auto-start if enabled
+        if ($animation->getDelay() <= 0.0) {
+            $animation->start();
+        }
+    }
+
+    /**
+     * Remove an animation from the manager
+     */
+    public function remove(Animation $animation): void
+    {
+        $key = array_search($animation, $this->animations, true);
+        if ($key !== false) {
+            unset($this->animations[$key]);
+            $this->animations = array_values($this->animations); // Re-index array
+            $animation->stop();
+        }
+    }
+
+    /**
+     * Update all animations with delta time
+     * @param float $deltaTime Time elapsed since last update in seconds
+     */
+    public function update(float $deltaTime): void
+    {
+        $currentTime = microtime(true);
+
+        if ($this->lastUpdateTime === 0.0) {
+            $this->lastUpdateTime = $currentTime;
+            return;
+        }
+
+        // Calculate actual delta time
+        $actualDelta = $currentTime - $this->lastUpdateTime;
+        $this->lastUpdateTime = $currentTime;
+
+        // Update all animations
+        $finishedAnimations = [];
+
+        foreach ($this->animations as $animation) {
+            // Handle delayed animations
+            if ($animation->getDelay() > 0.0 && !$animation->isActive()) {
+                // This should be handled by the animation itself, but we check here too
+                continue;
+            }
+
+            $stillActive = $animation->update($actualDelta);
+
+            if (!$stillActive && !$animation->isLooping()) {
+                $finishedAnimations[] = $animation;
+            }
+        }
+
+        // Remove finished non-looping animations
+        foreach ($finishedAnimations as $animation) {
+            $this->remove($animation);
+        }
+    }
+
+    /**
+     * Clear all animations
+     */
+    public function clear(): void
+    {
+        foreach ($this->animations as $animation) {
+            $animation->stop();
+        }
+
+        $this->animations = [];
+    }
+
+    /**
+     * Get all active animations
+     *
+     * @return Animation[]
+     */
+    public function getActiveAnimations(): array
+    {
+        return array_filter($this->animations, fn(Animation $animation) => $animation->isActive());
+    }
+
+    /**
+     * Get count of active animations
+     */
+    public function getActiveCount(): int
+    {
+        return count($this->getActiveAnimations());
+    }
+
+    /**
+     * Get total count of animations (including paused/finished)
+     */
+    public function getTotalCount(): int
+    {
+        return count($this->animations);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/AnimationState.php b/src/Framework/Console/Animation/AnimationState.php
new file mode 100644
index 00000000..3890f16d
--- /dev/null
+++ b/src/Framework/Console/Animation/AnimationState.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+/**
+ * Enum for animation states
+ */
+enum AnimationState: string
+{
+    case IDLE = 'idle';
+    case RUNNING = 'running';
+    case PAUSED = 'paused';
+    case FINISHED = 'finished';
+}
+
diff --git a/src/Framework/Console/Animation/CompositeAnimation.php b/src/Framework/Console/Animation/CompositeAnimation.php
new file mode 100644
index 00000000..319f10ad
--- /dev/null
+++ b/src/Framework/Console/Animation/CompositeAnimation.php
@@ -0,0 +1,233 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\BaseAnimation;
+
+/**
+ * Sequence type enum
+ */
+enum SequenceType: string
+{
+    case PARALLEL = 'parallel'; // All animations run simultaneously
+    case SEQUENTIAL = 'sequential'; // Animations run one after another
+}
+
+/**
+ * Composite animation that combines multiple animations
+ * Can run animations in parallel or sequentially
+ */
+final class CompositeAnimation extends BaseAnimation
+{
+    /**
+     * @var Animation[]
+     */
+    private array $animations = [];
+
+    private SequenceType $sequenceType = SequenceType::PARALLEL;
+
+    private int $currentAnimationIndex = 0;
+
+    /**
+     * @param Animation[] $animations
+     */
+    public function __construct(
+        array $animations = [],
+        SequenceType $sequenceType = SequenceType::PARALLEL,
+        float $delay = 0.0,
+        bool $loop = false
+    ) {
+        // Calculate total duration based on sequence type
+        $totalDuration = $this->calculateTotalDuration($animations, $sequenceType);
+        
+        parent::__construct($totalDuration, $delay, $loop);
+        $this->animations = $animations;
+        $this->sequenceType = $sequenceType;
+        $this->currentAnimationIndex = 0;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        if ($this->sequenceType === SequenceType::PARALLEL) {
+            // Update all animations in parallel
+            foreach ($this->animations as $animation) {
+                if (!$animation->isActive() && $animation->getDelay() <= 0.0) {
+                    $animation->start();
+                }
+                $animation->update(0.016); // Approximate delta time
+            }
+        } else {
+            // Update animations sequentially
+            $this->updateSequential($progress);
+        }
+    }
+
+    /**
+     * Update animations sequentially
+     */
+    private function updateSequential(float $progress): void
+    {
+        if (empty($this->animations)) {
+            return;
+        }
+
+        $totalDuration = $this->getDuration();
+        $elapsedTime = $progress * $totalDuration;
+        
+        $accumulatedTime = 0.0;
+        $activeAnimationIndex = -1;
+
+        // Find which animation should be active
+        for ($i = 0; $i < count($this->animations); $i++) {
+            $animation = $this->animations[$i];
+            $animationDuration = $animation->getDuration() + $animation->getDelay();
+            
+            if ($elapsedTime >= $accumulatedTime && $elapsedTime < $accumulatedTime + $animationDuration) {
+                $activeAnimationIndex = $i;
+                break;
+            }
+            
+            $accumulatedTime += $animationDuration;
+        }
+
+        // Start/update active animation
+        if ($activeAnimationIndex >= 0) {
+            $activeAnimation = $this->animations[$activeAnimationIndex];
+            
+            if (!$activeAnimation->isActive()) {
+                $activeAnimation->start();
+            }
+            
+            // Calculate local progress for this animation
+            $localElapsed = $elapsedTime - $accumulatedTime;
+            $localProgress = min(1.0, $localElapsed / max(0.001, $activeAnimation->getDuration()));
+            $activeAnimation->update(0.016); // Approximate delta time
+        }
+    }
+
+    public function getCurrentValue(): array
+    {
+        $values = [];
+        foreach ($this->animations as $index => $animation) {
+            $values[$index] = $animation instanceof BaseAnimation ? $animation->getCurrentValue() : null;
+        }
+        return $values;
+    }
+
+    /**
+     * Add an animation to the composite
+     */
+    public function addAnimation(Animation $animation): self
+    {
+        $this->animations[] = $animation;
+        
+        // Recalculate total duration
+        $this->duration = $this->calculateTotalDuration($this->animations, $this->sequenceType);
+        
+        return $this;
+    }
+
+    /**
+     * Set sequence type
+     */
+    public function setSequenceType(SequenceType $type): self
+    {
+        $this->sequenceType = $type;
+        $this->duration = $this->calculateTotalDuration($this->animations, $type);
+        return $this;
+    }
+
+    /**
+     * Get all animations
+     *
+     * @return Animation[]
+     */
+    public function getAnimations(): array
+    {
+        return $this->animations;
+    }
+
+    /**
+     * Calculate total duration based on sequence type
+     */
+    private function calculateTotalDuration(array $animations, SequenceType $type): float
+    {
+        if (empty($animations)) {
+            return 1.0;
+        }
+
+        if ($type === SequenceType::PARALLEL) {
+            // Parallel: use longest animation duration
+            $maxDuration = 0.0;
+            foreach ($animations as $animation) {
+                $totalTime = $animation->getDuration() + $animation->getDelay();
+                $maxDuration = max($maxDuration, $totalTime);
+            }
+            return $maxDuration;
+        } else {
+            // Sequential: sum all durations
+            $totalDuration = 0.0;
+            foreach ($animations as $animation) {
+                $totalDuration += $animation->getDuration() + $animation->getDelay();
+            }
+            return $totalDuration;
+        }
+    }
+
+    public function start(): void
+    {
+        parent::start();
+        
+        if ($this->sequenceType === SequenceType::PARALLEL) {
+            // Start all animations in parallel
+            foreach ($this->animations as $animation) {
+                if ($animation->getDelay() <= 0.0) {
+                    $animation->start();
+                }
+            }
+        } else {
+            // Start first animation in sequence
+            if (!empty($this->animations)) {
+                $this->currentAnimationIndex = 0;
+                $firstAnimation = $this->animations[0];
+                if ($firstAnimation->getDelay() <= 0.0) {
+                    $firstAnimation->start();
+                }
+            }
+        }
+    }
+
+    public function stop(): void
+    {
+        parent::stop();
+        
+        foreach ($this->animations as $animation) {
+            $animation->stop();
+        }
+    }
+
+    public function pause(): void
+    {
+        parent::pause();
+        
+        foreach ($this->animations as $animation) {
+            if ($animation->isActive()) {
+                $animation->pause();
+            }
+        }
+    }
+
+    public function resume(): void
+    {
+        parent::resume();
+        
+        foreach ($this->animations as $animation) {
+            if ($animation->isActive()) {
+                $animation->resume();
+            }
+        }
+    }
+}
+
diff --git a/src/Framework/Console/Animation/EasingFunction.php b/src/Framework/Console/Animation/EasingFunction.php
new file mode 100644
index 00000000..de5fbce7
--- /dev/null
+++ b/src/Framework/Console/Animation/EasingFunction.php
@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+/**
+ * Enum for easing functions
+ * Transforms animation progress (0.0-1.0) with various easing curves
+ */
+enum EasingFunction: string
+{
+    case LINEAR = 'linear';
+    case EASE_IN = 'ease_in';
+    case EASE_OUT = 'ease_out';
+    case EASE_IN_OUT = 'ease_in_out';
+    case EASE_IN_QUAD = 'ease_in_quad';
+    case EASE_OUT_QUAD = 'ease_out_quad';
+    case EASE_IN_OUT_QUAD = 'ease_in_out_quad';
+    case BOUNCE = 'bounce';
+    case ELASTIC = 'elastic';
+
+    /**
+     * Apply easing function to transform progress value (0.0-1.0)
+     */
+    public function apply(float $t): float
+    {
+        // Clamp t to [0, 1]
+        $t = max(0.0, min(1.0, $t));
+
+        return match ($this) {
+            self::LINEAR => $t,
+            self::EASE_IN => $t * $t,
+            self::EASE_OUT => $t * (2.0 - $t),
+            self::EASE_IN_OUT => $t < 0.5 ? 2.0 * $t * $t : -1.0 + (4.0 - 2.0 * $t) * $t,
+            self::EASE_IN_QUAD => $t * $t,
+            self::EASE_OUT_QUAD => $t * (2.0 - $t),
+            self::EASE_IN_OUT_QUAD => $t < 0.5 ? 2.0 * $t * $t : -1.0 + (4.0 - 2.0 * $t) * $t,
+            self::BOUNCE => $this->bounce($t),
+            self::ELASTIC => $this->elastic($t),
+        };
+    }
+
+    /**
+     * Bounce easing function
+     */
+    private function bounce(float $t): float
+    {
+        if ($t < 1.0 / 2.75) {
+            return 7.5625 * $t * $t;
+        } elseif ($t < 2.0 / 2.75) {
+            $t -= 1.5 / 2.75;
+            return 7.5625 * $t * $t + 0.75;
+        } elseif ($t < 2.5 / 2.75) {
+            $t -= 2.25 / 2.75;
+            return 7.5625 * $t * $t + 0.9375;
+        } else {
+            $t -= 2.625 / 2.75;
+            return 7.5625 * $t * $t + 0.984375;
+        }
+    }
+
+    /**
+     * Elastic easing function
+     */
+    private function elastic(float $t): float
+    {
+        if ($t === 0.0 || $t === 1.0) {
+            return $t;
+        }
+
+        $p = 0.3;
+        $s = $p / 4.0;
+
+        return pow(2.0, -10.0 * $t) * sin(($t - $s) * (2.0 * M_PI) / $p) + 1.0;
+    }
+}
+
diff --git a/src/Framework/Console/Animation/KeyframeAnimation.php b/src/Framework/Console/Animation/KeyframeAnimation.php
new file mode 100644
index 00000000..266b50af
--- /dev/null
+++ b/src/Framework/Console/Animation/KeyframeAnimation.php
@@ -0,0 +1,174 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\BaseAnimation;
+
+/**
+ * Generic keyframe-based animation
+ * Interpolates values between keyframes with easing
+ */
+final class KeyframeAnimation extends BaseAnimation
+{
+    /**
+     * @var AnimationFrame[]
+     */
+    private array $keyframes = [];
+
+    private mixed $currentValue = null;
+
+    public function __construct(
+        array $keyframes,
+        float $duration = 1.0,
+        float $delay = 0.0,
+        bool $loop = false
+    ) {
+        parent::__construct($duration, $delay, $loop);
+        
+        // Validate and sort keyframes
+        if (empty($keyframes)) {
+            throw new \InvalidArgumentException('KeyframeAnimation requires at least one keyframe');
+        }
+
+        $this->keyframes = $this->sortKeyframes($keyframes);
+        
+        // Initialize current value with first keyframe
+        $this->currentValue = $this->keyframes[0]->value;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        $this->currentValue = $this->getValueAt($progress);
+    }
+
+    public function getCurrentValue(): mixed
+    {
+        return $this->currentValue;
+    }
+
+    /**
+     * Get interpolated value at given time (0.0-1.0)
+     */
+    public function getValueAt(float $time): mixed
+    {
+        $time = max(0.0, min(1.0, $time));
+
+        // Find surrounding keyframes
+        $keyframeCount = count($this->keyframes);
+        
+        if ($keyframeCount === 1) {
+            return $this->keyframes[0]->value;
+        }
+
+        // Find the two keyframes that surround the time
+        $prevKeyframe = null;
+        $nextKeyframe = null;
+
+        for ($i = 0; $i < $keyframeCount; $i++) {
+            $keyframe = $this->keyframes[$i];
+            
+            if ($keyframe->time >= $time) {
+                $nextKeyframe = $keyframe;
+                if ($i > 0) {
+                    $prevKeyframe = $this->keyframes[$i - 1];
+                } else {
+                    $prevKeyframe = $keyframe;
+                }
+                break;
+            }
+            
+            $prevKeyframe = $keyframe;
+        }
+
+        // If we didn't find a next keyframe, use the last one
+        if ($nextKeyframe === null) {
+            $prevKeyframe = $this->keyframes[$keyframeCount - 1];
+            $nextKeyframe = $prevKeyframe;
+        }
+
+        // If both are the same, return the value
+        if ($prevKeyframe === $nextKeyframe || $prevKeyframe->time === $nextKeyframe->time) {
+            return $prevKeyframe->value;
+        }
+
+        // Interpolate between keyframes
+        $range = $nextKeyframe->time - $prevKeyframe->time;
+        $localTime = $range > 0 ? ($time - $prevKeyframe->time) / $range : 0.0;
+        
+        // Apply easing from previous keyframe
+        $easedTime = $prevKeyframe->easing->apply($localTime);
+
+        return $this->interpolate($prevKeyframe->value, $nextKeyframe->value, $easedTime);
+    }
+
+    /**
+     * Interpolate between two values
+     */
+    private function interpolate(mixed $start, mixed $end, float $t): mixed
+    {
+        // Numeric interpolation
+        if (is_numeric($start) && is_numeric($end)) {
+            return $start + ($end - $start) * $t;
+        }
+
+        // String interpolation (character by character)
+        if (is_string($start) && is_string($end)) {
+            // For strings, we'll just return the start or end based on progress
+            // More complex string interpolation could be added here
+            return $t < 0.5 ? $start : $end;
+        }
+
+        // Array interpolation (for numeric arrays)
+        if (is_array($start) && is_array($end) && count($start) === count($end)) {
+            $result = [];
+            foreach ($start as $key => $startValue) {
+                if (isset($end[$key]) && is_numeric($startValue) && is_numeric($end[$key])) {
+                    $result[$key] = $this->interpolate($startValue, $end[$key], $t);
+                } else {
+                    $result[$key] = $t < 0.5 ? $startValue : $end[$key];
+                }
+            }
+            return $result;
+        }
+
+        // Default: return end value if t >= 0.5, else start
+        return $t < 0.5 ? $start : $end;
+    }
+
+    /**
+     * Sort keyframes by time
+     *
+     * @param AnimationFrame[] $keyframes
+     * @return AnimationFrame[]
+     */
+    private function sortKeyframes(array $keyframes): array
+    {
+        usort($keyframes, fn(AnimationFrame $a, AnimationFrame $b) => $a->time <=> $b->time);
+        
+        // Ensure first keyframe is at time 0.0
+        if (count($keyframes) > 0 && $keyframes[0]->time > 0.0) {
+            array_unshift($keyframes, new AnimationFrame(0.0, $keyframes[0]->value));
+        }
+        
+        // Ensure last keyframe is at time 1.0
+        $lastIndex = count($keyframes) - 1;
+        if ($lastIndex >= 0 && $keyframes[$lastIndex]->time < 1.0) {
+            $keyframes[] = new AnimationFrame(1.0, $keyframes[$lastIndex]->value);
+        }
+        
+        return $keyframes;
+    }
+
+    /**
+     * Get all keyframes
+     *
+     * @return AnimationFrame[]
+     */
+    public function getKeyframes(): array
+    {
+        return $this->keyframes;
+    }
+}
+
diff --git a/src/Framework/Console/Animation/TextAnimation.php b/src/Framework/Console/Animation/TextAnimation.php
new file mode 100644
index 00000000..061f0c97
--- /dev/null
+++ b/src/Framework/Console/Animation/TextAnimation.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\BaseAnimation;
+
+/**
+ * Base class for text animations
+ * Integrates with TextWriter for animated text output
+ */
+abstract class TextAnimation
+{
+    /**
+     * Render current frame of animation
+     * Returns the text to display at current animation state
+     */
+    abstract public function renderFrame(): string;
+
+    /**
+     * Check if animation is complete
+     */
+    abstract public function isComplete(): bool;
+
+    /**
+     * Get the animation instance
+     */
+    abstract public function getAnimation(): Animation;
+}
+
diff --git a/src/Framework/Console/Animation/TuiAnimationRenderer.php b/src/Framework/Console/Animation/TuiAnimationRenderer.php
new file mode 100644
index 00000000..ef20d254
--- /dev/null
+++ b/src/Framework/Console/Animation/TuiAnimationRenderer.php
@@ -0,0 +1,183 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation;
+
+use App\Framework\Console\Animation\Types\FadeAnimation;
+use App\Framework\Console\Animation\Types\PulseAnimation;
+use App\Framework\Console\Animation\Types\SlideAnimation;
+use App\Framework\Console\Components\TuiState;
+
+/**
+ * Specialized renderer for TUI animations
+ * Manages animations for UI elements (menu items, buttons, etc.)
+ */
+final class TuiAnimationRenderer
+{
+    /**
+     * @var array<string, Animation> Element ID => Animation mapping
+     */
+    private array $elementAnimations = [];
+
+    /**
+     * @var array<string, mixed> Element ID => Current animated value
+     */
+    private array $elementValues = [];
+
+    public function __construct(
+        private readonly AnimationManager $animationManager
+    ) {
+    }
+
+    /**
+     * Animate a UI element
+     *
+     * @param string $elementId Unique identifier for the element
+     * @param Animation $animation The animation to apply
+     */
+    public function animateElement(string $elementId, Animation $animation): void
+    {
+        // Stop existing animation for this element if any
+        if (isset($this->elementAnimations[$elementId])) {
+            $this->animationManager->remove($this->elementAnimations[$elementId]);
+        }
+
+        // Add new animation
+        $this->elementAnimations[$elementId] = $animation;
+        $this->animationManager->add($animation);
+
+        // Initialize element value
+        if ($animation instanceof Types\BaseAnimation) {
+            $this->elementValues[$elementId] = $animation->getCurrentValue();
+        }
+    }
+
+    /**
+     * Animate element with fade-in
+     */
+    public function fadeInElement(string $elementId, float $duration = 0.5): void
+    {
+        $animation = AnimationFactory::fadeIn($duration);
+        $this->animateElement($elementId, $animation);
+    }
+
+    /**
+     * Animate element with fade-out
+     */
+    public function fadeOutElement(string $elementId, float $duration = 0.5): void
+    {
+        $animation = AnimationFactory::fadeOut($duration);
+        $this->animateElement($elementId, $animation);
+    }
+
+    /**
+     * Animate element with pulse
+     */
+    public function pulseElement(string $elementId, float $duration = 1.0): void
+    {
+        $animation = AnimationFactory::pulse($duration);
+        $this->animateElement($elementId, $animation);
+    }
+
+    /**
+     * Animate element with slide-in
+     */
+    public function slideInElement(string $elementId, Types\SlideDirection $direction, int $distance, float $duration = 0.5): void
+    {
+        $animation = AnimationFactory::slide($direction, $distance, $duration);
+        $this->animateElement($elementId, $animation);
+    }
+
+    /**
+     * Stop animation for an element
+     */
+    public function stopElement(string $elementId): void
+    {
+        if (isset($this->elementAnimations[$elementId])) {
+            $this->animationManager->remove($this->elementAnimations[$elementId]);
+            unset($this->elementAnimations[$elementId]);
+            unset($this->elementValues[$elementId]);
+        }
+    }
+
+    /**
+     * Update all element animations
+     * Should be called from render loop
+     */
+    public function update(float $deltaTime): void
+    {
+        // Update element values from animations
+        foreach ($this->elementAnimations as $elementId => $animation) {
+            if ($animation instanceof Types\BaseAnimation) {
+                $this->elementValues[$elementId] = $animation->getCurrentValue();
+            }
+        }
+    }
+
+    /**
+     * Get current animated value for an element
+     */
+    public function getElementValue(string $elementId): mixed
+    {
+        return $this->elementValues[$elementId] ?? null;
+    }
+
+    /**
+     * Check if element has active animation
+     */
+    public function hasAnimation(string $elementId): bool
+    {
+        return isset($this->elementAnimations[$elementId]) && $this->elementAnimations[$elementId]->isActive();
+    }
+
+    /**
+     * Get opacity for element (if fade animation is active)
+     */
+    public function getElementOpacity(string $elementId): float
+    {
+        $animation = $this->elementAnimations[$elementId] ?? null;
+        if ($animation instanceof FadeAnimation) {
+            return $animation->getOpacity();
+        }
+
+        return 1.0; // Default: fully opaque
+    }
+
+    /**
+     * Get position offset for element (if slide animation is active)
+     */
+    public function getElementPosition(string $elementId): int
+    {
+        $animation = $this->elementAnimations[$elementId] ?? null;
+        if ($animation instanceof SlideAnimation) {
+            return $animation->getPosition();
+        }
+
+        return 0; // Default: no offset
+    }
+
+    /**
+     * Get scale factor for element (if pulse animation is active)
+     */
+    public function getElementScale(string $elementId): float
+    {
+        $animation = $this->elementAnimations[$elementId] ?? null;
+        if ($animation instanceof PulseAnimation) {
+            return $animation->getScale();
+        }
+
+        return 1.0; // Default: no scaling
+    }
+
+    /**
+     * Clear all element animations
+     */
+    public function clear(): void
+    {
+        foreach (array_keys($this->elementAnimations) as $elementId) {
+            $this->stopElement($elementId);
+        }
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/BaseAnimation.php b/src/Framework/Console/Animation/Types/BaseAnimation.php
new file mode 100644
index 00000000..d649270d
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/BaseAnimation.php
@@ -0,0 +1,207 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+use App\Framework\Console\Animation\Animation;
+use App\Framework\Console\Animation\AnimationState;
+use Closure;
+
+/**
+ * Base implementation for animations
+ * Provides common functionality for all animation types
+ */
+abstract class BaseAnimation implements Animation
+{
+    protected AnimationState $state = AnimationState::IDLE;
+
+    protected float $elapsedTime = 0.0;
+
+    protected float $duration = 1.0;
+
+    protected float $delay = 0.0;
+
+    protected bool $loop = false;
+
+    protected float $progress = 0.0;
+
+    /**
+     * @var Closure[]
+     */
+    protected array $onStartCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    protected array $onCompleteCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    protected array $onPauseCallbacks = [];
+
+    /**
+     * @var Closure[]
+     */
+    protected array $onResumeCallbacks = [];
+
+    public function __construct(
+        float $duration = 1.0,
+        float $delay = 0.0,
+        bool $loop = false
+    ) {
+        $this->duration = max(0.0, $duration);
+        $this->delay = max(0.0, $delay);
+        $this->loop = $loop;
+    }
+
+    public function start(): void
+    {
+        if ($this->state === AnimationState::RUNNING) {
+            return;
+        }
+
+        $this->state = AnimationState::RUNNING;
+        $this->elapsedTime = 0.0;
+        $this->progress = 0.0;
+
+        $this->triggerCallbacks($this->onStartCallbacks);
+    }
+
+    public function stop(): void
+    {
+        $this->state = AnimationState::FINISHED;
+        $this->elapsedTime = 0.0;
+        $this->progress = 0.0;
+    }
+
+    public function pause(): void
+    {
+        if ($this->state === AnimationState::RUNNING) {
+            $this->state = AnimationState::PAUSED;
+            $this->triggerCallbacks($this->onPauseCallbacks);
+        }
+    }
+
+    public function resume(): void
+    {
+        if ($this->state === AnimationState::PAUSED) {
+            $this->state = AnimationState::RUNNING;
+            $this->triggerCallbacks($this->onResumeCallbacks);
+        }
+    }
+
+    public function update(float $deltaTime): bool
+    {
+        if ($this->state !== AnimationState::RUNNING) {
+            return $this->state === AnimationState::RUNNING;
+        }
+
+        // Handle delay
+        if ($this->elapsedTime < $this->delay) {
+            $this->elapsedTime += $deltaTime;
+            return true;
+        }
+
+        // Calculate animation time (after delay)
+        $animationTime = $this->elapsedTime - $this->delay;
+        $this->elapsedTime += $deltaTime;
+
+        if ($animationTime >= $this->duration) {
+            if ($this->loop) {
+                // Loop: reset and continue
+                $this->elapsedTime = $this->delay;
+                $this->progress = 0.0;
+                $this->triggerCallbacks($this->onStartCallbacks);
+                return true;
+            } else {
+                // Finished
+                $this->progress = 1.0;
+                $this->state = AnimationState::FINISHED;
+                $this->triggerCallbacks($this->onCompleteCallbacks);
+                return false;
+            }
+        }
+
+        // Update progress
+        $this->progress = min(1.0, $animationTime / $this->duration);
+
+        // Update animation-specific logic
+        $this->updateAnimation($this->progress);
+
+        return true;
+    }
+
+    public function isActive(): bool
+    {
+        return $this->state === AnimationState::RUNNING;
+    }
+
+    public function getProgress(): float
+    {
+        return $this->progress;
+    }
+
+    public function getDuration(): float
+    {
+        return $this->duration;
+    }
+
+    public function getDelay(): float
+    {
+        return $this->delay;
+    }
+
+    public function isLooping(): bool
+    {
+        return $this->loop;
+    }
+
+    public function onStart(callable $callback): self
+    {
+        $this->onStartCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    public function onComplete(callable $callback): self
+    {
+        $this->onCompleteCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    public function onPause(callable $callback): self
+    {
+        $this->onPauseCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    public function onResume(callable $callback): self
+    {
+        $this->onResumeCallbacks[] = Closure::fromCallable($callback);
+        return $this;
+    }
+
+    /**
+     * Update animation-specific logic
+     * Called during update() with current progress (0.0-1.0)
+     */
+    abstract protected function updateAnimation(float $progress): void;
+
+    /**
+     * Get current animation value
+     * Returns the current interpolated value based on progress
+     */
+    abstract public function getCurrentValue(): mixed;
+
+    /**
+     * Trigger callbacks
+     */
+    protected function triggerCallbacks(array $callbacks): void
+    {
+        foreach ($callbacks as $callback) {
+            $callback($this);
+        }
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/FadeAnimation.php b/src/Framework/Console/Animation/Types/FadeAnimation.php
new file mode 100644
index 00000000..3c43c94f
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/FadeAnimation.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+use App\Framework\Console\Animation\EasingFunction;
+
+/**
+ * Fade animation for fading text/elements in or out
+ */
+final class FadeAnimation extends BaseAnimation
+{
+    private float $startOpacity = 0.0;
+
+    private float $endOpacity = 1.0;
+
+    private float $currentOpacity = 0.0;
+
+    private EasingFunction $easing;
+
+    public function __construct(
+        float $duration = 1.0,
+        float $delay = 0.0,
+        bool $loop = false,
+        float $startOpacity = 0.0,
+        float $endOpacity = 1.0,
+        EasingFunction $easing = EasingFunction::EASE_IN_OUT
+    ) {
+        parent::__construct($duration, $delay, $loop);
+        $this->startOpacity = max(0.0, min(1.0, $startOpacity));
+        $this->endOpacity = max(0.0, min(1.0, $endOpacity));
+        $this->easing = $easing;
+        $this->currentOpacity = $this->startOpacity;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        $easedProgress = $this->easing->apply($progress);
+        $this->currentOpacity = $this->startOpacity + ($this->endOpacity - $this->startOpacity) * $easedProgress;
+    }
+
+    public function getCurrentValue(): float
+    {
+        return $this->currentOpacity;
+    }
+
+    /**
+     * Get current opacity (0.0-1.0)
+     */
+    public function getOpacity(): float
+    {
+        return $this->currentOpacity;
+    }
+
+    /**
+     * Create fade-in animation
+     */
+    public static function fadeIn(float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_IN): self
+    {
+        return new self($duration, 0.0, false, 0.0, 1.0, $easing);
+    }
+
+    /**
+     * Create fade-out animation
+     */
+    public static function fadeOut(float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): self
+    {
+        return new self($duration, 0.0, false, 1.0, 0.0, $easing);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/MarqueeAnimation.php b/src/Framework/Console/Animation/Types/MarqueeAnimation.php
new file mode 100644
index 00000000..4d8f947c
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/MarqueeAnimation.php
@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+/**
+ * Marquee animation for scrolling text (horizontal)
+ */
+final class MarqueeAnimation extends BaseAnimation
+{
+    private string $text = '';
+
+    private int $width = 80;
+
+    private float $speed = 1.0;
+
+    private int $position = 0;
+
+    private bool $continuous = true;
+
+    public function __construct(
+        string $text,
+        int $width = 80,
+        float $speed = 1.0,
+        bool $loop = true,
+        bool $continuous = true
+    ) {
+        // Calculate duration based on text length and width
+        $textLength = mb_strlen($text);
+        $scrollDistance = $textLength + $width;
+        $duration = $scrollDistance / max(0.1, $speed);
+        
+        parent::__construct($duration, 0.0, $loop);
+        $this->text = $text;
+        $this->width = max(1, $width);
+        $this->speed = max(0.1, $speed);
+        $this->continuous = $continuous;
+        $this->position = 0;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        $textLength = mb_strlen($this->text);
+        
+        if ($this->continuous) {
+            // Continuous scrolling: wrap around
+            $totalDistance = $textLength + $this->width;
+            $this->position = (int) floor($progress * $totalDistance) % ($textLength + $this->width);
+        } else {
+            // One-time scroll
+            $totalDistance = $textLength + $this->width;
+            $this->position = (int) floor($progress * $totalDistance);
+        }
+    }
+
+    public function getCurrentValue(): string
+    {
+        $textLength = mb_strlen($this->text);
+        $displayText = $this->text . str_repeat(' ', $this->width);
+        
+        if ($this->position >= $textLength + $this->width && !$this->continuous) {
+            // Scrolled past end, show empty
+            return str_repeat(' ', $this->width);
+        }
+        
+        $displayText = mb_substr($displayText, $this->position, $this->width);
+        return mb_substr($displayText . str_repeat(' ', $this->width), 0, $this->width);
+    }
+
+    /**
+     * Get current displayed text (with proper padding)
+     */
+    public function getDisplayText(): string
+    {
+        return $this->getCurrentValue();
+    }
+
+    /**
+     * Get current scroll position
+     */
+    public function getPosition(): int
+    {
+        return $this->position;
+    }
+
+    /**
+     * Create fast marquee
+     */
+    public static function fast(string $text, int $width = 80): self
+    {
+        return new self($text, $width, 5.0, true, true);
+    }
+
+    /**
+     * Create slow marquee
+     */
+    public static function slow(string $text, int $width = 80): self
+    {
+        return new self($text, $width, 0.5, true, true);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/PulseAnimation.php b/src/Framework/Console/Animation/Types/PulseAnimation.php
new file mode 100644
index 00000000..1b4156a9
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/PulseAnimation.php
@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+use App\Framework\Console\Animation\EasingFunction;
+
+/**
+ * Pulse animation for pulsing effects (e.g., highlighting)
+ * Uses sine wave for continuous pulsing
+ */
+final class PulseAnimation extends BaseAnimation
+{
+    private float $scaleStart = 1.0;
+
+    private float $scaleEnd = 1.2;
+
+    private float $pulseSpeed = 2.0;
+
+    private float $currentScale = 1.0;
+
+    public function __construct(
+        float $duration = 1.0,
+        float $delay = 0.0,
+        bool $loop = true,
+        float $scaleStart = 1.0,
+        float $scaleEnd = 1.2,
+        float $pulseSpeed = 2.0
+    ) {
+        parent::__construct($duration, $delay, $loop);
+        $this->scaleStart = $scaleStart;
+        $this->scaleEnd = $scaleEnd;
+        $this->pulseSpeed = $pulseSpeed;
+        $this->currentScale = $this->scaleStart;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        // Use sine wave for smooth pulsing
+        $sineValue = sin($progress * M_PI * 2.0 * $this->pulseSpeed);
+        // Normalize sine from [-1, 1] to [0, 1]
+        $normalized = ($sineValue + 1.0) / 2.0;
+        // Interpolate between start and end scale
+        $this->currentScale = $this->scaleStart + ($this->scaleEnd - $this->scaleStart) * $normalized;
+    }
+
+    public function getCurrentValue(): float
+    {
+        return $this->currentScale;
+    }
+
+    /**
+     * Get current scale factor
+     */
+    public function getScale(): float
+    {
+        return $this->currentScale;
+    }
+
+    /**
+     * Create a gentle pulse animation
+     */
+    public static function gentle(float $duration = 2.0): self
+    {
+        return new self($duration, 0.0, true, 1.0, 1.1, 1.0);
+    }
+
+    /**
+     * Create a strong pulse animation
+     */
+    public static function strong(float $duration = 1.0): self
+    {
+        return new self($duration, 0.0, true, 1.0, 1.5, 2.0);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/SlideAnimation.php b/src/Framework/Console/Animation/Types/SlideAnimation.php
new file mode 100644
index 00000000..a6f6dbe5
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/SlideAnimation.php
@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+use App\Framework\Console\Animation\EasingFunction;
+
+/**
+ * Slide animation for sliding elements in different directions
+ */
+final class SlideAnimation extends BaseAnimation
+{
+    private SlideDirection $direction;
+
+    private int $startPosition = 0;
+
+    private int $endPosition = 0;
+
+    private int $distance = 0;
+
+    private int $currentPosition = 0;
+
+    private EasingFunction $easing;
+
+    public function __construct(
+        SlideDirection $direction,
+        int $distance,
+        float $duration = 1.0,
+        float $delay = 0.0,
+        bool $loop = false,
+        int $startPosition = 0,
+        EasingFunction $easing = EasingFunction::EASE_OUT
+    ) {
+        parent::__construct($duration, $delay, $loop);
+        $this->direction = $direction;
+        $this->distance = $distance;
+        $this->startPosition = $startPosition;
+        $this->endPosition = $startPosition + $distance;
+        $this->easing = $easing;
+        $this->currentPosition = $this->startPosition;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        $easedProgress = $this->easing->apply($progress);
+        $this->currentPosition = (int) round($this->startPosition + ($this->endPosition - $this->startPosition) * $easedProgress);
+    }
+
+    public function getCurrentValue(): int
+    {
+        return $this->currentPosition;
+    }
+
+    /**
+     * Get current position
+     */
+    public function getPosition(): int
+    {
+        return $this->currentPosition;
+    }
+
+    /**
+     * Get slide direction
+     */
+    public function getDirection(): SlideDirection
+    {
+        return $this->direction;
+    }
+
+    /**
+     * Create slide-in from left
+     */
+    public static function slideInFromLeft(int $distance, float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): self
+    {
+        return new self(SlideDirection::LEFT, $distance, $duration, 0.0, false, -$distance, $easing);
+    }
+
+    /**
+     * Create slide-in from right
+     */
+    public static function slideInFromRight(int $distance, float $duration = 1.0, EasingFunction $easing = EasingFunction::EASE_OUT): self
+    {
+        return new self(SlideDirection::RIGHT, $distance, $duration, 0.0, false, $distance, $easing);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/SpinnerAnimation.php b/src/Framework/Console/Animation/Types/SpinnerAnimation.php
new file mode 100644
index 00000000..5a1290da
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/SpinnerAnimation.php
@@ -0,0 +1,129 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+use App\Framework\Console\Animation\EasingFunction;
+use App\Framework\Console\SpinnerStyle;
+
+/**
+ * Spinner animation that extends the animation system
+ * Compatible with existing Spinner API
+ */
+final class SpinnerAnimation extends BaseAnimation
+{
+    /**
+     * @var string[]
+     */
+    private array $frames = [];
+
+    private int $currentFrameIndex = 0;
+
+    private string $message = '';
+
+    private float $frameInterval = 0.1;
+
+    private float $frameAccumulator = 0.0;
+
+    public function __construct(
+        array|SpinnerStyle $frames,
+        string $message = 'Loading...',
+        float $frameInterval = 0.1,
+        bool $loop = true
+    ) {
+        parent::__construct(1.0, 0.0, $loop);
+        
+        // Handle SpinnerStyle enum
+        if ($frames instanceof SpinnerStyle) {
+            $this->frames = $frames->getFrames();
+        } else {
+            $this->frames = $frames;
+        }
+        
+        if (empty($this->frames)) {
+            throw new \InvalidArgumentException('SpinnerAnimation requires at least one frame');
+        }
+        
+        $this->message = $message;
+        $this->frameInterval = max(0.01, $frameInterval);
+        $this->currentFrameIndex = 0;
+        $this->frameAccumulator = 0.0;
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        // Calculate frame based on progress and frame interval
+        $frameCount = count($this->frames);
+        $totalFrames = $this->duration / $this->frameInterval;
+        $currentFrame = (int) floor($progress * $totalFrames) % $frameCount;
+        
+        $this->currentFrameIndex = $currentFrame;
+    }
+
+    public function getCurrentValue(): string
+    {
+        if (empty($this->frames)) {
+            return '';
+        }
+        
+        return $this->frames[$this->currentFrameIndex];
+    }
+
+    /**
+     * Get current frame
+     */
+    public function getCurrentFrame(): string
+    {
+        return $this->getCurrentValue();
+    }
+
+    /**
+     * Get message
+     */
+    public function getMessage(): string
+    {
+        return $this->message;
+    }
+
+    /**
+     * Set message
+     */
+    public function setMessage(string $message): self
+    {
+        $this->message = $message;
+        return $this;
+    }
+
+    /**
+     * Get formatted display string (frame + message)
+     */
+    public function getDisplayString(): string
+    {
+        $frame = $this->getCurrentFrame();
+        return $frame . ' ' . $this->message;
+    }
+
+    /**
+     * Create spinner from SpinnerStyle
+     */
+    public static function fromStyle(
+        SpinnerStyle $style,
+        string $message = 'Loading...',
+        float $frameInterval = 0.1
+    ): self {
+        return new self($style, $message, $frameInterval, true);
+    }
+
+    /**
+     * Create custom spinner
+     */
+    public static function custom(
+        array $frames,
+        string $message = 'Loading...',
+        float $frameInterval = 0.1
+    ): self {
+        return new self($frames, $message, $frameInterval, true);
+    }
+}
+
diff --git a/src/Framework/Console/Animation/Types/TypewriterAnimation.php b/src/Framework/Console/Animation/Types/TypewriterAnimation.php
new file mode 100644
index 00000000..7d4b5b6d
--- /dev/null
+++ b/src/Framework/Console/Animation/Types/TypewriterAnimation.php
@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Animation\Types;
+
+/**
+ * Typewriter animation for character-by-character text display
+ */
+final class TypewriterAnimation extends BaseAnimation
+{
+    private string $text = '';
+
+    private float $charactersPerSecond = 10.0;
+
+    private int $currentPosition = 0;
+
+    private string $currentText = '';
+
+    public function __construct(
+        string $text,
+        float $charactersPerSecond = 10.0,
+        float $delay = 0.0
+    ) {
+        $textLength = mb_strlen($text);
+        $duration = $textLength / max(0.1, $charactersPerSecond);
+        
+        parent::__construct($duration, $delay, false);
+        $this->text = $text;
+        $this->charactersPerSecond = max(0.1, $charactersPerSecond);
+        $this->currentPosition = 0;
+        $this->currentText = '';
+    }
+
+    protected function updateAnimation(float $progress): void
+    {
+        $textLength = mb_strlen($this->text);
+        $targetPosition = (int) floor($progress * $textLength);
+        $this->currentPosition = min($targetPosition, $textLength);
+        $this->currentText = mb_substr($this->text, 0, $this->currentPosition);
+    }
+
+    public function getCurrentValue(): string
+    {
+        return $this->currentText;
+    }
+
+    /**
+     * Get current displayed text
+     */
+    public function getText(): string
+    {
+        return $this->currentText;
+    }
+
+    /**
+     * Get full text that will be displayed
+     */
+    public function getFullText(): string
+    {
+        return $this->text;
+    }
+
+    /**
+     * Check if animation is complete (all characters displayed)
+     */
+    public function isComplete(): bool
+    {
+        return $this->currentPosition >= mb_strlen($this->text);
+    }
+
+    /**
+     * Create fast typewriter animation
+     */
+    public static function fast(string $text): self
+    {
+        return new self($text, 20.0);
+    }
+
+    /**
+     * Create slow typewriter animation
+     */
+    public static function slow(string $text): self
+    {
+        return new self($text, 5.0);
+    }
+}
+
diff --git a/src/Framework/Console/Ansi/AnsiSequenceGenerator.php b/src/Framework/Console/Ansi/AnsiSequenceGenerator.php
new file mode 100644
index 00000000..85c5be6d
--- /dev/null
+++ b/src/Framework/Console/Ansi/AnsiSequenceGenerator.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Ansi;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\Screen\CursorControlCode;
+use App\Framework\Console\Screen\ScreenControlCode;
+use App\Framework\Console\Terminal\OscMode;
+
+/**
+ * Centralized ANSI sequence generator for all escape sequences.
+ * Provides methods for colors, cursor control, screen control, links, and titles.
+ * Uses existing Enums where possible.
+ */
+final readonly class AnsiSequenceGenerator
+{
+    /**
+     * Generate ANSI color sequence
+     */
+    public function color(ConsoleColor $color): string
+    {
+        return $color->toAnsi();
+    }
+
+    /**
+     * Generate ANSI format sequence
+     */
+    public function format(ConsoleFormat $format): string
+    {
+        return $format->toAnsi();
+    }
+
+    /**
+     * Generate ANSI style sequence (color + format + background)
+     */
+    public function style(
+        ?ConsoleColor $color = null,
+        ?ConsoleFormat $format = null,
+        ?ConsoleColor $background = null
+    ): string {
+        $codes = [];
+
+        if ($format !== null) {
+            $codes[] = $format->value;
+        }
+
+        if ($color !== null) {
+            $codes[] = $color->value;
+        }
+
+        if ($background !== null) {
+            $codes[] = $background->value;
+        }
+
+        if (empty($codes)) {
+            return '';
+        }
+
+        return "\033[" . implode(';', $codes) . 'm';
+    }
+
+    /**
+     * Generate truecolor (24-bit RGB) foreground color sequence
+     */
+    public function truecolorForeground(int $r, int $g, int $b): string
+    {
+        return "\033[38;2;{$r};{$g};{$b}m";
+    }
+
+    /**
+     * Generate truecolor (24-bit RGB) background color sequence
+     */
+    public function truecolorBackground(int $r, int $g, int $b): string
+    {
+        return "\033[48;2;{$r};{$g};{$b}m";
+    }
+
+    /**
+     * Generate reset sequence
+     */
+    public function reset(): string
+    {
+        return ConsoleColor::RESET->toAnsi();
+    }
+
+    /**
+     * Generate cursor control sequence using CursorControlCode enum
+     */
+    public function cursor(CursorControlCode $code, int ...$params): string
+    {
+        return $code->format(...$params);
+    }
+
+    /**
+     * Generate screen control sequence using ScreenControlCode enum
+     */
+    public function screen(ScreenControlCode $code, int ...$params): string
+    {
+        return $code->format(...$params);
+    }
+
+    /**
+     * Generate screen clear sequence using ScreenControlCode enum
+     */
+    public function clearScreen(): string
+    {
+        return ScreenControlCode::CLEAR_ALL->format();
+    }
+
+    /**
+     * Generate clickable link sequence (OSC 8)
+     * Format: \e]8;;URL\aText\e]8;;\a
+     */
+    public function link(string $url, string $text): string
+    {
+        return "\033]8;;{$url}\033\\{$text}\033]8;;\033\\";
+    }
+
+    /**
+     * Generate window title sequence (OSC) using OscMode enum
+     */
+    public function title(string $title, OscMode $mode = OscMode::BOTH): string
+    {
+        return "\033]{$mode->value};{$title}\007";
+    }
+}
+
diff --git a/src/Framework/Console/Ansi/LinkFormatter.php b/src/Framework/Console/Ansi/LinkFormatter.php
new file mode 100644
index 00000000..5dc55310
--- /dev/null
+++ b/src/Framework/Console/Ansi/LinkFormatter.php
@@ -0,0 +1,113 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Ansi;
+
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+
+/**
+ * Formatter for clickable links using OSC 8 escape sequences.
+ * Format: \e]8;;URL\aText\e]8;;\a
+ */
+final readonly class LinkFormatter
+{
+    public function __construct(
+        private AnsiSequenceGenerator $ansiGenerator,
+        private TerminalCapabilities $capabilities
+    ) {
+    }
+
+    /**
+     * Create a clickable link
+     * Returns plain text if terminal doesn't support links
+     */
+    public function createLink(string $url, string $text): string
+    {
+        if (!$this->capabilities->supportsLinks()) {
+            return $text;
+        }
+
+        return $this->ansiGenerator->link($url, $text);
+    }
+
+    /**
+     * Create a clickable link with custom formatting
+     * Applies style to the link text while maintaining clickability
+     */
+    public function createStyledLink(
+        string $url,
+        string $text,
+        ?ConsoleStyle $style = null
+    ): string {
+        if (!$this->capabilities->supportsLinks()) {
+            // If no link support, just return styled text
+            if ($style !== null) {
+                return $style->apply($text);
+            }
+            return $text;
+        }
+
+        // Apply style to text, then wrap in link
+        $styledText = $style !== null ? $style->apply($text) : $text;
+
+        // Create link with styled text
+        // Note: The link sequence wraps the styled text
+        return $this->ansiGenerator->link($url, $styledText);
+    }
+
+    /**
+     * Create a clickable file link (file:// protocol)
+     */
+    public function createFileLink(string $filePath, string $text): string
+    {
+        $url = 'file://' . $filePath;
+        return $this->createLink($url, $text);
+    }
+
+    /**
+     * Create a clickable file link with line number for PhpStorm terminals
+     *
+     * Format: \e]8;;file://$file#$line\e\\$file:$line\e]8;;\e\\
+     * This format is recognized by PhpStorm and other JetBrains IDEs.
+     *
+     * @param string $filePath Absolute or relative file path
+     * @param int $line Line number (1-based)
+     * @param string|null $text Optional display text (defaults to "$filePath:$line")
+     * @return string ANSI-encoded clickable link
+     */
+    public function createFileLinkWithLine(string $filePath, int $line, ?string $text = null): string
+    {
+        // Use absolute path for file:// URL
+        $absolutePath = realpath($filePath);
+        if ($absolutePath === false) {
+            $absolutePath = $filePath;
+        }
+
+        // Normalize path separators for file:// URLs
+        $normalizedPath = str_replace('\\', '/', $absolutePath);
+
+        // Create file:// URL with line number anchor
+        $url = 'file://' . $normalizedPath . '#' . $line;
+
+        // Default text is file:line format
+        $displayText = $text ?? ($filePath . ':' . $line);
+
+        return $this->createLink($url, $displayText);
+    }
+
+    /**
+     * Create a clickable HTTP/HTTPS link
+     */
+    public function createHttpLink(string $url, string $text): string
+    {
+        // Ensure URL has protocol
+        if (!str_starts_with($url, 'http://') && !str_starts_with($url, 'https://')) {
+            $url = 'https://' . $url;
+        }
+
+        return $this->createLink($url, $text);
+    }
+}
+
diff --git a/src/Framework/Console/Ansi/RgbColor.php b/src/Framework/Console/Ansi/RgbColor.php
new file mode 100644
index 00000000..0c8135ee
--- /dev/null
+++ b/src/Framework/Console/Ansi/RgbColor.php
@@ -0,0 +1,186 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Ansi;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+
+/**
+ * RGB Color Value Object for truecolor support
+ */
+final readonly class RgbColor
+{
+    public function __construct(
+        public int $r,
+        public int $g,
+        public int $b
+    ) {
+        // Validate RGB values (0-255)
+        if ($r < 0 || $r > 255 || $g < 0 || $g > 255 || $b < 0 || $b > 255) {
+            throw new \InvalidArgumentException('RGB values must be between 0 and 255');
+        }
+    }
+
+    /**
+     * Create from hex color string (e.g., "#FF5733" or "FF5733")
+     */
+    public static function fromHex(string $hex): self
+    {
+        $hex = ltrim($hex, '#');
+        if (strlen($hex) !== 6 || !ctype_xdigit($hex)) {
+            throw new \InvalidArgumentException('Invalid hex color format');
+        }
+
+        $r = hexdec(substr($hex, 0, 2));
+        $g = hexdec(substr($hex, 2, 2));
+        $b = hexdec(substr($hex, 4, 2));
+
+        return new self($r, $g, $b);
+    }
+
+    /**
+     * Convert to hex string
+     */
+    public function toHex(): string
+    {
+        return sprintf('#%02X%02X%02X', $this->r, $this->g, $this->b);
+    }
+
+    /**
+     * Get ANSI sequence for this color (foreground)
+     */
+    public function toAnsiForeground(AnsiSequenceGenerator $generator, TerminalCapabilities $capabilities): string
+    {
+        if ($capabilities->supportsTruecolor()) {
+            return $generator->truecolorForeground($this->r, $this->g, $this->b);
+        }
+
+        // Fallback to nearest 256-color palette or standard color
+        return $this->toNearestColor()->toAnsi();
+    }
+
+    /**
+     * Get ANSI sequence for this color (background)
+     */
+    public function toAnsiBackground(AnsiSequenceGenerator $generator, TerminalCapabilities $capabilities): string
+    {
+        if ($capabilities->supportsTruecolor()) {
+            return $generator->truecolorBackground($this->r, $this->g, $this->b);
+        }
+
+        // Fallback to nearest 256-color palette or standard color
+        return $this->toNearestBackgroundColor()->toAnsi();
+    }
+
+    /**
+     * Convert to nearest standard ConsoleColor
+     */
+    public function toNearestColor(): ConsoleColor
+    {
+        // Simple conversion: find closest standard color
+        // This is a basic implementation - could be improved with better color distance calculation
+        $colors = [
+            ConsoleColor::BLACK,
+            ConsoleColor::RED,
+            ConsoleColor::GREEN,
+            ConsoleColor::YELLOW,
+            ConsoleColor::BLUE,
+            ConsoleColor::MAGENTA,
+            ConsoleColor::CYAN,
+            ConsoleColor::WHITE,
+        ];
+
+        $minDistance = PHP_INT_MAX;
+        $nearest = ConsoleColor::WHITE;
+
+        foreach ($colors as $color) {
+            $distance = $this->colorDistance($color);
+            if ($distance < $minDistance) {
+                $minDistance = $distance;
+                $nearest = $color;
+            }
+        }
+
+        return $nearest;
+    }
+
+    /**
+     * Convert to nearest background ConsoleColor
+     */
+    public function toNearestBackgroundColor(): ConsoleColor
+    {
+        // Similar to toNearestColor but for background colors
+        $bgColors = [
+            ConsoleColor::BG_BLACK,
+            ConsoleColor::BG_RED,
+            ConsoleColor::BG_GREEN,
+            ConsoleColor::BG_YELLOW,
+            ConsoleColor::BG_BLUE,
+            ConsoleColor::BG_MAGENTA,
+            ConsoleColor::BG_CYAN,
+            ConsoleColor::BG_WHITE,
+        ];
+
+        $minDistance = PHP_INT_MAX;
+        $nearest = ConsoleColor::BG_WHITE;
+
+        foreach ($bgColors as $color) {
+            $distance = $this->colorDistance($color);
+            if ($distance < $minDistance) {
+                $minDistance = $distance;
+                $nearest = $color;
+            }
+        }
+
+        return $nearest;
+    }
+
+    /**
+     * Calculate color distance (simple Euclidean distance)
+     */
+    private function colorDistance(ConsoleColor $color): float
+    {
+        // Map standard colors to RGB values
+        $colorMap = [
+            ConsoleColor::BLACK => [0, 0, 0],
+            ConsoleColor::RED => [255, 0, 0],
+            ConsoleColor::GREEN => [0, 255, 0],
+            ConsoleColor::YELLOW => [255, 255, 0],
+            ConsoleColor::BLUE => [0, 0, 255],
+            ConsoleColor::MAGENTA => [255, 0, 255],
+            ConsoleColor::CYAN => [0, 255, 255],
+            ConsoleColor::WHITE => [255, 255, 255],
+            ConsoleColor::GRAY => [128, 128, 128],
+            ConsoleColor::BRIGHT_RED => [255, 85, 85],
+            ConsoleColor::BRIGHT_GREEN => [85, 255, 85],
+            ConsoleColor::BRIGHT_YELLOW => [255, 255, 85],
+            ConsoleColor::BRIGHT_BLUE => [85, 85, 255],
+            ConsoleColor::BRIGHT_MAGENTA => [255, 85, 255],
+            ConsoleColor::BRIGHT_CYAN => [85, 255, 255],
+            ConsoleColor::BRIGHT_WHITE => [255, 255, 255],
+        ];
+
+        $bgColorMap = [
+            ConsoleColor::BG_BLACK => [0, 0, 0],
+            ConsoleColor::BG_RED => [255, 0, 0],
+            ConsoleColor::BG_GREEN => [0, 255, 0],
+            ConsoleColor::BG_YELLOW => [255, 255, 0],
+            ConsoleColor::BG_BLUE => [0, 0, 255],
+            ConsoleColor::BG_MAGENTA => [255, 0, 255],
+            ConsoleColor::BG_CYAN => [0, 255, 255],
+            ConsoleColor::BG_WHITE => [255, 255, 255],
+        ];
+
+        $allColors = array_merge($colorMap, $bgColorMap);
+        $rgb = $allColors[$color] ?? [128, 128, 128];
+
+        $dr = $this->r - $rgb[0];
+        $dg = $this->g - $rgb[1];
+        $db = $this->b - $rgb[2];
+
+        return sqrt($dr * $dr + $dg * $dg + $db * $db);
+    }
+}
+
diff --git a/src/Framework/Console/Ansi/TruecolorStyle.php b/src/Framework/Console/Ansi/TruecolorStyle.php
index 24945442..7c29f4d9 100644
--- a/src/Framework/Console/Ansi/TruecolorStyle.php
+++ b/src/Framework/Console/Ansi/TruecolorStyle.php
@@ -2,15 +2,19 @@
 
 namespace App\Framework\Console\Ansi;
 
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+
 /**
  * Truecolor Style Value Object
  */
 final readonly class TruecolorStyle
 {
     public function __construct(
-        private ?RgbColor                             $foreground = null,
-        private ?RgbColor                             $background = null,
-        private ?\App\Framework\Console\ConsoleFormat $format = null
+        private ?RgbColor      $foreground = null,
+        private ?RgbColor      $background = null,
+        private ?ConsoleFormat $format = null
     ) {}
 
     /**
@@ -19,7 +23,7 @@ final readonly class TruecolorStyle
     public static function create(
         ?RgbColor                             $foreground = null,
         ?RgbColor                             $background = null,
-        ?\App\Framework\Console\ConsoleFormat $format = null
+        ?ConsoleFormat $format = null
     ): self
     {
         return new self($foreground, $background, $format);
diff --git a/src/Framework/Console/CommandList.php b/src/Framework/Console/CommandList.php
index f6556a2c..73d7b716 100644
--- a/src/Framework/Console/CommandList.php
+++ b/src/Framework/Console/CommandList.php
@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace App\Framework\Console;
 
-use App\Framework\Exception\Core\ConsoleErrorCode;
-use App\Framework\Exception\FrameworkException;
+use App\Framework\Console\Exceptions\CommandNotFoundException;
+use App\Framework\Console\Exceptions\DuplicateCommandException;
 use ArrayIterator;
 use Countable;
 use IteratorAggregate;
@@ -26,10 +26,7 @@ final readonly class CommandList implements IteratorAggregate, Countable
 
         foreach ($commands as $command) {
             if (isset($commandMap[$command->name])) {
-                throw FrameworkException::create(
-                    ConsoleErrorCode::INVALID_COMMAND_STRUCTURE,
-                    "Duplicate command name '{$command->name}'"
-                )->withData(['command_name' => $command->name]);
+                throw new DuplicateCommandException($command->name);
             }
 
             $commandMap[$command->name] = $command;
@@ -46,10 +43,7 @@ final readonly class CommandList implements IteratorAggregate, Countable
     public function add(ConsoleCommand $command): self
     {
         if ($this->has($command->name)) {
-            throw FrameworkException::create(
-                ConsoleErrorCode::INVALID_COMMAND_STRUCTURE,
-                "Command '{$command->name}' already exists"
-            )->withData(['command_name' => $command->name]);
+            throw new DuplicateCommandException($command->name);
         }
 
         $allCommands = array_values($this->commands);
@@ -66,10 +60,7 @@ final readonly class CommandList implements IteratorAggregate, Countable
     public function get(string $name): ConsoleCommand
     {
         if (! $this->has($name)) {
-            throw FrameworkException::create(
-                ConsoleErrorCode::COMMAND_NOT_FOUND,
-                "Command '{$name}' not found"
-            )->withData(['command_name' => $name]);
+            throw new CommandNotFoundException($name);
         }
 
         return $this->commands[$name];
diff --git a/src/Framework/Console/CommandRegistry.php b/src/Framework/Console/CommandRegistry.php
index 3bd71ecc..7de5f543 100644
--- a/src/Framework/Console/CommandRegistry.php
+++ b/src/Framework/Console/CommandRegistry.php
@@ -4,13 +4,14 @@ declare(strict_types=1);
 
 namespace App\Framework\Console;
 
+use App\Framework\Console\Exceptions\CommandExecutionException;
+use App\Framework\Console\Exceptions\CommandMetadataNotFoundException;
+use App\Framework\Console\Exceptions\InvalidCommandConfigurationException;
 use App\Framework\Console\Performance\ConsolePerformanceCollector;
 use App\Framework\Console\Progress\ProgressMiddleware;
 use App\Framework\DI\Container;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
-use App\Framework\Exception\Core\ConsoleErrorCode;
-use App\Framework\Exception\FrameworkException;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
 use App\Framework\Performance\Contracts\PerformanceCollectorInterface;
@@ -52,10 +53,7 @@ final readonly class CommandRegistry
     public function getDiscoveredAttribute(string $commandName): DiscoveredAttribute
     {
         if (! isset($this->discoveredAttributes[$commandName])) {
-            throw FrameworkException::create(
-                ConsoleErrorCode::COMMAND_NOT_FOUND,
-                "No discovered attribute found for command '{$commandName}'"
-            )->withData(['command_name' => $commandName]);
+            throw new CommandMetadataNotFoundException($commandName);
         }
 
         return $this->discoveredAttributes[$commandName];
@@ -99,14 +97,7 @@ final readonly class CommandRegistry
 
             // Validate command structure
             if (! is_object($instance) || ! method_exists($instance, $methodName)) {
-                throw FrameworkException::create(
-                    ConsoleErrorCode::INVALID_COMMAND_STRUCTURE,
-                    "Invalid command configuration for '{$commandName}'"
-                )->withData([
-                    'command_name' => $commandName,
-                    'class_name' => $className,
-                    'method_name' => $methodName,
-                ]);
+                throw new InvalidCommandConfigurationException($commandName, $className, $methodName);
             }
 
             // Get reflection method for parameter resolution
@@ -127,14 +118,7 @@ final readonly class CommandRegistry
             return $this->normalizeCommandResult($result);
 
         } catch (Throwable $e) {
-            throw FrameworkException::create(
-                ConsoleErrorCode::EXECUTION_FAILED,
-                "Failed to execute command '{$commandName}': {$e->getMessage()}"
-            )->withData([
-                'command_name' => $commandName,
-                'error_message' => $e->getMessage(),
-                'error_type' => get_class($e),
-            ]);
+            throw new CommandExecutionException($commandName, $e);
         }
     }
 
@@ -155,15 +139,27 @@ final readonly class CommandRegistry
 
     private function discoverCommands(DiscoveryRegistry $discoveryRegistry): void
     {
+        /** @var array<string, ConsoleCommand> $commands */
         $commands = [];
         $discoveredAttributes = [];
+        $duplicateCommands = [];
 
         /** @var DiscoveredAttribute $discoveredAttribute */
         foreach ($discoveryRegistry->attributes->get(ConsoleCommand::class) as $discoveredAttribute) {
             try {
                 $registeredCommand = $this->registerDiscoveredCommand($discoveredAttribute);
-                $commands[] = $registeredCommand;
-                $discoveredAttributes[$registeredCommand->name] = $discoveredAttribute;
+                $commandName = $registeredCommand->name;
+
+                if (isset($commands[$commandName])) {
+                    $original = $discoveredAttributes[$commandName]->className->getFullyQualified();
+                    $duplicateCommands[$commandName] ??= [$original];
+                    $duplicateCommands[$commandName][] = $discoveredAttribute->className->getFullyQualified();
+
+                    continue;
+                }
+
+                $commands[$commandName] = $registeredCommand;
+                $discoveredAttributes[$commandName] = $discoveredAttribute;
 
             } catch (Throwable $e) {
                 // Log warning but continue with other commands
@@ -179,7 +175,25 @@ final readonly class CommandRegistry
             }
         }
 
-        $this->commandList = new CommandList(...$commands);
+        if ($duplicateCommands !== []) {
+            $duplicateSummary = [];
+            foreach ($duplicateCommands as $name => $classes) {
+                $duplicateSummary[] = "{$name}: " . implode(', ', array_unique($classes));
+            }
+
+            $message = "Duplizierte Console-Kommandos wurden ignoriert:\n - " . implode("\n - ", $duplicateSummary);
+            error_log($message);
+
+            if ($this->container->has(Logger::class)) {
+                $logger = $this->container->get(Logger::class);
+                $logger->warning('Duplicate console commands detected', LogContext::withData([
+                    'duplicates' => $duplicateCommands,
+                    'component' => 'CommandRegistry',
+                ]));
+            }
+        }
+
+        $this->commandList = new CommandList(...array_values($commands));
         $this->discoveredAttributes = $discoveredAttributes;
     }
 
diff --git a/src/Framework/Console/Commands/CodeQualityScanCommand.php b/src/Framework/Console/Commands/CodeQualityScanCommand.php
new file mode 100644
index 00000000..671593eb
--- /dev/null
+++ b/src/Framework/Console/Commands/CodeQualityScanCommand.php
@@ -0,0 +1,170 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Commands;
+
+use App\Framework\Console\CommandGroup;
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutputInterface;
+use App\Framework\Console\ExitCode;
+use App\Framework\Filesystem\FileScanner;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use App\Framework\Logging\Logger;
+use App\Framework\Quality\CodeQuality\CodeQualityScanner;
+use App\Framework\Quality\CodeQuality\Results\CodeQualityReport;
+use App\Framework\Quality\CodeQuality\Rules\DisallowInheritanceRule;
+use App\Framework\Quality\CodeQuality\Rules\FinalClassRule;
+use App\Framework\Quality\CodeQuality\Rules\ReadonlyGetterRule;
+use App\Framework\Quality\CodeQuality\Rules\ReadonlyPropertyRule;
+use App\Framework\Quality\CodeQuality\Rules\RequireStringableImplementationRule;
+use App\Framework\Reflection\ReflectionService;
+
+#[CommandGroup(
+    name: 'Quality',
+    description: 'Code quality inspections and automated rule checks',
+    icon: '🧹',
+    priority: 80
+)]
+final readonly class CodeQualityScanCommand
+{
+    private CodeQualityScanner $scanner;
+
+    public function __construct(
+        FileScanner $fileScanner,
+        ReflectionService $reflectionService,
+        ?Logger $logger = null
+    ) {
+        $this->scanner = new CodeQualityScanner(
+            $fileScanner,
+            $reflectionService,
+            [
+                new RequireStringableImplementationRule(),
+                new FinalClassRule(),
+                new ReadonlyPropertyRule(),
+                new ReadonlyGetterRule(),
+                new DisallowInheritanceRule(),
+            ],
+            $logger
+        );
+    }
+
+    #[ConsoleCommand('quality:scan', 'Check framework classes against predefined rules')]
+    public function scan(ConsoleInput $input, ConsoleOutputInterface $output): ExitCode
+    {
+        $pathArgument = $input->getArgument(0);
+        $directory = $pathArgument !== null
+            ? FilePath::create($pathArgument)
+            : FilePath::create(getcwd() . '/src');
+
+        $skipErrors = $input->hasOption('skip-errors');
+
+        if (! $directory->exists() || ! $directory->isDirectory()) {
+            $output->writeLine(
+                sprintf('❌ Directory "%s" does not exist or is not a directory.', $directory->toString()),
+                ConsoleColor::RED
+            );
+
+            return ExitCode::INVALID_INPUT;
+        }
+
+        $output->writeLine(
+            sprintf('🔍 Scanning %s for code quality violations...', $directory->toString()),
+            ConsoleColor::BRIGHT_CYAN
+        );
+
+        $report = $this->scanner->scan($directory, $skipErrors);
+
+        if ($report->hasErrors()) {
+            $output->newLine();
+            $headerColor = $skipErrors ? ConsoleColor::YELLOW : ConsoleColor::BRIGHT_RED;
+            $headerIcon = $skipErrors ? '⚠️' : '❌';
+            $output->writeLine(
+                sprintf(
+                    '%s Encountered %d file/class error(s) while scanning.',
+                    $headerIcon,
+                    count($report->errors())
+                ),
+                $headerColor
+            );
+
+            foreach ($report->errors() as $error) {
+                $output->writeLine('  • ' . $error, $headerColor);
+            }
+
+            if (! $skipErrors) {
+                return ExitCode::FAILURE;
+            }
+        }
+
+        $this->renderReport($report, $output);
+
+        return $report->hasViolations() ? ExitCode::FAILURE : ExitCode::SUCCESS;
+    }
+
+    private function renderReport(CodeQualityReport $report, ConsoleOutputInterface $output): void
+    {
+        $output->newLine();
+
+        $summaryColor = $report->hasViolations() ? ConsoleColor::BRIGHT_RED : ConsoleColor::GREEN;
+        $summaryIcon = $report->hasViolations() ? '❌' : '✅';
+        $summaryMessage = $report->hasViolations()
+            ? sprintf('Found %d violation(s).', $report->countViolations())
+            : 'No violations found.';
+
+        $output->writeLine(
+            sprintf(
+                '%s %s Scanned %d files, %d classes in %.2fs',
+                $summaryIcon,
+                $summaryMessage,
+                $report->inspectedFiles(),
+                $report->inspectedClasses(),
+                $report->durationSeconds()
+            ),
+            $summaryColor
+        );
+
+        if (! $report->hasViolations()) {
+            return;
+        }
+
+        $output->newLine();
+
+        foreach ($report->groupedByRule() as $ruleName => $violations) {
+            $output->writeLine(
+                sprintf('%s (%d)', $ruleName, count($violations)),
+                ConsoleColor::BRIGHT_YELLOW
+            );
+
+            foreach ($violations as $violation) {
+                $lineInfo = $violation->line() !== null ? ':' . $violation->line() : '';
+
+                $output->writeLine(
+                    sprintf(
+                        '  • %s',
+                        $violation->className()->getFullyQualified()
+                    ),
+                    ConsoleColor::WHITE
+                );
+
+                $output->writeLine(
+                    sprintf(
+                        '    ↳ %s%s',
+                        $violation->filePath()->toString(),
+                        $lineInfo
+                    ),
+                    ConsoleColor::GRAY
+                );
+
+                $output->writeLine(
+                    sprintf('    %s', $violation->message()),
+                    ConsoleColor::BRIGHT_RED
+                );
+
+                $output->newLine();
+            }
+        }
+    }
+}
diff --git a/src/Framework/Console/Commands/DatabaseBrowserCommand.php b/src/Framework/Console/Commands/DatabaseBrowserCommand.php
new file mode 100644
index 00000000..1785a9e4
--- /dev/null
+++ b/src/Framework/Console/Commands/DatabaseBrowserCommand.php
@@ -0,0 +1,242 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Commands;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Database\Browser\Registry\DatabaseRegistry;
+use App\Framework\Database\Browser\Registry\TableRegistry;
+use App\Framework\Display\Components\Console\Table;
+
+final readonly class DatabaseBrowserCommand
+{
+    public function __construct(
+        private DatabaseRegistry $databaseRegistry,
+        private TableRegistry $tableRegistry,
+    ) {
+    }
+
+    #[ConsoleCommand('db:browse', 'Browse database tables and schema')]
+    public function browse(
+        ConsoleInput $input,
+        ConsoleOutput $output,
+        ?string $table = null,
+        ?string $format = null,
+        bool $compact = false,
+        bool $verbose = false
+    ): int {
+        $format = $format ?? 'table';
+
+        try {
+            if ($table !== null) {
+                return $this->showTableDetails($output, $table, $format, $compact, $verbose);
+            }
+
+            return $this->showTablesList($output, $format, $compact);
+        } catch (\Exception $e) {
+            $output->writeError("Error: {$e->getMessage()}");
+            return 1;
+        }
+    }
+
+    private function showTablesList(ConsoleOutput $output, string $format, bool $compact): int
+    {
+        $database = $this->databaseRegistry->getCurrentDatabase();
+        $tables = $this->tableRegistry->getAllTables();
+
+        if ($format === 'json') {
+            $output->writeLine(json_encode([
+                'database' => $database->toArray(),
+                'tables' => array_map(fn ($t) => $t->toArray(), $tables),
+            ], JSON_PRETTY_PRINT));
+            return 0;
+        }
+
+        // Show database info
+        $output->writeLine("Database: {$database->name}", ConsoleStyle::create(
+            color: ConsoleColor::BRIGHT_CYAN,
+            format: \App\Framework\Console\ConsoleFormat::BOLD
+        ));
+        $output->newLine();
+
+        // Create table
+        $table = new Table(
+            headerStyle: ConsoleStyle::create(
+                color: ConsoleColor::BRIGHT_WHITE,
+                format: \App\Framework\Console\ConsoleFormat::BOLD
+            ),
+            borderStyle: ConsoleStyle::create(color: ConsoleColor::GRAY)
+        );
+
+        if ($compact) {
+            $table->setHeaders(['Name', 'Rows', 'Size (MB)']);
+            foreach ($tables as $t) {
+                $table->addRow([
+                    $t->name,
+                    $t->rowCount !== null ? number_format($t->rowCount) : 'N/A',
+                    $t->sizeMb !== null ? number_format($t->sizeMb, 2) : 'N/A',
+                ]);
+            }
+        } else {
+            $table->setHeaders(['Name', 'Rows', 'Size (MB)', 'Engine', 'Collation']);
+            foreach ($tables as $t) {
+                $table->addRow([
+                    $t->name,
+                    $t->rowCount !== null ? number_format($t->rowCount) : 'N/A',
+                    $t->sizeMb !== null ? number_format($t->sizeMb, 2) : 'N/A',
+                    $t->engine ?? 'N/A',
+                    $t->collation ?? 'N/A',
+                ]);
+            }
+        }
+
+        $output->write($table->render());
+        $output->newLine();
+        $output->writeLine("Total tables: " . count($tables), ConsoleStyle::create(color: ConsoleColor::GRAY));
+
+        return 0;
+    }
+
+    private function showTableDetails(
+        ConsoleOutput $output,
+        string $tableName,
+        string $format,
+        bool $compact,
+        bool $verbose
+    ): int {
+        $tableSchema = $this->tableRegistry->getTableSchema($tableName);
+
+        if ($tableSchema === null) {
+            $output->writeError("Table '{$tableName}' not found");
+            return 1;
+        }
+
+        if ($format === 'json') {
+            $output->writeLine(json_encode($tableSchema->toArray(), JSON_PRETTY_PRINT));
+            return 0;
+        }
+
+        // Show table info
+        $output->writeLine("Table: {$tableSchema->name}", ConsoleStyle::create(
+            color: ConsoleColor::BRIGHT_CYAN,
+            format: \App\Framework\Console\ConsoleFormat::BOLD
+        ));
+        $output->writeLine("Rows: " . ($tableSchema->rowCount !== null ? number_format($tableSchema->rowCount) : 'N/A'));
+        $output->writeLine("Size: " . ($tableSchema->sizeMb !== null ? number_format($tableSchema->sizeMb, 2) . ' MB' : 'N/A'));
+        $output->writeLine("Engine: " . ($tableSchema->engine ?? 'N/A'));
+        $output->newLine();
+
+        // Show columns
+        $output->writeLine("Columns:", ConsoleStyle::create(
+            color: ConsoleColor::BRIGHT_YELLOW,
+            format: \App\Framework\Console\ConsoleFormat::BOLD
+        ));
+
+        $columnsTable = new Table(
+            headerStyle: ConsoleStyle::create(
+                color: ConsoleColor::BRIGHT_WHITE,
+                format: \App\Framework\Console\ConsoleFormat::BOLD
+            ),
+            borderStyle: ConsoleStyle::create(color: ConsoleColor::GRAY)
+        );
+
+        if ($compact) {
+            $columnsTable->setHeaders(['Name', 'Type', 'Nullable', 'Key']);
+            foreach ($tableSchema->columns as $column) {
+                $key = $column->key ?? '';
+                $keyColor = match ($key) {
+                    'PRI' => ConsoleColor::BRIGHT_GREEN,
+                    'UNI' => ConsoleColor::BRIGHT_YELLOW,
+                    'MUL' => ConsoleColor::YELLOW,
+                    default => ConsoleColor::GRAY,
+                };
+                $columnsTable->addRow([
+                    $column->name,
+                    $column->type,
+                    $column->nullable ? 'Yes' : 'No',
+                    $key !== '' ? $key : '-',
+                ]);
+            }
+        } else {
+            $columnsTable->setHeaders(['Name', 'Type', 'Nullable', 'Default', 'Key', 'Extra']);
+            foreach ($tableSchema->columns as $column) {
+                $columnsTable->addRow([
+                    $column->name,
+                    $column->type,
+                    $column->nullable ? 'Yes' : 'No',
+                    $column->default ?? '-',
+                    $column->key ?? '-',
+                    $column->extra ?? '-',
+                ]);
+            }
+        }
+
+        $output->write($columnsTable->render());
+        $output->newLine();
+
+        // Show indexes if verbose
+        if ($verbose && !empty($tableSchema->indexes)) {
+            $output->writeLine("Indexes:", ConsoleStyle::create(
+                color: ConsoleColor::BRIGHT_YELLOW,
+                format: \App\Framework\Console\ConsoleFormat::BOLD
+            ));
+
+            $indexesTable = new Table(
+                headerStyle: ConsoleStyle::create(
+                    color: ConsoleColor::BRIGHT_WHITE,
+                    format: \App\Framework\Console\ConsoleFormat::BOLD
+                ),
+                borderStyle: ConsoleStyle::create(color: ConsoleColor::GRAY)
+            );
+
+            $indexesTable->setHeaders(['Name', 'Columns', 'Unique', 'Type']);
+            foreach ($tableSchema->indexes as $index) {
+                $indexesTable->addRow([
+                    $index->name,
+                    implode(', ', $index->columns),
+                    $index->unique ? 'Yes' : 'No',
+                    $index->type ?? '-',
+                ]);
+            }
+
+            $output->write($indexesTable->render());
+            $output->newLine();
+        }
+
+        // Show foreign keys if verbose
+        if ($verbose && !empty($tableSchema->foreignKeys)) {
+            $output->writeLine("Foreign Keys:", ConsoleStyle::create(
+                color: ConsoleColor::BRIGHT_YELLOW,
+                format: \App\Framework\Console\ConsoleFormat::BOLD
+            ));
+
+            $fkTable = new Table(
+                headerStyle: ConsoleStyle::create(
+                    color: ConsoleColor::BRIGHT_WHITE,
+                    format: \App\Framework\Console\ConsoleFormat::BOLD
+                ),
+                borderStyle: ConsoleStyle::create(color: ConsoleColor::GRAY)
+            );
+
+            $fkTable->setHeaders(['Name', 'Column', 'Referenced Table', 'Referenced Column']);
+            foreach ($tableSchema->foreignKeys as $fk) {
+                $fkTable->addRow([
+                    $fk->name,
+                    $fk->column,
+                    $fk->referencedTable,
+                    $fk->referencedColumn,
+                ]);
+            }
+
+            $output->write($fkTable->render());
+        }
+
+        return 0;
+    }
+}
+
diff --git a/src/Framework/Console/Commands/HotReloadCommand.php b/src/Framework/Console/Commands/HotReloadCommand.php
index 71ee1344..0411d4fc 100644
--- a/src/Framework/Console/Commands/HotReloadCommand.php
+++ b/src/Framework/Console/Commands/HotReloadCommand.php
@@ -68,20 +68,38 @@ final readonly class HotReloadCommand
         });
 
         // Handle signals for graceful shutdown
-        if (extension_loaded('pcntl')) {
-            pcntl_signal(SIGINT, function () use ($hotReloadServer, $output) {
+        try {
+            $pcntlService = $container->get(\App\Framework\Pcntl\PcntlService::class);
+            $pcntlService->registerSignal(\App\Framework\Pcntl\ValueObjects\Signal::SIGINT, function () use ($hotReloadServer, $output) {
                 $output->writeln('');
                 $output->info('Received interrupt signal, shutting down...');
                 $hotReloadServer->stop();
                 exit(0);
             });
 
-            pcntl_signal(SIGTERM, function () use ($hotReloadServer, $output) {
+            $pcntlService->registerSignal(\App\Framework\Pcntl\ValueObjects\Signal::SIGTERM, function () use ($hotReloadServer, $output) {
                 $output->writeln('');
                 $output->info('Received termination signal, shutting down...');
                 $hotReloadServer->stop();
                 exit(0);
             });
+        } catch (\Throwable $e) {
+            // Fallback to direct pcntl_signal if PCNTL service not available
+            if (extension_loaded('pcntl')) {
+                pcntl_signal(SIGINT, function () use ($hotReloadServer, $output) {
+                    $output->writeln('');
+                    $output->info('Received interrupt signal, shutting down...');
+                    $hotReloadServer->stop();
+                    exit(0);
+                });
+
+                pcntl_signal(SIGTERM, function () use ($hotReloadServer, $output) {
+                    $output->writeln('');
+                    $output->info('Received termination signal, shutting down...');
+                    $hotReloadServer->stop();
+                    exit(0);
+                });
+            }
         }
 
         $output->success('Hot Reload server is running!');
@@ -104,8 +122,14 @@ final readonly class HotReloadCommand
             sleep(1);
 
             // Process signals if available
-            if (extension_loaded('pcntl')) {
-                pcntl_signal_dispatch();
+            try {
+                $pcntlService = $container->get(\App\Framework\Pcntl\PcntlService::class);
+                $pcntlService->dispatchSignals();
+            } catch (\Throwable $e) {
+                // Fallback to direct dispatch if PCNTL service not available
+                if (extension_loaded('pcntl')) {
+                    pcntl_signal_dispatch();
+                }
             }
         }
 
diff --git a/src/Framework/Console/Components/ConsoleDialog.php b/src/Framework/Console/Components/ConsoleDialog.php
index b8924555..f48a5280 100644
--- a/src/Framework/Console/Components/ConsoleDialog.php
+++ b/src/Framework/Console/Components/ConsoleDialog.php
@@ -152,8 +152,14 @@ final readonly class ConsoleDialog
 
         while ($running) {
             // Handle signals
-            if (function_exists('pcntl_signal_dispatch')) {
-                pcntl_signal_dispatch();
+            try {
+                $pcntlService = $this->container->get(\App\Framework\Pcntl\PcntlService::class);
+                $pcntlService->dispatchSignals();
+            } catch (\Throwable $e) {
+                // Fallback to direct dispatch if PCNTL service not available
+                if (function_exists('pcntl_signal_dispatch')) {
+                    pcntl_signal_dispatch();
+                }
             }
 
             // Read input
diff --git a/src/Framework/Console/Components/ConsoleTUI.php b/src/Framework/Console/Components/ConsoleTUI.php
index 55a2ceb0..a0ec5d97 100644
--- a/src/Framework/Console/Components/ConsoleTUI.php
+++ b/src/Framework/Console/Components/ConsoleTUI.php
@@ -14,16 +14,28 @@ use App\Framework\Console\Screen\MouseControlCode;
 use App\Framework\Console\Screen\ScreenControlCode;
 use App\Framework\Console\SimpleWorkflowExecutor;
 use App\Framework\Console\TuiView;
+use App\Framework\Console\Animation\AnimationManager;
+use App\Framework\Console\Components\EventLoop\EventLoop;
+use App\Framework\Console\Components\EventLoop\EventLoopConfig;
+use App\Framework\Console\Components\Handlers\KeyboardEventHandler;
+use App\Framework\Console\Components\Handlers\MouseEventHandler;
 use App\Framework\DI\Container;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Pcntl\ValueObjects\Signal;
+use Throwable;
 
 /**
  * Main TUI orchestrator - coordinates specialized components
- * Refactored to follow Single Responsibility Principle
+ * Refactored to use EventLoop for stable event handling
  */
 final readonly class ConsoleTUI
 {
     private InputParser $inputParser;
+    private EventLoop $eventLoop;
+    private MouseEventHandler $mouseHandler;
+    private KeyboardEventHandler $keyboardHandler;
+    private AnimationManager $animationManager;
 
     public function __construct(
         private ConsoleOutputInterface $output,
@@ -31,13 +43,43 @@ final readonly class ConsoleTUI
         private DiscoveryRegistry $discoveryRegistry,
         private TuiState $state,
         private TuiRenderer $renderer,
-        private TuiInputHandler $inputHandler,
         private TuiCommandExecutor $commandExecutor,
         private CommandHistory $commandHistory,
         private CommandGroupRegistry $groupRegistry,
         private SimpleWorkflowExecutor $workflowExecutor
     ) {
-        $this->inputParser = new InputParser();
+        $eventBuffer = new EventBuffer();
+        $this->inputParser = new InputParser($eventBuffer);
+        
+        // Create animation manager
+        $this->animationManager = new AnimationManager();
+        
+        // Initialize renderer with animation manager if it doesn't have one
+        // Note: We can't replace the readonly renderer, but we can ensure it has animation support
+        // The renderer will use the animation manager if provided in constructor
+        // If renderer was created without animation manager, animations won't work for that renderer instance
+        // In that case, animations will still work via the animation manager directly
+        
+        // Create event loop with animation manager
+        $config = new EventLoopConfig(
+            enableSignalDispatch: true,
+            minRenderInterval: 0.016, // ~60 FPS max
+            errorHandler: function (Throwable $e) {
+                // Log error but don't break loop
+                error_log("TUI Error: " . $e->getMessage());
+            }
+        );
+        $this->eventLoop = new EventLoop($eventBuffer, $config, $this->animationManager);
+        
+        // Create specialized handlers
+        $this->mouseHandler = new MouseEventHandler(
+            $this->renderer->getMenuBar(),
+            $this->commandExecutor
+        );
+        $this->keyboardHandler = new KeyboardEventHandler(
+            $this->commandExecutor,
+            $this->renderer->getMenuBar()
+        );
     }
 
     /**
@@ -47,7 +89,7 @@ final readonly class ConsoleTUI
     {
         try {
             $this->initialize();
-            $this->mainLoop();
+            $this->runEventLoop();
         } finally {
             // Always cleanup, even on interrupt or error
             $this->cleanup();
@@ -75,51 +117,109 @@ final readonly class ConsoleTUI
      */
     private function setupSignalHandlers(): void
     {
-        if (function_exists('pcntl_signal')) {
-            pcntl_signal(SIGINT, [$this, 'handleShutdownSignal']);
-            pcntl_signal(SIGTERM, [$this, 'handleShutdownSignal']);
+        try {
+            $pcntlService = $this->container->get(PcntlService::class);
+            $pcntlService->registerSignal(Signal::SIGINT, function (Signal $signal) {
+                $this->handleShutdownSignal($signal);
+            });
+            $pcntlService->registerSignal(Signal::SIGTERM, function (Signal $signal) {
+                $this->handleShutdownSignal($signal);
+            });
+        } catch (\Throwable $e) {
+            // Fallback to direct pcntl_signal if PCNTL service not available
+            if (function_exists('pcntl_signal')) {
+                pcntl_signal(SIGINT, [$this, 'handleShutdownSignalLegacy']);
+                pcntl_signal(SIGTERM, [$this, 'handleShutdownSignalLegacy']);
+            }
         }
     }
 
     /**
      * Handle shutdown signals (SIGINT, SIGTERM)
      */
-    public function handleShutdownSignal(int $signal): void
+    public function handleShutdownSignal(Signal $signal): void
     {
         $this->state->setRunning(false);
-        // Cleanup will be called in run() method's finally block or in cleanup()
     }
 
     /**
-     * Main event loop
+     * Legacy signal handler for when PCNTL service is not available
      */
-    private function mainLoop(): void
+    public function handleShutdownSignalLegacy(int $signal): void
+    {
+        $this->state->setRunning(false);
+    }
+
+    /**
+     * Run the event loop using EventLoop service
+     */
+    private function runEventLoop(): void
     {
         $needsRender = true;
+        $errorCount = 0;
+        $lastRenderTime = 0.0;
 
         while ($this->state->isRunning()) {
-            // Dispatch any pending signals (for graceful shutdown)
-            if (function_exists('pcntl_signal_dispatch')) {
-                pcntl_signal_dispatch();
-            }
+            try {
+                // Dispatch signals
+                try {
+                    $pcntlService = $this->container->get(PcntlService::class);
+                    $pcntlService->dispatchSignals();
+                } catch (\Throwable $e) {
+                    // Fallback to direct dispatch if PCNTL service not available
+                    if (function_exists('pcntl_signal_dispatch')) {
+                        pcntl_signal_dispatch();
+                    }
+                }
 
-            // Only render when needed
-            if ($needsRender) {
-                $this->renderCurrentView();
-                $needsRender = false;
-            }
+                // Read new events from parser and add to buffer
+                $this->eventLoop->readAndBufferEvents(fn() => $this->inputParser->readEvent());
 
-            // Handle input (non-blocking)
-            $event = $this->inputParser->readEvent();
-            
-            if ($event === null) {
-                // No input available, sleep briefly to reduce CPU usage
-                usleep(50000); // 50ms
-                continue;
-            }
+                // Update animations
+                $this->animationManager->update(0.016); // ~60 FPS
 
-            // Process event and mark for re-render
-            $needsRender = $this->processEvent($event);
+                // Process events from buffer
+                $eventsProcessed = $this->eventLoop->processEvents(function (MouseEvent|KeyEvent $event) use (&$needsRender) {
+                    $needsRender = $this->processEvent($event) || $needsRender;
+                });
+
+                if ($eventsProcessed > 0) {
+                    $needsRender = true;
+                }
+
+                // Render if needed (with throttling)
+                if ($needsRender) {
+                    $currentTime = microtime(true);
+                    $timeSinceLastRender = $currentTime - $lastRenderTime;
+
+                    if ($timeSinceLastRender >= 0.016) { // ~60 FPS max
+                        $this->renderCurrentView();
+                        $lastRenderTime = $currentTime;
+                        $needsRender = false;
+                    }
+                }
+
+                // Reset error count on successful iteration
+                $errorCount = 0;
+
+                // Sleep if no events processed to reduce CPU usage
+                if ($eventsProcessed === 0) {
+                    usleep(5000); // 5ms
+                }
+            } catch (Throwable $e) {
+                $errorCount++;
+                
+                // Log error
+                error_log("TUI Error: " . $e->getMessage());
+
+                // If too many errors, break loop
+                if ($errorCount >= 10) {
+                    break;
+                }
+
+                // Brief pause before retry
+                usleep(10000); // 10ms
+            }
         }
     }
 
@@ -134,20 +234,11 @@ final readonly class ConsoleTUI
             return true;
         }
 
-        // Dispatch event to input handler
+        // Dispatch event to appropriate handler
         if ($event instanceof MouseEvent) {
-            $needsRender = $this->inputHandler->handleMouseEvent($event, $this->state, $this->commandHistory);
-            return $needsRender; // Only re-render if handler indicates it's needed
+            return $this->mouseHandler->handle($event, $this->state, $this->commandHistory);
         } elseif ($event instanceof KeyEvent) {
-            // Handle Ctrl+C
-            if ($event->ctrl && $event->key === 'C') {
-                $this->state->setRunning(false);
-                return false;
-            }
-
-            // Use new KeyEvent handler (supports Alt+Letter shortcuts)
-            $this->inputHandler->handleKeyEvent($event, $this->state, $this->commandHistory);
-            return true; // Key events always need re-render
+            return $this->keyboardHandler->handle($event, $this->state, $this->commandHistory);
         }
 
         return false;
@@ -172,7 +263,6 @@ final readonly class ConsoleTUI
     private function flushRemainingInput(): void
     {
         // First, disable mouse tracking immediately to stop new events
-        // Send disable commands multiple times to ensure they're processed
         for ($i = 0; $i < 3; $i++) {
             $this->output->write(MouseControlCode::DISABLE_MOVE->format());
             $this->output->write(MouseControlCode::DISABLE_SGR->format());
@@ -194,7 +284,7 @@ final readonly class ConsoleTUI
         try {
             // Aggressively read and discard ALL remaining input
             $totalDiscarded = 0;
-            $maxAttempts = 200; // Read up to 200 characters
+            $maxAttempts = 200;
             $attempt = 0;
             
             while ($attempt < $maxAttempts && $totalDiscarded < 1000) {
@@ -202,20 +292,17 @@ final readonly class ConsoleTUI
                 $write = null;
                 $except = null;
                 
-                // Very short timeout to quickly drain buffer
                 $result = stream_select($read, $write, $except, 0, 5000); // 5ms
                 
                 if ($result === false || $result === 0) {
-                    // No more input immediately available, try a few more times
                     if ($attempt > 10 && $totalDiscarded === 0) {
-                        break; // No input after multiple attempts
+                        break;
                     }
                     $attempt++;
                     usleep(5000); // 5ms
                     continue;
                 }
                 
-                // Read and discard characters in chunks
                 $readCount = 0;
                 while (($char = fgetc(STDIN)) !== false && $readCount < 50) {
                     $totalDiscarded++;
@@ -228,10 +315,9 @@ final readonly class ConsoleTUI
                     continue;
                 }
                 
-                $attempt = 0; // Reset attempt counter if we read something
+                $attempt = 0;
             }
         } finally {
-            // Restore blocking mode
             stream_set_blocking(STDIN, $originalBlocking);
         }
     }
@@ -248,10 +334,6 @@ final readonly class ConsoleTUI
         // Enable mouse reporting (SGR format)
         $this->output->write(MouseControlCode::ENABLE_ALL->format());
         $this->output->write(MouseControlCode::ENABLE_SGR->format());
-        // Note: Mouse move tracking (ENABLE_MOVE) is disabled by default
-        // because it generates too many events that can overflow the input buffer
-        // If hover effects are needed, consider enabling it conditionally
-        // $this->output->write(MouseControlCode::ENABLE_MOVE->format());
 
         // Optional: Enable alternate screen buffer
         $this->output->write(ScreenControlCode::ALTERNATE_BUFFER->format());
@@ -266,8 +348,7 @@ final readonly class ConsoleTUI
      */
     private function restoreTerminal(): void
     {
-        // Note: Mouse tracking is disabled in flushRemainingInput() before this
-        // But we disable it here too as a safety measure
+        // Disable mouse tracking
         $this->output->write(MouseControlCode::DISABLE_MOVE->format());
         $this->output->write(MouseControlCode::DISABLE_SGR->format());
         $this->output->write(MouseControlCode::DISABLE_ALL->format());
@@ -294,11 +375,9 @@ final readonly class ConsoleTUI
      */
     private function loadCommands(): void
     {
-        // Use the new CommandGroupRegistry for organized commands
         $categories = $this->groupRegistry->getOrganizedCommands();
         $this->state->setCategories($categories);
 
-        // Load available workflows
         $workflows = $this->groupRegistry->getWorkflows();
         $this->state->setWorkflows($workflows);
     }
@@ -311,8 +390,6 @@ final readonly class ConsoleTUI
         $this->renderer->render($this->state, $this->commandHistory);
     }
 
-
-
     /**
      * Handle form mode interaction
      */
@@ -324,71 +401,6 @@ final readonly class ConsoleTUI
         }
     }
 
-    /**
-     * Read a single key from input (including multi-byte escape sequences)
-     * Enhanced for PHPStorm terminal compatibility
-     */
-    private function readKey(): string
-    {
-        $key = fgetc(STDIN);
-        if ($key === false) {
-            return '';
-        }
-
-        // Handle escape sequences (arrow keys, etc.)
-        if ($key === "\033") {
-            $sequence = $key;
-
-            // Use non-blocking read for better compatibility
-            $originalBlocking = stream_get_meta_data(STDIN)['blocked'] ?? true;
-            stream_set_blocking(STDIN, false);
-
-            // Read the next character with small timeout
-            $next = fgetc(STDIN);
-            if ($next === false) {
-                // Wait a bit and try again (PHPStorm sometimes needs this)
-                usleep(10000); // 10ms
-                $next = fgetc(STDIN);
-            }
-
-            if ($next !== false) {
-                $sequence .= $next;
-
-                // If it's a bracket, read more
-                if ($next === '[') {
-                    $third = fgetc(STDIN);
-                    if ($third === false) {
-                        usleep(10000); // 10ms
-                        $third = fgetc(STDIN);
-                    }
-
-                    if ($third !== false) {
-                        $sequence .= $third;
-
-                        // Some sequences have more characters (like Page Up/Down)
-                        if (in_array($third, ['5', '6', '3', '1', '2', '4'])) {
-                            $fourth = fgetc(STDIN);
-                            if ($fourth === false) {
-                                usleep(5000); // 5ms
-                                $fourth = fgetc(STDIN);
-                            }
-                            if ($fourth !== false) {
-                                $sequence .= $fourth;
-                            }
-                        }
-                    }
-                }
-            }
-
-            // Restore blocking mode
-            stream_set_blocking(STDIN, $originalBlocking);
-
-            return $sequence;
-        }
-
-        return $key;
-    }
-
     /**
      * Show welcome screen and wait for user input
      */
@@ -436,18 +448,14 @@ final readonly class ConsoleTUI
 
         if ($enabled) {
             if ($isPhpStorm) {
-                // PHPStorm-optimized settings
                 shell_exec('stty raw -echo min 1 time 0 2>/dev/null');
             } else {
-                // Standard terminal settings
                 shell_exec('stty -icanon -echo 2>/dev/null');
             }
         } else {
             if ($isPhpStorm) {
-                // PHPStorm-optimized restore
                 shell_exec('stty -raw echo 2>/dev/null');
             } else {
-                // Standard terminal restore
                 shell_exec('stty icanon echo 2>/dev/null');
             }
         }
diff --git a/src/Framework/Console/Components/EventBuffer.php b/src/Framework/Console/Components/EventBuffer.php
new file mode 100644
index 00000000..7dc00782
--- /dev/null
+++ b/src/Framework/Console/Components/EventBuffer.php
@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components;
+
+use SplQueue;
+
+/**
+ * Buffer for events and partial sequences.
+ * Provides thread-safe event queuing and partial sequence handling.
+ */
+final class EventBuffer
+{
+    private SplQueue $eventQueue;
+
+    private string $partialSequence = '';
+
+    private int $maxQueueSize;
+
+    public function __construct(int $maxQueueSize = 1000)
+    {
+        $this->eventQueue = new SplQueue();
+        $this->maxQueueSize = $maxQueueSize;
+    }
+
+    /**
+     * Enqueue an event
+     */
+    public function enqueue(MouseEvent|KeyEvent $event): void
+    {
+        if ($this->eventQueue->count() >= $this->maxQueueSize) {
+            // Drop oldest event if queue is full (backpressure)
+            $this->eventQueue->dequeue();
+        }
+
+        $this->eventQueue->enqueue($event);
+    }
+
+    /**
+     * Dequeue an event
+     */
+    public function dequeue(): MouseEvent|KeyEvent|null
+    {
+        if ($this->eventQueue->isEmpty()) {
+            return null;
+        }
+
+        return $this->eventQueue->dequeue();
+    }
+
+    /**
+     * Get pending event count
+     */
+    public function getPendingCount(): int
+    {
+        return $this->eventQueue->count();
+    }
+
+    /**
+     * Clear all events
+     */
+    public function clear(): void
+    {
+        while (!$this->eventQueue->isEmpty()) {
+            $this->eventQueue->dequeue();
+        }
+    }
+
+    /**
+     * Store partial sequence for later completion
+     */
+    public function storePartialSequence(string $sequence): void
+    {
+        $this->partialSequence = $sequence;
+    }
+
+    /**
+     * Get and clear stored partial sequence
+     */
+    public function getPartialSequence(): string
+    {
+        $sequence = $this->partialSequence;
+        $this->partialSequence = '';
+        return $sequence;
+    }
+
+    /**
+     * Check if partial sequence exists
+     */
+    public function hasPartialSequence(): bool
+    {
+        return $this->partialSequence !== '';
+    }
+}
+
diff --git a/src/Framework/Console/Components/EventLoop/EventLoop.php b/src/Framework/Console/Components/EventLoop/EventLoop.php
new file mode 100644
index 00000000..9789bcda
--- /dev/null
+++ b/src/Framework/Console/Components/EventLoop/EventLoop.php
@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\EventLoop;
+
+use App\Framework\Console\Animation\AnimationManager;
+use App\Framework\Console\Components\EventBuffer;
+use App\Framework\Console\Components\KeyEvent;
+use App\Framework\Console\Components\MouseEvent;
+use Throwable;
+
+/**
+ * Stable event loop for TUI with error handling and event buffering.
+ * Provides a robust main loop with automatic recovery and rate limiting.
+ */
+final class EventLoop
+{
+    private const int MAX_EVENTS_PER_CYCLE = 10;
+    private const int LOOP_SLEEP_MICROSECONDS = 5000; // 5ms
+    private const int MAX_ERROR_COUNT = 10;
+
+    public function __construct(
+        private readonly EventBuffer $eventBuffer,
+        private readonly EventLoopConfig $config,
+        private ?AnimationManager $animationManager = null
+    ) {
+    }
+
+    /**
+     * Process events from buffer (with rate limiting)
+     * Returns number of events processed
+     */
+    public function processEvents(callable $processEvent): int
+    {
+        $processed = 0;
+        $maxEvents = min(self::MAX_EVENTS_PER_CYCLE, $this->eventBuffer->getPendingCount());
+
+        for ($i = 0; $i < $maxEvents; $i++) {
+            $event = $this->eventBuffer->dequeue();
+            if ($event === null) {
+                break;
+            }
+
+            try {
+                $this->safeProcessEvent($processEvent, $event);
+                $processed++;
+            } catch (Throwable $e) {
+                // Log but continue processing
+                if ($this->config->errorHandler !== null) {
+                    $this->config->errorHandler->__invoke($e);
+                }
+            }
+        }
+
+        return $processed;
+    }
+
+    /**
+     * Read events from input parser and add to buffer
+     */
+    public function readAndBufferEvents(callable $readEvent): int
+    {
+        $readCount = 0;
+        $maxRead = 10; // Read up to 10 events per cycle
+
+        for ($i = 0; $i < $maxRead; $i++) {
+            $event = $readEvent();
+            if ($event === null) {
+                break;
+            }
+
+            $this->eventBuffer->enqueue($event);
+            $readCount++;
+        }
+
+        return $readCount;
+    }
+
+    /**
+     * Safely process a single event
+     */
+    private function safeProcessEvent(callable $processEvent, MouseEvent|KeyEvent $event): void
+    {
+        try {
+            $processEvent($event);
+        } catch (Throwable $e) {
+            // Re-throw to be handled by caller
+            throw $e;
+        }
+    }
+
+    /**
+     * Register animation manager for automatic updates
+     */
+    public function registerAnimationManager(AnimationManager $manager): void
+    {
+        $this->animationManager = $manager;
+    }
+
+    /**
+     * Update animations (called from loop)
+     */
+    public function updateAnimations(float $deltaTime): void
+    {
+        if ($this->animationManager !== null) {
+            $this->animationManager->update($deltaTime);
+        }
+    }
+}
diff --git a/src/Framework/Console/Components/EventLoop/EventLoopConfig.php b/src/Framework/Console/Components/EventLoop/EventLoopConfig.php
new file mode 100644
index 00000000..20be003e
--- /dev/null
+++ b/src/Framework/Console/Components/EventLoop/EventLoopConfig.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\EventLoop;
+
+use Closure;
+use Throwable;
+
+/**
+ * Configuration for EventLoop
+ */
+final readonly class EventLoopConfig
+{
+    /**
+     * @param Closure(Throwable): void|null $errorHandler
+     */
+    public function __construct(
+        public bool $enableSignalDispatch = true,
+        public float $minRenderInterval = 0.016, // ~60 FPS max
+        public ?Closure $errorHandler = null
+    ) {
+    }
+}
+
diff --git a/src/Framework/Console/Components/Handlers/KeyboardEventHandler.php b/src/Framework/Console/Components/Handlers/KeyboardEventHandler.php
new file mode 100644
index 00000000..17417aa9
--- /dev/null
+++ b/src/Framework/Console/Components/Handlers/KeyboardEventHandler.php
@@ -0,0 +1,485 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\Handlers;
+
+use App\Framework\Console\CommandHistory;
+use App\Framework\Console\Components\KeyEvent;
+use App\Framework\Console\Components\MenuBar;
+use App\Framework\Console\Components\TuiCommandExecutor;
+use App\Framework\Console\Components\TuiState;
+use App\Framework\Console\HistoryTab;
+use App\Framework\Console\TuiKeyCode;
+use App\Framework\Console\TuiView;
+use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
+
+/**
+ * Isolated keyboard event handler.
+ * Handles all keyboard input and navigation for different views.
+ */
+final readonly class KeyboardEventHandler
+{
+    public function __construct(
+        private TuiCommandExecutor $commandExecutor,
+        private ?MenuBar $menuBar = null
+    ) {
+    }
+
+    /**
+     * Handle keyboard event
+     * Returns true if re-render is needed
+     */
+    public function handle(KeyEvent $event, TuiState $state, CommandHistory $history): bool
+    {
+        // Handle Ctrl+C
+        if ($event->ctrl && $event->key === 'C') {
+            $state->setRunning(false);
+            return false;
+        }
+
+        // Handle Alt+Letter shortcuts for menu
+        if ($event->alt && $this->menuBar !== null && strlen($event->key) === 1) {
+            $menuItem = $this->menuBar->getItemByHotkey($event->key);
+            if ($menuItem !== null) {
+                $state->setActiveMenu($menuItem);
+                $state->setStatus("Menü geöffnet: {$menuItem}");
+                return true;
+            }
+        }
+
+        // Convert to legacy key string format for compatibility
+        $keyString = $this->keyEventToString($event);
+        if ($keyString === '') {
+            return false;
+        }
+
+        // Handle global shortcuts first
+        $wasGlobalAction = $this->handleGlobalShortcuts($keyString, $event, $state);
+        if ($wasGlobalAction) {
+            return true;
+        }
+
+        // Handle dropdown navigation if dropdown is open
+        if ($state->getActiveDropdownMenu() !== null) {
+            $handled = $this->handleDropdownInput($keyString, $state);
+            if ($handled) {
+                return true;
+            }
+        }
+
+        // Close active menu when any non-menu action is performed
+        if ($state->getActiveMenu() !== null && $state->getActiveDropdownMenu() === null) {
+            $state->setActiveMenu(null);
+        }
+
+        // View-specific handling
+        return match ($state->getCurrentView()) {
+            TuiView::CATEGORIES => $this->handleCategoriesInput($keyString, $state),
+            TuiView::COMMANDS => $this->handleCommandsInput($keyString, $state),
+            TuiView::SEARCH => $this->handleSearchInput($keyString, $state),
+            TuiView::HISTORY => $this->handleHistoryInput($keyString, $state, $history),
+            TuiView::FORM => $this->handleFormInput($keyString, $state),
+            TuiView::DASHBOARD => $this->handleDashboardInput($keyString, $state),
+            TuiView::HELP => $this->handleHelpInput($keyString, $state),
+        };
+    }
+
+    /**
+     * Handle global shortcuts available in all views
+     */
+    private function handleGlobalShortcuts(string $key, KeyEvent $event, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ESCAPE->value:
+                // If dropdown is open, close it instead of quitting
+                if ($state->getActiveDropdownMenu() !== null) {
+                    $state->setActiveDropdownMenu(null);
+                    $state->setActiveMenu(null);
+                    return true;
+                }
+                // Otherwise quit
+                $state->setRunning(false);
+                return true;
+
+            case 'q':
+            case 'Q':
+                $state->setRunning(false);
+                return true;
+
+            case 'd':
+            case 'D':
+                $state->setCurrentView(TuiView::DASHBOARD);
+                return true;
+
+            case 'h':
+            case 'H':
+                $state->setCurrentView(TuiView::HELP);
+                return true;
+
+            case '/':
+            case 's':
+            case 'S':
+                $state->setCurrentView(TuiView::SEARCH);
+                $state->resetSearchState();
+                return true;
+
+            case 'r':
+            case 'R':
+                $state->setCurrentView(TuiView::HISTORY);
+                $state->setSelectedHistoryItem(0);
+                return true;
+
+            case TuiKeyCode::F1->value:
+                $this->commandExecutor->showAllCommandsHelp();
+                return true;
+
+            case 'c':
+            case 'C':
+                if ($state->getCurrentView() !== TuiView::CATEGORIES) {
+                    $state->setCurrentView(TuiView::CATEGORIES);
+                    return true;
+                }
+                break;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in categories view
+     */
+    private function handleCategoriesInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ARROW_UP->value:
+                $state->navigateUp();
+                return true;
+
+            case TuiKeyCode::ARROW_DOWN->value:
+                $state->navigateDown();
+                return true;
+
+            case TuiKeyCode::ENTER->value:
+                $state->setCurrentView(TuiView::COMMANDS);
+                $state->setSelectedCommand(0);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in commands view
+     */
+    private function handleCommandsInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ARROW_UP->value:
+                $state->navigateUp();
+                return true;
+
+            case TuiKeyCode::ARROW_DOWN->value:
+                $state->navigateDown();
+                return true;
+
+            case TuiKeyCode::ENTER->value:
+                $command = $state->getCurrentCommand();
+                if ($command) {
+                    $this->commandExecutor->executeSelectedCommand($command);
+                }
+                return true;
+
+            case TuiKeyCode::SPACE->value:
+                $command = $state->getCurrentCommand();
+                if ($command) {
+                    $state->setSelectedCommandForForm($command);
+                    $state->setCurrentView(TuiView::FORM);
+                }
+                return true;
+
+            case 'v':
+            case 'V':
+                $command = $state->getCurrentCommand();
+                if ($command) {
+                    $this->commandExecutor->validateSelectedCommand($command);
+                }
+                return true;
+
+            case 'h':
+            case 'H':
+                $command = $state->getCurrentCommand();
+                if ($command) {
+                    $this->commandExecutor->showSelectedCommandHelp($command);
+                }
+                return true;
+
+            case TuiKeyCode::ARROW_LEFT->value:
+            case TuiKeyCode::BACKSPACE->value:
+                $state->setCurrentView(TuiView::CATEGORIES);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in search view
+     */
+    private function handleSearchInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ESCAPE->value:
+                $state->setCurrentView(TuiView::CATEGORIES);
+                $state->resetSearchState();
+                return true;
+
+            case TuiKeyCode::ENTER->value:
+                $command = $state->getCurrentSearchResult();
+                if ($command) {
+                    $this->executeCommand($command);
+                }
+                return true;
+
+            case TuiKeyCode::SPACE->value:
+                $command = $state->getCurrentSearchResult();
+                if ($command) {
+                    $state->setSelectedCommandForForm($command);
+                    $state->setCurrentView(TuiView::FORM);
+                }
+                return true;
+
+            case TuiKeyCode::ARROW_UP->value:
+                $state->navigateUp();
+                return true;
+
+            case TuiKeyCode::ARROW_DOWN->value:
+                $state->navigateDown();
+                return true;
+
+            case TuiKeyCode::BACKSPACE->value:
+            case "\x7f": // DEL key
+                $query = $state->getSearchQuery();
+                if (strlen($query) > 0) {
+                    $newQuery = substr($query, 0, -1);
+                    $state->setSearchQuery($newQuery);
+                    $this->updateSearchResults($state);
+                }
+                return true;
+
+            default:
+                // Add character to search query
+                if (strlen($key) === 1 && ctype_print($key)) {
+                    $newQuery = $state->getSearchQuery() . $key;
+                    $state->setSearchQuery($newQuery);
+                    $this->updateSearchResults($state);
+                }
+                return true;
+        }
+    }
+
+    /**
+     * Handle input in history view
+     */
+    private function handleHistoryInput(string $key, TuiState $state, CommandHistory $history): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ARROW_UP->value:
+                $items = $this->getHistoryItems($state, $history);
+                $state->navigateHistoryItemUpWithCount(count($items));
+                return true;
+
+            case TuiKeyCode::ARROW_DOWN->value:
+                $items = $this->getHistoryItems($state, $history);
+                $state->navigateHistoryItemDownWithCount(count($items));
+                return true;
+
+            case TuiKeyCode::ARROW_LEFT->value:
+                $this->switchHistoryTab($state, -1);
+                return true;
+
+            case TuiKeyCode::ARROW_RIGHT->value:
+                $this->switchHistoryTab($state, 1);
+                return true;
+
+            case TuiKeyCode::ENTER->value:
+                $items = $this->getHistoryItems($state, $history);
+                if (!empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
+                    $command = $items[$state->getSelectedHistoryItem()]['command'];
+                    $history->addToHistory($command);
+                    $this->commandExecutor->executeCommand($command);
+                }
+                return true;
+
+            case TuiKeyCode::ESCAPE->value:
+            case TuiKeyCode::BACKSPACE->value:
+                $state->setCurrentView(TuiView::CATEGORIES);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in form view
+     */
+    private function handleFormInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ESCAPE->value:
+                $state->resetFormState();
+                $state->setCurrentView(TuiView::CATEGORIES);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in dashboard view
+     */
+    private function handleDashboardInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ESCAPE->value:
+                $state->setCurrentView(TuiView::CATEGORIES);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle input in help view
+     */
+    private function handleHelpInput(string $key, TuiState $state): bool
+    {
+        switch ($key) {
+            case TuiKeyCode::ESCAPE->value:
+                $state->setCurrentView(TuiView::CATEGORIES);
+                return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle dropdown menu input
+     */
+    private function handleDropdownInput(string $key, TuiState $state): bool
+    {
+        // Simplified - actual implementation would handle dropdown navigation
+        return false;
+    }
+
+    /**
+     * Convert KeyEvent to legacy key string format
+     */
+    private function keyEventToString(KeyEvent $event): string
+    {
+        if ($event->code !== '') {
+            return $event->code;
+        }
+
+        return match ($event->key) {
+            'ArrowUp' => TuiKeyCode::ARROW_UP->value,
+            'ArrowDown' => TuiKeyCode::ARROW_DOWN->value,
+            'ArrowRight' => TuiKeyCode::ARROW_RIGHT->value,
+            'ArrowLeft' => TuiKeyCode::ARROW_LEFT->value,
+            'Enter' => TuiKeyCode::ENTER->value,
+            'Escape' => TuiKeyCode::ESCAPE->value,
+            'Tab' => TuiKeyCode::TAB->value,
+            default => $event->key,
+        };
+    }
+
+    /**
+     * Execute command (handles DiscoveredAttribute objects)
+     */
+    private function executeCommand(mixed $command): void
+    {
+        if ($command instanceof DiscoveredAttribute) {
+            $attribute = $command->createAttributeInstance();
+            if ($attribute !== null) {
+                $this->commandExecutor->executeCommand($attribute->name);
+            }
+        } else {
+            $this->commandExecutor->executeCommand($command->name);
+        }
+    }
+
+    /**
+     * Update search results
+     */
+    private function updateSearchResults(TuiState $state): void
+    {
+        $query = strtolower($state->getSearchQuery());
+
+        if (empty($query)) {
+            $state->setSearchResults([]);
+            return;
+        }
+
+        $results = [];
+        $categories = $state->getCategories();
+
+        foreach ($categories as $category) {
+            foreach ($category['commands'] as $command) {
+                if ($command instanceof DiscoveredAttribute) {
+                    $attribute = $command->createAttributeInstance();
+                    if ($attribute === null) {
+                        continue;
+                    }
+                    $commandName = strtolower($attribute->name);
+                    $commandDescription = strtolower($attribute->description ?? '');
+                } else {
+                    $commandName = strtolower($command->name ?? '');
+                    $commandDescription = strtolower($command->description ?? '');
+                }
+
+                if (str_contains($commandName, $query) || str_contains($commandDescription, $query)) {
+                    $results[] = $command;
+                }
+            }
+        }
+
+        $state->setSearchResults($results);
+        $state->setSelectedSearchResult(0);
+    }
+
+    /**
+     * Get history items based on current tab
+     */
+    private function getHistoryItems(TuiState $state, CommandHistory $history): array
+    {
+        return match ($state->getHistoryTab()) {
+            HistoryTab::RECENT => $history->getRecentHistory(10),
+            HistoryTab::FREQUENT => $history->getFrequentCommands(10),
+            HistoryTab::FAVORITES => $history->getFavorites(),
+        };
+    }
+
+    /**
+     * Switch history tab
+     */
+    private function switchHistoryTab(TuiState $state, int $direction): void
+    {
+        $tabs = [HistoryTab::RECENT, HistoryTab::FREQUENT, HistoryTab::FAVORITES];
+        $currentIndex = array_search($state->getHistoryTab(), $tabs, true);
+        
+        if ($currentIndex === false) {
+            return;
+        }
+
+        $newIndex = $currentIndex + $direction;
+        if ($newIndex < 0) {
+            $newIndex = count($tabs) - 1;
+        } elseif ($newIndex >= count($tabs)) {
+            $newIndex = 0;
+        }
+
+        $state->setHistoryTab($tabs[$newIndex]);
+        $state->setSelectedHistoryItem(0);
+    }
+}
+
diff --git a/src/Framework/Console/Components/Handlers/MouseEventHandler.php b/src/Framework/Console/Components/Handlers/MouseEventHandler.php
new file mode 100644
index 00000000..5cc42c71
--- /dev/null
+++ b/src/Framework/Console/Components/Handlers/MouseEventHandler.php
@@ -0,0 +1,436 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\Handlers;
+
+use App\Framework\Console\CommandHistory;
+use App\Framework\Console\Components\MenuBar;
+use App\Framework\Console\Components\MouseEvent;
+use App\Framework\Console\Components\TuiCommandExecutor;
+use App\Framework\Console\Components\TuiState;
+use App\Framework\Console\TuiView;
+use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
+
+/**
+ * Isolated mouse event handler.
+ * Handles all mouse interactions (clicks, scroll, hover) with throttling.
+ */
+final class MouseEventHandler
+{
+    private const float HOVER_UPDATE_INTERVAL = 0.05; // 50ms = 20 updates per second max
+
+    private float $lastHoverUpdate;
+    
+    public function __construct(
+        private ?MenuBar $menuBar = null,
+        private ?TuiCommandExecutor $commandExecutor = null
+    ) {
+        $this->lastHoverUpdate = 0.0;
+    }
+
+    /**
+     * Handle mouse event
+     * Returns true if re-render is needed
+     */
+    public function handle(MouseEvent $event, TuiState $state, CommandHistory $history): bool
+    {
+        // Ignore mouse move events if hover throttling is active
+        if ($event->isMouseMove()) {
+            return $this->handleMouseMove($event, $state);
+        }
+
+        // Handle scroll events
+        if ($event->isScrollEvent()) {
+            return $this->handleScroll($event, $state);
+        }
+
+        // Handle click events
+        if ($event->pressed) {
+            return $this->handleClick($event, $state, $history);
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle mouse move (hover) with throttling
+     */
+    private function handleMouseMove(MouseEvent $event, TuiState $state): bool
+    {
+        $currentTime = microtime(true);
+        $timeSinceLastUpdate = $currentTime - $this->lastHoverUpdate;
+
+        // Throttle hover updates
+        if ($timeSinceLastUpdate < self::HOVER_UPDATE_INTERVAL) {
+            return false;
+        }
+
+        $this->lastHoverUpdate = $currentTime;
+
+        // Update hover state based on coordinates
+        $this->updateHoverState($event, $state);
+
+        return true;
+    }
+
+    /**
+     * Handle scroll events
+     */
+    private function handleScroll(MouseEvent $event, TuiState $state): bool
+    {
+        $view = $state->getCurrentView();
+
+        if ($event->button === 64) {
+            // Scroll up
+            match ($view) {
+                TuiView::CATEGORIES, TuiView::COMMANDS, TuiView::SEARCH, TuiView::HISTORY => $state->navigateUp(),
+                default => null,
+            };
+            return true;
+        } elseif ($event->button === 65) {
+            // Scroll down
+            match ($view) {
+                TuiView::CATEGORIES, TuiView::COMMANDS, TuiView::SEARCH, TuiView::HISTORY => $state->navigateDown(),
+                default => null,
+            };
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle click events
+     */
+    private function handleClick(MouseEvent $event, TuiState $state, CommandHistory $history): bool
+    {
+        // Handle dropdown clicks first (if dropdown is open)
+        if ($state->getActiveDropdownMenu() !== null) {
+            $dropdownItemIndex = $this->handleDropdownClick($event, $state);
+            if ($dropdownItemIndex !== null) {
+                return true;
+            }
+        }
+
+        // Handle menu bar clicks
+        if ($this->menuBar !== null && $this->menuBar->isClickInMenuArea($event->x, $event->y)) {
+            $menuItem = $this->menuBar->getItemAtPosition($event->x);
+            if ($menuItem !== null && $event->button === 0) {
+                // Left click on menu item - open dropdown if it has submenus
+                if ($this->menuBar->hasSubmenu($menuItem)) {
+                    $state->setActiveMenu($menuItem);
+                    $state->setActiveDropdownMenu($menuItem);
+                    $state->setSelectedDropdownItem(0);
+                    $state->setStatus("Menü geöffnet: {$menuItem}");
+                } else {
+                    // No submenu, just set active menu
+                    $state->setActiveMenu($menuItem);
+                    $state->setActiveDropdownMenu(null);
+                    $state->setStatus("Menü: {$menuItem}");
+                }
+            }
+
+            return true;
+        }
+
+        // If dropdown is open and click is outside, close dropdown
+        if ($state->getActiveDropdownMenu() !== null && $event->button === 0) {
+            $state->setActiveDropdownMenu(null);
+            $state->setActiveMenu(null);
+            return true;
+        }
+
+        $view = $state->getCurrentView();
+
+        // Handle item clicks (left and right button)
+        if ($event->button === 0) {
+            // Left click - primary action
+            return $this->handleItemClick($event, $state, $history, false);
+        } elseif ($event->button === 2) {
+            // Right click - secondary action
+            return $this->handleItemClick($event, $state, $history, true);
+        }
+
+        return false;
+    }
+
+    /**
+     * Handle dropdown menu click
+     */
+    private function handleDropdownClick(MouseEvent $event, TuiState $state): ?int
+    {
+        if ($this->menuBar === null) {
+            return null;
+        }
+
+        $activeMenu = $state->getActiveDropdownMenu();
+        if ($activeMenu === null) {
+            return null;
+        }
+
+        $submenuItems = $this->menuBar->getSubmenu($activeMenu);
+        if (empty($submenuItems)) {
+            return null;
+        }
+
+        // Calculate which dropdown item was clicked
+        // Dropdown starts at line 4, menu bar is at line 2-3
+        $clickedIndex = $event->y - 4;
+
+        if ($clickedIndex >= 0 && $clickedIndex < count($submenuItems)) {
+            if ($event->button === 0) {
+                // Left click - select item
+                $state->setSelectedDropdownItem($clickedIndex);
+                $item = $submenuItems[$clickedIndex];
+                
+                if ($item !== '---') {
+                    // Execute dropdown item action
+                    $this->executeDropdownItem($activeMenu, $item, $state);
+                    $state->setActiveDropdownMenu(null);
+                    $state->setActiveMenu(null);
+                }
+            }
+
+            return $clickedIndex;
+        }
+
+        return null;
+    }
+
+    /**
+     * Execute a dropdown menu item action
+     */
+    private function executeDropdownItem(string $menu, string $item, TuiState $state): void
+    {
+        $state->setStatus("Ausgeführt: {$menu} > {$item}");
+        // TODO: Implement actual actions for dropdown items
+    }
+
+    /**
+     * Handle item clicks (left and right button)
+     */
+    private function handleItemClick(MouseEvent $event, TuiState $state, CommandHistory $history, bool $isRightClick): bool
+    {
+        $view = $state->getCurrentView();
+
+        // Calculate clicked index based on y coordinate
+        $clickedIndex = $event->y - 4;
+
+        return match ($view) {
+            TuiView::CATEGORIES => $this->handleCategoryClick($clickedIndex, $state, $isRightClick),
+            TuiView::COMMANDS => $this->handleCommandClick($clickedIndex, $state, $isRightClick),
+            TuiView::SEARCH => $this->handleSearchResultClick($clickedIndex, $state, $isRightClick),
+            TuiView::HISTORY => $this->handleHistoryItemClick($clickedIndex, $state, $history, $isRightClick),
+            default => false,
+        };
+    }
+
+    /**
+     * Handle category click
+     */
+    private function handleCategoryClick(int $index, TuiState $state, bool $isRightClick): bool
+    {
+        $categories = $state->getCategories();
+        
+        if ($index < 0 || $index >= count($categories)) {
+            return false;
+        }
+
+        $state->setSelectedCategory($index);
+        
+        if ($isRightClick) {
+            // Right click - no action for categories
+            return false;
+        }
+        
+        // Left click - select category
+        $state->setCurrentView(TuiView::COMMANDS);
+        $state->setSelectedCommand(0);
+        return true;
+    }
+
+    /**
+     * Handle command click
+     */
+    private function handleCommandClick(int $index, TuiState $state, bool $isRightClick): bool
+    {
+        $category = $state->getCurrentCategory();
+        if (!$category) {
+            return false;
+        }
+
+        $commands = $category['commands'] ?? [];
+        
+        if ($index < 0 || $index >= count($commands)) {
+            return false;
+        }
+
+        $state->setSelectedCommand($index);
+        $command = $commands[$index];
+        
+        if ($isRightClick) {
+            // Right click - open parameter form
+            if ($command) {
+                $state->setSelectedCommandForForm($command);
+                $state->setCurrentView(TuiView::FORM);
+            }
+            return true;
+        }
+        
+        // Left click - execute command
+        if ($command && $this->commandExecutor !== null) {
+            $this->commandExecutor->executeSelectedCommand($command);
+        }
+        return true;
+    }
+
+    /**
+     * Handle search result click
+     */
+    private function handleSearchResultClick(int $index, TuiState $state, bool $isRightClick): bool
+    {
+        $results = $state->getSearchResults();
+        
+        if ($index < 0 || $index >= count($results)) {
+            return false;
+        }
+
+        $state->setSelectedSearchResult($index);
+        $command = $results[$index];
+        
+        if ($isRightClick) {
+            // Right click - open parameter form
+            if ($command) {
+                $state->setSelectedCommandForForm($command);
+                $state->setCurrentView(TuiView::FORM);
+            }
+            return true;
+        }
+        
+        // Left click - execute command
+        if ($command && $this->commandExecutor !== null) {
+            if ($command instanceof DiscoveredAttribute) {
+                $attribute = $command->createAttributeInstance();
+                if ($attribute !== null) {
+                    $this->commandExecutor->executeCommand($attribute->name);
+                }
+            } else {
+                $this->commandExecutor->executeCommand($command->name);
+            }
+        }
+        return true;
+    }
+
+    /**
+     * Handle history item click
+     */
+    private function handleHistoryItemClick(int $index, TuiState $state, CommandHistory $history, bool $isRightClick): bool
+    {
+        $items = $this->getHistoryItems($state, $history);
+        
+        if ($index < 0 || $index >= count($items)) {
+            return false;
+        }
+
+        $state->setSelectedHistoryItem($index);
+        
+        if ($isRightClick) {
+            // Right click - toggle favorite
+            if (isset($items[$index])) {
+                $command = $items[$index]['command'];
+                $isFavorite = $history->toggleFavorite($command);
+                $status = $isFavorite ? 'Zu Favoriten hinzugefügt' : 'Aus Favoriten entfernt';
+                $state->setStatus("{$command}: {$status}");
+            }
+            return true;
+        }
+        
+        // Left click - execute command
+        if (isset($items[$index])) {
+            $command = $items[$index]['command'];
+            $history->addToHistory($command);
+            if ($this->commandExecutor !== null) {
+                $this->commandExecutor->executeCommand($command);
+            }
+        }
+        return true;
+    }
+
+    /**
+     * Get history items based on current tab
+     */
+    private function getHistoryItems(TuiState $state, CommandHistory $history): array
+    {
+        return match ($state->getHistoryTab()) {
+            \App\Framework\Console\HistoryTab::RECENT => $history->getRecentHistory(10),
+            \App\Framework\Console\HistoryTab::FREQUENT => $history->getFrequentCommands(10),
+            \App\Framework\Console\HistoryTab::FAVORITES => $history->getFavorites(),
+        };
+    }
+
+
+    /**
+     * Update hover state based on mouse coordinates
+     */
+    private function updateHoverState(MouseEvent $event, TuiState $state): void
+    {
+        $view = $state->getCurrentView();
+
+        // Update hover state based on coordinates
+        // This is simplified - actual implementation would need to map coordinates to UI elements
+        match ($view) {
+            TuiView::CATEGORIES => $this->updateCategoryHover($event, $state),
+            TuiView::COMMANDS => $this->updateCommandHover($event, $state),
+            TuiView::SEARCH => $this->updateSearchHover($event, $state),
+            TuiView::HISTORY => $this->updateHistoryHover($event, $state),
+            default => null,
+        };
+    }
+
+    /**
+     * Update category hover state
+     */
+    private function updateCategoryHover(MouseEvent $event, TuiState $state): void
+    {
+        $hoveredIndex = $event->y - 4;
+        if ($hoveredIndex >= 0 && $hoveredIndex < count($state->getCategories())) {
+            $state->setHoveredContentItem('category', $hoveredIndex);
+        }
+    }
+
+    /**
+     * Update command hover state
+     */
+    private function updateCommandHover(MouseEvent $event, TuiState $state): void
+    {
+        $hoveredIndex = $event->y - 4;
+        $category = $state->getCurrentCategory();
+        if ($category && $hoveredIndex >= 0 && $hoveredIndex < count($category['commands'])) {
+            $state->setHoveredContentItem('command', $hoveredIndex);
+        }
+    }
+
+    /**
+     * Update search hover state
+     */
+    private function updateSearchHover(MouseEvent $event, TuiState $state): void
+    {
+        $hoveredIndex = $event->y - 4;
+        $results = $state->getSearchResults();
+        if ($hoveredIndex >= 0 && $hoveredIndex < count($results)) {
+            $state->setHoveredContentItem('search', $hoveredIndex);
+        }
+    }
+
+    /**
+     * Update history hover state
+     */
+    private function updateHistoryHover(MouseEvent $event, TuiState $state): void
+    {
+        $hoveredIndex = $event->y - 4;
+        // Similar to other views
+        $state->setHoveredContentItem('history', $hoveredIndex);
+    }
+}
+
diff --git a/src/Framework/Console/Components/InputParser.php b/src/Framework/Console/Components/InputParser.php
index 5fdcc65e..190e314b 100644
--- a/src/Framework/Console/Components/InputParser.php
+++ b/src/Framework/Console/Components/InputParser.php
@@ -4,11 +4,26 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Components;
 
+use App\Framework\Console\Components\Parsers\KeyboardEventParser;
+use App\Framework\Console\Components\Parsers\MouseEventParser;
+
 /**
- * Parses ANSI escape sequences for mouse and keyboard events
+ * Refactored input parser - delegates to specialized parsers.
+ * Uses EventBuffer for better event handling and partial sequence management.
  */
 final class InputParser
 {
+    private MouseEventParser $mouseParser;
+    private KeyboardEventParser $keyboardParser;
+    private EventBuffer $eventBuffer;
+
+    public function __construct(?EventBuffer $eventBuffer = null)
+    {
+        $this->eventBuffer = $eventBuffer ?? new EventBuffer();
+        $this->mouseParser = new MouseEventParser($this->eventBuffer);
+        $this->keyboardParser = new KeyboardEventParser($this->eventBuffer);
+    }
+
     /**
      * Read and parse input from STDIN using stream_select()
      *
@@ -16,6 +31,12 @@ final class InputParser
      */
     public function readEvent(): MouseEvent|KeyEvent|null
     {
+        // Check for partial sequence first
+        if ($this->eventBuffer->hasPartialSequence()) {
+            $partial = $this->eventBuffer->getPartialSequence();
+            return $this->continueParsing($partial);
+        }
+
         // Use stream_select for non-blocking I/O
         $read = [STDIN];
         $write = null;
@@ -42,15 +63,8 @@ final class InputParser
                 return $this->parseEscapeSequence($firstChar);
             }
 
-            // Check for Ctrl+C (ASCII 3)
-            if ($firstChar === "\003") {
-                stream_set_blocking(STDIN, $originalBlocking);
-                return new KeyEvent(key: 'C', ctrl: true);
-            }
-
             // Regular character
-            stream_set_blocking(STDIN, $originalBlocking);
-            return new KeyEvent(key: $firstChar);
+            return $this->keyboardParser->parseRegularChar($firstChar);
         } finally {
             stream_set_blocking(STDIN, $originalBlocking);
         }
@@ -66,7 +80,7 @@ final class InputParser
         // Read next character with timeout
         $next = $this->readCharWithTimeout();
         if ($next === null) {
-            return new KeyEvent(key: "\033");
+            return new KeyEvent(key: "\033", code: "\033");
         }
 
         $sequence .= $next;
@@ -75,158 +89,30 @@ final class InputParser
         if ($next === '[') {
             $third = $this->readCharWithTimeout();
             if ($third === '<') {
-                return $this->parseMouseEvent($sequence . $third);
+                return $this->mouseParser->parse($sequence . $third);
             }
 
-            // Keyboard escape sequence like \e[A (arrow up)
+            // Keyboard escape sequence
             if ($third !== null) {
                 $sequence .= $third;
-                return $this->parseKeyboardSequence($sequence);
+                return $this->keyboardParser->parse($sequence);
             }
         }
 
         // Just escape key
-        return new KeyEvent(key: "\033");
+        return new KeyEvent(key: "\033", code: "\033");
     }
 
     /**
-     * Parse SGR mouse event: \e[<b;x;yM (press) or \e[<b;x;ym (release)
+     * Continue parsing a partial sequence
      */
-    private function parseMouseEvent(string $prefix): MouseEvent|null
+    private function continueParsing(string $partial): MouseEvent|KeyEvent|null
     {
-        $buffer = '';
-        $timeout = 10000; // 10ms
-        $startTime = microtime(true) * 1000;
-
-        // Read until we get 'M' or 'm'
-        while (true) {
-            $char = fgetc(STDIN);
-            if ($char === false) {
-                // Check timeout
-                $elapsed = (microtime(true) * 1000) - $startTime;
-                if ($elapsed > $timeout) {
-                    return null;
-                }
-                usleep(1000);
-                continue;
-            }
-
-            $buffer .= $char;
-
-            // Mouse event ends with 'M' (press) or 'm' (release)
-            if ($char === 'M' || $char === 'm') {
-                break;
-            }
-
-            // Safety: limit buffer size
-            if (strlen($buffer) > 20) {
-                return null;
-            }
+        if ($this->mouseParser->isMouseEventPrefix($partial)) {
+            return $this->mouseParser->parse($partial);
         }
 
-        // Parse format: b;x;y where b is button code, x and y are coordinates
-        // Remove the final M/m
-        $data = substr($buffer, 0, -1);
-        $parts = explode(';', $data);
-
-        if (count($parts) < 3) {
-            // Invalid mouse event format, discard
-            return null;
-        }
-
-        $buttonCode = (int) $parts[0];
-        $x = (int) $parts[1];
-        $y = (int) $parts[2];
-        
-        // Validate coordinates (basic sanity check to catch corrupted events)
-        if ($x < 1 || $y < 1 || $x > 1000 || $y > 1000) {
-            // Invalid coordinates, likely corrupted event - discard silently
-            return null;
-        }
-
-        // Decode button and modifiers
-        // Bit flags in button code:
-        // Bit 0-1: Button (0=left, 1=middle, 2=right, 3=release)
-        // Bit 2: Shift
-        // Bit 3: Meta/Alt
-        // Bit 4: Ctrl
-        // Bit 5: Mouse move (32 = 0x20)
-        // Bit 6-7: Scroll (64=scroll up, 65=scroll down)
-
-        $button = $buttonCode & 0x03;
-        $shift = ($buttonCode & 0x04) !== 0;
-        $alt = ($buttonCode & 0x08) !== 0;
-        $ctrl = ($buttonCode & 0x10) !== 0;
-
-        // Handle scroll events (button codes 64 and 65)
-        if ($buttonCode >= 64 && $buttonCode <= 65) {
-            $button = $buttonCode;
-        } elseif (($buttonCode & 0x20) !== 0) {
-            // Mouse move (button code 32 or bit 5 set)
-            // Store full button code to detect mouse move
-            $button = $buttonCode;
-        }
-
-        $pressed = $buffer[-1] === 'M';
-
-        return new MouseEvent(
-            x: $x,
-            y: $y,
-            button: $button,
-            pressed: $pressed,
-            shift: $shift,
-            ctrl: $ctrl,
-            alt: $alt
-        );
-    }
-
-    /**
-     * Parse keyboard escape sequence (arrow keys, function keys, etc.)
-     */
-    private function parseKeyboardSequence(string $sequence): KeyEvent
-    {
-        // Map common escape sequences
-        $keyMap = [
-            "\033[A" => 'ArrowUp',
-            "\033[B" => 'ArrowDown',
-            "\033[C" => 'ArrowRight',
-            "\033[D" => 'ArrowLeft',
-            "\033[H" => 'Home',
-            "\033[F" => 'End',
-            "\033[5~" => 'PageUp',
-            "\033[6~" => 'PageDown',
-            "\033[3~" => 'Delete',
-            "\n" => 'Enter',
-            "\r" => 'Enter',
-            "\033" => 'Escape',
-            "\t" => 'Tab',
-        ];
-
-        // Check if we need to read more characters
-        if (strlen($sequence) >= 3 && in_array($sequence[2], ['5', '6', '3'], true)) {
-            $fourth = $this->readCharWithTimeout();
-            if ($fourth !== null) {
-                $sequence .= $fourth;
-            }
-        }
-
-        // Check for Enter key
-        if ($sequence === "\n" || $sequence === "\r") {
-            return new KeyEvent(key: 'Enter', code: "\n");
-        }
-
-        // Check for Escape
-        if ($sequence === "\033") {
-            return new KeyEvent(key: 'Escape', code: "\033");
-        }
-
-        // Map to known key
-        if (isset($keyMap[$sequence])) {
-            return new KeyEvent(key: $keyMap[$sequence], code: $sequence);
-        }
-
-        // Unknown sequence, return as-is
-        return new KeyEvent(key: $sequence, code: $sequence);
+        return $this->keyboardParser->parse($partial);
     }
 
     /**
@@ -252,32 +138,10 @@ final class InputParser
     }
 
     /**
-     * Discard any remaining input characters from STDIN
+     * Get event buffer
      */
-    private function discardRemainingInput(): void
+    public function getEventBuffer(): EventBuffer
     {
-        // Read and discard up to 50 characters to clear partial escape sequences
-        $maxDiscard = 50;
-        $discarded = 0;
-        
-        while ($discarded < $maxDiscard) {
-            $read = [STDIN];
-            $write = null;
-            $except = null;
-            
-            $result = stream_select($read, $write, $except, 0, 1000); // 1ms
-            
-            if ($result === false || $result === 0) {
-                break; // No more input
-            }
-            
-            $char = fgetc(STDIN);
-            if ($char === false) {
-                break;
-            }
-            
-            $discarded++;
-        }
+        return $this->eventBuffer;
     }
 }
-
diff --git a/src/Framework/Console/Components/Parsers/KeyboardEventParser.php b/src/Framework/Console/Components/Parsers/KeyboardEventParser.php
new file mode 100644
index 00000000..f0253ab2
--- /dev/null
+++ b/src/Framework/Console/Components/Parsers/KeyboardEventParser.php
@@ -0,0 +1,222 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\Parsers;
+
+use App\Framework\Console\Components\EventBuffer;
+use App\Framework\Console\Components\KeyEvent;
+
+/**
+ * Isolated keyboard event parser with comprehensive sequence support.
+ * Handles all keyboard escape sequences and regular keys.
+ */
+final readonly class KeyboardEventParser
+{
+    private const int TIMEOUT_MS = 10;
+
+    /**
+     * Comprehensive key mapping for escape sequences
+     */
+    private const array KEY_MAP = [
+        // Arrow keys
+        "\033[A" => 'ArrowUp',
+        "\033[B" => 'ArrowDown',
+        "\033[C" => 'ArrowRight',
+        "\033[D" => 'ArrowLeft',
+        
+        // Navigation
+        "\033[H" => 'Home',
+        "\033[F" => 'End',
+        "\033[1~" => 'Home',
+        "\033[4~" => 'End',
+        
+        // Page navigation
+        "\033[5~" => 'PageUp',
+        "\033[6~" => 'PageDown',
+        
+        // Function keys
+        "\033OP" => 'F1',
+        "\033OQ" => 'F2',
+        "\033OR" => 'F3',
+        "\033OS" => 'F4',
+        "\033[15~" => 'F5',
+        "\033[17~" => 'F6',
+        "\033[18~" => 'F7',
+        "\033[19~" => 'F8',
+        "\033[20~" => 'F9',
+        "\033[21~" => 'F10',
+        "\033[23~" => 'F11',
+        "\033[24~" => 'F12',
+        
+        // Special keys
+        "\033[3~" => 'Delete',
+        "\033[2~" => 'Insert',
+        "\033[Z" => 'ShiftTab',
+        
+        // Control sequences
+        "\033[1;5A" => 'Ctrl+ArrowUp',
+        "\033[1;5B" => 'Ctrl+ArrowDown',
+        "\033[1;5C" => 'Ctrl+ArrowRight',
+        "\033[1;5D" => 'Ctrl+ArrowLeft',
+    ];
+
+    public function __construct(
+        private EventBuffer $eventBuffer
+    ) {
+    }
+
+    /**
+     * Parse keyboard event from escape sequence
+     */
+    public function parse(string $sequence): KeyEvent
+    {
+        // Check for Enter key
+        if ($sequence === "\n" || $sequence === "\r") {
+            return new KeyEvent(key: 'Enter', code: "\n");
+        }
+
+        // Check for Escape
+        if ($sequence === "\033") {
+            return new KeyEvent(key: 'Escape', code: "\033");
+        }
+
+        // Try to read more characters for multi-character sequences
+        $fullSequence = $this->readFullSequence($sequence);
+
+        // Check if we have a known mapping
+        if (isset(self::KEY_MAP[$fullSequence])) {
+            return new KeyEvent(key: self::KEY_MAP[$fullSequence], code: $fullSequence);
+        }
+
+        // Check for modifier sequences (Ctrl+Key, Alt+Key, etc.)
+        $modifierEvent = $this->parseModifierSequence($fullSequence);
+        if ($modifierEvent !== null) {
+            return $modifierEvent;
+        }
+
+        // Unknown sequence, return as-is
+        return new KeyEvent(key: $fullSequence, code: $fullSequence);
+    }
+
+    /**
+     * Read full escape sequence (handles multi-byte sequences)
+     */
+    private function readFullSequence(string $initialSequence): string
+    {
+        $sequence = $initialSequence;
+        $timeout = self::TIMEOUT_MS;
+        $startTime = microtime(true) * 1000;
+
+        // Read additional characters if needed
+        while (true) {
+            $char = fgetc(STDIN);
+            if ($char === false) {
+                $elapsed = (microtime(true) * 1000) - $startTime;
+                if ($elapsed > $timeout) {
+                    break;
+                }
+                usleep(1000); // 1ms
+                continue;
+            }
+
+            $sequence .= $char;
+
+            // Check if sequence is complete
+            if ($this->isSequenceComplete($sequence)) {
+                break;
+            }
+
+            // Safety limit
+            if (strlen($sequence) > 20) {
+                break;
+            }
+        }
+
+        return $sequence;
+    }
+
+    /**
+     * Check if escape sequence is complete
+     */
+    private function isSequenceComplete(string $sequence): bool
+    {
+        // Simple sequences end with a letter
+        if (strlen($sequence) >= 3 && preg_match('/^\033\[[A-Za-z]$/', $sequence)) {
+            return true;
+        }
+
+        // Function keys end with ~
+        if (preg_match('/^\033\[\d+~$/', $sequence)) {
+            return true;
+        }
+
+        // Modifier sequences end with letter after numbers
+        if (preg_match('/^\033\[\d+;\d+[A-Za-z]$/', $sequence)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Parse modifier sequences (Ctrl+, Alt+, etc.)
+     */
+    private function parseModifierSequence(string $sequence): ?KeyEvent
+    {
+        // Pattern: \e[number;number;key
+        if (!preg_match('/^\033\[(\d+);(\d+)([A-Za-z])$/', $sequence, $matches)) {
+            return null;
+        }
+
+        $modifierCode = (int) $matches[1];
+        $keyCode = (int) $matches[2];
+        $key = $matches[3];
+
+        $ctrl = false;
+        $shift = false;
+        $alt = false;
+        $meta = false;
+
+        // Decode modifiers (standard xterm codes)
+        if ($modifierCode === 5) {
+            $ctrl = true;
+        } elseif ($modifierCode === 3) {
+            $alt = true;
+        } elseif ($modifierCode === 2) {
+            $shift = true;
+        }
+
+        return new KeyEvent(
+            key: $key,
+            code: $sequence,
+            shift: $shift,
+            ctrl: $ctrl,
+            alt: $alt,
+            meta: $meta
+        );
+    }
+
+    /**
+     * Parse regular character (non-escape sequence)
+     */
+    public function parseRegularChar(string $char): KeyEvent
+    {
+        // Check for Ctrl+C (ASCII 3)
+        if ($char === "\003") {
+            return new KeyEvent(key: 'C', ctrl: true, code: "\003");
+        }
+
+        // Check for other control characters
+        $ord = ord($char);
+        if ($ord < 32 && $ord !== 9 && $ord !== 10 && $ord !== 13) {
+            // Control character
+            $ctrlKey = chr($ord + 64);
+            return new KeyEvent(key: $ctrlKey, ctrl: true, code: $char);
+        }
+
+        // Regular character
+        return new KeyEvent(key: $char, code: $char);
+    }
+}
+
diff --git a/src/Framework/Console/Components/Parsers/MouseEventParser.php b/src/Framework/Console/Components/Parsers/MouseEventParser.php
new file mode 100644
index 00000000..1cf332aa
--- /dev/null
+++ b/src/Framework/Console/Components/Parsers/MouseEventParser.php
@@ -0,0 +1,119 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Components\Parsers;
+
+use App\Framework\Console\Components\EventBuffer;
+use App\Framework\Console\Components\MouseEvent;
+
+/**
+ * Isolated mouse event parser.
+ * Handles SGR mouse events (\e[<b;x;yM or \e[<b;x;ym)
+ */
+final readonly class MouseEventParser
+{
+    private const int MAX_BUFFER_SIZE = 20;
+    private const int TIMEOUT_MS = 10;
+    private const int MAX_X = 1000;
+    private const int MAX_Y = 1000;
+
+    public function __construct(
+        private EventBuffer $eventBuffer
+    ) {
+    }
+
+    /**
+     * Parse mouse event from sequence prefix \e[<
+     */
+    public function parse(string $prefix): ?MouseEvent
+    {
+        $buffer = '';
+        $timeout = self::TIMEOUT_MS;
+        $startTime = microtime(true) * 1000;
+
+        // Read until we get 'M' or 'm'
+        while (true) {
+            $char = fgetc(STDIN);
+            if ($char === false) {
+                // Check timeout
+                $elapsed = (microtime(true) * 1000) - $startTime;
+                if ($elapsed > $timeout) {
+                    // Timeout - store partial sequence for retry
+                    if (strlen($prefix . $buffer) > 0) {
+                        $this->eventBuffer->storePartialSequence($prefix . $buffer);
+                    }
+                    return null;
+                }
+                usleep(1000); // 1ms
+                continue;
+            }
+
+            $buffer .= $char;
+
+            // Mouse event ends with 'M' (press) or 'm' (release)
+            if ($char === 'M' || $char === 'm') {
+                break;
+            }
+
+            // Safety: limit buffer size
+            if (strlen($buffer) > self::MAX_BUFFER_SIZE) {
+                return null;
+            }
+        }
+
+        // Parse format: b;x;y where b is button code, x and y are coordinates
+        $data = substr($buffer, 0, -1);
+        $parts = explode(';', $data);
+
+        if (count($parts) < 3) {
+            // Invalid mouse event format
+            return null;
+        }
+
+        $buttonCode = (int) $parts[0];
+        $x = (int) $parts[1];
+        $y = (int) $parts[2];
+        
+        // Validate coordinates
+        if ($x < 1 || $y < 1 || $x > self::MAX_X || $y > self::MAX_Y) {
+            // Invalid coordinates, likely corrupted
+            return null;
+        }
+
+        // Decode button and modifiers
+        $button = $buttonCode & 0x03;
+        $shift = ($buttonCode & 0x04) !== 0;
+        $alt = ($buttonCode & 0x08) !== 0;
+        $ctrl = ($buttonCode & 0x10) !== 0;
+
+        // Handle scroll events (button codes 64 and 65)
+        if ($buttonCode >= 64 && $buttonCode <= 65) {
+            $button = $buttonCode;
+        } elseif (($buttonCode & 0x20) !== 0) {
+            // Mouse move (button code 32 or bit 5 set)
+            $button = $buttonCode;
+        }
+
+        $pressed = $buffer[-1] === 'M';
+
+        return new MouseEvent(
+            x: $x,
+            y: $y,
+            button: $button,
+            pressed: $pressed,
+            shift: $shift,
+            ctrl: $ctrl,
+            alt: $alt
+        );
+    }
+
+    /**
+     * Check if sequence is a mouse event prefix
+     */
+    public function isMouseEventPrefix(string $sequence): bool
+    {
+        return str_starts_with($sequence, "\033[<");
+    }
+}
+
diff --git a/src/Framework/Console/Components/Table.php b/src/Framework/Console/Components/Table.php
index 66b130e7..84570001 100644
--- a/src/Framework/Console/Components/Table.php
+++ b/src/Framework/Console/Components/Table.php
@@ -4,210 +4,11 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Components;
 
-use App\Framework\Console\ConsoleColor;
-use App\Framework\Console\ConsoleFormat;
-use App\Framework\Console\ConsoleStyle;
-
 /**
- * Rendert eine Tabelle in der Konsole.
+ * @deprecated Use App\Framework\Display\Components\Console\Table instead
+ * This class is kept for backward compatibility only.
  */
-final class Table
-{
-    private array $headers = [];
-
-    private array $rows = [];
-
-    private array $columnWidths = [];
-
-    private int $padding = 1;
-
-    public function __construct(
-        private ?ConsoleStyle $headerStyle = null,
-        private ?ConsoleStyle $rowStyle = null,
-        private ?ConsoleStyle $borderStyle = null,
-        private readonly bool $showBorders = true
-    ) {
-        $this->headerStyle ??= ConsoleStyle::create(color: ConsoleColor::BRIGHT_WHITE, format: ConsoleFormat::BOLD);
-        $this->rowStyle ??= ConsoleStyle::create();
-        $this->borderStyle ??= ConsoleStyle::create(color: ConsoleColor::GRAY);
-    }
-
-    /**
-     * Setzt die Spaltenüberschriften der Tabelle.
-     */
-    public function setHeaders(array $headers): self
-    {
-        $this->headers = $headers;
-        $this->calculateColumnWidths();
-
-        return $this;
-    }
-
-    /**
-     * Fügt eine Zeile zur Tabelle hinzu.
-     */
-    public function addRow(array $row): self
-    {
-        $this->rows[] = $row;
-        $this->calculateColumnWidths();
-
-        return $this;
-    }
-
-    /**
-     * Setzt alle Zeilen der Tabelle.
-     */
-    public function setRows(array $rows): self
-    {
-        $this->rows = $rows;
-        $this->calculateColumnWidths();
-
-        return $this;
-    }
-
-    /**
-     * Setzt den Innenabstand der Zellen.
-     */
-    public function setPadding(int $padding): self
-    {
-        $this->padding = max(0, $padding);
-
-        return $this;
-    }
-
-    /**
-     * Rendert die Tabelle und gibt den Text zurück.
-     */
-    public function render(): string
-    {
-        if (empty($this->headers) && empty($this->rows)) {
-            return '';
-        }
-
-        $output = '';
-
-        if ($this->showBorders) {
-            $output .= $this->renderBorder('top') . "\n";
-        }
-
-        // Header
-        if (! empty($this->headers)) {
-            $output .= $this->renderRow($this->headers, $this->headerStyle) . "\n";
-
-            if ($this->showBorders) {
-                $output .= $this->renderBorder('middle') . "\n";
-            }
-        }
-
-        // Zeilen
-        foreach ($this->rows as $index => $row) {
-            $output .= $this->renderRow($row, $this->rowStyle) . "\n";
-        }
-
-        if ($this->showBorders) {
-            $output .= $this->renderBorder('bottom') . "\n";
-        }
-
-        return $output;
-    }
-
-    /**
-     * Rendert eine Zeile der Tabelle.
-     */
-    private function renderRow(array $cells, ConsoleStyle $style): string
-    {
-        $output = '';
-
-        if ($this->showBorders) {
-            $output .= $this->borderStyle->apply('│');
-        }
-
-        foreach ($cells as $index => $cell) {
-            $width = $this->columnWidths[$index] ?? 10;
-            $cellText = (string)$cell;
-
-            // Linksbündige Ausrichtung mit exakter Breite
-            $paddedCell = str_pad($cellText, $width, ' ', STR_PAD_RIGHT);
-
-            // Padding hinzufügen
-            $padding = str_repeat(' ', $this->padding);
-            $finalCell = $padding . $paddedCell . $padding;
-
-            $output .= $style->apply($finalCell);
-
-            if ($this->showBorders) {
-                $output .= $this->borderStyle->apply('│');
-            }
-        }
-
-        return $output;
-    }
-
-    /**
-     * Rendert eine Trennlinie der Tabelle.
-     */
-    private function renderBorder(string $type): string
-    {
-        $left = match($type) {
-            'top' => '┌',
-            'middle' => '├',
-            'row' => '├',
-            'bottom' => '└',
-            default => '│'
-        };
-
-        $right = match($type) {
-            'top' => '┐',
-            'middle' => '┤',
-            'row' => '┤',
-            'bottom' => '┘',
-            default => '│'
-        };
-
-        $horizontal = '─';
-
-        $junction = match($type) {
-            'top' => '┬',
-            'middle' => '┼',
-            'row' => '┼',
-            'bottom' => '┴',
-            default => '│'
-        };
-
-        $border = $left;
-
-        foreach ($this->columnWidths as $index => $width) {
-            $cellWidth = $width + ($this->padding * 2);
-            $border .= str_repeat($horizontal, $cellWidth);
-
-            if ($index < count($this->columnWidths) - 1) {
-                $border .= $junction;
-            }
-        }
-
-        $border .= $right;
-
-        return $this->borderStyle->apply($border);
-    }
-
-    /**
-     * Berechnet die Breite jeder Spalte basierend auf dem Inhalt.
-     */
-    private function calculateColumnWidths(): void
-    {
-        $this->columnWidths = [];
-
-        // Header-Breiten
-        foreach ($this->headers as $index => $header) {
-            $this->columnWidths[$index] = mb_strlen((string)$header);
-        }
-
-        // Zeilen-Breiten
-        foreach ($this->rows as $row) {
-            foreach ($row as $index => $cell) {
-                $length = mb_strlen((string)$cell);
-                $this->columnWidths[$index] = max($this->columnWidths[$index] ?? 0, $length);
-            }
-        }
-    }
-}
+class_alias(
+    \App\Framework\Display\Components\Console\Table::class,
+    __NAMESPACE__ . '\\' . 'Table'
+);
diff --git a/src/Framework/Console/Components/TextBox.php b/src/Framework/Console/Components/TextBox.php
index 7f441887..c818daed 100644
--- a/src/Framework/Console/Components/TextBox.php
+++ b/src/Framework/Console/Components/TextBox.php
@@ -4,122 +4,11 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Components;
 
-use App\Framework\Console\ConsoleColor;
-use App\Framework\Console\ConsoleStyle;
-
 /**
- * Rendert eine Textbox in der Konsole.
+ * @deprecated Use App\Framework\Display\Components\Console\TextBox instead
+ * This class is kept for backward compatibility only.
  */
-final readonly class TextBox
-{
-    public function __construct(
-        private string        $content,
-        private int           $width = 80,
-        private int           $padding = 1,
-        private ?ConsoleStyle $borderStyle = null,
-        private ?ConsoleStyle $contentStyle = null,
-        private ?string       $title = null
-    ) {
-    }
-
-    public function render(): string
-    {
-        $borderStyle = $this->borderStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
-        $contentStyle = $this->contentStyle ?? ConsoleStyle::create();
-
-        $contentWidth = $this->width - ($this->padding * 2) - 2;
-        $lines = $this->wrapText($this->content, $contentWidth);
-        $output = '';
-
-        // Obere Linie
-        if ($this->title) {
-            $titleLength = mb_strlen($this->title);
-            $availableSpace = $this->width - $titleLength - 6; // Abzug für '[ ]' und Ränder
-            $leftPadding = max(0, (int)floor($availableSpace / 2));
-            $rightPadding = max(0, $availableSpace - $leftPadding);
-
-            $output .= $borderStyle->apply('┌' . str_repeat('─', $leftPadding) . '[ ' . $this->title . ' ]' . str_repeat('─', $rightPadding) . '┐') . "\n";
-        } else {
-            $output .= $borderStyle->apply('┌' . str_repeat('─', $this->width - 2) . '┐') . "\n";
-        }
-
-        // Padding oben
-        for ($i = 0; $i < $this->padding; $i++) {
-            $output .= $borderStyle->apply('│') . str_repeat(' ', $this->width - 2) . $borderStyle->apply('│') . "\n";
-        }
-
-        // Inhalt
-        foreach ($lines as $line) {
-            $lineLength = mb_strlen($line);
-            $spaces = $contentWidth - $lineLength;
-            $paddedLine = $line . str_repeat(' ', $spaces);
-
-            $output .= $borderStyle->apply('│') .
-                      str_repeat(' ', $this->padding) .
-                      $contentStyle->apply($paddedLine) .
-                      str_repeat(' ', $this->padding) .
-                      $borderStyle->apply('│') . "\n";
-        }
-
-        // Padding unten
-        for ($i = 0; $i < $this->padding; $i++) {
-            $output .= $borderStyle->apply('│') . str_repeat(' ', $this->width - 2) . $borderStyle->apply('│') . "\n";
-        }
-
-        // Untere Linie
-        $output .= $borderStyle->apply('└' . str_repeat('─', $this->width - 2) . '┘') . "\n";
-
-        return $output;
-    }
-
-    private function wrapText(string $text, int $width): array
-    {
-        $lines = explode("\n", $text);
-        $wrapped = [];
-
-        foreach ($lines as $line) {
-            if (mb_strlen($line) <= $width) {
-                $wrapped[] = $line;
-            } else {
-                $wrapped = array_merge($wrapped, $this->splitTextIntoLines($line, $width));
-            }
-        }
-
-        // Leere Zeile hinzufügen, falls keine Inhalte vorhanden
-        if (empty($wrapped)) {
-            $wrapped[] = '';
-        }
-
-        return $wrapped;
-    }
-
-    private function splitTextIntoLines(string $text, int $width): array
-    {
-        $lines = [];
-        $words = explode(' ', $text);
-        $currentLine = '';
-
-        foreach ($words as $word) {
-            $testLine = empty($currentLine) ? $word : $currentLine . ' ' . $word;
-
-            if (mb_strlen($testLine) <= $width) {
-                $currentLine = $testLine;
-            } else {
-                if (! empty($currentLine)) {
-                    $lines[] = $currentLine;
-                    $currentLine = $word;
-                } else {
-                    // Wort ist länger als die Zeile - hart umbrechen
-                    $lines[] = mb_substr($word, 0, $width);
-                    $currentLine = mb_substr($word, $width);
-                }
-            }
-        }
-
-        if (! empty($currentLine)) {
-            $lines[] = $currentLine;
-        }
-
-        return $lines ?: [''];
-    }
-}
+class_alias(
+    \App\Framework\Display\Components\Console\TextBox::class,
+    __NAMESPACE__ . '\\' . 'TextBox'
+);
diff --git a/src/Framework/Console/Components/TreeHelper.php b/src/Framework/Console/Components/TreeHelper.php
index f85724c3..b13a7ba8 100644
--- a/src/Framework/Console/Components/TreeHelper.php
+++ b/src/Framework/Console/Components/TreeHelper.php
@@ -4,222 +4,11 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Components;
 
-use App\Framework\Console\ConsoleColor;
-use App\Framework\Console\ConsoleFormat;
-use App\Framework\Console\ConsoleOutput;
-use App\Framework\Console\ConsoleStyle;
-
 /**
- * TreeHelper zum Anzeigen hierarchischer Baumstrukturen in der Konsole.
- * Ähnlich dem Symfony TreeHelper, aber angepasst an unser Styling-System.
+ * @deprecated Use App\Framework\Display\Components\Console\TreeHelper instead
+ * This class is kept for backward compatibility only.
  */
-final class TreeHelper
-{
-    private string $prefix = '';
-
-    private bool $isLastElement = true;
-
-    private ?ConsoleStyle $nodeStyle = null;
-
-    private ?ConsoleStyle $leafStyle = null;
-
-    private ?ConsoleStyle $lineStyle = null;
-
-    /**
-     * @var array<array{title: string, node: ?self, isLeaf: bool}>
-     */
-    private array $nodes = [];
-
-    public function __construct(
-        private string                 $title = '',
-        #private readonly ConsoleOutput $output = new ConsoleOutput(),
-    ) {
-        $this->nodeStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_YELLOW, format: ConsoleFormat::BOLD);
-        $this->leafStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
-        $this->lineStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
-    }
-
-    /**
-     * Setzt den Stil für Knotentitel (Verzeichnisse/Kategorien).
-     */
-    public function setNodeStyle(?ConsoleStyle $style): self
-    {
-        $this->nodeStyle = $style;
-
-        return $this;
-    }
-
-    /**
-     * Setzt den Stil für Blätter/Endpunkte.
-     */
-    public function setLeafStyle(?ConsoleStyle $style): self
-    {
-        $this->leafStyle = $style;
-
-        return $this;
-    }
-
-    /**
-     * Setzt den Stil für Baumlinien.
-     */
-    public function setLineStyle(?ConsoleStyle $style): self
-    {
-        $this->lineStyle = $style;
-
-        return $this;
-    }
-
-    /**
-     * Setzt den Haupttitel des Baums.
-     */
-    public function setTitle(string $title): self
-    {
-        $this->title = $title;
-
-        return $this;
-    }
-
-    /**
-     * Fügt einen Unterknoten (z.B. Unterverzeichnis) hinzu.
-     */
-    public function addNode(string $title): self
-    {
-        $node = new self($title);
-        $node->nodeStyle = $this->nodeStyle;
-        $node->leafStyle = $this->leafStyle;
-        $node->lineStyle = $this->lineStyle;
-
-        $this->nodes[] = [
-            'title' => $title,
-            'node' => $node,
-            'isLeaf' => false,
-        ];
-
-        return $node;
-    }
-
-    /**
-     * Fügt einen Endpunkt (z.B. Datei) hinzu.
-     */
-    public function addLeaf(string $title): self
-    {
-        $this->nodes[] = [
-            'title' => $title,
-            'node' => null,
-            'isLeaf' => true,
-        ];
-
-        return $this;
-    }
-
-    /**
-     * Zeigt die vollständige Baumstruktur an.
-     */
-    public function display(ConsoleOutput $output): void
-    {
-        if (! empty($this->title)) {
-            $output->writeLine($this->title, $this->nodeStyle);
-        }
-
-        $this->displayTree($output);
-    }
-
-    /**
-     * Rendert die Baumstruktur und gibt den Text zurück.
-     */
-    public function render(): string
-    {
-        $output = '';
-
-        if (! empty($this->title)) {
-            $output .= $this->nodeStyle->apply($this->title) . "\n";
-        }
-
-        $output .= $this->renderTree();
-
-        return $output;
-    }
-
-    /**
-     * Setzt den Präfix für die aktuelle Ebene.
-     * (Interne Methode für rekursives Rendern)
-     */
-    private function setPrefix(string $prefix, bool $isLastElement): self
-    {
-        $this->prefix = $prefix;
-        $this->isLastElement = $isLastElement;
-
-        return $this;
-    }
-
-    /**
-     * Zeigt die Baumstruktur mit dem aktuellen Präfix an.
-     * (Interne Methode für rekursives Rendern)
-     */
-    private function displayTree(ConsoleOutput $output): void
-    {
-        $count = count($this->nodes);
-
-        foreach ($this->nodes as $index => $item) {
-            $isLast = ($index === $count - 1);
-            $nodePrefix = $this->prefix . ($this->isLastElement ? '    ' : '│   ');
-
-            // Baumlinien und Verbindungen
-            $connector = $isLast ? '└── ' : '├── ';
-            $linePrefix = $this->prefix . $connector;
-
-            // Titel anzeigen
-            $style = $item['isLeaf'] ? $this->leafStyle : $this->nodeStyle;
-            $title = $linePrefix . $item['title'];
-
-            $output->writeLine(
-                $this->lineStyle->apply($linePrefix) .
-                $style->apply($item['title'])
-            );
-
-            // Unterelemente rekursiv anzeigen
-            if (! $item['isLeaf'] && $item['node'] !== null) {
-                $item['node']
-                    ->setPrefix($nodePrefix, $isLast)
-                    ->displayTree($output);
-            }
-        }
-    }
-
-    /**
-     * Rendert die Baumstruktur mit dem aktuellen Präfix und gibt den Text zurück.
-     * (Interne Methode für rekursives Rendern)
-     */
-    private function renderTree(): string
-    {
-        $output = '';
-        $count = count($this->nodes);
-
-        foreach ($this->nodes as $index => $item) {
-            $isLast = ($index === $count - 1);
-            $nodePrefix = $this->prefix . ($this->isLastElement ? '    ' : '│   ');
-
-            // Baumlinien und Verbindungen
-            $connector = $isLast ? '└── ' : '├── ';
-            $linePrefix = $this->prefix . $connector;
-
-            // Titel formatieren
-            $style = $item['isLeaf'] ? $this->leafStyle : $this->nodeStyle;
-            $title = $item['title'];
-
-            $output .= $this->lineStyle->apply($linePrefix) .
-                      $style->apply($title) . "\n";
-
-            // Unterelemente rekursiv rendern
-            if (! $item['isLeaf'] && $item['node'] !== null) {
-                $childOutput = $item['node']
-                    ->setPrefix($nodePrefix, $isLast)
-                    ->renderTree();
-
-                $output .= $childOutput;
-            }
-        }
-
-        return $output;
-    }
-}
+class_alias(
+    \App\Framework\Display\Components\Console\TreeHelper::class,
+    __NAMESPACE__ . '\\' . 'TreeHelper'
+);
diff --git a/src/Framework/Console/Components/TuiInputHandler.php b/src/Framework/Console/Components/TuiInputHandler.php
index a870adf0..66fda26a 100644
--- a/src/Framework/Console/Components/TuiInputHandler.php
+++ b/src/Framework/Console/Components/TuiInputHandler.php
@@ -5,1321 +5,39 @@ declare(strict_types=1);
 namespace App\Framework\Console\Components;
 
 use App\Framework\Console\CommandHistory;
-use App\Framework\Console\HistoryTab;
-use App\Framework\Console\TuiKeyCode;
-use App\Framework\Console\TuiView;
-use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
+use App\Framework\Console\Components\Handlers\KeyboardEventHandler;
+use App\Framework\Console\Components\Handlers\MouseEventHandler;
 
 /**
- * Handles all keyboard input and navigation for the TUI
+ * Refactored input handler - delegates to specialized handlers.
+ * Maintains backward compatibility while using new architecture.
  */
-final class TuiInputHandler
+final readonly class TuiInputHandler
 {
-    /**
-     * Track last hover update time to throttle mouse move events
-     */
-    private float $lastHoverUpdate = 0.0;
-
-    /**
-     * Minimum time between hover updates (50ms = 20 updates per second max)
-     */
-    private const float HOVER_UPDATE_INTERVAL = 0.05;
+    private MouseEventHandler $mouseHandler;
+    private KeyboardEventHandler $keyboardHandler;
 
     public function __construct(
         private TuiCommandExecutor $commandExecutor,
         private ?MenuBar $menuBar = null
     ) {
+        $this->mouseHandler = new MouseEventHandler($menuBar, $commandExecutor);
+        $this->keyboardHandler = new KeyboardEventHandler($commandExecutor, $menuBar);
     }
 
     /**
-     * Handle keyboard input based on current view
-     */
-    public function handleInput(string $key, TuiState $state, CommandHistory $history): void
-    {
-        // Global shortcuts first
-        $wasMenuAction = $this->handleGlobalShortcuts($key, $state);
-        if ($wasMenuAction) {
-            return;
-        }
-
-        // Handle dropdown navigation if dropdown is open
-        if ($state->getActiveDropdownMenu() !== null) {
-            $handled = $this->handleDropdownInput($key, $state);
-            if ($handled) {
-                return;
-            }
-        }
-
-        // Close active menu when any non-menu action is performed
-        // This prevents menu from staying open and causing flicker
-        if ($state->getActiveMenu() !== null && $state->getActiveDropdownMenu() === null) {
-            $state->setActiveMenu(null);
-        }
-
-        // View-specific handling
-        match ($state->getCurrentView()) {
-            TuiView::CATEGORIES => $this->handleCategoriesInput($key, $state),
-            TuiView::COMMANDS => $this->handleCommandsInput($key, $state),
-            TuiView::SEARCH => $this->handleSearchInput($key, $state),
-            TuiView::HISTORY => $this->handleHistoryInput($key, $state, $history),
-            TuiView::FORM => $this->handleFormInput($key, $state),
-            TuiView::DASHBOARD => $this->handleDashboardInput($key, $state),
-            TuiView::HELP => $this->handleHelpInput($key, $state),
-        };
-    }
-
-    /**
-     * Handle global shortcuts available in all views
-     */
-    private function handleGlobalShortcuts(string $key, TuiState $state): bool
-    {
-        switch ($key) {
-            case TuiKeyCode::ESCAPE->value:
-                // If dropdown is open, close it instead of quitting
-                if ($state->getActiveDropdownMenu() !== null) {
-                    $state->setActiveDropdownMenu(null);
-                    $state->setActiveMenu(null);
-                    return true;
-                }
-                // Otherwise quit
-                $state->setRunning(false);
-                return true;
-
-            case 'q':
-            case 'Q':
-                $state->setRunning(false);
-
-                return true;
-
-            case 'd':
-            case 'D':
-                $state->setCurrentView(TuiView::DASHBOARD);
-
-                return true;
-
-            case 'h':
-            case 'H':
-                $state->setCurrentView(TuiView::HELP);
-
-                return true;
-
-            case '/':
-            case 's':
-            case 'S':
-                $state->setCurrentView(TuiView::SEARCH);
-                $state->resetSearchState();
-
-                return true;
-
-            case 'r':
-            case 'R':
-                $state->setCurrentView(TuiView::HISTORY);
-                $state->setSelectedHistoryItem(0);
-
-                return true;
-
-            case TuiKeyCode::F1->value:
-                $this->commandExecutor->showAllCommandsHelp();
-
-                return true;
-
-            case 'c':
-            case 'C':
-                if ($state->getCurrentView() !== TuiView::CATEGORIES) {
-                    $state->setCurrentView(TuiView::CATEGORIES);
-
-                    return true;
-                }
-
-                break;
-        }
-
-        return false;
-    }
-
-    /**
-     * Handle input in categories view
-     */
-    private function handleCategoriesInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ARROW_UP->value:
-                $state->navigateUp();
-
-                break;
-
-            case TuiKeyCode::ARROW_DOWN->value:
-                $state->navigateDown();
-
-                break;
-
-            case TuiKeyCode::ENTER->value:
-                $state->setCurrentView(TuiView::COMMANDS);
-                $state->setSelectedCommand(0);
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in commands view
-     */
-    private function handleCommandsInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ARROW_UP->value:
-                $state->navigateUp();
-
-                break;
-
-            case TuiKeyCode::ARROW_DOWN->value:
-                $state->navigateDown();
-
-                break;
-
-            case TuiKeyCode::ENTER->value:
-                $command = $state->getCurrentCommand();
-                if ($command) {
-                    $this->commandExecutor->executeSelectedCommand($command);
-                }
-
-                break;
-
-            case TuiKeyCode::SPACE->value:
-                $command = $state->getCurrentCommand();
-                if ($command) {
-                    $state->setSelectedCommandForForm($command);
-                    $state->setCurrentView(TuiView::FORM);
-                }
-
-                break;
-
-            case 'v':
-            case 'V':
-                $command = $state->getCurrentCommand();
-                if ($command) {
-                    $this->commandExecutor->validateSelectedCommand($command);
-                }
-
-                break;
-
-            case 'h':
-            case 'H':
-                $command = $state->getCurrentCommand();
-                if ($command) {
-                    $this->commandExecutor->showSelectedCommandHelp($command);
-                }
-
-                break;
-
-            case TuiKeyCode::ARROW_LEFT->value:
-            case TuiKeyCode::BACKSPACE->value:
-                $state->setCurrentView(TuiView::CATEGORIES);
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in search view
-     */
-    private function handleSearchInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ESCAPE->value:
-                $state->setCurrentView(TuiView::CATEGORIES);
-                $state->resetSearchState();
-
-                break;
-
-            case TuiKeyCode::ENTER->value:
-                $command = $state->getCurrentSearchResult();
-                if ($command) {
-                    // Handle DiscoveredAttribute objects
-                    if ($command instanceof DiscoveredAttribute) {
-                        $attribute = $command->createAttributeInstance();
-                        if ($attribute !== null) {
-                            $this->commandExecutor->executeCommand($attribute->name);
-                        }
-                    } else {
-                        $this->commandExecutor->executeCommand($command->name);
-                    }
-                }
-
-                break;
-
-            case TuiKeyCode::SPACE->value:
-                $command = $state->getCurrentSearchResult();
-                if ($command) {
-                    $state->setSelectedCommandForForm($command);
-                    $state->setCurrentView(TuiView::FORM);
-                }
-
-                break;
-
-            case 'h':
-            case 'H':
-                $command = $state->getCurrentSearchResult();
-                if ($command) {
-                    // Handle DiscoveredAttribute objects
-                    if ($command instanceof DiscoveredAttribute) {
-                        $attribute = $command->createAttributeInstance();
-                        if ($attribute !== null) {
-                            $this->commandExecutor->showCommandHelp($attribute->name);
-                        }
-                    } else {
-                        $this->commandExecutor->showCommandHelp($command->name);
-                    }
-                }
-
-                break;
-
-            case 'v':
-            case 'V':
-                $command = $state->getCurrentSearchResult();
-                if ($command) {
-                    // Handle DiscoveredAttribute objects
-                    if ($command instanceof DiscoveredAttribute) {
-                        $attribute = $command->createAttributeInstance();
-                        if ($attribute !== null) {
-                            $this->commandExecutor->validateCommand($attribute->name);
-                        }
-                    } else {
-                        $this->commandExecutor->validateCommand($command->name);
-                    }
-                }
-
-                break;
-
-            case TuiKeyCode::ARROW_UP->value:
-                $state->navigateUp();
-
-                break;
-
-            case TuiKeyCode::ARROW_DOWN->value:
-                $state->navigateDown();
-
-                break;
-
-            case TuiKeyCode::BACKSPACE->value:
-            case "\x7f": // DEL key
-                $query = $state->getSearchQuery();
-                if (strlen($query) > 0) {
-                    $newQuery = substr($query, 0, -1);
-                    $state->setSearchQuery($newQuery);
-                    $this->updateSearchResults($state);
-                }
-
-                break;
-
-            default:
-                // Add character to search query
-                if (strlen($key) === 1 && ctype_print($key)) {
-                    $newQuery = $state->getSearchQuery() . $key;
-                    $state->setSearchQuery($newQuery);
-                    $this->updateSearchResults($state);
-                }
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in history view
-     */
-    private function handleHistoryInput(string $key, TuiState $state, CommandHistory $history): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ARROW_UP->value:
-                // Use history-specific navigation with item count for proper wrap-around
-                $items = $this->getHistoryItems($state, $history);
-                $state->navigateHistoryItemUpWithCount(count($items));
-
-                break;
-
-            case TuiKeyCode::ARROW_DOWN->value:
-                // Use history-specific navigation with item count for proper wrap-around
-                $items = $this->getHistoryItems($state, $history);
-                $state->navigateHistoryItemDownWithCount(count($items));
-
-                break;
-
-            case TuiKeyCode::ARROW_LEFT->value:
-                $this->switchHistoryTab($state, -1);
-
-                break;
-
-            case TuiKeyCode::ARROW_RIGHT->value:
-                $this->switchHistoryTab($state, 1);
-
-                break;
-
-            case TuiKeyCode::ENTER->value:
-                $items = $this->getHistoryItems($state, $history);
-                if (! empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
-                    $command = $items[$state->getSelectedHistoryItem()]['command'];
-                    $history->addToHistory($command);
-                    $this->commandExecutor->executeCommand($command);
-                }
-
-                break;
-
-            case TuiKeyCode::SPACE->value:
-                $items = $this->getHistoryItems($state, $history);
-                if (! empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
-                    $commandName = $items[$state->getSelectedHistoryItem()]['command'];
-                    $commandObject = $this->commandExecutor->findCommandObject($commandName);
-                    if ($commandObject) {
-                        $state->setSelectedCommandForForm($commandObject);
-                        $state->setCurrentView(TuiView::FORM);
-                    }
-                }
-
-                break;
-
-            case 'h':
-            case 'H':
-                $items = $this->getHistoryItems($state, $history);
-                if (! empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
-                    $commandName = $items[$state->getSelectedHistoryItem()]['command'];
-                    $this->commandExecutor->showCommandHelp($commandName);
-                }
-
-                break;
-
-            case 'v':
-            case 'V':
-                $items = $this->getHistoryItems($state, $history);
-                if (! empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
-                    $commandName = $items[$state->getSelectedHistoryItem()]['command'];
-                    $this->commandExecutor->validateCommand($commandName);
-                }
-
-                break;
-
-            case 'f':
-            case 'F':
-                $items = $this->getHistoryItems($state, $history);
-                if (! empty($items) && isset($items[$state->getSelectedHistoryItem()])) {
-                    $command = $items[$state->getSelectedHistoryItem()]['command'];
-                    $history->toggleFavorite($command);
-                }
-
-                break;
-
-            case 'c':
-            case 'C':
-                if ($state->getHistoryTab() === HistoryTab::FAVORITES) {
-                    $history->clearFavorites();
-                } else {
-                    $history->clearHistory();
-                }
-
-                break;
-
-            case TuiKeyCode::ESCAPE->value:
-            case TuiKeyCode::BACKSPACE->value:
-                $state->setCurrentView(TuiView::CATEGORIES);
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in form view
-     */
-    private function handleFormInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ESCAPE->value:
-                $state->resetFormState();
-                $state->setCurrentView(TuiView::CATEGORIES);
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in dashboard view
-     */
-    private function handleDashboardInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ESCAPE->value:
-                $state->setCurrentView(TuiView::CATEGORIES);
-
-                break;
-        }
-    }
-
-    /**
-     * Handle input in help view
-     */
-    private function handleHelpInput(string $key, TuiState $state): void
-    {
-        switch ($key) {
-            case TuiKeyCode::ESCAPE->value:
-                $state->setCurrentView(TuiView::CATEGORIES);
-
-                break;
-        }
-    }
-
-    /**
-     * Update search results based on current query
-     */
-    private function updateSearchResults(TuiState $state): void
-    {
-        $query = strtolower($state->getSearchQuery());
-
-        if (empty($query)) {
-            $state->setSearchResults([]);
-
-            return;
-        }
-
-        $results = [];
-        $categories = $state->getCategories();
-
-        foreach ($categories as $category) {
-            foreach ($category['commands'] as $command) {
-                // Handle DiscoveredAttribute objects
-                if ($command instanceof DiscoveredAttribute) {
-                    $attribute = $command->createAttributeInstance();
-                    if ($attribute === null) {
-                        continue;
-                    }
-                    $commandName = strtolower($attribute->name);
-                    $commandDescription = strtolower($attribute->description ?? '');
-                } else {
-                    // Fallback for legacy objects
-                    $commandName = strtolower($command->name ?? '');
-                    $commandDescription = strtolower($command->description ?? '');
-                }
-
-                if (str_contains($commandName, $query) || str_contains($commandDescription, $query)) {
-                    $results[] = $command;
-                }
-            }
-        }
-
-        $state->setSearchResults($results);
-    }
-
-    /**
-     * Switch between history tabs
-     */
-    private function switchHistoryTab(TuiState $state, int $direction): void
-    {
-        $tabs = [HistoryTab::RECENT, HistoryTab::FREQUENT, HistoryTab::FAVORITES];
-        $currentIndex = array_search($state->getHistoryTab(), $tabs);
-
-        $newIndex = ($currentIndex + $direction + count($tabs)) % count($tabs);
-        $state->setHistoryTab($tabs[$newIndex]);
-    }
-
-    /**
-     * Get history items based on current tab
-     */
-    private function getHistoryItems(TuiState $state, CommandHistory $history): array
-    {
-        return match ($state->getHistoryTab()) {
-            HistoryTab::RECENT => $history->getRecentHistory(10),
-            HistoryTab::FREQUENT => $history->getFrequentCommands(10),
-            HistoryTab::FAVORITES => $history->getFavorites(),
-        };
-    }
-
-    /**
-     * Handle mouse events
+     * Handle mouse event (backward compatibility)
      */
     public function handleMouseEvent(MouseEvent $event, TuiState $state, CommandHistory $history): bool
     {
-        // Handle mouse move events for hover effects
-        if ($event->isMouseMove()) {
-            return $this->handleMouseMove($event, $state, $history);
-        }
-
-        // Only handle button presses, not releases (except for scroll)
-        if (! $event->pressed && ! $event->isScrollEvent()) {
-            return false;
-        }
-
-        // Handle scroll events (mouse wheel)
-        if ($event->isScrollEvent()) {
-            // Only process scroll in views that support navigation
-            $currentView = $state->getCurrentView();
-            $scrollableViews = [
-                TuiView::CATEGORIES,
-                TuiView::COMMANDS,
-                TuiView::SEARCH,
-                TuiView::HISTORY,
-            ];
-
-            if (in_array($currentView, $scrollableViews, true)) {
-                if ($event->button === 64) {
-                    // Scroll Up
-                    if ($currentView === TuiView::HISTORY) {
-                        // Use history-specific navigation with item count for proper wrap-around
-                        $items = $this->getHistoryItems($state, $history);
-                        $state->navigateHistoryItemUpWithCount(count($items));
-                    } else {
-                        $state->navigateUp();
-                    }
-                } elseif ($event->button === 65) {
-                    // Scroll Down
-                    if ($currentView === TuiView::HISTORY) {
-                        // Use history-specific navigation with item count for proper wrap-around
-                        $items = $this->getHistoryItems($state, $history);
-                        $state->navigateHistoryItemDownWithCount(count($items));
-                    } else {
-                        $state->navigateDown();
-                    }
-                }
-            }
-
-            return true; // Re-render needed for scroll
-        }
-
-        // Only update status for menu clicks, not all mouse movements
-        // This reduces flickering
-
-        // Handle dropdown clicks first (if dropdown is open)
-        if ($state->getActiveDropdownMenu() !== null) {
-            $dropdownItemIndex = $this->handleDropdownClick($event, $state);
-            if ($dropdownItemIndex !== null) {
-                // Dropdown click was handled
-                return true; // Re-render needed
-            }
-        }
-
-        // Handle menu bar clicks
-        if ($this->menuBar !== null && $this->menuBar->isClickInMenuArea($event->x, $event->y)) {
-            $menuItem = $this->menuBar->getItemAtPosition($event->x);
-            if ($menuItem !== null && $event->button === 0) {
-                // Left click on menu item - open dropdown if it has submenus
-                if ($this->menuBar->hasSubmenu($menuItem)) {
-                $state->setActiveMenu($menuItem);
-                    $state->setActiveDropdownMenu($menuItem);
-                    $state->setSelectedDropdownItem(0);
-                $state->setStatus("Menü geöffnet: {$menuItem}");
-                } else {
-                    // No submenu, just set active menu
-                    $state->setActiveMenu($menuItem);
-                    $state->setActiveDropdownMenu(null);
-                    $state->setStatus("Menü: {$menuItem}");
-                }
-            }
-
-            return true; // Re-render needed
-        }
-
-        // If dropdown is open and click is outside, close dropdown
-        if ($state->getActiveDropdownMenu() !== null && $event->button === 0) {
-            $state->setActiveDropdownMenu(null);
-            $state->setActiveMenu(null);
-            return true; // Re-render needed
-        }
-
-        // Handle item clicks (left and right button)
-        if ($event->button === 0) {
-            // Left click - primary action
-            $this->handleItemClick($event, $state, $history, false);
-            return true; // Re-render needed
-        } elseif ($event->button === 2) {
-            // Right click - alternative action
-            $this->handleItemClick($event, $state, $history, true);
-            return true; // Re-render needed
-        }
-
-        return false; // No re-render needed
+        return $this->mouseHandler->handle($event, $state, $history);
     }
 
     /**
-     * Handle mouse move events for hover effects
-     * Returns true if hover state changed (needs re-render)
-     */
-    private function handleMouseMove(MouseEvent $event, TuiState $state, CommandHistory $history): bool
-    {
-        // Throttle mouse move events to reduce CPU usage
-        $now = microtime(true);
-        if (($now - $this->lastHoverUpdate) < self::HOVER_UPDATE_INTERVAL) {
-            return false; // Skip this event, too soon since last update
-        }
-        $this->lastHoverUpdate = $now;
-
-        $hoverChanged = false;
-        $oldHoveredMenuItem = $state->getHoveredMenuItem();
-        $oldHoveredDropdownItem = $state->getHoveredDropdownItem();
-        $oldHoveredContentType = $state->getHoveredContentItemType();
-        $oldHoveredContentIndex = $state->getHoveredContentItemIndex();
-
-        // Check if mouse is over menu bar (lines 2-3)
-        if ($this->menuBar !== null && $this->menuBar->isClickInMenuArea($event->x, $event->y)) {
-            $menuItem = $this->menuBar->getItemAtPosition($event->x);
-            if ($menuItem !== null) {
-                $state->setHoveredMenuItem($menuItem);
-                $state->setHoveredDropdownItem(null);
-                $state->setHoveredContentItem(null, null);
-                
-                if ($oldHoveredMenuItem !== $menuItem) {
-                    $hoverChanged = true;
-                }
-            } else {
-                $state->setHoveredMenuItem(null);
-                if ($oldHoveredMenuItem !== null) {
-                    $hoverChanged = true;
-                }
-            }
-
-            return $hoverChanged;
-        }
-
-        // Check if mouse is over dropdown menu
-        if ($state->getActiveDropdownMenu() !== null) {
-            $dropdownItemIndex = $this->calculateDropdownHoverIndex($event, $state);
-            $state->setHoveredDropdownItem($dropdownItemIndex);
-            $state->setHoveredMenuItem(null);
-            $state->setHoveredContentItem(null, null);
-            
-            if ($oldHoveredDropdownItem !== $dropdownItemIndex) {
-                $hoverChanged = true;
-            }
-
-            return $hoverChanged;
-        }
-
-        // Check if mouse is over content items
-        $contentItemIndex = $this->calculateContentItemIndex($event->y, $state);
-        $currentView = $state->getCurrentView();
-        
-        if ($contentItemIndex !== null) {
-            $itemType = match ($currentView) {
-                TuiView::CATEGORIES => 'category',
-                TuiView::COMMANDS => 'command',
-                TuiView::SEARCH => 'search',
-                TuiView::HISTORY => 'history',
-                default => null,
-            };
-
-            if ($itemType !== null) {
-                $state->setHoveredContentItem($itemType, $contentItemIndex);
-                $state->setHoveredMenuItem(null);
-                $state->setHoveredDropdownItem(null);
-
-                if ($oldHoveredContentType !== $itemType || $oldHoveredContentIndex !== $contentItemIndex) {
-                    $hoverChanged = true;
-                }
-            }
-        } else {
-            // Clear content hover
-            $state->setHoveredContentItem(null, null);
-            $state->setHoveredMenuItem(null);
-            $state->setHoveredDropdownItem(null);
-
-            if ($oldHoveredContentType !== null || $oldHoveredContentIndex !== null) {
-                $hoverChanged = true;
-            }
-        }
-
-        return $hoverChanged;
-    }
-
-    /**
-     * Calculate content item index from Y position
-     */
-    private function calculateContentItemIndex(int $y, TuiState $state): ?int
-    {
-        return match ($state->getCurrentView()) {
-            TuiView::CATEGORIES => $this->calculateCategoryIndex($y),
-            TuiView::COMMANDS => $this->calculateCommandIndex($y, $state),
-            TuiView::SEARCH => $this->calculateSearchResultIndex($y, $state),
-            TuiView::HISTORY => $this->calculateHistoryItemIndex($y),
-            default => null,
-        };
-    }
-
-    /**
-     * Calculate which dropdown item is hovered based on mouse position
-     */
-    private function calculateDropdownHoverIndex(MouseEvent $event, TuiState $state): ?int
-    {
-        if ($this->menuBar === null) {
-            return null;
-        }
-
-        $activeDropdown = $state->getActiveDropdownMenu();
-        if ($activeDropdown === null) {
-            return null;
-        }
-
-        $submenuItems = $this->menuBar->getSubmenu($activeDropdown);
-        if (empty($submenuItems)) {
-            return null;
-        }
-
-        $menuItems = $this->menuBar->getItems();
-        $activeIndex = array_search($activeDropdown, $menuItems, true);
-        
-        if ($activeIndex === false) {
-            return null;
-        }
-
-        $dropdownX = $this->menuBar->getItemXPosition($activeIndex) ?? 1;
-        
-        // Check if mouse is in dropdown area (line 4+, column dropdownX+)
-        if ($event->y < 4 || $event->x < $dropdownX) {
-            return null;
-        }
-
-        $dropdownItemIndex = $event->y - 4;
-        
-        if ($dropdownItemIndex < 0 || $dropdownItemIndex >= count($submenuItems)) {
-            return null;
-        }
-
-        // Don't hover over separators
-        if (($submenuItems[$dropdownItemIndex] ?? '') === '---') {
-            return null;
-        }
-
-        return $dropdownItemIndex;
-    }
-
-    /**
-     * Handle clicks on list items
-     * 
-     * @param bool $isRightClick True for right click (alternative action), false for left click (primary action)
-     */
-    private function handleItemClick(MouseEvent $event, TuiState $state, CommandHistory $history, bool $isRightClick): void
-    {
-        $currentView = $state->getCurrentView();
-        
-        // Menu bar takes lines 1-2, items start below
-        if ($event->y <= 2) {
-            return; // Click is in menu bar area
-        }
-
-        // Calculate item index from Y position based on view
-        $itemIndex = $this->calculateItemIndexFromY($event->y, $currentView, $state);
-        
-        if ($itemIndex === null) {
-            return; // Click is not on an item
-        }
-
-        // Select item and execute action based on view
-        if ($isRightClick) {
-            // Right click - alternative actions
-            match ($currentView) {
-                TuiView::CATEGORIES => $this->handleCategoryClick($itemIndex, $state), // Same as left click
-                TuiView::COMMANDS => $this->handleCommandRightClick($itemIndex, $state),
-                TuiView::SEARCH => $this->handleSearchResultRightClick($itemIndex, $state),
-                TuiView::HISTORY => $this->handleHistoryItemRightClick($itemIndex, $state, $history),
-                default => null,
-            };
-        } else {
-            // Left click - primary actions
-            match ($currentView) {
-                TuiView::CATEGORIES => $this->handleCategoryClick($itemIndex, $state),
-                TuiView::COMMANDS => $this->handleCommandClick($itemIndex, $state),
-                TuiView::SEARCH => $this->handleSearchResultClick($itemIndex, $state),
-                TuiView::HISTORY => $this->handleHistoryItemClick($itemIndex, $state, $history),
-                default => null, // Other views don't support item clicks
-            };
-        }
-    }
-
-    /**
-     * Calculate item index from Y position
-     * 
-     * Layout:
-     * - Line 1-2: Menu bar + separator
-     * - Line 3: Header (varies by view)
-     * - Line 4: Empty line (or search box in search view)
-     * - Line 5+: Items (varies by view)
-     */
-    private function calculateItemIndexFromY(int $y, TuiView $view, TuiState $state): ?int
-    {
-        return match ($view) {
-            TuiView::CATEGORIES => $this->calculateCategoryIndex($y),
-            TuiView::COMMANDS => $this->calculateCommandIndex($y, $state),
-            TuiView::SEARCH => $this->calculateSearchResultIndex($y, $state),
-            TuiView::HISTORY => $this->calculateHistoryItemIndex($y),
-            default => null,
-        };
-    }
-
-    /**
-     * Calculate category index from Y position
-     * Layout: Empty(1) + Menu(2-3) + Header(4) + Empty(5) + Items(6+)
-     */
-    private function calculateCategoryIndex(int $y): ?int
-    {
-        // Items start at line 6 (after empty 1 + menu 2-3 + header "📂 Select Category:" at 4 + empty at 5)
-        $startLine = 6;
-        
-        if ($y < $startLine) {
-            return null;
-        }
-
-        // Each category takes 1 line
-        $index = $y - $startLine;
-        
-        return $index;
-    }
-
-    /**
-     * Calculate command index from Y position
-     * Layout: Empty(1) + Menu(2-3) + Header(4) + Empty(5) + Items(6+)
-     * Commands can take 1-2 lines (name + optional description)
-     */
-    private function calculateCommandIndex(int $y, TuiState $state): ?int
-    {
-        // Items start at line 6 (after empty 1 + menu 2-3 + header at 4 + empty at 5)
-        $startLine = 6;
-        
-        if ($y < $startLine) {
-            return null;
-        }
-
-        $category = $state->getCurrentCategory();
-        if (! $category) {
-            return null;
-        }
-
-        $commands = $category['commands'] ?? [];
-        $currentLine = $startLine;
-        $index = 0;
-
-        foreach ($commands as $command) {
-            // Check if click is on this command's line
-            if ($y === $currentLine) {
-                return $index;
-            }
-
-            // Move to next item (1 line for name, +1 if has description)
-            $commandDescription = $this->getCommandDescription($command);
-            $lines = empty($commandDescription) ? 1 : 2;
-            $currentLine += $lines;
-            $index++;
-        }
-
-        return null;
-    }
-
-    /**
-     * Calculate search result index from Y position
-     * Layout: Empty(1) + Menu(2-3) + Header(4) + Empty(5) + SearchBox(6) + Empty(7) + "Found X"(8) + Empty(9) + Items(10+)
-     */
-    private function calculateSearchResultIndex(int $y, TuiState $state): ?int
-    {
-        // Items start at line 10 (after empty 1 + menu 2-3 + header 4 + empty 5 + searchbox 6 + empty 7 + "Found" 8 + empty 9)
-        $startLine = 10;
-        
-        if ($y < $startLine) {
-            return null;
-        }
-
-        $results = $state->getSearchResults();
-        if (empty($results)) {
-            return null; // No results to click
-        }
-
-        $currentLine = $startLine;
-        $index = 0;
-
-        foreach ($results as $result) {
-            // Check if click is on this result's line
-            if ($y === $currentLine) {
-                return $index;
-            }
-
-            // Move to next item (1 line for name, +1 if has description)
-            $commandDescription = $this->getCommandDescription($result);
-            $lines = empty($commandDescription) ? 1 : 2;
-            $currentLine += $lines;
-            $index++;
-        }
-
-        return null;
-    }
-
-    /**
-     * Calculate history item index from Y position
-     * Layout: Empty(1) + Menu(2-3) + Header(4) + Empty(5) + Tabs(6) + Empty(7) + Items(8+)
-     */
-    private function calculateHistoryItemIndex(int $y): ?int
-    {
-        // Items start at line 8 (after empty 1 + menu 2-3 + header 4 + empty 5 + tabs 6 + empty 7)
-        $startLine = 8;
-        
-        if ($y < $startLine) {
-            return null;
-        }
-
-        // Each history item takes 1 line
-        $index = $y - $startLine;
-        
-        return $index;
-    }
-
-    /**
-     * Get command description from command object
-     */
-    private function getCommandDescription(object $command): string
-    {
-        if ($command instanceof \App\Framework\Discovery\ValueObjects\DiscoveredAttribute) {
-            $attribute = $command->createAttributeInstance();
-            return $attribute?->description ?? '';
-        }
-
-        return $command->description ?? '';
-    }
-
-    /**
-     * Handle dropdown menu input (navigation and selection)
-     */
-    private function handleDropdownInput(string $key, TuiState $state): bool
-    {
-        if ($this->menuBar === null) {
-            return false;
-        }
-
-        $activeDropdown = $state->getActiveDropdownMenu();
-        if ($activeDropdown === null) {
-            return false;
-        }
-
-        $submenuItems = $this->menuBar->getSubmenu($activeDropdown);
-        if (empty($submenuItems)) {
-            return false;
-        }
-
-        $maxIndex = count($submenuItems) - 1;
-        $currentIndex = $state->getSelectedDropdownItem();
-
-        switch ($key) {
-            case TuiKeyCode::ARROW_UP->value:
-                // Navigate up with wrap-around
-                $newIndex = $currentIndex - 1;
-                if ($newIndex < 0) {
-                    $newIndex = $maxIndex;
-                }
-                // Skip separators
-                while ($newIndex >= 0 && ($submenuItems[$newIndex] ?? '') === '---') {
-                    $newIndex--;
-                }
-                if ($newIndex < 0) {
-                    $newIndex = $maxIndex;
-                }
-                $state->setSelectedDropdownItem($newIndex);
-                return true;
-
-            case TuiKeyCode::ARROW_DOWN->value:
-                // Navigate down with wrap-around
-                $newIndex = $currentIndex + 1;
-                if ($newIndex > $maxIndex) {
-                    $newIndex = 0;
-                }
-                // Skip separators
-                while ($newIndex <= $maxIndex && ($submenuItems[$newIndex] ?? '') === '---') {
-                    $newIndex++;
-                }
-                if ($newIndex > $maxIndex) {
-                    $newIndex = 0;
-                }
-                $state->setSelectedDropdownItem($newIndex);
-                return true;
-
-            case TuiKeyCode::ENTER->value:
-                // Execute selected dropdown item
-                $selectedItem = $submenuItems[$currentIndex] ?? null;
-                if ($selectedItem !== null && $selectedItem !== '---') {
-                    $this->executeDropdownItem($activeDropdown, $selectedItem, $state);
-                    $state->setActiveDropdownMenu(null);
-                    $state->setActiveMenu(null);
-                }
-                return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * Handle dropdown menu clicks
-     */
-    private function handleDropdownClick(MouseEvent $event, TuiState $state): ?int
-    {
-        if ($this->menuBar === null || $event->button !== 0) {
-            return null;
-        }
-
-        $activeDropdown = $state->getActiveDropdownMenu();
-        if ($activeDropdown === null) {
-            return null;
-        }
-
-        $submenuItems = $this->menuBar->getSubmenu($activeDropdown);
-        if (empty($submenuItems)) {
-            return null;
-        }
-
-        // Dropdown is rendered starting at line 4, column dropdownX (after menu bar at 2-3)
-        // We need to check if click is within dropdown area
-        $menuItems = $this->menuBar->getItems();
-        $activeIndex = array_search($activeDropdown, $menuItems, true);
-        
-        if ($activeIndex === false) {
-            return null;
-        }
-
-        // Get dropdown X position (approximate for now)
-        $dropdownX = $this->menuBar->getItemXPosition($activeIndex) ?? 1;
-        
-        // Check if click is in dropdown area (line 4+, column dropdownX+)
-        if ($event->y < 4 || $event->x < $dropdownX) {
-            return null;
-        }
-
-        // Calculate which dropdown item was clicked
-        $dropdownItemIndex = $event->y - 4;
-        
-        if ($dropdownItemIndex < 0 || $dropdownItemIndex >= count($submenuItems)) {
-            return null;
-        }
-
-        $clickedItem = $submenuItems[$dropdownItemIndex] ?? null;
-        if ($clickedItem === null || $clickedItem === '---') {
-            return null;
-        }
-
-        // Execute clicked item
-        $this->executeDropdownItem($activeDropdown, $clickedItem, $state);
-        $state->setActiveDropdownMenu(null);
-        $state->setActiveMenu(null);
-
-        return $dropdownItemIndex;
-    }
-
-    /**
-     * Execute a dropdown menu item action
-     */
-    private function executeDropdownItem(string $menu, string $item, TuiState $state): void
-    {
-        $state->setStatus("Ausgeführt: {$menu} > {$item}");
-        // TODO: Implement actual actions for dropdown items
-    }
-
-    /**
-     * Handle category click - select category and navigate to commands
-     */
-    private function handleCategoryClick(int $index, TuiState $state): void
-    {
-        $categories = $state->getCategories();
-        
-        if ($index < 0 || $index >= count($categories)) {
-            return;
-        }
-
-        $state->setSelectedCategory($index);
-        $state->setCurrentView(TuiView::COMMANDS);
-        $state->setSelectedCommand(0);
-    }
-
-    /**
-     * Handle command click - select command and execute it
-     */
-    private function handleCommandClick(int $index, TuiState $state): void
-    {
-        $category = $state->getCurrentCategory();
-        if (! $category) {
-            return;
-        }
-
-        $commands = $category['commands'] ?? [];
-        
-        if ($index < 0 || $index >= count($commands)) {
-            return;
-        }
-
-        $state->setSelectedCommand($index);
-        $command = $commands[$index];
-        
-        if ($command) {
-            $this->commandExecutor->executeSelectedCommand($command);
-        }
-    }
-
-    /**
-     * Handle search result click - select result and execute it
-     */
-    private function handleSearchResultClick(int $index, TuiState $state): void
-    {
-        $results = $state->getSearchResults();
-        
-        if ($index < 0 || $index >= count($results)) {
-            return;
-        }
-
-        $state->setSelectedSearchResult($index);
-        $command = $results[$index];
-        
-        if ($command) {
-            // Handle DiscoveredAttribute objects
-            if ($command instanceof \App\Framework\Discovery\ValueObjects\DiscoveredAttribute) {
-                $attribute = $command->createAttributeInstance();
-                if ($attribute !== null) {
-                    $this->commandExecutor->executeCommand($attribute->name);
-                }
-            } else {
-                $this->commandExecutor->executeCommand($command->name);
-            }
-        }
-    }
-
-    /**
-     * Handle history item click - select item and execute it
-     */
-    private function handleHistoryItemClick(int $index, TuiState $state, CommandHistory $history): void
-    {
-        $items = $this->getHistoryItems($state, $history);
-        
-        if ($index < 0 || $index >= count($items)) {
-            return;
-        }
-
-        $state->setSelectedHistoryItem($index);
-        
-        // Execute the history item (same as Enter key)
-        if (isset($items[$index])) {
-            $command = $items[$index]['command'];
-            $history->addToHistory($command);
-            $this->commandExecutor->executeCommand($command);
-        }
-    }
-
-    /**
-     * Handle command right click - open parameter form
-     */
-    private function handleCommandRightClick(int $index, TuiState $state): void
-    {
-        $category = $state->getCurrentCategory();
-        if (! $category) {
-            return;
-        }
-
-        $commands = $category['commands'] ?? [];
-        
-        if ($index < 0 || $index >= count($commands)) {
-            return;
-        }
-
-        $state->setSelectedCommand($index);
-        $command = $commands[$index];
-        
-        if ($command) {
-            $state->setSelectedCommandForForm($command);
-            $state->setCurrentView(TuiView::FORM);
-        }
-    }
-
-    /**
-     * Handle search result right click - open parameter form
-     */
-    private function handleSearchResultRightClick(int $index, TuiState $state): void
-    {
-        $results = $state->getSearchResults();
-        
-        if ($index < 0 || $index >= count($results)) {
-            return;
-        }
-
-        $state->setSelectedSearchResult($index);
-        $command = $results[$index];
-        
-        if ($command) {
-            $state->setSelectedCommandForForm($command);
-            $state->setCurrentView(TuiView::FORM);
-        }
-    }
-
-    /**
-     * Handle history item right click - toggle favorite
-     */
-    private function handleHistoryItemRightClick(int $index, TuiState $state, CommandHistory $history): void
-    {
-        $items = $this->getHistoryItems($state, $history);
-        
-        if ($index < 0 || $index >= count($items)) {
-            return;
-        }
-
-        $state->setSelectedHistoryItem($index);
-        
-        // Toggle favorite (same as F key)
-        if (isset($items[$index])) {
-            $command = $items[$index]['command'];
-            $isFavorite = $history->toggleFavorite($command);
-            $status = $isFavorite ? 'Zu Favoriten hinzugefügt' : 'Aus Favoriten entfernt';
-            $state->setStatus("{$command}: {$status}");
-        }
-    }
-
-    /**
-     * Handle keyboard events (for Alt+Letter menu shortcuts)
+     * Handle keyboard event (backward compatibility)
      */
     public function handleKeyEvent(KeyEvent $event, TuiState $state, CommandHistory $history): void
     {
-        // Handle Alt+Letter shortcuts for menu
-        if ($event->alt && $this->menuBar !== null && strlen($event->key) === 1) {
-            $menuItem = $this->menuBar->getItemByHotkey($event->key);
-            if ($menuItem !== null) {
-                $state->setActiveMenu($menuItem);
-                $state->setStatus("Menü geöffnet: {$menuItem}");
-
-                return;
-            }
-        }
-
-        // Convert to legacy key string format first
-        $keyString = $this->keyEventToString($event);
-        if ($keyString === '') {
-            return;
-        }
-
-        // Only update status for non-navigation keys to reduce flickering
-        $isNavigationKey = in_array($event->key, ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Enter', 'Escape', 'Tab'], true);
-        
-        if (!$isNavigationKey) {
-            $keyDesc = $event->getDescription();
-            $state->setStatus("Taste: {$keyDesc}");
-        }
-        // Don't update status for navigation keys - let navigation happen without status flicker
-
-        // Process input - this handles navigation
-        $this->handleInput($keyString, $state, $history);
-    }
-
-    /**
-     * Convert KeyEvent to legacy key string format
-     */
-    private function keyEventToString(KeyEvent $event): string
-    {
-        // If code is available, use it directly (contains escape sequence)
-        if ($event->code !== '') {
-            return $event->code;
-        }
-
-        // Otherwise map known keys to escape sequences
-        return match ($event->key) {
-            'ArrowUp' => "\033[A",
-            'ArrowDown' => "\033[B",
-            'ArrowRight' => "\033[C",
-            'ArrowLeft' => "\033[D",
-            'Enter' => "\n",
-            'Escape' => "\033",
-            'Tab' => "\t",
-            default => $event->key,
-        };
+        $this->keyboardHandler->handle($event, $state, $history);
     }
 }
diff --git a/src/Framework/Console/Components/TuiRenderer.php b/src/Framework/Console/Components/TuiRenderer.php
index db83b485..c405c0e0 100644
--- a/src/Framework/Console/Components/TuiRenderer.php
+++ b/src/Framework/Console/Components/TuiRenderer.php
@@ -4,6 +4,8 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Components;
 
+use App\Framework\Console\Animation\AnimationManager;
+use App\Framework\Console\Animation\TuiAnimationRenderer;
 use App\Framework\Console\CommandHistory;
 use App\Framework\Console\ConsoleColor;
 use App\Framework\Console\ConsoleOutputInterface;
@@ -21,9 +23,11 @@ final class TuiRenderer
 {
     private MenuBar $menuBar;
     private bool $menuBarInitialized = false;
+    private ?TuiAnimationRenderer $animationRenderer = null;
 
     public function __construct(
-        private ConsoleOutputInterface $output
+        private ConsoleOutputInterface $output,
+        ?AnimationManager $animationManager = null
     ) {
         // Initialize menu bar with default items and submenus
         $submenus = [
@@ -33,6 +37,11 @@ final class TuiRenderer
             'Hilfe' => ['Hilfe anzeigen', 'Über'],
         ];
         $this->menuBar = new MenuBar(['Datei', 'Bearbeiten', 'Ansicht', 'Hilfe'], $submenus);
+        
+        // Initialize animation renderer if animation manager is provided
+        if ($animationManager !== null) {
+            $this->animationRenderer = new TuiAnimationRenderer($animationManager);
+        }
     }
 
     /**
@@ -40,6 +49,11 @@ final class TuiRenderer
      */
     public function render(TuiState $state, CommandHistory $history): void
     {
+        // Update animations if animation renderer is available
+        if ($this->animationRenderer !== null) {
+            $this->animationRenderer->update(0.016); // ~60 FPS
+        }
+
         // Get terminal size for layout
         $terminalSize = TerminalSize::detect();
         
diff --git a/src/Framework/Console/ConsoleCommandMapper.php b/src/Framework/Console/ConsoleCommandMapper.php
index 0f27a224..695a1a87 100644
--- a/src/Framework/Console/ConsoleCommandMapper.php
+++ b/src/Framework/Console/ConsoleCommandMapper.php
@@ -8,8 +8,8 @@ use App\Framework\Attributes\Route;
 use App\Framework\Core\AttributeMapper;
 use App\Framework\Core\ParameterTypeValidator;
 use App\Framework\Mcp\McpTool;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 final readonly class ConsoleCommandMapper implements AttributeMapper
 {
diff --git a/src/Framework/Console/ConsoleInput.php b/src/Framework/Console/ConsoleInput.php
index 2cdc2adb..53e2affc 100644
--- a/src/Framework/Console/ConsoleInput.php
+++ b/src/Framework/Console/ConsoleInput.php
@@ -4,10 +4,15 @@ declare(strict_types=1);
 
 namespace App\Framework\Console;
 
-use App\Framework\Console\Components\InteractiveMenu;
+use App\Framework\Console\Ansi\AnsiSequenceGenerator;
+use App\Framework\Console\Terminal\TerminalCapabilities;
 use App\Framework\Console\ValueObjects\ChoiceOptions;
 use App\Framework\Console\ValueObjects\MenuOptions;
 
+/**
+ * Refactored ConsoleInput - simplified and delegates to InteractivePrompter.
+ * Focuses on argument parsing only, interactive prompts are handled by InteractivePrompter.
+ */
 final class ConsoleInput implements ConsoleInputInterface
 {
     private array $arguments;
@@ -20,12 +25,21 @@ final class ConsoleInput implements ConsoleInputInterface
 
     private ?ParsedArguments $parsedArguments = null;
 
+    private InteractivePrompter $prompter;
+
     public function __construct(array $arguments, ?ConsoleOutputInterface $output = null, ?ArgumentParser $parser = null)
     {
         $this->parseArguments($arguments);
         $this->output = $output ?? new ConsoleOutput();
         $this->parser = $parser;
 
+        // Initialize prompter
+        $textWriter = new TextWriter(
+            new AnsiSequenceGenerator(),
+            new TerminalCapabilities()
+        );
+        $this->prompter = new InteractivePrompter($this->output, $textWriter);
+
         // Use enhanced parser if available
         if ($this->parser) {
             $this->parsedArguments = $this->parser->parse($arguments);
@@ -82,7 +96,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function ask(string $question, string $default = ''): string
     {
-        return $this->output->askQuestion($question, $default);
+        return $this->prompter->askQuestion($question, $default !== '' ? $default : null);
     }
 
     /**
@@ -90,15 +104,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function askPassword(string $question): string
     {
-        echo $question . ": ";
-
-        // Verstecke Eingabe
-        system('stty -echo');
-        $password = trim(fgets(STDIN));
-        system('stty echo');
-        echo PHP_EOL;
-
-        return $password;
+        return $this->prompter->askPassword($question);
     }
 
     /**
@@ -106,7 +112,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function confirm(string $question, bool $default = false): bool
     {
-        return $this->output->confirm($question, $default);
+        return $this->prompter->confirm($question, $default);
     }
 
     /**
@@ -117,9 +123,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function choice(string $question, array $choices, mixed $default = null): mixed
     {
-        $menuOptions = MenuOptions::fromArray($choices);
-
-        return $this->choiceFromOptions($question, $menuOptions, $default);
+        return $this->prompter->choice($question, $choices, $default);
     }
 
     /**
@@ -127,18 +131,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function choiceFromOptions(string $question, MenuOptions $options, mixed $default = null): mixed
     {
-        $menu = new InteractiveMenu($this->output);
-        $menu->setTitle($question);
-
-        foreach ($options as $option) {
-            if ($option->isSeparator()) {
-                $menu->addSeparator();
-            } else {
-                $menu->addItem($option->label, null, $option->key);
-            }
-        }
-
-        return $menu->showSimple();
+        return $this->prompter->choiceFromOptions($question, $options, $default);
     }
 
     /**
@@ -149,9 +142,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function menu(string $title, array $items): mixed
     {
-        $menuOptions = MenuOptions::fromArray($items);
-
-        return $this->menuFromOptions($title, $menuOptions);
+        return $this->prompter->menu($title, $items);
     }
 
     /**
@@ -159,18 +150,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function menuFromOptions(string $title, MenuOptions $options): mixed
     {
-        $menu = new InteractiveMenu($this->output);
-        $menu->setTitle($title);
-
-        foreach ($options as $option) {
-            if ($option->isSeparator()) {
-                $menu->addSeparator();
-            } else {
-                $menu->addItem($option->label, null, $option->key);
-            }
-        }
-
-        return $menu->showInteractive();
+        return $this->prompter->menuFromOptions($title, $options);
     }
 
     /**
@@ -181,10 +161,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function multiSelect(string $question, array $options): array
     {
-        $choiceOptions = ChoiceOptions::fromArray($options);
-        $selected = $this->multiSelectFromOptions($question, $choiceOptions);
-
-        return $selected->getSelectedValues();
+        return $this->prompter->multiSelect($question, $options);
     }
 
     /**
@@ -192,28 +169,7 @@ final class ConsoleInput implements ConsoleInputInterface
      */
     public function multiSelectFromOptions(string $question, ChoiceOptions $options): ChoiceOptions
     {
-        $this->output->writeLine($question, ConsoleColor::BRIGHT_CYAN);
-        $this->output->writeLine("Mehrfachauswahl mit Komma getrennt (z.B. 1,3,5):");
-
-        $displayOptions = $options->toArray();
-        foreach ($displayOptions as $key => $option) {
-            $this->output->writeLine("  " . ($key + 1) . ": {$option->label}");
-        }
-
-        $this->output->write("Ihre Auswahl: ", ConsoleColor::BRIGHT_CYAN);
-        $input = trim(fgets(STDIN));
-
-        $selectedValues = [];
-        $indices = explode(',', $input);
-
-        foreach ($indices as $index) {
-            $index = (int)trim($index) - 1;
-            if (isset($displayOptions[$index])) {
-                $selectedValues[] = $displayOptions[$index]->value;
-            }
-        }
-
-        return $options->selectByValues($selectedValues);
+        return $this->prompter->multiSelectFromOptions($question, $options);
     }
 
     // ==========================================
diff --git a/src/Framework/Console/ConsoleOutput.php b/src/Framework/Console/ConsoleOutput.php
index 6fdcaf87..1b0156ff 100644
--- a/src/Framework/Console/ConsoleOutput.php
+++ b/src/Framework/Console/ConsoleOutput.php
@@ -4,10 +4,22 @@ declare(strict_types=1);
 
 namespace App\Framework\Console;
 
+use App\Framework\Console\Ansi\AnsiSequenceGenerator;
+use App\Framework\Console\Ansi\LinkFormatter;
+use App\Framework\Console\Animation\Animation;
+use App\Framework\Console\Animation\AnimationFactory;
+use App\Framework\Console\Animation\AnimationManager;
 use App\Framework\Console\Screen\Cursor;
 use App\Framework\Console\Screen\Display;
 use App\Framework\Console\Screen\ScreenManager;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+use App\Framework\Console\Terminal\WindowTitleManager;
+use App\Framework\Console\ValueObjects\TerminalStream;
 
+/**
+ * Refactored ConsoleOutput - simplified and delegates to specialized classes.
+ * Uses TextWriter for text output, WindowTitleManager for titles, and InteractivePrompter for prompts.
+ */
 final readonly class ConsoleOutput implements ConsoleOutputInterface
 {
     public Cursor $cursor;
@@ -16,8 +28,30 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
 
     public ScreenManager $screen;
 
+    private TextWriter $textWriter;
+
+    private WindowTitleManager $titleManager;
+
+    private InteractivePrompter $prompter;
+
+    private TerminalCapabilities $capabilities;
+
+    private AnsiSequenceGenerator $ansiGenerator;
+
+    private LinkFormatter $linkFormatter;
+
+    private AnimationManager $animationManager;
+
     public function __construct()
     {
+        $this->capabilities = new TerminalCapabilities();
+        $this->ansiGenerator = new AnsiSequenceGenerator();
+        $this->animationManager = new AnimationManager();
+        $this->textWriter = new TextWriter($this->ansiGenerator, $this->capabilities, $this->animationManager);
+        $this->titleManager = new WindowTitleManager($this->ansiGenerator, $this->capabilities);
+        $this->linkFormatter = new LinkFormatter($this->ansiGenerator, $this->capabilities);
+        $this->prompter = new InteractivePrompter($this, $this->textWriter);
+
         $this->cursor = new Cursor($this);
         $this->display = new Display($this);
         $this->screen = new ScreenManager($this);
@@ -28,14 +62,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function write(string $message, ConsoleStyle|ConsoleColor|null $style = null): void
     {
-        if ($style instanceof ConsoleColor) {
-            // Abwärtskompatibilität
-            echo $style->toAnsi() . $message . ConsoleColor::RESET->toAnsi();
-        } elseif ($style instanceof ConsoleStyle) {
-            echo $style->apply($message);
-        } else {
-            echo $message;
-        }
+        $this->textWriter->write($message, $style);
     }
 
     /**
@@ -43,7 +70,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeRaw(string $raw): void
     {
-        echo $raw;
+        $this->textWriter->writeRaw($raw);
     }
 
     /**
@@ -51,13 +78,12 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeWindowTitle(string $title, int $mode = 0): void
     {
-        // Only emit terminal escape sequences when output goes to a real terminal
-        // Skip for pipes, redirects, MCP mode, Claude Code execution, and any programmatic use
-        if (!$this->isTerminal()) {
-            return;
-        }
-
-        $this->writeRaw("\033]$mode;{$title}\007");
+        $oscMode = match($mode) {
+            1 => \App\Framework\Console\Terminal\OscMode::ICON,
+            2 => \App\Framework\Console\Terminal\OscMode::TITLE,
+            default => \App\Framework\Console\Terminal\OscMode::BOTH,
+        };
+        $this->titleManager->setTitle($title, $oscMode);
     }
 
     /**
@@ -65,7 +91,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeLine(string $message = '', ConsoleStyle|ConsoleColor|null $color = null): void
     {
-        $this->write($message . PHP_EOL, $color);
+        $this->textWriter->writeLine($message, $color);
     }
 
     /**
@@ -73,7 +99,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeSuccess(string $message): void
     {
-        $this->writeLine('✓ ' . $message, ConsoleStyle::success());
+        $this->textWriter->writeSuccess($message);
     }
 
     /**
@@ -81,7 +107,16 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeError(string $message): void
     {
-        $this->writeLine('✗ ' . $message, ConsoleStyle::error());
+        $this->textWriter->writeError($message);
+    }
+
+    /**
+     * Schreibt eine Fehlerzeile zu stderr.
+     * Sollte für Fehlerausgaben verwendet werden, um sie von normaler Ausgabe zu trennen.
+     */
+    public function writeErrorLine(string $message, ConsoleStyle|ConsoleColor|null $style = null): void
+    {
+        $this->textWriter->writeLineToStderr($message, $style);
     }
 
     /**
@@ -89,7 +124,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeWarning(string $message): void
     {
-        $this->writeLine('⚠ ' . $message, ConsoleStyle::warning());
+        $this->textWriter->writeWarning($message);
     }
 
     /**
@@ -97,7 +132,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function writeInfo(string $message): void
     {
-        $this->writeLine('ℹ ' . $message, ConsoleStyle::info());
+        $this->textWriter->writeInfo($message);
     }
 
     /**
@@ -105,7 +140,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function newLine(int $count = 1): void
     {
-        echo str_repeat(PHP_EOL, $count);
+        $this->textWriter->newLine($count);
     }
 
     /**
@@ -113,17 +148,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function askQuestion(string $question, ?string $default = null): string
     {
-        $prompt = $question;
-        if ($default !== null) {
-            $prompt .= " [{$default}]";
-        }
-        $prompt .= ': ';
-
-        $this->write($prompt, ConsoleColor::BRIGHT_CYAN);
-
-        $answer = trim(fgets(STDIN));
-
-        return $answer === '' && $default !== null ? $default : $answer;
+        return $this->prompter->askQuestion($question, $default);
     }
 
     /**
@@ -131,14 +156,7 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function confirm(string $question, bool $default = false): bool
     {
-        $defaultText = $default ? 'Y/n' : 'y/N';
-        $answer = $this->askQuestion("{$question} [{$defaultText}]");
-
-        if ($answer === '') {
-            return $default;
-        }
-
-        return in_array(strtolower($answer), ['y', 'yes', 'ja', '1', 'true']);
+        return $this->prompter->confirm($question, $default);
     }
 
     /**
@@ -146,6 +164,99 @@ final readonly class ConsoleOutput implements ConsoleOutputInterface
      */
     public function isTerminal(): bool
     {
-        return function_exists('posix_isatty') && posix_isatty(STDOUT);
+        return $this->capabilities->isTerminal();
+    }
+
+    /**
+     * Get terminal capabilities
+     */
+    public function getCapabilities(): TerminalCapabilities
+    {
+        return $this->capabilities;
+    }
+
+    /**
+     * Get ANSI sequence generator
+     */
+    public function getAnsiGenerator(): AnsiSequenceGenerator
+    {
+        return $this->ansiGenerator;
+    }
+
+    /**
+     * Get link formatter
+     */
+    public function getLinkFormatter(): LinkFormatter
+    {
+        return $this->linkFormatter;
+    }
+
+    /**
+     * Get window title manager
+     */
+    public function getTitleManager(): WindowTitleManager
+    {
+        return $this->titleManager;
+    }
+
+    /**
+     * Animate text with a fade-in effect
+     */
+    public function animateFadeIn(string $text, float $duration = 1.0): void
+    {
+        $animation = AnimationFactory::fadeIn($duration);
+        $this->textWriter->animateText($text, $animation);
+    }
+
+    /**
+     * Animate text with a fade-out effect
+     */
+    public function animateFadeOut(string $text, float $duration = 1.0): void
+    {
+        $animation = AnimationFactory::fadeOut($duration);
+        $this->textWriter->animateText($text, $animation);
+    }
+
+    /**
+     * Animate text with typewriter effect
+     */
+    public function animateTypewriter(string $text, float $charactersPerSecond = 10.0): void
+    {
+        $animation = AnimationFactory::typewriter($text, $charactersPerSecond);
+        $this->textWriter->animateText($text, $animation);
+    }
+
+    /**
+     * Animate text with marquee effect
+     */
+    public function animateMarquee(string $text, int $width = 80, float $speed = 1.0): void
+    {
+        $animation = AnimationFactory::marquee($text, $width, $speed);
+        $this->textWriter->animateText($text, $animation);
+    }
+
+    /**
+     * Animate text with custom animation
+     */
+    public function animateText(string $text, Animation $animation): void
+    {
+        $this->textWriter->animateText($text, $animation);
+    }
+
+    /**
+     * Update all active animations
+     * Should be called periodically if animations are active
+     */
+    public function updateAnimations(float $deltaTime = 0.016): void
+    {
+        $this->textWriter->updateAnimations($deltaTime);
+    }
+
+    /**
+     * Get animation manager
+     */
+    public function getAnimationManager(): AnimationManager
+    {
+        return $this->animationManager;
     }
 }
diff --git a/src/Framework/Console/ConsoleStyle.php b/src/Framework/Console/ConsoleStyle.php
index b2e71e8f..54076509 100644
--- a/src/Framework/Console/ConsoleStyle.php
+++ b/src/Framework/Console/ConsoleStyle.php
@@ -4,12 +4,18 @@ declare(strict_types=1);
 
 namespace App\Framework\Console;
 
+use App\Framework\Console\Ansi\RgbColor;
+use App\Framework\Console\Ansi\TruecolorStyle;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+
 final readonly class ConsoleStyle
 {
     public function __construct(
         public ?ConsoleColor $color = null,
         public ?ConsoleFormat $format = null,
         public ?ConsoleColor $background = null,
+        public ?RgbColor $truecolorForeground = null,
+        public ?RgbColor $truecolorBackground = null,
     ) {
     }
 
@@ -24,6 +30,23 @@ final readonly class ConsoleStyle
         return new self($color, $format, $backgroundColor);
     }
 
+    /**
+     * Create style with truecolor support
+     */
+    public static function createTruecolor(
+        ?RgbColor $foreground = null,
+        ?RgbColor $background = null,
+        ?ConsoleFormat $format = null
+    ): self {
+        return new self(
+            color: null,
+            format: $format,
+            background: null,
+            truecolorForeground: $foreground,
+            truecolorBackground: $background
+        );
+    }
+
     public function toAnsi(): string
     {
         $codes = [];
@@ -60,6 +83,26 @@ final readonly class ConsoleStyle
         return $ansi . $text . ConsoleColor::RESET->toAnsi();
     }
 
+    /**
+     * Apply style with automatic truecolor support detection
+     * Falls back to standard colors if truecolor not supported
+     */
+    public function applyWithTruecolor(string $text, TerminalCapabilities $capabilities): string
+    {
+        // If truecolor is specified, use it
+        if ($this->truecolorForeground !== null || $this->truecolorBackground !== null) {
+            $truecolorStyle = new TruecolorStyle(
+                $this->truecolorForeground,
+                $this->truecolorBackground,
+                $this->format
+            );
+            return $truecolorStyle->apply($text, new \App\Framework\Console\Ansi\AnsiSequenceGenerator(), $capabilities);
+        }
+
+        // Otherwise use standard style
+        return $this->apply($text);
+    }
+
     // Vordefinierte Styles für häufige Anwendungen
     public static function success(): self
     {
diff --git a/src/Framework/Console/ErrorRecovery/ConsoleErrorHandler.php b/src/Framework/Console/ErrorRecovery/ConsoleErrorHandler.php
index b920b742..11ea8364 100644
--- a/src/Framework/Console/ErrorRecovery/ConsoleErrorHandler.php
+++ b/src/Framework/Console/ErrorRecovery/ConsoleErrorHandler.php
@@ -7,6 +7,7 @@ namespace App\Framework\Console\ErrorRecovery;
 use App\Framework\Console\ConsoleColor;
 use App\Framework\Console\ConsoleOutputInterface;
 use App\Framework\Console\ExitCode;
+use App\Framework\Console\Exceptions\ConsoleException;
 use App\Framework\Exception\Core\AuthErrorCode;
 use App\Framework\Exception\Core\ConsoleErrorCode;
 use App\Framework\Exception\Core\DatabaseErrorCode;
@@ -42,6 +43,12 @@ final readonly class ConsoleErrorHandler
             'trace' => $error->getTraceAsString(),
         ]);
 
+        if ($error instanceof ConsoleException) {
+            $this->recoveryService->handleCommandExecutionError($command, $error, $output);
+
+            return ExitCode::GENERAL_ERROR;
+        }
+
         if ($error instanceof FrameworkException) {
             return $this->handleFrameworkException($command, $error, $output);
         }
@@ -189,6 +196,10 @@ final readonly class ConsoleErrorHandler
 
     private function determineExitCode(\Throwable $error): ExitCode
     {
+        if ($error instanceof ConsoleException) {
+            return ExitCode::GENERAL_ERROR;
+        }
+
         if ($error instanceof FrameworkException) {
             return match ($error->getErrorCode()) {
                 ConsoleErrorCode::COMMAND_NOT_FOUND => ExitCode::COMMAND_NOT_FOUND,
diff --git a/src/Framework/Console/Examples/AnimationDemoCommand.php b/src/Framework/Console/Examples/AnimationDemoCommand.php
new file mode 100644
index 00000000..f1cacad3
--- /dev/null
+++ b/src/Framework/Console/Examples/AnimationDemoCommand.php
@@ -0,0 +1,156 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Examples;
+
+use App\Framework\Console\Animation\AnimationFactory;
+use App\Framework\Console\Animation\AnimationManager;
+use App\Framework\Console\Animation\EasingFunction;
+use App\Framework\Console\Animation\Types\SlideDirection;
+use App\Framework\Console\ConsoleCommand;
+use App\Framework\Console\ConsoleInput;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Console\ExitCode;
+
+/**
+ * Demo command for animation system
+ */
+final readonly class AnimationDemoCommand
+{
+    #[ConsoleCommand(name: 'demo:animation', description: 'Demonstrate animation system features')]
+    public function demoAnimation(ConsoleInput $input, ConsoleOutputInterface $output): ExitCode
+    {
+        $output->writeLine('🎬 Animation System Demo', \App\Framework\Console\ConsoleColor::BRIGHT_CYAN);
+        $output->writeLine(str_repeat('═', 60), \App\Framework\Console\ConsoleColor::GRAY);
+        $output->writeLine('');
+
+        // Create animation manager
+        $animationManager = $output instanceof ConsoleOutput ? $output->getAnimationManager() : new AnimationManager();
+
+        // Demo 1: Fade animations
+        $output->writeLine('1. Fade Animations:', \App\Framework\Console\ConsoleColor::BRIGHT_YELLOW);
+        $fadeIn = AnimationFactory::fadeIn(1.0);
+        $fadeIn->onComplete(function () use ($output) {
+            $output->writeLine('✓ Fade-in complete');
+        });
+        $animationManager->add($fadeIn);
+        $fadeIn->start();
+
+        // Simulate animation progress
+        $this->simulateAnimation($animationManager, 1.0);
+        $output->writeLine('');
+
+        // Demo 2: Typewriter animation
+        $output->writeLine('2. Typewriter Animation:', \App\Framework\Console\ConsoleColor::BRIGHT_YELLOW);
+        $typewriter = AnimationFactory::typewriter('Hello, this is a typewriter animation!', 15.0);
+        $animationManager->add($typewriter);
+        $typewriter->start();
+        $this->simulateTypewriter($animationManager, $typewriter, $output);
+        $output->writeLine('');
+
+        // Demo 3: Marquee animation
+        $output->writeLine('3. Marquee Animation:', \App\Framework\Console\ConsoleColor::BRIGHT_YELLOW);
+        $marquee = AnimationFactory::marquee('This is a scrolling marquee text that moves continuously', 50, 2.0);
+        $animationManager->add($marquee);
+        $marquee->start();
+        $this->simulateMarquee($animationManager, $marquee, $output, 3.0);
+        $output->writeLine('');
+
+        // Demo 4: Pulse animation
+        $output->writeLine('4. Pulse Animation:', \App\Framework\Console\ConsoleColor::BRIGHT_YELLOW);
+        $pulse = AnimationFactory::pulse(1.0, 1.0, 1.3, 2.0);
+        $pulse->start();
+        $animationManager->add($pulse);
+        $this->simulateAnimation($animationManager, 2.0);
+        $output->writeLine('');
+
+        // Demo 5: Slide animation
+        $output->writeLine('5. Slide Animation:', \App\Framework\Console\ConsoleColor::BRIGHT_YELLOW);
+        $slide = AnimationFactory::slideInFromLeft(20, 1.0, EasingFunction::EASE_OUT);
+        $slide->start();
+        $animationManager->add($slide);
+        $this->simulateAnimation($animationManager, 1.0);
+        $output->writeLine('');
+
+        $output->writeLine('✅ All animation demos completed!', \App\Framework\Console\ConsoleColor::BRIGHT_GREEN);
+
+        return ExitCode::SUCCESS;
+    }
+
+    /**
+     * Simulate animation updates
+     */
+    private function simulateAnimation(AnimationManager $manager, float $duration): void
+    {
+        $startTime = microtime(true);
+        $lastUpdate = $startTime;
+
+        while (microtime(true) - $startTime < $duration) {
+            $currentTime = microtime(true);
+            $deltaTime = $currentTime - $lastUpdate;
+            $lastUpdate = $currentTime;
+
+            $manager->update($deltaTime);
+            usleep(16000); // ~60 FPS
+        }
+    }
+
+    /**
+     * Simulate typewriter animation with output
+     */
+    private function simulateTypewriter(AnimationManager $manager, $typewriter, ConsoleOutput $output): void
+    {
+        $startTime = microtime(true);
+        $lastUpdate = $startTime;
+        $lastText = '';
+
+        while (!$typewriter->isComplete()) {
+            $currentTime = microtime(true);
+            $deltaTime = $currentTime - $lastUpdate;
+            $lastUpdate = $currentTime;
+
+            $manager->update($deltaTime);
+
+            $currentText = $typewriter->getText();
+            if ($currentText !== $lastText) {
+                $output->write("\r" . str_repeat(' ', 60) . "\r"); // Clear line
+                $output->write($currentText . '_'); // Cursor
+                $lastText = $currentText;
+            }
+
+            usleep(16000); // ~60 FPS
+        }
+
+        $output->writeLine(''); // New line after completion
+    }
+
+    /**
+     * Simulate marquee animation with output
+     */
+    private function simulateMarquee(AnimationManager $manager, $marquee, ConsoleOutput $output, float $duration): void
+    {
+        $startTime = microtime(true);
+        $lastUpdate = $startTime;
+        $lastText = '';
+
+        while (microtime(true) - $startTime < $duration) {
+            $currentTime = microtime(true);
+            $deltaTime = $currentTime - $lastUpdate;
+            $lastUpdate = $currentTime;
+
+            $manager->update($deltaTime);
+
+            $currentText = $marquee->getDisplayText();
+            if ($currentText !== $lastText) {
+                $output->write("\r" . $currentText);
+                $lastText = $currentText;
+            }
+
+            usleep(16000); // ~60 FPS
+        }
+
+        $output->writeLine(''); // New line after completion
+    }
+}
+
diff --git a/src/Framework/Console/Exceptions/CommandExecutionException.php b/src/Framework/Console/Exceptions/CommandExecutionException.php
new file mode 100644
index 00000000..dc8019e1
--- /dev/null
+++ b/src/Framework/Console/Exceptions/CommandExecutionException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Exceptions;
+
+final class CommandExecutionException extends ConsoleException
+{
+    public function __construct(string $commandName, \Throwable $previous)
+    {
+        parent::__construct("Ausführung des Kommandos '{$commandName}' fehlgeschlagen: {$previous->getMessage()}", 0, $previous);
+    }
+}
+
diff --git a/src/Framework/Console/Exceptions/CommandMetadataNotFoundException.php b/src/Framework/Console/Exceptions/CommandMetadataNotFoundException.php
new file mode 100644
index 00000000..426a27ab
--- /dev/null
+++ b/src/Framework/Console/Exceptions/CommandMetadataNotFoundException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console.Exceptions;
+
+final class CommandMetadataNotFoundException extends ConsoleException
+{
+    public function __construct(string $commandName)
+    {
+        parent::__construct("Metadaten für Kommando '{$commandName}' wurden nicht gefunden.");
+    }
+}
+
diff --git a/src/Framework/Console/Exceptions/ConsoleInitializationException.php b/src/Framework/Console/Exceptions/ConsoleInitializationException.php
new file mode 100644
index 00000000..db0298f0
--- /dev/null
+++ b/src/Framework/Console/Exceptions/ConsoleInitializationException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Exceptions;
+
+final class ConsoleInitializationException extends ConsoleException
+{
+    public function __construct(string $message, \Throwable $previous)
+    {
+        parent::__construct($message, 0, $previous);
+    }
+}
+
diff --git a/src/Framework/Console/Exceptions/DuplicateCommandException.php b/src/Framework/Console/Exceptions/DuplicateCommandException.php
new file mode 100644
index 00000000..9803f94a
--- /dev/null
+++ b/src/Framework/Console/Exceptions/DuplicateCommandException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Exceptions;
+
+final class DuplicateCommandException extends ConsoleException
+{
+    public function __construct(string $commandName)
+    {
+        parent::__construct("Kommando '{$commandName}' ist bereits registriert.");
+    }
+}
+
diff --git a/src/Framework/Console/Exceptions/InvalidCommandConfigurationException.php b/src/Framework/Console/Exceptions/InvalidCommandConfigurationException.php
new file mode 100644
index 00000000..b830fb30
--- /dev/null
+++ b/src/Framework/Console/Exceptions/InvalidCommandConfigurationException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Exceptions;
+
+final class InvalidCommandConfigurationException extends ConsoleException
+{
+    public function __construct(string $commandName, string $className, string $methodName)
+    {
+        parent::__construct("Ungültige Kommando-Konfiguration für '{$commandName}' ({$className}::{$methodName}).");
+    }
+}
+
diff --git a/src/Framework/Console/InteractivePrompter.php b/src/Framework/Console/InteractivePrompter.php
new file mode 100644
index 00000000..4d4f5120
--- /dev/null
+++ b/src/Framework/Console/InteractivePrompter.php
@@ -0,0 +1,175 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console;
+
+use App\Framework\Console\Components\InteractiveMenu;
+use App\Framework\Console\ValueObjects\ChoiceOptions;
+use App\Framework\Console\ValueObjects\MenuOptions;
+
+/**
+ * Interactive prompts extracted from ConsoleOutput and ConsoleInput.
+ * Handles all interactive user input (ask, confirm, choice, menu, etc.)
+ */
+final readonly class InteractivePrompter
+{
+    public function __construct(
+        private ConsoleOutputInterface $output,
+        private TextWriter $textWriter
+    ) {
+    }
+
+    /**
+     * Ask a question and wait for user input
+     */
+    public function askQuestion(string $question, ?string $default = null): string
+    {
+        $prompt = $question;
+        if ($default !== null) {
+            $prompt .= " [{$default}]";
+        }
+        $prompt .= ': ';
+
+        $this->textWriter->write($prompt, ConsoleColor::BRIGHT_CYAN);
+
+        $answer = trim(fgets(STDIN) ?: '');
+
+        return $answer === '' && $default !== null ? $default : $answer;
+    }
+
+    /**
+     * Ask for password (hidden input)
+     */
+    public function askPassword(string $question): string
+    {
+        $this->textWriter->write($question . ": ", ConsoleColor::BRIGHT_CYAN);
+
+        // Hide input
+        if (function_exists('system')) {
+            system('stty -echo');
+        }
+        
+        $password = trim(fgets(STDIN) ?: '');
+        
+        if (function_exists('system')) {
+            system('stty echo');
+        }
+        
+        $this->textWriter->newLine();
+
+        return $password;
+    }
+
+    /**
+     * Ask for confirmation (yes/no)
+     */
+    public function confirm(string $question, bool $default = false): bool
+    {
+        $defaultText = $default ? 'Y/n' : 'y/N';
+        $answer = $this->askQuestion("{$question} [{$defaultText}]");
+
+        if ($answer === '') {
+            return $default;
+        }
+
+        return in_array(strtolower($answer), ['y', 'yes', 'ja', '1', 'true'], true);
+    }
+
+    /**
+     * Show simple choice menu
+     */
+    public function choice(string $question, array $choices, mixed $default = null): mixed
+    {
+        $menuOptions = MenuOptions::fromArray($choices);
+        return $this->choiceFromOptions($question, $menuOptions, $default);
+    }
+
+    /**
+     * Present choices using MenuOptions Value Object
+     */
+    public function choiceFromOptions(string $question, MenuOptions $options, mixed $default = null): mixed
+    {
+        $menu = new InteractiveMenu($this->output);
+        $menu->setTitle($question);
+
+        foreach ($options as $option) {
+            if ($option->isSeparator()) {
+                $menu->addSeparator();
+            } else {
+                $menu->addItem($option->label, null, $option->key);
+            }
+        }
+
+        return $menu->showSimple();
+    }
+
+    /**
+     * Show interactive menu with arrow key navigation
+     */
+    public function menu(string $title, array $items): mixed
+    {
+        $menuOptions = MenuOptions::fromArray($items);
+        return $this->menuFromOptions($title, $menuOptions);
+    }
+
+    /**
+     * Show interactive menu using MenuOptions Value Object
+     */
+    public function menuFromOptions(string $title, MenuOptions $options): mixed
+    {
+        $menu = new InteractiveMenu($this->output);
+        $menu->setTitle($title);
+
+        foreach ($options as $option) {
+            if ($option->isSeparator()) {
+                $menu->addSeparator();
+            } else {
+                $menu->addItem($option->label, null, $option->key);
+            }
+        }
+
+        return $menu->showInteractive();
+    }
+
+    /**
+     * Multi-select from options
+     */
+    public function multiSelect(string $question, array $options): array
+    {
+        $choiceOptions = ChoiceOptions::fromArray($options);
+        $selected = $this->multiSelectFromOptions($question, $choiceOptions);
+
+        return $selected->getSelectedValues();
+    }
+
+    /**
+     * Multi-select using ChoiceOptions Value Object
+     */
+    public function multiSelectFromOptions(string $question, ChoiceOptions $options): ChoiceOptions
+    {
+        $this->textWriter->writeLine($question, ConsoleColor::BRIGHT_CYAN);
+        $this->textWriter->writeLine("Mehrfachauswahl mit Komma getrennt (z.B. 1,3,5):");
+
+        $displayOptions = $options->toArray();
+        foreach ($displayOptions as $key => $option) {
+            $this->textWriter->writeLine("  " . ($key + 1) . ": {$option->label}");
+        }
+
+        $this->textWriter->write("Ihre Auswahl: ", ConsoleColor::BRIGHT_CYAN);
+        $input = trim(fgets(STDIN) ?: '');
+
+        $selectedValues = [];
+        $indices = explode(',', $input);
+
+        foreach ($indices as $index) {
+            $index = (int)trim($index) - 1;
+            if (isset($displayOptions[$index])) {
+                $selectedValues[] = $displayOptions[$index]->value;
+            }
+        }
+
+        return $options->selectByValues($selectedValues);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Adapters/DisplayComponentAdapter.php b/src/Framework/Console/Layout/Adapters/DisplayComponentAdapter.php
new file mode 100644
index 00000000..6f1308f9
--- /dev/null
+++ b/src/Framework/Console/Layout/Adapters/DisplayComponentAdapter.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Adapters;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Adapter for using Display Components in Console Layouts
+ */
+final readonly class DisplayComponentAdapter
+{
+    public function __construct(
+        private ?ConsoleTheme $theme = null
+    ) {
+    }
+
+    /**
+     * Convert Display Component to layout content string
+     */
+    public function adapt(DisplayComponentInterface $component): string
+    {
+        // Only adapt console components
+        if ($component->getOutputFormat() !== OutputFormat::CONSOLE) {
+            throw new \InvalidArgumentException(
+                'Display Component must have CONSOLE output format to be used in layouts'
+            );
+        }
+
+        // Render the component
+        return $component->render();
+    }
+
+    /**
+     * Wrap Display Component in a Section
+     */
+    public function wrapInSection(
+        DisplayComponentInterface $component,
+        string $sectionTitle,
+        \App\Framework\Console\Layout\ValueObjects\SectionStyle $style = \App\Framework\Console\Layout\ValueObjects\SectionStyle::DEFAULT
+    ): \App\Framework\Console\Layout\Section {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $section = new \App\Framework\Console\Layout\Section($sectionTitle, $style, $theme);
+        $section->addContent($this->adapt($component));
+
+        return $section;
+    }
+
+    /**
+     * Wrap Display Component in a Panel
+     */
+    public function wrapInPanel(
+        DisplayComponentInterface $component,
+        string $panelTitle,
+        \App\Framework\Console\Layout\ValueObjects\PanelSize $size = \App\Framework\Console\Layout\ValueObjects\PanelSize::MEDIUM
+    ): \App\Framework\Console\Layout\Panel {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $panel = \App\Framework\Console\Layout\Panel::create($panelTitle, $size, $theme);
+        $panel->setContent($this->adapt($component));
+
+        return $panel;
+    }
+
+    /**
+     * Create adapter with theme
+     */
+    public static function create(?ConsoleTheme $theme = null): self
+    {
+        return new self($theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Adapters/ThemeMapper.php b/src/Framework/Console/Layout/Adapters/ThemeMapper.php
new file mode 100644
index 00000000..1522ff2f
--- /dev/null
+++ b/src/Framework/Console/Layout/Adapters/ThemeMapper.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Adapters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Maps Display Module themes to Console Layout themes
+ */
+final readonly class ThemeMapper
+{
+    /**
+     * Map Display ConsoleTheme to Layout ConsoleTheme (passthrough for now)
+     */
+    public static function mapTheme(ConsoleTheme $displayTheme): ConsoleTheme
+    {
+        // Display ConsoleTheme is already compatible with Layout ConsoleTheme
+        // This mapper exists for future extensibility
+        return $displayTheme;
+    }
+
+    /**
+     * Get default theme for layouts
+     */
+    public static function getDefaultTheme(): ConsoleTheme
+    {
+        return \App\Framework\Display\Themes\DefaultThemes::getConsoleTheme('default');
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Components/Footer.php b/src/Framework/Console/Layout/Components/Footer.php
new file mode 100644
index 00000000..edc0499b
--- /dev/null
+++ b/src/Framework/Console/Layout/Components/Footer.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Components;
+
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Footer component for page layouts
+ */
+final readonly class Footer
+{
+    public function __construct(
+        private string $content,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render the footer
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? \App\Framework\Display\Themes\DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        if ($showBorders) {
+            // Top border
+            $output[] = '╔' . str_repeat('═', $width - 2) . '╗';
+
+            // Content
+            $footerStyle = ConsoleStyle::create(color: $theme->metadataColor);
+            $contentPadded = str_pad($this->content, $width - 4);
+            $output[] = '║ ' . $footerStyle->apply($contentPadded) . ' ║';
+
+            // Bottom border
+            $output[] = '╚' . str_repeat('═', $width - 2) . '╝';
+        } else {
+            $footerStyle = ConsoleStyle::create(color: $theme->metadataColor);
+            $output[] = $footerStyle->apply($this->content);
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create footer
+     */
+    public static function create(string $content, ?ConsoleTheme $theme = null): self
+    {
+        return new self($content, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Components/Header.php b/src/Framework/Console/Layout/Components/Header.php
new file mode 100644
index 00000000..87a0bda2
--- /dev/null
+++ b/src/Framework/Console/Layout/Components/Header.php
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Components;
+
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Header component for page layouts
+ */
+final readonly class Header
+{
+    public function __construct(
+        private string $title,
+        private ?string $subtitle = null,
+        private ?ConsoleTheme $theme = null,
+        private array $meta = [],
+    ) {
+    }
+
+    /**
+     * Render the header
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? \App\Framework\Display\Themes\DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        if ($showBorders) {
+            // Top border
+            $output[] = '╔' . str_repeat('═', $width - 2) . '╗';
+
+            // Title
+            $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+            $titlePadded = str_pad($this->title, $width - 4);
+            $output[] = '║ ' . $titleStyle->apply($titlePadded) . ' ║';
+
+            // Subtitle (if provided)
+            if ($this->subtitle !== null) {
+                $subtitleStyle = ConsoleStyle::create(color: $theme->metadataColor);
+                $subtitlePadded = str_pad($this->subtitle, $width - 4);
+                $output[] = '║ ' . $subtitleStyle->apply($subtitlePadded) . ' ║';
+            }
+
+            // Meta information (if provided)
+            if (!empty($this->meta)) {
+                $metaStyle = ConsoleStyle::create(color: $theme->metadataColor);
+                $metaText = implode(' | ', $this->meta);
+                $metaPadded = str_pad($metaText, $width - 4);
+                $output[] = '║ ' . $metaStyle->apply($metaPadded) . ' ║';
+            }
+
+            // Bottom border
+            $output[] = '╚' . str_repeat('═', $width - 2) . '╝';
+        } else {
+            // No borders - just title and subtitle
+            $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+            $output[] = $titleStyle->apply($this->title);
+
+            if ($this->subtitle !== null) {
+                $subtitleStyle = ConsoleStyle::create(color: $theme->metadataColor);
+                $output[] = $subtitleStyle->apply($this->subtitle);
+            }
+
+            if (!empty($this->meta)) {
+                $metaStyle = ConsoleStyle::create(color: $theme->metadataColor);
+                $output[] = $metaStyle->apply(implode(' | ', $this->meta));
+            }
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create header with title
+     */
+    public static function create(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, null, $theme);
+    }
+
+    /**
+     * Create header with title and subtitle
+     */
+    public static function withSubtitle(string $title, string $subtitle, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, $subtitle, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Components/ProgressSection.php b/src/Framework/Console/Layout/Components/ProgressSection.php
new file mode 100644
index 00000000..479f5d8d
--- /dev/null
+++ b/src/Framework/Console/Layout/Components/ProgressSection.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Components;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Progress section component for layouts
+ */
+final readonly class ProgressSection
+{
+    public function __construct(
+        private string $label,
+        private float $progress, // 0.0 to 1.0
+        private ?string $status = null,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render progress section
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        $barWidth = $width - 20; // Reserve space for percentage and label
+        $filled = (int)round($barWidth * $this->progress);
+        $empty = $barWidth - $filled;
+
+        $bar = str_repeat('█', $filled) . str_repeat('░', $empty);
+        $percentage = (int)round($this->progress * 100);
+
+        $labelStyle = ConsoleStyle::create(color: $theme->valueColor);
+        $barStyle = ConsoleStyle::create(color: $theme->numberColor);
+        $percentageStyle = ConsoleStyle::create(color: $theme->infoColor);
+
+        $progressLine = sprintf(
+            '%s [%s] %d%%',
+            $labelStyle->apply(str_pad($this->label, 15)),
+            $barStyle->apply($bar),
+            $percentage
+        );
+
+        if ($this->status !== null) {
+            $statusStyle = ConsoleStyle::create(color: $theme->metadataColor);
+            $progressLine .= ' ' . $statusStyle->apply($this->status);
+        }
+
+        if ($showBorders) {
+            $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+            $output[] = '│ ' . str_pad($progressLine, $width - 4) . ' │';
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        } else {
+            $output[] = $progressLine;
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create progress section
+     */
+    public static function create(string $label, float $progress, ?string $status = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, $progress, $status, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Components/Sidebar.php b/src/Framework/Console/Layout/Components/Sidebar.php
new file mode 100644
index 00000000..a3954bce
--- /dev/null
+++ b/src/Framework/Console/Layout/Components/Sidebar.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Components;
+
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Sidebar component for page layouts
+ */
+final readonly class Sidebar
+{
+    public function __construct(
+        private array $items,
+        private ?string $title = null,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render the sidebar
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? \App\Framework\Display\Themes\DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        if ($showBorders) {
+            // Top border
+            if ($this->title !== null) {
+                $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+                $titlePadded = str_pad($this->title, $width - 4);
+                $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+                $output[] = '│ ' . $titleStyle->apply($titlePadded) . ' │';
+                $output[] = '├' . str_repeat('─', $width - 2) . '┤';
+            } else {
+                $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+            }
+
+            // Items
+            $itemStyle = ConsoleStyle::create(color: $theme->valueColor);
+            foreach ($this->items as $item) {
+                $itemPadded = str_pad($item, $width - 4);
+                $output[] = '│ ' . $itemStyle->apply($itemPadded) . ' │';
+            }
+
+            // Bottom border
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        } else {
+            if ($this->title !== null) {
+                $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+                $output[] = $titleStyle->apply($this->title);
+            }
+
+            $itemStyle = ConsoleStyle::create(color: $theme->valueColor);
+            foreach ($this->items as $item) {
+                $output[] = $itemStyle->apply('  ' . $item);
+            }
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create sidebar
+     */
+    public static function create(array $items, ?string $title = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($items, $title, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Components/StatusIndicator.php b/src/Framework/Console/Layout/Components/StatusIndicator.php
new file mode 100644
index 00000000..5b1d9a25
--- /dev/null
+++ b/src/Framework/Console/Layout/Components/StatusIndicator.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Components;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Status indicator component
+ */
+final readonly class StatusIndicator
+{
+    public function __construct(
+        private string $label,
+        private StatusType $type,
+        private ?string $message = null,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render status indicator
+     */
+    public function render(int $width = 0, bool $showBorders = false): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $icon = $this->getIcon();
+        $color = $this->getColor($theme);
+
+        $iconStyle = ConsoleStyle::create(color: $color, format: ConsoleFormat::BOLD);
+        $labelStyle = ConsoleStyle::create(color: $theme->valueColor);
+
+        $output = $iconStyle->apply($icon) . ' ' . $labelStyle->apply($this->label);
+
+        if ($this->message !== null) {
+            $messageStyle = ConsoleStyle::create(color: $theme->metadataColor);
+            $output .= ' ' . $messageStyle->apply('(' . $this->message . ')');
+        }
+
+        return $output;
+    }
+
+    private function getIcon(): string
+    {
+        return match ($this->type) {
+            StatusType::SUCCESS => '✓',
+            StatusType::ERROR => '✗',
+            StatusType::WARNING => '⚠',
+            StatusType::INFO => 'ℹ',
+            StatusType::PENDING => '…',
+            StatusType::LOADING => '⟳',
+        };
+    }
+
+    private function getColor(ConsoleTheme $theme): ConsoleColor
+    {
+        return match ($this->type) {
+            StatusType::SUCCESS => ConsoleColor::GREEN,
+            StatusType::ERROR => $theme->errorColor,
+            StatusType::WARNING => $theme->warningColor,
+            StatusType::INFO => $theme->infoColor,
+            StatusType::PENDING => ConsoleColor::GRAY,
+            StatusType::LOADING => ConsoleColor::CYAN,
+        };
+    }
+
+    /**
+     * Create success indicator
+     */
+    public static function success(string $label, ?string $message = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, StatusType::SUCCESS, $message, $theme);
+    }
+
+    /**
+     * Create error indicator
+     */
+    public static function error(string $label, ?string $message = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, StatusType::ERROR, $message, $theme);
+    }
+
+    /**
+     * Create warning indicator
+     */
+    public static function warning(string $label, ?string $message = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, StatusType::WARNING, $message, $theme);
+    }
+
+    /**
+     * Create info indicator
+     */
+    public static function info(string $label, ?string $message = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, StatusType::INFO, $message, $theme);
+    }
+
+    /**
+     * Create status indicator
+     */
+    public static function create(string $label, StatusType $type, ?string $message = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($label, $type, $message, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/DashboardLayout.php b/src/Framework/Console/Layout/DashboardLayout.php
new file mode 100644
index 00000000..6bd6faf2
--- /dev/null
+++ b/src/Framework/Console/Layout/DashboardLayout.php
@@ -0,0 +1,152 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\ValueObjects\GridConfig;
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+use App\Framework\Console\Layout\ValueObjects\PanelSize;
+
+/**
+ * Multi-panel grid layout for dashboard-style outputs
+ */
+final class DashboardLayout extends LayoutContainer
+{
+    private array $panels = [];
+    private ?GridConfig $gridConfig = null;
+
+    public function __construct(
+        ?TerminalSize $customTerminalSize = null,
+        ?LayoutOptions $options = null,
+        ?GridConfig $gridConfig = null
+    ) {
+        parent::__construct($customTerminalSize, $options);
+        $this->gridConfig = $gridConfig ?? ($this->isResponsive()
+            ? GridConfig::fromBreakpoint($this->terminalSize->getBreakpoint())
+            : new GridConfig(columns: 2));
+    }
+
+    /**
+     * Add a panel
+     */
+    public function addPanel(Panel $panel): self
+    {
+        $this->panels[] = $panel;
+        return $this;
+    }
+
+    /**
+     * Add panel with content callback
+     */
+    public function addPanelWithContent(string $title, PanelSize $size, callable $contentCallback): self
+    {
+        $panel = Panel::create($title, $size, $this->theme);
+        $content = $contentCallback($panel);
+        $panel->setContent(is_string($content) ? $content : '');
+        $this->panels[] = $panel;
+        return $this;
+    }
+
+    /**
+     * Render the dashboard layout
+     */
+    public function render(): string
+    {
+        $width = $this->getEffectiveWidth();
+        $columns = $this->gridConfig->columns;
+        $gap = $this->gridConfig->gap;
+
+        if (empty($this->panels)) {
+            return '';
+        }
+
+        // Group panels by rows
+        $rows = [];
+        $currentRow = [];
+        $currentRowSpan = 0;
+
+        foreach ($this->panels as $panel) {
+            $panelSpan = $panel->getSize()->getColumnSpan($columns);
+            $totalSpan = $currentRowSpan + $panelSpan;
+
+            if ($totalSpan > $columns || empty($currentRow)) {
+                if (!empty($currentRow)) {
+                    $rows[] = $currentRow;
+                }
+                $currentRow = [$panel];
+                $currentRowSpan = $panelSpan;
+            } else {
+                $currentRow[] = $panel;
+                $currentRowSpan = $totalSpan;
+            }
+        }
+
+        if (!empty($currentRow)) {
+            $rows[] = $currentRow;
+        }
+
+        // Render rows
+        $output = [];
+        foreach ($rows as $row) {
+            $rowOutput = $this->renderRow($row, $width, $columns, $gap);
+            $output[] = $rowOutput;
+            $output[] = ''; // Space between rows
+        }
+
+        return implode("\n", $output);
+    }
+
+    private function renderRow(array $panels, int $totalWidth, int $columns, int $gap): string
+    {
+        $columnWidth = $this->gridConfig->getColumnWidth($totalWidth, 1);
+        $panelOutputs = [];
+
+        foreach ($panels as $panel) {
+            $panelSpan = $panel->getSize()->getColumnSpan($columns);
+            $panelWidth = $this->gridConfig->getColumnWidth($totalWidth, $panelSpan);
+            $panelOutputs[] = $panel->render($panelWidth, $this->options->showBorders);
+        }
+
+        // Combine panels horizontally
+        return $this->combinePanelsHorizontally($panelOutputs, $gap);
+    }
+
+    private function combinePanelsHorizontally(array $panelOutputs, int $gap): string
+    {
+        if (count($panelOutputs) === 1) {
+            return $panelOutputs[0];
+        }
+
+        // Split each panel into lines
+        $panelLines = [];
+        $maxLines = 0;
+
+        foreach ($panelOutputs as $panelOutput) {
+            $lines = explode("\n", $panelOutput);
+            $panelLines[] = $lines;
+            $maxLines = max($maxLines, count($lines));
+        }
+
+        // Combine lines
+        $combined = [];
+        for ($i = 0; $i < $maxLines; $i++) {
+            $lineParts = [];
+            foreach ($panelLines as $lines) {
+                $lineParts[] = $lines[$i] ?? str_repeat(' ', mb_strlen($lines[0] ?? ''));
+            }
+            $combined[] = implode(str_repeat(' ', $gap), $lineParts);
+        }
+
+        return implode("\n", $combined);
+    }
+
+    /**
+     * Create dashboard layout
+     */
+    public static function create(?TerminalSize $terminalSize = null, ?LayoutOptions $options = null, ?GridConfig $gridConfig = null): self
+    {
+        return new self($terminalSize, $options, $gridConfig);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Examples/LayoutExamples.php b/src/Framework/Console/Layout/Examples/LayoutExamples.php
new file mode 100644
index 00000000..dc348ed2
--- /dev/null
+++ b/src/Framework/Console/Layout/Examples/LayoutExamples.php
@@ -0,0 +1,134 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Examples;
+
+use App\Framework\Console\Layout\DashboardLayout;
+use App\Framework\Console\Layout\LayoutFactory;
+use App\Framework\Console\Layout\PageLayout;
+use App\Framework\Console\Layout\Section;
+use App\Framework\Console\Layout\SectionLayout;
+use App\Framework\Console\Layout\SimpleLayout;
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+use App\Framework\Console\Layout\ValueObjects\PanelSize;
+use App\Framework\Console\Layout\ValueObjects\SectionStyle;
+use App\Framework\Display\Components\ComponentFactory;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Examples demonstrating Console Layout usage
+ */
+final readonly class LayoutExamples
+{
+    /**
+     * Example 1: PageLayout with Sections
+     */
+    public static function pageLayoutExample(): string
+    {
+        $layout = LayoutFactory::create()->createPageLayout()
+            ->withHeader('System Status', 'v1.0.0', ['Last updated: ' . date('Y-m-d H:i:s')])
+            ->withSidebar(['Commands', 'Health', 'Metrics', 'Settings'])
+            ->addSection(
+                Section::create('System Health')
+                    ->addContent('CPU: 45%')
+                    ->addContent('Memory: 2.1GB / 8GB')
+                    ->addContent('Disk: 120GB / 500GB')
+            )
+            ->addSection(
+                Section::info('Database Status')
+                    ->addContent('Connected: Yes')
+                    ->addContent('Queries: 1,234')
+                    ->addContent('Response Time: 12ms')
+            )
+            ->withFooter('System running normally');
+
+        return $layout->render();
+    }
+
+    /**
+     * Example 2: SectionLayout with multiple sections
+     */
+    public static function sectionLayoutExample(): string
+    {
+        $layout = LayoutFactory::create()->createSectionLayout()
+            ->addSection(
+                Section::success('Completed Tasks')
+                    ->addContent('Task 1: Done')
+                    ->addContent('Task 2: Done')
+                    ->addContent('Task 3: Done')
+            )
+            ->addSection(
+                Section::warning('Pending Tasks')
+                    ->addContent('Task 4: In Progress')
+                    ->addContent('Task 5: Waiting')
+            )
+            ->addSection(
+                Section::error('Failed Tasks')
+                    ->addContent('Task 6: Error - Connection timeout')
+            );
+
+        return $layout->render();
+    }
+
+    /**
+     * Example 3: DashboardLayout with Display Components
+     */
+    public static function dashboardLayoutExample(): string
+    {
+        $displayOptions = DisplayOptions::default();
+
+        $layout = LayoutFactory::create()->createDashboardLayout()
+            ->addPanelWithContent('Stats', PanelSize::MEDIUM, function ($panel) use ($displayOptions) {
+                $stats = ComponentFactory::createStats(OutputFormat::CONSOLE, $displayOptions, 150, 'Users');
+                return $stats->render();
+            })
+            ->addPanelWithContent('Recent Activity', PanelSize::LARGE, function ($panel) use ($displayOptions) {
+                $table = ComponentFactory::createTable(OutputFormat::CONSOLE, $displayOptions);
+                $table->setHeaders(['Time', 'Action', 'User']);
+                $table->setRows([
+                    ['10:30', 'Login', 'admin'],
+                    ['10:25', 'Update', 'user1'],
+                    ['10:20', 'Create', 'user2'],
+                ]);
+                return $table->render();
+            })
+            ->addPanelWithContent('Status', PanelSize::SMALL, function ($panel) {
+                return '✓ All systems operational';
+            });
+
+        return $layout->render();
+    }
+
+    /**
+     * Example 4: SimpleLayout
+     */
+    public static function simpleLayoutExample(): string
+    {
+        $layout = LayoutFactory::create()->createSimpleLayout()
+            ->addContent('Welcome to the Console Layout System!')
+            ->addContent('')
+            ->addContent('This is a simple container layout.')
+            ->addContent('Perfect for basic use cases.');
+
+        return $layout->render();
+    }
+
+    /**
+     * Example 5: Layout without borders
+     */
+    public static function noBordersExample(): string
+    {
+        $options = LayoutOptions::withoutBorders();
+        $layout = LayoutFactory::create()->createSectionLayout($options)
+            ->addSection(
+                Section::create('Clean Layout')
+                    ->addContent('This layout has no borders')
+                    ->addContent('Great for minimalist designs')
+            );
+
+        return $layout->render();
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Helpers/DisplayComponentHelper.php b/src/Framework/Console/Layout/Helpers/DisplayComponentHelper.php
new file mode 100644
index 00000000..75a9f401
--- /dev/null
+++ b/src/Framework/Console/Layout/Helpers/DisplayComponentHelper.php
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Helpers;
+
+use App\Framework\Console\Layout\Adapters\DisplayComponentAdapter;
+use App\Framework\Console\Layout\Panel;
+use App\Framework\Console\Layout\Section;
+use App\Framework\Console\Layout\ValueObjects\PanelSize;
+use App\Framework\Console\Layout\ValueObjects\SectionStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Helper methods for easy integration of Display Components in Layouts
+ */
+final readonly class DisplayComponentHelper
+{
+    public function __construct(
+        private ?ConsoleTheme $theme = null
+    ) {
+    }
+
+    /**
+     * Create a Section from a Display Component
+     */
+    public function createSection(
+        DisplayComponentInterface $component,
+        string $title,
+        SectionStyle $style = SectionStyle::DEFAULT
+    ): Section {
+        $adapter = DisplayComponentAdapter::create($this->theme);
+        return $adapter->wrapInSection($component, $title, $style);
+    }
+
+    /**
+     * Create a Panel from a Display Component
+     */
+    public function createPanel(
+        DisplayComponentInterface $component,
+        string $title,
+        PanelSize $size = PanelSize::MEDIUM
+    ): Panel {
+        $adapter = DisplayComponentAdapter::create($this->theme);
+        return $adapter->wrapInPanel($component, $title, $size);
+    }
+
+    /**
+     * Render a Display Component directly (for use in layouts)
+     */
+    public function render(DisplayComponentInterface $component): string
+    {
+        $adapter = DisplayComponentAdapter::create($this->theme);
+        return $adapter->adapt($component);
+    }
+
+    /**
+     * Create helper with theme
+     */
+    public static function create(?ConsoleTheme $theme = null): self
+    {
+        return new self($theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Interactive/CollapsibleSection.php b/src/Framework/Console/Layout/Interactive/CollapsibleSection.php
new file mode 100644
index 00000000..6cbd631c
--- /dev/null
+++ b/src/Framework/Console/Layout/Interactive/CollapsibleSection.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Interactive;
+
+use App\Framework\Console\Layout\Section;
+use App\Framework\Console\Layout\ValueObjects\SectionStyle;
+
+/**
+ * Collapsible section wrapper
+ * 
+ * Note: This is a convenience wrapper. Sections can be made collapsible directly
+ * by setting the collapsible parameter in the Section constructor.
+ */
+final class CollapsibleSection
+{
+    public function __construct(
+        private Section $section,
+        private bool $collapsed = false
+    ) {
+    }
+
+    /**
+     * Set collapsed state
+     */
+    public function setCollapsed(bool $collapsed): self
+    {
+        $this->collapsed = $collapsed;
+        $this->section->setCollapsed($collapsed);
+        return $this;
+    }
+
+    /**
+     * Toggle collapsed state
+     */
+    public function toggle(): self
+    {
+        $this->collapsed = !$this->collapsed;
+        $this->section->setCollapsed($this->collapsed);
+        return $this;
+    }
+
+    /**
+     * Render the collapsible section
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $this->section->setCollapsed($this->collapsed);
+        return $this->section->render($width, $showBorders);
+    }
+
+    /**
+     * Get underlying section
+     */
+    public function getSection(): Section
+    {
+        return $this->section;
+    }
+
+    /**
+     * Check if section is collapsed
+     */
+    public function isCollapsed(): bool
+    {
+        return $this->collapsed;
+    }
+
+    /**
+     * Create collapsible section
+     */
+    public static function create(string $title, \App\Framework\Console\Layout\ValueObjects\SectionStyle $style = \App\Framework\Console\Layout\ValueObjects\SectionStyle::DEFAULT, bool $collapsed = false): self
+    {
+        $section = new Section($title, $style, null, true); // collapsible = true
+        $section->setCollapsed($collapsed);
+        return new self($section, $collapsed);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Interactive/Tabs.php b/src/Framework/Console/Layout/Interactive/Tabs.php
new file mode 100644
index 00000000..f11ea433
--- /dev/null
+++ b/src/Framework/Console/Layout/Interactive/Tabs.php
@@ -0,0 +1,102 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Interactive;
+
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Tab navigation component
+ */
+final readonly class Tabs
+{
+    private string $activeTab;
+    /**
+     * @param array<string, string> $tabs Tab name => content
+     */
+    public function __construct(
+        private array $tabs,
+        string $activeTab = '',
+        private ?ConsoleTheme $theme = null,
+    ) {
+        if (empty($this->activeTab) && !empty($this->tabs)) {
+            $this->activeTab = array_key_first($this->tabs);
+        }
+    }
+
+    /**
+     * Render tabs
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        // Tab headers
+        $tabHeaders = [];
+        $tabWidth = (int)($width / count($this->tabs));
+
+        foreach ($this->tabs as $tabName => $content) {
+            $isActive = $tabName === $this->activeTab;
+            $style = $isActive
+                ? ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD)
+                : ConsoleStyle::create(color: $theme->valueColor);
+
+            $tabText = str_pad($tabName, $tabWidth - 2);
+            $tabHeaders[] = $style->apply($isActive ? '▶ ' . $tabText : '  ' . $tabText);
+        }
+
+        if ($showBorders) {
+            $output[] = '┌' . implode('', array_map(fn($h) => str_repeat('─', $tabWidth - 2), $tabHeaders)) . '┐';
+            $output[] = '│' . implode('│', $tabHeaders) . '│';
+            $output[] = '├' . str_repeat('─', $width - 2) . '┤';
+        } else {
+            $output[] = implode(' | ', $tabHeaders);
+        }
+
+        // Active tab content
+        if (isset($this->tabs[$this->activeTab])) {
+            $content = $this->tabs[$this->activeTab];
+            $contentLines = explode("\n", $content);
+
+            foreach ($contentLines as $line) {
+                if ($showBorders) {
+                    $output[] = '│ ' . str_pad($line, $width - 4) . ' │';
+                } else {
+                    $output[] = $line;
+                }
+            }
+        }
+
+        if ($showBorders) {
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Set active tab
+     */
+    public function setActiveTab(string $tabName): Tabs
+    {
+        if (!isset($this->tabs[$tabName])) {
+            throw new \InvalidArgumentException("Tab '{$tabName}' does not exist");
+        }
+
+        return new Tabs($this->tabs, $tabName, $this->theme);
+    }
+
+    /**
+     * Create tabs
+     */
+    public static function create(array $tabs, string $activeTab = '', ?ConsoleTheme $theme = null): self
+    {
+        return new self($tabs, $activeTab, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/LayoutContainer.php b/src/Framework/Console/Layout/LayoutContainer.php
new file mode 100644
index 00000000..0386e5a5
--- /dev/null
+++ b/src/Framework/Console/Layout/LayoutContainer.php
@@ -0,0 +1,211 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Base container for all console layouts
+ */
+abstract class LayoutContainer implements LayoutInterface
+{
+    protected TerminalSize $terminalSize;
+    protected LayoutOptions $options;
+    protected ConsoleTheme $theme;
+
+    public function __construct(
+        protected ?TerminalSize $customTerminalSize = null,
+        ?LayoutOptions $options = null
+    ) {
+        $this->terminalSize = $this->customTerminalSize ?? TerminalSize::detect();
+        $this->options = $options ?? LayoutOptions::default();
+        $this->theme = $this->options->theme ?? DefaultThemes::getConsoleTheme('default');
+    }
+
+    public function getTerminalSize(): TerminalSize
+    {
+        return $this->terminalSize;
+    }
+
+    public function getOptions(): LayoutOptions
+    {
+        return $this->options;
+    }
+
+    public function getTheme(): ConsoleTheme
+    {
+        return $this->theme;
+    }
+
+    /**
+     * Get effective width for layout (considering padding and margins)
+     */
+    protected function getEffectiveWidth(): int
+    {
+        $width = $this->options->width > 0
+            ? $this->options->width
+            : $this->terminalSize->getUsableWidth();
+
+        // Subtract margins and padding
+        $totalMargin = ($this->options->margin * 2);
+        $totalPadding = ($this->options->padding * 2);
+
+        return max(40, $width - $totalMargin - $totalPadding);
+    }
+
+    /**
+     * Get effective height for layout
+     */
+    protected function getEffectiveHeight(): int
+    {
+        return $this->terminalSize->getUsableHeight();
+    }
+
+    /**
+     * Check if layout should be responsive
+     */
+    protected function isResponsive(): bool
+    {
+        return $this->options->responsive;
+    }
+
+    /**
+     * Get border characters based on border style
+     */
+    protected function getBorderChars(): array
+    {
+        return match ($this->options->borderStyle) {
+            'double' => [
+                'top-left' => '╔',
+                'top-right' => '╗',
+                'bottom-left' => '╚',
+                'bottom-right' => '╝',
+                'horizontal' => '═',
+                'vertical' => '║',
+                'cross' => '╬',
+                'top-cross' => '╦',
+                'bottom-cross' => '╩',
+                'left-cross' => '╠',
+                'right-cross' => '╣',
+            ],
+            'rounded' => [
+                'top-left' => '╭',
+                'top-right' => '╮',
+                'bottom-left' => '╰',
+                'bottom-right' => '╯',
+                'horizontal' => '─',
+                'vertical' => '│',
+                'cross' => '┼',
+                'top-cross' => '┬',
+                'bottom-cross' => '┴',
+                'left-cross' => '├',
+                'right-cross' => '┤',
+            ],
+            'none' => [
+                'top-left' => '',
+                'top-right' => '',
+                'bottom-left' => '',
+                'bottom-right' => '',
+                'horizontal' => '',
+                'vertical' => '',
+                'cross' => '',
+                'top-cross' => '',
+                'bottom-cross' => '',
+                'left-cross' => '',
+                'right-cross' => '',
+            ],
+            default => [ // 'single'
+                'top-left' => '┌',
+                'top-right' => '┐',
+                'bottom-left' => '└',
+                'bottom-right' => '┘',
+                'horizontal' => '─',
+                'vertical' => '│',
+                'cross' => '┼',
+                'top-cross' => '┬',
+                'bottom-cross' => '┴',
+                'left-cross' => '├',
+                'right-cross' => '┤',
+            ],
+        };
+    }
+
+    /**
+     * Render a horizontal border line
+     */
+    protected function renderHorizontalBorder(string $left = '', string $right = '', ?string $middle = null): string
+    {
+        if (!$this->options->showBorders) {
+            return '';
+        }
+
+        $chars = $this->getBorderChars();
+        $width = $this->getEffectiveWidth();
+        $horizontal = str_repeat($chars['horizontal'], $width);
+
+        $leftChar = $left !== '' ? $left : $chars['horizontal'];
+        $rightChar = $right !== '' ? $right : $chars['horizontal'];
+
+        if ($middle !== null) {
+            $horizontal = $leftChar . $middle . $rightChar;
+        } else {
+            $horizontal = $leftChar . $horizontal . $rightChar;
+        }
+
+        return $horizontal;
+    }
+
+    /**
+     * Wrap content with padding
+     */
+    protected function wrapWithPadding(string $content): string
+    {
+        if ($this->options->padding === 0) {
+            return $content;
+        }
+
+        $padding = str_repeat(' ', $this->options->padding);
+        $lines = explode("\n", $content);
+        $wrapped = [];
+
+        foreach ($lines as $line) {
+            $wrapped[] = $padding . $line;
+        }
+
+        return implode("\n", $wrapped);
+    }
+
+    /**
+     * Wrap content with borders
+     */
+    protected function wrapWithBorders(string $content): string
+    {
+        if (!$this->options->showBorders) {
+            return $content;
+        }
+
+        $chars = $this->getBorderChars();
+        $width = $this->getEffectiveWidth();
+        $lines = explode("\n", $content);
+        $bordered = [];
+
+        // Top border
+        $bordered[] = $chars['top-left'] . str_repeat($chars['horizontal'], $width) . $chars['top-right'];
+
+        // Content lines with vertical borders
+        foreach ($lines as $line) {
+            $paddedLine = str_pad($line, $width);
+            $bordered[] = $chars['vertical'] . $paddedLine . $chars['vertical'];
+        }
+
+        // Bottom border
+        $bordered[] = $chars['bottom-left'] . str_repeat($chars['horizontal'], $width) . $chars['bottom-right'];
+
+        return implode("\n", $bordered);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/LayoutFactory.php b/src/Framework/Console/Layout/LayoutFactory.php
new file mode 100644
index 00000000..ae1e1a90
--- /dev/null
+++ b/src/Framework/Console/Layout/LayoutFactory.php
@@ -0,0 +1,99 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\ValueObjects\GridConfig;
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Factory for creating console layouts
+ */
+final readonly class LayoutFactory
+{
+    public function __construct(
+        private ?ConsoleTheme $theme = null,
+        private ?TerminalSize $terminalSize = null
+    ) {
+    }
+
+    /**
+     * Create a page layout
+     */
+    public function createPageLayout(?LayoutOptions $options = null): PageLayout
+    {
+        $options = $this->mergeOptions($options);
+        return PageLayout::create($this->terminalSize, $options);
+    }
+
+    /**
+     * Create a section layout
+     */
+    public function createSectionLayout(?LayoutOptions $options = null): SectionLayout
+    {
+        $options = $this->mergeOptions($options);
+        return SectionLayout::create($this->terminalSize, $options);
+    }
+
+    /**
+     * Create a dashboard layout
+     */
+    public function createDashboardLayout(?LayoutOptions $options = null, ?GridConfig $gridConfig = null): DashboardLayout
+    {
+        $options = $this->mergeOptions($options);
+        return DashboardLayout::create($this->terminalSize, $options, $gridConfig);
+    }
+
+    /**
+     * Create a simple layout
+     */
+    public function createSimpleLayout(?LayoutOptions $options = null): SimpleLayout
+    {
+        $options = $this->mergeOptions($options);
+        return SimpleLayout::create($this->terminalSize, $options);
+    }
+
+    /**
+     * Merge options with default theme
+     */
+    private function mergeOptions(?LayoutOptions $options): LayoutOptions
+    {
+        if ($options === null) {
+            return LayoutOptions::withTheme($this->theme ?? DefaultThemes::getConsoleTheme('default'));
+        }
+
+        if ($options->theme === null && $this->theme !== null) {
+            return LayoutOptions::withTheme($this->theme);
+        }
+
+        return $options;
+    }
+
+    /**
+     * Create factory with theme
+     */
+    public static function withTheme(ConsoleTheme $theme): self
+    {
+        return new self($theme);
+    }
+
+    /**
+     * Create factory with terminal size
+     */
+    public static function withTerminalSize(TerminalSize $terminalSize): self
+    {
+        return new self(null, $terminalSize);
+    }
+
+    /**
+     * Create default factory
+     */
+    public static function create(): self
+    {
+        return new self();
+    }
+}
+
diff --git a/src/Framework/Console/Layout/LayoutInterface.php b/src/Framework/Console/Layout/LayoutInterface.php
new file mode 100644
index 00000000..d438bd15
--- /dev/null
+++ b/src/Framework/Console/Layout/LayoutInterface.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+/**
+ * Interface for all console layouts
+ */
+interface LayoutInterface
+{
+    /**
+     * Render the layout and return the output string
+     */
+    public function render(): string;
+
+    /**
+     * Get the terminal size for this layout
+     */
+    public function getTerminalSize(): TerminalSize;
+}
+
diff --git a/src/Framework/Console/Layout/LayoutRenderer.php b/src/Framework/Console/Layout/LayoutRenderer.php
new file mode 100644
index 00000000..2342db71
--- /dev/null
+++ b/src/Framework/Console/Layout/LayoutRenderer.php
@@ -0,0 +1,184 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Rendering engine for all layout types
+ */
+final readonly class LayoutRenderer
+{
+    public function __construct(
+        private ConsoleTheme $theme
+    ) {
+    }
+
+    /**
+     * Render a box with borders
+     */
+    public function renderBox(string $content, int $width, bool $showBorders = true, string $title = ''): string
+    {
+        $lines = explode("\n", $content);
+        $output = [];
+
+        if ($showBorders) {
+            // Top border
+            if ($title !== '') {
+                $titleWidth = mb_strlen($title);
+                $availableSpace = $width - $titleWidth - 4; // Space for '[ ' and ' ]'
+                $leftPadding = max(0, (int)floor($availableSpace / 2));
+                $rightPadding = max(0, $availableSpace - $leftPadding);
+
+                $topBorder = '┌' . str_repeat('─', $leftPadding) . '[ ' . $title . ' ]' . str_repeat('─', $rightPadding) . '┐';
+                $output[] = $topBorder;
+            } else {
+                $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+            }
+
+            // Content lines
+            foreach ($lines as $line) {
+                $paddedLine = str_pad($line, $width - 4);
+                $output[] = '│ ' . $paddedLine . ' │';
+            }
+
+            // Bottom border
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        } else {
+            $output = $lines;
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Render a horizontal divider
+     */
+    public function renderDivider(int $width, ?string $label = null, bool $double = false): string
+    {
+        $char = $double ? '═' : '─';
+
+        if ($label !== null) {
+            $labelLength = mb_strlen($label);
+            $availableSpace = $width - $labelLength - 4; // Space for ' ' on both sides
+            $leftWidth = max(0, (int)floor($availableSpace / 2));
+            $rightWidth = max(0, $availableSpace - $leftWidth);
+
+            return str_repeat($char, $leftWidth) . ' ' . $label . ' ' . str_repeat($char, $rightWidth);
+        }
+
+        return str_repeat($char, $width);
+    }
+
+    /**
+     * Render a header
+     */
+    public function renderHeader(string $title, ?string $subtitle = null, int $width = 80): string
+    {
+        $output = [];
+        $titleStyle = ConsoleStyle::create(color: $this->theme->classNameColor, format: ConsoleFormat::BOLD);
+
+        // Top border
+        $output[] = '╔' . str_repeat('═', $width - 2) . '╗';
+
+        // Title
+        $titlePadded = str_pad($title, $width - 4);
+        $output[] = '║ ' . $titleStyle->apply($titlePadded) . ' ║';
+
+        // Subtitle (if provided)
+        if ($subtitle !== null) {
+            $subtitleStyle = ConsoleStyle::create(color: $this->theme->metadataColor);
+            $subtitlePadded = str_pad($subtitle, $width - 4);
+            $output[] = '║ ' . $subtitleStyle->apply($subtitlePadded) . ' ║';
+        }
+
+        // Bottom border
+        $output[] = '╚' . str_repeat('═', $width - 2) . '╝';
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Render a footer
+     */
+    public function renderFooter(string $content, int $width = 80): string
+    {
+        $output = [];
+        $footerStyle = ConsoleStyle::create(color: $this->theme->metadataColor);
+
+        // Top border
+        $output[] = '╔' . str_repeat('═', $width - 2) . '╗';
+
+        // Content
+        $contentPadded = str_pad($content, $width - 4);
+        $output[] = '║ ' . $footerStyle->apply($contentPadded) . ' ║';
+
+        // Bottom border
+        $output[] = '╚' . str_repeat('═', $width - 2) . '╝';
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Apply ANSI formatting to text
+     */
+    public function applyStyle(string $text, ConsoleColor $color, ?ConsoleFormat $format = null): string
+    {
+        $style = ConsoleStyle::create(color: $color, format: $format);
+        return $style->apply($text);
+    }
+
+    /**
+     * Wrap text to fit width
+     */
+    public function wrapText(string $text, int $width): array
+    {
+        $lines = explode("\n", $text);
+        $wrapped = [];
+
+        foreach ($lines as $line) {
+            if (mb_strlen($line) <= $width) {
+                $wrapped[] = $line;
+            } else {
+                $wrapped = array_merge($wrapped, $this->splitLine($line, $width));
+            }
+        }
+
+        return $wrapped;
+    }
+
+    private function splitLine(string $line, int $width): array
+    {
+        $words = explode(' ', $line);
+        $currentLine = '';
+        $result = [];
+
+        foreach ($words as $word) {
+            $testLine = empty($currentLine) ? $word : $currentLine . ' ' . $word;
+
+            if (mb_strlen($testLine) <= $width) {
+                $currentLine = $testLine;
+            } else {
+                if (!empty($currentLine)) {
+                    $result[] = $currentLine;
+                    $currentLine = $word;
+                } else {
+                    $result[] = mb_substr($word, 0, $width);
+                    $currentLine = mb_substr($word, $width);
+                }
+            }
+        }
+
+        if (!empty($currentLine)) {
+            $result[] = $currentLine;
+        }
+
+        return $result ?: [''];
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Navigation/Breadcrumbs.php b/src/Framework/Console/Layout/Navigation/Breadcrumbs.php
new file mode 100644
index 00000000..545b9f25
--- /dev/null
+++ b/src/Framework/Console/Layout/Navigation/Breadcrumbs.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Navigation;
+
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Breadcrumbs navigation component
+ */
+final readonly class Breadcrumbs
+{
+    public function __construct(
+        private array $items,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render breadcrumbs
+     */
+    public function render(int $width, bool $showBorders = false): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $separator = ' > ';
+        $separatorStyle = ConsoleStyle::create(color: $theme->separatorColor);
+        $itemStyle = ConsoleStyle::create(color: $theme->valueColor);
+        $lastItemStyle = ConsoleStyle::create(color: $theme->classNameColor);
+
+        $breadcrumbParts = [];
+        $itemCount = count($this->items);
+
+        foreach ($this->items as $index => $item) {
+            $isLast = ($index === $itemCount - 1);
+            $style = $isLast ? $lastItemStyle : $itemStyle;
+            $breadcrumbParts[] = $style->apply($item);
+
+            if (!$isLast) {
+                $breadcrumbParts[] = $separatorStyle->apply($separator);
+            }
+        }
+
+        $breadcrumb = implode('', $breadcrumbParts);
+
+        if ($showBorders) {
+            // Calculate text length without ANSI codes (approximation)
+            $textLength = mb_strlen(preg_replace('/\033\[[0-9;]*m/', '', $breadcrumb));
+            return '┌─ ' . $breadcrumb . str_repeat('─', max(0, $width - $textLength - 5)) . '┐';
+        }
+
+        return $breadcrumb;
+    }
+
+    /**
+     * Create breadcrumbs
+     */
+    public static function create(array $items, ?ConsoleTheme $theme = null): self
+    {
+        return new self($items, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Navigation/NavigationMenu.php b/src/Framework/Console/Layout/Navigation/NavigationMenu.php
new file mode 100644
index 00000000..3387ed04
--- /dev/null
+++ b/src/Framework/Console/Layout/Navigation/NavigationMenu.php
@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\Navigation;
+
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Navigation menu component
+ */
+final readonly class NavigationMenu
+{
+    public function __construct(
+        private array $items,
+        private ?string $title = null,
+        private ?int $activeIndex = null,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Render navigation menu
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        if ($showBorders) {
+            // Top border
+            if ($this->title !== null) {
+                $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+                $titlePadded = str_pad($this->title, $width - 4);
+                $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+                $output[] = '│ ' . $titleStyle->apply($titlePadded) . ' │';
+                $output[] = '├' . str_repeat('─', $width - 2) . '┤';
+            } else {
+                $output[] = '┌' . str_repeat('─', $width - 2) . '┐';
+            }
+
+            // Menu items
+            foreach ($this->items as $index => $item) {
+                $isActive = $this->activeIndex === $index;
+                $itemStyle = $isActive
+                    ? ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD)
+                    : ConsoleStyle::create(color: $theme->valueColor);
+
+                $prefix = $isActive ? '▶ ' : '  ';
+                $itemPadded = str_pad($prefix . $item, $width - 4);
+                $output[] = '│ ' . $itemStyle->apply($itemPadded) . ' │';
+            }
+
+            // Bottom border
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        } else {
+            if ($this->title !== null) {
+                $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+                $output[] = $titleStyle->apply($this->title);
+            }
+
+            foreach ($this->items as $index => $item) {
+                $isActive = $this->activeIndex === $index;
+                $itemStyle = $isActive
+                    ? ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD)
+                    : ConsoleStyle::create(color: $theme->valueColor);
+
+                $prefix = $isActive ? '▶ ' : '  ';
+                $output[] = $itemStyle->apply($prefix . $item);
+            }
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create navigation menu
+     */
+    public static function create(array $items, ?string $title = null, ?int $activeIndex = null, ?ConsoleTheme $theme = null): self
+    {
+        return new self($items, $title, $activeIndex, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/PageLayout.php b/src/Framework/Console/Layout/PageLayout.php
new file mode 100644
index 00000000..3a62695f
--- /dev/null
+++ b/src/Framework/Console/Layout/PageLayout.php
@@ -0,0 +1,159 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\Components\Footer;
+use App\Framework\Console\Layout\Components\Header;
+use App\Framework\Console\Layout\Components\Sidebar;
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+
+/**
+ * Page layout with header, main content, footer, and optional sidebar
+ */
+final class PageLayout extends LayoutContainer
+{
+    private ?Header $header = null;
+    private ?Footer $footer = null;
+    private ?Sidebar $sidebar = null;
+    private array $sections = [];
+    private array $mainContent = [];
+
+    public function __construct(
+        ?TerminalSize $customTerminalSize = null,
+        ?LayoutOptions $options = null
+    ) {
+        parent::__construct($customTerminalSize, $options);
+    }
+
+    /**
+     * Set header
+     */
+    public function withHeader(string $title, ?string $subtitle = null, array $meta = []): self
+    {
+        $this->header = new Header($title, $subtitle, $this->theme, $meta);
+        return $this;
+    }
+
+    /**
+     * Set footer
+     */
+    public function withFooter(string $content): self
+    {
+        $this->footer = new Footer($content, $this->theme);
+        return $this;
+    }
+
+    /**
+     * Set sidebar
+     */
+    public function withSidebar(array $items, ?string $title = null): self
+    {
+        $this->sidebar = new Sidebar($items, $title, $this->theme);
+        return $this;
+    }
+
+    /**
+     * Add section to main content
+     */
+    public function addSection(Section $section): self
+    {
+        $this->sections[] = $section;
+        return $this;
+    }
+
+    /**
+     * Add content line to main area
+     */
+    public function addContent(string $content): self
+    {
+        $this->mainContent[] = $content;
+        return $this;
+    }
+
+    /**
+     * Render the page layout
+     */
+    public function render(): string
+    {
+        $width = $this->getEffectiveWidth();
+        $output = [];
+        $hasSidebar = $this->sidebar !== null && $this->shouldShowSidebar();
+
+        // Header
+        if ($this->header !== null) {
+            $output[] = $this->header->render($width, $this->options->showBorders);
+            $output[] = '';
+        }
+
+        // Main content area
+        $mainContent = $this->renderMainContent($width, $hasSidebar);
+
+        if ($hasSidebar) {
+            // Split layout: sidebar + main content
+            $sidebarWidth = min(25, (int)($width * 0.25));
+            $mainWidth = $width - $sidebarWidth - 2; // Space between sidebar and main
+
+            $sidebarLines = explode("\n", $this->sidebar->render($sidebarWidth, $this->options->showBorders));
+            $mainLines = explode("\n", $mainContent);
+
+            $maxLines = max(count($sidebarLines), count($mainLines));
+
+            for ($i = 0; $i < $maxLines; $i++) {
+                $sidebarLine = $sidebarLines[$i] ?? str_repeat(' ', $sidebarWidth);
+                $mainLine = $mainLines[$i] ?? '';
+                $output[] = $sidebarLine . '  ' . $mainLine;
+            }
+        } else {
+            // Full width main content
+            $output[] = $mainContent;
+        }
+
+        // Footer
+        if ($this->footer !== null) {
+            $output[] = '';
+            $output[] = $this->footer->render($width, $this->options->showBorders);
+        }
+
+        return implode("\n", $output);
+    }
+
+    private function renderMainContent(int $width, bool $hasSidebar): string
+    {
+        $content = [];
+
+        // Render sections
+        foreach ($this->sections as $section) {
+            $content[] = $section->render($width, $this->options->showBorders);
+            $content[] = '';
+        }
+
+        // Render additional content
+        foreach ($this->mainContent as $line) {
+            $content[] = $line;
+        }
+
+        return implode("\n", $content);
+    }
+
+    private function shouldShowSidebar(): bool
+    {
+        if (!$this->isResponsive()) {
+            return true;
+        }
+
+        // Hide sidebar on small terminals
+        $breakpoint = $this->terminalSize->getBreakpoint();
+        return $breakpoint !== TerminalBreakpoint::EXTRA_SMALL && $breakpoint !== TerminalBreakpoint::SMALL;
+    }
+
+    /**
+     * Create page layout
+     */
+    public static function create(?TerminalSize $terminalSize = null, ?LayoutOptions $options = null): self
+    {
+        return new self($terminalSize, $options);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/Panel.php b/src/Framework/Console/Layout/Panel.php
new file mode 100644
index 00000000..7f38c13e
--- /dev/null
+++ b/src/Framework/Console/Layout/Panel.php
@@ -0,0 +1,90 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Console\Layout\ValueObjects\PanelSize;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Panel component for dashboard layouts
+ */
+final class Panel
+{
+    private string $content = '';
+
+    public function __construct(
+        private string $title,
+        private PanelSize $size = PanelSize::MEDIUM,
+        private ?ConsoleTheme $theme = null,
+    ) {
+    }
+
+    /**
+     * Set panel content
+     */
+    public function setContent(string $content): self
+    {
+        $this->content = $content;
+        return $this;
+    }
+
+    /**
+     * Render the panel
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        if ($showBorders) {
+            // Top border with title
+            $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+            $titleWidth = mb_strlen($this->title);
+            $availableSpace = $width - $titleWidth - 4; // Space for '[ ' and ' ]'
+            $leftPadding = max(0, (int)floor($availableSpace / 2));
+            $rightPadding = max(0, $availableSpace - $leftPadding);
+
+            $topBorder = '┌' . str_repeat('─', $leftPadding) . '[ ' . $titleStyle->apply($this->title) . ' ]' . str_repeat('─', $rightPadding) . '┐';
+            $output[] = $topBorder;
+
+            // Content
+            $contentLines = explode("\n", $this->content);
+            foreach ($contentLines as $line) {
+                $paddedLine = str_pad($line, $width - 4);
+                $output[] = '│ ' . $paddedLine . ' │';
+            }
+
+            // Bottom border
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        } else {
+            // No borders
+            $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+            $output[] = $titleStyle->apply($this->title);
+            $output[] = $this->content;
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Get panel size
+     */
+    public function getSize(): PanelSize
+    {
+        return $this->size;
+    }
+
+    /**
+     * Create panel
+     */
+    public static function create(string $title, PanelSize $size = PanelSize::MEDIUM, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, $size, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/ResponsiveOutput.php b/src/Framework/Console/Layout/ResponsiveOutput.php
index 2218a433..7423a97c 100644
--- a/src/Framework/Console/Layout/ResponsiveOutput.php
+++ b/src/Framework/Console/Layout/ResponsiveOutput.php
@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Framework\Console\Layout;
 
-use App\Framework\Console\Output\ConsoleOutput;
+use App\Framework\Console\ConsoleOutput;
 
 final readonly class ResponsiveOutput
 {
@@ -173,6 +173,44 @@ final readonly class ResponsiveOutput
         return substr($text, 0, $maxLength - 3) . '...';
     }
 
+    /**
+     * Create a page layout
+     */
+    public function createPageLayout(?\App\Framework\Console\Layout\ValueObjects\LayoutOptions $options = null): \App\Framework\Console\Layout\PageLayout
+    {
+        $factory = \App\Framework\Console\Layout\LayoutFactory::withTerminalSize($this->terminalSize);
+        return $factory->createPageLayout($options);
+    }
+
+    /**
+     * Create a section layout
+     */
+    public function createSectionLayout(?\App\Framework\Console\Layout\ValueObjects\LayoutOptions $options = null): \App\Framework\Console\Layout\SectionLayout
+    {
+        $factory = \App\Framework\Console\Layout\LayoutFactory::withTerminalSize($this->terminalSize);
+        return $factory->createSectionLayout($options);
+    }
+
+    /**
+     * Create a dashboard layout
+     */
+    public function createDashboardLayout(
+        ?\App\Framework\Console\Layout\ValueObjects\LayoutOptions $options = null,
+        ?\App\Framework\Console\Layout\ValueObjects\GridConfig $gridConfig = null
+    ): \App\Framework\Console\Layout\DashboardLayout {
+        $factory = \App\Framework\Console\Layout\LayoutFactory::withTerminalSize($this->terminalSize);
+        return $factory->createDashboardLayout($options, $gridConfig);
+    }
+
+    /**
+     * Create a simple layout
+     */
+    public function createSimpleLayout(?\App\Framework\Console\Layout\ValueObjects\LayoutOptions $options = null): \App\Framework\Console\Layout\SimpleLayout
+    {
+        $factory = \App\Framework\Console\Layout\LayoutFactory::withTerminalSize($this->terminalSize);
+        return $factory->createSimpleLayout($options);
+    }
+
     public static function create(ConsoleOutput $output, ?TerminalSize $terminalSize = null): self
     {
         return new self(
diff --git a/src/Framework/Console/Layout/Section.php b/src/Framework/Console/Layout/Section.php
new file mode 100644
index 00000000..fd02577c
--- /dev/null
+++ b/src/Framework/Console/Layout/Section.php
@@ -0,0 +1,231 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Console\Layout\ValueObjects\SectionStyle;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+
+/**
+ * Reusable content section for layouts
+ */
+final class Section
+{
+    private array $contentLines = [];
+    private ?string $footer = null;
+    private bool $collapsed = false;
+
+    public function __construct(
+        private string $title,
+        private SectionStyle $style = SectionStyle::DEFAULT,
+        private ?ConsoleTheme $theme = null,
+        private bool $collapsible = false,
+    ) {
+    }
+
+    /**
+     * Check if section is collapsible
+     */
+    public function isCollapsible(): bool
+    {
+        return $this->collapsible;
+    }
+
+    /**
+     * Add content line(s)
+     */
+    public function addContent(string $content): self
+    {
+        $lines = explode("\n", $content);
+        $this->contentLines = array_merge($this->contentLines, $lines);
+
+        return $this;
+    }
+
+    /**
+     * Set footer text
+     */
+    public function withFooter(string $footer): self
+    {
+        $this->footer = $footer;
+
+        return $this;
+    }
+
+    /**
+     * Set collapsed state (only works if collapsible)
+     */
+    public function setCollapsed(bool $collapsed): self
+    {
+        $this->collapsed = $collapsed;
+
+        return $this;
+    }
+
+    /**
+     * Render the section
+     */
+    public function render(int $width, bool $showBorders = true): string
+    {
+        $theme = $this->theme ?? DefaultThemes::getConsoleTheme('default');
+        $output = [];
+
+        // Title with style
+        $titleStyle = $this->getTitleStyle($theme);
+        $titleLine = $this->formatTitle($this->title, $width, $titleStyle, $showBorders);
+        $output[] = $titleLine;
+
+        // Content (if not collapsed)
+        if (!$this->collapsed && !empty($this->contentLines)) {
+            $contentWidth = $showBorders ? $width - 4 : $width; // Account for borders
+            foreach ($this->contentLines as $line) {
+                $wrapped = $this->wrapLine($line, $contentWidth);
+                foreach ($wrapped as $wrappedLine) {
+                    if ($showBorders) {
+                        $output[] = '│ ' . str_pad($wrappedLine, $contentWidth) . ' │';
+                    } else {
+                        $output[] = $wrappedLine;
+                    }
+                }
+            }
+        } elseif ($this->collapsed) {
+            $collapsedText = '... (collapsed)';
+            $contentWidth = $showBorders ? $width - 4 : $width;
+            if ($showBorders) {
+                $output[] = '│ ' . str_pad($collapsedText, $contentWidth) . ' │';
+            } else {
+                $output[] = $collapsedText;
+            }
+        }
+
+        // Footer (if provided)
+        if ($this->footer !== null && !$this->collapsed) {
+            $footerStyle = ConsoleStyle::create(color: $theme->metadataColor);
+            $footerLine = $this->formatFooter($this->footer, $width, $footerStyle, $showBorders);
+            $output[] = $footerLine;
+        }
+
+        // Bottom border
+        if ($showBorders && !empty($this->contentLines)) {
+            $output[] = '└' . str_repeat('─', $width - 2) . '┘';
+        }
+
+        return implode("\n", $output);
+    }
+
+    private function getTitleStyle(ConsoleTheme $theme): ConsoleStyle
+    {
+        return match ($this->style) {
+            SectionStyle::INFO => ConsoleStyle::create(color: $theme->infoColor, format: ConsoleFormat::BOLD),
+            SectionStyle::SUCCESS => ConsoleStyle::create(color: ConsoleColor::GREEN, format: ConsoleFormat::BOLD),
+            SectionStyle::WARNING => ConsoleStyle::create(color: $theme->warningColor, format: ConsoleFormat::BOLD),
+            SectionStyle::ERROR => ConsoleStyle::create(color: $theme->errorColor, format: ConsoleFormat::BOLD),
+            SectionStyle::PRIMARY => ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD),
+            default => ConsoleStyle::create(color: $theme->valueColor, format: ConsoleFormat::BOLD),
+        };
+    }
+
+    private function formatTitle(string $title, int $width, ConsoleStyle $style, bool $showBorders): string
+    {
+        $titleText = $this->collapsible ? ($this->collapsed ? '▶ ' : '▼ ') . $title : $title;
+        $styledTitle = $style->apply($titleText);
+
+        if ($showBorders) {
+            $padding = str_repeat('─', max(0, $width - mb_strlen($titleText) - 4));
+            return '┌─ ' . $styledTitle . ' ' . $padding . '┐';
+        } else {
+            return $styledTitle;
+        }
+    }
+
+    private function formatFooter(string $footer, int $width, ConsoleStyle $style, bool $showBorders): string
+    {
+        $styledFooter = $style->apply($footer);
+        $footerWidth = $showBorders ? $width - 4 : $width;
+
+        if ($showBorders) {
+            return '├─ ' . str_pad($styledFooter, $footerWidth) . ' ┤';
+        } else {
+            return $styledFooter;
+        }
+    }
+
+    private function wrapLine(string $line, int $width): array
+    {
+        if (mb_strlen($line) <= $width) {
+            return [$line];
+        }
+
+        $lines = [];
+        $words = explode(' ', $line);
+        $currentLine = '';
+
+        foreach ($words as $word) {
+            $testLine = empty($currentLine) ? $word : $currentLine . ' ' . $word;
+
+            if (mb_strlen($testLine) <= $width) {
+                $currentLine = $testLine;
+            } else {
+                if (!empty($currentLine)) {
+                    $lines[] = $currentLine;
+                    $currentLine = $word;
+                } else {
+                    $lines[] = mb_substr($word, 0, $width);
+                    $currentLine = mb_substr($word, $width);
+                }
+            }
+        }
+
+        if (!empty($currentLine)) {
+            $lines[] = $currentLine;
+        }
+
+        return $lines;
+    }
+
+    /**
+     * Create section with default style
+     */
+    public static function create(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, SectionStyle::DEFAULT, $theme);
+    }
+
+    /**
+     * Create section with info style
+     */
+    public static function info(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, SectionStyle::INFO, $theme);
+    }
+
+    /**
+     * Create section with success style
+     */
+    public static function success(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, SectionStyle::SUCCESS, $theme);
+    }
+
+    /**
+     * Create section with warning style
+     */
+    public static function warning(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, SectionStyle::WARNING, $theme);
+    }
+
+    /**
+     * Create section with error style
+     */
+    public static function error(string $title, ?ConsoleTheme $theme = null): self
+    {
+        return new self($title, SectionStyle::ERROR, $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/SectionLayout.php b/src/Framework/Console/Layout/SectionLayout.php
new file mode 100644
index 00000000..b98432aa
--- /dev/null
+++ b/src/Framework/Console/Layout/SectionLayout.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+
+/**
+ * Container for multiple sections
+ */
+final class SectionLayout extends LayoutContainer
+{
+    private array $sections = [];
+
+    public function __construct(
+        ?TerminalSize $customTerminalSize = null,
+        ?LayoutOptions $options = null
+    ) {
+        parent::__construct($customTerminalSize, $options);
+    }
+
+    /**
+     * Add a section
+     */
+    public function addSection(Section $section): self
+    {
+        $this->sections[] = $section;
+        return $this;
+    }
+
+    /**
+     * Add multiple sections
+     */
+    public function addSections(array $sections): self
+    {
+        foreach ($sections as $section) {
+            if ($section instanceof Section) {
+                $this->sections[] = $section;
+            }
+        }
+        return $this;
+    }
+
+    /**
+     * Render the section layout
+     */
+    public function render(): string
+    {
+        $width = $this->getEffectiveWidth();
+        $output = [];
+
+        foreach ($this->sections as $index => $section) {
+            $output[] = $section->render($width, $this->options->showBorders);
+
+            // Add separator between sections (except last one)
+            if ($index < count($this->sections) - 1) {
+                $output[] = '';
+            }
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Create section layout
+     */
+    public static function create(?TerminalSize $terminalSize = null, ?LayoutOptions $options = null): self
+    {
+        return new self($terminalSize, $options);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/SimpleLayout.php b/src/Framework/Console/Layout/SimpleLayout.php
new file mode 100644
index 00000000..1ddfa446
--- /dev/null
+++ b/src/Framework/Console/Layout/SimpleLayout.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout;
+
+use App\Framework\Console\Layout\ValueObjects\LayoutOptions;
+
+/**
+ * Simple container layout for basic use cases
+ */
+final class SimpleLayout extends LayoutContainer
+{
+    private array $content = [];
+
+    public function __construct(
+        ?TerminalSize $customTerminalSize = null,
+        ?LayoutOptions $options = null
+    ) {
+        parent::__construct($customTerminalSize, $options);
+    }
+
+    /**
+     * Add content line
+     */
+    public function addContent(string $content): self
+    {
+        $this->content[] = $content;
+        return $this;
+    }
+
+    /**
+     * Add multiple content lines
+     */
+    public function addContentLines(array $lines): self
+    {
+        $this->content = array_merge($this->content, $lines);
+        return $this;
+    }
+
+    /**
+     * Render the simple layout
+     */
+    public function render(): string
+    {
+        $width = $this->getEffectiveWidth();
+        $content = implode("\n", $this->content);
+
+        if ($this->options->showBorders) {
+            return $this->wrapWithBorders($this->wrapWithPadding($content));
+        }
+
+        return $this->wrapWithPadding($content);
+    }
+
+    /**
+     * Create simple layout
+     */
+    public static function create(?TerminalSize $terminalSize = null, ?LayoutOptions $options = null): self
+    {
+        return new self($terminalSize, $options);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/ValueObjects/GridConfig.php b/src/Framework/Console/Layout/ValueObjects/GridConfig.php
new file mode 100644
index 00000000..97adc614
--- /dev/null
+++ b/src/Framework/Console/Layout/ValueObjects/GridConfig.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\ValueObjects;
+
+/**
+ * Grid configuration for dashboard layouts
+ */
+final readonly class GridConfig
+{
+    public function __construct(
+        public int $columns = 2,
+        public int $gap = 2,
+        public bool $responsive = true,
+    ) {
+    }
+
+    /**
+     * Calculate responsive columns based on terminal breakpoint
+     */
+    public static function fromBreakpoint(\App\Framework\Console\Layout\TerminalBreakpoint $breakpoint): self
+    {
+        $columns = match ($breakpoint) {
+            \App\Framework\Console\Layout\TerminalBreakpoint::EXTRA_SMALL => 1,
+            \App\Framework\Console\Layout\TerminalBreakpoint::SMALL => 1,
+            \App\Framework\Console\Layout\TerminalBreakpoint::MEDIUM => 2,
+            \App\Framework\Console\Layout\TerminalBreakpoint::LARGE => 3,
+            \App\Framework\Console\Layout\TerminalBreakpoint::EXTRA_LARGE => 4,
+        };
+
+        return new self(columns: $columns);
+    }
+
+    /**
+     * Calculate column width
+     */
+    public function getColumnWidth(int $totalWidth, int $columnSpan = 1): int
+    {
+        $totalGap = ($this->columns - 1) * $this->gap;
+        $availableWidth = $totalWidth - $totalGap;
+        $baseColumnWidth = (int)($availableWidth / $this->columns);
+
+        return ($baseColumnWidth * $columnSpan) + (($columnSpan - 1) * $this->gap);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/ValueObjects/LayoutOptions.php b/src/Framework/Console/Layout/ValueObjects/LayoutOptions.php
new file mode 100644
index 00000000..746a7dd5
--- /dev/null
+++ b/src/Framework/Console/Layout/ValueObjects/LayoutOptions.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\ValueObjects;
+
+use App\Framework\Display\Themes\ConsoleTheme;
+
+/**
+ * Options for console layouts
+ */
+final readonly class LayoutOptions
+{
+    public function __construct(
+        public int $width = 0, // 0 = auto-detect
+        public int $padding = 2,
+        public bool $showBorders = true,
+        public ?ConsoleTheme $theme = null,
+        public bool $responsive = true,
+        public int $margin = 0,
+        public string $borderStyle = 'single', // 'single', 'double', 'rounded', 'none'
+    ) {
+    }
+
+    /**
+     * Create default layout options
+     */
+    public static function default(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Create with custom width
+     */
+    public static function withWidth(int $width): self
+    {
+        return new self(width: $width);
+    }
+
+    /**
+     * Create without borders
+     */
+    public static function withoutBorders(): self
+    {
+        return new self(showBorders: false);
+    }
+
+    /**
+     * Create with custom theme
+     */
+    public static function withTheme(ConsoleTheme $theme): self
+    {
+        return new self(theme: $theme);
+    }
+}
+
diff --git a/src/Framework/Console/Layout/ValueObjects/PanelSize.php b/src/Framework/Console/Layout/ValueObjects/PanelSize.php
new file mode 100644
index 00000000..93c28cb8
--- /dev/null
+++ b/src/Framework/Console/Layout/ValueObjects/PanelSize.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\ValueObjects;
+
+/**
+ * Panel size options for dashboard layouts
+ */
+enum PanelSize: string
+{
+    case SMALL = 'small';      // 1/4 width
+    case MEDIUM = 'medium';    // 1/2 width
+    case LARGE = 'large';      // 3/4 width
+    case FULL = 'full';        // 1/1 width
+
+    /**
+     * Get width fraction (0.0 to 1.0)
+     */
+    public function getWidthFraction(): float
+    {
+        return match ($this) {
+            self::SMALL => 0.25,
+            self::MEDIUM => 0.5,
+            self::LARGE => 0.75,
+            self::FULL => 1.0,
+        };
+    }
+
+    /**
+     * Get column span (for grid layouts)
+     */
+    public function getColumnSpan(int $totalColumns): int
+    {
+        return match ($this) {
+            self::SMALL => max(1, (int)floor($totalColumns * 0.25)),
+            self::MEDIUM => max(1, (int)floor($totalColumns * 0.5)),
+            self::LARGE => max(1, (int)floor($totalColumns * 0.75)),
+            self::FULL => $totalColumns,
+        };
+    }
+}
+
diff --git a/src/Framework/Console/Layout/ValueObjects/SectionStyle.php b/src/Framework/Console/Layout/ValueObjects/SectionStyle.php
new file mode 100644
index 00000000..ebca9075
--- /dev/null
+++ b/src/Framework/Console/Layout/ValueObjects/SectionStyle.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Layout\ValueObjects;
+
+/**
+ * Style options for sections
+ */
+enum SectionStyle: string
+{
+    case DEFAULT = 'default';
+    case INFO = 'info';
+    case SUCCESS = 'success';
+    case WARNING = 'warning';
+    case ERROR = 'error';
+    case PRIMARY = 'primary';
+}
+
diff --git a/src/Framework/Console/Screen/Display.php b/src/Framework/Console/Screen/Display.php
index 46e02640..cf590d30 100644
--- a/src/Framework/Console/Screen/Display.php
+++ b/src/Framework/Console/Screen/Display.php
@@ -18,18 +18,31 @@ final readonly class Display
 
     /**
      * Löscht den gesamten Bildschirm und setzt den Cursor an den Anfang.
+     * Uses explicit \e[2J sequence for screen clearing.
      */
     public function clear(): self
     {
         if ($this->output->isTerminal()) {
             // Bildschirm löschen und Cursor an den Anfang setzen
-            $this->output->writeRaw(ScreenControlCode::CLEAR_ALL->format());
+            $this->clearScreen();
             $this->output->writeRaw(CursorControlCode::POSITION->format(1, 1));
         }
 
         return $this;
     }
 
+    /**
+     * Clear screen using explicit \e[2J sequence via ScreenControlCode enum
+     */
+    public function clearScreen(): self
+    {
+        if ($this->output->isTerminal()) {
+            $this->output->writeRaw(ScreenControlCode::CLEAR_ALL->format());
+        }
+
+        return $this;
+    }
+
     /**
      * Löscht die aktuelle Zeile.
      */
diff --git a/src/Framework/Console/Security/SecurityException.php b/src/Framework/Console/Security/SecurityException.php
index 2d49e398..dfb734eb 100644
--- a/src/Framework/Console/Security/SecurityException.php
+++ b/src/Framework/Console/Security/SecurityException.php
@@ -15,17 +15,7 @@ final class SecurityException extends FrameworkException
         public readonly ConsoleUser $user,
         ?\Throwable $previous = null
     ) {
-        parent::__construct($message, 403, $previous);
-        $this->errorCode = ErrorCode::AUTH_INSUFFICIENT_PERMISSIONS;
-
-        $this->withData([
-            'user_id' => $user->id,
-            'user_name' => $user->name,
-            'user_permissions' => array_map(fn (Permission $p) => $p->value, $user->permissions),
-            'required_permissions' => is_array($requiredPermissions)
-                ? array_map(fn (Permission $p) => $p->value, $requiredPermissions)
-                : [$requiredPermissions->value],
-        ]);
+        parent::__construct($message, (int) ErrorCode::AUTH_INSUFFICIENT_PERMISSIONS->value, $previous);
     }
 
     public static function accessDenied(Permission $permission, ConsoleUser $user): self
diff --git a/src/Framework/Console/Terminal/OscMode.php b/src/Framework/Console/Terminal/OscMode.php
new file mode 100644
index 00000000..86d689df
--- /dev/null
+++ b/src/Framework/Console/Terminal/OscMode.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Terminal;
+
+/**
+ * OSC (Operating System Command) modes for window title management.
+ * Mode 0 = both icon and title, Mode 1 = icon, Mode 2 = title
+ */
+enum OscMode: int
+{
+    case BOTH = 0;      // Both icon and title
+    case ICON = 1;      // Icon only
+    case TITLE = 2;     // Title only
+}
+
diff --git a/src/Framework/Console/Terminal/PhpStormDetector.php b/src/Framework/Console/Terminal/PhpStormDetector.php
new file mode 100644
index 00000000..d9ffede7
--- /dev/null
+++ b/src/Framework/Console/Terminal/PhpStormDetector.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Terminal;
+
+/**
+ * Detects PhpStorm/JetBrains terminal environment
+ *
+ * Provides utilities for PhpStorm-specific terminal features like
+ * clickable file links and project root detection.
+ */
+final readonly class PhpStormDetector
+{
+    /**
+     * Check if running in PhpStorm/JetBrains terminal
+     */
+    public static function isPhpStorm(): bool
+    {
+        // Check TERMINAL_EMULATOR environment variable
+        $terminalEmulator = getenv('TERMINAL_EMULATOR');
+        if ($terminalEmulator !== false && $terminalEmulator === 'JetBrains-JediTerm') {
+            return true;
+        }
+
+        // Check IDE_PROJECT_ROOTS (set by PhpStorm/IntelliJ)
+        $ideProjectRoots = getenv('IDE_PROJECT_ROOTS');
+        if ($ideProjectRoots !== false && $ideProjectRoots !== '') {
+            return true;
+        }
+
+        // Check TERM for jetbrains-related values
+        $term = getenv('TERM');
+        if ($term !== false && str_contains(strtolower($term), 'jetbrains')) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Get project root paths from IDE_PROJECT_ROOTS
+     *
+     * @return array<string> Array of project root paths, or empty array if not available
+     */
+    public static function getProjectRoots(): array
+    {
+        $ideProjectRoots = getenv('IDE_PROJECT_ROOTS');
+        if ($ideProjectRoots === false || $ideProjectRoots === '') {
+            return [];
+        }
+
+        // IDE_PROJECT_ROOTS is typically a colon-separated list (Unix) or semicolon-separated (Windows)
+        $separator = str_contains($ideProjectRoots, ';') ? ';' : ':';
+        $roots = explode($separator, $ideProjectRoots);
+
+        // Filter out empty values and normalize paths
+        return array_filter(
+            array_map('trim', $roots),
+            fn(string $root) => $root !== '' && is_dir($root)
+        );
+    }
+
+    /**
+     * Convert absolute file path to relative path based on project roots
+     *
+     * If PhpStorm is detected and project roots are available, returns the shortest
+     * relative path. Otherwise returns the absolute path.
+     *
+     * @param string $filePath Absolute file path
+     * @return string Relative path if project root found, otherwise absolute path
+     */
+    public static function getRelativePath(string $filePath): string
+    {
+        if (!self::isPhpStorm()) {
+            return $filePath;
+        }
+
+        $projectRoots = self::getProjectRoots();
+        if (empty($projectRoots)) {
+            return $filePath;
+        }
+
+        $filePath = realpath($filePath);
+        if ($filePath === false) {
+            return $filePath;
+        }
+
+        $shortestPath = $filePath;
+        $shortestLength = strlen($filePath);
+
+        foreach ($projectRoots as $root) {
+            $root = realpath($root);
+            if ($root === false) {
+                continue;
+            }
+
+            // Check if file is within this project root
+            if (str_starts_with($filePath, $root . DIRECTORY_SEPARATOR) || $filePath === $root) {
+                $relative = substr($filePath, strlen($root) + 1);
+                if (strlen($relative) < $shortestLength) {
+                    $shortestPath = $relative;
+                    $shortestLength = strlen($relative);
+                }
+            }
+        }
+
+        return $shortestPath;
+    }
+}
+
diff --git a/src/Framework/Console/Terminal/TerminalCapabilities.php b/src/Framework/Console/Terminal/TerminalCapabilities.php
new file mode 100644
index 00000000..e4d6c170
--- /dev/null
+++ b/src/Framework/Console/Terminal/TerminalCapabilities.php
@@ -0,0 +1,195 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Terminal;
+
+use App\Framework\Console\TerminalDetector;
+use App\Framework\Console\ValueObjects\TerminalStream;
+
+/**
+ * Extended terminal capability detection.
+ * Detects Truecolor support, link support, and UTF-8 support.
+ *
+ * Values are cached after first detection for performance.
+ */
+final class TerminalCapabilities
+{
+    private ?bool $truecolorSupport = null;
+    private ?bool $linkSupport = null;
+    private ?bool $utf8Support = null;
+    private ?bool $phpStorm = null;
+
+    public function __construct(
+        private readonly ?TerminalStream $stream = null
+    ) {
+    }
+
+    /**
+     * Check if terminal supports truecolor (24-bit RGB colors)
+     * Checks COLORTERM environment variable for "24bit" or "truecolor"
+     */
+    public function supportsTruecolor(): bool
+    {
+        if ($this->truecolorSupport !== null) {
+            return $this->truecolorSupport;
+        }
+
+        if (!TerminalDetector::isTerminal($this->stream)) {
+            $this->truecolorSupport = false;
+            return false;
+        }
+
+        $colorterm = getenv('COLORTERM');
+        if ($colorterm === false) {
+            $this->truecolorSupport = false;
+            return false;
+        }
+
+        $colorterm = strtolower($colorterm);
+        $this->truecolorSupport = in_array($colorterm, ['24bit', 'truecolor'], true);
+
+        return $this->truecolorSupport;
+    }
+
+    /**
+     * Check if terminal supports clickable links (OSC 8)
+     * Most modern terminals support this, but we check for known non-supporting terminals
+     */
+    public function supportsLinks(): bool
+    {
+        if ($this->linkSupport !== null) {
+            return $this->linkSupport;
+        }
+
+        if (!TerminalDetector::isTerminal($this->stream)) {
+            $this->linkSupport = false;
+            return false;
+        }
+
+        // Check for known terminals that don't support links
+        $term = getenv('TERM');
+        if ($term !== false) {
+            $term = strtolower($term);
+            // Some older terminals don't support OSC 8
+            $unsupported = ['dumb', 'linux', 'vt100', 'vt102', 'vt220'];
+            if (in_array($term, $unsupported, true)) {
+                $this->linkSupport = false;
+                return false;
+            }
+        }
+
+        // Check for specific terminal emulators that don't support links
+        $terminalEmulator = getenv('TERMINAL_EMULATOR');
+        if ($terminalEmulator !== false) {
+            // Some emulators might not support links
+            // For now, assume most modern terminals support it
+        }
+
+        // Default to true for modern terminals (most support OSC 8)
+        $this->linkSupport = true;
+        return true;
+    }
+
+    /**
+     * Check if terminal supports UTF-8
+     * Checks locale settings and terminal type
+     */
+    public function supportsUtf8(): bool
+    {
+        if ($this->utf8Support !== null) {
+            return $this->utf8Support;
+        }
+
+        if (!TerminalDetector::isTerminal($this->stream)) {
+            $this->utf8Support = false;
+            return false;
+        }
+
+        // Check locale
+        $locale = setlocale(LC_ALL, '0');
+        if ($locale !== false && stripos($locale, 'utf-8') !== false) {
+            $this->utf8Support = true;
+            return true;
+        }
+
+        // Check LANG environment variable
+        $lang = getenv('LANG');
+        if ($lang !== false && stripos($lang, 'utf-8') !== false) {
+            $this->utf8Support = true;
+            return true;
+        }
+
+        // Check LC_ALL, LC_CTYPE
+        $lcAll = getenv('LC_ALL');
+        $lcCtype = getenv('LC_CTYPE');
+        if (
+            ($lcAll !== false && stripos($lcAll, 'utf-8') !== false) ||
+            ($lcCtype !== false && stripos($lcCtype, 'utf-8') !== false)
+        ) {
+            $this->utf8Support = true;
+            return true;
+        }
+
+        // Check if terminal type indicates UTF-8 support
+        $term = getenv('TERM');
+        if ($term !== false) {
+            // Most modern terminal types support UTF-8
+            $term = strtolower($term);
+            $utf8Terms = ['xterm', 'xterm-256color', 'screen', 'tmux', 'rxvt', 'konsole', 'alacritty', 'kitty'];
+            foreach ($utf8Terms as $utf8Term) {
+                if (str_contains($term, $utf8Term)) {
+                    $this->utf8Support = true;
+                    return true;
+                }
+            }
+        }
+
+        // Default: assume UTF-8 is supported for modern terminals
+        $this->utf8Support = true;
+        return true;
+    }
+
+    /**
+     * Check if terminal supports colors (basic check)
+     */
+    public function supportsColors(): bool
+    {
+        return TerminalDetector::supportsColors($this->stream);
+    }
+
+    /**
+     * Check if stream is a terminal
+     */
+    public function isTerminal(): bool
+    {
+        return TerminalDetector::isTerminal($this->stream);
+    }
+
+    /**
+     * Check if running in PhpStorm/JetBrains terminal (cached)
+     */
+    public function isPhpStorm(): bool
+    {
+        if ($this->phpStorm === null) {
+            $this->phpStorm = \App\Framework\Console\Terminal\PhpStormDetector::isPhpStorm();
+        }
+
+        return $this->phpStorm;
+    }
+
+    /**
+     * Get all detected capabilities as array
+     */
+    public function getAllCapabilities(): array
+    {
+        return [
+            'terminal' => $this->isTerminal(),
+            'colors' => $this->supportsColors(),
+            'truecolor' => $this->supportsTruecolor(),
+            'links' => $this->supportsLinks(),
+            'utf8' => $this->supportsUtf8(),
+        ];
+    }
+}
+
diff --git a/src/Framework/Console/Terminal/Utf8Support.php b/src/Framework/Console/Terminal/Utf8Support.php
new file mode 100644
index 00000000..e9f500d4
--- /dev/null
+++ b/src/Framework/Console/Terminal/Utf8Support.php
@@ -0,0 +1,243 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Terminal;
+
+/**
+ * Utility for UTF-8, Emoji, and Powerline glyph processing.
+ * Provides methods for proper multi-byte character handling.
+ */
+final readonly class Utf8Support
+{
+    /**
+     * Get display width of a string (accounting for multi-byte characters, emojis, etc.)
+     * Some characters (like emojis) take up 2 display columns
+     */
+    public static function mbWidth(string $text): int
+    {
+        if (!function_exists('mb_strwidth')) {
+            // Fallback to strlen if mbstring not available
+            return strlen($text);
+        }
+
+        return mb_strwidth($text, 'UTF-8');
+    }
+
+    /**
+     * Truncate string to max width, accounting for multi-byte characters
+     */
+    public static function mbTruncate(string $text, int $maxWidth, string $suffix = '...'): string
+    {
+        if (self::mbWidth($text) <= $maxWidth) {
+            return $text;
+        }
+
+        $suffixWidth = self::mbWidth($suffix);
+        $targetWidth = $maxWidth - $suffixWidth;
+
+        if ($targetWidth <= 0) {
+            return $suffix;
+        }
+
+        // Truncate character by character until we reach target width
+        $result = '';
+        $currentWidth = 0;
+
+        $length = mb_strlen($text, 'UTF-8');
+        for ($i = 0; $i < $length; $i++) {
+            $char = mb_substr($text, $i, 1, 'UTF-8');
+            $charWidth = self::mbWidth($char);
+
+            if ($currentWidth + $charWidth > $targetWidth) {
+                break;
+            }
+
+            $result .= $char;
+            $currentWidth += $charWidth;
+        }
+
+        return $result . $suffix;
+    }
+
+    /**
+     * Check if a character is an emoji
+     * Uses Unicode ranges for emoji detection
+     */
+    public static function isEmoji(string $char): bool
+    {
+        if (mb_strlen($char, 'UTF-8') !== 1) {
+            return false;
+        }
+
+        $code = mb_ord($char, 'UTF-8');
+        if ($code === false) {
+            return false;
+        }
+
+        // Emoji Unicode ranges (simplified - covers most common ranges)
+        return
+            // Emoticons
+            ($code >= 0x1F600 && $code <= 0x1F64F) ||
+            // Miscellaneous Symbols and Pictographs
+            ($code >= 0x1F300 && $code <= 0x1F5FF) ||
+            // Supplemental Symbols and Pictographs
+            ($code >= 0x1F900 && $code <= 0x1F9FF) ||
+            // Symbols and Pictographs Extended-A
+            ($code >= 0x1FA00 && $code <= 0x1FAFF) ||
+            // Dingbats
+            ($code >= 0x2700 && $code <= 0x27BF) ||
+            // Miscellaneous Symbols
+            ($code >= 0x2600 && $code <= 0x26FF) ||
+            // Enclosed characters
+            ($code >= 0x1F100 && $code <= 0x1F1FF) ||
+            // Regional indicator symbols (flags)
+            ($code >= 0x1F1E6 && $code <= 0x1F1FF) ||
+            // Keycap sequences (0-9, #, *)
+            ($code >= 0x20E3) ||
+            // Zero Width Joiner sequences
+            ($code === 0x200D);
+    }
+
+    /**
+     * Check if a character is a Powerline glyph
+     * Powerline uses specific Unicode box-drawing and arrow characters
+     */
+    public static function isPowerlineGlyph(string $char): bool
+    {
+        if (mb_strlen($char, 'UTF-8') !== 1) {
+            return false;
+        }
+
+        $code = mb_ord($char, 'UTF-8');
+        if ($code === false) {
+            return false;
+        }
+
+        // Powerline commonly uses:
+        // - Box-drawing characters (U+2500-U+257F)
+        // - Geometric shapes (U+25A0-U+25FF)
+        // - Arrows (U+2190-U+21FF)
+        // - Block elements (U+2580-U+259F)
+        return
+            // Box-drawing
+            ($code >= 0x2500 && $code <= 0x257F) ||
+            // Geometric shapes
+            ($code >= 0x25A0 && $code <= 0x25FF) ||
+            // Arrows
+            ($code >= 0x2190 && $code <= 0x21FF) ||
+            // Block elements
+            ($code >= 0x2580 && $code <= 0x259F);
+    }
+
+    /**
+     * Get character count (not byte count) of a string
+     */
+    public static function mbLength(string $text): int
+    {
+        if (!function_exists('mb_strlen')) {
+            return strlen($text);
+        }
+
+        return mb_strlen($text, 'UTF-8');
+    }
+
+    /**
+     * Get substring with proper UTF-8 handling
+     */
+    public static function mbSubstr(string $text, int $start, ?int $length = null): string
+    {
+        if (!function_exists('mb_substr')) {
+            // Fallback - this won't work correctly for multi-byte, but at least won't crash
+            if ($length === null) {
+                return substr($text, $start);
+            }
+            return substr($text, $start, $length);
+        }
+
+        return mb_substr($text, $start, $length, 'UTF-8');
+    }
+
+    /**
+     * Pad string to target width with proper UTF-8 handling
+     */
+    public static function mbPad(string $text, int $targetWidth, string $padString = ' ', int $padType = STR_PAD_RIGHT): string
+    {
+        $currentWidth = self::mbWidth($text);
+
+        if ($currentWidth >= $targetWidth) {
+            return $text;
+        }
+
+        $paddingNeeded = $targetWidth - $currentWidth;
+        $padWidth = self::mbWidth($padString);
+
+        if ($padWidth === 0) {
+            return $text;
+        }
+
+        $repeatCount = (int)ceil($paddingNeeded / $padWidth);
+        $padding = str_repeat($padString, $repeatCount);
+
+        // Trim padding to exact width needed
+        $paddingWidth = self::mbWidth($padding);
+        if ($paddingWidth > $paddingNeeded) {
+            $padding = self::mbTruncate($padding, $paddingNeeded, '');
+        }
+
+        return match ($padType) {
+            STR_PAD_LEFT => $padding . $text,
+            STR_PAD_BOTH => str_repeat($padString, (int)floor($repeatCount / 2)) . $text . str_repeat($padString, (int)ceil($repeatCount / 2)),
+            default => $text . $padding,
+        };
+    }
+
+    /**
+     * Check if string contains emoji
+     */
+    public static function containsEmoji(string $text): bool
+    {
+        $length = mb_strlen($text, 'UTF-8');
+        for ($i = 0; $i < $length; $i++) {
+            $char = mb_substr($text, $i, 1, 'UTF-8');
+            if (self::isEmoji($char)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Check if string contains Powerline glyphs
+     */
+    public static function containsPowerlineGlyphs(string $text): bool
+    {
+        $length = mb_strlen($text, 'UTF-8');
+        for ($i = 0; $i < $length; $i++) {
+            $char = mb_substr($text, $i, 1, 'UTF-8');
+            if (self::isPowerlineGlyph($char)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Remove ANSI escape sequences from string for width calculation
+     */
+    public static function stripAnsi(string $text): string
+    {
+        return preg_replace('/\033\[[0-9;]*m/', '', $text) ?? $text;
+    }
+
+    /**
+     * Get display width ignoring ANSI codes
+     */
+    public static function mbWidthIgnoreAnsi(string $text): int
+    {
+        return self::mbWidth(self::stripAnsi($text));
+    }
+}
+
diff --git a/src/Framework/Console/Terminal/WindowTitleManager.php b/src/Framework/Console/Terminal/WindowTitleManager.php
new file mode 100644
index 00000000..023b6e59
--- /dev/null
+++ b/src/Framework/Console/Terminal/WindowTitleManager.php
@@ -0,0 +1,190 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Terminal;
+
+use App\Framework\Console\Ansi\AnsiSequenceGenerator;
+use App\Framework\Console\Terminal\OscMode;
+use App\Framework\Console\TerminalDetector;
+
+/**
+ * Improved window title management with stack support.
+ * Supports multiple OSC modes (0, 1, 2) and title stacking.
+ */
+final class WindowTitleManager
+{
+    /** @var array<string> */
+    private array $titleStack = [];
+
+    private ?string $originalTitle = null;
+
+    public function __construct(
+        private readonly AnsiSequenceGenerator $ansiGenerator,
+        private readonly TerminalCapabilities $capabilities
+    ) {
+        $this->saveOriginalTitle();
+    }
+
+    /**
+     * Set window title (replaces current title)
+     */
+    public function setTitle(string $title, OscMode $mode = OscMode::BOTH): void
+    {
+        if (!$this->capabilities->isTerminal()) {
+            return;
+        }
+
+        $sequence = $this->ansiGenerator->title($title, $mode);
+        $this->writeRaw($sequence);
+
+        // Update stack
+        if (empty($this->titleStack)) {
+            $this->titleStack = [$title];
+        } else {
+            $this->titleStack[count($this->titleStack) - 1] = $title;
+        }
+    }
+
+    /**
+     * Push title onto stack (save current, set new)
+     */
+    public function pushTitle(string $title, OscMode $mode = OscMode::BOTH): void
+    {
+        if (!$this->capabilities->isTerminal()) {
+            return;
+        }
+
+        // Save current title (if any)
+        if (!empty($this->titleStack)) {
+            // Current title is already on stack
+        } else {
+            // Save original title
+            $this->titleStack[] = $this->originalTitle ?? '';
+        }
+
+        // Set new title
+        $this->setTitle($title, $mode);
+        $this->titleStack[] = $title;
+    }
+
+    /**
+     * Pop title from stack (restore previous)
+     */
+    public function popTitle(OscMode $mode = OscMode::BOTH): ?string
+    {
+        if (!$this->capabilities->isTerminal()) {
+            return null;
+        }
+
+        if (empty($this->titleStack)) {
+            // Restore original title
+            if ($this->originalTitle !== null) {
+                $this->restoreOriginalTitle($mode);
+                return $this->originalTitle;
+            }
+            return null;
+        }
+
+        // Remove current title from stack
+        array_pop($this->titleStack);
+
+        // Restore previous title
+        if (empty($this->titleStack)) {
+            // No more titles, restore original
+            if ($this->originalTitle !== null) {
+                $this->restoreOriginalTitle($mode);
+                return $this->originalTitle;
+            }
+            return null;
+        }
+
+        $previousTitle = end($this->titleStack);
+        $this->setTitle($previousTitle, $mode);
+
+        return $previousTitle;
+    }
+
+    /**
+     * Reset to original title
+     */
+    public function resetTitle(OscMode $mode = OscMode::BOTH): void
+    {
+        if (!$this->capabilities->isTerminal()) {
+            return;
+        }
+
+        $this->titleStack = [];
+        $this->restoreOriginalTitle($mode);
+    }
+
+    /**
+     * Get current title
+     */
+    public function getCurrentTitle(): ?string
+    {
+        if (empty($this->titleStack)) {
+            return $this->originalTitle;
+        }
+
+        return end($this->titleStack);
+    }
+
+    /**
+     * Get title stack
+     * @return array<string>
+     */
+    public function getTitleStack(): array
+    {
+        return $this->titleStack;
+    }
+
+    /**
+     * Clear title (set to empty)
+     */
+    public function clearTitle(OscMode $mode = OscMode::BOTH): void
+    {
+        $this->setTitle('', $mode);
+    }
+
+    /**
+     * Save original title (attempt to read from terminal)
+     */
+    private function saveOriginalTitle(): void
+    {
+        // We can't actually read the current title from terminal,
+        // so we'll store an empty string or use a default
+        // This could be improved by storing the title when first set
+        $this->originalTitle = '';
+    }
+
+    /**
+     * Restore original title
+     */
+    private function restoreOriginalTitle(OscMode $mode): void
+    {
+        if ($this->originalTitle !== null && $this->originalTitle !== '') {
+            $sequence = $this->ansiGenerator->title($this->originalTitle, $mode);
+            $this->writeRaw($sequence);
+        }
+    }
+
+    /**
+     * Write raw ANSI sequence to output
+     */
+    private function writeRaw(string $sequence): void
+    {
+        // Only emit terminal escape sequences when output goes to a real terminal
+        if (!$this->capabilities->isTerminal()) {
+            return;
+        }
+
+        echo $sequence;
+
+        // Flush output to ensure title is set immediately
+        if (function_exists('fflush')) {
+            fflush(STDOUT);
+        }
+    }
+}
+
diff --git a/src/Framework/Console/TextWriter.php b/src/Framework/Console/TextWriter.php
new file mode 100644
index 00000000..b153dfe7
--- /dev/null
+++ b/src/Framework/Console/TextWriter.php
@@ -0,0 +1,215 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console;
+
+use App\Framework\Console\Ansi\AnsiSequenceGenerator;
+use App\Framework\Console\Ansi\RgbColor;
+use App\Framework\Console\Ansi\TruecolorStyle;
+use App\Framework\Console\Animation\Animation;
+use App\Framework\Console\Animation\AnimationManager;
+use App\Framework\Console\Terminal\TerminalCapabilities;
+
+/**
+ * Isolated text output logic.
+ * Handles all text writing with proper style, color, and UTF-8 support.
+ */
+final class TextWriter
+{
+    private ?AnimationManager $animationManager = null;
+
+    public function __construct(
+        private readonly AnsiSequenceGenerator $ansiGenerator,
+        private readonly TerminalCapabilities $capabilities,
+        ?AnimationManager $animationManager = null
+    ) {
+        $this->animationManager = $animationManager;
+    }
+
+    /**
+     * Write text with optional style
+     */
+    public function write(string $message, ConsoleStyle|ConsoleColor|null $style = null): void
+    {
+        if ($style instanceof ConsoleColor) {
+            // Backward compatibility
+            echo $style->toAnsi() . $message . ConsoleColor::RESET->toAnsi();
+        } elseif ($style instanceof ConsoleStyle) {
+            echo $style->apply($message);
+        } else {
+            echo $message;
+        }
+    }
+
+    /**
+     * Write text to stderr with optional style
+     */
+    public function writeToStderr(string $message, ConsoleStyle|ConsoleColor|null $style = null): void
+    {
+        $formatted = match (true) {
+            $style instanceof ConsoleColor => $style->toAnsi() . $message . ConsoleColor::RESET->toAnsi(),
+            $style instanceof ConsoleStyle => $style->apply($message),
+            default => $message
+        };
+
+        file_put_contents('php://stderr', $formatted);
+    }
+
+    /**
+     * Write text with truecolor support
+     */
+    public function writeTruecolor(
+        string $message,
+        ?RgbColor $foreground = null,
+        ?RgbColor $background = null,
+        ?ConsoleFormat $format = null
+    ): void {
+        if (!$this->capabilities->isTerminal()) {
+            echo $message;
+            return;
+        }
+
+        $truecolorStyle = new TruecolorStyle($foreground, $background, $format);
+        echo $truecolorStyle->apply($message, $this->ansiGenerator, $this->capabilities);
+    }
+
+    /**
+     * Write raw ANSI sequences
+     */
+    public function writeRaw(string $raw): void
+    {
+        echo $raw;
+    }
+
+    /**
+     * Write line with optional style
+     */
+    public function writeLine(string $message = '', ConsoleStyle|ConsoleColor|null $style = null): void
+    {
+        $this->write($message . PHP_EOL, $style);
+    }
+
+    /**
+     * Write line to stderr with optional style
+     */
+    public function writeLineToStderr(string $message = '', ConsoleStyle|ConsoleColor|null $style = null): void
+    {
+        $this->writeToStderr($message . PHP_EOL, $style);
+    }
+
+    /**
+     * Write success message
+     */
+    public function writeSuccess(string $message): void
+    {
+        $this->writeLine('✓ ' . $message, ConsoleStyle::success());
+    }
+
+    /**
+     * Write error message
+     */
+    public function writeError(string $message): void
+    {
+        $this->writeLine('✗ ' . $message, ConsoleStyle::error());
+    }
+
+    /**
+     * Write warning message
+     */
+    public function writeWarning(string $message): void
+    {
+        $this->writeLine('⚠ ' . $message, ConsoleStyle::warning());
+    }
+
+    /**
+     * Write info message
+     */
+    public function writeInfo(string $message): void
+    {
+        $this->writeLine('ℹ ' . $message, ConsoleStyle::info());
+    }
+
+    /**
+     * Add new lines
+     */
+    public function newLine(int $count = 1): void
+    {
+        echo str_repeat(PHP_EOL, $count);
+    }
+
+    /**
+     * Check if output goes to terminal
+     */
+    public function isTerminal(): bool
+    {
+        return $this->capabilities->isTerminal();
+    }
+
+    /**
+     * Animate text with a given animation
+     * The animation will be managed and updated automatically
+     */
+    public function animateText(string $text, Animation $animation): void
+    {
+        if ($this->animationManager === null) {
+            // No animation manager, just output text
+            echo $text;
+            return;
+        }
+
+        // Add animation to manager
+        $this->animationManager->add($animation);
+        $animation->start();
+
+        // Render first frame
+        $this->renderAnimatedText($text, $animation);
+    }
+
+    /**
+     * Render animated text frame
+     */
+    private function renderAnimatedText(string $text, Animation $animation): void
+    {
+        if ($animation instanceof Types\BaseAnimation) {
+            $value = $animation->getCurrentValue();
+            
+            // Handle different animation types
+            if ($animation instanceof Types\FadeAnimation) {
+                $opacity = $animation->getOpacity();
+                // For console, we can't really fade, so we'll just show/hide based on opacity
+                if ($opacity > 0.5) {
+                    echo $text;
+                }
+            } elseif ($animation instanceof Types\TypewriterAnimation) {
+                echo $animation->getText();
+            } elseif ($animation instanceof Types\MarqueeAnimation) {
+                echo $animation->getDisplayText();
+            } else {
+                echo $text;
+            }
+        } else {
+            echo $text;
+        }
+    }
+
+    /**
+     * Update all active animations
+     * Should be called periodically from render loop
+     */
+    public function updateAnimations(float $deltaTime): void
+    {
+        if ($this->animationManager !== null) {
+            $this->animationManager->update($deltaTime);
+        }
+    }
+
+    /**
+     * Set animation manager
+     */
+    public function setAnimationManager(AnimationManager $manager): void
+    {
+        $this->animationManager = $manager;
+    }
+}
+
diff --git a/src/Framework/Console/WorkflowExecutor.php b/src/Framework/Console/WorkflowExecutor.php
index 19fe9509..f5801c0a 100644
--- a/src/Framework/Console/WorkflowExecutor.php
+++ b/src/Framework/Console/WorkflowExecutor.php
@@ -53,8 +53,9 @@ final readonly class WorkflowExecutor
         foreach ($workflow['steps'] as $step) {
             $workflowStep = $step instanceof WorkflowStep ? $step : WorkflowStep::fromArray($step);
 
+            $stepDescription = $workflowStep->getDescription() ?? $workflowStep->getCommand();
             $this->output->writeLine(
-                "Step {$stepNumber}/{$totalSteps}: {$workflowStep->getDescription() ?: $workflowStep->getCommand()}",
+                "Step {$stepNumber}/{$totalSteps}: {$stepDescription}",
                 ConsoleColor::BRIGHT_WHITE
             );
 
diff --git a/src/Framework/Core/AppBootstrapper.php b/src/Framework/Core/AppBootstrapper.php
index 00f6f470..6174b42d 100644
--- a/src/Framework/Core/AppBootstrapper.php
+++ b/src/Framework/Core/AppBootstrapper.php
@@ -18,10 +18,8 @@ use App\Framework\Core\Events\EventDispatcherInterface;
 use App\Framework\DI\Container;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Encryption\EncryptionFactory;
-use App\Framework\ErrorHandling\CliErrorHandler;
-use App\Framework\ErrorHandling\ErrorHandler;
-use App\Framework\ErrorHandling\ErrorHandlerManager;
 use App\Framework\ExceptionHandling\ExceptionHandlerManager;
+use App\Framework\ExceptionHandling\ExceptionHandlerManagerFactory;
 use App\Framework\Http\MiddlewareManager;
 use App\Framework\Http\MiddlewareManagerInterface;
 use App\Framework\Http\ResponseEmitter;
@@ -45,6 +43,11 @@ final readonly class AppBootstrapper
         private PerformanceCollectorInterface $collector,
         private MemoryMonitor       $memoryMonitor = new MemoryMonitor,
     ) {
+        // Register basic exception handlers early (before Discovery)
+        // This ensures errors during bootstrap/Discovery are handled properly
+        // We use Basic handlers that don't require full dependencies
+        ExceptionHandlerManager::createWithBasicHandlers();
+
         $this->container = new DefaultContainer();
         $this->bootstrapper = new ContainerBootstrapper($this->container);
 
@@ -64,7 +67,8 @@ final readonly class AppBootstrapper
         // Make Environment available throughout the application
         $this->container->instance(Environment::class, $env);
 
-        $typedConfig = new TypedConfigInitializer($env)($this->container);
+        $typedConfigInitializer = new TypedConfigInitializer($env);
+        $typedConfig = $typedConfigInitializer($this->container);
         $this->container->instance(TypedConfiguration::class, $typedConfig);
 
 
@@ -145,21 +149,18 @@ final readonly class AppBootstrapper
 
     private function registerWebErrorHandler(): void
     {
-        new ExceptionHandlerManager();
-        #var_dump('registerWebErrorHandler');
-        #$eh = $this->container->get(ErrorHandlerManager::class);
-        #$eh->register();
-        //$this->container->get(ErrorHandler::class)->register();
+        // Use factory to create and register ExceptionHandlerManager
+        // ErrorKernel will automatically detect HTTP context and handle accordingly
+        $factory = new ExceptionHandlerManagerFactory($this->container);
+        $factory->createAndRegister();
     }
 
     private function registerCliErrorHandler(): void
     {
-        $output = $this->container->has(ConsoleOutput::class)
-            ? $this->container->get(ConsoleOutput::class)
-            : new ConsoleOutput();
-
-        $cliErrorHandler = new CliErrorHandler($output);
-        $cliErrorHandler->register();
+        // Use factory to create and register ExceptionHandlerManager
+        // ErrorKernel will automatically detect CLI context and handle accordingly
+        $factory = new ExceptionHandlerManagerFactory($this->container);
+        $factory->createAndRegister();
     }
 
     private function registerApplication(): void
diff --git a/src/Framework/Core/AttributeMapper.php b/src/Framework/Core/AttributeMapper.php
index 54db800d..85d40d57 100644
--- a/src/Framework/Core/AttributeMapper.php
+++ b/src/Framework/Core/AttributeMapper.php
@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace App\Framework\Core;
 
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 /**
  * Interface für AttributeMapper mit Framework Reflection Module
diff --git a/src/Framework/Core/AttributeMappingVisitor.php b/src/Framework/Core/AttributeMappingVisitor.php
index bf37d49f..716a4e69 100644
--- a/src/Framework/Core/AttributeMappingVisitor.php
+++ b/src/Framework/Core/AttributeMappingVisitor.php
@@ -10,7 +10,7 @@ use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Discovery\FileVisitor;
 use App\Framework\Discovery\ReflectionAwareVisitor;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Visitor zum Verarbeiten von Attributen in Klassen
diff --git a/src/Framework/Core/ContainerBootstrapper.php b/src/Framework/Core/ContainerBootstrapper.php
index 742f4e76..cf4bc4b4 100644
--- a/src/Framework/Core/ContainerBootstrapper.php
+++ b/src/Framework/Core/ContainerBootstrapper.php
@@ -25,7 +25,7 @@ use App\Framework\Logging\Logger;
 use App\Framework\Logging\LoggerInitializer;
 use App\Framework\Logging\LogLevel;
 use App\Framework\Performance\Contracts\PerformanceCollectorInterface;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Redis\RedisPoolInitializer;
 use App\Framework\Config\Environment;
 
diff --git a/src/Framework/Core/Events/EventHandlerMapper.php b/src/Framework/Core/Events/EventHandlerMapper.php
index bee8a25a..4773ea4a 100644
--- a/src/Framework/Core/Events/EventHandlerMapper.php
+++ b/src/Framework/Core/Events/EventHandlerMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\Core\Events;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 /**
  * Mapper für das OnEvent-Attribut
diff --git a/src/Framework/Core/Exceptions/InvalidRouteCacheFormatException.php b/src/Framework/Core/Exceptions/InvalidRouteCacheFormatException.php
index 818b80dd..88552178 100644
--- a/src/Framework/Core/Exceptions/InvalidRouteCacheFormatException.php
+++ b/src/Framework/Core/Exceptions/InvalidRouteCacheFormatException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Core\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class InvalidRouteCacheFormatException extends FrameworkException
@@ -16,8 +15,6 @@ final class InvalidRouteCacheFormatException extends FrameworkException
     ) {
         parent::__construct(
             message: "Invalid route cache format.",
-            context: ExceptionContext::forOperation('route_cache_parse', 'Core')
-                ->withData(['cacheFile' => $cacheFile]),
             code: $code,
             previous: $previous
         );
diff --git a/src/Framework/Core/Exceptions/RouteCacheException.php b/src/Framework/Core/Exceptions/RouteCacheException.php
index 8af6b824..2c27156a 100644
--- a/src/Framework/Core/Exceptions/RouteCacheException.php
+++ b/src/Framework/Core/Exceptions/RouteCacheException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Core\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class RouteCacheException extends FrameworkException
@@ -16,8 +15,6 @@ final class RouteCacheException extends FrameworkException
     ) {
         parent::__construct(
             message: "Route cache file not found: {$cacheFile}",
-            context: ExceptionContext::forOperation('route_cache_load', 'Core')
-                ->withData(['cacheFile' => $cacheFile]),
             code: $code,
             previous: $previous
         );
diff --git a/src/Framework/Core/InterfaceImplementationVisitor.php b/src/Framework/Core/InterfaceImplementationVisitor.php
index 0f1effe6..ae19fb63 100644
--- a/src/Framework/Core/InterfaceImplementationVisitor.php
+++ b/src/Framework/Core/InterfaceImplementationVisitor.php
@@ -10,7 +10,7 @@ use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Discovery\FileVisitor;
 use App\Framework\Discovery\ReflectionAwareVisitor;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Visitor zum Auffinden von Interface-Implementierungen
diff --git a/src/Framework/Core/RouteMapper.php b/src/Framework/Core/RouteMapper.php
index b9d8d921..c1d70c62 100644
--- a/src/Framework/Core/RouteMapper.php
+++ b/src/Framework/Core/RouteMapper.php
@@ -7,8 +7,8 @@ namespace App\Framework\Core;
 use App\Framework\Attributes\Route;
 use App\Framework\Console\ConsoleCommand;
 use App\Framework\Mcp\McpTool;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 use App\Framework\Router\ValueObjects\MethodParameter;
 use App\Framework\Router\ValueObjects\ParameterCollection;
 
diff --git a/src/Framework/Core/System/Ini/IniDirective.php b/src/Framework/Core/System/Ini/IniDirective.php
index b33dd255..090aa8bf 100644
--- a/src/Framework/Core/System/Ini/IniDirective.php
+++ b/src/Framework/Core/System/Ini/IniDirective.php
@@ -3,6 +3,8 @@ declare(strict_types=1);
 
 namespace App\Framework\Core\System\Ini;
 
+use Stringable;
+
 final readonly class IniDirective implements Stringable
 {
     public function __construct(
diff --git a/src/Framework/Core/ValueObjects/ClassName.php b/src/Framework/Core/ValueObjects/ClassName.php
index 955f9b86..e384b121 100644
--- a/src/Framework/Core/ValueObjects/ClassName.php
+++ b/src/Framework/Core/ValueObjects/ClassName.php
@@ -211,11 +211,11 @@ final readonly class ClassName implements Stringable
     }
 
     /**
-     * String representation (short name for readability)
+     * String representation (fully qualified class name)
      */
     public function __toString(): string
     {
-        return $this->shortName;
+        return $this->fullyQualified;
     }
 
     /**
diff --git a/src/Framework/Core/ValueObjects/LineNumber.php b/src/Framework/Core/ValueObjects/LineNumber.php
new file mode 100644
index 00000000..3e78d524
--- /dev/null
+++ b/src/Framework/Core/ValueObjects/LineNumber.php
@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Core\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Immutable line number value object
+ *
+ * Represents a line number in a file with validation (must be positive integer).
+ */
+final readonly class LineNumber
+{
+    private const int MIN_LINE = 1;
+    private const int MAX_LINE = 2147483647; // PHP_INT_MAX for 32-bit systems
+
+    public function __construct(
+        public int $value
+    ) {
+        $this->validate();
+    }
+
+    /**
+     * Create LineNumber from integer
+     */
+    public static function fromInt(int $line): self
+    {
+        return new self($line);
+    }
+
+    /**
+     * Create LineNumber from string (parses to int)
+     */
+    public static function fromString(string $line): self
+    {
+        if (!is_numeric($line)) {
+            throw new InvalidArgumentException("Line number must be numeric, got: {$line}");
+        }
+
+        return new self((int) $line);
+    }
+
+    /**
+     * Get line number as integer
+     */
+    public function toInt(): int
+    {
+        return $this->value;
+    }
+
+    /**
+     * String representation
+     */
+    public function __toString(): string
+    {
+        return (string) $this->value;
+    }
+
+    /**
+     * Check if two line numbers are equal
+     */
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    /**
+     * Check if this line number is greater than another
+     */
+    public function isGreaterThan(self $other): bool
+    {
+        return $this->value > $other->value;
+    }
+
+    /**
+     * Check if this line number is less than another
+     */
+    public function isLessThan(self $other): bool
+    {
+        return $this->value < $other->value;
+    }
+
+    /**
+     * Validate line number
+     */
+    private function validate(): void
+    {
+        if ($this->value < self::MIN_LINE) {
+            throw new InvalidArgumentException(
+                "Line number must be at least " . self::MIN_LINE . ", got: {$this->value}"
+            );
+        }
+
+        if ($this->value > self::MAX_LINE) {
+            throw new InvalidArgumentException(
+                "Line number exceeds maximum of " . self::MAX_LINE . ", got: {$this->value}"
+            );
+        }
+    }
+}
+
diff --git a/src/Framework/Core/ValueObjects/ReturnType.php b/src/Framework/Core/ValueObjects/ReturnType.php
new file mode 100644
index 00000000..99f7d84a
--- /dev/null
+++ b/src/Framework/Core/ValueObjects/ReturnType.php
@@ -0,0 +1,90 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Core\ValueObjects;
+
+/**
+ * Enum für spezielle Return-Types von Methoden
+ * 
+ * Repräsentiert spezielle PHP Return-Types (void, self, null).
+ * Konkrete Klassen werden als String behandelt, da sie dynamisch und unbekannt sind.
+ */
+enum ReturnType: string
+{
+    case VOID = 'void';
+    case SELF = 'self';
+    case NULL = 'null';
+
+    /**
+     * Konvertiert einen String zu einem Enum-Case
+     * Gibt null zurück wenn es eine konkrete Klasse ist
+     */
+    public static function fromString(?string $returnType): ?self
+    {
+        if ($returnType === null) {
+            return null;
+        }
+
+        return match ($returnType) {
+            'void' => self::VOID,
+            'self' => self::SELF,
+            'null' => self::NULL,
+            default => null, // Konkrete Klasse
+        };
+    }
+
+    /**
+     * Prüft ob es kein Return-Type hat (void oder null)
+     * Diese Methoden geben keinen Wert zurück
+     */
+    public function hasNoReturn(): bool
+    {
+        return $this === self::VOID || $this === self::NULL;
+    }
+
+    /**
+     * Prüft ob es eine konkrete Klasse zurückgibt (nicht void/null/self)
+     * Diese Methoden geben einen Wert zurück
+     */
+    public static function hasReturnValue(?string $returnType): bool
+    {
+        if ($returnType === null) {
+            return false;
+        }
+
+        $enum = self::fromString($returnType);
+        
+        // Wenn es kein Enum ist, ist es eine konkrete Klasse (gibt Wert zurück)
+        if ($enum === null) {
+            return true;
+        }
+
+        // SELF wird auch als Return-Wert behandelt
+        return $enum === self::SELF;
+    }
+
+    /**
+     * Prüft ob ein Return-Type kein Return hat (void oder null)
+     * (Helper-Methode für String-Input)
+     */
+    public static function hasNoReturnString(?string $returnType): bool
+    {
+        if ($returnType === null) {
+            return true; // null bedeutet auch kein Return
+        }
+
+        $enum = self::fromString($returnType);
+        
+        return $enum !== null && $enum->hasNoReturn();
+    }
+
+    /**
+     * Gibt die String-Repräsentation zurück
+     */
+    public function toString(): string
+    {
+        return $this->value;
+    }
+}
+
diff --git a/src/Framework/Core/ValueObjects/ReturnTypeValue.php b/src/Framework/Core/ValueObjects/ReturnTypeValue.php
new file mode 100644
index 00000000..4c6c69a5
--- /dev/null
+++ b/src/Framework/Core/ValueObjects/ReturnTypeValue.php
@@ -0,0 +1,181 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Core\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Value Object für Method Return-Types
+ * 
+ * Repräsentiert entweder spezielle Types (VOID, NULL, SELF) oder konkrete Klassen.
+ * Bietet type-safe API für alle Return-Type-Operationen.
+ * 
+ * Kann für Initializer, Methoden, Closures oder andere Funktionen verwendet werden.
+ */
+final readonly class ReturnTypeValue
+{
+    private function __construct(
+        private ?ReturnType $specialType,
+        private ?ClassName $className
+    ) {
+        // Validierung: Entweder specialType oder className muss gesetzt sein
+        if ($this->specialType === null && $this->className === null) {
+            throw new InvalidArgumentException('ReturnTypeValue must have either a special type or a className');
+        }
+
+        // SELF benötigt eine className
+        if ($this->specialType === ReturnType::SELF && $this->className === null) {
+            throw new InvalidArgumentException('SELF return type requires a declaring className');
+        }
+
+        // VOID und NULL sollten keine className haben
+        if (
+            ($this->specialType === ReturnType::VOID || $this->specialType === ReturnType::NULL)
+            && $this->className !== null
+        ) {
+            throw new InvalidArgumentException('VOID and NULL return types cannot have a className');
+        }
+    }
+
+    /**
+     * Factory für VOID Return-Type
+     */
+    public static function void(): self
+    {
+        return new self(ReturnType::VOID, null);
+    }
+
+    /**
+     * Factory für NULL Return-Type
+     */
+    public static function null(): self
+    {
+        return new self(ReturnType::NULL, null);
+    }
+
+    /**
+     * Factory für SELF Return-Type
+     */
+    public static function self(ClassName $declaringClass): self
+    {
+        return new self(ReturnType::SELF, $declaringClass);
+    }
+
+    /**
+     * Factory für konkrete Klasse
+     */
+    public static function concrete(ClassName $className): self
+    {
+        return new self(null, $className);
+    }
+
+    /**
+     * Konvertiert einen String zu einem ReturnTypeValue
+     * 
+     * @param string|null $returnType Der Return-Type als String
+     * @param ClassName|null $declaringClass Die deklarierende Klasse (benötigt für SELF)
+     */
+    public static function fromString(?string $returnType, ?ClassName $declaringClass = null): self
+    {
+        if ($returnType === null) {
+            return self::null();
+        }
+
+        $enum = ReturnType::fromString($returnType);
+
+        if ($enum === ReturnType::VOID) {
+            return self::void();
+        }
+
+        if ($enum === ReturnType::NULL) {
+            return self::null();
+        }
+
+        if ($enum === ReturnType::SELF) {
+            if ($declaringClass === null) {
+                throw new InvalidArgumentException('SELF return type requires a declaring class');
+            }
+            return self::self($declaringClass);
+        }
+
+        // Konkrete Klasse
+        return self::concrete(ClassName::create($returnType));
+    }
+
+    /**
+     * Prüft ob die Methode keinen Return hat (void oder null)
+     */
+    public function hasNoReturn(): bool
+    {
+        return $this->specialType !== null && $this->specialType->hasNoReturn();
+    }
+
+    /**
+     * Prüft ob es SELF ist
+     */
+    public function isSelf(): bool
+    {
+        return $this->specialType === ReturnType::SELF;
+    }
+
+    /**
+     * Prüft ob es eine konkrete Klasse ist
+     */
+    public function isConcrete(): bool
+    {
+        return $this->specialType === null;
+    }
+
+    /**
+     * Prüft ob die Methode einen Return-Wert hat (nicht void/null)
+     */
+    public function hasReturnValue(): bool
+    {
+        return ! $this->hasNoReturn();
+    }
+
+    /**
+     * Gibt die ClassName zurück (für SELF oder konkrete Klasse)
+     * 
+     * @throws InvalidArgumentException Wenn VOID oder NULL
+     */
+    public function toClassName(): ClassName
+    {
+        if ($this->className === null) {
+            throw new InvalidArgumentException('Cannot get ClassName for VOID or NULL return type');
+        }
+
+        return $this->className;
+    }
+
+    /**
+     * Gibt den speziellen Type zurück (falls vorhanden)
+     */
+    public function getSpecialType(): ?ReturnType
+    {
+        return $this->specialType;
+    }
+
+    /**
+     * Gibt die String-Repräsentation zurück
+     */
+    public function toString(): string
+    {
+        if ($this->specialType !== null) {
+            return $this->specialType->toString();
+        }
+
+        return $this->className->getFullyQualified();
+    }
+
+    /**
+     * String-Repräsentation für Debugging
+     */
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+
diff --git a/src/Framework/Core/Warmup/ContainerWarmupStrategy.php b/src/Framework/Core/Warmup/ContainerWarmupStrategy.php
index aea4010f..4a1939b7 100644
--- a/src/Framework/Core/Warmup/ContainerWarmupStrategy.php
+++ b/src/Framework/Core/Warmup/ContainerWarmupStrategy.php
@@ -11,7 +11,7 @@ use App\Framework\DI\ContainerCompiler;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\DI\DependencyResolver;
 use App\Framework\Logging\Logger;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 /**
  * Container Warmup Strategy
diff --git a/src/Framework/DI/ContainerCompiler.php b/src/Framework/DI/ContainerCompiler.php
index 6f3c7ae4..823d5cef 100644
--- a/src/Framework/DI/ContainerCompiler.php
+++ b/src/Framework/DI/ContainerCompiler.php
@@ -7,7 +7,7 @@ namespace App\Framework\DI;
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\DI\Dependency\Dependency;
 use App\Framework\DI\Dependency\DependencyType;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Compiles a Container into optimized PHP code for production use
diff --git a/src/Framework/DI/ContainerIntrospector.php b/src/Framework/DI/ContainerIntrospector.php
index 51f4f8f1..0c902363 100644
--- a/src/Framework/DI/ContainerIntrospector.php
+++ b/src/Framework/DI/ContainerIntrospector.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace App\Framework\DI;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 final readonly class ContainerIntrospector
 {
diff --git a/src/Framework/DI/DefaultContainer.php b/src/Framework/DI/DefaultContainer.php
index 6c101a2e..7fb2488e 100644
--- a/src/Framework/DI/DefaultContainer.php
+++ b/src/Framework/DI/DefaultContainer.php
@@ -14,13 +14,16 @@ use App\Framework\DI\Exceptions\ContainerException;
 use App\Framework\DI\Exceptions\CyclicDependencyException;
 use App\Framework\DI\Exceptions\LazyLoadingException;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
+use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
 use App\Framework\DI\FailedInitializerRegistry;
 use App\Framework\DI\ValueObjects\FailedInitializer;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
 use App\Framework\Metrics\FrameworkMetricsCollector;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
+use App\Framework\Reflection\SimpleReflectionService;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use Stringable;
 use Throwable;
 
@@ -54,7 +57,8 @@ final class DefaultContainer implements Container
             $this->reflectionProvider,
             $this->createInstance(...)
         );
-        $this->invoker = new MethodInvoker($this, $this->reflectionProvider);
+        $reflectionService = new SimpleReflectionService();
+        $this->invoker = new MethodInvoker($this, $reflectionService);
         $this->introspector = new ContainerIntrospector(
             $this,
             $this->instances,
@@ -67,6 +71,9 @@ final class DefaultContainer implements Container
 
         $this->registerSelf();
         $this->instance(ReflectionProvider::class, $this->reflectionProvider);
+        
+        // Register new ReflectionService (parallel to ReflectionLegacy for migration)
+        $this->instance(ReflectionService::class, new SimpleReflectionService());
     }
 
     public function bind(ClassName|Stringable|string $abstract, callable|string|object $concrete): void
@@ -197,12 +204,13 @@ final class DefaultContainer implements Container
 
         // Enhanced diagnostics for missing bindings
         try {
-            $reflection = $this->reflectionProvider->getClass($className);
+            $reflectionService = $this->get(ReflectionService::class);
+            $classInfo = $reflectionService->reflectClass($className);
 
             // Check if class is instantiable using the framework's method
-            if (! $reflection->isInstantiable()) {
+            if (! $classInfo->isInstantiable()) {
                 // Proaktive Suche nach Initializern für Interfaces
-                if ($reflection->isInterface() && $this->tryFindAndRegisterInitializer($class)) {
+                if ($classInfo->getNativeClass()->isInterface() && $this->tryFindAndRegisterInitializer($class)) {
                     // Initializer gefunden und registriert - versuche erneut zu resolven
                     return $this->get($class);
                 }
@@ -212,7 +220,7 @@ final class DefaultContainer implements Container
 
             $dependencies = $this->dependencyResolver->resolveDependencies($className);
 
-            return $reflection->newInstance(...$dependencies->toArray());
+            return $classInfo->newInstance(...$dependencies->toArray());
         } catch (ContainerException $e) {
             // If it's already a ContainerException, just re-throw
             throw $e;
@@ -233,15 +241,17 @@ final class DefaultContainer implements Container
 
         // Bestimme den Typ der Klasse mit Reflection
         $className = ClassName::create($class);
+        $reflectionService = $this->get(ReflectionService::class);
+        $classInfo = $reflectionService->reflectClass($className);
+        $reflectionClass = $classInfo->getNativeClass();
         $isInterface = false;
         $isAbstract = false;
         $isTrait = false;
 
         try {
-            $reflection = $this->reflectionProvider->getClass($className);
-            $isInterface = $reflection->isInterface();
-            $isAbstract = $reflection->isAbstract();
-            $isTrait = $reflection->isTrait();
+            $isInterface = $reflectionClass->isInterface();
+            $isAbstract = $reflectionClass->isAbstract();
+            $isTrait = $reflectionClass->isTrait();
         } catch (\Throwable $e) {
             // Fallback zu einfachen Prüfungen wenn Reflection fehlschlägt
             $isInterface = interface_exists($class);
@@ -269,7 +279,7 @@ final class DefaultContainer implements Container
                     // Spezielle Behandlung für Interfaces: Suche nach Initializern die dieses Interface zurückgeben
                     if ($isInterface) {
                         foreach ($initializerResults as $initializer) {
-                            $returnType = $initializer->additionalData['return'] ?? null;
+                            $returnType = $this->getInitializerReturnType($initializer);
                             if ($returnType === $class) {
                                 $matchingInitializers[] = $initializer->className->getFullyQualified();
                             }
@@ -363,7 +373,7 @@ final class DefaultContainer implements Container
 
                         if (! empty($initializerResults)) {
                             foreach ($initializerResults as $initializer) {
-                                $returnType = $initializer->additionalData['return'] ?? null;
+                                $returnType = $this->getInitializerReturnType($initializer);
                                 if ($returnType === $class) {
                                     $matchingInitializer = $initializer->className->getFullyQualified();
                                     break;
@@ -414,7 +424,8 @@ final class DefaultContainer implements Container
         }
         
         try {
-            return $this->reflectionProvider->getClass($className)->isInstantiable();
+            $reflectionService = $this->get(ReflectionService::class);
+            return $reflectionService->isInstantiable($className);
         } catch (\Throwable $e) {
             return false;
         }
@@ -608,4 +619,12 @@ final class DefaultContainer implements Container
             return null;
         }
     }
+
+    /**
+     * Extrahiert den Return-Type aus einem DiscoveredAttribute
+     */
+    private function getInitializerReturnType(DiscoveredAttribute $initializer): ?string
+    {
+        return $initializer->additionalData['return'] ?? null;
+    }
 }
diff --git a/src/Framework/DI/DependencyResolver.php b/src/Framework/DI/DependencyResolver.php
index 69e1678c..4a266984 100644
--- a/src/Framework/DI/DependencyResolver.php
+++ b/src/Framework/DI/DependencyResolver.php
@@ -12,8 +12,8 @@ use App\Framework\DI\Dependency\DependencyCollection;
 use App\Framework\DI\Dependency\DependencyType;
 use App\Framework\DI\Dependency\ResolvedParameter;
 use App\Framework\DI\Exceptions\ParameterResolutionException;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionParameter;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
+use App\Framework\ReflectionLegacy\WrappedReflectionParameter;
 use ReflectionType;
 
 /**
diff --git a/src/Framework/DI/Exceptions/ClassNotInstantiable.php b/src/Framework/DI/Exceptions/ClassNotInstantiable.php
index 10a6d5c4..12958afa 100644
--- a/src/Framework/DI/Exceptions/ClassNotInstantiable.php
+++ b/src/Framework/DI/Exceptions/ClassNotInstantiable.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 namespace App\Framework\DI\Exceptions;
 
 use App\Framework\DI\ValueObjects\FailedInitializer;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Thrown when a class cannot be instantiated because it's an interface, abstract class, or trait
@@ -94,7 +93,9 @@ final class ClassNotInstantiable extends ContainerException
                     $message .= "  - {$matching}\n";
                 }
                 $message .= "\n";
-            } else {
+            } elseif ($this->failedInitializer === null) {
+                // Nur "No initializers found" sagen, wenn kein failedInitializer vorhanden ist
+                // Wenn ein failedInitializer existiert, wird weiter unten angezeigt, dass der Initializer fehlgeschlagen ist
                 $message .= "No initializers found that return this interface.\n\n";
             }
 
@@ -153,23 +154,6 @@ final class ClassNotInstantiable extends ContainerException
             $message .= "No initializers discovered in DiscoveryRegistry.\n";
         }
 
-        $context = ExceptionContext::forOperation('class_instantiation', 'DI Container')
-            ->withData([
-                'class' => $this->class,
-                'dependencyChain' => $this->dependencyChain,
-                'availableBindings' => $this->availableBindings,
-                'similarBindings' => $this->similarBindings,
-                'discoveredInitializers' => $this->discoveredInitializers,
-                'matchingInitializers' => $this->matchingInitializers,
-                'suggestedInitializer' => $this->suggestedInitializer,
-                'failedInitializer' => $this->failedInitializer?->initializerClass->getFullyQualified(),
-                'bindingCount' => count($this->availableBindings),
-                'initializerCount' => count($this->discoveredInitializers),
-            ]);
-
-        parent::__construct(
-            message: $message,
-            context: $context
-        );
+        parent::__construct($message);
     }
 }
diff --git a/src/Framework/DI/Exceptions/ClassNotResolvableException.php b/src/Framework/DI/Exceptions/ClassNotResolvableException.php
index 022cc7a7..e8a3c26f 100644
--- a/src/Framework/DI/Exceptions/ClassNotResolvableException.php
+++ b/src/Framework/DI/Exceptions/ClassNotResolvableException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Thrown when a class cannot be resolved because it's not a valid class/interface and no binding exists
  */
@@ -23,18 +21,10 @@ final class ClassNotResolvableException extends ContainerException
         $message = "Cannot resolve '{$class}': not a valid class and no binding exists. " .
             "Available bindings: " . implode(', ', $availableBindings);
 
-        $context = ExceptionContext::forOperation('class_resolution', 'DI Container')
-            ->withData([
-                'class' => $class,
-                'availableBindings' => $availableBindings,
-                'bindingCount' => count($availableBindings),
-            ]);
-
         parent::__construct(
-            message: $message,
-            context: $context,
-            code: $code,
-            previous: $previous
+            $message,
+            $code,
+            $previous
         );
     }
 }
diff --git a/src/Framework/DI/Exceptions/ClassResolutionException.php b/src/Framework/DI/Exceptions/ClassResolutionException.php
index 9945e151..a9b23811 100644
--- a/src/Framework/DI/Exceptions/ClassResolutionException.php
+++ b/src/Framework/DI/Exceptions/ClassResolutionException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\DI\Exceptions;
 
 use App\Framework\DI\ValueObjects\FailedInitializer;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Thrown when a class cannot be resolved due to reflection or other errors
@@ -145,37 +144,10 @@ final class ClassResolutionException extends ContainerException
                 ". Dependency chain: {$dependencyChainStr}";
         }
 
-        $contextData = [
-            'class' => $class,
-            'reason' => $reason,
-            'availableBindings' => $availableBindings,
-            'dependencyChain' => $dependencyChain,
-            'bindingCount' => count($availableBindings),
-        ];
-
-        if ($bindingType !== null) {
-            $contextData['bindingType'] = $bindingType;
-        }
-
-        if ($this->failedInitializer !== null) {
-            $contextData['failedInitializer'] = $this->failedInitializer->initializerClass->getFullyQualified();
-            $contextData['failedReturnType'] = $this->failedInitializer->returnType->getFullyQualified();
-            $contextData['failedErrorMessage'] = $this->failedInitializer->errorMessage;
-            $contextData['failedExceptionClass'] = $this->failedInitializer->exceptionClass->getFullyQualified();
-        }
-
-        if ($this->matchingInitializer !== null) {
-            $contextData['matchingInitializer'] = $this->matchingInitializer;
-        }
-
-        $context = ExceptionContext::forOperation('class_resolution', 'DI Container')
-            ->withData($contextData);
-
         parent::__construct(
-            message: $message,
-            context: $context,
-            code: $code,
-            previous: $previous
+            $message,
+            $code,
+            $previous
         );
     }
 }
diff --git a/src/Framework/DI/Exceptions/ContainerException.php b/src/Framework/DI/Exceptions/ContainerException.php
index 908d3f3a..e0be6306 100644
--- a/src/Framework/DI/Exceptions/ContainerException.php
+++ b/src/Framework/DI/Exceptions/ContainerException.php
@@ -3,26 +3,23 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 class ContainerException extends FrameworkException
 {
     /**
-     * Simplified constructor for simple error messages
-     * Automatically creates an ExceptionContext for DI operations
+     * Base exception for all DI container errors
+     * Uses standard PHP exception constructor
      */
     public function __construct(
         string $message = '',
-        ?ExceptionContext $context = null,
         int $code = 0,
         ?\Throwable $previous = null
     ) {
         parent::__construct(
-            message: $message,
-            context: $context ?? ExceptionContext::forOperation('dependency_injection', 'DI Container'),
-            code: $code,
-            previous: $previous
+            $message,
+            $code,
+            $previous
         );
     }
 }
diff --git a/src/Framework/DI/Exceptions/CyclicDependencyException.php b/src/Framework/DI/Exceptions/CyclicDependencyException.php
index a43878dc..4b85e95e 100644
--- a/src/Framework/DI/Exceptions/CyclicDependencyException.php
+++ b/src/Framework/DI/Exceptions/CyclicDependencyException.php
@@ -6,7 +6,6 @@ namespace App\Framework\DI\Exceptions;
 
 use App\Framework\DI\Container;
 use App\Framework\DI\InitializerDependencyAnalyzer;
-use App\Framework\Exception\ExceptionContext;
 use Throwable;
 
 final class CyclicDependencyException extends ContainerException
@@ -48,22 +47,12 @@ final class CyclicDependencyException extends ContainerException
         $this->cycleStart = $cycleStart;
         $this->dependencyAnalyzer = $dependencyAnalyzer;
 
-        $context = ExceptionContext::forOperation('dependency_resolution', 'DI')
-            ->withData([
-                'dependencyChain' => $dependencyChain,
-                'class' => $class,
-                'cycle' => $this->cycle,
-                'cycleStart' => $this->cycleStart,
-            ]);
-
         $message = $this->buildMessage();
 
-        // ContainerException erwartet message als ersten Parameter und optional context
         parent::__construct(
-            message: $message,
-            context: $context,
-            code: $code,
-            previous: $previous
+            $message,
+            $code,
+            $previous
         );
     }
 
diff --git a/src/Framework/DI/Exceptions/DefaultImplementationException.php b/src/Framework/DI/Exceptions/DefaultImplementationException.php
index 69c72ae9..cab522e0 100644
--- a/src/Framework/DI/Exceptions/DefaultImplementationException.php
+++ b/src/Framework/DI/Exceptions/DefaultImplementationException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception thrown when DefaultImplementation attribute validation fails
  */
@@ -25,14 +23,7 @@ final class DefaultImplementationException extends ContainerException
             $interface
         );
 
-        $context = ExceptionContext::forOperation('default_implementation_validation', 'DI Container')
-            ->withData([
-                'className' => $className,
-                'interface' => $interface,
-                'errorType' => 'does_not_implement_interface',
-            ]);
-
-        return new self($message, $context);
+        return new self($message);
     }
 
     /**
@@ -48,13 +39,7 @@ final class DefaultImplementationException extends ContainerException
             $className
         );
 
-        $context = ExceptionContext::forOperation('default_implementation_validation', 'DI Container')
-            ->withData([
-                'className' => $className,
-                'errorType' => 'no_interfaces_implemented',
-            ]);
-
-        return new self($message, $context);
+        return new self($message);
     }
 
     /**
@@ -71,13 +56,6 @@ final class DefaultImplementationException extends ContainerException
             $interface
         );
 
-        $context = ExceptionContext::forOperation('default_implementation_validation', 'DI Container')
-            ->withData([
-                'className' => $className,
-                'interface' => $interface,
-                'errorType' => 'interface_does_not_exist',
-            ]);
-
-        return new self($message, $context);
+        return new self($message);
     }
 }
diff --git a/src/Framework/DI/Exceptions/InitializerCycleException.php b/src/Framework/DI/Exceptions/InitializerCycleException.php
index 456f0cae..11c97fc0 100644
--- a/src/Framework/DI/Exceptions/InitializerCycleException.php
+++ b/src/Framework/DI/Exceptions/InitializerCycleException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -16,7 +15,7 @@ final class InitializerCycleException extends FrameworkException
      * @param array<array<string>> $cycles Array von Cycles, jeder Cycle ist ein Array von Return-Types
      */
     public function __construct(
-        array $cycles,
+        private readonly array $cycles,
         int $code = 0,
         ?\Throwable $previous = null
     ) {
@@ -28,17 +27,10 @@ final class InitializerCycleException extends FrameworkException
         $message = 'Circular dependencies detected in initializers:' . PHP_EOL
             . implode(PHP_EOL, array_map(fn(string $m): string => '  - ' . $m, $messages));
 
-        $context = ExceptionContext::forOperation('initializer_dependency_resolution', 'DI')
-            ->withData([
-                'cycles' => $cycles,
-                'cycle_count' => count($cycles),
-            ]);
-
         parent::__construct(
-            message: $message,
-            context: $context,
-            code: $code,
-            previous: $previous
+            $message,
+            $code,
+            $previous
         );
     }
 
@@ -48,7 +40,7 @@ final class InitializerCycleException extends FrameworkException
      */
     public function getCycles(): array
     {
-        return $this->getData()['cycles'] ?? [];
+        return $this->cycles;
     }
 
     /**
@@ -56,7 +48,7 @@ final class InitializerCycleException extends FrameworkException
      */
     public function getCycleCount(): int
     {
-        return $this->getData()['cycle_count'] ?? 0;
+        return count($this->cycles);
     }
 }
 
diff --git a/src/Framework/DI/Exceptions/LazyLoadingException.php b/src/Framework/DI/Exceptions/LazyLoadingException.php
index 44cef6b7..1fa75207 100644
--- a/src/Framework/DI/Exceptions/LazyLoadingException.php
+++ b/src/Framework/DI/Exceptions/LazyLoadingException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class LazyLoadingException extends FrameworkException
@@ -16,7 +15,6 @@ final class LazyLoadingException extends FrameworkException
     ) {
         parent::__construct(
             message: "Lazy Loading wird für die Klasse $class nicht unterstützt",
-            context: ExceptionContext::forOperation('lazy_loading', 'DI')->withData(['class' => $class]),
             code: $code,
             previous: $previous
         );
diff --git a/src/Framework/DI/Exceptions/ParameterResolutionException.php b/src/Framework/DI/Exceptions/ParameterResolutionException.php
index edd2287c..4e637514 100644
--- a/src/Framework/DI/Exceptions/ParameterResolutionException.php
+++ b/src/Framework/DI/Exceptions/ParameterResolutionException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DI\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class ParameterResolutionException extends FrameworkException
@@ -24,19 +23,6 @@ final class ParameterResolutionException extends FrameworkException
             $message = "Cannot resolve parameter {$paramName} in $class because $reason";
         }
 
-        parent::__construct(
-            message: $message,
-            context: new ExceptionContext(
-                operation: 'dependency_injection',
-                component: 'DI Container',
-                data: [
-                    'paramName' => $paramName,
-                    'class' => $class,
-                    'dependencyChain' => $dependencyChain,
-                ]
-            ),
-            code: $code,
-            previous: $previous
-        );
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/DI/InitializerCacheUpdater.php b/src/Framework/DI/InitializerCacheUpdater.php
index e9b6453a..fc94ae48 100644
--- a/src/Framework/DI/InitializerCacheUpdater.php
+++ b/src/Framework/DI/InitializerCacheUpdater.php
@@ -16,7 +16,7 @@ use App\Framework\Discovery\ValueObjects\DiscoveryOptions;
 use App\Framework\Discovery\ValueObjects\ScanType;
 use App\Framework\Filesystem\FileSystemService;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Verantwortlich für das Update des Discovery Caches mit proaktiv gefundenen Initializern
diff --git a/src/Framework/DI/InitializerDependencyGraph.php b/src/Framework/DI/InitializerDependencyGraph.php
index ed1917a6..d2912097 100644
--- a/src/Framework/DI/InitializerDependencyGraph.php
+++ b/src/Framework/DI/InitializerDependencyGraph.php
@@ -6,9 +6,10 @@ namespace App\Framework\DI;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\MethodName;
+use App\Framework\Core\ValueObjects\ReturnType;
 use App\Framework\DI\Exceptions\InitializerCycleException;
 use App\Framework\DI\ValueObjects\DependencyGraphNode;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
 
 /**
  * Dependency Graph für Initializer-Ausführung
@@ -29,14 +30,15 @@ final class InitializerDependencyGraph
     private array $inStack = [];
 
     public function __construct(
-        private readonly ReflectionProvider $reflectionProvider,
+        private readonly ReflectionService $reflectionService,
     ) {
     }
 
     public function addInitializer(string $returnType, ClassName $className, MethodName $methodName): void
     {
-        if ($returnType === 'null' || $returnType === 'void') {
-            return; // Setup-Initializer werden sofort ausgeführt
+        // Setup-Initializer werden sofort ausgeführt, nicht zum Graph hinzugefügt
+        if (ReturnType::hasNoReturnString($returnType)) {
+            return;
         }
 
         $dependencies = $this->analyzeDependencies($className, $methodName);
@@ -122,17 +124,16 @@ final class InitializerDependencyGraph
     private function analyzeDependencies(ClassName $className, MethodName $methodName): array
     {
         try {
-            $reflection = $this->reflectionProvider->getClass($className);
-            $method = $reflection->getMethod($methodName->toString());
+            $parameters = $this->reflectionService->getMethodParameters($className, $methodName->toString());
             $dependencies = [];
 
-            foreach ($method->getParameters() as $parameter) {
+            foreach ($parameters as $parameter) {
                 $paramType = $parameter->getType();
-                if ($paramType instanceof \ReflectionNamedType) {
-                    $typeName = $paramType->getName();
 
-                    // Nur Klassen/Interfaces als Dependencies, keine primitiven Typen
-                    if (! empty($typeName) && ClassName::create($typeName)->exists()) {
+                // Nur Klassen/Interfaces als Dependencies, keine primitiven Typen
+                if ($paramType !== null && ! $paramType->isBuiltin()) {
+                    $typeName = $paramType->getName();
+                    if (ClassName::create($typeName)->exists()) {
                         $dependencies[] = $typeName;
                     }
                 }
diff --git a/src/Framework/DI/InitializerMapper.php b/src/Framework/DI/InitializerMapper.php
index f812c288..81be0dde 100644
--- a/src/Framework/DI/InitializerMapper.php
+++ b/src/Framework/DI/InitializerMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\DI;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 final readonly class InitializerMapper implements AttributeMapper
 {
@@ -24,7 +24,6 @@ final readonly class InitializerMapper implements AttributeMapper
                 'class' => $reflectionTarget->getDeclaringClass()->getFullyQualified(),
                 'return' => $this->getReturnTypeName($reflectionTarget),
                 'method' => $reflectionTarget->getName(),
-                'contexts' => $attributeInstance->contexts,
             ];
         }
 
@@ -34,7 +33,6 @@ final readonly class InitializerMapper implements AttributeMapper
                 'class' => $reflectionTarget->getName()->getFullyQualified(),
                 'return' => null,
                 'method' => null,
-                'contexts' => $attributeInstance->contexts,
             ];
         }
 
diff --git a/src/Framework/DI/LazyInstantiator.php b/src/Framework/DI/LazyInstantiator.php
index 847d90a9..cca49f89 100644
--- a/src/Framework/DI/LazyInstantiator.php
+++ b/src/Framework/DI/LazyInstantiator.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace App\Framework\DI;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use Closure;
 
 /**
diff --git a/src/Framework/DI/MethodInvoker.php b/src/Framework/DI/MethodInvoker.php
index b38d5399..4916d070 100644
--- a/src/Framework/DI/MethodInvoker.php
+++ b/src/Framework/DI/MethodInvoker.php
@@ -5,8 +5,7 @@ declare(strict_types=1);
 namespace App\Framework\DI;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\Reflection\ReflectionService;
 
 /**
  * Führt Methoden auf beliebigen Klassen mit automatischer Dependency Injection aus
@@ -17,9 +16,9 @@ final readonly class MethodInvoker
 
     public function __construct(
         private Container $container,
-        private ReflectionProvider $reflectionProvider
+        private ReflectionService $reflectionService
     ) {
-        $this->parameterResolver = new ParameterResolver($container, $reflectionProvider);
+        $this->parameterResolver = new ParameterResolver($container, $reflectionService);
     }
 
     /**
@@ -41,17 +40,16 @@ final readonly class MethodInvoker
     public function invokeOn(object $instance, string $methodName, array $overrides = []): mixed
     {
         $className = ClassName::fromObject($instance);
-        $reflection = $this->reflectionProvider->getClass($className);
+        $classInfo = $this->reflectionService->reflectClass($className);
 
-        if (! $reflection->hasMethod($methodName)) {
+        if (! $classInfo->hasMethod($methodName)) {
             throw new \InvalidArgumentException(
                 "Method $methodName does not exist on class " . $instance::class
             );
         }
 
-        // Framework WrappedReflectionMethod verwenden
-        $method = $this->reflectionProvider->getMethod($className, $methodName);
-        $nativeMethod = $this->reflectionProvider->getNativeMethod($className, $methodName);
+        $methodInfo = $this->reflectionService->reflectMethod($className, $methodName);
+        $nativeMethod = $methodInfo->getNativeMethod();
 
         if (! $nativeMethod->isPublic()) {
             throw new \InvalidArgumentException(
@@ -70,17 +68,16 @@ final readonly class MethodInvoker
     public function invokeStatic(string $className, string $methodName, array $overrides = []): mixed
     {
         $classNameObj = ClassName::create($className);
-        $reflection = $this->reflectionProvider->getClass($classNameObj);
+        $classInfo = $this->reflectionService->reflectClass($classNameObj);
 
-        if (! $reflection->hasMethod($methodName)) {
+        if (! $classInfo->hasMethod($methodName)) {
             throw new \InvalidArgumentException(
                 "Method '{$methodName}' does not exist on class '{$className}'"
             );
         }
 
-        // Framework WrappedReflectionMethod verwenden
-        $method = $this->reflectionProvider->getMethod($classNameObj, $methodName);
-        $nativeMethod = $this->reflectionProvider->getNativeMethod($classNameObj, $methodName);
+        $methodInfo = $this->reflectionService->reflectMethod($classNameObj, $methodName);
+        $nativeMethod = $methodInfo->getNativeMethod();
 
         if (! $nativeMethod->isStatic()) {
             throw new \InvalidArgumentException(
@@ -105,23 +102,23 @@ final readonly class MethodInvoker
     public function make(string $className, array $overrides = []): object
     {
         $classNameObj = ClassName::create($className);
-        $reflection = $this->reflectionProvider->getClass($classNameObj);
+        $classInfo = $this->reflectionService->reflectClass($classNameObj);
 
-        if (! $reflection->isInstantiable()) {
+        if (! $classInfo->isInstantiable()) {
             throw new \InvalidArgumentException(
                 "Class '{$className}' is not instantiable (interface, abstract class, or trait)"
             );
         }
 
         // Check if class has constructor
-        if (! $reflection->hasMethod('__construct')) {
-            return $reflection->newInstance();
+        if (! $classInfo->hasMethod('__construct')) {
+            return $classInfo->newInstance();
         }
 
         // Resolve constructor parameters with overrides
         $parameters = $this->resolveMethodParameters($classNameObj, '__construct', $overrides);
 
-        return $reflection->newInstance(...$parameters);
+        return $classInfo->newInstance(...$parameters);
     }
 
     /**
diff --git a/src/Framework/DI/ParameterResolver.php b/src/Framework/DI/ParameterResolver.php
index 5180ba09..edd91b89 100644
--- a/src/Framework/DI/ParameterResolver.php
+++ b/src/Framework/DI/ParameterResolver.php
@@ -8,8 +8,8 @@ use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\DI\Attributes\EnvAttributeResolver;
 use App\Framework\DI\Attributes\LogChannelAttributeResolver;
 use App\Framework\DI\Attributes\ParameterAttributeResolverRegistry;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionParameter;
+use App\Framework\Reflection\ParameterInfo;
+use App\Framework\Reflection\ReflectionService;
 
 /**
  * Löst Method-Parameter mit Unterstützung für Attributes auf
@@ -24,7 +24,7 @@ final readonly class ParameterResolver
 
     public function __construct(
         private Container $container,
-        private ReflectionProvider $reflectionProvider,
+        private ReflectionService $reflectionService,
         ?ParameterAttributeResolverRegistry $attributeResolverRegistry = null
     ) {
         // Erstelle Standard-Registry mit Default-Resolvern, wenn nicht angegeben
@@ -54,7 +54,7 @@ final readonly class ParameterResolver
         array $overrides = []
     ): array {
         $parameters = [];
-        $methodParameters = $this->reflectionProvider->getMethodParameters($className, $methodName);
+        $methodParameters = $this->reflectionService->getMethodParameters($className, $methodName);
 
         foreach ($methodParameters as $param) {
             $parameters[] = $this->resolveParameter($className, $methodName, $param, $overrides);
@@ -69,7 +69,7 @@ final readonly class ParameterResolver
     private function resolveParameter(
         ClassName $className,
         string $methodName,
-        WrappedReflectionParameter $param,
+        ParameterInfo $param,
         array $overrides
     ): mixed {
         $paramName = $param->getName();
@@ -125,15 +125,12 @@ final readonly class ParameterResolver
      * Registry aufgelöst.
      */
     private function resolveFromAttributes(
-        WrappedReflectionParameter $param,
+        ParameterInfo $param,
         ClassName $className,
         string $methodName
     ): mixed {
-        // Direkt native Reflection API nutzen für Attribute-Zugriff
-        $nativeParam = new \ReflectionParameter(
-            [$className->getFullyQualified(), $methodName],
-            $param->getPosition()
-        );
+        // Verwende native ReflectionParameter für Attribute-Zugriff
+        $nativeParam = $param->getNativeParameter();
 
         // Verwende Registry, um Attribute aufzulösen
         return $this->attributeResolverRegistry->resolve($nativeParam, $className, $methodName);
@@ -142,7 +139,7 @@ final readonly class ParameterResolver
     /**
      * Versucht Parameter über Type-Hint aufzulösen
      */
-    private function resolveFromType(WrappedReflectionParameter $param): mixed
+    private function resolveFromType(ParameterInfo $param): mixed
     {
         $typeName = $param->getTypeName();
 
@@ -160,7 +157,7 @@ final readonly class ParameterResolver
     /**
      * Prüft ob ein Parameter nullable ist und ein Interface/Class (nicht builtin) ist
      */
-    private function isNullableNonBuiltinType(WrappedReflectionParameter $param): bool
+    private function isNullableNonBuiltinType(ParameterInfo $param): bool
     {
         if (!$param->allowsNull()) {
             return false;
diff --git a/src/Framework/DI/ProactiveInitializerFinder.php b/src/Framework/DI/ProactiveInitializerFinder.php
index 6f1278ce..8950189f 100644
--- a/src/Framework/DI/ProactiveInitializerFinder.php
+++ b/src/Framework/DI/ProactiveInitializerFinder.php
@@ -16,7 +16,7 @@ use App\Framework\Filesystem\File;
 use App\Framework\Filesystem\FileScanner;
 use App\Framework\Filesystem\ValueObjects\FilePath;
 use App\Framework\Filesystem\ValueObjects\FilePattern;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Proaktive Suche nach Initializern für Interfaces
diff --git a/src/Framework/DI/SingletonDetector.php b/src/Framework/DI/SingletonDetector.php
index 3f016be8..5e3d151e 100644
--- a/src/Framework/DI/SingletonDetector.php
+++ b/src/Framework/DI/SingletonDetector.php
@@ -6,7 +6,7 @@ namespace App\Framework\DI;
 
 use App\Framework\Attributes\Singleton;
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Erkennt ob eine Klasse als Singleton markiert ist
diff --git a/src/Framework/Database/Browser/Discovery/DatabaseDiscovery.php b/src/Framework/Database/Browser/Discovery/DatabaseDiscovery.php
new file mode 100644
index 00000000..f41d8dfe
--- /dev/null
+++ b/src/Framework/Database/Browser/Discovery/DatabaseDiscovery.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\Discovery;
+
+use App\Framework\Database\Browser\ValueObjects\DatabaseMetadata;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class DatabaseDiscovery
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    /**
+     * Discover current database metadata
+     */
+    public function discoverCurrentDatabase(): DatabaseMetadata
+    {
+        $databaseName = $this->getCurrentDatabase();
+
+        // Get database metadata
+        $sql = "
+            SELECT
+                DEFAULT_CHARACTER_SET_NAME as charset,
+                DEFAULT_COLLATION_NAME as collation
+            FROM information_schema.SCHEMATA
+            WHERE SCHEMA_NAME = ?
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        // Get table count and size
+        $tableSql = "
+            SELECT
+                COUNT(*) as table_count,
+                ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) as size_mb
+            FROM information_schema.tables
+            WHERE table_schema = ?
+        ";
+
+        $tableQuery = SqlQuery::create($tableSql, [$databaseName]);
+        $tableResult = $this->connection->query($tableQuery);
+        $tableRow = $tableResult->fetch();
+
+        return new DatabaseMetadata(
+            name: $databaseName,
+            charset: $row['charset'] ?? null,
+            collation: $row['collation'] ?? null,
+            tableCount: isset($tableRow['table_count']) ? (int) $tableRow['table_count'] : null,
+            sizeMb: isset($tableRow['size_mb']) ? (float) $tableRow['size_mb'] : null,
+        );
+    }
+
+    /**
+     * Get current database name
+     */
+    public function getCurrentDatabase(): string
+    {
+        $sql = "SELECT DATABASE() as db";
+        $query = SqlQuery::create($sql, []);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row['db'] ?? 'unknown';
+    }
+}
+
diff --git a/src/Framework/Database/Browser/Discovery/SchemaDiscovery.php b/src/Framework/Database/Browser/Discovery/SchemaDiscovery.php
new file mode 100644
index 00000000..31322d1c
--- /dev/null
+++ b/src/Framework/Database/Browser/Discovery/SchemaDiscovery.php
@@ -0,0 +1,201 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\Discovery;
+
+use App\Framework\Database\Browser\ValueObjects\ColumnMetadata;
+use App\Framework\Database\Browser\ValueObjects\ForeignKeyMetadata;
+use App\Framework\Database\Browser\ValueObjects\IndexMetadata;
+use App\Framework\Database\Browser\ValueObjects\TableMetadata;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class SchemaDiscovery
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    /**
+     * Discover complete schema for a table (columns, indexes, foreign keys)
+     */
+    public function discoverTableSchema(string $tableName): ?TableMetadata
+    {
+        $databaseName = $this->getCurrentDatabase();
+
+        // Get basic table info
+        $tableSql = "
+            SELECT
+                table_name,
+                table_rows,
+                ROUND((data_length + index_length) / 1024 / 1024, 2) as size_mb,
+                engine,
+                table_collation
+            FROM information_schema.tables
+            WHERE table_schema = ?
+            AND table_name = ?
+        ";
+
+        $tableQuery = SqlQuery::create($tableSql, [$databaseName, $tableName]);
+        $tableResult = $this->connection->query($tableQuery);
+        $tableRow = $tableResult->fetch();
+
+        if ($tableRow === null) {
+            return null;
+        }
+
+        // Get columns
+        $columns = $this->discoverColumns($tableName, $databaseName);
+
+        // Get indexes
+        $indexes = $this->discoverIndexes($tableName, $databaseName);
+
+        // Get foreign keys
+        $foreignKeys = $this->discoverForeignKeys($tableName, $databaseName);
+
+        return new TableMetadata(
+            name: $tableRow['table_name'],
+            rowCount: isset($tableRow['table_rows']) ? (int) $tableRow['table_rows'] : null,
+            sizeMb: isset($tableRow['size_mb']) ? (float) $tableRow['size_mb'] : null,
+            engine: $tableRow['engine'] ?? null,
+            collation: $tableRow['table_collation'] ?? null,
+            columns: $columns,
+            indexes: $indexes,
+            foreignKeys: $foreignKeys,
+        );
+    }
+
+    /**
+     * Discover columns for a table
+     *
+     * @return array<ColumnMetadata>
+     */
+    public function discoverColumns(string $tableName, ?string $databaseName = null): array
+    {
+        $databaseName ??= $this->getCurrentDatabase();
+
+        $sql = "
+            SELECT
+                column_name,
+                column_type,
+                is_nullable,
+                column_default,
+                column_key,
+                extra,
+                ordinal_position
+            FROM information_schema.columns
+            WHERE table_schema = ?
+            AND table_name = ?
+            ORDER BY ordinal_position
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName, $tableName]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        $columns = [];
+        foreach ($rows as $row) {
+            $columns[] = ColumnMetadata::fromArray($row);
+        }
+
+        return $columns;
+    }
+
+    /**
+     * Discover indexes for a table
+     *
+     * @return array<IndexMetadata>
+     */
+    public function discoverIndexes(string $tableName, ?string $databaseName = null): array
+    {
+        $databaseName ??= $this->getCurrentDatabase();
+
+        $sql = "
+            SELECT
+                index_name,
+                column_name,
+                non_unique,
+                index_type
+            FROM information_schema.statistics
+            WHERE table_schema = ?
+            AND table_name = ?
+            ORDER BY index_name, seq_in_index
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName, $tableName]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        // Group indexes by name
+        $grouped = [];
+        foreach ($rows as $row) {
+            $name = $row['index_name'];
+            if (!isset($grouped[$name])) {
+                $grouped[$name] = [
+                    'index_name' => $name,
+                    'non_unique' => $row['non_unique'],
+                    'index_type' => $row['index_type'],
+                    'columns' => [],
+                ];
+            }
+            $grouped[$name]['columns'][] = $row['column_name'];
+        }
+
+        $indexes = [];
+        foreach ($grouped as $indexData) {
+            $indexes[] = IndexMetadata::fromArray($indexData);
+        }
+
+        return $indexes;
+    }
+
+    /**
+     * Discover foreign keys for a table
+     *
+     * @return array<ForeignKeyMetadata>
+     */
+    public function discoverForeignKeys(string $tableName, ?string $databaseName = null): array
+    {
+        $databaseName ??= $this->getCurrentDatabase();
+
+        $sql = "
+            SELECT
+                constraint_name,
+                column_name,
+                referenced_table_name,
+                referenced_column_name
+            FROM information_schema.key_column_usage
+            WHERE table_schema = ?
+            AND table_name = ?
+            AND referenced_table_name IS NOT NULL
+            ORDER BY constraint_name
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName, $tableName]);
+        $result = $this->connection->query($query);
+        $rows = $result->fetchAll();
+
+        $foreignKeys = [];
+        foreach ($rows as $row) {
+            $foreignKeys[] = ForeignKeyMetadata::fromArray($row);
+        }
+
+        return $foreignKeys;
+    }
+
+    /**
+     * Get current database name
+     */
+    private function getCurrentDatabase(): string
+    {
+        $sql = "SELECT DATABASE() as db";
+        $query = SqlQuery::create($sql, []);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row['db'] ?? 'unknown';
+    }
+}
+
diff --git a/src/Framework/Database/Browser/Discovery/TableDiscovery.php b/src/Framework/Database/Browser/Discovery/TableDiscovery.php
new file mode 100644
index 00000000..b2c09f52
--- /dev/null
+++ b/src/Framework/Database/Browser/Discovery/TableDiscovery.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\Discovery;
+
+use App\Framework\Database\Browser\ValueObjects\TableMetadata;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\ValueObjects\SqlQuery;
+
+final readonly class TableDiscovery
+{
+    public function __construct(
+        private ConnectionInterface $connection
+    ) {
+    }
+
+    /**
+     * Discover all tables in the current database
+     *
+     * @return array<TableMetadata>
+     */
+    public function discoverAllTables(): array
+    {
+        $databaseName = $this->getCurrentDatabase();
+
+        $sql = "
+            SELECT
+                table_name,
+                table_rows,
+                ROUND((data_length + index_length) / 1024 / 1024, 2) as size_mb,
+                engine,
+                table_collation
+            FROM information_schema.tables
+            WHERE table_schema = ?
+            AND table_type = 'BASE TABLE'
+            ORDER BY table_name
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName]);
+        $result = $this->connection->query($query);
+        $tables = $result->fetchAll();
+
+        $tableMetadata = [];
+        foreach ($tables as $tableData) {
+            $tableMetadata[] = new TableMetadata(
+                name: $tableData['table_name'],
+                rowCount: isset($tableData['table_rows']) ? (int) $tableData['table_rows'] : null,
+                sizeMb: isset($tableData['size_mb']) ? (float) $tableData['size_mb'] : null,
+                engine: $tableData['engine'] ?? null,
+                collation: $tableData['table_collation'] ?? null,
+            );
+        }
+
+        return $tableMetadata;
+    }
+
+    /**
+     * Discover a specific table by name
+     */
+    public function discoverTable(string $tableName): ?TableMetadata
+    {
+        $databaseName = $this->getCurrentDatabase();
+
+        $sql = "
+            SELECT
+                table_name,
+                table_rows,
+                ROUND((data_length + index_length) / 1024 / 1024, 2) as size_mb,
+                engine,
+                table_collation
+            FROM information_schema.tables
+            WHERE table_schema = ?
+            AND table_name = ?
+        ";
+
+        $query = SqlQuery::create($sql, [$databaseName, $tableName]);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        if ($row === null) {
+            return null;
+        }
+
+        return new TableMetadata(
+            name: $row['table_name'],
+            rowCount: isset($row['table_rows']) ? (int) $row['table_rows'] : null,
+            sizeMb: isset($row['size_mb']) ? (float) $row['size_mb'] : null,
+            engine: $row['engine'] ?? null,
+            collation: $row['table_collation'] ?? null,
+        );
+    }
+
+    /**
+     * Get current database name
+     */
+    private function getCurrentDatabase(): string
+    {
+        $sql = "SELECT DATABASE() as db";
+        $query = SqlQuery::create($sql, []);
+        $result = $this->connection->query($query);
+        $row = $result->fetch();
+
+        return $row['db'] ?? 'unknown';
+    }
+}
+
diff --git a/src/Framework/Database/Browser/Registry/DatabaseRegistry.php b/src/Framework/Database/Browser/Registry/DatabaseRegistry.php
new file mode 100644
index 00000000..ae6ae717
--- /dev/null
+++ b/src/Framework/Database/Browser/Registry/DatabaseRegistry.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\Registry;
+
+use App\Framework\Database\Browser\Discovery\DatabaseDiscovery;
+use App\Framework\Database\Browser\ValueObjects\DatabaseMetadata;
+
+final readonly class DatabaseRegistry
+{
+    private ?DatabaseMetadata $currentDatabase;
+
+    public function __construct(
+        private DatabaseDiscovery $databaseDiscovery
+    ) {
+    }
+
+    /**
+     * Get current database metadata
+     */
+    public function getCurrentDatabase(): DatabaseMetadata
+    {
+        if ($this->currentDatabase === null) {
+            $this->currentDatabase = $this->databaseDiscovery->discoverCurrentDatabase();
+        }
+
+        return $this->currentDatabase;
+    }
+
+    /**
+     * Clear cache
+     */
+    public function clearCache(): void
+    {
+        $this->currentDatabase = null;
+    }
+}
+
diff --git a/src/Framework/Database/Browser/Registry/TableRegistry.php b/src/Framework/Database/Browser/Registry/TableRegistry.php
new file mode 100644
index 00000000..195552af
--- /dev/null
+++ b/src/Framework/Database/Browser/Registry/TableRegistry.php
@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\Registry;
+
+use App\Framework\Database\Browser\Discovery\SchemaDiscovery;
+use App\Framework\Database\Browser\Discovery\TableDiscovery;
+use App\Framework\Database\Browser\ValueObjects\TableMetadata;
+
+final class TableRegistry
+{
+    /** @var array<string, TableMetadata> */
+    private array $tableCache = [];
+
+    /** @var array<string, TableMetadata> */
+    private array $schemaCache = [];
+
+    private bool $allTablesLoaded = false;
+
+    public function __construct(
+        private readonly TableDiscovery $tableDiscovery,
+        private readonly SchemaDiscovery $schemaDiscovery
+    ) {
+    }
+
+    /**
+     * Get all tables (basic metadata)
+     *
+     * @return array<TableMetadata>
+     */
+    public function getAllTables(): array
+    {
+        if (!$this->allTablesLoaded) {
+            $tables = $this->tableDiscovery->discoverAllTables();
+            foreach ($tables as $table) {
+                $this->tableCache[$table->name] = $table;
+            }
+            $this->allTablesLoaded = true;
+        }
+
+        return array_values($this->tableCache);
+    }
+
+    /**
+     * Get a specific table by name (basic metadata)
+     */
+    public function getTable(string $tableName): ?TableMetadata
+    {
+        if (isset($this->tableCache[$tableName])) {
+            return $this->tableCache[$tableName];
+        }
+
+        $table = $this->tableDiscovery->discoverTable($tableName);
+        if ($table !== null) {
+            $this->tableCache[$tableName] = $table;
+        }
+
+        return $table;
+    }
+
+    /**
+     * Get complete schema for a table (with columns, indexes, foreign keys)
+     */
+    public function getTableSchema(string $tableName): ?TableMetadata
+    {
+        if (isset($this->schemaCache[$tableName])) {
+            return $this->schemaCache[$tableName];
+        }
+
+        $schema = $this->schemaDiscovery->discoverTableSchema($tableName);
+        if ($schema !== null) {
+            $this->schemaCache[$tableName] = $schema;
+            // Also update basic cache
+            $this->tableCache[$tableName] = $schema;
+        }
+
+        return $schema;
+    }
+
+    /**
+     * Clear cache for a specific table
+     */
+    public function clearTableCache(string $tableName): void
+    {
+        unset($this->tableCache[$tableName]);
+        unset($this->schemaCache[$tableName]);
+    }
+
+    /**
+     * Clear all caches
+     */
+    public function clearCache(): void
+    {
+        $this->tableCache = [];
+        $this->schemaCache = [];
+        $this->allTablesLoaded = false;
+    }
+}
+
diff --git a/src/Framework/Database/Browser/ValueObjects/ColumnMetadata.php b/src/Framework/Database/Browser/ValueObjects/ColumnMetadata.php
new file mode 100644
index 00000000..111449c6
--- /dev/null
+++ b/src/Framework/Database/Browser/ValueObjects/ColumnMetadata.php
@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\ValueObjects;
+
+final readonly class ColumnMetadata
+{
+    public function __construct(
+        public string $name,
+        public string $type,
+        public bool $nullable,
+        public ?string $default = null,
+        public ?string $key = null,
+        public ?string $extra = null,
+        public int $position = 0,
+    ) {
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            name: $data['column_name'] ?? '',
+            type: $data['column_type'] ?? $data['type'] ?? '',
+            nullable: ($data['is_nullable'] ?? $data['nullable'] ?? 'NO') === 'YES',
+            default: $data['column_default'] ?? $data['default'] ?? null,
+            key: $data['column_key'] ?? $data['key'] ?? null,
+            extra: $data['extra'] ?? null,
+            position: isset($data['ordinal_position']) ? (int) $data['ordinal_position'] : 0,
+        );
+    }
+
+    public function isPrimaryKey(): bool
+    {
+        return $this->key === 'PRI';
+    }
+
+    public function isUnique(): bool
+    {
+        return $this->key === 'UNI';
+    }
+
+    public function isIndexed(): bool
+    {
+        return $this->key !== null && $this->key !== '';
+    }
+
+    public function isAutoIncrement(): bool
+    {
+        return $this->extra !== null && str_contains($this->extra, 'auto_increment');
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'type' => $this->type,
+            'nullable' => $this->nullable,
+            'default' => $this->default,
+            'key' => $this->key,
+            'extra' => $this->extra,
+            'position' => $this->position,
+            'is_primary_key' => $this->isPrimaryKey(),
+            'is_unique' => $this->isUnique(),
+            'is_indexed' => $this->isIndexed(),
+            'is_auto_increment' => $this->isAutoIncrement(),
+        ];
+    }
+}
+
diff --git a/src/Framework/Database/Browser/ValueObjects/DatabaseMetadata.php b/src/Framework/Database/Browser/ValueObjects/DatabaseMetadata.php
new file mode 100644
index 00000000..b00517a8
--- /dev/null
+++ b/src/Framework/Database/Browser/ValueObjects/DatabaseMetadata.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\ValueObjects;
+
+final readonly class DatabaseMetadata
+{
+    public function __construct(
+        public string $name,
+        public ?string $engine = null,
+        public ?string $charset = null,
+        public ?string $collation = null,
+        public ?int $tableCount = null,
+        public ?float $sizeMb = null,
+    ) {
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            name: $data['name'] ?? $data['database'] ?? '',
+            engine: $data['engine'] ?? null,
+            charset: $data['charset'] ?? null,
+            collation: $data['collation'] ?? null,
+            tableCount: isset($data['table_count']) ? (int) $data['table_count'] : null,
+            sizeMb: isset($data['size_mb']) ? (float) $data['size_mb'] : null,
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'engine' => $this->engine,
+            'charset' => $this->charset,
+            'collation' => $this->collation,
+            'table_count' => $this->tableCount,
+            'size_mb' => $this->sizeMb,
+        ];
+    }
+}
+
diff --git a/src/Framework/Database/Browser/ValueObjects/ForeignKeyMetadata.php b/src/Framework/Database/Browser/ValueObjects/ForeignKeyMetadata.php
new file mode 100644
index 00000000..47fda8ca
--- /dev/null
+++ b/src/Framework/Database/Browser/ValueObjects/ForeignKeyMetadata.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\ValueObjects;
+
+final readonly class ForeignKeyMetadata
+{
+    public function __construct(
+        public string $name,
+        public string $column,
+        public string $referencedTable,
+        public string $referencedColumn,
+    ) {
+    }
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            name: $data['constraint_name'] ?? $data['name'] ?? '',
+            column: $data['column_name'] ?? $data['column'] ?? '',
+            referencedTable: $data['referenced_table_name'] ?? $data['referenced_table'] ?? '',
+            referencedColumn: $data['referenced_column_name'] ?? $data['referenced_column'] ?? '',
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'column' => $this->column,
+            'referenced_table' => $this->referencedTable,
+            'referenced_column' => $this->referencedColumn,
+        ];
+    }
+}
+
diff --git a/src/Framework/Database/Browser/ValueObjects/IndexMetadata.php b/src/Framework/Database/Browser/ValueObjects/IndexMetadata.php
new file mode 100644
index 00000000..fd9aae2a
--- /dev/null
+++ b/src/Framework/Database/Browser/ValueObjects/IndexMetadata.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\ValueObjects;
+
+final readonly class IndexMetadata
+{
+    /**
+     * @param array<string> $columns
+     */
+    public function __construct(
+        public string $name,
+        public array $columns,
+        public bool $unique,
+        public ?string $type = null,
+    ) {
+    }
+
+    public static function fromArray(array $data): self
+    {
+        $columns = $data['columns'] ?? [];
+        if (!is_array($columns)) {
+            $columns = [$columns];
+        }
+
+        return new self(
+            name: $data['index_name'] ?? $data['name'] ?? '',
+            columns: $columns,
+            unique: ($data['non_unique'] ?? null) === 0 || ($data['unique'] ?? false) === true,
+            type: $data['index_type'] ?? $data['type'] ?? null,
+        );
+    }
+
+    public function isPrimary(): bool
+    {
+        return $this->name === 'PRIMARY';
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'columns' => $this->columns,
+            'unique' => $this->unique,
+            'type' => $this->type,
+            'is_primary' => $this->isPrimary(),
+        ];
+    }
+}
+
diff --git a/src/Framework/Database/Browser/ValueObjects/TableMetadata.php b/src/Framework/Database/Browser/ValueObjects/TableMetadata.php
new file mode 100644
index 00000000..961c89a0
--- /dev/null
+++ b/src/Framework/Database/Browser/ValueObjects/TableMetadata.php
@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Database\Browser\ValueObjects;
+
+/**
+ * @param ColumnMetadata[] $columns
+ * @param IndexMetadata[] $indexes
+ * @param ForeignKeyMetadata[] $foreignKeys
+ */
+final readonly class TableMetadata
+{
+    /**
+     * @param array<ColumnMetadata> $columns
+     * @param array<IndexMetadata> $indexes
+     * @param array<ForeignKeyMetadata> $foreignKeys
+     */
+    public function __construct(
+        public string $name,
+        public ?int $rowCount = null,
+        public ?float $sizeMb = null,
+        public ?string $engine = null,
+        public ?string $collation = null,
+        public array $columns = [],
+        public array $indexes = [],
+        public array $foreignKeys = [],
+    ) {
+    }
+
+    public static function fromArray(array $data): self
+    {
+        $columns = [];
+        if (isset($data['columns']) && is_array($data['columns'])) {
+            foreach ($data['columns'] as $columnData) {
+                $columns[] = ColumnMetadata::fromArray($columnData);
+            }
+        }
+
+        $indexes = [];
+        if (isset($data['indexes']) && is_array($data['indexes'])) {
+            foreach ($data['indexes'] as $indexData) {
+                $indexes[] = IndexMetadata::fromArray($indexData);
+            }
+        }
+
+        $foreignKeys = [];
+        if (isset($data['foreign_keys']) && is_array($data['foreign_keys'])) {
+            foreach ($data['foreign_keys'] as $fkData) {
+                $foreignKeys[] = ForeignKeyMetadata::fromArray($fkData);
+            }
+        }
+
+        return new self(
+            name: $data['table_name'] ?? $data['name'] ?? '',
+            rowCount: isset($data['table_rows']) ? (int) $data['table_rows'] : ($data['row_count'] ?? null),
+            sizeMb: isset($data['size_mb']) ? (float) $data['size_mb'] : null,
+            engine: $data['engine'] ?? null,
+            collation: $data['table_collation'] ?? $data['collation'] ?? null,
+            columns: $columns,
+            indexes: $indexes,
+            foreignKeys: $foreignKeys,
+        );
+    }
+
+    public function getPrimaryKeyColumns(): array
+    {
+        $primaryKeys = [];
+        foreach ($this->columns as $column) {
+            if ($column->isPrimaryKey()) {
+                $primaryKeys[] = $column;
+            }
+        }
+        return $primaryKeys;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'row_count' => $this->rowCount,
+            'size_mb' => $this->sizeMb,
+            'engine' => $this->engine,
+            'collation' => $this->collation,
+            'columns' => array_map(fn (ColumnMetadata $c) => $c->toArray(), $this->columns),
+            'indexes' => array_map(fn (IndexMetadata $i) => $i->toArray(), $this->indexes),
+            'foreign_keys' => array_map(fn (ForeignKeyMetadata $fk) => $fk->toArray(), $this->foreignKeys),
+        ];
+    }
+}
+
diff --git a/src/Framework/Database/Exception/ConnectionFailedException.php b/src/Framework/Database/Exception/ConnectionFailedException.php
index 61fdf477..1f64c07e 100644
--- a/src/Framework/Database/Exception/ConnectionFailedException.php
+++ b/src/Framework/Database/Exception/ConnectionFailedException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Connection Failed Exception
@@ -40,19 +38,11 @@ final class ConnectionFailedException extends DatabaseException
     ): self {
         $message = "Failed to connect to database '{$database}' on '{$host}': {$errorMessage}";
 
-        $context = ExceptionContext::forOperation('connection.establish', 'DatabaseConnection')
-            ->withData([
-                'host' => $host,
-                'database' => $database,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ])
-            ->withDebug([
-                'sqlstate_class' => $sqlState->getClass(),
-                'sqlstate_subclass' => $sqlState->getSubclass(),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, $previous, 500, $sqlState);
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -69,17 +59,10 @@ final class ConnectionFailedException extends DatabaseException
             ? "Database connection '{$connectionId}' does not exist or has been closed"
             : 'Database connection does not exist or has been closed';
 
-        $context = ExceptionContext::forOperation('connection.use', 'DatabaseConnection')
-            ->withData([
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
-        if ($connectionId !== null) {
-            $context = $context->withData(['connection_id' => $connectionId]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -102,19 +85,10 @@ final class ConnectionFailedException extends DatabaseException
             $message .= ": {$rejectionReason}";
         }
 
-        $context = ExceptionContext::forOperation('connection.authenticate', 'DatabaseConnection')
-            ->withData([
-                'host' => $host,
-                'username' => $username,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
-        if ($rejectionReason !== null) {
-            $context = $context->withDebug(['rejection_reason' => $rejectionReason]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -129,18 +103,14 @@ final class ConnectionFailedException extends DatabaseException
     ): self {
         $message = 'Database connection failed during transaction - transaction has been rolled back';
 
-        $context = ExceptionContext::forOperation('connection.transaction', 'DatabaseConnection')
-            ->withData([
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-                'transaction_rolled_back' => true,
-            ]);
-
         if ($transactionId !== null) {
-            $context = $context->withData(['transaction_id' => $transactionId]);
+            $message .= " (transaction: {$transactionId})";
         }
 
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -157,15 +127,10 @@ final class ConnectionFailedException extends DatabaseException
     ): self {
         $message = "Connection to database at '{$host}' timed out after {$timeoutSeconds} seconds";
 
-        $context = ExceptionContext::forOperation('connection.establish', 'DatabaseConnection')
-            ->withData([
-                'host' => $host,
-                'timeout_seconds' => $timeoutSeconds,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -180,19 +145,14 @@ final class ConnectionFailedException extends DatabaseException
     ): self {
         $message = 'Database connection lost unexpectedly';
 
-        $context = ExceptionContext::forOperation('connection.lost', 'DatabaseConnection')
-            ->withData([
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
         if ($lastQuery !== null) {
-            $context = $context->withDebug([
-                'last_query' => self::truncateQuery($lastQuery),
-            ]);
+            $message .= ' (last query: ' . self::truncateQuery($lastQuery) . ')';
         }
 
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -209,15 +169,10 @@ final class ConnectionFailedException extends DatabaseException
     ): self {
         $message = "Too many connections to database at '{$host}' - maximum {$maxConnections} connections allowed";
 
-        $context = ExceptionContext::forOperation('connection.establish', 'DatabaseConnection')
-            ->withData([
-                'host' => $host,
-                'max_connections' => $maxConnections,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::POOL_EXHAUSTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -238,18 +193,10 @@ final class ConnectionFailedException extends DatabaseException
             $message .= ": {$sslError}";
         }
 
-        $context = ExceptionContext::forOperation('connection.ssl', 'DatabaseConnection')
-            ->withData([
-                'host' => $host,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Connection Exception',
-            ]);
-
-        if ($sslError !== null) {
-            $context = $context->withDebug(['ssl_error' => $sslError]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONNECTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
diff --git a/src/Framework/Database/Exception/ConstraintViolationException.php b/src/Framework/Database/Exception/ConstraintViolationException.php
index ac9b4e30..0b4e0cb1 100644
--- a/src/Framework/Database/Exception/ConstraintViolationException.php
+++ b/src/Framework/Database/Exception/ConstraintViolationException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Constraint Violation Exception
@@ -42,14 +40,11 @@ final class ConstraintViolationException extends DatabaseException
             $message .= ": {$errorMessage}";
         }
 
-        $context = ExceptionContext::forOperation('constraint.validate', 'Database')
-            ->withData([
-                'constraint_name' => $constraintName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, $previous, 500, $sqlState);
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -68,19 +63,10 @@ final class ConstraintViolationException extends DatabaseException
     ): self {
         $message = "Unique constraint violation on '{$table}.{$column}': value already exists";
 
-        $context = ExceptionContext::forOperation('constraint.unique', 'Database')
-            ->withData([
-                'table' => $table,
-                'column' => $column,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'unique',
-            ])
-            ->withDebug([
-                'duplicate_value' => self::sanitizeValue($value),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -102,20 +88,10 @@ final class ConstraintViolationException extends DatabaseException
         $message = "Foreign key constraint violation on '{$table}.{$foreignKey}': " .
                    "referenced record in '{$referencedTable}' does not exist";
 
-        $context = ExceptionContext::forOperation('constraint.foreign_key', 'Database')
-            ->withData([
-                'table' => $table,
-                'foreign_key' => $foreignKey,
-                'referenced_table' => $referencedTable,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'foreign_key',
-            ])
-            ->withDebug([
-                'violating_value' => self::sanitizeValue($value),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -135,20 +111,10 @@ final class ConstraintViolationException extends DatabaseException
         $message = "Cannot delete record from '{$table}': " .
                    "referenced by records in '{$referencingTable}'";
 
-        $context = ExceptionContext::forOperation('constraint.foreign_key_delete', 'Database')
-            ->withData([
-                'table' => $table,
-                'referencing_table' => $referencingTable,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'foreign_key',
-                'operation' => 'delete',
-            ])
-            ->withDebug([
-                'deleted_id' => self::sanitizeValue($deletedId),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -165,16 +131,10 @@ final class ConstraintViolationException extends DatabaseException
     ): self {
         $message = "NOT NULL constraint violation on '{$table}.{$column}': value cannot be null";
 
-        $context = ExceptionContext::forOperation('constraint.not_null', 'Database')
-            ->withData([
-                'table' => $table,
-                'column' => $column,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'not_null',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -197,20 +157,10 @@ final class ConstraintViolationException extends DatabaseException
             $message .= ": {$checkCondition}";
         }
 
-        $context = ExceptionContext::forOperation('constraint.check', 'Database')
-            ->withData([
-                'table' => $table,
-                'constraint_name' => $constraintName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'check',
-            ]);
-
-        if ($checkCondition !== null) {
-            $context = $context->withDebug(['check_condition' => $checkCondition]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -229,19 +179,10 @@ final class ConstraintViolationException extends DatabaseException
     ): self {
         $message = "Primary key constraint violation on '{$table}.{$primaryKey}': value already exists";
 
-        $context = ExceptionContext::forOperation('constraint.primary_key', 'Database')
-            ->withData([
-                'table' => $table,
-                'primary_key' => $primaryKey,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'primary_key',
-            ])
-            ->withDebug([
-                'duplicate_value' => self::sanitizeValue($value),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -261,19 +202,10 @@ final class ConstraintViolationException extends DatabaseException
         $columnList = implode(', ', $columns);
         $message = "Composite unique constraint violation on '{$table}' (" . $columnList . "): combination already exists";
 
-        $context = ExceptionContext::forOperation('constraint.composite_unique', 'Database')
-            ->withData([
-                'table' => $table,
-                'columns' => $columns,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Integrity Constraint Violation',
-                'constraint_type' => 'composite_unique',
-            ])
-            ->withDebug([
-                'duplicate_values' => self::sanitizeArray($values),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::CONSTRAINT_VIOLATION, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
diff --git a/src/Framework/Database/Exception/DatabaseException.php b/src/Framework/Database/Exception/DatabaseException.php
index 9fcbe51e..23feaf17 100644
--- a/src/Framework/Database/Exception/DatabaseException.php
+++ b/src/Framework/Database/Exception/DatabaseException.php
@@ -5,47 +5,23 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\ExceptionMetadata;
 use App\Framework\Exception\FrameworkException;
 
+/**
+ * Base Database Exception
+ *
+ * Extends FrameworkException with SqlState tracking for database-specific errors.
+ * Uses promoted property pattern for optional SqlState.
+ */
 class DatabaseException extends FrameworkException
 {
     public function __construct(
-        string $message,
-        ExceptionContext $context,
-        ErrorCode $errorCode,
-        protected ?SqlState $sqlState = null,
+        string $message = '',
+        int $code = 0,
         ?\Throwable $previous = null,
-        int $httpStatusCode = 500,
-        ?ExceptionMetadata $metadata = null
+        protected readonly ?SqlState $sqlState = null
     ) {
-        parent::__construct($message, $context, $httpStatusCode, $previous, $errorCode, $metadata);
-    }
-
-    /**
-     * Create exception from context with optional SQLSTATE
-     *
-     * NOTE: SqlState is added as last parameter to maintain parent signature compatibility
-     * Parent signature: fromContext(string, ExceptionContext, ?ErrorCode, ?\Throwable, int)
-     */
-    public static function fromContext(
-        string $message,
-        ExceptionContext $context,
-        ?ErrorCode $errorCode = null,
-        ?\Throwable $previous = null,
-        int $httpStatusCode = 500,
-        ?SqlState $sqlState = null
-    ): static {
-        return new static(
-            message: $message,
-            context: $context,
-            errorCode: $errorCode ?? ErrorCode::INTERNAL,
-            sqlState: $sqlState,
-            previous: $previous,
-            httpStatusCode: $httpStatusCode
-        );
+        parent::__construct($message, $code, $previous);
     }
 
     /**
@@ -63,20 +39,4 @@ class DatabaseException extends FrameworkException
     {
         return $this->sqlState !== null;
     }
-
-    /**
-     * Override withMetadata to maintain DatabaseException structure
-     */
-    public function withMetadata(ExceptionMetadata $metadata): static
-    {
-        return new static(
-            message: $this->getMessage(),
-            context: $this->context,
-            errorCode: $this->errorCode ?? ErrorCode::INTERNAL,
-            sqlState: $this->sqlState,
-            previous: $this->getPrevious(),
-            httpStatusCode: $this->getCode(),
-            metadata: $metadata
-        );
-    }
 }
diff --git a/src/Framework/Database/Exception/DeadlockException.php b/src/Framework/Database/Exception/DeadlockException.php
index adcf0084..ad962b41 100644
--- a/src/Framework/Database/Exception/DeadlockException.php
+++ b/src/Framework/Database/Exception/DeadlockException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Deadlock Exception
@@ -34,21 +32,11 @@ final class DeadlockException extends DatabaseException
     ): self {
         $message = 'Deadlock detected - transaction conflict with concurrent operation';
 
-        $context = ExceptionContext::forOperation('transaction.deadlock', 'Database')
-            ->withData([
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => true,
-                'retry_recommended' => true,
-            ]);
-
-        if ($query !== null) {
-            $context = $context->withDebug([
-                'query' => self::truncateQuery($query),
-            ]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, $previous, 500, $sqlState);
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -71,23 +59,10 @@ final class DeadlockException extends DatabaseException
             $message .= " (attempt {$attemptNumber})";
         }
 
-        $context = ExceptionContext::forOperation('transaction.deadlock', 'Database')
-            ->withData([
-                'transaction_id' => $transactionId,
-                'attempt_number' => $attemptNumber,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => true,
-                'retry_recommended' => true,
-            ]);
-
-        if ($conflictingQuery !== null) {
-            $context = $context->withDebug([
-                'conflicting_query' => self::truncateQuery($conflictingQuery),
-            ]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -102,19 +77,10 @@ final class DeadlockException extends DatabaseException
     ): self {
         $message = 'Serialization failure - could not serialize access due to concurrent update';
 
-        $context = ExceptionContext::forOperation('transaction.serialization', 'Database')
-            ->withData([
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => true,
-                'retry_recommended' => true,
-            ]);
-
-        if ($isolationLevel !== null) {
-            $context = $context->withData(['isolation_level' => $isolationLevel]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -134,19 +100,10 @@ final class DeadlockException extends DatabaseException
             $message .= ' and ' . (count($lockedResources) - 5) . ' more';
         }
 
-        $context = ExceptionContext::forOperation('transaction.deadlock', 'Database')
-            ->withData([
-                'locked_resources_count' => count($lockedResources),
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => true,
-                'retry_recommended' => true,
-            ])
-            ->withDebug([
-                'locked_resources' => $lockedResources,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -167,20 +124,10 @@ final class DeadlockException extends DatabaseException
             $message .= " for transaction '{$transactionId}'";
         }
 
-        $context = ExceptionContext::forOperation('transaction.deadlock_retries', 'Database')
-            ->withData([
-                'max_attempts' => $maxAttempts,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => false,  // Not recoverable after max retries
-                'retry_recommended' => false,
-            ]);
-
-        if ($transactionId !== null) {
-            $context = $context->withData(['transaction_id' => $transactionId]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -197,22 +144,10 @@ final class DeadlockException extends DatabaseException
     ): self {
         $message = "Deadlock detected after {$executionTimeMs}ms of execution";
 
-        $context = ExceptionContext::forOperation('transaction.deadlock', 'Database')
-            ->withData([
-                'execution_time_ms' => $executionTimeMs,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Transaction Rollback',
-                'recoverable' => true,
-                'retry_recommended' => true,
-            ]);
-
-        if ($query !== null) {
-            $context = $context->withDebug([
-                'query' => self::truncateQuery($query),
-            ]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::DEADLOCK_DETECTED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
diff --git a/src/Framework/Database/Exception/EntityNotFoundException.php b/src/Framework/Database/Exception/EntityNotFoundException.php
index d95269e7..f93b7a9b 100644
--- a/src/Framework/Database/Exception/EntityNotFoundException.php
+++ b/src/Framework/Database/Exception/EntityNotFoundException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Database\Exception;
 
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Entity Not Found Exception
  *
@@ -26,14 +23,11 @@ final class EntityNotFoundException extends DatabaseException
     {
         $message = "Entity '{$entityClass}' with ID '{$id}' not found";
 
-        $context = ExceptionContext::forOperation('entity.find', 'EntityManager')
-            ->withData([
-                'entity_class' => $entityClass,
-                'entity_id' => (string) $id,
-                'lookup_type' => 'by_id',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::ENTITY_NOT_FOUND, $previous, 404);
+        return new self(
+            message: $message,
+            code: 404,
+            previous: $previous
+        );
     }
 
     /**
@@ -48,16 +42,11 @@ final class EntityNotFoundException extends DatabaseException
         $criteriaStr = json_encode($criteria);
         $message = "Entity '{$entityClass}' not found with criteria: {$criteriaStr}";
 
-        $context = ExceptionContext::forOperation('entity.find', 'EntityManager')
-            ->withData([
-                'entity_class' => $entityClass,
-                'lookup_type' => 'by_criteria',
-            ])
-            ->withDebug([
-                'criteria' => $criteria,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::ENTITY_NOT_FOUND, $previous, 404);
+        return new self(
+            message: $message,
+            code: 404,
+            previous: $previous
+        );
     }
 
     // No custom constructor - uses parent DatabaseException constructor directly
diff --git a/src/Framework/Database/Exception/PoolExhaustedException.php b/src/Framework/Database/Exception/PoolExhaustedException.php
index fca9562f..5d9fe542 100644
--- a/src/Framework/Database/Exception/PoolExhaustedException.php
+++ b/src/Framework/Database/Exception/PoolExhaustedException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Pool Exhausted Exception
@@ -34,17 +32,11 @@ final class PoolExhaustedException extends DatabaseException
         $message = "Connection pool exhausted: {$currentConnections}/{$maxConnections} connections in pool, " .
                    "{$connectionsInUse} in use, no healthy connections available";
 
-        $context = ExceptionContext::forOperation('connection_pool.acquire', 'ConnectionPool')
-            ->withData([
-                'current_connections' => $currentConnections,
-                'max_connections' => $maxConnections,
-                'connections_in_use' => $connectionsInUse,
-                'free_connections' => $currentConnections - $connectionsInUse,
-                'utilization_percent' => round(($currentConnections / $maxConnections) * 100, 2),
-            ]);
-
         // Use SQLSTATE HY000 (general driver error) for pool exhaustion
-        return self::fromContext($message, $context, DatabaseErrorCode::POOL_EXHAUSTED, null, 500, new SqlState('HY000'));
+        return new self(
+            message: $message,
+            sqlState: new SqlState('HY000')
+        );
     }
 
     /**
@@ -60,14 +52,10 @@ final class PoolExhaustedException extends DatabaseException
         $message = "Connection pool exhausted: {$maxConnections} max connections reached, " .
                    "but all {$unhealthyConnections} connections are unhealthy";
 
-        $context = ExceptionContext::forOperation('connection_pool.acquire', 'ConnectionPool')
-            ->withData([
-                'max_connections' => $maxConnections,
-                'unhealthy_connections' => $unhealthyConnections,
-                'health_status' => 'critical',
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::POOL_EXHAUSTED, null, 500, new SqlState('HY000'));
+        return new self(
+            message: $message,
+            sqlState: new SqlState('HY000')
+        );
     }
 
     /**
@@ -85,14 +73,10 @@ final class PoolExhaustedException extends DatabaseException
         $message = "Connection pool wait timeout after {$waitTimeSeconds} seconds - " .
                    "no connections became available";
 
-        $context = ExceptionContext::forOperation('connection_pool.wait', 'ConnectionPool')
-            ->withData([
-                'wait_time_seconds' => $waitTimeSeconds,
-                'current_connections' => $currentConnections,
-                'max_connections' => $maxConnections,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::TIMEOUT, null, 500, new SqlState('HY000'));
+        return new self(
+            message: $message,
+            sqlState: new SqlState('HY000')
+        );
     }
 
     /**
@@ -115,17 +99,11 @@ final class PoolExhaustedException extends DatabaseException
             $message .= ": {$reason}";
         }
 
-        $context = ExceptionContext::forOperation('connection_pool.create', 'ConnectionPool')
-            ->withData([
-                'current_connections' => $currentConnections,
-                'max_connections' => $maxConnections,
-            ]);
-
-        if ($reason !== null) {
-            $context = $context->withDebug(['failure_reason' => $reason]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::POOL_EXHAUSTED, $previous, 500, new SqlState('HY000'));
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: new SqlState('HY000')
+        );
     }
 
     /**
@@ -142,40 +120,10 @@ final class PoolExhaustedException extends DatabaseException
     ): self {
         $message = "Connection pool temporarily exhausted - retry after {$recommendedRetryDelayMs}ms";
 
-        $context = ExceptionContext::forOperation('connection_pool.acquire', 'ConnectionPool')
-            ->withData([
-                'current_connections' => $currentConnections,
-                'max_connections' => $maxConnections,
-                'recommended_retry_delay_ms' => $recommendedRetryDelayMs,
-            ]);
-
-        $exception = self::fromContext($message, $context, DatabaseErrorCode::POOL_EXHAUSTED, null, 500, new SqlState('HY000'));
-
-        // Set retry after in seconds
-        return $exception->withRetryAfter((int) ceil($recommendedRetryDelayMs / 1000));
+        return new self(
+            message: $message,
+            sqlState: new SqlState('HY000')
+        );
     }
 
-    /**
-     * Get recommended action for pool exhaustion
-     *
-     * @return string Recommended action
-     */
-    public function getRecommendedAction(): string
-    {
-        $data = $this->context->data;
-
-        if (isset($data['utilization_percent']) && $data['utilization_percent'] >= 95) {
-            return 'Increase max_connections pool size or optimize connection usage';
-        }
-
-        if (isset($data['unhealthy_connections']) && $data['unhealthy_connections'] > 0) {
-            return 'Check database server health - connections are failing health checks';
-        }
-
-        if (isset($data['recommended_retry_delay_ms'])) {
-            return "Retry after {$data['recommended_retry_delay_ms']}ms delay";
-        }
-
-        return 'Retry operation or implement connection pooling strategies';
-    }
 }
diff --git a/src/Framework/Database/Exception/QueryExecutionException.php b/src/Framework/Database/Exception/QueryExecutionException.php
index f3b37cbf..51dab901 100644
--- a/src/Framework/Database/Exception/QueryExecutionException.php
+++ b/src/Framework/Database/Exception/QueryExecutionException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Query Execution Exception
@@ -34,21 +32,14 @@ final class QueryExecutionException extends DatabaseException
         ?string $errorMessage = null,
         ?\Throwable $previous = null
     ): self {
-        $message = "Query execution failed: {$errorMessage}";
+        $truncatedQuery = self::truncateQuery($query);
+        $message = "Query execution failed: {$errorMessage} (query: {$truncatedQuery})";
 
-        $context = ExceptionContext::forOperation('query.execute', 'Database')
-            ->withData([
-                'query' => self::truncateQuery($query),
-                'sqlstate' => $sqlState->code,
-                'sqlstate_class' => $sqlState->getClass(),
-                'error_category' => self::getSqlStateCategory($sqlState),
-            ])
-            ->withDebug([
-                'full_query' => $query,
-                'sqlstate_subclass' => $sqlState->getSubclass(),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, $previous, 500, $sqlState);
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -68,18 +59,10 @@ final class QueryExecutionException extends DatabaseException
         $actualType = get_debug_type($actualValue);
         $message = "Data type mismatch for column '{$column}': expected {$expectedType}, got {$actualType}";
 
-        $context = ExceptionContext::forOperation('query.data_validation', 'Database')
-            ->withData([
-                'column' => $column,
-                'expected_type' => $expectedType,
-                'actual_type' => $actualType,
-                'sqlstate' => $sqlState->code,
-            ])
-            ->withDebug([
-                'actual_value' => self::sanitizeValue($actualValue),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -98,15 +81,10 @@ final class QueryExecutionException extends DatabaseException
     ): self {
         $message = "Data too long for column '{$column}': maximum {$maxLength} characters, got {$actualLength}";
 
-        $context = ExceptionContext::forOperation('query.data_validation', 'Database')
-            ->withData([
-                'column' => $column,
-                'max_length' => $maxLength,
-                'actual_length' => $actualLength,
-                'sqlstate' => $sqlState->code,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -123,16 +101,10 @@ final class QueryExecutionException extends DatabaseException
     ): self {
         $message = "Numeric value out of range for column '{$column}'";
 
-        $context = ExceptionContext::forOperation('query.data_validation', 'Database')
-            ->withData([
-                'column' => $column,
-                'sqlstate' => $sqlState->code,
-            ])
-            ->withDebug([
-                'value' => self::sanitizeValue($value),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -149,14 +121,10 @@ final class QueryExecutionException extends DatabaseException
     ): self {
         $message = "Invalid datetime format for column '{$column}': {$value}";
 
-        $context = ExceptionContext::forOperation('query.data_validation', 'Database')
-            ->withData([
-                'column' => $column,
-                'value' => $value,
-                'sqlstate' => $sqlState->code,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -171,13 +139,10 @@ final class QueryExecutionException extends DatabaseException
     ): self {
         $message = "Division by zero error in expression: {$expression}";
 
-        $context = ExceptionContext::forOperation('query.execute', 'Database')
-            ->withData([
-                'expression' => $expression,
-                'sqlstate' => $sqlState->code,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -192,19 +157,13 @@ final class QueryExecutionException extends DatabaseException
         string $value,
         SqlState $sqlState
     ): self {
-        $message = "Invalid text representation for column '{$column}': {$value}";
+        $truncatedValue = self::truncateValue($value);
+        $message = "Invalid text representation for column '{$column}': {$truncatedValue}";
 
-        $context = ExceptionContext::forOperation('query.data_validation', 'Database')
-            ->withData([
-                'column' => $column,
-                'value' => self::truncateValue($value),
-                'sqlstate' => $sqlState->code,
-            ])
-            ->withDebug([
-                'full_value' => $value,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_EXECUTION_FAILED, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
diff --git a/src/Framework/Database/Exception/QuerySyntaxException.php b/src/Framework/Database/Exception/QuerySyntaxException.php
index fedfd54e..5dfa008d 100644
--- a/src/Framework/Database/Exception/QuerySyntaxException.php
+++ b/src/Framework/Database/Exception/QuerySyntaxException.php
@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\Exception;
 
 use App\Framework\Database\ValueObjects\SqlState;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Query Syntax Exception
@@ -42,19 +40,11 @@ final class QuerySyntaxException extends DatabaseException
     ): self {
         $message = "SQL syntax error: {$errorMessage}";
 
-        $context = ExceptionContext::forOperation('query.parse', 'Database')
-            ->withData([
-                'query' => self::truncateQuery($query),
-                'sqlstate' => $sqlState->code,
-                'sqlstate_class' => $sqlState->getClass(),
-                'error_category' => 'Syntax Error or Access Violation',
-            ])
-            ->withDebug([
-                'full_query' => $query,
-                'sqlstate_subclass' => $sqlState->getSubclass(),
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, $previous, 500, $sqlState);
+        return new self(
+            message: $message,
+            previous: $previous,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -71,18 +61,10 @@ final class QuerySyntaxException extends DatabaseException
     ): self {
         $message = "Table '{$tableName}' does not exist";
 
-        $context = ExceptionContext::forOperation('query.validate', 'Database')
-            ->withData([
-                'table_name' => $tableName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ]);
-
-        if ($query !== null) {
-            $context = $context->withDebug(['query' => self::truncateQuery($query)]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -103,22 +85,10 @@ final class QuerySyntaxException extends DatabaseException
             ? "Column '{$tableName}.{$columnName}' does not exist"
             : "Column '{$columnName}' does not exist";
 
-        $context = ExceptionContext::forOperation('query.validate', 'Database')
-            ->withData([
-                'column_name' => $columnName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ]);
-
-        if ($tableName !== null) {
-            $context = $context->withData(['table_name' => $tableName]);
-        }
-
-        if ($query !== null) {
-            $context = $context->withDebug(['query' => self::truncateQuery($query)]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -135,18 +105,10 @@ final class QuerySyntaxException extends DatabaseException
     ): self {
         $message = "Function '{$functionName}' does not exist";
 
-        $context = ExceptionContext::forOperation('query.validate', 'Database')
-            ->withData([
-                'function_name' => $functionName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ]);
-
-        if ($query !== null) {
-            $context = $context->withDebug(['query' => self::truncateQuery($query)]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -165,18 +127,10 @@ final class QuerySyntaxException extends DatabaseException
             ? "Insufficient privileges to {$operation} on '{$objectName}'"
             : "Insufficient privileges to perform {$operation}";
 
-        $context = ExceptionContext::forOperation('query.authorize', 'Database')
-            ->withData([
-                'operation' => $operation,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ]);
-
-        if ($objectName !== null) {
-            $context = $context->withData(['object_name' => $objectName]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -193,18 +147,10 @@ final class QuerySyntaxException extends DatabaseException
     ): self {
         $message = "Ambiguous column reference '{$columnName}' - specify table name";
 
-        $context = ExceptionContext::forOperation('query.validate', 'Database')
-            ->withData([
-                'column_name' => $columnName,
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ]);
-
-        if ($query !== null) {
-            $context = $context->withDebug(['query' => self::truncateQuery($query)]);
-        }
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
@@ -223,19 +169,10 @@ final class QuerySyntaxException extends DatabaseException
     ): self {
         $message = "Syntax error at position {$position} near '{$nearText}'";
 
-        $context = ExceptionContext::forOperation('query.parse', 'Database')
-            ->withData([
-                'error_position' => $position,
-                'near_text' => $nearText,
-                'query' => self::truncateQuery($query),
-                'sqlstate' => $sqlState->code,
-                'error_category' => 'Syntax Error or Access Violation',
-            ])
-            ->withDebug([
-                'full_query' => $query,
-            ]);
-
-        return self::fromContext($message, $context, DatabaseErrorCode::QUERY_SYNTAX_ERROR, null, 500, $sqlState);
+        return new self(
+            message: $message,
+            sqlState: $sqlState
+        );
     }
 
     /**
diff --git a/src/Framework/Database/Migration/Exception/MemoryThresholdExceededException.php b/src/Framework/Database/Migration/Exception/MemoryThresholdExceededException.php
index 82060849..4b3ba297 100644
--- a/src/Framework/Database/Migration/Exception/MemoryThresholdExceededException.php
+++ b/src/Framework/Database/Migration/Exception/MemoryThresholdExceededException.php
@@ -18,21 +18,12 @@ final class MemoryThresholdExceededException extends FrameworkException
         Byte $currentMemory,
         Byte $memoryLimit
     ): self {
-        return self::create(
-            ErrorCode::PERF_MEMORY_LIMIT_EXCEEDED,
-            "Memory threshold exceeded during migration {$migrationVersion}: {$currentUsage->format(1)}% (threshold: {$threshold->format(1)}%)"
-        )->withData([
-            'migration_version' => $migrationVersion,
-            'current_usage_percentage' => $currentUsage->getValue(),
-            'threshold_percentage' => $threshold->getValue(),
-            'current_memory' => $currentMemory->toHumanReadable(),
-            'memory_limit' => $memoryLimit->toHumanReadable(),
-            'available_memory' => $memoryLimit->subtract($currentMemory)->toHumanReadable(),
-        ])->withMetadata([
-            'category' => 'memory',
-            'severity' => 'high',
-            'action_required' => 'Consider increasing memory limit or running migrations in smaller batches',
-        ]);
+        $available = $memoryLimit->subtract($currentMemory)->toHumanReadable();
+
+        return new self(
+            "Memory threshold exceeded during migration {$migrationVersion}: {$currentUsage->format(1)}% (threshold: {$threshold->format(1)}%), using {$currentMemory->toHumanReadable()} of {$memoryLimit->toHumanReadable()} ({$available} available)",
+            507 // Insufficient Storage
+        );
     }
 
     public static function batchAborted(
@@ -43,21 +34,11 @@ final class MemoryThresholdExceededException extends FrameworkException
         int $completedMigrations,
         int $totalMigrations
     ): self {
-        return self::create(
-            ErrorCode::PERF_MEMORY_LIMIT_EXCEEDED,
-            "Migration batch aborted due to critical memory usage: {$currentUsage->format(1)}% (abort threshold: {$abortThreshold->format(1)}%)"
-        )->withData([
-            'current_usage_percentage' => $currentUsage->getValue(),
-            'abort_threshold_percentage' => $abortThreshold->getValue(),
-            'current_memory' => $currentMemory->toHumanReadable(),
-            'memory_limit' => $memoryLimit->toHumanReadable(),
-            'completed_migrations' => $completedMigrations,
-            'total_migrations' => $totalMigrations,
-            'remaining_migrations' => $totalMigrations - $completedMigrations,
-        ])->withMetadata([
-            'category' => 'memory',
-            'severity' => 'critical',
-            'action_required' => 'Increase memory limit or run remaining migrations separately',
-        ]);
+        $remaining = $totalMigrations - $completedMigrations;
+
+        return new self(
+            "Migration batch aborted due to critical memory usage: {$currentUsage->format(1)}% (abort threshold: {$abortThreshold->format(1)}%), using {$currentMemory->toHumanReadable()} of {$memoryLimit->toHumanReadable()}, completed {$completedMigrations}/{$totalMigrations} ({$remaining} remaining)",
+            507 // Insufficient Storage
+        );
     }
 }
diff --git a/src/Framework/Database/Serialization/SerializationException.php b/src/Framework/Database/Serialization/SerializationException.php
index aca3047f..c7f11fbe 100644
--- a/src/Framework/Database/Serialization/SerializationException.php
+++ b/src/Framework/Database/Serialization/SerializationException.php
@@ -4,41 +4,22 @@ declare(strict_types=1);
 
 namespace App\Framework\Database\Serialization;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class SerializationException extends FrameworkException
 {
     public static function invalidData(string $reason): self
     {
-        return new self(
-            message: "Invalid serialized data: {$reason}",
-            context: ExceptionContext::forOperation('serialization_decode', 'Database')
-                ->withData(['reason' => $reason])
-        );
+        return new self("Invalid serialized data: {$reason}");
     }
 
     public static function classMismatch(string $expected, string $actual): self
     {
-        return new self(
-            message: "Class mismatch: expected {$expected}, got {$actual}",
-            context: ExceptionContext::forOperation('serialization_class_match', 'Database')
-                ->withData([
-                    'expected_class' => $expected,
-                    'actual_class' => $actual,
-                ])
-        );
+        return new self("Class mismatch: expected {$expected}, got {$actual}");
     }
 
     public static function missingProperty(string $class, string $property): self
     {
-        return new self(
-            message: "Missing required property {$property} in class {$class}",
-            context: ExceptionContext::forOperation('serialization_property_check', 'Database')
-                ->withData([
-                    'class' => $class,
-                    'missing_property' => $property,
-                ])
-        );
+        return new self("Missing required property {$property} in class {$class}");
     }
 }
diff --git a/src/Framework/Database/StoredProcedure/Exception/StoredFunctionException.php b/src/Framework/Database/StoredProcedure/Exception/StoredFunctionException.php
index ec359d52..3da9555d 100644
--- a/src/Framework/Database/StoredProcedure/Exception/StoredFunctionException.php
+++ b/src/Framework/Database/StoredProcedure/Exception/StoredFunctionException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\StoredProcedure\Exception;
 
 use App\Framework\Database\Exception\DatabaseException;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Base exception for stored function errors
@@ -20,12 +19,8 @@ class StoredFunctionException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_function.error', 'StoredFunction')
-            ->withData(['function_name' => $functionName]);
-
         return new self(
             "Error in stored function '{$functionName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -39,12 +34,8 @@ class StoredFunctionException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_function.execution', 'StoredFunction')
-            ->withData(['function_name' => $functionName]);
-
         return new self(
             "Error executing stored function '{$functionName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -58,12 +49,8 @@ class StoredFunctionException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_function.creation', 'StoredFunction')
-            ->withData(['function_name' => $functionName]);
-
         return new self(
             "Error creating stored function '{$functionName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -74,12 +61,8 @@ class StoredFunctionException extends DatabaseException
      */
     public static function notFound(string $functionName): self
     {
-        $context = ExceptionContext::forOperation('stored_function.not_found', 'StoredFunction')
-            ->withData(['function_name' => $functionName]);
-
         return new self(
             "Stored function '{$functionName}' not found",
-            $context,
             404
         );
     }
@@ -89,17 +72,8 @@ class StoredFunctionException extends DatabaseException
      */
     public static function invalidReturnType(string $functionName, string $expectedType, string $actualType): self
     {
-        $context = ExceptionContext::forOperation('stored_function.invalid_return_type', 'StoredFunction')
-            ->withData([
-                'function_name' => $functionName,
-                'expected_type' => $expectedType,
-                'actual_type' => $actualType,
-            ]);
-
         return new self(
-            "Invalid return type for stored function '{$functionName}': " .
-            "expected {$expectedType}, got {$actualType}",
-            $context,
+            "Invalid return type for stored function '{$functionName}': expected {$expectedType}, got {$actualType}",
             400
         );
     }
diff --git a/src/Framework/Database/StoredProcedure/Exception/StoredProcedureException.php b/src/Framework/Database/StoredProcedure/Exception/StoredProcedureException.php
index 1426e7a0..d6447030 100644
--- a/src/Framework/Database/StoredProcedure/Exception/StoredProcedureException.php
+++ b/src/Framework/Database/StoredProcedure/Exception/StoredProcedureException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Database\StoredProcedure\Exception;
 
 use App\Framework\Database\Exception\DatabaseException;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Base exception for stored procedure errors
@@ -20,12 +19,8 @@ class StoredProcedureException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_procedure.error', 'StoredProcedure')
-            ->withData(['procedure_name' => $procedureName]);
-
         return new self(
             "Error in stored procedure '{$procedureName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -39,12 +34,8 @@ class StoredProcedureException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_procedure.execution', 'StoredProcedure')
-            ->withData(['procedure_name' => $procedureName]);
-
         return new self(
             "Error executing stored procedure '{$procedureName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -58,12 +49,8 @@ class StoredProcedureException extends DatabaseException
         string $message,
         ?\Throwable $previous = null
     ): self {
-        $context = ExceptionContext::forOperation('stored_procedure.creation', 'StoredProcedure')
-            ->withData(['procedure_name' => $procedureName]);
-
         return new self(
             "Error creating stored procedure '{$procedureName}': {$message}",
-            $context,
             500,
             $previous
         );
@@ -74,12 +61,8 @@ class StoredProcedureException extends DatabaseException
      */
     public static function notFound(string $procedureName): self
     {
-        $context = ExceptionContext::forOperation('stored_procedure.not_found', 'StoredProcedure')
-            ->withData(['procedure_name' => $procedureName]);
-
         return new self(
             "Stored procedure '{$procedureName}' not found",
-            $context,
             404
         );
     }
diff --git a/src/Framework/DateTime/Exceptions/InvalidDateTimeException.php b/src/Framework/DateTime/Exceptions/InvalidDateTimeException.php
index c5ef2608..8e502a12 100644
--- a/src/Framework/DateTime/Exceptions/InvalidDateTimeException.php
+++ b/src/Framework/DateTime/Exceptions/InvalidDateTimeException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DateTime\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 class InvalidDateTimeException extends FrameworkException
@@ -15,12 +14,6 @@ class InvalidDateTimeException extends FrameworkException
             ? sprintf('Konnte DateTime nicht aus "%s" mit Format "%s" erstellen', $dateTime, $format)
             : sprintf('Ungültiges DateTime-Format: "%s"', $dateTime);
 
-        $context = ExceptionContext::forOperation('datetime.parse', 'datetime')
-            ->withData([
-                'input_datetime' => $dateTime,
-                'format' => $format,
-            ]);
-
-        parent::__construct($message, $context, 0, $previous);
+        parent::__construct($message, 0, $previous);
     }
 }
diff --git a/src/Framework/DateTime/Exceptions/InvalidTimezoneException.php b/src/Framework/DateTime/Exceptions/InvalidTimezoneException.php
index 5939786c..cabd9d9b 100644
--- a/src/Framework/DateTime/Exceptions/InvalidTimezoneException.php
+++ b/src/Framework/DateTime/Exceptions/InvalidTimezoneException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\DateTime\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 class InvalidTimezoneException extends FrameworkException
@@ -13,9 +12,6 @@ class InvalidTimezoneException extends FrameworkException
     {
         $message = sprintf('Ungültige Zeitzone: "%s"', $timezone);
 
-        $context = ExceptionContext::forOperation('timezone.validate', 'datetime')
-            ->withData(['timezone' => $timezone]);
-
-        parent::__construct($message, $context, 0, $previous);
+        parent::__construct($message, 0, $previous);
     }
 }
diff --git a/src/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheck.php b/src/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheck.php
index 243d9adb..c3835390 100644
--- a/src/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheck.php
+++ b/src/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheck.php
@@ -16,10 +16,19 @@ use App\Framework\Health\HealthCheckResult;
  */
 final readonly class SslCertificateHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'SSL Certificate';
+    private const int TIMEOUT_MS = 5000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private SslCertificateService $sslService,
         private Environment $environment
-    ) {}
+    ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
+    }
 
     public function check(): HealthCheckResult
     {
@@ -120,18 +129,8 @@ final readonly class SslCertificateHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'SSL Certificate';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::SECURITY;
     }
-
-    public function getTimeout(): int
-    {
-        return 5000; // 5 seconds
-    }
 }
diff --git a/src/Framework/Design/Ast/CssAstBuilder.php b/src/Framework/Design/Ast/CssAstBuilder.php
new file mode 100644
index 00000000..e49d2022
--- /dev/null
+++ b/src/Framework/Design/Ast/CssAstBuilder.php
@@ -0,0 +1,292 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+use App\Framework\Design\ValueObjects\Theme;
+use App\Framework\Design\ValueObjects\ThemeRegistry;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Design\ValueObjects\TokenStateRegistry;
+use App\Framework\Design\ValueObjects\Tokens\ColorToken;
+use App\Framework\Design\ValueObjects\Tokens\StatefulColorToken;
+use App\Framework\Design\ValueObjects\Tokens\StatefulTokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Builder for CSS AST from TokenRegistry
+ */
+final readonly class CssAstBuilder
+{
+    /**
+     * Build CSS AST from TokenRegistry
+     */
+    public function buildFromRegistry(
+        TokenRegistry $registry,
+        string $layerName = 'framework-settings',
+        bool $includeHdr = true
+    ): CssStylesheet {
+        $layer = new CssLayer($layerName, [
+            $this->buildRootRule($registry, $includeHdr),
+            $this->buildDarkModeRule($registry, $layerName),
+        ]);
+
+        if ($includeHdr) {
+            $layer = new CssLayer($layerName, [
+                $this->buildRootRule($registry, $includeHdr),
+                $this->buildHdrSupport($registry, $layerName),
+                $this->buildP3Support($registry, $layerName),
+                $this->buildDarkModeRule($registry, $layerName),
+            ]);
+        }
+
+        return new CssStylesheet([$layer]);
+    }
+
+    /**
+     * Build :root rule with all tokens
+     */
+    private function buildRootRule(TokenRegistry $registry, bool $includeHdr): CssRule
+    {
+        $properties = [];
+
+        foreach ($registry->all() as $token) {
+            $properties[] = $token->toCssAstNode();
+
+            // Add P3 variant for color tokens
+            if ($includeHdr && $token instanceof ColorToken) {
+                $p3Property = $token->toP3AstNode();
+                if ($p3Property) {
+                    $properties[] = $p3Property;
+                }
+            }
+        }
+
+        return new CssRule(':root', $properties);
+    }
+
+    /**
+     * Build dark mode media query
+     */
+    private function buildDarkModeRule(TokenRegistry $registry, string $layerName): CssMediaQuery
+    {
+        $properties = [];
+
+        foreach ($registry->colors() as $token) {
+            $darkNode = $token->toDarkModeAstNode();
+            if ($darkNode) {
+                $properties[] = $darkNode;
+            }
+        }
+
+        if (empty($properties)) {
+            // Return empty media query if no dark mode colors
+            return new CssMediaQuery('(prefers-color-scheme: dark)', []);
+        }
+
+        $rule = new CssRule(':root', $properties);
+
+        return new CssMediaQuery('(prefers-color-scheme: dark)', [$rule]);
+    }
+
+    /**
+     * Build HDR support media query
+     */
+    private function buildHdrSupport(TokenRegistry $registry, string $layerName): CssMediaQuery
+    {
+        $properties = [];
+
+        foreach ($registry->colors() as $token) {
+            $p3Node = $token->toP3AstNode();
+            if ($p3Node) {
+                $properties[] = new CssCustomProperty(
+                    $token->getName(),
+                    "var(--{$token->getName()}-p3)",
+                    'HDR variant'
+                );
+            }
+        }
+
+        if (empty($properties)) {
+            return new CssMediaQuery('(dynamic-range: high)', []);
+        }
+
+        $rule = new CssRule(':root', $properties);
+
+        return new CssMediaQuery('(dynamic-range: high)', [$rule]);
+    }
+
+    /**
+     * Build P3 wide gamut support
+     */
+    private function buildP3Support(TokenRegistry $registry, string $layerName): CssSupports
+    {
+        $properties = [];
+
+        foreach ($registry->colors() as $token) {
+            $p3Node = $token->toP3AstNode();
+            if ($p3Node) {
+                $properties[] = new CssCustomProperty(
+                    $token->getName(),
+                    "var(--{$token->getName()}-p3)",
+                    'P3 wide gamut variant'
+                );
+            }
+        }
+
+        if (empty($properties)) {
+            return new CssSupports('(color: color(display-p3 1 0 0))', []);
+        }
+
+        $rule = new CssRule(':root', $properties);
+
+        return new CssSupports('(color: color(display-p3 1 0 0))', [$rule]);
+    }
+
+    /**
+     * Build CSS rules for token states using pseudo-classes
+     * 
+     * @return CssRule[]
+     */
+    public function buildStateRules(TokenStateRegistry $registry): array
+    {
+        $rules = [];
+        $tokenGroups = [];
+
+        // Group tokens by base name
+        foreach ($registry->tokens as $token) {
+            if ($token instanceof StatefulTokenInterface) {
+                $baseName = $token->getName();
+                if (! isset($tokenGroups[$baseName])) {
+                    $tokenGroups[$baseName] = [];
+                }
+                $tokenGroups[$baseName][$token->getState()] = $token;
+            }
+        }
+
+        // Generate CSS rules for each token group
+        foreach ($tokenGroups as $baseName => $states) {
+            // Get default state
+            $defaultState = $states[TokenState::DEFAULT] ?? null;
+            if (! $defaultState instanceof StatefulColorToken) {
+                continue;
+            }
+
+            // Create base rule with default state
+            $baseSelector = $this->tokenNameToSelector($baseName);
+            $baseProperties = [
+                $defaultState->toCssAstNode()
+            ];
+
+            // Add P3 variant if available
+            $p3Node = $defaultState->toP3AstNode();
+            if ($p3Node) {
+                $baseProperties[] = $p3Node;
+            }
+
+            $baseRule = new CssRule($baseSelector, $baseProperties);
+            $rules[] = $baseRule;
+
+            // Generate state rules with pseudo-classes
+            foreach ($states as $state => $token) {
+                if ($state === TokenState::DEFAULT) {
+                    continue;
+                }
+
+                if (! $token instanceof StatefulColorToken) {
+                    continue;
+                }
+
+                $pseudoClass = $state->toPseudoClass();
+                if (empty($pseudoClass)) {
+                    continue;
+                }
+
+                $stateSelector = $baseSelector . $pseudoClass;
+                $stateProperties = [
+                    $token->toCssAstNode()
+                ];
+
+                $stateRule = new CssRule($stateSelector, $stateProperties);
+                $rules[] = $stateRule;
+            }
+        }
+
+        return $rules;
+    }
+
+    /**
+     * Convert token name to CSS selector
+     * e.g., "button-primary" -> ".button-primary"
+     */
+    private function tokenNameToSelector(string $tokenName): string
+    {
+        // Remove prefix if present (e.g., "admin-", "color-")
+        $name = preg_replace('/^(admin-|color-|framework-)/', '', $tokenName);
+        
+        // Convert kebab-case to class selector
+        return '.' . str_replace('_', '-', $name);
+    }
+
+    /**
+     * Build CSS rules for themes using data-attribute selectors
+     *
+     * @return CssRule[]
+     */
+    public function buildThemeRules(ThemeRegistry $registry): array
+    {
+        $rules = [];
+
+        // Default theme (no data-attribute)
+        $defaultTheme = $registry->getTheme('default');
+        if ($defaultTheme) {
+            $defaultRule = $this->buildThemeRule(':root', $defaultTheme);
+            if ($defaultRule) {
+                $rules[] = $defaultRule;
+            }
+        }
+
+        // Other themes (with data-attribute)
+        foreach ($registry->getAllThemes() as $themeName => $theme) {
+            if ($themeName === 'default') {
+                continue;
+            }
+
+            $selector = "[data-theme=\"{$themeName}\"]";
+            $themeRule = $this->buildThemeRule($selector, $theme);
+            if ($themeRule) {
+                $rules[] = $themeRule;
+            }
+        }
+
+        return $rules;
+    }
+
+    /**
+     * Build CSS rule for a theme
+     */
+    private function buildThemeRule(string $selector, Theme $theme): ?CssRule
+    {
+        $properties = [];
+        $tokens = $theme->getAllTokens();
+
+        foreach ($tokens as $token) {
+            $properties[] = $token->toCssAstNode();
+
+            // Add P3 variant for color tokens
+            if ($token instanceof ColorToken) {
+                $p3Property = $token->toP3AstNode();
+                if ($p3Property) {
+                    $properties[] = $p3Property;
+                }
+            }
+        }
+
+        if (empty($properties)) {
+            return null;
+        }
+
+        return new CssRule($selector, $properties);
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssAstNode.php b/src/Framework/Design/Ast/CssAstNode.php
new file mode 100644
index 00000000..397c6272
--- /dev/null
+++ b/src/Framework/Design/Ast/CssAstNode.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * Base interface for CSS AST nodes
+ */
+interface CssAstNode
+{
+    /**
+     * Render node to CSS string
+     * 
+     * @param int $indent Current indentation level (spaces)
+     * @return string CSS string representation
+     */
+    public function toCss(int $indent = 0): string;
+}
+
diff --git a/src/Framework/Design/Ast/CssComment.php b/src/Framework/Design/Ast/CssComment.php
new file mode 100644
index 00000000..96d3b51a
--- /dev/null
+++ b/src/Framework/Design/Ast/CssComment.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS comment node
+ */
+final readonly class CssComment implements CssAstNode
+{
+    public function __construct(
+        public string $text
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $lines = explode("\n", $this->text);
+        $css = '';
+
+        foreach ($lines as $line) {
+            $css .= "{$spaces}/* {$line} */\n";
+        }
+
+        return rtrim($css);
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssCustomProperty.php b/src/Framework/Design/Ast/CssCustomProperty.php
new file mode 100644
index 00000000..f87d1e0e
--- /dev/null
+++ b/src/Framework/Design/Ast/CssCustomProperty.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS custom property (CSS variable) node
+ */
+final readonly class CssCustomProperty implements CssAstNode
+{
+    public function __construct(
+        public string $name,
+        public string $value,
+        public ?string $comment = null
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $comment = $this->comment ? " /* {$this->comment} */" : '';
+
+        return "{$spaces}--{$this->name}: {$this->value};{$comment}";
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssLayer.php b/src/Framework/Design/Ast/CssLayer.php
new file mode 100644
index 00000000..9935fd96
--- /dev/null
+++ b/src/Framework/Design/Ast/CssLayer.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS @layer directive node
+ */
+final readonly class CssLayer implements CssAstNode
+{
+    /**
+     * @param CssAstNode[] $children
+     */
+    public function __construct(
+        public string $name,
+        public array $children = []
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $css = "{$spaces}@layer {$this->name} {\n";
+
+        foreach ($this->children as $child) {
+            $css .= $child->toCss($indent + 4) . "\n";
+        }
+
+        $css .= "{$spaces}}";
+
+        return $css;
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssMediaQuery.php b/src/Framework/Design/Ast/CssMediaQuery.php
new file mode 100644
index 00000000..5cb62b22
--- /dev/null
+++ b/src/Framework/Design/Ast/CssMediaQuery.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS @media query node
+ */
+final readonly class CssMediaQuery implements CssAstNode
+{
+    /**
+     * @param CssAstNode[] $children
+     */
+    public function __construct(
+        public string $query,
+        public array $children = []
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $css = "{$spaces}@media {$this->query} {\n";
+
+        foreach ($this->children as $child) {
+            $css .= $child->toCss($indent + 4) . "\n";
+        }
+
+        $css .= "{$spaces}}";
+
+        return $css;
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssRule.php b/src/Framework/Design/Ast/CssRule.php
new file mode 100644
index 00000000..6fb73bd7
--- /dev/null
+++ b/src/Framework/Design/Ast/CssRule.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS rule node (selector with declarations)
+ */
+final readonly class CssRule implements CssAstNode
+{
+    /**
+     * @param CssAstNode[] $children Custom properties or other declarations
+     */
+    public function __construct(
+        public string $selector,
+        public array $children = []
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $css = "{$spaces}{$this->selector} {\n";
+
+        foreach ($this->children as $child) {
+            $css .= $child->toCss($indent + 4) . "\n";
+        }
+
+        $css .= "{$spaces}}";
+
+        return $css;
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssStylesheet.php b/src/Framework/Design/Ast/CssStylesheet.php
new file mode 100644
index 00000000..a1076224
--- /dev/null
+++ b/src/Framework/Design/Ast/CssStylesheet.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * Root node representing a complete CSS stylesheet
+ */
+final readonly class CssStylesheet implements CssAstNode
+{
+    /**
+     * @param CssAstNode[] $children
+     */
+    public function __construct(
+        public array $children = []
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $css = '';
+        foreach ($this->children as $child) {
+            $css .= $child->toCss($indent) . "\n";
+        }
+
+        return rtrim($css);
+    }
+}
+
diff --git a/src/Framework/Design/Ast/CssSupports.php b/src/Framework/Design/Ast/CssSupports.php
new file mode 100644
index 00000000..5f8a9c2d
--- /dev/null
+++ b/src/Framework/Design/Ast/CssSupports.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Ast;
+
+/**
+ * CSS @supports query node
+ */
+final readonly class CssSupports implements CssAstNode
+{
+    /**
+     * @param CssAstNode[] $children
+     */
+    public function __construct(
+        public string $condition,
+        public array $children = []
+    ) {
+    }
+
+    public function toCss(int $indent = 0): string
+    {
+        $spaces = str_repeat(' ', $indent);
+        $css = "{$spaces}@supports {$this->condition} {\n";
+
+        foreach ($this->children as $child) {
+            $css .= $child->toCss($indent + 4) . "\n";
+        }
+
+        $css .= "{$spaces}}";
+
+        return $css;
+    }
+}
+
diff --git a/src/Framework/Design/Database/DesignTokenEntity.php b/src/Framework/Design/Database/DesignTokenEntity.php
new file mode 100644
index 00000000..5bf5cb5d
--- /dev/null
+++ b/src/Framework/Design/Database/DesignTokenEntity.php
@@ -0,0 +1,347 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Database;
+
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Database\Attributes\Column;
+use App\Framework\Database\Attributes\Entity;
+use App\Framework\Design\ValueObjects\StateMutation;
+use App\Framework\Design\ValueObjects\TokenState;
+use App\Framework\Design\ValueObjects\Tokens\ColorToken;
+use App\Framework\Design\ValueObjects\Tokens\SpacingToken;
+use App\Framework\Design\ValueObjects\Tokens\StatefulColorToken;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TypographyToken;
+
+/**
+ * Design Token Database Entity
+ *
+ * Represents a design token stored in the database.
+ * Supports serialization/deserialization of Token-ValueObjects.
+ */
+#[Entity(table: 'design_tokens')]
+final readonly class DesignTokenEntity
+{
+    public function __construct(
+        #[Column(name: 'id', type: 'string', length: 255, primary: true, nullable: false)]
+        public string $id,
+
+        #[Column(name: 'name', type: 'string', length: 255)]
+        public string $name,
+
+        #[Column(name: 'type', type: 'string', length: 50)]
+        public string $type, // 'color', 'spacing', 'typography', etc.
+
+        #[Column(name: 'state', type: 'string', length: 50, nullable: true)]
+        public string $state, // 'default', 'hover', 'disabled', etc.
+
+        #[Column(name: 'scope', type: 'string', length: 100)]
+        public string $scope, // 'framework', 'admin', 'custom', etc.
+
+        #[Column(name: 'value_data', type: 'json')]
+        public string $valueData, // JSON string
+
+        #[Column(name: 'base_token_id', type: 'string', length: 255, nullable: true)]
+        public ?string $baseTokenId,
+
+        #[Column(name: 'mutation_data', type: 'json', nullable: true)]
+        public ?string $mutationData, // JSON string
+
+        #[Column(name: 'description', type: 'text', nullable: true)]
+        public ?string $description,
+
+        #[Column(name: 'metadata', type: 'json', nullable: true)]
+        public ?string $metadata, // JSON string
+
+        #[Column(name: 'created_at', type: 'timestamp')]
+        public string $createdAt,
+
+        #[Column(name: 'updated_at', type: 'timestamp')]
+        public string $updatedAt,
+    ) {
+    }
+
+    /**
+     * Convert Entity to TokenInterface
+     */
+    public function toTokenInterface(): TokenInterface
+    {
+        $valueDataArray = json_decode($this->valueData, true);
+        if (! is_array($valueDataArray)) {
+            throw new \RuntimeException("Invalid value_data JSON for token {$this->id}");
+        }
+
+        $mutation = $this->getMutation();
+
+        return match($this->type) {
+            'color' => $this->createColorToken($valueDataArray, $mutation),
+            'spacing' => $this->createSpacingToken($valueDataArray),
+            'typography' => $this->createTypographyToken($valueDataArray),
+            default => throw new \RuntimeException("Unsupported token type: {$this->type}")
+        };
+    }
+
+    /**
+     * Create Entity from TokenInterface
+     */
+    public static function fromTokenInterface(
+        TokenInterface $token,
+        string $scope,
+        ?string $id = null
+    ): self {
+        $tokenId = $id ?? self::generateId($token->getName(), $scope, $token instanceof StatefulColorToken ? $token->getState() : TokenState::DEFAULT);
+        $state = $token instanceof StatefulColorToken ? $token->getState()->value : TokenState::DEFAULT->value;
+        $baseTokenId = $token instanceof StatefulColorToken && $token->baseState ? self::generateId($token->getName(), $scope, $token->baseState) : null;
+
+        $valueData = self::serializeTokenValue($token);
+        $mutationData = $token instanceof StatefulColorToken && $token->mutation ? self::serializeMutation($token->mutation) : null;
+
+        $now = date('Y-m-d H:i:s');
+
+        return new self(
+            id: $tokenId,
+            name: $token->getName(),
+            type: $token->getType()->value,
+            state: $state,
+            scope: $scope,
+            valueData: $valueData,
+            baseTokenId: $baseTokenId,
+            mutationData: $mutationData,
+            description: $token->getDescription(),
+            metadata: null,
+            createdAt: $now,
+            updatedAt: $now
+        );
+    }
+
+    /**
+     * Get StateMutation from JSON
+     */
+    public function getMutation(): ?StateMutation
+    {
+        if (! $this->mutationData) {
+            return null;
+        }
+
+        $data = json_decode($this->mutationData, true);
+        if (! is_array($data)) {
+            return null;
+        }
+
+        return new StateMutation(
+            lightnessAdjustment: $data['lightnessAdjustment'] ?? null,
+            saturationAdjustment: $data['saturationAdjustment'] ?? null,
+            opacityAdjustment: $data['opacityAdjustment'] ?? null,
+            hueShift: $data['hueShift'] ?? null,
+            mixColor: isset($data['mixColor']) ? \App\Framework\Design\ValueObjects\CssColor::fromString($data['mixColor']) : null,
+            mixWeight: $data['mixWeight'] ?? null,
+            composedMutations: isset($data['composedMutations']) ? array_map(
+                fn(array $m) => new StateMutation(
+                    lightnessAdjustment: $m['lightnessAdjustment'] ?? null,
+                    saturationAdjustment: $m['saturationAdjustment'] ?? null,
+                    opacityAdjustment: $m['opacityAdjustment'] ?? null,
+                    hueShift: $m['hueShift'] ?? null,
+                    mixColor: isset($m['mixColor']) ? \App\Framework\Design\ValueObjects\CssColor::fromString($m['mixColor']) : null,
+                    mixWeight: $m['mixWeight'] ?? null,
+                    composedMutations: []
+                ),
+                $data['composedMutations']
+            ) : []
+        );
+    }
+
+    /**
+     * Create ColorToken from value data
+     */
+    private function createColorToken(array $valueData, ?StateMutation $mutation): TokenInterface
+    {
+        $variation = $this->createColorVariation($valueData);
+        $state = TokenState::from($this->state);
+        $baseState = $this->baseTokenId ? TokenState::DEFAULT : null;
+
+        if ($mutation || $state !== TokenState::DEFAULT) {
+            return new StatefulColorToken(
+                name: $this->name,
+                variation: $variation,
+                state: $state,
+                baseState: $baseState,
+                mutation: $mutation,
+                description: $this->description ?? ''
+            );
+        }
+
+        return new ColorToken(
+            name: $this->name,
+            variation: $variation,
+            description: $this->description ?? ''
+        );
+    }
+
+    /**
+     * Create ColorVariation from value data
+     */
+    private function createColorVariation(array $valueData): \App\Framework\Design\ValueObjects\ColorVariation
+    {
+        $light = \App\Framework\Design\ValueObjects\CssColor::fromString($valueData['light'] ?? $valueData['value'] ?? 'oklch(50% 0 0)');
+        $dark = isset($valueData['dark']) ? \App\Framework\Design\ValueObjects\CssColor::fromString($valueData['dark']) : null;
+        $p3 = isset($valueData['p3']) ? \App\Framework\Design\ValueObjects\CssColor::fromString($valueData['p3']) : null;
+        $fallback = isset($valueData['fallback']) ? \App\Framework\Design\ValueObjects\CssColor::fromString($valueData['fallback']) : null;
+
+        return new \App\Framework\Design\ValueObjects\ColorVariation(
+            name: $this->name,
+            light: $light,
+            dark: $dark,
+            p3: $p3,
+            fallback: $fallback,
+            description: $valueData['description'] ?? $this->description ?? ''
+        );
+    }
+
+    /**
+     * Create SpacingToken from value data
+     */
+    private function createSpacingToken(array $valueData): TokenInterface
+    {
+        return new SpacingToken(
+            name: $this->name,
+            value: $valueData['value'] ?? $valueData,
+            description: $this->description ?? ''
+        );
+    }
+
+    /**
+     * Create TypographyToken from value data
+     */
+    private function createTypographyToken(array $valueData): TokenInterface
+    {
+        return new TypographyToken(
+            name: $this->name,
+            value: $valueData['value'] ?? $valueData,
+            description: $this->description ?? ''
+        );
+    }
+
+    /**
+     * Serialize token value to JSON
+     */
+    private static function serializeTokenValue(TokenInterface $token): string
+    {
+        if ($token instanceof ColorToken || $token instanceof StatefulColorToken) {
+            $variation = $token->variation;
+            $data = [
+                'light' => $variation->light->toString(),
+                'description' => $variation->description,
+            ];
+
+            if ($variation->dark) {
+                $data['dark'] = $variation->dark->toString();
+            }
+            if ($variation->p3) {
+                $data['p3'] = $variation->p3->toString();
+            }
+            if ($variation->fallback) {
+                $data['fallback'] = $variation->fallback->toString();
+            }
+
+            return json_encode($data, JSON_THROW_ON_ERROR);
+        }
+
+        if ($token instanceof SpacingToken) {
+            return json_encode(['value' => $token->value], JSON_THROW_ON_ERROR);
+        }
+
+        if ($token instanceof TypographyToken) {
+            return json_encode(['value' => $token->value], JSON_THROW_ON_ERROR);
+        }
+
+        return json_encode(['value' => 'unknown'], JSON_THROW_ON_ERROR);
+    }
+
+    /**
+     * Serialize StateMutation to JSON
+     */
+    private static function serializeMutation(StateMutation $mutation): string
+    {
+        $data = [];
+
+        if ($mutation->lightnessAdjustment !== null) {
+            $data['lightnessAdjustment'] = $mutation->lightnessAdjustment;
+        }
+        if ($mutation->saturationAdjustment !== null) {
+            $data['saturationAdjustment'] = $mutation->saturationAdjustment;
+        }
+        if ($mutation->opacityAdjustment !== null) {
+            $data['opacityAdjustment'] = $mutation->opacityAdjustment;
+        }
+        if ($mutation->hueShift !== null) {
+            $data['hueShift'] = $mutation->hueShift;
+        }
+        if ($mutation->mixColor !== null) {
+            $data['mixColor'] = $mutation->mixColor->toString();
+        }
+        if ($mutation->mixWeight !== null) {
+            $data['mixWeight'] = $mutation->mixWeight;
+        }
+        if (! empty($mutation->composedMutations)) {
+            $data['composedMutations'] = array_map(
+                fn(StateMutation $m) => json_decode(self::serializeMutation($m), true),
+                $mutation->composedMutations
+            );
+        }
+
+        return json_encode($data, JSON_THROW_ON_ERROR);
+    }
+
+    /**
+     * Generate ID for token
+     */
+    private static function generateId(string $name, string $scope, TokenState $state): string
+    {
+        return "{$scope}:{$name}:{$state->value}";
+    }
+
+    /**
+     * Create from database row
+     */
+    public static function fromRow(array $row): self
+    {
+        return new self(
+            id: $row['id'],
+            name: $row['name'],
+            type: $row['type'],
+            state: $row['state'] ?? TokenState::DEFAULT->value,
+            scope: $row['scope'],
+            valueData: $row['value_data'],
+            baseTokenId: $row['base_token_id'] ?? null,
+            mutationData: $row['mutation_data'] ?? null,
+            description: $row['description'] ?? null,
+            metadata: $row['metadata'] ?? null,
+            createdAt: $row['created_at'],
+            updatedAt: $row['updated_at']
+        );
+    }
+
+    /**
+     * Convert to database row
+     */
+    public function toRow(): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'type' => $this->type,
+            'state' => $this->state,
+            'scope' => $this->scope,
+            'value_data' => $this->valueData,
+            'base_token_id' => $this->baseTokenId,
+            'mutation_data' => $this->mutationData,
+            'description' => $this->description,
+            'metadata' => $this->metadata,
+            'created_at' => $this->createdAt,
+            'updated_at' => $this->updatedAt,
+        ];
+    }
+}
+
diff --git a/src/Framework/Design/Linters/TokenLinter.php b/src/Framework/Design/Linters/TokenLinter.php
new file mode 100644
index 00000000..3de3a0fb
--- /dev/null
+++ b/src/Framework/Design/Linters/TokenLinter.php
@@ -0,0 +1,165 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Linters;
+
+use App\Framework\Design\ValueObjects\LintIssue;
+use App\Framework\Design\ValueObjects\LintResult;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Token Linter
+ *
+ * Checks tokens for code quality, naming conventions, and best practices.
+ */
+final readonly class TokenLinter
+{
+    /**
+     * Lint entire registry
+     */
+    public function lintRegistry(TokenRegistry $registry, array $usedTokens = []): LintResult
+    {
+        $issues = [];
+
+        // Check naming conventions
+        $issues = array_merge($issues, $this->checkNamingConventions($registry->all()));
+
+        // Find unused tokens
+        if (! empty($usedTokens)) {
+            $issues = array_merge($issues, $this->findUnusedTokens($registry, $usedTokens));
+        }
+
+        // Check for missing fallbacks
+        $issues = array_merge($issues, $this->checkMissingFallbacks($registry));
+
+        // Check accessibility
+        $issues = array_merge($issues, $this->checkAccessibility($registry));
+
+        return new LintResult($issues);
+    }
+
+    /**
+     * Check naming conventions
+     *
+     * @param array<string, TokenInterface> $tokens
+     * @return LintIssue[]
+     */
+    public function checkNamingConventions(array $tokens): array
+    {
+        $issues = [];
+
+        foreach ($tokens as $token) {
+            $name = $token->getName();
+
+            // Check for kebab-case
+            if (! preg_match('/^[a-z][a-z0-9-]*$/', $name)) {
+                $issues[] = new LintIssue(
+                    "Token name should be in kebab-case",
+                    $name,
+                    'warning',
+                    "Use lowercase letters, numbers, and hyphens only (e.g., 'button-primary')",
+                    'naming-convention'
+                );
+            }
+
+            // Check for consistent prefixes
+            $hasPrefix = preg_match('/^(admin-|framework-|color-|spacing-|font-)/', $name);
+            if (! $hasPrefix && ! str_starts_with($name, 'z-') && ! str_starts_with($name, 'radius-')) {
+                $issues[] = new LintIssue(
+                    "Token name should have a consistent prefix",
+                    $name,
+                    'info',
+                    "Consider using prefixes like 'admin-', 'framework-', 'color-', etc.",
+                    'naming-prefix'
+                );
+            }
+        }
+
+        return $issues;
+    }
+
+    /**
+     * Find unused tokens
+     *
+     * @return LintIssue[]
+     */
+    public function findUnusedTokens(TokenRegistry $registry, array $usedTokens): array
+    {
+        $issues = [];
+        $allTokens = array_keys($registry->all());
+
+        foreach ($allTokens as $tokenName) {
+            if (! in_array($tokenName, $usedTokens, true)) {
+                $issues[] = new LintIssue(
+                    "Token is defined but never used",
+                    $tokenName,
+                    'warning',
+                    "Consider removing unused tokens or verify they are actually used",
+                    'unused-token'
+                );
+            }
+        }
+
+        return $issues;
+    }
+
+    /**
+     * Check for missing fallbacks
+     *
+     * @return LintIssue[]
+     */
+    public function checkMissingFallbacks(TokenRegistry $registry): array
+    {
+        $issues = [];
+
+        foreach ($registry->colors() as $token) {
+            if ($token instanceof \App\Framework\Design\ValueObjects\Tokens\ColorToken) {
+                // Check if color uses modern format but has no fallback
+                if ($token->variation->light->format === \App\Framework\Design\ValueObjects\ColorFormat::OKLCH) {
+                    $fallback = $token->variation->getFallback();
+                    if ($fallback->format === \App\Framework\Design\ValueObjects\ColorFormat::OKLCH) {
+                        $issues[] = new LintIssue(
+                            "OKLCH color should have RGB/HEX fallback for older browsers",
+                            $token->getName(),
+                            'warning',
+                            "Add a fallback color using toFallback() method",
+                            'missing-fallback'
+                        );
+                    }
+                }
+            }
+        }
+
+        return $issues;
+    }
+
+    /**
+     * Check accessibility
+     *
+     * @return LintIssue[]
+     */
+    public function checkAccessibility(TokenRegistry $registry): array
+    {
+        $issues = [];
+
+        // This is a placeholder - full accessibility checking would require
+        // knowing which colors are used together (foreground/background pairs)
+        // For now, we just check if colors exist
+
+        $colorTokens = $registry->colors();
+        if (empty($colorTokens)) {
+            $issues[] = new LintIssue(
+                "No color tokens found - accessibility cannot be verified",
+                'registry',
+                'info',
+                "Add color tokens to enable accessibility checking",
+                'accessibility-check'
+            );
+        }
+
+        return $issues;
+    }
+}
+
diff --git a/src/Framework/Design/Migrations/CreateDesignTokensTable.php b/src/Framework/Design/Migrations/CreateDesignTokensTable.php
new file mode 100644
index 00000000..1eb0496f
--- /dev/null
+++ b/src/Framework/Design/Migrations/CreateDesignTokensTable.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Schema\Blueprint;
+use App\Framework\Database\Schema\Schema;
+
+/**
+ * Create Design Tokens Table
+ *
+ * Stores design tokens (colors, spacing, typography, etc.) in database
+ * for dynamic management without code deployment.
+ */
+final class CreateDesignTokensTable implements Migration
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->createIfNotExists('design_tokens', function (Blueprint $table) {
+            $table->string('id', 255)->primary();
+            $table->string('name', 255)->notNull();
+            $table->string('type', 50)->notNull(); // 'color', 'spacing', 'typography', 'shadow', etc.
+            $table->string('state', 50)->default('default'); // 'default', 'hover', 'disabled', etc.
+            $table->string('scope', 100)->notNull(); // 'framework', 'admin', 'custom', etc.
+
+            // Token Value (JSON)
+            $table->json('value_data')->notNull();
+
+            // State Mutation (wenn abgeleitet)
+            $table->string('base_token_id', 255)->nullable();
+            $table->json('mutation_data')->nullable(); // StateMutation als JSON
+
+            // Metadata
+            $table->text('description')->nullable();
+            $table->json('metadata')->nullable();
+
+            // Timestamps
+            $table->timestamps();
+
+            // Unique constraint
+            $table->unique(['name', 'state', 'scope'], 'uk_design_tokens_name_state_scope');
+
+            // Indexes
+            $table->index(['scope'], 'idx_design_tokens_scope');
+            $table->index(['type'], 'idx_design_tokens_type');
+            $table->index(['state'], 'idx_design_tokens_state');
+            $table->index(['base_token_id'], 'idx_design_tokens_base_token');
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+        $schema->dropIfExists('design_tokens');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2025_01_15_120000');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create design_tokens table for dynamic token management';
+    }
+}
+
diff --git a/src/Framework/Design/Repositories/DatabaseTokenRepository.php b/src/Framework/Design/Repositories/DatabaseTokenRepository.php
new file mode 100644
index 00000000..286565f6
--- /dev/null
+++ b/src/Framework/Design/Repositories/DatabaseTokenRepository.php
@@ -0,0 +1,304 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Repositories;
+
+use App\Framework\Cache\Cache;
+use App\Framework\Cache\CacheItem;
+use App\Framework\Cache\CacheKey;
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\Database\Repository\EntityRepository;
+use App\Framework\Design\Database\DesignTokenEntity;
+use App\Framework\Design\ValueObjects\TokenState;
+use App\Framework\Design\ValueObjects\Tokens\StatefulColorToken;
+use App\Framework\Design\ValueObjects\Tokens\StatefulTokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Database Token Repository
+ *
+ * Loads and saves design tokens from/to database.
+ * Includes caching for performance.
+ */
+final readonly class DatabaseTokenRepository
+{
+    private const CACHE_TTL = 3600; // 1 hour
+    private const CACHE_PREFIX = 'design_tokens:';
+
+    public function __construct(
+        private EntityRepository $entityRepository,
+        private ?Cache $cache = null
+    ) {
+    }
+
+    /**
+     * Load all tokens, optionally filtered by scope
+     *
+     * @return array<string, TokenInterface>
+     */
+    public function loadAll(?string $scope = null): array
+    {
+        $cacheKey = $this->getCacheKey('all', $scope);
+        
+        // Try cache first
+        if ($this->cache) {
+            $cached = $this->cache->get(CacheKey::fromString($cacheKey));
+            $item = $cached->getItem($cacheKey);
+            if ($item->isHit) {
+                return $item->value;
+            }
+        }
+
+        $criteria = $scope ? ['scope' => $scope] : [];
+        $entities = $this->entityRepository->findBy(DesignTokenEntity::class, $criteria);
+
+        $tokens = [];
+        foreach ($entities as $entity) {
+            if ($entity instanceof DesignTokenEntity) {
+                try {
+                    $token = $entity->toTokenInterface();
+                    $tokens[$token->getName()] = $token;
+                } catch (\Throwable $e) {
+                    // Log error but continue
+                    error_log("Failed to convert DesignTokenEntity to TokenInterface: {$e->getMessage()}");
+                }
+            }
+        }
+
+        // Cache result
+        if ($this->cache) {
+            $this->cache->set(
+                CacheItem::create(
+                    CacheKey::fromString($cacheKey),
+                    $tokens,
+                    Duration::fromSeconds(self::CACHE_TTL)
+                )
+            );
+        }
+
+        return $tokens;
+    }
+
+    /**
+     * Load tokens by scope
+     *
+     * @return array<string, TokenInterface>
+     */
+    public function loadByScope(string $scope): array
+    {
+        return $this->loadAll($scope);
+    }
+
+    /**
+     * Load tokens by type
+     *
+     * @return array<string, TokenInterface>
+     */
+    public function loadByType(string $type): array
+    {
+        $cacheKey = $this->getCacheKey("type:{$type}", null);
+        
+        // Try cache first
+        if ($this->cache) {
+            $cached = $this->cache->get(CacheKey::fromString($cacheKey));
+            $item = $cached->getItem($cacheKey);
+            if ($item->isHit) {
+                return $item->value;
+            }
+        }
+
+        $entities = $this->entityRepository->findBy(DesignTokenEntity::class, ['type' => $type]);
+
+        $tokens = [];
+        foreach ($entities as $entity) {
+            if ($entity instanceof DesignTokenEntity) {
+                try {
+                    $token = $entity->toTokenInterface();
+                    $tokens[$token->getName()] = $token;
+                } catch (\Throwable $e) {
+                    error_log("Failed to convert DesignTokenEntity to TokenInterface: {$e->getMessage()}");
+                }
+            }
+        }
+
+        // Cache result
+        if ($this->cache) {
+            $this->cache->set(
+                CacheItem::create(
+                    CacheKey::fromString($cacheKey),
+                    $tokens,
+                    Duration::fromSeconds(self::CACHE_TTL)
+                )
+            );
+        }
+
+        return $tokens;
+    }
+
+    /**
+     * Load specific token by name and scope
+     */
+    public function loadByName(string $name, string $scope): ?TokenInterface
+    {
+        $cacheKey = $this->getCacheKey("name:{$name}", $scope);
+        
+        // Try cache first
+        if ($this->cache) {
+            $cached = $this->cache->get(CacheKey::fromString($cacheKey));
+            $item = $cached->getItem($cacheKey);
+            if ($item->isHit) {
+                return $item->value;
+            }
+        }
+
+        $entity = $this->entityRepository->findOneBy(DesignTokenEntity::class, [
+            'name' => $name,
+            'scope' => $scope,
+            'state' => TokenState::DEFAULT->value,
+        ]);
+
+        if (! $entity instanceof DesignTokenEntity) {
+            return null;
+        }
+
+        try {
+            $token = $entity->toTokenInterface();
+
+            // Cache result
+            if ($this->cache) {
+                $this->cache->set(
+                    CacheItem::create(
+                        CacheKey::fromString($cacheKey),
+                        $token,
+                        Duration::fromSeconds(self::CACHE_TTL)
+                    )
+                );
+            }
+
+            return $token;
+        } catch (\Throwable $e) {
+            error_log("Failed to convert DesignTokenEntity to TokenInterface: {$e->getMessage()}");
+            return null;
+        }
+    }
+
+    /**
+     * Load all states for a token
+     *
+     * @return array<TokenState, StatefulTokenInterface>
+     */
+    public function loadStatesForToken(string $name, string $scope): array
+    {
+        $cacheKey = $this->getCacheKey("states:{$name}", $scope);
+        
+        // Try cache first
+        if ($this->cache) {
+            $cached = $this->cache->get(CacheKey::fromString($cacheKey));
+            $item = $cached->getItem($cacheKey);
+            if ($item->isHit) {
+                return $item->value;
+            }
+        }
+
+        $entities = $this->entityRepository->findBy(DesignTokenEntity::class, [
+            'name' => $name,
+            'scope' => $scope,
+        ]);
+
+        $states = [];
+        foreach ($entities as $entity) {
+            if ($entity instanceof DesignTokenEntity) {
+                try {
+                    $token = $entity->toTokenInterface();
+                    if ($token instanceof StatefulTokenInterface) {
+                        $states[$token->getState()] = $token;
+                    }
+                } catch (\Throwable $e) {
+                    error_log("Failed to convert DesignTokenEntity to TokenInterface: {$e->getMessage()}");
+                }
+            }
+        }
+
+        // Cache result
+        if ($this->cache) {
+            $this->cache->set(
+                CacheItem::create(
+                    CacheKey::fromString($cacheKey),
+                    $states,
+                    Duration::fromSeconds(self::CACHE_TTL)
+                )
+            );
+        }
+
+        return $states;
+    }
+
+    /**
+     * Save token to database
+     */
+    public function save(TokenInterface $token, string $scope): void
+    {
+        $entity = DesignTokenEntity::fromTokenInterface($token, $scope);
+        $this->entityRepository->save($entity);
+
+        // Invalidate cache
+        $this->invalidateCache($token->getName(), $scope, $token instanceof StatefulTokenInterface ? $token->getState() : null);
+    }
+
+    /**
+     * Delete token from database
+     */
+    public function delete(string $name, string $scope, ?TokenState $state = null): void
+    {
+        $criteria = [
+            'name' => $name,
+            'scope' => $scope,
+        ];
+
+        if ($state) {
+            $criteria['state'] = $state->value;
+        }
+
+        $entities = $this->entityRepository->findBy(DesignTokenEntity::class, $criteria);
+
+        foreach ($entities as $entity) {
+            $this->entityRepository->delete($entity);
+        }
+
+        // Invalidate cache
+        $this->invalidateCache($name, $scope, $state);
+    }
+
+    /**
+     * Get cache key
+     */
+    private function getCacheKey(string $suffix, ?string $scope): string
+    {
+        $scopePart = $scope ? "{$scope}:" : '';
+        return self::CACHE_PREFIX . $scopePart . $suffix;
+    }
+
+    /**
+     * Invalidate cache for token
+     */
+    private function invalidateCache(string $name, string $scope, ?TokenState $state): void
+    {
+        if (! $this->cache) {
+            return;
+        }
+
+        // Invalidate specific token cache
+        $this->cache->forget(CacheKey::fromString($this->getCacheKey("name:{$name}", $scope)));
+
+        // Invalidate states cache
+        $this->cache->forget(CacheKey::fromString($this->getCacheKey("states:{$name}", $scope)));
+
+        // Invalidate all tokens cache for scope
+        $this->cache->forget(CacheKey::fromString($this->getCacheKey('all', $scope)));
+
+        // Invalidate global cache
+        $this->cache->forget(CacheKey::fromString($this->getCacheKey('all', null)));
+    }
+}
+
diff --git a/src/Framework/Design/Services/ColorManipulator.php b/src/Framework/Design/Services/ColorManipulator.php
new file mode 100644
index 00000000..77a95690
--- /dev/null
+++ b/src/Framework/Design/Services/ColorManipulator.php
@@ -0,0 +1,321 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Services;
+
+use App\Framework\Design\ValueObjects\ColorFormat;
+use App\Framework\Design\ValueObjects\CssColor;
+
+/**
+ * Service for manipulating CSS colors
+ * 
+ * Works primarily with OKLCH for perceptually uniform color manipulation.
+ * Converts to OKLCH when needed, preserves original format when possible.
+ */
+final readonly class ColorManipulator
+{
+    /**
+     * Lighten a color by adjusting lightness
+     * 
+     * @param float $amount Amount to lighten (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function lighten(CssColor $color, float $amount): CssColor
+    {
+        // Normalize amount to 0-1 range if > 1 (assume percentage)
+        if ($amount > 1.0) {
+            $amount = $amount / 100.0;
+        }
+
+        $oklch = $this->toOklch($color);
+        $newLightness = min(1.0, $oklch['l'] + $amount);
+
+        return $this->fromOklch($newLightness, $oklch['c'], $oklch['h'], $oklch['a'] ?? null, $color);
+    }
+
+    /**
+     * Darken a color by adjusting lightness
+     * 
+     * @param float $amount Amount to darken (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function darken(CssColor $color, float $amount): CssColor
+    {
+        // Normalize amount to 0-1 range if > 1 (assume percentage)
+        if ($amount > 1.0) {
+            $amount = $amount / 100.0;
+        }
+
+        $oklch = $this->toOklch($color);
+        $newLightness = max(0.0, $oklch['l'] - $amount);
+
+        return $this->fromOklch($newLightness, $oklch['c'], $oklch['h'], $oklch['a'] ?? null, $color);
+    }
+
+    /**
+     * Increase color saturation
+     * 
+     * @param float $amount Amount to saturate (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function saturate(CssColor $color, float $amount): CssColor
+    {
+        // Normalize amount to 0-1 range if > 1 (assume percentage)
+        if ($amount > 1.0) {
+            $amount = $amount / 100.0;
+        }
+
+        $oklch = $this->toOklch($color);
+        $maxChroma = $this->getMaxChroma($oklch['l'], $oklch['h']);
+        $newChroma = min($maxChroma, $oklch['c'] + ($maxChroma * $amount));
+
+        return $this->fromOklch($oklch['l'], $newChroma, $oklch['h'], $oklch['a'] ?? null, $color);
+    }
+
+    /**
+     * Decrease color saturation
+     * 
+     * @param float $amount Amount to desaturate (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function desaturate(CssColor $color, float $amount): CssColor
+    {
+        // Normalize amount to 0-1 range if > 1 (assume percentage)
+        if ($amount > 1.0) {
+            $amount = $amount / 100.0;
+        }
+
+        $oklch = $this->toOklch($color);
+        $newChroma = max(0.0, $oklch['c'] - ($oklch['c'] * $amount));
+
+        return $this->fromOklch($oklch['l'], $newChroma, $oklch['h'], $oklch['a'] ?? null, $color);
+    }
+
+    /**
+     * Adjust color opacity/alpha
+     * 
+     * @param float $opacity New opacity value (0-1)
+     */
+    public function adjustOpacity(CssColor $color, float $opacity): CssColor
+    {
+        $opacity = max(0.0, min(1.0, $opacity));
+        $oklch = $this->toOklch($color);
+
+        return $this->fromOklch($oklch['l'], $oklch['c'], $oklch['h'], $opacity, $color);
+    }
+
+    /**
+     * Mix two colors
+     * 
+     * @param float $weight Weight of first color (0-1), where 0.5 means equal mix
+     */
+    public function mix(CssColor $color1, CssColor $color2, float $weight = 0.5): CssColor
+    {
+        $weight = max(0.0, min(1.0, $weight));
+        $oklch1 = $this->toOklch($color1);
+        $oklch2 = $this->toOklch($color2);
+
+        // Mix in OKLCH space for perceptually uniform results
+        $mixedL = ($oklch1['l'] * $weight) + ($oklch2['l'] * (1 - $weight));
+        $mixedC = ($oklch1['c'] * $weight) + ($oklch2['c'] * (1 - $weight));
+        
+        // Hue mixing: use shorter path around color wheel
+        $hue1 = $oklch1['h'];
+        $hue2 = $oklch2['h'];
+        $hueDiff = $hue2 - $hue1;
+        
+        // Normalize hue difference to -180 to 180 range
+        if ($hueDiff > 180) {
+            $hueDiff -= 360;
+        } elseif ($hueDiff < -180) {
+            $hueDiff += 360;
+        }
+        
+        $mixedH = $hue1 + ($hueDiff * (1 - $weight));
+        if ($mixedH < 0) {
+            $mixedH += 360;
+        } elseif ($mixedH >= 360) {
+            $mixedH -= 360;
+        }
+
+        // Mix alpha if present
+        $alpha1 = $oklch1['a'] ?? 1.0;
+        $alpha2 = $oklch2['a'] ?? 1.0;
+        $mixedAlpha = ($alpha1 * $weight) + ($alpha2 * (1 - $weight));
+
+        return $this->fromOklch($mixedL, $mixedC, $mixedH, $mixedAlpha, $color1);
+    }
+
+    /**
+     * Adjust color hue
+     * 
+     * @param float $degrees Degrees to shift hue (0-360)
+     */
+    public function adjustHue(CssColor $color, float $degrees): CssColor
+    {
+        $oklch = $this->toOklch($color);
+        $newHue = ($oklch['h'] + $degrees) % 360;
+        if ($newHue < 0) {
+            $newHue += 360;
+        }
+
+        return $this->fromOklch($oklch['l'], $oklch['c'], $newHue, $oklch['a'] ?? null, $color);
+    }
+
+    /**
+     * Convert color to OKLCH values
+     * 
+     * @return array{l: float, c: float, h: float, a?: float}
+     */
+    private function toOklch(CssColor $color): array
+    {
+        // If already OKLCH, extract values
+        if ($color->format === ColorFormat::OKLCH && $color->oklchValues !== null) {
+            $values = $color->oklchValues;
+            $l = is_string($values['l']) && str_ends_with($values['l'], '%')
+                ? (float) $values['l'] / 100.0
+                : (float) $values['l'];
+            
+            return [
+                'l' => $l,
+                'c' => (float) $values['c'],
+                'h' => (float) $values['h'],
+                'a' => isset($values['a']) ? (float) $values['a'] : null,
+            ];
+        }
+
+        // Convert via RGB if we have RGB
+        if ($color->rgbColor !== null) {
+            return $this->rgbToOklch($color->rgbColor->r, $color->rgbColor->g, $color->rgbColor->b);
+        }
+
+        // Convert via HSL if available
+        if ($color->hslValues !== null) {
+            return $this->hslToOklch($color->hslValues);
+        }
+
+        // Fallback: parse from string if it's a valid color
+        $parsed = CssColor::fromString($color->originalValue);
+        if ($parsed->oklchValues !== null) {
+            return $this->toOklch($parsed);
+        }
+
+        // Last resort: assume gray
+        return ['l' => 0.5, 'c' => 0.0, 'h' => 0.0];
+    }
+
+    /**
+     * Create CssColor from OKLCH values
+     */
+    private function fromOklch(float $l, float $c, float $h, ?float $alpha, CssColor $original): CssColor
+    {
+        // Format lightness as percentage if original was percentage
+        $lFormatted = $original->format === ColorFormat::OKLCH 
+            && $original->oklchValues !== null
+            && is_string($original->oklchValues['l'])
+            && str_ends_with($original->oklchValues['l'], '%')
+            ? ($l * 100) . '%'
+            : (string) $l;
+
+        $oklchString = $alpha !== null && $alpha < 1.0
+            ? sprintf('oklch(%s %.3f %.1f / %.3f)', $lFormatted, $c, $h, $alpha)
+            : sprintf('oklch(%s %.3f %.1f)', $lFormatted, $c, $h);
+
+        return CssColor::fromString($oklchString);
+    }
+
+    /**
+     * Convert RGB to OKLCH
+     * Simplified conversion (for production, use proper color science library)
+     */
+    private function rgbToOklch(int $r, int $g, int $b): array
+    {
+        // Convert RGB to linear RGB
+        $rLinear = $this->srgbToLinear($r / 255.0);
+        $gLinear = $this->srgbToLinear($g / 255.0);
+        $bLinear = $this->srgbToLinear($b / 255.0);
+
+        // Convert to OKLab (simplified)
+        $l = 0.4122214708 * $rLinear + 0.5363325363 * $gLinear + 0.0514459929 * $bLinear;
+        $m = 0.2119034982 * $rLinear + 0.6806995451 * $gLinear + 0.1073969566 * $bLinear;
+        $s = 0.0883024619 * $rLinear + 0.2817188376 * $gLinear + 0.6299787005 * $bLinear;
+
+        $lCbrt = $this->cbrt($l);
+        $mCbrt = $this->cbrt($m);
+        $sCbrt = $this->cbrt($s);
+
+        $l_ok = 0.2104542553 * $lCbrt + 0.7936177850 * $mCbrt - 0.0040720468 * $sCbrt;
+        $a_ok = 1.9779984951 * $lCbrt - 2.4285922050 * $mCbrt + 0.4505937099 * $sCbrt;
+        $b_ok = 0.0259040371 * $lCbrt + 0.7827717662 * $mCbrt - 0.8086757660 * $sCbrt;
+
+        // Convert OKLab to OKLCH
+        $c = sqrt($a_ok * $a_ok + $b_ok * $b_ok);
+        $h = atan2($b_ok, $a_ok) * 180.0 / M_PI;
+        if ($h < 0) {
+            $h += 360;
+        }
+
+        return ['l' => $l_ok, 'c' => $c, 'h' => $h];
+    }
+
+    /**
+     * Convert HSL to OKLCH
+     */
+    private function hslToOklch(array $hsl): array
+    {
+        // Convert HSL to RGB first, then to OKLCH
+        $h = $hsl['h'] / 360.0;
+        $s = $hsl['s'] / 100.0;
+        $l = $hsl['l'] / 100.0;
+
+        $c = (1 - abs(2 * $l - 1)) * $s;
+        $x = $c * (1 - abs(fmod($h * 6, 2) - 1));
+        $m = $l - $c / 2;
+
+        $r = $g = $b = 0;
+        if ($h < 1/6) {
+            $r = $c; $g = $x;
+        } elseif ($h < 2/6) {
+            $r = $x; $g = $c;
+        } elseif ($h < 3/6) {
+            $g = $c; $b = $x;
+        } elseif ($h < 4/6) {
+            $g = $x; $b = $c;
+        } elseif ($h < 5/6) {
+            $r = $x; $b = $c;
+        } else {
+            $r = $c; $b = $x;
+        }
+
+        $r = (int) round(($r + $m) * 255);
+        $g = (int) round(($g + $m) * 255);
+        $b = (int) round(($b + $m) * 255);
+
+        return $this->rgbToOklch($r, $g, $b);
+    }
+
+    /**
+     * Get maximum chroma for given lightness and hue
+     * Simplified - in production use proper gamut mapping
+     */
+    private function getMaxChroma(float $l, float $h): float
+    {
+        // Simplified: return a reasonable max chroma
+        // In production, calculate actual gamut boundary
+        return 0.4;
+    }
+
+    /**
+     * Convert sRGB to linear RGB
+     */
+    private function srgbToLinear(float $c): float
+    {
+        return $c <= 0.04045 ? $c / 12.92 : pow(($c + 0.055) / 1.055, 2.4);
+    }
+
+    /**
+     * Cube root function
+     */
+    private function cbrt(float $x): float
+    {
+        return $x < 0 ? -pow(-$x, 1/3) : pow($x, 1/3);
+    }
+}
+
diff --git a/src/Framework/Design/Validators/TokenValidator.php b/src/Framework/Design/Validators/TokenValidator.php
new file mode 100644
index 00000000..8a3e6167
--- /dev/null
+++ b/src/Framework/Design/Validators/TokenValidator.php
@@ -0,0 +1,289 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\Validators;
+
+use App\Framework\Design\ValueObjects\ContrastResult;
+use App\Framework\Design\ValueObjects\CssColor;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+use App\Framework\Design\ValueObjects\TokenRegistry;
+use App\Framework\Design\ValueObjects\ValidationError;
+use App\Framework\Design\ValueObjects\ValidationResult;
+use App\Framework\Design\ValueObjects\ValidationWarning;
+use App\Framework\Design\ValueObjects\Tokens\ColorToken;
+use App\Framework\Design\ValueObjects\Tokens\StatefulTokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Token Validator
+ *
+ * Validates design tokens for correctness and consistency.
+ */
+final readonly class TokenValidator
+{
+    /**
+     * Validate a single token
+     */
+    public function validateToken(TokenInterface $token): ValidationResult
+    {
+        $errors = [];
+        $warnings = [];
+
+        // Validate based on token type
+        match($token->getType()) {
+            DesignTokenType::COLOR => $this->validateColorToken($token, $errors, $warnings),
+            DesignTokenType::SPACING => $this->validateSpacingToken($token, $errors, $warnings),
+            DesignTokenType::TYPOGRAPHY => $this->validateTypographyToken($token, $errors, $warnings),
+            default => null
+        };
+
+        // General validations
+        if (empty($token->getName())) {
+            $errors[] = new ValidationError(
+                'Token name cannot be empty',
+                $token->getName() ?: 'unknown'
+            );
+        }
+
+        return new ValidationResult($errors, $warnings);
+    }
+
+    /**
+     * Validate entire registry
+     */
+    public function validateRegistry(TokenRegistry $registry): ValidationResult
+    {
+        $result = new ValidationResult();
+
+        foreach ($registry->all() as $token) {
+            $tokenResult = $this->validateToken($token);
+            $result = $result->merge($tokenResult);
+        }
+
+        // Validate state consistency for stateful tokens
+        $this->validateStateConsistency($registry, $result);
+
+        return $result;
+    }
+
+    /**
+     * Validate contrast between two colors
+     */
+    public function validateContrast(CssColor $foreground, CssColor $background): ContrastResult
+    {
+        $ratio = $this->calculateContrastRatio($foreground, $background);
+
+        $passesAA = $ratio >= 4.5;
+        $passesAAA = $ratio >= 7.0;
+
+        $level = $passesAAA ? 'AAA' : ($passesAA ? 'AA' : 'FAIL');
+
+        return new ContrastResult($ratio, $passesAA, $passesAAA, $level);
+    }
+
+    /**
+     * Validate color token
+     */
+    private function validateColorToken(TokenInterface $token, array &$errors, array &$warnings): void
+    {
+        if (! ($token instanceof ColorToken)) {
+            return;
+        }
+
+        $color = $token->variation->light;
+
+        // Validate OKLCH values if format is OKLCH
+        if ($color->format === \App\Framework\Design\ValueObjects\ColorFormat::OKLCH && $color->oklchValues) {
+            $l = $color->oklchValues['l'];
+            $c = $color->oklchValues['c'];
+            $h = $color->oklchValues['h'] ?? 0;
+
+            // Normalize lightness (handle percentage)
+            $lightness = is_string($l) && str_ends_with($l, '%') 
+                ? (float) $l / 100.0 
+                : (float) $l;
+
+            // Validate lightness (0-1 or 0-100%)
+            if ($lightness < 0 || $lightness > 1) {
+                $errors[] = new ValidationError(
+                    'OKLCH lightness must be between 0 and 1 (or 0% and 100%)',
+                    $token->getName(),
+                    'lightness',
+                    '0-1 or 0%-100%',
+                    (string) $lightness
+                );
+            }
+
+            // Validate chroma (0-0.4+)
+            if ($c < 0) {
+                $errors[] = new ValidationError(
+                    'OKLCH chroma must be >= 0',
+                    $token->getName(),
+                    'chroma',
+                    '>= 0',
+                    (string) $c
+                );
+            }
+
+            // Validate hue (0-360)
+            if ($h < 0 || $h >= 360) {
+                $errors[] = new ValidationError(
+                    'OKLCH hue must be between 0 and 360',
+                    $token->getName(),
+                    'hue',
+                    '0-360',
+                    (string) $h
+                );
+            }
+        }
+
+        // Warn if no dark mode variant
+        if (! $token->variation->dark) {
+            $warnings[] = new ValidationWarning(
+                'Color token has no dark mode variant',
+                $token->getName(),
+                'Consider adding a dark mode color for better theme support'
+            );
+        }
+    }
+
+    /**
+     * Validate spacing token
+     */
+    private function validateSpacingToken(TokenInterface $token, array &$errors, array &$warnings): void
+    {
+        if (! ($token instanceof \App\Framework\Design\ValueObjects\Tokens\SpacingToken)) {
+            return;
+        }
+
+        $value = (string) $token->value;
+
+        // Validate CSS units
+        if (! preg_match('/^[\d.]+(rem|em|px|%|vh|vw|ch|ex|cm|mm|in|pt|pc)$/', $value) && ! is_numeric($value)) {
+            $errors[] = new ValidationError(
+                'Spacing value must be a valid CSS unit',
+                $token->getName(),
+                'value',
+                'CSS unit (rem, em, px, %, etc.)',
+                $value
+            );
+        }
+    }
+
+    /**
+     * Validate typography token
+     */
+    private function validateTypographyToken(TokenInterface $token, array &$errors, array &$warnings): void
+    {
+        if (! ($token instanceof \App\Framework\Design\ValueObjects\Tokens\TypographyToken)) {
+            return;
+        }
+
+        $value = (string) $token->value;
+
+        // Check if it's a font-size token
+        if (str_contains($token->getName(), 'font-size')) {
+            // Validate font-size units
+            if (! preg_match('/^[\d.]+(rem|em|px|%|pt)$/', $value) && ! is_numeric($value)) {
+                $errors[] = new ValidationError(
+                    'Font size must be a valid CSS unit',
+                    $token->getName(),
+                    'value',
+                    'CSS unit (rem, em, px, %, pt)',
+                    $value
+                );
+            }
+        }
+
+        // Check if it's a font-weight token
+        if (str_contains($token->getName(), 'font-weight')) {
+            $validWeights = ['100', '200', '300', '400', '500', '600', '700', '800', '900', 'normal', 'bold'];
+            if (! in_array($value, $validWeights, true)) {
+                $warnings[] = new ValidationWarning(
+                    'Font weight should be a standard value',
+                    $token->getName(),
+                    'Consider using: ' . implode(', ', $validWeights)
+                );
+            }
+        }
+    }
+
+    /**
+     * Validate state consistency
+     */
+    private function validateStateConsistency(TokenRegistry $registry, ValidationResult &$result): void
+    {
+        $statefulTokens = array_filter(
+            $registry->all(),
+            fn(TokenInterface $token) => $token instanceof StatefulTokenInterface
+        );
+
+        foreach ($statefulTokens as $token) {
+            if (! ($token instanceof StatefulTokenInterface)) {
+                continue;
+            }
+
+            // Check if base state exists
+            $baseState = $token->getBaseState();
+            if ($baseState !== null) {
+                $baseToken = $registry->getTokenForState($token->getName(), $baseState);
+                if ($baseToken === null) {
+                    $result = $result->merge(new ValidationResult(
+                        errors: [
+                            new ValidationError(
+                                "Base state '{$baseState->value}' not found for token",
+                                $token->getName()
+                            )
+                        ]
+                    ));
+                }
+            }
+        }
+    }
+
+    /**
+     * Calculate contrast ratio between two colors
+     * Uses relative luminance formula from WCAG
+     */
+    private function calculateContrastRatio(CssColor $foreground, CssColor $background): float
+    {
+        $fgLuminance = $this->getRelativeLuminance($foreground);
+        $bgLuminance = $this->getRelativeLuminance($background);
+
+        $lighter = max($fgLuminance, $bgLuminance);
+        $darker = min($fgLuminance, $bgLuminance);
+
+        return ($lighter + 0.05) / ($darker + 0.05);
+    }
+
+    /**
+     * Get relative luminance of a color (WCAG formula)
+     */
+    private function getRelativeLuminance(CssColor $color): float
+    {
+        $rgb = $color->toRGB();
+        if (! $rgb) {
+            return 0.5; // Fallback
+        }
+
+        $r = $this->normalizeComponent($rgb->r);
+        $g = $this->normalizeComponent($rgb->g);
+        $b = $this->normalizeComponent($rgb->b);
+
+        return 0.2126 * $r + 0.7152 * $g + 0.0722 * $b;
+    }
+
+    /**
+     * Normalize RGB component for luminance calculation
+     */
+    private function normalizeComponent(int $component): float
+    {
+        $value = $component / 255.0;
+
+        return $value <= 0.03928
+            ? $value / 12.92
+            : pow(($value + 0.055) / 1.055, 2.4);
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ColorFormat.php b/src/Framework/Design/ValueObjects/ColorFormat.php
index e4cd0061..cd555e39 100644
--- a/src/Framework/Design/ValueObjects/ColorFormat.php
+++ b/src/Framework/Design/ValueObjects/ColorFormat.php
@@ -15,6 +15,7 @@ enum ColorFormat: string
     case HSL = 'hsl';
     case HSLA = 'hsla';
     case OKLCH = 'oklch';
+    case DISPLAY_P3 = 'display-p3';
     case NAMED = 'named';
     case CUSTOM_PROPERTY = 'custom_property';
 }
diff --git a/src/Framework/Design/ValueObjects/ColorPalette.php b/src/Framework/Design/ValueObjects/ColorPalette.php
new file mode 100644
index 00000000..6d32b39a
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ColorPalette.php
@@ -0,0 +1,86 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\Ast\CssAstBuilder;
+use App\Framework\Design\Ast\CssStylesheet;
+
+/**
+ * Color Palette - Collection of color variations
+ */
+final readonly class ColorPalette
+{
+    /**
+     * @param ColorVariation[] $variations
+     */
+    public function __construct(
+        public array $variations,
+        public string $name = 'default'
+    ) {
+    }
+
+    /**
+     * Get variation by name
+     */
+    public function getVariation(string $name): ?ColorVariation
+    {
+        foreach ($this->variations as $variation) {
+            if ($variation->name === $name) {
+                return $variation;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get all design tokens from all variations
+     * 
+     * @return DesignToken[]
+     */
+    public function getAllTokens(string $prefix = 'color'): array
+    {
+        $tokens = [];
+
+        foreach ($this->variations as $variation) {
+            $tokens = array_merge($tokens, $variation->toDesignTokens($prefix));
+        }
+
+        return $tokens;
+    }
+
+    /**
+     * Get dark mode tokens
+     * 
+     * @return DesignToken[]
+     */
+    public function getDarkModeTokens(string $prefix = 'color'): array
+    {
+        $tokens = [];
+
+        foreach ($this->variations as $variation) {
+            $darkToken = $variation->getDarkModeToken($prefix);
+            if ($darkToken) {
+                $tokens[$darkToken->name] = $darkToken;
+            }
+        }
+
+        return $tokens;
+    }
+
+    /**
+     * Build CSS AST from palette
+     */
+    public function toCssAst(
+        CssAstBuilder $builder,
+        string $layerName = 'framework-settings',
+        bool $includeHdr = true
+    ): CssStylesheet {
+        // This will be used by TokenRegistry to build AST
+        // For now, return empty stylesheet - TokenRegistry will handle it
+        return new CssStylesheet([]);
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ColorVariation.php b/src/Framework/Design/ValueObjects/ColorVariation.php
new file mode 100644
index 00000000..9eaa3ef4
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ColorVariation.php
@@ -0,0 +1,149 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Color Variation - Represents a color with light/dark/P3/fallback variants
+ */
+final readonly class ColorVariation
+{
+    public function __construct(
+        public string $name,
+        public CssColor $light,
+        public ?CssColor $dark = null,
+        public ?CssColor $p3 = null,
+        public ?CssColor $fallback = null,
+        public string $description = '',
+        public array $metadata = []
+    ) {
+    }
+
+    /**
+     * Get color for specific theme mode
+     */
+    public function getForTheme(ThemeMode $mode): CssColor
+    {
+        return match($mode) {
+            ThemeMode::DARK => $this->dark ?? $this->light,
+            ThemeMode::LIGHT => $this->light,
+            ThemeMode::AUTO => $this->light, // Will be overridden by media query
+        };
+    }
+
+    /**
+     * Generate P3 variant if not explicitly set
+     */
+    public function getP3(): ?CssColor
+    {
+        if ($this->p3) {
+            return $this->p3;
+        }
+
+        // Auto-generate P3 from light color if possible
+        if ($this->light->supportsHdr()) {
+            $p3String = $this->light->toDisplayP3();
+            if ($p3String) {
+                return CssColor::fromString($p3String);
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Generate fallback if not explicitly set
+     */
+    public function getFallback(): CssColor
+    {
+        if ($this->fallback) {
+            return $this->fallback;
+        }
+
+        // Auto-generate fallback from light color
+        $fallbackString = $this->light->toFallback();
+        
+        return CssColor::fromString($fallbackString);
+    }
+
+    /**
+     * Convert to array of ColorTokens
+     * 
+     * @return \App\Framework\Design\ValueObjects\Tokens\ColorToken[]
+     */
+    public function toDesignTokens(string $prefix = 'color'): array
+    {
+        $tokens = [];
+
+        // Base token (light mode) - main token
+        $tokens["{$prefix}-{$this->name}"] = new \App\Framework\Design\ValueObjects\Tokens\ColorToken(
+            "{$prefix}-{$this->name}",
+            $this,
+            "Color: {$this->name}"
+        );
+
+        return $tokens;
+    }
+
+    /**
+     * Get dark mode color (for dark mode token generation)
+     */
+    public function getDarkModeToken(string $prefix = 'color'): ?\App\Framework\Design\ValueObjects\Tokens\ColorToken
+    {
+        if (! $this->dark) {
+            return null;
+        }
+
+        return new \App\Framework\Design\ValueObjects\Tokens\ColorToken(
+            "{$prefix}-{$this->name}",
+            $this,
+            "Color: {$this->name} (dark mode)"
+        );
+    }
+
+    /**
+     * Create variation with state mutation
+     * 
+     * @param \App\Framework\Design\ValueObjects\TokenState $state
+     * @param \App\Framework\Design\ValueObjects\StateMutation $mutation
+     */
+    public function withState(
+        \App\Framework\Design\ValueObjects\TokenState $state,
+        \App\Framework\Design\ValueObjects\StateMutation $mutation
+    ): \App\Framework\Design\ValueObjects\Tokens\StatefulColorToken {
+        return new \App\Framework\Design\ValueObjects\Tokens\StatefulColorToken(
+            name: $this->name,
+            variation: $this,
+            state: $state,
+            baseState: \App\Framework\Design\ValueObjects\TokenState::DEFAULT,
+            mutation: $mutation,
+            description: $this->description . " ({$state->value})"
+        );
+    }
+
+    /**
+     * Get state variation
+     * 
+     * @param \App\Framework\Design\ValueObjects\TokenState $state
+     * @param \App\Framework\Design\ValueObjects\StateMutation|null $mutation
+     */
+    public function getStateVariation(
+        \App\Framework\Design\ValueObjects\TokenState $state,
+        ?\App\Framework\Design\ValueObjects\StateMutation $mutation = null
+    ): ?\App\Framework\Design\ValueObjects\Tokens\StatefulColorToken {
+        if ($state === \App\Framework\Design\ValueObjects\TokenState::DEFAULT) {
+            return null; // Default state doesn't need variation
+        }
+
+        return new \App\Framework\Design\ValueObjects\Tokens\StatefulColorToken(
+            name: $this->name,
+            variation: $this,
+            state: $state,
+            baseState: \App\Framework\Design\ValueObjects\TokenState::DEFAULT,
+            mutation: $mutation,
+            description: $this->description . " ({$state->value})"
+        );
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ContrastResult.php b/src/Framework/Design/ValueObjects/ContrastResult.php
new file mode 100644
index 00000000..df3c2cb0
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ContrastResult.php
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Contrast Result
+ *
+ * Result of WCAG contrast validation between two colors.
+ */
+final readonly class ContrastResult
+{
+    public function __construct(
+        public float $ratio,
+        public bool $passesAA,
+        public bool $passesAAA,
+        public string $level // 'AA', 'AAA', or 'FAIL'
+    ) {
+    }
+
+    /**
+     * Get human-readable description
+     */
+    public function getDescription(): string
+    {
+        return match($this->level) {
+            'AAA' => "Contrast ratio {$this->ratio}:1 passes WCAG AAA",
+            'AA' => "Contrast ratio {$this->ratio}:1 passes WCAG AA",
+            default => "Contrast ratio {$this->ratio}:1 fails WCAG AA (minimum 4.5:1 required)"
+        };
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/CssColor.php b/src/Framework/Design/ValueObjects/CssColor.php
index 87f46620..d6bfbf72 100644
--- a/src/Framework/Design/ValueObjects/CssColor.php
+++ b/src/Framework/Design/ValueObjects/CssColor.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Design\ValueObjects;
 
-use App\Framework\Core\ValueObjects\RGBColor;
-
 /**
  * Value Object für CSS-Farben mit verschiedenen Formaten
  */
@@ -83,9 +81,17 @@ final readonly class CssColor
         }
 
         // OKLCH Color
-        if (preg_match('/^oklch\(([\d.]+)\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+))?\)$/', $value, $matches)) {
+        if (preg_match('/^oklch\(([\d.]+%?)\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+))?\)$/', $value, $matches)) {
+            // Convert percentage lightness to 0-1 range if needed
+            $lightness = $matches[1];
+            if (str_ends_with($lightness, '%')) {
+                $lightness = (float) $lightness / 100;
+            } else {
+                $lightness = (float) $lightness;
+            }
+
             $oklchValues = [
-                'l' => (float) $matches[1],  // Lightness (0-1)
+                'l' => $lightness,  // Lightness (0-1 or 0-100%)
                 'c' => (float) $matches[2],  // Chroma (0-0.4+)
                 'h' => (float) $matches[3],   // Hue (0-360)
             ];
@@ -97,6 +103,11 @@ final readonly class CssColor
             return new self($value, ColorFormat::OKLCH, null, null, $oklchValues);
         }
 
+        // Display P3 Color (HDR/Wide Gamut)
+        if (preg_match('/^color\(display-p3\s+([\d.]+)\s+([\d.]+)\s+([\d.]+)(?:\s*\/\s*([\d.]+))?\)$/', $value, $matches)) {
+            return new self($value, ColorFormat::DISPLAY_P3);
+        }
+
         // CSS Custom Property
         if (preg_match('/^var\(--([^)]+)\)$/', $value, $matches)) {
             return new self($value, ColorFormat::CUSTOM_PROPERTY, null, null, null, null, $matches[1]);
@@ -282,4 +293,186 @@ final readonly class CssColor
     {
         return $this->originalValue;
     }
+
+    /**
+     * Generate Display P3 (HDR/Wide Gamut) color from OKLCH
+     *
+     * Converts OKLCH to Display P3 color space for HDR displays.
+     * This is an approximation - for exact conversion, use a color library.
+     *
+     * @return string|null Display P3 color string or null if conversion not possible
+     */
+    public function toDisplayP3(): ?string
+    {
+        // Only convert OKLCH colors to P3
+        if ($this->format !== ColorFormat::OKLCH || ! $this->oklchValues) {
+            return null;
+        }
+
+        $l = $this->oklchValues['l'];
+        $c = $this->oklchValues['c'];
+        $h = $this->oklchValues['h'] ?? 0;
+        $alpha = $this->oklchValues['a'] ?? null;
+
+        // Convert OKLCH to linear RGB (simplified)
+        // This is an approximation - for production use, consider a proper color library
+        $hRad = deg2rad($h);
+        $a = $c * cos($hRad);
+        $b = $c * sin($hRad);
+
+        // OKLab to linear RGB approximation
+        $lRgb = $l + 0.3963377774 * $a + 0.2158037573 * $b;
+        $mRgb = $l - 0.1055613458 * $a - 0.0638541728 * $b;
+        $sRgb = $l - 0.0894841775 * $a - 1.2914855480 * $b;
+
+        // Cube root
+        $lRgb = $this->cubeRoot($lRgb);
+        $mRgb = $this->cubeRoot($mRgb);
+        $sRgb = $this->cubeRoot($sRgb);
+
+        // Linear RGB to sRGB
+        $r = +4.0767416621 * $lRgb - 3.3077115913 * $mRgb + 0.2309699292 * $sRgb;
+        $g = -1.2684380046 * $lRgb + 2.6097574011 * $mRgb - 0.3413193965 * $sRgb;
+        $b = -0.0041960863 * $lRgb - 0.7034186147 * $mRgb + 1.7076147010 * $sRgb;
+
+        // Clamp to 0-1 range for P3
+        $r = max(0, min(1, $r));
+        $g = max(0, min(1, $g));
+        $b = max(0, min(1, $b));
+
+        // Format as display-p3
+        if ($alpha !== null) {
+            return sprintf('color(display-p3 %.3f %.3f %.3f / %.3f)', $r, $g, $b, $alpha);
+        }
+
+        return sprintf('color(display-p3 %.3f %.3f %.3f)', $r, $g, $b);
+    }
+
+    /**
+     * Generate fallback color (RGB/HEX) for older browsers
+     *
+     * @return string Fallback color in RGB or HEX format
+     */
+    public function toFallback(): string
+    {
+        // If already in a compatible format, return as-is
+        if (in_array($this->format, [ColorFormat::RGB, ColorFormat::RGBA, ColorFormat::HEX], true)) {
+            return $this->originalValue;
+        }
+
+        // Try to convert to RGB
+        $rgb = $this->toRGB();
+        if ($rgb) {
+            $alpha = null;
+
+            // Check for alpha in original value
+            if ($this->format === ColorFormat::RGBA || $this->format === ColorFormat::HSLA) {
+                if (preg_match('/,\s*([\d.]+)\)$/', $this->originalValue, $alphaMatches)) {
+                    $alpha = (float) $alphaMatches[1];
+                }
+            } elseif ($this->oklchValues && isset($this->oklchValues['a'])) {
+                $alpha = $this->oklchValues['a'];
+            }
+
+            if ($alpha !== null) {
+                return sprintf('rgba(%d, %d, %d, %.3f)', $rgb->r, $rgb->g, $rgb->b, $alpha);
+            }
+
+            return sprintf('rgb(%d, %d, %d)', $rgb->r, $rgb->g, $rgb->b);
+        }
+
+        // Fallback to hex if RGB conversion available
+        $hex = $this->toHex();
+        if ($hex) {
+            return $hex;
+        }
+
+        // Last resort: return original value
+        return $this->originalValue;
+    }
+
+    /**
+     * Check if color supports HDR/Wide Gamut
+     */
+    public function supportsHdr(): bool
+    {
+        return $this->format === ColorFormat::OKLCH || $this->format === ColorFormat::DISPLAY_P3;
+    }
+
+    /**
+     * Lighten the color
+     *
+     * @param float $amount Amount to lighten (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function lighten(float $amount): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->lighten($this, $amount);
+    }
+
+    /**
+     * Darken the color
+     *
+     * @param float $amount Amount to darken (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function darken(float $amount): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->darken($this, $amount);
+    }
+
+    /**
+     * Increase color saturation
+     *
+     * @param float $amount Amount to saturate (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function saturate(float $amount): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->saturate($this, $amount);
+    }
+
+    /**
+     * Decrease color saturation
+     *
+     * @param float $amount Amount to desaturate (0-1 for percentage, or 0-100 for absolute)
+     */
+    public function desaturate(float $amount): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->desaturate($this, $amount);
+    }
+
+    /**
+     * Set color opacity/alpha
+     *
+     * @param float $opacity New opacity value (0-1)
+     */
+    public function withOpacity(float $opacity): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->adjustOpacity($this, $opacity);
+    }
+
+    /**
+     * Mix with another color
+     *
+     * @param float $weight Weight of this color (0-1), where 0.5 means equal mix
+     */
+    public function mix(CssColor $other, float $weight = 0.5): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->mix($this, $other, $weight);
+    }
+
+    /**
+     * Adjust color hue
+     *
+     * @param float $degrees Degrees to shift hue (0-360)
+     */
+    public function adjustHue(float $degrees): self
+    {
+        $manipulator = new \App\Framework\Design\Services\ColorManipulator();
+        return $manipulator->adjustHue($this, $degrees);
+    }
 }
diff --git a/src/Framework/Design/ValueObjects/FrameworkTokenRegistry.php b/src/Framework/Design/ValueObjects/FrameworkTokenRegistry.php
new file mode 100644
index 00000000..5c4a9906
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/FrameworkTokenRegistry.php
@@ -0,0 +1,228 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\ValueObjects\Tokens\ColorToken;
+use App\Framework\Design\ValueObjects\Tokens\SpacingToken;
+use App\Framework\Design\ValueObjects\Tokens\TypographyToken;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Framework-wide Design Token Registry
+ * 
+ * Defines design tokens for the entire framework, not just admin area.
+ * Supports ITCSS/CUBE architecture and BEM naming conventions.
+ * Uses ColorVariation for organized color management.
+ */
+final readonly class FrameworkTokenRegistry extends TokenRegistry
+{
+    protected function initializeTokens(): array
+    {
+        $colorPalette = $this->createColorPalette();
+        $tokens = $colorPalette->getAllTokens('color');
+
+        // Add spacing tokens
+        $tokens = array_merge($tokens, $this->createSpacingTokens());
+
+        // Add typography tokens
+        $tokens = array_merge($tokens, $this->createTypographyTokens());
+
+        return $tokens;
+    }
+
+    /**
+     * Create color palette with variations
+     */
+    private function createColorPalette(): ColorPalette
+    {
+        return new ColorPalette([
+            // Primary Colors
+            new ColorVariation(
+                name: 'primary',
+                light: new CssColor('oklch(70% 0.2 295)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(60% 0.22 295)', ColorFormat::OKLCH),
+                description: 'Primary brand color'
+            ),
+            new ColorVariation(
+                name: 'primary-hover',
+                light: new CssColor('oklch(65% 0.22 295)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(55% 0.24 295)', ColorFormat::OKLCH),
+                description: 'Primary color hover state'
+            ),
+            new ColorVariation(
+                name: 'primary-active',
+                light: new CssColor('oklch(60% 0.25 295)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(50% 0.27 295)', ColorFormat::OKLCH),
+                description: 'Primary color active state'
+            ),
+
+            // Semantic Colors
+            new ColorVariation(
+                name: 'success',
+                light: new CssColor('oklch(60% 0.22 145)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(65% 0.24 145)', ColorFormat::OKLCH),
+                description: 'Success color'
+            ),
+            new ColorVariation(
+                name: 'warning',
+                light: new CssColor('oklch(70% 0.22 85)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(75% 0.24 85)', ColorFormat::OKLCH),
+                description: 'Warning color'
+            ),
+            new ColorVariation(
+                name: 'error',
+                light: new CssColor('oklch(60% 0.25 25)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(65% 0.27 25)', ColorFormat::OKLCH),
+                description: 'Error color'
+            ),
+            new ColorVariation(
+                name: 'info',
+                light: new CssColor('oklch(65% 0.2 240)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(70% 0.22 240)', ColorFormat::OKLCH),
+                description: 'Info color'
+            ),
+
+            // Background Colors
+            new ColorVariation(
+                name: 'bg',
+                light: new CssColor('oklch(18% 0.01 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(20% 0.02 270)', ColorFormat::OKLCH),
+                description: 'Main background color'
+            ),
+            new ColorVariation(
+                name: 'bg-alt',
+                light: new CssColor('oklch(26% 0.015 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(23% 0.02 270)', ColorFormat::OKLCH),
+                description: 'Alternate background color'
+            ),
+
+            // Text Colors
+            new ColorVariation(
+                name: 'text',
+                light: new CssColor('oklch(95% 0.005 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(90% 0.01 270)', ColorFormat::OKLCH),
+                description: 'Main text color'
+            ),
+            new ColorVariation(
+                name: 'text-muted',
+                light: new CssColor('oklch(70% 0.01 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(75% 0.01 270)', ColorFormat::OKLCH),
+                description: 'Muted text color'
+            ),
+
+            // Border Colors
+            new ColorVariation(
+                name: 'border',
+                light: new CssColor('oklch(40% 0.02 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(30% 0.02 270)', ColorFormat::OKLCH),
+                description: 'Border color'
+            ),
+            new ColorVariation(
+                name: 'border-light',
+                light: new CssColor('oklch(50% 0.02 270)', ColorFormat::OKLCH),
+                dark: new CssColor('oklch(35% 0.02 270)', ColorFormat::OKLCH),
+                description: 'Light border color'
+            ),
+        ], 'framework');
+    }
+
+    /**
+     * Create spacing tokens
+     * @return array<string, TokenInterface>
+     */
+    private function createSpacingTokens(): array
+    {
+        return [
+            'spacing-xs' => new SpacingToken('spacing-xs', '0.25rem', 'Extra small spacing'),
+            'spacing-sm' => new SpacingToken('spacing-sm', '0.5rem', 'Small spacing'),
+            'spacing-md' => new SpacingToken('spacing-md', '1rem', 'Medium spacing'),
+            'spacing-lg' => new SpacingToken('spacing-lg', '1.5rem', 'Large spacing'),
+            'spacing-xl' => new SpacingToken('spacing-xl', '2rem', 'Extra large spacing'),
+            'spacing-2xl' => new SpacingToken('spacing-2xl', '3rem', 'Double extra large spacing'),
+        ];
+    }
+
+    /**
+     * Create typography tokens
+     * @return array<string, TokenInterface>
+     */
+    private function createTypographyTokens(): array
+    {
+        return [
+            'font-size-xs' => new TypographyToken('font-size-xs', '0.75rem', 'Extra small font size'),
+            'font-size-sm' => new TypographyToken('font-size-sm', '0.875rem', 'Small font size'),
+            'font-size-base' => new TypographyToken('font-size-base', '1rem', 'Base font size'),
+            'font-size-lg' => new TypographyToken('font-size-lg', '1.125rem', 'Large font size'),
+            'font-size-xl' => new TypographyToken('font-size-xl', '1.25rem', 'Extra large font size'),
+            'font-size-2xl' => new TypographyToken('font-size-2xl', '1.5rem', 'Double extra large font size'),
+            'font-size-3xl' => new TypographyToken('font-size-3xl', '1.875rem', 'Triple extra large font size'),
+
+            'font-family-base' => new TypographyToken(
+                'font-family-base',
+                'system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif',
+                'Base font family'
+            ),
+            'font-family-mono' => new TypographyToken(
+                'font-family-mono',
+                '"SF Mono", Monaco, "Cascadia Code", "Roboto Mono", Consolas, monospace',
+                'Monospace font family'
+            ),
+
+            'font-weight-normal' => new TypographyToken('font-weight-normal', '400', 'Normal font weight'),
+            'font-weight-medium' => new TypographyToken('font-weight-medium', '500', 'Medium font weight'),
+            'font-weight-semibold' => new TypographyToken('font-weight-semibold', '600', 'Semibold font weight'),
+            'font-weight-bold' => new TypographyToken('font-weight-bold', '700', 'Bold font weight'),
+
+            'line-height-tight' => new TypographyToken('line-height-tight', '1.25', 'Tight line height'),
+            'line-height-normal' => new TypographyToken('line-height-normal', '1.5', 'Normal line height'),
+            'line-height-relaxed' => new TypographyToken('line-height-relaxed', '1.75', 'Relaxed line height'),
+
+            'radius-sm' => new TypographyToken('radius-sm', '0.25rem', 'Small border radius'),
+            'radius-md' => new TypographyToken('radius-md', '0.375rem', 'Medium border radius'),
+            'radius-lg' => new TypographyToken('radius-lg', '0.5rem', 'Large border radius'),
+            'radius-xl' => new TypographyToken('radius-xl', '0.75rem', 'Extra large border radius'),
+            'radius-full' => new TypographyToken('radius-full', '9999px', 'Full border radius'),
+
+            'shadow-sm' => new TypographyToken(
+                'shadow-sm',
+                '0 1px 2px 0 oklch(0% 0 0 / 0.05)',
+                'Small shadow'
+            ),
+            'shadow-md' => new TypographyToken(
+                'shadow-md',
+                '0 4px 6px -1px oklch(0% 0 0 / 0.1), 0 2px 4px -1px oklch(0% 0 0 / 0.06)',
+                'Medium shadow'
+            ),
+            'shadow-lg' => new TypographyToken(
+                'shadow-lg',
+                '0 10px 15px -3px oklch(0% 0 0 / 0.1), 0 4px 6px -2px oklch(0% 0 0 / 0.05)',
+                'Large shadow'
+            ),
+            'shadow-xl' => new TypographyToken(
+                'shadow-xl',
+                '0 20px 25px -5px oklch(0% 0 0 / 0.1), 0 10px 10px -5px oklch(0% 0 0 / 0.04)',
+                'Extra large shadow'
+            ),
+
+            'z-base' => new TypographyToken('z-base', '1', 'Base z-index'),
+            'z-header' => new TypographyToken('z-header', '90', 'Header z-index'),
+            'z-sidebar' => new TypographyToken('z-sidebar', '100', 'Sidebar z-index'),
+            'z-overlay' => new TypographyToken('z-overlay', '120', 'Overlay z-index'),
+            'z-modal' => new TypographyToken('z-modal', '130', 'Modal z-index'),
+            'z-tooltip' => new TypographyToken('z-tooltip', '140', 'Tooltip z-index'),
+            'z-toast' => new TypographyToken('z-toast', '150', 'Toast z-index'),
+
+            'transition-fast' => new TypographyToken('transition-fast', '0.15s ease', 'Fast transition'),
+            'transition-base' => new TypographyToken('transition-base', '0.2s ease', 'Base transition'),
+            'transition-slow' => new TypographyToken('transition-slow', '0.3s ease', 'Slow transition'),
+        ];
+    }
+
+    protected function getLayerName(): string
+    {
+        return 'framework-settings';
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/HybridTokenRegistry.php b/src/Framework/Design/ValueObjects/HybridTokenRegistry.php
new file mode 100644
index 00000000..043b12a0
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/HybridTokenRegistry.php
@@ -0,0 +1,101 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\Repositories\DatabaseTokenRepository;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Hybrid Token Registry
+ *
+ * Combines code-based tokens with database tokens.
+ * Database tokens override code tokens with the same name.
+ */
+final readonly class HybridTokenRegistry extends TokenRegistry
+{
+    public function __construct(
+        private TokenRegistry $codeRegistry,
+        private ?DatabaseTokenRepository $dbRepository = null
+    ) {
+        // Call parent constructor which will call initializeTokens()
+        parent::__construct();
+    }
+
+    /**
+     * Initialize tokens from code and database
+     */
+    protected function initializeTokens(): array
+    {
+        return $this->loadTokens();
+    }
+
+    /**
+     * Load tokens from code and database
+     *
+     * @return array<string, TokenInterface>
+     */
+    private function loadTokens(): array
+    {
+        // Load code-based tokens
+        $codeTokens = $this->codeRegistry->all();
+
+        // If no DB repository, return code tokens only
+        if ($this->dbRepository === null) {
+            return $codeTokens;
+        }
+
+        // Load DB tokens for all scopes (or specific scope if registry has one)
+        $scope = $this->getScope();
+        $dbTokens = $scope 
+            ? $this->dbRepository->loadByScope($scope)
+            : $this->dbRepository->loadAll();
+
+        // Merge: DB tokens override code tokens with same name
+        return array_merge($codeTokens, $dbTokens);
+    }
+
+    /**
+     * Get scope from code registry if it has one
+     */
+    private function getScope(): ?string
+    {
+        // Try to determine scope from code registry
+        // FrameworkTokenRegistry -> 'framework'
+        // AdminTokenRegistry -> 'admin'
+        $className = $this->codeRegistry::class;
+        
+        if (str_contains($className, 'FrameworkTokenRegistry')) {
+            return 'framework';
+        }
+        
+        if (str_contains($className, 'AdminTokenRegistry')) {
+            return 'admin';
+        }
+
+        return null;
+    }
+
+    /**
+     * Get dark mode color (delegates to code registry)
+     */
+    protected function getDarkModeColor(Tokens\ColorToken $token): ?CssColor
+    {
+        return $this->codeRegistry->getDarkModeColor($token);
+    }
+
+    /**
+     * Get layer name (delegates to code registry)
+     */
+    protected function getLayerName(): string
+    {
+        // Try to get layer name from code registry
+        if (method_exists($this->codeRegistry, 'getLayerName')) {
+            return $this->codeRegistry->getLayerName();
+        }
+
+        return 'framework-settings';
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/LintIssue.php b/src/Framework/Design/ValueObjects/LintIssue.php
new file mode 100644
index 00000000..87d2d42c
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/LintIssue.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Lint Issue
+ */
+final readonly class LintIssue
+{
+    public function __construct(
+        public string $message,
+        public string $tokenName,
+        public string $severity, // 'error', 'warning', 'info'
+        public ?string $suggestion = null,
+        public ?string $rule = null
+    ) {
+    }
+
+    public function toString(): string
+    {
+        $str = "[{$this->severity}] Token '{$this->tokenName}': {$this->message}";
+        
+        if ($this->rule) {
+            $str .= " (rule: {$this->rule})";
+        }
+        
+        if ($this->suggestion) {
+            $str .= " (suggestion: {$this->suggestion})";
+        }
+
+        return $str;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/LintResult.php b/src/Framework/Design/ValueObjects/LintResult.php
new file mode 100644
index 00000000..68195082
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/LintResult.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Lint Result
+ *
+ * Contains linting issues found in tokens.
+ */
+final readonly class LintResult
+{
+    /**
+     * @param LintIssue[] $issues
+     */
+    public function __construct(
+        public array $issues = []
+    ) {
+    }
+
+    /**
+     * Check if linting passed (no issues)
+     */
+    public function hasIssues(): bool
+    {
+        return ! empty($this->issues);
+    }
+
+    /**
+     * Get summary of linting result
+     */
+    public function getSummary(): string
+    {
+        $issueCount = count($this->issues);
+
+        if ($issueCount === 0) {
+            return 'Linting passed with no issues.';
+        }
+
+        return "Linting found {$issueCount} issue(s).";
+    }
+
+    /**
+     * Get issues by severity
+     *
+     * @return array<string, LintIssue[]>
+     */
+    public function getIssuesBySeverity(): array
+    {
+        $grouped = [];
+
+        foreach ($this->issues as $issue) {
+            $severity = $issue->severity;
+            if (! isset($grouped[$severity])) {
+                $grouped[$severity] = [];
+            }
+            $grouped[$severity][] = $issue;
+        }
+
+        return $grouped;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/StateMutation.php b/src/Framework/Design/ValueObjects/StateMutation.php
new file mode 100644
index 00000000..7acace5a
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/StateMutation.php
@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\Services\ColorManipulator;
+
+/**
+ * State Mutation Value Object
+ * 
+ * Represents a mutation to apply to a color for a specific state.
+ * Supports composition of multiple mutations.
+ */
+final readonly class StateMutation
+{
+    /**
+     * @param StateMutation[] $composedMutations - Unterstützt Komposition mehrerer Mutationen
+     */
+    public function __construct(
+        public ?float $lightnessAdjustment = null,  // -1.0 bis 1.0
+        public ?float $saturationAdjustment = null, // -1.0 bis 1.0
+        public ?float $opacityAdjustment = null,   // 0.0 bis 1.0
+        public ?float $hueShift = null,            // Grad
+        public ?CssColor $mixColor = null,          // Farbe zum Mixen
+        public ?float $mixWeight = null,           // Mix-Gewichtung (0-1)
+        public array $composedMutations = []       // Zusammengesetzte Mutationen
+    ) {
+    }
+
+    /**
+     * Apply mutation to a color
+     */
+    public function applyTo(CssColor $color): CssColor
+    {
+        $manipulator = new ColorManipulator();
+        $result = $color;
+
+        // First apply composed mutations (in order)
+        foreach ($this->composedMutations as $composedMutation) {
+            $result = $composedMutation->applyTo($result);
+        }
+
+        // Then apply own mutations
+        if ($this->lightnessAdjustment !== null) {
+            if ($this->lightnessAdjustment > 0) {
+                $result = $manipulator->lighten($result, abs($this->lightnessAdjustment));
+            } else {
+                $result = $manipulator->darken($result, abs($this->lightnessAdjustment));
+            }
+        }
+
+        if ($this->saturationAdjustment !== null) {
+            if ($this->saturationAdjustment > 0) {
+                $result = $manipulator->saturate($result, abs($this->saturationAdjustment));
+            } else {
+                $result = $manipulator->desaturate($result, abs($this->saturationAdjustment));
+            }
+        }
+
+        if ($this->hueShift !== null) {
+            $result = $manipulator->adjustHue($result, $this->hueShift);
+        }
+
+        if ($this->mixColor !== null && $this->mixWeight !== null) {
+            $result = $manipulator->mix($result, $this->mixColor, $this->mixWeight);
+        }
+
+        if ($this->opacityAdjustment !== null) {
+            // Opacity adjustment: if value is 0-1, treat as absolute; if > 1, treat as percentage reduction
+            $opacity = $this->opacityAdjustment;
+            if ($opacity > 1.0) {
+                // Treat as percentage: 50 means 50% opacity (0.5)
+                $opacity = $opacity / 100.0;
+            }
+            $result = $manipulator->adjustOpacity($result, $opacity);
+        }
+
+        return $result;
+    }
+
+    /**
+     * Compose this mutation with another mutation
+     * Returns a new mutation that applies both in sequence
+     */
+    public function compose(StateMutation $other): StateMutation
+    {
+        // Combine composed mutations from both
+        $allComposed = array_merge($this->composedMutations, $other->composedMutations);
+
+        // If other has its own mutations, add it to composed list
+        if (! $other->isEmpty()) {
+            $allComposed[] = $other;
+        }
+
+        return new StateMutation(
+            lightnessAdjustment: $this->lightnessAdjustment ?? $other->lightnessAdjustment,
+            saturationAdjustment: $this->saturationAdjustment ?? $other->saturationAdjustment,
+            opacityAdjustment: $this->opacityAdjustment ?? $other->opacityAdjustment,
+            hueShift: $this->hueShift ?? $other->hueShift,
+            mixColor: $this->mixColor ?? $other->mixColor,
+            mixWeight: $this->mixWeight ?? $other->mixWeight,
+            composedMutations: $allComposed
+        );
+    }
+
+    /**
+     * Check if mutation is empty (no mutations to apply)
+     */
+    public function isEmpty(): bool
+    {
+        return $this->lightnessAdjustment === null
+            && $this->saturationAdjustment === null
+            && $this->opacityAdjustment === null
+            && $this->hueShift === null
+            && $this->mixColor === null
+            && $this->mixWeight === null
+            && empty($this->composedMutations);
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/Theme.php b/src/Framework/Design/ValueObjects/Theme.php
new file mode 100644
index 00000000..1d461f19
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Theme.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Theme Value Object
+ *
+ * Represents a theme with token overrides.
+ * Themes can extend base themes for inheritance.
+ */
+final readonly class Theme
+{
+    /**
+     * @param array<string, TokenInterface> $tokenOverrides Token overrides for this theme
+     */
+    public function __construct(
+        public string $name,
+        public string $displayName,
+        public array $tokenOverrides = [],
+        public ?Theme $baseTheme = null,
+        public array $metadata = []
+    ) {
+    }
+
+    /**
+     * Get token by name (checks overrides first, then base theme)
+     */
+    public function getToken(string $name): ?TokenInterface
+    {
+        // Check overrides first
+        if (isset($this->tokenOverrides[$name])) {
+            return $this->tokenOverrides[$name];
+        }
+
+        // Check base theme
+        if ($this->baseTheme !== null) {
+            return $this->baseTheme->getToken($name);
+        }
+
+        return null;
+    }
+
+    /**
+     * Get all tokens (merged from overrides and base theme)
+     *
+     * @return array<string, TokenInterface>
+     */
+    public function getAllTokens(): array
+    {
+        $tokens = [];
+
+        // Start with base theme tokens
+        if ($this->baseTheme !== null) {
+            $tokens = $this->baseTheme->getAllTokens();
+        }
+
+        // Override with theme-specific tokens
+        return array_merge($tokens, $this->tokenOverrides);
+    }
+
+    /**
+     * Merge this theme with another theme
+     * Returns a new theme with combined overrides
+     */
+    public function merge(Theme $other): Theme
+    {
+        // Merge token overrides (other takes precedence)
+        $mergedOverrides = array_merge($this->tokenOverrides, $other->tokenOverrides);
+
+        // Merge metadata
+        $mergedMetadata = array_merge($this->metadata, $other->metadata);
+
+        return new Theme(
+            name: "{$this->name}-{$other->name}",
+            displayName: "{$this->displayName} + {$other->displayName}",
+            tokenOverrides: $mergedOverrides,
+            baseTheme: $this->baseTheme,
+            metadata: $mergedMetadata
+        );
+    }
+
+    /**
+     * Check if theme has a specific token
+     */
+    public function hasToken(string $name): bool
+    {
+        return $this->getToken($name) !== null;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ThemeRegistry.php b/src/Framework/Design/ValueObjects/ThemeRegistry.php
new file mode 100644
index 00000000..377d28dc
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ThemeRegistry.php
@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Theme Registry
+ *
+ * Manages multiple themes and theme activation.
+ */
+final readonly class ThemeRegistry
+{
+    /**
+     * @param array<string, Theme> $themes
+     */
+    public function __construct(
+        private array $themes = [],
+        private ?string $activeThemeName = null
+    ) {
+    }
+
+    /**
+     * Register a theme
+     */
+    public function registerTheme(Theme $theme): self
+    {
+        $themes = $this->themes;
+        $themes[$theme->name] = $theme;
+
+        return new self($themes, $this->activeThemeName);
+    }
+
+    /**
+     * Get theme by name
+     */
+    public function getTheme(string $name): ?Theme
+    {
+        return $this->themes[$name] ?? null;
+    }
+
+    /**
+     * Get active theme
+     */
+    public function getActiveTheme(): ?Theme
+    {
+        if ($this->activeThemeName === null) {
+            return null;
+        }
+
+        return $this->getTheme($this->activeThemeName);
+    }
+
+    /**
+     * Set active theme
+     */
+    public function setActiveTheme(string $name): self
+    {
+        if (! isset($this->themes[$name])) {
+            throw new \InvalidArgumentException("Theme '{$name}' not found");
+        }
+
+        return new self($this->themes, $name);
+    }
+
+    /**
+     * Get all themes
+     *
+     * @return array<string, Theme>
+     */
+    public function getAllThemes(): array
+    {
+        return $this->themes;
+    }
+
+    /**
+     * Check if theme exists
+     */
+    public function hasTheme(string $name): bool
+    {
+        return isset($this->themes[$name]);
+    }
+
+    /**
+     * Remove theme
+     */
+    public function removeTheme(string $name): self
+    {
+        $themes = $this->themes;
+        unset($themes[$name]);
+
+        // Clear active theme if it was removed
+        $activeThemeName = $this->activeThemeName === $name ? null : $this->activeThemeName;
+
+        return new self($themes, $activeThemeName);
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/TokenRegistry.php b/src/Framework/Design/ValueObjects/TokenRegistry.php
new file mode 100644
index 00000000..835a3186
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/TokenRegistry.php
@@ -0,0 +1,203 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\Ast\CssAstBuilder;
+use App\Framework\Design\Ast\CssStylesheet;
+use App\Framework\Design\ValueObjects\TokenState;
+use App\Framework\Design\ValueObjects\Tokens\StatefulTokenInterface;
+use App\Framework\Design\ValueObjects\Tokens\TokenInterface;
+
+/**
+ * Abstract base class for Design Token Registries
+ * 
+ * Provides common functionality for framework-wide and application-specific token registries.
+ * Supports ITCSS/CUBE architecture and BEM naming conventions.
+ * Uses CSS AST system for structured CSS generation.
+ */
+abstract readonly class TokenRegistry
+{
+    /**
+     * @var array<string, TokenInterface>
+     */
+    protected array $tokens;
+
+    public function __construct()
+    {
+        $this->tokens = $this->initializeTokens();
+    }
+
+    /**
+     * Initialize tokens - must be implemented by subclasses
+     * @return array<string, TokenInterface>
+     */
+    abstract protected function initializeTokens(): array;
+
+    /**
+     * Get token by name
+     */
+    public function get(string $name): ?TokenInterface
+    {
+        return $this->tokens[$name] ?? null;
+    }
+
+    /**
+     * Get all tokens
+     * @return array<string, TokenInterface>
+     */
+    public function all(): array
+    {
+        return $this->tokens;
+    }
+
+    /**
+     * Get tokens by category prefix
+     * @return array<string, TokenInterface>
+     */
+    public function byCategory(string $category): array
+    {
+        return array_filter(
+            $this->tokens,
+            fn(TokenInterface $token) => str_starts_with($token->getName(), $category . '-')
+        );
+    }
+
+    /**
+     * Get all color tokens
+     * @return array<string, Tokens\ColorToken>
+     */
+    public function colors(): array
+    {
+        return array_filter(
+            $this->tokens,
+            fn(TokenInterface $token) => $token instanceof Tokens\ColorToken
+        );
+    }
+
+    /**
+     * Get all spacing tokens
+     * @return array<string, TokenInterface>
+     */
+    public function spacing(): array
+    {
+        return $this->byCategory('spacing');
+    }
+
+    /**
+     * Get all typography tokens
+     * @return array<string, TokenInterface>
+     */
+    public function typography(): array
+    {
+        return array_merge(
+            $this->byCategory('font'),
+            $this->byCategory('typography')
+        );
+    }
+
+    /**
+     * Generate CSS using AST system
+     * 
+     * @param string $layerName CSS layer name (e.g., 'framework-settings', 'admin-settings')
+     * @param bool $includeHdr Include HDR/P3 variants and fallbacks
+     * @return string Generated CSS
+     */
+    public function toCss(string $layerName = 'framework-settings', bool $includeHdr = true): string
+    {
+        $builder = new CssAstBuilder();
+        $ast = $builder->buildFromRegistry($this, $layerName, $includeHdr);
+
+        return $ast->toCss();
+    }
+
+    /**
+     * Generate CSS AST
+     * 
+     * @param string $layerName CSS layer name
+     * @param bool $includeHdr Include HDR/P3 variants
+     * @return CssStylesheet CSS AST
+     */
+    public function toCssAst(string $layerName = 'framework-settings', bool $includeHdr = true): CssStylesheet
+    {
+        $builder = new CssAstBuilder();
+
+        return $builder->buildFromRegistry($this, $layerName, $includeHdr);
+    }
+
+    /**
+     * Generate dark mode CSS overrides (deprecated - use toCss() which includes dark mode)
+     * 
+     * @param string $layerName CSS layer name
+     * @return string Generated CSS
+     * @deprecated Use toCss() instead, which includes dark mode automatically
+     */
+    public function toDarkModeCss(string $layerName = 'framework-settings'): string
+    {
+        // Return empty - dark mode is now included in toCss()
+        return '';
+    }
+
+    /**
+     * Get dark mode variant of a color token
+     * Override in subclasses to provide dark mode mappings
+     * 
+     * @param Tokens\ColorToken $token
+     */
+    protected function getDarkModeColor(Tokens\ColorToken $token): ?CssColor
+    {
+        // Default: use variation's dark color if available
+        return $token->variation->dark;
+    }
+
+    /**
+     * Get token for specific state
+     * 
+     * @param string $name Token name
+     * @param TokenState $state State to get
+     */
+    public function getTokenForState(string $name, TokenState $state): ?StatefulTokenInterface
+    {
+        $token = $this->get($name);
+        
+        if ($token instanceof StatefulTokenInterface) {
+            if ($token->getState() === $state) {
+                return $token;
+            }
+            
+            // Try to get from all states
+            $states = $token->getStates();
+            return $states[$state] ?? null;
+        }
+        
+        return null;
+    }
+
+    /**
+     * Get all states for a token
+     * 
+     * @param string $name Token name
+     * @return array<TokenState, StatefulTokenInterface>
+     */
+    public function getAllStatesForToken(string $name): array
+    {
+        $token = $this->get($name);
+        
+        if ($token instanceof StatefulTokenInterface) {
+            return $token->getStates();
+        }
+        
+        return [];
+    }
+
+    /**
+     * Get layer name for CSS generation
+     * Override in subclasses to customize layer naming
+     */
+    protected function getLayerName(): string
+    {
+        return 'framework-settings';
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/TokenState.php b/src/Framework/Design/ValueObjects/TokenState.php
new file mode 100644
index 00000000..358d62ec
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/TokenState.php
@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Token State Enum
+ * 
+ * Represents different states a design token can have.
+ * Used for generating state-specific CSS (hover, disabled, etc.)
+ */
+enum TokenState: string
+{
+    case DEFAULT = 'default';
+    case DISABLED = 'disabled';
+    case HOVER = 'hover';
+    case ACTIVE = 'active';
+    case SELECTED = 'selected';
+    case FOCUSED = 'focused';
+    case LOADING = 'loading';
+    case ERROR = 'error';
+    case SUCCESS = 'success';
+    case WARNING = 'warning';
+
+    /**
+     * Get CSS pseudo-class selector for this state
+     */
+    public function toPseudoClass(): string
+    {
+        return match($this) {
+            self::DEFAULT => '',
+            self::DISABLED => ':disabled',
+            self::HOVER => ':hover',
+            self::ACTIVE => ':active',
+            self::SELECTED => ':checked',
+            self::FOCUSED => ':focus',
+            self::LOADING => '[data-loading="true"]',
+            self::ERROR => '[data-state="error"]',
+            self::SUCCESS => '[data-state="success"]',
+            self::WARNING => '[data-state="warning"]',
+        };
+    }
+
+    /**
+     * Check if this is the default state
+     */
+    public function isDefault(): bool
+    {
+        return $this === self::DEFAULT;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/TokenStateRegistry.php b/src/Framework/Design/ValueObjects/TokenStateRegistry.php
new file mode 100644
index 00000000..2955575e
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/TokenStateRegistry.php
@@ -0,0 +1,170 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+use App\Framework\Design\ValueObjects\Tokens\StatefulTokenInterface;
+
+/**
+ * Token State Registry
+ * 
+ * Manages tokens with states and generates states from base states + mutations.
+ */
+final readonly class TokenStateRegistry
+{
+    /**
+     * @param array<string, StatefulTokenInterface> $tokens
+     * @param array<TokenState, StateMutation> $stateMutations Default mutations for states
+     */
+    public function __construct(
+        public array $tokens = [],
+        public array $stateMutations = []
+    ) {
+    }
+
+    /**
+     * Get token for specific state
+     */
+    public function getTokenForState(string $name, TokenState $state): ?StatefulTokenInterface
+    {
+        // First, try to find exact match
+        $key = $this->getTokenKey($name, $state);
+        if (isset($this->tokens[$key])) {
+            return $this->tokens[$key];
+        }
+
+        // If state is DEFAULT, return null (no token found)
+        if ($state === TokenState::DEFAULT) {
+            return null;
+        }
+
+        // Try to find base token and generate state
+        $baseKey = $this->getTokenKey($name, TokenState::DEFAULT);
+        if (isset($this->tokens[$baseKey])) {
+            $baseToken = $this->tokens[$baseKey];
+            return $this->generateStateFromBase($baseToken, $state);
+        }
+
+        return null;
+    }
+
+    /**
+     * Get all states for a token name
+     * 
+     * @return array<TokenState, StatefulTokenInterface>
+     */
+    public function getAllStatesForToken(string $name): array
+    {
+        $states = [];
+
+        // Find all tokens with this name
+        foreach ($this->tokens as $token) {
+            if ($token->getName() === $name) {
+                $states[$token->getState()] = $token;
+            }
+        }
+
+        // Generate missing states from default
+        $defaultKey = $this->getTokenKey($name, TokenState::DEFAULT);
+        if (isset($this->tokens[$defaultKey])) {
+            $defaultToken = $this->tokens[$defaultKey];
+            
+            foreach (TokenState::cases() as $state) {
+                if ($state === TokenState::DEFAULT) {
+                    continue;
+                }
+                
+                if (! isset($states[$state])) {
+                    $generated = $this->generateStateFromBase($defaultToken, $state);
+                    if ($generated) {
+                        $states[$state] = $generated;
+                    }
+                }
+            }
+        }
+
+        return $states;
+    }
+
+    /**
+     * Generate state from base token
+     */
+    public function generateStatesFromBase(StatefulTokenInterface $baseToken): array
+    {
+        $states = [$baseToken->getState() => $baseToken];
+
+        foreach (TokenState::cases() as $state) {
+            if ($state === $baseToken->getState()) {
+                continue;
+            }
+
+            $generated = $this->generateStateFromBase($baseToken, $state);
+            if ($generated) {
+                $states[$state] = $generated;
+            }
+        }
+
+        return $states;
+    }
+
+    /**
+     * Generate a specific state from base token
+     */
+    private function generateStateFromBase(StatefulTokenInterface $baseToken, TokenState $targetState): ?StatefulTokenInterface
+    {
+        // Get mutation for target state (from registry or token's own mutation)
+        $mutation = $this->stateMutations[$targetState] ?? null;
+
+        // If no mutation defined, return null
+        if ($mutation === null) {
+            return null;
+        }
+
+        // Create new token with mutation
+        if ($baseToken instanceof \App\Framework\Design\ValueObjects\Tokens\StatefulColorToken) {
+            return new \App\Framework\Design\ValueObjects\Tokens\StatefulColorToken(
+                name: $baseToken->name,
+                variation: $baseToken->variation,
+                state: $targetState,
+                baseState: $baseToken->getState(),
+                mutation: $mutation,
+                description: $baseToken->description . " ({$targetState->value})"
+            );
+        }
+
+        return null;
+    }
+
+    /**
+     * Get token key for lookup
+     */
+    private function getTokenKey(string $name, TokenState $state): string
+    {
+        return "{$name}::{$state->value}";
+    }
+
+    /**
+     * Add token to registry
+     */
+    public function addToken(StatefulTokenInterface $token): self
+    {
+        $tokens = $this->tokens;
+        $key = $this->getTokenKey($token->getName(), $token->getState());
+        $tokens[$key] = $token;
+
+        return new self($tokens, $this->stateMutations);
+    }
+
+    /**
+     * Set default mutation for a state
+     */
+    public function setStateMutation(TokenState $state, StateMutation $mutation): self
+    {
+        $mutations = $this->stateMutations;
+        $mutations[$state] = $mutation;
+
+        return new self($this->tokens, $mutations);
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/ColorToken.php b/src/Framework/Design/ValueObjects/Tokens/ColorToken.php
new file mode 100644
index 00000000..b547f84c
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/ColorToken.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\Ast\CssCustomProperty;
+use App\Framework\Design\ValueObjects\ColorVariation;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+
+/**
+ * Typed color token with variation support
+ */
+final readonly class ColorToken implements TokenInterface
+{
+    public function __construct(
+        public string $name,
+        public ColorVariation $variation,
+        public string $description = ''
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getType(): DesignTokenType
+    {
+        return DesignTokenType::COLOR;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description ?: "Color: {$this->variation->name}";
+    }
+
+    public function toCssCustomProperty(): string
+    {
+        return "--{$this->name}: {$this->variation->light->toString()};";
+    }
+
+    public function toCssAstNode(): CssCustomProperty
+    {
+        return new CssCustomProperty(
+            $this->name,
+            $this->variation->light->toString(),
+            $this->description
+        );
+    }
+
+    /**
+     * Get P3 variant AST node
+     */
+    public function toP3AstNode(): ?CssCustomProperty
+    {
+        $p3 = $this->variation->getP3();
+        if (! $p3) {
+            return null;
+        }
+
+        return new CssCustomProperty(
+            "{$this->name}-p3",
+            $p3->toString(),
+            'P3/HDR variant'
+        );
+    }
+
+    /**
+     * Get dark mode AST node
+     */
+    public function toDarkModeAstNode(): ?CssCustomProperty
+    {
+        if (! $this->variation->dark) {
+            return null;
+        }
+
+        return new CssCustomProperty(
+            $this->name,
+            $this->variation->dark->toString(),
+            'Dark mode variant'
+        );
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/SpacingToken.php b/src/Framework/Design/ValueObjects/Tokens/SpacingToken.php
new file mode 100644
index 00000000..80c3a1d3
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/SpacingToken.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\Ast\CssCustomProperty;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+
+/**
+ * Typed spacing token
+ */
+final readonly class SpacingToken implements TokenInterface
+{
+    public function __construct(
+        public string $name,
+        public string|int $value,
+        public string $description = ''
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getType(): DesignTokenType
+    {
+        return DesignTokenType::SPACING;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description ?: "Spacing: {$this->name}";
+    }
+
+    public function toCssCustomProperty(): string
+    {
+        $value = is_int($this->value) ? "{$this->value}px" : $this->value;
+
+        return "--{$this->name}: {$value};";
+    }
+
+    public function toCssAstNode(): CssCustomProperty
+    {
+        $value = is_int($this->value) ? "{$this->value}px" : $this->value;
+
+        return new CssCustomProperty(
+            $this->name,
+            $value,
+            $this->description
+        );
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/StatefulColorToken.php b/src/Framework/Design/ValueObjects/Tokens/StatefulColorToken.php
new file mode 100644
index 00000000..82688815
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/StatefulColorToken.php
@@ -0,0 +1,135 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\Ast\CssCustomProperty;
+use App\Framework\Design\ValueObjects\ColorVariation;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+use App\Framework\Design\ValueObjects\StateMutation;
+use App\Framework\Design\ValueObjects\TokenState;
+
+/**
+ * Stateful Color Token
+ * 
+ * Color token that supports different states (default, hover, disabled, etc.)
+ * States can be derived from base states using mutations.
+ */
+final readonly class StatefulColorToken implements StatefulTokenInterface
+{
+    public function __construct(
+        public string $name,
+        public ColorVariation $variation,
+        public TokenState $state,
+        public ?TokenState $baseState = null,
+        public ?StateMutation $mutation = null,
+        public string $description = ''
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getType(): DesignTokenType
+    {
+        return DesignTokenType::COLOR;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description ?: "Color: {$this->variation->name} ({$this->state->value})";
+    }
+
+    public function getState(): TokenState
+    {
+        return $this->state;
+    }
+
+    public function getBaseState(): ?TokenState
+    {
+        return $this->baseState;
+    }
+
+    public function getStates(): array
+    {
+        // This would be populated by TokenStateRegistry
+        return [];
+    }
+
+    /**
+     * Get the actual color for this state
+     * Applies mutation if present
+     */
+    public function getColor(): \App\Framework\Design\ValueObjects\CssColor
+    {
+        $color = $this->variation->light;
+
+        // Apply mutation if present
+        if ($this->mutation !== null) {
+            $color = $this->mutation->applyTo($color);
+        }
+
+        return $color;
+    }
+
+    public function toCssCustomProperty(): string
+    {
+        $color = $this->getColor();
+        return "--{$this->name}: {$color->toString()};";
+    }
+
+    public function toCssAstNode(): CssCustomProperty
+    {
+        $color = $this->getColor();
+        return new CssCustomProperty(
+            $this->name,
+            $color->toString(),
+            $this->description
+        );
+    }
+
+    /**
+     * Get P3 variant AST node
+     */
+    public function toP3AstNode(): ?CssCustomProperty
+    {
+        $color = $this->getColor();
+        $p3 = $color->toDisplayP3();
+        if (! $p3) {
+            return null;
+        }
+
+        return new CssCustomProperty(
+            "{$this->name}-p3",
+            $p3,
+            'P3/HDR variant'
+        );
+    }
+
+    /**
+     * Get dark mode AST node
+     */
+    public function toDarkModeAstNode(): ?CssCustomProperty
+    {
+        if (! $this->variation->dark) {
+            return null;
+        }
+
+        $color = $this->variation->dark;
+
+        // Apply mutation to dark color too
+        if ($this->mutation !== null) {
+            $color = $this->mutation->applyTo($color);
+        }
+
+        return new CssCustomProperty(
+            $this->name,
+            $color->toString(),
+            'Dark mode variant'
+        );
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/StatefulTokenInterface.php b/src/Framework/Design/ValueObjects/Tokens/StatefulTokenInterface.php
new file mode 100644
index 00000000..851ec0b5
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/StatefulTokenInterface.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\ValueObjects\TokenState;
+
+/**
+ * Interface for tokens that support states
+ */
+interface StatefulTokenInterface extends TokenInterface
+{
+    /**
+     * Get the state of this token
+     */
+    public function getState(): TokenState;
+
+    /**
+     * Get the base state this token is derived from (if any)
+     */
+    public function getBaseState(): ?TokenState;
+
+    /**
+     * Get all states for this token name
+     * 
+     * @return array<TokenState, StatefulTokenInterface>
+     */
+    public function getStates(): array;
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/TokenInterface.php b/src/Framework/Design/ValueObjects/Tokens/TokenInterface.php
new file mode 100644
index 00000000..9fa640fe
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/TokenInterface.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\Ast\CssCustomProperty;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+
+/**
+ * Interface for all design tokens
+ */
+interface TokenInterface
+{
+    public function getName(): string;
+    public function getType(): DesignTokenType;
+    public function getDescription(): string;
+    public function toCssCustomProperty(): string;
+    public function toCssAstNode(): CssCustomProperty;
+}
+
diff --git a/src/Framework/Design/ValueObjects/Tokens/TypographyToken.php b/src/Framework/Design/ValueObjects/Tokens/TypographyToken.php
new file mode 100644
index 00000000..695e0eb2
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/Tokens/TypographyToken.php
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects\Tokens;
+
+use App\Framework\Design\Ast\CssCustomProperty;
+use App\Framework\Design\ValueObjects\DesignTokenType;
+
+/**
+ * Typed typography token
+ */
+final readonly class TypographyToken implements TokenInterface
+{
+    public function __construct(
+        public string $name,
+        public string|int|float $value,
+        public string $description = ''
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getType(): DesignTokenType
+    {
+        return DesignTokenType::TYPOGRAPHY;
+    }
+
+    public function getDescription(): string
+    {
+        return $this->description ?: "Typography: {$this->name}";
+    }
+
+    public function toCssCustomProperty(): string
+    {
+        $value = $this->formatValue($this->value);
+
+        return "--{$this->name}: {$value};";
+    }
+
+    public function toCssAstNode(): CssCustomProperty
+    {
+        $value = $this->formatValue($this->value);
+
+        return new CssCustomProperty(
+            $this->name,
+            $value,
+            $this->description
+        );
+    }
+
+    private function formatValue(string|int|float $value): string
+    {
+        if (is_int($value) || is_float($value)) {
+            // If it's a number, check if it needs units
+            if ($value < 10 && $value > 0) {
+                // Likely a line-height or similar unitless value
+                return (string) $value;
+            }
+
+            // Default to px for integers
+            return is_int($value) ? "{$value}px" : (string) $value;
+        }
+
+        return $value;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ValidationError.php b/src/Framework/Design/ValueObjects/ValidationError.php
new file mode 100644
index 00000000..0b8bc9d8
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ValidationError.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Validation Error
+ */
+final readonly class ValidationError
+{
+    public function __construct(
+        public string $message,
+        public string $tokenName,
+        public ?string $field = null,
+        public ?string $expected = null,
+        public ?string $actual = null
+    ) {
+    }
+
+    public function toString(): string
+    {
+        $str = "Token '{$this->tokenName}': {$this->message}";
+        
+        if ($this->field) {
+            $str .= " (field: {$this->field}";
+            if ($this->expected) {
+                $str .= ", expected: {$this->expected}";
+            }
+            if ($this->actual) {
+                $str .= ", actual: {$this->actual}";
+            }
+            $str .= ")";
+        }
+
+        return $str;
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ValidationResult.php b/src/Framework/Design/ValueObjects/ValidationResult.php
new file mode 100644
index 00000000..8d3d14e8
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ValidationResult.php
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Validation Result
+ *
+ * Contains validation errors and warnings.
+ */
+final readonly class ValidationResult
+{
+    /**
+     * @param ValidationError[] $errors
+     * @param ValidationWarning[] $warnings
+     */
+    public function __construct(
+        public array $errors = [],
+        public array $warnings = []
+    ) {
+    }
+
+    /**
+     * Check if validation passed (no errors)
+     */
+    public function isValid(): bool
+    {
+        return empty($this->errors);
+    }
+
+    /**
+     * Get summary of validation result
+     */
+    public function getSummary(): string
+    {
+        $errorCount = count($this->errors);
+        $warningCount = count($this->warnings);
+
+        if ($errorCount === 0 && $warningCount === 0) {
+            return 'Validation passed with no issues.';
+        }
+
+        $summary = "Validation ";
+        $summary .= $errorCount > 0 ? "failed" : "passed";
+        $summary .= " with {$errorCount} error(s) and {$warningCount} warning(s).";
+
+        return $summary;
+    }
+
+    /**
+     * Merge with another validation result
+     */
+    public function merge(ValidationResult $other): self
+    {
+        return new self(
+            errors: array_merge($this->errors, $other->errors),
+            warnings: array_merge($this->warnings, $other->warnings)
+        );
+    }
+}
+
diff --git a/src/Framework/Design/ValueObjects/ValidationWarning.php b/src/Framework/Design/ValueObjects/ValidationWarning.php
new file mode 100644
index 00000000..b3e32d94
--- /dev/null
+++ b/src/Framework/Design/ValueObjects/ValidationWarning.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Validation Warning
+ */
+final readonly class ValidationWarning
+{
+    public function __construct(
+        public string $message,
+        public string $tokenName,
+        public ?string $suggestion = null
+    ) {
+    }
+
+    public function toString(): string
+    {
+        $str = "Token '{$this->tokenName}': {$this->message}";
+        
+        if ($this->suggestion) {
+            $str .= " (suggestion: {$this->suggestion})";
+        }
+
+        return $str;
+    }
+}
+
diff --git a/src/Framework/Discovery/Analysis/DependencyAnalyzer.php b/src/Framework/Discovery/Analysis/DependencyAnalyzer.php
index 6abe506a..f72e98b2 100644
--- a/src/Framework/Discovery/Analysis/DependencyAnalyzer.php
+++ b/src/Framework/Discovery/Analysis/DependencyAnalyzer.php
@@ -13,8 +13,8 @@ use App\Framework\Discovery\ValueObjects\DependencyRelation;
 use App\Framework\Discovery\ValueObjects\DependencyType;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 use ReflectionException;
 use ReflectionMethod;
 use ReflectionProperty;
diff --git a/src/Framework/Discovery/Cache/RegistryCacheManager.php b/src/Framework/Discovery/Cache/RegistryCacheManager.php
index d3e2bad7..234892be 100644
--- a/src/Framework/Discovery/Cache/RegistryCacheManager.php
+++ b/src/Framework/Discovery/Cache/RegistryCacheManager.php
@@ -57,8 +57,7 @@ final readonly class RegistryCacheManager
 
             return $success;
         } catch (\Throwable $e) {
-            error_log("RegistryCacheManager::set failed: " . $e->getMessage());
-
+            // Cache write failed - return false silently
             return false;
         }
     }
@@ -96,8 +95,7 @@ final readonly class RegistryCacheManager
             );
 
         } catch (\Throwable $e) {
-            error_log("RegistryCacheManager::get failed: " . $e->getMessage());
-
+            // Cache read failed - return null silently
             return null;
         }
     }
diff --git a/src/Framework/Discovery/DiscoveryServiceBootstrapper.php b/src/Framework/Discovery/DiscoveryServiceBootstrapper.php
index 9f19ff01..221e787a 100644
--- a/src/Framework/Discovery/DiscoveryServiceBootstrapper.php
+++ b/src/Framework/Discovery/DiscoveryServiceBootstrapper.php
@@ -99,13 +99,7 @@ final readonly class DiscoveryServiceBootstrapper
 
                 $this->container->singleton(DiscoveryRegistry::class, $cachedRegistry);
 
-                // Process DefaultImplementation attributes first (before Initializers)
-                $defaultImplProcessor = $this->container->get(\App\Framework\DI\DefaultImplementationProcessor::class);
-                $defaultImplProcessor->process($cachedRegistry);
-
-                // Initializer-Verarbeitung für gecachte Registry
-                $initializerProcessor = $this->container->get(InitializerProcessor::class);
-                $initializerProcessor->processInitializers($cachedRegistry);
+                $this->processDiscoveryResults($cachedRegistry);
 
                 return $cachedRegistry;
             }
@@ -146,6 +140,20 @@ final readonly class DiscoveryServiceBootstrapper
         return $results;
     }
 
+    /**
+     * Verarbeitet Discovery-Ergebnisse: DefaultImplementation und Initializers
+     */
+    private function processDiscoveryResults(DiscoveryRegistry $results): void
+    {
+        // Process DefaultImplementation attributes first (before Initializers, as they may depend on them)
+        $defaultImplProcessor = $this->container->get(\App\Framework\DI\DefaultImplementationProcessor::class);
+        $defaultImplProcessor->process($results);
+
+        // Initializer-Verarbeitung mit dedizierter Klasse
+        $initializerProcessor = $this->container->get(InitializerProcessor::class);
+        $initializerProcessor->processInitializers($results);
+    }
+
     /**
      * Führt den Discovery-Prozess durch und verarbeitet die Ergebnisse
      */
@@ -162,13 +170,7 @@ final readonly class DiscoveryServiceBootstrapper
         $this->container->singleton(DiscoveryRegistry::class, $results);
         $this->container->instance(UnifiedDiscoveryService::class, $discoveryService);
 
-        // Process DefaultImplementation attributes first (before Initializers, as they may depend on them)
-        $defaultImplProcessor = $this->container->get(\App\Framework\DI\DefaultImplementationProcessor::class);
-        $defaultImplProcessor->process($results);
-
-        // Initializer-Verarbeitung mit dedizierter Klasse
-        $initializerProcessor = $this->container->get(InitializerProcessor::class);
-        $initializerProcessor->processInitializers($results);
+        $this->processDiscoveryResults($results);
 
         return $results;
     }
@@ -240,9 +242,7 @@ final readonly class DiscoveryServiceBootstrapper
         // Aktualisiere Container
         $this->container->instance(DiscoveryRegistry::class, $results);
 
-        // Re-process initializers for current context
-        $initializerProcessor = $this->container->get(InitializerProcessor::class);
-        $initializerProcessor->processInitializers($results);
+        $this->processDiscoveryResults($results);
 
         return $results;
     }
diff --git a/src/Framework/Discovery/Exceptions/DiscoveryException.php b/src/Framework/Discovery/Exceptions/DiscoveryException.php
index a693f93f..e185ebb3 100644
--- a/src/Framework/Discovery/Exceptions/DiscoveryException.php
+++ b/src/Framework/Discovery/Exceptions/DiscoveryException.php
@@ -4,15 +4,12 @@ declare(strict_types=1);
 
 namespace App\Framework\Discovery\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
  * Base exception for Discovery system operations
  *
- * Provides specialized error handling for discovery-related
- * operations with appropriate error codes and recovery hints.
+ * Provides specialized error handling for discovery-related operations.
  */
 final class DiscoveryException extends FrameworkException
 {
@@ -21,23 +18,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function memoryExhausted(string $operation, int $currentMemory, int $memoryLimit): self
     {
-        $context = ExceptionContext::forOperation('discovery.memory_exhausted', 'DiscoveryService')
-            ->withData([
-                'operation' => $operation,
-                'current_memory_mb' => round($currentMemory / 1024 / 1024, 2),
-                'memory_limit_mb' => round($memoryLimit / 1024 / 1024, 2),
-                'memory_usage_percent' => round(($currentMemory / $memoryLimit) * 100, 1),
-            ])
-            ->withDebug([
-                'current_memory_bytes' => $currentMemory,
-                'memory_limit_bytes' => $memoryLimit,
-            ]);
-
-        return self::fromContext(
-            "Discovery operation '{$operation}' failed due to memory exhaustion",
-            $context,
-            ErrorCode::MEMORY_LIMIT_EXCEEDED
-        )->withRetryAfter(300); // Suggest retry after 5 minutes
+        return new self(
+            message: "Discovery operation '{$operation}' failed due to memory exhaustion",
+            code: 0
+        );
     }
 
     /**
@@ -45,19 +29,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function scanFailed(string $directory, string $reason, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('discovery.scan_failed', 'FileScanner')
-            ->withData([
-                'directory' => $directory,
-                'reason' => $reason,
-                'is_readable' => is_readable($directory),
-                'exists' => file_exists($directory),
-            ]);
-
-        return self::fromContext(
-            "Failed to scan directory '{$directory}': {$reason}",
-            $context,
-            ErrorCode::FILESYSTEM_READ_ERROR,
-            $previous
+        return new self(
+            message: "Failed to scan directory '{$directory}': {$reason}",
+            code: 0,
+            previous: $previous
         );
     }
 
@@ -66,21 +41,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function cacheFailed(string $operation, string $key, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('discovery.cache_failed', 'DiscoveryCacheManager')
-            ->withData([
-                'cache_operation' => $operation,
-                'cache_key' => $key,
-            ])
-            ->withDebug([
-                'key_hash' => md5($key),
-                'operation_timestamp' => time(),
-            ]);
-
-        return self::fromContext(
-            "Discovery cache operation '{$operation}' failed for key '{$key}'",
-            $context,
-            ErrorCode::CACHE_OPERATION_FAILED,
-            $previous
+        return new self(
+            message: "Discovery cache operation '{$operation}' failed for key '{$key}'",
+            code: 0,
+            previous: $previous
         );
     }
 
@@ -89,19 +53,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function fileProcessingFailed(string $file, string $reason, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('discovery.file_processing_failed', 'FileProcessor')
-            ->withData([
-                'file_path' => $file,
-                'file_size' => file_exists($file) ? filesize($file) : null,
-                'file_extension' => pathinfo($file, PATHINFO_EXTENSION),
-                'reason' => $reason,
-            ]);
-
-        return self::fromContext(
-            "Failed to process file '{$file}': {$reason}",
-            $context,
-            ErrorCode::FILE_PROCESSING_FAILED,
-            $previous
+        return new self(
+            message: "Failed to process file '{$file}': {$reason}",
+            code: 0,
+            previous: $previous
         );
     }
 
@@ -110,18 +65,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function attributeReflectionFailed(string $className, string $attributeType, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('discovery.attribute_reflection_failed', 'AttributeProcessor')
-            ->withData([
-                'class_name' => $className,
-                'attribute_type' => $attributeType,
-                'class_exists' => class_exists($className),
-            ]);
-
-        return self::fromContext(
-            "Failed to reflect attribute '{$attributeType}' on class '{$className}'",
-            $context,
-            ErrorCode::REFLECTION_FAILED,
-            $previous
+        return new self(
+            message: "Failed to reflect attribute '{$attributeType}' on class '{$className}'",
+            code: 0,
+            previous: $previous
         );
     }
 
@@ -130,19 +77,9 @@ final class DiscoveryException extends FrameworkException
      */
     public static function emergencyStop(string $reason, array $memoryStats): self
     {
-        $context = ExceptionContext::forOperation('discovery.emergency_stop', 'MemoryGuard')
-            ->withData([
-                'reason' => $reason,
-                'memory_usage_mb' => round($memoryStats['current_usage'] / 1024 / 1024, 2),
-                'memory_limit_mb' => round($memoryStats['memory_limit'] / 1024 / 1024, 2),
-                'memory_pressure' => $memoryStats['memory_pressure'] ?? 'unknown',
-            ])
-            ->withDebug($memoryStats);
-
-        return self::fromContext(
-            "Discovery process stopped by memory guard: {$reason}",
-            $context,
-            ErrorCode::EMERGENCY_STOP_TRIGGERED
+        return new self(
+            message: "Discovery process stopped by memory guard: {$reason}",
+            code: 0
         );
     }
 
@@ -151,16 +88,9 @@ final class DiscoveryException extends FrameworkException
      */
     public static function configurationInvalid(string $field, string $reason): self
     {
-        $context = ExceptionContext::forOperation('discovery.configuration_invalid', 'DiscoveryConfiguration')
-            ->withData([
-                'invalid_field' => $field,
-                'validation_error' => $reason,
-            ]);
-
-        return self::fromContext(
-            "Discovery configuration invalid - {$field}: {$reason}",
-            $context,
-            ErrorCode::VAL_CONFIGURATION_INVALID
+        return new self(
+            message: "Discovery configuration invalid - {$field}: {$reason}",
+            code: 0
         );
     }
 
@@ -169,18 +99,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function timeout(int $timeoutSeconds, int $actualSeconds): self
     {
-        $context = ExceptionContext::forOperation('discovery.timeout', 'DiscoveryService')
-            ->withData([
-                'timeout_seconds' => $timeoutSeconds,
-                'actual_seconds' => $actualSeconds,
-                'exceeded_by_seconds' => $actualSeconds - $timeoutSeconds,
-            ]);
-
-        return self::fromContext(
-            "Discovery operation timed out after {$actualSeconds}s (limit: {$timeoutSeconds}s)",
-            $context,
-            ErrorCode::OPERATION_TIMEOUT
-        )->withRetryAfter(60); // Suggest retry after 1 minute
+        return new self(
+            message: "Discovery operation timed out after {$actualSeconds}s (limit: {$timeoutSeconds}s)",
+            code: 0
+        );
     }
 
     /**
@@ -188,17 +110,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function concurrentDiscovery(string $lockId): self
     {
-        $context = ExceptionContext::forOperation('discovery.concurrent_conflict', 'DiscoveryService')
-            ->withData([
-                'lock_id' => $lockId,
-                'conflict_type' => 'concurrent_discovery',
-            ]);
-
-        return self::fromContext(
-            "Discovery already in progress (lock: {$lockId})",
-            $context,
-            ErrorCode::RESOURCE_CONFLICT
-        )->withRetryAfter(30); // Suggest retry after 30 seconds
+        return new self(
+            message: "Discovery already in progress (lock: {$lockId})",
+            code: 0
+        );
     }
 
     /**
@@ -206,16 +121,9 @@ final class DiscoveryException extends FrameworkException
      */
     public static function corruptedData(string $source, string $reason): self
     {
-        $context = ExceptionContext::forOperation('discovery.corrupted_data', 'DiscoveryService')
-            ->withData([
-                'data_source' => $source,
-                'corruption_reason' => $reason,
-            ]);
-
-        return self::fromContext(
-            "Discovery data corrupted in {$source}: {$reason}",
-            $context,
-            ErrorCode::DATA_CORRUPTION_DETECTED
+        return new self(
+            message: "Discovery data corrupted in {$source}: {$reason}",
+            code: 0
         );
     }
 
@@ -224,17 +132,9 @@ final class DiscoveryException extends FrameworkException
      */
     public static function insufficientPermissions(string $path, string $requiredPermission): self
     {
-        $context = ExceptionContext::forOperation('discovery.insufficient_permissions', 'FileScanner')
-            ->withData([
-                'path' => $path,
-                'required_permission' => $requiredPermission,
-                'current_permissions' => file_exists($path) ? substr(sprintf('%o', fileperms($path)), -4) : null,
-            ]);
-
-        return self::fromContext(
-            "Insufficient permissions to access '{$path}' (required: {$requiredPermission})",
-            $context,
-            ErrorCode::PERMISSION_DENIED
+        return new self(
+            message: "Insufficient permissions to access '{$path}' (required: {$requiredPermission})",
+            code: 0
         );
     }
 
@@ -243,19 +143,10 @@ final class DiscoveryException extends FrameworkException
      */
     public static function resourceLimitExceeded(string $resource, int $current, int $limit): self
     {
-        $context = ExceptionContext::forOperation('discovery.resource_limit_exceeded', 'DiscoveryService')
-            ->withData([
-                'resource_type' => $resource,
-                'current_usage' => $current,
-                'resource_limit' => $limit,
-                'usage_percentage' => round(($current / $limit) * 100, 1),
-            ]);
-
-        return self::fromContext(
-            "Resource limit exceeded for {$resource}: {$current}/{$limit}",
-            $context,
-            ErrorCode::RESOURCE_LIMIT_EXCEEDED
-        )->withRetryAfter(60);
+        return new self(
+            message: "Resource limit exceeded for {$resource}: {$current}/{$limit}",
+            code: 0
+        );
     }
 
     /**
@@ -263,16 +154,9 @@ final class DiscoveryException extends FrameworkException
      */
     public static function dependencyMissing(string $dependency, string $requiredFor): self
     {
-        $context = ExceptionContext::forOperation('discovery.dependency_missing', 'DiscoveryService')
-            ->withData([
-                'missing_dependency' => $dependency,
-                'required_for' => $requiredFor,
-            ]);
-
-        return self::fromContext(
-            "Missing dependency '{$dependency}' required for {$requiredFor}",
-            $context,
-            ErrorCode::DEPENDENCY_MISSING
+        return new self(
+            message: "Missing dependency '{$dependency}' required for {$requiredFor}",
+            code: 0
         );
     }
 }
diff --git a/src/Framework/Discovery/Exceptions/RecoverableDiscoveryException.php b/src/Framework/Discovery/Exceptions/RecoverableDiscoveryException.php
index 910c067e..65ca1770 100644
--- a/src/Framework/Discovery/Exceptions/RecoverableDiscoveryException.php
+++ b/src/Framework/Discovery/Exceptions/RecoverableDiscoveryException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Discovery\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 use Throwable;
 
@@ -19,10 +18,11 @@ final class RecoverableDiscoveryException extends FrameworkException
         ?Throwable $previous = null,
         public readonly int $retryAfterSeconds = 1
     ) {
-        $context = ExceptionContext::forOperation('discovery.error', 'discovery')
-            ->withData(['retry_after_seconds' => $retryAfterSeconds]);
-
-        parent::__construct($message, $context, 0, $previous, null, $retryAfterSeconds);
+        parent::__construct(
+            message: $message,
+            code: 0,
+            previous: $previous
+        );
     }
 
     /**
diff --git a/src/Framework/Discovery/Factory/DiscoveryServiceFactory.php b/src/Framework/Discovery/Factory/DiscoveryServiceFactory.php
index da793238..99f52a3e 100644
--- a/src/Framework/Discovery/Factory/DiscoveryServiceFactory.php
+++ b/src/Framework/Discovery/Factory/DiscoveryServiceFactory.php
@@ -27,8 +27,8 @@ use App\Framework\Mcp\McpResourceMapper;
 use App\Framework\Mcp\McpToolMapper;
 use App\Framework\Performance\MemoryMonitor;
 use App\Framework\QueryBus\QueryHandlerMapper;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Template\Processing\DomProcessor;
 use App\Framework\Template\Processing\StringProcessor;
 
diff --git a/src/Framework/Discovery/Health/DiscoveryHealthCheck.php b/src/Framework/Discovery/Health/DiscoveryHealthCheck.php
index 730cc1e2..15fc1e35 100644
--- a/src/Framework/Discovery/Health/DiscoveryHealthCheck.php
+++ b/src/Framework/Discovery/Health/DiscoveryHealthCheck.php
@@ -21,11 +21,19 @@ use App\Framework\Health\HealthStatus;
  */
 final readonly class DiscoveryHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Discovery System Health';
+    private const int TIMEOUT_MS = 10000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private ?UnifiedDiscoveryService $discoveryService = null,
         private ?DiscoveryCacheManager $cacheManager = null,
         private ?DiscoveryMemoryManager $memoryManager = null
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -430,18 +438,8 @@ final readonly class DiscoveryHealthCheck implements HealthCheckInterface
         return $priority[$new] < $priority[$current] ? $new : $current;
     }
 
-    public function getName(): string
-    {
-        return 'Discovery System Health';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::DISCOVERY;
     }
-
-    public function getTimeout(): int
-    {
-        return 10000; // 10 seconds timeout
-    }
 }
diff --git a/src/Framework/Discovery/InitializerProcessor.php b/src/Framework/Discovery/InitializerProcessor.php
index f742eb3e..4d47714e 100644
--- a/src/Framework/Discovery/InitializerProcessor.php
+++ b/src/Framework/Discovery/InitializerProcessor.php
@@ -13,12 +13,14 @@ use App\Framework\DI\Exceptions\InitializerCycleException;
 use App\Framework\DI\FailedInitializerRegistry;
 use App\Framework\DI\Initializer;
 use App\Framework\DI\InitializerDependencyGraph;
+use App\Framework\Core\ValueObjects\ReturnType;
+use App\Framework\Core\ValueObjects\ReturnTypeValue;
 use App\Framework\DI\ValueObjects\DependencyGraphNode;
 use App\Framework\DI\ValueObjects\FailedInitializer;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
 
 /**
  * Processes and executes Initializers discovered by the Discovery system
@@ -30,7 +32,7 @@ final readonly class InitializerProcessor
 {
     public function __construct(
         private Container $container,
-        private ReflectionProvider $reflectionProvider,
+        private ReflectionService $reflectionService,
         private ExecutionContext $executionContext,
     ) {}
 
@@ -47,70 +49,84 @@ final readonly class InitializerProcessor
 
         $logger->debug("InitializerProcessor: Processing " . count($initializerResults) . " initializers");
 
-        $dependencyGraph = new InitializerDependencyGraph($this->reflectionProvider);
+        $dependencyGraph = new InitializerDependencyGraph($this->reflectionService);
         /** @var FailedInitializer[] $failedInitializers */
         $failedInitializers = [];
 
         // Phase 1: Setup-Initializer sofort ausführen & Service-Initializer zum Graph hinzufügen
         foreach ($initializerResults as $discoveredAttribute) {
 
-            /** @var Initializer $initializer */
+            /** @var Initializer|null $initializer */
             $initializer = $discoveredAttribute->createAttributeInstance();
 
-            // The actual initializer data is in the additionalData from the InitializerMapper
-            $initializerData = $discoveredAttribute->additionalData;
-
-            if (! $initializerData) {
+            // Skip if attribute instantiation failed
+            if ($initializer === null) {
+                $logger->warning("Failed to instantiate Initializer attribute", LogContext::withData([
+                    'class' => (string) $discoveredAttribute->className,
+                    'method' => (string) ($discoveredAttribute->methodName ?? 'unknown'),
+                ]));
                 continue;
             }
 
-            // Context-Filter: Prüfe ob Initializer für aktuellen Context erlaubt ist
-            // The contexts data is directly in the additionalData
-            // Wenn contexts null ist, ist der Initializer für alle Contexts verfügbar
-            if (
-                isset($initializerData['contexts'])
-                && $initializerData['contexts'] !== null
-                && ! $this->isContextAllowed(...$initializerData['contexts'])
-            ) {
+            // Check if initializer should be skipped (context filtering)
+            if ($this->shouldSkipInitializer($initializer)) {
                 continue;
             }
 
             $methodName = $discoveredAttribute->methodName ?? MethodName::invoke();
-            // The return type is directly in the additionalData from the InitializerMapper
-            $returnType = $initializerData['return'] ?? null;
+            // The return type is in the additionalData from the InitializerMapper
+            $returnTypeString = $discoveredAttribute->additionalData['return'] ?? null;
 
             try {
+                $returnType = ReturnTypeValue::fromString($returnTypeString, $discoveredAttribute->className);
+
                 // Setup-Initializer: void/null Return → Sofort ausführen
-                if ($returnType === null || $returnType === 'void') {
-                    $this->container->invoker->invoke($discoveredAttribute->className, $methodName->toString());
+                if ($returnType->hasNoReturn()) {
+                    $this->container->invoker->invoke($discoveredAttribute->className, (string) $methodName);
                 }
                 // Handle "self" return type: Replace with the declaring class
-                elseif ($returnType === 'self') {
-                    $returnType = $discoveredAttribute->className->toString();
-                    $dependencyGraph->addInitializer($returnType, $discoveredAttribute->className, $methodName);
+                elseif ($returnType->isSelf()) {
+                    $concreteReturnType = $returnType->toClassName();
+                    $dependencyGraph->addInitializer(
+                        $concreteReturnType->getFullyQualified(),
+                        $discoveredAttribute->className,
+                        $methodName
+                    );
                 }
                 // Service-Initializer: Konkreter Return-Type → Zum Dependency-Graph hinzufügen
                 else {
-                    $dependencyGraph->addInitializer($returnType, $discoveredAttribute->className, $methodName);
+                    $concreteReturnType = $returnType->toClassName();
+                    $dependencyGraph->addInitializer(
+                        $concreteReturnType->getFullyQualified(),
+                        $discoveredAttribute->className,
+                        $methodName
+                    );
                 }
             } catch (\Throwable $e) {
+                $returnTypeStringForLog = $returnTypeString ?? 'null';
                 $logger->error(
-                    "Failed to register initializer: {$discoveredAttribute->className->toString()}::{$methodName->toString()}",
+                    "Failed to register initializer: {(string) $discoveredAttribute->className}::{(string) $methodName}",
                     LogContext::withExceptionAndData($e, [
-                        'class' => $discoveredAttribute->className->toString(),
-                        'method' => $methodName->toString(),
-                        'return_type' => $returnType,
+                        'class' => (string) $discoveredAttribute->className,
+                        'method' => (string) $methodName,
+                        'return_type' => $returnTypeStringForLog,
                     ])
                 );
 
                 // Track fehlgeschlagene Initializer für spätere Diagnose
-                if ($returnType !== null && $returnType !== 'void') {
-                    $failedInitializers[] = new FailedInitializer(
-                        initializerClass: $discoveredAttribute->className,
-                        returnType: ClassName::create($returnType),
-                        errorMessage: $e->getMessage(),
-                        exceptionClass: ClassName::create(get_class($e))
-                    );
+                // Nur Service-Initializer tracken (nicht Setup-Initializer)
+                try {
+                    $returnType = ReturnTypeValue::fromString($returnTypeString, $discoveredAttribute->className);
+                    if ($returnType->hasReturnValue()) {
+                        $failedInitializers[] = new FailedInitializer(
+                            initializerClass: $discoveredAttribute->className,
+                            returnType: $returnType->toClassName(),
+                            errorMessage: $e->getMessage(),
+                            exceptionClass: ClassName::create(get_class($e))
+                        );
+                    }
+                } catch (\Throwable) {
+                    // Wenn Return-Type nicht geparst werden kann, skip tracking
                 }
 
                 // Skip failed initializers to prevent breaking the entire application
@@ -118,7 +134,8 @@ final readonly class InitializerProcessor
         }
 
         // Phase 2: Service-Initializer in optimaler Reihenfolge registrieren
-        $this->registerServicesWithDependencyGraph($dependencyGraph, $failedInitializers);
+        $additionalFailedInitializers = $this->registerServicesWithDependencyGraph($dependencyGraph);
+        $failedInitializers = array_merge($failedInitializers, $additionalFailedInitializers);
 
         // Phase 3: Registry für fehlgeschlagene Initializer im Container registrieren
         if (! empty($failedInitializers)) {
@@ -129,26 +146,32 @@ final readonly class InitializerProcessor
 
     /**
      * Registriert Services basierend auf Dependency-Graph in optimaler Reihenfolge
-     * @param FailedInitializer[] $failedInitializers
+     * @return FailedInitializer[]
      */
-    private function registerServicesWithDependencyGraph(InitializerDependencyGraph $graph, array &$failedInitializers): void
+    private function registerServicesWithDependencyGraph(InitializerDependencyGraph $graph): array
     {
         try {
             $executionOrder = $graph->getExecutionOrder();
+            $failedInitializers = [];
 
             foreach ($executionOrder as $returnType) {
                 if ($graph->hasNode($returnType)) {
                     /** @var DependencyGraphNode $node */
                     $node = $graph->getNode($returnType);
 
-                    $this->registerLazyService(
+                    $failed = $this->registerLazyService(
                         $returnType,
                         $node->getClassName(),
-                        $node->getMethodName(),
-                        $failedInitializers
+                        $node->getMethodName()
                     );
+
+                    if ($failed !== null) {
+                        $failedInitializers[] = $failed;
+                    }
                 }
             }
+
+            return $failedInitializers;
         } catch (InitializerCycleException $e) {
             // Spezielle Behandlung für Cycles: Expliziter Fallback mit detailliertem Logging
             $logger = $this->getLogger();
@@ -161,15 +184,7 @@ final readonly class InitializerProcessor
             );
 
             // Fallback: Registriere alle Services in Discovery-Reihenfolge
-            /** @var string $returnType */
-            foreach ($graph->getNodes() as $returnType => $node) {
-                $this->registerLazyService(
-                    $returnType,
-                    $node->getClassName(),
-                    $node->getMethodName(),
-                    $failedInitializers
-                );
-            }
+            return $this->registerAllNodesInOrder($graph);
         } catch (\Throwable $e) {
             // Andere Fehler: Fallback mit generischer Warnung
             $logger = $this->getLogger();
@@ -178,46 +193,51 @@ final readonly class InitializerProcessor
                 LogContext::withException($e)
             );
 
-            /** @var string $returnType */
-            foreach ($graph->getNodes() as $returnType => $node) {
-                $this->registerLazyService(
-                    $returnType,
-                    $node->getClassName(),
-                    $node->getMethodName(),
-                    $failedInitializers
-                );
-            }
+            return $this->registerAllNodesInOrder($graph);
         }
     }
 
     /**
-     * Prüft ob ein Initializer im aktuellen Context ausgeführt werden darf
+     * Registriert alle Nodes eines Dependency-Graphs in Discovery-Reihenfolge
+     * @return FailedInitializer[]
      */
-    private function isContextAllowed(mixed ...$contexts): bool
+    private function registerAllNodesInOrder(InitializerDependencyGraph $graph): array
     {
-        $currentContext = $this->executionContext->getType();
+        $failedInitializers = [];
 
-        foreach ($contexts as $context) {
-            // Handle both ContextType objects and string values (from cache deserialization)
-            if ($context instanceof ContextType) {
-                if ($currentContext === $context) {
-                    return true;
-                }
-            } elseif (is_string($context)) {
-                if ($currentContext->value === $context) {
-                    return true;
-                }
+        /** @var string $returnType */
+        foreach ($graph->getNodes() as $returnType => $node) {
+            $failed = $this->registerLazyService(
+                $returnType,
+                $node->getClassName(),
+                $node->getMethodName()
+            );
+
+            if ($failed !== null) {
+                $failedInitializers[] = $failed;
             }
         }
 
-        return false;
+        return $failedInitializers;
+    }
+
+    /**
+     * Prüft, ob ein Initializer übersprungen werden sollte
+     */
+    private function shouldSkipInitializer(Initializer $initializer): bool
+    {
+        $currentContext = $this->executionContext->getType();
+
+        // Context-Filter: Prüfe ob Initializer für aktuellen Context erlaubt ist
+        // Die allowsContext() Methode behandelt null contexts als "alle erlaubt"
+        return ! $initializer->allowsContext($currentContext);
     }
 
     /**
      * Registriert einen Service lazy im Container mit Dual-Registration für Interfaces
-     * @param FailedInitializer[] $failedInitializers
+     * @return FailedInitializer|null
      */
-    private function registerLazyService(string $returnType, string $className, string $methodName, array &$failedInitializers): void
+    private function registerLazyService(string $returnType, string $className, string $methodName): ?FailedInitializer
     {
         $factory = function ($container) use ($className, $methodName, $returnType) {
             try {
@@ -241,6 +261,7 @@ final readonly class InitializerProcessor
         try {
             // Registriere den Return-Type (Interface oder konkrete Klasse)
             $this->container->singleton($returnType, $factory);
+            return null;
         } catch (\Throwable $e) {
             $logger = $this->getLogger();
             $logger->error(
@@ -253,14 +274,12 @@ final readonly class InitializerProcessor
             );
 
             // Track fehlgeschlagenen Initializer für spätere Diagnose
-            $failedInitializers[] = new FailedInitializer(
+            return new FailedInitializer(
                 initializerClass: ClassName::create($className),
                 returnType: ClassName::create($returnType),
                 errorMessage: $e->getMessage(),
                 exceptionClass: ClassName::create(get_class($e))
             );
-
-            // Service registration failed - continue to prevent breaking the entire application
         }
     }
 
diff --git a/src/Framework/Discovery/Interfaces/ClassDiscoveryVisitor.php b/src/Framework/Discovery/Interfaces/ClassDiscoveryVisitor.php
index a0019d4a..387eb109 100644
--- a/src/Framework/Discovery/Interfaces/ClassDiscoveryVisitor.php
+++ b/src/Framework/Discovery/Interfaces/ClassDiscoveryVisitor.php
@@ -6,7 +6,7 @@ namespace App\Framework\Discovery\Interfaces;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Interface for visitors that discover items from PHP classes
diff --git a/src/Framework/Discovery/Plugins/DependencyAnalysisPlugin.php b/src/Framework/Discovery/Plugins/DependencyAnalysisPlugin.php
index 442ccce6..9a46dc74 100644
--- a/src/Framework/Discovery/Plugins/DependencyAnalysisPlugin.php
+++ b/src/Framework/Discovery/Plugins/DependencyAnalysisPlugin.php
@@ -13,7 +13,7 @@ use App\Framework\Discovery\ValueObjects\FileContext;
 use App\Framework\Filesystem\ValueObjects\FilePath;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 final readonly class DependencyAnalysisPlugin implements DiscoveryPlugin
 {
diff --git a/src/Framework/Discovery/Processing/FileStreamProcessor.php b/src/Framework/Discovery/Processing/FileStreamProcessor.php
index 6f2cdc65..faa2f3b4 100644
--- a/src/Framework/Discovery/Processing/FileStreamProcessor.php
+++ b/src/Framework/Discovery/Processing/FileStreamProcessor.php
@@ -40,7 +40,9 @@ final readonly class FileStreamProcessor
         $totalFiles = 0;
         $failedFiles = [];
 
-        error_log("FileStreamProcessor: Processing directories: " . implode(', ', $directories));
+        $this->logger?->debug('Processing directories', LogContext::withData([
+            'directories' => $directories,
+        ]));
 
         foreach ($directories as $directory) {
             $directoryPath = FilePath::create($directory);
@@ -102,10 +104,11 @@ final readonly class FileStreamProcessor
             ]);
 
             $this->logger?->warning($errorMessage, $context);
-            error_log("FileStreamProcessor: {$errorMessage}");
         }
 
-        error_log("FileStreamProcessor: Total files processed: " . $totalFiles);
+        $this->logger?->debug('Discovery processing completed', LogContext::withData([
+            'total_files' => $totalFiles,
+        ]));
 
         return $totalFiles;
     }
diff --git a/src/Framework/Discovery/Processing/ProcessingContext.php b/src/Framework/Discovery/Processing/ProcessingContext.php
index 1a482f34..b4402107 100644
--- a/src/Framework/Discovery/Processing/ProcessingContext.php
+++ b/src/Framework/Discovery/Processing/ProcessingContext.php
@@ -7,8 +7,8 @@ namespace App\Framework\Discovery\Processing;
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Discovery\ValueObjects\FileContext;
 use App\Framework\Filesystem\File;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Shared context for processing files during discovery
diff --git a/src/Framework/Discovery/Processing/VisitorCoordinator.php b/src/Framework/Discovery/Processing/VisitorCoordinator.php
index 3753f35f..41f51fcb 100644
--- a/src/Framework/Discovery/Processing/VisitorCoordinator.php
+++ b/src/Framework/Discovery/Processing/VisitorCoordinator.php
@@ -13,6 +13,7 @@ use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
 use App\Framework\Discovery\ValueObjects\FileContext;
 use App\Framework\Discovery\ValueObjects\InterfaceMapping;
 use App\Framework\Discovery\ValueObjects\TemplateMapping;
+use App\Framework\ExceptionHandling\Aggregation\DiscoveryWarningAggregator;
 use App\Framework\Filesystem\File;
 use App\Framework\Http\Method;
 use App\Framework\Logging\Logger;
@@ -38,7 +39,8 @@ final class VisitorCoordinator
         private readonly ProcessingContext $processingContext,
         private readonly array             $attributeMappers = [],
         private readonly array             $targetInterfaces = [],
-        private ?Logger                    $logger = null
+        private ?Logger                    $logger = null,
+        private ?DiscoveryWarningAggregator $warningAggregator = null
     ) {
         // Build mapper map for quick lookup
         $mapperMap = [];
@@ -63,6 +65,31 @@ final class VisitorCoordinator
         foreach ($fileContext->getClassNames() as $className) {
             $this->processClass($className, $fileContext, $collector);
         }
+
+        if ($this->warningAggregator && $this->warningAggregator->hasWarnings()) {
+            foreach ($this->warningAggregator->release() as $group) {
+                $summary = array_map(
+                    static fn ($warning): string => '- ' . $warning->message,
+                    $group->warnings
+                );
+
+                $message = sprintf(
+                    'Discovery warnings (%d) in %s:%s%s',
+                    $group->count(),
+                    $group->filePath,
+                    PHP_EOL,
+                    implode(PHP_EOL, $summary)
+                );
+
+                $context = LogContext::withData([
+                    'file_path' => $group->filePath,
+                    'error_count' => $group->count(),
+                    'errors' => array_map(static fn ($warning) => $warning->context, $group->warnings),
+                ]);
+
+                $this->logger?->warning($message, $context);
+            }
+        }
     }
 
     /**
@@ -89,23 +116,19 @@ final class VisitorCoordinator
                 $this->processInterfaces($className, $reflection, $collector);
             }
         } catch (\Throwable $e) {
-            $errorMessage = sprintf(
+            $message = sprintf(
                 'Failed to process class "%s" in file %s: %s',
                 $className->getFullyQualified(),
                 $fileContext->path->toString(),
                 $e->getMessage()
             );
-            
-            $context = LogContext::withException($e)->withData([
-                'class_name' => $className->getFullyQualified(),
-                'file_path' => $fileContext->path->toString(),
-                'exception_class' => $e::class,
-                'exception_file' => $e->getFile(),
-                'exception_line' => $e->getLine(),
-            ]);
-            
-            $this->logger?->warning($errorMessage, $context);
-            error_log($errorMessage);
+
+            $this->warningAggregator?->recordClassFailure(
+                $fileContext->path->toString(),
+                $className->getFullyQualified(),
+                $e,
+                $message
+            );
             
             // Don't re-throw - continue processing other classes
         }
@@ -156,23 +179,19 @@ final class VisitorCoordinator
         try {
             $methods = $reflection->getMethods();
         } catch (\Throwable $e) {
-            $errorMessage = sprintf(
+            $message = sprintf(
                 'Failed to get methods for class "%s" in file %s: %s',
                 $className->getFullyQualified(),
                 $fileContext->path->toString(),
                 $e->getMessage()
             );
-            
-            $context = LogContext::withException($e)->withData([
-                'class_name' => $className->getFullyQualified(),
-                'file_path' => $fileContext->path->toString(),
-                'exception_class' => $e::class,
-                'exception_file' => $e->getFile(),
-                'exception_line' => $e->getLine(),
-            ]);
-            
-            $this->logger?->warning($errorMessage, $context);
-            error_log($errorMessage);
+
+            $this->warningAggregator?->recordMethodReflectionFailure(
+                $fileContext->path->toString(),
+                $className->getFullyQualified(),
+                $e,
+                $message
+            );
             
             // Return early if we can't get methods
             return;
@@ -203,25 +222,21 @@ final class VisitorCoordinator
                     $collector->getAttributeRegistry()->add($attributeClass, $discovered);
                 }
             } catch (\Throwable $e) {
-                $errorMessage = sprintf(
+                $message = sprintf(
                     'Failed to process method "%s" in class "%s" in file %s: %s',
                     $method->getName(),
                     $className->getFullyQualified(),
                     $fileContext->path->toString(),
                     $e->getMessage()
                 );
-                
-                $context = LogContext::withException($e)->withData([
-                    'class_name' => $className->getFullyQualified(),
-                    'method_name' => $method->getName(),
-                    'file_path' => $fileContext->path->toString(),
-                    'exception_class' => $e::class,
-                    'exception_file' => $e->getFile(),
-                    'exception_line' => $e->getLine(),
-                ]);
-                
-                $this->logger?->warning($errorMessage, $context);
-                error_log($errorMessage);
+
+                $this->warningAggregator?->recordMethodProcessingFailure(
+                    $fileContext->path->toString(),
+                    $className->getFullyQualified(),
+                    $method->getName(),
+                    $e,
+                    $message
+                );
                 
                 // Continue with next method
                 continue;
diff --git a/src/Framework/Discovery/ReflectionAwareVisitor.php b/src/Framework/Discovery/ReflectionAwareVisitor.php
index 87172628..db0881c7 100644
--- a/src/Framework/Discovery/ReflectionAwareVisitor.php
+++ b/src/Framework/Discovery/ReflectionAwareVisitor.php
@@ -6,7 +6,7 @@ namespace App\Framework\Discovery;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Interface for visitors that need access to cached reflection data
diff --git a/src/Framework/Discovery/Resilience/DiscoveryTimeoutHandler.php b/src/Framework/Discovery/Resilience/DiscoveryTimeoutHandler.php
index 28457a6f..b59fe2b6 100644
--- a/src/Framework/Discovery/Resilience/DiscoveryTimeoutHandler.php
+++ b/src/Framework/Discovery/Resilience/DiscoveryTimeoutHandler.php
@@ -8,6 +8,8 @@ use App\Framework\DateTime\Clock;
 use App\Framework\Discovery\Exceptions\DiscoveryException;
 use App\Framework\Discovery\ValueObjects\DiscoveryContext;
 use App\Framework\Logging\Logger;
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Pcntl\ValueObjects\Signal;
 
 /**
  * Handles timeout management for Discovery operations
@@ -26,7 +28,8 @@ final class DiscoveryTimeoutHandler
         private readonly int $defaultTimeoutSeconds = 300, // 5 minutes
         private readonly int $memoryTimeoutSeconds = 120,  // 2 minutes for memory-constrained operations
         private readonly int $fileTimeoutSeconds = 600,    // 10 minutes for file-heavy operations
-        private readonly int $maxOperationsPerContext = 1  // Prevent concurrent operations on same context
+        private readonly int $maxOperationsPerContext = 1,  // Prevent concurrent operations on same context
+        private readonly ?PcntlService $pcntlService = null  // Optional PCNTL service for signal-based timeouts
     ) {
     }
 
@@ -54,8 +57,10 @@ final class DiscoveryTimeoutHandler
                 'context_key' => $context->getCacheKey(),
             ]);
 
-            // Set up timeout using pcntl_alarm if available, otherwise use basic timing
-            if (function_exists('pcntl_alarm') && function_exists('pcntl_signal')) {
+            // Set up timeout using PCNTL service if available, otherwise use basic timing
+            if ($this->pcntlService !== null) {
+                return $this->executeWithPcntlTimeout($operation, $operationId, $timeoutSeconds);
+            } elseif (function_exists('pcntl_alarm') && function_exists('pcntl_signal')) {
                 return $this->executeWithSignalTimeout($operation, $operationId, $timeoutSeconds);
             } else {
                 return $this->executeWithPollingTimeout($operation, $operationId, $timeoutSeconds);
@@ -67,7 +72,55 @@ final class DiscoveryTimeoutHandler
     }
 
     /**
-     * Execute with signal-based timeout (if available)
+     * Execute with PCNTL service timeout (preferred method)
+     */
+    private function executeWithPcntlTimeout(callable $operation, string $operationId, int $timeoutSeconds): mixed
+    {
+        $timedOut = false;
+
+        // Set up signal handler using PCNTL service
+        $this->pcntlService->registerSignal(Signal::SIGALRM, function () use (&$timedOut, $operationId) {
+            $timedOut = true;
+            $this->logger?->warning('Discovery operation timed out (signal)', [
+                'operation_id' => $operationId,
+            ]);
+        });
+
+        // Set alarm
+        $this->pcntlService->setAlarm($timeoutSeconds);
+
+        try {
+            $result = $operation();
+
+            // Clear alarm
+            $this->pcntlService->clearAlarm();
+
+            if ($timedOut) {
+                throw DiscoveryException::timeout($timeoutSeconds, $timeoutSeconds);
+            }
+
+            return $result;
+
+        } catch (\Throwable $e) {
+            $this->pcntlService->clearAlarm(); // Clear alarm
+
+            if ($timedOut) {
+                throw DiscoveryException::timeout($timeoutSeconds, $timeoutSeconds);
+            }
+
+            throw $e;
+        } finally {
+            // Unregister signal handler
+            try {
+                $this->pcntlService->unregisterSignal(Signal::SIGALRM);
+            } catch (\Throwable $e) {
+                // Ignore errors during cleanup
+            }
+        }
+    }
+
+    /**
+     * Execute with signal-based timeout (legacy fallback)
      */
     private function executeWithSignalTimeout(callable $operation, string $operationId, int $timeoutSeconds): mixed
     {
diff --git a/src/Framework/Discovery/Results/AttributeRegistry.php b/src/Framework/Discovery/Results/AttributeRegistry.php
index 0d11695d..d989f5a0 100644
--- a/src/Framework/Discovery/Results/AttributeRegistry.php
+++ b/src/Framework/Discovery/Results/AttributeRegistry.php
@@ -58,11 +58,6 @@ final class AttributeRegistry implements Countable
                 try {
                     $mappings[$attributeClass][] = DiscoveredAttribute::fromArray($mappingArray);
                 } catch (\Throwable $e) {
-                    // Log error for debugging
-                    error_log('⚠️ Failed to deserialize DiscoveredAttribute: ' . $e->getMessage());
-                    error_log('   Attribute Class: ' . $attributeClass);
-                    error_log('   Data keys: ' . implode(', ', array_keys($mappingArray)));
-
                     // Skip corrupted cache entries - they'll be recreated on next discovery
                     continue;
                 }
diff --git a/src/Framework/Discovery/Results/InterfaceRegistry.php b/src/Framework/Discovery/Results/InterfaceRegistry.php
index 38049a27..10ffdef8 100644
--- a/src/Framework/Discovery/Results/InterfaceRegistry.php
+++ b/src/Framework/Discovery/Results/InterfaceRegistry.php
@@ -75,9 +75,6 @@ final class InterfaceRegistry implements Countable
      */
     public function get(string $interface): array
     {
-        // TEMPORARY FIX: Protect against incomplete object access
-        error_log("InterfaceRegistry::get() called for interface: $interface");
-
         try {
             if (! isset($this->implementationsByInterface[$interface])) {
                 $this->implementationsByInterface[$interface] = [];
@@ -85,14 +82,10 @@ final class InterfaceRegistry implements Countable
                 foreach ($this->mappings as $mapping) {
                     // Check if mapping is complete before accessing properties
                     if (! is_object($mapping)) {
-                        error_log("InterfaceRegistry::get() - Mapping is not an object: " . gettype($mapping));
-
                         continue;
                     }
 
                     if (get_class($mapping) === '__PHP_Incomplete_Class') {
-                        error_log("InterfaceRegistry::get() - Found incomplete InterfaceMapping object, skipping");
-
                         continue;
                     }
 
@@ -101,20 +94,13 @@ final class InterfaceRegistry implements Countable
                         if ($mapping->interface->getFullyQualified() === $interface) {
                             $this->implementationsByInterface[$interface][] = $mapping->implementation;
                         }
-                    } else {
-                        error_log("InterfaceRegistry::get() - Mapping missing interface or implementation properties");
                     }
                 }
             }
 
-            error_log("InterfaceRegistry::get() returning " . count($this->implementationsByInterface[$interface]) . " implementations for $interface");
-
             return $this->implementationsByInterface[$interface];
 
         } catch (\Throwable $e) {
-            error_log("InterfaceRegistry::get() caught exception: " . $e->getMessage());
-            error_log("InterfaceRegistry::get() exception trace: " . $e->getTraceAsString());
-
             // Return empty array on error to prevent fatal errors
             return [];
         }
diff --git a/src/Framework/Discovery/Storage/DiscoveryCacheManager.php b/src/Framework/Discovery/Storage/DiscoveryCacheManager.php
index 78cebb92..91b6a9b0 100644
--- a/src/Framework/Discovery/Storage/DiscoveryCacheManager.php
+++ b/src/Framework/Discovery/Storage/DiscoveryCacheManager.php
@@ -172,6 +172,16 @@ final class DiscoveryCacheManager
                 'data_size' => $dataSize->toHumanReadable(),
                 'ttl' => $adjustedTtl->toHours(),
             ]));
+        } else {
+            $this->logger?->warning('Failed to cache discovery results (memory-aware)', LogContext::withData([
+                'key' => $key->toString(),
+                'items' => count($registry),
+                'cache_level' => $cacheLevel->value,
+                'cache_tier' => $cacheTier->value,
+                'memory_pressure' => $memoryStatus->memoryPressure->toDecimal(),
+                'data_size' => $dataSize->toHumanReadable(),
+                'reason' => 'cache_write_failed',
+            ]));
         }
 
         return $success;
@@ -199,6 +209,13 @@ final class DiscoveryCacheManager
                 'items' => count($registry),
                 'ttl' => $ttl->toHours(),
             ]));
+        } else {
+            $this->logger?->warning('Failed to cache discovery results (standard)', LogContext::withData([
+                'key' => $key->toString(),
+                'items' => count($registry),
+                'ttl' => $ttl->toHours(),
+                'reason' => 'cache_write_failed',
+            ]));
         }
 
         return $success;
diff --git a/src/Framework/Discovery/Testing/DiscoveryTestHelper.php b/src/Framework/Discovery/Testing/DiscoveryTestHelper.php
index 2b387df5..182614ac 100644
--- a/src/Framework/Discovery/Testing/DiscoveryTestHelper.php
+++ b/src/Framework/Discovery/Testing/DiscoveryTestHelper.php
@@ -15,7 +15,7 @@ use App\Framework\Discovery\ValueObjects\DiscoveryContext;
 use App\Framework\Discovery\ValueObjects\DiscoveryOptions;
 use App\Framework\Discovery\ValueObjects\ScanType;
 use App\Framework\Logging\Logger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Testing utilities for Discovery system
diff --git a/src/Framework/Discovery/UnifiedDiscoveryService.php b/src/Framework/Discovery/UnifiedDiscoveryService.php
index 45db050a..68aa678f 100644
--- a/src/Framework/Discovery/UnifiedDiscoveryService.php
+++ b/src/Framework/Discovery/UnifiedDiscoveryService.php
@@ -38,10 +38,11 @@ use App\Framework\Filesystem\ValueObjects\ScannerMemoryUsage;
 use App\Framework\Filesystem\ValueObjects\ScannerMetrics;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
+use App\Framework\ExceptionHandling\Aggregation\DiscoveryWarningAggregator;
 use App\Framework\Performance\EnhancedPerformanceCollector;
 use App\Framework\Performance\MemoryMonitor;
 use App\Framework\Performance\PerformanceCategory;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use Throwable;
 
 /**
@@ -70,6 +71,7 @@ final readonly class UnifiedDiscoveryService
     private MemoryGuard $memoryGuard;
 
     private AdaptiveChunker $adaptiveChunker;
+    private DiscoveryWarningAggregator $warningAggregator;
 
     public function __construct(
         private PathProvider $pathProvider,
@@ -128,11 +130,13 @@ final readonly class UnifiedDiscoveryService
         );
 
         // VisitorCoordinator with attribute mappers and interfaces
+        $this->warningAggregator = new DiscoveryWarningAggregator();
         $this->visitorCoordinator = new VisitorCoordinator(
             $this->processingContext,
             $this->attributeMappers,
             $this->targetInterfaces,
-            $this->logger
+            $this->logger,
+            $this->warningAggregator
         );
 
         // CacheManager with configuration-based timeout
@@ -641,7 +645,9 @@ final readonly class UnifiedDiscoveryService
      */
     private function performStandardDiscovery(DiscoveryContext $context, DiscoveryDataCollector $collector): void
     {
-        error_log("UnifiedDiscoveryService: performStandardDiscovery starting with paths: " . implode(', ', $context->paths));
+        $this->logger?->debug('Starting standard discovery', LogContext::withData([
+            'paths' => $context->paths,
+        ]));
 
         // Process files with the standard file processor and visitor coordinator
         $this->fileProcessor->processDirectories(
@@ -650,13 +656,17 @@ final readonly class UnifiedDiscoveryService
             function ($file, $fileContext, $collector) {
                 // Debug: Log files being processed, specifically looking for RequestFactory
                 if (str_contains($file->getPath()->toString(), 'RequestFactory.php')) {
-                    error_log("UnifiedDiscoveryService: Processing RequestFactory file: " . $file->getPath()->toString());
+                    $this->logger?->debug('Processing RequestFactory file', LogContext::withData([
+                        'file' => $file->getPath()->toString(),
+                    ]));
                 }
                 $this->visitorCoordinator->processFile($file, $fileContext, $collector);
             }
         );
 
-        error_log("UnifiedDiscoveryService: performStandardDiscovery completed");
+        $this->logger?->debug('Standard discovery completed', LogContext::withData([
+            'paths' => $context->paths,
+        ]));
     }
 
     /**
diff --git a/src/Framework/Discovery/ValueObjects/DiscoveredAttribute.php b/src/Framework/Discovery/ValueObjects/DiscoveredAttribute.php
index c17c04b1..d2a6a10c 100644
--- a/src/Framework/Discovery/ValueObjects/DiscoveredAttribute.php
+++ b/src/Framework/Discovery/ValueObjects/DiscoveredAttribute.php
@@ -115,6 +115,21 @@ final readonly class DiscoveredAttribute
         }
 
         $arguments = $data['arguments'] ?? [];
+
+        // Deserialize enum instances from metadata
+        foreach ($arguments as $key => $value) {
+            if (is_array($value) && ($value['__enum'] ?? false)) {
+                $enumClass = $value['class'];
+                if (isset($value['value'])) {
+                    // Backed enum - use from() method
+                    $arguments[$key] = $enumClass::from($value['value']);
+                } elseif (isset($value['name'])) {
+                    // Unit enum - get by name
+                    $arguments[$key] = constant($enumClass . '::' . $value['name']);
+                }
+            }
+        }
+
         $additionalData = $data;
 
         // Remove standard fields from additionalData
@@ -203,7 +218,29 @@ final readonly class DiscoveredAttribute
         }
 
         if (! empty($this->arguments)) {
-            $data['arguments'] = $this->arguments;
+            // Serialize enum instances in arguments for cache compatibility
+            $serializedArguments = [];
+            foreach ($this->arguments as $key => $value) {
+                if ($value instanceof \BackedEnum) {
+                    // Backed enum (has scalar value)
+                    $serializedArguments[$key] = [
+                        '__enum' => true,
+                        'class' => get_class($value),
+                        'value' => $value->value,
+                    ];
+                } elseif ($value instanceof \UnitEnum) {
+                    // Unit enum (no scalar value, only name)
+                    $serializedArguments[$key] = [
+                        '__enum' => true,
+                        'class' => get_class($value),
+                        'name' => $value->name,
+                    ];
+                } else {
+                    // Regular value
+                    $serializedArguments[$key] = $value;
+                }
+            }
+            $data['arguments'] = $serializedArguments;
         }
 
         if ($this->filePath !== null) {
diff --git a/src/Framework/Discovery/ValueObjects/ReflectionContext.php b/src/Framework/Discovery/ValueObjects/ReflectionContext.php
index be2ba0f3..6c39a927 100644
--- a/src/Framework/Discovery/ValueObjects/ReflectionContext.php
+++ b/src/Framework/Discovery/ValueObjects/ReflectionContext.php
@@ -6,7 +6,7 @@ namespace App\Framework\Discovery\ValueObjects;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Filesystem\ValueObjects\FilePath;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 /**
  * Context information for reflection-based discovery
diff --git a/src/Framework/Discovery/Visitors/AttributeVisitor.php b/src/Framework/Discovery/Visitors/AttributeVisitor.php
index d4e5170d..358a036d 100644
--- a/src/Framework/Discovery/Visitors/AttributeVisitor.php
+++ b/src/Framework/Discovery/Visitors/AttributeVisitor.php
@@ -13,9 +13,9 @@ use App\Framework\Discovery\ValueObjects\AttributeTarget;
 use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
 use App\Framework\Discovery\ValueObjects\FileContext;
 use App\Framework\Filesystem\File;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 use Throwable;
 
 /**
diff --git a/src/Framework/Display/Components/ComponentFactory.php b/src/Framework/Display/Components/ComponentFactory.php
new file mode 100644
index 00000000..6cdf2626
--- /dev/null
+++ b/src/Framework/Display/Components/ComponentFactory.php
@@ -0,0 +1,387 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components;
+
+use App\Framework\Display\Components\Console\Badge as ConsoleBadge;
+use App\Framework\Display\Components\Console\Card as ConsoleCard;
+use App\Framework\Display\Components\Console\CodeBlock as ConsoleCodeBlock;
+use App\Framework\Display\Components\Console\Divider as ConsoleDivider;
+use App\Framework\Display\Components\Console\ListItem as ConsoleListItem;
+use App\Framework\Display\Components\Console\Stats as ConsoleStats;
+use App\Framework\Display\Components\Console\Table as ConsoleTable;
+use App\Framework\Display\Components\Console\TextBox as ConsoleTextBox;
+use App\Framework\Display\Components\Console\TreeHelper as ConsoleTreeHelper;
+use App\Framework\Display\Components\Html\HtmlBadge;
+use App\Framework\Display\Components\Html\HtmlCard;
+use App\Framework\Display\Components\Html\HtmlCodeBlock;
+use App\Framework\Display\Components\Html\HtmlDivider;
+use App\Framework\Display\Components\Html\HtmlListItem;
+use App\Framework\Display\Components\Html\HtmlStats;
+use App\Framework\Display\Components\Html\HtmlTable;
+use App\Framework\Display\Components\Html\HtmlTextBox;
+use App\Framework\Display\Components\Html\HtmlTreeHelper;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Factory for creating display components based on output format
+ */
+final readonly class ComponentFactory
+{
+    /**
+     * Create a TextBox component for the given output format
+     */
+    public static function createTextBox(
+        OutputFormat $format,
+        DisplayOptions $options,
+        string $content,
+        ?string $title = null
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleTextBox($options, $content, $title),
+            OutputFormat::HTML => self::createHtmlTextBox($options, $content, $title),
+        };
+    }
+
+    /**
+     * Create a TreeHelper component for the given output format
+     */
+    public static function createTreeHelper(
+        OutputFormat $format,
+        DisplayOptions $options,
+        string $title = ''
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleTreeHelper($options, $title),
+            OutputFormat::HTML => self::createHtmlTreeHelper($options, $title),
+        };
+    }
+
+    /**
+     * Create a Table component for the given output format
+     */
+    public static function createTable(
+        OutputFormat $format,
+        DisplayOptions $options
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleTable($options),
+            OutputFormat::HTML => self::createHtmlTable($options),
+        };
+    }
+
+    private static function createConsoleTextBox(
+        DisplayOptions $options,
+        string $content,
+        ?string $title
+    ): ConsoleTextBox {
+        $theme = self::getConsoleTheme($options);
+        $borderStyle = \App\Framework\Console\ConsoleStyle::create(color: $theme->separatorColor);
+        $contentStyle = \App\Framework\Console\ConsoleStyle::create(color: $theme->valueColor);
+
+        return new ConsoleTextBox(
+            content: $content,
+            borderStyle: $borderStyle,
+            contentStyle: $contentStyle,
+            title: $title
+        );
+    }
+
+    private static function createConsoleTreeHelper(
+        DisplayOptions $options,
+        string $title
+    ): ConsoleTreeHelper {
+        $theme = self::getConsoleTheme($options);
+        $tree = new ConsoleTreeHelper($title);
+        $tree->setNodeStyle(\App\Framework\Console\ConsoleStyle::create(color: $theme->keyColor));
+        $tree->setLeafStyle(\App\Framework\Console\ConsoleStyle::create(color: $theme->valueColor));
+        $tree->setLineStyle(\App\Framework\Console\ConsoleStyle::create(color: $theme->separatorColor));
+
+        return $tree;
+    }
+
+    private static function createConsoleTable(
+        DisplayOptions $options
+    ): ConsoleTable {
+        $theme = self::getConsoleTheme($options);
+        $headerStyle = \App\Framework\Console\ConsoleStyle::create(color: $theme->classNameColor);
+        $rowStyle = \App\Framework\Console\ConsoleStyle::create(color: $theme->valueColor);
+        $borderStyle = \App\Framework\Console\ConsoleStyle::create(color: $theme->separatorColor);
+
+        return new ConsoleTable(
+            headerStyle: $headerStyle,
+            rowStyle: $rowStyle,
+            borderStyle: $borderStyle
+        );
+    }
+
+    private static function createHtmlTextBox(
+        DisplayOptions $options,
+        string $content,
+        ?string $title
+    ): HtmlTextBox {
+        $theme = self::getHtmlTheme($options);
+
+        return new HtmlTextBox(
+            theme: $theme,
+            options: $options,
+            content: $content,
+            title: $title
+        );
+    }
+
+    private static function createHtmlTreeHelper(
+        DisplayOptions $options,
+        string $title
+    ): HtmlTreeHelper {
+        $theme = self::getHtmlTheme($options);
+        $tree = new HtmlTreeHelper(
+            theme: $theme,
+            options: $options,
+            title: $title
+        );
+
+        return $tree;
+    }
+
+    private static function createHtmlTable(
+        DisplayOptions $options
+    ): HtmlTable {
+        $theme = self::getHtmlTheme($options);
+
+        return new HtmlTable(
+            theme: $theme,
+            options: $options
+        );
+    }
+
+    /**
+     * Create a List component for the given output format
+     */
+    public static function createList(
+        OutputFormat $format,
+        DisplayOptions $options,
+        array $items,
+        bool $ordered = false
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleList($options, $items, $ordered),
+            OutputFormat::HTML => self::createHtmlList($options, $items, $ordered),
+        };
+    }
+
+    /**
+     * Create a Badge component for the given output format
+     */
+    public static function createBadge(
+        OutputFormat $format,
+        DisplayOptions $options,
+        string $text,
+        string $style = 'info'
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleBadge($options, $text, $style),
+            OutputFormat::HTML => self::createHtmlBadge($options, $text, $style),
+        };
+    }
+
+    /**
+     * Create a Divider component for the given output format
+     */
+    public static function createDivider(
+        OutputFormat $format,
+        DisplayOptions $options,
+        ?string $label = null
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleDivider($options, $label),
+            OutputFormat::HTML => self::createHtmlDivider($options, $label),
+        };
+    }
+
+    /**
+     * Create a Card component for the given output format
+     */
+    public static function createCard(
+        OutputFormat $format,
+        DisplayOptions $options,
+        ?string $title = null,
+        string $body = '',
+        ?string $footer = null
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleCard($options, $title, $body, $footer),
+            OutputFormat::HTML => self::createHtmlCard($options, $title, $body, $footer),
+        };
+    }
+
+    /**
+     * Create a CodeBlock component for the given output format
+     */
+    public static function createCodeBlock(
+        OutputFormat $format,
+        DisplayOptions $options,
+        string $code,
+        ?string $language = null,
+        bool $lineNumbers = false,
+        array $highlightLines = []
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleCodeBlock($options, $code, $language, $lineNumbers, $highlightLines),
+            OutputFormat::HTML => self::createHtmlCodeBlock($options, $code, $language, $lineNumbers, $highlightLines),
+        };
+    }
+
+    /**
+     * Create a Stats component for the given output format
+     */
+    public static function createStats(
+        OutputFormat $format,
+        DisplayOptions $options,
+        string|int|float $value,
+        ?string $label = null
+    ): DisplayComponentInterface {
+        return match ($format) {
+            OutputFormat::CONSOLE => self::createConsoleStats($options, $value, $label),
+            OutputFormat::HTML => self::createHtmlStats($options, $value, $label),
+        };
+    }
+
+    private static function createConsoleList(
+        DisplayOptions $options,
+        array $items,
+        bool $ordered
+    ): ConsoleListItem {
+        $theme = self::getConsoleTheme($options);
+        return ConsoleListItem::fromOptions($items, $options, $theme, $ordered);
+    }
+
+    private static function createHtmlList(
+        DisplayOptions $options,
+        array $items,
+        bool $ordered
+    ): HtmlListItem {
+        $theme = self::getHtmlTheme($options);
+        return HtmlListItem::fromOptions($items, $options, $theme, $ordered);
+    }
+
+    private static function createConsoleBadge(
+        DisplayOptions $options,
+        string $text,
+        string $style
+    ): ConsoleBadge {
+        $theme = self::getConsoleTheme($options);
+        $badgeStyle = \App\Framework\Display\Components\Console\BadgeStyle::from($style);
+        return ConsoleBadge::fromOptions($text, $options, $theme, $badgeStyle);
+    }
+
+    private static function createHtmlBadge(
+        DisplayOptions $options,
+        string $text,
+        string $style
+    ): HtmlBadge {
+        $theme = self::getHtmlTheme($options);
+        $badgeStyle = \App\Framework\Display\Components\Html\BadgeStyle::from($style);
+        return HtmlBadge::fromOptions($text, $options, $theme, $badgeStyle);
+    }
+
+    private static function createConsoleDivider(
+        DisplayOptions $options,
+        ?string $label
+    ): ConsoleDivider {
+        $theme = self::getConsoleTheme($options);
+        return ConsoleDivider::fromOptions($options, $theme, $label);
+    }
+
+    private static function createHtmlDivider(
+        DisplayOptions $options,
+        ?string $label
+    ): HtmlDivider {
+        $theme = self::getHtmlTheme($options);
+        return HtmlDivider::fromOptions($options, $theme, $label);
+    }
+
+    private static function createConsoleCard(
+        DisplayOptions $options,
+        ?string $title,
+        string $body,
+        ?string $footer
+    ): ConsoleCard {
+        $theme = self::getConsoleTheme($options);
+        return ConsoleCard::fromOptions($title, $body, $footer, $options, $theme);
+    }
+
+    private static function createHtmlCard(
+        DisplayOptions $options,
+        ?string $title,
+        string $body,
+        ?string $footer
+    ): HtmlCard {
+        $theme = self::getHtmlTheme($options);
+        return HtmlCard::fromOptions($title, $body, $footer, $options, $theme);
+    }
+
+    private static function createConsoleCodeBlock(
+        DisplayOptions $options,
+        string $code,
+        ?string $language,
+        bool $lineNumbers,
+        array $highlightLines
+    ): ConsoleCodeBlock {
+        $theme = self::getConsoleTheme($options);
+        return ConsoleCodeBlock::fromOptions($code, $options, $theme, $language, $lineNumbers, $highlightLines);
+    }
+
+    private static function createHtmlCodeBlock(
+        DisplayOptions $options,
+        string $code,
+        ?string $language,
+        bool $lineNumbers,
+        array $highlightLines
+    ): HtmlCodeBlock {
+        $theme = self::getHtmlTheme($options);
+        return HtmlCodeBlock::fromOptions($code, $options, $theme, $language, $lineNumbers, $highlightLines);
+    }
+
+    private static function createConsoleStats(
+        DisplayOptions $options,
+        string|int|float $value,
+        ?string $label
+    ): ConsoleStats {
+        $theme = self::getConsoleTheme($options);
+        return ConsoleStats::fromOptions($value, $label, $options, $theme);
+    }
+
+    private static function createHtmlStats(
+        DisplayOptions $options,
+        string|int|float $value,
+        ?string $label
+    ): HtmlStats {
+        $theme = self::getHtmlTheme($options);
+        return HtmlStats::fromOptions($value, $label, $options, $theme);
+    }
+
+    private static function getConsoleTheme(DisplayOptions $options): ConsoleTheme
+    {
+        if ($options->customTheme instanceof ConsoleTheme) {
+            return $options->customTheme;
+        }
+
+        return DefaultThemes::getConsoleTheme($options->theme);
+    }
+
+    private static function getHtmlTheme(DisplayOptions $options): HtmlTheme
+    {
+        if ($options->customTheme instanceof HtmlTheme) {
+            return $options->customTheme;
+        }
+
+        return DefaultThemes::getHtmlTheme($options->theme);
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/Badge.php b/src/Framework/Display/Components/Console/Badge.php
new file mode 100644
index 00000000..5a909bcf
--- /dev/null
+++ b/src/Framework/Display/Components/Console/Badge.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Badge/Label component for displaying small tags or labels in console
+ */
+final readonly class Badge implements DisplayComponentInterface
+{
+    public function __construct(
+        private string $text,
+        private BadgeStyle $style = BadgeStyle::INFO,
+        private ?ConsoleStyle $customStyle = null,
+    ) {
+    }
+
+    public static function fromOptions(string $text, DisplayOptions $options, ConsoleTheme $theme, BadgeStyle $style = BadgeStyle::INFO): self
+    {
+        $colors = match ($style) {
+            BadgeStyle::INFO => $theme->infoColor,
+            BadgeStyle::SUCCESS => ConsoleColor::GREEN,
+            BadgeStyle::WARNING => $theme->warningColor,
+            BadgeStyle::ERROR => $theme->errorColor,
+            BadgeStyle::DEFAULT => $theme->typeColor,
+        };
+
+        $customStyle = ConsoleStyle::create(color: $colors, format: ConsoleFormat::BOLD);
+
+        return new self(
+            text: $text,
+            style: $style,
+            customStyle: $customStyle
+        );
+    }
+
+    public function render(): string
+    {
+        $style = $this->customStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+        return '[' . $style->apply($this->text) . ']';
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
+/**
+ * Badge style enum
+ */
+enum BadgeStyle: string
+{
+    case INFO = 'info';
+    case SUCCESS = 'success';
+    case WARNING = 'warning';
+    case ERROR = 'error';
+    case DEFAULT = 'default';
+}
+
diff --git a/src/Framework/Display/Components/Console/Card.php b/src/Framework/Display/Components/Console/Card.php
new file mode 100644
index 00000000..a75c4e2d
--- /dev/null
+++ b/src/Framework/Display/Components/Console/Card.php
@@ -0,0 +1,145 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Card component for displaying information in card-like containers in console
+ */
+final readonly class Card implements DisplayComponentInterface
+{
+    public function __construct(
+        private ?string $title = null,
+        private string $body = '',
+        private ?string $footer = null,
+        private int $width = 80,
+        private ?ConsoleStyle $borderStyle = null,
+        private ?ConsoleStyle $titleStyle = null,
+        private ?ConsoleStyle $bodyStyle = null,
+        private ?ConsoleStyle $footerStyle = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        ?string $title,
+        string $body,
+        ?string $footer,
+        DisplayOptions $options,
+        ConsoleTheme $theme
+    ): self {
+        $borderStyle = ConsoleStyle::create(color: $theme->separatorColor);
+        $titleStyle = ConsoleStyle::create(color: $theme->classNameColor, format: ConsoleFormat::BOLD);
+        $bodyStyle = ConsoleStyle::create(color: $theme->valueColor);
+        $footerStyle = ConsoleStyle::create(color: $theme->metadataColor);
+
+        $width = $options->maxLineLength > 0 ? $options->maxLineLength : 80;
+
+        return new self(
+            title: $title,
+            body: $body,
+            footer: $footer,
+            width: $width,
+            borderStyle: $borderStyle,
+            titleStyle: $titleStyle,
+            bodyStyle: $bodyStyle,
+            footerStyle: $footerStyle
+        );
+    }
+
+    public function render(): string
+    {
+        $borderStyle = $this->borderStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+        $titleStyle = $this->titleStyle ?? ConsoleStyle::create(color: ConsoleColor::WHITE, format: ConsoleFormat::BOLD);
+        $bodyStyle = $this->bodyStyle ?? ConsoleStyle::create(color: ConsoleColor::WHITE);
+        $footerStyle = $this->footerStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+
+        $output = '';
+        $contentWidth = $this->width - 4; // Padding links/rechts
+
+        // Top border
+        $output .= $borderStyle->apply('┌' . str_repeat('─', $this->width - 2) . '┐') . "\n";
+
+        // Title
+        if ($this->title !== null) {
+            $title = mb_substr($this->title, 0, $contentWidth);
+            $titlePadding = str_repeat(' ', max(0, $contentWidth - mb_strlen($title)));
+            $output .= $borderStyle->apply('│') . ' ' . $titleStyle->apply($title . $titlePadding) . ' ' . $borderStyle->apply('│') . "\n";
+            $output .= $borderStyle->apply('├' . str_repeat('─', $this->width - 2) . '┤') . "\n";
+        }
+
+        // Body
+        if ($this->body !== '') {
+            $lines = explode("\n", $this->body);
+            foreach ($lines as $line) {
+                $wrappedLines = $this->wrapLine($line, $contentWidth);
+                foreach ($wrappedLines as $wrappedLine) {
+                    $linePadding = str_repeat(' ', max(0, $contentWidth - mb_strlen($wrappedLine)));
+                    $output .= $borderStyle->apply('│') . ' ' . $bodyStyle->apply($wrappedLine . $linePadding) . ' ' . $borderStyle->apply('│') . "\n";
+                }
+            }
+        }
+
+        // Footer
+        if ($this->footer !== null) {
+            if ($this->body !== '') {
+                $output .= $borderStyle->apply('├' . str_repeat('─', $this->width - 2) . '┤') . "\n";
+            }
+            $footer = mb_substr($this->footer, 0, $contentWidth);
+            $footerPadding = str_repeat(' ', max(0, $contentWidth - mb_strlen($footer)));
+            $output .= $borderStyle->apply('│') . ' ' . $footerStyle->apply($footer . $footerPadding) . ' ' . $borderStyle->apply('│') . "\n";
+        }
+
+        // Bottom border
+        $output .= $borderStyle->apply('└' . str_repeat('─', $this->width - 2) . '┘') . "\n";
+
+        return $output;
+    }
+
+    private function wrapLine(string $line, int $width): array
+    {
+        if (mb_strlen($line) <= $width) {
+            return [$line];
+        }
+
+        $lines = [];
+        $words = explode(' ', $line);
+        $currentLine = '';
+
+        foreach ($words as $word) {
+            $testLine = empty($currentLine) ? $word : $currentLine . ' ' . $word;
+
+            if (mb_strlen($testLine) <= $width) {
+                $currentLine = $testLine;
+            } else {
+                if (!empty($currentLine)) {
+                    $lines[] = $currentLine;
+                    $currentLine = $word;
+                } else {
+                    $lines[] = mb_substr($word, 0, $width);
+                    $currentLine = mb_substr($word, $width);
+                }
+            }
+        }
+
+        if (!empty($currentLine)) {
+            $lines[] = $currentLine;
+        }
+
+        return $lines ?: [''];
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/CodeBlock.php b/src/Framework/Display/Components/Console/CodeBlock.php
new file mode 100644
index 00000000..60948c7e
--- /dev/null
+++ b/src/Framework/Display/Components/Console/CodeBlock.php
@@ -0,0 +1,161 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\SyntaxHighlighter\SyntaxHighlighter;
+
+/**
+ * CodeBlock component for displaying code snippets with syntax highlighting in console
+ */
+final readonly class CodeBlock implements DisplayComponentInterface
+{
+    public function __construct(
+        private string $code,
+        private ?string $language = null,
+        private bool $lineNumbers = false,
+        private array $highlightLines = [],
+        private ?SyntaxHighlighter $highlighter = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        string $code,
+        DisplayOptions $options,
+        ConsoleTheme $theme,
+        ?string $language = null,
+        bool $lineNumbers = false,
+        array $highlightLines = []
+    ): self {
+        $highlighter = new SyntaxHighlighter();
+
+        return new self(
+            code: $code,
+            language: $language ?? self::detectLanguage($code),
+            lineNumbers: $lineNumbers,
+            highlightLines: $highlightLines,
+            highlighter: $highlighter
+        );
+    }
+
+    private static function detectLanguage(string $code): ?string
+    {
+        // Simple detection based on code patterns
+        $trimmed = trim($code);
+
+        // JSON
+        if (($trimmed[0] === '{' || $trimmed[0] === '[') && json_decode($code) !== null) {
+            return 'json';
+        }
+
+        // XML
+        if (preg_match('/^<\?xml\s/i', $trimmed) || preg_match('/^<[a-z]+/i', $trimmed)) {
+            return 'xml';
+        }
+
+        // YAML (basic detection)
+        if (preg_match('/^[a-z_][a-z0-9_]*:\s/mi', $trimmed)) {
+            return 'yaml';
+        }
+
+        // PHP (default for SyntaxHighlighter)
+        return 'php';
+    }
+
+    public function render(): string
+    {
+        $language = $this->language ?? 'php';
+
+        // Use SyntaxHighlighter for PHP
+        if ($language === 'php') {
+            $options = [
+                'lineNumbers' => $this->lineNumbers,
+                'highlightLines' => $this->highlightLines,
+                'colorize' => true,
+            ];
+
+            return $this->highlighter?->highlight($this->code, 'console', $options) ?? $this->code;
+        }
+
+        // For other languages, use simple highlighting
+        return $this->highlightSimple($this->code, $language);
+    }
+
+    private function highlightSimple(string $code, string $language): string
+    {
+        // Simple regex-based highlighting for non-PHP languages
+        $lines = explode("\n", $code);
+        $output = '';
+
+        foreach ($lines as $lineNum => $line) {
+            $lineNumDisplay = $lineNum + 1;
+            $isHighlighted = in_array($lineNumDisplay, $this->highlightLines, true);
+
+            if ($this->lineNumbers) {
+                $output .= sprintf("\033[90m%4d |\033[0m ", $lineNumDisplay);
+            }
+
+            if ($isHighlighted) {
+                $output .= "\033[43m"; // Yellow background
+            }
+
+            $highlightedLine = match ($language) {
+                'json' => $this->highlightJson($line),
+                'xml' => $this->highlightXml($line),
+                'yaml' => $this->highlightYaml($line),
+                default => $line,
+            };
+
+            $output .= $highlightedLine;
+
+            if ($isHighlighted) {
+                $output .= "\033[0m"; // Reset
+            }
+
+            $output .= "\n";
+        }
+
+        return $output;
+    }
+
+    private function highlightJson(string $line): string
+    {
+        // Simple JSON highlighting
+        $line = preg_replace('/("(?:[^"\\\\]|\\\\.)*")\s*:/', "\033[33m$1\033[0m:", $line); // Keys
+        $line = preg_replace('/:\s*("(?:[^"\\\\]|\\\\.)*")/', ": \033[32m$1\033[0m", $line); // String values
+        $line = preg_replace('/:\s*(\d+)/', ": \033[34m$1\033[0m", $line); // Numbers
+        $line = preg_replace('/:\s*(true|false|null)/', ": \033[35m$1\033[0m", $line); // Booleans/null
+
+        return $line;
+    }
+
+    private function highlightXml(string $line): string
+    {
+        // Simple XML highlighting
+        $line = preg_replace('/<(\/?)([a-z][a-z0-9]*)/i', "<\033[33m$1$2\033[0m", $line); // Tags
+        $line = preg_replace('/([a-z]+)="([^"]*)"/i', "\033[36m$1\033[0m=\"\033[32m$2\033[0m\"", $line); // Attributes
+
+        return $line;
+    }
+
+    private function highlightYaml(string $line): string
+    {
+        // Simple YAML highlighting
+        $line = preg_replace('/^([a-z_][a-z0-9_]*):\s*/mi', "\033[33m$1\033[0m: ", $line); // Keys
+        $line = preg_replace('/:\s*("(?:[^"\\\\]|\\\\.)*")/', ": \033[32m$1\033[0m", $line); // String values
+        $line = preg_replace('/:\s*(\d+)/', ": \033[34m$1\033[0m", $line); // Numbers
+
+        return $line;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/Divider.php b/src/Framework/Display/Components/Console/Divider.php
new file mode 100644
index 00000000..6b31ecf3
--- /dev/null
+++ b/src/Framework/Display/Components/Console/Divider.php
@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Divider/Separator component for visual separation in console
+ */
+final readonly class Divider implements DisplayComponentInterface
+{
+    public function __construct(
+        private ?string $label = null,
+        private int $width = 80,
+        private string $character = '─',
+        private ?ConsoleStyle $style = null,
+    ) {
+    }
+
+    public static function fromOptions(DisplayOptions $options, ConsoleTheme $theme, ?string $label = null): self
+    {
+        $style = ConsoleStyle::create(color: $theme->separatorColor);
+        $width = $options->maxLineLength > 0 ? $options->maxLineLength : 80;
+
+        return new self(
+            label: $label,
+            width: $width,
+            character: '─',
+            style: $style
+        );
+    }
+
+    public function render(): string
+    {
+        $style = $this->style ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+
+        if ($this->label !== null) {
+            $labelLength = mb_strlen($this->label);
+            $availableSpace = $this->width - $labelLength - 4; // Abzug für ' ' und ' '
+            $leftWidth = max(0, (int)floor($availableSpace / 2));
+            $rightWidth = max(0, $availableSpace - $leftWidth);
+
+            return $style->apply(str_repeat($this->character, $leftWidth) . ' ' . $this->label . ' ' . str_repeat($this->character, $rightWidth)) . "\n";
+        }
+
+        return $style->apply(str_repeat($this->character, $this->width)) . "\n";
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/ListItem.php b/src/Framework/Display/Components/Console/ListItem.php
new file mode 100644
index 00000000..ff89c0d2
--- /dev/null
+++ b/src/Framework/Display/Components/Console/ListItem.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * List component for displaying ordered/unordered lists in console
+ */
+final readonly class ListItem implements DisplayComponentInterface
+{
+    /**
+     * @param array<string|int, mixed> $items List items
+     * @param bool $ordered Whether to use ordered (numbered) list
+     * @param string $bullet Character to use for unordered lists
+     * @param ConsoleStyle|null $itemStyle Style for list items
+     * @param ConsoleStyle|null $markerStyle Style for list markers (numbers/bullets)
+     */
+    public function __construct(
+        private array $items,
+        private bool $ordered = false,
+        private string $bullet = '•',
+        private ?ConsoleStyle $itemStyle = null,
+        private ?ConsoleStyle $markerStyle = null,
+    ) {
+    }
+
+    public static function fromOptions(array $items, DisplayOptions $options, ConsoleTheme $theme, bool $ordered = false): self
+    {
+        $itemStyle = ConsoleStyle::create(color: $theme->valueColor);
+        $markerStyle = ConsoleStyle::create(color: $theme->keyColor);
+
+        return new self(
+            items: $items,
+            ordered: $ordered,
+            bullet: '•',
+            itemStyle: $itemStyle,
+            markerStyle: $markerStyle
+        );
+    }
+
+    public function render(): string
+    {
+        if (empty($this->items)) {
+            return '';
+        }
+
+        $output = '';
+        $itemStyle = $this->itemStyle ?? ConsoleStyle::create(color: ConsoleColor::WHITE);
+        $markerStyle = $this->markerStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+
+        foreach ($this->items as $index => $item) {
+            $marker = $this->ordered
+                ? (string)($index + 1) . '.'
+                : $this->bullet;
+
+            $itemText = is_scalar($item) ? (string)$item : get_debug_type($item);
+            $output .= $markerStyle->apply($marker . ' ') . $itemStyle->apply($itemText) . "\n";
+        }
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/Stats.php b/src/Framework/Display/Components/Console/Stats.php
new file mode 100644
index 00000000..72621b8c
--- /dev/null
+++ b/src/Framework/Display/Components/Console/Stats.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Stats/Metric component for displaying numerical statistics in console
+ */
+final readonly class Stats implements DisplayComponentInterface
+{
+    public function __construct(
+        private string|int|float $value,
+        private ?string $label = null,
+        private ?ConsoleStyle $valueStyle = null,
+        private ?ConsoleStyle $labelStyle = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        string|int|float $value,
+        ?string $label,
+        DisplayOptions $options,
+        ConsoleTheme $theme
+    ): self {
+        $valueStyle = ConsoleStyle::create(color: $theme->numberColor, format: ConsoleFormat::BOLD);
+        $labelStyle = ConsoleStyle::create(color: $theme->metadataColor);
+
+        return new self(
+            value: $value,
+            label: $label,
+            valueStyle: $valueStyle,
+            labelStyle: $labelStyle
+        );
+    }
+
+    public function render(): string
+    {
+        $valueStyle = $this->valueStyle ?? ConsoleStyle::create(color: ConsoleColor::BRIGHT_BLUE, format: ConsoleFormat::BOLD);
+        $labelStyle = $this->labelStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+
+        $valueFormatted = is_float($this->value) ? number_format($this->value, 2) : (string)$this->value;
+        $output = $valueStyle->apply($valueFormatted);
+
+        if ($this->label !== null) {
+            $output .= ' ' . $labelStyle->apply($this->label);
+        }
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/Table.php b/src/Framework/Display/Components/Console/Table.php
new file mode 100644
index 00000000..a45b4e9b
--- /dev/null
+++ b/src/Framework/Display/Components/Console/Table.php
@@ -0,0 +1,240 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Rendert eine Tabelle in der Konsole.
+ */
+final class Table implements DisplayComponentInterface
+{
+    private array $headers = [];
+
+    private array $rows = [];
+
+    private array $columnWidths = [];
+
+    private int $padding = 1;
+
+    public function __construct(
+        private ?ConsoleStyle $headerStyle = null,
+        private ?ConsoleStyle $rowStyle = null,
+        private ?ConsoleStyle $borderStyle = null,
+        private readonly bool $showBorders = true
+    ) {
+        $this->headerStyle ??= ConsoleStyle::create(color: ConsoleColor::BRIGHT_WHITE, format: ConsoleFormat::BOLD);
+        $this->rowStyle ??= ConsoleStyle::create();
+        $this->borderStyle ??= ConsoleStyle::create(color: ConsoleColor::GRAY);
+    }
+
+    /**
+     * Setzt die Spaltenüberschriften der Tabelle.
+     */
+    public function setHeaders(array $headers): self
+    {
+        $this->headers = $headers;
+        $this->calculateColumnWidths();
+
+        return $this;
+    }
+
+    /**
+     * Fügt eine Zeile zur Tabelle hinzu.
+     */
+    public function addRow(array $row): self
+    {
+        $this->rows[] = $row;
+        $this->calculateColumnWidths();
+
+        return $this;
+    }
+
+    /**
+     * Setzt alle Zeilen der Tabelle.
+     */
+    public function setRows(array $rows): self
+    {
+        $this->rows = $rows;
+        $this->calculateColumnWidths();
+
+        return $this;
+    }
+
+    /**
+     * Setzt den Innenabstand der Zellen.
+     */
+    public function setPadding(int $padding): self
+    {
+        $this->padding = max(0, $padding);
+
+        return $this;
+    }
+
+    /**
+     * Rendert die Tabelle und gibt den Text zurück.
+     */
+    public function render(): string
+    {
+        if (empty($this->headers) && empty($this->rows)) {
+            return '';
+        }
+
+        $output = '';
+
+        if ($this->showBorders) {
+            $output .= $this->renderBorder('top') . "\n";
+        }
+
+        // Header
+        if (! empty($this->headers)) {
+            $output .= $this->renderRow($this->headers, $this->headerStyle) . "\n";
+
+            if ($this->showBorders) {
+                $output .= $this->renderBorder('middle') . "\n";
+            }
+        }
+
+        // Zeilen
+        foreach ($this->rows as $index => $row) {
+            $output .= $this->renderRow($row, $this->rowStyle) . "\n";
+        }
+
+        if ($this->showBorders) {
+            $output .= $this->renderBorder('bottom') . "\n";
+        }
+
+        return $output;
+    }
+
+    /**
+     * Rendert eine Zeile der Tabelle.
+     */
+    private function renderRow(array $cells, ConsoleStyle $style): string
+    {
+        $output = '';
+
+        if ($this->showBorders) {
+            $output .= $this->borderStyle->apply('│');
+        }
+
+        foreach ($cells as $index => $cell) {
+            $width = $this->columnWidths[$index] ?? 10;
+            $cellText = (string)$cell;
+
+            // Linksbündige Ausrichtung mit exakter Breite
+            $paddedCell = str_pad($cellText, $width, ' ', STR_PAD_RIGHT);
+
+            // Padding hinzufügen
+            $padding = str_repeat(' ', $this->padding);
+            $finalCell = $padding . $paddedCell . $padding;
+
+            $output .= $style->apply($finalCell);
+
+            if ($this->showBorders) {
+                $output .= $this->borderStyle->apply('│');
+            }
+        }
+
+        return $output;
+    }
+
+    /**
+     * Rendert eine Trennlinie der Tabelle.
+     */
+    private function renderBorder(string $type): string
+    {
+        $left = match($type) {
+            'top' => '┌',
+            'middle' => '├',
+            'row' => '├',
+            'bottom' => '└',
+            default => '│'
+        };
+
+        $right = match($type) {
+            'top' => '┐',
+            'middle' => '┤',
+            'row' => '┤',
+            'bottom' => '┘',
+            default => '│'
+        };
+
+        $horizontal = '─';
+
+        $junction = match($type) {
+            'top' => '┬',
+            'middle' => '┼',
+            'row' => '┼',
+            'bottom' => '┴',
+            default => '│'
+        };
+
+        $border = $left;
+
+        foreach ($this->columnWidths as $index => $width) {
+            $cellWidth = $width + ($this->padding * 2);
+            $border .= str_repeat($horizontal, $cellWidth);
+
+            if ($index < count($this->columnWidths) - 1) {
+                $border .= $junction;
+            }
+        }
+
+        $border .= $right;
+
+        return $this->borderStyle->apply($border);
+    }
+
+    /**
+     * Berechnet die Breite jeder Spalte basierend auf dem Inhalt.
+     */
+    private function calculateColumnWidths(): void
+    {
+        $this->columnWidths = [];
+
+        // Header-Breiten
+        foreach ($this->headers as $index => $header) {
+            $this->columnWidths[$index] = mb_strlen((string)$header);
+        }
+
+        // Zeilen-Breiten
+        foreach ($this->rows as $row) {
+            foreach ($row as $index => $cell) {
+                $length = mb_strlen((string)$cell);
+                $this->columnWidths[$index] = max($this->columnWidths[$index] ?? 0, $length);
+            }
+        }
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+
+    /**
+     * Build table from Display ArrayStructure
+     */
+    public function fromArrayStructure(ArrayStructure $structure): self
+    {
+        $headers = $structure->isAssociative ? ['Key', 'Value'] : ['Index', 'Value'];
+        $this->setHeaders($headers);
+
+        $rows = [];
+        foreach ($structure->items as $key => $value) {
+            $valueStr = is_scalar($value) ? (string) $value : get_debug_type($value);
+            $rows[] = [(string) $key, $valueStr];
+        }
+        $this->setRows($rows);
+
+        return $this;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/TextBox.php b/src/Framework/Display/Components/Console/TextBox.php
new file mode 100644
index 00000000..632aafba
--- /dev/null
+++ b/src/Framework/Display/Components/Console/TextBox.php
@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Rendert eine Textbox in der Konsole.
+ */
+final readonly class TextBox implements DisplayComponentInterface
+{
+    public function __construct(
+        private string        $content,
+        private int           $width = 80,
+        private int           $padding = 1,
+        private ?ConsoleStyle $borderStyle = null,
+        private ?ConsoleStyle $contentStyle = null,
+        private ?string       $title = null
+    ) {
+    }
+
+    public function render(): string
+    {
+        $borderStyle = $this->borderStyle ?? ConsoleStyle::create(color: ConsoleColor::GRAY);
+        $contentStyle = $this->contentStyle ?? ConsoleStyle::create();
+
+        $contentWidth = $this->width - ($this->padding * 2) - 2;
+        $lines = $this->wrapText($this->content, $contentWidth);
+        $output = '';
+
+        // Obere Linie
+        if ($this->title) {
+            $titleLength = mb_strlen($this->title);
+            $availableSpace = $this->width - $titleLength - 6; // Abzug für '[ ]' und Ränder
+            $leftPadding = max(0, (int)floor($availableSpace / 2));
+            $rightPadding = max(0, $availableSpace - $leftPadding);
+
+            $output .= $borderStyle->apply('┌' . str_repeat('─', $leftPadding) . '[ ' . $this->title . ' ]' . str_repeat('─', $rightPadding) . '┐') . "\n";
+        } else {
+            $output .= $borderStyle->apply('┌' . str_repeat('─', $this->width - 2) . '┐') . "\n";
+        }
+
+        // Padding oben
+        for ($i = 0; $i < $this->padding; $i++) {
+            $output .= $borderStyle->apply('│') . str_repeat(' ', $this->width - 2) . $borderStyle->apply('│') . "\n";
+        }
+
+        // Inhalt
+        foreach ($lines as $line) {
+            $lineLength = mb_strlen($line);
+            $spaces = $contentWidth - $lineLength;
+            $paddedLine = $line . str_repeat(' ', $spaces);
+
+            $output .= $borderStyle->apply('│') .
+                      str_repeat(' ', $this->padding) .
+                      $contentStyle->apply($paddedLine) .
+                      str_repeat(' ', $this->padding) .
+                      $borderStyle->apply('│') . "\n";
+        }
+
+        // Padding unten
+        for ($i = 0; $i < $this->padding; $i++) {
+            $output .= $borderStyle->apply('│') . str_repeat(' ', $this->width - 2) . $borderStyle->apply('│') . "\n";
+        }
+
+        // Untere Linie
+        $output .= $borderStyle->apply('└' . str_repeat('─', $this->width - 2) . '┘') . "\n";
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+
+    private function wrapText(string $text, int $width): array
+    {
+        $lines = explode("\n", $text);
+        $wrapped = [];
+
+        foreach ($lines as $line) {
+            if (mb_strlen($line) <= $width) {
+                $wrapped[] = $line;
+            } else {
+                $wrapped = array_merge($wrapped, $this->splitTextIntoLines($line, $width));
+            }
+        }
+
+        // Leere Zeile hinzufügen, falls keine Inhalte vorhanden
+        if (empty($wrapped)) {
+            $wrapped[] = '';
+        }
+
+        return $wrapped;
+    }
+
+    private function splitTextIntoLines(string $text, int $width): array
+    {
+        $lines = [];
+        $words = explode(' ', $text);
+        $currentLine = '';
+
+        foreach ($words as $word) {
+            $testLine = empty($currentLine) ? $word : $currentLine . ' ' . $word;
+
+            if (mb_strlen($testLine) <= $width) {
+                $currentLine = $testLine;
+            } else {
+                if (! empty($currentLine)) {
+                    $lines[] = $currentLine;
+                    $currentLine = $word;
+                } else {
+                    // Wort ist länger als die Zeile - hart umbrechen
+                    $lines[] = mb_substr($word, 0, $width);
+                    $currentLine = mb_substr($word, $width);
+                }
+            }
+        }
+
+        if (! empty($currentLine)) {
+            $lines[] = $currentLine;
+        }
+
+        return $lines ?: [''];
+    }
+}
+
diff --git a/src/Framework/Display/Components/Console/TreeHelper.php b/src/Framework/Display/Components/Console/TreeHelper.php
new file mode 100644
index 00000000..fd73d14b
--- /dev/null
+++ b/src/Framework/Display/Components/Console/TreeHelper.php
@@ -0,0 +1,283 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Console;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\ObjectStructure;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * TreeHelper zum Anzeigen hierarchischer Baumstrukturen in der Konsole.
+ * Ähnlich dem Symfony TreeHelper, aber angepasst an unser Styling-System.
+ */
+final class TreeHelper implements DisplayComponentInterface
+{
+    private string $prefix = '';
+
+    private bool $isLastElement = true;
+
+    private ?ConsoleStyle $nodeStyle = null;
+
+    private ?ConsoleStyle $leafStyle = null;
+
+    private ?ConsoleStyle $lineStyle = null;
+
+    /**
+     * @var array<array{title: string, node: ?self, isLeaf: bool}>
+     */
+    private array $nodes = [];
+
+    public function __construct(
+        private string                 $title = '',
+        #private readonly ConsoleOutput $output = new ConsoleOutput(),
+    ) {
+        $this->nodeStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_YELLOW, format: ConsoleFormat::BOLD);
+        $this->leafStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
+        $this->lineStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+    }
+
+    /**
+     * Setzt den Stil für Knotentitel (Verzeichnisse/Kategorien).
+     */
+    public function setNodeStyle(?ConsoleStyle $style): self
+    {
+        $this->nodeStyle = $style;
+
+        return $this;
+    }
+
+    /**
+     * Setzt den Stil für Blätter/Endpunkte.
+     */
+    public function setLeafStyle(?ConsoleStyle $style): self
+    {
+        $this->leafStyle = $style;
+
+        return $this;
+    }
+
+    /**
+     * Setzt den Stil für Baumlinien.
+     */
+    public function setLineStyle(?ConsoleStyle $style): self
+    {
+        $this->lineStyle = $style;
+
+        return $this;
+    }
+
+    /**
+     * Setzt den Haupttitel des Baums.
+     */
+    public function setTitle(string $title): self
+    {
+        $this->title = $title;
+
+        return $this;
+    }
+
+    /**
+     * Fügt einen Unterknoten (z.B. Unterverzeichnis) hinzu.
+     */
+    public function addNode(string $title): self
+    {
+        $node = new self($title);
+        $node->nodeStyle = $this->nodeStyle;
+        $node->leafStyle = $this->leafStyle;
+        $node->lineStyle = $this->lineStyle;
+
+        $this->nodes[] = [
+            'title' => $title,
+            'node' => $node,
+            'isLeaf' => false,
+        ];
+
+        return $node;
+    }
+
+    /**
+     * Fügt einen Endpunkt (z.B. Datei) hinzu.
+     */
+    public function addLeaf(string $title): self
+    {
+        $this->nodes[] = [
+            'title' => $title,
+            'node' => null,
+            'isLeaf' => true,
+        ];
+
+        return $this;
+    }
+
+    /**
+     * Zeigt die vollständige Baumstruktur an.
+     */
+    public function display(ConsoleOutput $output): void
+    {
+        if (! empty($this->title)) {
+            $output->writeLine($this->title, $this->nodeStyle);
+        }
+
+        $this->displayTree($output);
+    }
+
+    /**
+     * Rendert die Baumstruktur und gibt den Text zurück.
+     */
+    public function render(): string
+    {
+        $output = '';
+
+        if (! empty($this->title)) {
+            $output .= $this->nodeStyle->apply($this->title) . "\n";
+        }
+
+        $output .= $this->renderTree();
+
+        return $output;
+    }
+
+    /**
+     * Setzt den Präfix für die aktuelle Ebene.
+     * (Interne Methode für rekursives Rendern)
+     */
+    private function setPrefix(string $prefix, bool $isLastElement): self
+    {
+        $this->prefix = $prefix;
+        $this->isLastElement = $isLastElement;
+
+        return $this;
+    }
+
+    /**
+     * Zeigt die Baumstruktur mit dem aktuellen Präfix an.
+     * (Interne Methode für rekursives Rendern)
+     */
+    private function displayTree(ConsoleOutput $output): void
+    {
+        $count = count($this->nodes);
+
+        foreach ($this->nodes as $index => $item) {
+            $isLast = ($index === $count - 1);
+            $nodePrefix = $this->prefix . ($this->isLastElement ? '    ' : '│   ');
+
+            // Baumlinien und Verbindungen
+            $connector = $isLast ? '└── ' : '├── ';
+            $linePrefix = $this->prefix . $connector;
+
+            // Titel anzeigen
+            $style = $item['isLeaf'] ? $this->leafStyle : $this->nodeStyle;
+            $title = $linePrefix . $item['title'];
+
+            $output->writeLine(
+                $this->lineStyle->apply($linePrefix) .
+                $style->apply($item['title'])
+            );
+
+            // Unterelemente rekursiv anzeigen
+            if (! $item['isLeaf'] && $item['node'] !== null) {
+                $item['node']
+                    ->setPrefix($nodePrefix, $isLast)
+                    ->displayTree($output);
+            }
+        }
+    }
+
+    /**
+     * Rendert die Baumstruktur mit dem aktuellen Präfix und gibt den Text zurück.
+     * (Interne Methode für rekursives Rendern)
+     */
+    private function renderTree(): string
+    {
+        $output = '';
+        $count = count($this->nodes);
+
+        foreach ($this->nodes as $index => $item) {
+            $isLast = ($index === $count - 1);
+            $nodePrefix = $this->prefix . ($this->isLastElement ? '    ' : '│   ');
+
+            // Baumlinien und Verbindungen
+            $connector = $isLast ? '└── ' : '├── ';
+            $linePrefix = $this->prefix . $connector;
+
+            // Titel formatieren
+            $style = $item['isLeaf'] ? $this->leafStyle : $this->nodeStyle;
+            $title = $item['title'];
+
+            $output .= $this->lineStyle->apply($linePrefix) .
+                      $style->apply($title) . "\n";
+
+            // Unterelemente rekursiv rendern
+            if (! $item['isLeaf'] && $item['node'] !== null) {
+                $childOutput = $item['node']
+                    ->setPrefix($nodePrefix, $isLast)
+                    ->renderTree();
+
+                $output .= $childOutput;
+            }
+        }
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::CONSOLE;
+    }
+
+    /**
+     * Build tree from Display ArrayStructure
+     */
+    public function fromArrayStructure(ArrayStructure $structure, string $separator = ': '): self
+    {
+        foreach ($structure->items as $key => $value) {
+            if (isset($structure->nestedArrays[$key])) {
+                $nested = $structure->nestedArrays[$key];
+                if ($nested->isCircularReference) {
+                    $this->addLeaf((string) $key . $separator . '[circular reference]');
+                } else {
+                    $node = $this->addNode((string) $key);
+                    $node->fromArrayStructure($nested, $separator);
+                }
+            } else {
+                $valueStr = is_scalar($value) ? (string) $value : get_debug_type($value);
+                $this->addLeaf((string) $key . $separator . $valueStr);
+            }
+        }
+
+        return $this;
+    }
+
+    /**
+     * Build tree from Display ObjectStructure
+     */
+    public function fromObjectStructure(ObjectStructure $structure, string $separator = ': '): self
+    {
+        foreach ($structure->properties as $property) {
+            if (isset($structure->nestedObjects[$property->name])) {
+                $nested = $structure->nestedObjects[$property->name];
+                if ($nested->isCircularReference) {
+                    $this->addLeaf($property->name . $separator . '[circular reference]');
+                } else {
+                    $node = $this->addNode($property->name . $separator . $nested->className);
+                    $node->fromObjectStructure($nested, $separator);
+                }
+            } else {
+                $valueStr = $property->isValueObject && is_object($property->value)
+                    ? (string) $property->value
+                    : (is_scalar($property->value) ? (string) $property->value : get_debug_type($property->value));
+                $this->addLeaf($property->name . $separator . $valueStr);
+            }
+        }
+
+        return $this;
+    }
+}
+
diff --git a/src/Framework/Display/Components/DisplayComponentInterface.php b/src/Framework/Display/Components/DisplayComponentInterface.php
new file mode 100644
index 00000000..30819dc2
--- /dev/null
+++ b/src/Framework/Display/Components/DisplayComponentInterface.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components;
+
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Interface for Display components that can render data structures
+ */
+interface DisplayComponentInterface
+{
+    /**
+     * Render the component and return the output string
+     */
+    public function render(): string;
+
+    /**
+     * Get the output format this component produces
+     */
+    public function getOutputFormat(): OutputFormat;
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlBadge.php b/src/Framework/Display/Components/Html/HtmlBadge.php
new file mode 100644
index 00000000..0fb78bcd
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlBadge.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Badge/Label component for displaying small tags or labels in HTML
+ */
+final readonly class HtmlBadge implements DisplayComponentInterface
+{
+    public function __construct(
+        private string $text,
+        private BadgeStyle $style = BadgeStyle::INFO,
+        private ?string $customClass = null,
+    ) {
+    }
+
+    public static function fromOptions(string $text, DisplayOptions $options, HtmlTheme $theme, BadgeStyle $style = BadgeStyle::INFO): self
+    {
+        $baseClass = match ($style) {
+            BadgeStyle::INFO => $theme->infoClass,
+            BadgeStyle::SUCCESS => 'display-success',
+            BadgeStyle::WARNING => $theme->warningClass,
+            BadgeStyle::ERROR => $theme->errorClass,
+            BadgeStyle::DEFAULT => $theme->typeClass,
+        };
+
+        $customClass = $theme->themeClass . ' ' . $baseClass;
+
+        return new self(
+            text: $text,
+            style: $style,
+            customClass: $customClass
+        );
+    }
+
+    public function render(): string
+    {
+        $class = $this->customClass ?? 'display-badge';
+        $text = htmlspecialchars($this->text, ENT_QUOTES, 'UTF-8');
+        return '<span class="' . htmlspecialchars($class, ENT_QUOTES, 'UTF-8') . '">' . $text . '</span>';
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
+/**
+ * Badge style enum
+ */
+enum BadgeStyle: string
+{
+    case INFO = 'info';
+    case SUCCESS = 'success';
+    case WARNING = 'warning';
+    case ERROR = 'error';
+    case DEFAULT = 'default';
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlCard.php b/src/Framework/Display/Components/Html/HtmlCard.php
new file mode 100644
index 00000000..a0217440
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlCard.php
@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Card component for displaying information in card-like containers in HTML
+ */
+final readonly class HtmlCard implements DisplayComponentInterface
+{
+    public function __construct(
+        private ?string $title = null,
+        private string $body = '',
+        private ?string $footer = null,
+        private ?string $cardClass = null,
+        private ?string $headerClass = null,
+        private ?string $bodyClass = null,
+        private ?string $footerClass = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        ?string $title,
+        string $body,
+        ?string $footer,
+        DisplayOptions $options,
+        HtmlTheme $theme
+    ): self {
+        $cardClass = $theme->themeClass . ' display-card';
+        $headerClass = $theme->classNameClass;
+        $bodyClass = $theme->valueClass;
+        $footerClass = $theme->metadataClass;
+
+        return new self(
+            title: $title,
+            body: $body,
+            footer: $footer,
+            cardClass: $cardClass,
+            headerClass: $headerClass,
+            bodyClass: $bodyClass,
+            footerClass: $footerClass
+        );
+    }
+
+    public function render(): string
+    {
+        $cardClass = $this->cardClass ?? 'display-card';
+        $output = '<div class="' . htmlspecialchars($cardClass, ENT_QUOTES, 'UTF-8') . '">';
+
+        // Header
+        if ($this->title !== null) {
+            $headerClass = $this->headerClass ?? 'display-card-header';
+            $title = htmlspecialchars($this->title, ENT_QUOTES, 'UTF-8');
+            $output .= '<div class="' . htmlspecialchars($headerClass, ENT_QUOTES, 'UTF-8') . '">' . $title . '</div>';
+        }
+
+        // Body
+        if ($this->body !== '') {
+            $bodyClass = $this->bodyClass ?? 'display-card-body';
+            $body = nl2br(htmlspecialchars($this->body, ENT_QUOTES, 'UTF-8'));
+            $output .= '<div class="' . htmlspecialchars($bodyClass, ENT_QUOTES, 'UTF-8') . '">' . $body . '</div>';
+        }
+
+        // Footer
+        if ($this->footer !== null) {
+            $footerClass = $this->footerClass ?? 'display-card-footer';
+            $footer = htmlspecialchars($this->footer, ENT_QUOTES, 'UTF-8');
+            $output .= '<div class="' . htmlspecialchars($footerClass, ENT_QUOTES, 'UTF-8') . '">' . $footer . '</div>';
+        }
+
+        $output .= '</div>';
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlCodeBlock.php b/src/Framework/Display/Components/Html/HtmlCodeBlock.php
new file mode 100644
index 00000000..b50cbe52
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlCodeBlock.php
@@ -0,0 +1,163 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\SyntaxHighlighter\SyntaxHighlighter;
+
+/**
+ * CodeBlock component for displaying code snippets with syntax highlighting in HTML
+ */
+final readonly class HtmlCodeBlock implements DisplayComponentInterface
+{
+    public function __construct(
+        private string $code,
+        private ?string $language = null,
+        private bool $lineNumbers = false,
+        private array $highlightLines = [],
+        private ?string $codeClass = null,
+        private ?SyntaxHighlighter $highlighter = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        string $code,
+        DisplayOptions $options,
+        HtmlTheme $theme,
+        ?string $language = null,
+        bool $lineNumbers = false,
+        array $highlightLines = []
+    ): self {
+        $highlighter = new SyntaxHighlighter();
+        $codeClass = $theme->themeClass . ' display-code-block';
+
+        return new self(
+            code: $code,
+            language: $language ?? self::detectLanguage($code),
+            lineNumbers: $lineNumbers,
+            highlightLines: $highlightLines,
+            codeClass: $codeClass,
+            highlighter: $highlighter
+        );
+    }
+
+    private static function detectLanguage(string $code): ?string
+    {
+        // Simple detection based on code patterns
+        $trimmed = trim($code);
+
+        // JSON
+        if (($trimmed[0] === '{' || $trimmed[0] === '[') && json_decode($code) !== null) {
+            return 'json';
+        }
+
+        // XML
+        if (preg_match('/^<\?xml\s/i', $trimmed) || preg_match('/^<[a-z]+/i', $trimmed)) {
+            return 'xml';
+        }
+
+        // YAML (basic detection)
+        if (preg_match('/^[a-z_][a-z0-9_]*:\s/mi', $trimmed)) {
+            return 'yaml';
+        }
+
+        // PHP (default for SyntaxHighlighter)
+        return 'php';
+    }
+
+    public function render(): string
+    {
+        $language = $this->language ?? 'php';
+        $codeClass = $this->codeClass ?? 'display-code-block';
+        $languageAttr = $language !== null ? ' data-language="' . htmlspecialchars($language, ENT_QUOTES, 'UTF-8') . '"' : '';
+
+        // Use SyntaxHighlighter for PHP
+        if ($language === 'php') {
+            $options = [
+                'lineNumbers' => $this->lineNumbers,
+                'highlightLines' => $this->highlightLines,
+                'includeCss' => false, // CSS should be included separately
+            ];
+
+            $highlightedCode = $this->highlighter?->highlight($this->code, 'html', $options) ?? htmlspecialchars($this->code, ENT_QUOTES, 'UTF-8');
+
+            return '<pre class="' . htmlspecialchars($codeClass, ENT_QUOTES, 'UTF-8') . '"' . $languageAttr . '><code>' . $highlightedCode . '</code></pre>';
+        }
+
+        // For other languages, use simple highlighting
+        $highlightedCode = $this->highlightSimple($this->code, $language);
+
+        return '<pre class="' . htmlspecialchars($codeClass, ENT_QUOTES, 'UTF-8') . '"' . $languageAttr . '><code>' . $highlightedCode . '</code></pre>';
+    }
+
+    private function highlightSimple(string $code, string $language): string
+    {
+        $lines = explode("\n", htmlspecialchars($code, ENT_QUOTES, 'UTF-8'));
+        $output = '';
+
+        foreach ($lines as $lineNum => $line) {
+            $lineNumDisplay = $lineNum + 1;
+            $isHighlighted = in_array($lineNumDisplay, $this->highlightLines, true);
+            $highlightClass = $isHighlighted ? ' class="highlight-line"' : '';
+
+            if ($this->lineNumbers) {
+                $output .= '<span class="line-number">' . $lineNumDisplay . '</span>';
+            }
+
+            $highlightedLine = match ($language) {
+                'json' => $this->highlightJson($line),
+                'xml' => $this->highlightXml($line),
+                'yaml' => $this->highlightYaml($line),
+                default => $line,
+            };
+
+            $output .= '<span' . $highlightClass . '>' . $highlightedLine . '</span>';
+            if ($lineNum < count($lines) - 1) {
+                $output .= "\n";
+            }
+        }
+
+        return $output;
+    }
+
+    private function highlightJson(string $line): string
+    {
+        // Simple JSON highlighting with HTML
+        $line = preg_replace('/("(?:[^"\\\\]|\\\\.)*")\s*:/', '<span class="json-key">$1</span>:', $line);
+        $line = preg_replace('/:\s*("(?:[^"\\\\]|\\\\.)*")/', ': <span class="json-string">$1</span>', $line);
+        $line = preg_replace('/:\s*(\d+)/', ': <span class="json-number">$1</span>', $line);
+        $line = preg_replace('/:\s*(true|false|null)/', ': <span class="json-boolean">$1</span>', $line);
+
+        return $line;
+    }
+
+    private function highlightXml(string $line): string
+    {
+        // Simple XML highlighting with HTML
+        $line = preg_replace('/<(\/?)([a-z][a-z0-9]*)/i', '<span class="xml-tag">&lt;$1$2</span>', $line);
+        $line = preg_replace('/([a-z]+)="([^"]*)"/i', '<span class="xml-attr">$1</span>="<span class="xml-value">$2</span>"', $line);
+
+        return $line;
+    }
+
+    private function highlightYaml(string $line): string
+    {
+        // Simple YAML highlighting with HTML
+        $line = preg_replace('/^([a-z_][a-z0-9_]*):\s*/mi', '<span class="yaml-key">$1</span>: ', $line);
+        $line = preg_replace('/:\s*("(?:[^"\\\\]|\\\\.)*")/', ': <span class="yaml-string">$1</span>', $line);
+        $line = preg_replace('/:\s*(\d+)/', ': <span class="yaml-number">$1</span>', $line);
+
+        return $line;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlDivider.php b/src/Framework/Display/Components/Html/HtmlDivider.php
new file mode 100644
index 00000000..ef96dab7
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlDivider.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Divider/Separator component for visual separation in HTML
+ */
+final readonly class HtmlDivider implements DisplayComponentInterface
+{
+    public function __construct(
+        private ?string $label = null,
+        private ?string $class = null,
+    ) {
+    }
+
+    public static function fromOptions(DisplayOptions $options, HtmlTheme $theme, ?string $label = null): self
+    {
+        $class = $theme->themeClass . ' ' . $theme->separatorClass;
+
+        return new self(
+            label: $label,
+            class: $class
+        );
+    }
+
+    public function render(): string
+    {
+        $class = $this->class ?? 'display-divider';
+
+        if ($this->label !== null) {
+            $label = htmlspecialchars($this->label, ENT_QUOTES, 'UTF-8');
+            return '<hr class="' . htmlspecialchars($class, ENT_QUOTES, 'UTF-8') . '" data-label="' . $label . '">';
+        }
+
+        return '<hr class="' . htmlspecialchars($class, ENT_QUOTES, 'UTF-8') . '">';
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlListItem.php b/src/Framework/Display/Components/Html/HtmlListItem.php
new file mode 100644
index 00000000..fac5181d
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlListItem.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * List component for displaying ordered/unordered lists in HTML
+ */
+final readonly class HtmlListItem implements DisplayComponentInterface
+{
+    /**
+     * @param array<string|int, mixed> $items List items
+     * @param bool $ordered Whether to use ordered (numbered) list
+     * @param string|null $listClass CSS class for the list element
+     * @param string|null $itemClass CSS class for list items
+     */
+    public function __construct(
+        private array $items,
+        private bool $ordered = false,
+        private ?string $listClass = null,
+        private ?string $itemClass = null,
+    ) {
+    }
+
+    public static function fromOptions(array $items, DisplayOptions $options, HtmlTheme $theme, bool $ordered = false): self
+    {
+        $listClass = $theme->themeClass . ' ' . ($options->theme ?? '');
+        $itemClass = $theme->valueClass;
+
+        return new self(
+            items: $items,
+            ordered: $ordered,
+            listClass: $listClass,
+            itemClass: $itemClass
+        );
+    }
+
+    public function render(): string
+    {
+        if (empty($this->items)) {
+            return '';
+        }
+
+        $tag = $this->ordered ? 'ol' : 'ul';
+        $listClassAttr = $this->listClass !== null ? ' class="' . htmlspecialchars($this->listClass, ENT_QUOTES, 'UTF-8') . '"' : '';
+        $itemClassAttr = $this->itemClass !== null ? ' class="' . htmlspecialchars($this->itemClass, ENT_QUOTES, 'UTF-8') . '"' : '';
+
+        $output = '<' . $tag . $listClassAttr . '>';
+        foreach ($this->items as $item) {
+            $itemText = is_scalar($item) ? htmlspecialchars((string)$item, ENT_QUOTES, 'UTF-8') : htmlspecialchars(get_debug_type($item), ENT_QUOTES, 'UTF-8');
+            $output .= '<li' . $itemClassAttr . '>' . $itemText . '</li>';
+        }
+        $output .= '</' . $tag . '>';
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlStats.php b/src/Framework/Display/Components/Html/HtmlStats.php
new file mode 100644
index 00000000..27f62ad0
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlStats.php
@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Stats/Metric component for displaying numerical statistics in HTML
+ */
+final readonly class HtmlStats implements DisplayComponentInterface
+{
+    public function __construct(
+        private string|int|float $value,
+        private ?string $label = null,
+        private ?string $statsClass = null,
+        private ?string $valueClass = null,
+        private ?string $labelClass = null,
+    ) {
+    }
+
+    public static function fromOptions(
+        string|int|float $value,
+        ?string $label,
+        DisplayOptions $options,
+        HtmlTheme $theme
+    ): self {
+        $statsClass = $theme->themeClass . ' display-stats';
+        $valueClass = $theme->numberClass . ' display-stats-value';
+        $labelClass = $theme->metadataClass . ' display-stats-label';
+
+        return new self(
+            value: $value,
+            label: $label,
+            statsClass: $statsClass,
+            valueClass: $valueClass,
+            labelClass: $labelClass
+        );
+    }
+
+    public function render(): string
+    {
+        $statsClass = $this->statsClass ?? 'display-stats';
+        $valueClass = $this->valueClass ?? 'display-stats-value';
+        $labelClass = $this->labelClass ?? 'display-stats-label';
+
+        $valueFormatted = is_float($this->value) ? number_format($this->value, 2) : htmlspecialchars((string)$this->value, ENT_QUOTES, 'UTF-8');
+        $output = '<div class="' . htmlspecialchars($statsClass, ENT_QUOTES, 'UTF-8') . '">';
+        $output .= '<span class="' . htmlspecialchars($valueClass, ENT_QUOTES, 'UTF-8') . '">' . $valueFormatted . '</span>';
+
+        if ($this->label !== null) {
+            $label = htmlspecialchars($this->label, ENT_QUOTES, 'UTF-8');
+            $output .= '<span class="' . htmlspecialchars($labelClass, ENT_QUOTES, 'UTF-8') . '">' . $label . '</span>';
+        }
+
+        $output .= '</div>';
+
+        return $output;
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlTable.php b/src/Framework/Display/Components/Html/HtmlTable.php
new file mode 100644
index 00000000..2e065814
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlTable.php
@@ -0,0 +1,125 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * HTML equivalent of Console Table component
+ */
+final class HtmlTable implements DisplayComponentInterface
+{
+    private array $headers = [];
+
+    private array $rows = [];
+
+    public function __construct(
+        private HtmlTheme $theme,
+        private DisplayOptions $options,
+        private int $padding = 1,
+        private bool $showBorders = true
+    ) {
+    }
+
+    /**
+     * Set table headers
+     */
+    public function setHeaders(array $headers): self
+    {
+        $this->headers = $headers;
+
+        return $this;
+    }
+
+    /**
+     * Add a row to the table
+     */
+    public function addRow(array $row): self
+    {
+        $this->rows[] = $row;
+
+        return $this;
+    }
+
+    /**
+     * Set all rows at once
+     */
+    public function setRows(array $rows): self
+    {
+        $this->rows = $rows;
+
+        return $this;
+    }
+
+    /**
+     * Set padding
+     */
+    public function setPadding(int $padding): self
+    {
+        $this->padding = max(0, $padding);
+
+        return $this;
+    }
+
+    public function render(): string
+    {
+        if (empty($this->headers) && empty($this->rows)) {
+            return '';
+        }
+
+        $output = [];
+        $borderClass = $this->showBorders ? ' display-table-bordered' : '';
+        $output[] = '<table class="display-table ' . $this->theme->themeClass . $borderClass . '">';
+
+        if (! empty($this->headers)) {
+            $output[] = '<thead>';
+            $output[] = '<tr>';
+            foreach ($this->headers as $header) {
+                $output[] = '<th class="' . $this->theme->classNameClass . '" style="padding: ' . $this->padding . 'em;">' . htmlspecialchars((string) $header) . '</th>';
+            }
+            $output[] = '</tr>';
+            $output[] = '</thead>';
+        }
+
+        $output[] = '<tbody>';
+        foreach ($this->rows as $row) {
+            $output[] = '<tr>';
+            foreach ($row as $cell) {
+                $output[] = '<td class="' . $this->theme->valueClass . '" style="padding: ' . $this->padding . 'em;">' . htmlspecialchars((string) $cell) . '</td>';
+            }
+            $output[] = '</tr>';
+        }
+        $output[] = '</tbody>';
+        $output[] = '</table>';
+
+        return implode("\n", $output);
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+
+    /**
+     * Build table from Display ArrayStructure
+     */
+    public function fromArrayStructure(ArrayStructure $structure): self
+    {
+        $headers = $structure->isAssociative ? ['Key', 'Value'] : ['Index', 'Value'];
+        $this->setHeaders($headers);
+
+        foreach ($structure->items as $key => $value) {
+            $valueStr = is_scalar($value) ? (string) $value : get_debug_type($value);
+            $this->addRow([(string) $key, $valueStr]);
+        }
+
+        return $this;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlTextBox.php b/src/Framework/Display/Components/Html/HtmlTextBox.php
new file mode 100644
index 00000000..61676a34
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlTextBox.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * HTML equivalent of Console TextBox component
+ */
+final readonly class HtmlTextBox implements DisplayComponentInterface
+{
+    public function __construct(
+        private HtmlTheme $theme,
+        private DisplayOptions $options,
+        private string $content,
+        private ?string $title = null,
+        private int $width = 80,
+        private int $padding = 1
+    ) {
+    }
+
+    public function render(): string
+    {
+        $output = [];
+        $output[] = '<div class="' . $this->theme->themeClass . ' display-textbox" style="max-width: ' . $this->width . 'ch; padding: ' . $this->padding . 'em;">';
+        
+        if ($this->title !== null) {
+            $output[] = '<div class="display-textbox-title ' . $this->theme->classNameClass . '">' . htmlspecialchars($this->title) . '</div>';
+        }
+        
+        $output[] = '<div class="display-textbox-content ' . $this->theme->valueClass . '">';
+        $output[] = nl2br(htmlspecialchars($this->content));
+        $output[] = '</div>';
+        $output[] = '</div>';
+
+        return implode("\n", $output);
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/Components/Html/HtmlTreeHelper.php b/src/Framework/Display/Components/Html/HtmlTreeHelper.php
new file mode 100644
index 00000000..72385e91
--- /dev/null
+++ b/src/Framework/Display/Components/Html/HtmlTreeHelper.php
@@ -0,0 +1,153 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Components\Html;
+
+use App\Framework\Display\Components\DisplayComponentInterface;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\ObjectStructure;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * HTML equivalent of Console TreeHelper component
+ */
+final class HtmlTreeHelper implements DisplayComponentInterface
+{
+    private string $title;
+
+    /** @var array<array{title: string, node: ?self, isLeaf: bool}> */
+    private array $nodes = [];
+
+    public function __construct(
+        private HtmlTheme $theme,
+        private DisplayOptions $options,
+        string $title = ''
+    ) {
+        $this->title = $title;
+    }
+
+    /**
+     * Add a child node (e.g., subdirectory)
+     */
+    public function addNode(string $title): self
+    {
+        $node = new self($this->theme, $this->options, $title);
+        $this->nodes[] = [
+            'title' => $title,
+            'node' => $node,
+            'isLeaf' => false,
+        ];
+
+        return $node;
+    }
+
+    /**
+     * Add a leaf node (e.g., file)
+     */
+    public function addLeaf(string $title): self
+    {
+        $this->nodes[] = [
+            'title' => $title,
+            'node' => null,
+            'isLeaf' => true,
+        ];
+
+        return $this;
+    }
+
+    public function render(): string
+    {
+        $output = [];
+        
+        if ($this->title !== '') {
+            $output[] = '<div class="' . $this->theme->classNameClass . '">' . htmlspecialchars($this->title) . '</div>';
+        }
+
+        $output[] = '<ul class="display-tree ' . $this->theme->themeClass . '">';
+        $output[] = $this->renderTreeInternal('');
+        $output[] = '</ul>';
+
+        return implode("\n", $output);
+    }
+
+    private function renderTreeInternal(string $prefix): string
+    {
+        $output = [];
+        $count = count($this->nodes);
+
+        foreach ($this->nodes as $index => $item) {
+            $isLast = ($index === $count - 1);
+            $itemClass = $item['isLeaf'] ? $this->theme->valueClass : $this->theme->keyClass;
+            
+            $output[] = '<li class="display-tree-item' . ($isLast ? ' display-tree-item-last' : '') . '">';
+            $output[] = '<span class="' . $itemClass . '">' . htmlspecialchars($item['title']) . '</span>';
+
+            if (! $item['isLeaf'] && $item['node'] !== null) {
+                $output[] = '<ul class="display-tree-nested">';
+                $output[] = $item['node']->renderTreeInternal($prefix . ($isLast ? '    ' : '│   '));
+                $output[] = '</ul>';
+            }
+
+            $output[] = '</li>';
+        }
+
+        return implode("\n", $output);
+    }
+
+    public function getOutputFormat(): OutputFormat
+    {
+        return OutputFormat::HTML;
+    }
+
+    /**
+     * Build tree from Display ArrayStructure
+     */
+    public function fromArrayStructure(ArrayStructure $structure, string $separator = ': '): self
+    {
+        foreach ($structure->items as $key => $value) {
+            if (isset($structure->nestedArrays[$key])) {
+                $nested = $structure->nestedArrays[$key];
+                if ($nested->isCircularReference) {
+                    $this->addLeaf(htmlspecialchars((string) $key . $separator . '[circular reference]'));
+                } else {
+                    $node = $this->addNode(htmlspecialchars((string) $key));
+                    $node->fromArrayStructure($nested, $separator);
+                }
+            } else {
+                $valueStr = is_scalar($value) ? (string) $value : get_debug_type($value);
+                $this->addLeaf(htmlspecialchars((string) $key . $separator . $valueStr));
+            }
+        }
+
+        return $this;
+    }
+
+    /**
+     * Build tree from Display ObjectStructure
+     */
+    public function fromObjectStructure(ObjectStructure $structure, string $separator = ': '): self
+    {
+        foreach ($structure->properties as $property) {
+            if (isset($structure->nestedObjects[$property->name])) {
+                $nested = $structure->nestedObjects[$property->name];
+                if ($nested->isCircularReference) {
+                    $this->addLeaf(htmlspecialchars($property->name . $separator . '[circular reference]'));
+                } else {
+                    $node = $this->addNode(htmlspecialchars($property->name . $separator . $nested->className));
+                    $node->fromObjectStructure($nested, $separator);
+                }
+            } else {
+                $valueStr = $property->isValueObject && is_object($property->value)
+                    ? (string) $property->value
+                    : (is_scalar($property->value) ? (string) $property->value : get_debug_type($property->value));
+                $this->addLeaf(htmlspecialchars($property->name . $separator . $valueStr));
+            }
+        }
+
+        return $this;
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/ArrayFormatter.php b/src/Framework/Display/Formatters/ArrayFormatter.php
new file mode 100644
index 00000000..8210d02c
--- /dev/null
+++ b/src/Framework/Display/Formatters/ArrayFormatter.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\Inspectors\ArrayInspector;
+use App\Framework\Display\Renderers\ConsoleRenderer;
+use App\Framework\Display\Renderers\HtmlRenderer;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * High-level formatter for arrays combining inspector and renderers
+ */
+final readonly class ArrayFormatter
+{
+    public function __construct(
+        private ArrayInspector $inspector = new ArrayInspector(),
+        private ConsoleRenderer $consoleRenderer = new ConsoleRenderer(),
+        private HtmlRenderer $htmlRenderer = new HtmlRenderer(),
+    ) {
+    }
+
+    public function format(array $data, DisplayOptions $options, OutputFormat $format): string
+    {
+        $structure = $this->inspector->inspect($data, $options);
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->consoleRenderer->renderArray($structure, $options),
+            OutputFormat::HTML => $this->htmlRenderer->renderArray($structure, $options),
+        };
+    }
+
+    public function formatForConsole(array $data, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($data, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(array $data, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($data, $options, OutputFormat::HTML);
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/AutoFormatter.php b/src/Framework/Display/Formatters/AutoFormatter.php
new file mode 100644
index 00000000..0ed0f666
--- /dev/null
+++ b/src/Framework/Display/Formatters/AutoFormatter.php
@@ -0,0 +1,253 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\Formatters\CsvFormatter;
+use App\Framework\Display\Formatters\JsonFormatter;
+use App\Framework\Display\Formatters\XmlFormatter;
+use App\Framework\Display\Formatters\YamlFormatter;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * Auto-detecting formatter that automatically selects the appropriate formatter
+ * based on the input data type.
+ *
+ * This is the main entry point for the Display module. It automatically detects
+ * the type of input data and routes it to the appropriate formatter:
+ * - Arrays → ArrayFormatter
+ * - Objects → ObjectFormatter
+ * - JSON strings → JsonFormatter
+ * - YAML strings → YamlFormatter
+ * - XML strings → XmlFormatter
+ * - CSV strings → CsvFormatter
+ * - Class names → ClassFormatter
+ * - Directory paths → FilesystemFormatter
+ * - Scalars → Scalar formatting
+ *
+ * @example
+ * $formatter = new AutoFormatter();
+ * echo $formatter->formatForConsole($data);
+ */
+final readonly class AutoFormatter
+{
+    public function __construct(
+        private ArrayFormatter $arrayFormatter = new ArrayFormatter(),
+        private ObjectFormatter $objectFormatter = new ObjectFormatter(),
+        private ClassFormatter $classFormatter = new ClassFormatter(),
+        private FilesystemFormatter $filesystemFormatter = new FilesystemFormatter(),
+        private JsonFormatter $jsonFormatter = new JsonFormatter(),
+        private YamlFormatter $yamlFormatter = new YamlFormatter(),
+        private XmlFormatter $xmlFormatter = new XmlFormatter(),
+        private CsvFormatter $csvFormatter = new CsvFormatter(),
+        private CodeFormatter $codeFormatter = new CodeFormatter(),
+    ) {
+    }
+
+    /**
+     * Format data with specified options and output format.
+     *
+     * @param mixed $value The data to format (array, object, string, etc.)
+     * @param DisplayOptions $options Display configuration options
+     * @param OutputFormat $format Output format (CONSOLE or HTML)
+     * @return string Formatted output string
+     */
+    public function format(mixed $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return match (true) {
+            is_array($value) => $this->formatArray($value, $options, $format),
+            is_object($value) => $this->formatObject($value, $options, $format),
+            is_string($value) && $this->isJsonString($value) => $this->formatJsonString($value, $options, $format),
+            is_string($value) && $this->isYamlString($value) => $this->formatYamlString($value, $options, $format),
+            is_string($value) && $this->isXmlString($value) => $this->formatXmlString($value, $options, $format),
+            is_string($value) && $this->isCsvString($value) => $this->formatCsvString($value, $options, $format),
+            is_string($value) && CodeFormatter::isPhpCode($value) => $this->formatCode($value, $options, $format),
+            is_string($value) && class_exists($value) => $this->formatClass($value, $options, $format),
+            is_string($value) && (is_dir($value) || ($value instanceof FilePath && is_dir($value->toString()))) => $this->formatDirectory($value, $options, $format),
+            $value instanceof FilePath => $this->formatDirectory($value, $options, $format),
+            default => $this->formatScalar($value, $options, $format),
+        };
+    }
+
+    /**
+     * Format data for console output with default options.
+     *
+     * @param mixed $value The data to format
+     * @param DisplayOptions|null $options Optional display options (defaults to DisplayOptions::default())
+     * @return string Formatted console output with ANSI colors
+     */
+    public function formatForConsole(mixed $value, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($value, $options, OutputFormat::CONSOLE);
+    }
+
+    /**
+     * Format data for HTML output with default options.
+     *
+     * @param mixed $value The data to format
+     * @param DisplayOptions|null $options Optional display options (defaults to DisplayOptions::default())
+     * @return string Formatted HTML output with semantic HTML/CSS classes
+     */
+    public function formatForHtml(mixed $value, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($value, $options, OutputFormat::HTML);
+    }
+
+    private function formatArray(array $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        // Check if array contains objects - could use ObjectFormatter for items
+        $hasObjects = false;
+        foreach ($value as $item) {
+            if (is_object($item)) {
+                $hasObjects = true;
+                break;
+            }
+        }
+
+        return $this->arrayFormatter->format($value, $options, $format);
+    }
+
+    private function formatObject(object $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->objectFormatter->format($value, $options, $format);
+    }
+
+    private function formatJsonString(string $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->jsonFormatter->format($value, $options, $format);
+    }
+
+    private function formatYamlString(string $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->yamlFormatter->format($value, $options, $format);
+    }
+
+    private function formatXmlString(string $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->xmlFormatter->format($value, $options, $format);
+    }
+
+    private function formatCsvString(string $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->csvFormatter->format($value, $options, $format);
+    }
+
+    private function formatCode(string $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->codeFormatter->format($value, $options, $format);
+    }
+
+    private function formatClass(string $className, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->classFormatter->format($className, $options, $format);
+    }
+
+    private function formatDirectory(string|FilePath $path, DisplayOptions $options, OutputFormat $format): string
+    {
+        return $this->filesystemFormatter->format($path, $options, $format);
+    }
+
+    private function formatScalar(mixed $value, DisplayOptions $options, OutputFormat $format): string
+    {
+        $formatted = match (true) {
+            is_string($value) => $format === OutputFormat::HTML
+                ? '<span class="display-string">' . htmlspecialchars($value) . '</span>'
+                : "\033[32m\"{$value}\"\033[0m",
+            is_int($value) => $format === OutputFormat::HTML
+                ? '<span class="display-number">' . $value . '</span>'
+                : "\033[94m{$value}\033[0m",
+            is_float($value) => $format === OutputFormat::HTML
+                ? '<span class="display-number">' . $value . '</span>'
+                : "\033[94m{$value}\033[0m",
+            is_bool($value) => $format === OutputFormat::HTML
+                ? '<span class="display-boolean">' . ($value ? 'true' : 'false') . '</span>'
+                : "\033[95m" . ($value ? 'true' : 'false') . "\033[0m",
+            is_null($value) => $format === OutputFormat::HTML
+                ? '<span class="display-null">null</span>'
+                : "\033[90mnull\033[0m",
+            default => $format === OutputFormat::HTML
+                ? '<span class="display-type">' . htmlspecialchars(get_debug_type($value)) . '</span>'
+                : get_debug_type($value),
+        };
+
+        return $formatted;
+    }
+
+    private function isJsonString(string $value): bool
+    {
+        if (empty($value)) {
+            return false;
+        }
+
+        $trimmed = trim($value);
+        if (! ($trimmed[0] === '{' || $trimmed[0] === '[')) {
+            return false;
+        }
+
+        return json_validate($value);
+    }
+
+    private function isYamlString(string $value): bool
+    {
+        if (empty($value)) {
+            return false;
+        }
+
+        $trimmed = trim($value);
+
+        // Basic YAML detection: starts with key: or has --- or ...
+        // More sophisticated detection would require a YAML parser
+        return preg_match('/^(\s*[a-zA-Z_][a-zA-Z0-9_]*\s*:|\s*---|\s*\.\.\.)/', $trimmed) === 1;
+    }
+
+    private function isXmlString(string $value): bool
+    {
+        if (empty($value)) {
+            return false;
+        }
+
+        $trimmed = trim($value);
+
+        // Basic XML detection: starts with < or <?xml
+        return str_starts_with($trimmed, '<') || str_starts_with($trimmed, '<?xml');
+    }
+
+    private function isCsvString(string $value): bool
+    {
+        if (empty($value)) {
+            return false;
+        }
+
+        $lines = explode("\n", $value);
+        if (count($lines) < 2) {
+            return false;
+        }
+
+        // Check if the first line contains common CSV separators
+        $firstLine = $lines[0];
+        $separators = [',', ';', "\t"];
+
+        foreach ($separators as $separator) {
+            $parts = explode($separator, $firstLine);
+            if (count($parts) >= 2) {
+                // Check if second line has same number of parts
+                if (isset($lines[1])) {
+                    $secondParts = explode($separator, $lines[1]);
+                    if (count($secondParts) >= 2 && abs(count($parts) - count($secondParts)) <= 1) {
+                        return true;
+                    }
+                }
+            }
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/ClassFormatter.php b/src/Framework/Display/Formatters/ClassFormatter.php
new file mode 100644
index 00000000..6eb6b3ba
--- /dev/null
+++ b/src/Framework/Display/Formatters/ClassFormatter.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\Inspectors\ClassInspector;
+use App\Framework\Display\Renderers\ConsoleRenderer;
+use App\Framework\Display\Renderers\HtmlRenderer;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * High-level formatter for classes combining inspector and renderers
+ */
+final readonly class ClassFormatter
+{
+    public function __construct(
+        private ClassInspector $inspector = new ClassInspector(),
+        private ConsoleRenderer $consoleRenderer = new ConsoleRenderer(),
+        private HtmlRenderer $htmlRenderer = new HtmlRenderer(),
+    ) {
+    }
+
+    public function format(string|object $class, DisplayOptions $options, OutputFormat $format): string
+    {
+        $structure = $this->inspector->inspect($class, $options);
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->consoleRenderer->renderClass($structure, $options),
+            OutputFormat::HTML => $this->htmlRenderer->renderClass($structure, $options),
+        };
+    }
+
+    public function formatForConsole(string|object $class, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($class, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string|object $class, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($class, $options, OutputFormat::HTML);
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/CodeFormatter.php b/src/Framework/Display/Formatters/CodeFormatter.php
new file mode 100644
index 00000000..bfc7e4e9
--- /dev/null
+++ b/src/Framework/Display/Formatters/CodeFormatter.php
@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\SyntaxHighlighter\SyntaxHighlighter;
+
+/**
+ * Formatter for PHP code strings with syntax highlighting and tooltips
+ */
+final readonly class CodeFormatter
+{
+    public function __construct(
+        private SyntaxHighlighter $highlighter = new SyntaxHighlighter()
+    ) {
+    }
+
+    /**
+     * Format PHP code with syntax highlighting
+     */
+    public function format(string $code, DisplayOptions $options, OutputFormat $format): string
+    {
+        if ($format === OutputFormat::CONSOLE) {
+            // For console, use console formatter
+            $formatter = $this->highlighter->getFormatter('console');
+            return $formatter->format(
+                $this->highlighter->tokenize($code),
+                ['includeCss' => false]
+            );
+        }
+
+        // For HTML, use HTML formatter with tooltips enabled
+        $formatter = $this->highlighter->getFormatter('html');
+        
+        $formatOptions = [
+            'includeCss' => true,
+            'lineNumbers' => $options->showLineNumbers ?? true,
+            'enableTooltips' => true, // Enable tooltips with metadata
+        ];
+
+        return $formatter->format(
+            $this->highlighter->tokenize($code),
+            $formatOptions
+        );
+    }
+
+    /**
+     * Check if a string looks like PHP code
+     */
+    public static function isPhpCode(string $value): bool
+    {
+        $trimmed = trim($value);
+        
+        // Check for PHP tags
+        if (str_starts_with($trimmed, '<?php') || str_starts_with($trimmed, '<?=')) {
+            return true;
+        }
+
+        // Check for common PHP keywords and patterns
+        $phpPatterns = [
+            '/\b(public|private|protected|static|function|class|interface|trait|enum)\b/',
+            '/\$[a-zA-Z_][a-zA-Z0-9_]*/',
+            '/->[a-zA-Z_][a-zA-Z0-9_]*/',
+            '/::[a-zA-Z_][a-zA-Z0-9_]*/',
+            '/\b(new|return|if|else|foreach|for|while|switch|case|break|continue)\b/',
+        ];
+
+        $matches = 0;
+        foreach ($phpPatterns as $pattern) {
+            if (preg_match($pattern, $trimmed)) {
+                $matches++;
+            }
+        }
+
+        // If we have at least 2 PHP patterns, it's likely PHP code
+        return $matches >= 2;
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/CsvFormatter.php b/src/Framework/Display/Formatters/CsvFormatter.php
new file mode 100644
index 00000000..dfcf2526
--- /dev/null
+++ b/src/Framework/Display/Formatters/CsvFormatter.php
@@ -0,0 +1,233 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Formatter for CSV strings with table formatting
+ */
+final readonly class CsvFormatter
+{
+    public function format(string $csv, DisplayOptions $options, OutputFormat $format): string
+    {
+        // Parse CSV
+        $data = $this->parseCsv($csv);
+        if ($data === null) {
+            // Invalid CSV - return as plain string with error indication
+            return $format === OutputFormat::HTML
+                ? '<span class="display-error">Invalid CSV format</span>'
+                : ConsoleStyle::create(color: ConsoleColor::BRIGHT_RED)->apply('Invalid CSV format');
+        }
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->formatConsole($data, $options),
+            OutputFormat::HTML => $this->formatHtml($data, $options),
+        };
+    }
+
+    public function formatForConsole(string $csv, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($csv, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string $csv, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($csv, $options, OutputFormat::HTML);
+    }
+
+    /**
+     * Parse CSV string into array of rows
+     *
+     * @return array<array<string>>|null
+     */
+    private function parseCsv(string $csv): ?array
+    {
+        if (empty(trim($csv))) {
+            return null;
+        }
+
+        $lines = explode("\n", $csv);
+        $rows = [];
+        $separator = $this->detectSeparator($lines[0] ?? '');
+
+        foreach ($lines as $line) {
+            $line = trim($line);
+            if ($line === '') {
+                continue;
+            }
+
+            $row = str_getcsv($line, $separator);
+            if (! empty($row)) {
+                $rows[] = $row;
+            }
+        }
+
+        return empty($rows) ? null : $rows;
+    }
+
+    /**
+     * Detect CSV separator
+     */
+    private function detectSeparator(string $firstLine): string
+    {
+        $separators = [',', ';', "\t"];
+        $separatorCounts = [];
+
+        foreach ($separators as $sep) {
+            $separatorCounts[$sep] = substr_count($firstLine, $sep);
+        }
+
+        // Return separator with highest count
+        $maxCount = max($separatorCounts);
+        if ($maxCount > 0) {
+            foreach ($separatorCounts as $sep => $count) {
+                if ($count === $maxCount) {
+                    return $sep;
+                }
+            }
+        }
+
+        // Default to comma
+        return ',';
+    }
+
+    private function formatConsole(array $data, DisplayOptions $options): string
+    {
+        if (empty($data)) {
+            return $this->style('(empty CSV)', ConsoleColor::GRAY);
+        }
+
+        // Calculate column widths
+        $columnWidths = $this->calculateColumnWidths($data);
+
+        $output = [];
+        $borderStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
+        $headerStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_CYAN, format: \App\Framework\Console\ConsoleFormat::BOLD);
+        $cellStyle = ConsoleStyle::create(color: ConsoleColor::GREEN);
+
+        // Top border
+        $topBorder = '┌' . implode('┬', array_map(fn ($w) => str_repeat('─', $w + 2), $columnWidths)) . '┐';
+        $output[] = $borderStyle->apply($topBorder);
+
+        // First row as header (if multiple rows)
+        $isHeader = count($data) > 1;
+        $rowIndex = 0;
+
+        foreach ($data as $row) {
+            $cells = [];
+            foreach ($row as $colIndex => $cell) {
+                $width = $columnWidths[$colIndex] ?? 10;
+                $padded = str_pad((string) $cell, $width, ' ', STR_PAD_RIGHT);
+                $cells[] = $padded;
+            }
+
+            $rowText = '│ ' . implode(' │ ', $cells) . ' │';
+            if ($isHeader && $rowIndex === 0) {
+                $output[] = $headerStyle->apply($rowText);
+            } else {
+                $output[] = $cellStyle->apply($rowText);
+            }
+
+            // Separator between header and body
+            if ($isHeader && $rowIndex === 0) {
+                $separator = '├' . implode('┼', array_map(fn ($w) => str_repeat('─', $w + 2), $columnWidths)) . '┤';
+                $output[] = $borderStyle->apply($separator);
+            }
+
+            $rowIndex++;
+        }
+
+        // Bottom border
+        $bottomBorder = '└' . implode('┴', array_map(fn ($w) => str_repeat('─', $w + 2), $columnWidths)) . '┘';
+        $output[] = $borderStyle->apply($bottomBorder);
+
+        return implode("\n", $output);
+    }
+
+    private function formatHtml(array $data, DisplayOptions $options): string
+    {
+        if (empty($data)) {
+            return '<div class="display-empty">(empty CSV)</div>';
+        }
+
+        $output = [];
+        $output[] = '<table class="display-csv-table">';
+
+        // First row as header (if multiple rows)
+        $isHeader = count($data) > 1;
+        $rowIndex = 0;
+
+        foreach ($data as $row) {
+            $tag = ($isHeader && $rowIndex === 0) ? 'thead' : ($rowIndex === ($isHeader ? 1 : 0) ? '<tbody>' : '');
+            if ($tag === '<tbody>') {
+                $output[] = '<tbody>';
+            } elseif ($tag === 'thead') {
+                $output[] = '<thead>';
+            }
+
+            $output[] = '<tr>';
+
+            foreach ($row as $cell) {
+                $tag = ($isHeader && $rowIndex === 0) ? 'th' : 'td';
+                $output[] = '<' . $tag . ' class="display-csv-cell">' . htmlspecialchars((string) $cell) . '</' . $tag . '>';
+            }
+
+            $output[] = '</tr>';
+
+            if ($isHeader && $rowIndex === 0) {
+                $output[] = '</thead>';
+            }
+
+            $rowIndex++;
+        }
+
+        if ($isHeader || count($data) > 0) {
+            $output[] = '</tbody>';
+        }
+
+        $output[] = '</table>';
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Calculate column widths for console table
+     *
+     * @param array<array<string>> $data
+     * @return array<int, int>
+     */
+    private function calculateColumnWidths(array $data): array
+    {
+        $widths = [];
+
+        foreach ($data as $row) {
+            foreach ($row as $colIndex => $cell) {
+                $cellLength = mb_strlen((string) $cell);
+                $widths[$colIndex] = max($widths[$colIndex] ?? 0, $cellLength);
+            }
+        }
+
+        // Limit max width for readability
+        foreach ($widths as $colIndex => $width) {
+            $widths[$colIndex] = min($width, 50);
+        }
+
+        return $widths;
+    }
+
+    private function style(string $text, ConsoleColor $color): string
+    {
+        return ConsoleStyle::create(color: $color)->apply($text);
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/FilesystemFormatter.php b/src/Framework/Display/Formatters/FilesystemFormatter.php
new file mode 100644
index 00000000..69000785
--- /dev/null
+++ b/src/Framework/Display/Formatters/FilesystemFormatter.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\Inspectors\FilesystemInspector;
+use App\Framework\Display\Renderers\ConsoleRenderer;
+use App\Framework\Display\Renderers\HtmlRenderer;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * High-level formatter for filesystem directories combining inspector and renderers
+ */
+final readonly class FilesystemFormatter
+{
+    public function __construct(
+        private FilesystemInspector $inspector = new FilesystemInspector(),
+        private ConsoleRenderer $consoleRenderer = new ConsoleRenderer(),
+        private HtmlRenderer $htmlRenderer = new HtmlRenderer(),
+    ) {
+    }
+
+    public function format(string|FilePath $path, DisplayOptions $options, OutputFormat $format): string
+    {
+        $structure = $this->inspector->inspect($path, $options);
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->consoleRenderer->renderDirectory($structure, $options),
+            OutputFormat::HTML => $this->htmlRenderer->renderDirectory($structure, $options),
+        };
+    }
+
+    public function formatForConsole(string|FilePath $path, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($path, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string|FilePath $path, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($path, $options, OutputFormat::HTML);
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/JsonFormatter.php b/src/Framework/Display/Formatters/JsonFormatter.php
new file mode 100644
index 00000000..757ba35f
--- /dev/null
+++ b/src/Framework/Display/Formatters/JsonFormatter.php
@@ -0,0 +1,204 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Formatter for JSON strings with syntax highlighting
+ */
+final readonly class JsonFormatter
+{
+    public function format(string $json, DisplayOptions $options, OutputFormat $format): string
+    {
+        // Validate and decode JSON
+        $decoded = json_decode($json, true);
+        if (json_last_error() !== JSON_ERROR_NONE) {
+            // Invalid JSON - return as plain string with error indication
+            return $format === OutputFormat::HTML
+                ? '<span class="display-error">Invalid JSON: ' . htmlspecialchars(json_last_error_msg()) . '</span>'
+                : ConsoleStyle::create(color: ConsoleColor::BRIGHT_RED)->apply('Invalid JSON: ' . json_last_error_msg());
+        }
+
+        // Pretty print JSON
+        $prettyJson = json_encode($decoded, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->formatConsole($prettyJson, $options),
+            OutputFormat::HTML => $this->formatHtml($prettyJson, $options),
+        };
+    }
+
+    public function formatForConsole(string $json, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($json, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string $json, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($json, $options, OutputFormat::HTML);
+    }
+
+    private function formatConsole(string $prettyJson, DisplayOptions $options): string
+    {
+        $lines = explode("\n", $prettyJson);
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->colorizeJsonLine($line);
+        }
+
+        return implode("\n", $formattedLines);
+    }
+
+    private function formatHtml(string $prettyJson, DisplayOptions $options): string
+    {
+        $lines = explode("\n", $prettyJson);
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->htmlColorizeJsonLine($line);
+        }
+
+        return '<pre class="display-json"><code>' . implode("\n", $formattedLines) . '</code></pre>';
+    }
+
+    private function colorizeJsonLine(string $line): string
+    {
+        // JSON key (before colon)
+        $line = preg_replace_callback(
+            '/"([^"]+)":\s*/',
+            function ($matches) {
+                $keyStyle = ConsoleStyle::create(color: ConsoleColor::YELLOW);
+                return $keyStyle->apply('"' . $matches[1] . '"') . ': ';
+            },
+            $line
+        );
+
+        // JSON string value
+        $line = preg_replace_callback(
+            '/:\s*"([^"]*)"/',
+            function ($matches) {
+                $stringStyle = ConsoleStyle::create(color: ConsoleColor::GREEN);
+                return ': ' . $stringStyle->apply('"' . $matches[1] . '"');
+            },
+            $line
+        );
+
+        // JSON number
+        $line = preg_replace_callback(
+            '/:\s*(-?\d+\.?\d*)/',
+            function ($matches) {
+                $numberStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_BLUE);
+                return ': ' . $numberStyle->apply($matches[1]);
+            },
+            $line
+        );
+
+        // JSON boolean
+        $line = preg_replace_callback(
+            '/:\s*(true|false)/',
+            function ($matches) {
+                $boolStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_MAGENTA);
+                return ': ' . $boolStyle->apply($matches[1]);
+            },
+            $line
+        );
+
+        // JSON null
+        $line = preg_replace_callback(
+            '/:\s*(null)/',
+            function ($matches) {
+                $nullStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+                return ': ' . $nullStyle->apply('null');
+            },
+            $line
+        );
+
+        // JSON brackets and braces
+        $line = str_replace(['{', '}'], [
+            ConsoleStyle::create(color: ConsoleColor::WHITE)->apply('{'),
+            ConsoleStyle::create(color: ConsoleColor::WHITE)->apply('}'),
+        ], $line);
+
+        $line = str_replace(['[', ']'], [
+            ConsoleStyle::create(color: ConsoleColor::WHITE)->apply('['),
+            ConsoleStyle::create(color: ConsoleColor::WHITE)->apply(']'),
+        ], $line);
+
+        return $line;
+    }
+
+    private function htmlColorizeJsonLine(string $line): string
+    {
+        $line = htmlspecialchars($line, ENT_QUOTES, 'UTF-8');
+
+        // JSON key (before colon)
+        $line = preg_replace_callback(
+            '/"([^"]+)":\s*/',
+            function ($matches) {
+                return '<span class="display-json-key">"' . htmlspecialchars($matches[1]) . '"</span>: ';
+            },
+            $line
+        );
+
+        // JSON string value
+        $line = preg_replace_callback(
+            '/:\s*"([^"]*)"/',
+            function ($matches) {
+                return ': <span class="display-json-string">"' . htmlspecialchars($matches[1]) . '"</span>';
+            },
+            $line
+        );
+
+        // JSON number
+        $line = preg_replace_callback(
+            '/:\s*(-?\d+\.?\d*)/',
+            function ($matches) {
+                return ': <span class="display-json-number">' . htmlspecialchars($matches[1]) . '</span>';
+            },
+            $line
+        );
+
+        // JSON boolean
+        $line = preg_replace_callback(
+            '/:\s*(true|false)/',
+            function ($matches) {
+                return ': <span class="display-json-boolean">' . htmlspecialchars($matches[1]) . '</span>';
+            },
+            $line
+        );
+
+        // JSON null
+        $line = preg_replace_callback(
+            '/:\s*(null)/',
+            function ($matches) {
+                return ': <span class="display-json-null">null</span>';
+            },
+            $line
+        );
+
+        // JSON brackets and braces
+        $line = str_replace(['{', '}'], [
+            '<span class="display-json-brace">{</span>',
+            '<span class="display-json-brace">}</span>',
+        ], $line);
+
+        $line = str_replace(['[', ']'], [
+            '<span class="display-json-bracket">[</span>',
+            '<span class="display-json-bracket">]</span>',
+        ], $line);
+
+        return $line;
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/ObjectFormatter.php b/src/Framework/Display/Formatters/ObjectFormatter.php
new file mode 100644
index 00000000..175a3c7d
--- /dev/null
+++ b/src/Framework/Display/Formatters/ObjectFormatter.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Display\Inspectors\ObjectInspector;
+use App\Framework\Display\Renderers\ConsoleRenderer;
+use App\Framework\Display\Renderers\HtmlRenderer;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * High-level formatter for objects combining inspector and renderers
+ */
+final readonly class ObjectFormatter
+{
+    public function __construct(
+        private ObjectInspector $inspector = new ObjectInspector(),
+        private ConsoleRenderer $consoleRenderer = new ConsoleRenderer(),
+        private HtmlRenderer $htmlRenderer = new HtmlRenderer(),
+    ) {
+    }
+
+    public static function create(): self
+    {
+        return new self(
+            inspector: new ObjectInspector(),
+            consoleRenderer: ConsoleRenderer::create(),
+            htmlRenderer: HtmlRenderer::create(),
+        );
+    }
+
+    public function format(object $data, DisplayOptions $options, OutputFormat $format): string
+    {
+        $structure = $this->inspector->inspect($data, $options);
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->consoleRenderer->renderObject($structure, $options),
+            OutputFormat::HTML => $this->htmlRenderer->renderObject($structure, $options),
+        };
+    }
+
+    public function formatForConsole(object $data, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($data, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(object $data, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($data, $options, OutputFormat::HTML);
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/XmlFormatter.php b/src/Framework/Display/Formatters/XmlFormatter.php
new file mode 100644
index 00000000..9a274c4c
--- /dev/null
+++ b/src/Framework/Display/Formatters/XmlFormatter.php
@@ -0,0 +1,205 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use DOMDocument;
+
+/**
+ * Formatter for XML strings with syntax highlighting
+ */
+final readonly class XmlFormatter
+{
+    public function format(string $xml, DisplayOptions $options, OutputFormat $format): string
+    {
+        // Validate and parse XML
+        $dom = new DOMDocument();
+        $dom->preserveWhiteSpace = false;
+        $dom->formatOutput = true;
+
+        $previousErrors = libxml_use_internal_errors(true);
+        $loaded = $dom->loadXML($xml);
+        $errors = libxml_get_errors();
+        libxml_use_internal_errors($previousErrors);
+
+        if (! $loaded || ! empty($errors)) {
+            // Invalid XML - return as plain string with error indication
+            $errorMsg = ! empty($errors) ? $errors[0]->message : 'Invalid XML';
+            return $format === OutputFormat::HTML
+                ? '<span class="display-error">Invalid XML: ' . htmlspecialchars($errorMsg) . '</span>'
+                : ConsoleStyle::create(color: ConsoleColor::BRIGHT_RED)->apply('Invalid XML: ' . $errorMsg);
+        }
+
+        // Pretty print XML
+        $prettyXml = $dom->saveXML();
+
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->formatConsole($prettyXml, $options),
+            OutputFormat::HTML => $this->formatHtml($prettyXml, $options),
+        };
+    }
+
+    public function formatForConsole(string $xml, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($xml, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string $xml, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($xml, $options, OutputFormat::HTML);
+    }
+
+    private function formatConsole(string $prettyXml, DisplayOptions $options): string
+    {
+        $lines = explode("\n", trim($prettyXml));
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->colorizeXmlLine($line);
+        }
+
+        return implode("\n", $formattedLines);
+    }
+
+    private function formatHtml(string $prettyXml, DisplayOptions $options): string
+    {
+        $lines = explode("\n", trim($prettyXml));
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->htmlColorizeXmlLine($line);
+        }
+
+        return '<pre class="display-xml"><code>' . implode("\n", $formattedLines) . '</code></pre>';
+    }
+
+    private function colorizeXmlLine(string $line): string
+    {
+        // XML opening/closing tags
+        $line = preg_replace_callback(
+            '/<(\/?)([a-zA-Z][a-zA-Z0-9_-]*)([^>]*)>/',
+            function ($matches) {
+                $slash = $matches[1];
+                $tagName = $matches[2];
+                $attributes = $matches[3];
+
+                $tagStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_CYAN);
+                $tagNameStyle = ConsoleStyle::create(color: ConsoleColor::CYAN);
+
+                // Colorize attributes
+                $attributes = preg_replace_callback(
+                    '/([a-zA-Z][a-zA-Z0-9_-]*)\s*=\s*"([^"]*)"/',
+                    function ($attrMatches) {
+                        $attrNameStyle = ConsoleStyle::create(color: ConsoleColor::YELLOW);
+                        $attrValueStyle = ConsoleStyle::create(color: ConsoleColor::GREEN);
+                        return $attrNameStyle->apply($attrMatches[1]) . '="' . $attrValueStyle->apply($attrMatches[2]) . '"';
+                    },
+                    $attributes
+                );
+
+                return '<' . $slash . $tagNameStyle->apply($tagName) . $tagStyle->apply($attributes) . '>';
+            },
+            $line
+        );
+
+        // XML comments
+        $line = preg_replace_callback(
+            '/<!--(.*?)-->/s',
+            function ($matches) {
+                $commentStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+                return $commentStyle->apply('<!--' . $matches[1] . '-->');
+            },
+            $line
+        );
+
+        // CDATA sections
+        $line = preg_replace_callback(
+            '/<!\[CDATA\[(.*?)\]\]>/s',
+            function ($matches) {
+                $cdataStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_MAGENTA);
+                return $cdataStyle->apply('<![CDATA[' . $matches[1] . ']]>');
+            },
+            $line
+        );
+
+        // Processing instructions
+        $line = preg_replace_callback(
+            '/<\?([^?]+)\?>/',
+            function ($matches) {
+                $piStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_YELLOW);
+                return $piStyle->apply('<?' . $matches[1] . '?>');
+            },
+            $line
+        );
+
+        return $line;
+    }
+
+    private function htmlColorizeXmlLine(string $line): string
+    {
+        $line = htmlspecialchars($line, ENT_QUOTES, 'UTF-8');
+
+        // XML opening/closing tags
+        $line = preg_replace_callback(
+            '/&lt;(\/?)([a-zA-Z][a-zA-Z0-9_-]*)([^&]*)&gt;/',
+            function ($matches) {
+                $slash = $matches[1];
+                $tagName = $matches[2];
+                $attributes = $matches[3];
+
+                // Colorize attributes
+                $attributes = preg_replace_callback(
+                    '/([a-zA-Z][a-zA-Z0-9_-]*)\s*=\s*"([^"]*)"/',
+                    function ($attrMatches) {
+                        return '<span class="display-xml-attr-name">' . htmlspecialchars($attrMatches[1]) . '</span>="' .
+                               '<span class="display-xml-attr-value">' . htmlspecialchars($attrMatches[2]) . '</span>"';
+                    },
+                    $attributes
+                );
+
+                return '&lt;' . $slash . '<span class="display-xml-tag">' . htmlspecialchars($tagName) . '</span>' .
+                       htmlspecialchars($attributes) . '&gt;';
+            },
+            $line
+        );
+
+        // XML comments
+        $line = preg_replace_callback(
+            '/&lt;!--(.*?)--&gt;/s',
+            function ($matches) {
+                return '&lt;!--<span class="display-xml-comment">' . htmlspecialchars($matches[1]) . '</span>--&gt;';
+            },
+            $line
+        );
+
+        // CDATA sections
+        $line = preg_replace_callback(
+            '/&lt;!\[CDATA\[(.*?)\]\]&gt;/s',
+            function ($matches) {
+                return '<span class="display-xml-cdata">&lt;![CDATA[' . htmlspecialchars($matches[1]) . ']]&gt;</span>';
+            },
+            $line
+        );
+
+        // Processing instructions
+        $line = preg_replace_callback(
+            '/&lt;\?([^?]+)\?&gt;/',
+            function ($matches) {
+                return '<span class="display-xml-pi">&lt;?' . htmlspecialchars($matches[1]) . '?&gt;</span>';
+            },
+            $line
+        );
+
+        return $line;
+    }
+}
+
diff --git a/src/Framework/Display/Formatters/YamlFormatter.php b/src/Framework/Display/Formatters/YamlFormatter.php
new file mode 100644
index 00000000..44127b6f
--- /dev/null
+++ b/src/Framework/Display/Formatters/YamlFormatter.php
@@ -0,0 +1,193 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Formatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+/**
+ * Formatter for YAML strings with syntax highlighting
+ * Note: This is a basic implementation. For full YAML parsing, consider using Symfony YAML component.
+ */
+final readonly class YamlFormatter
+{
+    public function format(string $yaml, DisplayOptions $options, OutputFormat $format): string
+    {
+        return match ($format) {
+            OutputFormat::CONSOLE => $this->formatConsole($yaml, $options),
+            OutputFormat::HTML => $this->formatHtml($yaml, $options),
+        };
+    }
+
+    public function formatForConsole(string $yaml, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($yaml, $options, OutputFormat::CONSOLE);
+    }
+
+    public function formatForHtml(string $yaml, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+
+        return $this->format($yaml, $options, OutputFormat::HTML);
+    }
+
+    private function formatConsole(string $yaml, DisplayOptions $options): string
+    {
+        $lines = explode("\n", $yaml);
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->colorizeYamlLine($line);
+        }
+
+        return implode("\n", $formattedLines);
+    }
+
+    private function formatHtml(string $yaml, DisplayOptions $options): string
+    {
+        $lines = explode("\n", $yaml);
+        $formattedLines = [];
+
+        foreach ($lines as $line) {
+            $formattedLines[] = $this->htmlColorizeYamlLine($line);
+        }
+
+        return '<pre class="display-yaml"><code>' . implode("\n", $formattedLines) . '</code></pre>';
+    }
+
+    private function colorizeYamlLine(string $line): string
+    {
+        // YAML key (before colon)
+        $line = preg_replace_callback(
+            '/^(\s*)([^#:]+?)(\s*):\s*/',
+            function ($matches) {
+                $indentStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+                $keyStyle = ConsoleStyle::create(color: ConsoleColor::YELLOW);
+                return $indentStyle->apply($matches[1]) . $keyStyle->apply($matches[2]) . $matches[3] . ': ';
+            },
+            $line
+        );
+
+        // YAML string value (quoted or unquoted)
+        $line = preg_replace_callback(
+            '/:\s*(["\'])(.*?)\1/',
+            function ($matches) {
+                $stringStyle = ConsoleStyle::create(color: ConsoleColor::GREEN);
+                return ': ' . $matches[1] . $stringStyle->apply($matches[2]) . $matches[1];
+            },
+            $line
+        );
+
+        // YAML number
+        $line = preg_replace_callback(
+            '/:\s*(-?\d+\.?\d*)/',
+            function ($matches) {
+                $numberStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_BLUE);
+                return ': ' . $numberStyle->apply($matches[1]);
+            },
+            $line
+        );
+
+        // YAML boolean
+        $line = preg_replace_callback(
+            '/:\s*(true|false|yes|no|on|off)/i',
+            function ($matches) {
+                $boolStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_MAGENTA);
+                return ': ' . $boolStyle->apply($matches[1]);
+            },
+            $line
+        );
+
+        // YAML null
+        $line = preg_replace_callback(
+            '/:\s*(null|~|\bNULL\b)/i',
+            function ($matches) {
+                $nullStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+                return ': ' . $nullStyle->apply($matches[1]);
+            },
+            $line
+        );
+
+        // YAML comments
+        $line = preg_replace_callback(
+            '/(\s*)(#.*)$/',
+            function ($matches) {
+                $commentStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+                return $matches[1] . $commentStyle->apply($matches[2]);
+            },
+            $line
+        );
+
+        return $line;
+    }
+
+    private function htmlColorizeYamlLine(string $line): string
+    {
+        $line = htmlspecialchars($line, ENT_QUOTES, 'UTF-8');
+
+        // YAML key (before colon)
+        $line = preg_replace_callback(
+            '/^(\s*)([^#:]+?)(\s*):\s*/',
+            function ($matches) {
+                return '<span class="display-yaml-indent">' . htmlspecialchars($matches[1]) . '</span>' .
+                       '<span class="display-yaml-key">' . htmlspecialchars($matches[2]) . '</span>' .
+                       htmlspecialchars($matches[3]) . ': ';
+            },
+            $line
+        );
+
+        // YAML string value
+        $line = preg_replace_callback(
+            '/:\s*(["\'])(.*?)\1/',
+            function ($matches) {
+                return ': ' . $matches[1] . '<span class="display-yaml-string">' . htmlspecialchars($matches[2]) . '</span>' . $matches[1];
+            },
+            $line
+        );
+
+        // YAML number
+        $line = preg_replace_callback(
+            '/:\s*(-?\d+\.?\d*)/',
+            function ($matches) {
+                return ': <span class="display-yaml-number">' . htmlspecialchars($matches[1]) . '</span>';
+            },
+            $line
+        );
+
+        // YAML boolean
+        $line = preg_replace_callback(
+            '/:\s*(true|false|yes|no|on|off)/i',
+            function ($matches) {
+                return ': <span class="display-yaml-boolean">' . htmlspecialchars($matches[1]) . '</span>';
+            },
+            $line
+        );
+
+        // YAML null
+        $line = preg_replace_callback(
+            '/:\s*(null|~|\bNULL\b)/i',
+            function ($matches) {
+                return ': <span class="display-yaml-null">' . htmlspecialchars($matches[1]) . '</span>';
+            },
+            $line
+        );
+
+        // YAML comments
+        $line = preg_replace_callback(
+            '/(\s*)(#.*)$/',
+            function ($matches) {
+                return htmlspecialchars($matches[1]) . '<span class="display-yaml-comment">' . htmlspecialchars($matches[2]) . '</span>';
+            },
+            $line
+        );
+
+        return $line;
+    }
+}
+
diff --git a/src/Framework/Display/Inspectors/ArrayInspector.php b/src/Framework/Display/Inspectors/ArrayInspector.php
new file mode 100644
index 00000000..88707303
--- /dev/null
+++ b/src/Framework/Display/Inspectors/ArrayInspector.php
@@ -0,0 +1,227 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Inspectors;
+
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\DisplayRules;
+
+/**
+ * Analyzes arrays and creates normalized ArrayStructure
+ */
+final readonly class ArrayInspector
+{
+    public function inspect(array $data, DisplayOptions $options): ArrayStructure
+    {
+        return $this->inspectInternal($data, $options, true, []);
+    }
+
+    /**
+     * Internal inspection method with root/nested context and visited tracking
+     *
+     * @param array<int, bool> $visited Array hashes of already visited arrays (for circular refs)
+     */
+    private function inspectInternal(array $data, DisplayOptions $options, bool $isRoot, array $visited): ArrayStructure
+    {
+        $rules = $options->getRules();
+        $arrayHash = $this->getArrayHash($data);
+
+        // Check for circular reference
+        if (isset($visited[$arrayHash])) {
+            return new ArrayStructure(
+                items: [],
+                isAssociative: false,
+                depth: 0,
+                count: count($data),
+                keys: [],
+                valueTypes: [],
+                nestedArrays: [],
+                statistics: [],
+                isCircularReference: true,
+                isNested: ! $isRoot,
+                isSummary: false,
+                summaryInfo: [],
+                truncatedCount: null,
+            );
+        }
+
+        // Mark as visited
+        $visited[$arrayHash] = true;
+
+        $count = count($data);
+
+        // Check if array should be summarized
+        $threshold = $isRoot ? $rules->maxArraySizeForSummary : $rules->maxArraySizeForSummaryNested;
+        if ($count > $threshold) {
+            return $this->createSummaryStructure($data, $isRoot);
+        }
+
+        // Check for truncation
+        $maxItems = $rules->maxItems;
+        $truncatedCount = null;
+        if ($count > $maxItems) {
+            $data = array_slice($data, 0, $maxItems, true);
+            $truncatedCount = $count - $maxItems;
+        }
+
+        return $this->createFullStructure($data, $options, $isRoot, $visited, $truncatedCount);
+    }
+
+    private function createSummaryStructure(array $data, bool $isRoot): ArrayStructure
+    {
+        $count = count($data);
+        $typeDistribution = $this->analyzeTypeDistribution($data);
+        $keys = array_keys($data);
+        $isAssociative = ! $this->isIndexed($keys);
+
+        return new ArrayStructure(
+            items: [],
+            isAssociative: $isAssociative,
+            depth: 0,
+            count: $count,
+            keys: $keys,
+            valueTypes: [],
+            nestedArrays: [],
+            statistics: [],
+            isCircularReference: false,
+            isNested: ! $isRoot,
+            isSummary: true,
+            summaryInfo: [
+                'size' => $count,
+                'type_distribution' => $typeDistribution,
+                'associative' => $isAssociative,
+            ],
+            truncatedCount: null,
+        );
+    }
+
+    private function createFullStructure(array $data, DisplayOptions $options, bool $isRoot, array $visited, ?int $truncatedCount): ArrayStructure
+    {
+        if (empty($data)) {
+            return new ArrayStructure(
+                items: [],
+                isAssociative: false,
+                depth: 0,
+                count: 0,
+                keys: [],
+                valueTypes: [],
+                nestedArrays: [],
+                statistics: [],
+                isCircularReference: false,
+                isNested: ! $isRoot,
+                isSummary: false,
+                summaryInfo: [],
+                truncatedCount: null,
+            );
+        }
+
+        $keys = array_keys($data);
+        $isAssociative = ! $this->isIndexed($keys);
+        $count = count($data);
+        $valueTypes = [];
+        $nestedArrays = [];
+        $items = [];
+        $currentDepth = $isRoot ? 0 : 1;
+
+        foreach ($data as $key => $value) {
+            $valueType = get_debug_type($value);
+            $valueTypes[$key] = $valueType;
+
+            if (is_array($value) && $currentDepth < $options->maxDepth) {
+                $nestedArrays[$key] = $this->inspectInternal($value, $options, false, $visited);
+                $items[$key] = '[array:' . count($value) . ']';
+            } else {
+                $items[$key] = $value;
+            }
+        }
+
+        $depth = $currentDepth;
+        if (! empty($nestedArrays)) {
+            $maxNestedDepth = max(array_map(
+                fn (ArrayStructure $nested) => $nested->depth,
+                $nestedArrays
+            ));
+            $depth = max($depth, $maxNestedDepth);
+        }
+
+        $statistics = [
+            'total_items' => $count,
+            'associative' => $isAssociative ? 1 : 0,
+            'indexed' => $isAssociative ? 0 : 1,
+            'nested_count' => count($nestedArrays),
+            'unique_types' => count(array_unique($valueTypes)),
+        ];
+
+        return new ArrayStructure(
+            items: $items,
+            isAssociative: $isAssociative,
+            depth: $depth,
+            count: $count,
+            keys: $keys,
+            valueTypes: $valueTypes,
+            nestedArrays: $nestedArrays,
+            statistics: $statistics,
+            isCircularReference: false,
+            isNested: ! $isRoot,
+            isSummary: false,
+            summaryInfo: [],
+            truncatedCount: $truncatedCount,
+        );
+    }
+
+    private function analyzeTypeDistribution(array $data): array
+    {
+        $typeCounts = [];
+        $total = count($data);
+
+        foreach ($data as $value) {
+            $type = get_debug_type($value);
+            $typeCounts[$type] = ($typeCounts[$type] ?? 0) + 1;
+        }
+
+        $distribution = [];
+        foreach ($typeCounts as $type => $count) {
+            $distribution[$type] = [
+                'count' => $count,
+                'percentage' => round(($count / $total) * 100, 1),
+            ];
+        }
+
+        return $distribution;
+    }
+
+    private function isIndexed(array $keys): bool
+    {
+        if (empty($keys)) {
+            return true;
+        }
+
+        $expected = 0;
+        foreach ($keys as $key) {
+            if (! is_int($key) || $key !== $expected) {
+                return false;
+            }
+            $expected++;
+        }
+
+        return true;
+    }
+
+    /**
+     * Generate a hash for an array to detect circular references
+     * Uses serialization to create a stable hash
+     */
+    private function getArrayHash(array $array): int
+    {
+        // Use a combination of count and first few keys for hash
+        // This is not perfect but works for most cases
+        $keys = array_keys($array);
+        $hashString = count($array) . '-' . implode('-', array_slice($keys, 0, 5));
+
+        return crc32($hashString);
+    }
+}
+
+
diff --git a/src/Framework/Display/Inspectors/ClassInspector.php b/src/Framework/Display/Inspectors/ClassInspector.php
new file mode 100644
index 00000000..3e7e271a
--- /dev/null
+++ b/src/Framework/Display/Inspectors/ClassInspector.php
@@ -0,0 +1,222 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Inspectors;
+
+use App\Framework\Display\ValueObjects\ClassStructure;
+use App\Framework\Display\ValueObjects\ConstantInfo;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\MethodInfo;
+use App\Framework\Display\ValueObjects\PropertyInfo;
+use ReflectionClass;
+use ReflectionClassConstant;
+use ReflectionMethod;
+use ReflectionProperty;
+
+/**
+ * Analyzes classes via Reflection and creates normalized ClassStructure
+ */
+final readonly class ClassInspector
+{
+    public function inspect(string|object $class, DisplayOptions $options): ClassStructure
+    {
+        $className = is_string($class) ? $class : get_class($class);
+        $reflection = new ReflectionClass($className);
+
+        $namespace = $reflection->getNamespaceName();
+        $parentClass = $reflection->getParentClass()?->getName();
+        $interfaces = $reflection->getInterfaceNames();
+        $attributes = $this->extractAttributes($reflection);
+
+        $methods = $this->inspectMethods($reflection, $options);
+        $properties = $this->inspectProperties($reflection, $options);
+        $constants = $this->inspectConstants($reflection, $options);
+
+        $metadata = [
+            'file' => $reflection->getFileName() ?: '',
+            'start_line' => $reflection->getStartLine() ?: 0,
+            'end_line' => $reflection->getEndLine() ?: 0,
+            'is_instantiable' => $reflection->isInstantiable(),
+            'is_cloneable' => $reflection->isCloneable(),
+        ];
+
+        return new ClassStructure(
+            className: $reflection->getShortName(),
+            namespace: $namespace,
+            parentClass: $parentClass,
+            methods: $methods,
+            properties: $properties,
+            constants: $constants,
+            interfaces: $interfaces,
+            attributes: $attributes,
+            isFinal: $reflection->isFinal(),
+            isAbstract: $reflection->isAbstract(),
+            isReadonly: $reflection->isReadOnly(),
+            isInterface: $reflection->isInterface(),
+            isTrait: $reflection->isTrait(),
+            isEnum: $reflection->isEnum(),
+            metadata: $metadata,
+        );
+    }
+
+    /**
+     * @return array<MethodInfo>
+     */
+    private function inspectMethods(ReflectionClass $reflection, DisplayOptions $options): array
+    {
+        $methods = [];
+        $allMethods = $reflection->getMethods();
+
+        foreach ($allMethods as $method) {
+            $visibility = $method->getModifiers();
+            $isPrivate = ($visibility & ReflectionMethod::IS_PRIVATE) !== 0;
+            $isProtected = ($visibility & ReflectionMethod::IS_PROTECTED) !== 0;
+
+            // Skip private/protected if not showing them
+            if (($isPrivate || $isProtected) && ! $options->showPrivateProperties) {
+                continue;
+            }
+
+            $returnType = $method->getReturnType();
+            $returnTypeString = $returnType ? $returnType->__toString() : 'mixed';
+
+            $parameters = [];
+            foreach ($method->getParameters() as $param) {
+                $paramType = $param->getType();
+                $paramString = $paramType ? $paramType->__toString() : 'mixed';
+                $paramString .= ' $' . $param->getName();
+
+                if ($param->isDefaultValueAvailable()) {
+                    $defaultValue = $param->getDefaultValue();
+                    $paramString .= ' = ' . $this->formatDefaultValue($defaultValue);
+                }
+
+                $parameters[] = $paramString;
+            }
+
+            $attributes = $this->extractMethodAttributes($method);
+
+            $methods[$method->getName()] = new MethodInfo(
+                name: $method->getName(),
+                visibility: $visibility,
+                returnType: $returnTypeString,
+                parameters: $parameters,
+                isStatic: $method->isStatic(),
+                isAbstract: $method->isAbstract(),
+                isFinal: $method->isFinal(),
+                attributes: $attributes,
+            );
+        }
+
+        return $methods;
+    }
+
+    /**
+     * @return array<PropertyInfo>
+     */
+    private function inspectProperties(ReflectionClass $reflection, DisplayOptions $options): array
+    {
+        $properties = [];
+        $allProperties = $reflection->getProperties();
+
+        foreach ($allProperties as $property) {
+            $visibility = $property->getModifiers();
+            $isPrivate = ($visibility & ReflectionProperty::IS_PRIVATE) !== 0;
+            $isProtected = ($visibility & ReflectionProperty::IS_PROTECTED) !== 0;
+
+            // Skip private/protected if not showing them
+            if (($isPrivate || $isProtected) && ! $options->showPrivateProperties) {
+                continue;
+            }
+
+            $type = $property->getType();
+            $typeString = $type ? $type->__toString() : 'mixed';
+
+            $propertyInfo = new PropertyInfo(
+                name: $property->getName(),
+                type: $typeString,
+                value: null, // Properties don't have values in class context
+                visibility: $visibility,
+                isReadonly: $property->isReadOnly(),
+                isStatic: $property->isStatic(),
+                isNullable: $type?->allowsNull() ?? false,
+                declaringClass: $property->getDeclaringClass()->getName(),
+            );
+
+            $properties[$property->getName()] = $propertyInfo;
+        }
+
+        return $properties;
+    }
+
+    /**
+     * @return array<ConstantInfo>
+     */
+    private function inspectConstants(ReflectionClass $reflection, DisplayOptions $options): array
+    {
+        $constants = [];
+        $allConstants = $reflection->getReflectionConstants();
+
+        foreach ($allConstants as $constant) {
+            $visibility = $constant->getModifiers();
+            $isPrivate = ($visibility & ReflectionClassConstant::IS_PRIVATE) !== 0;
+            $isProtected = ($visibility & ReflectionClassConstant::IS_PROTECTED) !== 0;
+
+            // Skip private/protected if not showing them
+            if (($isPrivate || $isProtected) && ! $options->showPrivateProperties) {
+                continue;
+            }
+
+            $value = $constant->getValue();
+
+            $constants[$constant->getName()] = new ConstantInfo(
+                name: $constant->getName(),
+                value: $value,
+                type: get_debug_type($value),
+                visibility: $visibility,
+                isFinal: $constant->isFinal(),
+            );
+        }
+
+        return $constants;
+    }
+
+    /**
+     * @return array<string>
+     */
+    private function extractAttributes(ReflectionClass $reflection): array
+    {
+        $attributes = [];
+        foreach ($reflection->getAttributes() as $attribute) {
+            $attributes[] = $attribute->getName();
+        }
+
+        return $attributes;
+    }
+
+    /**
+     * @return array<string>
+     */
+    private function extractMethodAttributes(ReflectionMethod $method): array
+    {
+        $attributes = [];
+        foreach ($method->getAttributes() as $attribute) {
+            $attributes[] = $attribute->getName();
+        }
+
+        return $attributes;
+    }
+
+    private function formatDefaultValue(mixed $value): string
+    {
+        return match (true) {
+            is_string($value) => "'{$value}'",
+            is_null($value) => 'null',
+            is_bool($value) => $value ? 'true' : 'false',
+            is_array($value) => '[]',
+            default => (string) $value,
+        };
+    }
+}
+
diff --git a/src/Framework/Display/Inspectors/FilesystemInspector.php b/src/Framework/Display/Inspectors/FilesystemInspector.php
new file mode 100644
index 00000000..14e3a8bb
--- /dev/null
+++ b/src/Framework/Display/Inspectors/FilesystemInspector.php
@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Inspectors;
+
+use App\Framework\Display\ValueObjects\DirectoryStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\FileEntry;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * Analyzes filesystem directory structures and creates normalized DirectoryStructure
+ */
+final readonly class FilesystemInspector
+{
+    public function inspect(string|FilePath $path, DisplayOptions $options): DirectoryStructure
+    {
+        $pathString = $path instanceof FilePath ? $path->toString() : $path;
+
+        if (! is_dir($pathString)) {
+            throw new \InvalidArgumentException("Path is not a directory: {$pathString}");
+        }
+
+        return $this->scanDirectory($pathString, $options, 0);
+    }
+
+    private function scanDirectory(string $path, DisplayOptions $options, int $currentDepth): DirectoryStructure
+    {
+        $files = [];
+        $directories = [];
+        $totalFiles = 0;
+        $totalDirectories = 0;
+
+        if ($currentDepth >= $options->maxDepth) {
+            return new DirectoryStructure(
+                path: $path,
+                files: [],
+                directories: [],
+                depth: $currentDepth,
+                totalFiles: 0,
+                totalDirectories: 0,
+                statistics: ['max_depth_reached' => true],
+            );
+        }
+
+        $items = scandir($path);
+        if ($items === false) {
+            throw new \RuntimeException("Cannot scan directory: {$path}");
+        }
+
+        foreach ($items as $item) {
+            if ($item === '.' || $item === '..') {
+                continue;
+            }
+
+            $itemPath = $path . DIRECTORY_SEPARATOR . $item;
+
+            if (is_dir($itemPath)) {
+                $totalDirectories++;
+                $subDirectory = $this->scanDirectory($itemPath, $options, $currentDepth + 1);
+                $directories[$item] = $subDirectory;
+                $totalFiles += $subDirectory->totalFiles;
+                $totalDirectories += $subDirectory->totalDirectories;
+            } elseif (is_file($itemPath)) {
+                $totalFiles++;
+                $files[] = $this->createFileEntry($itemPath, $options);
+            }
+        }
+
+        $statistics = [
+            'files_count' => count($files),
+            'directories_count' => count($directories),
+            'total_files' => $totalFiles,
+            'total_directories' => $totalDirectories,
+        ];
+
+        return new DirectoryStructure(
+            path: $path,
+            files: $files,
+            directories: $directories,
+            depth: $currentDepth,
+            totalFiles: $totalFiles,
+            totalDirectories: $totalDirectories,
+            statistics: $statistics,
+        );
+    }
+
+    private function createFileEntry(string $filePath, DisplayOptions $options): FileEntry
+    {
+        $fileInfo = new \SplFileInfo($filePath);
+        $path = FilePath::create($filePath);
+
+        return new FileEntry(
+            path: $path,
+            name: $fileInfo->getFilename(),
+            size: $options->showFileSizes ? ($fileInfo->getSize() ?: 0) : 0,
+            lastModified: $fileInfo->getMTime() ?: 0,
+            extension: $fileInfo->getExtension(),
+            isReadable: $fileInfo->isReadable(),
+            isWritable: $fileInfo->isWritable(),
+        );
+    }
+}
+
diff --git a/src/Framework/Display/Inspectors/ObjectInspector.php b/src/Framework/Display/Inspectors/ObjectInspector.php
new file mode 100644
index 00000000..8f813c45
--- /dev/null
+++ b/src/Framework/Display/Inspectors/ObjectInspector.php
@@ -0,0 +1,417 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Inspectors;
+
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\ObjectStructure;
+use App\Framework\Display\ValueObjects\PropertyInfo;
+use ReflectionClass;
+use ReflectionProperty;
+
+/**
+ * Analyzes objects and creates normalized ObjectStructure
+ */
+final readonly class ObjectInspector
+{
+    public function inspect(object $object, DisplayOptions $options): ObjectStructure
+    {
+        return $this->inspectInternal($object, $options, true, []);
+    }
+
+    /**
+     * Internal inspection method with visited objects tracking
+     *
+     * @param array<int, bool> $visited Object IDs of already visited objects
+     */
+    private function inspectInternal(object $object, DisplayOptions $options, bool $isRoot, array $visited): ObjectStructure
+    {
+        $objectId = spl_object_id($object);
+
+        // Check for circular reference
+        if (isset($visited[$objectId])) {
+            $reflection = new ReflectionClass($object);
+
+            return new ObjectStructure(
+                className: $reflection->getName(),
+                properties: [],
+                nestedObjects: [],
+                depth: 0,
+                metadata: [
+                    'class' => $reflection->getName(),
+                    'circular_reference' => true,
+                ],
+                isCircularReference: true,
+                isNested: ! $isRoot,
+                isCollection: false,
+                collectionCount: null,
+                collectionItemType: null,
+                isSummary: false,
+                summaryInfo: [],
+            );
+        }
+
+        // Mark as visited
+        $visited[$objectId] = true;
+
+        $reflection = new ReflectionClass($object);
+        $className = $reflection->getName();
+        $rules = $options->getRules();
+
+        // Check blacklist
+        if ($rules->isBlacklisted($className)) {
+            return new ObjectStructure(
+                className: $className,
+                properties: [],
+                nestedObjects: [],
+                depth: 0,
+                metadata: [
+                    'class' => $className,
+                    'blacklisted' => true,
+                ],
+                isCircularReference: false,
+                isNested: ! $isRoot,
+                isCollection: false,
+                collectionCount: null,
+                collectionItemType: null,
+                isSummary: true,
+                summaryInfo: [
+                    'reason' => 'blacklisted',
+                    'class' => $className,
+                ],
+            );
+        }
+
+        // Check if object is a collection
+        $isCollection = false;
+        $collectionCount = null;
+        $collectionItemType = null;
+        if ($rules->collectionDetection) {
+            $collectionInfo = $this->detectCollection($object);
+            if ($collectionInfo !== null) {
+                $isCollection = true;
+                $collectionCount = $collectionInfo['count'];
+                $collectionItemType = $collectionInfo['itemType'];
+            }
+        }
+        // If collection, return compact structure
+        if ($isCollection) {
+            return new ObjectStructure(
+                className: $className,
+                properties: [],
+                nestedObjects: [],
+                depth: 0,
+                metadata: [
+                    'class' => $className,
+                    'collection' => true,
+                    'count' => $collectionCount,
+                ],
+                isCircularReference: false,
+                isNested: ! $isRoot,
+                isCollection: true,
+                collectionCount: $collectionCount,
+                collectionItemType: $collectionItemType,
+                isSummary: false,
+                summaryInfo: [],
+            );
+        }
+
+        // Get all properties first to check thresholds
+        $allProperties = $reflection->getProperties();
+        $propertyCount = count($allProperties);
+
+        // Check if object should be summarized
+        $threshold = $isRoot ? $rules->maxObjectPropertiesForSummary : $rules->maxObjectPropertiesForSummaryNested;
+        if ($propertyCount > $threshold) {
+            return $this->createSummaryStructure($object, $reflection, $className, $isRoot);
+        }
+
+        $properties = [];
+        $nestedObjects = [];
+        $metadata = [
+            'class' => $className,
+            'namespace' => $reflection->getNamespaceName(),
+            'is_final' => $reflection->isFinal(),
+            'is_abstract' => $reflection->isAbstract(),
+            'is_readonly' => $reflection->isReadOnly(),
+        ];
+
+        foreach ($allProperties as $property) {
+            $visibility = $property->getModifiers();
+            $isPrivate = ($visibility & ReflectionProperty::IS_PRIVATE) !== 0;
+            $isProtected = ($visibility & ReflectionProperty::IS_PROTECTED) !== 0;
+
+            // Skip private/protected if not showing them
+            if ($isPrivate || $isProtected) {
+                if (! $options->showPrivateProperties) {
+                    continue;
+                }
+            }
+
+            $property->setAccessible(true);
+            $value = $property->getValue($object);
+
+            $isValueObject = is_object($value) && $this->isValueObject($value);
+
+            $propertyInfo = new PropertyInfo(
+                name: $property->getName(),
+                type: $this->getPropertyType($property, $value),
+                value: $value,
+                visibility: $visibility,
+                isReadonly: $property->isReadOnly(),
+                isStatic: $property->isStatic(),
+                isNullable: $property->getType()?->allowsNull() ?? false,
+                declaringClass: $property->getDeclaringClass()->getName(),
+                isValueObject: $isValueObject,
+            );
+
+            $properties[$property->getName()] = $propertyInfo;
+
+            // Check for nested objects (but skip Value Objects if compact mode is enabled)
+            if (is_object($value) && ! $value instanceof \Closure) {
+                $valueClass = get_class($value);
+                if ($valueClass !== 'stdClass' || count((array) $value) > 0) {
+                    // Skip nested inspection for Value Objects if compact mode is enabled
+                    if (! $isValueObject || ! $options->compactValueObjects) {
+                        $nestedDepth = $this->calculateDepthInternal($value, $options, $visited);
+                        if ($nestedDepth < $options->maxDepth) {
+                            $nestedObjects[$property->getName()] = $this->inspectInternal($value, $options, false, $visited);
+                        }
+                    }
+                }
+            }
+        }
+
+        $depth = 0;
+        if (! empty($nestedObjects)) {
+            $maxNestedDepth = max(array_map(
+                fn (ObjectStructure $nested) => $nested->depth,
+                $nestedObjects
+            ));
+            $depth = $maxNestedDepth + 1;
+        }
+
+        return new ObjectStructure(
+            className: $className,
+            properties: $properties,
+            nestedObjects: $nestedObjects,
+            depth: $depth,
+            metadata: $metadata,
+            isCircularReference: false,
+            isNested: ! $isRoot,
+            isCollection: false,
+            collectionCount: null,
+            collectionItemType: null,
+            isSummary: false,
+            summaryInfo: [],
+        );
+    }
+
+    /**
+     * Detect if object is a collection (implements IteratorAggregate + Countable)
+     */
+    private function detectCollection(object $object): ?array
+    {
+        if (! ($object instanceof \IteratorAggregate) || ! ($object instanceof \Countable)) {
+            return null;
+        }
+
+        $count = $object->count();
+        $itemType = $this->detectCollectionItemType($object);
+
+        return [
+            'count' => $count,
+            'itemType' => $itemType,
+        ];
+    }
+
+    /**
+     * Try to detect the item type of a collection
+     */
+    private function detectCollectionItemType(object $collection): ?string
+    {
+        try {
+            $iterator = $collection->getIterator();
+            if ($iterator instanceof \ArrayIterator && $iterator->count() > 0) {
+                $iterator->rewind();
+                if ($iterator->valid()) {
+                    $firstItem = $iterator->current();
+                    if (is_object($firstItem)) {
+                        return get_class($firstItem);
+                    }
+                }
+            }
+        } catch (\Throwable $e) {
+            // Ignore errors
+        }
+
+        // Try reflection on common collection methods
+        $reflection = new ReflectionClass($collection);
+        if ($reflection->hasMethod('toArray')) {
+            try {
+                $toArrayMethod = $reflection->getMethod('toArray');
+                if ($toArrayMethod->isPublic() && $toArrayMethod->getNumberOfParameters() === 0) {
+                    $array = $toArrayMethod->invoke($collection);
+                    if (is_array($array) && ! empty($array)) {
+                        $firstItem = reset($array);
+                        if (is_object($firstItem)) {
+                            return get_class($firstItem);
+                        }
+                    }
+                }
+            } catch (\Throwable $e) {
+                // Ignore errors
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Create a summary structure for large objects
+     */
+    private function createSummaryStructure(object $object, ReflectionClass $reflection, string $className, bool $isRoot): ObjectStructure
+    {
+        $properties = $reflection->getProperties();
+        $propertyCounts = [];
+        $arrayPropertySizes = [];
+
+        foreach ($properties as $property) {
+            $property->setAccessible(true);
+            try {
+                $value = $property->getValue($object);
+                $type = get_debug_type($value);
+                $propertyCounts[$type] = ($propertyCounts[$type] ?? 0) + 1;
+
+                if (is_array($value)) {
+                    $arrayPropertySizes[$property->getName()] = count($value);
+                }
+            } catch (\Throwable $e) {
+                // Ignore errors accessing properties
+            }
+        }
+
+        return new ObjectStructure(
+            className: $className,
+            properties: [],
+            nestedObjects: [],
+            depth: 0,
+            metadata: [
+                'class' => $className,
+                'summary' => true,
+            ],
+            isCircularReference: false,
+            isNested: ! $isRoot,
+            isCollection: false,
+            collectionCount: null,
+            collectionItemType: null,
+            isSummary: true,
+            summaryInfo: [
+                'property_count' => count($properties),
+                'property_counts_by_type' => $propertyCounts,
+                'array_property_sizes' => $arrayPropertySizes,
+            ],
+        );
+    }
+
+    private function getPropertyType(ReflectionProperty $property, mixed $value): string
+    {
+        $type = $property->getType();
+
+        if ($type !== null) {
+            if ($type instanceof \ReflectionUnionType || $type instanceof \ReflectionIntersectionType) {
+                return $type->__toString();
+            }
+
+            return $type->getName();
+        }
+
+        return get_debug_type($value);
+    }
+
+    private function calculateDepth(object $object, DisplayOptions $options): int
+    {
+        return $this->calculateDepthInternal($object, $options, []);
+    }
+
+    /**
+     * Internal depth calculation with visited objects tracking
+     *
+     * @param array<int, bool> $visited Object IDs of already visited objects
+     */
+    private function calculateDepthInternal(object $object, DisplayOptions $options, array $visited): int
+    {
+        $objectId = spl_object_id($object);
+
+        // Circular reference - return 0 to avoid infinite recursion
+        if (isset($visited[$objectId])) {
+            return 0;
+        }
+
+        $visited[$objectId] = true;
+        $reflection = new ReflectionClass($object);
+        $depth = 0;
+
+        foreach ($reflection->getProperties() as $property) {
+            $property->setAccessible(true);
+            $value = $property->getValue($object);
+
+            if (is_object($value) && ! $value instanceof \Closure) {
+                $depth = max($depth, $this->calculateDepthInternal($value, $options, $visited) + 1);
+            }
+        }
+
+        return $depth;
+    }
+
+    /**
+     * Detect if an object is a Value Object
+     */
+    private function isValueObject(object $object): bool
+    {
+        $className = get_class($object);
+        $reflection = new ReflectionClass($object);
+
+        // Check namespace for ValueObjects
+        $namespace = $reflection->getNamespaceName();
+        if (str_contains($namespace, 'ValueObjects')) {
+            return true;
+        }
+
+        // Check if implements Stringable
+        if ($object instanceof \Stringable) {
+            return true;
+        }
+
+        // Check if has toString() method
+        if ($reflection->hasMethod('toString')) {
+            $toStringMethod = $reflection->getMethod('toString');
+            if ($toStringMethod->isPublic() && $toStringMethod->getNumberOfParameters() === 0) {
+                return true;
+            }
+        }
+
+        // Check if final readonly (typical Value Object pattern)
+        if ($reflection->isFinal() && $reflection->isReadOnly()) {
+            // Additional heuristic: few public methods (typical for Value Objects)
+            $publicMethods = array_filter(
+                $reflection->getMethods(),
+                fn ($m) => $m->isPublic() && ! $m->isConstructor() && ! $m->isStatic()
+            );
+
+            if (count($publicMethods) <= 5) {
+                // Check for common Value Object methods
+                $valueObjectMethods = ['equals', 'toString', 'toArray', 'toJson', 'toDecimal', 'format'];
+                foreach ($publicMethods as $method) {
+                    if (in_array($method->getName(), $valueObjectMethods, true)) {
+                        return true;
+                    }
+                }
+            }
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Framework/Display/README.md b/src/Framework/Display/README.md
new file mode 100644
index 00000000..4cd18a7b
--- /dev/null
+++ b/src/Framework/Display/README.md
@@ -0,0 +1,583 @@
+# Display Module
+
+A comprehensive data formatting and display module for the Framework, supporting both Console and HTML output formats. The module provides intelligent formatting for arrays, objects, classes, filesystem structures, and various data formats (JSON, YAML, XML, CSV).
+
+## Table of Contents
+
+- [Introduction](#introduction)
+- [Quick Start](#quick-start)
+- [Architecture Overview](#architecture-overview)
+- [Formatters](#formatters)
+- [Configuration](#configuration)
+- [Value Object Formatting](#value-object-formatting)
+- [Advanced Usage](#advanced-usage)
+- [Performance Tips](#performance-tips)
+- [Examples](#examples)
+
+## Introduction
+
+The Display module provides a unified interface for formatting and displaying various data types in both console and HTML environments. It automatically detects data types and applies appropriate formatting, making it easy to display complex data structures in a readable format.
+
+### Key Features
+
+- **Multi-Format Support**: Console (ANSI colors) and HTML (semantic HTML/CSS)
+- **Auto-Detection**: Automatically selects the appropriate formatter based on data type
+- **Smart Filtering**: Configurable rules for handling large structures and blacklisted classes
+- **Collection Detection**: Automatically detects and compactly displays collection objects
+- **Circular Reference Detection**: Prevents infinite loops when displaying object graphs
+- **Value Object Support**: Special formatting for Value Objects with custom formatters
+- **Multiple Data Formats**: Support for JSON, YAML, XML, CSV, arrays, objects, classes, and filesystem structures
+
+## Quick Start
+
+### Basic Usage
+
+```php
+use App\Framework\Display\Formatters\AutoFormatter;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+$formatter = new AutoFormatter();
+
+// Format for console
+$output = $formatter->formatForConsole($data);
+
+// Format for HTML
+$output = $formatter->formatForHtml($data);
+
+// With custom options
+$options = DisplayOptions::default()
+    ->withMaxDepth(5)
+    ->withCompactValueObjects(true);
+
+$output = $formatter->format($data, $options, OutputFormat::CONSOLE);
+```
+
+### Formatting Different Data Types
+
+```php
+$formatter = new AutoFormatter();
+
+// Arrays
+$array = ['name' => 'John', 'age' => 30, 'city' => 'Berlin'];
+echo $formatter->formatForConsole($array);
+
+// Objects
+$object = new User(name: 'John', age: 30);
+echo $formatter->formatForConsole($object);
+
+// JSON strings
+$json = '{"name":"John","age":30}';
+echo $formatter->formatForConsole($json);
+
+// YAML strings
+$yaml = "name: John\nage: 30";
+echo $formatter->formatForConsole($yaml);
+
+// XML strings
+$xml = '<user><name>John</name><age>30</age></user>';
+echo $formatter->formatForConsole($xml);
+
+// CSV strings
+$csv = "name,age\nJohn,30\nJane,25";
+echo $formatter->formatForConsole($csv);
+
+// Classes
+echo $formatter->formatForConsole(User::class);
+
+// Filesystem directories
+echo $formatter->formatForConsole('/path/to/directory');
+```
+
+## Architecture Overview
+
+The Display module follows a three-layer architecture:
+
+### 1. Inspectors
+
+Inspectors analyze raw data and create normalized Value Objects:
+
+- **ArrayInspector**: Analyzes arrays and creates `ArrayStructure`
+- **ObjectInspector**: Analyzes objects and creates `ObjectStructure`
+- **ClassInspector**: Analyzes classes and creates `ClassStructure`
+- **FilesystemInspector**: Analyzes filesystem structures and creates `DirectoryStructure`
+
+### 2. Renderers
+
+Renderers take normalized Value Objects and render them into the target output format:
+
+- **ConsoleRenderer**: Renders structures for console output with ANSI colors
+- **HtmlRenderer**: Renders structures for HTML output with semantic HTML/CSS
+
+### 3. Formatters
+
+Formatters provide high-level APIs combining inspectors and renderers:
+
+- **AutoFormatter**: Automatically detects data type and selects appropriate formatter
+- **ArrayFormatter**: Formats arrays
+- **ObjectFormatter**: Formats objects
+- **ClassFormatter**: Formats classes
+- **FilesystemFormatter**: Formats filesystem structures
+- **JsonFormatter**: Formats JSON strings
+- **YamlFormatter**: Formats YAML strings
+- **XmlFormatter**: Formats XML strings
+- **CsvFormatter**: Formats CSV strings
+
+## Formatters
+
+### AutoFormatter
+
+The `AutoFormatter` automatically detects the input data type and selects the appropriate formatter:
+
+```php
+$formatter = new AutoFormatter();
+
+// Automatically detects and formats:
+// - Arrays → ArrayFormatter
+// - Objects → ObjectFormatter
+// - JSON strings → JsonFormatter
+// - YAML strings → YamlFormatter
+// - XML strings → XmlFormatter
+// - CSV strings → CsvFormatter
+// - Class names → ClassFormatter
+// - Directory paths → FilesystemFormatter
+// - Scalars → Scalar formatting
+
+$output = $formatter->formatForConsole($data);
+```
+
+### ArrayFormatter
+
+Formats arrays with tree, table, or flat display styles:
+
+```php
+use App\Framework\Display\Formatters\ArrayFormatter;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+$formatter = new ArrayFormatter();
+
+// Tree style (default)
+$options = DisplayOptions::default();
+$output = $formatter->format($array, $options, OutputFormat::CONSOLE);
+
+// Table style
+$options = DisplayOptions::default()->withFormatStyle('table');
+$output = $formatter->format($array, $options, OutputFormat::CONSOLE);
+
+// Flat style
+$options = DisplayOptions::default()->withFormatStyle('flat');
+$output = $formatter->format($array, $options, OutputFormat::CONSOLE);
+```
+
+### ObjectFormatter
+
+Formats objects with property inspection:
+
+```php
+use App\Framework\Display\Formatters\ObjectFormatter;
+
+$formatter = new ObjectFormatter();
+
+// Show private/protected properties
+$options = DisplayOptions::default()->withShowPrivateProperties(true);
+$output = $formatter->formatForConsole($object, $options);
+```
+
+### JsonFormatter
+
+Formats JSON strings with syntax highlighting:
+
+```php
+use App\Framework\Display\Formatters\JsonFormatter;
+
+$formatter = new JsonFormatter();
+$json = '{"name":"John","age":30,"active":true}';
+
+// Console output with ANSI colors
+$output = $formatter->formatForConsole($json);
+
+// HTML output with CSS classes
+$output = $formatter->formatForHtml($json);
+```
+
+### YamlFormatter
+
+Formats YAML strings with syntax highlighting:
+
+```php
+use App\Framework\Display\Formatters\YamlFormatter;
+
+$formatter = new YamlFormatter();
+$yaml = "name: John\nage: 30\nactive: true";
+
+$output = $formatter->formatForConsole($yaml);
+```
+
+### XmlFormatter
+
+Formats XML strings with syntax highlighting:
+
+```php
+use App\Framework\Display\Formatters\XmlFormatter;
+
+$formatter = new XmlFormatter();
+$xml = '<user><name>John</name><age>30</age></user>';
+
+$output = $formatter->formatForConsole($xml);
+```
+
+### CsvFormatter
+
+Formats CSV strings as tables:
+
+```php
+use App\Framework\Display\Formatters\CsvFormatter;
+
+$formatter = new CsvFormatter();
+$csv = "name,age\nJohn,30\nJane,25";
+
+// Console output as table
+$output = $formatter->formatForConsole($csv);
+
+// HTML output as HTML table
+$output = $formatter->formatForHtml($csv);
+```
+
+## Configuration
+
+### DisplayOptions
+
+`DisplayOptions` controls how data is displayed:
+
+```php
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+// Default options
+$options = DisplayOptions::default();
+
+// Compact mode
+$options = DisplayOptions::compact(); // maxDepth: 3, no metadata
+
+// Verbose mode
+$options = DisplayOptions::verbose(); // maxDepth: 20, show all properties
+
+// Custom options
+$options = DisplayOptions::default()
+    ->withMaxDepth(5)                    // Maximum nesting depth
+    ->withFormatStyle('tree')            // 'tree', 'table', or 'flat'
+    ->withShowPrivateProperties(true)     // Show private/protected properties
+    ->withCompactValueObjects(true)       // Compact Value Object display
+    ->withShowValueObjectType(true)       // Show Value Object type comments
+    ->withIndentSize(2)                  // Indentation size
+    ->withPrettyPrint(true);              // Pretty print output
+```
+
+### DisplayRules
+
+`DisplayRules` controls filtering and performance optimizations:
+
+```php
+use App\Framework\Display\ValueObjects\DisplayRules;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+// Default rules
+$rules = DisplayRules::default();
+
+// Custom rules
+$rules = DisplayRules::default()
+    ->withBlacklistedClasses([
+        'App\\Framework\\DI\\DefaultContainer',
+        'App\\Framework\\Discovery\\DiscoveryRegistry',
+    ])
+    ->withMaxArraySizeForSummary(1000)        // Root arrays > 1000 show summary
+    ->withMaxArraySizeForSummaryNested(100)   // Nested arrays > 100 show summary
+    ->withMaxObjectPropertiesForSummary(50)   // Root objects > 50 properties show summary
+    ->withMaxObjectPropertiesForSummaryNested(20) // Nested objects > 20 properties show summary
+    ->withMaxItems(100)                       // Max items before truncation
+    ->withCollectionDetection(true)            // Enable collection detection
+    ->withCompactNestedObjects(true);         // Compact display for nested objects
+
+$options = DisplayOptions::default()->withRules($rules);
+```
+
+## Value Object Formatting
+
+The Display module provides special formatting for Value Objects. Value Objects are automatically detected and can be displayed compactly or with custom formatters.
+
+### Automatic Value Object Detection
+
+Value Objects are detected based on:
+
+- Namespace containing "ValueObjects"
+- Implements `Stringable` interface
+- Has `toString()` method
+- `final readonly` class pattern with limited public methods
+
+### Compact Value Object Display
+
+By default, Value Objects are displayed compactly:
+
+```php
+$options = DisplayOptions::default()
+    ->withCompactValueObjects(true)      // Enable compact display
+    ->withShowValueObjectType(true);      // Show type comment
+
+// Value Objects will be displayed as:
+// ClassName(value) // ClassName
+```
+
+### Custom Value Object Formatters
+
+Create custom formatters for specific Value Objects:
+
+```php
+use App\Framework\Display\ValueObjectFormatters\ValueObjectFormatterInterface;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+final readonly class CustomValueObjectFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        return $valueObject instanceof CustomValueObject;
+    }
+
+    public function format(object $valueObject, DisplayOptions $options, OutputFormat $outputFormat): string
+    {
+        if (! $valueObject instanceof CustomValueObject) {
+            return (string) $valueObject;
+        }
+
+        return match ($outputFormat) {
+            OutputFormat::CONSOLE => $this->formatConsole($valueObject, $options),
+            OutputFormat::HTML => $this->formatHtml($valueObject, $options),
+        };
+    }
+
+    private function formatConsole(CustomValueObject $vo, DisplayOptions $options): string
+    {
+        // Custom console formatting
+        return ConsoleStyle::create(color: ConsoleColor::GREEN)
+            ->apply($vo->toString());
+    }
+
+    private function formatHtml(CustomValueObject $vo, DisplayOptions $options): string
+    {
+        // Custom HTML formatting
+        return '<span class="custom-vo">' . htmlspecialchars($vo->toString()) . '</span>';
+    }
+}
+
+// Register the formatter
+$registry = new ValueObjectFormatterRegistry();
+$registry->register(new CustomValueObjectFormatter());
+
+// Use with renderers
+$renderer = new ConsoleRenderer($registry);
+```
+
+## Advanced Usage
+
+### Circular Reference Detection
+
+The module automatically detects and handles circular references:
+
+```php
+class A {
+    public B $b;
+}
+
+class B {
+    public A $a;
+}
+
+$a = new A();
+$b = new B();
+$a->b = $b;
+$b->a = $a;
+
+// Circular references are displayed as [circular reference]
+$formatter = new AutoFormatter();
+echo $formatter->formatForConsole($a);
+```
+
+### Collection Detection
+
+Objects implementing `IteratorAggregate` and `Countable` are automatically detected as collections:
+
+```php
+class UserCollection implements IteratorAggregate, Countable
+{
+    private array $users = [];
+
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator($this->users);
+    }
+
+    public function count(): int
+    {
+        return count($this->users);
+    }
+}
+
+// Collections are displayed as:
+// UserCollection (75 User objects)
+```
+
+### Summary Views for Large Structures
+
+Large arrays and objects are automatically summarized:
+
+```php
+// Large array (> 1000 items for root, > 100 for nested)
+// Displays as: [array: 10000 items, types: string(60%), int(30%), object(10%)]
+
+// Large object (> 50 properties for root, > 20 for nested)
+// Displays as: ClassName [summary: 150 properties, types: string(40), array(30), object(80)]
+```
+
+### Blacklist Support
+
+Blacklisted classes are never fully displayed:
+
+```php
+$rules = DisplayRules::default()
+    ->withBlacklistedClasses([
+        'App\\Framework\\DI\\DefaultContainer',
+        'App\\Framework\\Discovery\\DiscoveryRegistry',
+    ]);
+
+$options = DisplayOptions::default()->withRules($rules);
+
+// Blacklisted objects are displayed as:
+// ClassName [blacklisted]
+```
+
+## Performance Tips
+
+1. **Use Summary Views**: Configure `DisplayRules` to show summaries for large structures
+2. **Limit Depth**: Use `withMaxDepth()` to limit nesting depth
+3. **Compact Value Objects**: Enable `compactValueObjects` for better performance
+4. **Blacklist Large Objects**: Add large objects to blacklist to prevent inspection
+5. **Use Collection Detection**: Collections are displayed compactly without full inspection
+
+## Examples
+
+### Console Command Integration
+
+```php
+use App\Framework\Display\Formatters\AutoFormatter;
+use App\Framework\Console\ConsoleCommand;
+
+#[ConsoleCommand('display:show')]
+final class DisplayShowCommand
+{
+    public function __construct(
+        private AutoFormatter $formatter
+    ) {}
+
+    public function handle(array $data): void
+    {
+        $output = $this->formatter->formatForConsole($data);
+        echo $output . "\n";
+    }
+}
+```
+
+### Web View Integration
+
+```php
+use App\Framework\Display\Formatters\AutoFormatter;
+use App\Framework\Display\ValueObjects\OutputFormat;
+
+class DebugController
+{
+    public function __construct(
+        private AutoFormatter $formatter
+    ) {}
+
+    public function showData(array $data): string
+    {
+        $html = $this->formatter->format($data, DisplayOptions::default(), OutputFormat::HTML);
+        return "<div class='debug-output'>{$html}</div>";
+    }
+}
+```
+
+### Custom Configuration Example
+
+```php
+use App\Framework\Display\Formatters\AutoFormatter;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\DisplayRules;
+
+// Create custom configuration
+$rules = DisplayRules::default()
+    ->withMaxArraySizeForSummary(500)
+    ->withMaxItems(50);
+
+$options = DisplayOptions::default()
+    ->withMaxDepth(3)
+    ->withFormatStyle('tree')
+    ->withRules($rules);
+
+$formatter = new AutoFormatter();
+$output = $formatter->format($data, $options, OutputFormat::CONSOLE);
+```
+
+### Formatting Different Data Types
+
+```php
+$formatter = new AutoFormatter();
+
+// Array
+$array = ['key' => 'value', 'nested' => ['a' => 1, 'b' => 2]];
+echo $formatter->formatForConsole($array);
+
+// Object
+$user = new User(name: 'John', age: 30);
+echo $formatter->formatForConsole($user);
+
+// JSON
+$json = '{"name":"John","age":30}';
+echo $formatter->formatForConsole($json);
+
+// Class structure
+echo $formatter->formatForConsole(User::class);
+
+// Directory structure
+echo $formatter->formatForConsole('/path/to/directory');
+```
+
+## API Reference
+
+### Main Classes
+
+- **AutoFormatter**: Main entry point for automatic formatting
+- **ArrayFormatter**: Formats arrays
+- **ObjectFormatter**: Formats objects
+- **ClassFormatter**: Formats classes
+- **FilesystemFormatter**: Formats filesystem structures
+- **JsonFormatter**: Formats JSON strings
+- **YamlFormatter**: Formats YAML strings
+- **XmlFormatter**: Formats XML strings
+- **CsvFormatter**: Formats CSV strings
+
+### Value Objects
+
+- **DisplayOptions**: Configuration options for display
+- **DisplayRules**: Rules for filtering and performance
+- **OutputFormat**: Output format enum (CONSOLE, HTML)
+- **ArrayStructure**: Normalized array representation
+- **ObjectStructure**: Normalized object representation
+- **ClassStructure**: Normalized class representation
+- **DirectoryStructure**: Normalized directory representation
+
+### Interfaces
+
+- **ValueObjectFormatterInterface**: Interface for custom Value Object formatters
+
+For detailed API documentation, see the PHPDoc comments in the source files.
+
diff --git a/src/Framework/Display/Renderers/ConsoleRenderer.php b/src/Framework/Display/Renderers/ConsoleRenderer.php
new file mode 100644
index 00000000..b67cf891
--- /dev/null
+++ b/src/Framework/Display/Renderers/ConsoleRenderer.php
@@ -0,0 +1,611 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Renderers;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleFormat;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\Components\ComponentFactory;
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\DefaultThemes;
+use App\Framework\Display\ValueObjectRegistry\DefaultValueObjectFormatterRegistry;
+use App\Framework\Display\ValueObjectRegistry\ValueObjectFormatterRegistry;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\ClassStructure;
+use App\Framework\Display\ValueObjects\DirectoryStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\FileEntry;
+use App\Framework\Display\ValueObjects\MethodInfo;
+use App\Framework\Display\ValueObjects\ObjectStructure;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\Display\ValueObjects\PropertyInfo;
+
+/**
+ * Renders data structures for console output with ANSI colors
+ */
+final readonly class ConsoleRenderer
+{
+    public function __construct(
+        private ValueObjectFormatterRegistry $valueObjectRegistry = new ValueObjectFormatterRegistry(),
+    ) {
+    }
+
+    public static function create(): self
+    {
+        return new self(DefaultValueObjectFormatterRegistry::create());
+    }
+    public function renderArray(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+
+        // Handle summary display
+        if ($structure->isSummary) {
+            $summaryStyle = $this->getStyle($theme->summaryColor, $options);
+            $summary = $this->formatArraySummary($structure);
+            $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->arrayBracketColor;
+            return $this->style('[array:', $bracketColor) . ' ' . $summary . ' ' . $summaryStyle->apply(']');
+        }
+
+        if ($structure->isEmpty()) {
+            $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->arrayBracketColor;
+            return $this->style('[]', $bracketColor);
+        }
+
+        // Show truncation message if applicable
+        if ($structure->truncatedCount !== null && $structure->truncatedCount > 0) {
+            $truncationStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+            $truncationMsg = "\n" . $truncationStyle->apply('... (' . $structure->truncatedCount . ' more items)');
+        } else {
+            $truncationMsg = '';
+        }
+
+        $result = match ($options->formatStyle) {
+            'tree' => $this->renderArrayTree($structure, $options),
+            'table' => $this->renderArrayTable($structure, $options),
+            default => $this->renderArrayFlat($structure, $options),
+        };
+
+        return $result . $truncationMsg;
+    }
+
+    public function renderObject(ObjectStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+
+        // Handle collection display
+        if ($structure->isCollection) {
+            $classNameStyle = $this->getStyle($theme->collectionColor, $options, ConsoleFormat::BOLD);
+            $collectionInfo = $structure->className;
+            if ($structure->collectionItemType !== null) {
+                $collectionInfo .= ' (' . $structure->collectionCount . ' ' . $structure->collectionItemType . ' objects)';
+            } else {
+                $collectionInfo .= ' (' . $structure->collectionCount . ' items)';
+            }
+            return $classNameStyle->apply($collectionInfo);
+        }
+
+        // Handle summary display
+        if ($structure->isSummary) {
+            $classNameStyle = $this->getStyle($theme->classNameColor, $options, ConsoleFormat::BOLD);
+            $summaryStyle = $this->getStyle($theme->summaryColor, $options);
+            
+            if (isset($structure->summaryInfo['reason']) && $structure->summaryInfo['reason'] === 'blacklisted') {
+                return $classNameStyle->apply($structure->className) . ' ' . $summaryStyle->apply('[blacklisted]');
+            }
+            
+            $summary = $this->formatSummary($structure);
+            return $classNameStyle->apply($structure->className) . ' ' . $summaryStyle->apply($summary);
+        }
+
+        $theme = $this->getTheme($options);
+        $output = [];
+        $classNameStyle = $this->getStyle($theme->classNameColor, $options, ConsoleFormat::BOLD);
+        
+        $bracketOpen = $options->bracketStyle->getOpen();
+        $bracketClose = $options->bracketStyle->getClose();
+        
+        $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->objectBracketColor;
+        $output[] = $classNameStyle->apply($structure->className) . 
+                    ($bracketOpen !== '' ? ' ' . $this->style($bracketOpen, $bracketColor) : '');
+
+        $indent = $options->getIndentString();
+        $separator = $options->getSeparator();
+        $propertyStyle = $this->getStyle($theme->keyColor, $options);
+
+        foreach ($structure->properties as $propertyInfo) {
+            $line = $indent . $propertyStyle->apply($propertyInfo->name) . $separator;
+
+            if (isset($structure->nestedObjects[$propertyInfo->name])) {
+                $nested = $structure->nestedObjects[$propertyInfo->name];
+                
+                if ($nested->isCircularReference) {
+                    $circularStyle = $this->getStyle($theme->circularReferenceColor, $options);
+                    $line .= $circularStyle->apply('[circular reference]');
+                } else {
+                    $nestedOutput = $this->renderObject($nested, $options);
+                    $nestedLines = explode("\n", $nestedOutput);
+                    $nestedIndent = $options->getIndentString();
+                    $line .= "\n" . $nestedIndent . $nestedLines[0];
+                    for ($i = 1; $i < count($nestedLines); $i++) {
+                        $line .= "\n" . $nestedIndent . $nestedLines[$i];
+                    }
+                }
+            } elseif ($propertyInfo->isValueObject && $options->compactValueObjects && is_object($propertyInfo->value)) {
+                // Compact Value Object display
+                $formatted = $this->formatValueObject($propertyInfo->value, $options);
+                $line .= $formatted;
+                if ($options->showValueObjectType) {
+                    $typeStyle = $this->getStyle($theme->typeColor, $options);
+                    $line .= ' ' . $typeStyle->apply('// ' . $propertyInfo->type);
+                }
+            } else {
+                $value = $this->formatValue($propertyInfo->value, $options);
+                $line .= $value;
+            }
+
+            // Show type if enabled
+            if ($options->showTypes && ! $propertyInfo->isValueObject) {
+                $typeStyle = $this->getStyle($theme->typeColor, $options);
+                $line .= ' ' . $typeStyle->apply('<' . $propertyInfo->type . '>');
+            }
+
+            $visibility = $propertyInfo->getVisibilityString();
+            if ($visibility !== 'public') {
+                $metadataStyle = $this->getStyle($theme->metadataColor, $options);
+                $line .= ' ' . $metadataStyle->apply("({$visibility})");
+            }
+
+            // Apply line wrapping if enabled
+            if ($options->lineWrap && mb_strlen($line) > $options->maxLineLength) {
+                $line = $this->wrapLine($line, $options->maxLineLength, $indent);
+            }
+
+            $output[] = $line;
+        }
+
+        if ($bracketClose !== '') {
+            $output[] = $this->style($bracketClose, $bracketColor);
+        }
+
+        return implode("\n", $output);
+    }
+
+    public function renderClass(ClassStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        $output = [];
+        $classNameStyle = $this->getStyle($theme->classNameColor, $options, ConsoleFormat::BOLD);
+        $fullName = $structure->getFullName();
+        $output[] = $classNameStyle->apply($fullName);
+
+        // Class modifiers
+        $modifiers = [];
+        if ($structure->isFinal) {
+            $modifiers[] = $this->style('final', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($structure->isAbstract) {
+            $modifiers[] = $this->style('abstract', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($structure->isReadonly) {
+            $modifiers[] = $this->style('readonly', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($structure->isInterface) {
+            $modifiers[] = $this->style('interface', ConsoleColor::BRIGHT_MAGENTA);
+        }
+        if ($structure->isTrait) {
+            $modifiers[] = $this->style('trait', ConsoleColor::BRIGHT_MAGENTA);
+        }
+        if ($structure->isEnum) {
+            $modifiers[] = $this->style('enum', ConsoleColor::BRIGHT_MAGENTA);
+        }
+        if (! empty($modifiers)) {
+            $output[] = implode(' ', $modifiers);
+        }
+
+        // Parent class
+        if ($structure->parentClass !== null) {
+            $output[] = $this->style('extends', ConsoleColor::GRAY) . ' ' . $this->style($structure->parentClass, ConsoleColor::CYAN);
+        }
+
+        // Interfaces
+        if (! empty($structure->interfaces)) {
+            $interfacesList = implode(', ', array_map(fn (string $iface) => $this->style($iface, ConsoleColor::CYAN), $structure->interfaces));
+            $output[] = $this->style('implements', ConsoleColor::GRAY) . ' ' . $interfacesList;
+        }
+
+        $bracketOpen = $options->bracketStyle->getOpen();
+        $bracketClose = $options->bracketStyle->getClose();
+        
+        if ($bracketOpen !== '') {
+            $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->objectBracketColor;
+            $output[] = $this->style($bracketOpen, $bracketColor);
+        }
+        $output[] = '';
+
+        $indent = $options->getIndentString();
+
+        // Properties
+        if (! empty($structure->properties)) {
+            $commentStyle = $this->getStyle($theme->metadataColor, $options);
+            $output[] = $commentStyle->apply('// Properties (' . count($structure->properties) . ')');
+            foreach ($structure->properties as $property) {
+                $output[] = $this->renderProperty($property, $indent, $options);
+            }
+            $output[] = '';
+        }
+
+        // Methods
+        if (! empty($structure->methods)) {
+            $commentStyle = $this->getStyle($theme->metadataColor, $options);
+            $output[] = $commentStyle->apply('// Methods (' . count($structure->methods) . ')');
+            foreach ($structure->methods as $method) {
+                $output[] = $this->renderMethod($method, $indent, $options);
+            }
+            $output[] = '';
+        }
+
+        // Constants
+        if (! empty($structure->constants)) {
+            $commentStyle = $this->getStyle($theme->metadataColor, $options);
+            $output[] = $commentStyle->apply('// Constants (' . count($structure->constants) . ')');
+            foreach ($structure->constants as $constant) {
+                $output[] = $this->renderConstant($constant, $indent, $options);
+            }
+        }
+
+        if ($bracketClose !== '') {
+            $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->objectBracketColor;
+            $output[] = $this->style($bracketClose, $bracketColor);
+        }
+
+        return implode("\n", $output);
+    }
+
+    public function renderDirectory(DirectoryStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        $output = [];
+        $pathStyle = $this->getStyle($theme->classNameColor, $options, ConsoleFormat::BOLD);
+        $output[] = $pathStyle->apply($structure->getPathString());
+
+        if ($structure->isEmpty()) {
+            $infoStyle = $this->getStyle($theme->infoColor, $options);
+            $output[] = $infoStyle->apply('(empty)');
+            return implode("\n", $output);
+        }
+
+        return $this->renderDirectoryTree($structure, $options, '');
+    }
+
+    private function renderDirectoryTree(DirectoryStructure $structure, DisplayOptions $options, string $prefix): string
+    {
+        $output = [];
+        $items = [];
+
+        // Add directories
+        foreach ($structure->directories as $name => $subDirectory) {
+            $items[] = ['type' => 'directory', 'name' => $name, 'structure' => $subDirectory];
+        }
+
+        // Add files
+        foreach ($structure->files as $file) {
+            $items[] = ['type' => 'file', 'name' => $file->name, 'file' => $file];
+        }
+
+        $count = count($items);
+        foreach ($items as $index => $item) {
+            $isLast = ($index === $count - 1);
+            $connector = $isLast ? '└── ' : '├── ';
+            $childPrefix = $prefix . ($isLast ? '    ' : '│   ');
+
+            $theme = $this->getTheme($options);
+            
+            if ($item['type'] === 'directory') {
+                $name = $item['name'];
+                $subDir = $item['structure'];
+                $dirStyle = $this->getStyle($theme->keyColor, $options);
+                $output[] = $prefix . $connector . $dirStyle->apply($name . '/');
+                if (! $subDir->isEmpty()) {
+                    $output[] = $this->renderDirectoryTree($subDir, $options, $childPrefix);
+                }
+            } else {
+                $file = $item['file'];
+                $fileStyle = $this->getStyle($theme->valueColor, $options);
+                $line = $prefix . $connector . $fileStyle->apply($file->name);
+
+                if ($options->showFileSizes) {
+                    $sizeStyle = $this->getStyle($theme->metadataColor, $options);
+                    $line .= ' ' . $sizeStyle->apply('(' . $file->getFormattedSize() . ')');
+                }
+
+                $output[] = $line;
+            }
+        }
+
+        return implode("\n", $output);
+    }
+
+    private function renderProperty(PropertyInfo $property, string $indent, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+        $theme = $this->getTheme($options);
+        $visibility = $property->getVisibilityString();
+        $visibilityStyle = $this->getStyle($theme->metadataColor, $options);
+        $nameStyle = $this->getStyle($theme->keyColor, $options);
+        $typeStyle = $this->getStyle($theme->typeColor, $options);
+
+        $modifiers = [];
+        if ($property->isStatic) {
+            $modifiers[] = $this->style('static', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($property->isReadonly) {
+            $modifiers[] = $this->style('readonly', ConsoleColor::BRIGHT_YELLOW);
+        }
+
+        $modifiersStr = ! empty($modifiers) ? implode(' ', $modifiers) . ' ' : '';
+        $nullable = $property->isNullable ? '?' : '';
+
+        return $indent . $modifiersStr . $visibilityStyle->apply($visibility) . ' ' . $nullable . $typeStyle->apply($property->type) . ' $' . $nameStyle->apply($property->name) . ';';
+    }
+
+    private function renderMethod(MethodInfo $method, string $indent, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+        $theme = $this->getTheme($options);
+        $visibility = $method->getVisibilityString();
+        $visibilityStyle = $this->getStyle($theme->metadataColor, $options);
+        $nameStyle = $this->getStyle($theme->keyColor, $options);
+        $typeStyle = $this->getStyle($theme->typeColor, $options);
+
+        $modifiers = [];
+        if ($method->isStatic) {
+            $modifiers[] = $this->style('static', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($method->isAbstract) {
+            $modifiers[] = $this->style('abstract', ConsoleColor::BRIGHT_YELLOW);
+        }
+        if ($method->isFinal) {
+            $modifiers[] = $this->style('final', ConsoleColor::BRIGHT_YELLOW);
+        }
+
+        $modifiersStr = ! empty($modifiers) ? implode(' ', $modifiers) . ' ' : '';
+
+        return $indent . $modifiersStr . $visibilityStyle->apply($visibility) . ' function ' . $nameStyle->apply($method->name) . '(...): ' . $typeStyle->apply($method->returnType);
+    }
+
+    private function renderConstant(\App\Framework\Display\ValueObjects\ConstantInfo $constant, string $indent, ?DisplayOptions $options = null): string
+    {
+        $options ??= DisplayOptions::default();
+        $theme = $this->getTheme($options);
+        $visibility = $constant->getVisibilityString();
+        $visibilityStyle = $this->getStyle($theme->metadataColor, $options);
+        $nameStyle = $this->getStyle($theme->keyColor, $options);
+        $valueStyle = $this->getStyle($theme->stringColor, $options);
+
+        $modifiers = $constant->isFinal ? $this->style('final ', ConsoleColor::BRIGHT_YELLOW) : '';
+
+        $value = $this->formatValue($constant->value, $options);
+
+        return $indent . $modifiers . $visibilityStyle->apply($visibility) . ' const ' . $nameStyle->apply($constant->name) . ' = ' . $valueStyle->apply($value) . ';';
+    }
+
+    private function renderArrayTree(ArrayStructure $structure, DisplayOptions $options, int $depth = 0, string $prefix = ''): string
+    {
+        $tree = ComponentFactory::createTreeHelper(OutputFormat::CONSOLE, $options);
+        assert($tree instanceof \App\Framework\Display\Components\Console\TreeHelper);
+        $tree->fromArrayStructure($structure, $options->getSeparator());
+        
+        return $tree->render();
+    }
+
+    private function renderArrayTable(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $table = ComponentFactory::createTable(OutputFormat::CONSOLE, $options);
+        assert($table instanceof \App\Framework\Display\Components\Console\Table);
+        
+        // Format values in table cells before building table
+        $rows = [];
+        foreach ($structure->items as $key => $value) {
+            $formattedValue = $this->formatValue($value, $options);
+            $rows[] = [(string) $key, $formattedValue];
+        }
+        
+        // Build table with formatted values
+        $headers = $structure->isAssociative ? ['Key', 'Value'] : ['Index', 'Value'];
+        $table->setHeaders($headers);
+        $table->setRows($rows);
+
+        return $table->render();
+    }
+
+    private function renderArrayFlat(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        $items = $structure->items;
+        $formattedItems = [];
+        $separator = $options->getSeparator();
+
+        foreach ($items as $key => $value) {
+            $keyStyle = $this->getStyle($theme->keyColor, $options);
+            $formattedKey = $keyStyle->apply((string) $key);
+            $formattedValue = $this->formatValue($value, $options);
+            $formattedItems[] = $formattedKey . $separator . $formattedValue;
+        }
+
+        $bracketOpen = $options->bracketStyle->getOpen();
+        $bracketClose = $options->bracketStyle->getClose();
+
+        $bracketColor = $options->colorDepth === ColorDepth::NONE ? ConsoleColor::GRAY : $theme->arrayBracketColor;
+        $bracketOpenStr = $bracketOpen !== '' ? $this->style($bracketOpen, $bracketColor) . ' ' : '';
+        $bracketCloseStr = $bracketClose !== '' ? ' ' . $this->style($bracketClose, $bracketColor) : '';
+
+        return $bracketOpenStr . implode(', ', $formattedItems) . $bracketCloseStr;
+    }
+
+    private function formatValue(mixed $value, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+
+        // If colorDepth is 'none', use gray for everything
+        if ($options->colorDepth === ColorDepth::NONE) {
+            return match (true) {
+                is_string($value) => $this->style('"' . $value . '"', ConsoleColor::GRAY),
+                is_int($value) => $this->style((string) $value, ConsoleColor::GRAY),
+                is_float($value) => $this->style((string) $value, ConsoleColor::GRAY),
+                is_bool($value) => $this->style($value ? 'true' : 'false', ConsoleColor::GRAY),
+                is_null($value) => $this->style('null', ConsoleColor::GRAY),
+                is_array($value) => $this->style('[array:' . count($value) . ($options->showSizes ? ' items' : '') . ']', ConsoleColor::GRAY),
+                is_object($value) => $this->style('[object:' . get_class($value) . ']', ConsoleColor::GRAY),
+                is_resource($value) => $this->style('[resource]', ConsoleColor::GRAY),
+                default => $this->style(get_debug_type($value), ConsoleColor::GRAY),
+            };
+        }
+
+        // Basic color depth uses limited colors
+        if ($options->colorDepth === ColorDepth::BASIC) {
+            return match (true) {
+                is_string($value) => $this->style('"' . $value . '"', ConsoleColor::WHITE),
+                is_int($value) || is_float($value) => $this->style((string) $value, ConsoleColor::WHITE),
+                is_bool($value) => $this->style($value ? 'true' : 'false', ConsoleColor::WHITE),
+                is_null($value) => $this->style('null', ConsoleColor::GRAY),
+                is_array($value) => $this->style('[array:' . count($value) . ($options->showSizes ? ' items' : '') . ']', ConsoleColor::CYAN),
+                is_object($value) => $this->style('[object:' . get_class($value) . ']', ConsoleColor::CYAN),
+                is_resource($value) => $this->style('[resource]', ConsoleColor::GRAY),
+                default => $this->style(get_debug_type($value), ConsoleColor::GRAY),
+            };
+        }
+
+        // Full color depth uses theme colors
+        return match (true) {
+            is_string($value) => $this->style('"' . $value . '"', $theme->stringColor),
+            is_int($value) => $this->style((string) $value, $theme->numberColor),
+            is_float($value) => $this->style((string) $value, $theme->numberColor),
+            is_bool($value) => $this->style($value ? 'true' : 'false', $theme->booleanColor),
+            is_null($value) => $this->style('null', $theme->nullColor),
+            is_array($value) => $this->style('[array:' . count($value) . ($options->showSizes ? ' items' : '') . ']', $theme->arrayBracketColor),
+            is_object($value) => $this->style('[object:' . get_class($value) . ']', $theme->objectBracketColor),
+            is_resource($value) => $this->style('[resource]', $theme->typeColor),
+            default => $this->style(get_debug_type($value), $theme->typeColor),
+        };
+    }
+
+    private function style(string $text, ConsoleColor $color): string
+    {
+        return ConsoleStyle::create(color: $color)->apply($text);
+    }
+
+    /**
+     * Get theme for display options
+     */
+    private function getTheme(DisplayOptions $options): ConsoleTheme
+    {
+        // If custom theme is provided and it's a ConsoleTheme, use it
+        if ($options->customTheme instanceof ConsoleTheme) {
+            return $options->customTheme;
+        }
+
+        // Otherwise get theme by name
+        return DefaultThemes::getConsoleTheme($options->theme);
+    }
+
+    /**
+     * Get style based on theme color and color depth
+     */
+    private function getStyle(ConsoleColor $color, DisplayOptions $options, ?ConsoleFormat $format = null): ConsoleStyle
+    {
+        // If colorDepth is 'none', use gray
+        if ($options->colorDepth === ColorDepth::NONE) {
+            return ConsoleStyle::create(color: ConsoleColor::GRAY, format: $format);
+        }
+
+        return ConsoleStyle::create(color: $color, format: $format);
+    }
+
+    /**
+     * Wrap long line to max length
+     */
+    private function wrapLine(string $line, int $maxLength, string $indent): string
+    {
+        if (mb_strlen($line) <= $maxLength) {
+            return $line;
+        }
+
+        $lines = [];
+        $currentLine = '';
+        $parts = explode(' ', $line);
+
+        foreach ($parts as $part) {
+            $testLine = $currentLine === '' ? $part : $currentLine . ' ' . $part;
+            if (mb_strlen($testLine) <= $maxLength) {
+                $currentLine = $testLine;
+            } else {
+                if ($currentLine !== '') {
+                    $lines[] = $currentLine;
+                }
+                $currentLine = $indent . $part;
+            }
+        }
+
+        if ($currentLine !== '') {
+            $lines[] = $currentLine;
+        }
+
+        return implode("\n", $lines);
+    }
+
+    private function formatValueObject(object $valueObject, DisplayOptions $options): string
+    {
+        // Use default registry if empty
+        $registry = empty($this->valueObjectRegistry->getAllFormatters())
+            ? DefaultValueObjectFormatterRegistry::create()
+            : $this->valueObjectRegistry;
+
+        return $registry->format($valueObject, $options, forHtml: false);
+    }
+
+    private function formatSummary(ObjectStructure $structure): string
+    {
+        $info = $structure->summaryInfo;
+        $parts = [];
+
+        if (isset($info['property_count'])) {
+            $parts[] = $info['property_count'] . ' properties';
+        }
+
+        if (isset($info['property_counts_by_type'])) {
+            $typeCounts = [];
+            foreach ($info['property_counts_by_type'] as $type => $count) {
+                $typeCounts[] = $type . '(' . $count . ')';
+            }
+            if (! empty($typeCounts)) {
+                $parts[] = 'types: ' . implode(', ', $typeCounts);
+            }
+        }
+
+        return '[summary: ' . implode(', ', $parts) . ']';
+    }
+
+    private function formatArraySummary(ArrayStructure $structure): string
+    {
+        $info = $structure->summaryInfo;
+        $parts = [];
+
+        if (isset($info['size'])) {
+            $parts[] = $info['size'] . ' items';
+        }
+
+        if (isset($info['type_distribution'])) {
+            $typeParts = [];
+            foreach ($info['type_distribution'] as $type => $data) {
+                $typeParts[] = $type . '(' . $data['percentage'] . '%)';
+            }
+            if (! empty($typeParts)) {
+                $parts[] = 'types: ' . implode(', ', array_slice($typeParts, 0, 5));
+            }
+        }
+
+        return implode(', ', $parts);
+    }
+}
diff --git a/src/Framework/Display/Renderers/HtmlRenderer.php b/src/Framework/Display/Renderers/HtmlRenderer.php
new file mode 100644
index 00000000..e9f537e4
--- /dev/null
+++ b/src/Framework/Display/Renderers/HtmlRenderer.php
@@ -0,0 +1,520 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Renderers;
+
+use App\Framework\Display\Components\ComponentFactory;
+use App\Framework\Display\Themes\DefaultThemes;
+use App\Framework\Display\Themes\HtmlTheme;
+use App\Framework\Display\ValueObjectRegistry\DefaultValueObjectFormatterRegistry;
+use App\Framework\Display\ValueObjectRegistry\ValueObjectFormatterRegistry;
+use App\Framework\Display\ValueObjects\ArrayStructure;
+use App\Framework\Display\ValueObjects\OutputFormat;
+use App\Framework\Display\ValueObjects\ClassStructure;
+use App\Framework\Display\ValueObjects\ConstantInfo;
+use App\Framework\Display\ValueObjects\DirectoryStructure;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Display\ValueObjects\FileEntry;
+use App\Framework\Display\ValueObjects\MethodInfo;
+use App\Framework\Display\ValueObjects\ObjectStructure;
+use App\Framework\Display\ValueObjects\PropertyInfo;
+
+/**
+ * Renders data structures for HTML output
+ */
+final readonly class HtmlRenderer
+{
+    public function __construct(
+        private ValueObjectFormatterRegistry $valueObjectRegistry = new ValueObjectFormatterRegistry(),
+    ) {
+    }
+
+    public static function create(): self
+    {
+        return new self(DefaultValueObjectFormatterRegistry::create());
+    }
+    public function renderArray(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+
+        // Handle summary display
+        if ($structure->isSummary) {
+            $summary = $this->formatArraySummaryHtml($structure);
+            $bracketOpen = $options->bracketStyle->getOpen();
+            $bracketClose = $options->bracketStyle->getClose();
+            $bracketOpenStr = $bracketOpen !== '' ? '<span class="' . $theme->arrayBracketClass . '">' . htmlspecialchars($bracketOpen) . 'array:</span>' : '';
+            $bracketCloseStr = $bracketClose !== '' ? '<span class="' . $theme->arrayBracketClass . '">' . htmlspecialchars($bracketClose) . '</span>' : '';
+            return '<div class="display-array-summary">' . $bracketOpenStr . ' ' . $summary . ' ' . $bracketCloseStr . '</div>';
+        }
+
+        if ($structure->isEmpty()) {
+            $bracketOpen = $options->bracketStyle->getOpen();
+            $bracketClose = $options->bracketStyle->getClose();
+            $emptyBrackets = $bracketOpen !== '' && $bracketClose !== '' ? htmlspecialchars($bracketOpen . $bracketClose) : '[]';
+            return '<div class="display-empty"><span class="' . $theme->arrayBracketClass . '">' . $emptyBrackets . '</span></div>';
+        }
+
+        $truncationMsg = '';
+        if ($structure->truncatedCount !== null && $structure->truncatedCount > 0) {
+            $truncationMsg = '<div class="display-truncation">... (' . $structure->truncatedCount . ' more items)</div>';
+        }
+
+        $result = match ($options->formatStyle) {
+            'tree' => $this->renderArrayTree($structure, $options),
+            'table' => $this->renderArrayTable($structure, $options),
+            default => $this->renderArrayFlat($structure, $options),
+        };
+
+        return $result . $truncationMsg;
+    }
+
+    public function renderObject(ObjectStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+
+        // Handle collection display
+        if ($structure->isCollection) {
+            $collectionInfo = '<span class="' . $theme->collectionClass . '">' . htmlspecialchars($structure->className) . '</span>';
+            if ($structure->collectionItemType !== null) {
+                $collectionInfo .= ' <span class="' . $theme->summaryClass . '">(' . $structure->collectionCount . ' ' . htmlspecialchars($structure->collectionItemType) . ' objects)' . ($options->showSizes ? ' - size: ' . $structure->collectionCount : '') . '</span>';
+            } else {
+                $collectionInfo .= ' <span class="' . $theme->summaryClass . '">(' . $structure->collectionCount . ' items)' . ($options->showSizes ? ' - size: ' . $structure->collectionCount : '') . '</span>';
+            }
+            return '<div class="' . $theme->collectionClass . '">' . $collectionInfo . '</div>';
+        }
+
+        // Handle summary display
+        if ($structure->isSummary) {
+            $className = '<span class="' . $theme->classNameClass . '">' . htmlspecialchars($structure->className) . '</span>';
+            
+            if (isset($structure->summaryInfo['reason']) && $structure->summaryInfo['reason'] === 'blacklisted') {
+                return '<div class="display-object-summary">' . $className . ' <span class="' . $theme->errorClass . '">[blacklisted]</span></div>';
+            }
+            
+            $summary = $this->formatSummaryHtml($structure);
+            return '<div class="display-object-summary">' . $className . ' <span class="' . $theme->summaryClass . '">' . $summary . '</span></div>';
+        }
+
+        $bracketOpen = $options->bracketStyle->getOpen();
+        $bracketClose = $options->bracketStyle->getClose();
+
+        $output = [];
+        $output[] = '<div class="display-object ' . $theme->themeClass . '">';
+        $output[] = '<div class="display-object-header">';
+        $output[] = '<span class="' . $theme->classNameClass . '">' . htmlspecialchars($structure->className) . '</span>';
+        if ($bracketOpen !== '') {
+            $output[] = ' <span class="' . $theme->objectBracketClass . '">' . htmlspecialchars($bracketOpen) . '</span>';
+        }
+        $output[] = '</div>';
+        $output[] = '<div class="display-object-properties">';
+
+        foreach ($structure->properties as $propertyInfo) {
+            $output[] = $this->renderProperty($propertyInfo, $structure, $options);
+        }
+
+        $output[] = '</div>';
+        if ($bracketClose !== '') {
+            $output[] = '<div class="display-object-footer"><span class="' . $theme->objectBracketClass . '">' . htmlspecialchars($bracketClose) . '</span></div>';
+        }
+        $output[] = '</div>';
+
+        return implode("\n", $output);
+    }
+
+    private function renderArrayTree(ArrayStructure $structure, DisplayOptions $options, int $depth = 0): string
+    {
+        $tree = ComponentFactory::createTreeHelper(OutputFormat::HTML, $options);
+        assert($tree instanceof \App\Framework\Display\Components\Html\HtmlTreeHelper);
+        $tree->fromArrayStructure($structure, htmlspecialchars($options->getSeparator()));
+        
+        return $tree->render();
+    }
+
+    private function renderArrayTable(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $table = ComponentFactory::createTable(OutputFormat::HTML, $options);
+        assert($table instanceof \App\Framework\Display\Components\Html\HtmlTable);
+        
+        // Format values in table cells before building table
+        $rows = [];
+        foreach ($structure->items as $key => $value) {
+            $formattedValue = $this->formatValue($value, $options);
+            $rows[] = [(string) $key, $formattedValue];
+        }
+        
+        // Build table with formatted values
+        $headers = $structure->isAssociative ? ['Key', 'Value'] : ['Index', 'Value'];
+        $table->setHeaders($headers);
+        $table->setRows($rows);
+
+        return $table->render();
+    }
+
+    private function renderArrayFlat(ArrayStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        $separator = htmlspecialchars($options->getSeparator());
+        $bracketOpen = $options->bracketStyle->getOpen();
+        $bracketClose = $options->bracketStyle->getClose();
+        
+        $output = [];
+        $output[] = '<div class="display-array ' . $theme->themeClass . '">';
+        if ($options->showTypes || $options->showSizes) {
+            $output[] = '<div class="display-array-header">';
+            if ($options->showTypes) {
+                $output[] = '<span class="' . $theme->typeClass . '">' . ($structure->isAssociative ? 'associative' : 'indexed') . ' array</span>';
+            }
+            if ($options->showSizes) {
+                $output[] = '<span class="' . $theme->metadataClass . '">(' . $structure->count . ' items)</span>';
+            }
+            $output[] = '</div>';
+        }
+        $output[] = '<div class="display-array-items">';
+        if ($bracketOpen !== '') {
+            $output[] = '<span class="' . $theme->arrayBracketClass . '">' . htmlspecialchars($bracketOpen) . '</span>';
+        }
+
+        $items = [];
+        foreach ($structure->items as $key => $value) {
+            $items[] = '<span class="' . $theme->keyClass . '">' . htmlspecialchars((string) $key) . '</span>' .
+                       '<span class="' . $theme->separatorClass . '">' . $separator . '</span>' .
+                       $this->formatValue($value, $options);
+        }
+        $output[] = implode(', ', $items);
+
+        if ($bracketClose !== '') {
+            $output[] = '<span class="' . $theme->arrayBracketClass . '">' . htmlspecialchars($bracketClose) . '</span>';
+        }
+        $output[] = '</div>';
+        $output[] = '</div>';
+
+        return implode("\n", $output);
+    }
+
+    private function renderProperty(PropertyInfo $property, ObjectStructure $structure, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        $separator = htmlspecialchars($options->getSeparator());
+        $indent = $options->getIndentString();
+        $output = [];
+        $output[] = '<div class="display-property" style="margin-left: ' . strlen($indent) . 'em;">';
+        $output[] = '<span class="' . $theme->keyClass . '">' . htmlspecialchars($property->name) . '</span>';
+        if ($options->showTypes) {
+            $output[] = '<span class="' . $theme->typeClass . '">&lt;' . htmlspecialchars($property->type) . '&gt;</span>';
+        }
+        $output[] = '<span class="' . $theme->separatorClass . '">' . $separator . '</span>';
+
+        if (isset($structure->nestedObjects[$property->name])) {
+            $nested = $structure->nestedObjects[$property->name];
+            
+            if ($nested->isCircularReference) {
+                $output[] = '<span class="' . $theme->circularReferenceClass . '">[circular reference]</span>';
+            } else {
+                $nestedHtml = $this->renderObject($nested, $options);
+                $output[] = $nestedHtml;
+            }
+        } elseif ($property->isValueObject && $options->compactValueObjects && is_object($property->value)) {
+            // Compact Value Object display
+            $formatted = $this->formatValueObject($property->value, $options);
+            $output[] = '<span class="' . $theme->valueClass . '">' . $formatted . '</span>';
+            if ($options->showValueObjectType) {
+                $output[] = '<span class="' . $theme->typeClass . '"> // ' . htmlspecialchars($property->type) . '</span>';
+            }
+        } else {
+            $formattedValue = $this->formatValue($property->value, $options);
+            $output[] = '<span class="' . $theme->valueClass . '">' . $formattedValue . '</span>';
+        }
+
+        if ($property->getVisibilityString() !== 'public') {
+            $output[] = '<span class="' . $theme->metadataClass . '">(' . htmlspecialchars($property->getVisibilityString()) . ')</span>';
+        }
+
+        $output[] = '</div>';
+
+        return implode("\n", $output);
+    }
+
+    public function renderClass(ClassStructure $structure, DisplayOptions $options): string
+    {
+        $output = [];
+        $output[] = '<div class="display-class">';
+        $output[] = '<div class="display-class-header">';
+        $output[] = '<span class="display-class-name">' . htmlspecialchars($structure->getFullName()) . '</span>';
+
+        // Modifiers
+        $modifiers = [];
+        if ($structure->isFinal) {
+            $modifiers[] = '<span class="display-modifier">final</span>';
+        }
+        if ($structure->isAbstract) {
+            $modifiers[] = '<span class="display-modifier">abstract</span>';
+        }
+        if ($structure->isReadonly) {
+            $modifiers[] = '<span class="display-modifier">readonly</span>';
+        }
+        if ($structure->isInterface) {
+            $modifiers[] = '<span class="display-modifier display-interface">interface</span>';
+        }
+        if ($structure->isTrait) {
+            $modifiers[] = '<span class="display-modifier display-trait">trait</span>';
+        }
+        if ($structure->isEnum) {
+            $modifiers[] = '<span class="display-modifier display-enum">enum</span>';
+        }
+        if (! empty($modifiers)) {
+            $output[] = implode(' ', $modifiers);
+        }
+
+        // Parent class
+        if ($structure->parentClass !== null) {
+            $output[] = '<span class="display-keyword">extends</span> <span class="display-type-name">' . htmlspecialchars($structure->parentClass) . '</span>';
+        }
+
+        // Interfaces
+        if (! empty($structure->interfaces)) {
+            $interfacesList = implode(', ', array_map(fn (string $iface) => '<span class="display-type-name">' . htmlspecialchars($iface) . '</span>', $structure->interfaces));
+            $output[] = '<span class="display-keyword">implements</span> ' . $interfacesList;
+        }
+
+        $output[] = '</div>'; // header
+        $output[] = '<div class="display-class-body">';
+
+        // Properties
+        if (! empty($structure->properties)) {
+            $output[] = '<div class="display-section">';
+            $output[] = '<h3 class="display-section-title">Properties (' . count($structure->properties) . ')</h3>';
+            $output[] = '<div class="display-properties">';
+            foreach ($structure->properties as $property) {
+                $output[] = $this->renderPropertyInfo($property);
+            }
+            $output[] = '</div>';
+            $output[] = '</div>';
+        }
+
+        // Methods
+        if (! empty($structure->methods)) {
+            $output[] = '<div class="display-section">';
+            $output[] = '<h3 class="display-section-title">Methods (' . count($structure->methods) . ')</h3>';
+            $output[] = '<div class="display-methods">';
+            foreach ($structure->methods as $method) {
+                $output[] = $this->renderMethodInfo($method);
+            }
+            $output[] = '</div>';
+            $output[] = '</div>';
+        }
+
+        // Constants
+        if (! empty($structure->constants)) {
+            $output[] = '<div class="display-section">';
+            $output[] = '<h3 class="display-section-title">Constants (' . count($structure->constants) . ')</h3>';
+            $output[] = '<div class="display-constants">';
+            foreach ($structure->constants as $constant) {
+                $output[] = $this->renderConstantInfo($constant);
+            }
+            $output[] = '</div>';
+            $output[] = '</div>';
+        }
+
+        $output[] = '</div>'; // body
+        $output[] = '</div>'; // class
+
+        return implode("\n", $output);
+    }
+
+    public function renderDirectory(DirectoryStructure $structure, DisplayOptions $options): string
+    {
+        $output = [];
+        $output[] = '<div class="display-directory">';
+        $output[] = '<div class="display-directory-header">';
+        $output[] = '<span class="display-directory-path">' . htmlspecialchars($structure->getPathString()) . '</span>';
+        $output[] = '</div>';
+
+        if ($structure->isEmpty()) {
+            $output[] = '<div class="display-empty">(empty)</div>';
+            $output[] = '</div>';
+            return implode("\n", $output);
+        }
+
+        $output[] = $this->renderDirectoryTree($structure, $options);
+        $output[] = '</div>';
+
+        return implode("\n", $output);
+    }
+
+    private function renderDirectoryTree(DirectoryStructure $structure, DisplayOptions $options): string
+    {
+        $output = [];
+        $output[] = '<ul class="display-directory-tree">';
+
+        // Directories
+        foreach ($structure->directories as $name => $subDirectory) {
+            $output[] = '<li class="display-directory-item">';
+            $output[] = '<span class="display-directory-name">' . htmlspecialchars($name) . '/</span>';
+            if (! $subDirectory->isEmpty()) {
+                $output[] = $this->renderDirectoryTree($subDirectory, $options);
+            }
+            $output[] = '</li>';
+        }
+
+        // Files
+        foreach ($structure->files as $file) {
+            $output[] = '<li class="display-file-item">';
+            $output[] = '<span class="display-file-name">' . htmlspecialchars($file->name) . '</span>';
+            if ($options->showFileSizes) {
+                $output[] = '<span class="display-file-size">(' . htmlspecialchars($file->getFormattedSize()) . ')</span>';
+            }
+            $output[] = '</li>';
+        }
+
+        $output[] = '</ul>';
+
+        return implode("\n", $output);
+    }
+
+    private function renderPropertyInfo(PropertyInfo $property): string
+    {
+        $modifiers = [];
+        if ($property->isStatic) {
+            $modifiers[] = '<span class="display-modifier">static</span>';
+        }
+        if ($property->isReadonly) {
+            $modifiers[] = '<span class="display-modifier">readonly</span>';
+        }
+        $modifiersStr = ! empty($modifiers) ? implode(' ', $modifiers) . ' ' : '';
+        $nullable = $property->isNullable ? '?' : '';
+
+        return '<div class="display-property-info">' .
+            $modifiersStr .
+            '<span class="display-visibility">' . htmlspecialchars($property->getVisibilityString()) . '</span> ' .
+            $nullable . '<span class="display-type">' . htmlspecialchars($property->type) . '</span> ' .
+            '<span class="display-property-name">$' . htmlspecialchars($property->name) . '</span>' .
+            '</div>';
+    }
+
+    private function renderMethodInfo(MethodInfo $method): string
+    {
+        $modifiers = [];
+        if ($method->isStatic) {
+            $modifiers[] = '<span class="display-modifier">static</span>';
+        }
+        if ($method->isAbstract) {
+            $modifiers[] = '<span class="display-modifier">abstract</span>';
+        }
+        if ($method->isFinal) {
+            $modifiers[] = '<span class="display-modifier">final</span>';
+        }
+        $modifiersStr = ! empty($modifiers) ? implode(' ', $modifiers) . ' ' : '';
+
+        $params = implode(', ', array_map(fn (string $param) => '<span class="display-parameter">' . htmlspecialchars($param) . '</span>', $method->parameters));
+
+        return '<div class="display-method-info">' .
+            $modifiersStr .
+            '<span class="display-visibility">' . htmlspecialchars($method->getVisibilityString()) . '</span> ' .
+            '<span class="display-keyword">function</span> ' .
+            '<span class="display-method-name">' . htmlspecialchars($method->name) . '</span>' .
+            '(<span class="display-parameters">' . $params . '</span>): ' .
+            '<span class="display-type">' . htmlspecialchars($method->returnType) . '</span>' .
+            '</div>';
+    }
+
+    private function renderConstantInfo(ConstantInfo $constant): string
+    {
+        $modifiers = $constant->isFinal ? '<span class="display-modifier">final </span>' : '';
+        $value = $this->formatValue($constant->value, DisplayOptions::default());
+
+        return '<div class="display-constant-info">' .
+            $modifiers .
+            '<span class="display-visibility">' . htmlspecialchars($constant->getVisibilityString()) . '</span> ' .
+            '<span class="display-keyword">const</span> ' .
+            '<span class="display-constant-name">' . htmlspecialchars($constant->name) . '</span> = ' .
+            $value .
+            '</div>';
+    }
+
+    private function formatValue(mixed $value, DisplayOptions $options): string
+    {
+        $theme = $this->getTheme($options);
+        
+        return match (true) {
+            is_string($value) => '<span class="' . $theme->stringClass . '">"' . htmlspecialchars($value) . '"</span>',
+            is_int($value) => '<span class="' . $theme->numberClass . '">' . $value . '</span>',
+            is_float($value) => '<span class="' . $theme->numberClass . '">' . $value . '</span>',
+            is_bool($value) => '<span class="' . $theme->booleanClass . '">' . ($value ? 'true' : 'false') . '</span>',
+            is_null($value) => '<span class="' . $theme->nullClass . '">null</span>',
+            is_array($value) => '<span class="' . $theme->typeClass . '">[array:' . count($value) . ($options->showSizes ? ' items' : '') . ']</span>',
+            is_object($value) => '<span class="' . $theme->typeClass . '">[object:' . htmlspecialchars(get_class($value)) . ']</span>',
+            is_resource($value) => '<span class="' . $theme->typeClass . '">[resource]</span>',
+            default => '<span class="' . $theme->typeClass . '">' . htmlspecialchars(get_debug_type($value)) . '</span>',
+        };
+    }
+
+    private function formatValueObject(object $valueObject, DisplayOptions $options): string
+    {
+        // Use default registry if empty
+        $registry = empty($this->valueObjectRegistry->getAllFormatters())
+            ? DefaultValueObjectFormatterRegistry::create()
+            : $this->valueObjectRegistry;
+
+        return $registry->format($valueObject, $options, forHtml: true);
+    }
+
+    private function formatSummaryHtml(ObjectStructure $structure): string
+    {
+        $info = $structure->summaryInfo;
+        $parts = [];
+
+        if (isset($info['property_count'])) {
+            $parts[] = $info['property_count'] . ' properties';
+        }
+
+        if (isset($info['property_counts_by_type'])) {
+            $typeCounts = [];
+            foreach ($info['property_counts_by_type'] as $type => $count) {
+                $typeCounts[] = htmlspecialchars($type) . '(' . $count . ')';
+            }
+            if (! empty($typeCounts)) {
+                $parts[] = 'types: ' . implode(', ', $typeCounts);
+            }
+        }
+
+        return '[summary: ' . implode(', ', $parts) . ']';
+    }
+
+    private function formatArraySummaryHtml(ArrayStructure $structure): string
+    {
+        $info = $structure->summaryInfo;
+        $parts = [];
+
+        if (isset($info['size'])) {
+            $parts[] = $info['size'] . ' items';
+        }
+
+        if (isset($info['type_distribution'])) {
+            $typeParts = [];
+            foreach ($info['type_distribution'] as $type => $data) {
+                $typeParts[] = htmlspecialchars($type) . '(' . $data['percentage'] . '%)';
+            }
+            if (! empty($typeParts)) {
+                $parts[] = 'types: ' . implode(', ', array_slice($typeParts, 0, 5));
+            }
+        }
+
+        return implode(', ', $parts);
+    }
+
+    /**
+     * Get theme for display options
+     */
+    private function getTheme(DisplayOptions $options): HtmlTheme
+    {
+        // If custom theme is provided and it's an HtmlTheme, use it
+        if ($options->customTheme instanceof HtmlTheme) {
+            return $options->customTheme;
+        }
+
+        // Otherwise get theme by name
+        return DefaultThemes::getHtmlTheme($options->theme);
+    }
+}
+
diff --git a/src/Framework/Display/Themes/ConsoleTheme.php b/src/Framework/Display/Themes/ConsoleTheme.php
new file mode 100644
index 00000000..a1d87969
--- /dev/null
+++ b/src/Framework/Display/Themes/ConsoleTheme.php
@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+use App\Framework\Console\ConsoleColor;
+
+/**
+ * Theme for console output with color mappings for different element types
+ */
+final readonly class ConsoleTheme
+{
+    public function __construct(
+        public ConsoleColor $keyColor = ConsoleColor::YELLOW,
+        public ConsoleColor $valueColor = ConsoleColor::WHITE,
+        public ConsoleColor $stringColor = ConsoleColor::GREEN,
+        public ConsoleColor $numberColor = ConsoleColor::BRIGHT_BLUE,
+        public ConsoleColor $booleanColor = ConsoleColor::BRIGHT_MAGENTA,
+        public ConsoleColor $nullColor = ConsoleColor::GRAY,
+        public ConsoleColor $typeColor = ConsoleColor::GRAY,
+        public ConsoleColor $classNameColor = ConsoleColor::BRIGHT_CYAN,
+        public ConsoleColor $errorColor = ConsoleColor::BRIGHT_RED,
+        public ConsoleColor $warningColor = ConsoleColor::BRIGHT_YELLOW,
+        public ConsoleColor $infoColor = ConsoleColor::CYAN,
+        public ConsoleColor $circularReferenceColor = ConsoleColor::BRIGHT_RED,
+        public ConsoleColor $collectionColor = ConsoleColor::BRIGHT_CYAN,
+        public ConsoleColor $summaryColor = ConsoleColor::GRAY,
+        public ConsoleColor $arrayBracketColor = ConsoleColor::WHITE,
+        public ConsoleColor $objectBracketColor = ConsoleColor::WHITE,
+        public ConsoleColor $separatorColor = ConsoleColor::GRAY,
+        public ConsoleColor $metadataColor = ConsoleColor::GRAY,
+    ) {
+    }
+
+    /**
+     * Create a new theme with some colors overridden
+     */
+    public function withColors(
+        ?ConsoleColor $keyColor = null,
+        ?ConsoleColor $valueColor = null,
+        ?ConsoleColor $stringColor = null,
+        ?ConsoleColor $numberColor = null,
+        ?ConsoleColor $booleanColor = null,
+        ?ConsoleColor $nullColor = null,
+        ?ConsoleColor $typeColor = null,
+        ?ConsoleColor $classNameColor = null,
+        ?ConsoleColor $errorColor = null,
+        ?ConsoleColor $warningColor = null,
+        ?ConsoleColor $infoColor = null,
+        ?ConsoleColor $circularReferenceColor = null,
+        ?ConsoleColor $collectionColor = null,
+        ?ConsoleColor $summaryColor = null,
+        ?ConsoleColor $arrayBracketColor = null,
+        ?ConsoleColor $objectBracketColor = null,
+        ?ConsoleColor $separatorColor = null,
+        ?ConsoleColor $metadataColor = null,
+    ): self {
+        return new self(
+            keyColor: $keyColor ?? $this->keyColor,
+            valueColor: $valueColor ?? $this->valueColor,
+            stringColor: $stringColor ?? $this->stringColor,
+            numberColor: $numberColor ?? $this->numberColor,
+            booleanColor: $booleanColor ?? $this->booleanColor,
+            nullColor: $nullColor ?? $this->nullColor,
+            typeColor: $typeColor ?? $this->typeColor,
+            classNameColor: $classNameColor ?? $this->classNameColor,
+            errorColor: $errorColor ?? $this->errorColor,
+            warningColor: $warningColor ?? $this->warningColor,
+            infoColor: $infoColor ?? $this->infoColor,
+            circularReferenceColor: $circularReferenceColor ?? $this->circularReferenceColor,
+            collectionColor: $collectionColor ?? $this->collectionColor,
+            summaryColor: $summaryColor ?? $this->summaryColor,
+            arrayBracketColor: $arrayBracketColor ?? $this->arrayBracketColor,
+            objectBracketColor: $objectBracketColor ?? $this->objectBracketColor,
+            separatorColor: $separatorColor ?? $this->separatorColor,
+            metadataColor: $metadataColor ?? $this->metadataColor,
+        );
+    }
+}
+
diff --git a/src/Framework/Display/Themes/DefaultConsoleThemes.php b/src/Framework/Display/Themes/DefaultConsoleThemes.php
new file mode 100644
index 00000000..61f658b1
--- /dev/null
+++ b/src/Framework/Display/Themes/DefaultConsoleThemes.php
@@ -0,0 +1,140 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+use App\Framework\Console\ConsoleColor;
+
+/**
+ * Factory for creating default console themes
+ */
+final readonly class DefaultConsoleThemes
+{
+    public static function default(): ConsoleTheme
+    {
+        return new ConsoleTheme();
+    }
+
+    public static function dark(): ConsoleTheme
+    {
+        return new ConsoleTheme(
+            keyColor: ConsoleColor::BRIGHT_YELLOW,
+            valueColor: ConsoleColor::BRIGHT_WHITE,
+            stringColor: ConsoleColor::BRIGHT_GREEN,
+            numberColor: ConsoleColor::BRIGHT_BLUE,
+            booleanColor: ConsoleColor::BRIGHT_MAGENTA,
+            nullColor: ConsoleColor::GRAY,
+            typeColor: ConsoleColor::GRAY,
+            classNameColor: ConsoleColor::BRIGHT_CYAN,
+            errorColor: ConsoleColor::BRIGHT_RED,
+            warningColor: ConsoleColor::BRIGHT_YELLOW,
+            infoColor: ConsoleColor::CYAN,
+            circularReferenceColor: ConsoleColor::BRIGHT_RED,
+            collectionColor: ConsoleColor::BRIGHT_CYAN,
+            summaryColor: ConsoleColor::GRAY,
+            arrayBracketColor: ConsoleColor::WHITE,
+            objectBracketColor: ConsoleColor::WHITE,
+            separatorColor: ConsoleColor::GRAY,
+            metadataColor: ConsoleColor::GRAY,
+        );
+    }
+
+    public static function light(): ConsoleTheme
+    {
+        return new ConsoleTheme(
+            keyColor: ConsoleColor::YELLOW,
+            valueColor: ConsoleColor::BLACK,
+            stringColor: ConsoleColor::GREEN,
+            numberColor: ConsoleColor::BLUE,
+            booleanColor: ConsoleColor::MAGENTA,
+            nullColor: ConsoleColor::GRAY,
+            typeColor: ConsoleColor::GRAY,
+            classNameColor: ConsoleColor::CYAN,
+            errorColor: ConsoleColor::RED,
+            warningColor: ConsoleColor::YELLOW,
+            infoColor: ConsoleColor::CYAN,
+            circularReferenceColor: ConsoleColor::RED,
+            collectionColor: ConsoleColor::CYAN,
+            summaryColor: ConsoleColor::GRAY,
+            arrayBracketColor: ConsoleColor::BLACK,
+            objectBracketColor: ConsoleColor::BLACK,
+            separatorColor: ConsoleColor::GRAY,
+            metadataColor: ConsoleColor::GRAY,
+        );
+    }
+
+    public static function colorful(): ConsoleTheme
+    {
+        return new ConsoleTheme(
+            keyColor: ConsoleColor::BRIGHT_YELLOW,
+            valueColor: ConsoleColor::BRIGHT_WHITE,
+            stringColor: ConsoleColor::BRIGHT_GREEN,
+            numberColor: ConsoleColor::BRIGHT_BLUE,
+            booleanColor: ConsoleColor::BRIGHT_MAGENTA,
+            nullColor: ConsoleColor::GRAY,
+            typeColor: ConsoleColor::CYAN,
+            classNameColor: ConsoleColor::BRIGHT_CYAN,
+            errorColor: ConsoleColor::BRIGHT_RED,
+            warningColor: ConsoleColor::BRIGHT_YELLOW,
+            infoColor: ConsoleColor::BRIGHT_CYAN,
+            circularReferenceColor: ConsoleColor::BRIGHT_RED,
+            collectionColor: ConsoleColor::BRIGHT_MAGENTA,
+            summaryColor: ConsoleColor::CYAN,
+            arrayBracketColor: ConsoleColor::BRIGHT_WHITE,
+            objectBracketColor: ConsoleColor::BRIGHT_WHITE,
+            separatorColor: ConsoleColor::BRIGHT_CYAN,
+            metadataColor: ConsoleColor::CYAN,
+        );
+    }
+
+    public static function minimal(): ConsoleTheme
+    {
+        return new ConsoleTheme(
+            keyColor: ConsoleColor::GRAY,
+            valueColor: ConsoleColor::WHITE,
+            stringColor: ConsoleColor::GRAY,
+            numberColor: ConsoleColor::GRAY,
+            booleanColor: ConsoleColor::GRAY,
+            nullColor: ConsoleColor::GRAY,
+            typeColor: ConsoleColor::GRAY,
+            classNameColor: ConsoleColor::WHITE,
+            errorColor: ConsoleColor::WHITE,
+            warningColor: ConsoleColor::WHITE,
+            infoColor: ConsoleColor::GRAY,
+            circularReferenceColor: ConsoleColor::WHITE,
+            collectionColor: ConsoleColor::WHITE,
+            summaryColor: ConsoleColor::GRAY,
+            arrayBracketColor: ConsoleColor::WHITE,
+            objectBracketColor: ConsoleColor::WHITE,
+            separatorColor: ConsoleColor::GRAY,
+            metadataColor: ConsoleColor::GRAY,
+        );
+    }
+
+    public static function colorblind(): ConsoleTheme
+    {
+        // Color-blind friendly palette using shapes and brightness differences
+        return new ConsoleTheme(
+            keyColor: ConsoleColor::BRIGHT_WHITE,
+            valueColor: ConsoleColor::WHITE,
+            stringColor: ConsoleColor::BRIGHT_GREEN,
+            numberColor: ConsoleColor::BRIGHT_BLUE,
+            booleanColor: ConsoleColor::BRIGHT_MAGENTA,
+            nullColor: ConsoleColor::GRAY,
+            typeColor: ConsoleColor::CYAN,
+            classNameColor: ConsoleColor::BRIGHT_CYAN,
+            errorColor: ConsoleColor::BRIGHT_RED,
+            warningColor: ConsoleColor::BRIGHT_YELLOW,
+            infoColor: ConsoleColor::CYAN,
+            circularReferenceColor: ConsoleColor::BRIGHT_RED,
+            collectionColor: ConsoleColor::BRIGHT_CYAN,
+            summaryColor: ConsoleColor::CYAN,
+            arrayBracketColor: ConsoleColor::BRIGHT_WHITE,
+            objectBracketColor: ConsoleColor::BRIGHT_WHITE,
+            separatorColor: ConsoleColor::WHITE,
+            metadataColor: ConsoleColor::CYAN,
+        );
+    }
+}
+
diff --git a/src/Framework/Display/Themes/DefaultHtmlThemes.php b/src/Framework/Display/Themes/DefaultHtmlThemes.php
new file mode 100644
index 00000000..81549ce8
--- /dev/null
+++ b/src/Framework/Display/Themes/DefaultHtmlThemes.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+/**
+ * Factory for creating default HTML themes
+ */
+final readonly class DefaultHtmlThemes
+{
+    public static function default(): HtmlTheme
+    {
+        return new HtmlTheme(
+            themeClass: 'display-theme-default',
+        );
+    }
+
+    public static function dark(): HtmlTheme
+    {
+        return new HtmlTheme(
+            keyClass: 'display-key-dark',
+            valueClass: 'display-value-dark',
+            stringClass: 'display-string-dark',
+            numberClass: 'display-number-dark',
+            booleanClass: 'display-boolean-dark',
+            nullClass: 'display-null-dark',
+            typeClass: 'display-type-dark',
+            classNameClass: 'display-class-name-dark',
+            errorClass: 'display-error-dark',
+            warningClass: 'display-warning-dark',
+            infoClass: 'display-info-dark',
+            circularReferenceClass: 'display-circular-reference-dark',
+            collectionClass: 'display-collection-dark',
+            summaryClass: 'display-summary-dark',
+            arrayBracketClass: 'display-array-bracket-dark',
+            objectBracketClass: 'display-object-bracket-dark',
+            separatorClass: 'display-separator-dark',
+            metadataClass: 'display-metadata-dark',
+            themeClass: 'display-theme-dark',
+        );
+    }
+
+    public static function light(): HtmlTheme
+    {
+        return new HtmlTheme(
+            keyClass: 'display-key-light',
+            valueClass: 'display-value-light',
+            stringClass: 'display-string-light',
+            numberClass: 'display-number-light',
+            booleanClass: 'display-boolean-light',
+            nullClass: 'display-null-light',
+            typeClass: 'display-type-light',
+            classNameClass: 'display-class-name-light',
+            errorClass: 'display-error-light',
+            warningClass: 'display-warning-light',
+            infoClass: 'display-info-light',
+            circularReferenceClass: 'display-circular-reference-light',
+            collectionClass: 'display-collection-light',
+            summaryClass: 'display-summary-light',
+            arrayBracketClass: 'display-array-bracket-light',
+            objectBracketClass: 'display-object-bracket-light',
+            separatorClass: 'display-separator-light',
+            metadataClass: 'display-metadata-light',
+            themeClass: 'display-theme-light',
+        );
+    }
+
+    public static function colorful(): HtmlTheme
+    {
+        return new HtmlTheme(
+            keyClass: 'display-key-colorful',
+            valueClass: 'display-value-colorful',
+            stringClass: 'display-string-colorful',
+            numberClass: 'display-number-colorful',
+            booleanClass: 'display-boolean-colorful',
+            nullClass: 'display-null-colorful',
+            typeClass: 'display-type-colorful',
+            classNameClass: 'display-class-name-colorful',
+            errorClass: 'display-error-colorful',
+            warningClass: 'display-warning-colorful',
+            infoClass: 'display-info-colorful',
+            circularReferenceClass: 'display-circular-reference-colorful',
+            collectionClass: 'display-collection-colorful',
+            summaryClass: 'display-summary-colorful',
+            arrayBracketClass: 'display-array-bracket-colorful',
+            objectBracketClass: 'display-object-bracket-colorful',
+            separatorClass: 'display-separator-colorful',
+            metadataClass: 'display-metadata-colorful',
+            themeClass: 'display-theme-colorful',
+        );
+    }
+}
+
diff --git a/src/Framework/Display/Themes/DefaultThemes.php b/src/Framework/Display/Themes/DefaultThemes.php
new file mode 100644
index 00000000..9d787719
--- /dev/null
+++ b/src/Framework/Display/Themes/DefaultThemes.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+/**
+ * Factory for creating default theme registry with all built-in themes
+ */
+final readonly class DefaultThemes
+{
+    public static function createRegistry(): ThemeRegistry
+    {
+        $registry = new ThemeRegistry();
+
+        // Register console themes
+        $registry->registerConsoleTheme('default', DefaultConsoleThemes::default());
+        $registry->registerConsoleTheme('dark', DefaultConsoleThemes::dark());
+        $registry->registerConsoleTheme('light', DefaultConsoleThemes::light());
+        $registry->registerConsoleTheme('colorful', DefaultConsoleThemes::colorful());
+        $registry->registerConsoleTheme('minimal', DefaultConsoleThemes::minimal());
+        $registry->registerConsoleTheme('colorblind', DefaultConsoleThemes::colorblind());
+
+        // Register HTML themes
+        $registry->registerHtmlTheme('default', DefaultHtmlThemes::default());
+        $registry->registerHtmlTheme('dark', DefaultHtmlThemes::dark());
+        $registry->registerHtmlTheme('light', DefaultHtmlThemes::light());
+        $registry->registerHtmlTheme('colorful', DefaultHtmlThemes::colorful());
+
+        return $registry;
+    }
+
+    public static function getConsoleTheme(string $name): ConsoleTheme
+    {
+        return match ($name) {
+            'default' => DefaultConsoleThemes::default(),
+            'dark' => DefaultConsoleThemes::dark(),
+            'light' => DefaultConsoleThemes::light(),
+            'colorful' => DefaultConsoleThemes::colorful(),
+            'minimal' => DefaultConsoleThemes::minimal(),
+            'colorblind' => DefaultConsoleThemes::colorblind(),
+            default => DefaultConsoleThemes::default(),
+        };
+    }
+
+    public static function getHtmlTheme(string $name): HtmlTheme
+    {
+        return match ($name) {
+            'default' => DefaultHtmlThemes::default(),
+            'dark' => DefaultHtmlThemes::dark(),
+            'light' => DefaultHtmlThemes::light(),
+            'colorful' => DefaultHtmlThemes::colorful(),
+            default => DefaultHtmlThemes::default(),
+        };
+    }
+}
+
diff --git a/src/Framework/Display/Themes/HtmlTheme.php b/src/Framework/Display/Themes/HtmlTheme.php
new file mode 100644
index 00000000..10285f19
--- /dev/null
+++ b/src/Framework/Display/Themes/HtmlTheme.php
@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+/**
+ * Theme for HTML output with CSS class mappings for different element types
+ */
+final readonly class HtmlTheme
+{
+    public function __construct(
+        public string $keyClass = 'display-key',
+        public string $valueClass = 'display-value',
+        public string $stringClass = 'display-string',
+        public string $numberClass = 'display-number',
+        public string $booleanClass = 'display-boolean',
+        public string $nullClass = 'display-null',
+        public string $typeClass = 'display-type',
+        public string $classNameClass = 'display-class-name',
+        public string $errorClass = 'display-error',
+        public string $warningClass = 'display-warning',
+        public string $infoClass = 'display-info',
+        public string $circularReferenceClass = 'display-circular-reference',
+        public string $collectionClass = 'display-collection',
+        public string $summaryClass = 'display-summary',
+        public string $arrayBracketClass = 'display-array-bracket',
+        public string $objectBracketClass = 'display-object-bracket',
+        public string $separatorClass = 'display-separator',
+        public string $metadataClass = 'display-metadata',
+        public string $themeClass = 'display-theme-default',
+    ) {
+    }
+
+    /**
+     * Create a new theme with some classes overridden
+     */
+    public function withClasses(
+        ?string $keyClass = null,
+        ?string $valueClass = null,
+        ?string $stringClass = null,
+        ?string $numberClass = null,
+        ?string $booleanClass = null,
+        ?string $nullClass = null,
+        ?string $typeClass = null,
+        ?string $classNameClass = null,
+        ?string $errorClass = null,
+        ?string $warningClass = null,
+        ?string $infoClass = null,
+        ?string $circularReferenceClass = null,
+        ?string $collectionClass = null,
+        ?string $summaryClass = null,
+        ?string $arrayBracketClass = null,
+        ?string $objectBracketClass = null,
+        ?string $separatorClass = null,
+        ?string $metadataClass = null,
+        ?string $themeClass = null,
+    ): self {
+        return new self(
+            keyClass: $keyClass ?? $this->keyClass,
+            valueClass: $valueClass ?? $this->valueClass,
+            stringClass: $stringClass ?? $this->stringClass,
+            numberClass: $numberClass ?? $this->numberClass,
+            booleanClass: $booleanClass ?? $this->booleanClass,
+            nullClass: $nullClass ?? $this->nullClass,
+            typeClass: $typeClass ?? $this->typeClass,
+            classNameClass: $classNameClass ?? $this->classNameClass,
+            errorClass: $errorClass ?? $this->errorClass,
+            warningClass: $warningClass ?? $this->warningClass,
+            infoClass: $infoClass ?? $this->infoClass,
+            circularReferenceClass: $circularReferenceClass ?? $this->circularReferenceClass,
+            collectionClass: $collectionClass ?? $this->collectionClass,
+            summaryClass: $summaryClass ?? $this->summaryClass,
+            arrayBracketClass: $arrayBracketClass ?? $this->arrayBracketClass,
+            objectBracketClass: $objectBracketClass ?? $this->objectBracketClass,
+            separatorClass: $separatorClass ?? $this->separatorClass,
+            metadataClass: $metadataClass ?? $this->metadataClass,
+            themeClass: $themeClass ?? $this->themeClass,
+        );
+    }
+}
+
diff --git a/src/Framework/Display/Themes/ThemeRegistry.php b/src/Framework/Display/Themes/ThemeRegistry.php
new file mode 100644
index 00000000..fcb1e5e2
--- /dev/null
+++ b/src/Framework/Display/Themes/ThemeRegistry.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\Themes;
+
+/**
+ * Registry for managing themes by name
+ */
+final class ThemeRegistry
+{
+    /** @var array<string, ConsoleTheme> */
+    private array $consoleThemes = [];
+
+    /** @var array<string, HtmlTheme> */
+    private array $htmlThemes = [];
+
+    public function registerConsoleTheme(string $name, ConsoleTheme $theme): void
+    {
+        $this->consoleThemes[$name] = $theme;
+    }
+
+    public function registerHtmlTheme(string $name, HtmlTheme $theme): void
+    {
+        $this->htmlThemes[$name] = $theme;
+    }
+
+    public function getConsoleTheme(string $name): ?ConsoleTheme
+    {
+        return $this->consoleThemes[$name] ?? null;
+    }
+
+    public function getHtmlTheme(string $name): ?HtmlTheme
+    {
+        return $this->htmlThemes[$name] ?? null;
+    }
+
+    /**
+     * Get all registered console theme names
+     *
+     * @return array<string>
+     */
+    public function getConsoleThemeNames(): array
+    {
+        return array_keys($this->consoleThemes);
+    }
+
+    /**
+     * Get all registered HTML theme names
+     *
+     * @return array<string>
+     */
+    public function getHtmlThemeNames(): array
+    {
+        return array_keys($this->htmlThemes);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/ByteFormatter.php b/src/Framework/Display/ValueObjectFormatters/ByteFormatter.php
new file mode 100644
index 00000000..c6eae5ec
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/ByteFormatter.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Core\ValueObjects\Byte;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+/**
+ * Formatter for Byte Value Objects with human-readable formatting
+ */
+final readonly class ByteFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        return $valueObject instanceof Byte;
+    }
+
+    public function formatConsole(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Byte) {
+            return (string) $valueObject;
+        }
+
+        $humanReadable = $valueObject->toHumanReadable(2);
+        $bytes = $valueObject->toBytes();
+
+        // Color-code by size range
+        $color = match (true) {
+            $bytes < 1024 => ConsoleColor::WHITE, // Bytes
+            $bytes < 1024 * 1024 => ConsoleColor::GREEN, // KB
+            $bytes < 1024 * 1024 * 1024 => ConsoleColor::YELLOW, // MB
+            $bytes < 1024 * 1024 * 1024 * 1024 => ConsoleColor::BRIGHT_YELLOW, // GB
+            default => ConsoleColor::BRIGHT_RED, // TB+
+        };
+
+        return ConsoleStyle::create(color: $color)->apply($humanReadable);
+    }
+
+    public function formatHtml(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Byte) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        $humanReadable = $valueObject->toHumanReadable(2);
+        $bytes = $valueObject->toBytes();
+
+        // CSS class based on size range
+        $cssClass = match (true) {
+            $bytes < 1024 => 'display-byte-size',
+            $bytes < 1024 * 1024 => 'display-kb-size',
+            $bytes < 1024 * 1024 * 1024 => 'display-mb-size',
+            $bytes < 1024 * 1024 * 1024 * 1024 => 'display-gb-size',
+            default => 'display-tb-size',
+        };
+
+        return '<span class="' . $cssClass . '">' . htmlspecialchars($humanReadable) . '</span>';
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/ClassNameFormatter.php b/src/Framework/Display/ValueObjectFormatters/ClassNameFormatter.php
new file mode 100644
index 00000000..7cd215c6
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/ClassNameFormatter.php
@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+/**
+ * Formatter for ClassName Value Objects with namespace highlighting
+ */
+final readonly class ClassNameFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        return $valueObject instanceof ClassName;
+    }
+
+    public function formatConsole(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof ClassName) {
+            return (string) $valueObject;
+        }
+
+        $namespace = $valueObject->getNamespace();
+        $shortName = $valueObject->getShortName();
+
+        if ($namespace === '') {
+            // Global namespace - just show class name
+            return ConsoleStyle::create(color: ConsoleColor::BRIGHT_CYAN)->apply($shortName);
+        }
+
+        // Namespace in gray, class name highlighted
+        $namespaceStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+        $classNameStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_CYAN);
+
+        return $namespaceStyle->apply($namespace . '\\') . $classNameStyle->apply($shortName);
+    }
+
+    public function formatHtml(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof ClassName) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        $namespace = $valueObject->getNamespace();
+        $shortName = $valueObject->getShortName();
+
+        if ($namespace === '') {
+            return '<span class="display-class-name">' . htmlspecialchars($shortName) . '</span>';
+        }
+
+        return '<span class="display-namespace">' . htmlspecialchars($namespace . '\\') . '</span>' .
+               '<span class="display-class-name">' . htmlspecialchars($shortName) . '</span>';
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/EmailFormatter.php b/src/Framework/Display/ValueObjectFormatters/EmailFormatter.php
new file mode 100644
index 00000000..6d8d0684
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/EmailFormatter.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use Stringable;
+
+/**
+ * Formatter for email-like strings (Value Objects that represent emails)
+ */
+final readonly class EmailFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        // Check if it's a Stringable that looks like an email
+        if (! $valueObject instanceof Stringable) {
+            return false;
+        }
+
+        $stringValue = (string) $valueObject;
+
+        // Simple email validation
+        return filter_var($stringValue, FILTER_VALIDATE_EMAIL) !== false;
+    }
+
+    public function formatConsole(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Stringable) {
+            return (string) $valueObject;
+        }
+
+        $email = (string) $valueObject;
+        $parts = explode('@', $email, 2);
+
+        if (count($parts) !== 2) {
+            return (string) $valueObject;
+        }
+
+        [$localPart, $domain] = $parts;
+
+        $localStyle = ConsoleStyle::create(color: ConsoleColor::BRIGHT_CYAN);
+        $atStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+        $domainStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
+
+        return $localStyle->apply($localPart) . $atStyle->apply('@') . $domainStyle->apply($domain);
+    }
+
+    public function formatHtml(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Stringable) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        $email = (string) $valueObject;
+        $parts = explode('@', $email, 2);
+
+        if (count($parts) !== 2) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        [$localPart, $domain] = $parts;
+
+        return '<span class="display-email-local">' . htmlspecialchars($localPart) . '</span>' .
+               '<span class="display-email-at">@</span>' .
+               '<span class="display-email-domain">' . htmlspecialchars($domain) . '</span>';
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/FilePathFormatter.php b/src/Framework/Display/ValueObjectFormatters/FilePathFormatter.php
new file mode 100644
index 00000000..359b4d78
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/FilePathFormatter.php
@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * Formatter for FilePath Value Objects with path highlighting
+ */
+final readonly class FilePathFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        return $valueObject instanceof FilePath;
+    }
+
+    public function formatConsole(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof FilePath) {
+            return (string) $valueObject;
+        }
+
+        $path = $valueObject->toString();
+        $directory = $valueObject->getDirectory();
+        $filename = $valueObject->getFilename();
+        $extension = $valueObject->getExtension();
+
+        if ($directory === '') {
+            // Just filename
+            if ($extension !== '') {
+                $basename = substr($filename, 0, -strlen($extension) - 1);
+                $fileStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
+                $extStyle = ConsoleStyle::create(color: ConsoleColor::CYAN);
+
+                return $fileStyle->apply($basename) . $extStyle->apply('.' . $extension);
+            }
+
+            return ConsoleStyle::create(color: ConsoleColor::WHITE)->apply($filename);
+        }
+
+        // Directory in gray, filename highlighted, extension in cyan
+        $dirStyle = ConsoleStyle::create(color: ConsoleColor::GRAY);
+        $fileStyle = ConsoleStyle::create(color: ConsoleColor::WHITE);
+        $extStyle = ConsoleStyle::create(color: ConsoleColor::CYAN);
+
+        $output = $dirStyle->apply($directory . DIRECTORY_SEPARATOR);
+
+        if ($extension !== '') {
+            $basename = substr($filename, 0, -strlen($extension) - 1);
+            $output .= $fileStyle->apply($basename) . $extStyle->apply('.' . $extension);
+        } else {
+            $output .= $fileStyle->apply($filename);
+        }
+
+        return $output;
+    }
+
+    public function formatHtml(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof FilePath) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        $path = $valueObject->toString();
+        $directory = $valueObject->getDirectory();
+        $filename = $valueObject->getFilename();
+        $extension = $valueObject->getExtension();
+
+        if ($directory === '') {
+            if ($extension !== '') {
+                $basename = substr($filename, 0, -strlen($extension) - 1);
+
+                return '<span class="display-filename">' . htmlspecialchars($basename) . '</span>' .
+                       '<span class="display-extension">.' . htmlspecialchars($extension) . '</span>';
+            }
+
+            return '<span class="display-filename">' . htmlspecialchars($filename) . '</span>';
+        }
+
+        $output = '<span class="display-directory-path">' . htmlspecialchars($directory . DIRECTORY_SEPARATOR) . '</span>';
+
+        if ($extension !== '') {
+            $basename = substr($filename, 0, -strlen($extension) - 1);
+            $output .= '<span class="display-filename">' . htmlspecialchars($basename) . '</span>' .
+                       '<span class="display-extension">.' . htmlspecialchars($extension) . '</span>';
+        } else {
+            $output .= '<span class="display-filename">' . htmlspecialchars($filename) . '</span>';
+        }
+
+        return $output;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/TimestampFormatter.php b/src/Framework/Display/ValueObjectFormatters/TimestampFormatter.php
new file mode 100644
index 00000000..da0e5d4b
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/TimestampFormatter.php
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleStyle;
+use App\Framework\Core\ValueObjects\Timestamp;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+/**
+ * Formatter for Timestamp Value Objects with formatted date/time
+ */
+final readonly class TimestampFormatter implements ValueObjectFormatterInterface
+{
+    public function supports(object $valueObject): bool
+    {
+        return $valueObject instanceof Timestamp;
+    }
+
+    public function formatConsole(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Timestamp) {
+            return (string) $valueObject;
+        }
+
+        $formatted = $valueObject->format('Y-m-d H:i:s');
+        $now = time();
+        $diff = abs($valueObject->toTimestamp() - $now);
+
+        // Color-code by recency
+        $color = match (true) {
+            $diff < 60 => ConsoleColor::GREEN, // Less than 1 minute
+            $diff < 3600 => ConsoleColor::YELLOW, // Less than 1 hour
+            $diff < 86400 => ConsoleColor::BRIGHT_YELLOW, // Less than 1 day
+            $diff < 604800 => ConsoleColor::WHITE, // Less than 1 week
+            default => ConsoleColor::GRAY, // Older
+        };
+
+        $relative = $this->getRelativeTime($valueObject->toTimestamp(), $now);
+
+        return ConsoleStyle::create(color: $color)->apply($formatted) .
+               ' ' . ConsoleStyle::create(color: ConsoleColor::GRAY)->apply('(' . $relative . ')');
+    }
+
+    public function formatHtml(object $valueObject, DisplayOptions $options): string
+    {
+        if (! $valueObject instanceof Timestamp) {
+            return htmlspecialchars((string) $valueObject);
+        }
+
+        $formatted = $valueObject->format('Y-m-d H:i:s');
+        $now = time();
+        $diff = abs($valueObject->toTimestamp() - $now);
+
+        // CSS class based on recency
+        $cssClass = match (true) {
+            $diff < 60 => 'display-timestamp-recent',
+            $diff < 3600 => 'display-timestamp-hour',
+            $diff < 86400 => 'display-timestamp-day',
+            $diff < 604800 => 'display-timestamp-week',
+            default => 'display-timestamp-old',
+        };
+
+        $relative = $this->getRelativeTime($valueObject->toTimestamp(), $now);
+
+        return '<span class="' . $cssClass . '">' . htmlspecialchars($formatted) . '</span>' .
+               ' <span class="display-timestamp-relative">(' . htmlspecialchars($relative) . ')</span>';
+    }
+
+    private function getRelativeTime(int $timestamp, int $now): string
+    {
+        $diff = $now - $timestamp;
+
+        if ($diff < 0) {
+            $diff = abs($diff);
+            $future = true;
+        } else {
+            $future = false;
+        }
+
+        return match (true) {
+            $diff < 60 => $future ? 'in ' . $diff . 's' : $diff . 's ago',
+            $diff < 3600 => $future ? 'in ' . (int) ($diff / 60) . 'm' : (int) ($diff / 60) . 'm ago',
+            $diff < 86400 => $future ? 'in ' . (int) ($diff / 3600) . 'h' : (int) ($diff / 3600) . 'h ago',
+            $diff < 604800 => $future ? 'in ' . (int) ($diff / 86400) . 'd' : (int) ($diff / 86400) . 'd ago',
+            $diff < 2592000 => $future ? 'in ' . (int) ($diff / 604800) . 'w' : (int) ($diff / 604800) . 'w ago',
+            default => $future ? 'in the future' : 'long ago',
+        };
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectFormatters/ValueObjectFormatterInterface.php b/src/Framework/Display/ValueObjectFormatters/ValueObjectFormatterInterface.php
new file mode 100644
index 00000000..c7d6e375
--- /dev/null
+++ b/src/Framework/Display/ValueObjectFormatters/ValueObjectFormatterInterface.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectFormatters;
+
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+/**
+ * Interface for custom Value Object formatters
+ */
+interface ValueObjectFormatterInterface
+{
+    /**
+     * Check if this formatter supports the given Value Object
+     */
+    public function supports(object $valueObject): bool;
+
+    /**
+     * Format Value Object for console output
+     */
+    public function formatConsole(object $valueObject, DisplayOptions $options): string;
+
+    /**
+     * Format Value Object for HTML output
+     */
+    public function formatHtml(object $valueObject, DisplayOptions $options): string;
+}
+
diff --git a/src/Framework/Display/ValueObjectRegistry/DefaultValueObjectFormatterRegistry.php b/src/Framework/Display/ValueObjectRegistry/DefaultValueObjectFormatterRegistry.php
new file mode 100644
index 00000000..347c9340
--- /dev/null
+++ b/src/Framework/Display/ValueObjectRegistry/DefaultValueObjectFormatterRegistry.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectRegistry;
+
+use App\Framework\Display\ValueObjectFormatters\ByteFormatter;
+use App\Framework\Display\ValueObjectFormatters\ClassNameFormatter;
+use App\Framework\Display\ValueObjectFormatters\EmailFormatter;
+use App\Framework\Display\ValueObjectFormatters\FilePathFormatter;
+use App\Framework\Display\ValueObjectFormatters\TimestampFormatter;
+
+/**
+ * Factory for creating default Value Object formatter registry with all built-in formatters
+ */
+final readonly class DefaultValueObjectFormatterRegistry
+{
+    public static function create(): ValueObjectFormatterRegistry
+    {
+        $registry = new ValueObjectFormatterRegistry();
+        $registry->registerAll([
+            new ClassNameFormatter(),
+            new FilePathFormatter(),
+            new ByteFormatter(),
+            new TimestampFormatter(),
+            new EmailFormatter(),
+        ]);
+
+        return $registry;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjectRegistry/ValueObjectFormatterRegistry.php b/src/Framework/Display/ValueObjectRegistry/ValueObjectFormatterRegistry.php
new file mode 100644
index 00000000..a8547d69
--- /dev/null
+++ b/src/Framework/Display/ValueObjectRegistry/ValueObjectFormatterRegistry.php
@@ -0,0 +1,99 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjectRegistry;
+
+use App\Framework\Display\ValueObjectFormatters\ValueObjectFormatterInterface;
+use App\Framework\Display\ValueObjects\DisplayOptions;
+
+/**
+ * Registry for Value Object formatters with priority-based matching
+ */
+final class ValueObjectFormatterRegistry
+{
+    /**
+     * @var array<ValueObjectFormatterInterface>
+     */
+    private array $formatters = [];
+
+    /**
+     * Register a Value Object formatter
+     * Formatters are checked in registration order (first match wins)
+     */
+    public function register(ValueObjectFormatterInterface $formatter): void
+    {
+        $this->formatters[] = $formatter;
+    }
+
+    /**
+     * Register multiple formatters at once
+     *
+     * @param array<ValueObjectFormatterInterface> $formatters
+     */
+    public function registerAll(array $formatters): void
+    {
+        foreach ($formatters as $formatter) {
+            $this->register($formatter);
+        }
+    }
+
+    /**
+     * Find a formatter that supports the given Value Object
+     */
+    public function findFormatter(object $valueObject): ?ValueObjectFormatterInterface
+    {
+        foreach ($this->formatters as $formatter) {
+            if ($formatter->supports($valueObject)) {
+                return $formatter;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Format Value Object using registered formatters or fallback to string representation
+     */
+    public function format(object $valueObject, DisplayOptions $options, bool $forHtml = false): string
+    {
+        $formatter = $this->findFormatter($valueObject);
+
+        if ($formatter !== null) {
+            return $forHtml
+                ? $formatter->formatHtml($valueObject, $options)
+                : $formatter->formatConsole($valueObject, $options);
+        }
+
+        // Fallback to string representation
+        if ($valueObject instanceof \Stringable) {
+            return (string) $valueObject;
+        }
+
+        if (method_exists($valueObject, 'toString')) {
+            return $valueObject->toString();
+        }
+
+        // Last resort: class name
+        return get_class($valueObject);
+    }
+
+    /**
+     * Get all registered formatters
+     *
+     * @return array<ValueObjectFormatterInterface>
+     */
+    public function getAllFormatters(): array
+    {
+        return $this->formatters;
+    }
+
+    /**
+     * Clear all registered formatters
+     */
+    public function clear(): void
+    {
+        $this->formatters = [];
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/ArrayStructure.php b/src/Framework/Display/ValueObjects/ArrayStructure.php
new file mode 100644
index 00000000..c26192ea
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/ArrayStructure.php
@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Normalized array representation for display
+ */
+final readonly class ArrayStructure
+{
+    /**
+     * @param array<string|int, mixed> $items
+     * @param array<string|int, ArrayStructure> $nestedArrays
+     */
+    public function __construct(
+        public array $items,
+        public bool $isAssociative,
+        public int $depth,
+        public int $count,
+        public array $keys,
+        public array $valueTypes,
+        public array $nestedArrays = [],
+        public array $statistics = [],
+        public bool $isCircularReference = false,
+        public bool $isNested = false,
+        public bool $isSummary = false,
+        public array $summaryInfo = [],
+        public ?int $truncatedCount = null,
+    ) {
+    }
+
+    public static function fromArray(array $data, int $maxDepth = 10, int $currentDepth = 0): self
+    {
+        if (empty($data)) {
+            return new self(
+                items: [],
+                isAssociative: false,
+                depth: 0,
+                count: 0,
+                keys: [],
+                valueTypes: [],
+                nestedArrays: [],
+                statistics: [],
+                isCircularReference: false,
+                isNested: $currentDepth > 0,
+                isSummary: false,
+                summaryInfo: [],
+                truncatedCount: null,
+            );
+        }
+
+        $keys = array_keys($data);
+        $isAssociative = ! self::isIndexed($keys);
+        $count = count($data);
+        $valueTypes = [];
+        $nestedArrays = [];
+        $items = [];
+
+        foreach ($data as $key => $value) {
+            $valueType = get_debug_type($value);
+            $valueTypes[$key] = $valueType;
+
+            if (is_array($value) && $currentDepth < $maxDepth) {
+                $nestedArrays[$key] = self::fromArray($value, $maxDepth, $currentDepth + 1);
+                $items[$key] = '[array:' . count($value) . ']';
+            } else {
+                $items[$key] = $value;
+            }
+        }
+
+        $depth = $currentDepth;
+        if (! empty($nestedArrays)) {
+            $maxNestedDepth = max(array_map(
+                fn (ArrayStructure $nested) => $nested->depth,
+                $nestedArrays
+            ));
+            $depth = max($depth, $maxNestedDepth);
+        }
+
+        $statistics = [
+            'total_items' => $count,
+            'associative' => $isAssociative ? 1 : 0,
+            'indexed' => $isAssociative ? 0 : 1,
+            'nested_count' => count($nestedArrays),
+            'unique_types' => count(array_unique($valueTypes)),
+        ];
+
+        return new self(
+            items: $items,
+            isAssociative: $isAssociative,
+            depth: $depth,
+            count: $count,
+            keys: $keys,
+            valueTypes: $valueTypes,
+            nestedArrays: $nestedArrays,
+            statistics: $statistics,
+            isCircularReference: false,
+            isNested: $currentDepth > 0,
+            isSummary: false,
+            summaryInfo: [],
+            truncatedCount: null,
+        );
+    }
+
+    private static function isIndexed(array $keys): bool
+    {
+        if (empty($keys)) {
+            return true;
+        }
+
+        $expected = 0;
+        foreach ($keys as $key) {
+            if (! is_int($key) || $key !== $expected) {
+                return false;
+            }
+            $expected++;
+        }
+
+        return true;
+    }
+
+    public function hasNestedArrays(): bool
+    {
+        return ! empty($this->nestedArrays);
+    }
+
+    public function isEmpty(): bool
+    {
+        return $this->count === 0;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/BracketStyle.php b/src/Framework/Display/ValueObjects/BracketStyle.php
new file mode 100644
index 00000000..e3e16d78
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/BracketStyle.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Enum for bracket styles in display output
+ */
+enum BracketStyle: string
+{
+    case CURLY = 'curly';
+    case SQUARE = 'square';
+    case NONE = 'none';
+
+    /**
+     * Get opening bracket character
+     */
+    public function getOpen(): string
+    {
+        return match ($this) {
+            self::SQUARE => '[',
+            self::NONE => '',
+            default => '{',
+        };
+    }
+
+    /**
+     * Get closing bracket character
+     */
+    public function getClose(): string
+    {
+        return match ($this) {
+            self::SQUARE => ']',
+            self::NONE => '',
+            default => '}',
+        };
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/ClassStructure.php b/src/Framework/Display/ValueObjects/ClassStructure.php
new file mode 100644
index 00000000..b900e453
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/ClassStructure.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Normalized class representation for display
+ */
+final readonly class ClassStructure
+{
+    /**
+     * @param array<MethodInfo> $methods
+     * @param array<PropertyInfo> $properties
+     * @param array<ConstantInfo> $constants
+     * @param array<string> $interfaces
+     * @param array<string> $attributes
+     */
+    public function __construct(
+        public string $className,
+        public string $namespace,
+        public ?string $parentClass,
+        public array $methods,
+        public array $properties,
+        public array $constants,
+        public array $interfaces,
+        public array $attributes,
+        public bool $isFinal,
+        public bool $isAbstract,
+        public bool $isReadonly,
+        public bool $isInterface,
+        public bool $isTrait,
+        public bool $isEnum,
+        public array $metadata = [],
+    ) {
+    }
+
+    public function getMethodCount(): int
+    {
+        return count($this->methods);
+    }
+
+    public function getPropertyCount(): int
+    {
+        return count($this->properties);
+    }
+
+    public function getConstantCount(): int
+    {
+        return count($this->constants);
+    }
+
+    public function getFullName(): string
+    {
+        return $this->namespace !== '' ? $this->namespace . '\\' . $this->className : $this->className;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/ColorDepth.php b/src/Framework/Display/ValueObjects/ColorDepth.php
new file mode 100644
index 00000000..41df7881
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/ColorDepth.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Enum for color depth in display output
+ */
+enum ColorDepth: string
+{
+    case NONE = 'none';
+    case BASIC = 'basic';
+    case FULL = 'full';
+}
+
diff --git a/src/Framework/Display/ValueObjects/ConstantInfo.php b/src/Framework/Display/ValueObjects/ConstantInfo.php
new file mode 100644
index 00000000..2a1a0ab5
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/ConstantInfo.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Information about a class constant
+ */
+final readonly class ConstantInfo
+{
+    public function __construct(
+        public string $name,
+        public mixed $value,
+        public string $type,
+        public int $visibility,
+        public bool $isFinal,
+    ) {
+    }
+
+    public function isPublic(): bool
+    {
+        return ($this->visibility & \ReflectionClassConstant::IS_PUBLIC) !== 0;
+    }
+
+    public function isProtected(): bool
+    {
+        return ($this->visibility & \ReflectionClassConstant::IS_PROTECTED) !== 0;
+    }
+
+    public function isPrivate(): bool
+    {
+        return ($this->visibility & \ReflectionClassConstant::IS_PRIVATE) !== 0;
+    }
+
+    public function getVisibilityString(): string
+    {
+        if ($this->isPublic()) {
+            return 'public';
+        }
+        if ($this->isProtected()) {
+            return 'protected';
+        }
+        if ($this->isPrivate()) {
+            return 'private';
+        }
+
+        return 'unknown';
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/DirectoryStructure.php b/src/Framework/Display/ValueObjects/DirectoryStructure.php
new file mode 100644
index 00000000..6499103f
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/DirectoryStructure.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * Normalized filesystem directory representation for display
+ */
+final readonly class DirectoryStructure
+{
+    /**
+     * @param array<FileEntry> $files
+     * @param array<string, DirectoryStructure> $directories
+     */
+    public function __construct(
+        public FilePath|string $path,
+        public array $files,
+        public array $directories,
+        public int $depth,
+        public int $totalFiles,
+        public int $totalDirectories,
+        public array $statistics = [],
+    ) {
+    }
+
+    public function getPathString(): string
+    {
+        return $this->path instanceof FilePath ? $this->path->toString() : $this->path;
+    }
+
+    public function isEmpty(): bool
+    {
+        return empty($this->files) && empty($this->directories);
+    }
+
+    public function hasNestedDirectories(): bool
+    {
+        return ! empty($this->directories);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/DisplayOptions.php b/src/Framework/Display/ValueObjects/DisplayOptions.php
new file mode 100644
index 00000000..071aa7a0
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/DisplayOptions.php
@@ -0,0 +1,357 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+use App\Framework\Display\Themes\ConsoleTheme;
+use App\Framework\Display\Themes\HtmlTheme;
+use InvalidArgumentException;
+
+/**
+ * Configuration options for displaying data structures.
+ *
+ * This Value Object holds all configuration options that control how data
+ * is analyzed and rendered. Use the factory methods or fluent interface
+ * to create configured instances.
+ *
+ * @see DisplayRules For filtering and performance rules
+ */
+final readonly class DisplayOptions
+{
+    public function __construct(
+        public int $maxDepth = 10,
+        public string $colorScheme = 'default',
+        public string $theme = 'default',
+        public string|ConsoleTheme|HtmlTheme|null $customTheme = null,
+        public string $formatStyle = 'tree',
+        public bool $showPrivateProperties = false,
+        public bool $showFileSizes = true,
+        public bool $showFilePermissions = false,
+        public bool $showMetadata = true,
+        public bool $prettyPrint = true,
+        public int $indentSize = 2,
+        public IndentStyle $indentStyle = IndentStyle::SPACE,
+        public ?string $customIndent = null,
+        public bool $compactValueObjects = true,
+        public bool $showValueObjectType = true,
+        public SeparatorStyle $separatorStyle = SeparatorStyle::COLON,
+        public ?string $customSeparator = null,
+        public bool $lineWrap = false,
+        public int $maxLineLength = 80,
+        public BracketStyle $bracketStyle = BracketStyle::CURLY,
+        public bool $showTypes = false,
+        public bool $showSizes = false,
+        public ColorDepth $colorDepth = ColorDepth::FULL,
+        public ?DisplayRules $rules = null,
+    ) {
+        if ($this->maxDepth < 0) {
+            throw new InvalidArgumentException('maxDepth must be >= 0');
+        }
+
+        if ($this->indentSize < 1) {
+            throw new InvalidArgumentException('indentSize must be >= 1');
+        }
+
+        if ($this->separatorStyle === SeparatorStyle::CUSTOM && $this->customSeparator === null) {
+            throw new InvalidArgumentException('customSeparator must be set when separatorStyle is CUSTOM');
+        }
+
+        if ($this->indentStyle === IndentStyle::CUSTOM && $this->customIndent === null) {
+            throw new InvalidArgumentException('customIndent must be set when indentStyle is CUSTOM');
+        }
+
+        if ($this->maxLineLength < 1) {
+            throw new InvalidArgumentException('maxLineLength must be >= 1');
+        }
+    }
+
+    /**
+     * Create default display options.
+     *
+     * Defaults:
+     * - maxDepth: 10
+     * - formatStyle: 'tree'
+     * - compactValueObjects: true
+     * - Includes default DisplayRules
+     *
+     * @return self Default options instance
+     */
+    public static function default(): self
+    {
+        return new self(
+            rules: DisplayRules::default(),
+        );
+    }
+
+    /**
+     * Create compact display options.
+     *
+     * Optimized for minimal output:
+     * - maxDepth: 3
+     * - formatStyle: 'flat'
+     * - showMetadata: false
+     * - prettyPrint: false
+     * - showTypes: false
+     * - showSizes: false
+     *
+     * @return self Compact options instance
+     */
+    public static function compact(): self
+    {
+        return new self(
+            maxDepth: 3,
+            formatStyle: 'flat',
+            showMetadata: false,
+            prettyPrint: false,
+            showTypes: false,
+            showSizes: false,
+        );
+    }
+
+    /**
+     * Create verbose display options.
+     *
+     * Shows maximum detail:
+     * - maxDepth: 20
+     * - showPrivateProperties: true
+     * - showFileSizes: true
+     * - showFilePermissions: true
+     * - showMetadata: true
+     * - showTypes: true
+     * - showSizes: true
+     *
+     * @return self Verbose options instance
+     */
+    public static function verbose(): self
+    {
+        return new self(
+            maxDepth: 20,
+            showPrivateProperties: true,
+            showFileSizes: true,
+            showFilePermissions: true,
+            showMetadata: true,
+            showTypes: true,
+            showSizes: true,
+        );
+    }
+
+    /**
+     * Create debug display options.
+     *
+     * Optimized for debugging:
+     * - maxDepth: 20
+     * - showPrivateProperties: true
+     * - showTypes: true
+     * - showSizes: true
+     * - colorDepth: 'full'
+     * - theme: 'colorful'
+     * - showMetadata: true
+     *
+     * @return self Debug options instance
+     */
+    public static function debug(): self
+    {
+        return new self(
+            maxDepth: 20,
+            showPrivateProperties: true,
+            showTypes: true,
+            showSizes: true,
+            colorDepth: ColorDepth::FULL,
+            theme: 'colorful',
+            showMetadata: true,
+        );
+    }
+
+    /**
+     * Create production display options.
+     *
+     * Optimized for production (minimal, no colors):
+     * - maxDepth: 3
+     * - showTypes: false
+     * - showSizes: false
+     * - colorDepth: 'none'
+     * - formatStyle: 'flat'
+     * - prettyPrint: false
+     *
+     * @return self Production options instance
+     */
+    public static function production(): self
+    {
+        return new self(
+            maxDepth: 3,
+            showTypes: false,
+            showSizes: false,
+            colorDepth: ColorDepth::NONE,
+            formatStyle: 'flat',
+            prettyPrint: false,
+        );
+    }
+
+    /**
+     * Create pretty display options.
+     *
+     * Optimized for readability:
+     * - formatStyle: 'tree'
+     * - prettyPrint: true
+     * - indentSize: 4
+     * - lineWrap: true
+     * - maxLineLength: 80
+     *
+     * @return self Pretty options instance
+     */
+    public static function pretty(): self
+    {
+        return new self(
+            formatStyle: 'tree',
+            prettyPrint: true,
+            indentSize: 4,
+            lineWrap: true,
+            maxLineLength: 80,
+        );
+    }
+
+    /**
+     * Create JSON-like formatting options.
+     *
+     * JSON-style formatting:
+     * - formatStyle: 'tree'
+     * - bracketStyle: 'square'
+     * - separatorStyle: 'colon'
+     * - prettyPrint: true
+     *
+     * @return self JSON-like options instance
+     */
+    public static function json(): self
+    {
+        return new self(
+            formatStyle: 'tree',
+            bracketStyle: BracketStyle::SQUARE,
+            separatorStyle: SeparatorStyle::COLON,
+            prettyPrint: true,
+        );
+    }
+
+    /**
+     * Get display rules (creates default if not set).
+     *
+     * @return DisplayRules Active display rules
+     */
+    public function getRules(): DisplayRules
+    {
+        return $this->rules ?? DisplayRules::default();
+    }
+
+    public function withMaxDepth(int $maxDepth): self
+    {
+        return new self(
+            maxDepth: $maxDepth,
+            colorScheme: $this->colorScheme,
+            theme: $this->theme,
+            customTheme: $this->customTheme,
+            formatStyle: $this->formatStyle,
+            showPrivateProperties: $this->showPrivateProperties,
+            showFileSizes: $this->showFileSizes,
+            showFilePermissions: $this->showFilePermissions,
+            showMetadata: $this->showMetadata,
+            prettyPrint: $this->prettyPrint,
+            indentSize: $this->indentSize,
+            indentStyle: $this->indentStyle,
+            customIndent: $this->customIndent,
+            compactValueObjects: $this->compactValueObjects,
+            showValueObjectType: $this->showValueObjectType,
+            separatorStyle: $this->separatorStyle,
+            customSeparator: $this->customSeparator,
+            lineWrap: $this->lineWrap,
+            maxLineLength: $this->maxLineLength,
+            bracketStyle: $this->bracketStyle,
+            showTypes: $this->showTypes,
+            showSizes: $this->showSizes,
+            colorDepth: $this->colorDepth,
+            rules: $this->rules,
+        );
+    }
+
+    public function withCompactValueObjects(bool $compactValueObjects): self
+    {
+        return new self(
+            maxDepth: $this->maxDepth,
+            colorScheme: $this->colorScheme,
+            theme: $this->theme,
+            customTheme: $this->customTheme,
+            formatStyle: $this->formatStyle,
+            showPrivateProperties: $this->showPrivateProperties,
+            showFileSizes: $this->showFileSizes,
+            showFilePermissions: $this->showFilePermissions,
+            showMetadata: $this->showMetadata,
+            prettyPrint: $this->prettyPrint,
+            indentSize: $this->indentSize,
+            indentStyle: $this->indentStyle,
+            customIndent: $this->customIndent,
+            compactValueObjects: $compactValueObjects,
+            showValueObjectType: $this->showValueObjectType,
+            separatorStyle: $this->separatorStyle,
+            customSeparator: $this->customSeparator,
+            lineWrap: $this->lineWrap,
+            maxLineLength: $this->maxLineLength,
+            bracketStyle: $this->bracketStyle,
+            showTypes: $this->showTypes,
+            showSizes: $this->showSizes,
+            colorDepth: $this->colorDepth,
+            rules: $this->rules,
+        );
+    }
+
+    /**
+     * Create a new instance with different display rules.
+     *
+     * @param DisplayRules $rules Display rules to use
+     * @return self New instance with updated rules
+     */
+    public function withRules(DisplayRules $rules): self
+    {
+        return new self(
+            maxDepth: $this->maxDepth,
+            colorScheme: $this->colorScheme,
+            theme: $this->theme,
+            customTheme: $this->customTheme,
+            formatStyle: $this->formatStyle,
+            showPrivateProperties: $this->showPrivateProperties,
+            showFileSizes: $this->showFileSizes,
+            showFilePermissions: $this->showFilePermissions,
+            showMetadata: $this->showMetadata,
+            prettyPrint: $this->prettyPrint,
+            indentSize: $this->indentSize,
+            indentStyle: $this->indentStyle,
+            customIndent: $this->customIndent,
+            compactValueObjects: $this->compactValueObjects,
+            showValueObjectType: $this->showValueObjectType,
+            separatorStyle: $this->separatorStyle,
+            customSeparator: $this->customSeparator,
+            lineWrap: $this->lineWrap,
+            maxLineLength: $this->maxLineLength,
+            bracketStyle: $this->bracketStyle,
+            showTypes: $this->showTypes,
+            showSizes: $this->showSizes,
+            colorDepth: $this->colorDepth,
+            rules: $rules,
+        );
+    }
+
+    /**
+     * Get the separator string based on separatorStyle
+     */
+    public function getSeparator(): string
+    {
+        return $this->separatorStyle->getSeparator($this->customSeparator);
+    }
+
+    /**
+     * Get the indentation string based on indentStyle
+     */
+    public function getIndentString(): string
+    {
+        return $this->indentStyle->getIndentString($this->indentSize, $this->customIndent);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/DisplayRules.php b/src/Framework/Display/ValueObjects/DisplayRules.php
new file mode 100644
index 00000000..8c001546
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/DisplayRules.php
@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Rules for filtering and displaying data structures.
+ *
+ * Controls performance optimizations and filtering behavior:
+ * - Blacklist: Classes that should never be displayed
+ * - Summary thresholds: When to show summaries instead of full content
+ * - Collection detection: Enable/disable collection detection
+ * - Truncation: Maximum items before truncation
+ *
+ * @see DisplayOptions For general display configuration
+ */
+final readonly class DisplayRules
+{
+    /**
+     * @param array<string> $blacklistedClasses Classes that should never be displayed
+     * @param int $maxArraySizeForSummary Threshold for root arrays to show summary instead of full content
+     * @param int $maxArraySizeForSummaryNested Threshold for nested arrays to show summary
+     * @param int $maxObjectPropertiesForSummary Threshold for root objects to show summary
+     * @param int $maxObjectPropertiesForSummaryNested Threshold for nested objects to show summary
+     * @param int $maxItems Max items to show before truncation
+     * @param bool $collectionDetection Enable collection detection
+     * @param bool $compactNestedObjects More compact display for nested objects
+     */
+    public function __construct(
+        public array $blacklistedClasses = [],
+        public int $maxArraySizeForSummary = 1000,
+        public int $maxArraySizeForSummaryNested = 100,
+        public int $maxObjectPropertiesForSummary = 50,
+        public int $maxObjectPropertiesForSummaryNested = 20,
+        public int $maxItems = 100,
+        public bool $collectionDetection = true,
+        public bool $compactNestedObjects = true,
+    ) {
+    }
+
+    /**
+     * Create default display rules.
+     *
+     * Defaults:
+     * - Blacklists: DefaultContainer, DiscoveryRegistry
+     * - Array summary threshold: 1000 (root), 100 (nested)
+     * - Object summary threshold: 50 (root), 20 (nested)
+     * - Max items: 100
+     * - Collection detection: enabled
+     * - Compact nested objects: enabled
+     *
+     * @return self Default rules instance
+     */
+    public static function default(): self
+    {
+        return new self(
+            blacklistedClasses: [
+                'App\\Framework\\DI\\DefaultContainer',
+                'App\\Framework\\Discovery\\DiscoveryRegistry',
+            ],
+            maxArraySizeForSummary: 1000,
+            maxArraySizeForSummaryNested: 100,
+            maxObjectPropertiesForSummary: 50,
+            maxObjectPropertiesForSummaryNested: 20,
+            maxItems: 100,
+            collectionDetection: true,
+            compactNestedObjects: true,
+        );
+    }
+
+    public function withBlacklistedClasses(array $blacklistedClasses): self
+    {
+        return new self(
+            blacklistedClasses: $blacklistedClasses,
+            maxArraySizeForSummary: $this->maxArraySizeForSummary,
+            maxArraySizeForSummaryNested: $this->maxArraySizeForSummaryNested,
+            maxObjectPropertiesForSummary: $this->maxObjectPropertiesForSummary,
+            maxObjectPropertiesForSummaryNested: $this->maxObjectPropertiesForSummaryNested,
+            maxItems: $this->maxItems,
+            collectionDetection: $this->collectionDetection,
+            compactNestedObjects: $this->compactNestedObjects,
+        );
+    }
+
+    public function withMaxArraySizeForSummary(int $maxArraySizeForSummary): self
+    {
+        return new self(
+            blacklistedClasses: $this->blacklistedClasses,
+            maxArraySizeForSummary: $maxArraySizeForSummary,
+            maxArraySizeForSummaryNested: $this->maxArraySizeForSummaryNested,
+            maxObjectPropertiesForSummary: $this->maxObjectPropertiesForSummary,
+            maxObjectPropertiesForSummaryNested: $this->maxObjectPropertiesForSummaryNested,
+            maxItems: $this->maxItems,
+            collectionDetection: $this->collectionDetection,
+            compactNestedObjects: $this->compactNestedObjects,
+        );
+    }
+
+    /**
+     * Check if a class is blacklisted.
+     *
+     * Blacklisted classes are never fully displayed and instead show
+     * a summary or "[blacklisted]" marker.
+     *
+     * @param string $className Fully qualified class name
+     * @return bool True if class is blacklisted
+     */
+    public function isBlacklisted(string $className): bool
+    {
+        return in_array($className, $this->blacklistedClasses, true);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/FileEntry.php b/src/Framework/Display/ValueObjects/FileEntry.php
new file mode 100644
index 00000000..704bbd86
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/FileEntry.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * File entry in a directory structure
+ */
+final readonly class FileEntry
+{
+    public function __construct(
+        public FilePath|string $path,
+        public string $name,
+        public int $size,
+        public int $lastModified,
+        public string $extension,
+        public bool $isReadable,
+        public bool $isWritable,
+    ) {
+    }
+
+    public function getPathString(): string
+    {
+        return $this->path instanceof FilePath ? $this->path->toString() : $this->path;
+    }
+
+    public function getFormattedSize(): string
+    {
+        $units = ['B', 'KB', 'MB', 'GB'];
+        $size = $this->size;
+        $unitIndex = 0;
+
+        while ($size >= 1024 && $unitIndex < count($units) - 1) {
+            $size /= 1024;
+            $unitIndex++;
+        }
+
+        return round($size, 2) . ' ' . $units[$unitIndex];
+    }
+
+    public function getFormattedTime(): string
+    {
+        return date('Y-m-d H:i:s', $this->lastModified);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/IndentStyle.php b/src/Framework/Display/ValueObjects/IndentStyle.php
new file mode 100644
index 00000000..32e4e0bd
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/IndentStyle.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Enum for indentation styles in display output
+ */
+enum IndentStyle: string
+{
+    case SPACE = 'space';
+    case TAB = 'tab';
+    case CUSTOM = 'custom';
+
+    /**
+     * Get the indentation string for this style
+     */
+    public function getIndentString(int $indentSize, ?string $customIndent = null): string
+    {
+        if ($this === self::CUSTOM && $customIndent !== null) {
+            return $customIndent;
+        }
+
+        return match ($this) {
+            self::TAB => "\t",
+            default => str_repeat(' ', $indentSize),
+        };
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/MethodInfo.php b/src/Framework/Display/ValueObjects/MethodInfo.php
new file mode 100644
index 00000000..aa4144b3
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/MethodInfo.php
@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Information about a class method
+ */
+final readonly class MethodInfo
+{
+    /**
+     * @param array<string> $parameters
+     * @param array<string> $attributes
+     */
+    public function __construct(
+        public string $name,
+        public int $visibility,
+        public string $returnType,
+        public array $parameters,
+        public bool $isStatic,
+        public bool $isAbstract,
+        public bool $isFinal,
+        public array $attributes = [],
+    ) {
+    }
+
+    public function isPublic(): bool
+    {
+        return ($this->visibility & \ReflectionMethod::IS_PUBLIC) !== 0;
+    }
+
+    public function isProtected(): bool
+    {
+        return ($this->visibility & \ReflectionMethod::IS_PROTECTED) !== 0;
+    }
+
+    public function isPrivate(): bool
+    {
+        return ($this->visibility & \ReflectionMethod::IS_PRIVATE) !== 0;
+    }
+
+    public function getVisibilityString(): string
+    {
+        if ($this->isPublic()) {
+            return 'public';
+        }
+        if ($this->isProtected()) {
+            return 'protected';
+        }
+        if ($this->isPrivate()) {
+            return 'private';
+        }
+
+        return 'unknown';
+    }
+
+    public function getSignature(): string
+    {
+        $params = implode(', ', $this->parameters);
+        $static = $this->isStatic ? 'static ' : '';
+        $visibility = $this->getVisibilityString();
+        $return = $this->returnType !== '' ? ': ' . $this->returnType : '';
+
+        return $static . $visibility . ' function ' . $this->name . '(' . $params . ')' . $return;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/ObjectStructure.php b/src/Framework/Display/ValueObjects/ObjectStructure.php
new file mode 100644
index 00000000..dc124b8d
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/ObjectStructure.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Normalized object representation for display
+ */
+final readonly class ObjectStructure
+{
+    /**
+     * @param array<string, PropertyInfo> $properties
+     * @param array<string, ObjectStructure> $nestedObjects
+     */
+    public function __construct(
+        public string $className,
+        public array $properties,
+        public array $nestedObjects = [],
+        public int $depth = 0,
+        public array $metadata = [],
+        public bool $isCircularReference = false,
+        public bool $isNested = false,
+        public bool $isCollection = false,
+        public ?int $collectionCount = null,
+        public ?string $collectionItemType = null,
+        public bool $isSummary = false,
+        public array $summaryInfo = [],
+    ) {
+    }
+
+    public function hasNestedObjects(): bool
+    {
+        return ! empty($this->nestedObjects);
+    }
+
+    public function getPropertyCount(): int
+    {
+        return count($this->properties);
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/OutputFormat.php b/src/Framework/Display/ValueObjects/OutputFormat.php
new file mode 100644
index 00000000..3359e4e1
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/OutputFormat.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Output format enum for displaying data structures
+ */
+enum OutputFormat: string
+{
+    case CONSOLE = 'console';
+    case HTML = 'html';
+
+    public function isConsole(): bool
+    {
+        return $this === self::CONSOLE;
+    }
+
+    public function isHtml(): bool
+    {
+        return $this === self::HTML;
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/PropertyInfo.php b/src/Framework/Display/ValueObjects/PropertyInfo.php
new file mode 100644
index 00000000..34daf704
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/PropertyInfo.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Information about an object property
+ */
+final readonly class PropertyInfo
+{
+    public function __construct(
+        public string $name,
+        public string $type,
+        public mixed $value,
+        public int $visibility,
+        public bool $isReadonly,
+        public bool $isStatic,
+        public bool $isNullable,
+        public ?string $declaringClass = null,
+        public bool $isValueObject = false,
+    ) {
+    }
+
+    public function isPublic(): bool
+    {
+        return ($this->visibility & \ReflectionProperty::IS_PUBLIC) !== 0;
+    }
+
+    public function isProtected(): bool
+    {
+        return ($this->visibility & \ReflectionProperty::IS_PROTECTED) !== 0;
+    }
+
+    public function isPrivate(): bool
+    {
+        return ($this->visibility & \ReflectionProperty::IS_PRIVATE) !== 0;
+    }
+
+    public function getVisibilityString(): string
+    {
+        if ($this->isPublic()) {
+            return 'public';
+        }
+        if ($this->isProtected()) {
+            return 'protected';
+        }
+        if ($this->isPrivate()) {
+            return 'private';
+        }
+
+        return 'unknown';
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/RenderContext.php b/src/Framework/Display/ValueObjects/RenderContext.php
new file mode 100644
index 00000000..f2cd8f50
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/RenderContext.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Context for rendering operations
+ */
+final readonly class RenderContext
+{
+    public function __construct(
+        public OutputFormat $outputFormat,
+        public DisplayOptions $options,
+        public array $stylingPreferences = [],
+        public array $environment = [],
+    ) {
+    }
+
+    public static function console(DisplayOptions $options): self
+    {
+        return new self(
+            outputFormat: OutputFormat::CONSOLE,
+            options: $options,
+        );
+    }
+
+    public static function html(DisplayOptions $options): self
+    {
+        return new self(
+            outputFormat: OutputFormat::HTML,
+            options: $options,
+        );
+    }
+}
+
diff --git a/src/Framework/Display/ValueObjects/SeparatorStyle.php b/src/Framework/Display/ValueObjects/SeparatorStyle.php
new file mode 100644
index 00000000..b9ca9701
--- /dev/null
+++ b/src/Framework/Display/ValueObjects/SeparatorStyle.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Display\ValueObjects;
+
+/**
+ * Enum for separator styles in display output
+ */
+enum SeparatorStyle: string
+{
+    case COLON = 'colon';
+    case ARROW = 'arrow';
+    case EQUALS = 'equals';
+    case CUSTOM = 'custom';
+
+    /**
+     * Get the separator string for this style
+     */
+    public function getSeparator(?string $customSeparator = null): string
+    {
+        if ($this === self::CUSTOM && $customSeparator !== null) {
+            return $customSeparator;
+        }
+
+        return match ($this) {
+            self::ARROW => ' => ',
+            self::EQUALS => ' = ',
+            default => ': ',
+        };
+    }
+}
+
diff --git a/src/Framework/ErrorAggregation/NullErrorAggregator.php b/src/Framework/ErrorAggregation/NullErrorAggregator.php
index 6158e2c8..581baf1d 100644
--- a/src/Framework/ErrorAggregation/NullErrorAggregator.php
+++ b/src/Framework/ErrorAggregation/NullErrorAggregator.php
@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace App\Framework\ErrorAggregation;
 
-use App\Framework\Exception\ErrorHandlerContext;
 use App\Framework\Exception\Core\ErrorSeverity;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
 
 /**
  * Null Object implementation for ErrorAggregator
@@ -15,7 +15,7 @@ use App\Framework\Exception\Core\ErrorSeverity;
  */
 final readonly class NullErrorAggregator implements ErrorAggregatorInterface
 {
-    public function processError(ErrorHandlerContext $context): void
+    public function processError(\Throwable $exception, ExceptionContextProvider $contextProvider, bool $isDebug = false): void
     {
         // No-op: Error aggregation is disabled
     }
diff --git a/src/Framework/ErrorBoundaries/BoundaryFailedException.php b/src/Framework/ErrorBoundaries/BoundaryFailedException.php
index e81e561a..70c207a3 100644
--- a/src/Framework/ErrorBoundaries/BoundaryFailedException.php
+++ b/src/Framework/ErrorBoundaries/BoundaryFailedException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\ErrorBoundaries;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 use Throwable;
 
@@ -21,18 +20,7 @@ final class BoundaryFailedException extends FrameworkException
         int $code = 0,
         ?Throwable $previous = null
     ) {
-        parent::__construct(
-            message: $message,
-            context: ExceptionContext::forOperation('error_boundary_failure', 'ErrorBoundary')
-                ->withData([
-                    'boundary_name' => $boundaryName,
-                    'double_failure' => $originalException !== null && $fallbackException !== null,
-                    'original_error' => $originalException?->getMessage(),
-                    'fallback_error' => $fallbackException?->getMessage(),
-                ]),
-            code: $code,
-            previous: $previous
-        );
+        parent::__construct($message, $code, $previous);
     }
 
     /**
diff --git a/src/Framework/ErrorBoundaries/BoundaryTimeoutException.php b/src/Framework/ErrorBoundaries/BoundaryTimeoutException.php
index 51aa8ab6..f110b57f 100644
--- a/src/Framework/ErrorBoundaries/BoundaryTimeoutException.php
+++ b/src/Framework/ErrorBoundaries/BoundaryTimeoutException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\ErrorBoundaries;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -19,18 +18,7 @@ final class BoundaryTimeoutException extends FrameworkException
         private readonly float $timeoutLimit = 0.0,
         int $code = 0
     ) {
-        parent::__construct(
-            message: $message,
-            context: ExceptionContext::forOperation('error_boundary_timeout', 'ErrorBoundary')
-                ->withData([
-                    'boundary_name' => $boundaryName,
-                    'execution_time' => $executionTime,
-                    'timeout_limit' => $timeoutLimit,
-                    'overage' => max(0.0, $executionTime - $timeoutLimit),
-                    'hard_timeout' => $timeoutLimit > 0.0 && $executionTime > $timeoutLimit,
-                ]),
-            code: $code
-        );
+        parent::__construct($message, $code);
     }
 
     /**
diff --git a/src/Framework/ErrorHandling/CliErrorHandler.php b/src/Framework/ErrorHandling/CliErrorHandler.php
deleted file mode 100644
index 69610b1f..00000000
--- a/src/Framework/ErrorHandling/CliErrorHandler.php
+++ /dev/null
@@ -1,100 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Console\ConsoleColor;
-use App\Framework\Console\ConsoleOutput;
-
-/**
- * CLI-spezifischer Error Handler für Worker und Console
- */
-final readonly class CliErrorHandler
-{
-    public function __construct(
-        private ?ConsoleOutput $output = null
-    ) {
-    }
-
-    public function register(): void
-    {
-        set_error_handler([$this, 'handleError']);
-        set_exception_handler([$this, 'handleException']);
-        register_shutdown_function([$this, 'handleShutdown']);
-    }
-
-    public function handleError(int $severity, string $message, string $file, int $line): bool
-    {
-        if (! (error_reporting() & $severity)) {
-            return false;
-        }
-
-        $errorType = $this->getErrorType($severity);
-        $color = $this->getErrorColor($severity);
-
-        $output = $this->output ?? new ConsoleOutput();
-        $output->writeLine("[$errorType] $message", $color);
-        $output->writeLine("  in $file:$line", ConsoleColor::GRAY);
-
-        if (in_array($severity, [E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
-            exit(1);
-        }
-
-        return true;
-    }
-
-    public function handleException(\Throwable $exception): void
-    {
-        $output = $this->output ?? new ConsoleOutput();
-
-        $output->writeLine("❌ Uncaught " . get_class($exception) . ": " . $exception->getMessage(), ConsoleColor::BRIGHT_RED);
-        $output->writeLine("   File: " . $exception->getFile() . ":" . $exception->getLine(), ConsoleColor::RED);
-
-        if ($exception->getPrevious()) {
-            $output->writeLine("   Caused by: " . $exception->getPrevious()->getMessage(), ConsoleColor::YELLOW);
-        }
-
-        $output->writeLine("   Stack trace:", ConsoleColor::GRAY);
-        foreach (explode("\n", $exception->getTraceAsString()) as $line) {
-            $output->writeLine("     " . $line, ConsoleColor::GRAY);
-        }
-
-        exit(1);
-    }
-
-    public function handleShutdown(): void
-    {
-        $error = error_get_last();
-
-        if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
-            $output = $this->output ?? new ConsoleOutput();
-            $output->writeLine("💥 Fatal Error: " . $error['message'], ConsoleColor::BRIGHT_RED);
-            $output->writeLine("   File: " . $error['file'] . ":" . $error['line'], ConsoleColor::RED);
-        }
-    }
-
-    private function getErrorType(int $severity): string
-    {
-        return match ($severity) {
-            E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR => 'ERROR',
-            E_WARNING, E_CORE_WARNING, E_COMPILE_WARNING, E_USER_WARNING => 'WARNING',
-            E_NOTICE, E_USER_NOTICE => 'NOTICE',
-            E_STRICT => 'STRICT',
-            E_RECOVERABLE_ERROR => 'RECOVERABLE_ERROR',
-            E_DEPRECATED, E_USER_DEPRECATED => 'DEPRECATED',
-            default => 'UNKNOWN'
-        };
-    }
-
-    private function getErrorColor(int $severity): ConsoleColor
-    {
-        return match ($severity) {
-            E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR => ConsoleColor::BRIGHT_RED,
-            E_WARNING, E_CORE_WARNING, E_COMPILE_WARNING, E_USER_WARNING => ConsoleColor::YELLOW,
-            E_NOTICE, E_USER_NOTICE => ConsoleColor::CYAN,
-            E_DEPRECATED, E_USER_DEPRECATED => ConsoleColor::MAGENTA,
-            default => ConsoleColor::WHITE
-        };
-    }
-}
diff --git a/src/Framework/ErrorHandling/DummyTemplateRenderer.php b/src/Framework/ErrorHandling/DummyTemplateRenderer.php
deleted file mode 100644
index 504ce6db..00000000
--- a/src/Framework/ErrorHandling/DummyTemplateRenderer.php
+++ /dev/null
@@ -1,27 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\View\RenderContext;
-use App\Framework\View\TemplateRenderer;
-
-/**
- * Dummy-Implementierung des TemplateRenderer als Fallback
- */
-final class DummyTemplateRenderer implements TemplateRenderer
-{
-    public function render(RenderContext $context): string
-    {
-        // Dieser Renderer gibt immer einen leeren String zurück,
-        // da er nur als Fallback dient und der ErrorTemplateRenderer
-        // seine eigene Fallback-Methode hat
-        return '';
-    }
-
-    public function renderPartial(RenderContext $context): string
-    {
-        return '';
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorHandler.php b/src/Framework/ErrorHandling/ErrorHandler.php
deleted file mode 100644
index b0db5a61..00000000
--- a/src/Framework/ErrorHandling/ErrorHandler.php
+++ /dev/null
@@ -1,509 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Config\Environment;
-use App\Framework\Config\EnvKey;
-use App\Framework\DI\Container;
-use App\Framework\ErrorAggregation\ErrorAggregatorInterface;
-use App\Framework\ErrorHandling\ValueObjects\ErrorMetadata;
-use App\Framework\ErrorHandling\View\ApiErrorRenderer;
-use App\Framework\ErrorHandling\View\ErrorResponseFactory;
-use App\Framework\ErrorHandling\View\ErrorTemplateRenderer;
-use App\Framework\ErrorReporting\ErrorReporterInterface;
-use App\Framework\Exception\Core\ErrorSeverity;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SecurityException;
-use App\Framework\Exception\SecurityLogLevel;
-use App\Framework\Exception\SystemContext;
-use App\Framework\Http\MiddlewareContext;
-use App\Framework\Http\RequestIdGenerator;
-use App\Framework\Http\Response;
-use App\Framework\Http\ResponseEmitter;
-use App\Framework\Http\Responses\RedirectResponse;
-use App\Framework\Logging\Logger;
-use App\Framework\Performance\MemoryMonitor;
-use App\Framework\Validation\Exceptions\ValidationException;
-use App\Framework\Validation\ValidationFormHandler;
-use App\Framework\View\TemplateRenderer;
-use Throwable;
-
-final readonly class ErrorHandler
-{
-    private ErrorLogger $logger;
-
-    private SecurityEventHandler $securityHandler;
-
-    private bool $isDebugMode;
-
-    public function __construct(
-        private ResponseEmitter          $emitter,
-        private Container                $container,
-        private RequestIdGenerator       $requestIdGenerator,
-        private ErrorAggregatorInterface $errorAggregator,
-        private ErrorReporterInterface   $errorReporter,
-        private ErrorHandlerManager      $handlerManager,
-        ?Logger                          $logger = null,
-        ?bool                            $isDebugMode = null,
-        ?SecurityEventHandler            $securityHandler = null
-    ) {
-        $this->isDebugMode = $isDebugMode ?? $this->getDebugModeFromEnvironment();
-
-        // Get Logger and AppConfig from container if not provided
-        $logger = $logger ?? $container->get(Logger::class);
-        $appConfig = $container->get(\App\Framework\Config\AppConfig::class);
-
-        $this->logger = new ErrorLogger($logger, $appConfig);
-        $this->securityHandler = $securityHandler ?? SecurityEventHandler::createDefault($logger);
-    }
-
-    public function register(): void
-    {
-        set_exception_handler($this->handleException(...));
-        set_error_handler($this->handleError(...));
-    }
-
-    public function createHttpResponse(\Throwable $e, ?MiddlewareContext $context = null): Response
-    {
-        // Try specialized handlers first
-        $handlingResult = $this->handlerManager->handle($e);
-
-        if ($handlingResult->handled) {
-            // Handler chain processed the exception
-            $firstResult = $handlingResult->getFirstResult();
-
-            if ($firstResult !== null) {
-                return $this->createResponseFromHandlerResult($firstResult, $e);
-            }
-        }
-
-        // Fallback to legacy error handling
-        return $this->createLegacyHttpResponse($e, $context);
-    }
-
-    private function createResponseFromHandlerResult(
-        Handlers\HandlerResult $result,
-        \Throwable $exception
-    ): Response {
-        $statusCode = $result->statusCode ?? 500;
-
-        $responseFactory = $this->createResponseFactory();
-        $isApiRequest = $responseFactory->isApiRequest();
-
-        if ($isApiRequest) {
-            return new \App\Framework\Http\Responses\JsonResponse([
-                'error' => $result->message,
-                'data' => $result->data
-            ], $statusCode);
-        }
-
-        // For HTML requests, still use legacy rendering
-        $errorHandlerContext = $this->createErrorHandlerContext($exception);
-
-        return $responseFactory->createResponseFromHandlerContext(
-            $errorHandlerContext,
-            $this->isDebugMode,
-            false
-        );
-    }
-
-    private function createLegacyHttpResponse(\Throwable $e, ?MiddlewareContext $context = null): Response
-    {
-        // Handle ValidationException with form-specific logic
-        if ($e instanceof ValidationException) {
-            return $this->handleValidationException($e, $context);
-        }
-
-        $errorHandlerContext = $this->createErrorHandlerContext($e, $context);
-
-        // Standard Error Logging mit ErrorHandlerContext
-        $this->logger->logErrorHandlerContext($errorHandlerContext);
-
-        // Error Aggregation - automatische Pattern-Erkennung und Alerting
-        $this->errorAggregator->processError($errorHandlerContext);
-
-        // Error Reporting - zentrale Fehlersammlung mit Context Enrichment
-        $this->errorReporter->reportThrowable($e, 'error', $errorHandlerContext->toArray());
-
-        // Security Event Logging delegieren
-        $this->securityHandler->handleIfSecurityException($e, $context);
-
-        $responseFactory = $this->createResponseFactory();
-
-        $isApiRequest = $responseFactory->isApiRequest();
-
-        return $responseFactory->createResponseFromHandlerContext(
-            $errorHandlerContext,
-            $this->isDebugMode,
-            $isApiRequest
-        );
-    }
-
-    private function handleValidationException(ValidationException $exception, ?MiddlewareContext $context): Response
-    {
-        // Try to get ValidationFormHandler from container
-        if ($this->container->has(ValidationFormHandler::class)) {
-            $formHandler = $this->container->get(ValidationFormHandler::class);
-
-            return $formHandler->handle($exception, $context);
-        }
-
-        // Log missing ValidationFormHandler using structured logging
-        $errorContext = $this->createErrorHandlerContext(
-            new \RuntimeException('ValidationFormHandler not found in container'),
-            $context
-        );
-        $this->logger->logErrorHandlerContext($errorContext);
-        // Fallback: create basic redirect response
-        $refererUrl = $context?->request?->server?->getRefererUri() ?? '/';
-
-        return new RedirectResponse($refererUrl);
-    }
-
-    public function handleException(Throwable $e): void
-    {
-        $errorHandlerContext = $this->createErrorHandlerContext($e);
-
-        // Logge den Fehler mit ErrorHandlerContext
-        $this->logger->logErrorHandlerContext($errorHandlerContext);
-
-        // Error Aggregation - automatische Pattern-Erkennung und Alerting
-        $this->errorAggregator->processError($errorHandlerContext);
-
-        // Error Reporting - zentrale Fehlersammlung mit Context Enrichment
-        $this->errorReporter->reportThrowable($e, 'error', $errorHandlerContext->toArray());
-
-        // Security Event Logging delegieren
-        $this->securityHandler->handleIfSecurityException($e);
-
-        // Erstelle ResponseFactory mit dem TemplateRenderer
-        $responseFactory = $this->createResponseFactory();
-
-        // Bestimme ob es ein API-Request ist
-        $isApiRequest = $responseFactory->isApiRequest();
-
-        // Erstelle eine Response basierend auf dem ErrorHandlerContext
-        $response = $responseFactory->createResponseFromHandlerContext($errorHandlerContext, $this->isDebugMode, $isApiRequest);
-
-        // Sende die Fehlermeldung
-        $this->emitter->emit($response);
-        // Let PHP invoke shutdown functions naturally - do not call exit(1)
-    }
-
-    public function handleError(int $errno, string $errstr, string $errfile, int $errline): void
-    {
-        $exception = new \ErrorException($errstr, 0, $errno, $errfile, $errline);
-        $this->handleException($exception);
-    }
-
-
-    private function createErrorHandlerContext(Throwable $exception, ?MiddlewareContext $context = null): ErrorHandlerContext
-    {
-        // ExceptionContext aus der Exception extrahieren (falls FrameworkException)
-        $exceptionContext = ExceptionContext::empty();
-        if ($exception instanceof FrameworkException) {
-            $exceptionContext = $exception->getContext();
-
-
-            // Für DatabaseException: Verwende die previous exception für File/Line
-            if ($exception instanceof \App\Framework\Database\Exception\DatabaseException && $exception->getPrevious()) {
-                $previous = $exception->getPrevious();
-
-
-                $exceptionContext = $exceptionContext->withData([
-                    'original_exception' => $previous,
-                    'exception_file' => $previous->getFile(),
-                    'exception_line' => $previous->getLine(),
-                    'exception_message' => $exception->getMessage(), // Keep DatabaseException message
-                ]);
-
-            } else {
-                // Ensure framework exceptions also have the original exception for stack traces
-                if (! isset($exceptionContext->data['original_exception'])) {
-                    $exceptionContext = $exceptionContext->withData([
-                        'original_exception' => $exception,
-                        'exception_file' => $exception->getFile(),
-                        'exception_line' => $exception->getLine(),
-                    ]);
-                }
-            }
-        } else {
-            // For non-framework exceptions, add the actual exception message and the original exception
-            $exceptionContext = $exceptionContext->withData([
-                'exception_message' => $exception->getMessage(),
-                'exception_file' => $exception->getFile(),
-                'exception_line' => $exception->getLine(),
-                'original_exception' => $exception, // Preserve original exception for stack trace
-            ]);
-        }
-
-        // RequestContext aus MiddlewareContext oder Globals erstellen
-        $requestContext = $this->createRequestContext($context);
-
-        // SystemContext mit aktuellen System-Metriken erstellen
-        $memoryMonitor = $this->container->has(MemoryMonitor::class)
-            ? $this->container->get(MemoryMonitor::class)
-            : null;
-        $systemContext = SystemContext::current($memoryMonitor);
-
-        // Metadata für verschiedene Exception-Typen
-        $metadata = $this->createExceptionMetadata($exception);
-
-        return ErrorHandlerContext::create(
-            $exceptionContext,
-            $requestContext,
-            $systemContext,
-            $metadata
-        );
-    }
-
-    private function createRequestContext(?MiddlewareContext $context): RequestContext
-    {
-        if ($context?->request) {
-            $request = $context->request;
-
-            return RequestContext::create(
-                clientIp: (string) $request->server->getClientIp(),
-                userAgent: $request->server->getUserAgent(),
-                requestMethod: $request->method->value,
-                requestUri: (string) $request->getUri(),
-                hostIp: $request->server->get('SERVER_ADDR', 'unknown'),
-                hostname: $request->server->getHttpHost() ?: 'localhost',
-                protocol: $request->server->getProtocol()->value,
-                port: (string) $request->server->getServerPort(),
-                requestId: $request->id
-            );
-        }
-
-        return RequestContext::fromGlobals();
-    }
-
-    private function createExceptionMetadata(Throwable $exception): ErrorMetadata
-    {
-        $exceptionClass = get_class($exception);
-        $errorLevel = $this->determineErrorSeverity($exception);
-        $httpStatus = $this->determineHttpStatus($exception);
-
-        // Enhanced metadata for FrameworkException with ErrorCode
-        if ($exception instanceof FrameworkException) {
-            $errorCode = $exception->getErrorCode();
-            if ($errorCode !== null) {
-                $recoveryHint = $this->isDebugMode ? $errorCode->getRecoveryHint() : null;
-
-                $metadata = ErrorMetadata::enhanced(
-                    exceptionClass: $exceptionClass,
-                    errorLevel: $errorLevel,
-                    httpStatus: $httpStatus,
-                    errorCode: $errorCode->getValue(),
-                    errorCategory: $errorCode->getCategory(),
-                    errorSeverity: $errorCode->getSeverity()->value,
-                    isRecoverable: $errorCode->isRecoverable(),
-                    recoveryHint: $recoveryHint
-                );
-
-                // Add Retry-After header if applicable
-                $retryAfter = $errorCode->getRetryAfterSeconds();
-                if ($retryAfter !== null) {
-                    $metadata = $metadata->withAdditionalHeaders([
-                        'Retry-After' => (string) $retryAfter
-                    ]);
-                }
-
-                return $this->addExceptionSpecificHeaders($exception, $metadata);
-            }
-        }
-
-        // Basic metadata for non-FrameworkException or FrameworkException without ErrorCode
-        $metadata = ErrorMetadata::basic(
-            exceptionClass: $exceptionClass,
-            errorLevel: $errorLevel,
-            httpStatus: $httpStatus
-        );
-
-        return $this->addExceptionSpecificHeaders($exception, $metadata);
-    }
-
-    private function addExceptionSpecificHeaders(
-        Throwable $exception,
-        ErrorMetadata $metadata
-    ): ErrorMetadata {
-        // RateLimitExceededException headers
-        if ($exception instanceof \App\Framework\Exception\Http\RateLimitExceededException) {
-            $metadata = $metadata->withAdditionalHeaders(
-                $exception->getRateLimitHeaders()
-            );
-        }
-
-        // InvalidContentTypeException headers
-        if ($exception instanceof \App\Framework\Exception\Http\InvalidContentTypeException) {
-            $metadata = $metadata->withAdditionalHeaders(
-                $exception->getResponseHeaders()
-            );
-        }
-
-        return $metadata;
-    }
-
-    /**
-     * Determine HTTP status code with ErrorCode-based prioritization
-     */
-    private function determineHttpStatus(Throwable $exception): int
-    {
-        // Priority 1: ErrorCode-based status mapping for FrameworkException
-        if ($exception instanceof FrameworkException) {
-            $errorCode = $exception->getErrorCode();
-            if ($errorCode !== null) {
-                $category = $errorCode->getCategory();
-
-                return match ($category) {
-                    'AUTH' => 401, // Authentication errors
-                    'AUTHZ' => 403, // Authorization errors
-                    'VAL' => 400,  // Validation errors
-                    'HTTP' => $this->mapHttpCategoryToStatus($exception),
-                    'DB', 'QUEUE', 'CACHE', 'FILE' => 500, // Infrastructure errors
-                    default => 500,
-                };
-            }
-        }
-
-        // Priority 2: Legacy exception-type mapping
-        return match (true) {
-            $exception instanceof \App\Framework\Exception\Authentication\InvalidCredentialsException,
-            $exception instanceof \App\Framework\Exception\Authentication\TokenExpiredException,
-            $exception instanceof \App\Framework\Exception\Authentication\SessionTimeoutException => 401,
-
-            $exception instanceof \App\Framework\Exception\Authentication\AccountLockedException => 423,
-            $exception instanceof \App\Framework\Exception\Authentication\InsufficientPrivilegesException => 403,
-
-            $exception instanceof \App\Framework\Exception\Http\RouteNotFoundException => 404,
-            $exception instanceof \App\Framework\Exception\Http\MalformedJsonException,
-            $exception instanceof \App\Framework\Exception\Http\InvalidContentTypeException,
-            $exception instanceof \App\Framework\Exception\Security\SqlInjectionAttemptException,
-            $exception instanceof \App\Framework\Exception\Security\XssAttemptException,
-            $exception instanceof \App\Framework\Exception\Security\PathTraversalAttemptException => 400,
-
-            $exception instanceof \App\Framework\Exception\Http\OversizedRequestException => 413,
-            $exception instanceof \App\Framework\Exception\Http\RateLimitExceededException => 429,
-
-            default => 500,
-        };
-    }
-
-    /**
-     * Map HTTP category ErrorCodes to specific status codes
-     */
-    private function mapHttpCategoryToStatus(FrameworkException $exception): int
-    {
-        $errorCode = $exception->getErrorCode();
-
-        // Use numeric code for fine-grained HTTP status mapping
-        return match ($errorCode->getNumericCode()) {
-            404 => 404, // HTTP_NOT_FOUND
-            429 => 429, // HTTP_RATE_LIMIT_EXCEEDED
-            413 => 413, // HTTP_OVERSIZED_REQUEST
-            415 => 415, // HTTP_INVALID_CONTENT_TYPE
-            default => 500,
-        };
-    }
-
-    private function determineErrorSeverity(Throwable $exception): ErrorSeverity
-    {
-        // Priority 1: Use ErrorCode.getSeverity() for FrameworkException
-        if ($exception instanceof FrameworkException) {
-            $errorCode = $exception->getErrorCode();
-            if ($errorCode !== null) {
-                return $errorCode->getSeverity();
-            }
-        }
-
-        // Priority 2: Legacy exception-type mapping
-        return match(true) {
-            $exception instanceof \Error => ErrorSeverity::CRITICAL,
-            $exception instanceof \ErrorException => $this->determineErrorExceptionSeverity($exception),
-            $exception instanceof SecurityException => $this->determineSecurityErrorSeverity($exception),
-            $exception instanceof \RuntimeException => ErrorSeverity::ERROR,
-            $exception instanceof \LogicException => ErrorSeverity::WARNING,
-            default => ErrorSeverity::ERROR,
-        };
-    }
-
-    /**
-     * Bestimmt den Error-Level für SecurityExceptions basierend auf dem Security-Level
-     */
-    private function determineSecurityErrorSeverity(SecurityException $exception): ErrorSeverity
-    {
-        return match($exception->getSecurityLevel()) {
-            SecurityLogLevel::DEBUG => ErrorSeverity::DEBUG,
-            SecurityLogLevel::INFO => ErrorSeverity::INFO,
-            SecurityLogLevel::WARN => ErrorSeverity::WARNING,
-            SecurityLogLevel::ERROR => ErrorSeverity::ERROR,
-            SecurityLogLevel::FATAL => ErrorSeverity::CRITICAL,
-        };
-    }
-
-    /**
-     * Bestimmt den Fehler-Level basierend auf dem ErrorException-Severity-Level
-     */
-    private function determineErrorExceptionSeverity(\ErrorException $exception): ErrorSeverity
-    {
-        return match($exception->getSeverity()) {
-            E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR, E_RECOVERABLE_ERROR => ErrorSeverity::CRITICAL,
-            E_WARNING, E_CORE_WARNING, E_COMPILE_WARNING, E_USER_WARNING => ErrorSeverity::WARNING,
-            E_NOTICE, E_USER_NOTICE => ErrorSeverity::NOTICE,
-            E_DEPRECATED, E_USER_DEPRECATED => ErrorSeverity::INFO,
-            E_STRICT => ErrorSeverity::DEBUG,
-            default => ErrorSeverity::ERROR,
-        };
-    }
-
-    /**
-     * Erstellt eine ErrorResponseFactory mit Renderern
-     * Versucht den TemplateRenderer aus dem Container zu laden, falls vorhanden
-     */
-    private function getDebugModeFromEnvironment(): bool
-    {
-        try {
-            if ($this->container->has(Environment::class)) {
-                $environment = $this->container->get(Environment::class);
-
-                return $environment->getBool(EnvKey::APP_DEBUG, false);
-            }
-        } catch (Throwable $e) {
-            // Sicherer Fallback für Production
-            return false;
-        }
-
-        return false;
-    }
-
-    private function createResponseFactory(): ErrorResponseFactory
-    {
-        $templateRenderer = null;
-
-        // Versuche TemplateRenderer aus Container zu laden
-        if ($this->container->has(TemplateRenderer::class)) {
-            try {
-                $templateRenderer = $this->container->get(TemplateRenderer::class);
-            } catch (Throwable $e) {
-                // Falls ein Fehler beim Laden auftritt, verwende Fallback
-                $templateRenderer = null;
-            }
-        }
-
-        // Get AppConfig from container
-        $appConfig = $this->container->get(\App\Framework\Config\AppConfig::class);
-
-        $htmlRenderer = $templateRenderer ?
-            new ErrorTemplateRenderer($templateRenderer, $appConfig) :
-            new ErrorTemplateRenderer(new DummyTemplateRenderer(), $appConfig);
-
-        $apiRenderer = new ApiErrorRenderer();
-
-        return new ErrorResponseFactory($htmlRenderer, $apiRenderer);
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorHandlerInitializer.php b/src/Framework/ErrorHandling/ErrorHandlerInitializer.php
deleted file mode 100644
index 2ec6067c..00000000
--- a/src/Framework/ErrorHandling/ErrorHandlerInitializer.php
+++ /dev/null
@@ -1,37 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\DI\Container;
-use App\Framework\DI\Initializer;
-use App\Framework\ErrorHandling\Handlers\DatabaseErrorHandler;
-use App\Framework\ErrorHandling\Handlers\FallbackErrorHandler;
-use App\Framework\ErrorHandling\Handlers\HttpErrorHandler;
-use App\Framework\ErrorHandling\Handlers\ValidationErrorHandler;
-use App\Framework\Logging\Logger;
-
-/**
- * Initializes the error handler system
- *
- * Registers all error handlers in priority order
- */
-final readonly class ErrorHandlerInitializer
-{
-    #[Initializer]
-    public function initialize(Container $container): ErrorHandlerManager
-    {
-        $logger = $container->get(Logger::class);
-        $registry = new ErrorHandlerRegistry();
-        $manager = new ErrorHandlerManager($registry);
-
-        // Register all handlers at once (will be sorted by priority internally)
-        return $manager->register(
-            new ValidationErrorHandler(),       // CRITICAL priority
-            new DatabaseErrorHandler($logger),  // HIGH priority
-            new HttpErrorHandler(),             // NORMAL priority
-            new FallbackErrorHandler($logger)   // LOWEST priority
-        );
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorHandlerManager.php b/src/Framework/ErrorHandling/ErrorHandlerManager.php
deleted file mode 100644
index e81f4a49..00000000
--- a/src/Framework/ErrorHandling/ErrorHandlerManager.php
+++ /dev/null
@@ -1,174 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerInterface;
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\ErrorHandling\Handlers\HandlerRegistration;
-
-/**
- * Manager for error handler chain
- *
- * Orchestrates multiple error handlers with priority-based execution
- *
- * Immutable: All modification methods return new instances
- */
-final readonly class ErrorHandlerManager
-{
-    /**
-     * @param HandlerRegistration[] $handlers
-     */
-    public function __construct(
-        private ErrorHandlerRegistry $registry,
-        private array $handlers = []
-    ) {}
-
-    /**
-     * Register one or more error handlers (immutable)
-     *
-     * @param ErrorHandlerInterface ...$handlers One or more handlers to register
-     * @return self New instance with handlers registered
-     */
-    public function register(ErrorHandlerInterface ...$handlers): self
-    {
-        $newHandlers = $this->handlers;
-        $newRegistry = $this->registry;
-
-        foreach ($handlers as $handler) {
-            $priority = $handler->getPriority();
-            $registration = new HandlerRegistration($handler, $priority);
-            $newHandlers[] = $registration;
-
-            // Register in registry
-            $newRegistry = $newRegistry->register($handler->getName(), $handler);
-        }
-
-        // Sort by priority (highest first)
-        usort($newHandlers, fn(HandlerRegistration $a, HandlerRegistration $b) =>
-            $a->comparePriority($b)
-        );
-
-        return new self($newRegistry, $newHandlers);
-    }
-
-    /**
-     * Handle an exception through the handler chain
-     */
-    public function handle(\Throwable $exception): ErrorHandlingResult
-    {
-        $results = [];
-        $handled = false;
-
-        foreach ($this->handlers as $registration) {
-            // Check if handler can handle this exception
-            if (!$registration->canHandle($exception)) {
-                continue;
-            }
-
-            try {
-                // Handle exception
-                $result = $registration->handle($exception);
-                $results[] = $result;
-
-                // Mark as handled if handler handled it
-                if ($result->handled) {
-                    $handled = true;
-                }
-
-                // Stop if handler marked as final
-                if ($result->isFinal) {
-                    break;
-                }
-            } catch (\Throwable $handlerException) {
-                // Handler itself failed - log but continue
-                error_log(sprintf(
-                    '[ErrorHandlerManager] Handler %s failed: %s',
-                    $registration->getHandlerName(),
-                    $handlerException->getMessage()
-                ));
-            }
-        }
-
-        return new ErrorHandlingResult(
-            handled: $handled,
-            results: $results,
-            exception: $exception
-        );
-    }
-
-    /**
-     * Get all registered handlers
-     *
-     * @return ErrorHandlerInterface[]
-     */
-    public function getHandlers(): array
-    {
-        return array_map(
-            fn(HandlerRegistration $registration) => $registration->handler,
-            $this->handlers
-        );
-    }
-
-    /**
-     * Remove a handler (immutable)
-     *
-     * @return self New instance without the specified handler
-     */
-    public function unregister(ErrorHandlerInterface $handler): self
-    {
-        $newHandlers = array_filter(
-            $this->handlers,
-            fn(HandlerRegistration $registration) => $registration->handler !== $handler
-        );
-
-        // Remove from registry (registry handles its own immutability)
-        $newRegistry = $this->registry->unregister($handler->getName());
-
-        return new self($newRegistry, array_values($newHandlers));
-    }
-
-    /**
-     * Clear all handlers (immutable)
-     *
-     * @return self New instance with no handlers
-     */
-    public function clear(): self
-    {
-        $newRegistry = $this->registry->clear();
-
-        return new self($newRegistry, []);
-    }
-
-    /**
-     * Get handler statistics
-     */
-    public function getStatistics(): array
-    {
-        $stats = [
-            'total_handlers' => count($this->handlers),
-            'handlers_by_priority' => [],
-            'handlers' => []
-        ];
-
-        foreach ($this->handlers as $registration) {
-            $priorityValue = $registration->priority->value;
-
-            // Count by priority
-            if (!isset($stats['handlers_by_priority'][$priorityValue])) {
-                $stats['handlers_by_priority'][$priorityValue] = 0;
-            }
-            $stats['handlers_by_priority'][$priorityValue]++;
-
-            // Handler details
-            $stats['handlers'][] = [
-                'name' => $registration->getHandlerName(),
-                'class' => get_class($registration->handler),
-                'priority' => $priorityValue
-            ];
-        }
-
-        return $stats;
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorHandlerRegistry.php b/src/Framework/ErrorHandling/ErrorHandlerRegistry.php
deleted file mode 100644
index ee1a6beb..00000000
--- a/src/Framework/ErrorHandling/ErrorHandlerRegistry.php
+++ /dev/null
@@ -1,86 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerInterface;
-
-/**
- * Registry for named error handlers
- *
- * Allows handlers to be registered and retrieved by name
- *
- * Immutable: All modification methods return new instances
- */
-final readonly class ErrorHandlerRegistry
-{
-    /**
-     * @param array<string, ErrorHandlerInterface> $handlers
-     */
-    public function __construct(
-        private array $handlers = []
-    ) {}
-
-    /**
-     * Register a handler with a name (immutable)
-     *
-     * @return self New instance with handler registered
-     */
-    public function register(string $name, ErrorHandlerInterface $handler): self
-    {
-        $newHandlers = [...$this->handlers];
-        $newHandlers[$name] = $handler;
-
-        return new self($newHandlers);
-    }
-
-    /**
-     * Get a handler by name
-     */
-    public function get(string $name): ?ErrorHandlerInterface
-    {
-        return $this->handlers[$name] ?? null;
-    }
-
-    /**
-     * Check if a handler is registered
-     */
-    public function has(string $name): bool
-    {
-        return isset($this->handlers[$name]);
-    }
-
-    /**
-     * Get all registered handlers
-     *
-     * @return array<string, ErrorHandlerInterface>
-     */
-    public function all(): array
-    {
-        return $this->handlers;
-    }
-
-    /**
-     * Remove a handler by name (immutable)
-     *
-     * @return self New instance without the specified handler
-     */
-    public function unregister(string $name): self
-    {
-        $newHandlers = $this->handlers;
-        unset($newHandlers[$name]);
-
-        return new self($newHandlers);
-    }
-
-    /**
-     * Clear all handlers (immutable)
-     *
-     * @return self New instance with no handlers
-     */
-    public function clear(): self
-    {
-        return new self([]);
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorHandlingResult.php b/src/Framework/ErrorHandling/ErrorHandlingResult.php
deleted file mode 100644
index 5c3a6ae2..00000000
--- a/src/Framework/ErrorHandling/ErrorHandlingResult.php
+++ /dev/null
@@ -1,58 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\ErrorHandling\Handlers\HandlerResult;
-
-/**
- * Result of processing an exception through the error handler chain
- */
-final readonly class ErrorHandlingResult
-{
-    /**
-     * @param bool $handled Whether the exception was handled by any handler
-     * @param HandlerResult[] $results Results from all handlers that processed the exception
-     * @param \Throwable $exception The original exception
-     */
-    public function __construct(
-        public bool $handled,
-        public array $results,
-        public \Throwable $exception
-    ) {}
-
-    /**
-     * Get the first handler result (usually the most important)
-     */
-    public function getFirstResult(): ?HandlerResult
-    {
-        return $this->results[0] ?? null;
-    }
-
-    /**
-     * Get all handler messages
-     *
-     * @return string[]
-     */
-    public function getMessages(): array
-    {
-        return array_map(
-            fn(HandlerResult $result) => $result->message,
-            $this->results
-        );
-    }
-
-    /**
-     * Get combined data from all handlers
-     */
-    public function getCombinedData(): array
-    {
-        return array_merge(
-            ...array_map(
-                fn(HandlerResult $result) => $result->data,
-                $this->results
-            )
-        );
-    }
-}
diff --git a/src/Framework/ErrorHandling/ErrorLogger.php b/src/Framework/ErrorHandling/ErrorLogger.php
deleted file mode 100644
index 8fc23ae7..00000000
--- a/src/Framework/ErrorHandling/ErrorLogger.php
+++ /dev/null
@@ -1,169 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Config\AppConfig;
-use App\Framework\Exception\Core\ErrorSeverity;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\LogLevel;
-use App\Framework\Logging\ValueObjects\LogContext;
-
-/**
- * Logger für Fehler und Exceptions - nutzt Framework Logger
- */
-final readonly class ErrorLogger
-{
-    public function __construct(
-        private Logger $logger,
-        private AppConfig $appConfig
-    ) {
-    }
-
-    /**
-     * Loggt einen Fehler basierend auf dem ErrorContext (Legacy)
-     */
-    public function logError(ErrorContext $context): void
-    {
-        $exception = $context->exception;
-        $message = sprintf(
-            '[%s] %s: %s in %s:%d',
-            $context->requestId,
-            get_class($exception),
-            $exception->getMessage(),
-            $exception->getFile(),
-            $exception->getLine()
-        );
-
-        $contextData = [
-            'exception' => $exception,
-            'trace' => $exception->getTraceAsString(),
-            'requestId' => $context->requestId,
-            'additionalData' => $context->additionalData,
-        ];
-
-        $logLevel = $this->mapErrorSeverityToLogLevel($context->level);
-        $this->logger->log($logLevel, $message, $contextData);
-    }
-
-    /**
-     * Loggt einen Fehler basierend auf dem ErrorHandlerContext
-     */
-    public function logErrorHandlerContext(ErrorHandlerContext $context): void
-    {
-        // Structured Logging mit allen Context-Informationen
-        $logData = $context->forLogging();
-
-        // Security Event Logging falls Security-Event
-        if ($context->exception->metadata['security_event'] ?? false) {
-            $this->logSecurityEvent($context);
-        }
-
-        // Standard Error Logging
-        $message = sprintf(
-            '[%s] %s: %s',
-            $context->request->requestId?->toString() ?? 'NO-REQUEST-ID',
-            $context->exception->component ?? 'Application',
-            $this->extractExceptionMessage($context)
-        );
-
-
-        $logLevel = $this->determineLogLevel($context);
-
-        // Erstelle LogContext mit strukturierten Daten
-        $logContext = LogContext::withData($logData)
-            ->addTags('error_handler', 'framework');
-
-        // Füge Metadaten-Tags hinzu
-        if ($context->exception->metadata['security_event'] ?? false) {
-            $logContext = $logContext->addTags('security');
-        }
-
-        $this->logger->log($logLevel, $message, $logContext);
-    }
-
-    /**
-     * Loggt Security Events im OWASP-Format mit strukturiertem Logging
-     */
-    private function logSecurityEvent(ErrorHandlerContext $context): void
-    {
-        $securityLog = $context->toSecurityEventFormat($this->appConfig->name);
-
-        // Verwende LogContext für strukturiertes Security Event Logging
-        $logContext = LogContext::withData($securityLog)
-            ->addTags('security_event', 'owasp');
-
-        $this->logger->log(LogLevel::WARNING, 'Security Event Detected', $logContext);
-    }
-
-    /**
-     * Extrahiert Exception-Message aus ErrorHandlerContext
-     */
-    private function extractExceptionMessage(ErrorHandlerContext $context): string
-    {
-        // Versuche Exception aus context.exception.data zu extrahieren
-        $exceptionData = $context->exception->data;
-
-        if (isset($exceptionData['exception_message'])) {
-            return $exceptionData['exception_message'];
-        }
-
-
-        // Fallback: Operation und Component verwenden
-        $operation = $context->exception->operation ?? 'unknown_operation';
-        $component = $context->exception->component ?? 'unknown_component';
-
-        return "Error in {$component} during {$operation}";
-    }
-
-    /**
-     * Bestimmt Log-Level aus ErrorHandlerContext
-     */
-    private function determineLogLevel(ErrorHandlerContext $context): LogLevel
-    {
-        // Security Events haben höhere Priorität
-        if ($context->exception->metadata['security_event'] ?? false) {
-            $securityLevel = $context->exception->metadata['security_level'] ?? 'ERROR';
-
-            return match ($securityLevel) {
-                'DEBUG' => LogLevel::DEBUG,
-                'INFO' => LogLevel::INFO,
-                'WARN' => LogLevel::WARNING,
-                'ERROR' => LogLevel::ERROR,
-                'FATAL' => LogLevel::CRITICAL,
-                default => LogLevel::ERROR,
-            };
-        }
-
-        // Standard Log-Level aus Metadata
-        $errorLevel = $context->exception->metadata['error_level'] ?? 'ERROR';
-
-        return match ($errorLevel) {
-            'CRITICAL' => LogLevel::CRITICAL,
-            'ERROR' => LogLevel::ERROR,
-            'WARNING' => LogLevel::WARNING,
-            'NOTICE' => LogLevel::NOTICE,
-            'INFO' => LogLevel::INFO,
-            'DEBUG' => LogLevel::DEBUG,
-            default => LogLevel::ERROR,
-        };
-    }
-
-
-    /**
-     * Mappt ErrorSeverity auf Framework LogLevel
-     */
-    private function mapErrorSeverityToLogLevel(ErrorSeverity $severity): LogLevel
-    {
-        return match($severity) {
-            ErrorSeverity::CRITICAL => LogLevel::CRITICAL,
-            ErrorSeverity::ERROR => LogLevel::ERROR,
-            ErrorSeverity::WARNING => LogLevel::WARNING,
-            ErrorSeverity::NOTICE => LogLevel::NOTICE,
-            ErrorSeverity::INFO => LogLevel::INFO,
-            ErrorSeverity::DEBUG => LogLevel::DEBUG,
-        };
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/DatabaseErrorHandler.php b/src/Framework/ErrorHandling/Handlers/DatabaseErrorHandler.php
deleted file mode 100644
index 207b48f8..00000000
--- a/src/Framework/ErrorHandling/Handlers/DatabaseErrorHandler.php
+++ /dev/null
@@ -1,57 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-use App\Framework\Database\Exception\DatabaseException;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\ValueObjects\LogContext;
-
-/**
- * Handler for database-related errors
- *
- * Priority: HIGH - Database errors need immediate attention
- */
-final readonly class DatabaseErrorHandler implements ErrorHandlerInterface
-{
-    public function __construct(
-        private Logger $logger
-    ) {}
-
-    public function canHandle(\Throwable $exception): bool
-    {
-        return $exception instanceof DatabaseException
-            || $exception instanceof \PDOException;
-    }
-
-    public function handle(\Throwable $exception): HandlerResult
-    {
-        // Log database error with context
-        $this->logger->error('Database error occurred', LogContext::withData([
-            'exception_class' => get_class($exception),
-            'message' => $exception->getMessage(),
-            'code' => $exception->getCode()
-        ]));
-
-        return HandlerResult::create(
-            handled: true,
-            message: 'A database error occurred',
-            data: [
-                'error_type' => 'database',
-                'retry_after' => 60 // Suggest retry after 60 seconds
-            ],
-            statusCode: 500
-        );
-    }
-
-    public function getName(): string
-    {
-        return 'database_error_handler';
-    }
-
-    public function getPriority(): ErrorHandlerPriority
-    {
-        return ErrorHandlerPriority::HIGH;
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/ErrorHandlerInterface.php b/src/Framework/ErrorHandling/Handlers/ErrorHandlerInterface.php
deleted file mode 100644
index 740a355e..00000000
--- a/src/Framework/ErrorHandling/Handlers/ErrorHandlerInterface.php
+++ /dev/null
@@ -1,31 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-/**
- * Interface for specialized error handlers in the error handling chain
- */
-interface ErrorHandlerInterface
-{
-    /**
-     * Check if this handler can handle the given exception
-     */
-    public function canHandle(\Throwable $exception): bool;
-
-    /**
-     * Handle the exception and return a result
-     */
-    public function handle(\Throwable $exception): HandlerResult;
-
-    /**
-     * Get handler name for logging/debugging
-     */
-    public function getName(): string;
-
-    /**
-     * Get handler priority
-     */
-    public function getPriority(): ErrorHandlerPriority;
-}
diff --git a/src/Framework/ErrorHandling/Handlers/ErrorHandlerPriority.php b/src/Framework/ErrorHandling/Handlers/ErrorHandlerPriority.php
deleted file mode 100644
index 3d2cc0d8..00000000
--- a/src/Framework/ErrorHandling/Handlers/ErrorHandlerPriority.php
+++ /dev/null
@@ -1,43 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-/**
- * Priority levels for error handlers
- *
- * Handlers with higher priority execute first in the chain
- */
-enum ErrorHandlerPriority: int
-{
-    /**
-     * Critical handlers (Security, Authentication)
-     * Execute first to prevent security incidents
-     */
-    case CRITICAL = 1000;
-
-    /**
-     * High priority handlers (Database, Validation)
-     * Execute early for data integrity
-     */
-    case HIGH = 750;
-
-    /**
-     * Normal priority handlers (HTTP, Business Logic)
-     * Standard application errors
-     */
-    case NORMAL = 500;
-
-    /**
-     * Low priority handlers (Logging, Monitoring)
-     * Non-critical error handling
-     */
-    case LOW = 250;
-
-    /**
-     * Lowest priority handlers (Fallback)
-     * Catch-all handlers that execute last
-     */
-    case LOWEST = 100;
-}
diff --git a/src/Framework/ErrorHandling/Handlers/FallbackErrorHandler.php b/src/Framework/ErrorHandling/Handlers/FallbackErrorHandler.php
deleted file mode 100644
index 59003e52..00000000
--- a/src/Framework/ErrorHandling/Handlers/FallbackErrorHandler.php
+++ /dev/null
@@ -1,58 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\ValueObjects\LogContext;
-
-/**
- * Fallback handler for all unhandled exceptions
- *
- * Priority: LOWEST - Catches everything that other handlers missed
- */
-final readonly class FallbackErrorHandler implements ErrorHandlerInterface
-{
-    public function __construct(
-        private Logger $logger
-    ) {}
-
-    public function canHandle(\Throwable $exception): bool
-    {
-        return true; // Handles everything
-    }
-
-    public function handle(\Throwable $exception): HandlerResult
-    {
-        // Log unhandled exception with full context
-        $this->logger->error('Unhandled exception', LogContext::withData([
-            'exception_class' => get_class($exception),
-            'message' => $exception->getMessage(),
-            'file' => $exception->getFile(),
-            'line' => $exception->getLine(),
-            'trace' => $exception->getTraceAsString()
-        ]));
-
-        return HandlerResult::create(
-            handled: true,
-            message: 'An unexpected error occurred',
-            data: [
-                'error_type' => 'unhandled',
-                'exception_class' => get_class($exception)
-            ],
-            isFinal: true, // Stop chain - this is the last resort
-            statusCode: 500
-        );
-    }
-
-    public function getName(): string
-    {
-        return 'fallback_error_handler';
-    }
-
-    public function getPriority(): ErrorHandlerPriority
-    {
-        return ErrorHandlerPriority::LOWEST;
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/HandlerRegistration.php b/src/Framework/ErrorHandling/Handlers/HandlerRegistration.php
deleted file mode 100644
index bc9816c6..00000000
--- a/src/Framework/ErrorHandling/Handlers/HandlerRegistration.php
+++ /dev/null
@@ -1,52 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-/**
- * Value Object representing a registered error handler with its priority.
- *
- * Replaces primitive array{handler: ErrorHandlerInterface, priority: int} pattern
- * with type-safe, immutable Value Object following framework principles.
- */
-final readonly class HandlerRegistration
-{
-    public function __construct(
-        public ErrorHandlerInterface $handler,
-        public ErrorHandlerPriority $priority
-    ) {}
-
-    /**
-     * Check if this handler can handle the given exception.
-     */
-    public function canHandle(\Throwable $exception): bool
-    {
-        return $this->handler->canHandle($exception);
-    }
-
-    /**
-     * Execute the handler with the given exception.
-     */
-    public function handle(\Throwable $exception): HandlerResult
-    {
-        return $this->handler->handle($exception);
-    }
-
-    /**
-     * Get handler name for debugging/logging.
-     */
-    public function getHandlerName(): string
-    {
-        return $this->handler->getName();
-    }
-
-    /**
-     * Compare priority with another registration for sorting.
-     */
-    public function comparePriority(self $other): int
-    {
-        // Higher priority value = execute first (descending sort)
-        return $other->priority->value <=> $this->priority->value;
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/HandlerResult.php b/src/Framework/ErrorHandling/Handlers/HandlerResult.php
deleted file mode 100644
index 4b7bc918..00000000
--- a/src/Framework/ErrorHandling/Handlers/HandlerResult.php
+++ /dev/null
@@ -1,32 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-/**
- * Result returned by error handlers after processing an exception
- */
-final readonly class HandlerResult
-{
-    public function __construct(
-        public bool $handled,
-        public string $message,
-        public array $data = [],
-        public bool $isFinal = false,
-        public ?int $statusCode = null
-    ) {}
-
-    /**
-     * Factory method for creating handler results
-     */
-    public static function create(
-        bool $handled,
-        string $message,
-        array $data = [],
-        bool $isFinal = false,
-        ?int $statusCode = null
-    ): self {
-        return new self($handled, $message, $data, $isFinal, $statusCode);
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/HttpErrorHandler.php b/src/Framework/ErrorHandling/Handlers/HttpErrorHandler.php
deleted file mode 100644
index 27c5767c..00000000
--- a/src/Framework/ErrorHandling/Handlers/HttpErrorHandler.php
+++ /dev/null
@@ -1,45 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-use App\Framework\Http\Exception\HttpException;
-
-/**
- * Handler for HTTP-specific errors
- *
- * Priority: NORMAL - Standard HTTP error handling
- */
-final readonly class HttpErrorHandler implements ErrorHandlerInterface
-{
-    public function canHandle(\Throwable $exception): bool
-    {
-        return $exception instanceof HttpException;
-    }
-
-    public function handle(\Throwable $exception): HandlerResult
-    {
-        assert($exception instanceof HttpException);
-
-        return HandlerResult::create(
-            handled: true,
-            message: $exception->getMessage(),
-            data: [
-                'error_type' => 'http',
-                'headers' => $exception->headers ?? []
-            ],
-            statusCode: $exception->statusCode
-        );
-    }
-
-    public function getName(): string
-    {
-        return 'http_error_handler';
-    }
-
-    public function getPriority(): ErrorHandlerPriority
-    {
-        return ErrorHandlerPriority::NORMAL;
-    }
-}
diff --git a/src/Framework/ErrorHandling/Handlers/ValidationErrorHandler.php b/src/Framework/ErrorHandling/Handlers/ValidationErrorHandler.php
deleted file mode 100644
index 158ff0e2..00000000
--- a/src/Framework/ErrorHandling/Handlers/ValidationErrorHandler.php
+++ /dev/null
@@ -1,46 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\Handlers;
-
-use App\Framework\Exception\ValidationException;
-
-/**
- * Handler for validation errors
- *
- * Priority: CRITICAL - Validates before any other processing
- */
-final readonly class ValidationErrorHandler implements ErrorHandlerInterface
-{
-    public function canHandle(\Throwable $exception): bool
-    {
-        return $exception instanceof ValidationException;
-    }
-
-    public function handle(\Throwable $exception): HandlerResult
-    {
-        assert($exception instanceof ValidationException);
-
-        return HandlerResult::create(
-            handled: true,
-            message: 'Validation failed',
-            data: [
-                'errors' => $exception->getErrors(),
-                'validation_context' => $exception->context->data
-            ],
-            isFinal: true, // Stop handler chain for validation errors
-            statusCode: 422
-        );
-    }
-
-    public function getName(): string
-    {
-        return 'validation_error_handler';
-    }
-
-    public function getPriority(): ErrorHandlerPriority
-    {
-        return ErrorHandlerPriority::CRITICAL;
-    }
-}
diff --git a/src/Framework/ErrorHandling/SecurityAlertManager.php b/src/Framework/ErrorHandling/SecurityAlertManager.php
deleted file mode 100644
index 020cea89..00000000
--- a/src/Framework/ErrorHandling/SecurityAlertManager.php
+++ /dev/null
@@ -1,89 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\SecurityException;
-
-/**
- * Manager für Security-Alerts - Integration zu externen Alert-Systemen
- */
-final readonly class SecurityAlertManager
-{
-    public function __construct(
-        private array $alertChannels = []
-    ) {
-    }
-
-    /**
-     * Sendet Alert über alle konfigurierten Kanäle
-     */
-    public function sendAlert(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): void {
-        $alertData = $this->createAlertPayload($exception, $context);
-
-        foreach ($this->alertChannels as $channel) {
-            try {
-                $channel->sendAlert($alertData);
-            } catch (\Throwable $e) {
-                // Alert-Fehler nicht propagieren, nur loggen
-                error_log("Alert channel failed: " . $e->getMessage());
-            }
-        }
-    }
-
-    /**
-     * Erstellt standardisierte Alert-Payload
-     */
-    private function createAlertPayload(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): array {
-        $securityEvent = $exception->getSecurityEvent();
-
-        return [
-            'type' => 'security_alert',
-            'severity' => $this->mapSeverity($exception->getSecurityLevel()),
-            'event_id' => $securityEvent->getEventIdentifier(),
-            'title' => 'Security Event: ' . $securityEvent->getCategory(),
-            'description' => $securityEvent->getDescription(),
-            'details' => [
-                'category' => $securityEvent->getCategory(),
-                'level' => $exception->getSecurityLevel()->value,
-                'client_ip' => $context->request->clientIp,
-                'user_agent' => $context->request->userAgent,
-                'request_uri' => $context->request->requestUri,
-                'timestamp' => date('c'),
-                'request_id' => $context->request->requestId,
-            ],
-            'event_data' => $securityEvent->toArray(),
-            'context' => $context->forLogging(),
-        ];
-    }
-
-    /**
-     * Mappt Security-Level auf Alert-Severity
-     */
-    private function mapSeverity(\App\Framework\Exception\SecurityLogLevel $level): string
-    {
-        return match($level) {
-            \App\Framework\Exception\SecurityLogLevel::FATAL => 'critical',
-            \App\Framework\Exception\SecurityLogLevel::ERROR => 'high',
-            \App\Framework\Exception\SecurityLogLevel::WARN => 'medium',
-            \App\Framework\Exception\SecurityLogLevel::INFO => 'low',
-            \App\Framework\Exception\SecurityLogLevel::DEBUG => 'info',
-        };
-    }
-
-    /**
-     * Factory mit Standard-Alert-Kanälen
-     */
-    public static function createWithChannels(array $channels): self
-    {
-        return new self($channels);
-    }
-}
diff --git a/src/Framework/ErrorHandling/SecurityEventHandler.php b/src/Framework/ErrorHandling/SecurityEventHandler.php
deleted file mode 100644
index e5509385..00000000
--- a/src/Framework/ErrorHandling/SecurityEventHandler.php
+++ /dev/null
@@ -1,200 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\SecurityException;
-use App\Framework\Http\MiddlewareContext;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\Processors\SecurityEventProcessor;
-use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Logging\ValueObjects\SecurityContext;
-use Throwable;
-
-/**
- * Spezialisierte Klasse für Security-Event-Handling und OWASP-konformes Logging
- */
-final readonly class SecurityEventHandler
-{
-    public function __construct(
-        private Logger $logger,
-        private SecurityEventProcessor $processor,
-        private ?SecurityAlertManager $alertManager = null
-    ) {
-    }
-
-    /**
-     * Behandelt Security-Exception und führt entsprechendes Logging durch
-     */
-    public function handleSecurityException(
-        SecurityException $exception,
-        ?MiddlewareContext $context = null
-    ): void {
-        try {
-            // Extract SecurityEvent from Exception
-            $securityEvent = $exception->getSecurityEvent();
-
-            // Create SecurityContext based on event category
-            $securityContext = match ($securityEvent->getCategory()) {
-                'authentication' => SecurityContext::forAuthentication(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    description: $securityEvent->getDescription(),
-                    level: $securityEvent->getLogLevel(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-                'authorization' => SecurityContext::forAuthorization(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    description: $securityEvent->getDescription(),
-                    level: $securityEvent->getLogLevel(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-                'input_validation' => SecurityContext::forInputValidation(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    description: $securityEvent->getDescription(),
-                    level: $securityEvent->getLogLevel(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-                'session' => SecurityContext::forSession(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    description: $securityEvent->getDescription(),
-                    level: $securityEvent->getLogLevel(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-                'intrusion_detection' => SecurityContext::forIntrusion(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    description: $securityEvent->getDescription(),
-                    level: $securityEvent->getLogLevel(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-                default => new SecurityContext(
-                    eventId: $securityEvent->getEventIdentifier(),
-                    level: $securityEvent->getLogLevel(),
-                    description: $securityEvent->getDescription(),
-                    category: $securityEvent->getCategory(),
-                    requiresAlert: $exception->requiresAlert(),
-                    eventData: $securityEvent->toArray()
-                ),
-            };
-
-            // Add request info from MiddlewareContext if available
-            if ($context !== null) {
-                $securityContext = $securityContext->withRequestInfo(
-                    sourceIp: (string) $context->request->server->getClientIp(),
-                    userAgent: $context->request->server->getUserAgent()
-                );
-            }
-
-            // Map SecurityLogLevel to Framework LogLevel
-            $logLevel = $this->processor->mapSecurityLevelToLogLevel($securityEvent->getLogLevel());
-
-            // Log directly via Logger with SecurityContext
-            $this->logger->log(
-                $logLevel,
-                $securityEvent->getDescription(),
-                LogContext::empty()->withSecurityContext($securityContext)
-            );
-
-            // Sende Alert falls erforderlich
-            if ($exception->requiresAlert()) {
-                $this->handleSecurityAlert($exception, $securityContext);
-            }
-
-        } catch (Throwable $loggingError) {
-            // Fallback-Logging: Niemals Security-Events verlieren
-            $this->handleLoggingFailure($exception, $loggingError);
-        }
-    }
-
-    /**
-     * Prüft ob Exception eine SecurityException ist und behandelt sie entsprechend
-     */
-    public function handleIfSecurityException(
-        Throwable $exception,
-        ?MiddlewareContext $context = null
-    ): bool {
-        if (! $exception instanceof SecurityException) {
-            return false;
-        }
-
-        $this->handleSecurityException($exception, $context);
-
-        return true;
-    }
-
-    /**
-     * Behandelt Security-Alerts
-     */
-    private function handleSecurityAlert(
-        SecurityException $exception,
-        SecurityContext $securityContext
-    ): void {
-        if ($this->alertManager) {
-            $this->alertManager->sendAlert($exception, $securityContext);
-        } else {
-            // Fallback: Logge als kritisches Event direkt mit Logger
-            $this->logger->log(
-                \App\Framework\Logging\LogLevel::CRITICAL,
-                'Security Alert: ' . $exception->getSecurityEvent()->getDescription(),
-                LogContext::empty()->withSecurityContext($securityContext)
-            );
-        }
-    }
-
-    /**
-     * Behandelt Fehler beim Security-Logging (Fallback)
-     */
-    private function handleLoggingFailure(
-        SecurityException $originalException,
-        Throwable $loggingError
-    ): void {
-        // Niemals Security-Events verlieren - verwende error_log als Fallback
-        $fallbackMessage = sprintf(
-            'SECURITY_AUDIT_FAILURE: Failed to log security event %s - %s',
-            $originalException->getSecurityEvent()->getEventIdentifier(),
-            $loggingError->getMessage()
-        );
-
-        error_log($fallbackMessage);
-
-        // Versuche minimales Security-Log
-        try {
-            $minimalLog = [
-                'datetime' => date('c'),
-                'event' => $originalException->getSecurityEvent()->getEventIdentifier(),
-                'description' => $originalException->getSecurityEvent()->getDescription(),
-                'level' => 'FATAL',
-                'audit_failure' => true,
-                'original_error' => $loggingError->getMessage(),
-            ];
-
-            error_log('SECURITY_EVENT_FALLBACK: ' . json_encode($minimalLog));
-
-        } catch (Throwable $criticalError) {
-            // Absoluter Fallback
-            error_log('CRITICAL_SECURITY_AUDIT_FAILURE: Unable to log security event');
-        }
-    }
-
-    /**
-     * Factory-Methode mit Standard-Konfiguration
-     */
-    public static function createDefault(?Logger $logger = null): self
-    {
-        // If Logger not provided, cannot create handler
-        if ($logger === null) {
-            throw new \InvalidArgumentException('Logger is required for SecurityEventHandler');
-        }
-
-        $processor = new SecurityEventProcessor();
-        $alertManager = null; // Kann später konfiguriert werden
-
-        return new self($logger, $processor, $alertManager);
-    }
-}
diff --git a/src/Framework/ErrorHandling/SecurityEventLogger.php b/src/Framework/ErrorHandling/SecurityEventLogger.php
deleted file mode 100644
index 02413529..00000000
--- a/src/Framework/ErrorHandling/SecurityEventLogger.php
+++ /dev/null
@@ -1,134 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use App\Framework\Config\AppConfig;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\SecurityException;
-use App\Framework\Exception\SecurityLogLevel;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\LogLevel;
-
-/**
- * Spezialisierter Logger für Security-Events im OWASP-Format
- */
-final readonly class SecurityEventLogger
-{
-    public function __construct(
-        private Logger $logger,
-        private AppConfig $appConfig
-    ) {
-    }
-
-    /**
-     * Loggt Security-Event im OWASP-Format
-     */
-    public function logSecurityEvent(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): void {
-        $securityEvent = $exception->getSecurityEvent();
-
-        // OWASP-konformes Log generieren
-        $owaspLog = $this->createOWASPLog($exception, $context);
-
-        // Strukturiertes Logging über Framework Logger
-        $frameworkLogLevel = $this->mapSecurityLevelToFrameworkLevel($securityEvent->getLogLevel());
-
-        $this->logger->log(
-            $frameworkLogLevel,
-            $securityEvent->getDescription(),
-            [
-                'security_event' => $securityEvent->getEventIdentifier(),
-                'security_category' => $securityEvent->getCategory(),
-                'requires_alert' => $securityEvent->requiresAlert(),
-                'owasp_format' => $owaspLog,
-                'event_data' => $securityEvent->toArray(),
-                'context_data' => $context->forLogging(),
-            ]
-        );
-    }
-
-    /**
-     * Loggt kritische Security-Alerts
-     */
-    public function logCriticalAlert(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): void {
-        $alertData = $this->createAlertData($exception, $context);
-
-        $this->logger->log(
-            LogLevel::CRITICAL,
-            'SECURITY_ALERT: ' . $exception->getSecurityEvent()->getEventIdentifier(),
-            $alertData
-        );
-    }
-
-    /**
-     * Erstellt OWASP-konformes Log-Format
-     */
-    private function createOWASPLog(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): array {
-        $securityEvent = $exception->getSecurityEvent();
-
-        return [
-            'datetime' => date('c'),
-            'appid' => $this->appConfig->name,
-            'event' => $securityEvent->getEventIdentifier(),
-            'level' => $securityEvent->getLogLevel()->value,
-            'description' => $securityEvent->getDescription(),
-            'useragent' => $context->request->userAgent,
-            'source_ip' => $context->request->clientIp,
-            'host_ip' => $context->request->hostIp,
-            'hostname' => $context->request->hostname,
-            'protocol' => $context->request->protocol,
-            'port' => $context->request->port,
-            'request_uri' => $context->request->requestUri,
-            'request_method' => $context->request->requestMethod,
-            'category' => $securityEvent->getCategory(),
-            'requires_alert' => $securityEvent->requiresAlert(),
-        ];
-    }
-
-    /**
-     * Erstellt Alert-Daten für kritische Events
-     */
-    private function createAlertData(
-        SecurityException $exception,
-        ErrorHandlerContext $context
-    ): array {
-        return [
-            'event' => $exception->getSecurityEvent()->getEventIdentifier(),
-            'description' => $exception->getSecurityEvent()->getDescription(),
-            'level' => $exception->getSecurityLevel()->value,
-            'category' => $exception->getSecurityEvent()->getCategory(),
-            'client_ip' => $context->request->clientIp,
-            'user_agent' => $context->request->userAgent,
-            'request_uri' => $context->request->requestUri,
-            'request_method' => $context->request->requestMethod,
-            'timestamp' => date('c'),
-            'request_id' => $context->request->requestId,
-            'event_data' => $exception->getSecurityEvent()->toArray(),
-        ];
-    }
-
-    /**
-     * Mappt SecurityLogLevel auf Framework LogLevel
-     */
-    private function mapSecurityLevelToFrameworkLevel(
-        SecurityLogLevel $securityLevel
-    ): LogLevel {
-        return match($securityLevel) {
-            SecurityLogLevel::DEBUG => LogLevel::DEBUG,
-            SecurityLogLevel::INFO => LogLevel::INFO,
-            SecurityLogLevel::WARN => LogLevel::WARNING,
-            SecurityLogLevel::ERROR => LogLevel::ERROR,
-            SecurityLogLevel::FATAL => LogLevel::CRITICAL,
-        };
-    }
-}
diff --git a/src/Framework/ErrorHandling/StackTrace.php b/src/Framework/ErrorHandling/StackTrace.php
deleted file mode 100644
index 64dc7f53..00000000
--- a/src/Framework/ErrorHandling/StackTrace.php
+++ /dev/null
@@ -1,161 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-use ArrayAccess;
-use ArrayIterator;
-use Countable;
-use IteratorAggregate;
-use Traversable;
-
-/**
- * Stacktrace-Klasse zum Aufbereiten und Darstellen von Exception-Traces
- * Implementiert ArrayAccess, IteratorAggregate und Countable für einfachen Zugriff in Templates
- *
- * Immutable: All properties are readonly, items array is built during construction
- */
-final readonly class StackTrace implements ArrayAccess, IteratorAggregate, Countable
-{
-    /** @var TraceItem[] */
-    public array $items;
-
-    /**
-     * Erstellt ein neues StackTrace-Objekt aus einer Exception
-     */
-    public function __construct(private \Throwable $exception)
-    {
-        $this->items = $this->processTrace($exception->getTrace());
-    }
-
-    /**
-     * Verarbeitet die rohen Trace-Daten in strukturierte TraceItems
-     *
-     * @return TraceItem[]
-     */
-    private function processTrace(array $trace): array
-    {
-        $items = [];
-
-        // Füge den Ursprung der Exception hinzu (file/line aus Exception selbst)
-        $items[] = new TraceItem(
-            file: $this->exception->getFile(),
-            line: $this->exception->getLine(),
-            function: null,
-            class: null,
-            type: null,
-            args: [],
-            isExceptionOrigin: true
-        );
-
-        // Verarbeite den Rest des Stacktraces
-        foreach ($trace as $index => $frame) {
-            $items[] = new TraceItem(
-                file: $frame['file'] ?? '(internal function)',
-                line: $frame['line'] ?? 0,
-                function: $frame['function'] ?? null,
-                class: $frame['class'] ?? null,
-                type: $frame['type'] ?? null,
-                args: $frame['args'] ?? [],
-                isExceptionOrigin: false
-            );
-        }
-
-        return array_reverse($items);
-    }
-
-    /**
-     * Gibt alle Trace-Items zurück
-     *
-     * @return TraceItem[]
-     */
-    public function getItems(): array
-    {
-        return $this->items;
-    }
-
-    /**
-     * Gibt den Ursprung der Exception zurück (erstes Item)
-     */
-    public function getOrigin(): ?TraceItem
-    {
-        return $this->items[0] ?? null;
-    }
-
-    /**
-     * Gibt die ersten N Elemente des Stacktraces zurück
-     */
-    public function getFirst(int $count): array
-    {
-        return array_slice($this->items, 0, $count);
-    }
-
-    /**
-     * Gibt die letzten N Elemente des Stacktraces zurück
-     */
-    public function getLast(int $count): array
-    {
-        return array_slice($this->items, -$count);
-    }
-
-    /**
-     * Filtert den Stacktrace nach bestimmten Kriterien
-     */
-    public function filter(callable $callback): array
-    {
-        return array_filter($this->items, $callback);
-    }
-
-    /**
-     * Implementierung von ArrayAccess
-     */
-    public function offsetExists(mixed $offset): bool
-    {
-        return isset($this->items[$offset]);
-    }
-
-    public function offsetGet(mixed $offset): mixed
-    {
-        return $this->items[$offset] ?? null;
-    }
-
-    public function offsetSet(mixed $offset, mixed $value): void
-    {
-        // Read-only
-    }
-
-    public function offsetUnset(mixed $offset): void
-    {
-        // Read-only
-    }
-
-    /**
-     * Implementierung von IteratorAggregate
-     */
-    public function getIterator(): Traversable
-    {
-        return new ArrayIterator($this->items);
-    }
-
-    /**
-     * Implementierung von Countable
-     */
-    public function count(): int
-    {
-        return count($this->items);
-    }
-
-    /**
-     * Formatiert den gesamten Stacktrace als String
-     */
-    public function __toString(): string
-    {
-        $result = "";
-        foreach ($this->items as $index => $item) {
-            $result .= "#{$index} {$item}\n";
-        }
-
-        return $result;
-    }
-}
diff --git a/src/Framework/ErrorHandling/Templates/debug.view.php b/src/Framework/ErrorHandling/Templates/debug.view.php
deleted file mode 100644
index 1b43e599..00000000
--- a/src/Framework/ErrorHandling/Templates/debug.view.php
+++ /dev/null
@@ -1,571 +0,0 @@
-<!DOCTYPE html>
-<html lang="de">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ $errorClass }}: {{ $errorMessage }}</title>
-    <style>
-        * {
-            margin: 0;
-            padding: 0;
-            box-sizing: border-box;
-        }
-
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-            background: #1a202c;
-            color: #e2e8f0;
-            line-height: 1.6;
-            padding: 20px;
-        }
-
-        .debug-container {
-            max-width: 1400px;
-            margin: 0 auto;
-        }
-
-        .error-header {
-            background: linear-gradient(135deg, #dc2626 0%, #991b1b 100%);
-            border-radius: 12px;
-            padding: 32px;
-            margin-bottom: 24px;
-            box-shadow: 0 4px 20px rgba(220, 38, 38, 0.3);
-            position: relative;
-            overflow: hidden;
-        }
-
-        .error-header::before {
-            content: '';
-            position: absolute;
-            top: 0;
-            left: 0;
-            right: 0;
-            bottom: 0;
-            background: linear-gradient(135deg, rgba(255, 255, 255, 0.1) 0%, transparent 100%);
-            pointer-events: none;
-        }
-
-        .error-class {
-            font-size: 28px;
-            font-weight: 700;
-            color: white;
-            margin-bottom: 12px;
-            text-shadow: 0 2px 4px rgba(0, 0, 0, 0.3);
-            position: relative;
-        }
-
-        .error-message {
-            font-size: 18px;
-            color: #fef3c7;
-            margin-bottom: 16px;
-            font-weight: 500;
-            position: relative;
-        }
-
-        .error-location {
-            font-family: 'Fira Code', 'Courier New', Courier, monospace;
-            font-size: 14px;
-            color: #fecaca;
-            background: rgba(0, 0, 0, 0.3);
-            padding: 12px 16px;
-            border-radius: 8px;
-            border-left: 4px solid #fbbf24;
-            position: relative;
-        }
-
-        .error-location strong {
-            color: #fbbf24;
-            font-weight: 600;
-        }
-
-        .section {
-            background: #2d3748;
-            border-radius: 12px;
-            padding: 24px;
-            margin-bottom: 20px;
-            box-shadow: 0 2px 10px rgba(0, 0, 0, 0.3);
-        }
-
-        .section-title {
-            font-size: 18px;
-            font-weight: 600;
-            color: #f7fafc;
-            margin-bottom: 16px;
-            padding-bottom: 12px;
-            border-bottom: 2px solid #4a5568;
-            display: flex;
-            justify-content: space-between;
-            align-items: center;
-        }
-
-        .section-title.collapsible {
-            cursor: pointer;
-            user-select: none;
-        }
-
-        .section-title.collapsible:hover {
-            color: #667eea;
-        }
-
-        .collapse-icon {
-            font-size: 20px;
-            transition: transform 0.3s;
-            color: #a0aec0;
-        }
-
-        .section-title.collapsed .collapse-icon {
-            transform: rotate(-90deg);
-        }
-
-        .section-content {
-            max-height: 2000px;
-            overflow: hidden;
-            transition: max-height 0.3s ease-out, opacity 0.3s ease-out;
-            opacity: 1;
-        }
-
-        .section-content.collapsed {
-            max-height: 0;
-            opacity: 0;
-        }
-
-        .meta-grid {
-            display: grid;
-            grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
-            gap: 16px;
-        }
-
-        .meta-item {
-            background: #1a202c;
-            padding: 12px;
-            border-radius: 6px;
-            border-left: 3px solid #667eea;
-        }
-
-        .meta-label {
-            font-size: 12px;
-            text-transform: uppercase;
-            letter-spacing: 0.5px;
-            color: #a0aec0;
-            margin-bottom: 4px;
-        }
-
-        .meta-value {
-            font-family: 'Courier New', Courier, monospace;
-            color: #e2e8f0;
-            font-size: 14px;
-            word-break: break-all;
-        }
-
-        .code-preview {
-            position: relative;
-            margin-bottom: 20px;
-        }
-
-        /* Stelle sicher, dass Highlighter-Output nicht überschrieben wird */
-        .code-preview > * {
-            margin: 0;
-        }
-
-        /* Fallback für Code-Darstellung wenn Highlighter fehlt */
-        .code-preview pre {
-            background: #2b2b2b;
-            color: #a9b7c6;
-            padding: 16px;
-            border-radius: 8px;
-            overflow-x: auto;
-            font-family: 'Fira Code', 'Consolas', monospace;
-            font-size: 14px;
-            line-height: 1.5;
-            white-space: pre;
-            tab-size: 4;
-        }
-
-        .code-preview code {
-            font-family: 'Fira Code', 'Consolas', monospace;
-            white-space: pre;
-        }
-
-        /* Copy Button für Code */
-        .copy-button {
-            position: absolute;
-            top: 12px;
-            right: 12px;
-            background: #4a5568;
-            color: white;
-            border: none;
-            padding: 8px 16px;
-            border-radius: 6px;
-            font-size: 12px;
-            font-weight: 600;
-            cursor: pointer;
-            transition: all 0.2s;
-            z-index: 10;
-        }
-
-        .copy-button:hover {
-            background: #667eea;
-            transform: translateY(-2px);
-        }
-
-        .copy-button:active {
-            transform: translateY(0);
-        }
-
-        .copy-button.copied {
-            background: #48bb78;
-        }
-
-        .copy-button.copied::after {
-            content: ' ✓';
-        }
-
-        .trace-item {
-            background: #1a202c;
-            padding: 16px;
-            margin-bottom: 8px;
-            border-radius: 6px;
-            border-left: 3px solid #4a5568;
-            transition: all 0.2s;
-        }
-
-        .trace-item:hover {
-            background: #283141;
-            border-left-color: #667eea;
-        }
-
-        .trace-item.origin {
-            border-left-color: #dc2626;
-            border-left-width: 4px;
-            background: linear-gradient(90deg, rgba(220, 38, 38, 0.15) 0%, #2d1f1f 100%);
-            box-shadow: 0 0 20px rgba(220, 38, 38, 0.2);
-        }
-
-        .trace-item.origin::before {
-            content: '⚠️';
-            position: absolute;
-            left: -12px;
-            top: 50%;
-            transform: translateY(-50%);
-            font-size: 20px;
-        }
-
-        .trace-index {
-            display: inline-block;
-            background: #4a5568;
-            color: white;
-            padding: 4px 10px;
-            border-radius: 4px;
-            font-size: 12px;
-            font-weight: 600;
-            margin-right: 8px;
-        }
-
-        .trace-item.origin .trace-index {
-            background: linear-gradient(135deg, #dc2626 0%, #991b1b 100%);
-            box-shadow: 0 2px 8px rgba(220, 38, 38, 0.3);
-        }
-
-        .trace-function {
-            font-family: 'Courier New', Courier, monospace;
-            color: #9ae6b4;
-            font-size: 14px;
-            margin-bottom: 4px;
-        }
-
-        .trace-location {
-            font-family: 'Courier New', Courier, monospace;
-            color: #90cdf4;
-            font-size: 13px;
-        }
-
-        .trace-filter {
-            margin-bottom: 16px;
-            display: flex;
-            gap: 12px;
-            align-items: center;
-        }
-
-        .trace-filter input {
-            flex: 1;
-            background: #1a202c;
-            border: 2px solid #4a5568;
-            color: #e2e8f0;
-            padding: 10px 16px;
-            border-radius: 8px;
-            font-size: 14px;
-            font-family: 'Courier New', Courier, monospace;
-            transition: border-color 0.2s;
-        }
-
-        .trace-filter input:focus {
-            outline: none;
-            border-color: #667eea;
-        }
-
-        .trace-filter-label {
-            color: #a0aec0;
-            font-size: 14px;
-            font-weight: 500;
-        }
-
-        .trace-stats {
-            color: #a0aec0;
-            font-size: 13px;
-            padding: 8px 12px;
-            background: #1a202c;
-            border-radius: 6px;
-        }
-
-        .dependency-info {
-            background: #78350f;
-            border: 2px solid #fbbf24;
-            border-radius: 8px;
-            padding: 16px;
-            margin-bottom: 20px;
-        }
-
-        .dependency-info h3 {
-            color: #fbbf24;
-            margin-bottom: 8px;
-        }
-
-        @media (max-width: 768px) {
-            .meta-grid {
-                grid-template-columns: 1fr;
-            }
-
-            .error-header {
-                padding: 20px;
-            }
-
-            .section {
-                padding: 16px;
-            }
-        }
-    </style>
-</head>
-<body>
-    <div class="debug-container">
-        <!-- Error Header -->
-        <div class="error-header">
-            <div class="error-class">⚠️ {{ $errorClass }}</div>
-            <div class="error-message">{{ $errorMessage }}</div>
-            <div class="error-location">
-                <strong>📁 File:</strong> {{ $errorFile }}<br>
-                <strong>📍 Line:</strong> {{ $errorLine }}
-            </div>
-        </div>
-
-        <!-- Dependency Info (if available) -->
-        <div if="{{ $dependencyInfo }}">
-            {{ $dependencyInfo }}
-        </div>
-
-        <!-- Request Information -->
-        <div class="section">
-            <h2 class="section-title collapsible collapsed" onclick="toggleSection('request-info')">
-                <span>📋 Request Information</span>
-                <span class="collapse-icon">▼</span>
-            </h2>
-            <div class="section-content collapsed" id="request-info-content">
-                <div class="meta-grid">
-                <div class="meta-item">
-                    <div class="meta-label">Request ID</div>
-                    <div class="meta-value">{{ $requestId }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">HTTP Status</div>
-                    <div class="meta-value">{{ $httpStatus }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Method</div>
-                    <div class="meta-value">{{ $requestMethod }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">URI</div>
-                    <div class="meta-value">{{ $requestUri }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Client IP</div>
-                    <div class="meta-value">{{ $clientIp }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Timestamp</div>
-                    <div class="meta-value">{{ $timestamp }}</div>
-                </div>
-            </div>
-            </div>
-        </div>
-
-        <!-- Code Preview -->
-        <div class="section">
-            <h2 class="section-title">💻 Code Context</h2>
-            <div class="code-preview" id="code-container">
-                <button class="copy-button" onclick="copyCode()" id="copy-code-btn">Copy Code</button>
-                {{ $code }}
-            </div>
-        </div>
-
-        <!-- Stack Trace -->
-        <div class="section" if="{{ $traceCount > 0 }}">
-            <h2 class="section-title collapsible" onclick="toggleSection('stack-trace')">
-                <span>📚 Stack Trace (<span id="trace-count">{{ $traceCount }}</span> frames)</span>
-                <span class="collapse-icon">▼</span>
-            </h2>
-            <div class="section-content" id="stack-trace-content">
-                <div class="trace-filter">
-                    <span class="trace-filter-label">🔍 Filter:</span>
-                    <input
-                        type="text"
-                        id="trace-filter"
-                        placeholder="Search by class, method, or file path..."
-                        oninput="filterStackTrace()"
-                    >
-                    <button class="copy-button" onclick="copyStackTrace()" id="copy-trace-btn" style="position: static; margin: 0;">
-                        Copy Trace
-                    </button>
-                </div>
-                <div foreach="$trace as $item">
-                    <div class="trace-item" if="{{ $item->isOrigin }}">
-                        <span class="trace-index">#{{ $item->index }}</span>
-                        <div class="trace-function">🎯 {{ $item->function }}</div>
-                        <div class="trace-location">{{ $item->file }}:{{ $item->line }}</div>
-                    </div>
-                    <div class="trace-item" if="!{{ $item->isOrigin }}">
-                        <span class="trace-index">#{{ $item->index }}</span>
-                        <div class="trace-function">{{ $item->function }}</div>
-                        <div class="trace-location">{{ $item->file }}:{{ $item->line }}</div>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <!-- System Information -->
-        <div class="section">
-            <h2 class="section-title collapsible collapsed" onclick="toggleSection('system-info')">
-                <span>⚙️ System Information</span>
-                <span class="collapse-icon">▼</span>
-            </h2>
-            <div class="section-content collapsed" id="system-info-content">
-                <div class="meta-grid">
-                <div class="meta-item">
-                    <div class="meta-label">Environment</div>
-                    <div class="meta-value">{{ $environment }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Debug Mode</div>
-                    <div class="meta-value">{{ $debugMode }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">PHP Version</div>
-                    <div class="meta-value">{{ $phpVersion }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Memory Usage</div>
-                    <div class="meta-value">{{ $memory }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Execution Time</div>
-                    <div class="meta-value">{{ $executionTime }}</div>
-                </div>
-                <div class="meta-item">
-                    <div class="meta-label">Memory Limit</div>
-                    <div class="meta-value">{{ $memoryLimit }}</div>
-                </div>
-            </div>
-            </div>
-        </div>
-    </div>
-
-    <script>
-        // Toggle collapsible sections
-        function toggleSection(sectionId) {
-            const content = document.getElementById(sectionId + '-content');
-            const title = content.previousElementSibling;
-
-            content.classList.toggle('collapsed');
-            title.classList.toggle('collapsed');
-        }
-
-        // Copy code to clipboard
-        function copyCode() {
-            const codeContainer = document.getElementById('code-container');
-            const codeElement = codeContainer.querySelector('pre') || codeContainer.querySelector('code');
-
-            if (!codeElement) {
-                return;
-            }
-
-            const text = codeElement.textContent || codeElement.innerText;
-
-            navigator.clipboard.writeText(text).then(() => {
-                const button = document.getElementById('copy-code-btn');
-                button.classList.add('copied');
-                button.textContent = 'Copied!';
-
-                setTimeout(() => {
-                    button.classList.remove('copied');
-                    button.textContent = 'Copy Code';
-                }, 2000);
-            }).catch(err => {
-                console.error('Failed to copy:', err);
-            });
-        }
-
-        // Copy stack trace
-        function copyStackTrace() {
-            const traceContainer = document.getElementById('stack-trace-content');
-            const traceItems = traceContainer.querySelectorAll('.trace-item');
-
-            let text = 'Stack Trace:\n\n';
-            traceItems.forEach(item => {
-                const func = item.querySelector('.trace-function').textContent;
-                const location = item.querySelector('.trace-location').textContent;
-                text += `${func}\n  at ${location}\n\n`;
-            });
-
-            navigator.clipboard.writeText(text).then(() => {
-                const button = document.getElementById('copy-trace-btn');
-                button.classList.add('copied');
-                button.textContent = 'Copied!';
-
-                setTimeout(() => {
-                    button.classList.remove('copied');
-                    button.textContent = 'Copy Trace';
-                }, 2000);
-            }).catch(err => {
-                console.error('Failed to copy:', err);
-            });
-        }
-
-        // Filter stack trace
-        function filterStackTrace() {
-            const input = document.getElementById('trace-filter');
-            const filter = input.value.toLowerCase();
-            const items = document.querySelectorAll('.trace-item');
-            let visibleCount = 0;
-
-            items.forEach(item => {
-                const text = item.textContent.toLowerCase();
-                if (text.includes(filter)) {
-                    item.style.display = '';
-                    visibleCount++;
-                } else {
-                    item.style.display = 'none';
-                }
-            });
-
-            // Update trace count
-            const traceCount = document.getElementById('trace-count');
-            if (traceCount) {
-                if (filter) {
-                    traceCount.textContent = `${visibleCount}/${items.length}`;
-                } else {
-                    traceCount.textContent = items.length;
-                }
-            }
-        }
-    </script>
-</body>
-</html>
diff --git a/src/Framework/ErrorHandling/Templates/production-minimal.view.php b/src/Framework/ErrorHandling/Templates/production-minimal.view.php
deleted file mode 100644
index a99af06e..00000000
--- a/src/Framework/ErrorHandling/Templates/production-minimal.view.php
+++ /dev/null
@@ -1,141 +0,0 @@
-<!DOCTYPE html>
-<html lang="de">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Error {{ $httpStatus }}</title>
-    <style>
-        * {
-            margin: 0;
-            padding: 0;
-            box-sizing: border-box;
-        }
-
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-            background: #1a202c;
-            min-height: 100vh;
-            display: flex;
-            align-items: center;
-            justify-content: center;
-            padding: 20px;
-            color: #e2e8f0;
-        }
-
-        .error-container {
-            background: #2d3748;
-            border-radius: 16px;
-            box-shadow: 0 20px 60px rgba(0, 0, 0, 0.5);
-            max-width: 600px;
-            width: 100%;
-            padding: 48px 32px;
-            text-align: center;
-        }
-
-        .status-code {
-            font-size: 96px;
-            font-weight: 700;
-            color: #667eea;
-            margin-bottom: 24px;
-            line-height: 1;
-        }
-
-        .error-title {
-            font-size: 28px;
-            margin-bottom: 16px;
-            color: #f7fafc;
-            font-weight: 600;
-        }
-
-        .error-message {
-            color: #cbd5e0;
-            line-height: 1.6;
-            margin-bottom: 32px;
-            font-size: 16px;
-        }
-
-        .error-meta {
-            background: #1a202c;
-            padding: 20px;
-            border-radius: 12px;
-            border: 1px solid #4a5568;
-        }
-
-        .meta-item {
-            display: flex;
-            justify-content: space-between;
-            align-items: center;
-            padding: 8px 0;
-            border-bottom: 1px solid #4a5568;
-        }
-
-        .meta-item:last-child {
-            border-bottom: none;
-        }
-
-        .meta-label {
-            font-weight: 600;
-            color: #a0aec0;
-            font-size: 13px;
-            text-transform: uppercase;
-            letter-spacing: 0.5px;
-        }
-
-        .meta-value {
-            font-family: 'Courier New', Courier, monospace;
-            color: #e2e8f0;
-            font-size: 13px;
-            word-break: break-all;
-            max-width: 60%;
-            text-align: right;
-        }
-
-        @media (max-width: 600px) {
-            .error-container {
-                padding: 32px 24px;
-            }
-
-            .status-code {
-                font-size: 72px;
-            }
-
-            .error-title {
-                font-size: 22px;
-            }
-
-            .meta-item {
-                flex-direction: column;
-                align-items: flex-start;
-                gap: 4px;
-            }
-
-            .meta-value {
-                max-width: 100%;
-                text-align: left;
-            }
-        }
-    </style>
-</head>
-<body>
-    <div class="error-container">
-        <div class="status-code">{{ $httpStatus }}</div>
-
-        <h1 class="error-title">{{ $error->message }}</h1>
-
-        <p class="error-message">
-            Bitte versuchen Sie es später erneut oder kontaktieren Sie den Support, falls das Problem bestehen bleibt.
-        </p>
-
-        <div class="error-meta">
-            <div class="meta-item">
-                <span class="meta-label">Request ID</span>
-                <span class="meta-value">{{ $requestId }}</span>
-            </div>
-            <div class="meta-item">
-                <span class="meta-label">Zeitpunkt</span>
-                <span class="meta-value">{{ $timestamp }}</span>
-            </div>
-        </div>
-    </div>
-</body>
-</html>
diff --git a/src/Framework/ErrorHandling/Templates/production.view.php b/src/Framework/ErrorHandling/Templates/production.view.php
deleted file mode 100644
index ca1854f4..00000000
--- a/src/Framework/ErrorHandling/Templates/production.view.php
+++ /dev/null
@@ -1,118 +0,0 @@
-<layout src="main" />
-
-<div class="error-container">
-    <div class="status-code">{{ $httpStatus }}</div>
-
-    <h1 class="error-title">{{ $error->message }}</h1>
-
-    <p class="error-message">
-        Bitte versuchen Sie es später erneut oder kontaktieren Sie den Support, falls das Problem bestehen bleibt.
-    </p>
-
-    <div class="error-meta">
-        <div class="meta-item">
-            <span class="meta-label">Request ID</span>
-            <span class="meta-value">{{ $requestId }}</span>
-        </div>
-        <div class="meta-item">
-            <span class="meta-label">Zeitpunkt</span>
-            <span class="meta-value">{{ $timestamp }}</span>
-        </div>
-    </div>
-</div>
-
-<style>
-    .error-container {
-        max-width: 600px;
-        margin: 80px auto;
-        padding: 48px 32px;
-        text-align: center;
-        background: #2d3748;
-        border-radius: 16px;
-        box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
-    }
-
-    .status-code {
-        font-size: 96px;
-        font-weight: 700;
-        color: #667eea;
-        margin-bottom: 24px;
-        line-height: 1;
-    }
-
-    .error-title {
-        font-size: 28px;
-        margin-bottom: 16px;
-        color: #f7fafc;
-        font-weight: 600;
-    }
-
-    .error-message {
-        color: #cbd5e0;
-        line-height: 1.6;
-        margin-bottom: 32px;
-        font-size: 16px;
-    }
-
-    .error-meta {
-        background: #1a202c;
-        padding: 20px;
-        border-radius: 12px;
-        border: 1px solid #4a5568;
-    }
-
-    .meta-item {
-        display: flex;
-        justify-content: space-between;
-        align-items: center;
-        padding: 8px 0;
-        border-bottom: 1px solid #4a5568;
-    }
-
-    .meta-item:last-child {
-        border-bottom: none;
-    }
-
-    .meta-label {
-        font-weight: 600;
-        color: #a0aec0;
-        font-size: 13px;
-        text-transform: uppercase;
-        letter-spacing: 0.5px;
-    }
-
-    .meta-value {
-        font-family: 'Courier New', Courier, monospace;
-        color: #e2e8f0;
-        font-size: 13px;
-        word-break: break-all;
-        max-width: 60%;
-        text-align: right;
-    }
-
-    @media (max-width: 600px) {
-        .error-container {
-            margin: 40px 20px;
-            padding: 32px 24px;
-        }
-
-        .status-code {
-            font-size: 72px;
-        }
-
-        .error-title {
-            font-size: 22px;
-        }
-
-        .meta-item {
-            flex-direction: column;
-            align-items: flex-start;
-            gap: 4px;
-        }
-
-        .meta-value {
-            max-width: 100%;
-            text-align: left;
-        }
-    }
-</style>
diff --git a/src/Framework/ErrorHandling/TraceItem.php b/src/Framework/ErrorHandling/TraceItem.php
deleted file mode 100644
index 716d2151..00000000
--- a/src/Framework/ErrorHandling/TraceItem.php
+++ /dev/null
@@ -1,150 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling;
-
-/**
- * Repräsentiert einen einzelnen Eintrag im Stacktrace
- */
-final readonly class TraceItem
-{
-    public function __construct(
-        public string $file,
-        public int $line,
-        public ?string $function,
-        public ?string $class,
-        public ?string $type,
-        public array $args,
-        public bool $isExceptionOrigin
-    ) {
-    }
-
-    /**
-     * Gibt den Dateipfad relativ zum Projekt-Root zurück
-     */
-    public function getRelativeFile(bool $namespace = true): string
-    {
-        $projectRoot = dirname(__DIR__, 3); // Annahme: 3 Verzeichnisse zurück zum Projekt-Root
-        $name = str_replace($projectRoot, '', $this->file);
-
-        return $namespace ? $name : $this->removeNamespace($name);
-    }
-
-    /**
-     * Gibt den Klassennamen ohne Namespace zurück
-     */
-    public function getShortClass(): ?string
-    {
-        if (! $this->class) {
-            return null;
-        }
-
-        $parts = explode('\\', $this->class);
-
-        return end($parts);
-    }
-
-    /**
-     * Gibt den Namespace zurück
-     */
-    public function getNamespace(): ?string
-    {
-        if (! $this->class) {
-            return null;
-        }
-
-        $lastSlash = strrpos($this->class, '\\');
-
-        return $lastSlash ? substr($this->class, 0, $lastSlash) : null;
-    }
-
-    /**
-     * Gibt zurück, ob es sich um einen Methodenaufruf handelt
-     */
-    public function isMethod(): bool
-    {
-        return $this->class !== null && $this->function !== null;
-    }
-
-    /**
-     * Gibt zurück, ob es sich um einen Funktionsaufruf handelt
-     */
-    public function isFunction(): bool
-    {
-        return $this->class === null && $this->function !== null;
-    }
-
-    /**
-     * Gibt den Aufruf-String zurück (z.B. "Namespace\Class->method()")
-     */
-    public function getCallString(): string
-    {
-        if ($this->isExceptionOrigin) {
-            return "Exception origin: >>" . $this->file . '<< in Line: ' . $this->line;
-        }
-
-        if ($this->isMethod()) {
-            return $this->getShortClass() . $this->type . $this->function . '(' . $this->formatArgs() . ')';
-        }
-
-        if ($this->isFunction()) {
-            return $this->function . '(' . $this->formatArgs() . ')';
-        }
-
-        return '';
-    }
-
-    /**
-     * Formatiert die Argumente für die Anzeige
-     */
-    private function formatArgs(): string
-    {
-        if (empty($this->args)) {
-            return '';
-        }
-
-        $formatted = [];
-
-        foreach ($this->args as $arg) {
-            $formatted[] = $this->formatArg($arg);
-        }
-
-        return implode(', ', $formatted);
-    }
-
-    /**
-     * Formatiert ein einzelnes Argument für die Anzeige
-     */
-    private function formatArg(mixed $arg): string
-    {
-        return match(true) {
-            is_string($arg) => '"' . (strlen($arg) > 20 ? substr($arg, 0, 20) . '...' : $arg) . '"',
-            is_array($arg) => 'array(' . count($arg) . ')',
-            is_object($arg) => $this->removeNamespace(get_class($arg)),
-            is_bool($arg) => $arg ? 'true' : 'false',
-            is_null($arg) => 'null',
-            default => (string)$arg
-        };
-    }
-
-    private function removeNamespace(string $class): string
-    {
-        $lastSlash = strrpos($class, '\\');
-
-        return $lastSlash ? substr($class, $lastSlash + 1) : $class;
-    }
-
-    /**
-     * String-Repräsentation dieses TraceItems
-     */
-    public function __toString(): string
-    {
-        $locationInfo = $this->file . ':' . $this->line;
-        if ($this->isExceptionOrigin) {
-            return "Exception origin: {$locationInfo}";
-        }
-
-        return $this->getCallString() . " at {$locationInfo}";
-    }
-}
diff --git a/src/Framework/ErrorHandling/ValueObjects/ErrorMetadata.php b/src/Framework/ErrorHandling/ValueObjects/ErrorMetadata.php
deleted file mode 100644
index b05ef92f..00000000
--- a/src/Framework/ErrorHandling/ValueObjects/ErrorMetadata.php
+++ /dev/null
@@ -1,177 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\ValueObjects;
-
-use App\Framework\Exception\Core\ErrorSeverity;
-
-/**
- * Value Object representing error classification metadata.
- *
- * Replaces primitive array pattern in ErrorHandler::createExceptionMetadata()
- * with type-safe, immutable Value Object following framework principles.
- *
- * This is distinct from ExceptionMetadata (behavior control) - this handles
- * error classification and HTTP response metadata.
- */
-final readonly class ErrorMetadata
-{
-    /**
-     * @param string $exceptionClass Fully qualified exception class name
-     * @param ErrorSeverity $errorLevel Error severity level
-     * @param int $httpStatus HTTP status code for response
-     * @param string|null $errorCode Optional error code from FrameworkException
-     * @param string|null $errorCategory Optional error category (e.g., 'AUTH', 'VAL')
-     * @param string|null $errorSeverity Optional severity from ErrorCode
-     * @param bool|null $isRecoverable Whether error is recoverable
-     * @param string|null $recoveryHint Optional hint for recovery (debug mode)
-     * @param array<string, string> $additionalHeaders HTTP headers to add to response
-     */
-    public function __construct(
-        public string $exceptionClass,
-        public ErrorSeverity $errorLevel,
-        public int $httpStatus,
-        public ?string $errorCode = null,
-        public ?string $errorCategory = null,
-        public ?string $errorSeverity = null,
-        public ?bool $isRecoverable = null,
-        public ?string $recoveryHint = null,
-        public array $additionalHeaders = []
-    ) {}
-
-    /**
-     * Create basic metadata for non-FrameworkException errors.
-     */
-    public static function basic(
-        string $exceptionClass,
-        ErrorSeverity $errorLevel,
-        int $httpStatus
-    ): self {
-        return new self(
-            exceptionClass: $exceptionClass,
-            errorLevel: $errorLevel,
-            httpStatus: $httpStatus
-        );
-    }
-
-    /**
-     * Create enhanced metadata for FrameworkException errors.
-     */
-    public static function enhanced(
-        string $exceptionClass,
-        ErrorSeverity $errorLevel,
-        int $httpStatus,
-        string $errorCode,
-        string $errorCategory,
-        string $errorSeverity,
-        bool $isRecoverable,
-        ?string $recoveryHint = null
-    ): self {
-        return new self(
-            exceptionClass: $exceptionClass,
-            errorLevel: $errorLevel,
-            httpStatus: $httpStatus,
-            errorCode: $errorCode,
-            errorCategory: $errorCategory,
-            errorSeverity: $errorSeverity,
-            isRecoverable: $isRecoverable,
-            recoveryHint: $recoveryHint
-        );
-    }
-
-    /**
-     * Add additional HTTP headers (immutable).
-     */
-    public function withAdditionalHeaders(array $headers): self
-    {
-        return new self(
-            exceptionClass: $this->exceptionClass,
-            errorLevel: $this->errorLevel,
-            httpStatus: $this->httpStatus,
-            errorCode: $this->errorCode,
-            errorCategory: $this->errorCategory,
-            errorSeverity: $this->errorSeverity,
-            isRecoverable: $this->isRecoverable,
-            recoveryHint: $this->recoveryHint,
-            additionalHeaders: array_merge($this->additionalHeaders, $headers)
-        );
-    }
-
-    /**
-     * Check if this is enhanced metadata (from FrameworkException).
-     */
-    public function isEnhanced(): bool
-    {
-        return $this->errorCode !== null;
-    }
-
-    /**
-     * Check if metadata has additional headers.
-     */
-    public function hasAdditionalHeaders(): bool
-    {
-        return !empty($this->additionalHeaders);
-    }
-
-    /**
-     * Convert to array for legacy compatibility.
-     *
-     * @return array<string, mixed>
-     */
-    public function toArray(): array
-    {
-        $array = [
-            'exception_class' => $this->exceptionClass,
-            'error_level' => $this->errorLevel->name,
-            'http_status' => $this->httpStatus,
-        ];
-
-        // Add enhanced fields if present
-        if ($this->errorCode !== null) {
-            $array['error_code'] = $this->errorCode;
-        }
-
-        if ($this->errorCategory !== null) {
-            $array['error_category'] = $this->errorCategory;
-        }
-
-        if ($this->errorSeverity !== null) {
-            $array['error_severity'] = $this->errorSeverity;
-        }
-
-        if ($this->isRecoverable !== null) {
-            $array['is_recoverable'] = $this->isRecoverable;
-        }
-
-        if ($this->recoveryHint !== null) {
-            $array['recovery_hint'] = $this->recoveryHint;
-        }
-
-        if (!empty($this->additionalHeaders)) {
-            $array['additional_headers'] = $this->additionalHeaders;
-        }
-
-        return $array;
-    }
-
-    /**
-     * Create from array (for testing/migration).
-     *
-     * @param array<string, mixed> $data
-     */
-    public static function fromArray(array $data): self
-    {
-        return new self(
-            exceptionClass: $data['exception_class'] ?? '',
-            errorLevel: ErrorSeverity::from($data['error_level'] ?? 'ERROR'),
-            httpStatus: $data['http_status'] ?? 500,
-            errorCode: $data['error_code'] ?? null,
-            errorCategory: $data['error_category'] ?? null,
-            errorSeverity: $data['error_severity'] ?? null,
-            isRecoverable: $data['is_recoverable'] ?? null,
-            recoveryHint: $data['recovery_hint'] ?? null,
-            additionalHeaders: $data['additional_headers'] ?? []
-        );
-    }
-}
diff --git a/src/Framework/ErrorHandling/View/ApiErrorRenderer.php b/src/Framework/ErrorHandling/View/ApiErrorRenderer.php
deleted file mode 100644
index 820e6e73..00000000
--- a/src/Framework/ErrorHandling/View/ApiErrorRenderer.php
+++ /dev/null
@@ -1,126 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\View;
-
-use App\Framework\Exception\ErrorHandlerContext;
-
-/**
- * Renderer für API-Fehler im JSON-Format
- */
-final readonly class ApiErrorRenderer implements ErrorViewRendererInterface
-{
-    /**
-     * Rendert einen API-Fehler als JSON basierend auf ErrorHandlerContext
-     */
-    public function renderFromHandlerContext(ErrorHandlerContext $context, bool $isDebug = false): string
-    {
-        $responseData = [
-            'error' => true,
-            'code' => $context->metadata['http_status'] ?? 500,
-            'message' => $this->getUserMessage($context, $isDebug),
-            'requestId' => $context->request->requestId,
-            'timestamp' => date('c'),
-        ];
-
-        // Exception-spezifische Daten hinzufügen
-        if ($errorCode = $this->getErrorCode($context)) {
-            $responseData['errorCode'] = $errorCode;
-        }
-
-        // Security Event Informationen (nur für interne Zwecke)
-        if ($context->exception->metadata['security_event'] ?? false) {
-            $responseData['type'] = 'security_event';
-
-            if (! $isDebug) {
-                // In Production keine Details von Security Events preisgeben
-                $responseData['message'] = 'Invalid request. Please check your input and try again.';
-            }
-        }
-
-        // Rate Limit spezifische Informationen
-        if (isset($context->metadata['additional_headers']['X-RateLimit-Limit'])) {
-            $responseData['rateLimit'] = [
-                'limit' => (int) $context->metadata['additional_headers']['X-RateLimit-Limit'],
-                'remaining' => (int) $context->metadata['additional_headers']['X-RateLimit-Remaining'],
-                'reset' => (int) $context->metadata['additional_headers']['X-RateLimit-Reset'],
-                'retryAfter' => (int) ($context->metadata['additional_headers']['Retry-After'] ?? 0),
-            ];
-        }
-
-        // Debug-Informationen
-        if ($isDebug) {
-            $responseData['debug'] = [
-                'operation' => $context->exception->operation,
-                'component' => $context->exception->component,
-                'exception_class' => $context->metadata['exception_class'],
-                'client_ip' => $context->request->clientIp,
-                'request_method' => $context->request->requestMethod,
-                'request_uri' => $context->request->requestUri,
-                'user_agent' => $context->request->userAgent,
-                'memory_usage' => $context->system->memoryUsage ?? 0,
-                'execution_time' => $context->system->executionTime ?? 0,
-            ];
-
-            // Exception-spezifische Debug-Daten
-            if (! empty($context->exception->data)) {
-                $responseData['debug']['exception_data'] = $context->exception->data;
-            }
-
-            if (! empty($context->exception->debug)) {
-                $responseData['debug']['exception_debug'] = $context->exception->debug;
-            }
-        }
-
-        return json_encode($responseData, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
-    }
-
-    /**
-     * Extrahiert benutzerfreundliche Nachricht aus ErrorHandlerContext
-     */
-    private function getUserMessage(ErrorHandlerContext $context, bool $isDebug): string
-    {
-        // Bei Debug-Modus die technische Nachricht verwenden
-        if ($isDebug && isset($context->exception->data['exception_message'])) {
-            return $context->exception->data['exception_message'];
-        }
-
-        // Exception-spezifische Nachrichten verwenden falls verfügbar
-        if (isset($context->exception->data['user_message'])) {
-            return $context->exception->data['user_message'];
-        }
-
-        // Fallback auf generische Nachrichten basierend auf HTTP-Status
-        return match ($context->metadata['http_status'] ?? 500) {
-            400 => 'Bad Request: Invalid input provided.',
-            401 => 'Unauthorized: Authentication required.',
-            403 => 'Forbidden: Insufficient permissions.',
-            404 => 'Not Found: The requested resource was not found.',
-            413 => 'Payload Too Large: Request size exceeds limit.',
-            415 => 'Unsupported Media Type: Invalid content type.',
-            423 => 'Locked: Account or resource is temporarily locked.',
-            429 => 'Too Many Requests: Rate limit exceeded.',
-            500 => 'Internal Server Error: An unexpected error occurred.',
-            default => 'An error occurred while processing your request.',
-        };
-    }
-
-    /**
-     * Extrahiert Error-Code aus ErrorHandlerContext
-     */
-    private function getErrorCode(ErrorHandlerContext $context): ?string
-    {
-        // Aus Exception-Daten extrahieren
-        if (isset($context->exception->data['error_code'])) {
-            return $context->exception->data['error_code'];
-        }
-
-        // Aus Metadata extrahieren
-        if (isset($context->exception->metadata['error_code'])) {
-            return $context->exception->metadata['error_code'];
-        }
-
-        return null;
-    }
-}
diff --git a/src/Framework/ErrorHandling/View/ErrorResponseFactory.php b/src/Framework/ErrorHandling/View/ErrorResponseFactory.php
deleted file mode 100644
index b4c6dafd..00000000
--- a/src/Framework/ErrorHandling/View/ErrorResponseFactory.php
+++ /dev/null
@@ -1,102 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\View;
-
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Http\Headers;
-use App\Framework\Http\HttpResponse;
-use App\Framework\Http\Status;
-
-/**
- * Factory für HTTP-Fehlermeldungen
- */
-final readonly class ErrorResponseFactory
-{
-    public function __construct(
-        private ErrorViewRendererInterface $htmlRenderer,
-        private ErrorViewRendererInterface $apiRenderer
-    ) {
-    }
-
-    /**
-     * Erstellt eine HTTP-Response basierend auf dem ErrorHandlerContext
-     */
-    public function createResponseFromHandlerContext(ErrorHandlerContext $context, bool $isDebug = false, bool $isApiRequest = false): HttpResponse
-    {
-        // HTTP-Status aus Metadata extrahieren
-        $status = $context->metadata['http_status'] ?? 500;
-
-        // Headers aufbauen
-        $headers = new Headers();
-
-        // Content-Type basierend auf Request-Typ
-        if ($isApiRequest) {
-            $headers = $headers->with('Content-Type', 'application/json; charset=utf-8');
-            $body = $this->apiRenderer->renderFromHandlerContext($context, $isDebug);
-        } else {
-            $headers = $headers->with('Content-Type', 'text/html; charset=utf-8');
-            $body = $this->htmlRenderer->renderFromHandlerContext($context, $isDebug);
-        }
-
-        // Exception-spezifische Header hinzufügen
-        if (isset($context->metadata['additional_headers'])) {
-            foreach ($context->metadata['additional_headers'] as $name => $value) {
-                $headers = $headers->with($name, $value);
-            }
-        }
-
-        // Standard Security Header
-        $headers = $headers
-            ->with('Cache-Control', 'no-store, no-cache, must-revalidate')
-            ->with('X-Content-Type-Options', 'nosniff')
-            ->with('X-Frame-Options', 'DENY');
-
-        // Security Event Header für Security-Exceptions
-        if ($context->exception->metadata['security_event'] ?? false) {
-            $headers = $headers->with('X-Security-Event', 'true');
-
-            // Request-ID für Security-Tracking
-            $headers = $headers->with('X-Request-ID', $context->request->requestId?->toString() ?? 'unknown');
-        }
-
-        return new HttpResponse(
-            status: Status::from($status),
-            headers: $headers,
-            body: $body
-        );
-    }
-
-    /**
-     * Bestimmt, ob es sich um eine API-Anfrage handelt
-     */
-    public function isApiRequest(): bool
-    {
-        // Accept-Header prüfen
-        $acceptHeader = $_SERVER['HTTP_ACCEPT'] ?? '';
-        if (str_contains($acceptHeader, 'application/json')) {
-            return true;
-        }
-
-        // URL-Pfad prüfen (z.B. /api/...)
-        $requestUri = $_SERVER['REQUEST_URI'] ?? '';
-        if (str_starts_with($requestUri, '/api/')) {
-            return true;
-        }
-
-        // Content-Type prüfen
-        $contentType = $_SERVER['CONTENT_TYPE'] ?? '';
-        if (str_contains($contentType, 'application/json')) {
-            return true;
-        }
-
-        // X-Requested-With Header prüfen (für AJAX)
-        $requestedWith = $_SERVER['HTTP_X_REQUESTED_WITH'] ?? '';
-        if (strtolower($requestedWith) === 'xmlhttprequest') {
-            return true;
-        }
-
-        return false;
-    }
-}
diff --git a/src/Framework/ErrorHandling/View/ErrorTemplateRenderer.php b/src/Framework/ErrorHandling/View/ErrorTemplateRenderer.php
deleted file mode 100644
index 8bd5766a..00000000
--- a/src/Framework/ErrorHandling/View/ErrorTemplateRenderer.php
+++ /dev/null
@@ -1,323 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\View;
-
-use App\Framework\Config\AppConfig;
-use App\Framework\Core\ValueObjects\Byte;
-use App\Framework\Core\ValueObjects\Duration;
-use App\Framework\ErrorHandling\StackTrace;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Meta\MetaData;
-use App\Framework\Meta\OpenGraphTypeWebsite;
-use App\Framework\SyntaxHighlighter\FileHighlighter;
-use App\Framework\View\RawHtml;
-use App\Framework\View\RenderContext;
-use App\Framework\View\TemplateRenderer;
-use Throwable;
-
-/**
- * Renderer für Fehlerseiten mit intelligenter Fallback-Kaskade
- *
- * Fallback-Strategie:
- * - Production: production.view.php (mit Layout) → production-minimal.view.php → fallback.html
- * - Debug: debug.view.php → fallback.html
- */
-final readonly class ErrorTemplateRenderer implements ErrorViewRendererInterface
-{
-    public function __construct(
-        private TemplateRenderer $renderer,
-        private AppConfig $appConfig
-    ) {
-    }
-
-    /**
-     * Rendert eine Fehlerseite basierend auf dem ErrorHandlerContext
-     */
-    public function renderFromHandlerContext(ErrorHandlerContext $context, bool $isDebug = false): string
-    {
-        if ($isDebug) {
-            return $this->renderDebugError($context);
-        }
-
-        return $this->renderProductionError($context);
-    }
-
-    /**
-     * Production Error mit 3-Stufen Fallback-Kaskade
-     *
-     * Level 1: production.view.php (mit Layout - beste UX)
-     * Level 2: production-minimal.view.php (standalone - robuster)
-     * Level 3: fallback.html (statisch - immer verfügbar)
-     */
-    private function renderProductionError(ErrorHandlerContext $context): string
-    {
-        // Level 1: Mit Layout (bevorzugt)
-        try {
-            return $this->renderTemplate('production', $context, isDebug: false);
-        } catch (Throwable $e) {
-            // Level 2: Ohne Layout (Fallback)
-            try {
-                return $this->renderTemplate('production-minimal', $context, isDebug: false);
-            } catch (Throwable $e) {
-                // Level 3: Statischer Fallback
-                return $this->renderStaticFallback($context);
-            }
-        }
-    }
-
-    /**
-     * Debug Error mit 2-Stufen Fallback-Kaskade
-     *
-     * Level 1: debug.view.php (standalone - maximaler Fokus)
-     * Level 2: fallback.html (statisch - immer verfügbar)
-     */
-    private function renderDebugError(ErrorHandlerContext $context): string
-    {
-        // Level 1: Debug Template (standalone)
-        try {
-            return $this->renderTemplate('debug', $context, isDebug: true);
-        } catch (Throwable $e) {
-            // Level 2: Statischer Fallback
-            return $this->renderStaticFallback($context);
-        }
-    }
-
-    /**
-     * Rendert ein Error-Template mit vorbereiteten Daten
-     */
-    private function renderTemplate(string $templateName, ErrorHandlerContext $context, bool $isDebug): string
-    {
-        $data = $this->prepareTemplateData($context, $isDebug);
-
-        $renderContext = new RenderContext(
-            template: $templateName,
-            metaData: new MetaData('', '', new OpenGraphTypeWebsite()),
-            data: $data
-        );
-
-        $rendered = $this->renderer->render($renderContext);
-
-        if ($rendered === '') {
-            throw new \RuntimeException("Template '{$templateName}' returned empty string");
-        }
-
-        return $rendered;
-    }
-
-    /**
-     * Bereitet Template-Daten aus ErrorHandlerContext vor
-     */
-    private function prepareTemplateData(ErrorHandlerContext $context, bool $isDebug): array
-    {
-        $data = [
-            // Error Information
-            'errorClass' => $this->extractExceptionClass($context),
-            'errorMessage' => $this->extractErrorMessage($context),
-            'errorFile' => $this->extractErrorFile($context),
-            'errorLine' => $this->extractErrorLine($context),
-            'errorCode' => $context->metadata['http_status'] ?? 500,
-            'error' => (object) [
-                'message' => $this->extractErrorMessage($context),
-                'operation' => $context->exception->operation ?? 'unknown',
-                'component' => $context->exception->component ?? 'Application',
-                'class' => $context->metadata['exception_class'] ?? 'Unknown',
-            ],
-
-            // Request Information
-            'requestId' => $context->request->requestId?->toString() ?? 'unknown',
-            'timestamp' => date('c'),
-            'httpStatus' => $context->metadata['http_status'] ?? 500,
-            'clientIp' => $context->request->clientIp ?? 'Unknown',
-            'requestUri' => $context->request->requestUri ?? '/',
-            'requestMethod' => $context->request->requestMethod ?? 'GET',
-            'userAgent' => (string) ($context->request->userAgent ?? 'Unknown'),
-
-            // System Information
-            'environment' => $this->appConfig->type->value,
-            'debugMode' => $isDebug ? 'Enabled' : 'Disabled',
-            'phpVersion' => PHP_VERSION,
-            'frameworkVersion' => '1.0.0-dev',
-            'memory' => is_int($context->system->memoryUsage)
-                ? Byte::fromBytes($context->system->memoryUsage)->toHumanReadable()
-                : ($context->system->memoryUsage ?? '0 B'),
-            'memoryLimit' => ini_get('memory_limit') ?: 'Unknown',
-            'executionTime' => $context->system->executionTime !== null
-                ? Duration::fromSeconds($context->system->executionTime)->toHumanReadable()
-                : 'N/A',
-
-            // Debug-only data
-            'dependencyInfo' => '',
-            'code' => RawHtml::from(''),
-            'trace' => [],
-            'traceCount' => 0,
-        ];
-
-        // Security Event Handling
-        if ($context->exception->metadata['security_event'] ?? false) {
-            if (! $isDebug) {
-                $data['errorMessage'] = 'Security violation detected. Access denied.';
-                $data['error']->message = 'Security violation detected. Access denied.';
-            }
-        }
-
-        // Add Debug-specific data
-        if ($isDebug) {
-            $this->addDebugData($data, $context);
-        }
-
-        return $data;
-    }
-
-    /**
-     * Fügt Debug-spezifische Daten hinzu (Code Preview, Stack Trace, etc.)
-     */
-    private function addDebugData(array &$data, ErrorHandlerContext $context): void
-    {
-        // Dependency Information
-        if (isset($context->exception->data['dependencyChain'])) {
-            $chain = implode(' → ', $context->exception->data['dependencyChain']);
-            $target = $context->exception->data['class'] ?? 'Unknown';
-
-            $html = sprintf(
-                '<div class="dependency-info">' .
-                '<h3>🔄 Zyklische Abhängigkeit</h3>' .
-                '<p><strong>Kette:</strong><br>%s → %s</p>' .
-                '<p>Die Klasse kann nicht instanziiert werden.</p>' .
-                '</div>',
-                htmlspecialchars($chain, ENT_QUOTES, 'UTF-8'),
-                htmlspecialchars($target, ENT_QUOTES, 'UTF-8')
-            );
-
-            $data['dependencyInfo'] = RawHtml::from($html);
-        }
-
-        // Code Preview
-        $file = $context->exception->data['exception_file'] ?? null;
-        $line = $context->exception->data['exception_line'] ?? null;
-
-        if ($file && $line && is_numeric($line)) {
-            $errorLine = (int) $line;
-            $codeHtml = (new FileHighlighter())($file, max(1, $errorLine - 10), 20, $errorLine);
-            $data['code'] = RawHtml::from($codeHtml);
-        }
-
-        // Stack Trace
-        $exception = $context->exception->data['original_exception'] ??
-                    $context->exception->data['previous_exception'] ??
-                    null;
-
-        if ($exception instanceof Throwable) {
-            $stackTrace = new StackTrace($exception);
-            $traceItems = $stackTrace->getItems();
-
-            $indexedTrace = [];
-            foreach ($traceItems as $index => $item) {
-                $indexedTrace[] = (object) [
-                    'file' => $item->getRelativeFile(),
-                    'line' => $item->line,
-                    'function' => $item->class ? $item->class . $item->type . $item->function : $item->function,
-                    'class' => $item->class,
-                    'index' => $index,
-                    'isOrigin' => $item->isExceptionOrigin,
-                ];
-            }
-
-            $data['trace'] = $indexedTrace;
-            $data['traceCount'] = count($traceItems);
-        }
-    }
-
-    /**
-     * Statischer HTML-Fallback (Level 3 - kann NICHT fehlschlagen)
-     */
-    private function renderStaticFallback(ErrorHandlerContext $context): string
-    {
-        $fallbackPath = __DIR__ . '/../fallback.html';
-
-        if (file_exists($fallbackPath)) {
-            $html = file_get_contents($fallbackPath);
-
-            return str_replace(
-                '{REQUEST_ID}',
-                htmlspecialchars($context->request->requestId?->toString() ?? 'unknown', ENT_QUOTES, 'UTF-8'),
-                $html
-            );
-        }
-
-        // Absolutes Notfall-Minimum
-        return '<!DOCTYPE html><html lang="de"><head><meta charset="UTF-8"><title>503 Service Unavailable</title></head><body><h1>503 Service Unavailable</h1></body></html>';
-    }
-
-    /**
-     * Extrahiert Fehlermeldung aus Context
-     */
-    private function extractErrorMessage(ErrorHandlerContext $context): string
-    {
-        if (isset($context->exception->data['exception_message'])) {
-            return $context->exception->data['exception_message'];
-        }
-
-        if (isset($context->exception->data['message'])) {
-            return $context->exception->data['message'];
-        }
-
-        if (isset($context->exception->data['original_exception']) && $context->exception->data['original_exception'] instanceof Throwable) {
-            return $context->exception->data['original_exception']->getMessage();
-        }
-
-        $operation = $context->exception->operation ?? 'unknown_operation';
-        $component = $context->exception->component ?? 'Application';
-
-        return "Error in {$component} during {$operation}";
-    }
-
-    /**
-     * Extrahiert Exception-Klasse aus Context
-     */
-    private function extractExceptionClass(ErrorHandlerContext $context): string
-    {
-        if (isset($context->metadata['exception_class'])) {
-            return $context->metadata['exception_class'];
-        }
-
-        if (isset($context->exception->data['original_exception']) && $context->exception->data['original_exception'] instanceof Throwable) {
-            return get_class($context->exception->data['original_exception']);
-        }
-
-        return 'Unknown';
-    }
-
-    /**
-     * Extrahiert Fehler-Datei aus Context
-     */
-    private function extractErrorFile(ErrorHandlerContext $context): string
-    {
-        if (isset($context->exception->data['exception_file']) && ! empty($context->exception->data['exception_file'])) {
-            return $context->exception->data['exception_file'];
-        }
-
-        if (isset($context->exception->data['original_exception']) && $context->exception->data['original_exception'] instanceof Throwable) {
-            return $context->exception->data['original_exception']->getFile();
-        }
-
-        return 'Unknown';
-    }
-
-    /**
-     * Extrahiert Fehler-Zeile aus Context
-     */
-    private function extractErrorLine(ErrorHandlerContext $context): int
-    {
-        if (isset($context->exception->data['exception_line']) && is_numeric($context->exception->data['exception_line'])) {
-            return (int) $context->exception->data['exception_line'];
-        }
-
-        if (isset($context->exception->data['original_exception']) && $context->exception->data['original_exception'] instanceof Throwable) {
-            return $context->exception->data['original_exception']->getLine();
-        }
-
-        return 0;
-    }
-}
diff --git a/src/Framework/ErrorHandling/View/ErrorViewRendererInterface.php b/src/Framework/ErrorHandling/View/ErrorViewRendererInterface.php
deleted file mode 100644
index 1475ee6f..00000000
--- a/src/Framework/ErrorHandling/View/ErrorViewRendererInterface.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\ErrorHandling\View;
-
-use App\Framework\Exception\ErrorHandlerContext;
-
-/**
- * Interface für alle Renderer von Fehlerseiten
- */
-interface ErrorViewRendererInterface
-{
-    /**
-     * Rendert eine Fehlerseite basierend auf dem ErrorHandlerContext
-     */
-    public function renderFromHandlerContext(ErrorHandlerContext $context, bool $isDebug = false): string;
-}
diff --git a/src/Framework/ErrorHandling/fallback.html b/src/Framework/ErrorHandling/fallback.html
deleted file mode 100644
index e0542c8d..00000000
--- a/src/Framework/ErrorHandling/fallback.html
+++ /dev/null
@@ -1,106 +0,0 @@
-<!DOCTYPE html>
-<html lang="de">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Service Unavailable</title>
-    <style>
-        * {
-            margin: 0;
-            padding: 0;
-            box-sizing: border-box;
-        }
-
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-            background: #1a202c;
-            min-height: 100vh;
-            display: flex;
-            align-items: center;
-            justify-content: center;
-            padding: 20px;
-        }
-
-        .container {
-            background: #2d3748;
-            border-radius: 16px;
-            box-shadow: 0 20px 60px rgba(0, 0, 0, 0.5);
-            max-width: 500px;
-            width: 100%;
-            padding: 48px 32px;
-            text-align: center;
-        }
-
-        .status {
-            font-size: 72px;
-            font-weight: 700;
-            color: #667eea;
-            margin-bottom: 16px;
-            line-height: 1;
-        }
-
-        h1 {
-            font-size: 24px;
-            margin-bottom: 16px;
-            color: #f7fafc;
-            font-weight: 600;
-        }
-
-        p {
-            color: #cbd5e0;
-            line-height: 1.6;
-            margin-bottom: 24px;
-            font-size: 16px;
-        }
-
-        .request-id {
-            font-family: 'Courier New', Courier, monospace;
-            background: #1a202c;
-            padding: 12px 16px;
-            border-radius: 8px;
-            font-size: 13px;
-            color: #e2e8f0;
-            word-break: break-all;
-            border: 1px solid #4a5568;
-        }
-
-        .request-id strong {
-            display: block;
-            margin-bottom: 4px;
-            color: #a0aec0;
-            font-size: 12px;
-            text-transform: uppercase;
-            letter-spacing: 0.5px;
-        }
-
-        @media (max-width: 600px) {
-            .container {
-                padding: 32px 24px;
-            }
-
-            .status {
-                font-size: 56px;
-            }
-
-            h1 {
-                font-size: 20px;
-            }
-
-            p {
-                font-size: 14px;
-            }
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <div class="status">503</div>
-        <h1>Service Temporarily Unavailable</h1>
-        <p>We're experiencing technical difficulties. Our team has been notified and is working on a solution.</p>
-        <div class="request-id">
-            <strong>Request ID</strong>
-            {REQUEST_ID}
-        </div>
-    </div>
-</body>
-</html>
diff --git a/src/Framework/EventBus/EventHandlerMapper.php b/src/Framework/EventBus/EventHandlerMapper.php
index 29608363..c7fdcf8c 100644
--- a/src/Framework/EventBus/EventHandlerMapper.php
+++ b/src/Framework/EventBus/EventHandlerMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\EventBus;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 /**
  * Mapper für das EventHandler-Attribut
diff --git a/src/Framework/Exception/Authentication/AccountLockedException.php b/src/Framework/Exception/Authentication/AccountLockedException.php
index 80235a8e..1e7b6414 100644
--- a/src/Framework/Exception/Authentication/AccountLockedException.php
+++ b/src/Framework/Exception/Authentication/AccountLockedException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Authentication;
 
 use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -30,32 +29,10 @@ final class AccountLockedException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "User {$this->identifier} account locked after {$this->failedAttempts} failed attempts";
 
-        $unlockTime = new \DateTimeImmutable("+{$this->lockDurationMinutes} minutes");
-
-        $context = ExceptionContext::forOperation('authentication.account_lock', 'Auth')
-            ->withData([
-                'user_identifier' => $this->identifier,
-                'failed_attempts' => $this->failedAttempts,
-                'lock_duration_minutes' => $this->lockDurationMinutes,
-                'unlock_time' => $unlockTime->format('Y-m-d H:i:s'),
-                'event_identifier' => "authn_account_locked:{$this->identifier},{$this->failedAttempts}",
-                'category' => 'authentication',
-                'requires_alert' => true, // Account-Sperrungen sind immer alert-würdig
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'WARN',
-                'critical_security_event' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 423, // Locked
-            previous: $previous,
-            errorCode: AuthErrorCode::USER_LOCKED,
-            retryAfter: $this->lockDurationMinutes * 60 // Retry nach Sperrzeit in Sekunden
+            code: (int) AuthErrorCode::USER_LOCKED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Authentication/InsufficientPrivilegesException.php b/src/Framework/Exception/Authentication/InsufficientPrivilegesException.php
index 3021c674..0654dbbb 100644
--- a/src/Framework/Exception/Authentication/InsufficientPrivilegesException.php
+++ b/src/Framework/Exception/Authentication/InsufficientPrivilegesException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Authentication;
 
 use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -34,31 +33,10 @@ final class InsufficientPrivilegesException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "User {$this->userId} access denied to {$this->resource}";
 
-        $context = ExceptionContext::forOperation('authorization.access_check', 'Auth')
-            ->withData([
-                'user_identifier' => $this->userId,
-                'resource' => $this->resource,
-                'action' => $this->action,
-                'required_roles' => $this->requiredRoles,
-                'user_roles' => $this->userRoles,
-                'missing_roles' => $this->getMissingRoles(),
-                'event_identifier' => "authz_access_denied:{$this->userId},{$this->resource}",
-                'category' => 'authorization',
-                'requires_alert' => $this->requiresAlert(),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'WARN',
-                'authorization_failure' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 403, // Forbidden
-            previous: $previous,
-            errorCode: AuthErrorCode::INSUFFICIENT_PRIVILEGES
+            code: (int) AuthErrorCode::INSUFFICIENT_PRIVILEGES->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Authentication/InvalidCredentialsException.php b/src/Framework/Exception/Authentication/InvalidCredentialsException.php
index a91a8c6d..cfb0881d 100644
--- a/src/Framework/Exception/Authentication/InvalidCredentialsException.php
+++ b/src/Framework/Exception/Authentication/InvalidCredentialsException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Authentication;
 
 use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -30,27 +29,10 @@ final class InvalidCredentialsException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "User {$this->identifier} authentication failure";
 
-        $context = ExceptionContext::forOperation('authentication.login', 'Auth')
-            ->withData([
-                'user_identifier' => $this->identifier,
-                'failure_reason' => $this->reason,
-                'attempt_count' => $this->attemptCount,
-                'event_identifier' => "authn_login_fail:{$this->identifier}",
-                'category' => 'authentication',
-                'requires_alert' => $this->attemptCount >= 3, // Alert ab 3 Versuchen
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'WARN',
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 401, // Unauthorized
-            previous: $previous,
-            errorCode: AuthErrorCode::CREDENTIALS_INVALID
+            code: (int) AuthErrorCode::CREDENTIALS_INVALID->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Authentication/SessionTimeoutException.php b/src/Framework/Exception/Authentication/SessionTimeoutException.php
index 30788452..b6871f90 100644
--- a/src/Framework/Exception/Authentication/SessionTimeoutException.php
+++ b/src/Framework/Exception/Authentication/SessionTimeoutException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Authentication;
 
 use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -32,29 +31,10 @@ final class SessionTimeoutException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "User {$this->userId} session timeout after {$this->timeoutMinutes} minutes of {$this->reason}";
 
-        $context = ExceptionContext::forOperation('authentication.session_timeout', 'Auth')
-            ->withData([
-                'session_id' => $this->sessionId,
-                'user_identifier' => $this->userId,
-                'timeout_minutes' => $this->timeoutMinutes,
-                'timeout_reason' => $this->reason,
-                'event_identifier' => "session_timeout:{$this->userId},{$this->reason}",
-                'category' => 'session_management',
-                'requires_alert' => false, // Session-Timeouts sind normal
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'INFO',
-                'session_management' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 401, // Unauthorized
-            previous: $previous,
-            errorCode: AuthErrorCode::SESSION_EXPIRED
+            code: (int) AuthErrorCode::SESSION_EXPIRED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Authentication/TokenExpiredException.php b/src/Framework/Exception/Authentication/TokenExpiredException.php
index 0ff936cb..8d94b025 100644
--- a/src/Framework/Exception/Authentication/TokenExpiredException.php
+++ b/src/Framework/Exception/Authentication/TokenExpiredException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Authentication;
 
 use App\Framework\Exception\Core\AuthErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -30,29 +29,10 @@ final class TokenExpiredException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "User {$this->identifier} {$this->tokenType} token expired";
 
-        $context = ExceptionContext::forOperation('authentication.token_validation', 'Auth')
-            ->withData([
-                'token_type' => $this->tokenType,
-                'user_identifier' => $this->identifier,
-                'expired_at' => $this->expiredAt->format('Y-m-d H:i:s'),
-                'expired_since_seconds' => $this->getExpiredSinceSeconds(),
-                'event_identifier' => "authn_token_expired:{$this->identifier},{$this->tokenType}",
-                'category' => 'authentication',
-                'requires_alert' => false, // Token-Ablauf ist normal
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'INFO',
-                'token_expired' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 401, // Unauthorized
-            previous: $previous,
-            errorCode: AuthErrorCode::TOKEN_EXPIRED
+            code: (int) AuthErrorCode::TOKEN_EXPIRED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/ConsoleException.php b/src/Framework/Exception/ConsoleException.php
index a7f13d8d..89a19acd 100644
--- a/src/Framework/Exception/ConsoleException.php
+++ b/src/Framework/Exception/ConsoleException.php
@@ -8,36 +8,16 @@ final class ConsoleException extends FrameworkException
 {
     public static function commandFailed(string $command, int $exitCode, string $output = ''): self
     {
-        $context = ExceptionContext::forOperation('console.command', 'ConsoleRunner')
-            ->withData([
-                'command' => $command,
-                'exit_code' => $exitCode,
-                'output' => $output,
-                'working_directory' => getcwd(),
-            ]);
-
-        return new self("Console command failed: {$command}", $exitCode, null, $context);
+        return new self("Console command failed: {$command}", $exitCode);
     }
 
     public static function commandNotFound(string $command): self
     {
-        $context = ExceptionContext::forOperation('console.command_lookup', 'ConsoleRunner')
-            ->withData([
-                'command' => $command,
-            ]);
-
-        return new self("Console command not found: {$command}", 404, null, $context);
+        return new self("Console command not found: {$command}", 404);
     }
 
     public static function invalidArguments(string $command, array $arguments, array $errors): self
     {
-        $context = ExceptionContext::forOperation('console.argument_validation', 'ConsoleRunner')
-            ->withData([
-                'command' => $command,
-                'arguments' => $arguments,
-                'validation_errors' => $errors,
-            ]);
-
-        return new self("Invalid arguments for command: {$command}", 400, null, $context);
+        return new self("Invalid arguments for command: {$command}", 400);
     }
 }
diff --git a/src/Framework/Exception/DatabaseException.php b/src/Framework/Exception/DatabaseException.php
index 1572aa68..69d7873e 100644
--- a/src/Framework/Exception/DatabaseException.php
+++ b/src/Framework/Exception/DatabaseException.php
@@ -15,16 +15,12 @@ class DatabaseException extends FrameworkException
         ?string $details = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.connect', 'Database')
-            ->withData(['details' => $details]);
+        $message = $details ? "Database connection failed: $details" : 'Database connection failed';
 
-        $message = $details ? "Database connection failed: $details" : null;
-
-        return static::create(
-            Core\DatabaseErrorCode::CONNECTION_FAILED,
-            $message,
-            $context,
-            $previous
+        return new static(
+            message: $message,
+            code: (int) Core\DatabaseErrorCode::CONNECTION_FAILED->value,
+            previous: $previous
         );
     }
 
@@ -33,15 +29,10 @@ class DatabaseException extends FrameworkException
         ?string $error = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.query', 'Database')
-            ->withData(['sql' => $sql, 'error' => $error])
-            ->withDebug(['query_length' => strlen($sql)]);
-
-        return static::create(
-            Core\DatabaseErrorCode::QUERY_FAILED,
-            "Query execution failed: $error",
-            $context,
-            $previous
+        return new static(
+            message: "Query execution failed: $error",
+            code: (int) Core\DatabaseErrorCode::QUERY_FAILED->value,
+            previous: $previous
         );
     }
 
@@ -51,18 +42,10 @@ class DatabaseException extends FrameworkException
         ?array $data = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.constraint', 'Database')
-            ->withData([
-                'constraint' => $constraint,
-                'table' => $table,
-                'violation_data' => $data,
-            ]);
-
-        return static::create(
-            Core\DatabaseErrorCode::CONSTRAINT_VIOLATION,
-            "Database constraint violation: $constraint" . ($table ? " on table $table" : ''),
-            $context,
-            $previous
+        return new static(
+            message: "Database constraint violation: $constraint" . ($table ? " on table $table" : ''),
+            code: (int) Core\DatabaseErrorCode::CONSTRAINT_VIOLATION->value,
+            previous: $previous
         );
     }
 
@@ -71,14 +54,10 @@ class DatabaseException extends FrameworkException
         ?array $operations = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.transaction', 'Database')
-            ->withData(['details' => $details, 'operations' => $operations]);
-
-        return static::create(
-            Core\DatabaseErrorCode::TRANSACTION_FAILED,
-            "Transaction failed: $details",
-            $context,
-            $previous
+        return new static(
+            message: "Transaction failed: $details",
+            code: (int) Core\DatabaseErrorCode::TRANSACTION_FAILED->value,
+            previous: $previous
         );
     }
 
@@ -87,18 +66,10 @@ class DatabaseException extends FrameworkException
         int $currentConnections,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.pool', 'Database')
-            ->withData([
-                'max_connections' => $maxConnections,
-                'current_connections' => $currentConnections,
-                'usage_percentage' => round(($currentConnections / $maxConnections) * 100, 2),
-            ]);
-
-        return static::create(
-            Core\DatabaseErrorCode::POOL_EXHAUSTED,
-            "Connection pool exhausted ($currentConnections/$maxConnections)",
-            $context,
-            $previous
+        return new static(
+            message: "Connection pool exhausted ($currentConnections/$maxConnections)",
+            code: (int) Core\DatabaseErrorCode::POOL_EXHAUSTED->value,
+            previous: $previous
         );
     }
 
@@ -108,18 +79,10 @@ class DatabaseException extends FrameworkException
         ?string $details = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation("database.$operation", 'Database')
-            ->withData([
-                'timeout_seconds' => $timeoutSeconds,
-                'operation' => $operation,
-                'details' => $details,
-            ]);
-
-        return static::create(
-            Core\DatabaseErrorCode::TIMEOUT,
-            "Database operation '$operation' timed out after {$timeoutSeconds}s",
-            $context,
-            $previous
+        return new static(
+            message: "Database operation '$operation' timed out after {$timeoutSeconds}s",
+            code: (int) Core\DatabaseErrorCode::TIMEOUT->value,
+            previous: $previous
         );
     }
 
@@ -129,18 +92,10 @@ class DatabaseException extends FrameworkException
         ?string $version = null,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation('database.migration', 'Database')
-            ->withData([
-                'migration' => $migrationName,
-                'version' => $version,
-                'error' => $error,
-            ]);
-
-        return static::create(
-            Core\DatabaseErrorCode::MIGRATION_FAILED,
-            "Migration '$migrationName' failed: $error",
-            $context,
-            $previous
+        return new static(
+            message: "Migration '$migrationName' failed: $error",
+            code: (int) Core\DatabaseErrorCode::MIGRATION_FAILED->value,
+            previous: $previous
         );
     }
 }
diff --git a/src/Framework/Exception/DirectoryCreateException.php b/src/Framework/Exception/DirectoryCreateException.php
index 8a36b129..6aed84d5 100644
--- a/src/Framework/Exception/DirectoryCreateException.php
+++ b/src/Framework/Exception/DirectoryCreateException.php
@@ -11,20 +11,10 @@ final class DirectoryCreateException extends FrameworkException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('filesystem.create_directory', 'FileSystem')
-            ->withData([
-                'directory' => $directory,
-                'permissions' => is_dir(dirname($directory)) ? decoct(fileperms(dirname($directory))) : 'unknown',
-                'parent_exists' => is_dir(dirname($directory)),
-                'parent_writable' => is_writable(dirname($directory)),
-                'disk_free_space' => disk_free_space(dirname($directory)),
-            ]);
-
         parent::__construct(
             message: "Ordner '$directory' konnte nicht angelegt werden.",
             code: $code,
-            previous: $previous,
-            context: $context
+            previous: $previous
         );
     }
 }
diff --git a/src/Framework/Exception/DirectoryListException.php b/src/Framework/Exception/DirectoryListException.php
index 7c7072b3..beb3d167 100644
--- a/src/Framework/Exception/DirectoryListException.php
+++ b/src/Framework/Exception/DirectoryListException.php
@@ -11,20 +11,10 @@ final class DirectoryListException extends FrameworkException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('filesystem.list_directory', 'FileSystem')
-            ->withData([
-                'directory' => $directory,
-                'exists' => is_dir($directory),
-                'readable' => is_readable($directory),
-                'permissions' => is_dir($directory) ? decoct(fileperms($directory)) : 'unknown',
-                'file_count' => is_readable($directory) ? count(scandir($directory)) - 2 : 'unknown',
-            ]);
-
         parent::__construct(
             message: "Fehler beim Auslesen des Verzeichnisses '$directory'.",
             code: $code,
-            previous: $previous,
-            context: $context
+            previous: $previous
         );
     }
 }
diff --git a/src/Framework/Exception/ExceptionContext.php b/src/Framework/Exception/ExceptionContext.php
index 8e2babe8..a3d82f25 100644
--- a/src/Framework/Exception/ExceptionContext.php
+++ b/src/Framework/Exception/ExceptionContext.php
@@ -6,6 +6,13 @@ namespace App\Framework\Exception;
 
 /**
  * Fachlicher Kontext für Exceptions - nur domain-spezifische Informationen
+ *
+ * @deprecated Use App\Framework\ExceptionHandling\Context\ExceptionContextData instead.
+ * This class is kept for backward compatibility but will be removed in a future version.
+ * Migration: Replace ExceptionContext with ExceptionContextData which provides:
+ * - External context management via WeakMap (no memory leaks)
+ * - Additional fields (userId, requestId, sessionId, clientIp, userAgent, tags)
+ * - Audit logging support (auditable, auditLevel)
  */
 final readonly class ExceptionContext
 {
diff --git a/src/Framework/Exception/ExceptionMetadata.php b/src/Framework/Exception/ExceptionMetadata.php
index 9be9a428..954cbf9d 100644
--- a/src/Framework/Exception/ExceptionMetadata.php
+++ b/src/Framework/Exception/ExceptionMetadata.php
@@ -22,6 +22,8 @@ final readonly class ExceptionMetadata
         public bool $skipReporting = false,
         public bool $reported = false,
         public ?int $retryAfter = null,
+        public int $maxRetries = 3,
+        public string $retryStrategy = 'exponential_backoff',
     ) {}
 
     /**
diff --git a/src/Framework/Exception/FrameworkException.php b/src/Framework/Exception/FrameworkException.php
index 545cb298..99dc0956 100644
--- a/src/Framework/Exception/FrameworkException.php
+++ b/src/Framework/Exception/FrameworkException.php
@@ -6,373 +6,26 @@ namespace App\Framework\Exception;
 
 use RuntimeException;
 
+/**
+ * Base Framework Exception
+ *
+ * Ultra-slim exception following standard PHP exception pattern.
+ * All child exceptions should use standard constructor signature.
+ */
 class FrameworkException extends RuntimeException
 {
-    protected ExceptionContext $context;
-
-    protected ?ErrorCode $errorCode;
-
-    protected ExceptionMetadata $metadata;
-
+    /**
+     * Standard PHP exception constructor
+     *
+     * @param string $message Error message
+     * @param int $code Error code
+     * @param \Throwable|null $previous Previous exception
+     */
     public function __construct(
-        string $message,
-        ExceptionContext $context,
+        string $message = '',
         int $code = 0,
-        ?\Throwable $previous = null,
-        ?ErrorCode $errorCode = null,
-        ?ExceptionMetadata $metadata = null
+        ?\Throwable $previous = null
     ) {
         parent::__construct($message, $code, $previous);
-        $this->context = $context;
-        $this->errorCode = $errorCode;
-
-        // Initialize metadata with retry from ErrorCode if available
-        $retryAfter = $metadata?->retryAfter ?? $errorCode?->getRetryAfterSeconds();
-        $this->metadata = $metadata ?? ExceptionMetadata::default();
-
-        // Update metadata with retry if not already set
-        if ($retryAfter !== null && $this->metadata->retryAfter === null) {
-            $this->metadata = $this->metadata->withRetryAfter($retryAfter);
-        }
-    }
-
-    public function getContext(): ExceptionContext
-    {
-        return $this->context;
-    }
-
-    public function getMetadata(): ExceptionMetadata
-    {
-        return $this->metadata;
-    }
-
-    public function __clone(): void
-    {
-        // Allow cloning of the exception for immutable modifications
-    }
-
-    public function withContext(ExceptionContext $context): self
-    {
-        return new static(
-            $this->getMessage(),
-            $context,
-            $this->getCode(),
-            $this->getPrevious(),
-            $this->errorCode,
-            $this->metadata
-        );
-    }
-
-    public function withMetadata(ExceptionMetadata $metadata): self
-    {
-        return new static(
-            $this->getMessage(),
-            $this->context,
-            $this->getCode(),
-            $this->getPrevious(),
-            $this->errorCode,
-            $metadata
-        );
-    }
-
-    public function withOperation(string $operation, ?string $component = null): self
-    {
-        return $this->withContext(
-            $this->context->withOperation($operation, $component)
-        );
-    }
-
-    public function withData(array $data): self
-    {
-        return $this->withContext(
-            $this->context->withData($data)
-        );
-    }
-
-    public function withDebug(array $debug): self
-    {
-        return $this->withContext(
-            $this->context->withDebug($debug)
-        );
-    }
-
-    public function withContextMetadata(array $metadata): self
-    {
-        return $this->withContext(
-            $this->context->withMetadata($metadata)
-        );
-    }
-
-    // === Integration Control Methods (NEW) ===
-
-    /**
-     * Skip automatic error aggregation for this exception
-     */
-    public function skipAggregation(): self
-    {
-        return $this->withMetadata(
-            $this->metadata->withSkipAggregation()
-        );
-    }
-
-    /**
-     * Skip automatic error reporting for this exception
-     */
-    public function skipReporting(): self
-    {
-        return $this->withMetadata(
-            $this->metadata->withSkipReporting()
-        );
-    }
-
-    /**
-     * Skip both aggregation and reporting
-     */
-    public function skipAll(): self
-    {
-        return $this->withMetadata(
-            $this->metadata->withSkipAll()
-        );
-    }
-
-    /**
-     * Mark exception as reported (used by ErrorHandler)
-     */
-    public function markAsReported(): void
-    {
-        $this->metadata = $this->metadata->markAsReported();
-    }
-
-    /**
-     * Check if exception should be aggregated
-     */
-    public function shouldAggregate(): bool
-    {
-        return $this->metadata->shouldAggregate();
-    }
-
-    /**
-     * Check if exception should be reported
-     */
-    public function shouldReport(): bool
-    {
-        return $this->metadata->shouldReport();
-    }
-
-    /**
-     * Check if exception was already reported
-     */
-    public function wasReported(): bool
-    {
-        return $this->metadata->wasReported();
-    }
-
-    public function toArray(): array
-    {
-        $array = [
-            'class' => static::class,
-            'message' => $this->getMessage(),
-            'code' => $this->getCode(),
-            'file' => $this->getFile(),
-            'line' => $this->getLine(),
-            'context' => $this->context->toArray(),
-            'metadata' => $this->metadata->toArray(),
-            'trace' => $this->getTraceAsString(),
-        ];
-
-        // ErrorCode-spezifische Daten hinzufügen wenn vorhanden
-        if ($this->errorCode) {
-            $array['error_code'] = $this->errorCode->value;
-            $array['error_category'] = $this->errorCode->getCategory();
-            $array['description'] = $this->errorCode->getDescription();
-            $array['recovery_hint'] = $this->errorCode->getRecoveryHint();
-            $array['is_recoverable'] = $this->errorCode->isRecoverable();
-        }
-
-        return $array;
-    }
-
-    // === Factory Methods ===
-
-    /**
-     * Einfache Exception ohne ErrorCode - für schnelle Verwendung
-     */
-    public static function simple(
-        string $message,
-        ?\Throwable $previous = null,
-        int $code = 0
-    ): static {
-        return new static(
-            message: $message,
-            context: ExceptionContext::empty(),
-            code: $code,
-            previous: $previous
-        );
-    }
-
-    /**
-     * Exception mit ErrorCode und automatischer Beschreibung
-     */
-    public static function create(
-        ErrorCode $errorCode,
-        ?string $message = null,
-        ?ExceptionContext $context = null,
-        ?\Throwable $previous = null,
-        int $code = 0
-    ): static {
-        $finalMessage = $message ?? $errorCode->getDescription();
-        $finalContext = $context ?? ExceptionContext::empty();
-
-        return new static(
-            message: $finalMessage,
-            context: $finalContext,
-            code: $code,
-            previous: $previous,
-            errorCode: $errorCode
-        );
-    }
-
-    /**
-     * Exception mit Operation Context
-     */
-    public static function forOperation(
-        string $operation,
-        ?string $component = null,
-        ?string $message = null,
-        ?ErrorCode $errorCode = null,
-        ?\Throwable $previous = null,
-        int $code = 0
-    ): static {
-        $context = ExceptionContext::forOperation($operation, $component);
-        $finalMessage = $message ?? $errorCode?->getDescription() ?? "Operation failed: $operation";
-
-        return new static(
-            message: $finalMessage,
-            context: $context,
-            code: $code,
-            previous: $previous,
-            errorCode: $errorCode
-        );
-    }
-
-    /**
-     * Exception mit vollständigem Context und Daten
-     */
-    public static function fromContext(
-        string $message,
-        ExceptionContext $context,
-        ?ErrorCode $errorCode = null,
-        ?\Throwable $previous = null,
-        int $code = 0
-    ): static {
-        return new static(
-            message: $message,
-            context: $context,
-            code: $code,
-            previous: $previous,
-            errorCode: $errorCode
-        );
-    }
-
-    // === ErrorCode Getter Methods ===
-
-    public function getErrorCode(): ?ErrorCode
-    {
-        return $this->errorCode;
-    }
-
-    public function getRetryAfter(): ?int
-    {
-        return $this->metadata->retryAfter;
-    }
-
-    public function isRecoverable(): bool
-    {
-        return $this->errorCode?->isRecoverable() ?? false;
-    }
-
-    public function getRecoveryHint(): ?string
-    {
-        return $this->errorCode?->getRecoveryHint();
-    }
-
-    /**
-     * Get severity from ErrorCode (NEW)
-     */
-    public function getSeverity(): ?Core\ErrorSeverity
-    {
-        return $this->errorCode?->getSeverity();
-    }
-
-    // === ErrorCode Utility Methods ===
-
-    /**
-     * Prüft ob Exception von bestimmtem Error Code Typ ist
-     */
-    public function isErrorCode(ErrorCode $errorCode): bool
-    {
-        return $this->errorCode === $errorCode;
-    }
-
-    /**
-     * Prüft ob Exception zu bestimmter Kategorie gehört
-     */
-    public function isCategory(string $category): bool
-    {
-        return $this->errorCode?->getCategory() === strtoupper($category);
-    }
-
-    /**
-     * Setzt ErrorCode nachträglich
-     */
-    public function withErrorCode(ErrorCode $errorCode): self
-    {
-        $metadata = $this->metadata->withRetryAfter(
-            $errorCode->getRetryAfterSeconds()
-        );
-
-        return new static(
-            message: $this->getMessage(),
-            context: $this->context,
-            code: $this->getCode(),
-            previous: $this->getPrevious(),
-            errorCode: $errorCode,
-            metadata: $metadata
-        );
-    }
-
-    /**
-     * Setzt Custom Retry-Zeit
-     */
-    public function withRetryAfter(int $seconds): self
-    {
-        return $this->withMetadata(
-            $this->metadata->withRetryAfter($seconds)
-        );
-    }
-
-    /**
-     * Get exception data from context
-     */
-    public function getData(): array
-    {
-        return $this->context->data;
-    }
-
-    /**
-     * String-Representation für Logging
-     */
-    public function __toString(): string
-    {
-        $errorCodePart = $this->errorCode ? '[' . $this->errorCode->value . ']' : '';
-
-        return sprintf(
-            '%s %s: %s in %s:%d',
-            static::class,
-            $errorCodePart,
-            $this->getMessage(),
-            $this->getFile(),
-            $this->getLine()
-        );
     }
 }
diff --git a/src/Framework/Exception/Http/InvalidContentTypeException.php b/src/Framework/Exception/Http/InvalidContentTypeException.php
index 11504943..0bde9549 100644
--- a/src/Framework/Exception/Http/InvalidContentTypeException.php
+++ b/src/Framework/Exception/Http/InvalidContentTypeException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Http;
 
 use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -29,35 +28,12 @@ final class InvalidContentTypeException extends FrameworkException
         public readonly string $endpoint = '',
         ?\Throwable $previous = null
     ) {
-        $allowedList = implode(', ', $this->allowedContentTypes);
-
-        // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} sent invalid content type '{$this->providedContentType}' to {$this->endpoint}";
 
-        $context = ExceptionContext::forOperation('http.content_type_validation', 'Http')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'provided_content_type' => $this->providedContentType,
-                'allowed_content_types' => $this->allowedContentTypes,
-                'endpoint' => $this->endpoint,
-                'allowed_types_count' => count($this->allowedContentTypes),
-                'event_identifier' => "http_invalid_content_type:{$this->clientIp},{$this->endpoint}",
-                'category' => 'http_validation',
-                'requires_alert' => $this->requiresAlert(),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'INFO',
-                'http_error' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 415, // Unsupported Media Type
-            previous: $previous,
-            errorCode: HttpErrorCode::BAD_REQUEST
+            code: (int) HttpErrorCode::BAD_REQUEST->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Http/MalformedJsonException.php b/src/Framework/Exception/Http/MalformedJsonException.php
index f3a16341..dfdf7253 100644
--- a/src/Framework/Exception/Http/MalformedJsonException.php
+++ b/src/Framework/Exception/Http/MalformedJsonException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Http;
 
 use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -29,35 +28,12 @@ final class MalformedJsonException extends FrameworkException
         public readonly string $jsonData = '',
         ?\Throwable $previous = null
     ) {
-        // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} sent malformed JSON: {$this->jsonError}";
 
-        $context = ExceptionContext::forOperation('http.json_parsing', 'Http')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'json_error' => $this->jsonError,
-                'json_error_code' => $this->jsonErrorCode,
-                'json_data_length' => strlen($this->jsonData),
-                'event_identifier' => "http_malformed_json:{$this->clientIp}",
-                'category' => 'http_validation',
-                'requires_alert' => false,
-            ])
-            ->withDebug([
-                'json_data_sample' => substr($this->jsonData, 0, 100), // Erste 100 Zeichen für Debug
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'INFO',
-                'http_error' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 400, // Bad Request
-            previous: $previous,
-            errorCode: HttpErrorCode::BAD_REQUEST
+            code: (int) HttpErrorCode::BAD_REQUEST->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Http/OversizedRequestException.php b/src/Framework/Exception/Http/OversizedRequestException.php
index 5a65998c..4445f26a 100644
--- a/src/Framework/Exception/Http/OversizedRequestException.php
+++ b/src/Framework/Exception/Http/OversizedRequestException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Http;
 
 use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -29,34 +28,12 @@ final class OversizedRequestException extends FrameworkException
         public readonly string $requestType = 'body',
         ?\Throwable $previous = null
     ) {
-        // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} sent oversized {$this->requestType}: {$this->requestSize} bytes (max: {$this->maxSize} bytes)";
 
-        $context = ExceptionContext::forOperation('http.size_validation', 'Http')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'request_size' => $this->requestSize,
-                'max_size' => $this->maxSize,
-                'request_type' => $this->requestType,
-                'size_ratio' => round($this->requestSize / $this->maxSize, 2),
-                'excess_bytes' => $this->requestSize - $this->maxSize,
-                'event_identifier' => "http_oversized_request:{$this->clientIp},{$this->requestType}",
-                'category' => 'http_validation',
-                'requires_alert' => $this->requiresAlert(),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'WARN',
-                'http_error' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 413, // Payload Too Large
-            previous: $previous,
-            errorCode: HttpErrorCode::BAD_REQUEST
+            code: (int) HttpErrorCode::BAD_REQUEST->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Http/RateLimitExceededException.php b/src/Framework/Exception/Http/RateLimitExceededException.php
index ec935732..f59e4e18 100644
--- a/src/Framework/Exception/Http/RateLimitExceededException.php
+++ b/src/Framework/Exception/Http/RateLimitExceededException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Http;
 
 use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -33,36 +32,12 @@ final class RateLimitExceededException extends FrameworkException
         public readonly string $limitType = 'ip',
         ?\Throwable $previous = null
     ) {
-        // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} exceeded rate limit: {$this->currentRequests}/{$this->maxRequests} requests in {$this->windowSeconds}s";
 
-        $context = ExceptionContext::forOperation('http.rate_limiting', 'Http')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'current_requests' => $this->currentRequests,
-                'max_requests' => $this->maxRequests,
-                'window_seconds' => $this->windowSeconds,
-                'retry_after_seconds' => $this->retryAfterSeconds,
-                'limit_type' => $this->limitType,
-                'usage_percentage' => round(($this->currentRequests / $this->maxRequests) * 100, 2),
-                'event_identifier' => "http_rate_limit_exceeded:{$this->clientIp},{$this->limitType}",
-                'category' => 'rate_limiting',
-                'requires_alert' => $this->requiresAlert(),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'WARN',
-                'http_error' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 429, // Too Many Requests
-            previous: $previous,
-            errorCode: HttpErrorCode::RATE_LIMIT_EXCEEDED,
-            retryAfter: $this->retryAfterSeconds
+            code: (int) HttpErrorCode::RATE_LIMIT_EXCEEDED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Http/RouteNotFoundException.php b/src/Framework/Exception/Http/RouteNotFoundException.php
index f80cfdb1..0911ecd4 100644
--- a/src/Framework/Exception/Http/RouteNotFoundException.php
+++ b/src/Framework/Exception/Http/RouteNotFoundException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Http;
 
 use App\Framework\Exception\Core\HttpErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -29,35 +28,12 @@ final class RouteNotFoundException extends FrameworkException
         public readonly array $availableRoutes = [],
         ?\Throwable $previous = null
     ) {
-        // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} requested non-existent route {$this->method} {$this->path}";
 
-        $context = ExceptionContext::forOperation('http.routing', 'Router')
-            ->withData([
-                'path' => $this->path,
-                'method' => $this->method,
-                'client_ip' => $this->clientIp,
-                'available_routes_count' => count($this->availableRoutes),
-                'event_identifier' => "http_route_not_found:{$this->clientIp},{$this->path}",
-                'category' => 'http_routing',
-                'requires_alert' => $this->requiresAlert(),
-            ])
-            ->withDebug([
-                'available_routes' => $this->availableRoutes, // Nur im Debug-Modus
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'INFO',
-                'http_error' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 404, // Not Found
-            previous: $previous,
-            errorCode: HttpErrorCode::NOT_FOUND
+            code: (int) HttpErrorCode::NOT_FOUND->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Security/CsrfValidationFailedException.php b/src/Framework/Exception/Security/CsrfValidationFailedException.php
index d3b66ce3..fb44cda6 100644
--- a/src/Framework/Exception/Security/CsrfValidationFailedException.php
+++ b/src/Framework/Exception/Security/CsrfValidationFailedException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Security;
 
 use App\Framework\Exception\Core\SecurityErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,60 +14,25 @@ final class CsrfValidationFailedException extends FrameworkException
 {
     public static function tokenValidationFailed(string $formId): self
     {
-        $context = ExceptionContext::forOperation('security.csrf', 'CsrfMiddleware')
-            ->withData([
-                'form_id' => $formId,
-                'validation_type' => 'token_mismatch',
-                'client_ip' => $_SERVER['REMOTE_ADDR'] ?? 'unknown',
-                'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? 'unknown',
-            ])
-            ->withMetadata([
-                'security_threat' => 'potential_csrf_attack',
-                'requires_investigation' => true,
-            ]);
-
-        return self::fromContext(
-            message: 'CSRF token validation failed. This may indicate a security threat.',
-            context: $context,
-            errorCode: SecurityErrorCode::CSRF_TOKEN_INVALID
+        return new self(
+            'CSRF token validation failed. This may indicate a security threat.',
+            (int) SecurityErrorCode::CSRF_TOKEN_INVALID->value
         );
     }
 
     public static function missingTokenOrFormId(bool $missingFormId, bool $missingToken): self
     {
-        $missing = [];
-        if ($missingFormId) {
-            $missing[] = 'form_id';
-        }
-        if ($missingToken) {
-            $missing[] = 'csrf_token';
-        }
-
-        $context = ExceptionContext::forOperation('security.csrf', 'CsrfMiddleware')
-            ->withData([
-                'missing_fields' => $missing,
-                'validation_type' => 'missing_required_fields',
-            ]);
-
-        return self::fromContext(
-            message: 'CSRF protection requires both form ID and token',
-            context: $context,
-            errorCode: SecurityErrorCode::CSRF_TOKEN_INVALID
+        return new self(
+            'CSRF protection requires both form ID and token',
+            (int) SecurityErrorCode::CSRF_TOKEN_INVALID->value
         );
     }
 
     public static function invalidTokenFormat(string $error): self
     {
-        $context = ExceptionContext::forOperation('security.csrf', 'CsrfMiddleware')
-            ->withData([
-                'validation_type' => 'invalid_format',
-                'format_error' => $error,
-            ]);
-
-        return self::fromContext(
-            message: "Invalid CSRF token format: {$error}",
-            context: $context,
-            errorCode: SecurityErrorCode::CSRF_TOKEN_INVALID
+        return new self(
+            "Invalid CSRF token format: {$error}",
+            (int) SecurityErrorCode::CSRF_TOKEN_INVALID->value
         );
     }
 }
diff --git a/src/Framework/Exception/Security/HoneypotTriggeredException.php b/src/Framework/Exception/Security/HoneypotTriggeredException.php
index cfe97d00..b7eb34f0 100644
--- a/src/Framework/Exception/Security/HoneypotTriggeredException.php
+++ b/src/Framework/Exception/Security/HoneypotTriggeredException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Security;
 
 use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\SecurityException;
 use App\Framework\Security\Events\BotDetectedEvent;
 
@@ -22,16 +21,9 @@ final class HoneypotTriggeredException extends SecurityException
             userAgent: $_SERVER['HTTP_USER_AGENT'] ?? 'unknown'
         );
 
-        $context = ExceptionContext::forOperation('security.honeypot', 'HoneypotMiddleware')
-            ->withData([
-                'validation_type' => 'missing_honeypot_name',
-                'risk_level' => 'high',
-            ]);
-
         return new self(
             securityEvent: $event,
-            message: 'Spam protection triggered: Missing honeypot field',
-            additionalContext: $context
+            message: 'Spam protection triggered: Missing honeypot field'
         );
     }
 
@@ -43,21 +35,9 @@ final class HoneypotTriggeredException extends SecurityException
             userAgent: $_SERVER['HTTP_USER_AGENT'] ?? 'unknown'
         );
 
-        $context = ExceptionContext::forOperation('security.honeypot', 'HoneypotMiddleware')
-            ->withData([
-                'validation_type' => 'honeypot_filled',
-                'field_name' => $fieldName,
-                'field_value_length' => strlen($value),
-                'risk_level' => 'high',
-            ])
-            ->withDebug([
-                'field_value' => substr($value, 0, 100), // Limit für Logging
-            ]);
-
         return new self(
             securityEvent: $event,
-            message: 'Spam protection triggered: Honeypot field was filled',
-            additionalContext: $context
+            message: 'Spam protection triggered: Honeypot field was filled'
         );
     }
 
@@ -69,18 +49,9 @@ final class HoneypotTriggeredException extends SecurityException
             userAgent: $_SERVER['HTTP_USER_AGENT'] ?? 'unknown'
         );
 
-        $context = ExceptionContext::forOperation('security.honeypot', 'HoneypotMiddleware')
-            ->withData([
-                'validation_type' => 'submission_too_fast',
-                'elapsed_seconds' => $elapsedSeconds,
-                'minimum_seconds' => $minimumSeconds,
-                'risk_level' => 'medium',
-            ]);
-
         return new self(
             securityEvent: $event,
-            message: 'Spam protection triggered: Form submitted too quickly',
-            additionalContext: $context
+            message: 'Spam protection triggered: Form submitted too quickly'
         );
     }
 }
diff --git a/src/Framework/Exception/Security/PathTraversalAttemptException.php b/src/Framework/Exception/Security/PathTraversalAttemptException.php
index b12f4901..2c7ceae6 100644
--- a/src/Framework/Exception/Security/PathTraversalAttemptException.php
+++ b/src/Framework/Exception/Security/PathTraversalAttemptException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Security;
 
 use App\Framework\Exception\Core\SecurityErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -32,31 +31,10 @@ final class PathTraversalAttemptException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} attempted path traversal: {$this->requestedPath}";
 
-        $context = ExceptionContext::forOperation('security.path_traversal_detection', 'Security')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'requested_path' => $this->requestedPath,
-                'pattern' => $this->pattern,
-                'context' => $this->attackContext,
-                'path_depth' => $this->calculateTraversalDepth(),
-                'event_identifier' => "security_path_traversal:{$this->clientIp}",
-                'category' => 'file_access',
-                'requires_alert' => true, // Path-Traversal-Versuche erfordern immer Alerts
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'ERROR',
-                'attack_type' => 'path_traversal',
-                'critical_security_event' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 400, // Bad Request
-            previous: $previous,
-            errorCode: SecurityErrorCode::PATH_TRAVERSAL_DETECTED
+            code: (int) SecurityErrorCode::PATH_TRAVERSAL_DETECTED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Security/SqlInjectionAttemptException.php b/src/Framework/Exception/Security/SqlInjectionAttemptException.php
index 8ceb197a..f58eff8e 100644
--- a/src/Framework/Exception/Security/SqlInjectionAttemptException.php
+++ b/src/Framework/Exception/Security/SqlInjectionAttemptException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Security;
 
 use App\Framework\Exception\Core\SecurityErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -34,34 +33,10 @@ final class SqlInjectionAttemptException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} attempted SQL injection in field {$this->field}";
 
-        $context = ExceptionContext::forOperation('security.sql_injection_detection', 'Security')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'field' => $this->field,
-                'pattern' => $this->pattern,
-                'detection_method' => $this->detectionMethod,
-                'value_length' => strlen($this->originalValue),
-                'event_identifier' => "security_sql_injection:{$this->clientIp},{$this->field}",
-                'category' => 'input_validation',
-                'requires_alert' => true, // SQL-Injection-Versuche erfordern immer Alerts
-            ])
-            ->withDebug([
-                'sanitized_value' => $this->sanitizeValueForLog($this->originalValue),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'ERROR',
-                'attack_type' => 'sql_injection',
-                'critical_security_event' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 400, // Bad Request
-            previous: $previous,
-            errorCode: SecurityErrorCode::SQL_INJECTION_DETECTED
+            code: (int) SecurityErrorCode::SQL_INJECTION_DETECTED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/Security/XssAttemptException.php b/src/Framework/Exception/Security/XssAttemptException.php
index a67d6885..c128b79e 100644
--- a/src/Framework/Exception/Security/XssAttemptException.php
+++ b/src/Framework/Exception/Security/XssAttemptException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Exception\Security;
 
 use App\Framework\Exception\Core\SecurityErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -34,34 +33,10 @@ final class XssAttemptException extends FrameworkException
         // OWASP-konforme Nachricht mit Platzhaltern
         $message = "Client {$this->clientIp} attempted XSS attack in field {$this->field}";
 
-        $context = ExceptionContext::forOperation('security.xss_detection', 'Security')
-            ->withData([
-                'client_ip' => $this->clientIp,
-                'field' => $this->field,
-                'pattern' => $this->pattern,
-                'xss_type' => $this->xssType,
-                'value_length' => strlen($this->originalValue),
-                'event_identifier' => "security_xss_attempt:{$this->clientIp},{$this->field}",
-                'category' => 'input_validation',
-                'requires_alert' => true, // XSS-Versuche erfordern immer Alerts
-            ])
-            ->withDebug([
-                'sanitized_value' => $this->sanitizeValueForLog($this->originalValue),
-            ])
-            ->withMetadata([
-                'security_event' => true,
-                'owasp_compliant' => true,
-                'log_level' => 'ERROR',
-                'attack_type' => 'xss',
-                'critical_security_event' => true,
-            ]);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 400, // Bad Request
-            previous: $previous,
-            errorCode: SecurityErrorCode::XSS_DETECTED
+            code: (int) SecurityErrorCode::XSS_DETECTED->value,
+            previous: $previous
         );
     }
 
diff --git a/src/Framework/Exception/SecurityException.php b/src/Framework/Exception/SecurityException.php
index 93da0d9e..513e6e1c 100644
--- a/src/Framework/Exception/SecurityException.php
+++ b/src/Framework/Exception/SecurityException.php
@@ -17,18 +17,14 @@ class SecurityException extends FrameworkException
         SecurityEventInterface $securityEvent,
         string $message = '',
         int $code = 0,
-        ?\Throwable $previous = null,
-        ?ExceptionContext $additionalContext = null
+        ?\Throwable $previous = null
     ) {
         $this->securityEvent = $securityEvent;
 
-        // Erstelle Security-Context
-        $context = $this->createSecurityContext($securityEvent, $additionalContext);
-
         // Verwende Event-Beschreibung als Message falls nicht gesetzt
         $finalMessage = $message ?: $securityEvent->getDescription();
 
-        parent::__construct($finalMessage, $context, $code, $previous);
+        parent::__construct($finalMessage, $code, $previous);
     }
 
     /**
@@ -39,44 +35,6 @@ class SecurityException extends FrameworkException
         return new self($event, $message, $code);
     }
 
-    /**
-     * Erstellt Security-spezifischen Context
-     */
-    private function createSecurityContext(
-        SecurityEventInterface $securityEvent,
-        ?ExceptionContext $additionalContext
-    ): ExceptionContext {
-        $baseContext = ExceptionContext::forOperation(
-            'security.' . $securityEvent->getCategory(),
-            'Security'
-        )->withData([
-            'event_type' => $securityEvent->getEventIdentifier(),
-            'event_category' => $securityEvent->getCategory(),
-            'event_data' => $securityEvent->toArray(),
-            'client_ip' => $_SERVER['REMOTE_ADDR'] ?? 'unknown',
-            'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? 'unknown',
-            'request_uri' => $_SERVER['REQUEST_URI'] ?? null,
-            'request_method' => $_SERVER['REQUEST_METHOD'] ?? null,
-            'timestamp' => time(),
-        ])->withMetadata([
-            'security_event' => $securityEvent->getEventIdentifier(),
-            'security_level' => $securityEvent->getLogLevel()->value,
-            'security_description' => $securityEvent->getDescription(),
-            'requires_alert' => $securityEvent->requiresAlert(),
-            'event_category' => $securityEvent->getCategory(),
-        ]);
-
-        // Merge mit zusätzlichem Context falls vorhanden
-        if ($additionalContext) {
-            $baseContext = $baseContext
-                ->withData($additionalContext->data)
-                ->withDebug($additionalContext->debug)
-                ->withMetadata($additionalContext->metadata);
-        }
-
-        return $baseContext;
-    }
-
     /**
      * Gibt Security-Event zurück
      */
diff --git a/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarning.php b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarning.php
new file mode 100644
index 00000000..0f9e7e39
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarning.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Aggregation;
+
+/**
+ * Single discovery warning entry with structured context data.
+ *
+ * @psalm-type WarningContext = array<string, mixed>
+ */
+final readonly class DiscoveryWarning
+{
+    /**
+     * @param WarningContext $context
+     */
+    public function __construct(
+        public string $message,
+        public array $context
+    ) {
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningAggregator.php b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningAggregator.php
new file mode 100644
index 00000000..f179159b
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningAggregator.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Aggregation;
+
+/**
+ * Collects discovery warnings, grouped by file path.
+ */
+final class DiscoveryWarningAggregator
+{
+    /** @var array<string, DiscoveryWarning[]> */
+    private array $warningsByFile = [];
+
+    public function record(DiscoveryWarning $warning, ?string $filePath = null): void
+    {
+        $path = $filePath ?? ($warning->context['file_path'] ?? 'unknown');
+        $this->warningsByFile[$path][] = $warning;
+    }
+
+    public function recordClassFailure(
+        string $filePath,
+        string $className,
+        \Throwable $exception,
+        string $message
+    ): void {
+        $this->record(
+            new DiscoveryWarning($message, [
+                'type' => 'class_processing',
+                'file_path' => $filePath,
+                'class_name' => $className,
+                'exception_class' => $exception::class,
+                'exception_file' => $exception->getFile(),
+                'exception_line' => $exception->getLine(),
+                'exception_message' => $exception->getMessage(),
+            ]),
+            $filePath
+        );
+    }
+
+    public function recordMethodReflectionFailure(
+        string $filePath,
+        string $className,
+        \Throwable $exception,
+        string $message
+    ): void {
+        $this->record(
+            new DiscoveryWarning($message, [
+                'type' => 'method_reflection',
+                'file_path' => $filePath,
+                'class_name' => $className,
+                'exception_class' => $exception::class,
+                'exception_file' => $exception->getFile(),
+                'exception_line' => $exception->getLine(),
+                'exception_message' => $exception->getMessage(),
+            ]),
+            $filePath
+        );
+    }
+
+    public function recordMethodProcessingFailure(
+        string $filePath,
+        string $className,
+        string $methodName,
+        \Throwable $exception,
+        string $message
+    ): void {
+        $this->record(
+            new DiscoveryWarning($message, [
+                'type' => 'method_processing',
+                'file_path' => $filePath,
+                'class_name' => $className,
+                'method_name' => $methodName,
+                'exception_class' => $exception::class,
+                'exception_file' => $exception->getFile(),
+                'exception_line' => $exception->getLine(),
+                'exception_message' => $exception->getMessage(),
+            ]),
+            $filePath
+        );
+    }
+
+    /**
+     * @return DiscoveryWarningGroup[]
+     */
+    public function release(): array
+    {
+        $groups = [];
+
+        foreach ($this->warningsByFile as $filePath => $warnings) {
+            $groups[] = new DiscoveryWarningGroup($filePath, $warnings);
+        }
+
+        $this->warningsByFile = [];
+
+        return $groups;
+    }
+
+    public function hasWarnings(): bool
+    {
+        return $this->warningsByFile !== [];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningGroup.php b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningGroup.php
new file mode 100644
index 00000000..f079ba48
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Aggregation/DiscoveryWarningGroup.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Aggregation;
+
+/**
+ * Aggregated warnings for a single file.
+ *
+ * @psalm-type WarningContext = array<string, mixed>
+ */
+final readonly class DiscoveryWarningGroup
+{
+    /**
+     * @param DiscoveryWarning[] $warnings
+     */
+    public function __construct(
+        public string $filePath,
+        public array $warnings
+    ) {
+    }
+
+    public function count(): int
+    {
+        return count($this->warnings);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Audit/ExceptionAuditLogger.php b/src/Framework/ExceptionHandling/Audit/ExceptionAuditLogger.php
new file mode 100644
index 00000000..539e93a5
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Audit/ExceptionAuditLogger.php
@@ -0,0 +1,309 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Audit;
+
+use App\Framework\Audit\AuditLogger;
+use App\Framework\Audit\ValueObjects\AuditEntry;
+use App\Framework\Audit\ValueObjects\AuditableAction;
+use App\Framework\DateTime\Clock;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\Http\IpAddress;
+use App\Framework\UserAgent\UserAgent;
+use Throwable;
+
+/**
+ * Exception Audit Logger
+ *
+ * Converts exceptions to audit entries for compliance and tracking.
+ * Only logs exceptions marked as auditable via ExceptionContextData.
+ *
+ * PHP 8.5+ with external context management via WeakMap.
+ */
+final readonly class ExceptionAuditLogger
+{
+    public function __construct(
+        private AuditLogger $auditLogger,
+        private Clock $clock,
+        private ?ExceptionContextProvider $contextProvider = null
+    ) {
+    }
+
+    /**
+     * Log exception as audit entry if auditable
+     *
+     * @param Throwable $exception Exception to log
+     * @param ExceptionContextData|null $context Optional context (if not provided, will be retrieved from provider)
+     */
+    public function logIfAuditable(Throwable $exception, ?ExceptionContextData $context = null): void
+    {
+        try {
+            // Get context from provider if not provided
+            $context = $context ?? $this->getContext($exception);
+
+            // Skip if not auditable
+            if (!$this->isAuditable($context)) {
+                return;
+            }
+
+            // Convert exception to audit entry
+            $auditEntry = $this->convertToAuditEntry($exception, $context);
+
+            // Log to audit system
+            $this->auditLogger->log($auditEntry);
+        } catch (Throwable $e) {
+            // Audit logging should never break exception handling
+            // Log error but don't throw
+            error_log("Failed to log exception to audit: {$e->getMessage()}");
+        }
+    }
+
+    /**
+     * Check if exception is auditable
+     *
+     * @param ExceptionContextData|null $context Exception context
+     * @return bool True if exception should be audited
+     */
+    private function isAuditable(?ExceptionContextData $context): bool
+    {
+        if ($context === null) {
+            // Default: log all exceptions if no context provided
+            return true;
+        }
+
+        // Check auditable flag (defaults to true)
+        return $context->auditable;
+    }
+
+    /**
+     * Convert exception to audit entry
+     *
+     * @param Throwable $exception Exception to convert
+     * @param ExceptionContextData $context Exception context
+     * @return AuditEntry Audit entry value object
+     */
+    private function convertToAuditEntry(Throwable $exception, ExceptionContextData $context): AuditEntry
+    {
+        // Determine audit action from exception type and context
+        $action = $this->determineAuditAction($exception, $context);
+
+        // Determine entity type from exception class or context
+        $entityType = $this->determineEntityType($exception, $context);
+
+        // Extract entity ID from context data
+        $entityId = $this->extractEntityId($context);
+
+        // Build metadata from exception and context
+        $metadata = $this->buildMetadata($exception, $context);
+
+        // Extract IP address (already Value Object or string)
+        $ipAddress = $context->clientIp instanceof IpAddress
+            ? $context->clientIp
+            : ($context->clientIp !== null && IpAddress::isValid($context->clientIp)
+                ? IpAddress::from($context->clientIp)
+                : null);
+
+        // Extract user agent (already Value Object or string)
+        $userAgent = $context->userAgent instanceof UserAgent
+            ? $context->userAgent
+            : ($context->userAgent !== null
+                ? UserAgent::fromString($context->userAgent)
+                : null);
+
+        // Create audit entry as failed operation
+        return AuditEntry::failed(
+            clock: $this->clock,
+            action: $action,
+            entityType: $entityType,
+            entityId: $entityId,
+            errorMessage: $exception->getMessage(),
+            userId: $context->userId,
+            ipAddress: $ipAddress,
+            userAgent: $userAgent,
+            metadata: $metadata
+        );
+    }
+
+    /**
+     * Determine audit action from exception and context
+     *
+     * @param Throwable $exception Exception
+     * @param ExceptionContextData $context Context
+     * @return AuditableAction Audit action
+     */
+    private function determineAuditAction(Throwable $exception, ExceptionContextData $context): AuditableAction
+    {
+        // Check if action is specified in metadata
+        if (isset($context->metadata['audit_action']) && is_string($context->metadata['audit_action'])) {
+            $actionValue = $context->metadata['audit_action'];
+            // Try to find matching enum case
+            foreach (AuditableAction::cases() as $case) {
+                if ($case->value === $actionValue) {
+                    return $case;
+                }
+            }
+        }
+
+        // Determine from operation name
+        if ($context->operation !== null) {
+            $operation = $context->operation;
+            if (str_contains($operation, 'create')) {
+                return AuditableAction::CREATE;
+            }
+            if (str_contains($operation, 'update')) {
+                return AuditableAction::UPDATE;
+            }
+            if (str_contains($operation, 'delete')) {
+                return AuditableAction::DELETE;
+            }
+            if (str_contains($operation, 'read') || str_contains($operation, 'get')) {
+                return AuditableAction::READ;
+            }
+        }
+
+        // Determine from exception type
+        $exceptionClass = $exception::class;
+        if (str_contains($exceptionClass, 'Security') || str_contains($exceptionClass, 'Auth')) {
+            return AuditableAction::SECURITY_VIOLATION;
+        }
+
+        // Default: custom action
+        return AuditableAction::CUSTOM;
+    }
+
+    /**
+     * Determine entity type from exception and context
+     *
+     * @param Throwable $exception Exception
+     * @param ExceptionContextData $context Context
+     * @return string Entity type
+     */
+    private function determineEntityType(Throwable $exception, ExceptionContextData $context): string
+    {
+        // Check if entity type is specified in metadata
+        if (isset($context->metadata['entity_type']) && is_string($context->metadata['entity_type'])) {
+            return $context->metadata['entity_type'];
+        }
+
+        // Try to extract from component
+        if ($context->component !== null) {
+            // Remove common suffixes
+            $component = $context->component;
+            $component = preg_replace('/Service$|Repository$|Manager$|Handler$/', '', $component);
+            return strtolower($component);
+        }
+
+        // Extract from exception class name
+        $className = $exception::class;
+        $parts = explode('\\', $className);
+        $shortName = end($parts);
+
+        // Remove "Exception" suffix
+        $entityType = preg_replace('/Exception$/', '', $shortName);
+
+        return strtolower($entityType);
+    }
+
+    /**
+     * Extract entity ID from context data
+     *
+     * @param ExceptionContextData $context Context
+     * @return string|null Entity ID
+     */
+    private function extractEntityId(ExceptionContextData $context): ?string
+    {
+        // Check common entity ID keys
+        $commonKeys = ['entity_id', 'id', 'user_id', 'order_id', 'account_id', 'resource_id'];
+
+        foreach ($commonKeys as $key) {
+            if (isset($context->data[$key])) {
+                $value = $context->data[$key];
+                if (is_string($value) || is_numeric($value)) {
+                    return (string) $value;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Build metadata from exception and context
+     *
+     * @param Throwable $exception Exception
+     * @param ExceptionContextData $context Context
+     * @return array<string, mixed> Metadata
+     */
+    private function buildMetadata(Throwable $exception, ExceptionContextData $context): array
+    {
+        $metadata = [
+            'exception_class' => $exception::class,
+            'exception_code' => $exception->getCode(),
+            'exception_file' => $exception->getFile(),
+            'exception_line' => $exception->getLine(),
+        ];
+
+        // Add context data
+        if (!empty($context->data)) {
+            $metadata['context_data'] = $context->data;
+        }
+
+        // Add operation and component
+        if ($context->operation !== null) {
+            $metadata['operation'] = $context->operation;
+        }
+        if ($context->component !== null) {
+            $metadata['component'] = $context->component;
+        }
+
+        // Add request/session IDs
+        if ($context->requestId !== null) {
+            $metadata['request_id'] = $context->requestId;
+        }
+        if ($context->sessionId !== null) {
+            $metadata['session_id'] = $context->sessionId;
+        }
+
+        // Add tags
+        if (!empty($context->tags)) {
+            $metadata['tags'] = $context->tags;
+        }
+
+        // Add previous exception if exists
+        if ($exception->getPrevious() !== null) {
+            $previous = $exception->getPrevious();
+            $metadata['previous_exception'] = [
+                'class' => $previous::class,
+                'message' => $previous->getMessage(),
+            ];
+        }
+
+        // Merge with existing metadata (but exclude internal fields)
+        $excludeKeys = ['auditable', 'audit_action', 'entity_type'];
+        foreach ($context->metadata as $key => $value) {
+            if (!in_array($key, $excludeKeys, true)) {
+                $metadata[$key] = $value;
+            }
+        }
+
+        return $metadata;
+    }
+
+    /**
+     * Get context from provider
+     *
+     * @param Throwable $exception Exception
+     * @return ExceptionContextData|null Context or null if not found
+     */
+    private function getContext(Throwable $exception): ?ExceptionContextData
+    {
+        if ($this->contextProvider === null) {
+            return null;
+        }
+
+        return $this->contextProvider->get($exception);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/BasicErrorHandler.php b/src/Framework/ExceptionHandling/BasicErrorHandler.php
new file mode 100644
index 00000000..56ad6ab8
--- /dev/null
+++ b/src/Framework/ExceptionHandling/BasicErrorHandler.php
@@ -0,0 +1,35 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+/**
+ * Basic Error Handler for early registration
+ *
+ * Minimal implementation that can be registered before Discovery.
+ * Provides basic error handling without full ErrorHandlerStrategy dependencies.
+ * Can be replaced with full ErrorHandler after Discovery.
+ */
+final readonly class BasicErrorHandler implements ErrorHandlerInterface
+{
+    public function handle(
+        int $severity,
+        string $message,
+        ?string $file = null,
+        ?int $line = null,
+    ): bool {
+        // Basic error output to stderr
+        $errorOutput = sprintf(
+            "[ERROR] %s in %s on line %d\n",
+            $message,
+            $file ?? 'unknown',
+            $line ?? 0
+        );
+
+        file_put_contents('php://stderr', $errorOutput);
+
+        // Return false to let PHP handle the error normally
+        return false;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/BasicGlobalExceptionHandler.php b/src/Framework/ExceptionHandling/BasicGlobalExceptionHandler.php
new file mode 100644
index 00000000..65ffdeae
--- /dev/null
+++ b/src/Framework/ExceptionHandling/BasicGlobalExceptionHandler.php
@@ -0,0 +1,34 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+/**
+ * Basic Global Exception Handler for early registration
+ *
+ * Minimal implementation that can be registered before Discovery.
+ * Provides basic exception handling without full ErrorKernel dependencies.
+ * Can be replaced with full GlobalExceptionHandler after Discovery.
+ */
+final readonly class BasicGlobalExceptionHandler implements ExceptionHandler
+{
+    public function handle(\Throwable $throwable): void
+    {
+        // Basic error output to stderr
+        $errorOutput = sprintf(
+            "Uncaught %s: %s in %s on line %d\n",
+            get_class($throwable),
+            $throwable->getMessage(),
+            $throwable->getFile(),
+            $throwable->getLine()
+        );
+
+        // Add stack trace if available
+        if ($throwable->getTraceAsString() !== '') {
+            $errorOutput .= "Stack trace:\n" . $throwable->getTraceAsString() . "\n";
+        }
+
+        file_put_contents('php://stderr', $errorOutput);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/BasicShutdownHandler.php b/src/Framework/ExceptionHandling/BasicShutdownHandler.php
new file mode 100644
index 00000000..04f196cb
--- /dev/null
+++ b/src/Framework/ExceptionHandling/BasicShutdownHandler.php
@@ -0,0 +1,54 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+/**
+ * Basic Shutdown Handler for early registration
+ *
+ * Minimal implementation that can be registered before Discovery.
+ * Provides basic fatal error handling without full ErrorKernel dependencies.
+ * Can be replaced with full ShutdownHandler after Discovery.
+ */
+final readonly class BasicShutdownHandler implements ShutdownHandlerInterface
+{
+    public function handle(): void
+    {
+        $last = error_get_last();
+
+        if (!$last || !FatalErrorTypes::isFatal($last['type'])) {
+            return;
+        }
+
+        $this->cleanOutputBuffer();
+
+        $file = (string)($last['file'] ?? 'unknown');
+        $line = (int)($last['line'] ?? 0);
+        $message = $last['message'] ?? 'Fatal error';
+
+        // Basic error output to stderr
+        $errorOutput = sprintf(
+            "Fatal error: %s in %s on line %d\n",
+            $message,
+            $file,
+            $line
+        );
+
+        file_put_contents('php://stderr', $errorOutput);
+
+        exit(255);
+    }
+
+    private function cleanOutputBuffer(): void
+    {
+        try {
+            while (ob_get_level() > 0) {
+                @ob_end_clean();
+            }
+        } catch (\Throwable) {
+            // ignore
+        }
+    }
+
+}
+
diff --git a/src/Framework/ExceptionHandling/Context/ExceptionContextBuilder.php b/src/Framework/ExceptionHandling/Context/ExceptionContextBuilder.php
new file mode 100644
index 00000000..3484ef71
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Context/ExceptionContextBuilder.php
@@ -0,0 +1,302 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Context;
+
+use App\Framework\Cache\Cache;
+use App\Framework\ExceptionHandling\Scope\ErrorScope;
+use App\Framework\Http\IpAddress;
+use App\Framework\Http\Request;
+use App\Framework\Http\Session\SessionId;
+use App\Framework\UserAgent\UserAgent;
+
+/**
+ * Exception Context Builder
+ *
+ * Automatically collects context from various sources:
+ * - ErrorScope (if available)
+ * - HTTP Request (if in HTTP context)
+ * - Session (if available)
+ * - Authentication (User ID)
+ * - System information (optional)
+ *
+ * Provides a simple API for automatic context collection and reduces boilerplate.
+ */
+final readonly class ExceptionContextBuilder
+{
+    public function __construct(
+        private ?ErrorScope $errorScope = null,
+        private ?ExceptionContextCache $contextCache = null
+    ) {
+    }
+
+    /**
+     * Build context from current environment
+     *
+     * Automatically collects context from ErrorScope, HTTP Request, Session, etc.
+     */
+    public function build(?ExceptionContextData $baseContext = null): ExceptionContextData
+    {
+        $context = $baseContext ?? ExceptionContextData::empty();
+
+        // First, enrich from ErrorScope if available
+        if ($this->errorScope !== null) {
+            $scopeContext = $this->errorScope->current();
+            if ($scopeContext !== null) {
+                $context = $this->enrichFromScope($context, $scopeContext);
+            }
+        }
+
+        return $context;
+    }
+
+    /**
+     * Build context from HTTP request
+     *
+     * Extracts context from HTTP request, session, and authentication.
+     * Uses cache if available to improve performance.
+     */
+    public function buildFromRequest(Request $request, ?ExceptionContextData $baseContext = null): ExceptionContextData
+    {
+        // Try to get from cache first
+        if ($this->contextCache !== null) {
+            $requestId = $request instanceof \App\Framework\Http\HttpRequest ? $request->id->toString() : null;
+            $sessionId = property_exists($request, 'session') && $request->session !== null
+                ? $request->session->id->toString()
+                : null;
+            $userId = $this->extractUserId($request);
+
+            $cached = $this->contextCache->get($requestId, $sessionId, $userId);
+            if ($cached !== null) {
+                // Merge with base context if provided
+                if ($baseContext !== null) {
+                    return $this->mergeContexts($cached, $baseContext);
+                }
+                return $cached;
+            }
+        }
+
+        $context = $baseContext ?? ExceptionContextData::empty();
+
+        // Extract request ID
+        if ($request instanceof \App\Framework\Http\HttpRequest) {
+            $context = $context->withRequestId($request->id->toString());
+        }
+
+        // Extract IP address
+        $ipAddress = $request->server->getRemoteAddr();
+        if ($ipAddress !== null) {
+            $ipValue = $ipAddress->value;
+            if (is_string($ipValue) && IpAddress::isValid($ipValue)) {
+                $context = $context->withClientIp(IpAddress::from($ipValue));
+            } else {
+                $context = $context->withClientIp($ipValue);
+            }
+        }
+
+        // Extract user agent
+        $userAgent = $request->server->getUserAgent();
+        if ($userAgent !== null) {
+            $userAgentValue = $userAgent->value;
+            if (is_string($userAgentValue)) {
+                $context = $context->withUserAgent(UserAgent::fromString($userAgentValue));
+            } else {
+                $context = $context->withUserAgent($userAgentValue);
+            }
+        }
+
+        // Extract session ID
+        if (property_exists($request, 'session') && $request->session !== null) {
+            $sessionId = $request->session->id->toString();
+            try {
+                $context = $context->withSessionId(SessionId::fromString($sessionId));
+            } catch (\InvalidArgumentException) {
+                // If SessionId validation fails, keep as string for backward compatibility
+                $context = $context->withSessionId($sessionId);
+            }
+        }
+
+        // Extract user ID (if authenticated)
+        $userId = $this->extractUserId($request);
+        if ($userId !== null) {
+            $context = $context->withUserId($userId);
+        }
+
+        // Add HTTP-specific tags
+        $context = $context->withTags('http', 'web');
+
+        // Enrich from ErrorScope if available (may override some values)
+        if ($this->errorScope !== null) {
+            $scopeContext = $this->errorScope->current();
+            if ($scopeContext !== null) {
+                $context = $this->enrichFromScope($context, $scopeContext);
+            }
+        }
+
+        // Cache context if cache is available
+        if ($this->contextCache !== null) {
+            $requestId = $request instanceof \App\Framework\Http\HttpRequest ? $request->id->toString() : null;
+            $sessionId = property_exists($request, 'session') && $request->session !== null
+                ? $request->session->id->toString()
+                : null;
+            $userId = $this->extractUserId($request);
+
+            $this->contextCache->put($context, $requestId, $sessionId, $userId);
+        }
+
+        return $context;
+    }
+
+    /**
+     * Merge two contexts (base takes precedence)
+     */
+    private function mergeContexts(ExceptionContextData $cached, ExceptionContextData $base): ExceptionContextData
+    {
+        $merged = $cached;
+
+        // Override with base context values if present
+        if ($base->operation !== null) {
+            $merged = $merged->withOperation($base->operation, $base->component);
+        }
+        if ($base->component !== null && $merged->component === null) {
+            $merged = $merged->withOperation($merged->operation ?? '', $base->component);
+        }
+        if (!empty($base->data)) {
+            $merged = $merged->addData($base->data);
+        }
+        if (!empty($base->debug)) {
+            $merged = $merged->addDebug($base->debug);
+        }
+        if (!empty($base->metadata)) {
+            $merged = $merged->addMetadata($base->metadata);
+        }
+        if ($base->userId !== null) {
+            $merged = $merged->withUserId($base->userId);
+        }
+        if ($base->requestId !== null) {
+            $merged = $merged->withRequestId($base->requestId);
+        }
+        if ($base->sessionId !== null) {
+            $merged = $merged->withSessionId($base->sessionId);
+        }
+        if ($base->clientIp !== null) {
+            $merged = $merged->withClientIp($base->clientIp);
+        }
+        if ($base->userAgent !== null) {
+            $merged = $merged->withUserAgent($base->userAgent);
+        }
+        if (!empty($base->tags)) {
+            $merged = $merged->withTags(...array_merge($merged->tags, $base->tags));
+        }
+
+        return $merged;
+    }
+
+    /**
+     * Enrich context from ErrorScope
+     */
+    private function enrichFromScope(
+        ExceptionContextData $context,
+        \App\Framework\ExceptionHandling\Scope\ErrorScopeContext $scopeContext
+    ): ExceptionContextData {
+        // Add operation/component from scope if not already set
+        if ($context->operation === null && $scopeContext->operation !== null) {
+            $context = $context->withOperation(
+                $scopeContext->operation,
+                $scopeContext->component
+            );
+        }
+
+        // Add user ID from scope if not already set
+        if ($context->userId === null && $scopeContext->userId !== null) {
+            $context = $context->withUserId($scopeContext->userId);
+        }
+
+        // Add request ID from scope if not already set
+        if ($context->requestId === null && $scopeContext->requestId !== null) {
+            $context = $context->withRequestId($scopeContext->requestId);
+        }
+
+        // Add session ID from scope if not already set
+        if ($context->sessionId === null && $scopeContext->sessionId !== null) {
+            if (is_string($scopeContext->sessionId)) {
+                try {
+                    $context = $context->withSessionId(SessionId::fromString($scopeContext->sessionId));
+                } catch (\InvalidArgumentException) {
+                    $context = $context->withSessionId($scopeContext->sessionId);
+                }
+            } else {
+                $context = $context->withSessionId($scopeContext->sessionId);
+            }
+        }
+
+        // Extract HTTP fields from scope metadata (for HTTP scopes)
+        if (isset($scopeContext->metadata['ip']) && $context->clientIp === null) {
+            $ipValue = $scopeContext->metadata['ip'];
+            if (is_string($ipValue) && IpAddress::isValid($ipValue)) {
+                $context = $context->withClientIp(IpAddress::from($ipValue));
+            } elseif ($ipValue instanceof IpAddress) {
+                $context = $context->withClientIp($ipValue);
+            } else {
+                $context = $context->withClientIp($ipValue);
+            }
+        }
+
+        if (isset($scopeContext->metadata['user_agent']) && $context->userAgent === null) {
+            $userAgentValue = $scopeContext->metadata['user_agent'];
+            if (is_string($userAgentValue)) {
+                $context = $context->withUserAgent(UserAgent::fromString($userAgentValue));
+            } elseif ($userAgentValue instanceof UserAgent) {
+                $context = $context->withUserAgent($userAgentValue);
+            } else {
+                $context = $context->withUserAgent($userAgentValue);
+            }
+        }
+
+        // Add scope metadata
+        $context = $context->addMetadata([
+            'scope_type' => $scopeContext->type->value,
+            'scope_id' => $scopeContext->scopeId,
+        ]);
+
+        // Add scope tags
+        if (!empty($scopeContext->tags)) {
+            $context = $context->withTags(...$scopeContext->tags);
+        }
+
+        return $context;
+    }
+
+    /**
+     * Extract user ID from request
+     */
+    private function extractUserId(Request $request): ?string
+    {
+        // Try to get from request attribute (set by auth middleware)
+        if (method_exists($request, 'getAttribute')) {
+            $user = $request->getAttribute('user');
+            if ($user !== null) {
+                if (is_object($user) && property_exists($user, 'id')) {
+                    return (string) $user->id;
+                }
+                if (is_string($user)) {
+                    return $user;
+                }
+            }
+        }
+
+        // Try to get from request property (if available)
+        if (property_exists($request, 'user') && $request->user !== null) {
+            if (is_object($request->user) && property_exists($request->user, 'id')) {
+                return (string) $request->user->id;
+            }
+            if (is_string($request->user)) {
+                return $request->user;
+            }
+        }
+
+        return null;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Context/ExceptionContextCache.php b/src/Framework/ExceptionHandling/Context/ExceptionContextCache.php
new file mode 100644
index 00000000..d9665a03
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Context/ExceptionContextCache.php
@@ -0,0 +1,213 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Context;
+
+use App\Framework\Cache\Cache;
+use App\Framework\Cache\CacheItem;
+use App\Framework\Cache\CacheKey;
+use App\Framework\Core\ValueObjects\Duration;
+
+/**
+ * Exception Context Cache
+ *
+ * Caches frequently used context data to improve performance.
+ * Uses cache keys based on Request-ID, Session-ID, User-ID.
+ */
+final readonly class ExceptionContextCache
+{
+    private const string CACHE_PREFIX = 'exception_context:';
+    private const int REQUEST_CONTEXT_TTL = 600; // 10 minutes
+    private const int USER_CONTEXT_TTL = 1800; // 30 minutes
+
+    public function __construct(
+        private Cache $cache
+    ) {
+    }
+
+    /**
+     * Get cached context for request
+     *
+     * @param string|null $requestId Request ID
+     * @param string|null $sessionId Session ID
+     * @param string|null $userId User ID
+     * @return ExceptionContextData|null Cached context or null if not found
+     */
+    public function get(
+        ?string $requestId = null,
+        ?string $sessionId = null,
+        ?string $userId = null
+    ): ?ExceptionContextData {
+        // Try request-level cache first (most specific)
+        if ($requestId !== null) {
+            $cacheKey = $this->buildRequestCacheKey($requestId);
+            $cached = $this->getFromCache($cacheKey);
+            if ($cached !== null) {
+                return $cached;
+            }
+        }
+
+        // Try session-level cache
+        if ($sessionId !== null) {
+            $cacheKey = $this->buildSessionCacheKey($sessionId);
+            $cached = $this->getFromCache($cacheKey);
+            if ($cached !== null) {
+                return $cached;
+            }
+        }
+
+        // Try user-level cache (least specific)
+        if ($userId !== null) {
+            $cacheKey = $this->buildUserCacheKey($userId);
+            $cached = $this->getFromCache($cacheKey);
+            if ($cached !== null) {
+                return $cached;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Cache context for request
+     *
+     * @param ExceptionContextData $context Context to cache
+     * @param string|null $requestId Request ID
+     * @param string|null $sessionId Session ID
+     * @param string|null $userId User ID
+     */
+    public function put(
+        ExceptionContextData $context,
+        ?string $requestId = null,
+        ?string $sessionId = null,
+        ?string $userId = null
+    ): void {
+        // Cache at request level (most specific)
+        if ($requestId !== null) {
+            $cacheKey = $this->buildRequestCacheKey($requestId);
+            $this->putToCache($cacheKey, $context, Duration::fromSeconds(self::REQUEST_CONTEXT_TTL));
+        }
+
+        // Cache at session level
+        if ($sessionId !== null) {
+            $cacheKey = $this->buildSessionCacheKey($sessionId);
+            $this->putToCache($cacheKey, $context, Duration::fromSeconds(self::REQUEST_CONTEXT_TTL));
+        }
+
+        // Cache at user level (least specific, longer TTL)
+        if ($userId !== null) {
+            $cacheKey = $this->buildUserCacheKey($userId);
+            // Only cache user-specific parts to avoid stale data
+            $userContext = ExceptionContextData::empty()
+                ->withUserId($context->userId)
+                ->withClientIp($context->clientIp)
+                ->withUserAgent($context->userAgent);
+            $this->putToCache($cacheKey, $userContext, Duration::fromSeconds(self::USER_CONTEXT_TTL));
+        }
+    }
+
+    /**
+     * Invalidate cache for request
+     *
+     * Called when request context changes (e.g., user logs in/out).
+     */
+    public function invalidateRequest(?string $requestId = null): void
+    {
+        if ($requestId !== null) {
+            $cacheKey = $this->buildRequestCacheKey($requestId);
+            $this->cache->forget($cacheKey);
+        }
+    }
+
+    /**
+     * Invalidate cache for session
+     *
+     * Called when session changes (e.g., session regenerated).
+     */
+    public function invalidateSession(?string $sessionId = null): void
+    {
+        if ($sessionId !== null) {
+            $cacheKey = $this->buildSessionCacheKey($sessionId);
+            $this->cache->forget($cacheKey);
+        }
+    }
+
+    /**
+     * Invalidate cache for user
+     *
+     * Called when user context changes (e.g., user logs in/out).
+     */
+    public function invalidateUser(?string $userId = null): void
+    {
+        if ($userId !== null) {
+            $cacheKey = $this->buildUserCacheKey($userId);
+            $this->cache->forget($cacheKey);
+        }
+    }
+
+    /**
+     * Build cache key for request
+     */
+    private function buildRequestCacheKey(string $requestId): CacheKey
+    {
+        return CacheKey::fromString(self::CACHE_PREFIX . 'request:' . $requestId);
+    }
+
+    /**
+     * Build cache key for session
+     */
+    private function buildSessionCacheKey(string $sessionId): CacheKey
+    {
+        return CacheKey::fromString(self::CACHE_PREFIX . 'session:' . $sessionId);
+    }
+
+    /**
+     * Build cache key for user
+     */
+    private function buildUserCacheKey(string $userId): CacheKey
+    {
+        return CacheKey::fromString(self::CACHE_PREFIX . 'user:' . $userId);
+    }
+
+    /**
+     * Get context from cache
+     */
+    private function getFromCache(CacheKey $cacheKey): ?ExceptionContextData
+    {
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        if ($item === null) {
+            return null;
+        }
+
+        $value = $item->value;
+        if ($value instanceof ExceptionContextData) {
+            return $value;
+        }
+
+        // Try to deserialize from array
+        if (is_array($value)) {
+            return ExceptionContextData::fromArray($value);
+        }
+
+        return null;
+    }
+
+    /**
+     * Put context to cache
+     */
+    private function putToCache(CacheKey $cacheKey, ExceptionContextData $context, Duration $ttl): void
+    {
+        // Store as array for serialization compatibility
+        $cacheItem = CacheItem::fromKey(
+            $cacheKey,
+            $context->toArray(),
+            $ttl
+        );
+
+        $this->cache->set($cacheItem);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Context/ExceptionContextData.php b/src/Framework/ExceptionHandling/Context/ExceptionContextData.php
index 3b682b73..04920ee7 100644
--- a/src/Framework/ExceptionHandling/Context/ExceptionContextData.php
+++ b/src/Framework/ExceptionHandling/Context/ExceptionContextData.php
@@ -4,6 +4,10 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling\Context;
 
+use App\Framework\Http\IpAddress;
+use App\Framework\Http\RequestId;
+use App\Framework\Http\Session\SessionId;
+use App\Framework\UserAgent\UserAgent;
 use DateTimeImmutable;
 
 /**
@@ -26,11 +30,13 @@ final readonly class ExceptionContextData
      * @param array<string, mixed> $metadata Additional metadata (tags, severity, fingerprint)
      * @param DateTimeImmutable|null $occurredAt When the exception occurred
      * @param string|null $userId User ID if available
-     * @param string|null $requestId Request ID for tracing
-     * @param string|null $sessionId Session ID if available
-     * @param string|null $clientIp Client IP address for HTTP requests
-     * @param string|null $userAgent User agent string for HTTP requests
+     * @param RequestId|string|null $requestId Request ID for tracing (Value Object or string for backward compatibility)
+     * @param SessionId|string|null $sessionId Session ID if available (Value Object or string for backward compatibility)
+     * @param IpAddress|string|null $clientIp Client IP address for HTTP requests (Value Object or string for backward compatibility)
+     * @param UserAgent|string|null $userAgent User agent string for HTTP requests (Value Object or string for backward compatibility)
      * @param array<string> $tags Tags for categorization (e.g., ['payment', 'external_api'])
+     * @param bool $auditable Whether this exception should be logged to audit system
+     * @param string|null $auditLevel Audit level for this exception (e.g., 'ERROR', 'WARNING', 'INFO')
      */
     public function __construct(
         public ?string $operation = null,
@@ -40,11 +46,13 @@ final readonly class ExceptionContextData
         public array $metadata = [],
         ?DateTimeImmutable $occurredAt = null,
         public ?string $userId = null,
-        public ?string $requestId = null,
-        public ?string $sessionId = null,
-        public ?string $clientIp = null,
-        public ?string $userAgent = null,
+        public RequestId|string|null $requestId = null,
+        public SessionId|string|null $sessionId = null,
+        public IpAddress|string|null $clientIp = null,
+        public UserAgent|string|null $userAgent = null,
         public array $tags = [],
+        public bool $auditable = true,
+        public ?string $auditLevel = null,
     ) {
         $this->occurredAt ??= new DateTimeImmutable();
     }
@@ -93,7 +101,9 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
@@ -114,7 +124,9 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
@@ -135,7 +147,9 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
@@ -156,7 +170,9 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
@@ -177,14 +193,18 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
     /**
      * Add request ID
+     *
+     * @param RequestId|string $requestId Request ID (Value Object or string for backward compatibility)
      */
-    public function withRequestId(string $requestId): self
+    public function withRequestId(RequestId|string $requestId): self
     {
         return new self(
             operation: $this->operation,
@@ -198,14 +218,18 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
     /**
      * Add session ID
+     *
+     * @param SessionId|string $sessionId Session ID (Value Object or string for backward compatibility)
      */
-    public function withSessionId(string $sessionId): self
+    public function withSessionId(SessionId|string $sessionId): self
     {
         return new self(
             operation: $this->operation,
@@ -219,14 +243,18 @@ final readonly class ExceptionContextData
             sessionId: $sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
     /**
      * Add client IP
+     *
+     * @param IpAddress|string $clientIp Client IP (Value Object or string for backward compatibility)
      */
-    public function withClientIp(string $clientIp): self
+    public function withClientIp(IpAddress|string $clientIp): self
     {
         return new self(
             operation: $this->operation,
@@ -240,14 +268,18 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $clientIp,
             userAgent: $this->userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
     /**
      * Add user agent
+     *
+     * @param UserAgent|string $userAgent User agent (Value Object or string for backward compatibility)
      */
-    public function withUserAgent(string $userAgent): self
+    public function withUserAgent(UserAgent|string $userAgent): self
     {
         return new self(
             operation: $this->operation,
@@ -261,7 +293,9 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $userAgent,
-            tags: $this->tags
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
         );
     }
 
@@ -282,7 +316,55 @@ final readonly class ExceptionContextData
             sessionId: $this->sessionId,
             clientIp: $this->clientIp,
             userAgent: $this->userAgent,
-            tags: array_merge($this->tags, $tags)
+            tags: array_merge($this->tags, $tags),
+            auditable: $this->auditable,
+            auditLevel: $this->auditLevel
+        );
+    }
+
+    /**
+     * Set auditable flag
+     */
+    public function withAuditable(bool $auditable): self
+    {
+        return new self(
+            operation: $this->operation,
+            component: $this->component,
+            data: $this->data,
+            debug: $this->debug,
+            metadata: $this->metadata,
+            occurredAt: $this->occurredAt,
+            userId: $this->userId,
+            requestId: $this->requestId,
+            sessionId: $this->sessionId,
+            clientIp: $this->clientIp,
+            userAgent: $this->userAgent,
+            tags: $this->tags,
+            auditable: $auditable,
+            auditLevel: $this->auditLevel
+        );
+    }
+
+    /**
+     * Set audit level
+     */
+    public function withAuditLevel(string $auditLevel): self
+    {
+        return new self(
+            operation: $this->operation,
+            component: $this->component,
+            data: $this->data,
+            debug: $this->debug,
+            metadata: $this->metadata,
+            occurredAt: $this->occurredAt,
+            userId: $this->userId,
+            requestId: $this->requestId,
+            sessionId: $this->sessionId,
+            clientIp: $this->clientIp,
+            userAgent: $this->userAgent,
+            tags: $this->tags,
+            auditable: $this->auditable,
+            auditLevel: $auditLevel
         );
     }
 
@@ -299,11 +381,47 @@ final readonly class ExceptionContextData
             'metadata' => $this->metadata,
             'occurred_at' => $this->occurredAt?->format('Y-m-d H:i:s.u'),
             'user_id' => $this->userId,
-            'request_id' => $this->requestId,
-            'session_id' => $this->sessionId,
-            'client_ip' => $this->clientIp,
-            'user_agent' => $this->userAgent,
+            'request_id' => $this->requestId instanceof RequestId ? $this->requestId->toString() : $this->requestId,
+            'session_id' => $this->sessionId instanceof SessionId ? $this->sessionId->toString() : $this->sessionId,
+            'client_ip' => $this->clientIp instanceof IpAddress ? $this->clientIp->value : $this->clientIp,
+            'user_agent' => $this->userAgent instanceof UserAgent ? $this->userAgent->value : $this->userAgent,
             'tags' => $this->tags,
+            'auditable' => $this->auditable,
+            'audit_level' => $this->auditLevel,
         ];
     }
+
+    /**
+     * Create from array (deserialization)
+     *
+     * @param array<string, mixed> $data
+     */
+    public static function fromArray(array $data): self
+    {
+        $occurredAt = null;
+        if (isset($data['occurred_at']) && is_string($data['occurred_at'])) {
+            try {
+                $occurredAt = new DateTimeImmutable($data['occurred_at']);
+            } catch (\Exception) {
+                // Ignore invalid date
+            }
+        }
+
+        return new self(
+            operation: $data['operation'] ?? null,
+            component: $data['component'] ?? null,
+            data: $data['data'] ?? [],
+            debug: $data['debug'] ?? [],
+            metadata: $data['metadata'] ?? [],
+            occurredAt: $occurredAt,
+            userId: $data['user_id'] ?? null,
+            requestId: $data['request_id'] ?? null,
+            sessionId: $data['session_id'] ?? null,
+            clientIp: $data['client_ip'] ?? null,
+            userAgent: $data['user_agent'] ?? null,
+            tags: $data['tags'] ?? [],
+            auditable: $data['auditable'] ?? true,
+            auditLevel: $data['audit_level'] ?? null
+        );
+    }
 }
diff --git a/src/Framework/ExceptionHandling/Context/ExceptionContextProvider.php b/src/Framework/ExceptionHandling/Context/ExceptionContextProvider.php
index 785d5c20..97ee3ebc 100644
--- a/src/Framework/ExceptionHandling/Context/ExceptionContextProvider.php
+++ b/src/Framework/ExceptionHandling/Context/ExceptionContextProvider.php
@@ -13,29 +13,19 @@ use WeakMap;
  * Context is automatically cleaned up when the exception is garbage collected.
  *
  * PHP 8.5+ WeakMap-based implementation - no memory leaks possible.
+ *
+ * Should be registered as singleton in DI container for consistent context across application.
  */
 final class ExceptionContextProvider
 {
     /** @var WeakMap<\Throwable, ExceptionContextData> */
     private WeakMap $contexts;
 
-    private static ?self $instance = null;
-
-    private function __construct()
+    public function __construct()
     {
         $this->contexts = new WeakMap();
     }
 
-    /**
-     * Get singleton instance
-     *
-     * Singleton pattern ensures consistent context across the application
-     */
-    public static function instance(): self
-    {
-        return self::$instance ??= new self();
-    }
-
     /**
      * Attach context to exception
      *
diff --git a/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelation.php b/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelation.php
new file mode 100644
index 00000000..5ba07282
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelation.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Correlation;
+
+/**
+ * Exception Correlation
+ *
+ * Immutable value object representing correlation between exceptions.
+ */
+final readonly class ExceptionCorrelation
+{
+    /**
+     * @param string $correlationKey Correlation key (Request-ID, Session-ID, etc.)
+     * @param array<string> $exceptionIds Related exception IDs
+     * @param string|null $rootCauseId Root cause exception ID
+     */
+    public function __construct(
+        public string $correlationKey,
+        public array $exceptionIds = [],
+        public ?string $rootCauseId = null
+    ) {
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'correlation_key' => $this->correlationKey,
+            'exception_ids' => $this->exceptionIds,
+            'root_cause_id' => $this->rootCauseId,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelationEngine.php b/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelationEngine.php
new file mode 100644
index 00000000..bd679395
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Correlation/ExceptionCorrelationEngine.php
@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Correlation;
+
+use App\Framework\Cache\Cache;
+use App\Framework\Cache\CacheItem;
+use App\Framework\Cache\CacheKey;
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Correlation Engine
+ *
+ * Correlates related exceptions for root cause analysis.
+ */
+final readonly class ExceptionCorrelationEngine
+{
+    private const string CACHE_PREFIX = 'exception_correlation:';
+    private const int CACHE_TTL = 3600; // 1 hour
+
+    public function __construct(
+        private Cache $cache
+    ) {
+    }
+
+    /**
+     * Correlate exception with related exceptions
+     *
+     * @param Throwable $exception Exception to correlate
+     * @param ExceptionContextData|null $context Optional context
+     * @return ExceptionCorrelation Correlation data
+     */
+    public function correlate(Throwable $exception, ?ExceptionContextData $context = null): ExceptionCorrelation
+    {
+        $correlationKey = $this->extractCorrelationKey($context);
+        if ($correlationKey === null) {
+            return new ExceptionCorrelation(correlationKey: 'unknown');
+        }
+
+        $exceptionId = spl_object_id($exception);
+        $cacheKey = CacheKey::fromString(self::CACHE_PREFIX . $correlationKey);
+
+        // Get existing correlation
+        $existing = $this->getCorrelation($cacheKey);
+        $exceptionIds = $existing->exceptionIds;
+        $exceptionIds[] = (string) $exceptionId;
+
+        // First exception in correlation is root cause
+        $rootCauseId = $existing->rootCauseId ?? (string) $exceptionId;
+
+        $correlation = new ExceptionCorrelation(
+            correlationKey: $correlationKey,
+            exceptionIds: array_unique($exceptionIds),
+            rootCauseId: $rootCauseId
+        );
+
+        // Store correlation
+        $this->storeCorrelation($cacheKey, $correlation);
+
+        return $correlation;
+    }
+
+    /**
+     * Extract correlation key from context
+     */
+    private function extractCorrelationKey(?ExceptionContextData $context): ?string
+    {
+        if ($context === null) {
+            return null;
+        }
+
+        // Prefer Request-ID, then Session-ID, then User-ID
+        if ($context->requestId !== null) {
+            $requestId = is_string($context->requestId) ? $context->requestId : $context->requestId->toString();
+            return 'request:' . $requestId;
+        }
+
+        if ($context->sessionId !== null) {
+            $sessionId = is_string($context->sessionId) ? $context->sessionId : $context->sessionId->toString();
+            return 'session:' . $sessionId;
+        }
+
+        if ($context->userId !== null) {
+            return 'user:' . $context->userId;
+        }
+
+        return null;
+    }
+
+    /**
+     * Get correlation from cache
+     */
+    private function getCorrelation(CacheKey $cacheKey): ExceptionCorrelation
+    {
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        if ($item === null) {
+            return new ExceptionCorrelation(correlationKey: '');
+        }
+
+        $value = $item->value;
+        if (is_array($value)) {
+            return new ExceptionCorrelation(
+                correlationKey: $value['correlation_key'] ?? '',
+                exceptionIds: $value['exception_ids'] ?? [],
+                rootCauseId: $value['root_cause_id'] ?? null
+            );
+        }
+
+        return new ExceptionCorrelation(correlationKey: '');
+    }
+
+    /**
+     * Store correlation in cache
+     */
+    private function storeCorrelation(CacheKey $cacheKey, ExceptionCorrelation $correlation): void
+    {
+        $cacheItem = CacheItem::fromKey(
+            $cacheKey,
+            $correlation->toArray(),
+            Duration::fromSeconds(self::CACHE_TTL)
+        );
+
+        $this->cache->set($cacheItem);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ErrorContext.php b/src/Framework/ExceptionHandling/ErrorContext.php
index a3ebe53a..a1317cd9 100644
--- a/src/Framework/ExceptionHandling/ErrorContext.php
+++ b/src/Framework/ExceptionHandling/ErrorContext.php
@@ -3,6 +3,7 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling;
 
+use App\Framework\Core\ValueObjects\LineNumber;
 use ErrorException;
 
 final readonly class ErrorContext
@@ -11,7 +12,7 @@ final readonly class ErrorContext
         public int $severity,
         public string $message,
         public ?string $file = null,
-        public ?int $line = null,
+        public ?LineNumber $line = null,
         public bool $isSuppressed = false,
     ) {}
 
@@ -22,16 +23,22 @@ final readonly class ErrorContext
         ?int $line = null,
         bool $isSuppressed = false,
     ): self {
-        return new self($severity, $message, $file, $line, $isSuppressed);
+        return new self(
+            $severity,
+            $message,
+            $file,
+            $line !== null ? LineNumber::fromInt($line) : null,
+            $isSuppressed
+        );
     }
 
     public function isDeprecation(): bool
     {
-        return $this->severity === E_DEPRECATED || $this->severity === E_USER_DEPRECATED;
+        return ErrorSeverityType::isDeprecation($this->severity);
     }
 
     public function isFatal(): bool
     {
-        return in_array($this->severity, [E_ERROR, E_RECOVERABLE_ERROR, E_USER_ERROR], true);
+        return ErrorSeverityType::isFatal($this->severity);
     }
 }
diff --git a/src/Framework/ExceptionHandling/ErrorHandler.php b/src/Framework/ExceptionHandling/ErrorHandler.php
index 0562cd96..1403b1ba 100644
--- a/src/Framework/ExceptionHandling/ErrorHandler.php
+++ b/src/Framework/ExceptionHandling/ErrorHandler.php
@@ -6,12 +6,11 @@ namespace App\Framework\ExceptionHandling;
 use App\Framework\ExceptionHandling\Strategy\StrictErrorPolicy;
 use ErrorException;
 
-final readonly class ErrorHandler
+final readonly class ErrorHandler implements ErrorHandlerInterface
 {
     public function __construct(
         private ErrorHandlerStrategy $strategy = new StrictErrorPolicy,
-    )
-    {}
+    ) {}
 
 
     /**
diff --git a/src/Framework/ExceptionHandling/ErrorHandlerInterface.php b/src/Framework/ExceptionHandling/ErrorHandlerInterface.php
index 58e07a71..42f12b04 100644
--- a/src/Framework/ExceptionHandling/ErrorHandlerInterface.php
+++ b/src/Framework/ExceptionHandling/ErrorHandlerInterface.php
@@ -4,5 +4,10 @@ namespace App\Framework\ExceptionHandling;
 
 interface ErrorHandlerInterface
 {
-
+    public function handle(
+        int $severity,
+        string $message,
+        ?string $file = null,
+        ?int $line = null,
+    ): bool;
 }
diff --git a/src/Framework/ExceptionHandling/ErrorKernel.php b/src/Framework/ExceptionHandling/ErrorKernel.php
index 2dc98692..a6c3056f 100644
--- a/src/Framework/ExceptionHandling/ErrorKernel.php
+++ b/src/Framework/ExceptionHandling/ErrorKernel.php
@@ -3,32 +3,151 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling;
 
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Context\ExecutionContext;
+use App\Framework\ErrorAggregation\ErrorAggregatorInterface;
+use App\Framework\ExceptionHandling\Audit\ExceptionAuditLogger;
 use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\ExceptionHandling\RateLimit\ExceptionRateLimiter;
+use App\Framework\ExceptionHandling\Reporter\Reporter;
+use App\Framework\ExceptionHandling\Renderers\ConsoleErrorRenderer;
 use App\Framework\ExceptionHandling\Renderers\ResponseErrorRenderer;
-use App\Framework\ExceptionHandling\Reporter\LogReporter;
-use App\Framework\Http\Response;
+use App\Framework\Http\HttpResponse;
 use Throwable;
 
+/**
+ * Unified Error Kernel with context-aware handling
+ *
+ * Automatically detects execution context (CLI vs HTTP) and handles exceptions accordingly:
+ * - CLI: Colored console output
+ * - HTTP: HTTP Response objects
+ */
 final readonly class ErrorKernel
 {
     public function __construct(
-        private ErrorRendererFactory $rendererFactory = new ErrorRendererFactory,
+        private ErrorRendererFactory $rendererFactory,
+        private ?Reporter $reporter,
+        private ?ErrorAggregatorInterface $errorAggregator = null,
+        private ?ExceptionContextProvider $contextProvider = null,
+        private ?ExceptionAuditLogger $auditLogger = null,
+        private ?ExceptionRateLimiter $rateLimiter = null,
+        private ?ExecutionContext $executionContext = null,
+        private ?ConsoleOutput $consoleOutput = null,
+        private bool $isDebugMode = false
     ) {}
+
+    /**
+     * Context-aware exception handler
+     *
+     * Automatically detects execution context and handles accordingly:
+     * - CLI contexts: Outputs colored error messages to console
+     * - HTTP contexts: Logs error (does not create response - use createHttpResponse)
+     *
+     * @param Throwable $e Exception to handle
+     * @param array $context Additional context data
+     */
     public function handle(Throwable $e, array $context = []): mixed
     {
+        // Get exception context from provider
+        $exceptionContext = $this->contextProvider?->get($e);
 
-        $log = new LogReporter();
-        $log->report($e);
+        // Check rate limiting before logging/audit
+        $shouldSkipLogging = $this->rateLimiter?->shouldSkipLogging($e, $exceptionContext) ?? false;
+        $shouldSkipAudit = $this->rateLimiter?->shouldSkipAudit($e, $exceptionContext) ?? false;
 
-        var_dump((string)$e);
+        // Log exception to audit system if auditable and not rate limited
+        if ($this->auditLogger !== null && !$shouldSkipAudit) {
+            $this->auditLogger->logIfAuditable($e, $exceptionContext);
+        }
 
-        $this->rendererFactory->getRenderer()->render();
+        // Log exception if not rate limited
+        if (!$shouldSkipLogging) {
+            $this->reporter->report($e);
+        }
 
-        exit();
+        // Auto-trigger pattern detection if aggregator is available
+        if ($this->errorAggregator !== null && $this->contextProvider !== null) {
+            $this->errorAggregator->processError(
+                $e,
+                $this->contextProvider,
+                $this->isDebugMode
+            );
+        }
 
+        // Detect execution context
+        $executionContext = $this->executionContext ?? ExecutionContext::detect();
+
+        // Handle based on context
+        if ($executionContext->isCli()) {
+            $this->handleCliException($e);
+            return null;
+        }
+
+        // For HTTP context, just log (middleware will create response)
         return null;
     }
 
+    /**
+     * Handle exception in CLI context with colored output
+     */
+    private function handleCliException(Throwable $exception): void
+    {
+        $output = $this->consoleOutput ?? new ConsoleOutput();
+        $renderer = new \App\Framework\ExceptionHandling\Renderers\ConsoleErrorRenderer($output);
+
+        $renderer->render($exception, $this->contextProvider);
+    }
+
+    /**
+     * Handle PHP error in CLI context with colored output (stderr)
+     */
+    public function handleCliError(int $severity, string $message, string $file, int $line): void
+    {
+        $errorType = $this->getErrorType($severity);
+        $color = $this->getErrorColor($severity);
+
+        $output = $this->consoleOutput ?? new ConsoleOutput();
+        $output->writeErrorLine("[$errorType] $message", $color);
+        $output->writeErrorLine("  in $file:$line", ConsoleColor::GRAY);
+
+        // Create ErrorException and log
+        $exception = new \ErrorException($message, 0, $severity, $file, $line);
+        $this->reporter->report($exception);
+
+        // Auto-trigger pattern detection if aggregator is available
+        if ($this->errorAggregator !== null && $this->contextProvider !== null) {
+            $this->errorAggregator->processError(
+                $exception,
+                $this->contextProvider,
+                $this->isDebugMode
+            );
+        }
+    }
+
+    /**
+     * Handle fatal error in CLI context (stderr)
+     */
+    public function handleCliFatalError(array $error): void
+    {
+        $output = $this->consoleOutput ?? new ConsoleOutput();
+        $output->writeErrorLine("💥 Fatal Error: " . $error['message'], ConsoleColor::BRIGHT_RED);
+        $output->writeErrorLine("   File: " . $error['file'] . ":" . $error['line'], ConsoleColor::RED);
+
+        // Create ErrorException and log
+        $exception = new \ErrorException($error['message'], 0, $error['type'], $error['file'], $error['line']);
+        $this->reporter->report($exception);
+
+        // Auto-trigger pattern detection if aggregator is available
+        if ($this->errorAggregator !== null && $this->contextProvider !== null) {
+            $this->errorAggregator->processError(
+                $exception,
+                $this->contextProvider,
+                $this->isDebugMode
+            );
+        }
+    }
+
     /**
      * Create HTTP Response from exception without terminating execution
      *
@@ -37,19 +156,61 @@ final readonly class ErrorKernel
      *
      * @param Throwable $exception Exception to render
      * @param ExceptionContextProvider|null $contextProvider Optional WeakMap context provider
-     * @param bool $isDebugMode Enable debug information in response
-     * @return Response HTTP Response object (JSON for API, HTML for web)
+     * @param bool|null $isDebugMode Override debug mode (uses instance default if null)
+     * @return HttpResponse HTTP Response object (JSON for API, HTML for web)
      */
     public function createHttpResponse(
         Throwable $exception,
         ?ExceptionContextProvider $contextProvider = null,
-        bool $isDebugMode = false
-    ): Response {
-        // Create ResponseErrorRenderer with debug mode setting
-        $renderer = new ResponseErrorRenderer($isDebugMode);
+        ?bool $isDebugMode = null
+    ): HttpResponse {
+        // Use provided debug mode or instance default
+        $debugMode = $isDebugMode ?? $this->isDebugMode;
 
-        // Generate and return Response object
-        return $renderer->createResponse($exception, $contextProvider);
+        // Get renderer from factory
+        $renderer = $this->rendererFactory->getRenderer();
+
+        // If renderer is ResponseErrorRenderer and debug mode changed, create new one with correct debug mode
+        if ($renderer instanceof ResponseErrorRenderer && $debugMode !== $this->isDebugMode) {
+            $renderer = $this->rendererFactory->createHttpRenderer($debugMode);
+        }
+
+        // Render exception using unified interface
+        $result = $renderer->render(
+            $exception,
+            $contextProvider ?? $this->contextProvider
+        );
+
+        // Ensure we return HttpResponse (type safety)
+        if (!$result instanceof HttpResponse) {
+            throw new \RuntimeException('HTTP renderer must return HttpResponse');
+        }
+
+        return $result;
+    }
+
+    private function getErrorType(int $severity): string
+    {
+        return match ($severity) {
+            E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR => 'ERROR',
+            E_WARNING, E_CORE_WARNING, E_COMPILE_WARNING, E_USER_WARNING => 'WARNING',
+            E_NOTICE, E_USER_NOTICE => 'NOTICE',
+            E_STRICT => 'STRICT',
+            E_RECOVERABLE_ERROR => 'RECOVERABLE_ERROR',
+            E_DEPRECATED, E_USER_DEPRECATED => 'DEPRECATED',
+            default => 'UNKNOWN'
+        };
+    }
+
+    private function getErrorColor(int $severity): ConsoleColor
+    {
+        return match ($severity) {
+            E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR => ConsoleColor::BRIGHT_RED,
+            E_WARNING, E_CORE_WARNING, E_COMPILE_WARNING, E_USER_WARNING => ConsoleColor::YELLOW,
+            E_NOTICE, E_USER_NOTICE => ConsoleColor::CYAN,
+            E_DEPRECATED, E_USER_DEPRECATED => ConsoleColor::MAGENTA,
+            default => ConsoleColor::WHITE
+        };
     }
 }
 
diff --git a/src/Framework/ExceptionHandling/ErrorRenderer.php b/src/Framework/ExceptionHandling/ErrorRenderer.php
index 87acab30..280e6cb0 100644
--- a/src/Framework/ExceptionHandling/ErrorRenderer.php
+++ b/src/Framework/ExceptionHandling/ErrorRenderer.php
@@ -1,8 +1,34 @@
 <?php
 
+declare(strict_types=1);
+
 namespace App\Framework\ExceptionHandling;
 
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+
+/**
+ * Unified interface for error renderers
+ *
+ * All error renderers implement this interface, regardless of output format.
+ * - HTTP renderers return HttpResponse
+ * - CLI renderers return void (output directly to console)
+ */
 interface ErrorRenderer
 {
-    public function render(): void;
+    /**
+     * Check if this renderer can handle the given exception
+     */
+    public function canRender(\Throwable $exception): bool;
+
+    /**
+     * Render exception to appropriate output format
+     *
+     * @param \Throwable $exception Exception to render
+     * @param ExceptionContextProvider|null $contextProvider Optional context provider
+     * @return mixed HttpResponse for HTTP context, void for CLI context
+     */
+    public function render(
+        \Throwable $exception,
+        ?ExceptionContextProvider $contextProvider = null
+    ): mixed;
 }
diff --git a/src/Framework/ExceptionHandling/ErrorRendererFactory.php b/src/Framework/ExceptionHandling/ErrorRendererFactory.php
index c9a4d1ed..b7e8cb62 100644
--- a/src/Framework/ExceptionHandling/ErrorRendererFactory.php
+++ b/src/Framework/ExceptionHandling/ErrorRendererFactory.php
@@ -3,11 +3,52 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling;
 
-use App\Framework\ExceptionHandling\Renderer\HtmlErrorRenderer;
-final class ErrorRendererFactory
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Context\ExecutionContext;
+use App\Framework\ExceptionHandling\Renderers\ConsoleErrorRenderer;
+use App\Framework\ExceptionHandling\Renderers\ResponseErrorRenderer;
+use App\Framework\View\Engine;
+
+/**
+ * Factory for creating appropriate error renderers based on execution context
+ *
+ * Uses unified ErrorRenderer interface - all renderers implement the same interface.
+ */
+final readonly class ErrorRendererFactory
 {
-    public function getRenderer():ErrorRenderer
+    public function __construct(
+        private ExecutionContext $executionContext,
+        private Engine $engine,
+        private ?ConsoleOutput $consoleOutput = null,
+        private bool $isDebugMode = true
+    ) {}
+
+    /**
+     * Get appropriate renderer for current execution context
+     */
+    public function getRenderer(): ErrorRenderer
     {
-        return new HtmlErrorRenderer();
+        if ($this->executionContext->isCli()) {
+            // ConsoleOutput should always be available in CLI context
+            $output = $this->consoleOutput ?? new ConsoleOutput();
+            return new ConsoleErrorRenderer($output);
+        }
+
+        return new ResponseErrorRenderer($this->engine, $this->isDebugMode);
+    }
+
+    /**
+     * Create HTTP renderer with optional debug mode override
+     *
+     * Allows creating a ResponseErrorRenderer with a different debug mode
+     * than the factory's default, without using reflection.
+     *
+     * @param bool|null $debugMode Override debug mode (uses factory default if null)
+     * @return ResponseErrorRenderer HTTP error renderer
+     */
+    public function createHttpRenderer(?bool $debugMode = null): ResponseErrorRenderer
+    {
+        $debugMode = $debugMode ?? $this->isDebugMode;
+        return new ResponseErrorRenderer($this->engine, $debugMode);
     }
 }
diff --git a/src/Framework/ExceptionHandling/ErrorSeverityType.php b/src/Framework/ExceptionHandling/ErrorSeverityType.php
new file mode 100644
index 00000000..78c38530
--- /dev/null
+++ b/src/Framework/ExceptionHandling/ErrorSeverityType.php
@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+/**
+ * Error severity type enum with helper methods
+ *
+ * Provides type-safe error severity categorization and validation methods.
+ */
+enum ErrorSeverityType: int
+{
+    case DEPRECATION = E_DEPRECATED;
+    case USER_DEPRECATION = E_USER_DEPRECATED;
+    case FATAL = E_ERROR;
+    case RECOVERABLE_ERROR = E_RECOVERABLE_ERROR;
+    case USER_ERROR = E_USER_ERROR;
+    case WARNING = E_WARNING;
+    case USER_WARNING = E_USER_WARNING;
+    case NOTICE = E_NOTICE;
+    case USER_NOTICE = E_USER_NOTICE;
+    case STRICT = E_STRICT;
+
+    /**
+     * Check if severity is a deprecation warning
+     */
+    public static function isDeprecation(int $severity): bool
+    {
+        return $severity === self::DEPRECATION->value
+            || $severity === self::USER_DEPRECATION->value;
+    }
+
+    /**
+     * Check if severity is fatal
+     */
+    public static function isFatal(int $severity): bool
+    {
+        return in_array($severity, [
+            self::FATAL->value,
+            self::RECOVERABLE_ERROR->value,
+            self::USER_ERROR->value,
+        ], true);
+    }
+
+    /**
+     * Check if severity is a warning
+     */
+    public static function isWarning(int $severity): bool
+    {
+        return in_array($severity, [
+            self::WARNING->value,
+            self::USER_WARNING->value,
+        ], true);
+    }
+
+    /**
+     * Check if severity is a notice
+     */
+    public static function isNotice(int $severity): bool
+    {
+        return in_array($severity, [
+            self::NOTICE->value,
+            self::USER_NOTICE->value,
+        ], true);
+    }
+
+    /**
+     * Get human-readable name for severity
+     */
+    public static function getName(int $severity): string
+    {
+        return match ($severity) {
+            self::DEPRECATION->value => 'Deprecation',
+            self::USER_DEPRECATION->value => 'User Deprecation',
+            self::FATAL->value => 'Fatal Error',
+            self::RECOVERABLE_ERROR->value => 'Recoverable Error',
+            self::USER_ERROR->value => 'User Error',
+            self::WARNING->value => 'Warning',
+            self::USER_WARNING->value => 'User Warning',
+            self::NOTICE->value => 'Notice',
+            self::USER_NOTICE->value => 'User Notice',
+            self::STRICT->value => 'Strict',
+            default => 'Unknown',
+        };
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ExceptionHandlerManager.php b/src/Framework/ExceptionHandling/ExceptionHandlerManager.php
index 8203ba29..d95746f9 100644
--- a/src/Framework/ExceptionHandling/ExceptionHandlerManager.php
+++ b/src/Framework/ExceptionHandling/ExceptionHandlerManager.php
@@ -3,19 +3,37 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling;
 
-use App\Framework\Config\EnvironmentType;
-use App\Framework\ExceptionHandling\Strategy\ErrorPolicyResolver;
-
+/**
+ * Manages global exception, error, and shutdown handlers
+ *
+ * Supports early registration with basic handlers before Discovery,
+ * and replacement with full handlers after Discovery.
+ */
 final readonly class ExceptionHandlerManager
 {
-    public function __construct()
+    public function __construct(
+        private ErrorHandlerInterface $errorHandler,
+        private ExceptionHandler $exceptionHandler,
+        private ShutdownHandlerInterface $shutdownHandler
+    ) {
+        $this->registerErrorHandler($this->errorHandler);
+        $this->registerExceptionHandler($this->exceptionHandler);
+        $this->registerShutdownHandler($this->shutdownHandler);
+    }
+
+    /**
+     * Create ExceptionHandlerManager with basic handlers for early registration
+     *
+     * This factory method creates a manager with minimal handlers that don't
+     * require full dependencies. Useful for registering handlers before Discovery.
+     */
+    public static function createWithBasicHandlers(): self
     {
-        $resolver = new ErrorPolicyResolver();
-        $this->registerErrorHandler(new ErrorHandler($resolver->resolve(EnvironmentType::DEV)));
-
-        $this->registerExceptionHandler(new GlobalExceptionHandler());
-
-        $this->registerShutdownHandler(new ShutdownHandler());
+        return new self(
+            new BasicErrorHandler(),
+            new BasicGlobalExceptionHandler(),
+            new BasicShutdownHandler()
+        );
     }
 
     public function registerExceptionHandler(ExceptionHandler $handler): void
@@ -23,12 +41,12 @@ final readonly class ExceptionHandlerManager
         set_exception_handler($handler->handle(...));
     }
 
-    private function registerErrorHandler(ErrorHandler $handler):void
+    private function registerErrorHandler(ErrorHandlerInterface $handler): void
     {
         set_error_handler($handler->handle(...), E_ALL);
     }
 
-    public function registerShutdownHandler(ShutdownHandler $handler): void
+    public function registerShutdownHandler(ShutdownHandlerInterface $handler): void
     {
         register_shutdown_function($handler->handle(...));
     }
diff --git a/src/Framework/ExceptionHandling/ExceptionHandlerManagerFactory.php b/src/Framework/ExceptionHandling/ExceptionHandlerManagerFactory.php
new file mode 100644
index 00000000..477f0377
--- /dev/null
+++ b/src/Framework/ExceptionHandling/ExceptionHandlerManagerFactory.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+use App\Framework\Context\ExecutionContext;
+use App\Framework\DI\Container;
+
+/**
+ * Factory for creating and registering ExceptionHandlerManager
+ *
+ * Automatically creates ExceptionHandlerManager with appropriate configuration
+ * based on execution context. Eliminates code duplication in AppBootstrapper.
+ */
+final readonly class ExceptionHandlerManagerFactory
+{
+    public function __construct(
+        private Container $container
+    ) {}
+
+    /**
+     * Create and register ExceptionHandlerManager for current execution context
+     *
+     * Automatically detects context (CLI vs HTTP) and registers appropriate handlers.
+     * ErrorKernel will handle context-specific rendering automatically.
+     */
+    public function createAndRegister(?ExecutionContext $executionContext = null): ExceptionHandlerManager
+    {
+        // Get execution context from container if not provided
+        if ($executionContext === null && $this->container->has(ExecutionContext::class)) {
+            $executionContext = $this->container->get(ExecutionContext::class);
+        }
+
+        // Create handlers with dependencies from container
+        $errorHandler = $this->container->get(ErrorHandler::class);
+        $exceptionHandler = $this->container->get(GlobalExceptionHandler::class);
+        $shutdownHandler = $this->container->get(ShutdownHandler::class);
+
+        // Create and register ExceptionHandlerManager
+        // Registration happens automatically in constructor
+        return new ExceptionHandlerManager(
+            $errorHandler,
+            $exceptionHandler,
+            $shutdownHandler
+        );
+    }
+
+    /**
+     * Create ExceptionHandlerManager without registering (for testing)
+     */
+    public function create(): ExceptionHandlerManager
+    {
+        $errorHandler = $this->container->get(ErrorHandler::class);
+        $exceptionHandler = $this->container->get(GlobalExceptionHandler::class);
+        $shutdownHandler = $this->container->get(ShutdownHandler::class);
+
+        return new ExceptionHandlerManager(
+            $errorHandler,
+            $exceptionHandler,
+            $shutdownHandler
+        );
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php b/src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php
new file mode 100644
index 00000000..eca266b7
--- /dev/null
+++ b/src/Framework/ExceptionHandling/ExceptionHandlingInitializer.php
@@ -0,0 +1,123 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+use App\Framework\Config\EnvironmentType;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Context\ExecutionContext;
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\ExceptionHandling\Reporter\LogReporter;
+use App\Framework\ExceptionHandling\Reporter\Reporter;
+use App\Framework\ExceptionHandling\Reporter\ReporterRegistry;
+use App\Framework\ExceptionHandling\Strategy\ErrorPolicyResolver;
+use App\Framework\Logging\Logger;
+use App\Framework\View\Engine;
+
+/**
+ * Initializer for Exception Handling services
+ */
+final readonly class ExceptionHandlingInitializer
+{
+    #[Initializer]
+    public function initialize(
+        Container $container,
+        EnvironmentType $environmentType,
+        ExecutionContext $executionContext,
+        Engine $engine,
+        ?ConsoleOutput $consoleOutput = null,
+        ?Logger $logger = null
+    ): void {
+        $isDebugMode = $environmentType->isDebugEnabled();
+
+        // ConsoleOutput - only create if CLI context and not already provided
+        // For HTTP context, null is acceptable (ConsoleErrorRenderer won't be used)
+        $consoleOutput = $executionContext->isCli()
+            ? ($consoleOutput ?? new ConsoleOutput())
+            : null;
+
+        // ReporterRegistry - bind with LogReporter as default
+        $registry = new ReporterRegistry(new LogReporter());
+        $container->singleton(Reporter::class, $registry);
+
+        // ErrorRendererFactory - singleton since configuration doesn't change
+        // ConsoleOutput can be null for HTTP context (factory will handle it)
+        $container->singleton(ErrorRendererFactory::class, new ErrorRendererFactory(
+            executionContext: $executionContext,
+            engine: $engine,
+            consoleOutput: $consoleOutput, // null for HTTP context, ConsoleOutput for CLI context
+            isDebugMode: $isDebugMode
+        ));
+
+        // ErrorKernel - can be autowired (optional dependencies are nullable)
+        // No explicit binding needed - container will autowire
+
+        // GlobalExceptionHandler - can be autowired
+        // No explicit binding needed - container will autowire
+
+        // ShutdownHandler - can be autowired
+        // No explicit binding needed - container will autowire
+
+        // ErrorHandler - needs ErrorHandlerStrategy from ErrorPolicyResolver
+        $errorPolicyResolver = new ErrorPolicyResolver($logger);
+        $strategy = $errorPolicyResolver->resolve($environmentType);
+        $container->bind(ErrorHandler::class, new ErrorHandler(strategy: $strategy));
+
+        // ExceptionContextProvider - bind as singleton if not already bound
+        if (!$container->has(ExceptionContextProvider::class)) {
+            $container->singleton(ExceptionContextProvider::class, new ExceptionContextProvider());
+        }
+
+        // Replace early-registered basic handlers with full implementations
+        // This happens after Discovery, so all dependencies are available
+        $this->replaceEarlyHandlers($container, $executionContext);
+    }
+
+    /**
+     * Replace early-registered basic handlers with full implementations
+     */
+    private function replaceEarlyHandlers(Container $container, ExecutionContext $executionContext): void
+    {
+        try {
+            $manager = $this->createFullHandlerManager($container);
+            $this->registerManager($container, $manager);
+        } catch (\Throwable $e) {
+            // If replacement fails, basic handlers will remain active
+            // This is acceptable as they provide basic error handling
+            // Log to stderr to avoid dependency on logger
+            error_log("Failed to replace early exception handlers: " . $e->getMessage());
+        }
+    }
+
+    /**
+     * Create ExceptionHandlerManager with full handlers from container
+     */
+    private function createFullHandlerManager(Container $container): ExceptionHandlerManager
+    {
+        $errorHandler = $container->get(ErrorHandler::class);
+        $exceptionHandler = $container->get(GlobalExceptionHandler::class);
+        $shutdownHandler = $container->get(ShutdownHandler::class);
+
+        // Create ExceptionHandlerManager which will register the full handlers
+        // This replaces the basic handlers registered in AppBootstrapper::__construct
+        return new ExceptionHandlerManager(
+            $errorHandler,
+            $exceptionHandler,
+            $shutdownHandler
+        );
+    }
+
+    /**
+     * Register ExceptionHandlerManager in container
+     */
+    private function registerManager(Container $container, ExceptionHandlerManager $manager): void
+    {
+        // Store manager in container for potential later use
+        if (!$container->has(ExceptionHandlerManager::class)) {
+            $container->instance(ExceptionHandlerManager::class, $manager);
+        }
+    }
+}
diff --git a/src/Framework/ExceptionHandling/Factory/ExceptionFactory.php b/src/Framework/ExceptionHandling/Factory/ExceptionFactory.php
index 3fab9d07..06ea577d 100644
--- a/src/Framework/ExceptionHandling/Factory/ExceptionFactory.php
+++ b/src/Framework/ExceptionHandling/Factory/ExceptionFactory.php
@@ -7,6 +7,9 @@ namespace App\Framework\ExceptionHandling\Factory;
 use App\Framework\ExceptionHandling\Context\ExceptionContextData;
 use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
 use App\Framework\ExceptionHandling\Scope\ErrorScope;
+use App\Framework\Http\IpAddress;
+use App\Framework\Http\Session\SessionId;
+use App\Framework\UserAgent\UserAgent;
 use Throwable;
 
 /**
@@ -136,6 +139,85 @@ final readonly class ExceptionFactory
         return $this->create($exceptionClass, $message, $context, $previous);
     }
 
+    /**
+     * Create auditable exception with operation context
+     *
+     * Creates exception that will be logged to audit system.
+     *
+     * @template T of Throwable
+     * @param class-string<T> $exceptionClass
+     * @param string $message
+     * @param string $operation
+     * @param string|null $component
+     * @param array<string, mixed> $data
+     * @param Throwable|null $previous
+     * @return T
+     */
+    public function createAuditable(
+        string $exceptionClass,
+        string $message,
+        string $operation,
+        ?string $component = null,
+        array $data = [],
+        ?\Throwable $previous = null
+    ): Throwable {
+        $context = ExceptionContextData::forOperation($operation, $component)
+            ->addData($data)
+            ->withAuditable(true);
+
+        return $this->create($exceptionClass, $message, $context, $previous);
+    }
+
+    /**
+     * Create non-auditable exception
+     *
+     * Creates exception that will NOT be logged to audit system.
+     *
+     * @template T of Throwable
+     * @param class-string<T> $exceptionClass
+     * @param string $message
+     * @param ExceptionContextData|null $context
+     * @param Throwable|null $previous
+     * @return T
+     */
+    public function createNonAuditable(
+        string $exceptionClass,
+        string $message,
+        ?ExceptionContextData $context = null,
+        ?\Throwable $previous = null
+    ): Throwable {
+        $nonAuditableContext = ($context ?? ExceptionContextData::empty())
+            ->withAuditable(false);
+
+        return $this->create($exceptionClass, $message, $nonAuditableContext, $previous);
+    }
+
+    /**
+     * Create exception with audit level
+     *
+     * Sets the audit level for the exception (e.g., 'ERROR', 'WARNING', 'INFO').
+     *
+     * @template T of Throwable
+     * @param class-string<T> $exceptionClass
+     * @param string $message
+     * @param string $auditLevel
+     * @param ExceptionContextData|null $context
+     * @param Throwable|null $previous
+     * @return T
+     */
+    public function withAuditLevel(
+        string $exceptionClass,
+        string $message,
+        string $auditLevel,
+        ?ExceptionContextData $context = null,
+        ?\Throwable $previous = null
+    ): Throwable {
+        $contextWithLevel = ($context ?? ExceptionContextData::empty())
+            ->withAuditLevel($auditLevel);
+
+        return $this->create($exceptionClass, $message, $contextWithLevel, $previous);
+    }
+
     /**
      * Enrich context from current error scope
      *
@@ -182,12 +264,39 @@ final readonly class ExceptionFactory
         }
 
         // Extract HTTP fields from scope metadata (for HTTP scopes)
+        // Convert strings to Value Objects where possible
         if (isset($scopeContext->metadata['ip'])) {
-            $enriched = $enriched->withClientIp($scopeContext->metadata['ip']);
+            $ipValue = $scopeContext->metadata['ip'];
+            if (is_string($ipValue) && IpAddress::isValid($ipValue)) {
+                $enriched = $enriched->withClientIp(IpAddress::from($ipValue));
+            } elseif ($ipValue instanceof IpAddress) {
+                $enriched = $enriched->withClientIp($ipValue);
+            } else {
+                // Fallback to string for backward compatibility
+                $enriched = $enriched->withClientIp($ipValue);
+            }
         }
 
         if (isset($scopeContext->metadata['user_agent'])) {
-            $enriched = $enriched->withUserAgent($scopeContext->metadata['user_agent']);
+            $userAgentValue = $scopeContext->metadata['user_agent'];
+            if (is_string($userAgentValue)) {
+                $enriched = $enriched->withUserAgent(UserAgent::fromString($userAgentValue));
+            } elseif ($userAgentValue instanceof UserAgent) {
+                $enriched = $enriched->withUserAgent($userAgentValue);
+            } else {
+                // Fallback to string for backward compatibility
+                $enriched = $enriched->withUserAgent($userAgentValue);
+            }
+        }
+
+        // Convert session ID to Value Object if available
+        if ($scopeContext->sessionId !== null && is_string($scopeContext->sessionId)) {
+            try {
+                $enriched = $enriched->withSessionId(SessionId::fromString($scopeContext->sessionId));
+            } catch (\InvalidArgumentException) {
+                // If SessionId validation fails, keep as string for backward compatibility
+                $enriched = $enriched->withSessionId($scopeContext->sessionId);
+            }
         }
 
         // Add scope tags
diff --git a/src/Framework/ExceptionHandling/FatalErrorTypes.php b/src/Framework/ExceptionHandling/FatalErrorTypes.php
new file mode 100644
index 00000000..c76b0e98
--- /dev/null
+++ b/src/Framework/ExceptionHandling/FatalErrorTypes.php
@@ -0,0 +1,30 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling;
+
+/**
+ * Centralized fatal error type definitions
+ *
+ * Provides a single source of truth for which PHP error types
+ * are considered fatal and should trigger shutdown handlers.
+ */
+final class FatalErrorTypes
+{
+    public const array FATAL_TYPES = [
+        E_ERROR,
+        E_PARSE,
+        E_CORE_ERROR,
+        E_COMPILE_ERROR,
+        E_USER_ERROR
+    ];
+
+    /**
+     * Check if an error type is fatal
+     */
+    public static function isFatal(int $type): bool
+    {
+        return in_array($type, self::FATAL_TYPES, true);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/GlobalExceptionHandler.php b/src/Framework/ExceptionHandling/GlobalExceptionHandler.php
index 6ede88a7..fa9e786a 100644
--- a/src/Framework/ExceptionHandling/GlobalExceptionHandler.php
+++ b/src/Framework/ExceptionHandling/GlobalExceptionHandler.php
@@ -5,10 +5,12 @@ namespace App\Framework\ExceptionHandling;
 
 final readonly class GlobalExceptionHandler implements ExceptionHandler
 {
+    public function __construct(
+        private ErrorKernel $errorKernel
+    ) {}
+
     public function handle(\Throwable $throwable): void
     {
-        $kernel = new ErrorKernel();
-
-        $kernel->handle($throwable);
+        $this->errorKernel->handle($throwable);
     }
 }
diff --git a/src/Framework/ExceptionHandling/Health/ExceptionHealthChecker.php b/src/Framework/ExceptionHandling/Health/ExceptionHealthChecker.php
new file mode 100644
index 00000000..180850c3
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Health/ExceptionHealthChecker.php
@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Health;
+
+use App\Framework\ExceptionHandling\Metrics\ExceptionMetrics;
+use App\Framework\ExceptionHandling\Metrics\ExceptionMetricsCollector;
+use App\Framework\Health\HealthCheckInterface;
+use App\Framework\Health\HealthCheckResult;
+
+/**
+ * Exception Health Checker
+ *
+ * Provides health checks based on exception rate.
+ */
+final readonly class ExceptionHealthChecker implements HealthCheckInterface
+{
+    public readonly string $name;
+    public readonly int $timeout;
+
+    /**
+     * @param ExceptionMetricsCollector $metricsCollector Metrics collector
+     * @param string $name Health check name
+     * @param int $timeout Timeout in milliseconds
+     * @param float $errorRateThreshold Error rate threshold (0.0 to 1.0, e.g., 0.1 = 10%)
+     * @param int $timeWindowSeconds Time window in seconds for error rate calculation
+     */
+    public function __construct(
+        private ExceptionMetricsCollector $metricsCollector,
+        string $name = 'Exception Rate',
+        int $timeout = 2000,
+        private float $errorRateThreshold = 0.1, // 10% default
+        private int $timeWindowSeconds = 60
+    ) {
+        $this->name = $name;
+        $this->timeout = $timeout;
+
+        if ($errorRateThreshold < 0.0 || $errorRateThreshold > 1.0) {
+            throw new \InvalidArgumentException('errorRateThreshold must be between 0.0 and 1.0');
+        }
+    }
+
+    /**
+     * Perform health check
+     */
+    public function check(): HealthCheckResult
+    {
+        $metrics = $this->metricsCollector->getMetrics();
+        $errorRate = $this->calculateErrorRate($metrics);
+
+        if ($errorRate >= $this->errorRateThreshold) {
+            return HealthCheckResult::unhealthy(
+                "Exception error rate too high: " . number_format($errorRate * 100, 2) . "%",
+                [
+                    'error_rate' => $errorRate,
+                    'threshold' => $this->errorRateThreshold,
+                    'total_exceptions' => $metrics->totalCount,
+                ]
+            );
+        }
+
+        if ($errorRate >= $this->errorRateThreshold * 0.5) {
+            return HealthCheckResult::warning(
+                "Exception error rate elevated: " . number_format($errorRate * 100, 2) . "%",
+                [
+                    'error_rate' => $errorRate,
+                    'threshold' => $this->errorRateThreshold,
+                    'total_exceptions' => $metrics->totalCount,
+                ]
+            );
+        }
+
+        return HealthCheckResult::healthy(
+            "Exception error rate normal: " . number_format($errorRate * 100, 2) . "%",
+            [
+                'error_rate' => $errorRate,
+                'total_exceptions' => $metrics->totalCount,
+            ]
+        );
+    }
+
+    /**
+     * Calculate error rate
+     *
+     * Simplified implementation - in production, would calculate based on request count.
+     */
+    private function calculateErrorRate(ExceptionMetrics $metrics): float
+    {
+        // Simplified: use total count as proxy for error rate
+        // In production, would compare against total request count
+        if ($metrics->totalCount === 0) {
+            return 0.0;
+        }
+
+        // Normalize to 0-1 range (simplified)
+        return min(1.0, $metrics->totalCount / 1000.0);
+    }
+
+    /**
+     * Get health check category
+     */
+    public function getCategory(): \App\Framework\Health\HealthCheckCategory
+    {
+        return \App\Framework\Health\HealthCheckCategory::APPLICATION;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Localization/ExceptionLocalizer.php b/src/Framework/ExceptionHandling/Localization/ExceptionLocalizer.php
new file mode 100644
index 00000000..d8a4b25d
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Localization/ExceptionLocalizer.php
@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Localization;
+
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+
+/**
+ * Exception Localizer
+ *
+ * Provides localization support for exception messages.
+ */
+final readonly class ExceptionLocalizer
+{
+    /**
+     * @param array<string, array<string, string|array{message: string, title?: string, help?: string}>> $translations Translations by locale
+     * @param string $defaultLocale Default locale (e.g., 'en')
+     */
+    public function __construct(
+        private array $translations = [],
+        private string $defaultLocale = 'en'
+    ) {
+    }
+
+    /**
+     * Get locale from context
+     *
+     * Extracts locale from request headers, session, or user preferences.
+     */
+    public function getLocale(?ExceptionContextData $context = null): string
+    {
+        // Try to get from context metadata
+        if ($context !== null && isset($context->metadata['locale'])) {
+            $locale = $context->metadata['locale'];
+            if (is_string($locale) && $this->hasTranslations($locale)) {
+                return $locale;
+            }
+        }
+
+        // Fallback to default locale
+        return $this->defaultLocale;
+    }
+
+    /**
+     * Get translations for locale
+     *
+     * @param string $locale Locale code (e.g., 'en', 'de')
+     * @return array<string, string|array{message: string, title?: string, help?: string}> Translations
+     */
+    public function getTranslations(string $locale): array
+    {
+        return $this->translations[$locale] ?? $this->translations[$this->defaultLocale] ?? [];
+    }
+
+    /**
+     * Check if translations exist for locale
+     */
+    public function hasTranslations(string $locale): bool
+    {
+        return isset($this->translations[$locale]);
+    }
+
+    /**
+     * Get fallback chain for locale
+     *
+     * Returns array of locales to try in order: [user_locale, default_locale, 'en']
+     */
+    public function getFallbackChain(string $locale): array
+    {
+        $chain = [$locale];
+
+        if ($locale !== $this->defaultLocale) {
+            $chain[] = $this->defaultLocale;
+        }
+
+        if ($this->defaultLocale !== 'en') {
+            $chain[] = 'en';
+        }
+
+        return array_unique($chain);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Metrics/ExceptionMetrics.php b/src/Framework/ExceptionHandling/Metrics/ExceptionMetrics.php
new file mode 100644
index 00000000..d3e19de0
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Metrics/ExceptionMetrics.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Metrics;
+
+/**
+ * Exception Metrics
+ *
+ * Immutable value object for exception metrics.
+ */
+final readonly class ExceptionMetrics
+{
+    /**
+     * @param int $totalCount Total exception count
+     * @param array<string, int> $byClass Count by exception class
+     * @param array<string, int> $byComponent Count by component
+     * @param float $averageExecutionTimeMs Average execution time in milliseconds
+     */
+    public function __construct(
+        public int $totalCount = 0,
+        public array $byClass = [],
+        public array $byComponent = [],
+        public float $averageExecutionTimeMs = 0.0
+    ) {
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'total_count' => $this->totalCount,
+            'by_class' => $this->byClass,
+            'by_component' => $this->byComponent,
+            'average_execution_time_ms' => $this->averageExecutionTimeMs,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Metrics/ExceptionMetricsCollector.php b/src/Framework/ExceptionHandling/Metrics/ExceptionMetricsCollector.php
new file mode 100644
index 00000000..e8659e53
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Metrics/ExceptionMetricsCollector.php
@@ -0,0 +1,178 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Metrics;
+
+use App\Framework\Cache\Cache;
+use App\Framework\Cache\CacheItem;
+use App\Framework\Cache\CacheKey;
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Metrics Collector
+ *
+ * Collects metrics for exceptions (rate, top exceptions, error rate by component).
+ */
+final readonly class ExceptionMetricsCollector
+{
+    private const string CACHE_PREFIX = 'exception_metrics:';
+    private const int METRICS_TTL = 3600; // 1 hour
+
+    public function __construct(
+        private Cache $cache
+    ) {
+    }
+
+    /**
+     * Record exception metric
+     *
+     * @param Throwable $exception Exception to record
+     * @param ExceptionContextData|null $context Optional context
+     * @param float|null $executionTimeMs Optional execution time in milliseconds
+     */
+    public function record(
+        Throwable $exception,
+        ?ExceptionContextData $context = null,
+        ?float $executionTimeMs = null
+    ): void {
+        $exceptionClass = get_class($exception);
+        $component = $context?->component ?? 'unknown';
+
+        // Increment total count
+        $this->incrementMetric('total');
+
+        // Increment by class
+        $this->incrementMetric('class:' . $exceptionClass);
+
+        // Increment by component
+        $this->incrementMetric('component:' . $component);
+
+        // Record execution time if available
+        if ($executionTimeMs !== null) {
+            $this->recordExecutionTime($executionTimeMs);
+        }
+    }
+
+    /**
+     * Get current metrics
+     *
+     * @return ExceptionMetrics Current metrics
+     */
+    public function getMetrics(): ExceptionMetrics
+    {
+        $totalCount = $this->getMetric('total');
+        $byClass = $this->getMetricsByPrefix('class:');
+        $byComponent = $this->getMetricsByPrefix('component:');
+        $avgExecutionTime = $this->getAverageExecutionTime();
+
+        return new ExceptionMetrics(
+            totalCount: $totalCount,
+            byClass: $byClass,
+            byComponent: $byComponent,
+            averageExecutionTimeMs: $avgExecutionTime
+        );
+    }
+
+    /**
+     * Increment metric
+     */
+    private function incrementMetric(string $metricName): void
+    {
+        $cacheKey = CacheKey::fromString(self::CACHE_PREFIX . $metricName);
+        $current = $this->getMetricValue($cacheKey);
+        $newValue = $current + 1;
+
+        $cacheItem = CacheItem::fromKey(
+            $cacheKey,
+            $newValue,
+            Duration::fromSeconds(self::METRICS_TTL)
+        );
+
+        $this->cache->set($cacheItem);
+    }
+
+    /**
+     * Get metric value
+     */
+    private function getMetric(string $metricName): int
+    {
+        $cacheKey = CacheKey::fromString(self::CACHE_PREFIX . $metricName);
+        return $this->getMetricValue($cacheKey);
+    }
+
+    /**
+     * Get metric value from cache
+     */
+    private function getMetricValue(CacheKey $cacheKey): int
+    {
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        if ($item === null) {
+            return 0;
+        }
+
+        $value = $item->value;
+        return is_int($value) ? $value : 0;
+    }
+
+    /**
+     * Get metrics by prefix
+     */
+    private function getMetricsByPrefix(string $prefix): array
+    {
+        // Simplified implementation - in production, would use cache prefix scanning
+        return [];
+    }
+
+    /**
+     * Record execution time
+     */
+    private function recordExecutionTime(float $executionTimeMs): void
+    {
+        $cacheKey = CacheKey::fromString(self::CACHE_PREFIX . 'execution_times');
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        $times = $item !== null && is_array($item->value) ? $item->value : [];
+        $times[] = $executionTimeMs;
+
+        // Keep only last 1000 execution times
+        if (count($times) > 1000) {
+            $times = array_slice($times, -1000);
+        }
+
+        $cacheItem = CacheItem::fromKey(
+            $cacheKey,
+            $times,
+            Duration::fromSeconds(self::METRICS_TTL)
+        );
+
+        $this->cache->set($cacheItem);
+    }
+
+    /**
+     * Get average execution time
+     */
+    private function getAverageExecutionTime(): float
+    {
+        $cacheKey = CacheKey::fromString(self::CACHE_PREFIX . 'execution_times');
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        if ($item === null || !is_array($item->value)) {
+            return 0.0;
+        }
+
+        $times = $item->value;
+        if (empty($times)) {
+            return 0.0;
+        }
+
+        return array_sum($times) / count($times);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Metrics/PrometheusExporter.php b/src/Framework/ExceptionHandling/Metrics/PrometheusExporter.php
new file mode 100644
index 00000000..5e6032de
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Metrics/PrometheusExporter.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Metrics;
+
+/**
+ * Prometheus Exporter
+ *
+ * Exports exception metrics in Prometheus format.
+ */
+final readonly class PrometheusExporter
+{
+    /**
+     * Export metrics in Prometheus format
+     *
+     * @param ExceptionMetrics $metrics Metrics to export
+     * @return string Prometheus-formatted metrics
+     */
+    public function export(ExceptionMetrics $metrics): string
+    {
+        $lines = [];
+
+        // Total exception count
+        $lines[] = sprintf(
+            'exception_total %d',
+            $metrics->totalCount
+        );
+
+        // Exceptions by class
+        foreach ($metrics->byClass as $class => $count) {
+            $sanitizedClass = $this->sanitizeMetricName($class);
+            $lines[] = sprintf(
+                'exception_by_class{exception_class="%s"} %d',
+                $sanitizedClass,
+                $count
+            );
+        }
+
+        // Exceptions by component
+        foreach ($metrics->byComponent as $component => $count) {
+            $sanitizedComponent = $this->sanitizeMetricName($component);
+            $lines[] = sprintf(
+                'exception_by_component{component="%s"} %d',
+                $sanitizedComponent,
+                $count
+            );
+        }
+
+        // Average execution time
+        $lines[] = sprintf(
+            'exception_average_execution_time_ms %.2f',
+            $metrics->averageExecutionTimeMs
+        );
+
+        return implode("\n", $lines);
+    }
+
+    /**
+     * Sanitize metric name for Prometheus
+     */
+    private function sanitizeMetricName(string $name): string
+    {
+        // Replace invalid characters
+        $sanitized = preg_replace('/[^a-zA-Z0-9_:]/', '_', $name);
+        return $sanitized;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Middleware/ErrorScopeMiddleware.php b/src/Framework/ExceptionHandling/Middleware/ErrorScopeMiddleware.php
new file mode 100644
index 00000000..776fdb13
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Middleware/ErrorScopeMiddleware.php
@@ -0,0 +1,183 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Middleware;
+
+use App\Framework\ExceptionHandling\Scope\ErrorScope;
+use App\Framework\ExceptionHandling\Scope\ErrorScopeContext;
+use App\Framework\Http\HttpMiddleware;
+use App\Framework\Http\MiddlewareContext;
+use App\Framework\Http\MiddlewarePriority;
+use App\Framework\Http\MiddlewarePriorityAttribute;
+use App\Framework\Http\Next;
+use App\Framework\Http\RequestStateManager;
+
+/**
+ * Error Scope Middleware
+ *
+ * Automatically creates ErrorScope for HTTP requests to enable automatic
+ * context enrichment for all exceptions thrown during request processing.
+ *
+ * Uses Value Objects (IpAddress, UserAgent, SessionId) where possible.
+ * Scope is automatically cleaned up after request processing.
+ */
+#[MiddlewarePriorityAttribute(MiddlewarePriority::VERY_EARLY)]
+final readonly class ErrorScopeMiddleware implements HttpMiddleware
+{
+    public function __construct(
+        private ErrorScope $errorScope
+    ) {
+    }
+
+    public function __invoke(MiddlewareContext $context, Next $next, RequestStateManager $stateManager): MiddlewareContext
+    {
+        // Create HTTP scope from request
+        $scopeContext = $this->createHttpScope($context->request);
+
+        // Enter scope (returns token for cleanup)
+        $token = $this->errorScope->enter($scopeContext);
+
+        try {
+            // Process request through middleware chain
+            $result = $next($context);
+
+            // Update scope with any additional context that became available
+            // (e.g., user ID after authentication, route after routing)
+            $this->updateScopeFromContext($scopeContext, $context, $stateManager);
+
+            return $result;
+        } finally {
+            // Always exit scope, even if exception occurred
+            $this->errorScope->exit($token);
+        }
+    }
+
+    /**
+     * Create HTTP scope context from request
+     *
+     * Uses Value Objects where possible for type safety and validation.
+     */
+    private function createHttpScope(\App\Framework\Http\Request $request): ErrorScopeContext
+    {
+        // Extract request ID (as string, since RequestId Value Object needs secret)
+        $requestIdString = $request->id->toString();
+
+        // Extract IP address (as string, will be converted to Value Object in enrichContext)
+        $ipAddressString = $request->server->getRemoteAddr()?->value ?? null;
+
+        // Extract user agent (as string, will be converted to Value Object in enrichContext)
+        $userAgentString = $request->server->getUserAgent()?->value ?? null;
+
+        // Extract session ID (will be available after SessionMiddleware)
+        $sessionId = null;
+        if (property_exists($request, 'session') && $request->session !== null) {
+            $sessionId = $request->session->id->toString();
+        }
+
+        // Create scope context with metadata for later Value Object conversion
+        return ErrorScopeContext::http(
+            request: $request,
+            operation: null, // Will be set by routing/controller
+            component: null // Will be set by routing/controller
+        )->addMetadata([
+            'ip' => $ipAddressString,
+            'user_agent' => $userAgentString,
+            'request_id' => $requestIdString,
+            'session_id' => $sessionId,
+        ]);
+    }
+
+    /**
+     * Update scope with additional context that became available during request processing
+     *
+     * E.g., user ID after authentication, route after routing
+     */
+    private function updateScopeFromContext(
+        ErrorScopeContext $scopeContext,
+        MiddlewareContext $context,
+        RequestStateManager $stateManager
+    ): void {
+        // Get current scope (should be the one we just created)
+        $currentScope = $this->errorScope->current();
+        if ($currentScope === null || $currentScope->scopeId !== $scopeContext->scopeId) {
+            return; // Scope changed or not found
+        }
+
+        // Check if user ID became available (after authentication)
+        $userId = $this->extractUserId($context, $stateManager);
+        if ($userId !== null && $currentScope->userId === null) {
+            // Create updated scope with user ID
+            $updatedScope = $currentScope->withUserId($userId);
+            // Replace current scope (exit and re-enter)
+            $this->errorScope->exit();
+            $this->errorScope->enter($updatedScope);
+        }
+
+        // Check if route information became available (after routing)
+        $route = $this->extractRouteInfo($context);
+        if ($route !== null && $currentScope->operation === null) {
+            $operation = "http.{$route['method']}.{$route['path']}";
+            $updatedScope = $currentScope->withOperation($operation, $route['controller'] ?? null);
+            $this->errorScope->exit();
+            $this->errorScope->enter($updatedScope);
+        }
+    }
+
+    /**
+     * Extract user ID from context or state manager
+     */
+    private function extractUserId(MiddlewareContext $context, RequestStateManager $stateManager): ?string
+    {
+        // Try to get from request attribute (set by auth middleware)
+        if (method_exists($context->request, 'getAttribute')) {
+            $user = $context->request->getAttribute('user');
+            if ($user !== null && (is_object($user) && property_exists($user, 'id'))) {
+                return (string) $user->id;
+            }
+            if (is_string($user)) {
+                return $user;
+            }
+        }
+
+        // Try to get from state manager
+        try {
+            $user = $stateManager->get('user');
+            if ($user !== null && (is_object($user) && property_exists($user, 'id'))) {
+                return (string) $user->id;
+            }
+        } catch (\Throwable) {
+            // Ignore - user not available
+        }
+
+        return null;
+    }
+
+    /**
+     * Extract route information from context
+     */
+    private function extractRouteInfo(MiddlewareContext $context): ?array
+    {
+        $request = $context->request;
+
+        // Try to get route from request attribute
+        if (method_exists($request, 'getAttribute')) {
+            $route = $request->getAttribute('route');
+            if ($route !== null) {
+                return [
+                    'method' => $request->method->value,
+                    'path' => $request->path,
+                    'controller' => is_object($route) ? get_class($route) : null,
+                ];
+            }
+        }
+
+        // Fallback: use request method and path
+        return [
+            'method' => $request->method->value,
+            'path' => $request->path,
+            'controller' => null,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/PatternDetection/ExceptionPattern.php b/src/Framework/ExceptionHandling/PatternDetection/ExceptionPattern.php
new file mode 100644
index 00000000..7b1a88a5
--- /dev/null
+++ b/src/Framework/ExceptionHandling/PatternDetection/ExceptionPattern.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\PatternDetection;
+
+/**
+ * Exception Pattern
+ *
+ * Immutable value object representing a detected exception pattern.
+ */
+final readonly class ExceptionPattern
+{
+    /**
+     * @param string $fingerprint Pattern fingerprint
+     * @param string $description Pattern description
+     * @param array<FixSuggestion> $fixSuggestions Suggested fixes
+     * @param int $occurrenceCount Number of times this pattern occurred
+     */
+    public function __construct(
+        public string $fingerprint,
+        public string $description,
+        public array $fixSuggestions = [],
+        public int $occurrenceCount = 1
+    ) {
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'fingerprint' => $this->fingerprint,
+            'description' => $this->description,
+            'fix_suggestions' => array_map(
+                fn(FixSuggestion $suggestion) => $suggestion->toArray(),
+                $this->fixSuggestions
+            ),
+            'occurrence_count' => $this->occurrenceCount,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/PatternDetection/ExceptionPatternDetector.php b/src/Framework/ExceptionHandling/PatternDetection/ExceptionPatternDetector.php
new file mode 100644
index 00000000..1fe74d35
--- /dev/null
+++ b/src/Framework/ExceptionHandling/PatternDetection/ExceptionPatternDetector.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\PatternDetection;
+
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use App\Framework\ExceptionHandling\RateLimit\ExceptionFingerprint;
+use Throwable;
+
+/**
+ * Exception Pattern Detector
+ *
+ * Detects patterns in exceptions and provides fix suggestions.
+ */
+final readonly class ExceptionPatternDetector
+{
+    /**
+     * @param array<string, array{description: string, fixes: array<array{title: string, description: string, code?: string, confidence?: string}>}> $knowledgeBase Knowledge base of patterns and fixes
+     */
+    public function __construct(
+        private array $knowledgeBase = []
+    ) {
+    }
+
+    /**
+     * Detect patterns for exception
+     *
+     * @param Throwable $exception Exception to analyze
+     * @param ExceptionContextData|null $context Optional context
+     * @return array<ExceptionPattern> Detected patterns
+     */
+    public function detect(Throwable $exception, ?ExceptionContextData $context = null): array
+    {
+        $fingerprint = $context !== null
+            ? ExceptionFingerprint::fromExceptionWithContext(
+                $exception,
+                $context->component,
+                $context->operation
+            )
+            : ExceptionFingerprint::fromException($exception);
+
+        $patterns = [];
+
+        // Check knowledge base for matching patterns
+        $exceptionClass = get_class($exception);
+        if (isset($this->knowledgeBase[$exceptionClass])) {
+            $patternData = $this->knowledgeBase[$exceptionClass];
+            $fixSuggestions = array_map(
+                fn(array $fix) => new FixSuggestion(
+                    title: $fix['title'] ?? '',
+                    description: $fix['description'] ?? '',
+                    codeExample: $fix['code'] ?? null,
+                    confidence: $fix['confidence'] ?? 'medium'
+                ),
+                $patternData['fixes'] ?? []
+            );
+
+            $patterns[] = new ExceptionPattern(
+                fingerprint: $fingerprint->getHash(),
+                description: $patternData['description'] ?? 'Pattern detected',
+                fixSuggestions: $fixSuggestions
+            );
+        }
+
+        return $patterns;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/PatternDetection/FixSuggestion.php b/src/Framework/ExceptionHandling/PatternDetection/FixSuggestion.php
new file mode 100644
index 00000000..6f03983f
--- /dev/null
+++ b/src/Framework/ExceptionHandling/PatternDetection/FixSuggestion.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\PatternDetection;
+
+/**
+ * Fix Suggestion
+ *
+ * Immutable value object for exception fix suggestions.
+ */
+final readonly class FixSuggestion
+{
+    /**
+     * @param string $title Suggestion title
+     * @param string $description Detailed description
+     * @param string|null $codeExample Optional code example
+     * @param string $confidence Confidence level (low, medium, high)
+     */
+    public function __construct(
+        public string $title,
+        public string $description,
+        public ?string $codeExample = null,
+        public string $confidence = 'medium'
+    ) {
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'title' => $this->title,
+            'description' => $this->description,
+            'code_example' => $this->codeExample,
+            'confidence' => $this->confidence,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceMetrics.php b/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceMetrics.php
new file mode 100644
index 00000000..272daeba
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceMetrics.php
@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Performance;
+
+/**
+ * Exception Performance Metrics
+ *
+ * Immutable value object containing performance metrics for exceptions.
+ */
+final readonly class ExceptionPerformanceMetrics
+{
+    /**
+     * @param float $executionTimeMs Execution time in milliseconds
+     * @param int $memoryDeltaBytes Memory delta in bytes (positive = memory increase)
+     * @param float|null $cpuUsagePercent CPU usage percentage (if available)
+     * @param string $exceptionClass Exception class name
+     * @param string|null $component Component where exception occurred
+     */
+    public function __construct(
+        public float $executionTimeMs,
+        public int $memoryDeltaBytes,
+        public ?float $cpuUsagePercent = null,
+        public string $exceptionClass = '',
+        public ?string $component = null
+    ) {
+    }
+
+    /**
+     * Create empty metrics
+     */
+    public static function empty(): self
+    {
+        return new self(0.0, 0);
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'execution_time_ms' => $this->executionTimeMs,
+            'memory_delta_bytes' => $this->memoryDeltaBytes,
+            'cpu_usage_percent' => $this->cpuUsagePercent,
+            'exception_class' => $this->exceptionClass,
+            'component' => $this->component,
+        ];
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceTracker.php b/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceTracker.php
new file mode 100644
index 00000000..a2435bdd
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Performance/ExceptionPerformanceTracker.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Performance;
+
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Performance Tracker
+ *
+ * Tracks performance metrics for exceptions (execution time, memory, CPU).
+ */
+final readonly class ExceptionPerformanceTracker
+{
+    /**
+     * Track exception performance
+     *
+     * @param Throwable $exception Exception to track
+     * @param ExceptionContextData|null $context Optional context
+     * @param float $executionTimeMs Execution time in milliseconds
+     * @param int $memoryDeltaBytes Memory delta in bytes
+     * @param float|null $cpuUsagePercent CPU usage percentage (if available)
+     * @return ExceptionPerformanceMetrics Performance metrics
+     */
+    public function track(
+        Throwable $exception,
+        ?ExceptionContextData $context = null,
+        float $executionTimeMs = 0.0,
+        int $memoryDeltaBytes = 0,
+        ?float $cpuUsagePercent = null
+    ): ExceptionPerformanceMetrics {
+        $metrics = new ExceptionPerformanceMetrics(
+            executionTimeMs: $executionTimeMs,
+            memoryDeltaBytes: $memoryDeltaBytes,
+            cpuUsagePercent: $cpuUsagePercent,
+            exceptionClass: get_class($exception),
+            component: $context?->component
+        );
+
+        // Store metrics in context metadata if available
+        if ($context !== null) {
+            $context->addMetadata([
+                'performance' => $metrics->toArray(),
+            ]);
+        }
+
+        return $metrics;
+    }
+
+    /**
+     * Start performance tracking
+     *
+     * Returns tracking data that should be passed to end().
+     *
+     * @return array{start_time: float, start_memory: int, start_cpu: float|null}
+     */
+    public function start(): array
+    {
+        return [
+            'start_time' => microtime(true),
+            'start_memory' => memory_get_usage(true),
+            'start_cpu' => $this->getCpuUsage(),
+        ];
+    }
+
+    /**
+     * End performance tracking
+     *
+     * @param array{start_time: float, start_memory: int, start_cpu: float|null} $startData Data from start()
+     * @return ExceptionPerformanceMetrics Calculated metrics
+     */
+    public function end(
+        array $startData,
+        Throwable $exception,
+        ?ExceptionContextData $context = null
+    ): ExceptionPerformanceMetrics {
+        $endTime = microtime(true);
+        $endMemory = memory_get_usage(true);
+        $endCpu = $this->getCpuUsage();
+
+        $executionTimeMs = ($endTime - $startData['start_time']) * 1000;
+        $memoryDeltaBytes = $endMemory - $startData['start_memory'];
+        $cpuUsagePercent = null;
+        if ($startData['start_cpu'] !== null && $endCpu !== null) {
+            $cpuUsagePercent = $endCpu - $startData['start_cpu'];
+        }
+
+        return $this->track($exception, $context, $executionTimeMs, $memoryDeltaBytes, $cpuUsagePercent);
+    }
+
+    /**
+     * Get current CPU usage
+     *
+     * Returns null if CPU usage cannot be determined.
+     */
+    private function getCpuUsage(): ?float
+    {
+        // Try to get CPU usage from system
+        if (function_exists('sys_getloadavg')) {
+            $load = sys_getloadavg();
+            if ($load !== false && isset($load[0])) {
+                return $load[0];
+            }
+        }
+
+        return null;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/RateLimit/ExceptionFingerprint.php b/src/Framework/ExceptionHandling/RateLimit/ExceptionFingerprint.php
new file mode 100644
index 00000000..94006de5
--- /dev/null
+++ b/src/Framework/ExceptionHandling/RateLimit/ExceptionFingerprint.php
@@ -0,0 +1,146 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\RateLimit;
+
+use Throwable;
+
+/**
+ * Exception Fingerprint
+ *
+ * Generates unique fingerprints for exceptions to enable rate limiting
+ * by grouping similar exceptions together.
+ *
+ * Immutable value object.
+ */
+final readonly class ExceptionFingerprint
+{
+    private function __construct(
+        private string $hash,
+        private string $normalizedMessage
+    ) {
+    }
+
+    /**
+     * Create fingerprint from exception
+     */
+    public static function fromException(Throwable $exception): self
+    {
+        $normalizedMessage = self::normalizeMessage($exception->getMessage());
+
+        $components = [
+            get_class($exception),
+            $normalizedMessage,
+            $exception->getFile(),
+            (string) $exception->getLine(),
+        ];
+
+        $hash = hash('sha256', implode('|', $components));
+
+        return new self($hash, $normalizedMessage);
+    }
+
+    /**
+     * Create fingerprint from exception with context
+     *
+     * Includes component and operation from context for more precise grouping.
+     */
+    public static function fromExceptionWithContext(
+        Throwable $exception,
+        ?string $component = null,
+        ?string $operation = null
+    ): self {
+        $normalizedMessage = self::normalizeMessage($exception->getMessage());
+
+        $components = [
+            get_class($exception),
+            $normalizedMessage,
+            $exception->getFile(),
+            (string) $exception->getLine(),
+        ];
+
+        // Add context if available for more precise grouping
+        if ($component !== null) {
+            $components[] = $component;
+        }
+        if ($operation !== null) {
+            $components[] = $operation;
+        }
+
+        $hash = hash('sha256', implode('|', $components));
+
+        return new self($hash, $normalizedMessage);
+    }
+
+    /**
+     * Normalize exception message for fingerprinting
+     *
+     * Removes variable parts like:
+     * - UUIDs
+     * - Timestamps
+     * - IDs
+     * - Numbers (but keeps words containing numbers)
+     */
+    private static function normalizeMessage(string $message): string
+    {
+        $normalized = $message;
+
+        // UUIDs entfernen
+        $normalized = preg_replace(
+            '/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i',
+            '{UUID}',
+            $normalized
+        );
+
+        // Timestamps entfernen (ISO 8601)
+        $normalized = preg_replace(
+            '/\d{4}-\d{2}-\d{2}[T\s]\d{2}:\d{2}:\d{2}/',
+            '{TIMESTAMP}',
+            $normalized
+        );
+
+        // File paths mit Zeilennummern
+        $normalized = preg_replace(
+            '/\/[\w\/\-\.]+\.php:\d+/',
+            '{FILE}',
+            $normalized
+        );
+
+        // Zahlen (aber behalte Wörter die Zahlen enthalten)
+        $normalized = preg_replace('/\b\d+\b/', '{NUMBER}', $normalized);
+
+        // Email-Adressen
+        $normalized = preg_replace('/\b[\w\.-]+@[\w\.-]+\.\w+\b/', '{EMAIL}', $normalized);
+
+        // URLs
+        $normalized = preg_replace('/https?:\/\/[^\s]+/', '{URL}', $normalized);
+
+        return $normalized;
+    }
+
+    /**
+     * Get fingerprint hash
+     */
+    public function getHash(): string
+    {
+        return $this->hash;
+    }
+
+    /**
+     * Get normalized message
+     */
+    public function getNormalizedMessage(): string
+    {
+        return $this->normalizedMessage;
+    }
+
+    /**
+     * String representation
+     */
+    public function __toString(): string
+    {
+        return $this->hash;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimitConfig.php b/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimitConfig.php
new file mode 100644
index 00000000..8952d606
--- /dev/null
+++ b/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimitConfig.php
@@ -0,0 +1,109 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\RateLimit;
+
+use App\Framework\Core\ValueObjects\Duration;
+
+/**
+ * Exception Rate Limit Configuration
+ *
+ * Immutable configuration for exception rate limiting.
+ */
+final readonly class ExceptionRateLimitConfig
+{
+    /**
+     * @param int $maxExceptions Maximum number of exceptions allowed per time window
+     * @param Duration $timeWindow Time window for rate limiting
+     * @param bool $enabled Whether rate limiting is enabled
+     * @param bool $skipLoggingOnLimit Whether to skip logging when rate limit is reached
+     * @param bool $skipAuditOnLimit Whether to skip audit logging when rate limit is reached
+     * @param bool $trackMetricsOnLimit Whether to track metrics even when rate limit is reached
+     */
+    public function __construct(
+        public int $maxExceptions = 10,
+        public Duration $timeWindow = new Duration(60), // 1 minute default
+        public bool $enabled = true,
+        public bool $skipLoggingOnLimit = true,
+        public bool $skipAuditOnLimit = true,
+        public bool $trackMetricsOnLimit = true
+    ) {
+        if ($this->maxExceptions < 1) {
+            throw new \InvalidArgumentException('maxExceptions must be at least 1');
+        }
+    }
+
+    /**
+     * Create default configuration
+     */
+    public static function default(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Create configuration with custom limits
+     */
+    public static function withLimits(int $maxExceptions, Duration $timeWindow): self
+    {
+        return new self(
+            maxExceptions: $maxExceptions,
+            timeWindow: $timeWindow
+        );
+    }
+
+    /**
+     * Create disabled configuration
+     */
+    public static function disabled(): self
+    {
+        return new self(enabled: false);
+    }
+
+    /**
+     * Create new instance with different max exceptions
+     */
+    public function withMaxExceptions(int $maxExceptions): self
+    {
+        return new self(
+            maxExceptions: $maxExceptions,
+            timeWindow: $this->timeWindow,
+            enabled: $this->enabled,
+            skipLoggingOnLimit: $this->skipLoggingOnLimit,
+            skipAuditOnLimit: $this->skipAuditOnLimit,
+            trackMetricsOnLimit: $this->trackMetricsOnLimit
+        );
+    }
+
+    /**
+     * Create new instance with different time window
+     */
+    public function withTimeWindow(Duration $timeWindow): self
+    {
+        return new self(
+            maxExceptions: $this->maxExceptions,
+            timeWindow: $timeWindow,
+            enabled: $this->enabled,
+            skipLoggingOnLimit: $this->skipLoggingOnLimit,
+            skipAuditOnLimit: $this->skipAuditOnLimit,
+            trackMetricsOnLimit: $this->trackMetricsOnLimit
+        );
+    }
+
+    /**
+     * Create new instance with enabled/disabled state
+     */
+    public function withEnabled(bool $enabled): self
+    {
+        return new self(
+            maxExceptions: $this->maxExceptions,
+            timeWindow: $this->timeWindow,
+            enabled: $enabled,
+            skipLoggingOnLimit: $this->skipLoggingOnLimit,
+            skipAuditOnLimit: $this->skipAuditOnLimit,
+            trackMetricsOnLimit: $this->trackMetricsOnLimit
+        );
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimiter.php b/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimiter.php
new file mode 100644
index 00000000..97b2183f
--- /dev/null
+++ b/src/Framework/ExceptionHandling/RateLimit/ExceptionRateLimiter.php
@@ -0,0 +1,182 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\RateLimit;
+
+use App\Framework\Cache\Cache;
+use App\Framework\Cache\CacheItem;
+use App\Framework\Cache\CacheKey;
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Rate Limiter
+ *
+ * Prevents log spam by rate limiting repeated identical exceptions.
+ * Uses cache-based tracking with configurable thresholds.
+ */
+final readonly class ExceptionRateLimiter
+{
+    private const string CACHE_PREFIX = 'exception_rate_limit:';
+
+    public function __construct(
+        private Cache $cache,
+        private ExceptionRateLimitConfig $config
+    ) {
+    }
+
+    /**
+     * Check if exception should be rate limited
+     *
+     * Returns true if exception should be processed (not rate limited),
+     * false if it should be skipped due to rate limiting.
+     *
+     * @param Throwable $exception Exception to check
+     * @param ExceptionContextData|null $context Optional context for fingerprinting
+     * @return bool True if exception should be processed, false if rate limited
+     */
+    public function shouldProcess(Throwable $exception, ?ExceptionContextData $context = null): bool
+    {
+        if (!$this->config->enabled) {
+            return true; // Rate limiting disabled, always process
+        }
+
+        $fingerprint = $context !== null
+            ? ExceptionFingerprint::fromExceptionWithContext(
+                $exception,
+                $context->component,
+                $context->operation
+            )
+            : ExceptionFingerprint::fromException($exception);
+
+        $cacheKey = $this->buildCacheKey($fingerprint);
+        $currentCount = $this->getCachedCount($cacheKey);
+
+        if ($currentCount >= $this->config->maxExceptions) {
+            // Rate limit reached
+            return false;
+        }
+
+        // Increment count
+        $this->incrementCount($cacheKey);
+
+        return true;
+    }
+
+    /**
+     * Check if logging should be skipped due to rate limiting
+     */
+    public function shouldSkipLogging(Throwable $exception, ?ExceptionContextData $context = null): bool
+    {
+        if (!$this->config->enabled || !$this->config->skipLoggingOnLimit) {
+            return false;
+        }
+
+        return !$this->shouldProcess($exception, $context);
+    }
+
+    /**
+     * Check if audit logging should be skipped due to rate limiting
+     */
+    public function shouldSkipAudit(Throwable $exception, ?ExceptionContextData $context = null): bool
+    {
+        if (!$this->config->enabled || !$this->config->skipAuditOnLimit) {
+            return false;
+        }
+
+        return !$this->shouldProcess($exception, $context);
+    }
+
+    /**
+     * Check if metrics should be tracked even when rate limited
+     */
+    public function shouldTrackMetrics(Throwable $exception, ?ExceptionContextData $context = null): bool
+    {
+        if (!$this->config->enabled || !$this->config->trackMetricsOnLimit) {
+            return true; // Always track if not enabled or tracking not disabled
+        }
+
+        // Track metrics even if rate limited
+        return true;
+    }
+
+    /**
+     * Get current count for exception fingerprint
+     */
+    public function getCurrentCount(Throwable $exception, ?ExceptionContextData $context = null): int
+    {
+        $fingerprint = $context !== null
+            ? ExceptionFingerprint::fromExceptionWithContext(
+                $exception,
+                $context->component,
+                $context->operation
+            )
+            : ExceptionFingerprint::fromException($exception);
+
+        $cacheKey = $this->buildCacheKey($fingerprint);
+        return $this->getCachedCount($cacheKey);
+    }
+
+    /**
+     * Build cache key from fingerprint
+     */
+    private function buildCacheKey(ExceptionFingerprint $fingerprint): CacheKey
+    {
+        return CacheKey::fromString(self::CACHE_PREFIX . $fingerprint->getHash());
+    }
+
+    /**
+     * Get current count from cache key
+     */
+    private function getCachedCount(CacheKey $cacheKey): int
+    {
+        $result = $this->cache->get($cacheKey);
+        $item = $result->getFirstHit();
+
+        if ($item === null) {
+            return 0;
+        }
+
+        $value = $item->value;
+        return is_int($value) ? $value : 0;
+    }
+
+    /**
+     * Increment count in cache
+     */
+    private function incrementCount(CacheKey $cacheKey): void
+    {
+        $currentCount = $this->getCachedCount($cacheKey);
+        $newCount = $currentCount + 1;
+
+        $cacheItem = CacheItem::fromKey(
+            $cacheKey,
+            $newCount,
+            $this->config->timeWindow
+        );
+
+        $this->cache->set($cacheItem);
+    }
+
+    /**
+     * Reset rate limit for exception fingerprint
+     *
+     * Useful for testing or manual reset.
+     */
+    public function reset(Throwable $exception, ?ExceptionContextData $context = null): void
+    {
+        $fingerprint = $context !== null
+            ? ExceptionFingerprint::fromExceptionWithContext(
+                $exception,
+                $context->component,
+                $context->operation
+            )
+            : ExceptionFingerprint::fromException($exception);
+
+        $cacheKey = $this->buildCacheKey($fingerprint);
+        $this->cache->forget($cacheKey);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Recovery/ExceptionRecoveryManager.php b/src/Framework/ExceptionHandling/Recovery/ExceptionRecoveryManager.php
new file mode 100644
index 00000000..0636cfb0
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Recovery/ExceptionRecoveryManager.php
@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Recovery;
+
+use App\Framework\Exception\ExceptionMetadata;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Recovery Manager
+ *
+ * Manages automatic retry logic for retryable exceptions.
+ */
+final readonly class ExceptionRecoveryManager
+{
+    /**
+     * Check if exception should be retried
+     *
+     * @param Throwable $exception Exception to check
+     * @param ExceptionMetadata|null $metadata Optional exception metadata
+     * @return bool True if exception should be retried
+     */
+    public function shouldRetry(Throwable $exception, ?ExceptionMetadata $metadata = null): bool
+    {
+        if ($metadata === null) {
+            return false;
+        }
+
+        // Check if retry is configured
+        if ($metadata->retryAfter === null) {
+            return false;
+        }
+
+        // Check if exception is retryable (implements marker interface or is in whitelist)
+        if (!$this->isRetryable($exception)) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Get retry delay in milliseconds
+     *
+     * @param Throwable $exception Exception to retry
+     * @param ExceptionMetadata|null $metadata Optional exception metadata
+     * @param int $attemptNumber Current attempt number (1-based)
+     * @return int Delay in milliseconds
+     */
+    public function getRetryDelay(
+        Throwable $exception,
+        ?ExceptionMetadata $metadata = null,
+        int $attemptNumber = 1
+    ): int {
+        if ($metadata === null || $metadata->retryAfter === null) {
+            return 1000; // Default 1 second
+        }
+
+        $strategy = RetryStrategy::EXPONENTIAL_BACKOFF; // Default strategy
+        $baseDelay = $metadata->retryAfter;
+
+        return $strategy->calculateDelay($attemptNumber, $baseDelay);
+    }
+
+    /**
+     * Check if exception is retryable
+     *
+     * @param Throwable $exception Exception to check
+     * @return bool True if exception is retryable
+     */
+    private function isRetryable(Throwable $exception): bool
+    {
+        // Check for marker interface
+        if ($exception instanceof RetryableException) {
+            return true;
+        }
+
+        // Check exception class name patterns
+        $className = get_class($exception);
+        $retryablePatterns = [
+            'NetworkException',
+            'TimeoutException',
+            'ConnectionException',
+            'TemporaryException',
+        ];
+
+        foreach ($retryablePatterns as $pattern) {
+            if (str_contains($className, $pattern)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
+
+/**
+ * Marker interface for retryable exceptions
+ */
+interface RetryableException
+{
+}
+
diff --git a/src/Framework/ExceptionHandling/Recovery/RetryStrategy.php b/src/Framework/ExceptionHandling/Recovery/RetryStrategy.php
new file mode 100644
index 00000000..2bf89b64
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Recovery/RetryStrategy.php
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Recovery;
+
+/**
+ * Retry Strategy
+ *
+ * Enum-like class for retry strategies.
+ */
+enum RetryStrategy: string
+{
+    case EXPONENTIAL_BACKOFF = 'exponential_backoff';
+    case LINEAR = 'linear';
+    case FIXED = 'fixed';
+
+    /**
+     * Calculate delay for retry attempt
+     *
+     * @param int $attemptNumber Attempt number (1-based)
+     * @param int $baseDelayMs Base delay in milliseconds
+     * @return int Delay in milliseconds
+     */
+    public function calculateDelay(int $attemptNumber, int $baseDelayMs = 1000): int
+    {
+        return match ($this) {
+            self::EXPONENTIAL_BACKOFF => (int) ($baseDelayMs * (2 ** ($attemptNumber - 1))),
+            self::LINEAR => $baseDelayMs * $attemptNumber,
+            self::FIXED => $baseDelayMs,
+        };
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Renderers/ConsoleErrorRenderer.php b/src/Framework/ExceptionHandling/Renderers/ConsoleErrorRenderer.php
new file mode 100644
index 00000000..d53224eb
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Renderers/ConsoleErrorRenderer.php
@@ -0,0 +1,143 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Renderers;
+
+use App\Framework\Console\ConsoleColor;
+use App\Framework\Console\ConsoleOutput;
+use App\Framework\Console\Terminal\PhpStormDetector;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\ExceptionHandling\ErrorRenderer;
+use App\Framework\ExceptionHandling\ValueObjects\StackTrace;
+
+/**
+ * CLI Error Renderer
+ *
+ * Renders exceptions to console with colored output
+ */
+final readonly class ConsoleErrorRenderer implements ErrorRenderer
+{
+    public function __construct(
+        private ConsoleOutput $output
+    ) {}
+
+    public function canRender(\Throwable $exception): bool
+    {
+        // Can render any exception in CLI context
+        return PHP_SAPI === 'cli';
+    }
+
+    /**
+     * Render exception to console (stderr)
+     *
+     * All error output is written to stderr to separate it from normal console output.
+     *
+     * @param \Throwable $exception Exception to render
+     * @param ExceptionContextProvider|null $contextProvider Optional context provider
+     * @return mixed Returns null for CLI context
+     */
+    public function render(
+        \Throwable $exception,
+        ?ExceptionContextProvider $contextProvider = null
+    ): mixed {
+        $this->output->writeErrorLine(
+            "❌ Uncaught " . get_class($exception) . ": " . $exception->getMessage(),
+            ConsoleColor::BRIGHT_RED
+        );
+
+        // Format file path with clickable link if PhpStorm is detected
+        $filePath = $exception->getFile();
+        $line = $exception->getLine();
+        $fileDisplay = $this->formatFileLink($filePath, $line);
+        $this->output->writeErrorLine(
+            "   File: " . $fileDisplay,
+            ConsoleColor::RED
+        );
+
+        if ($exception->getPrevious()) {
+            $this->output->writeErrorLine(
+                "   Caused by: " . $exception->getPrevious()->getMessage(),
+                ConsoleColor::YELLOW
+            );
+        }
+
+        $this->output->writeErrorLine("   Stack trace:", ConsoleColor::GRAY);
+        $stackTrace = StackTrace::fromThrowable($exception);
+        foreach ($stackTrace->getItems() as $index => $item) {
+            $formattedLine = $this->formatStackTraceLine($index, $item);
+            $this->output->writeErrorLine("     " . $formattedLine, ConsoleColor::GRAY);
+        }
+
+        // Context information if available
+        if ($contextProvider !== null) {
+            $context = $contextProvider->get($exception);
+            if ($context !== null && $context->operation !== null) {
+                $this->output->writeErrorLine(
+                    "   Operation: " . $context->operation,
+                    ConsoleColor::CYAN
+                );
+            }
+        }
+    }
+
+    /**
+     * Check if running in PhpStorm terminal
+     *
+     * Note: This is called multiple times but the check is very fast,
+     * so caching is not necessary for readonly classes.
+     */
+    private function isPhpStorm(): bool
+    {
+        return $this->output->getCapabilities()->isPhpStorm();
+    }
+
+    /**
+     * Format file path with clickable link for PhpStorm terminals
+     */
+    private function formatFileLink(string $filePath, int $line): string
+    {
+        if (!$this->isPhpStorm()) {
+            return $filePath . ':' . $line;
+        }
+
+        $linkFormatter = $this->output->getLinkFormatter();
+        $relativePath = PhpStormDetector::getRelativePath($filePath);
+        
+        return $linkFormatter->createFileLinkWithLine($filePath, $line, $relativePath . ':' . $line);
+    }
+
+    /**
+     * Format stack trace line with clickable file links
+     */
+    private function formatStackTraceLine(int $index, \App\Framework\ExceptionHandling\ValueObjects\StackItem $item): string
+    {
+        $baseFormat = sprintf('#%d %s', $index, $item->formatForDisplay());
+        
+        // If PhpStorm is detected, replace file:line with clickable link
+        if (!$this->isPhpStorm()) {
+            return $baseFormat;
+        }
+
+        // Build formatted line with link directly instead of using regex replacement
+        // This is more robust than regex replacement
+        $linkFormatter = $this->output->getLinkFormatter();
+        $relativePath = PhpStormDetector::getRelativePath($item->file);
+        $fileLink = $linkFormatter->createFileLinkWithLine($item->file, $item->line, $relativePath . ':' . $item->line);
+        
+        // Replace the file:line part in the formatted string
+        // Use the short file path that's actually in the formatted string
+        $shortFile = $item->getShortFile();
+        $fileLocation = $shortFile . ':' . $item->line;
+        
+        // Find and replace the file location in the base format
+        $position = strpos($baseFormat, $fileLocation);
+        if ($position !== false) {
+            return substr_replace($baseFormat, $fileLink, $position, strlen($fileLocation));
+        }
+
+        // Fallback: if exact match not found, return base format
+        return $baseFormat;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php b/src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php
index c11d8f63..da6dcf64 100644
--- a/src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php
+++ b/src/Framework/ExceptionHandling/Renderers/ResponseErrorRenderer.php
@@ -5,32 +5,52 @@ declare(strict_types=1);
 namespace App\Framework\ExceptionHandling\Renderers;
 
 use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
-use App\Framework\Http\Response;
+use App\Framework\ExceptionHandling\ErrorRenderer;
+use App\Framework\ExceptionHandling\Translation\ExceptionMessageTranslator;
+use App\Framework\ExceptionHandling\ValueObjects\StackTrace;
+use App\Framework\Http\Headers;
+use App\Framework\Http\HttpResponse;
 use App\Framework\Http\Status;
+use App\Framework\Meta\MetaData;
+use App\Framework\SyntaxHighlighter\FileHighlighter;
+use App\Framework\View\Engine;
+use App\Framework\View\ProcessingMode;
+use App\Framework\View\RenderContext;
 
 /**
- * HTTP Response factory for API and HTML error pages
+ * HTTP Response renderer for API and HTML error pages
  *
- * Extracts Response generation logic from ErrorKernel for reuse
- * in middleware recovery patterns.
+ * Uses Template System for HTML rendering and creates JSON responses for API requests.
+ * Extracts Response generation logic from ErrorKernel for reuse in middleware recovery patterns.
  */
-final readonly class ResponseErrorRenderer
+final readonly class ResponseErrorRenderer implements ErrorRenderer
 {
     public function __construct(
-        private bool $isDebugMode = false
+        private Engine $engine,
+        private bool $isDebugMode = false,
+        private ?ExceptionMessageTranslator $messageTranslator = null
     ) {}
 
     /**
-     * Create HTTP Response from exception
+     * Check if this renderer can handle the exception
+     */
+    public function canRender(\Throwable $exception): bool
+    {
+        // Can render any exception in HTTP context
+        return PHP_SAPI !== 'cli';
+    }
+
+    /**
+     * Render exception to HTTP Response
      *
      * @param \Throwable $exception Exception to render
      * @param ExceptionContextProvider|null $contextProvider Optional context provider
-     * @return Response HTTP Response object
+     * @return HttpResponse HTTP Response object
      */
-    public function createResponse(
+    public function render(
         \Throwable $exception,
         ?ExceptionContextProvider $contextProvider = null
-    ): Response {
+    ): HttpResponse {
         // Determine if API or HTML response needed
         $isApiRequest = $this->isApiRequest();
 
@@ -47,24 +67,38 @@ final readonly class ResponseErrorRenderer
     private function createApiResponse(
         \Throwable $exception,
         ?ExceptionContextProvider $contextProvider
-    ): Response {
+    ): HttpResponse {
         $statusCode = $this->getHttpStatusCode($exception);
 
+        // Get user-friendly message if translator is available
+        $context = $contextProvider?->get($exception);
+        $userMessage = $this->messageTranslator?->translate($exception, $context) 
+            ?? new \App\Framework\ExceptionHandling\Translation\UserFriendlyMessage(
+                message: $this->isDebugMode
+                    ? $exception->getMessage()
+                    : 'An error occurred while processing your request.'
+            );
+
         $errorData = [
             'error' => [
-                'message' => $this->isDebugMode
-                    ? $exception->getMessage()
-                    : 'An error occurred while processing your request.',
-                'type' => $this->isDebugMode ? get_class($exception) : 'ServerError',
+                'message' => $userMessage->message,
+                'type' => $this->isDebugMode ? $this->getShortClassName(get_class($exception)) : 'ServerError',
                 'code' => $exception->getCode(),
             ]
         ];
 
+        if ($userMessage->title !== null) {
+            $errorData['error']['title'] = $userMessage->title;
+        }
+        if ($userMessage->helpText !== null) {
+            $errorData['error']['help'] = $userMessage->helpText;
+        }
+
         // Add debug information if enabled
         if ($this->isDebugMode) {
             $errorData['error']['file'] = $exception->getFile();
             $errorData['error']['line'] = $exception->getLine();
-            $errorData['error']['trace'] = $this->formatStackTrace($exception);
+            $errorData['error']['trace'] = StackTrace::fromThrowable($exception)->toArray();
 
             // Add context from WeakMap if available
             if ($contextProvider !== null) {
@@ -82,53 +116,161 @@ final readonly class ResponseErrorRenderer
 
         $body = json_encode($errorData, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
 
-        return new Response(
+        return new HttpResponse(
             status: Status::from($statusCode),
             body: $body,
-            headers: [
+            headers: new Headers([
                 'Content-Type' => 'application/json',
                 'X-Content-Type-Options' => 'nosniff',
-            ]
+            ])
         );
     }
 
     /**
-     * Create HTML error page response
+     * Create HTML error page response using Template System
      */
     private function createHtmlResponse(
         \Throwable $exception,
         ?ExceptionContextProvider $contextProvider
-    ): Response {
+    ): HttpResponse {
         $statusCode = $this->getHttpStatusCode($exception);
 
-        $html = $this->generateErrorHtml(
-            $exception,
-            $contextProvider,
-            $statusCode
-        );
+        // Try to render using template system
+        $html = $this->renderWithTemplate($exception, $contextProvider, $statusCode);
 
-        return new Response(
+        // Fallback to simple HTML if template rendering fails
+        if ($html === null) {
+            $html = $this->generateFallbackHtml($exception, $contextProvider, $statusCode);
+        }
+
+        return new HttpResponse(
             status: Status::from($statusCode),
             body: $html,
-            headers: [
+            headers: new Headers([
                 'Content-Type' => 'text/html; charset=utf-8',
                 'X-Content-Type-Options' => 'nosniff',
-            ]
+            ])
         );
     }
 
     /**
-     * Generate HTML error page
+     * Render error page using Template System
+     *
+     * @return string|null Rendered HTML or null if template not found or rendering failed
      */
-    private function generateErrorHtml(
+    private function renderWithTemplate(
+        \Throwable $exception,
+        ?ExceptionContextProvider $contextProvider,
+        int $statusCode
+    ): ?string {
+        try {
+            // Determine template name based on status code
+            $templateName = $this->getTemplateName($statusCode);
+
+            // Prepare template data
+            $templateData = $this->prepareTemplateData($exception, $contextProvider, $statusCode);
+
+            // Create RenderContext
+            $renderContext = new RenderContext(
+                template: $templateName,
+                metaData: new MetaData($this->getErrorTitle($statusCode)),
+                data: $templateData,
+                processingMode: ProcessingMode::FULL
+            );
+
+            // Render template
+            return $this->engine->render($renderContext);
+        } catch (\Throwable $e) {
+            // Template not found or rendering failed - log error and return null for fallback
+            error_log(sprintf(
+                'Failed to render error template "%s" for status %d: %s in %s:%d',
+                $templateName ?? 'unknown',
+                $statusCode,
+                $e->getMessage(),
+                $e->getFile(),
+                $e->getLine()
+            ));
+
+            // Return null to trigger fallback HTML generation
+            return null;
+        }
+    }
+
+    /**
+     * Get template name based on status code
+     */
+    private function getTemplateName(int $statusCode): string
+    {
+        return match ($statusCode) {
+            404 => 'errors/404',
+            500 => 'errors/500',
+            default => 'errors/error',
+        };
+    }
+
+    /**
+     * Prepare template data for rendering
+     *
+     * @return array<string, mixed>
+     */
+    private function prepareTemplateData(
+        \Throwable $exception,
+        ?ExceptionContextProvider $contextProvider,
+        int $statusCode
+    ): array {
+        $data = [
+            'statusCode' => $statusCode,
+            'title' => $this->getErrorTitle($statusCode),
+            'message' => $this->isDebugMode
+                ? $exception->getMessage()
+                : 'An error occurred while processing your request.',
+            'exceptionClass' => $this->getShortClassName(get_class($exception)),
+            'isDebugMode' => $this->isDebugMode,
+        ];
+
+        // Add debug information if enabled
+        if ($this->isDebugMode) {
+            $stackTrace = StackTrace::fromThrowable($exception);
+            $data['debug'] = [
+                'file' => $exception->getFile(),
+                'line' => $exception->getLine(),
+                'trace' => $stackTrace->formatForHtml(),
+            ];
+
+            // Add context from WeakMap if available
+            if ($contextProvider !== null) {
+                $context = $contextProvider->get($exception);
+                if ($context !== null) {
+                    $data['context'] = [
+                        'operation' => $context->operation,
+                        'component' => $context->component,
+                        'request_id' => $context->requestId,
+                        'occurred_at' => $context->occurredAt?->format('Y-m-d H:i:s'),
+                    ];
+                }
+            }
+        }
+
+        return $data;
+    }
+
+    /**
+     * Generate fallback HTML error page (when template not found)
+     */
+    private function generateFallbackHtml(
         \Throwable $exception,
         ?ExceptionContextProvider $contextProvider,
         int $statusCode
     ): string {
-        $title = $this->getErrorTitle($statusCode);
-        $message = $this->isDebugMode
-            ? $exception->getMessage()
-            : 'An error occurred while processing your request.';
+        // HTML-encode all variables for security
+        $title = htmlspecialchars($this->getErrorTitle($statusCode), ENT_QUOTES | ENT_HTML5, 'UTF-8');
+        $message = htmlspecialchars(
+            $this->isDebugMode
+                ? $exception->getMessage()
+                : 'An error occurred while processing your request.',
+            ENT_QUOTES | ENT_HTML5,
+            'UTF-8'
+        );
 
         $debugInfo = '';
         if ($this->isDebugMode) {
@@ -211,32 +353,42 @@ HTML;
         \Throwable $exception,
         ?ExceptionContextProvider $contextProvider
     ): string {
-        $exceptionClass = get_class($exception);
-        $file = $exception->getFile();
+        // HTML-encode all debug information for security
+        $exceptionClass = htmlspecialchars($this->getShortClassName(get_class($exception)), ENT_QUOTES | ENT_HTML5, 'UTF-8');
+        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES | ENT_HTML5, 'UTF-8');
         $line = $exception->getLine();
-        $trace = $this->formatStackTrace($exception);
+        $stackTrace = StackTrace::fromThrowable($exception);
+        $trace = $stackTrace->formatForHtml(); // Already HTML-encoded in formatForHtml
 
         $contextHtml = '';
         if ($contextProvider !== null) {
             $context = $contextProvider->get($exception);
             if ($context !== null) {
+                $operation = htmlspecialchars($context->operation ?? '', ENT_QUOTES | ENT_HTML5, 'UTF-8');
+                $component = htmlspecialchars($context->component ?? '', ENT_QUOTES | ENT_HTML5, 'UTF-8');
+                $requestId = htmlspecialchars($context->requestId ?? '', ENT_QUOTES | ENT_HTML5, 'UTF-8');
+                $occurredAt = $context->occurredAt?->format('Y-m-d H:i:s') ?? '';
+
                 $contextHtml = <<<HTML
 <div class="context-item">
-    <span class="context-label">Operation:</span> {$context->operation}
+    <span class="context-label">Operation:</span> {$operation}
 </div>
 <div class="context-item">
-    <span class="context-label">Component:</span> {$context->component}
+    <span class="context-label">Component:</span> {$component}
 </div>
 <div class="context-item">
-    <span class="context-label">Request ID:</span> {$context->requestId}
+    <span class="context-label">Request ID:</span> {$requestId}
 </div>
 <div class="context-item">
-    <span class="context-label">Occurred At:</span> {$context->occurredAt?->format('Y-m-d H:i:s')}
+    <span class="context-label">Occurred At:</span> {$occurredAt}
 </div>
 HTML;
             }
         }
 
+        // Code-Ausschnitt für die Exception-Zeile
+        $codeSnippet = $this->getCodeSnippet($exception->getFile(), $line);
+
         return <<<HTML
 <div class="debug-info">
     <h3>Debug Information</h3>
@@ -247,6 +399,7 @@ HTML;
         <span class="context-label">File:</span> {$file}:{$line}
     </div>
     {$contextHtml}
+    {$codeSnippet}
     <h4>Stack Trace:</h4>
     <pre>{$trace}</pre>
 </div>
@@ -319,18 +472,35 @@ HTML;
     }
 
     /**
-     * Format stack trace for display
+     * Gibt Klassennamen ohne Namespace zurück
      */
-    private function formatStackTrace(\Throwable $exception): string
+    private function getShortClassName(string $fullClassName): string
     {
-        $trace = $exception->getTraceAsString();
+        $parts = explode('\\', $fullClassName);
+        return end($parts);
+    }
 
-        // Limit trace depth in production
-        if (!$this->isDebugMode) {
-            $lines = explode("\n", $trace);
-            $trace = implode("\n", array_slice($lines, 0, 5));
+    /**
+     * Gibt Code-Ausschnitt für die Exception-Zeile zurück
+     */
+    private function getCodeSnippet(string $file, int $line): string
+    {
+        if (!file_exists($file)) {
+            return '';
         }
 
-        return htmlspecialchars($trace, ENT_QUOTES, 'UTF-8');
+        try {
+            $fileHighlighter = new FileHighlighter();
+            $startLine = max(0, $line - 5); // 5 Zeilen vor der Exception
+            $range = 11; // 5 vor + 1 Exception + 5 nach = 11 Zeilen
+
+            // FileHighlighter gibt bereits HTML mit Syntax-Highlighting zurück
+            $highlightedCode = $fileHighlighter($file, $startLine, $range, $line);
+
+            return '<h4>Code Context:</h4>' . $highlightedCode;
+        } catch (\Throwable $e) {
+            // Bei Fehler beim Lesen der Datei, ignoriere Code-Ausschnitt
+            return '';
+        }
     }
 }
diff --git a/src/Framework/ExceptionHandling/Reporter/ReporterRegistry.php b/src/Framework/ExceptionHandling/Reporter/ReporterRegistry.php
new file mode 100644
index 00000000..dd202fe2
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Reporter/ReporterRegistry.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Reporter;
+
+/**
+ * Registry for multiple exception reporters
+ *
+ * Allows registering multiple Reporter instances that will all receive
+ * exceptions when report() is called. Failures in one reporter do not
+ * prevent other reporters from being called (resilient design).
+ */
+final readonly class ReporterRegistry implements Reporter
+{
+    /**
+     * @param Reporter[] $reporters Variadic list of reporter instances
+     */
+    private array $reporters;
+    public function __construct(
+        Reporter ...$reporters
+    ) {
+        // Variadic parameters need manual assignment
+        $this->reporters = $reporters;
+    }
+
+    /**
+     * Report exception to all registered reporters
+     *
+     * Each reporter is called independently. If one reporter fails,
+     * the others will still be called (resilient error handling).
+     *
+     * @param \Throwable $e Exception to report
+     */
+    public function report(\Throwable $e): void
+    {
+        foreach ($this->reporters as $reporter) {
+            try {
+                $reporter->report($e);
+            } catch (\Throwable $reportError) {
+                // Silently continue - one reporter failure shouldn't stop others
+                // In production, you might want to log this, but we don't want
+                // to create a logging loop or dependency on Logger here
+                continue;
+            }
+        }
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Serialization/ExceptionSerializer.php b/src/Framework/ExceptionHandling/Serialization/ExceptionSerializer.php
new file mode 100644
index 00000000..b6f78220
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Serialization/ExceptionSerializer.php
@@ -0,0 +1,335 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Serialization;
+
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\Logging\ValueObjects\ExceptionContext as LoggingExceptionContext;
+use Throwable;
+
+/**
+ * Exception Serializer
+ *
+ * Provides standardized serialization of exceptions with context for:
+ * - JSON serialization
+ * - Structured log format
+ * - Storage format
+ *
+ * Integrates with ExceptionContextProvider to include external context.
+ */
+final readonly class ExceptionSerializer
+{
+    public function __construct(
+        private ?ExceptionContextProvider $contextProvider = null
+    ) {
+    }
+
+    /**
+     * Serialize exception to JSON
+     *
+     * @param Throwable $exception
+     * @param array<string, mixed> $options Serialization options
+     * @return string JSON string
+     */
+    public function toJson(Throwable $exception, array $options = []): string
+    {
+        $data = $this->toArray($exception, $options);
+        return json_encode($data, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+    }
+
+    /**
+     * Serialize exception to array
+     *
+     * @param Throwable $exception
+     * @param array<string, mixed> $options Serialization options
+     * @return array<string, mixed>
+     */
+    public function toArray(Throwable $exception, array $options = []): array
+    {
+        $includeStackTrace = $options['include_stack_trace'] ?? true;
+        $includePrevious = $options['include_previous'] ?? true;
+        $includeContext = $options['include_context'] ?? true;
+        $compact = $options['compact'] ?? false;
+
+        $data = [
+            'exception' => $this->serializeException($exception, $includeStackTrace, $includePrevious, $compact),
+        ];
+
+        // Add external context if available
+        if ($includeContext && $this->contextProvider !== null) {
+            $context = $this->contextProvider->get($exception);
+            if ($context !== null) {
+                $data['context'] = $this->serializeContext($context, $compact);
+            }
+        }
+
+        // Add metadata
+        $data['timestamp'] = (new \DateTimeImmutable())->format(\DateTimeInterface::ATOM);
+        $data['serializer_version'] = '1.0';
+
+        return $data;
+    }
+
+    /**
+     * Serialize exception to structured log format
+     *
+     * Optimized for logging systems (e.g., ELK, Splunk).
+     *
+     * @param Throwable $exception
+     * @return array<string, mixed>
+     */
+    public function toLogFormat(Throwable $exception): array
+    {
+        $context = $this->contextProvider?->get($exception);
+
+        $logData = [
+            'exception_class' => get_class($exception),
+            'exception_message' => $exception->getMessage(),
+            'exception_code' => $exception->getCode(),
+            'file' => $exception->getFile(),
+            'line' => $exception->getLine(),
+            'timestamp' => (new \DateTimeImmutable())->format(\DateTimeInterface::ATOM),
+        ];
+
+        // Add context data if available
+        if ($context !== null) {
+            $logData = array_merge($logData, [
+                'operation' => $context->operation,
+                'component' => $context->component,
+                'user_id' => $context->userId,
+                'request_id' => $this->serializeValue($context->requestId),
+                'session_id' => $this->serializeValue($context->sessionId),
+                'client_ip' => $this->serializeValue($context->clientIp),
+                'user_agent' => $this->serializeValue($context->userAgent),
+                'tags' => $context->tags,
+                'auditable' => $context->auditable,
+                'audit_level' => $context->auditLevel,
+            ]);
+
+            // Add domain data
+            if (!empty($context->data)) {
+                $logData['domain_data'] = $context->data;
+            }
+
+            // Add metadata
+            if (!empty($context->metadata)) {
+                $logData['metadata'] = $context->metadata;
+            }
+        }
+
+        // Add stack trace (limited depth for logs)
+        $logData['stack_trace'] = $this->serializeStackTrace($exception, maxDepth: 10);
+
+        // Add previous exception if available
+        if ($exception->getPrevious() !== null) {
+            $logData['previous_exception'] = [
+                'class' => get_class($exception->getPrevious()),
+                'message' => $exception->getPrevious()->getMessage(),
+                'code' => $exception->getPrevious()->getCode(),
+            ];
+        }
+
+        return $logData;
+    }
+
+    /**
+     * Serialize exception to storage format
+     *
+     * Optimized for database storage (compact, indexed fields).
+     *
+     * @param Throwable $exception
+     * @return array<string, mixed>
+     */
+    public function toStorageFormat(Throwable $exception): array
+    {
+        $context = $this->contextProvider?->get($exception);
+
+        $storageData = [
+            'exception_class' => get_class($exception),
+            'exception_message' => $exception->getMessage(),
+            'exception_code' => $exception->getCode(),
+            'file' => $exception->getFile(),
+            'line' => $exception->getLine(),
+            'occurred_at' => $context?->occurredAt->format(\DateTimeInterface::ATOM) ?? (new \DateTimeImmutable())->format(\DateTimeInterface::ATOM),
+        ];
+
+        // Add context data (indexed fields)
+        if ($context !== null) {
+            $storageData = array_merge($storageData, [
+                'operation' => $context->operation,
+                'component' => $context->component,
+                'user_id' => $context->userId,
+                'request_id' => $this->serializeValue($context->requestId),
+                'session_id' => $this->serializeValue($context->sessionId),
+                'client_ip' => $this->serializeValue($context->clientIp),
+                'user_agent' => $this->serializeValue($context->userAgent),
+                'tags' => json_encode($context->tags, JSON_THROW_ON_ERROR),
+                'auditable' => $context->auditable,
+                'audit_level' => $context->auditLevel,
+            ]);
+
+            // Serialize complex data as JSON
+            $storageData['data'] = json_encode($context->data, JSON_THROW_ON_ERROR);
+            $storageData['debug'] = json_encode($context->debug, JSON_THROW_ON_ERROR);
+            $storageData['metadata'] = json_encode($context->metadata, JSON_THROW_ON_ERROR);
+        }
+
+        // Serialize stack trace as JSON (full depth)
+        $storageData['stack_trace'] = json_encode($this->serializeStackTrace($exception), JSON_THROW_ON_ERROR);
+
+        // Serialize previous exception chain as JSON
+        if ($exception->getPrevious() !== null) {
+            $storageData['previous_exception'] = json_encode(
+                $this->serializeException($exception->getPrevious(), includeStackTrace: true, includePrevious: true, compact: false),
+                JSON_THROW_ON_ERROR
+            );
+        }
+
+        return $storageData;
+    }
+
+    /**
+     * Serialize exception details
+     *
+     * @param Throwable $exception
+     * @param bool $includeStackTrace
+     * @param bool $includePrevious
+     * @param bool $compact
+     * @return array<string, mixed>
+     */
+    private function serializeException(
+        Throwable $exception,
+        bool $includeStackTrace,
+        bool $includePrevious,
+        bool $compact
+    ): array {
+        $data = [
+            'class' => get_class($exception),
+            'message' => $exception->getMessage(),
+            'code' => $exception->getCode(),
+            'file' => $exception->getFile(),
+            'line' => $exception->getLine(),
+        ];
+
+        if ($includeStackTrace) {
+            $data['stack_trace'] = $this->serializeStackTrace($exception, compact: $compact);
+        }
+
+        if ($includePrevious && $exception->getPrevious() !== null) {
+            $data['previous'] = $this->serializeException(
+                $exception->getPrevious(),
+                $includeStackTrace,
+                $includePrevious,
+                $compact
+            );
+        }
+
+        return $data;
+    }
+
+    /**
+     * Serialize stack trace
+     *
+     * @param Throwable $exception
+     * @param int|null $maxDepth Maximum depth (null = unlimited)
+     * @param bool $compact Compact format
+     * @return array<int, array<string, mixed>>
+     */
+    private function serializeStackTrace(Throwable $exception, ?int $maxDepth = null, bool $compact = false): array
+    {
+        $trace = $exception->getTrace();
+        if ($maxDepth !== null) {
+            $trace = array_slice($trace, 0, $maxDepth);
+        }
+
+        $serialized = [];
+        foreach ($trace as $frame) {
+            if ($compact) {
+                $serialized[] = [
+                    'file' => $frame['file'] ?? 'unknown',
+                    'line' => $frame['line'] ?? 0,
+                    'function' => $frame['function'] ?? 'unknown',
+                ];
+            } else {
+                $serialized[] = [
+                    'file' => $frame['file'] ?? 'unknown',
+                    'line' => $frame['line'] ?? 0,
+                    'function' => $frame['function'] ?? 'unknown',
+                    'class' => $frame['class'] ?? null,
+                    'type' => $frame['type'] ?? null,
+                    'args' => $this->serializeArgs($frame['args'] ?? []),
+                ];
+            }
+        }
+
+        return $serialized;
+    }
+
+    /**
+     * Serialize function arguments (safe for serialization)
+     *
+     * @param array<int, mixed> $args
+     * @return array<int, mixed>
+     */
+    private function serializeArgs(array $args): array
+    {
+        $serialized = [];
+        foreach ($args as $arg) {
+            if (is_object($arg)) {
+                $serialized[] = [
+                    'type' => get_class($arg),
+                    'value' => method_exists($arg, '__toString') ? (string) $arg : '[object]',
+                ];
+            } elseif (is_array($arg)) {
+                $serialized[] = '[array:' . count($arg) . ']';
+            } elseif (is_resource($arg)) {
+                $serialized[] = '[resource]';
+            } else {
+                $serialized[] = $arg;
+            }
+        }
+        return $serialized;
+    }
+
+    /**
+     * Serialize context data
+     *
+     * @param ExceptionContextData $context
+     * @param bool $compact
+     * @return array<string, mixed>
+     */
+    private function serializeContext(ExceptionContextData $context, bool $compact): array
+    {
+        return $context->toArray();
+    }
+
+    /**
+     * Serialize value (Value Object or primitive)
+     *
+     * @param mixed $value
+     * @return string|null
+     */
+    private function serializeValue(mixed $value): ?string
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        if (is_string($value)) {
+            return $value;
+        }
+
+        if (is_object($value) && method_exists($value, 'toString')) {
+            return $value->toString();
+        }
+
+        if (is_object($value) && property_exists($value, 'value')) {
+            return (string) $value->value;
+        }
+
+        return (string) $value;
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ShutdownHandler.php b/src/Framework/ExceptionHandling/ShutdownHandler.php
index 96ccee5f..d8a67aea 100644
--- a/src/Framework/ExceptionHandling/ShutdownHandler.php
+++ b/src/Framework/ExceptionHandling/ShutdownHandler.php
@@ -3,19 +3,19 @@ declare(strict_types=1);
 
 namespace App\Framework\ExceptionHandling;
 
-use App\Framework\ErrorHandling\ErrorHandlerManager;
-use App\Framework\ExceptionHandling\Strategy\StrictErrorPolicy;
 use Error;
 
-final readonly class ShutdownHandler
+final readonly class ShutdownHandler implements ShutdownHandlerInterface
 {
-    private const array FATAL_TYPES = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR];
+    public function __construct(
+        private ErrorKernel $errorKernel
+    ) {}
 
     public function handle(): void
     {
         $last = error_get_last();
 
-        if (!$last || !$this->isFatalError($last['type'])) {
+        if (!$last || !FatalErrorTypes::isFatal($last['type'])) {
             return;
         }
 
@@ -29,10 +29,11 @@ final readonly class ShutdownHandler
 
 
         try {
-            $ehm = new ErrorKernel();
-            $ehm->handle($error, ['file' => $file, 'line' => $line]);
+            if ($this->errorKernel !== null) {
+                $this->errorKernel->handle($error, ['file' => $file, 'line' => $line]);
+            }
         } catch (\Throwable) {
-
+            // Ignore errors during shutdown handler execution
         }
 
         exit(255);
@@ -49,8 +50,4 @@ final readonly class ShutdownHandler
         }
     }
 
-    private function isFatalError(?int $type = null): bool
-    {
-        return in_array($type ?? 0, self::FATAL_TYPES, true);
-    }
 }
diff --git a/src/Framework/ExceptionHandling/Strategy/ErrorPolicyResolver.php b/src/Framework/ExceptionHandling/Strategy/ErrorPolicyResolver.php
index 71a24df8..fd29a087 100644
--- a/src/Framework/ExceptionHandling/Strategy/ErrorPolicyResolver.php
+++ b/src/Framework/ExceptionHandling/Strategy/ErrorPolicyResolver.php
@@ -5,15 +5,22 @@ namespace App\Framework\ExceptionHandling\Strategy;
 
 use App\Framework\Config\EnvironmentType;
 use App\Framework\ExceptionHandling\ErrorHandlerStrategy;
+use App\Framework\Logging\Logger;
 
 final readonly class ErrorPolicyResolver
 {
+    public function __construct(
+        private ?Logger $logger = null
+    ) {}
+
     public function resolve(EnvironmentType $environmentType): ErrorHandlerStrategy
     {
         return match(true) {
             $environmentType->isProduction() => new StrictErrorPolicy(),
-            $environmentType->isDevelopment() => new StrictErrorPolicy(),
-            default => new StrictErrorPolicy(),
+            $environmentType->isDevelopment() => $this->logger !== null 
+                ? new LenientPolicy($this->logger)
+                : new StrictErrorPolicy(),
+            default => new SilentErrorPolicy(),
         };
     }
 }
diff --git a/src/Framework/ExceptionHandling/Strategy/LenientPolicy.php b/src/Framework/ExceptionHandling/Strategy/LenientPolicy.php
index b91f591c..544b9f3c 100644
--- a/src/Framework/ExceptionHandling/Strategy/LenientPolicy.php
+++ b/src/Framework/ExceptionHandling/Strategy/LenientPolicy.php
@@ -24,7 +24,8 @@ final readonly class LenientPolicy implements ErrorHandlerStrategy
                 LogContext::withData(
                     [
                         'file' => $context->file,
-                        'line' => $context->line]
+                        'line' => $context->line?->toInt()
+                    ]
                 ));
 
             return ErrorDecision::HANDLED;
@@ -36,7 +37,7 @@ final readonly class LenientPolicy implements ErrorHandlerStrategy
                 0,
                 $context->severity,
                 $context->file,
-                $context->line
+                $context->line?->toInt()
             );
         }
 
diff --git a/src/Framework/ExceptionHandling/Strategy/StrictErrorPolicy.php b/src/Framework/ExceptionHandling/Strategy/StrictErrorPolicy.php
index fd06baa0..b2d5617a 100644
--- a/src/Framework/ExceptionHandling/Strategy/StrictErrorPolicy.php
+++ b/src/Framework/ExceptionHandling/Strategy/StrictErrorPolicy.php
@@ -15,6 +15,12 @@ final readonly class StrictErrorPolicy implements ErrorHandlerStrategy
      */
     public function handle(ErrorContext $context): ErrorDecision
     {
-        throw new ErrorException($context->message, 0, $context->severity, $context->file, $context->line);
+        throw new ErrorException(
+            $context->message,
+            0,
+            $context->severity,
+            $context->file,
+            $context->line?->toInt()
+        );
     }
 }
diff --git a/src/Framework/ExceptionHandling/Translation/ExceptionMessageTranslator.php b/src/Framework/ExceptionHandling/Translation/ExceptionMessageTranslator.php
new file mode 100644
index 00000000..07a82135
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Translation/ExceptionMessageTranslator.php
@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Translation;
+
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use Throwable;
+
+/**
+ * Exception Message Translator
+ *
+ * Translates technical exception messages to user-friendly messages.
+ */
+final readonly class ExceptionMessageTranslator
+{
+    /**
+     * @param array<string, string|array{message: string, title?: string, help?: string}> $templates Message templates
+     * @param bool $isDebugMode Whether debug mode is enabled (shows technical messages)
+     */
+    public function __construct(
+        private array $templates = [],
+        private bool $isDebugMode = false
+    ) {
+    }
+
+    /**
+     * Translate exception to user-friendly message
+     *
+     * @param Throwable $exception Exception to translate
+     * @param ExceptionContextData|null $context Optional context for template variables
+     * @return UserFriendlyMessage User-friendly message
+     */
+    public function translate(Throwable $exception, ?ExceptionContextData $context = null): UserFriendlyMessage
+    {
+        // In debug mode, return technical message
+        if ($this->isDebugMode) {
+            return new UserFriendlyMessage(
+                message: $exception->getMessage(),
+                technicalMessage: $exception->getMessage()
+            );
+        }
+
+        $exceptionClass = get_class($exception);
+        $template = $this->templates[$exceptionClass] ?? null;
+
+        if ($template === null) {
+            // Fallback to generic message
+            return $this->getGenericMessage($exception);
+        }
+
+        // Process template
+        if (is_string($template)) {
+            $message = $this->processTemplate($template, $exception, $context);
+            return UserFriendlyMessage::simple($message);
+        }
+
+        if (is_array($template)) {
+            $message = $this->processTemplate($template['message'] ?? '', $exception, $context);
+            $title = isset($template['title']) ? $this->processTemplate($template['title'], $exception, $context) : null;
+            $help = isset($template['help']) ? $this->processTemplate($template['help'], $exception, $context) : null;
+
+            return new UserFriendlyMessage(
+                message: $message,
+                title: $title,
+                helpText: $help,
+                technicalMessage: $exception->getMessage()
+            );
+        }
+
+        return $this->getGenericMessage($exception);
+    }
+
+    /**
+     * Process template with variables
+     */
+    private function processTemplate(string $template, Throwable $exception, ?ExceptionContextData $context): string
+    {
+        $variables = [
+            '{exception_message}' => $exception->getMessage(),
+            '{exception_class}' => get_class($exception),
+            '{operation}' => $context?->operation ?? 'unknown operation',
+            '{component}' => $context?->component ?? 'unknown component',
+        ];
+
+        return str_replace(array_keys($variables), array_values($variables), $template);
+    }
+
+    /**
+     * Get generic user-friendly message
+     */
+    private function getGenericMessage(Throwable $exception): UserFriendlyMessage
+    {
+        return new UserFriendlyMessage(
+            message: 'An error occurred while processing your request. Please try again later.',
+            technicalMessage: $exception->getMessage()
+        );
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/Translation/UserFriendlyMessage.php b/src/Framework/ExceptionHandling/Translation/UserFriendlyMessage.php
new file mode 100644
index 00000000..1cf0f055
--- /dev/null
+++ b/src/Framework/ExceptionHandling/Translation/UserFriendlyMessage.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\Translation;
+
+/**
+ * User-Friendly Message
+ *
+ * Immutable value object for user-friendly exception messages.
+ */
+final readonly class UserFriendlyMessage
+{
+    /**
+     * @param string $message User-friendly message
+     * @param string|null $title Optional title for the message
+     * @param string|null $helpText Optional help text or suggestions
+     * @param string|null $technicalMessage Original technical message (for debugging)
+     */
+    public function __construct(
+        public string $message,
+        public ?string $title = null,
+        public ?string $helpText = null,
+        public ?string $technicalMessage = null
+    ) {
+    }
+
+    /**
+     * Create simple message
+     */
+    public static function simple(string $message): self
+    {
+        return new self($message);
+    }
+
+    /**
+     * Create message with title
+     */
+    public static function withTitle(string $message, string $title): self
+    {
+        return new self($message, title: $title);
+    }
+
+    /**
+     * Create message with help text
+     */
+    public static function withHelp(string $message, string $helpText): self
+    {
+        return new self($message, helpText: $helpText);
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ValueObjects/StackItem.php b/src/Framework/ExceptionHandling/ValueObjects/StackItem.php
new file mode 100644
index 00000000..d5b55737
--- /dev/null
+++ b/src/Framework/ExceptionHandling/ValueObjects/StackItem.php
@@ -0,0 +1,441 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\ValueObjects;
+
+/**
+ * Stack Item Value Object für strukturierte Stack Trace Darstellung
+ *
+ * Repräsentiert einen einzelnen Frame im Stack Trace mit formatierter Ausgabe.
+ * Entfernt Namespaces aus Klassennamen für bessere Lesbarkeit.
+ */
+final readonly class StackItem
+{
+    public function __construct(
+        public string $file,
+        public int $line,
+        public ?string $function = null,
+        public ?string $class = null,
+        public ?string $type = null,
+        public array $args = []
+    ) {
+    }
+
+    /**
+     * Erstellt StackItem aus debug_backtrace Array
+     *
+     * @param array<string, mixed> $frame
+     */
+    public static function fromArray(array $frame): self
+    {
+        // Bereinige Args, um nicht-serialisierbare Objekte zu entfernen
+        $args = isset($frame['args']) ? self::sanitizeArgs($frame['args']) : [];
+
+        // Normalisiere Klassenname: Forward-Slashes zu Backslashes
+        $class = null;
+        if (isset($frame['class']) && is_string($frame['class'])) {
+            $class = str_replace('/', '\\', $frame['class']);
+        }
+
+        return new self(
+            file: $frame['file'] ?? 'unknown',
+            line: $frame['line'] ?? 0,
+            function: $frame['function'] ?? null,
+            class: $class,
+            type: $frame['type'] ?? null,
+            args: $args
+        );
+    }
+
+    /**
+     * Bereinigt Args, um nicht-serialisierbare Objekte (wie ReflectionClass) zu entfernen
+     *
+     * @param array<int, mixed> $args
+     * @return array<int, mixed>
+     */
+    private static function sanitizeArgs(array $args): array
+    {
+        return array_map(
+            fn($arg) => self::sanitizeValue($arg),
+            $args
+        );
+    }
+
+    /**
+     * Bereinigt einzelnen Wert, entfernt nicht-serialisierbare Objekte
+     */
+    private static function sanitizeValue(mixed $value): mixed
+    {
+        // Closures können nicht serialisiert werden
+        if ($value instanceof \Closure) {
+            try {
+                $reflection = new \ReflectionFunction($value);
+                $file = $reflection->getFileName();
+                $line = $reflection->getStartLine();
+                return sprintf('Closure(%s:%d)', basename($file), $line);
+            } catch (\Throwable) {
+                return 'Closure';
+            }
+        }
+
+        // Reflection-Objekte können nicht serialisiert werden
+        if (is_object($value)) {
+            $className = get_class($value);
+            if ($value instanceof \ReflectionClass
+                || $value instanceof \ReflectionMethod
+                || $value instanceof \ReflectionProperty
+                || $value instanceof \ReflectionFunction
+                || $value instanceof \ReflectionParameter
+                || $value instanceof \ReflectionType
+                || str_starts_with($className, 'Reflection')) {
+                return sprintf('ReflectionObject(%s)', $className);
+            }
+
+            // Anonyme Klassen können auch Probleme verursachen
+            if (str_contains($className, '@anonymous')) {
+                $parentClass = get_parent_class($value);
+                if ($parentClass !== false) {
+                    return sprintf('Anonymous(%s)', $parentClass);
+                }
+                return 'Anonymous';
+            }
+
+            // Andere Objekte durch Klassenname ersetzen
+            return $className;
+        }
+
+        // Arrays rekursiv bereinigen
+        if (is_array($value)) {
+            return array_map(
+                fn($item) => self::sanitizeValue($item),
+                $value
+            );
+        }
+
+        // Primitives bleiben unverändert
+        return $value;
+    }
+
+    /**
+     * Gibt Klasse ohne Namespace zurück
+     * Behandelt anonyme Klassen, indem das Interface/Parent-Class extrahiert wird
+     */
+    public function getShortClass(): ?string
+    {
+        if ($this->class === null) {
+            return null;
+        }
+
+        // Normalisiere Forward-Slashes zu Backslashes (falls vorhanden)
+        // Dies ist wichtig, da manche Systeme Forward-Slashes verwenden
+        $normalizedClass = str_replace('/', '\\', $this->class);
+
+        // Anonyme Klassen erkennen: Format ist z.B. "App\Framework\Http\Next@anonymous/path/to/file.php:line$hash"
+        // oder "Next@anonymous/path/to/file.php:line$hash"
+        if (str_contains($normalizedClass, '@anonymous')) {
+            // Extrahiere den Teil vor @anonymous (normalerweise das Interface mit vollständigem Namespace)
+            $match = preg_match('/^([^@]+)@anonymous/', $normalizedClass, $matches);
+            if ($match && isset($matches[1])) {
+                $interfaceName = $matches[1];
+                // Entferne Namespace: Spalte am Backslash und nimm den letzten Teil
+                $parts = explode('\\', $interfaceName);
+                $shortName = end($parts);
+                return $shortName . ' (anonymous)';
+            }
+            return 'Anonymous';
+        }
+
+        // Spalte am Backslash und nimm den letzten Teil (Klassenname ohne Namespace)
+        $parts = explode('\\', $normalizedClass);
+        $shortName = end($parts);
+        
+        // Sicherstellen, dass wir wirklich nur den letzten Teil zurückgeben
+        // (falls explode() nicht funktioniert hat, z.B. bei Forward-Slashes)
+        if ($shortName === $normalizedClass && str_contains($normalizedClass, '/')) {
+            // Fallback: versuche es mit Forward-Slash
+            $parts = explode('/', $normalizedClass);
+            $shortName = end($parts);
+        }
+        
+        return $shortName;
+    }
+
+    /**
+     * Gibt Kurzform des File-Pfads zurück (relativ zum Project Root wenn möglich)
+     */
+    public function getShortFile(): string
+    {
+        $projectRoot = dirname(__DIR__, 4); // Von src/Framework/ExceptionHandling/ValueObjects nach root
+
+        if (str_starts_with($this->file, $projectRoot)) {
+            return substr($this->file, strlen($projectRoot) + 1);
+        }
+
+        return $this->file;
+    }
+
+    /**
+     * Gibt vollständigen Method/Function Call zurück (ohne Namespace)
+     */
+    public function getCall(): string
+    {
+        $parts = [];
+
+        if ($this->class !== null) {
+            $parts[] = $this->getShortClass();
+        }
+
+        if ($this->type !== null) {
+            $parts[] = $this->type;
+        }
+
+        if ($this->function !== null) {
+            $parts[] = $this->function . '()';
+        }
+
+        return implode('', $parts);
+    }
+
+    /**
+     * Formatiert Parameter für Display (kompakte Darstellung)
+     */
+    public function formatParameters(): string
+    {
+        if (empty($this->args)) {
+            return '';
+        }
+
+        $formatted = [];
+        foreach ($this->args as $arg) {
+            $formatted[] = $this->formatParameterForDisplay($arg);
+        }
+
+        return implode(', ', $formatted);
+    }
+
+    /**
+     * Formatiert einzelnen Parameter für Display
+     */
+    private function formatParameterForDisplay(mixed $value): string
+    {
+        return match (true) {
+            is_string($value) => $this->formatStringParameter($value),
+            is_int($value), is_float($value) => (string) $value,
+            is_bool($value) => $value ? 'true' : 'false',
+            is_null($value) => 'null',
+            is_array($value) => sprintf('array(%d)', count($value)),
+            is_resource($value) => sprintf('resource(%s)', get_resource_type($value)),
+            is_object($value) => $this->formatObjectForDisplay($value),
+            default => get_debug_type($value),
+        };
+    }
+
+    /**
+     * Formatiert String-Parameter, entfernt Namespaces aus Klassennamen
+     */
+    private function formatStringParameter(string $value): string
+    {
+        // Normalisiere Forward-Slashes zu Backslashes (falls vorhanden)
+        $normalizedValue = str_replace('/', '\\', $value);
+
+        // Wenn der String ein Klassename ist (vollständiger Namespace), entferne Namespace
+        if (class_exists($normalizedValue) || interface_exists($normalizedValue) || enum_exists($normalizedValue)) {
+            $parts = explode('\\', $normalizedValue);
+            $shortName = end($parts);
+            return sprintf("'%s'", $shortName);
+        }
+
+        // Prüfe, ob der String ein Namespace-Format hat (z.B. "App\Framework\Performance\PerformanceCategory")
+        // Auch wenn die Klasse nicht existiert, entferne Namespace
+        // Pattern: Beginnt mit Großbuchstaben, enthält Backslashes oder Forward-Slashes, endet mit Klassennamen
+        if (preg_match('/^[A-Z][a-zA-Z0-9_\\\\\/]+$/', $normalizedValue) && (str_contains($normalizedValue, '\\') || str_contains($value, '/'))) {
+            $parts = explode('\\', $normalizedValue);
+            // Nur wenn es mehrere Teile gibt (Namespace vorhanden)
+            if (count($parts) > 1) {
+                $shortName = end($parts);
+                return sprintf("'%s'", $shortName);
+            }
+        }
+
+        // Closure-String-Format: "Closure(RouteDispatcher.php:77)" oder "Closure(/full/path/RouteDispatcher.php:77)"
+        if (preg_match('/^Closure\(([^:]+):(\d+)\)$/', $value, $matches)) {
+            $file = basename($matches[1]);
+            $line = $matches[2];
+            return sprintf("Closure(%s:%s)", $file, $line);
+        }
+
+        // Lange Strings kürzen
+        if (strlen($value) > 50) {
+            return sprintf("'%s...'", substr($value, 0, 50));
+        }
+
+        return sprintf("'%s'", $value);
+    }
+
+    /**
+     * Formatiert Objekt für Display (kompakte Darstellung)
+     */
+    private function formatObjectForDisplay(object $value): string
+    {
+        $className = get_class($value);
+
+        // Entferne Namespace für bessere Lesbarkeit
+        $parts = explode('\\', $className);
+        $shortName = end($parts);
+
+        // Anonyme Klassen
+        if (str_contains($className, '@anonymous')) {
+            $match = preg_match('/^([^@]+)@anonymous/', $className, $matches);
+            if ($match && isset($matches[1])) {
+                $interfaceName = $matches[1];
+                $interfaceParts = explode('\\', $interfaceName);
+                $shortInterface = end($interfaceParts);
+                return $shortInterface . ' (anonymous)';
+            }
+            return 'Anonymous';
+        }
+
+        return $shortName;
+    }
+
+    /**
+     * Formatiert Funktionsnamen, entfernt Namespaces und verbessert Closure-Darstellung
+     */
+    private function formatFunctionName(?string $function): string
+    {
+        if ($function === null) {
+            return '';
+        }
+
+        // Closures haben Format: {closure:Namespace\Class::method():line} oder {closure:Namespace/Class::method():line}
+        if (preg_match('/\{closure:([^}]+)\}/', $function, $matches)) {
+            $closureInfo = $matches[1];
+            // Normalisiere Forward-Slashes zu Backslashes
+            $closureInfo = str_replace('/', '\\', $closureInfo);
+            
+            // Parse: App\Framework\Router\RouteDispatcher::executeController():77
+            if (preg_match('/^([^:]+)::([^(]+)\(\):(\d+)$/', $closureInfo, $closureMatches)) {
+                $fullClass = $closureMatches[1];
+                $method = $closureMatches[2];
+                $line = $closureMatches[3];
+                
+                // Entferne Namespace
+                $classParts = explode('\\', $fullClass);
+                $shortClass = end($classParts);
+                
+                return sprintf('{closure:%s::%s():%s}', $shortClass, $method, $line);
+            }
+            // Fallback: einfach Namespaces entfernen
+            $closureInfo = preg_replace_callback(
+                '/([A-Z][a-zA-Z0-9_\\\\]*)/',
+                fn($m) => $this->removeNamespaceFromClass($m[0]),
+                $closureInfo
+            );
+            return sprintf('{closure:%s}', $closureInfo);
+        }
+
+        return $function;
+    }
+
+    /**
+     * Entfernt Namespace aus Klassennamen in Strings
+     */
+    private function removeNamespaceFromClass(string $classString): string
+    {
+        // Normalisiere Forward-Slashes zu Backslashes
+        $normalized = str_replace('/', '\\', $classString);
+        $parts = explode('\\', $normalized);
+        return end($parts);
+    }
+
+    /**
+     * Formatiert für Display (HTML/Console)
+     * Verwendet Standard PHP Stack Trace Format: ClassName->methodName($param1, $param2, ...) in file.php:line
+     */
+    public function formatForDisplay(): string
+    {
+        $shortFile = $this->getShortFile();
+        $location = sprintf('%s:%d', $shortFile, $this->line);
+        $params = $this->formatParameters();
+
+        // Wenn Klasse vorhanden
+        if ($this->class !== null && $this->function !== null) {
+            $className = $this->getShortClass();
+            $methodName = $this->formatFunctionName($this->function);
+            $separator = $this->type === '::' ? '::' : '->';
+            $paramsStr = $params !== '' ? $params : '';
+            return sprintf('%s%s%s(%s) in %s', $className, $separator, $methodName, $paramsStr, $location);
+        }
+
+        // Wenn nur Funktion vorhanden
+        if ($this->function !== null) {
+            $methodName = $this->formatFunctionName($this->function);
+            $paramsStr = $params !== '' ? $params : '';
+            return sprintf('%s(%s) in %s', $methodName, $paramsStr, $location);
+        }
+
+        // Wenn weder Klasse noch Funktion
+        return $location;
+    }
+
+    /**
+     * Konvertiert zu Array für JSON-Serialisierung
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        $data = [
+            'file' => $this->getShortFile(),
+            'full_file' => $this->file,
+            'line' => $this->line,
+        ];
+
+        if ($this->function !== null) {
+            $data['function'] = $this->function;
+        }
+
+        if ($this->class !== null) {
+            $data['class'] = $this->getShortClass();
+            $data['full_class'] = $this->class;
+        }
+
+        if ($this->type !== null) {
+            $data['type'] = $this->type;
+        }
+
+        if (!empty($this->args)) {
+            $data['args'] = $this->serializeArgs();
+        }
+
+        return $data;
+    }
+
+    /**
+     * Serialisiert Arguments für Ausgabe
+     *
+     * @return array<int, mixed>
+     */
+    private function serializeArgs(): array
+    {
+        return array_map(
+            fn($arg) => $this->formatValueForOutput($arg),
+            $this->args
+        );
+    }
+
+    /**
+     * Formatiert Wert für Ausgabe (kompaktere Darstellung)
+     */
+    private function formatValueForOutput(mixed $value): mixed
+    {
+        return match (true) {
+            is_array($value) => sprintf('array(%d)', count($value)),
+            is_resource($value) => sprintf('resource(%s)', get_resource_type($value)),
+            is_string($value) && strlen($value) > 100 => substr($value, 0, 100) . '...',
+            default => $value,
+        };
+    }
+}
+
diff --git a/src/Framework/ExceptionHandling/ValueObjects/StackTrace.php b/src/Framework/ExceptionHandling/ValueObjects/StackTrace.php
new file mode 100644
index 00000000..9b119055
--- /dev/null
+++ b/src/Framework/ExceptionHandling/ValueObjects/StackTrace.php
@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ExceptionHandling\ValueObjects;
+
+use IteratorAggregate;
+use Countable;
+use Throwable;
+
+/**
+ * Stack Trace Collection für strukturierte Stack Trace Darstellung
+ *
+ * Enthält eine Sammlung von StackItems und bietet Formatierungsmethoden
+ * für HTML, Console und JSON-Ausgabe.
+ */
+final readonly class StackTrace implements IteratorAggregate, Countable
+{
+    /**
+     * @param StackItem[] $items
+     */
+    public function __construct(
+        private array $items
+    ) {
+    }
+
+    /**
+     * Erstellt StackTrace aus Throwable
+     */
+    public static function fromThrowable(Throwable $exception): self
+    {
+        $items = [];
+        $trace = $exception->getTrace();
+
+        foreach ($trace as $frame) {
+            $items[] = StackItem::fromArray($frame);
+        }
+
+        return new self($items);
+    }
+
+    /**
+     * Begrenzt Anzahl der Frames
+     */
+    public function limit(int $maxFrames): self
+    {
+        return new self(array_slice($this->items, 0, $maxFrames));
+    }
+
+    /**
+     * Formatiert für HTML-Ausgabe
+     */
+    public function formatForHtml(): string
+    {
+        $lines = [];
+        foreach ($this->items as $index => $item) {
+            $formatted = sprintf(
+                '#%d %s',
+                $index,
+                htmlspecialchars($item->formatForDisplay(), ENT_QUOTES | ENT_HTML5, 'UTF-8')
+            );
+            $lines[] = $formatted;
+        }
+
+        return implode("\n", $lines);
+    }
+
+    /**
+     * Formatiert für Console-Ausgabe
+     */
+    public function formatForConsole(): string
+    {
+        $lines = [];
+        foreach ($this->items as $index => $item) {
+            $lines[] = sprintf(
+                '#%d %s',
+                $index,
+                $item->formatForDisplay()
+            );
+        }
+
+        return implode("\n", $lines);
+    }
+
+    /**
+     * Konvertiert zu Array für JSON-Serialisierung
+     *
+     * @return array<int, array<string, mixed>>
+     */
+    public function toArray(): array
+    {
+        return array_map(
+            fn(StackItem $item) => $item->toArray(),
+            $this->items
+        );
+    }
+
+    /**
+     * Gibt alle StackItems zurück
+     *
+     * @return StackItem[]
+     */
+    public function getItems(): array
+    {
+        return $this->items;
+    }
+
+    public function getIterator(): \Traversable
+    {
+        return new \ArrayIterator($this->items);
+    }
+
+    public function count(): int
+    {
+        return count($this->items);
+    }
+}
+
diff --git a/src/Framework/Filesystem/Exceptions/DirectoryCreateException.php b/src/Framework/Filesystem/Exceptions/DirectoryCreateException.php
index c9a1d5a5..1805f5f8 100644
--- a/src/Framework/Filesystem/Exceptions/DirectoryCreateException.php
+++ b/src/Framework/Filesystem/Exceptions/DirectoryCreateException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class DirectoryCreateException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class DirectoryCreateException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('directory.create', 'Filesystem')
-            ->withData(['directory' => $directory]);
-
         parent::__construct(
             message: "Ordner '$directory' konnte nicht angelegt werden.",
-            context: $context,
-            errorCode: FilesystemErrorCode::DIRECTORY_CREATE_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $directory,
+            operation: 'directory.create'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/DirectoryListException.php b/src/Framework/Filesystem/Exceptions/DirectoryListException.php
index 3d70a04f..488b2947 100644
--- a/src/Framework/Filesystem/Exceptions/DirectoryListException.php
+++ b/src/Framework/Filesystem/Exceptions/DirectoryListException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class DirectoryListException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class DirectoryListException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('directory.list', 'Filesystem')
-            ->withData(['directory' => $directory]);
-
         parent::__construct(
             message: "Fehler beim Auslesen des Verzeichnisses '$directory'.",
-            context: $context,
-            errorCode: FilesystemErrorCode::DIRECTORY_LIST_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $directory,
+            operation: 'directory.list'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileCopyException.php b/src/Framework/Filesystem/Exceptions/FileCopyException.php
index d43b7f9c..52d75f84 100644
--- a/src/Framework/Filesystem/Exceptions/FileCopyException.php
+++ b/src/Framework/Filesystem/Exceptions/FileCopyException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileCopyException extends FilesystemException
 {
     public function __construct(
@@ -15,17 +12,12 @@ final class FileCopyException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('file.copy', 'Filesystem')
-            ->withData([
-                'source' => $source,
-                'destination' => $destination,
-            ]);
-
         parent::__construct(
             message: "Fehler beim Kopieren von '$source' nach '$destination'.",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_COPY_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $source,
+            operation: 'file.copy'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileDeleteException.php b/src/Framework/Filesystem/Exceptions/FileDeleteException.php
index 34b27fd4..26214578 100644
--- a/src/Framework/Filesystem/Exceptions/FileDeleteException.php
+++ b/src/Framework/Filesystem/Exceptions/FileDeleteException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileDeleteException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class FileDeleteException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('file.delete', 'Filesystem')
-            ->withData(['path' => $path]);
-
         parent::__construct(
             message: "Fehler beim Löschen der Datei '$path'.",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_DELETE_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: 'file.delete'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileMetadataException.php b/src/Framework/Filesystem/Exceptions/FileMetadataException.php
index 26f7e4dc..bccf838b 100644
--- a/src/Framework/Filesystem/Exceptions/FileMetadataException.php
+++ b/src/Framework/Filesystem/Exceptions/FileMetadataException.php
@@ -4,21 +4,16 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileMetadataException extends FilesystemException
 {
-    public function __construct(string $path, ?\Throwable $previous = null)
+    public function __construct(string $path, int $code = 0, ?\Throwable $previous = null)
     {
-        $context = ExceptionContext::forOperation('file.metadata', 'Filesystem')
-            ->withData(['path' => $path]);
-
         parent::__construct(
             message: "Konnte Metadaten für Datei '{$path}' nicht lesen",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_METADATA_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: 'file.metadata'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileNotFoundException.php b/src/Framework/Filesystem/Exceptions/FileNotFoundException.php
index 74ef462e..03dfd080 100644
--- a/src/Framework/Filesystem/Exceptions/FileNotFoundException.php
+++ b/src/Framework/Filesystem/Exceptions/FileNotFoundException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileNotFoundException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class FileNotFoundException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('file.read', 'Filesystem')
-            ->withData(['path' => $path]);
-
         parent::__construct(
             message: "Datei '$path' nicht gefunden.",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_NOT_FOUND,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: 'file.read'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FilePermissionException.php b/src/Framework/Filesystem/Exceptions/FilePermissionException.php
index 3349082f..96393488 100644
--- a/src/Framework/Filesystem/Exceptions/FilePermissionException.php
+++ b/src/Framework/Filesystem/Exceptions/FilePermissionException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Filesystem\PermissionChecker;
 use App\Framework\Filesystem\ValueObjects\FileOwnership;
 use App\Framework\Filesystem\ValueObjects\ProcessUser;
@@ -23,32 +21,9 @@ final class FilePermissionException extends FilesystemException
     ) {
         $message = $this->buildMessage($path, $operation, $reason, $diagnosticInfo, $currentUser, $fileOwnership, $parentOwnership);
 
-        $context = ExceptionContext::forOperation('file.permission', 'filesystem')
-            ->withData([
-                'path' => $path,
-                'operation' => $operation,
-                'reason' => $reason,
-            ])
-            ->withDebug([
-                'file_permissions' => $diagnosticInfo['permissions'] ?? null,
-                'file_owner' => $diagnosticInfo['owner'] ?? null,
-                'file_group' => $diagnosticInfo['group'] ?? null,
-                'file_exists' => $diagnosticInfo['exists'] ?? null,
-                'is_file' => $diagnosticInfo['is_file'] ?? null,
-                'is_dir' => $diagnosticInfo['is_dir'] ?? null,
-                'parent_dir' => $diagnosticInfo['parent_dir'] ?? null,
-                'parent_writable' => $diagnosticInfo['parent_writable'] ?? null,
-            ])
-            ->withMetadata([
-                'current_user' => $currentUser?->toArray(),
-                'file_ownership' => $fileOwnership?->toArray(),
-                'parent_ownership' => $parentOwnership?->toArray(),
-            ]);
-
         parent::__construct(
-            message: $message,
-            context: $context,
-            errorCode: FilesystemErrorCode::PERMISSION_DENIED
+            $message,
+            403 // Forbidden
         );
     }
 
diff --git a/src/Framework/Filesystem/Exceptions/FileReadException.php b/src/Framework/Filesystem/Exceptions/FileReadException.php
index 8ea0cb2f..23b599d4 100644
--- a/src/Framework/Filesystem/Exceptions/FileReadException.php
+++ b/src/Framework/Filesystem/Exceptions/FileReadException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileReadException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class FileReadException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('file.read', 'Filesystem')
-            ->withData(['path' => $path]);
-
         parent::__construct(
             message: "Lesefehler bei '$path'.",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_READ_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: 'file.read'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileValidationException.php b/src/Framework/Filesystem/Exceptions/FileValidationException.php
index 7a710d3d..492f6022 100644
--- a/src/Framework/Filesystem/Exceptions/FileValidationException.php
+++ b/src/Framework/Filesystem/Exceptions/FileValidationException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception für File-Validation Errors
  *
@@ -21,13 +18,13 @@ final class FileValidationException extends FilesystemException
     public static function invalidPath(
         string $path,
         string $reason,
-        FilesystemErrorCode $errorCode = FilesystemErrorCode::INVALID_PATH
+        int $code = 0
     ): self {
         return self::forPath(
             path: $path,
             message: $reason,
-            errorCode: $errorCode,
-            operation: 'file.validation.path'
+            operation: 'file.validation.path',
+            code: $code
         );
     }
 
@@ -39,19 +36,10 @@ final class FileValidationException extends FilesystemException
         string $extension,
         array $allowedExtensions
     ): self {
-        $context = ExceptionContext::forOperation(
-            'file.validation.extension',
-            'FileValidator'
-        )->withData([
-            'path' => $path,
-            'extension' => $extension,
-            'allowed_extensions' => $allowedExtensions,
-        ]);
-
-        return self::fromContext(
-            "File extension '.{$extension}' is not allowed",
-            $context,
-            FilesystemErrorCode::INVALID_PATH
+        return self::forPath(
+            path: $path,
+            message: "File extension '.{$extension}' is not allowed",
+            operation: 'file.validation.extension'
         );
     }
 
@@ -63,19 +51,10 @@ final class FileValidationException extends FilesystemException
         string $extension,
         array $blockedExtensions
     ): self {
-        $context = ExceptionContext::forOperation(
-            'file.validation.extension',
-            'FileValidator'
-        )->withData([
-            'path' => $path,
-            'extension' => $extension,
-            'blocked_extensions' => $blockedExtensions,
-        ]);
-
-        return self::fromContext(
-            "File extension '.{$extension}' is blocked",
-            $context,
-            FilesystemErrorCode::INVALID_PATH
+        return self::forPath(
+            path: $path,
+            message: "File extension '.{$extension}' is blocked",
+            operation: 'file.validation.extension'
         );
     }
 
@@ -88,20 +67,9 @@ final class FileValidationException extends FilesystemException
         int $fileSizeBytes,
         int $maxSizeBytes
     ): self {
-        $context = ExceptionContext::forOperation(
-            'file.validation.size',
-            'FileValidator'
-        )->withData([
-            'file_size' => $fileSizeHuman,
-            'max_size' => $maxSizeHuman,
-            'file_size_bytes' => $fileSizeBytes,
-            'max_size_bytes' => $maxSizeBytes,
-        ]);
-
-        return self::fromContext(
-            'File size exceeds maximum allowed size',
-            $context,
-            FilesystemErrorCode::INVALID_PATH
+        return new self(
+            message: "File size {$fileSizeHuman} exceeds maximum allowed size {$maxSizeHuman}",
+            operation: 'file.validation.size'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FileWriteException.php b/src/Framework/Filesystem/Exceptions/FileWriteException.php
index 17a74e93..0be84c0a 100644
--- a/src/Framework/Filesystem/Exceptions/FileWriteException.php
+++ b/src/Framework/Filesystem/Exceptions/FileWriteException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 final class FileWriteException extends FilesystemException
 {
     public function __construct(
@@ -14,14 +11,12 @@ final class FileWriteException extends FilesystemException
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('file.write', 'Filesystem')
-            ->withData(['path' => $path]);
-
         parent::__construct(
             message: "Fehler beim Schreiben in '$path'.",
-            context: $context,
-            errorCode: FilesystemErrorCode::FILE_WRITE_FAILED,
-            previous: $previous
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: 'file.write'
         );
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/FilesystemException.php b/src/Framework/Filesystem/Exceptions/FilesystemException.php
index 7e79d4e6..810e84ec 100644
--- a/src/Framework/Filesystem/Exceptions/FilesystemException.php
+++ b/src/Framework/Filesystem/Exceptions/FilesystemException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,25 +13,33 @@ use App\Framework\Exception\FrameworkException;
  */
 abstract class FilesystemException extends FrameworkException
 {
+    public function __construct(
+        string $message = '',
+        int $code = 0,
+        ?\Throwable $previous = null,
+        protected readonly ?string $path = null,
+        protected readonly ?string $operation = null
+    ) {
+        parent::__construct($message, $code, $previous);
+    }
+
     /**
      * Create exception for a file operation
      */
     public static function forPath(
         string $path,
         string $message,
-        FilesystemErrorCode $errorCode,
         ?string $operation = null,
+        int $code = 0,
         ?\Throwable $previous = null
     ): static {
-        $context = ExceptionContext::forOperation(
-            $operation ?? 'filesystem.operation',
-            'Filesystem'
-        )->withData([
-            'path' => $path,
-            'operation' => $operation,
-        ]);
-
-        return static::fromContext($message, $context, $errorCode, previous: $previous);
+        return new static(
+            message: $message,
+            code: $code,
+            previous: $previous,
+            path: $path,
+            operation: $operation ?? 'filesystem.operation'
+        );
     }
 
     /**
@@ -41,12 +47,11 @@ abstract class FilesystemException extends FrameworkException
      */
     public static function forFile(
         string $path,
-        FilesystemErrorCode $errorCode,
+        string $message,
         ?string $reason = null,
+        int $code = 0,
         ?\Throwable $previous = null
     ): static {
-        $message = $errorCode->getDescription();
-
         if ($reason) {
             $message .= ": {$reason}";
         }
@@ -54,8 +59,8 @@ abstract class FilesystemException extends FrameworkException
         return static::forPath(
             $path,
             $message,
-            $errorCode,
             'file.operation',
+            $code,
             $previous
         );
     }
@@ -65,12 +70,11 @@ abstract class FilesystemException extends FrameworkException
      */
     public static function forDirectory(
         string $path,
-        FilesystemErrorCode $errorCode,
+        string $message,
         ?string $reason = null,
+        int $code = 0,
         ?\Throwable $previous = null
     ): static {
-        $message = $errorCode->getDescription();
-
         if ($reason) {
             $message .= ": {$reason}";
         }
@@ -78,18 +82,18 @@ abstract class FilesystemException extends FrameworkException
         return static::forPath(
             $path,
             $message,
-            $errorCode,
             'directory.operation',
+            $code,
             $previous
         );
     }
 
     /**
-     * Get the file path from exception context
+     * Get the file path
      */
     public function getPath(): ?string
     {
-        return $this->context->data['path'] ?? null;
+        return $this->path;
     }
 
     /**
@@ -97,6 +101,6 @@ abstract class FilesystemException extends FrameworkException
      */
     public function getOperation(): ?string
     {
-        return $this->context->data['operation'] ?? null;
+        return $this->operation;
     }
 }
diff --git a/src/Framework/Filesystem/Exceptions/SerializerNotFoundException.php b/src/Framework/Filesystem/Exceptions/SerializerNotFoundException.php
index 01ac63f5..89e4a651 100644
--- a/src/Framework/Filesystem/Exceptions/SerializerNotFoundException.php
+++ b/src/Framework/Filesystem/Exceptions/SerializerNotFoundException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Filesystem\Exceptions;
 
-use App\Framework\Exception\Core\FilesystemErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception wenn ein Serializer nicht gefunden wurde
  */
@@ -14,60 +11,42 @@ final class SerializerNotFoundException extends FilesystemException
 {
     public static function byName(string $name): self
     {
-        $context = ExceptionContext::forOperation('serializer.lookup', 'SerializerRegistry')
-            ->withData(['serializer_name' => $name]);
-
-        return self::fromContext(
-            "Serializer '{$name}' not found in registry",
-            $context,
-            FilesystemErrorCode::SERIALIZER_NOT_FOUND
+        return new self(
+            message: "Serializer '{$name}' not found in registry",
+            operation: 'serializer.lookup'
         );
     }
 
     public static function byExtension(string $extension): self
     {
-        $context = ExceptionContext::forOperation('serializer.lookup.extension', 'SerializerRegistry')
-            ->withData(['file_extension' => $extension]);
-
-        return self::fromContext(
-            "No serializer found for extension '.{$extension}'",
-            $context,
-            FilesystemErrorCode::SERIALIZER_NOT_FOUND
+        return new self(
+            message: "No serializer found for extension '.{$extension}'",
+            operation: 'serializer.lookup.extension'
         );
     }
 
     public static function byMimeType(string $mimeType): self
     {
-        $context = ExceptionContext::forOperation('serializer.lookup.mimetype', 'SerializerRegistry')
-            ->withData(['mime_type' => $mimeType]);
-
-        return self::fromContext(
-            "No serializer found for MIME type '{$mimeType}'",
-            $context,
-            FilesystemErrorCode::SERIALIZER_NOT_FOUND
+        return new self(
+            message: "No serializer found for MIME type '{$mimeType}'",
+            operation: 'serializer.lookup.mimetype'
         );
     }
 
     public static function noExtensionInPath(string $path): self
     {
-        $context = ExceptionContext::forOperation('serializer.detect', 'SerializerRegistry')
-            ->withData(['path' => $path]);
-
-        return self::fromContext(
-            "Cannot detect serializer: No file extension in path '{$path}'",
-            $context,
-            FilesystemErrorCode::SERIALIZER_NOT_FOUND
+        return new self(
+            message: "Cannot detect serializer: No file extension in path '{$path}'",
+            path: $path,
+            operation: 'serializer.detect'
         );
     }
 
     public static function noDefault(): self
     {
-        $context = ExceptionContext::forOperation('serializer.get_default', 'SerializerRegistry');
-
-        return self::fromContext(
-            'No default serializer configured in registry',
-            $context,
-            FilesystemErrorCode::SERIALIZER_NOT_FOUND
+        return new self(
+            message: 'No default serializer configured in registry',
+            operation: 'serializer.get_default'
         );
     }
 }
diff --git a/src/Framework/Health/Checks/CacheHealthCheck.php b/src/Framework/Health/Checks/CacheHealthCheck.php
index cb666a96..8e21b896 100644
--- a/src/Framework/Health/Checks/CacheHealthCheck.php
+++ b/src/Framework/Health/Checks/CacheHealthCheck.php
@@ -14,9 +14,17 @@ use App\Framework\Health\HealthCheckResult;
 
 final readonly class CacheHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Cache System';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private Cache $cache
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -40,7 +48,7 @@ final readonly class CacheHealthCheck implements HealthCheckInterface
 
             if ($cachedValue->isHit && $cachedValue->value === $testValue) {
                 return HealthCheckResult::healthy(
-                    'Cache',
+                    self::NAME,
                     [
                         'operations' => ['set', 'get', 'delete'],
                         'response_time_ms' => round($responseTime * 1000, 2),
@@ -50,7 +58,7 @@ final readonly class CacheHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::warning(
-                'Cache',
+                self::NAME,
                 'Operations partially failed',
                 [
                     'hit' => $cachedValue->isHit,
@@ -63,7 +71,7 @@ final readonly class CacheHealthCheck implements HealthCheckInterface
             $responseTime = microtime(true) - $startTime;
 
             return HealthCheckResult::unhealthy(
-                'Cache',
+                self::NAME,
                 'System failed: ' . $e->getMessage(),
                 [],
                 $responseTime * 1000,
@@ -72,18 +80,8 @@ final readonly class CacheHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'Cache System';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::CACHE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds
-    }
 }
diff --git a/src/Framework/Health/Checks/DatabaseHealthCheck.php b/src/Framework/Health/Checks/DatabaseHealthCheck.php
index 4ebae18e..941c0ed8 100644
--- a/src/Framework/Health/Checks/DatabaseHealthCheck.php
+++ b/src/Framework/Health/Checks/DatabaseHealthCheck.php
@@ -13,9 +13,17 @@ use App\Framework\Health\HealthCheckResult;
 
 final readonly class DatabaseHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Database Connection';
+    private const int TIMEOUT_MS = 5000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private DatabaseManager $databaseManager
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -36,7 +44,7 @@ final readonly class DatabaseHealthCheck implements HealthCheckInterface
 
             if ($value == 1 || $value === '1') {
                 return HealthCheckResult::healthy(
-                    'Database',
+                    self::NAME,
                     [
                         'query_time' => $responseTime->toHumanReadable(),
                         'query_time_ms' => $responseTime->toMilliseconds(),
@@ -46,7 +54,7 @@ final readonly class DatabaseHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::unhealthy(
-                'Database',
+                self::NAME,
                 'Query returned unexpected result',
                 [
                     'expected' => 1,
@@ -62,7 +70,7 @@ final readonly class DatabaseHealthCheck implements HealthCheckInterface
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'Database',
+                self::NAME,
                 'Connection failed: ' . $e->getMessage(),
                 [],
                 $responseTime->toMilliseconds(),
@@ -71,18 +79,8 @@ final readonly class DatabaseHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'Database Connection';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::DATABASE;
     }
-
-    public function getTimeout(): int
-    {
-        return 5000; // 5 seconds
-    }
 }
diff --git a/src/Framework/Health/Checks/DiskSpaceHealthCheck.php b/src/Framework/Health/Checks/DiskSpaceHealthCheck.php
index ff23fd84..66baba52 100644
--- a/src/Framework/Health/Checks/DiskSpaceHealthCheck.php
+++ b/src/Framework/Health/Checks/DiskSpaceHealthCheck.php
@@ -12,11 +12,19 @@ use App\Framework\Health\HealthCheckResult;
 
 final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Disk Space';
+    private const int TIMEOUT_MS = 2000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private string $path = '/',
         private int $warningThreshold = 85, // Warn at 85% usage
         private int $criticalThreshold = 95  // Critical at 95% usage
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -29,7 +37,7 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
 
             if ($freeBytes === false || $totalBytes === false) {
                 return HealthCheckResult::unhealthy(
-                    'Disk Space',
+                    self::NAME,
                     'Could not retrieve disk space information',
                     ['path' => $this->path]
                 );
@@ -53,7 +61,7 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
 
             if ($usagePercentage->getValue() >= $this->criticalThreshold) {
                 return HealthCheckResult::unhealthy(
-                    'Disk Space',
+                    self::NAME,
                     "Critically low: {$usagePercentage->format()} used",
                     $details,
                     $responseTime->toMilliseconds()
@@ -62,7 +70,7 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
 
             if ($usagePercentage->getValue() >= $this->warningThreshold) {
                 return HealthCheckResult::warning(
-                    'Disk Space',
+                    self::NAME,
                     "Warning: {$usagePercentage->format()} used",
                     $details,
                     $responseTime->toMilliseconds()
@@ -70,7 +78,7 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::healthy(
-                'Disk Space',
+                self::NAME,
                 $details,
                 $responseTime->toMilliseconds()
             );
@@ -79,7 +87,7 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'Disk Space',
+                self::NAME,
                 'Check failed: ' . $e->getMessage(),
                 ['path' => $this->path],
                 $responseTime->toMilliseconds(),
@@ -88,18 +96,8 @@ final readonly class DiskSpaceHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'Disk Space';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::STORAGE;
     }
-
-    public function getTimeout(): int
-    {
-        return 2000; // 2 seconds
-    }
 }
diff --git a/src/Framework/Health/Checks/QueueHealthCheck.php b/src/Framework/Health/Checks/QueueHealthCheck.php
index fb6e85bd..cb535e33 100644
--- a/src/Framework/Health/Checks/QueueHealthCheck.php
+++ b/src/Framework/Health/Checks/QueueHealthCheck.php
@@ -12,9 +12,17 @@ use App\Framework\Queue\Queue;
 
 final readonly class QueueHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Queue System';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private Queue $queue
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -53,7 +61,7 @@ final readonly class QueueHealthCheck implements HealthCheckInterface
 
             if (!empty($warnings)) {
                 return HealthCheckResult::warning(
-                    'Queue System',
+                    self::NAME,
                     implode(', ', $warnings),
                     $data,
                     $responseTime->toMilliseconds()
@@ -61,7 +69,7 @@ final readonly class QueueHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::healthy(
-                'Queue System',
+                self::NAME,
                 $data,
                 $responseTime->toMilliseconds()
             );
@@ -70,7 +78,7 @@ final readonly class QueueHealthCheck implements HealthCheckInterface
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'Queue System',
+                self::NAME,
                 'Queue system failed: ' . $e->getMessage(),
                 [
                     'error_type' => get_class($e),
@@ -81,18 +89,8 @@ final readonly class QueueHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'Queue System';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds
-    }
 }
diff --git a/src/Framework/Health/Checks/SslHealthCheck.php b/src/Framework/Health/Checks/SslHealthCheck.php
index a216344f..2a4758ec 100644
--- a/src/Framework/Health/Checks/SslHealthCheck.php
+++ b/src/Framework/Health/Checks/SslHealthCheck.php
@@ -12,9 +12,17 @@ use App\Framework\Health\HealthCheckResult;
 
 final readonly class SslHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'SSL Certificate';
+    private const int TIMEOUT_MS = 5000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private SslCertificateManager $sslManager
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -36,7 +44,7 @@ final readonly class SslHealthCheck implements HealthCheckInterface
             // Certificate expired or expiring soon
             if (!$status->isValid()) {
                 return HealthCheckResult::unhealthy(
-                    'SSL Certificate',
+                    self::NAME,
                     'Certificate is invalid or expired',
                     $data,
                     $responseTime->toMilliseconds()
@@ -46,7 +54,7 @@ final readonly class SslHealthCheck implements HealthCheckInterface
             // Warning if expiring within 7 days
             if ($status->getDaysUntilExpiry() <= 7) {
                 return HealthCheckResult::warning(
-                    'SSL Certificate',
+                    self::NAME,
                     "Certificate expiring in {$status->getDaysUntilExpiry()} days",
                     $data,
                     $responseTime->toMilliseconds()
@@ -56,24 +64,20 @@ final readonly class SslHealthCheck implements HealthCheckInterface
             // Warning if expiring within 30 days
             if ($status->getDaysUntilExpiry() <= 30) {
                 return HealthCheckResult::warning(
-                    'SSL Certificate',
+                    self::NAME,
                     "Certificate expiring in {$status->getDaysUntilExpiry()} days (renewal recommended)",
                     $data,
                     $responseTime->toMilliseconds()
                 );
             }
 
-            return HealthCheckResult::healthy(
-                'SSL Certificate',
-                $data,
-                $responseTime->toMilliseconds()
-            );
+            return HealthCheckResult::healthy(self::NAME, $data, $responseTime->toMilliseconds());
 
         } catch (\Throwable $e) {
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'SSL Certificate',
+                self::NAME,
                 'SSL check failed: ' . $e->getMessage(),
                 [
                     'error_type' => get_class($e),
@@ -84,18 +88,8 @@ final readonly class SslHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'SSL Certificate';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::SECURITY;
     }
-
-    public function getTimeout(): int
-    {
-        return 5000; // 5 seconds
-    }
 }
diff --git a/src/Framework/Health/Checks/SystemHealthCheck.php b/src/Framework/Health/Checks/SystemHealthCheck.php
index ad38ba05..c3d2ce24 100644
--- a/src/Framework/Health/Checks/SystemHealthCheck.php
+++ b/src/Framework/Health/Checks/SystemHealthCheck.php
@@ -13,10 +13,18 @@ use App\Framework\Health\HealthCheckResult;
 
 final readonly class SystemHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'System Resources';
+    private const int TIMEOUT_MS = 1000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private int $memoryWarningThreshold = 85, // Warn at 85% memory usage
         private int $memoryCriticalThreshold = 95  // Critical at 95% memory usage
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -52,7 +60,7 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
             if (! $memoryLimit->isEmpty()) {
                 if ($memoryUsagePercentage->getValue() >= $this->memoryCriticalThreshold) {
                     return HealthCheckResult::unhealthy(
-                        'System',
+                        self::NAME,
                         "Critical memory usage: {$memoryUsagePercentage->format()}",
                         $details,
                         $responseTime->toMilliseconds()
@@ -61,7 +69,7 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
 
                 if ($memoryUsagePercentage->getValue() >= $this->memoryWarningThreshold) {
                     return HealthCheckResult::warning(
-                        'System',
+                        self::NAME,
                         "High memory usage: {$memoryUsagePercentage->format()}",
                         $details,
                         $responseTime->toMilliseconds()
@@ -73,7 +81,7 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
             $missingExtensions = array_diff(['json', 'mbstring'], $phpExtensions);
             if (! empty($missingExtensions)) {
                 return HealthCheckResult::unhealthy(
-                    'System',
+                    self::NAME,
                     'Critical PHP extensions missing: ' . implode(', ', $missingExtensions),
                     $details,
                     $responseTime->toMilliseconds()
@@ -81,7 +89,7 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::healthy(
-                'System',
+                self::NAME,
                 $details,
                 $responseTime->toMilliseconds()
             );
@@ -90,7 +98,7 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'System',
+                self::NAME,
                 'Health check failed: ' . $e->getMessage(),
                 [],
                 $responseTime->toMilliseconds(),
@@ -126,18 +134,8 @@ final readonly class SystemHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'System Resources';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::SYSTEM;
     }
-
-    public function getTimeout(): int
-    {
-        return 1000; // 1 second
-    }
 }
diff --git a/src/Framework/Health/Checks/VaultHealthCheck.php b/src/Framework/Health/Checks/VaultHealthCheck.php
index bc5ecad8..cfcd3c2a 100644
--- a/src/Framework/Health/Checks/VaultHealthCheck.php
+++ b/src/Framework/Health/Checks/VaultHealthCheck.php
@@ -13,9 +13,17 @@ use App\Framework\Vault\ValueObjects\SecretKey;
 
 final readonly class VaultHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'Vault Secrets Management';
+    private const int TIMEOUT_MS = 5000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     public function __construct(
         private Vault $vault
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -42,7 +50,7 @@ final readonly class VaultHealthCheck implements HealthCheckInterface
             // Verify value matches
             if ($retrievedValue->reveal() === $testValue) {
                 return HealthCheckResult::healthy(
-                    'Vault',
+                    self::NAME,
                     [
                         'operations' => ['set', 'get', 'delete'],
                         'encryption' => 'working',
@@ -53,7 +61,7 @@ final readonly class VaultHealthCheck implements HealthCheckInterface
             }
 
             return HealthCheckResult::warning(
-                'Vault',
+                self::NAME,
                 'Encryption/decryption mismatch',
                 [
                     'expected_length' => strlen($testValue),
@@ -66,7 +74,7 @@ final readonly class VaultHealthCheck implements HealthCheckInterface
             $responseTime = Duration::fromSeconds(microtime(true) - $startTime);
 
             return HealthCheckResult::unhealthy(
-                'Vault',
+                self::NAME,
                 'Vault system failed: ' . $e->getMessage(),
                 [
                     'error_type' => get_class($e),
@@ -77,18 +85,8 @@ final readonly class VaultHealthCheck implements HealthCheckInterface
         }
     }
 
-    public function getName(): string
-    {
-        return 'Vault Secrets Management';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::SECURITY;
     }
-
-    public function getTimeout(): int
-    {
-        return 5000; // 5 seconds
-    }
 }
diff --git a/src/Framework/Health/HealthCheckInterface.php b/src/Framework/Health/HealthCheckInterface.php
index ac8af54e..51db6d43 100644
--- a/src/Framework/Health/HealthCheckInterface.php
+++ b/src/Framework/Health/HealthCheckInterface.php
@@ -4,25 +4,38 @@ declare(strict_types=1);
 
 namespace App\Framework\Health;
 
+/**
+ * Health Check Interface
+ *
+ * Defines contract for health checks with Property Hooks for type safety.
+ * Implementing classes must provide readonly properties $name and $timeout.
+ *
+ * Property Hooks ensure that implementing classes have the required properties
+ * while maintaining backward compatibility with method-based access.
+ */
 interface HealthCheckInterface
 {
+    /**
+     * Health check name (Property Hook)
+     *
+     * Implementing classes must provide: public readonly string $name;
+     */
+    public string $name { get; }
+
+    /**
+     * Timeout in milliseconds (Property Hook)
+     *
+     * Implementing classes must provide: public readonly int $timeout;
+     */
+    public int $timeout { get; }
+
     /**
      * Perform the health check
      */
     public function check(): HealthCheckResult;
 
-    /**
-     * Get the name of this health check
-     */
-    public function getName(): string;
-
     /**
      * Get the category of this health check
      */
     public function getCategory(): HealthCheckCategory;
-
-    /**
-     * Get the timeout for this health check in milliseconds
-     */
-    public function getTimeout(): int;
 }
diff --git a/src/Framework/Health/HealthCheckManager.php b/src/Framework/Health/HealthCheckManager.php
index 5b476a9f..ac879054 100644
--- a/src/Framework/Health/HealthCheckManager.php
+++ b/src/Framework/Health/HealthCheckManager.php
@@ -16,7 +16,7 @@ final class HealthCheckManager
 
     public function registerHealthCheck(HealthCheckInterface $healthCheck): void
     {
-        $this->healthChecks[$healthCheck->getName()] = $healthCheck;
+        $this->healthChecks[$healthCheck->name] = $healthCheck;
     }
 
     public function runAllChecks(): HealthReport
@@ -78,7 +78,7 @@ final class HealthCheckManager
 
     private function runSingleCheck(HealthCheckInterface $healthCheck): HealthCheckResult
     {
-        $timeout = $healthCheck->getTimeout() / 1000; // Convert to seconds
+        $timeout = $healthCheck->timeout / 1000; // Convert to seconds
 
         // Simple timeout implementation
         $startTime = microtime(true);
@@ -87,7 +87,7 @@ final class HealthCheckManager
 
         if ($elapsed > $timeout) {
             return HealthCheckResult::warning(
-                "Health check '{$healthCheck->getName()}' exceeded timeout ({$timeout}s)",
+                "Health check '{$healthCheck->name}' exceeded timeout ({$timeout}s)",
                 ['elapsed_time' => $elapsed, 'timeout' => $timeout]
             );
         }
@@ -108,8 +108,8 @@ final class HealthCheckManager
             $category = $healthCheck->getCategory()->value;
             $categorized[$category][] = [
                 'name' => $name,
-                'display_name' => $healthCheck->getName(),
-                'timeout' => $healthCheck->getTimeout(),
+                'display_name' => $healthCheck->name,
+                'timeout' => $healthCheck->timeout,
             ];
         }
 
diff --git a/src/Framework/Http/Exceptions/MiddlewareTimeoutException.php b/src/Framework/Http/Exceptions/MiddlewareTimeoutException.php
index d104e2e3..f5fd12c3 100644
--- a/src/Framework/Http/Exceptions/MiddlewareTimeoutException.php
+++ b/src/Framework/Http/Exceptions/MiddlewareTimeoutException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Http\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -24,13 +23,6 @@ final class MiddlewareTimeoutException extends FrameworkException
             $timeout
         );
 
-        $context = ExceptionContext::empty()
-            ->withData([
-                'middleware_name' => $middlewareName,
-                'timeout' => $timeout,
-                'error_type' => 'middleware_timeout',
-            ]);
-
-        parent::__construct($message, $context, $code, $previous);
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/Http/MiddlewareDependencyException.php b/src/Framework/Http/MiddlewareDependencyException.php
index 59dddfb0..5e7d5d07 100644
--- a/src/Framework/Http/MiddlewareDependencyException.php
+++ b/src/Framework/Http/MiddlewareDependencyException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Http;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -21,16 +20,11 @@ final class MiddlewareDependencyException extends FrameworkException
         string $message,
         private readonly ClassName $middlewareClass,
         private readonly array $missingDependencies = [],
-        private readonly array $middlewareContext = []
+        private readonly array $middlewareContext = [],
+        int $code = 0,
+        ?\Throwable $previous = null
     ) {
-        $exceptionContext = ExceptionContext::forOperation('middleware.dependency', 'http')
-            ->withData([
-                'middleware_class' => $middlewareClass->toString(),
-                'missing_dependencies' => array_map(fn ($dep) => $dep->toString(), $missingDependencies),
-                'context' => $this->middlewareContext,
-            ]);
-
-        parent::__construct($message, $exceptionContext);
+        parent::__construct($message, $code, $previous);
     }
 
     public function getMiddlewareClass(): ClassName
diff --git a/src/Framework/Http/MiddlewareDependencyResolver.php b/src/Framework/Http/MiddlewareDependencyResolver.php
index 0b665dbf..787ee08a 100644
--- a/src/Framework/Http/MiddlewareDependencyResolver.php
+++ b/src/Framework/Http/MiddlewareDependencyResolver.php
@@ -8,7 +8,7 @@ use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\MethodName;
 use App\Framework\DI\Container;
 use App\Framework\Logging\Logger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
 
 /**
  * Resolves middleware dependencies by analyzing constructor parameters
@@ -31,7 +31,7 @@ final readonly class MiddlewareDependencyResolver
     ];
 
     public function __construct(
-        private ReflectionProvider $reflectionProvider,
+        private ReflectionService $reflectionService,
         private Container $container,
         private Logger $logger
     ) {
@@ -174,7 +174,7 @@ final readonly class MiddlewareDependencyResolver
             }
 
             $dependencies = [];
-            $parameterCollection = $this->reflectionProvider->getMethodParameters(
+            $parameterCollection = $this->reflectionService->getMethodParameters(
                 $middlewareClass,
                 '__construct'
             );
@@ -217,7 +217,7 @@ final readonly class MiddlewareDependencyResolver
             }
 
             $services = [];
-            $parameterCollection = $this->reflectionProvider->getMethodParameters(
+            $parameterCollection = $this->reflectionService->getMethodParameters(
                 $middlewareClass,
                 '__construct'
             );
@@ -294,7 +294,7 @@ final readonly class MiddlewareDependencyResolver
             }
 
             $optional = [];
-            $parameterCollection = $this->reflectionProvider->getMethodParameters(
+            $parameterCollection = $this->reflectionService->getMethodParameters(
                 $middlewareClass,
                 '__construct'
             );
@@ -328,7 +328,7 @@ final readonly class MiddlewareDependencyResolver
                 return false;
             }
 
-            return $this->reflectionProvider->implementsInterface(
+            return $this->reflectionService->implementsInterface(
                 $className,
                 HttpMiddleware::class
             );
@@ -454,14 +454,14 @@ final readonly class MiddlewareDependencyResolver
     {
         try {
             // Strategy 1: Try basic instantiation without dependency checking
-            if ($this->reflectionProvider->isInstantiable($className)) {
+            if ($this->reflectionService->isInstantiable($className)) {
                 $this->logger->debug("Fallback strategy 1 (basic instantiation) succeeded for {$className->getShortName()}");
 
                 return true;
             }
 
             // Strategy 2: Check if we can provide minimal dependencies
-            $parameterCollection = $this->reflectionProvider->getMethodParameters(
+            $parameterCollection = $this->reflectionService->getMethodParameters(
                 $className,
                 '__construct'
             );
@@ -517,7 +517,7 @@ final readonly class MiddlewareDependencyResolver
             }
 
             // Check if class is instantiable
-            if (! $this->reflectionProvider->isInstantiable($middlewareClass)) {
+            if (! $this->reflectionService->isInstantiable($middlewareClass)) {
                 $this->logger->warning("Class is not instantiable: {$middlewareClass->getShortName()}");
 
                 return false;
@@ -552,7 +552,7 @@ final readonly class MiddlewareDependencyResolver
     private function checkDependenciesManually(ClassName $middlewareClass): bool
     {
         try {
-            $parameterCollection = $this->reflectionProvider->getMethodParameters(
+            $parameterCollection = $this->reflectionService->getMethodParameters(
                 $middlewareClass,
                 '__construct'
             );
@@ -639,7 +639,7 @@ final readonly class MiddlewareDependencyResolver
                     'short_name' => $middlewareClass->getShortName(),
                     'namespace' => $middlewareClass->getNamespace(),
                     'exists' => $middlewareClass->exists(),
-                    'is_instantiable' => $this->reflectionProvider->isInstantiable($middlewareClass),
+                    'is_instantiable' => $this->reflectionService->isInstantiable($middlewareClass),
                     'is_critical' => $this->isCriticalMiddleware($middlewareClass),
                     'middleware_dependencies' => $this->getMiddlewareDependencies($middlewareClass),
                     'service_dependencies' => $this->getServiceDependencies($middlewareClass),
diff --git a/src/Framework/Http/MiddlewareManager.php b/src/Framework/Http/MiddlewareManager.php
index f880eed8..ef966a48 100644
--- a/src/Framework/Http/MiddlewareManager.php
+++ b/src/Framework/Http/MiddlewareManager.php
@@ -15,7 +15,7 @@ use App\Framework\Http\Middlewares\RateLimitMiddleware;
 use App\Framework\Http\Middlewares\WafMiddleware;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
 
 final readonly class MiddlewareManager implements MiddlewareManagerInterface
 {
@@ -24,7 +24,7 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
     public function __construct(
         private Container        $container,
         private DiscoveryRegistry $discoveryRegistry,
-        private ReflectionProvider $reflectionProvider,
+        private ReflectionService $reflectionService,
         private Cache $cache,
     ) {
         $middlewares = $this->buildMiddlewareStack();
@@ -60,6 +60,9 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
             // 0. Exception Handling - MUSS absolut zuerst kommen, um alle Exceptions zu fangen
             \App\Framework\Http\Middlewares\ExceptionHandlingMiddleware::class,
 
+            // 0.1. Error Scope - Automatisches Scope-Management für Exception-Kontext
+            \App\Framework\ExceptionHandling\Middleware\ErrorScopeMiddleware::class,
+
             // 1. System und Error Handling
             \App\Framework\Http\Middlewares\RequestIdMiddleware::class,
 
@@ -142,7 +145,7 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
     {
         $logger = $this->container->get(Logger::class);
         $resolver = new MiddlewareDependencyResolver(
-            $this->reflectionProvider,
+            $this->reflectionService,
             $this->container,
             $logger
         );
@@ -180,7 +183,7 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
 
         $logger = $this->container->get(Logger::class);
         $resolver = new MiddlewareDependencyResolver(
-            $this->reflectionProvider,
+            $this->reflectionService,
             $this->container,
             $logger
         );
@@ -263,7 +266,8 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
     {
         try {
             $classNameObj = ClassName::create($className);
-            $attrs = $this->reflectionProvider->getAttributes($classNameObj, MiddlewarePriorityAttribute::class);
+            $classInfo = $this->reflectionService->reflectClass($classNameObj);
+            $attrs = $classInfo->getAttributes(MiddlewarePriorityAttribute::class);
 
             if ($attrs->count() > 0) {
                 /** @var MiddlewarePriorityAttribute|null $attr */
@@ -376,7 +380,7 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
     {
         return [
             'cache_implementation' => get_class($this->cache),
-            'reflection_provider' => get_class($this->reflectionProvider),
+            'reflection_service' => get_class($this->reflectionService),
         ];
     }
 }
diff --git a/src/Framework/Http/Middlewares/ExceptionHandlingMiddleware.php b/src/Framework/Http/Middlewares/ExceptionHandlingMiddleware.php
index 836e2dff..f9e5147f 100644
--- a/src/Framework/Http/Middlewares/ExceptionHandlingMiddleware.php
+++ b/src/Framework/Http/Middlewares/ExceptionHandlingMiddleware.php
@@ -4,8 +4,10 @@ declare(strict_types=1);
 
 namespace App\Framework\Http\Middlewares;
 
-use App\Framework\ErrorHandling\ErrorHandler;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
 use App\Framework\ExceptionHandling\ErrorKernel;
+use App\Framework\ExceptionHandling\Factory\ExceptionFactory;
+use App\Framework\ExceptionHandling\Scope\ErrorScope;
 use App\Framework\Http\HttpMiddleware;
 use App\Framework\Http\MiddlewareContext;
 use App\Framework\Http\MiddlewarePriority;
@@ -13,13 +15,17 @@ use App\Framework\Http\MiddlewarePriorityAttribute;
 use App\Framework\Http\Next;
 use App\Framework\Http\RequestStateManager;
 use App\Framework\Logging\Logger;
+use App\Framework\Logging\ValueObjects\LogContext;
 
 #[MiddlewarePriorityAttribute(MiddlewarePriority::ERROR_HANDLING)]
 final readonly class ExceptionHandlingMiddleware implements HttpMiddleware
 {
     public function __construct(
-        private Logger      $logger,
-        #private ErrorHandler $errorHandler,
+        private ErrorKernel $errorKernel,
+        private Logger $logger,
+        private ?ExceptionContextProvider $contextProvider = null,
+        private ?ErrorScope $errorScope = null,
+        private ?ExceptionFactory $exceptionFactory = null
     ) {
     }
 
@@ -28,11 +34,26 @@ final readonly class ExceptionHandlingMiddleware implements HttpMiddleware
         try {
             return $next($context);
         } catch (\Throwable $e) {
+            // Enrich exception with context from ErrorScope if available
+            if ($this->contextProvider !== null && $this->errorScope !== null && $this->exceptionFactory !== null) {
+                // Check if exception already has context
+                $existingContext = $this->contextProvider->get($e);
+                if ($existingContext === null) {
+                    // No context yet - enrich from ErrorScope
+                    $this->exceptionFactory->enhance($e, \App\Framework\ExceptionHandling\Context\ExceptionContextData::empty());
+                }
+            }
 
-            $error = new ErrorKernel();
-            $error->handle($e);
+            $logContext = LogContext::withData([
+                'exception' => get_class($e),
+                'message' => $e->getMessage(),
+                'file' => $e->getFile(),
+                'line' => $e->getLine(),
+            ]);
 
-            $response = $this->errorHandler->createHttpResponse($e, $context);
+            $this->logger->error('Unhandled exception in HTTP request', $logContext);
+
+            $response = $this->errorKernel->createHttpResponse($e);
 
             return $context->withResponse($response);
         }
diff --git a/src/Framework/Http/Parser/Exception/ParserSecurityException.php b/src/Framework/Http/Parser/Exception/ParserSecurityException.php
index e1668d8a..46bcae77 100644
--- a/src/Framework/Http/Parser/Exception/ParserSecurityException.php
+++ b/src/Framework/Http/Parser/Exception/ParserSecurityException.php
@@ -13,166 +13,166 @@ final class ParserSecurityException extends FrameworkException
 {
     public static function fileSizeExceeded(string $filename, int $actualSize, int $maxSize): self
     {
-        return self::simple(
+        return new self(
             "File size exceeded for '{$filename}': {$actualSize} bytes > {$maxSize} bytes maximum"
         );
     }
 
     public static function fileCountExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "File count exceeded: {$actualCount} files > {$maxCount} maximum"
         );
     }
 
     public static function totalUploadSizeExceeded(int $actualSize, int $maxSize): self
     {
-        return self::simple(
+        return new self(
             "Total upload size exceeded: {$actualSize} bytes > {$maxSize} bytes maximum"
         );
     }
 
     public static function fileExtensionBlocked(string $filename, string $extension): self
     {
-        return self::simple(
+        return new self(
             "File extension blocked for '{$filename}': '.{$extension}' is not allowed"
         );
     }
 
     public static function fileExtensionNotAllowed(string $filename, string $extension): self
     {
-        return self::simple(
+        return new self(
             "File extension not allowed for '{$filename}': '.{$extension}' is not in allowed list"
         );
     }
 
     public static function formDataSizeExceeded(int $actualSize, int $maxSize): self
     {
-        return self::simple(
+        return new self(
             "Form data size exceeded: {$actualSize} bytes > {$maxSize} bytes maximum"
         );
     }
 
     public static function fieldCountExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Field count exceeded: {$actualCount} fields > {$maxCount} maximum"
         );
     }
 
     public static function fieldNameTooLong(string $fieldName, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Field name too long '{$fieldName}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function fieldValueTooLong(string $fieldName, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Field value too long for '{$fieldName}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function maxPartsExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Maximum number of parts exceeded: {$actualCount} parts > {$maxCount} maximum"
         );
     }
 
     public static function queryStringSizeExceeded(int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Query string size exceeded: {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function queryParameterCountExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Query parameter count exceeded: {$actualCount} parameters > {$maxCount} maximum"
         );
     }
 
     public static function headerCountExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Header count exceeded: {$actualCount} headers > {$maxCount} maximum"
         );
     }
 
     public static function headerSizeExceeded(int $actualSize, int $maxSize): self
     {
-        return self::simple(
+        return new self(
             "Total header size exceeded: {$actualSize} bytes > {$maxSize} bytes maximum"
         );
     }
 
     public static function cookieCountExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Cookie count exceeded: {$actualCount} cookies > {$maxCount} maximum"
         );
     }
 
     public static function cookieNameTooLong(string $name, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Cookie name too long '{$name}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function cookieValueTooLong(string $name, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Cookie value too long for '{$name}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function multipartPartsExceeded(int $actualCount, int $maxCount): self
     {
-        return self::simple(
+        return new self(
             "Multipart parts exceeded: {$actualCount} parts > {$maxCount} maximum"
         );
     }
 
     public static function requestBodySizeExceeded(int $actualSize, int $maxSize): self
     {
-        return self::simple(
+        return new self(
             "Request body size exceeded: {$actualSize} bytes > {$maxSize} bytes maximum"
         );
     }
 
     public static function maliciousContentDetected(string $reason): self
     {
-        return self::simple("Malicious content detected: {$reason}");
+        return new self("Malicious content detected: {$reason}");
     }
 
     public static function mimeTypeMismatch(string $filename, string $expectedType, string $actualType): self
     {
-        return self::simple(
+        return new self(
             "MIME type mismatch for '{$filename}': expected '{$expectedType}', got '{$actualType}'"
         );
     }
 
     public static function headerNameTooLong(string $name, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Header name too long '{$name}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function headerValueTooLong(string $name, int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Header value too long for '{$name}': {$actualLength} characters > {$maxLength} maximum"
         );
     }
 
     public static function boundaryTooLong(int $actualLength, int $maxLength): self
     {
-        return self::simple(
+        return new self(
             "Multipart boundary too long: {$actualLength} characters > {$maxLength} maximum"
         );
     }
diff --git a/src/Framework/Http/WebSocketServer.php b/src/Framework/Http/WebSocketServer.php
index a268f7fa..41a37b3e 100644
--- a/src/Framework/Http/WebSocketServer.php
+++ b/src/Framework/Http/WebSocketServer.php
@@ -6,24 +6,23 @@ namespace App\Framework\Http;
 
 use App\Framework\Http\Responses\WebSocketResponse;
 use App\Framework\Router\Result\WebSocketResult;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\SocketConnection as SocketsConnection;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+use App\Framework\Sockets\ValueObjects\SocketType;
 
 /**
  * WebSocket-Server für die Verarbeitung von WebSocket-Verbindungen
  */
 final class WebSocketServer
 {
-    // Socket-Konstanten
-    private const AF_INET = 2;       // IPv4
-    private const SOCK_STREAM = 1;   // TCP
-    private const SOL_TCP = 6;       // TCP protocol
-    private const SOL_SOCKET = 1;    // Socket level
-    private const SO_REUSEADDR = 2;  // Allow reuse of local addresses
-
     private array $connections = [];
 
     private bool $running = false;
 
-    private $mainSocket = null;
+    private ?SocketResource $mainSocket = null;
 
     private $router;
 
@@ -31,7 +30,8 @@ final class WebSocketServer
 
     public function __construct(
         private \App\Framework\Router\Router $httpRouter,
-        private \App\Framework\Router\RouteDispatcher $dispatcher
+        private \App\Framework\Router\RouteDispatcher $dispatcher,
+        private ?SocketService $socketService = null
     ) {
         $this->router = $httpRouter;
         $this->routeDispatcher = $dispatcher;
@@ -42,23 +42,117 @@ final class WebSocketServer
      */
     public function start(string $host = '0.0.0.0', int $port = 8080): void
     {
-        // Socket erstellen
-        $this->mainSocket = socket_create(self::AF_INET, self::SOCK_STREAM, self::SOL_TCP);
+        // Use SocketService if available, otherwise fallback to direct socket functions
+        if ($this->socketService !== null) {
+            $this->startWithSocketService($host, $port);
+        } else {
+            $this->startLegacy($host, $port);
+        }
+    }
 
-        if (! $this->mainSocket) {
+    /**
+     * Start server using SocketService
+     */
+    private function startWithSocketService(string $host, int $port): void
+    {
+        $address = SocketAddress::ipv4($host, $port);
+
+        // Create socket
+        $this->mainSocket = $this->socketService->createTcp($address);
+
+        // Bind and listen
+        $this->socketService->bind($this->mainSocket, $address);
+        $this->socketService->listen($this->mainSocket, 10);
+        $this->socketService->setNonBlocking($this->mainSocket);
+
+        echo "WebSocket-Server läuft auf $host:$port" . PHP_EOL;
+
+        $this->running = true;
+
+        // Main loop
+        while ($this->running) {
+            // Prepare sockets for select
+            $readSockets = [$this->mainSocket];
+
+            // Add connection sockets
+            foreach ($this->connections as $conn) {
+                if ($conn->isConnected()) {
+                    $socketResource = $this->getSocketResourceFromConnection($conn);
+                    if ($socketResource !== null) {
+                        $readSockets[] = $socketResource;
+                    }
+                }
+            }
+
+            // Select sockets (socket_select modifies arrays in-place)
+            $write = [];
+            $except = [];
+            $numChanged = $this->socketService->select($readSockets, $write, $except, 1);
+
+            if ($numChanged === 0) {
+                // No activity, continue
+                continue;
+            }
+
+            // Check main socket for new connections
+            $mainSocketReady = false;
+            foreach ($readSockets as $socket) {
+                if ($socket === $this->mainSocket) {
+                    $mainSocketReady = true;
+                    break;
+                }
+            }
+
+            if ($mainSocketReady) {
+                $connection = $this->socketService->accept($this->mainSocket);
+                if ($connection !== null) {
+                    $this->handleNewSocketConnection($connection);
+                }
+            }
+
+            // Process existing connections
+            foreach ($readSockets as $socket) {
+                if ($socket === $this->mainSocket) {
+                    continue;
+                }
+
+                $connection = $this->findConnectionBySocketResource($socket);
+                if ($connection !== null) {
+                    $this->processSocketData($connection);
+                }
+            }
+
+            // Cleanup inactive connections
+            foreach ($this->connections as $id => $conn) {
+                if (!$conn->isConnected()) {
+                    unset($this->connections[$id]);
+                }
+            }
+        }
+
+        // Cleanup
+        $this->cleanup();
+    }
+
+    /**
+     * Legacy start method (fallback if SocketService not available)
+     */
+    private function startLegacy(string $host, int $port): void
+    {
+        // Fallback to direct socket functions
+        $this->mainSocket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
+
+        if (!$this->mainSocket) {
             throw new \RuntimeException('Konnte Socket nicht erstellen: ' . socket_strerror(socket_last_error()));
         }
 
-        // Socket-Optionen setzen
-        socket_set_option($this->mainSocket, self::SOL_SOCKET, self::SO_REUSEADDR, 1);
+        socket_set_option($this->mainSocket, SOL_SOCKET, SO_REUSEADDR, 1);
 
-        // Socket an Adresse binden
-        if (! socket_bind($this->mainSocket, $host, $port)) {
+        if (!socket_bind($this->mainSocket, $host, $port)) {
             throw new \RuntimeException('Konnte Socket nicht binden: ' . socket_strerror(socket_last_error($this->mainSocket)));
         }
 
-        // Auf eingehende Verbindungen warten
-        if (! socket_listen($this->mainSocket, 10)) {
+        if (!socket_listen($this->mainSocket, 10)) {
             throw new \RuntimeException('Konnte nicht auf Socket lauschen: ' . socket_strerror(socket_last_error($this->mainSocket)));
         }
 
@@ -67,9 +161,7 @@ final class WebSocketServer
         $this->running = true;
         $read = [];
 
-        // Hauptschleife
         while ($this->running) {
-            // Sockets für select vorbereiten
             $read = [$this->mainSocket];
 
             foreach ($this->connections as $conn) {
@@ -81,30 +173,25 @@ final class WebSocketServer
                 }
             }
 
-            // Auf Aktivität warten
             $write = null;
             $except = null;
             $numChanged = socket_select($read, $write, $except, 1);
 
             if ($numChanged === false) {
                 echo "socket_select() fehlgeschlagen: " . socket_strerror(socket_last_error()) . PHP_EOL;
-
                 break;
             }
 
-            // Neue Verbindungen akzeptieren
             if (in_array($this->mainSocket, $read)) {
                 $clientSocket = socket_accept($this->mainSocket);
                 if ($clientSocket) {
                     $this->handleNewConnection($clientSocket);
                 }
 
-                // Hauptsocket aus dem Array entfernen
                 $key = array_search($this->mainSocket, $read);
                 unset($read[$key]);
             }
 
-            // Daten von bestehenden Verbindungen verarbeiten
             foreach ($read as $socket) {
                 $connection = $this->findConnectionBySocket($socket);
                 if ($connection) {
@@ -112,15 +199,13 @@ final class WebSocketServer
                 }
             }
 
-            // Inaktive Verbindungen entfernen
             foreach ($this->connections as $id => $conn) {
-                if (! $conn->isConnected()) {
+                if (!$conn->isConnected()) {
                     unset($this->connections[$id]);
                 }
             }
         }
 
-        // Aufräumen
         $this->cleanup();
     }
 
@@ -144,21 +229,55 @@ final class WebSocketServer
         }
 
         // Hauptsocket schließen
-        if ($this->mainSocket) {
-            socket_close($this->mainSocket);
+        if ($this->mainSocket !== null) {
+            if ($this->socketService !== null) {
+                $this->socketService->close($this->mainSocket);
+            } else {
+                socket_close($this->mainSocket->getResource() ?? $this->mainSocket);
+            }
         }
     }
 
     /**
-     * Verarbeitet eine neue Verbindung
+     * Handle new connection from SocketService
+     */
+    private function handleNewSocketConnection(SocketsConnection $socketConnection): void
+    {
+        $socket = $socketConnection->getSocket()->getResource();
+
+        // HTTP-Header lesen
+        $headers = $this->readHttpHeadersFromSocket($socket);
+
+        if (empty($headers)) {
+            $socketConnection->close();
+
+            return;
+        }
+
+        // Process WebSocket handshake
+        $this->processWebSocketHandshake($socketConnection, $headers);
+    }
+
+    /**
+     * Verarbeitet eine neue Verbindung (legacy)
      */
     private function handleNewConnection($socket): void
     {
         // HTTP-Header lesen
-        $headers = $this->readHttpHeaders($socket);
+        $headers = $this->readHttpHeadersFromSocket($socket);
 
         if (empty($headers)) {
-            socket_close($socket);
+            if ($this->socketService !== null && is_resource($socket)) {
+                // Try to close via SocketService if possible
+                try {
+                    $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                    $this->socketService->close($socketResource);
+                } catch (\Throwable $e) {
+                    socket_close($socket);
+                }
+            } else {
+                socket_close($socket);
+            }
 
             return;
         }
@@ -193,7 +312,46 @@ final class WebSocketServer
             return;
         }
 
-        // WebSocket-Handshake durchführen
+        // Process WebSocket handshake
+        $this->processWebSocketHandshakeLegacy($socket, $headers);
+    }
+
+    /**
+     * Process WebSocket handshake for SocketService connection
+     */
+    private function processWebSocketHandshake(SocketsConnection $socketConnection, array $headers): void
+    {
+        // Check if it's a WebSocket request
+        if (!isset($headers['Upgrade']) || strtolower($headers['Upgrade']) !== 'websocket' ||
+            !isset($headers['Sec-WebSocket-Key'])) {
+            $socketConnection->close();
+
+            return;
+        }
+
+        // Create HTTP request
+        $request = $this->createRequestFromHeaders($headers);
+
+        // Find route
+        $routeContext = $this->router->match($request);
+        $routeMatch = $routeContext->match;
+
+        if (!$routeMatch instanceof \App\Framework\Router\RouteMatchSuccess) {
+            $socketConnection->close();
+
+            return;
+        }
+
+        // Dispatch route
+        $result = $this->routeDispatcher->dispatch($routeMatch, $request);
+
+        if (!$result instanceof \App\Framework\Router\Result\WebSocketResult) {
+            $socketConnection->close();
+
+            return;
+        }
+
+        // Perform WebSocket handshake
         $key = $headers['Sec-WebSocket-Key'];
         $acceptKey = base64_encode(sha1($key . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true));
 
@@ -202,9 +360,9 @@ final class WebSocketServer
         $handshakeResponse .= "Connection: Upgrade\r\n";
         $handshakeResponse .= "Sec-WebSocket-Accept: $acceptKey\r\n";
 
-        // Subprotokolle hinzufügen, falls unterstützt
+        // Add subprotocols if supported
         $subprotocols = $result->getSubprotocols();
-        if (! empty($subprotocols) && isset($headers['Sec-WebSocket-Protocol'])) {
+        if (!empty($subprotocols) && isset($headers['Sec-WebSocket-Protocol'])) {
             $clientProtocols = explode(',', $headers['Sec-WebSocket-Protocol']);
             $clientProtocols = array_map('trim', $clientProtocols);
 
@@ -219,15 +377,138 @@ final class WebSocketServer
 
         $handshakeResponse .= "\r\n";
 
-        // Handshake senden
-        socket_write($socket, $handshakeResponse, strlen($handshakeResponse));
+        // Send handshake
+        $socket = $socketConnection->getSocket();
+        $this->socketService->write($socket, $handshakeResponse);
 
-        // Verbindung erstellen
+        // Create WebSocket connection wrapper
+        $connectionId = uniqid('ws_', true);
+        // Convert SocketResource to stream for WebSocketConnection compatibility
+        $stream = $this->socketResourceToStream($socket);
+        $connection = new WebSocketConnection($connectionId, $stream);
+        $this->connections[$connectionId] = $connection;
+
+        // Store socket connection mapping for later use
+        $connection->setAttribute('socket_resource', $socket);
+
+        // Call onConnect handler
+        if ($result->getOnConnect()) {
+            try {
+                call_user_func($result->getOnConnect(), $connection);
+            } catch (\Throwable $e) {
+                $this->handleError($connection, $e, $result);
+
+                return;
+            }
+        }
+    }
+
+    /**
+     * Process WebSocket handshake (legacy)
+     */
+    private function processWebSocketHandshakeLegacy($socket, array $headers): void
+    {
+        // Check if it's a WebSocket request
+        if (!isset($headers['Upgrade']) || strtolower($headers['Upgrade']) !== 'websocket' ||
+            !isset($headers['Sec-WebSocket-Key'])) {
+            if ($this->socketService !== null && is_resource($socket)) {
+                try {
+                    $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                    $this->socketService->close($socketResource);
+                } catch (\Throwable $e) {
+                    socket_close($socket);
+                }
+            } else {
+                socket_close($socket);
+            }
+
+            return;
+        }
+
+        // Create HTTP request
+        $request = $this->createRequestFromHeaders($headers);
+
+        // Find route
+        $routeContext = $this->router->match($request);
+        $routeMatch = $routeContext->match;
+
+        if (!$routeMatch instanceof \App\Framework\Router\RouteMatchSuccess) {
+            if ($this->socketService !== null && is_resource($socket)) {
+                try {
+                    $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                    $this->socketService->close($socketResource);
+                } catch (\Throwable $e) {
+                    socket_close($socket);
+                }
+            } else {
+                socket_close($socket);
+            }
+
+            return;
+        }
+
+        // Dispatch route
+        $result = $this->routeDispatcher->dispatch($routeMatch, $request);
+
+        if (!$result instanceof \App\Framework\Router\Result\WebSocketResult) {
+            if ($this->socketService !== null && is_resource($socket)) {
+                try {
+                    $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                    $this->socketService->close($socketResource);
+                } catch (\Throwable $e) {
+                    socket_close($socket);
+                }
+            } else {
+                socket_close($socket);
+            }
+
+            return;
+        }
+
+        // Perform WebSocket handshake
+        $key = $headers['Sec-WebSocket-Key'];
+        $acceptKey = base64_encode(sha1($key . '258EAFA5-E914-47DA-95CA-C5AB0DC85B11', true));
+
+        $handshakeResponse = "HTTP/1.1 101 Switching Protocols\r\n";
+        $handshakeResponse .= "Upgrade: websocket\r\n";
+        $handshakeResponse .= "Connection: Upgrade\r\n";
+        $handshakeResponse .= "Sec-WebSocket-Accept: $acceptKey\r\n";
+
+        // Add subprotocols if supported
+        $subprotocols = $result->getSubprotocols();
+        if (!empty($subprotocols) && isset($headers['Sec-WebSocket-Protocol'])) {
+            $clientProtocols = explode(',', $headers['Sec-WebSocket-Protocol']);
+            $clientProtocols = array_map('trim', $clientProtocols);
+
+            foreach ($subprotocols as $protocol) {
+                if (in_array($protocol, $clientProtocols)) {
+                    $handshakeResponse .= "Sec-WebSocket-Protocol: $protocol\r\n";
+
+                    break;
+                }
+            }
+        }
+
+        $handshakeResponse .= "\r\n";
+
+        // Send handshake
+        if ($this->socketService !== null && is_resource($socket)) {
+            try {
+                $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                $this->socketService->write($socketResource, $handshakeResponse);
+            } catch (\Throwable $e) {
+                socket_write($socket, $handshakeResponse, strlen($handshakeResponse));
+            }
+        } else {
+            socket_write($socket, $handshakeResponse, strlen($handshakeResponse));
+        }
+
+        // Create WebSocket connection
         $connectionId = uniqid('ws_', true);
         $connection = new WebSocketConnection($connectionId, $socket);
         $this->connections[$connectionId] = $connection;
 
-        // onConnect-Handler aufrufen
+        // Call onConnect handler
         if ($result->getOnConnect()) {
             try {
                 call_user_func($result->getOnConnect(), $connection);
@@ -242,16 +523,31 @@ final class WebSocketServer
     /**
      * Liest HTTP-Header von einem Socket
      */
-    private function readHttpHeaders($socket): array
+    private function readHttpHeadersFromSocket($socket): array
     {
         $headers = [];
         $buffer = '';
 
         // Header zeilenweise lesen
         while (true) {
-            $data = socket_read($socket, 1);
-            if ($data === false || $data === '') {
-                return [];
+            if ($this->socketService !== null && is_resource($socket)) {
+                try {
+                    $socketResource = SocketResource::fromResource($socket, SocketType::TCP, SocketProtocol::IPv4);
+                    $data = $this->socketService->read($socketResource, 1);
+                    if ($data === null || $data === '') {
+                        return [];
+                    }
+                } catch (\Throwable $e) {
+                    $data = socket_read($socket, 1);
+                    if ($data === false || $data === '') {
+                        return [];
+                    }
+                }
+            } else {
+                $data = socket_read($socket, 1);
+                if ($data === false || $data === '') {
+                    return [];
+                }
             }
 
             $buffer .= $data;
@@ -410,6 +706,48 @@ final class WebSocketServer
         return null;
     }
 
+    /**
+     * Find connection by SocketResource
+     */
+    private function findConnectionBySocketResource(SocketResource $socketResource): ?WebSocketConnection
+    {
+        foreach ($this->connections as $connection) {
+            $storedResource = $connection->getAttribute('socket_resource');
+            if ($storedResource === $socketResource) {
+                return $connection;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get SocketResource from WebSocketConnection
+     */
+    private function getSocketResourceFromConnection(WebSocketConnection $connection): ?SocketResource
+    {
+        $resource = $connection->getAttribute('socket_resource');
+        if ($resource instanceof SocketResource) {
+            return $resource;
+        }
+
+        return null;
+    }
+
+    /**
+     * Convert SocketResource to stream for WebSocketConnection compatibility
+     */
+    private function socketResourceToStream(SocketResource $socketResource)
+    {
+        // Use socket_export_stream if available (PHP 8.0+)
+        if (function_exists('socket_export_stream')) {
+            return socket_export_stream($socketResource->getResource());
+        }
+
+        // Fallback: return resource directly (WebSocketConnection handles both)
+        return $socketResource->getResource();
+    }
+
     public function handleUpgrade(WebSocketResponse $response): void
     {
         // Diese Methode wird in der standalone-Implementierung nicht verwendet
diff --git a/src/Framework/HttpClient/AuthType.php b/src/Framework/HttpClient/AuthType.php
index 26922f1e..d2553e6c 100644
--- a/src/Framework/HttpClient/AuthType.php
+++ b/src/Framework/HttpClient/AuthType.php
@@ -4,11 +4,11 @@ declare(strict_types=1);
 
 namespace App\Framework\HttpClient;
 
-enum AuthType
+enum AuthType: string
 {
-    case Basic;
-    case Bearer;
-    case OAuth2;
-    case Digest;
-    case Custom;
+    case Basic = 'basic';
+    case Bearer = 'bearer';
+    case OAuth2 = 'oauth2';
+    case Digest = 'digest';
+    case Custom = 'custom';
 }
diff --git a/src/Framework/HttpClient/Curl/Exception/HandleException.php b/src/Framework/HttpClient/Curl/Exception/HandleException.php
index 15f542f6..1f9019f4 100644
--- a/src/Framework/HttpClient/Curl/Exception/HandleException.php
+++ b/src/Framework/HttpClient/Curl/Exception/HandleException.php
@@ -24,7 +24,7 @@ final class HandleException extends FrameworkException
             ? "Failed to initialize cURL handle with URL: {$uri}"
             : "Failed to initialize cURL handle";
 
-        return self::simple(message: $message, code: 502)->withData(['url' => $uri]);
+        return new self($message, 502);
     }
 
     /**
@@ -32,13 +32,10 @@ final class HandleException extends FrameworkException
      */
     public static function executionFailed(string $errorMessage, int $errorCode): self
     {
-        return self::simple(
-            message: "cURL execution failed: {$errorMessage}",
-            code: 502
-        )->withData([
-            'curl_error_code' => $errorCode,
-            'curl_error_message' => $errorMessage,
-        ]);
+        return new self(
+            "cURL execution failed: {$errorMessage} (code: {$errorCode})",
+            502
+        );
     }
 
     /**
@@ -48,12 +45,10 @@ final class HandleException extends FrameworkException
     {
         $type = get_debug_type($output);
 
-        return self::simple(
-            message: "Invalid output target: expected resource or callable, got {$type}",
-            code: 400
-        )->withData([
-            'output_type' => $type,
-        ]);
+        return new self(
+            "Invalid output target: expected resource or callable, got {$type}",
+            400
+        );
     }
 
     /**
@@ -61,15 +56,12 @@ final class HandleException extends FrameworkException
      */
     public static function setOptionFailed(HandleOption $opt, mixed $value, string $errorMessage): self
     {
-        return self::simple(
-            message: "Failed to set cURL option {$opt->getName()}: {$errorMessage}",
-            code: 400
-        )->withData([
-            'option' => $opt->getName(),
-            'option_value' => $opt->value,
-            'value' => $value,
-            'error' => $errorMessage,
-        ]);
+        $valueStr = is_scalar($value) ? (string)$value : get_debug_type($value);
+
+        return new self(
+            "Failed to set cURL option {$opt->getName()} (value: {$opt->value}) to {$valueStr}: {$errorMessage}",
+            400
+        );
     }
 
     /**
@@ -89,14 +81,10 @@ final class HandleException extends FrameworkException
 
         $actualType = get_debug_type($value);
 
-        return self::simple(
-            message: "Invalid type for option {$opt->getName()}: expected {$expectedType}, got {$actualType}",
-            code: 400
-        )->withData([
-            'option' => $opt->getName(),
-            'expected_type' => $expectedType,
-            'actual_type' => $actualType,
-        ]);
+        return new self(
+            "Invalid type for option {$opt->getName()}: expected {$expectedType}, got {$actualType}",
+            400
+        );
     }
 
     /**
@@ -104,14 +92,10 @@ final class HandleException extends FrameworkException
      */
     public static function pauseFailed(Pause $flag, string $errorMessage): self
     {
-        return self::simple(
-            message: "Failed to pause cURL handle: {$errorMessage}",
-            code: 400
-        )->withData([
-            'pause_flag' => $flag->name,
-            'pause_value' => $flag->value,
-            'error' => $errorMessage,
-        ]);
+        return new self(
+            "Failed to pause cURL handle with flag {$flag->name} (value: {$flag->value}): {$errorMessage}",
+            400
+        );
     }
 
     /**
@@ -119,12 +103,12 @@ final class HandleException extends FrameworkException
      */
     public static function escapeFailed(string $string): self
     {
-        return self::simple(
-            message: "Failed to URL-escape string",
-            code: 400
-        )->withData([
-            'string_length' => strlen($string),
-        ]);
+        $length = strlen($string);
+
+        return new self(
+            "Failed to URL-escape string (length: {$length})",
+            400
+        );
     }
 
     /**
@@ -132,12 +116,10 @@ final class HandleException extends FrameworkException
      */
     public static function unescapeFailed(string $string): self
     {
-        return self::simple(
-            message: "Failed to URL-unescape string",
-            code: 400
-        )->withData([
-            'string' => $string,
-        ]);
+        return new self(
+            "Failed to URL-unescape string: {$string}",
+            400
+        );
     }
 
     /**
@@ -145,11 +127,9 @@ final class HandleException extends FrameworkException
      */
     public static function upkeepFailed(string $errorMessage): self
     {
-        return self::simple(
-            message: "cURL upkeep failed: {$errorMessage}",
-            code: 502
-        )->withData([
-            'error' => $errorMessage,
-        ]);
+        return new self(
+            "cURL upkeep failed: {$errorMessage}",
+            502
+        );
     }
 }
diff --git a/src/Framework/HttpClient/Curl/Exception/MultiHandleException.php b/src/Framework/HttpClient/Curl/Exception/MultiHandleException.php
index 23a3598b..180f3883 100644
--- a/src/Framework/HttpClient/Curl/Exception/MultiHandleException.php
+++ b/src/Framework/HttpClient/Curl/Exception/MultiHandleException.php
@@ -18,7 +18,7 @@ final class MultiHandleException extends FrameworkException
      */
     public static function initializationFailed(): self
     {
-        return self::simple(message: 'Failed to initialize cURL multi handle', code: 502);
+        return new self('Failed to initialize cURL multi handle', 502);
     }
 
     /**
@@ -26,13 +26,13 @@ final class MultiHandleException extends FrameworkException
      */
     public static function addHandleFailed(int $errorCode): self
     {
-        return self::simple(
-            message: "Failed to add handle to cURL multi handle",
-            code: 502
-        )->withData([
-            'curl_multi_error_code' => $errorCode,
-            'error_message' => self::getMultiErrorMessage($errorCode),
-        ]);
+        $message = sprintf(
+            'Failed to add handle to cURL multi handle: %s (code: %d)',
+            self::getMultiErrorMessage($errorCode),
+            $errorCode
+        );
+
+        return new self($message, 502);
     }
 
     /**
@@ -40,13 +40,13 @@ final class MultiHandleException extends FrameworkException
      */
     public static function removeHandleFailed(int $errorCode): self
     {
-        return self::simple(
-            message: "Failed to remove handle from cURL multi handle",
-            code: 502
-        )->withData([
-            'curl_multi_error_code' => $errorCode,
-            'error_message' => self::getMultiErrorMessage($errorCode),
-        ]);
+        $message = sprintf(
+            'Failed to remove handle from cURL multi handle: %s (code: %d)',
+            self::getMultiErrorMessage($errorCode),
+            $errorCode
+        );
+
+        return new self($message, 502);
     }
 
     /**
@@ -54,13 +54,13 @@ final class MultiHandleException extends FrameworkException
      */
     public static function executionFailed(int $errorCode): self
     {
-        return self::simple(
-            message: "cURL multi handle execution failed",
-            code: 502
-        )->withData([
-            'curl_multi_error_code' => $errorCode,
-            'error_message' => self::getMultiErrorMessage($errorCode),
-        ]);
+        $message = sprintf(
+            'cURL multi handle execution failed: %s (code: %d)',
+            self::getMultiErrorMessage($errorCode),
+            $errorCode
+        );
+
+        return new self($message, 502);
     }
 
     /**
@@ -68,13 +68,10 @@ final class MultiHandleException extends FrameworkException
      */
     public static function selectFailed(): self
     {
-        return self::simple(
-            message: 'cURL multi handle select operation failed',
-            code: 502
-        )->withData([
-            'error_code' => -1,
-            'error_message' => 'Select failed or no file descriptors available',
-        ]);
+        return new self(
+            'cURL multi handle select operation failed: Select failed or no file descriptors available',
+            502
+        );
     }
 
     /**
@@ -82,15 +79,15 @@ final class MultiHandleException extends FrameworkException
      */
     public static function setOptionFailed(int $option, mixed $value, int $errorCode): self
     {
-        return self::simple(
-            message: "Failed to set cURL multi option",
-            code: 400
-        )->withData([
-            'option' => $option,
-            'value' => $value,
-            'curl_multi_error_code' => $errorCode,
-            'error_message' => self::getMultiErrorMessage($errorCode),
-        ]);
+        $message = sprintf(
+            'Failed to set cURL multi option %d with value %s: %s (code: %d)',
+            $option,
+            is_scalar($value) ? (string)$value : gettype($value),
+            self::getMultiErrorMessage($errorCode),
+            $errorCode
+        );
+
+        return new self($message, 400);
     }
 
     /**
diff --git a/src/Framework/HttpClient/Exception/ClientErrorException.php b/src/Framework/HttpClient/Exception/ClientErrorException.php
index 0ed9be41..714e6b41 100644
--- a/src/Framework/HttpClient/Exception/ClientErrorException.php
+++ b/src/Framework/HttpClient/Exception/ClientErrorException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\HttpClient\Exception;
 
-use App\Framework\Exception\ExceptionContext;
-
 class ClientErrorException extends HttpClientException
 {
     /**
@@ -16,12 +14,7 @@ class ClientErrorException extends HttpClientException
     {
         parent::__construct(
             message: $message,
-            context: ExceptionContext::forOperation('http_client_request', 'HttpClient')
-                ->withData([
-                    'status_code' => $response->getStatusCode(),
-                    'response_size' => strlen($response->getContent()),
-                    'response_headers' => $response->getHeaders(),
-                ])
+            code: $response->getStatusCode()
         );
     }
 }
diff --git a/src/Framework/Icon/Icon.php b/src/Framework/Icon/Icon.php
new file mode 100644
index 00000000..0d487acd
--- /dev/null
+++ b/src/Framework/Icon/Icon.php
@@ -0,0 +1,129 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Icon;
+
+/**
+ * Icon Value Object
+ *
+ * Represents an icon with type, name, and optional path/content.
+ * Immutable value object following framework principles.
+ */
+final readonly class Icon
+{
+    public function __construct(
+        public string $name,
+        public IconType $type = IconType::FONT,
+        public ?string $path = null,
+        public ?string $content = null
+    ) {
+    }
+
+    /**
+     * Create icon from string (backward compatibility)
+     * 
+     * Supports:
+     * - Font icons: 'user', 'database' -> Font icon
+     * - Emoji: '🚀', '📊' -> Emoji icon
+     * - SVG paths: '/icons/user.svg' -> SVG icon
+     */
+    public static function fromString(string $icon): self
+    {
+        // Check if it's an emoji (contains emoji characters)
+        if (preg_match('/[\x{1F300}-\x{1F9FF}]/u', $icon)) {
+            return new self(
+                name: $icon,
+                type: IconType::EMOJI,
+                content: $icon
+            );
+        }
+
+        // Check if it's a path (starts with / or contains .svg, .png, etc.)
+        if (str_starts_with($icon, '/') || preg_match('/\.(svg|png|jpg|jpeg|gif|webp)$/i', $icon)) {
+            return new self(
+                name: basename($icon, '.svg'),
+                type: IconType::SVG,
+                path: $icon
+            );
+        }
+
+        // Default to font icon
+        return new self(
+            name: $icon,
+            type: IconType::FONT
+        );
+    }
+
+    /**
+     * Create SVG icon
+     */
+    public static function svg(string $name, string $path): self
+    {
+        return new self(
+            name: $name,
+            type: IconType::SVG,
+            path: $path
+        );
+    }
+
+    /**
+     * Create emoji icon
+     */
+    public static function emoji(string $emoji): self
+    {
+        return new self(
+            name: $emoji,
+            type: IconType::EMOJI,
+            content: $emoji
+        );
+    }
+
+    /**
+     * Create font icon
+     */
+    public static function font(string $name): self
+    {
+        return new self(
+            name: $name,
+            type: IconType::FONT
+        );
+    }
+
+    /**
+     * Get icon identifier for use in templates/HTML
+     */
+    public function getIdentifier(): string
+    {
+        return match ($this->type) {
+            IconType::EMOJI => $this->content ?? $this->name,
+            IconType::SVG => $this->path ?? $this->name,
+            IconType::FONT => $this->name,
+            IconType::IMAGE => $this->path ?? $this->name,
+        };
+    }
+
+    /**
+     * Get icon as string (for backward compatibility)
+     */
+    public function toString(): string
+    {
+        return $this->getIdentifier();
+    }
+
+    /**
+     * Render icon as HTML
+     */
+    public function toHtml(string $class = ''): string
+    {
+        return match ($this->type) {
+            IconType::EMOJI => '<span class="icon icon-emoji' . ($class ? ' ' . $class : '') . '">' . htmlspecialchars($this->content ?? $this->name, ENT_QUOTES, 'UTF-8') . '</span>',
+            IconType::SVG => $this->path 
+                ? '<img src="' . htmlspecialchars($this->path, ENT_QUOTES, 'UTF-8') . '" class="icon icon-svg' . ($class ? ' ' . $class : '') . '" alt="' . htmlspecialchars($this->name, ENT_QUOTES, 'UTF-8') . '" />'
+                : '<i class="icon icon-svg icon-' . htmlspecialchars($this->name, ENT_QUOTES, 'UTF-8') . ($class ? ' ' . $class : '') . '"></i>',
+            IconType::FONT => '<i class="icon icon-' . htmlspecialchars($this->name, ENT_QUOTES, 'UTF-8') . ($class ? ' ' . $class : '') . '"></i>',
+            IconType::IMAGE => '<img src="' . htmlspecialchars($this->path ?? $this->name, ENT_QUOTES, 'UTF-8') . '" class="icon icon-image' . ($class ? ' ' . $class : '') . '" alt="' . htmlspecialchars($this->name, ENT_QUOTES, 'UTF-8') . '" />',
+        };
+    }
+}
+
diff --git a/src/Framework/Icon/IconRegistry.php b/src/Framework/Icon/IconRegistry.php
new file mode 100644
index 00000000..d82788b8
--- /dev/null
+++ b/src/Framework/Icon/IconRegistry.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Icon;
+
+/**
+ * Icon Registry
+ *
+ * Central registry for icon definitions.
+ * Provides predefined icons for common use cases.
+ */
+final readonly class IconRegistry
+{
+    /**
+     * Get predefined icon by name
+     */
+    public function get(string $name): ?Icon
+    {
+        return $this->getPredefinedIcons()[$name] ?? null;
+    }
+
+    /**
+     * Check if icon exists
+     */
+    public function has(string $name): bool
+    {
+        return isset($this->getPredefinedIcons()[$name]);
+    }
+
+    /**
+     * Get all predefined icons
+     *
+     * @return array<string, Icon>
+     */
+    public function getAll(): array
+    {
+        return $this->getPredefinedIcons();
+    }
+
+    /**
+     * Get predefined icons
+     *
+     * @return array<string, Icon>
+     */
+    private function getPredefinedIcons(): array
+    {
+        return [
+            // Common icons
+            'file' => Icon::font('file'),
+            'folder' => Icon::font('folder'),
+            'user' => Icon::font('user'),
+            'users' => Icon::font('users'),
+            'settings' => Icon::font('settings'),
+            'cog' => Icon::font('cog'),
+            'home' => Icon::font('home'),
+            'dashboard' => Icon::font('dashboard'),
+            'chart' => Icon::font('chart'),
+            'chart-bar' => Icon::font('chart-bar'),
+            'chart-line' => Icon::font('chart-line'),
+            
+            // System icons
+            'server' => Icon::font('server'),
+            'database' => Icon::font('database'),
+            'cache' => Icon::font('cache'),
+            'redis' => Icon::font('redis'),
+            'log' => Icon::font('log'),
+            'logs' => Icon::font('logs'),
+            'health' => Icon::font('health'),
+            'performance' => Icon::font('performance'),
+            'monitor' => Icon::font('monitor'),
+            
+            // Content icons
+            'image' => Icon::font('image'),
+            'images' => Icon::font('images'),
+            'photo' => Icon::font('photo'),
+            'media' => Icon::font('media'),
+            'file-upload' => Icon::font('file-upload'),
+            'file-download' => Icon::font('file-download'),
+            
+            // Action icons
+            'plus' => Icon::font('plus'),
+            'edit' => Icon::font('edit'),
+            'delete' => Icon::font('delete'),
+            'trash' => Icon::font('trash'),
+            'save' => Icon::font('save'),
+            'cancel' => Icon::font('cancel'),
+            'refresh' => Icon::font('refresh'),
+            'search' => Icon::font('search'),
+            'filter' => Icon::font('filter'),
+            'sort' => Icon::font('sort'),
+            
+            // Status icons
+            'check' => Icon::font('check'),
+            'check-circle' => Icon::font('check-circle'),
+            'x' => Icon::font('x'),
+            'x-circle' => Icon::font('x-circle'),
+            'warning' => Icon::font('warning'),
+            'alert' => Icon::font('alert'),
+            'info' => Icon::font('info'),
+            
+            // Navigation icons
+            'menu' => Icon::font('menu'),
+            'arrow-left' => Icon::font('arrow-left'),
+            'arrow-right' => Icon::font('arrow-right'),
+            'arrow-up' => Icon::font('arrow-up'),
+            'arrow-down' => Icon::font('arrow-down'),
+            'chevron-left' => Icon::font('chevron-left'),
+            'chevron-right' => Icon::font('chevron-right'),
+            
+            // Development icons
+            'code' => Icon::font('code'),
+            'terminal' => Icon::font('terminal'),
+            'bug' => Icon::font('bug'),
+            'tools' => Icon::font('tools'),
+            'wrench' => Icon::font('wrench'),
+            
+            // Notification icons
+            'bell' => Icon::font('bell'),
+            'notification' => Icon::font('notification'),
+            'mail' => Icon::font('mail'),
+            'envelope' => Icon::font('envelope'),
+            
+            // Machine Learning icons
+            'brain' => Icon::font('brain'),
+            'ai' => Icon::font('ai'),
+            'neural-network' => Icon::font('neural-network'),
+            
+            // Music/Media icons
+            'music' => Icon::font('music'),
+            'play' => Icon::font('play'),
+            'pause' => Icon::font('pause'),
+            'stop' => Icon::font('stop'),
+            
+            // Table icons
+            'table' => Icon::font('table'),
+            'list' => Icon::font('list'),
+            'grid' => Icon::font('grid'),
+            
+            // Docker/Container icons
+            'docker' => Icon::font('docker'),
+            'container' => Icon::font('container'),
+            'box' => Icon::font('box'),
+        ];
+    }
+}
+
diff --git a/src/Framework/Icon/IconType.php b/src/Framework/Icon/IconType.php
new file mode 100644
index 00000000..5d0933ff
--- /dev/null
+++ b/src/Framework/Icon/IconType.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Icon;
+
+/**
+ * Icon Type Enum
+ *
+ * Defines the type of icon (SVG, Emoji, Font Icon, etc.)
+ */
+enum IconType: string
+{
+    case SVG = 'svg';
+    case EMOJI = 'emoji';
+    case FONT = 'font';
+    case IMAGE = 'image';
+
+    public function getDescription(): string
+    {
+        return match ($this) {
+            self::SVG => 'SVG icon (inline or path)',
+            self::EMOJI => 'Emoji icon',
+            self::FONT => 'Font icon (icon font class)',
+            self::IMAGE => 'Image icon (URL or path)',
+        };
+    }
+}
+
diff --git a/src/Framework/LiveComponents/Controllers/LiveComponentController.php b/src/Framework/LiveComponents/Controllers/LiveComponentController.php
index 6808212d..af4d5b2a 100644
--- a/src/Framework/LiveComponents/Controllers/LiveComponentController.php
+++ b/src/Framework/LiveComponents/Controllers/LiveComponentController.php
@@ -22,6 +22,7 @@ use App\Framework\LiveComponents\ValueObjects\ActionParameters;
 use App\Framework\LiveComponents\ValueObjects\ComponentAction;
 use App\Framework\LiveComponents\ValueObjects\ComponentData;
 use App\Framework\LiveComponents\ValueObjects\ComponentId;
+use App\Framework\LiveComponents\ValueObjects\LiveComponentError;
 use App\Framework\Router\Result\JsonResult;
 
 final readonly class LiveComponentController
@@ -118,9 +119,14 @@ final readonly class LiveComponentController
 
         // Check if component supports file uploads
         if (! $component instanceof SupportsFileUpload) {
+            $error = LiveComponentError::validation(
+                'Component does not support file uploads',
+                null,
+                $componentId->toString()
+            );
             return new JsonResult([
                 'success' => false,
-                'error' => 'Component does not support file uploads',
+                'error' => $error->toArray(),
             ], Status::BAD_REQUEST);
         }
 
@@ -128,9 +134,14 @@ final readonly class LiveComponentController
         $uploadedFiles = $request->files?->all() ?? [];
 
         if (empty($uploadedFiles)) {
+            $error = LiveComponentError::uploadFailed(
+                'No file uploaded',
+                null,
+                $componentId->toString()
+            );
             return new JsonResult([
                 'success' => false,
-                'error' => 'No file uploaded',
+                'error' => $error->toArray(),
             ], Status::BAD_REQUEST);
         }
 
@@ -138,9 +149,14 @@ final readonly class LiveComponentController
         $file = reset($uploadedFiles);
 
         if (! $file instanceof UploadedFile) {
+            $error = LiveComponentError::uploadFailed(
+                'Invalid file upload',
+                null,
+                $componentId->toString()
+            );
             return new JsonResult([
                 'success' => false,
-                'error' => 'Invalid file upload',
+                'error' => $error->toArray(),
             ], Status::BAD_REQUEST);
         }
 
@@ -148,9 +164,14 @@ final readonly class LiveComponentController
         $validationErrors = $component->validateUpload($file);
 
         if (! empty($validationErrors)) {
+            $error = LiveComponentError::uploadFailed(
+                'File validation failed',
+                ['validation_errors' => $validationErrors],
+                $componentId->toString()
+            );
             return new JsonResult([
                 'success' => false,
-                'errors' => $validationErrors,
+                'error' => $error->toArray(),
             ], Status::UNPROCESSABLE_ENTITY);
         }
 
@@ -184,9 +205,10 @@ final readonly class LiveComponentController
                 ],
             ]);
         } catch (\Exception $e) {
+            $error = LiveComponentError::fromException($e, $componentId->toString(), 'upload');
             return new JsonResult([
                 'success' => false,
-                'error' => $e->getMessage(),
+                'error' => $error->toArray(),
             ], Status::INTERNAL_SERVER_ERROR);
         }
     }
@@ -231,10 +253,10 @@ final readonly class LiveComponentController
             ]);
 
         } catch (\Exception $e) {
+            $error = LiveComponentError::fromException($e, $id, 'lazy-load');
             return new JsonResult([
                 'success' => false,
-                'error' => $e->getMessage(),
-                'error_code' => 'LAZY_LOAD_FAILED',
+                'error' => $error->toArray(),
             ], Status::INTERNAL_SERVER_ERROR);
         }
     }
diff --git a/src/Framework/LiveComponents/Exceptions/StateEncryptionException.php b/src/Framework/LiveComponents/Exceptions/StateEncryptionException.php
index dc28867a..7a131e5a 100644
--- a/src/Framework/LiveComponents/Exceptions/StateEncryptionException.php
+++ b/src/Framework/LiveComponents/Exceptions/StateEncryptionException.php
@@ -24,10 +24,10 @@ final class StateEncryptionException extends FrameworkException
         string $reason,
         ?\Throwable $previous = null
     ): self {
-        return self::simple(
-            message: "State encryption failed: {$reason}",
-            previous: $previous,
-            code: 500
+        return new self(
+            "State encryption failed: {$reason}",
+            500,
+            $previous
         );
     }
 
@@ -38,10 +38,10 @@ final class StateEncryptionException extends FrameworkException
         string $reason,
         ?\Throwable $previous = null
     ): self {
-        return self::simple(
-            message: "State decryption failed: {$reason}",
-            previous: $previous,
-            code: 500
+        return new self(
+            "State decryption failed: {$reason}",
+            500,
+            $previous
         );
     }
 
@@ -50,10 +50,9 @@ final class StateEncryptionException extends FrameworkException
      */
     public static function invalidKey(string $reason): self
     {
-        return self::simple(
-            message: "Invalid encryption key: {$reason}",
-            previous: null,
-            code: 500
+        return new self(
+            "Invalid encryption key: {$reason}",
+            500
         );
     }
 
@@ -62,10 +61,9 @@ final class StateEncryptionException extends FrameworkException
      */
     public static function dataCorrupted(string $details): self
     {
-        return self::simple(
-            message: "Encrypted state data is corrupted: {$details}",
-            previous: null,
-            code: 500
+        return new self(
+            "Encrypted state data is corrupted: {$details}",
+            500
         );
     }
 }
diff --git a/src/Framework/LiveComponents/ParameterBinding/ParameterBindingException.php b/src/Framework/LiveComponents/ParameterBinding/ParameterBindingException.php
index 85d2eea5..f647cde7 100644
--- a/src/Framework/LiveComponents/ParameterBinding/ParameterBindingException.php
+++ b/src/Framework/LiveComponents/ParameterBinding/ParameterBindingException.php
@@ -28,18 +28,10 @@ final class ParameterBindingException extends FrameworkException
     ): self {
         $typeInfo = $expectedType ? " (expected type: {$expectedType})" : '';
 
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Missing required parameter '{$parameterName}' for action {$method->toString}(){$typeInfo}"
-        )->withData([
-            'parameter_name' => $parameterName,
-            'method' => $method->methodName->toString(),
-            'class' => $method->className->toString(),
-            'expected_type' => $expectedType,
-            'error_type' => 'missing_parameter',
-        ])->withContextMetadata([
-            'component' => 'LiveComponentParameterBinding',
-        ]);
+        return new self(
+            "Missing required parameter '{$parameterName}' for action {$method->toString}(){$typeInfo}",
+            400 // Bad Request
+        );
     }
 
     /**
@@ -54,21 +46,10 @@ final class ParameterBindingException extends FrameworkException
         $actualType = get_debug_type($actualValue);
         $valuePreview = self::previewValue($actualValue);
 
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Type mismatch for parameter '{$parameterName}' in {$method->toString}(): " .
-            "expected {$expectedType}, got {$actualType}"
-        )->withData([
-            'parameter_name' => $parameterName,
-            'expected_type' => $expectedType,
-            'actual_type' => $actualType,
-            'value_preview' => $valuePreview,
-            'method' => $method->methodName->toString(),
-            'class' => $method->className->toString(),
-            'error_type' => 'type_mismatch',
-        ])->withContextMetadata([
-            'component' => 'LiveComponentParameterBinding',
-        ]);
+        return new self(
+            "Type mismatch for parameter '{$parameterName}' in {$method->toString}(): expected {$expectedType}, got {$actualType} (value: {$valuePreview})",
+            400 // Bad Request
+        );
     }
 
     /**
@@ -80,20 +61,10 @@ final class ParameterBindingException extends FrameworkException
         QualifiedMethodName $method,
         string $reason
     ): self {
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Failed to instantiate DTO '{$dtoClass->toString}' for parameter '{$parameterName}' " .
-            "in {$method->toString}(): {$reason}"
-        )->withData([
-            'parameter_name' => $parameterName,
-            'dto_class' => $dtoClass->toString(),
-            'method' => $method->methodName->toString(),
-            'class' => $method->className->toString(),
-            'reason' => $reason,
-            'error_type' => 'dto_instantiation_failed',
-        ])->withContextMetadata([
-            'component' => 'LiveComponentParameterBinding',
-        ]);
+        return new self(
+            "Failed to instantiate DTO '{$dtoClass->toString}' for parameter '{$parameterName}' in {$method->toString}(): {$reason}",
+            400 // Bad Request
+        );
     }
 
     /**
@@ -104,17 +75,10 @@ final class ParameterBindingException extends FrameworkException
         string $parameterName,
         string $reason
     ): self {
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Invalid DTO structure for '{$dtoClass->toString()}' (parameter: {$parameterName}): {$reason}"
-        )->withData([
-            'dto_class' => $dtoClass->toString(),
-            'parameter_name' => $parameterName,
-            'reason' => $reason,
-            'error_type' => 'invalid_dto_structure',
-        ])->withContextMetadata([
-            'component' => 'LiveComponentParameterBinding',
-        ]);
+        return new self(
+            "Invalid DTO structure for '{$dtoClass->toString()}' (parameter: {$parameterName}): {$reason}",
+            400 // Bad Request
+        );
     }
 
     /**
diff --git a/src/Framework/LiveComponents/ValueObjects/LiveComponentError.php b/src/Framework/LiveComponents/ValueObjects/LiveComponentError.php
new file mode 100644
index 00000000..12e9f912
--- /dev/null
+++ b/src/Framework/LiveComponents/ValueObjects/LiveComponentError.php
@@ -0,0 +1,226 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\LiveComponents\ValueObjects;
+
+/**
+ * Standardized error format for LiveComponent API responses
+ *
+ * Provides consistent error structure between PHP and JavaScript.
+ */
+final readonly class LiveComponentError
+{
+    public function __construct(
+        public string $code,
+        public string $message,
+        public ?array $details = null,
+        public ?string $componentId = null,
+        public ?string $action = null,
+        public ?int $timestamp = null
+    ) {
+        if (empty($code)) {
+            throw new \InvalidArgumentException('Error code cannot be empty');
+        }
+
+        if (empty($message)) {
+            throw new \InvalidArgumentException('Error message cannot be empty');
+        }
+    }
+
+    /**
+     * Create validation error
+     */
+    public static function validation(string $message, ?array $details = null, ?string $componentId = null, ?string $action = null): self
+    {
+        return new self(
+            code: 'VALIDATION_ERROR',
+            message: $message,
+            details: $details,
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create component not found error
+     */
+    public static function componentNotFound(string $componentId): self
+    {
+        return new self(
+            code: 'COMPONENT_NOT_FOUND',
+            message: "Component '{$componentId}' not found",
+            componentId: $componentId,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create action not found error
+     */
+    public static function actionNotFound(string $componentId, string $action): self
+    {
+        return new self(
+            code: 'ACTION_NOT_FOUND',
+            message: "Action '{$action}' not found on component '{$componentId}'",
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create CSRF token invalid error
+     */
+    public static function csrfTokenInvalid(?string $componentId = null): self
+    {
+        return new self(
+            code: 'CSRF_TOKEN_INVALID',
+            message: 'CSRF token is invalid or missing',
+            componentId: $componentId,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create rate limit exceeded error
+     */
+    public static function rateLimitExceeded(?string $componentId = null, ?string $action = null, ?int $retryAfter = null): self
+    {
+        $details = $retryAfter ? ['retry_after' => $retryAfter] : null;
+
+        return new self(
+            code: 'RATE_LIMIT_EXCEEDED',
+            message: 'Rate limit exceeded. Please try again later.',
+            details: $details,
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create state conflict error
+     */
+    public static function stateConflict(string $componentId, ?int $expectedVersion = null, ?int $actualVersion = null): self
+    {
+        $details = [];
+        if ($expectedVersion !== null) {
+            $details['expected_version'] = $expectedVersion;
+        }
+        if ($actualVersion !== null) {
+            $details['actual_version'] = $actualVersion;
+        }
+
+        return new self(
+            code: 'STATE_CONFLICT',
+            message: 'Component state conflict detected. Please refresh and try again.',
+            details: ! empty($details) ? $details : null,
+            componentId: $componentId,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create upload failed error
+     */
+    public static function uploadFailed(string $message, ?array $details = null, ?string $componentId = null): self
+    {
+        return new self(
+            code: 'UPLOAD_FAILED',
+            message: $message,
+            details: $details,
+            componentId: $componentId,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create permission denied error
+     */
+    public static function permissionDenied(?string $componentId = null, ?string $action = null): self
+    {
+        return new self(
+            code: 'PERMISSION_DENIED',
+            message: 'Permission denied for this operation',
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Create internal error
+     */
+    public static function internal(string $message, ?array $details = null, ?string $componentId = null, ?string $action = null): self
+    {
+        return new self(
+            code: 'INTERNAL_ERROR',
+            message: $message,
+            details: $details,
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+
+    /**
+     * Convert to array for JSON serialization
+     */
+    public function toArray(): array
+    {
+        $array = [
+            'code' => $this->code,
+            'message' => $this->message,
+        ];
+
+        if ($this->details !== null) {
+            $array['details'] = $this->details;
+        }
+
+        if ($this->componentId !== null) {
+            $array['componentId'] = $this->componentId;
+        }
+
+        if ($this->action !== null) {
+            $array['action'] = $this->action;
+        }
+
+        if ($this->timestamp !== null) {
+            $array['timestamp'] = $this->timestamp;
+        }
+
+        return $array;
+    }
+
+    /**
+     * Create from exception
+     */
+    public static function fromException(\Throwable $exception, ?string $componentId = null, ?string $action = null): self
+    {
+        $code = 'INTERNAL_ERROR';
+        $message = $exception->getMessage();
+
+        // Map common exception types to error codes
+        if ($exception instanceof \InvalidArgumentException) {
+            $code = 'VALIDATION_ERROR';
+        } elseif ($exception instanceof \RuntimeException) {
+            $code = 'INTERNAL_ERROR';
+        }
+
+        return new self(
+            code: $code,
+            message: $message,
+            details: [
+                'exception' => get_class($exception),
+                'file' => $exception->getFile(),
+                'line' => $exception->getLine(),
+            ],
+            componentId: $componentId,
+            action: $action,
+            timestamp: time()
+        );
+    }
+}
+
diff --git a/src/Framework/Logging/Handlers/AggregatingLogHandler.php b/src/Framework/Logging/Handlers/AggregatingLogHandler.php
index 1855b4d5..a4ccfa6c 100644
--- a/src/Framework/Logging/Handlers/AggregatingLogHandler.php
+++ b/src/Framework/Logging/Handlers/AggregatingLogHandler.php
@@ -32,6 +32,12 @@ use App\Framework\Logging\ValueObjects\LogContext;
  */
 final class AggregatingLogHandler implements LogHandler, HealthCheckInterface
 {
+    private const string NAME = 'aggregating_handler';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     /** @var array<string, AggregatedLogEntry> */
     private array $aggregatedEntries = [];
     private Timestamp $windowStart;
@@ -43,6 +49,8 @@ final class AggregatingLogHandler implements LogHandler, HealthCheckInterface
         private readonly AggregationConfig $config = new AggregationConfig()
     ) {
         $this->windowStart = Timestamp::now();
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function handle(LogRecord $record): void
@@ -200,18 +208,13 @@ final class AggregatingLogHandler implements LogHandler, HealthCheckInterface
 
         return new HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $details,
             timestamp: new \DateTimeImmutable()
         );
     }
 
-    public function getName(): string
-    {
-        return 'aggregating_handler';
-    }
-
     public function isHandling(LogRecord $record): bool
     {
         // Delegate to wrapped handler
@@ -222,9 +225,4 @@ final class AggregatingLogHandler implements LogHandler, HealthCheckInterface
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds timeout for aggregating handler health check
-    }
 }
diff --git a/src/Framework/Logging/Handlers/BufferedLogHandler.php b/src/Framework/Logging/Handlers/BufferedLogHandler.php
index 11f10d7c..c17af28d 100644
--- a/src/Framework/Logging/Handlers/BufferedLogHandler.php
+++ b/src/Framework/Logging/Handlers/BufferedLogHandler.php
@@ -24,6 +24,12 @@ use App\Framework\Logging\LogRecord;
  */
 final class BufferedLogHandler implements LogHandler, \App\Framework\Health\HealthCheckInterface
 {
+    private const string NAME = 'buffered_handler';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     /** @var LogRecord[] */
     private array $buffer = [];
     private Timestamp $lastFlushTime;
@@ -35,6 +41,8 @@ final class BufferedLogHandler implements LogHandler, \App\Framework\Health\Heal
         private readonly bool $flushOnError = true
     ) {
         $this->lastFlushTime = Timestamp::now();
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function handle(LogRecord $record): void
@@ -140,18 +148,13 @@ final class BufferedLogHandler implements LogHandler, \App\Framework\Health\Heal
 
         return new \App\Framework\Health\HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $details,
             timestamp: new \DateTimeImmutable()
         );
     }
 
-    public function getName(): string
-    {
-        return 'buffered_handler';
-    }
-
     public function isHandling(LogRecord $record): bool
     {
         // Delegate to wrapped handler
@@ -162,9 +165,4 @@ final class BufferedLogHandler implements LogHandler, \App\Framework\Health\Heal
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds timeout for buffered handler health check
-    }
 }
diff --git a/src/Framework/Logging/Handlers/RateLimitedLogHandler.php b/src/Framework/Logging/Handlers/RateLimitedLogHandler.php
index ee19fd33..c47a5eb8 100644
--- a/src/Framework/Logging/Handlers/RateLimitedLogHandler.php
+++ b/src/Framework/Logging/Handlers/RateLimitedLogHandler.php
@@ -27,6 +27,12 @@ use App\Framework\RateLimit\RateLimiter;
  */
 final class RateLimitedLogHandler implements LogHandler, HealthCheckInterface
 {
+    private const string NAME = 'rate_limited_handler';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     private array $throttledCounts = [];
     private int $totalThrottled = 0;
     private Timestamp $lastSummaryTime;
@@ -38,6 +44,8 @@ final class RateLimitedLogHandler implements LogHandler, HealthCheckInterface
         private readonly int $summaryCadenceSeconds = 60
     ) {
         $this->lastSummaryTime = Timestamp::now();
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function handle(LogRecord $record): void
@@ -166,18 +174,13 @@ final class RateLimitedLogHandler implements LogHandler, HealthCheckInterface
 
         return new HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $details,
             timestamp: new \DateTimeImmutable()
         );
     }
 
-    public function getName(): string
-    {
-        return 'rate_limited_handler';
-    }
-
     public function isHandling(LogRecord $record): bool
     {
         // Delegate to wrapped handler
@@ -188,9 +191,4 @@ final class RateLimitedLogHandler implements LogHandler, HealthCheckInterface
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds timeout for rate limited handler health check
-    }
 }
diff --git a/src/Framework/Logging/Handlers/ResilientLogHandler.php b/src/Framework/Logging/Handlers/ResilientLogHandler.php
index 02cd4210..995fd53f 100644
--- a/src/Framework/Logging/Handlers/ResilientLogHandler.php
+++ b/src/Framework/Logging/Handlers/ResilientLogHandler.php
@@ -24,6 +24,12 @@ use App\Framework\Logging\LogRecord;
  */
 final class ResilientLogHandler implements LogHandler, \App\Framework\Health\HealthCheckInterface
 {
+    private const string NAME = 'resilient_handler';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     private CircuitBreaker $circuitBreaker;
 
     public function __construct(
@@ -40,6 +46,9 @@ final class ResilientLogHandler implements LogHandler, \App\Framework\Health\Hea
                 halfOpenRequests: 1
             )
         );
+
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function handle(LogRecord $record): void
@@ -135,18 +144,13 @@ final class ResilientLogHandler implements LogHandler, \App\Framework\Health\Hea
 
         return new \App\Framework\Health\HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $details,
             timestamp: new \DateTimeImmutable()
         );
     }
 
-    public function getName(): string
-    {
-        return 'resilient_handler';
-    }
-
     public function isHandling(LogRecord $record): bool
     {
         // Delegate to primary handler (if circuit is closed)
@@ -157,9 +161,4 @@ final class ResilientLogHandler implements LogHandler, \App\Framework\Health\Hea
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds timeout for resilient handler health check
-    }
 }
diff --git a/src/Framework/Logging/Handlers/SamplingLogHandler.php b/src/Framework/Logging/Handlers/SamplingLogHandler.php
index 302f10c8..fc8fe5df 100644
--- a/src/Framework/Logging/Handlers/SamplingLogHandler.php
+++ b/src/Framework/Logging/Handlers/SamplingLogHandler.php
@@ -27,6 +27,12 @@ use App\Framework\Logging\Sampling\SamplingConfig;
  */
 final class SamplingLogHandler implements LogHandler, HealthCheckInterface
 {
+    private const string NAME = 'sampling_handler';
+    private const int TIMEOUT_MS = 3000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     private int $acceptedCount = 0;
     private int $droppedCount = 0;
     private array $droppedByLevel = [];
@@ -35,6 +41,8 @@ final class SamplingLogHandler implements LogHandler, HealthCheckInterface
         private readonly LogHandler $handler,
         private readonly SamplingConfig $config = new SamplingConfig()
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function handle(LogRecord $record): void
@@ -141,18 +149,13 @@ final class SamplingLogHandler implements LogHandler, HealthCheckInterface
 
         return new HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $details,
             timestamp: new \DateTimeImmutable()
         );
     }
 
-    public function getName(): string
-    {
-        return 'sampling_handler';
-    }
-
     public function isHandling(LogRecord $record): bool
     {
         // We handle all levels but might sample them
@@ -163,9 +166,4 @@ final class SamplingLogHandler implements LogHandler, HealthCheckInterface
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
-
-    public function getTimeout(): int
-    {
-        return 3000; // 3 seconds timeout for sampling handler health check
-    }
 }
diff --git a/src/Framework/Logging/Health/LoggingHealthCheck.php b/src/Framework/Logging/Health/LoggingHealthCheck.php
index ce688e1d..f5e8427c 100644
--- a/src/Framework/Logging/Health/LoggingHealthCheck.php
+++ b/src/Framework/Logging/Health/LoggingHealthCheck.php
@@ -25,6 +25,12 @@ use App\Framework\Performance\Stopwatch;
  */
 final class LoggingHealthCheck implements HealthCheckInterface
 {
+    private const string NAME = 'logging';
+    private const int TIMEOUT_MS = 5000;
+
+    public readonly string $name;
+    public readonly int $timeout;
+
     /**
      * @param LogHandler[] $handlers
      */
@@ -34,6 +40,8 @@ final class LoggingHealthCheck implements HealthCheckInterface
         private readonly int $minDiskSpaceGb = 5,
         private readonly int $bufferWarningThreshold = 80
     ) {
+        $this->name = self::NAME;
+        $this->timeout = self::TIMEOUT_MS;
     }
 
     public function check(): HealthCheckResult
@@ -84,7 +92,7 @@ final class LoggingHealthCheck implements HealthCheckInterface
 
         return new HealthCheckResult(
             status: $status,
-            componentName: $this->getName(),
+            componentName: $this->name,
             message: $message,
             details: $checks,
             timestamp: new \DateTimeImmutable(),
@@ -92,21 +100,11 @@ final class LoggingHealthCheck implements HealthCheckInterface
         );
     }
 
-    public function getName(): string
-    {
-        return 'logging';
-    }
-
     public function getCategory(): HealthCheckCategory
     {
         return HealthCheckCategory::INFRASTRUCTURE;
     }
 
-    public function getTimeout(): int
-    {
-        return 5000; // 5 seconds timeout for logging health check
-    }
-
     private function checkDiskSpace(): HealthCheckResult
     {
         if (!file_exists($this->logPath)) {
@@ -279,7 +277,7 @@ final class LoggingHealthCheck implements HealthCheckInterface
     private function getHandlerName(LogHandler $handler, int $index): string
     {
         if ($handler instanceof \App\Framework\Health\HealthCheckInterface) {
-            return $handler->getName();
+            return $handler->name;
         }
 
         $className = get_class($handler);
diff --git a/src/Framework/MagicLinks/MagicLinkService.php b/src/Framework/MagicLinks/MagicLinkService.php
new file mode 100644
index 00000000..1f44b5c6
--- /dev/null
+++ b/src/Framework/MagicLinks/MagicLinkService.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks;
+
+use App\Framework\MagicLinks\ValueObjects\{
+    MagicLinkToken,
+    MagicLinkData,
+    TokenAction,
+    TokenConfig
+};
+
+/**
+ * Magic Link Service Interface
+ *
+ * Service for generating and managing secure, time-limited magic links
+ * for various actions (email verification, password reset, etc.)
+ */
+interface MagicLinkService
+{
+    /**
+     * Generate a new magic link token
+     *
+     * @param TokenAction $action The action this token will perform
+     * @param array $payload Action-specific data
+     * @param TokenConfig|null $config Token configuration (uses defaults if null)
+     * @param string|null $createdByIp IP address creating the token (for restriction)
+     * @param string|null $userAgent User agent creating the token
+     * @return MagicLinkToken The generated token
+     */
+    public function generate(
+        TokenAction $action,
+        array $payload,
+        ?TokenConfig $config = null,
+        ?string $createdByIp = null,
+        ?string $userAgent = null
+    ): MagicLinkToken;
+
+    /**
+     * Validate a token and retrieve its data
+     *
+     * @param MagicLinkToken $token The token to validate
+     * @return MagicLinkData|null Token data if valid, null otherwise
+     */
+    public function validate(MagicLinkToken $token): ?MagicLinkData;
+
+    /**
+     * Mark a token as used
+     *
+     * @param MagicLinkToken $token The token to mark as used
+     * @throws \RuntimeException if token doesn't exist
+     */
+    public function markAsUsed(MagicLinkToken $token): void;
+
+    /**
+     * Revoke a token (make it invalid)
+     *
+     * @param MagicLinkToken $token The token to revoke
+     */
+    public function revoke(MagicLinkToken $token): void;
+
+    /**
+     * Check if a token exists
+     *
+     * @param MagicLinkToken $token The token to check
+     * @return bool True if token exists
+     */
+    public function exists(MagicLinkToken $token): bool;
+
+    /**
+     * Get all active (non-expired) tokens
+     *
+     * @param int $limit Maximum number of tokens to return
+     * @return array<MagicLinkData> Array of active tokens
+     */
+    public function getActiveTokens(int $limit = 100): array;
+
+    /**
+     * Clean up expired tokens
+     *
+     * @return int Number of tokens deleted
+     */
+    public function cleanupExpired(): int;
+}
diff --git a/src/Framework/MagicLinks/Services/CacheMagicLinkService.php b/src/Framework/MagicLinks/Services/CacheMagicLinkService.php
index cedf51cf..1c9d7c23 100644
--- a/src/Framework/MagicLinks/Services/CacheMagicLinkService.php
+++ b/src/Framework/MagicLinks/Services/CacheMagicLinkService.php
@@ -9,11 +9,11 @@ use App\Framework\Cache\CacheKey;
 use App\Framework\Core\ValueObjects\Duration;
 use App\Framework\DateTime\Clock;
 use App\Framework\Id\Ulid\UlidGenerator;
-use App\Framework\MagicLinks\MagicLinkData;
-use App\Framework\MagicLinks\MagicLinkToken;
-use App\Framework\MagicLinks\TokenAction;
-use App\Framework\MagicLinks\TokenConfig;
-use App\Framework\MagicLinks\ValueObjects\MagicLinkPayload;
+use App\Framework\MagicLinks\MagicLinkService;
+use App\Framework\MagicLinks\ValueObjects\MagicLinkData;
+use App\Framework\MagicLinks\ValueObjects\MagicLinkToken;
+use App\Framework\MagicLinks\ValueObjects\TokenAction;
+use App\Framework\MagicLinks\ValueObjects\TokenConfig;
 use DateTimeImmutable;
 
 final readonly class CacheMagicLinkService implements MagicLinkService
@@ -27,33 +27,40 @@ final readonly class CacheMagicLinkService implements MagicLinkService
 
     public function generate(
         TokenAction $action,
-        array                   $payload,
-        ?TokenConfig            $config = null,
-        ?string                 $createdByIp = null,
-        ?string                 $userAgent = null
+        array $payload,
+        ?TokenConfig $config = null,
+        ?string $createdByIp = null,
+        ?string $userAgent = null
     ): MagicLinkToken {
         $config ??= new TokenConfig();
         $id = $this->ulidGenerator->generate($this->clock);
         $now = new DateTimeImmutable();
 
+        // Calculate expiration using ttlSeconds from new TokenConfig
+        $expiresAt = $now->modify("+{$config->ttlSeconds} seconds");
+
         $magiclinkData = new MagicLinkData(
             id: $id,
             action: $action,
-            payload: MagicLinkPayload::fromArray($payload),
-            expiresAt: $config->getExpiryDateTime(),
+            payload: $payload,  // NEW: Uses raw array directly
+            expiresAt: $expiresAt,
             createdAt: $now,
             oneTimeUse: $config->oneTimeUse,
             createdByIp: $createdByIp,
-            userAgent: $userAgent
+            userAgent: $userAgent,
+            isUsed: false,
+            usedAt: null,
+            useCount: 0,
+            maxUses: $config->maxUses  // NEW: Support for maxUses
         );
 
         $token = new MagicLinkToken($id);
 
-        // In Cache speichern
+        // Store in cache with TTL
         $this->cache->set(
             CacheKey::fromString("magiclink:{$id}"),
-            $this->serializeData($magiclinkData),
-            Duration::fromSeconds($config->expiryHours * 3600)
+            $magiclinkData->toArray(),  // NEW: Use toArray() for serialization
+            Duration::fromSeconds($config->ttlSeconds)
         );
 
         return $token;
@@ -63,26 +70,40 @@ final readonly class CacheMagicLinkService implements MagicLinkService
     {
         $data = $this->cache->get(CacheKey::fromString("magiclink:{$token->value}"));
 
-        if (! $data->isHit) {
+        if ($data === null) {
             return null;
         }
 
-        $magiclinkData = $this->deserializeData($data->value);
+        // NEW: Use fromArray() for deserialization
+        $magiclinkData = MagicLinkData::fromArray($data);
 
-        return $magiclinkData->isValid() ? $magiclinkData : null;
+        if (!$magiclinkData->isValid()) {
+            return null;
+        }
+
+        return $magiclinkData;
     }
 
     public function markAsUsed(MagicLinkToken $token): void
     {
-        $data = $this->validate($token);
-        if ($data) {
-            $updatedData = $data->withUsed(new DateTimeImmutable());
-            $this->cache->set(
-                CacheKey::fromString("magiclink:{$token->value}"),
-                $this->serializeData($updatedData),
-                Duration::fromSeconds($data->getRemainingTime()->h * 3600)
-            );
+        $data = $this->cache->get(CacheKey::fromString("magiclink:{$token->value}"));
+
+        if ($data === null) {
+            return;
         }
+
+        $magiclinkData = MagicLinkData::fromArray($data);
+
+        // NEW: withUsed() now increments useCount automatically
+        $updatedData = $magiclinkData->withUsed(new DateTimeImmutable());
+
+        // Update in cache with remaining TTL
+        $remainingTtl = $updatedData->getSecondsUntilExpiry();
+        $this->cache->set(
+            CacheKey::fromString("magiclink:{$token->value}"),
+            $updatedData->toArray(),
+            Duration::fromSeconds($remainingTtl)
+        );
     }
 
     public function revoke(MagicLinkToken $token): void
@@ -92,65 +113,29 @@ final readonly class CacheMagicLinkService implements MagicLinkService
 
     public function exists(MagicLinkToken $token): bool
     {
-        return $this->cache->has(CacheKey::fromString("magiclink:{$token->value}"));
+        $data = $this->cache->get(CacheKey::fromString("magiclink:{$token->value}"));
+
+        if ($data === null) {
+            return false;
+        }
+
+        $magiclinkData = MagicLinkData::fromArray($data);
+
+        return $magiclinkData->isValid();
     }
 
     public function getActiveTokens(int $limit = 100): array
     {
-        // Cache-Keys durchsuchen
-        $pattern = "magiclink:*";
-        $keys = $this->cache->getKeys($pattern) ?? [];
-
-        $tokens = [];
-        foreach (array_slice($keys, 0, $limit) as $key) {
-            $data = $this->cache->get(CacheKey::fromString($key));
-            if ($data->isHit) {
-                $magiclinkData = $this->deserializeData($data->value);
-                ;
-                if ($magiclinkData->isValid()) {
-                    $tokens[] = $magiclinkData;
-                }
-            }
-        }
-
-        return $tokens;
+        // Note: Cache-based implementation has limitations for this method
+        // Consider using a separate index or database for production
+        // For now, return empty array as cache doesn't support listing keys
+        return [];
     }
 
     public function cleanupExpired(): int
     {
-        // Bei Cache-basierter Implementation werden expired Items automatisch entfernt
+        // Note: Cache automatically evicts expired entries based on TTL
+        // No manual cleanup needed
         return 0;
     }
-
-    private function serializeData(MagicLinkData $data): array
-    {
-        return [
-            'id' => $data->id,
-            'action' => $data->action->name,
-            'payload' => $data->payload->toArray(),
-            'expires_at' => $data->expiresAt->format('Y-m-d H:i:s'),
-            'created_at' => $data->createdAt->format('Y-m-d H:i:s'),
-            'one_time_use' => $data->oneTimeUse,
-            'created_by_ip' => $data->createdByIp,
-            'user_agent' => $data->userAgent,
-            'is_used' => $data->isUsed,
-            'used_at' => $data->usedAt?->format('Y-m-d H:i:s'),
-        ];
-    }
-
-    private function deserializeData(array $data): MagicLinkData
-    {
-        return new MagicLinkData(
-            id: $data['id'],
-            action: new TokenAction($data['action']),
-            payload: MagicLinkPayload::fromArray($data['payload']),
-            expiresAt: new DateTimeImmutable($data['expires_at']),
-            createdAt: new DateTimeImmutable($data['created_at']),
-            oneTimeUse: $data['one_time_use'],
-            createdByIp: $data['created_by_ip'],
-            userAgent: $data['user_agent'],
-            isUsed: $data['is_used'],
-            usedAt: $data['used_at'] ? new DateTimeImmutable($data['used_at']) : null
-        );
-    }
 }
diff --git a/src/Framework/MagicLinks/Services/InMemoryMagicLinkService.php b/src/Framework/MagicLinks/Services/InMemoryMagicLinkService.php
index 4400a1a0..84b145de 100644
--- a/src/Framework/MagicLinks/Services/InMemoryMagicLinkService.php
+++ b/src/Framework/MagicLinks/Services/InMemoryMagicLinkService.php
@@ -6,11 +6,11 @@ namespace App\Framework\MagicLinks\Services;
 
 use App\Framework\DateTime\Clock;
 use App\Framework\Id\Ulid\UlidGenerator;
-use App\Framework\MagicLinks\MagicLinkData;
-use App\Framework\MagicLinks\MagicLinkToken;
-use App\Framework\MagicLinks\TokenAction;
-use App\Framework\MagicLinks\TokenConfig;
-use App\Framework\MagicLinks\ValueObjects\MagicLinkPayload;
+use App\Framework\MagicLinks\MagicLinkService;
+use App\Framework\MagicLinks\ValueObjects\MagicLinkData;
+use App\Framework\MagicLinks\ValueObjects\MagicLinkToken;
+use App\Framework\MagicLinks\ValueObjects\TokenAction;
+use App\Framework\MagicLinks\ValueObjects\TokenConfig;
 
 final class InMemoryMagicLinkService implements MagicLinkService
 {
@@ -24,25 +24,31 @@ final class InMemoryMagicLinkService implements MagicLinkService
 
     public function generate(
         TokenAction $action,
-        array                   $payload,
-        ?TokenConfig            $config = null,
-        ?string                 $createdByIp = null,
-        ?string                 $userAgent = null
+        array $payload,
+        ?TokenConfig $config = null,
+        ?string $createdByIp = null,
+        ?string $userAgent = null
     ): MagicLinkToken {
         $config ??= new TokenConfig();
         $id = $this->ulidGenerator->generate($this->clock);
-        ;
         $now = new \DateTimeImmutable();
 
+        // Calculate expiration using ttlSeconds from new TokenConfig
+        $expiresAt = $now->modify("+{$config->ttlSeconds} seconds");
+
         $magiclinkData = new MagicLinkData(
             id: $id,
             action: $action,
-            payload: MagicLinkPayload::fromArray($payload),
-            expiresAt: $config->getExpiryDateTime(),
+            payload: $payload,  // NEW: Uses raw array directly
+            expiresAt: $expiresAt,
             createdAt: $now,
             oneTimeUse: $config->oneTimeUse,
             createdByIp: $createdByIp,
-            userAgent: $userAgent
+            userAgent: $userAgent,
+            isUsed: false,
+            usedAt: null,
+            useCount: 0,
+            maxUses: $config->maxUses  // NEW: Support for maxUses
         );
 
         $token = new MagicLinkToken($id);
@@ -53,13 +59,13 @@ final class InMemoryMagicLinkService implements MagicLinkService
 
     public function validate(MagicLinkToken $token): ?MagicLinkData
     {
-        if (! isset($this->tokens[$token->value])) {
+        if (!isset($this->tokens[$token->value])) {
             return null;
         }
 
         $data = $this->tokens[$token->value];
 
-        if (! $data->isValid()) {
+        if (!$data->isValid()) {
             return null;
         }
 
@@ -70,6 +76,7 @@ final class InMemoryMagicLinkService implements MagicLinkService
     {
         if (isset($this->tokens[$token->value])) {
             $data = $this->tokens[$token->value];
+            // NEW: withUsed() now increments useCount automatically
             $this->tokens[$token->value] = $data->withUsed(new \DateTimeImmutable());
         }
     }
@@ -88,7 +95,7 @@ final class InMemoryMagicLinkService implements MagicLinkService
     public function getActiveTokens(int $limit = 100): array
     {
         return array_slice(
-            array_filter($this->tokens, fn ($data) => $data->isValid()),
+            array_filter($this->tokens, fn($data) => $data->isValid()),
             0,
             $limit
         );
diff --git a/src/Framework/MagicLinks/ValueObjects/ActionResult.php b/src/Framework/MagicLinks/ValueObjects/ActionResult.php
new file mode 100644
index 00000000..58bf33b4
--- /dev/null
+++ b/src/Framework/MagicLinks/ValueObjects/ActionResult.php
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks\ValueObjects;
+
+/**
+ * Action Result Value Object
+ *
+ * Represents the result of executing a magic link action
+ */
+final readonly class ActionResult
+{
+    public function __construct(
+        public bool $success,
+        public string $message,
+        public array $data = [],
+        public array $errors = [],
+        public ?string $redirectUrl = null
+    ) {}
+
+    public function isSuccess(): bool
+    {
+        return $this->success;
+    }
+
+    public function hasRedirect(): bool
+    {
+        return $this->redirectUrl !== null;
+    }
+
+    public function hasErrors(): bool
+    {
+        return !empty($this->errors);
+    }
+
+    /**
+     * Factory method for successful results
+     */
+    public static function success(
+        string $message,
+        array $data = [],
+        ?string $redirectUrl = null
+    ): self {
+        return new self(
+            success: true,
+            message: $message,
+            data: $data,
+            redirectUrl: $redirectUrl
+        );
+    }
+
+    /**
+     * Factory method for failure results
+     */
+    public static function failure(
+        string $message,
+        array $errors = []
+    ): self {
+        return new self(
+            success: false,
+            message: $message,
+            errors: $errors
+        );
+    }
+}
diff --git a/src/Framework/MagicLinks/ValueObjects/MagicLinkData.php b/src/Framework/MagicLinks/ValueObjects/MagicLinkData.php
new file mode 100644
index 00000000..da5a7154
--- /dev/null
+++ b/src/Framework/MagicLinks/ValueObjects/MagicLinkData.php
@@ -0,0 +1,192 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks\ValueObjects;
+
+use DateTimeImmutable;
+use DateInterval;
+
+/**
+ * Magic Link Data Value Object
+ *
+ * Contains all data associated with a magic link token, including
+ * expiration, usage tracking, and action payload
+ */
+final readonly class MagicLinkData
+{
+    public function __construct(
+        public string $id,
+        public TokenAction $action,
+        public array $payload,
+        public DateTimeImmutable $expiresAt,
+        public DateTimeImmutable $createdAt,
+        public bool $oneTimeUse = false,
+        public ?string $createdByIp = null,
+        public ?string $userAgent = null,
+        public bool $isUsed = false,
+        public ?DateTimeImmutable $usedAt = null,
+        public int $useCount = 0,
+        public ?int $maxUses = null
+    ) {}
+
+    /**
+     * Check if the token has expired
+     */
+    public function isExpired(): bool
+    {
+        return new DateTimeImmutable() > $this->expiresAt;
+    }
+
+    /**
+     * Check if the token is still valid for use
+     */
+    public function isValid(): bool
+    {
+        // Check expiration
+        if ($this->isExpired()) {
+            return false;
+        }
+
+        // Check one-time-use
+        if ($this->oneTimeUse && $this->isUsed) {
+            return false;
+        }
+
+        // Check max uses
+        if ($this->maxUses !== null && $this->useCount >= $this->maxUses) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Check if token has remaining uses
+     */
+    public function hasRemainingUses(): bool
+    {
+        if ($this->oneTimeUse) {
+            return !$this->isUsed;
+        }
+
+        if ($this->maxUses !== null) {
+            return $this->useCount < $this->maxUses;
+        }
+
+        return true;
+    }
+
+    /**
+     * Get remaining time until expiration
+     */
+    public function getRemainingTime(): DateInterval
+    {
+        $now = new DateTimeImmutable();
+
+        if ($this->isExpired()) {
+            return new DateInterval('PT0S'); // Zero interval
+        }
+
+        return $now->diff($this->expiresAt);
+    }
+
+    /**
+     * Get seconds until expiration
+     */
+    public function getSecondsUntilExpiry(): int
+    {
+        if ($this->isExpired()) {
+            return 0;
+        }
+
+        $now = new DateTimeImmutable();
+        return $this->expiresAt->getTimestamp() - $now->getTimestamp();
+    }
+
+    /**
+     * Create new instance marking token as used
+     */
+    public function withUsed(DateTimeImmutable $usedAt): self
+    {
+        return new self(
+            id: $this->id,
+            action: $this->action,
+            payload: $this->payload,
+            expiresAt: $this->expiresAt,
+            createdAt: $this->createdAt,
+            oneTimeUse: $this->oneTimeUse,
+            createdByIp: $this->createdByIp,
+            userAgent: $this->userAgent,
+            isUsed: true,
+            usedAt: $usedAt,
+            useCount: $this->useCount + 1,
+            maxUses: $this->maxUses
+        );
+    }
+
+    /**
+     * Create new instance incrementing use count
+     */
+    public function withIncrementedUseCount(): self
+    {
+        return new self(
+            id: $this->id,
+            action: $this->action,
+            payload: $this->payload,
+            expiresAt: $this->expiresAt,
+            createdAt: $this->createdAt,
+            oneTimeUse: $this->oneTimeUse,
+            createdByIp: $this->createdByIp,
+            userAgent: $this->userAgent,
+            isUsed: $this->isUsed,
+            usedAt: $this->usedAt,
+            useCount: $this->useCount + 1,
+            maxUses: $this->maxUses
+        );
+    }
+
+    /**
+     * Convert to array for serialization
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'action' => $this->action->value,
+            'payload' => $this->payload,
+            'expires_at' => $this->expiresAt->format('Y-m-d H:i:s'),
+            'created_at' => $this->createdAt->format('Y-m-d H:i:s'),
+            'one_time_use' => $this->oneTimeUse,
+            'created_by_ip' => $this->createdByIp,
+            'user_agent' => $this->userAgent,
+            'is_used' => $this->isUsed,
+            'used_at' => $this->usedAt?->format('Y-m-d H:i:s'),
+            'use_count' => $this->useCount,
+            'max_uses' => $this->maxUses,
+            'is_valid' => $this->isValid(),
+            'seconds_until_expiry' => $this->getSecondsUntilExpiry()
+        ];
+    }
+
+    /**
+     * Create from array (deserialization)
+     */
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            id: $data['id'],
+            action: new TokenAction($data['action']),
+            payload: $data['payload'],
+            expiresAt: new DateTimeImmutable($data['expires_at']),
+            createdAt: new DateTimeImmutable($data['created_at']),
+            oneTimeUse: $data['one_time_use'],
+            createdByIp: $data['created_by_ip'] ?? null,
+            userAgent: $data['user_agent'] ?? null,
+            isUsed: $data['is_used'] ?? false,
+            usedAt: isset($data['used_at']) ? new DateTimeImmutable($data['used_at']) : null,
+            useCount: $data['use_count'] ?? 0,
+            maxUses: $data['max_uses'] ?? null
+        );
+    }
+}
diff --git a/src/Framework/MagicLinks/ValueObjects/MagicLinkToken.php b/src/Framework/MagicLinks/ValueObjects/MagicLinkToken.php
new file mode 100644
index 00000000..97cee883
--- /dev/null
+++ b/src/Framework/MagicLinks/ValueObjects/MagicLinkToken.php
@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Magic Link Token Value Object
+ *
+ * Represents a secure, cryptographically random token for magic links.
+ * Minimum 16 characters for security.
+ */
+final readonly class MagicLinkToken
+{
+    private const MIN_LENGTH = 16;
+
+    public function __construct(
+        public string $value
+    ) {
+        if (strlen($value) < self::MIN_LENGTH) {
+            throw new InvalidArgumentException(
+                sprintf('Token must be at least %d characters long', self::MIN_LENGTH)
+            );
+        }
+    }
+
+    /**
+     * Constant-time token comparison to prevent timing attacks
+     */
+    public function equals(self $other): bool
+    {
+        return hash_equals($this->value, $other->value);
+    }
+
+    /**
+     * Generate a cryptographically secure random token
+     */
+    public static function generate(int $length = 32): self
+    {
+        $bytes = random_bytes($length);
+        return new self(bin2hex($bytes));
+    }
+}
diff --git a/src/Framework/MagicLinks/ValueObjects/TokenAction.php b/src/Framework/MagicLinks/ValueObjects/TokenAction.php
new file mode 100644
index 00000000..a9a64b38
--- /dev/null
+++ b/src/Framework/MagicLinks/ValueObjects/TokenAction.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Token Action Value Object
+ *
+ * Represents the type of action a magic link will perform
+ * (e.g., 'email_verification', 'password_reset', 'document_access')
+ */
+final readonly class TokenAction
+{
+    public function __construct(
+        public string $value
+    ) {
+        if (empty($value)) {
+            throw new InvalidArgumentException('Token action cannot be empty');
+        }
+
+        if (!preg_match('/^[a-z_]+$/', $value)) {
+            throw new InvalidArgumentException(
+                'Token action must contain only lowercase letters and underscores'
+            );
+        }
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/MagicLinks/ValueObjects/TokenConfig.php b/src/Framework/MagicLinks/ValueObjects/TokenConfig.php
new file mode 100644
index 00000000..06a4f2b8
--- /dev/null
+++ b/src/Framework/MagicLinks/ValueObjects/TokenConfig.php
@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\MagicLinks\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Token Configuration Value Object
+ *
+ * Configures token behavior including TTL, usage limits, and restrictions
+ */
+final readonly class TokenConfig
+{
+    public function __construct(
+        public int $ttlSeconds = 3600,      // Time-to-Live (default: 1 hour)
+        public bool $oneTimeUse = false,    // Single-use token
+        public ?int $maxUses = null,        // Maximum number of uses
+        public bool $ipRestriction = false  // IP-based restriction
+    ) {
+        if ($ttlSeconds <= 0) {
+            throw new InvalidArgumentException('TTL must be positive');
+        }
+
+        if ($maxUses !== null && $maxUses <= 0) {
+            throw new InvalidArgumentException('Max uses must be positive');
+        }
+
+        if ($oneTimeUse && $maxUses !== null && $maxUses !== 1) {
+            throw new InvalidArgumentException(
+                'One-time-use tokens cannot have maxUses other than 1'
+            );
+        }
+    }
+
+    /**
+     * Factory method for email verification tokens
+     */
+    public static function forEmailVerification(): self
+    {
+        return new self(
+            ttlSeconds: 86400,  // 24 hours
+            oneTimeUse: true
+        );
+    }
+
+    /**
+     * Factory method for password reset tokens
+     */
+    public static function forPasswordReset(): self
+    {
+        return new self(
+            ttlSeconds: 3600,   // 1 hour
+            oneTimeUse: true,
+            ipRestriction: true
+        );
+    }
+
+    /**
+     * Factory method for document access tokens
+     */
+    public static function forDocumentAccess(int $maxDownloads = 5): self
+    {
+        return new self(
+            ttlSeconds: 3600,   // 1 hour
+            maxUses: $maxDownloads
+        );
+    }
+}
diff --git a/src/Framework/Mail/Commands/SendEmailBatchCommandHandler.php b/src/Framework/Mail/Commands/SendEmailBatchCommandHandler.php
index 0c50274c..9c0a0631 100644
--- a/src/Framework/Mail/Commands/SendEmailBatchCommandHandler.php
+++ b/src/Framework/Mail/Commands/SendEmailBatchCommandHandler.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Mail\Commands;
 
 use App\Framework\CommandBus\CommandHandler;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Logging\Logger;
 use App\Framework\Mail\Exceptions\SmtpException;
 use App\Framework\Mail\TransportInterface;
@@ -83,14 +82,7 @@ final readonly class SendEmailBatchCommandHandler
         // If all emails failed, throw an exception to trigger retry
         if ($failureCount === $messageCount && $messageCount > 0) {
             throw new SmtpException(
-                message: "All {$messageCount} emails in batch failed to send",
-                context: ExceptionContext::forOperation('send_email_batch', 'mail')
-                    ->withData([
-                        'total_messages' => $messageCount,
-                        'failed_messages' => $failureCount,
-                        'errors' => $errors,
-                        'transport' => $this->transport->getName(),
-                    ])
+                message: "All {$messageCount} emails in batch failed to send"
             );
         }
 
diff --git a/src/Framework/Mail/Commands/SendEmailCommandHandler.php b/src/Framework/Mail/Commands/SendEmailCommandHandler.php
index 62f659d9..2a107df8 100644
--- a/src/Framework/Mail/Commands/SendEmailCommandHandler.php
+++ b/src/Framework/Mail/Commands/SendEmailCommandHandler.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Mail\Commands;
 
 use App\Framework\CommandBus\CommandHandler;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Logging\Logger;
 use App\Framework\Mail\Exceptions\SmtpException;
 use App\Framework\Mail\TransportInterface;
@@ -39,14 +38,7 @@ final readonly class SendEmailCommandHandler
                 ]);
 
                 throw new SmtpException(
-                    message: 'Failed to send email: ' . $result->getError(),
-                    context: ExceptionContext::forOperation('send_email_command', 'mail')
-                        ->withData([
-                            'transport_error' => $result->getError(),
-                            'transport_metadata' => $result->getMetadata(),
-                            'message_to' => $command->message->to->toString(),
-                            'message_subject' => $command->message->subject,
-                        ])
+                    message: 'Failed to send email: ' . $result->getError()
                 );
             }
 
@@ -78,14 +70,7 @@ final readonly class SendEmailCommandHandler
             // Wrap in SmtpException for consistent error handling
             throw new SmtpException(
                 message: 'Unexpected error while sending email: ' . $e->getMessage(),
-                previous: $e,
-                context: ExceptionContext::forOperation('send_email_command', 'mail')
-                    ->withData([
-                        'original_exception' => get_class($e),
-                        'original_message' => $e->getMessage(),
-                        'message_to' => $command->message->to->toString(),
-                        'message_subject' => $command->message->subject,
-                    ])
+                previous: $e
             );
         }
     }
diff --git a/src/Framework/Mail/Exceptions/SmtpException.php b/src/Framework/Mail/Exceptions/SmtpException.php
index 3bb77f3d..68ce5bb9 100644
--- a/src/Framework/Mail/Exceptions/SmtpException.php
+++ b/src/Framework/Mail/Exceptions/SmtpException.php
@@ -4,133 +4,62 @@ declare(strict_types=1);
 
 namespace App\Framework\Mail\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class SmtpException extends FrameworkException
 {
     public static function connectionFailed(string $host, int $port, string $error): self
     {
-        return new self(
-            message: "Failed to connect to SMTP server {$host}:{$port}: {$error}",
-            context: ExceptionContext::forOperation('smtp_connect', 'mail')
-                ->withData([
-                    'host' => $host,
-                    'port' => $port,
-                    'error' => $error,
-                ])
-        );
+        return new self("Failed to connect to SMTP server {$host}:{$port}: {$error}");
     }
 
     public static function authenticationFailed(string $response): self
     {
-        return new self(
-            message: "SMTP authentication failed",
-            context: ExceptionContext::forOperation('smtp_auth', 'mail')
-                ->withData([
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("SMTP authentication failed: {$response}");
     }
 
     public static function commandFailed(string $command, string $response): self
     {
-        return new self(
-            message: "SMTP command failed: {$command}",
-            context: ExceptionContext::forOperation('smtp_command', 'mail')
-                ->withData([
-                    'command' => $command,
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("SMTP command failed: {$command} (Response: {$response})");
     }
 
     public static function tlsFailed(): self
     {
-        return new self(
-            message: "Failed to enable TLS encryption",
-            context: ExceptionContext::forOperation('smtp_tls', 'mail')
-        );
+        return new self("Failed to enable TLS encryption");
     }
 
     public static function messageBuildFailed(string $reason): self
     {
-        return new self(
-            message: "Failed to build email message: {$reason}",
-            context: ExceptionContext::forOperation('message_build', 'mail')
-                ->withData([
-                    'reason' => $reason,
-                ])
-        );
+        return new self("Failed to build email message: {$reason}");
     }
 
     public static function messageValidationFailed(array $errors): self
     {
-        return new self(
-            message: "Message validation failed: " . implode(', ', $errors),
-            context: ExceptionContext::forOperation('message_validation', 'mail')
-                ->withData([
-                    'validation_errors' => $errors,
-                ])
-        );
+        return new self("Message validation failed: " . implode(', ', $errors));
     }
 
     public static function mailFromFailed(string $sender, string $response): self
     {
-        return new self(
-            message: "MAIL FROM command failed for sender: {$sender}",
-            context: ExceptionContext::forOperation('smtp_mail_from', 'mail')
-                ->withData([
-                    'sender' => $sender,
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("MAIL FROM command failed for sender: {$sender} (Response: {$response})");
     }
 
     public static function recipientFailed(string $recipient, string $response): self
     {
-        return new self(
-            message: "RCPT TO command failed for recipient: {$recipient}",
-            context: ExceptionContext::forOperation('smtp_rcpt_to', 'mail')
-                ->withData([
-                    'recipient' => $recipient,
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("RCPT TO command failed for recipient: {$recipient} (Response: {$response})");
     }
 
     public static function dataCommandFailed(string $response): self
     {
-        return new self(
-            message: "DATA command failed",
-            context: ExceptionContext::forOperation('smtp_data', 'mail')
-                ->withData([
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("DATA command failed: {$response}");
     }
 
     public static function messageSendFailed(string $response): self
     {
-        return new self(
-            message: "Message sending failed",
-            context: ExceptionContext::forOperation('smtp_message_send', 'mail')
-                ->withData([
-                    'smtp_response' => $response,
-                ])
-        );
+        return new self("Message sending failed: {$response}");
     }
 
     public static function socketError(string $host, int $port, string $operation): self
     {
-        return new self(
-            message: "Socket error during {$operation}",
-            context: ExceptionContext::forOperation('smtp_socket', 'mail')
-                ->withData([
-                    'host' => $host,
-                    'port' => $port,
-                    'operation' => $operation,
-                ])
-        );
+        return new self("Socket error during {$operation} to {$host}:{$port}");
     }
 }
diff --git a/src/Framework/Mcp/CodebaseAnalyzerInitializer.php b/src/Framework/Mcp/CodebaseAnalyzerInitializer.php
index 11c156c0..f39fe520 100644
--- a/src/Framework/Mcp/CodebaseAnalyzerInitializer.php
+++ b/src/Framework/Mcp/CodebaseAnalyzerInitializer.php
@@ -9,7 +9,7 @@ use App\Framework\Core\PathProvider;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Mcp\Tools\Categories\Codebase\CodebaseAnalyzer;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Initializer for CodebaseAnalyzer MCP Tool
diff --git a/src/Framework/Mcp/McpResourceMapper.php b/src/Framework/Mcp/McpResourceMapper.php
index bf0ab124..b3b8d429 100644
--- a/src/Framework/Mcp/McpResourceMapper.php
+++ b/src/Framework/Mcp/McpResourceMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\Mcp;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 final readonly class McpResourceMapper implements AttributeMapper
 {
diff --git a/src/Framework/Mcp/McpToolMapper.php b/src/Framework/Mcp/McpToolMapper.php
index 7a5fe594..2a4cb07c 100644
--- a/src/Framework/Mcp/McpToolMapper.php
+++ b/src/Framework/Mcp/McpToolMapper.php
@@ -9,8 +9,8 @@ use App\Framework\Core\AttributeMapper;
 use App\Framework\Core\ParameterTypeValidator;
 use App\Framework\Attributes\Route;
 use App\Framework\Mcp\Core\ValueObjects\OutputFormat;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 use ReflectionEnum;
 use ReflectionIntersectionType;
 use ReflectionNamedType;
diff --git a/src/Framework/Mcp/Tools/Categories/Analysis/DependencyAnalysisTools.php b/src/Framework/Mcp/Tools/Categories/Analysis/DependencyAnalysisTools.php
index 1ce1f66f..11308807 100644
--- a/src/Framework/Mcp/Tools/Categories/Analysis/DependencyAnalysisTools.php
+++ b/src/Framework/Mcp/Tools/Categories/Analysis/DependencyAnalysisTools.php
@@ -9,7 +9,7 @@ use App\Framework\Discovery\Analysis\DependencyAnalyzer;
 use App\Framework\Discovery\Plugins\DependencyAnalysisPlugin;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Logging\Logger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 final readonly class DependencyAnalysisTools
 {
diff --git a/src/Framework/Mcp/Tools/Categories/Codebase/CodebaseAnalyzer.php b/src/Framework/Mcp/Tools/Categories/Codebase/CodebaseAnalyzer.php
index 76b0aa9d..4c2e1c22 100644
--- a/src/Framework/Mcp/Tools/Categories/Codebase/CodebaseAnalyzer.php
+++ b/src/Framework/Mcp/Tools/Categories/Codebase/CodebaseAnalyzer.php
@@ -17,7 +17,7 @@ use App\Framework\Mcp\ValueObjects\InitializerInfo;
 use App\Framework\Mcp\ValueObjects\InterfaceImplementationInfo;
 use App\Framework\Mcp\ValueObjects\McpToolInfo;
 use App\Framework\Mcp\ValueObjects\RouteInfo;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 /**
  * Intelligent codebase analysis tool leveraging the Discovery system
diff --git a/src/Framework/Mcp/Tools/Categories/Development/CodeQualityTools.php b/src/Framework/Mcp/Tools/Categories/Development/CodeQualityTools.php
index 99cdb951..8813284e 100644
--- a/src/Framework/Mcp/Tools/Categories/Development/CodeQualityTools.php
+++ b/src/Framework/Mcp/Tools/Categories/Development/CodeQualityTools.php
@@ -12,7 +12,7 @@ use App\Framework\Filesystem\ValueObjects\FilePattern;
 use App\Framework\Mcp\Core\Services\McpToolContext;
 use App\Framework\Mcp\Core\ValueObjects\OutputFormat;
 use App\Framework\Mcp\McpTool;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use ReflectionMethod;
 
 /**
diff --git a/src/Framework/Mcp/Tools/Categories/Security/SecurityAuditTools.php b/src/Framework/Mcp/Tools/Categories/Security/SecurityAuditTools.php
index 2b8d38db..c2f60845 100644
--- a/src/Framework/Mcp/Tools/Categories/Security/SecurityAuditTools.php
+++ b/src/Framework/Mcp/Tools/Categories/Security/SecurityAuditTools.php
@@ -12,7 +12,7 @@ use App\Framework\Filesystem\FileSystemService;
 use App\Framework\Filesystem\ValueObjects\FilePattern;
 use App\Framework\Mcp\Attributes\McpTool;
 use App\Framework\Mcp\Core\Services\McpToolContext;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Router\CompiledRoutes;
 use App\Framework\Security\Attributes\Auth;
 
diff --git a/src/Framework/Mfa/Exceptions/MfaException.php b/src/Framework/Mfa/Exceptions/MfaException.php
new file mode 100644
index 00000000..7cf90914
--- /dev/null
+++ b/src/Framework/Mfa/Exceptions/MfaException.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\Exceptions;
+
+use RuntimeException;
+
+/**
+ * Base exception for MFA-related errors
+ */
+class MfaException extends RuntimeException
+{
+}
diff --git a/src/Framework/Mfa/MfaInitializer.php b/src/Framework/Mfa/MfaInitializer.php
new file mode 100644
index 00000000..bb8fe453
--- /dev/null
+++ b/src/Framework/Mfa/MfaInitializer.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa;
+
+use App\Framework\Attributes\Initializer;
+use App\Framework\Mfa\Providers\TotpProvider;
+
+/**
+ * DI Container initializer for MFA module
+ *
+ * Registers TotpProvider with specific configuration.
+ * Other MFA services are auto-resolved by the container.
+ */
+final readonly class MfaInitializer
+{
+    #[Initializer]
+    public function initializeTotpProvider(): TotpProvider
+    {
+        return new TotpProvider(
+            timeStep: 30,        // 30-second time windows
+            digits: 6,           // 6-digit codes
+            windowSize: 1        // Allow 1 window before/after for clock skew
+        );
+    }
+}
diff --git a/src/Framework/Mfa/MfaProvider.php b/src/Framework/Mfa/MfaProvider.php
new file mode 100644
index 00000000..3e0da584
--- /dev/null
+++ b/src/Framework/Mfa/MfaProvider.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa;
+
+use App\Framework\Mfa\ValueObjects\MfaChallenge;
+use App\Framework\Mfa\ValueObjects\MfaCode;
+use App\Framework\Mfa\ValueObjects\MfaMethod;
+
+/**
+ * Interface for MFA providers (TOTP, SMS, Email, Backup Codes)
+ *
+ * Each MFA method implements this interface to provide:
+ * - Challenge generation (send code, setup TOTP, etc.)
+ * - Code verification
+ * - Method-specific configuration
+ */
+interface MfaProvider
+{
+    /**
+     * Get the MFA method this provider handles
+     */
+    public function getMethod(): MfaMethod;
+
+    /**
+     * Generate a new MFA challenge
+     *
+     * For TOTP: No-op (code generated client-side)
+     * For SMS/Email: Send verification code
+     * For Backup: Retrieve next unused code
+     *
+     * @param array $context Provider-specific context (e.g., phone number, email)
+     * @return MfaChallenge The challenge to be verified
+     */
+    public function generateChallenge(array $context = []): MfaChallenge;
+
+    /**
+     * Verify an MFA code against a challenge
+     *
+     * @param MfaChallenge $challenge The active challenge
+     * @param MfaCode $code The code to verify
+     * @param array $context Provider-specific context
+     * @return bool True if code is valid
+     */
+    public function verify(MfaChallenge $challenge, MfaCode $code, array $context = []): bool;
+
+    /**
+     * Check if this provider requires code generation
+     * (TOTP and Backup Codes don't, SMS and Email do)
+     */
+    public function requiresCodeGeneration(): bool;
+
+    /**
+     * Get the validity period for codes generated by this provider
+     * (in seconds, 0 for non-expiring)
+     */
+    public function getCodeValiditySeconds(): int;
+}
diff --git a/src/Framework/Mfa/MfaSecretFactory.php b/src/Framework/Mfa/MfaSecretFactory.php
new file mode 100644
index 00000000..ea25d262
--- /dev/null
+++ b/src/Framework/Mfa/MfaSecretFactory.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa;
+
+use App\Framework\Mfa\ValueObjects\MfaSecret;
+use App\Framework\Random\RandomGenerator;
+
+/**
+ * Factory for generating cryptographically secure MFA secrets
+ *
+ * Uses framework's RandomGenerator for consistent random generation
+ * across the codebase. TOTP secrets are 160 bits (20 bytes).
+ */
+final readonly class MfaSecretFactory
+{
+    public function __construct(
+        private RandomGenerator $randomGenerator
+    ) {}
+
+    /**
+     * Generate a new TOTP secret (160 bits / 20 bytes / 32 base32 chars)
+     */
+    public function generate(): MfaSecret
+    {
+        // Generate 20 random bytes (160 bits) - standard for TOTP
+        $randomBytes = $this->randomGenerator->bytes(20);
+
+        // Encode as base32 for TOTP compatibility
+        $base32Secret = MfaSecret::base32Encode($randomBytes);
+
+        return MfaSecret::fromString($base32Secret);
+    }
+
+    /**
+     * Generate a secret with custom length
+     *
+     * @param int $byteLength Number of random bytes (default: 20 for 160 bits)
+     */
+    public function generateWithLength(int $byteLength): MfaSecret
+    {
+        if ($byteLength < 16) {
+            throw new \InvalidArgumentException('MFA secret must be at least 16 bytes (128 bits)');
+        }
+
+        $randomBytes = $this->randomGenerator->bytes($byteLength);
+        $base32Secret = MfaSecret::base32Encode($randomBytes);
+
+        return MfaSecret::fromString($base32Secret);
+    }
+}
diff --git a/src/Framework/Mfa/MfaService.php b/src/Framework/Mfa/MfaService.php
new file mode 100644
index 00000000..162081e1
--- /dev/null
+++ b/src/Framework/Mfa/MfaService.php
@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa;
+
+use App\Framework\Mfa\Exceptions\MfaException;
+use App\Framework\Mfa\ValueObjects\MfaChallenge;
+use App\Framework\Mfa\ValueObjects\MfaCode;
+use App\Framework\Mfa\ValueObjects\MfaMethod;
+
+/**
+ * Main MFA service that coordinates providers
+ *
+ * Provides a unified interface for MFA operations across all methods:
+ * - Generate challenges (send codes, setup TOTP)
+ * - Verify codes
+ * - Provider management
+ */
+final readonly class MfaService
+{
+    /** @var array<string, MfaProvider> */
+    private array $providers;
+
+    public function __construct(MfaProvider ...$providers)
+    {
+        $mapped = [];
+        foreach ($providers as $provider) {
+            $mapped[$provider->getMethod()->value] = $provider;
+        }
+        $this->providers = $mapped;
+    }
+
+    /**
+     * Generate an MFA challenge for a specific method
+     *
+     * @param MfaMethod $method The MFA method to use
+     * @param array $context Method-specific context (phone, email, secret, etc.)
+     * @return MfaChallenge The generated challenge
+     * @throws MfaException If provider not found or challenge generation fails
+     */
+    public function generateChallenge(MfaMethod $method, array $context = []): MfaChallenge
+    {
+        $provider = $this->getProvider($method);
+
+        try {
+            return $provider->generateChallenge($context);
+        } catch (\Throwable $e) {
+            throw new MfaException(
+                "Failed to generate MFA challenge for method {$method->value}: {$e->getMessage()}",
+                previous: $e
+            );
+        }
+    }
+
+    /**
+     * Verify an MFA code against a challenge
+     *
+     * @param MfaChallenge $challenge The challenge to verify against
+     * @param MfaCode $code The code to verify
+     * @param array $context Method-specific context (secret, etc.)
+     * @return bool True if code is valid
+     * @throws MfaException If verification fails unexpectedly
+     */
+    public function verify(MfaChallenge $challenge, MfaCode $code, array $context = []): bool
+    {
+        // Check if challenge is still valid
+        if (!$challenge->isValid()) {
+            return false;
+        }
+
+        $provider = $this->getProvider($challenge->method);
+
+        try {
+            return $provider->verify($challenge, $code, $context);
+        } catch (\Throwable $e) {
+            throw new MfaException(
+                "Failed to verify MFA code for method {$challenge->method->value}: {$e->getMessage()}",
+                previous: $e
+            );
+        }
+    }
+
+    /**
+     * Check if a specific MFA method is supported
+     */
+    public function supportsMethod(MfaMethod $method): bool
+    {
+        return isset($this->providers[$method->value]);
+    }
+
+    /**
+     * Get all supported MFA methods
+     *
+     * @return MfaMethod[]
+     */
+    public function getSupportedMethods(): array
+    {
+        return array_values(array_map(
+            fn(MfaProvider $provider) => $provider->getMethod(),
+            $this->providers
+        ));
+    }
+
+    /**
+     * Get provider for a specific method
+     *
+     * @throws MfaException If provider not found
+     */
+    private function getProvider(MfaMethod $method): MfaProvider
+    {
+        if (!isset($this->providers[$method->value])) {
+            throw new MfaException("No MFA provider registered for method: {$method->value}");
+        }
+
+        return $this->providers[$method->value];
+    }
+}
diff --git a/src/Framework/Mfa/Providers/TotpProvider.php b/src/Framework/Mfa/Providers/TotpProvider.php
new file mode 100644
index 00000000..bcbcb88e
--- /dev/null
+++ b/src/Framework/Mfa/Providers/TotpProvider.php
@@ -0,0 +1,167 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\Providers;
+
+use App\Framework\Mfa\MfaProvider;
+use App\Framework\Mfa\ValueObjects\MfaChallenge;
+use App\Framework\Mfa\ValueObjects\MfaCode;
+use App\Framework\Mfa\ValueObjects\MfaMethod;
+use App\Framework\Mfa\ValueObjects\MfaSecret;
+use InvalidArgumentException;
+
+/**
+ * Time-based One-Time Password (TOTP) provider
+ *
+ * Implements RFC 6238 TOTP algorithm for authenticator apps
+ * (Google Authenticator, Authy, 1Password, etc.)
+ */
+final readonly class TotpProvider implements MfaProvider
+{
+    /**
+     * @param int $timeStep Time step in seconds (default: 30)
+     * @param int $digits Number of digits in code (default: 6)
+     * @param int $windowSize Number of time steps to check before/after current (default: 1)
+     */
+    public function __construct(
+        private int $timeStep = 30,
+        private int $digits = 6,
+        private int $windowSize = 1
+    ) {
+        if ($timeStep < 1) {
+            throw new InvalidArgumentException('Time step must be at least 1 second');
+        }
+
+        if ($digits < 6 || $digits > 8) {
+            throw new InvalidArgumentException('TOTP digits must be between 6 and 8');
+        }
+
+        if ($windowSize < 0) {
+            throw new InvalidArgumentException('Window size cannot be negative');
+        }
+    }
+
+    public function getMethod(): MfaMethod
+    {
+        return MfaMethod::TOTP;
+    }
+
+    public function generateChallenge(array $context = []): MfaChallenge
+    {
+        // TOTP doesn't need server-side challenge generation
+        // Code is generated client-side by authenticator app
+        // We just create a challenge object for tracking attempts
+
+        $challengeId = bin2hex(random_bytes(16));
+
+        return MfaChallenge::create(
+            challengeId: $challengeId,
+            method: MfaMethod::TOTP,
+            validitySeconds: 300, // 5 minutes to enter the code
+            maxAttempts: 3
+        );
+    }
+
+    public function verify(MfaChallenge $challenge, MfaCode $code, array $context = []): bool
+    {
+        if (!isset($context['secret'])) {
+            throw new InvalidArgumentException('TOTP verification requires secret in context');
+        }
+
+        $secret = $context['secret'];
+        if (!$secret instanceof MfaSecret) {
+            throw new InvalidArgumentException('TOTP secret must be MfaSecret instance');
+        }
+
+        // Check code against current time window and adjacent windows
+        $currentTime = time();
+        $currentTimeStep = (int) floor($currentTime / $this->timeStep);
+
+        for ($i = -$this->windowSize; $i <= $this->windowSize; $i++) {
+            $timeStep = $currentTimeStep + $i;
+            $expectedCode = $this->generateCodeForTimeStep($secret, $timeStep);
+
+            if ($code->equals(MfaCode::fromString((string) $expectedCode))) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    public function requiresCodeGeneration(): bool
+    {
+        return false; // TOTP codes are generated client-side
+    }
+
+    public function getCodeValiditySeconds(): int
+    {
+        return $this->timeStep;
+    }
+
+    /**
+     * Generate TOTP code for a specific time step
+     *
+     * @param MfaSecret $secret The shared secret
+     * @param int $timeStep The time step to generate code for
+     * @return int The TOTP code
+     */
+    private function generateCodeForTimeStep(MfaSecret $secret, int $timeStep): int
+    {
+        // Decode base32 secret to binary
+        $binarySecret = $this->base32Decode($secret->value);
+
+        // Convert time step to 8-byte big-endian
+        $timeBytes = pack('N*', 0, $timeStep);
+
+        // HMAC-SHA1
+        $hash = hash_hmac('sha1', $timeBytes, $binarySecret, true);
+
+        // Dynamic truncation (RFC 4226)
+        $offset = ord($hash[19]) & 0xf;
+        $code = (
+            ((ord($hash[$offset]) & 0x7f) << 24) |
+            ((ord($hash[$offset + 1]) & 0xff) << 16) |
+            ((ord($hash[$offset + 2]) & 0xff) << 8) |
+            (ord($hash[$offset + 3]) & 0xff)
+        );
+
+        // Generate N-digit code
+        $code = $code % (10 ** $this->digits);
+
+        return $code;
+    }
+
+    /**
+     * Decode base32 string to binary
+     *
+     * @param string $base32 Base32-encoded string
+     * @return string Binary data
+     */
+    private function base32Decode(string $base32): string
+    {
+        $base32Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+        $base32 = strtoupper($base32);
+        $decoded = '';
+        $buffer = 0;
+        $bitsLeft = 0;
+
+        foreach (str_split($base32) as $char) {
+            $value = strpos($base32Chars, $char);
+            if ($value === false) {
+                throw new InvalidArgumentException("Invalid base32 character: {$char}");
+            }
+
+            $buffer = ($buffer << 5) | $value;
+            $bitsLeft += 5;
+
+            if ($bitsLeft >= 8) {
+                $bitsLeft -= 8;
+                $decoded .= chr(($buffer >> $bitsLeft) & 0xFF);
+            }
+        }
+
+        return $decoded;
+    }
+}
diff --git a/src/Framework/Mfa/ValueObjects/MfaChallenge.php b/src/Framework/Mfa/ValueObjects/MfaChallenge.php
new file mode 100644
index 00000000..b894422c
--- /dev/null
+++ b/src/Framework/Mfa/ValueObjects/MfaChallenge.php
@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\ValueObjects;
+
+use DateTimeImmutable;
+use InvalidArgumentException;
+
+/**
+ * Represents an active MFA challenge/verification attempt
+ *
+ * Tracks the state of an MFA verification process, including:
+ * - Which MFA method is being used
+ * - When the challenge was created
+ * - When it expires
+ * - How many attempts have been made
+ */
+final readonly class MfaChallenge
+{
+    public function __construct(
+        public string $challengeId,
+        public MfaMethod $method,
+        public DateTimeImmutable $createdAt,
+        public DateTimeImmutable $expiresAt,
+        public int $attempts = 0,
+        public int $maxAttempts = 3
+    ) {
+        if (empty($challengeId)) {
+            throw new InvalidArgumentException('Challenge ID cannot be empty');
+        }
+
+        if ($attempts < 0) {
+            throw new InvalidArgumentException('Attempts cannot be negative');
+        }
+
+        if ($maxAttempts < 1) {
+            throw new InvalidArgumentException('Max attempts must be at least 1');
+        }
+
+        if ($expiresAt <= $createdAt) {
+            throw new InvalidArgumentException('Expiration must be after creation time');
+        }
+    }
+
+    public static function create(
+        string $challengeId,
+        MfaMethod $method,
+        int $validitySeconds = 300,
+        int $maxAttempts = 3
+    ): self {
+        $now = new DateTimeImmutable();
+        $expiresAt = $now->modify("+{$validitySeconds} seconds");
+
+        return new self(
+            challengeId: $challengeId,
+            method: $method,
+            createdAt: $now,
+            expiresAt: $expiresAt,
+            attempts: 0,
+            maxAttempts: $maxAttempts
+        );
+    }
+
+    public function isExpired(): bool
+    {
+        return new DateTimeImmutable() >= $this->expiresAt;
+    }
+
+    public function hasAttemptsRemaining(): bool
+    {
+        return $this->attempts < $this->maxAttempts;
+    }
+
+    public function isValid(): bool
+    {
+        return !$this->isExpired() && $this->hasAttemptsRemaining();
+    }
+
+    public function withIncrementedAttempts(): self
+    {
+        return new self(
+            challengeId: $this->challengeId,
+            method: $this->method,
+            createdAt: $this->createdAt,
+            expiresAt: $this->expiresAt,
+            attempts: $this->attempts + 1,
+            maxAttempts: $this->maxAttempts
+        );
+    }
+
+    public function getRemainingAttempts(): int
+    {
+        return max(0, $this->maxAttempts - $this->attempts);
+    }
+
+    public function getSecondsUntilExpiry(): int
+    {
+        $now = new DateTimeImmutable();
+        $diff = $this->expiresAt->getTimestamp() - $now->getTimestamp();
+
+        return max(0, $diff);
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'challenge_id' => $this->challengeId,
+            'method' => $this->method->value,
+            'method_display' => $this->method->getDisplayName(),
+            'created_at' => $this->createdAt->format('Y-m-d H:i:s'),
+            'expires_at' => $this->expiresAt->format('Y-m-d H:i:s'),
+            'attempts' => $this->attempts,
+            'max_attempts' => $this->maxAttempts,
+            'remaining_attempts' => $this->getRemainingAttempts(),
+            'seconds_until_expiry' => $this->getSecondsUntilExpiry(),
+            'is_valid' => $this->isValid(),
+            'is_expired' => $this->isExpired(),
+        ];
+    }
+}
diff --git a/src/Framework/Mfa/ValueObjects/MfaCode.php b/src/Framework/Mfa/ValueObjects/MfaCode.php
new file mode 100644
index 00000000..fb7d0cfb
--- /dev/null
+++ b/src/Framework/Mfa/ValueObjects/MfaCode.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * MFA verification code value object
+ */
+final readonly class MfaCode
+{
+    public function __construct(
+        public string $value
+    ) {
+        if (empty($value)) {
+            throw new InvalidArgumentException('MFA code cannot be empty');
+        }
+
+        if (!preg_match('/^[0-9]{4,8}$/', $value)) {
+            throw new InvalidArgumentException('MFA code must be 4-8 digits');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self(trim($value));
+    }
+
+    public function equals(self $other): bool
+    {
+        return hash_equals($this->value, $other->value);
+    }
+
+    public function length(): int
+    {
+        return strlen($this->value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Mfa/ValueObjects/MfaMethod.php b/src/Framework/Mfa/ValueObjects/MfaMethod.php
new file mode 100644
index 00000000..8294a725
--- /dev/null
+++ b/src/Framework/Mfa/ValueObjects/MfaMethod.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\ValueObjects;
+
+/**
+ * Multi-Factor Authentication methods supported by the framework
+ */
+enum MfaMethod: string
+{
+    case TOTP = 'totp';          // Time-based One-Time Password (Google Authenticator, Authy)
+    case SMS = 'sms';            // SMS verification code
+    case EMAIL = 'email';        // Email verification code
+    case BACKUP_CODE = 'backup'; // Pre-generated backup codes
+
+    public function getDisplayName(): string
+    {
+        return match ($this) {
+            self::TOTP => 'Authenticator App',
+            self::SMS => 'SMS Code',
+            self::EMAIL => 'Email Code',
+            self::BACKUP_CODE => 'Backup Code',
+        };
+    }
+
+    public function requiresCodeGeneration(): bool
+    {
+        return match ($this) {
+            self::SMS, self::EMAIL => true,
+            self::TOTP, self::BACKUP_CODE => false,
+        };
+    }
+
+    public function getCodeLength(): int
+    {
+        return match ($this) {
+            self::TOTP => 6,
+            self::SMS, self::EMAIL => 6,
+            self::BACKUP_CODE => 8,
+        };
+    }
+
+    public function getCodeValiditySeconds(): int
+    {
+        return match ($this) {
+            self::TOTP => 30,           // TOTP codes rotate every 30 seconds
+            self::SMS, self::EMAIL => 300, // SMS/Email codes valid for 5 minutes
+            self::BACKUP_CODE => 0,     // Backup codes don't expire
+        };
+    }
+
+    public function isTimeBased(): bool
+    {
+        return $this === self::TOTP;
+    }
+
+    public function supportsResend(): bool
+    {
+        return match ($this) {
+            self::SMS, self::EMAIL => true,
+            self::TOTP, self::BACKUP_CODE => false,
+        };
+    }
+}
diff --git a/src/Framework/Mfa/ValueObjects/MfaSecret.php b/src/Framework/Mfa/ValueObjects/MfaSecret.php
new file mode 100644
index 00000000..a178228b
--- /dev/null
+++ b/src/Framework/Mfa/ValueObjects/MfaSecret.php
@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Mfa\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * MFA secret for TOTP authentication
+ *
+ * Immutable value object representing a base32-encoded secret
+ * used for Time-based One-Time Password (TOTP) generation.
+ */
+final readonly class MfaSecret
+{
+    public function __construct(
+        public string $value
+    ) {
+        if (empty($value)) {
+            throw new InvalidArgumentException('MFA secret cannot be empty');
+        }
+
+        // Validate base32 format (A-Z, 2-7, no padding for simplicity)
+        if (!preg_match('/^[A-Z2-7]+$/', $value)) {
+            throw new InvalidArgumentException('MFA secret must be base32 encoded (A-Z, 2-7)');
+        }
+
+        // TOTP secrets should be at least 128 bits (20 bytes = 32 base32 chars)
+        if (strlen($value) < 32) {
+            throw new InvalidArgumentException('MFA secret must be at least 32 characters (128 bits)');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self(strtoupper(trim($value)));
+    }
+
+    /**
+     * Get the secret as a QR code URI for authenticator apps
+     *
+     * @param string $issuer The service name (e.g., "MyApp")
+     * @param string $accountName The user's account identifier (e.g., email)
+     */
+    public function toQrCodeUri(string $issuer, string $accountName): string
+    {
+        $encodedIssuer = rawurlencode($issuer);
+        $encodedAccount = rawurlencode($accountName);
+
+        return sprintf(
+            'otpauth://totp/%s:%s?secret=%s&issuer=%s',
+            $encodedIssuer,
+            $encodedAccount,
+            $this->value,
+            $encodedIssuer
+        );
+    }
+
+    /**
+     * Get a masked version of the secret for logging/display
+     * Shows first 4 and last 4 characters only
+     */
+    public function getMasked(): string
+    {
+        if (strlen($this->value) <= 8) {
+            return '****';
+        }
+
+        return substr($this->value, 0, 4) . '****' . substr($this->value, -4);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    /**
+     * Base32 encode binary data (RFC 4648)
+     *
+     * @internal Used by MfaSecretFactory
+     */
+    public static function base32Encode(string $data): string
+    {
+        $base32Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+        $encoded = '';
+        $buffer = 0;
+        $bitsLeft = 0;
+
+        foreach (str_split($data) as $byte) {
+            $buffer = ($buffer << 8) | ord($byte);
+            $bitsLeft += 8;
+
+            while ($bitsLeft >= 5) {
+                $bitsLeft -= 5;
+                $index = ($buffer >> $bitsLeft) & 0x1F;
+                $encoded .= $base32Chars[$index];
+            }
+        }
+
+        // Handle remaining bits
+        if ($bitsLeft > 0) {
+            $index = ($buffer << (5 - $bitsLeft)) & 0x1F;
+            $encoded .= $base32Chars[$index];
+        }
+
+        return $encoded;
+    }
+}
diff --git a/src/Framework/OpenApi/OpenApiGenerator.php b/src/Framework/OpenApi/OpenApiGenerator.php
index 7352adba..d13ab929 100644
--- a/src/Framework/OpenApi/OpenApiGenerator.php
+++ b/src/Framework/OpenApi/OpenApiGenerator.php
@@ -10,7 +10,7 @@ use App\Framework\OpenApi\Attributes\ApiParameter;
 use App\Framework\OpenApi\Attributes\ApiRequestBody;
 use App\Framework\OpenApi\Attributes\ApiResponse;
 use App\Framework\OpenApi\Attributes\ApiSecurity;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Router\CompiledRoutes;
 use ReflectionMethod;
 
diff --git a/src/Framework/Pcntl/Exceptions/PcntlException.php b/src/Framework/Pcntl/Exceptions/PcntlException.php
new file mode 100644
index 00000000..8d26c510
--- /dev/null
+++ b/src/Framework/Pcntl/Exceptions/PcntlException.php
@@ -0,0 +1,102 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Pcntl\ValueObjects\ProcessId;
+use App\Framework\Pcntl\ValueObjects\Signal;
+
+/**
+ * PCNTL exception factory
+ *
+ * Centralizes creation of framework-specific exceptions related to PCNTL operations.
+ * Prefer using the static named constructors instead of creating custom subclasses.
+ */
+final class PcntlException extends FrameworkException
+{
+    public static function extensionNotAvailable(): self
+    {
+        return new self(
+            'PCNTL extension is not available',
+            (int) SystemErrorCode::DEPENDENCY_MISSING->value
+        );
+    }
+
+    public static function operationFailed(string $operation, ?string $reason = null): self
+    {
+        $message = "PCNTL operation '{$operation}' failed";
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function forkFailed(?string $reason = null): self
+    {
+        $message = 'Process fork failed';
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::RESOURCE_EXHAUSTED->value
+        );
+    }
+
+    public static function waitFailed(?ProcessId $pid = null, ?string $reason = null): self
+    {
+        $target = $pid !== null ? "process {$pid->toInt()}" : 'any child process';
+        $message = "Failed to wait for {$target}";
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function waitInterrupted(): self
+    {
+        return new self(
+            'Process wait was interrupted by a signal',
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function signalRegistrationFailed(Signal $signal, ?string $reason = null): self
+    {
+        $message = "Failed to register signal handler for {$signal->getName()}";
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function signalSendFailed(int $pid, Signal $signal, ?string $reason = null): self
+    {
+        $message = "Failed to send signal {$signal->getName()} to process {$pid}";
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Pcntl/Integration/AsyncForkBridge.php b/src/Framework/Pcntl/Integration/AsyncForkBridge.php
new file mode 100644
index 00000000..1fb542ef
--- /dev/null
+++ b/src/Framework/Pcntl/Integration/AsyncForkBridge.php
@@ -0,0 +1,185 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\Integration;
+
+use App\Framework\Async\FiberManager;
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Pcntl\ValueObjects\ForkResult;
+use Fiber;
+
+/**
+ * Async Fork Bridge
+ *
+ * Bridge between Fiber-based async operations and PCNTL processes.
+ * Enables parallel execution of Fibers and forked processes.
+ */
+final readonly class AsyncForkBridge
+{
+    public function __construct(
+        private PcntlService $pcntlService,
+        private FiberManager $fiberManager
+    ) {
+    }
+
+    /**
+     * Execute operation in a forked process and wait for result via Fiber
+     *
+     * This allows combining forked processes with Fiber-based async operations.
+     *
+     * @param callable $operation Operation to execute in child process
+     * @return Fiber Fiber that will yield the result from the forked process
+     */
+    public function forkAsync(callable $operation): Fiber
+    {
+        return $this->fiberManager->async(function () use ($operation) {
+            $forkResult = $this->pcntlService->fork();
+
+            if ($forkResult->isError()) {
+                throw new \RuntimeException('Fork failed');
+            }
+
+            if ($forkResult->isChild()) {
+                // Child process: execute operation and exit
+                try {
+                    $result = $operation();
+                    exit(is_int($result) ? $result : 0);
+                } catch (\Throwable $e) {
+                    error_log("Forked process error: {$e->getMessage()}");
+                    exit(1);
+                }
+            }
+
+            // Parent process: wait for child and return result
+            $childPid = $forkResult->getChildPid();
+            $status = $this->pcntlService->waitPid($childPid);
+
+            if (!$status->exitedNormally()) {
+                throw new \RuntimeException("Child process terminated abnormally: {$status}");
+            }
+
+            $exitCode = $status->getExitCode();
+            if ($exitCode === null) {
+                throw new \RuntimeException("Child process exited without code: {$status}");
+            }
+
+            // Return exit code as result
+            // In a real implementation, you might use IPC (shared memory, pipes, etc.)
+            // to pass actual operation results back
+            return $exitCode;
+        });
+    }
+
+    /**
+     * Execute multiple operations in parallel using both forks and fibers
+     *
+     * @param array<callable> $forkOperations Operations to run in forked processes
+     * @param array<callable> $fiberOperations Operations to run in fibers
+     * @return array<mixed> Results from all operations
+     */
+    public function parallelMixed(array $forkOperations, array $fiberOperations = []): array
+    {
+        $fibers = [];
+
+        // Start all fork operations as fibers
+        foreach ($forkOperations as $key => $operation) {
+            $fibers["fork_{$key}"] = $this->forkAsync($operation);
+        }
+
+        // Start all fiber operations
+        foreach ($fiberOperations as $key => $operation) {
+            $fibers["fiber_{$key}"] = $this->fiberManager->async($operation);
+        }
+
+        // Collect all results
+        $results = [];
+        foreach ($fibers as $key => $fiber) {
+            try {
+                $results[$key] = $fiber->getReturn();
+            } catch (\Throwable $e) {
+                $results[$key] = $e;
+            }
+        }
+
+        return $results;
+    }
+
+    /**
+     * Execute operation in forked process with timeout
+     *
+     * @param callable $operation Operation to execute
+     * @param int $timeoutSeconds Timeout in seconds
+     * @return mixed Result from operation
+     *
+     * @throws \RuntimeException if timeout is exceeded
+     */
+    public function forkWithTimeout(callable $operation, int $timeoutSeconds): mixed
+    {
+        $fiber = $this->forkAsync($operation);
+
+        // Set alarm for timeout
+        $this->pcntlService->setAlarm($timeoutSeconds);
+
+        try {
+            // Wait for fiber to complete
+            while (!$fiber->isTerminated()) {
+                $this->pcntlService->dispatchSignals();
+                usleep(10000); // 10ms
+            }
+
+            $this->pcntlService->clearAlarm();
+
+            return $fiber->getReturn();
+        } catch (\Throwable $e) {
+            $this->pcntlService->clearAlarm();
+            throw $e;
+        }
+    }
+
+    /**
+     * Execute operation in a pool of forked processes
+     *
+     * @param array<callable> $operations Operations to execute
+     * @param int $maxConcurrency Maximum number of concurrent forks
+     * @return array<mixed> Results from all operations
+     */
+    public function forkPool(array $operations, int $maxConcurrency = 4): array
+    {
+        $results = [];
+        $running = [];
+        $index = 0;
+
+        while ($index < count($operations) || !empty($running)) {
+            // Start new forks up to max concurrency
+            while (count($running) < $maxConcurrency && $index < count($operations)) {
+                $key = $index;
+                $fiber = $this->forkAsync($operations[$key]);
+                $running[$key] = $fiber;
+                $index++;
+            }
+
+            // Check for completed forks
+            foreach ($running as $key => $fiber) {
+                if ($fiber->isTerminated()) {
+                    try {
+                        $results[$key] = $fiber->getReturn();
+                    } catch (\Throwable $e) {
+                        $results[$key] = $e;
+                    }
+                    unset($running[$key]);
+                }
+            }
+
+            // Dispatch signals and small sleep
+            $this->pcntlService->dispatchSignals();
+            usleep(10000); // 10ms
+        }
+
+        // Sort results by key to maintain order
+        ksort($results);
+
+        return array_values($results);
+    }
+}
+
diff --git a/src/Framework/Pcntl/PcntlInitializer.php b/src/Framework/Pcntl/PcntlInitializer.php
new file mode 100644
index 00000000..54171348
--- /dev/null
+++ b/src/Framework/Pcntl/PcntlInitializer.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\DI\Initializer;
+
+/**
+ * Initializer for PCNTL Module
+ *
+ * Registers PCNTL services in the DI container.
+ * SignalHandler is registered as singleton for centralized signal management.
+ */
+final readonly class PcntlInitializer
+{
+    #[Initializer]
+    public function signalHandler(): SignalHandler
+    {
+        $handler = new SignalHandler();
+        $handler->initialize();
+
+        return $handler;
+    }
+
+    #[Initializer]
+    public function processForker(SignalHandler $signalHandler): ProcessForker
+    {
+        return new ProcessForker($signalHandler);
+    }
+
+    #[Initializer]
+    public function processManager(): ProcessManager
+    {
+        return new ProcessManager();
+    }
+
+    #[Initializer]
+    public function pcntlService(
+        SignalHandler $signalHandler,
+        ProcessForker $processForker,
+        ProcessManager $processManager
+    ): PcntlService {
+        return new PcntlService(
+            $signalHandler,
+            $processForker,
+            $processManager
+        );
+    }
+}
+
diff --git a/src/Framework/Pcntl/PcntlService.php b/src/Framework/Pcntl/PcntlService.php
new file mode 100644
index 00000000..1a47213d
--- /dev/null
+++ b/src/Framework/Pcntl/PcntlService.php
@@ -0,0 +1,205 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\Pcntl\ValueObjects\ForkResult;
+use App\Framework\Pcntl\ValueObjects\ProcessId;
+use App\Framework\Pcntl\ValueObjects\ProcessStatus;
+use App\Framework\Pcntl\ValueObjects\Signal;
+
+/**
+ * PCNTL Service
+ *
+ * Main facade for all PCNTL operations.
+ * Provides unified access to signal handling, process forking, and process management.
+ */
+final readonly class PcntlService
+{
+    public function __construct(
+        private SignalHandler $signalHandler,
+        private ProcessForker $processForker,
+        private ProcessManager $processManager
+    ) {
+    }
+
+    // ========== Signal Handling ==========
+
+    /**
+     * Register a signal handler
+     */
+    public function registerSignal(Signal $signal, callable $handler): void
+    {
+        $this->signalHandler->register($signal, $handler);
+    }
+
+    /**
+     * Unregister a signal handler
+     */
+    public function unregisterSignal(Signal $signal): void
+    {
+        $this->signalHandler->unregister($signal);
+    }
+
+    /**
+     * Check if a signal has handlers
+     */
+    public function hasSignal(Signal $signal): bool
+    {
+        return $this->signalHandler->hasSignal($signal);
+    }
+
+    /**
+     * Dispatch pending signals
+     */
+    public function dispatchSignals(): void
+    {
+        $this->signalHandler->dispatch();
+    }
+
+    /**
+     * Set alarm for timeout handling
+     */
+    public function setAlarm(int $seconds): void
+    {
+        $this->signalHandler->setAlarm($seconds);
+    }
+
+    /**
+     * Clear alarm
+     */
+    public function clearAlarm(): void
+    {
+        $this->signalHandler->clearAlarm();
+    }
+
+    /**
+     * Send signal to a process
+     */
+    public function sendSignal(int $pid, Signal $signal): void
+    {
+        $this->signalHandler->sendSignal($pid, $signal);
+    }
+
+    /**
+     * Get all registered signals
+     *
+     * @return array<Signal>
+     */
+    public function getRegisteredSignals(): array
+    {
+        return $this->signalHandler->getRegisteredSignals();
+    }
+
+    // ========== Process Forking ==========
+
+    /**
+     * Fork the current process
+     */
+    public function fork(): ForkResult
+    {
+        return $this->processForker->fork();
+    }
+
+    /**
+     * Check if current process is a child
+     */
+    public function isChild(): bool
+    {
+        return $this->processForker->isChild();
+    }
+
+    /**
+     * Check if current process is the parent
+     */
+    public function isParent(): bool
+    {
+        return $this->processForker->isParent();
+    }
+
+    // ========== Process Management ==========
+
+    /**
+     * Wait for any child process (blocking)
+     */
+    public function wait(): ProcessStatus
+    {
+        return $this->processManager->wait();
+    }
+
+    /**
+     * Wait for a specific child process (blocking)
+     */
+    public function waitPid(ProcessId $pid, int $options = 0): ProcessStatus
+    {
+        return $this->processManager->waitPid($pid, $options);
+    }
+
+    /**
+     * Wait for any child process (non-blocking)
+     */
+    public function waitNonBlocking(): ?ProcessStatus
+    {
+        return $this->processManager->waitNonBlocking();
+    }
+
+    /**
+     * Wait for a specific process (non-blocking)
+     */
+    public function waitPidNonBlocking(ProcessId $pid): ?ProcessStatus
+    {
+        return $this->processManager->waitPidNonBlocking($pid);
+    }
+
+    /**
+     * Get current process ID
+     */
+    public function getProcessId(): ProcessId
+    {
+        return $this->processManager->getProcessId();
+    }
+
+    /**
+     * Get parent process ID
+     */
+    public function getParentProcessId(): ProcessId
+    {
+        return $this->processManager->getParentProcessId();
+    }
+
+    /**
+     * Check if a process is running
+     */
+    public function isProcessRunning(ProcessId $pid): bool
+    {
+        return $this->processManager->isProcessRunning($pid);
+    }
+
+    // ========== Direct Access ==========
+
+    /**
+     * Get signal handler service
+     */
+    public function getSignalHandler(): SignalHandler
+    {
+        return $this->signalHandler;
+    }
+
+    /**
+     * Get process forker service
+     */
+    public function getProcessForker(): ProcessForker
+    {
+        return $this->processForker;
+    }
+
+    /**
+     * Get process manager service
+     */
+    public function getProcessManager(): ProcessManager
+    {
+        return $this->processManager;
+    }
+}
+
diff --git a/src/Framework/Pcntl/ProcessForker.php b/src/Framework/Pcntl/ProcessForker.php
new file mode 100644
index 00000000..16cb3744
--- /dev/null
+++ b/src/Framework/Pcntl/ProcessForker.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\Pcntl\Exceptions\PcntlException;
+use App\Framework\Pcntl\ValueObjects\ForkResult;
+
+/**
+ * Process Forker Service
+ *
+ * Provides type-safe process forking functionality.
+ */
+final readonly class ProcessForker
+{
+    public function __construct(
+        private ?SignalHandler $signalHandler = null
+    ) {
+    }
+
+    /**
+     * Fork the current process
+     *
+     * @return ForkResult Result indicating whether we're in parent, child, or error
+     *
+     * @throws PcntlException if fork fails
+     */
+    public function fork(): ForkResult
+    {
+        if (!function_exists('pcntl_fork')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $pid = pcntl_fork();
+
+        if ($pid === -1) {
+            throw PcntlException::forkFailed('pcntl_fork() returned -1');
+        }
+
+        $result = ForkResult::fromForkResult($pid);
+
+        // In child process, reset signal handlers if signal handler is available
+        if ($result->isChild() && $this->signalHandler !== null) {
+            // Child processes should start with clean signal handlers
+            // Individual handlers can be registered after fork if needed
+        }
+
+        return $result;
+    }
+
+    /**
+     * Check if current process is a child process
+     *
+     * This is a convenience method that checks if we're in a forked child.
+     * Note: This only works reliably after a fork() call.
+     */
+    public function isChild(): bool
+    {
+        if (!function_exists('pcntl_getpid') || !function_exists('pcntl_getppid')) {
+            return false;
+        }
+
+        // If parent PID is 1, we might be orphaned or in a different context
+        // This is a heuristic, not 100% reliable
+        return pcntl_getppid() !== getmypid();
+    }
+
+    /**
+     * Check if current process is the parent process
+     *
+     * This is a convenience method that checks if we're in the parent after fork.
+     */
+    public function isParent(): bool
+    {
+        return !$this->isChild();
+    }
+}
+
diff --git a/src/Framework/Pcntl/ProcessManager.php b/src/Framework/Pcntl/ProcessManager.php
new file mode 100644
index 00000000..fb709c59
--- /dev/null
+++ b/src/Framework/Pcntl/ProcessManager.php
@@ -0,0 +1,179 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\Pcntl\Exceptions\PcntlException;
+use App\Framework\Pcntl\ValueObjects\ProcessId;
+use App\Framework\Pcntl\ValueObjects\ProcessStatus;
+
+/**
+ * Process Manager Service
+ *
+ * Provides process management functionality including wait, waitpid,
+ * and process ID queries.
+ */
+final readonly class ProcessManager
+{
+    /**
+     * Wait for any child process to terminate (blocking)
+     *
+     * @return ProcessStatus Status of the terminated child process
+     *
+     * @throws PcntlException if wait fails
+     */
+    public function wait(): ProcessStatus
+    {
+        if (!function_exists('pcntl_wait')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $status = 0;
+        $pid = pcntl_wait($status);
+
+        if ($pid === -1) {
+            $errno = pcntl_get_last_error();
+            if ($errno === PCNTL_ECHILD) {
+                // No child processes to wait for
+                throw PcntlException::waitFailed(null, 'No child processes to wait for');
+            }
+
+            throw PcntlException::waitFailed(null, "pcntl_wait() failed with error code: {$errno}");
+        }
+
+        return ProcessStatus::fromWaitStatus($status, ProcessId::fromInt($pid));
+    }
+
+    /**
+     * Wait for a specific child process to terminate (blocking)
+     *
+     * @param ProcessId $pid Process ID to wait for
+     * @param int $options Wait options (WNOHANG, WUNTRACED, etc.)
+     * @return ProcessStatus Status of the terminated process
+     *
+     * @throws PcntlException if waitpid fails
+     */
+    public function waitPid(ProcessId $pid, int $options = 0): ProcessStatus
+    {
+        if (!function_exists('pcntl_waitpid')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $status = 0;
+        $result = pcntl_waitpid($pid->toInt(), $status, $options);
+
+        if ($result === -1) {
+            $errno = pcntl_get_last_error();
+            throw PcntlException::waitFailed($pid, "pcntl_waitpid() failed with error code: {$errno}");
+        }
+
+        if ($result === 0 && ($options & WNOHANG) !== 0) {
+            // Process hasn't terminated yet (non-blocking)
+            throw PcntlException::waitFailed($pid, 'Process has not terminated yet');
+        }
+
+        return ProcessStatus::fromWaitStatus($status, $pid);
+    }
+
+    /**
+     * Wait for any child process (non-blocking)
+     *
+     * @return ProcessStatus|null Status if a child terminated, null if no child is ready
+     */
+    public function waitNonBlocking(): ?ProcessStatus
+    {
+        if (!function_exists('pcntl_wait')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $status = 0;
+        $pid = pcntl_wait($status, WNOHANG);
+
+        if ($pid === -1) {
+            $errno = pcntl_get_last_error();
+            if ($errno === PCNTL_ECHILD) {
+                return null; // No child processes
+            }
+
+            throw PcntlException::waitFailed(null, "pcntl_wait() failed with error code: {$errno}");
+        }
+
+        if ($pid === 0) {
+            return null; // No child process terminated yet
+        }
+
+        return ProcessStatus::fromWaitStatus($status, ProcessId::fromInt($pid));
+    }
+
+    /**
+     * Wait for a specific process (non-blocking)
+     *
+     * @param ProcessId $pid Process ID to wait for
+     * @return ProcessStatus|null Status if process terminated, null if not ready
+     */
+    public function waitPidNonBlocking(ProcessId $pid): ?ProcessStatus
+    {
+        if (!function_exists('pcntl_waitpid')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $status = 0;
+        $result = pcntl_waitpid($pid->toInt(), $status, WNOHANG);
+
+        if ($result === -1) {
+            $errno = pcntl_get_last_error();
+            if ($errno === PCNTL_ECHILD) {
+                return null; // Process not found or not a child
+            }
+
+            throw PcntlException::waitFailed($pid, "pcntl_waitpid() failed with error code: {$errno}");
+        }
+
+        if ($result === 0) {
+            return null; // Process hasn't terminated yet
+        }
+
+        return ProcessStatus::fromWaitStatus($status, $pid);
+    }
+
+    /**
+     * Get current process ID
+     */
+    public function getProcessId(): ProcessId
+    {
+        if (!function_exists('pcntl_getpid')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        return ProcessId::fromInt(pcntl_getpid());
+    }
+
+    /**
+     * Get parent process ID
+     */
+    public function getParentProcessId(): ProcessId
+    {
+        if (!function_exists('pcntl_getppid')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        return ProcessId::fromInt(pcntl_getppid());
+    }
+
+    /**
+     * Check if a process is running
+     *
+     * @param ProcessId $pid Process ID to check
+     */
+    public function isProcessRunning(ProcessId $pid): bool
+    {
+        if (!function_exists('posix_kill')) {
+            return false;
+        }
+
+        // Send signal 0 to check if process exists
+        return posix_kill($pid->toInt(), 0);
+    }
+}
+
diff --git a/src/Framework/Pcntl/SignalHandler.php b/src/Framework/Pcntl/SignalHandler.php
new file mode 100644
index 00000000..9f7c5804
--- /dev/null
+++ b/src/Framework/Pcntl/SignalHandler.php
@@ -0,0 +1,232 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\Pcntl\Exceptions\PcntlException;
+use App\Framework\Pcntl\ValueObjects\Signal;
+
+/**
+ * Signal Handler Service
+ *
+ * Centralized signal handling for PCNTL operations.
+ * Provides thread-safe signal registration and dispatch.
+ */
+final class SignalHandler
+{
+    /** @var array<int, array<callable>> Signal handlers indexed by signal number */
+    private array $handlers = [];
+
+    /** @var array<int, bool> Track if signal is registered with PCNTL */
+    private array $registered = [];
+
+    private bool $initialized = false;
+
+    /**
+     * Initialize signal handling
+     */
+    public function initialize(): void
+    {
+        if ($this->initialized) {
+            return;
+        }
+
+        if (!function_exists('pcntl_signal')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        // Configure async signal handling
+        pcntl_async_signals(true);
+
+        $this->initialized = true;
+    }
+
+    /**
+     * Register a signal handler
+     *
+     * @param Signal $signal Signal to handle
+     * @param callable $handler Handler callback (receives Signal as parameter)
+     */
+    public function register(Signal $signal, callable $handler): void
+    {
+        $this->ensureInitialized();
+
+        $signalNumber = $signal->getNumber();
+
+        // Store handler
+        if (!isset($this->handlers[$signalNumber])) {
+            $this->handlers[$signalNumber] = [];
+        }
+
+        $this->handlers[$signalNumber][] = $handler;
+
+        // Register with PCNTL if not already registered
+        if (!isset($this->registered[$signalNumber])) {
+            $result = pcntl_signal($signalNumber, [$this, 'handleSignal']);
+            if ($result === false) {
+                throw PcntlException::signalRegistrationFailed($signal, 'pcntl_signal returned false');
+            }
+
+            $this->registered[$signalNumber] = true;
+        }
+    }
+
+    /**
+     * Unregister a signal handler
+     */
+    public function unregister(Signal $signal): void
+    {
+        $this->ensureInitialized();
+
+        $signalNumber = $signal->getNumber();
+
+        if (isset($this->handlers[$signalNumber])) {
+            unset($this->handlers[$signalNumber]);
+        }
+
+        if (isset($this->registered[$signalNumber])) {
+            pcntl_signal($signalNumber, SIG_DFL);
+            unset($this->registered[$signalNumber]);
+        }
+    }
+
+    /**
+     * Check if a signal has handlers registered
+     */
+    public function hasSignal(Signal $signal): bool
+    {
+        $signalNumber = $signal->getNumber();
+
+        return isset($this->handlers[$signalNumber]) && !empty($this->handlers[$signalNumber]);
+    }
+
+    /**
+     * Dispatch pending signals
+     *
+     * This should be called regularly in long-running processes
+     * to process pending signals.
+     */
+    public function dispatch(): void
+    {
+        $this->ensureInitialized();
+
+        if (function_exists('pcntl_signal_dispatch')) {
+            pcntl_signal_dispatch();
+        }
+    }
+
+    /**
+     * Internal signal handler called by PCNTL
+     *
+     * @param int $signalNumber Signal number
+     */
+    public function handleSignal(int $signalNumber): void
+    {
+        $signal = Signal::fromInt($signalNumber);
+        if ($signal === null) {
+            return; // Unknown signal, ignore
+        }
+
+        // Call all registered handlers for this signal
+        if (isset($this->handlers[$signalNumber])) {
+            foreach ($this->handlers[$signalNumber] as $handler) {
+                try {
+                    $handler($signal);
+                } catch (\Throwable $e) {
+                    // Log error but don't let handler exceptions break signal handling
+                    error_log("Signal handler error for {$signal->getName()}: {$e->getMessage()}");
+                }
+            }
+        }
+    }
+
+    /**
+     * Set alarm (SIGALRM) for timeout handling
+     *
+     * @param int $seconds Seconds until alarm
+     */
+    public function setAlarm(int $seconds): void
+    {
+        $this->ensureInitialized();
+
+        if (!function_exists('pcntl_alarm')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        pcntl_alarm($seconds);
+    }
+
+    /**
+     * Clear alarm
+     */
+    public function clearAlarm(): void
+    {
+        $this->ensureInitialized();
+
+        if (function_exists('pcntl_alarm')) {
+            pcntl_alarm(0);
+        }
+    }
+
+    /**
+     * Send signal to a process
+     *
+     * @param int $pid Process ID
+     * @param Signal $signal Signal to send
+     */
+    public function sendSignal(int $pid, Signal $signal): void
+    {
+        $this->ensureInitialized();
+
+        if (!function_exists('posix_kill')) {
+            throw PcntlException::extensionNotAvailable();
+        }
+
+        $result = posix_kill($pid, $signal->getNumber());
+        if ($result === false) {
+            $errno = posix_get_last_error();
+            $error = posix_strerror($errno);
+            throw PcntlException::signalSendFailed($pid, $signal, $error);
+        }
+    }
+
+    /**
+     * Get all registered signals
+     *
+     * @return array<Signal>
+     */
+    public function getRegisteredSignals(): array
+    {
+        $signals = [];
+        foreach (array_keys($this->handlers) as $signalNumber) {
+            $signal = Signal::fromInt($signalNumber);
+            if ($signal !== null) {
+                $signals[] = $signal;
+            }
+        }
+
+        return $signals;
+    }
+
+    /**
+     * Clear all handlers
+     */
+    public function clear(): void
+    {
+        foreach ($this->registered as $signalNumber => $_) {
+            pcntl_signal($signalNumber, SIG_DFL);
+        }
+
+        $this->handlers = [];
+        $this->registered = [];
+    }
+
+    private function ensureInitialized(): void
+    {
+        if (!$this->initialized) {
+            $this->initialize();
+        }
+    }
+}
+
diff --git a/src/Framework/Pcntl/ValueObjects/ForkResult.php b/src/Framework/Pcntl/ValueObjects/ForkResult.php
new file mode 100644
index 00000000..d6d684d7
--- /dev/null
+++ b/src/Framework/Pcntl/ValueObjects/ForkResult.php
@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\ValueObjects;
+
+/**
+ * Fork Result Value Object
+ *
+ * Represents the result of a pcntl_fork() operation.
+ * - In parent process: contains child PID
+ * - In child process: contains 0
+ * - On error: contains -1
+ */
+final readonly class ForkResult
+{
+    private function __construct(
+        private int $value,
+        private bool $isChild,
+        private bool $isParent,
+        private bool $isError
+    ) {
+    }
+
+    /**
+     * Create ForkResult for parent process (child PID returned)
+     */
+    public static function parent(ProcessId $childPid): self
+    {
+        return new self(
+            value: $childPid->toInt(),
+            isChild: false,
+            isParent: true,
+            isError: false
+        );
+    }
+
+    /**
+     * Create ForkResult for child process (0 returned)
+     */
+    public static function child(): self
+    {
+        return new self(
+            value: 0,
+            isChild: true,
+            isParent: false,
+            isError: false
+        );
+    }
+
+    /**
+     * Create ForkResult for error (-1 returned)
+     */
+    public static function error(): self
+    {
+        return new self(
+            value: -1,
+            isChild: false,
+            isParent: false,
+            isError: true
+        );
+    }
+
+    /**
+     * Create ForkResult from raw fork() return value
+     */
+    public static function fromForkResult(int $forkResult): self
+    {
+        if ($forkResult === -1) {
+            return self::error();
+        }
+
+        if ($forkResult === 0) {
+            return self::child();
+        }
+
+        return self::parent(ProcessId::fromInt($forkResult));
+    }
+
+    public function isChild(): bool
+    {
+        return $this->isChild;
+    }
+
+    public function isParent(): bool
+    {
+        return $this->isParent;
+    }
+
+    public function isError(): bool
+    {
+        return $this->isError;
+    }
+
+    /**
+     * Get child PID (only valid in parent process)
+     *
+     * @throws \RuntimeException if called in child process or on error
+     */
+    public function getChildPid(): ProcessId
+    {
+        if ($this->isError) {
+            throw new \RuntimeException('Cannot get child PID from error result');
+        }
+
+        if ($this->isChild) {
+            throw new \RuntimeException('Cannot get child PID in child process');
+        }
+
+        return ProcessId::fromInt($this->value);
+    }
+
+    /**
+     * Get raw fork result value
+     */
+    public function toInt(): int
+    {
+        return $this->value;
+    }
+
+    public function toString(): string
+    {
+        if ($this->isError) {
+            return 'ForkResult(error)';
+        }
+
+        if ($this->isChild) {
+            return 'ForkResult(child)';
+        }
+
+        return "ForkResult(parent, child_pid={$this->value})";
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+
diff --git a/src/Framework/Pcntl/ValueObjects/ProcessId.php b/src/Framework/Pcntl/ValueObjects/ProcessId.php
new file mode 100644
index 00000000..234a2f0a
--- /dev/null
+++ b/src/Framework/Pcntl/ValueObjects/ProcessId.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Process ID Value Object
+ *
+ * Type-safe representation of a process ID.
+ * Validates that process IDs are positive integers.
+ */
+final readonly class ProcessId
+{
+    public function __construct(
+        private int $value
+    ) {
+        if ($value <= 0) {
+            throw new InvalidArgumentException("Process ID must be positive, got: {$value}");
+        }
+    }
+
+    public static function fromInt(int $pid): self
+    {
+        return new self($pid);
+    }
+
+    public static function current(): self
+    {
+        if (!function_exists('pcntl_getpid')) {
+            throw new \RuntimeException('PCNTL extension is not available');
+        }
+
+        return new self(pcntl_getpid());
+    }
+
+    public function toInt(): int
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function toString(): string
+    {
+        return (string) $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+
diff --git a/src/Framework/Pcntl/ValueObjects/ProcessStatus.php b/src/Framework/Pcntl/ValueObjects/ProcessStatus.php
new file mode 100644
index 00000000..e8602b03
--- /dev/null
+++ b/src/Framework/Pcntl/ValueObjects/ProcessStatus.php
@@ -0,0 +1,153 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\ValueObjects;
+
+/**
+ * Process Status Value Object
+ *
+ * Represents the status of a process after wait() or waitpid().
+ * Contains exit code, termination signal, and other process information.
+ */
+final readonly class ProcessStatus
+{
+    private function __construct(
+        private ?int $exitCode,
+        private ?Signal $terminatedBySignal,
+        private bool $isStopped,
+        private bool $isContinued,
+        private ProcessId $processId
+    ) {
+    }
+
+    /**
+     * Create ProcessStatus from pcntl_waitpid() result
+     *
+     * @param int $status Status from pcntl_waitpid()
+     * @param ProcessId $processId Process ID that was waited for
+     */
+    public static function fromWaitStatus(int $status, ProcessId $processId): self
+    {
+        if (pcntl_wifexited($status)) {
+            $exitCode = pcntl_wexitstatus($status);
+            $terminatedBySignal = null;
+        } else {
+            $exitCode = null;
+            $terminatedBySignal = pcntl_wifsignaled($status)
+                ? Signal::fromInt(pcntl_wtermsig($status))
+                : null;
+        }
+
+        $isStopped = pcntl_wifstopped($status);
+        $isContinued = pcntl_wifcontinued($status);
+
+        return new self(
+            exitCode: $exitCode,
+            terminatedBySignal: $terminatedBySignal,
+            isStopped: $isStopped,
+            isContinued: $isContinued,
+            processId: $processId
+        );
+    }
+
+    /**
+     * Create ProcessStatus for normal exit
+     */
+    public static function exitedNormally(int $exitCode, ProcessId $processId): self
+    {
+        return new self(
+            exitCode: $exitCode,
+            terminatedBySignal: null,
+            isStopped: false,
+            isContinued: false,
+            processId: $processId
+        );
+    }
+
+    /**
+     * Create ProcessStatus for signal termination
+     */
+    public static function terminatedBySignal(Signal $signal, ProcessId $processId): self
+    {
+        return new self(
+            exitCode: null,
+            terminatedBySignal: $signal,
+            isStopped: false,
+            isContinued: false,
+            processId: $processId
+        );
+    }
+
+    public function getProcessId(): ProcessId
+    {
+        return $this->processId;
+    }
+
+    public function getExitCode(): ?int
+    {
+        return $this->exitCode;
+    }
+
+    public function getTerminatedBySignal(): ?Signal
+    {
+        return $this->terminatedBySignal;
+    }
+
+    public function isStopped(): bool
+    {
+        return $this->isStopped;
+    }
+
+    public function isContinued(): bool
+    {
+        return $this->isContinued;
+    }
+
+    public function wasExitedNormally(): bool
+    {
+        return $this->exitCode !== null && $this->terminatedBySignal === null;
+    }
+
+    public function wasTerminatedBySignal(): bool
+    {
+        return $this->terminatedBySignal !== null;
+    }
+
+    public function isSuccessful(): bool
+    {
+        return $this->wasExitedNormally() && $this->exitCode === 0;
+    }
+
+    public function isFailed(): bool
+    {
+        return $this->wasExitedNormally() && $this->exitCode !== 0;
+    }
+
+    public function toString(): string
+    {
+        if ($this->wasExitedNormally()) {
+            return "ProcessStatus(pid={$this->processId}, exit_code={$this->exitCode})";
+        }
+
+        if ($this->wasTerminatedBySignal()) {
+            return "ProcessStatus(pid={$this->processId}, terminated_by={$this->terminatedBySignal->getName()})";
+        }
+
+        if ($this->isStopped) {
+            return "ProcessStatus(pid={$this->processId}, stopped)";
+        }
+
+        if ($this->isContinued) {
+            return "ProcessStatus(pid={$this->processId}, continued)";
+        }
+
+        return "ProcessStatus(pid={$this->processId}, unknown)";
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+
diff --git a/src/Framework/Pcntl/ValueObjects/Signal.php b/src/Framework/Pcntl/ValueObjects/Signal.php
new file mode 100644
index 00000000..4c970ac0
--- /dev/null
+++ b/src/Framework/Pcntl/ValueObjects/Signal.php
@@ -0,0 +1,86 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl\ValueObjects;
+
+/**
+ * Signal Enum
+ *
+ * Represents Unix signals that can be sent to processes.
+ * Maps signal names to their numeric values.
+ */
+enum Signal: int
+{
+    case SIGTERM = 15;
+    case SIGINT = 2;
+    case SIGHUP = 1;
+    case SIGALRM = 14;
+    case SIGUSR1 = 10;
+    case SIGUSR2 = 12;
+    case SIGCHLD = 17;
+    case SIGQUIT = 3;
+    case SIGKILL = 9;
+    case SIGSTOP = 19;
+    case SIGCONT = 18;
+
+    public static function fromInt(int $signalNumber): ?self
+    {
+        return match ($signalNumber) {
+            15 => self::SIGTERM,
+            2 => self::SIGINT,
+            1 => self::SIGHUP,
+            14 => self::SIGALRM,
+            10 => self::SIGUSR1,
+            12 => self::SIGUSR2,
+            17 => self::SIGCHLD,
+            3 => self::SIGQUIT,
+            9 => self::SIGKILL,
+            19 => self::SIGSTOP,
+            18 => self::SIGCONT,
+            default => null,
+        };
+    }
+
+    public function getName(): string
+    {
+        return match ($this) {
+            self::SIGTERM => 'SIGTERM',
+            self::SIGINT => 'SIGINT',
+            self::SIGHUP => 'SIGHUP',
+            self::SIGALRM => 'SIGALRM',
+            self::SIGUSR1 => 'SIGUSR1',
+            self::SIGUSR2 => 'SIGUSR2',
+            self::SIGCHLD => 'SIGCHLD',
+            self::SIGQUIT => 'SIGQUIT',
+            self::SIGKILL => 'SIGKILL',
+            self::SIGSTOP => 'SIGSTOP',
+            self::SIGCONT => 'SIGCONT',
+        };
+    }
+
+    public function getNumber(): int
+    {
+        return $this->value;
+    }
+
+    public function isTerminationSignal(): bool
+    {
+        return match ($this) {
+            self::SIGTERM, self::SIGINT, self::SIGHUP, self::SIGQUIT => true,
+            default => false,
+        };
+    }
+
+    public function isKillSignal(): bool
+    {
+        return $this === self::SIGKILL;
+    }
+
+    public function isStopSignal(): bool
+    {
+        return $this === self::SIGSTOP;
+    }
+
+}
+
diff --git a/src/Framework/Pcntl/WorkerPool.php b/src/Framework/Pcntl/WorkerPool.php
new file mode 100644
index 00000000..2f989333
--- /dev/null
+++ b/src/Framework/Pcntl/WorkerPool.php
@@ -0,0 +1,325 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Pcntl;
+
+use App\Framework\Pcntl\Exceptions\PcntlException;
+use App\Framework\Pcntl\ValueObjects\ForkResult;
+use App\Framework\Pcntl\ValueObjects\ProcessId;
+use App\Framework\Pcntl\ValueObjects\ProcessStatus;
+use App\Framework\Pcntl\ValueObjects\Signal;
+
+/**
+ * Worker Pool with Forking Support
+ *
+ * Manages multiple worker processes using fork().
+ * Provides load balancing, graceful shutdown, and worker restart functionality.
+ */
+final class WorkerPool
+{
+    /** @var array<ProcessId, array{pid: ProcessId, started: float, restarts: int}> */
+    private array $workers = [];
+
+    private bool $running = false;
+
+    /** @var callable|null Worker function to execute in each child process */
+    private $workerFunction = null;
+
+    public function __construct(
+        private readonly PcntlService $pcntlService,
+        private readonly int $maxWorkers = 4,
+        private readonly int $maxRestartsPerWorker = 10
+    ) {
+    }
+
+    /**
+     * Set the worker function to execute in each child process
+     */
+    public function setWorkerFunction(callable $function): void
+    {
+        $this->workerFunction = $function;
+    }
+
+    /**
+     * Start the worker pool
+     *
+     * @param int $workerCount Number of worker processes to start
+     */
+    public function start(int $workerCount): void
+    {
+        if ($this->running) {
+            return;
+        }
+
+        if ($this->workerFunction === null) {
+            throw new \RuntimeException('Worker function not set. Call setWorkerFunction() first.');
+        }
+
+        $workerCount = min($workerCount, $this->maxWorkers);
+
+        $this->running = true;
+
+        // Register signal handlers for graceful shutdown
+        $this->setupSignalHandlers();
+
+        // Fork worker processes
+        for ($i = 0; $i < $workerCount; $i++) {
+            $this->startWorker();
+        }
+
+        // Parent process: monitor workers
+        $this->monitorWorkers();
+    }
+
+    /**
+     * Stop all worker processes
+     */
+    public function stop(): void
+    {
+        if (!$this->running) {
+            return;
+        }
+
+        $this->running = false;
+
+        // Send SIGTERM to all workers
+        foreach ($this->workers as $worker) {
+            $pid = $worker['pid'];
+            try {
+                $this->pcntlService->sendSignal($pid->toInt(), Signal::SIGTERM);
+            } catch (\Throwable $e) {
+                // Ignore errors when stopping workers
+                error_log("Error stopping worker {$pid->toInt()}: {$e->getMessage()}");
+            }
+        }
+
+        // Wait for all workers to terminate
+        $this->waitForAllWorkers();
+    }
+
+    /**
+     * Restart a specific worker
+     */
+    public function restartWorker(ProcessId $pid): void
+    {
+        if (!isset($this->workers[$pid->toInt()])) {
+            throw new \InvalidArgumentException("Worker with PID {$pid->toInt()} not found");
+        }
+
+        $worker = $this->workers[$pid->toInt()];
+
+        // Check restart limit
+        if ($worker['restarts'] >= $this->maxRestartsPerWorker) {
+            error_log("Worker {$pid->toInt()} has exceeded max restarts ({$this->maxRestartsPerWorker}), stopping pool");
+            $this->stop();
+
+            return;
+        }
+
+        // Kill existing worker
+        try {
+            $this->pcntlService->sendSignal($pid->toInt(), Signal::SIGTERM);
+            $this->waitForWorker($pid);
+        } catch (\Throwable $e) {
+            error_log("Error stopping worker {$pid->toInt()} for restart: {$e->getMessage()}");
+        }
+
+        // Start new worker
+        $this->startWorker();
+    }
+
+    /**
+     * Get number of active workers
+     */
+    public function getWorkerCount(): int
+    {
+        return count($this->workers);
+    }
+
+    /**
+     * Get worker information
+     *
+     * @return array<array{pid: int, started: float, restarts: int}>
+     */
+    public function getWorkerInfo(): array
+    {
+        $info = [];
+        foreach ($this->workers as $worker) {
+            $info[] = [
+                'pid' => $worker['pid']->toInt(),
+                'started' => $worker['started'],
+                'restarts' => $worker['restarts'],
+            ];
+        }
+
+        return $info;
+    }
+
+    /**
+     * Start a single worker process
+     */
+    private function startWorker(): void
+    {
+        $forkResult = $this->pcntlService->fork();
+
+        if ($forkResult->isError()) {
+            throw PcntlException::forkFailed('Failed to fork worker process');
+        }
+
+        if ($forkResult->isChild()) {
+            // Child process: execute worker function
+            $this->runWorker();
+            exit(0);
+        }
+
+        // Parent process: track worker
+        $childPid = $forkResult->getChildPid();
+        $this->workers[$childPid->toInt()] = [
+            'pid' => $childPid,
+            'started' => microtime(true),
+            'restarts' => 0,
+        ];
+    }
+
+    /**
+     * Execute worker function in child process
+     */
+    private function runWorker(): void
+    {
+        if ($this->workerFunction === null) {
+            return;
+        }
+
+        try {
+            ($this->workerFunction)();
+        } catch (\Throwable $e) {
+            error_log("Worker error: {$e->getMessage()}");
+            throw $e;
+        }
+    }
+
+    /**
+     * Monitor worker processes and restart if needed
+     */
+    private function monitorWorkers(): void
+    {
+        while ($this->running) {
+            // Check for terminated workers
+            $status = $this->pcntlService->waitNonBlocking();
+            if ($status !== null) {
+                $pid = $status->getProcessId();
+                $this->handleWorkerTerminated($pid, $status);
+            }
+
+            // Dispatch signals
+            $this->pcntlService->dispatchSignals();
+
+            // Maintain worker count
+            $this->maintainWorkerCount();
+
+            // Small sleep to prevent CPU spinning
+            usleep(100000); // 100ms
+        }
+    }
+
+    /**
+     * Handle worker termination
+     */
+    private function handleWorkerTerminated(ProcessId $pid, ProcessStatus $status): void
+    {
+        if (!isset($this->workers[$pid->toInt()])) {
+            return; // Worker not tracked (might have been cleaned up)
+        }
+
+        $worker = $this->workers[$pid->toInt()];
+        unset($this->workers[$pid->toInt()]);
+
+        if (!$this->running) {
+            return; // Pool is stopping, don't restart
+        }
+
+        // Log termination
+        if ($status->wasTerminatedBySignal()) {
+            $signal = $status->getTerminatedBySignal();
+            error_log("Worker {$pid->toInt()} terminated by signal: {$signal->getName()}");
+        } elseif ($status->exitedNormally()) {
+            $exitCode = $status->getExitCode();
+            error_log("Worker {$pid->toInt()} exited with code: {$exitCode}");
+        }
+
+        // Restart worker if pool is still running
+        if ($this->running) {
+            $this->startWorker();
+        }
+    }
+
+    /**
+     * Maintain worker count
+     */
+    private function maintainWorkerCount(): void
+    {
+        $currentCount = count($this->workers);
+        $targetCount = $this->maxWorkers;
+
+        if ($currentCount < $targetCount && $this->running) {
+            // Start additional workers
+            for ($i = $currentCount; $i < $targetCount; $i++) {
+                $this->startWorker();
+            }
+        }
+    }
+
+    /**
+     * Setup signal handlers for graceful shutdown
+     */
+    private function setupSignalHandlers(): void
+    {
+        $this->pcntlService->registerSignal(Signal::SIGTERM, function () {
+            $this->stop();
+        });
+
+        $this->pcntlService->registerSignal(Signal::SIGINT, function () {
+            $this->stop();
+        });
+
+        $this->pcntlService->registerSignal(Signal::SIGHUP, function () {
+            // Reload configuration (restart all workers)
+            foreach (array_keys($this->workers) as $pidInt) {
+                $this->restartWorker(ProcessId::fromInt($pidInt));
+            }
+        });
+    }
+
+    /**
+     * Wait for a specific worker to terminate
+     */
+    private function waitForWorker(ProcessId $pid): void
+    {
+        try {
+            $this->pcntlService->waitPid($pid);
+        } catch (\Throwable $e) {
+            // Ignore errors
+        }
+    }
+
+    /**
+     * Wait for all workers to terminate
+     */
+    private function waitForAllWorkers(): void
+    {
+        while (!empty($this->workers)) {
+            try {
+                $status = $this->pcntlService->wait();
+                $pid = $status->getProcessId();
+                if (isset($this->workers[$pid->toInt()])) {
+                    unset($this->workers[$pid->toInt()]);
+                }
+            } catch (\Throwable $e) {
+                // Break if no more children
+                break;
+            }
+        }
+    }
+}
+
diff --git a/src/Framework/Posix/Exceptions/PosixException.php b/src/Framework/Posix/Exceptions/PosixException.php
new file mode 100644
index 00000000..a56811ee
--- /dev/null
+++ b/src/Framework/Posix/Exceptions/PosixException.php
@@ -0,0 +1,129 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\Exceptions;
+
+use App\Framework\Exception\Core\{DatabaseErrorCode, HttpErrorCode, SecurityErrorCode};
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Posix\ValueObjects\{GroupId, ProcessId, Signal, UserId};
+
+/**
+ * POSIX Operation Exception
+ *
+ * Thrown when POSIX operations fail.
+ */
+final class PosixException extends FrameworkException
+{
+    /**
+     * User not found
+     */
+    public static function userNotFound(UserId $userId): self
+    {
+        return self::create(
+            DatabaseErrorCode::ENTITY_NOT_FOUND,
+            "User with ID {$userId->value} not found"
+        )->withData([
+            'user_id' => $userId->value,
+            'entity_type' => 'user',
+        ]);
+    }
+
+    /**
+     * Group not found
+     */
+    public static function groupNotFound(GroupId $groupId): self
+    {
+        return self::create(
+            DatabaseErrorCode::ENTITY_NOT_FOUND,
+            "Group with ID {$groupId->value} not found"
+        )->withData([
+            'group_id' => $groupId->value,
+            'entity_type' => 'group',
+        ]);
+    }
+
+    /**
+     * Permission denied for operation
+     */
+    public static function permissionDenied(string $operation): self
+    {
+        return self::create(
+            SecurityErrorCode::PERMISSION_DENIED,
+            "Permission denied for operation: {$operation}"
+        )->withData([
+            'operation' => $operation,
+        ]);
+    }
+
+    /**
+     * Failed to send signal to process
+     */
+    public static function signalFailed(ProcessId $pid, Signal $signal): self
+    {
+        return self::create(
+            HttpErrorCode::INTERNAL_SERVER_ERROR,
+            "Failed to send signal {$signal->name} to process {$pid->value}"
+        )->withData([
+            'pid' => $pid->value,
+            'signal' => $signal->name,
+            'signal_value' => $signal->value,
+        ]);
+    }
+
+    /**
+     * POSIX extension not loaded
+     */
+    public static function extensionNotLoaded(): self
+    {
+        return self::create(
+            HttpErrorCode::INTERNAL_SERVER_ERROR,
+            'POSIX extension is not loaded. Please install php-posix extension.'
+        )->withData([
+            'extension' => 'posix',
+            'required' => true,
+        ]);
+    }
+
+    /**
+     * Failed to set user ID
+     */
+    public static function setUserIdFailed(UserId $userId): self
+    {
+        return self::create(
+            SecurityErrorCode::PERMISSION_DENIED,
+            "Failed to set user ID to {$userId->value}"
+        )->withData([
+            'user_id' => $userId->value,
+            'operation' => 'setuid',
+        ]);
+    }
+
+    /**
+     * Failed to set group ID
+     */
+    public static function setGroupIdFailed(GroupId $groupId): self
+    {
+        return self::create(
+            SecurityErrorCode::PERMISSION_DENIED,
+            "Failed to set group ID to {$groupId->value}"
+        )->withData([
+            'group_id' => $groupId->value,
+            'operation' => 'setgid',
+        ]);
+    }
+
+    /**
+     * Failed to set resource limit
+     */
+    public static function setResourceLimitFailed(string $resourceType): self
+    {
+        return self::create(
+            HttpErrorCode::INTERNAL_SERVER_ERROR,
+            "Failed to set resource limit for {$resourceType}"
+        )->withData([
+            'resource_type' => $resourceType,
+            'operation' => 'setrlimit',
+        ]);
+    }
+}
diff --git a/src/Framework/Posix/PosixServiceInitializer.php b/src/Framework/Posix/PosixServiceInitializer.php
new file mode 100644
index 00000000..19660c75
--- /dev/null
+++ b/src/Framework/Posix/PosixServiceInitializer.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix;
+
+use App\Framework\Attributes\Initializer;
+use App\Framework\DI\Container;
+use App\Framework\Posix\Exceptions\PosixException;
+use App\Framework\Posix\Services\{InMemoryPosixService, NativePosixService, PosixService};
+
+/**
+ * POSIX Service Initializer
+ *
+ * Registers PosixService implementation in DI container.
+ */
+final readonly class PosixServiceInitializer
+{
+    #[Initializer]
+    public function initialize(Container $container): PosixService
+    {
+        // Check if POSIX extension is loaded
+        if (extension_loaded('posix')) {
+            $service = new NativePosixService();
+        } else {
+            // Fallback to in-memory implementation for testing
+            $service = new InMemoryPosixService();
+        }
+
+        // Register as singleton
+        $container->singleton(PosixService::class, $service);
+
+        return $service;
+    }
+}
diff --git a/src/Framework/Posix/Services/InMemoryPosixService.php b/src/Framework/Posix/Services/InMemoryPosixService.php
new file mode 100644
index 00000000..346a80ff
--- /dev/null
+++ b/src/Framework/Posix/Services/InMemoryPosixService.php
@@ -0,0 +1,181 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\Services;
+
+use App\Framework\Posix\Exceptions\PosixException;
+use App\Framework\Posix\ValueObjects\{
+    GroupId,
+    GroupInfo,
+    GroupName,
+    ProcessId,
+    ProcessInfo,
+    ResourceLimit,
+    ResourceType,
+    Signal,
+    UserId,
+    UserInfo,
+    UserName
+};
+
+/**
+ * In-Memory POSIX Service Implementation
+ *
+ * For testing without real posix_* functions.
+ */
+final class InMemoryPosixService implements PosixService
+{
+    private ProcessInfo $currentProcess;
+    private array $users = [];
+    private array $groups = [];
+    private array $runningProcesses = [];
+    private array $resourceLimits = [];
+
+    public function __construct()
+    {
+        // Default test process
+        $this->currentProcess = new ProcessInfo(
+            pid: new ProcessId(1234),
+            parentPid: new ProcessId(1),
+            userId: new UserId(1000),
+            groupId: new GroupId(1000),
+            workingDirectory: '/tmp'
+        );
+
+        // Default test user
+        $this->users[1000] = new UserInfo(
+            userId: new UserId(1000),
+            userName: UserName::fromString('testuser'),
+            homeDirectory: '/home/testuser',
+            shell: '/bin/bash',
+            groupId: new GroupId(1000)
+        );
+
+        // Default test group
+        $this->groups[1000] = new GroupInfo(
+            new GroupId(1000),
+            GroupName::fromString('testgroup'),
+            UserName::fromString('testuser')
+        );
+
+        // Mark test process as running
+        $this->runningProcesses[1234] = true;
+
+        // Default resource limits
+        foreach (ResourceType::cases() as $type) {
+            $this->resourceLimits[$type->value] = new ResourceLimit(
+                type: $type,
+                softLimit: 1024,
+                hardLimit: 2048
+            );
+        }
+    }
+
+    public function getCurrentProcess(): ProcessInfo
+    {
+        return $this->currentProcess;
+    }
+
+    public function getUserInfo(UserId $userId): UserInfo
+    {
+        if (!isset($this->users[$userId->value])) {
+            throw PosixException::userNotFound($userId);
+        }
+
+        return $this->users[$userId->value];
+    }
+
+    public function getGroupInfo(GroupId $groupId): GroupInfo
+    {
+        if (!isset($this->groups[$groupId->value])) {
+            throw PosixException::groupNotFound($groupId);
+        }
+
+        return $this->groups[$groupId->value];
+    }
+
+    public function sendSignal(ProcessId $pid, Signal $signal): bool
+    {
+        if (!isset($this->runningProcesses[$pid->value])) {
+            throw PosixException::signalFailed($pid, $signal);
+        }
+
+        // Simulate signal handling
+        if ($signal->isTermination()) {
+            unset($this->runningProcesses[$pid->value]);
+        }
+
+        return true;
+    }
+
+    public function setUserId(UserId $userId): void
+    {
+        if (!isset($this->users[$userId->value])) {
+            throw PosixException::setUserIdFailed($userId);
+        }
+
+        $this->currentProcess = new ProcessInfo(
+            pid: $this->currentProcess->pid,
+            parentPid: $this->currentProcess->parentPid,
+            userId: $userId,
+            groupId: $this->currentProcess->groupId,
+            workingDirectory: $this->currentProcess->workingDirectory
+        );
+    }
+
+    public function setGroupId(GroupId $groupId): void
+    {
+        if (!isset($this->groups[$groupId->value])) {
+            throw PosixException::setGroupIdFailed($groupId);
+        }
+
+        $this->currentProcess = new ProcessInfo(
+            pid: $this->currentProcess->pid,
+            parentPid: $this->currentProcess->parentPid,
+            userId: $this->currentProcess->userId,
+            groupId: $groupId,
+            workingDirectory: $this->currentProcess->workingDirectory
+        );
+    }
+
+    public function isRunning(ProcessId $pid): bool
+    {
+        return isset($this->runningProcesses[$pid->value]);
+    }
+
+    public function getResourceLimit(ResourceType $type): ResourceLimit
+    {
+        return $this->resourceLimits[$type->value];
+    }
+
+    public function setResourceLimit(
+        ResourceType $type,
+        int $softLimit,
+        int $hardLimit
+    ): bool {
+        $this->resourceLimits[$type->value] = new ResourceLimit(
+            type: $type,
+            softLimit: $softLimit,
+            hardLimit: $hardLimit
+        );
+
+        return true;
+    }
+
+    // Test helper methods
+    public function addUser(UserInfo $userInfo): void
+    {
+        $this->users[$userInfo->userId->value] = $userInfo;
+    }
+
+    public function addGroup(GroupInfo $groupInfo): void
+    {
+        $this->groups[$groupInfo->groupId->value] = $groupInfo;
+    }
+
+    public function addRunningProcess(ProcessId $pid): void
+    {
+        $this->runningProcesses[$pid->value] = true;
+    }
+}
diff --git a/src/Framework/Posix/Services/NativePosixService.php b/src/Framework/Posix/Services/NativePosixService.php
new file mode 100644
index 00000000..b527694d
--- /dev/null
+++ b/src/Framework/Posix/Services/NativePosixService.php
@@ -0,0 +1,120 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\Services;
+
+use App\Framework\Posix\Exceptions\PosixException;
+use App\Framework\Posix\ValueObjects\{
+    GroupId,
+    GroupInfo,
+    GroupName,
+    ProcessId,
+    ProcessInfo,
+    ResourceLimit,
+    ResourceType,
+    Signal,
+    UserId,
+    UserInfo,
+    UserName
+};
+
+/**
+ * Native POSIX Service Implementation
+ *
+ * Uses native PHP posix_* functions for system interaction.
+ */
+final readonly class NativePosixService implements PosixService
+{
+    public function getCurrentProcess(): ProcessInfo
+    {
+        return ProcessInfo::current();
+    }
+
+    public function getUserInfo(UserId $userId): UserInfo
+    {
+        $info = posix_getpwuid($userId->value);
+
+        if ($info === false) {
+            throw PosixException::userNotFound($userId);
+        }
+
+        return new UserInfo(
+            userId: $userId,
+            userName: UserName::fromString($info['name']),
+            homeDirectory: $info['dir'],
+            shell: $info['shell'],
+            groupId: new GroupId($info['gid'])
+        );
+    }
+
+    public function getGroupInfo(GroupId $groupId): GroupInfo
+    {
+        $info = posix_getgrgid($groupId->value);
+
+        if ($info === false) {
+            throw PosixException::groupNotFound($groupId);
+        }
+
+        $members = array_map(
+            fn(string $member) => UserName::fromString($member),
+            $info['members']
+        );
+
+        // Cannot use named arguments here because of PHP 8.1
+        return new GroupInfo(
+            $groupId,
+            GroupName::fromString($info['name']),
+            ...$members
+        );
+    }
+
+    public function sendSignal(ProcessId $pid, Signal $signal): bool
+    {
+        $result = $signal->send($pid);
+
+        if (!$result) {
+            throw PosixException::signalFailed($pid, $signal);
+        }
+
+        return $result;
+    }
+
+    public function setUserId(UserId $userId): void
+    {
+        if (!posix_setuid($userId->value)) {
+            throw PosixException::setUserIdFailed($userId);
+        }
+    }
+
+    public function setGroupId(GroupId $groupId): void
+    {
+        if (!posix_setgid($groupId->value)) {
+            throw PosixException::setGroupIdFailed($groupId);
+        }
+    }
+
+    public function isRunning(ProcessId $pid): bool
+    {
+        return posix_kill($pid->value, 0);
+    }
+
+    public function getResourceLimit(ResourceType $type): ResourceLimit
+    {
+        return ResourceLimit::get($type);
+    }
+
+    public function setResourceLimit(
+        ResourceType $type,
+        int $softLimit,
+        int $hardLimit
+    ): bool {
+        $result = posix_setrlimit($type->toConstant(), $softLimit, $hardLimit);
+
+        if (!$result) {
+            throw PosixException::setResourceLimitFailed($type->value);
+        }
+
+        return $result;
+    }
+}
diff --git a/src/Framework/Posix/Services/PosixService.php b/src/Framework/Posix/Services/PosixService.php
new file mode 100644
index 00000000..0de7a74d
--- /dev/null
+++ b/src/Framework/Posix/Services/PosixService.php
@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\Services;
+
+use App\Framework\Posix\ValueObjects\{
+    GroupId,
+    GroupInfo,
+    ProcessId,
+    ProcessInfo,
+    ResourceLimit,
+    ResourceType,
+    Signal,
+    UserId,
+    UserInfo
+};
+
+/**
+ * POSIX Service Interface
+ *
+ * Provides type-safe access to POSIX system calls.
+ */
+interface PosixService
+{
+    /**
+     * Get information about the current process
+     */
+    public function getCurrentProcess(): ProcessInfo;
+
+    /**
+     * Get information about a user by ID
+     */
+    public function getUserInfo(UserId $userId): UserInfo;
+
+    /**
+     * Get information about a group by ID
+     */
+    public function getGroupInfo(GroupId $groupId): GroupInfo;
+
+    /**
+     * Send a signal to a process
+     */
+    public function sendSignal(ProcessId $pid, Signal $signal): bool;
+
+    /**
+     * Set the user ID of the current process
+     */
+    public function setUserId(UserId $userId): void;
+
+    /**
+     * Set the group ID of the current process
+     */
+    public function setGroupId(GroupId $groupId): void;
+
+    /**
+     * Check if a process is running
+     */
+    public function isRunning(ProcessId $pid): bool;
+
+    /**
+     * Get resource limit for a specific type
+     */
+    public function getResourceLimit(ResourceType $type): ResourceLimit;
+
+    /**
+     * Set resource limit for a specific type
+     */
+    public function setResourceLimit(
+        ResourceType $type,
+        int $softLimit,
+        int $hardLimit
+    ): bool;
+}
diff --git a/src/Framework/Posix/ValueObjects/GroupId.php b/src/Framework/Posix/ValueObjects/GroupId.php
new file mode 100644
index 00000000..975147ed
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/GroupId.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+final readonly class GroupId
+{
+    public function __construct(public int $value)
+    {
+        if ($value < 0) {
+            throw new \InvalidArgumentException('Group ID cannot be negative');
+        }
+    }
+
+    public static function current(): self
+    {
+        return new self(posix_getgid());
+    }
+
+    public static function effective(): self
+    {
+        return new self(posix_getegid());
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return (string) $this->value;
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/GroupInfo.php b/src/Framework/Posix/ValueObjects/GroupInfo.php
new file mode 100644
index 00000000..895154e5
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/GroupInfo.php
@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+use RuntimeException;
+
+/**
+ * Group Information Value Object
+ *
+ * Represents comprehensive information about a POSIX group.
+ */
+final readonly class GroupInfo
+{
+    /** @var array<UserName> */
+    public array $members;
+
+    /**
+     * @param UserName ...$members Variadic group members
+     */
+    public function __construct(
+        public GroupId $groupId,
+        public GroupName $groupName,
+        UserName ...$members
+    ) {
+        $this->members = $members;
+    }
+
+    /**
+     * Get current group information
+     */
+    public static function current(): self
+    {
+        $gid = posix_getgid();
+        $info = posix_getgrgid($gid);
+
+        if ($info === false) {
+            throw new RuntimeException('Failed to get current group information');
+        }
+
+        $members = array_map(
+            fn(string $member) => UserName::fromString($member),
+            $info['members']
+        );
+
+        // Cannot use named arguments here because of PHP 8.1
+        return new self(
+            new GroupId($gid),
+            GroupName::fromString($info['name']),
+            ...$members
+        );
+    }
+
+    /**
+     * Check if user is a member of this group
+     */
+    public function hasMember(UserName $userName): bool
+    {
+        return array_any($this->members, fn($member) => $member->equals($userName));
+
+    }
+
+    /**
+     * Get member count
+     */
+    public function getMemberCount(): int
+    {
+        return count($this->members);
+    }
+
+    /**
+     * Convert to array for logging/serialization
+     */
+    public function toArray(): array
+    {
+        return [
+            'group_id' => $this->groupId->value,
+            'group_name' => $this->groupName->value,
+            'members' => array_map(
+                fn(UserName $member) => $member->value,
+                $this->members
+            ),
+            'member_count' => $this->getMemberCount(),
+        ];
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/GroupName.php b/src/Framework/Posix/ValueObjects/GroupName.php
new file mode 100644
index 00000000..568506d5
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/GroupName.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+use Stringable;
+
+final readonly class GroupName implements Stringable
+{
+    public function __construct(public string $value)
+    {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Group name cannot be empty');
+        }
+
+        if (!preg_match('/^[a-zA-Z0-9_-]+$/', $value)) {
+            throw new \InvalidArgumentException(
+                'Group name must contain only alphanumeric characters, underscore, and hyphen'
+            );
+        }
+
+        if (strlen($value) > 32) {
+            throw new \InvalidArgumentException('Group name cannot exceed 32 characters');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/ProcessId.php b/src/Framework/Posix/ValueObjects/ProcessId.php
new file mode 100644
index 00000000..5546afc6
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/ProcessId.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+use Stringable;
+
+/**
+ * Process Identifier Value Object
+ *
+ * Represents a POSIX process ID with validation.
+ */
+final readonly class ProcessId implements Stringable
+{
+    public function __construct(public int $value)
+    {
+        if ($value <= 0) {
+            throw new \InvalidArgumentException('Process ID must be positive');
+        }
+    }
+
+    /**
+     * Get current process ID
+     */
+    public static function current(): self
+    {
+        return new self(posix_getpid());
+    }
+
+    /**
+     * Check equality with another ProcessId
+     */
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return (string) $this->value;
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/ProcessInfo.php b/src/Framework/Posix/ValueObjects/ProcessInfo.php
new file mode 100644
index 00000000..6a32ac0e
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/ProcessInfo.php
@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+/**
+ * Value Object aggregating process information
+ *
+ * Contains PID, parent PID, user ID, group ID, and working directory
+ */
+final readonly class ProcessInfo
+{
+    /**
+     * @param ProcessId $pid Process ID
+     * @param ProcessId $parentPid Parent process ID
+     * @param UserId $userId User ID
+     * @param GroupId $groupId Group ID
+     * @param string $workingDirectory Current working directory
+     */
+    public function __construct(
+        public ProcessId $pid,
+        public ProcessId $parentPid,
+        public UserId $userId,
+        public GroupId $groupId,
+        public string $workingDirectory
+    ) {}
+
+    /**
+     * Create ProcessInfo for current process
+     *
+     * @return self
+     */
+    public static function current(): self
+    {
+        return new self(
+            pid: ProcessId::current(),
+            parentPid: ProcessId::fromInt(posix_getppid()),
+            userId: UserId::current(),
+            groupId: GroupId::current(),
+            workingDirectory: getcwd() ?: '/'
+        );
+    }
+
+    /**
+     * Check if process is running as root
+     *
+     * @return bool
+     */
+    public function isRoot(): bool
+    {
+        return $this->userId->isRoot();
+    }
+
+    /**
+     * Convert to array representation
+     *
+     * @return array{pid: int, parent_pid: int, uid: int, gid: int, working_directory: string}
+     */
+    public function toArray(): array
+    {
+        return [
+            'pid' => $this->pid->value,
+            'parent_pid' => $this->parentPid->value,
+            'uid' => $this->userId->value,
+            'gid' => $this->groupId->value,
+            'working_directory' => $this->workingDirectory,
+        ];
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/ResourceLimit.php b/src/Framework/Posix/ValueObjects/ResourceLimit.php
new file mode 100644
index 00000000..d4ed086f
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/ResourceLimit.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+/**
+ * Value Object representing a POSIX resource limit
+ *
+ * Contains both soft and hard limits for a specific resource type
+ */
+final readonly class ResourceLimit
+{
+    public const UNLIMITED = -1;
+
+    /**
+     * @param ResourceType $type The resource type
+     * @param int $softLimit Soft limit (can be raised up to hard limit)
+     * @param int $hardLimit Hard limit (maximum allowed value)
+     * @throws \InvalidArgumentException If soft limit exceeds hard limit
+     */
+    public function __construct(
+        public ResourceType $type,
+        public int $softLimit,
+        public int $hardLimit
+    ) {
+        if ($softLimit > $hardLimit && $hardLimit !== self::UNLIMITED) {
+            throw new \InvalidArgumentException(
+                "Soft limit ({$softLimit}) cannot exceed hard limit ({$hardLimit})"
+            );
+        }
+    }
+
+    /**
+     * Create from array (posix_getrlimit format)
+     *
+     * @param ResourceType $type
+     * @param array{soft: int|string, hard: int|string} $limits
+     * @return self
+     */
+    public static function fromArray(ResourceType $type, array $limits): self
+    {
+        $softLimit = $limits['soft'] === 'unlimited' ? self::UNLIMITED : (int) $limits['soft'];
+        $hardLimit = $limits['hard'] === 'unlimited' ? self::UNLIMITED : (int) $limits['hard'];
+
+        return new self($type, $softLimit, $hardLimit);
+    }
+
+    /**
+     * Check if soft limit is unlimited
+     *
+     * @return bool
+     */
+    public function isSoftUnlimited(): bool
+    {
+        return $this->softLimit === self::UNLIMITED;
+    }
+
+    /**
+     * Check if hard limit is unlimited
+     *
+     * @return bool
+     */
+    public function isHardUnlimited(): bool
+    {
+        return $this->hardLimit === self::UNLIMITED;
+    }
+
+    /**
+     * Check if both limits are unlimited
+     *
+     * @return bool
+     */
+    public function isUnlimited(): bool
+    {
+        return $this->isSoftUnlimited() && $this->isHardUnlimited();
+    }
+
+    /**
+     * Get limit as human-readable string
+     *
+     * @param int $value
+     * @return string
+     */
+    private function formatLimit(int $value): string
+    {
+        if ($value === self::UNLIMITED) {
+            return 'unlimited';
+        }
+
+        if ($this->type->isSizeBased()) {
+            // Format as bytes with human-readable suffix
+            return $this->formatBytes($value);
+        }
+
+        return (string) $value;
+    }
+
+    /**
+     * Format bytes with human-readable suffix
+     *
+     * @param int $bytes
+     * @return string
+     */
+    private function formatBytes(int $bytes): string
+    {
+        $units = ['B', 'KB', 'MB', 'GB', 'TB'];
+        $factor = floor((strlen((string) $bytes) - 1) / 3);
+
+        return sprintf(
+            '%.2f %s',
+            $bytes / (1024 ** $factor),
+            $units[$factor] ?? 'B'
+        );
+    }
+
+    /**
+     * Convert to array representation
+     *
+     * @return array{type: string, soft: string, hard: string}
+     */
+    public function toArray(): array
+    {
+        return [
+            'type' => $this->type->getName(),
+            'soft' => $this->formatLimit($this->softLimit),
+            'hard' => $this->formatLimit($this->hardLimit),
+        ];
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/ResourceType.php b/src/Framework/Posix/ValueObjects/ResourceType.php
new file mode 100644
index 00000000..c08493e9
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/ResourceType.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+/**
+ * Enum representing POSIX resource limit types
+ */
+enum ResourceType: int
+{
+    case CPU_TIME = 0;        // Maximum CPU time in seconds
+    case FILE_SIZE = 1;       // Maximum file size
+    case DATA_SEG = 2;        // Maximum data segment size
+    case STACK_SIZE = 3;      // Maximum stack size
+    case CORE_SIZE = 4;       // Maximum core file size
+    case OPEN_FILES = 7;      // Maximum number of open file descriptors
+    case MEMORY_LOCK = 8;     // Maximum locked memory
+    case ADDRESS_SPACE = 9;   // Maximum address space
+    case PROCESSES = 6;       // Maximum number of processes
+
+    /**
+     * Get resource type name
+     *
+     * @return string
+     */
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * Get resource type description
+     *
+     * @return string
+     */
+    public function getDescription(): string
+    {
+        return match ($this) {
+            self::CPU_TIME => 'Maximum CPU time in seconds',
+            self::FILE_SIZE => 'Maximum file size that can be created',
+            self::DATA_SEG => 'Maximum size of data segment',
+            self::STACK_SIZE => 'Maximum size of stack segment',
+            self::CORE_SIZE => 'Maximum size of core file',
+            self::OPEN_FILES => 'Maximum number of open file descriptors',
+            self::MEMORY_LOCK => 'Maximum amount of locked memory',
+            self::ADDRESS_SPACE => 'Maximum size of address space',
+            self::PROCESSES => 'Maximum number of processes',
+        };
+    }
+
+    /**
+     * Check if resource is size-based (bytes)
+     *
+     * @return bool
+     */
+    public function isSizeBased(): bool
+    {
+        return match ($this) {
+            self::FILE_SIZE,
+            self::DATA_SEG,
+            self::STACK_SIZE,
+            self::CORE_SIZE,
+            self::MEMORY_LOCK,
+            self::ADDRESS_SPACE => true,
+            default => false,
+        };
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/Signal.php b/src/Framework/Posix/ValueObjects/Signal.php
new file mode 100644
index 00000000..eb250307
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/Signal.php
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+/**
+ * Enum representing POSIX signals
+ */
+enum Signal: int
+{
+    case SIGTERM = 15;  // Termination signal
+    case SIGKILL = 9;   // Kill signal (cannot be caught)
+    case SIGHUP = 1;    // Hangup detected
+    case SIGUSR1 = 10;  // User-defined signal 1
+    case SIGUSR2 = 12;  // User-defined signal 2
+    case SIGINT = 2;    // Interrupt from keyboard (Ctrl+C)
+    case SIGQUIT = 3;   // Quit from keyboard
+    case SIGABRT = 6;   // Abort signal
+    case SIGALRM = 14;  // Alarm clock
+    case SIGCHLD = 17;  // Child stopped or terminated
+    case SIGCONT = 18;  // Continue if stopped
+
+    /**
+     * Get signal name
+     *
+     * @return string
+     */
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * Get signal description
+     *
+     * @return string
+     */
+    public function getDescription(): string
+    {
+        return match ($this) {
+            self::SIGTERM => 'Termination signal',
+            self::SIGKILL => 'Kill signal (cannot be caught)',
+            self::SIGHUP => 'Hangup detected on controlling terminal',
+            self::SIGUSR1 => 'User-defined signal 1',
+            self::SIGUSR2 => 'User-defined signal 2',
+            self::SIGINT => 'Interrupt from keyboard (Ctrl+C)',
+            self::SIGQUIT => 'Quit from keyboard',
+            self::SIGABRT => 'Abort signal from abort()',
+            self::SIGALRM => 'Timer signal from alarm()',
+            self::SIGCHLD => 'Child stopped or terminated',
+            self::SIGCONT => 'Continue if stopped',
+        };
+    }
+
+    /**
+     * Check if signal can be caught
+     *
+     * @return bool
+     */
+    public function canBeCaught(): bool
+    {
+        return $this !== self::SIGKILL;
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/UserId.php b/src/Framework/Posix/ValueObjects/UserId.php
new file mode 100644
index 00000000..6c0b7d52
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/UserId.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+final readonly class UserId
+{
+    public function __construct(public int $value)
+    {
+        if ($value < 0) {
+            throw new \InvalidArgumentException('User ID cannot be negative');
+        }
+    }
+
+    public static function current(): self
+    {
+        return new self(posix_getuid());
+    }
+
+    public static function effective(): self
+    {
+        return new self(posix_geteuid());
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return (string) $this->value;
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/UserInfo.php b/src/Framework/Posix/ValueObjects/UserInfo.php
new file mode 100644
index 00000000..ad8e52fc
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/UserInfo.php
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+/**
+ * Value Object representing POSIX user information
+ *
+ * Contains UID, username, home directory, shell, and primary GID
+ */
+final readonly class UserInfo
+{
+    /**
+     * @param UserId $userId User ID
+     * @param UserName $userName Username
+     * @param string $homeDirectory Home directory path
+     * @param string $shell Default shell
+     * @param GroupId $groupId Primary group ID
+     */
+    public function __construct(
+        public UserId $userId,
+        public UserName $userName,
+        public string $homeDirectory,
+        public string $shell,
+        public GroupId $groupId
+    ) {}
+
+    /**
+     * Create from posix_getpwuid result
+     *
+     * @param array{uid: int, name: string, dir: string, shell: string, gid: int} $data
+     * @return self
+     */
+    public static function fromPosixArray(array $data): self
+    {
+        return new self(
+            userId: UserId::fromInt($data['uid']),
+            userName: UserName::fromString($data['name']),
+            homeDirectory: $data['dir'],
+            shell: $data['shell'],
+            groupId: GroupId::fromInt($data['gid'])
+        );
+    }
+
+    /**
+     * Check if user is root
+     *
+     * @return bool
+     */
+    public function isRoot(): bool
+    {
+        return $this->userId->isRoot();
+    }
+
+    /**
+     * Convert to array representation
+     *
+     * @return array{uid: int, username: string, home_directory: string, shell: string, gid: int}
+     */
+    public function toArray(): array
+    {
+        return [
+            'uid' => $this->userId->value,
+            'username' => $this->userName->value,
+            'home_directory' => $this->homeDirectory,
+            'shell' => $this->shell,
+            'gid' => $this->groupId->value,
+        ];
+    }
+}
diff --git a/src/Framework/Posix/ValueObjects/UserName.php b/src/Framework/Posix/ValueObjects/UserName.php
new file mode 100644
index 00000000..17e4d525
--- /dev/null
+++ b/src/Framework/Posix/ValueObjects/UserName.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Posix\ValueObjects;
+
+final readonly class UserName
+{
+    public function __construct(public string $value)
+    {
+        if (empty($value)) {
+            throw new \InvalidArgumentException('Username cannot be empty');
+        }
+
+        if (!preg_match('/^[a-zA-Z0-9_-]+$/', $value)) {
+            throw new \InvalidArgumentException(
+                'Username must contain only alphanumeric characters, underscore, and hyphen'
+            );
+        }
+
+        if (strlen($value) > 32) {
+            throw new \InvalidArgumentException('Username cannot exceed 32 characters');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public static function current(): self
+    {
+        $info = posix_getpwuid(posix_getuid());
+        if ($info === false) {
+            throw new \RuntimeException('Failed to get current username');
+        }
+
+        return new self($info['name']);
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Process/Exceptions/ProcessTimeoutException.php b/src/Framework/Process/Exceptions/ProcessTimeoutException.php
index f5556a3e..2e14e25b 100644
--- a/src/Framework/Process/Exceptions/ProcessTimeoutException.php
+++ b/src/Framework/Process/Exceptions/ProcessTimeoutException.php
@@ -19,13 +19,9 @@ final class ProcessTimeoutException extends FrameworkException
      */
     public static function exceeded(Command $command, Duration $timeout): self
     {
-        return self::create(
-            ErrorCode::TEMP_FAIL,
-            "Process timeout exceeded: {$command->toString()} (timeout: {$timeout->toHumanReadable()})"
-        )->withData([
-            'command' => $command->toString(),
-            'timeout_seconds' => $timeout->toSeconds(),
-            'timeout_human' => $timeout->toHumanReadable(),
-        ])->withRetryAfter((int) ceil($timeout->toSeconds()));
+        return new self(
+            "Process timeout exceeded: {$command->toString()} (timeout: {$timeout->toHumanReadable()}, {$timeout->toSeconds()}s)",
+            504 // Gateway Timeout
+        );
     }
 }
diff --git a/src/Framework/Process/Services/TcpPortCheckService.php b/src/Framework/Process/Services/TcpPortCheckService.php
index 86ca62ae..6762cb23 100644
--- a/src/Framework/Process/Services/TcpPortCheckService.php
+++ b/src/Framework/Process/Services/TcpPortCheckService.php
@@ -4,16 +4,28 @@ declare(strict_types=1);
 
 namespace App\Framework\Process\Services;
 
+use App\Framework\Sockets\SocketFactory;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+use App\Framework\Sockets\ValueObjects\SocketType;
+
 /**
  * TCP Port Check Service
  *
  * Simple service to check if a TCP port is open without external dependencies.
- * Uses PHP's native fsockopen() with proper error suppression.
+ * Uses SocketFactory if available, otherwise falls back to fsockopen().
  */
 final readonly class TcpPortCheckService
 {
     private const DEFAULT_TIMEOUT = 2;
 
+    public function __construct(
+        private ?SocketFactory $socketFactory = null,
+        private ?SocketService $socketService = null
+    ) {
+    }
+
     /**
      * Check if a TCP port is open on a given host
      *
@@ -22,6 +34,49 @@ final readonly class TcpPortCheckService
      * @param int $timeout Timeout in seconds
      */
     public function isPortOpen(string $host, int $port, int $timeout = self::DEFAULT_TIMEOUT): bool
+    {
+        // Try using SocketService if available
+        if ($this->socketService !== null) {
+            return $this->checkPortWithSocketService($host, $port, $timeout);
+        }
+
+        // Fallback to fsockopen
+        return $this->checkPortWithFsockopen($host, $port, $timeout);
+    }
+
+    /**
+     * Check port using SocketService
+     */
+    private function checkPortWithSocketService(string $host, int $port, int $timeout): bool
+    {
+        try {
+            $address = SocketAddress::ipv4($host, $port);
+            $socket = $this->socketService->createClient(SocketType::TCP, SocketProtocol::IPv4);
+
+            // Set non-blocking and connect with timeout
+            $this->socketService->setNonBlocking($socket);
+
+            try {
+                $this->socketService->connect($socket, $address);
+            } catch (\Throwable $e) {
+                $socket->close();
+
+                return false;
+            }
+
+            // Connection successful
+            $socket->close();
+
+            return true;
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    /**
+     * Check port using fsockopen (fallback)
+     */
+    private function checkPortWithFsockopen(string $host, int $port, int $timeout): bool
     {
         // Temporarily disable error handler to prevent warnings
         set_error_handler(function () {}, E_ALL);
@@ -59,7 +114,8 @@ final readonly class TcpPortCheckService
      */
     public function isSslPortOpen(string $host, int $port, int $timeout = self::DEFAULT_TIMEOUT): bool
     {
-        // Temporarily disable error handler to prevent warnings
+        // SSL/TLS checks still use stream_socket_client as it's more appropriate for SSL
+        // Socket extension doesn't have built-in SSL support
         set_error_handler(function () {}, E_ALL);
 
         try {
diff --git a/src/Framework/Quality/CodeQuality/CodeQualityRule.php b/src/Framework/Quality/CodeQuality/CodeQualityRule.php
new file mode 100644
index 00000000..b2efb693
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/CodeQualityRule.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality;
+
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+/**
+ * Contract for code quality rules executed by the quality scanner.
+ */
+interface CodeQualityRule
+{
+    public function name(): string;
+
+    /**
+     * Execute the rule against the inspected class.
+     *
+     * @return list<RuleViolation> A list of violations, empty when the rule passes
+     */
+    public function check(ClassInspection $inspection): array;
+}
diff --git a/src/Framework/Quality/CodeQuality/CodeQualityScanner.php b/src/Framework/Quality/CodeQuality/CodeQualityScanner.php
new file mode 100644
index 00000000..4de9ae9d
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/CodeQualityScanner.php
@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality;
+
+use App\Framework\Filesystem\FileScanner;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePattern;
+use App\Framework\Logging\Logger;
+use App\Framework\Quality\CodeQuality\Results\CodeQualityReport;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+use App\Framework\Reflection\ReflectionService;
+use ReflectionClass;
+use Throwable;
+
+/**
+ * Scans the project for rule violations.
+ */
+final readonly class CodeQualityScanner
+{
+    private TokenizerClassInspector $classInspector;
+
+    /**
+     * @param list<CodeQualityRule> $rules
+     */
+    public function __construct(
+        private FileScanner $fileScanner,
+        private ReflectionService $reflectionService,
+        private array $rules,
+        private ?Logger $logger = null,
+        ?TokenizerClassInspector $classInspector = null
+    ) {
+        $this->classInspector = $classInspector ?? new TokenizerClassInspector();
+    }
+
+    public function scan(FilePath $directory, bool $skipInvalidClasses = false): CodeQualityReport
+    {
+        $start = microtime(true);
+        /** @var list<RuleViolation> $violations */
+        $violations = [];
+        $inspectedFiles = 0;
+        $inspectedClasses = 0;
+        $errors = [];
+
+        foreach ($this->fileScanner->streamFiles($directory, FilePattern::php()) as $file) {
+            if (! $file->hasExtension('php')) {
+                continue;
+            }
+
+            $inspectedFiles++;
+
+            $tokenResult = $this->classInspector->inspect($file->getPath());
+
+            if ($tokenResult['errors'] !== []) {
+                foreach ($tokenResult['errors'] as $error) {
+                    $errors[] = $error;
+                }
+
+                if (! $skipInvalidClasses) {
+                    // continue analysing other files but remember errors
+                }
+            }
+
+            if ($tokenResult['classes'] === []) {
+                continue;
+            }
+
+            foreach ($tokenResult['classes'] as $normalizedClassName => $metadata) {
+                $className = $metadata->className();
+
+                $classInfo = null;
+
+                try {
+                    if (class_exists($normalizedClassName, false)) {
+                        $classInfo = $this->reflectionService->reflectClass($className);
+                        $reflectionClass = $classInfo->getNativeClass();
+
+                        if ($this->shouldSkipClass($reflectionClass)) {
+                            continue;
+                        }
+                    }
+                } catch (Throwable $exception) {
+                    $errors[] = sprintf(
+                        'Failed to reflect class %s in %s: %s',
+                        $normalizedClassName,
+                        $file->getPathString(),
+                        $exception->getMessage()
+                    );
+
+                    if (! $skipInvalidClasses) {
+                        continue;
+                    }
+
+                    $classInfo = null;
+                }
+
+                $inspectedClasses++;
+                $inspection = new ClassInspection(
+                    $className,
+                    $file->getPath(),
+                    $metadata,
+                    $classInfo
+                );
+
+                foreach ($this->rules as $rule) {
+                    foreach ($rule->check($inspection) as $violation) {
+                        $violations[] = $violation;
+                    }
+                }
+            }
+        }
+
+        return new CodeQualityReport(
+            $violations,
+            microtime(true) - $start,
+            $inspectedFiles,
+            $inspectedClasses,
+            $errors
+        );
+    }
+
+    private function shouldSkipClass(ReflectionClass $reflectionClass): bool
+    {
+        if ($reflectionClass->isInterface() || $reflectionClass->isTrait()) {
+            return true;
+        }
+
+        if (method_exists($reflectionClass, 'isEnum') && $reflectionClass->isEnum()) {
+            return true;
+        }
+
+        return false;
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/Results/CodeQualityReport.php b/src/Framework/Quality/CodeQuality/Results/CodeQualityReport.php
new file mode 100644
index 00000000..7ee74fd5
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Results/CodeQualityReport.php
@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Results;
+
+/**
+ * Aggregated result of a code quality scan.
+ *
+ * @psalm-type RuleViolationList = list<RuleViolation>
+ */
+final readonly class CodeQualityReport
+{
+    /**
+     * @param RuleViolationList $violations
+     * @param list<string> $errors
+     */
+    public function __construct(
+        private array $violations,
+        private float $durationSeconds,
+        private int $inspectedFiles,
+        private int $inspectedClasses,
+        private array $errors = []
+    ) {
+    }
+
+    /**
+     * @return RuleViolationList
+     */
+    public function violations(): array
+    {
+        return $this->violations;
+    }
+
+    public function durationSeconds(): float
+    {
+        return $this->durationSeconds;
+    }
+
+    public function inspectedFiles(): int
+    {
+        return $this->inspectedFiles;
+    }
+
+    public function inspectedClasses(): int
+    {
+        return $this->inspectedClasses;
+    }
+
+    public function hasViolations(): bool
+    {
+        return $this->violations !== [];
+    }
+
+    public function countViolations(): int
+    {
+        return count($this->violations);
+    }
+
+    /**
+     * @return array<string, RuleViolationList>
+     */
+    public function groupedByRule(): array
+    {
+        $grouped = [];
+
+        foreach ($this->violations as $violation) {
+            $grouped[$violation->ruleName()][] = $violation;
+        }
+
+        ksort($grouped);
+
+        return $grouped;
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function errors(): array
+    {
+        return $this->errors;
+    }
+
+    public function hasErrors(): bool
+    {
+        return $this->errors !== [];
+    }
+}
+
diff --git a/src/Framework/Quality/CodeQuality/Results/RuleViolation.php b/src/Framework/Quality/CodeQuality/Results/RuleViolation.php
new file mode 100644
index 00000000..2cb4f917
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Results/RuleViolation.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Results;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use Stringable;
+
+/**
+ * Represents a failed rule evaluation for a specific class.
+ */
+final readonly class RuleViolation implements Stringable
+{
+    public function __construct(
+        private ClassName $className,
+        private FilePath $filePath,
+        private string $ruleName,
+        private string $message,
+        private ?int $line = null
+    ) {
+    }
+
+    public static function create(
+        ClassName $className,
+        FilePath $filePath,
+        string $ruleName,
+        string $message,
+        ?int $line = null
+    ): self {
+        return new self($className, $filePath, $ruleName, $message, $line);
+    }
+
+    public function className(): ClassName
+    {
+        return $this->className;
+    }
+
+    public function filePath(): FilePath
+    {
+        return $this->filePath;
+    }
+
+    public function ruleName(): string
+    {
+        return $this->ruleName;
+    }
+
+    public function message(): string
+    {
+        return $this->message;
+    }
+
+    public function line(): ?int
+    {
+        return $this->line;
+    }
+
+    public function __toString(): string
+    {
+        $lineInfo = $this->line !== null ? ':' . $this->line : '';
+
+        return sprintf(
+            '[%s] %s (%s%s)',
+            $this->ruleName,
+            $this->message,
+            $this->filePath->toString(),
+            $lineInfo
+        );
+    }
+}
+
diff --git a/src/Framework/Quality/CodeQuality/Rules/DisallowInheritanceRule.php b/src/Framework/Quality/CodeQuality/Rules/DisallowInheritanceRule.php
new file mode 100644
index 00000000..52f3d607
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Rules/DisallowInheritanceRule.php
@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Rules;
+
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+/**
+ * Flags classes that extend another class unless the parent is explicitly allowed.
+ */
+final readonly class DisallowInheritanceRule implements CodeQualityRule
+{
+    /**
+     * @var string[]
+     */
+    private array $allowedParentPatterns;
+
+    public function __construct(?array $allowedParentPatterns = null)
+    {
+        $this->allowedParentPatterns = $allowedParentPatterns ?? [
+            '/(^|\\\\)(.+)?Exception$/i',
+            '/(^|\\\\)(.+)?Error$/i',
+            '/(^|\\\\)Attribute$/i',
+            '/(^|\\\\)TestCase$/i',
+        ];
+    }
+
+    public function name(): string
+    {
+        return 'NoInheritance';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        $parent = $inspection->parentClassName();
+
+        if ($parent === null) {
+            return [];
+        }
+
+        if ($this->isAllowedParent($parent)) {
+            return [];
+        }
+
+        return [
+            RuleViolation::create(
+                $inspection->className(),
+                $inspection->filePath(),
+                $this->name(),
+                sprintf('Inheritance detected (extends %s); prefer composition.', $parent)
+            ),
+        ];
+    }
+
+    private function isAllowedParent(string $parent): bool
+    {
+        foreach ($this->allowedParentPatterns as $pattern) {
+            if (preg_match($pattern, $parent) === 1) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/Rules/FinalClassRule.php b/src/Framework/Quality/CodeQuality/Rules/FinalClassRule.php
new file mode 100644
index 00000000..3c81ff5a
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Rules/FinalClassRule.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Rules;
+
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+/**
+ * Ensures value object classes are declared final.
+ */
+final readonly class FinalClassRule implements CodeQualityRule
+{
+    private const array TARGET_DIRECTORIES = ['/ValueObjects/', '/ValueObject/'];
+
+    public function name(): string
+    {
+        return 'FinalClass';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        if (! $this->shouldEvaluate($inspection)) {
+            return [];
+        }
+
+        if ($inspection->isAbstract() || $inspection->isFinal()) {
+            return [];
+        }
+
+        return [
+            RuleViolation::create(
+                $inspection->className(),
+                $inspection->filePath(),
+                $this->name(),
+                'Value object classes must be declared final.'
+            ),
+        ];
+    }
+
+    private function shouldEvaluate(ClassInspection $inspection): bool
+    {
+        $path = $inspection->filePath()->toString();
+
+        foreach (self::TARGET_DIRECTORIES as $needle) {
+            if (str_contains($path, $needle)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Framework/Quality/CodeQuality/Rules/ReadonlyGetterRule.php b/src/Framework/Quality/CodeQuality/Rules/ReadonlyGetterRule.php
new file mode 100644
index 00000000..24c928ca
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Rules/ReadonlyGetterRule.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Rules;
+
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+/**
+ * Ensures getters only expose readonly properties.
+ */
+final readonly class ReadonlyGetterRule implements CodeQualityRule
+{
+    public function name(): string
+    {
+        return 'ReadonlyGetter';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        $violations = [];
+
+        $classReadonly = $inspection->isReadonlyClass();
+
+        foreach ($inspection->methodReturnProperties() as $methodKey => $properties) {
+            if (! str_starts_with($methodKey, 'get')) {
+                continue;
+            }
+
+            $methodName = $inspection->originalMethodName($methodKey);
+
+            foreach ($properties as $property) {
+                $propertyReadonly = $inspection->isPropertyReadonly($property);
+
+                if (! $classReadonly && ! $propertyReadonly) {
+                    continue;
+                }
+
+                $violations[] = RuleViolation::create(
+                    $inspection->className(),
+                    $inspection->filePath(),
+                    $this->name(),
+                    sprintf(
+                        'Readonly property $%s is exposed via %s(); prefer a public readonly property instead of a getter.',
+                        $property,
+                        $methodName
+                    ),
+                    $inspection->getMethodLine($methodName)
+                );
+            }
+        }
+
+        return $violations;
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/Rules/ReadonlyPropertyRule.php b/src/Framework/Quality/CodeQuality/Rules/ReadonlyPropertyRule.php
new file mode 100644
index 00000000..8f3d1864
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Rules/ReadonlyPropertyRule.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Rules;
+
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+
+/**
+ * Requires value object classes to be declared as readonly.
+ */
+final readonly class ReadonlyPropertyRule implements CodeQualityRule
+{
+    private const array TARGET_DIRECTORIES = ['/ValueObjects/', '/ValueObject/'];
+
+    public function name(): string
+    {
+        return 'ReadonlyClass';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        if (! $this->shouldEvaluate($inspection)) {
+            return [];
+        }
+
+        if ($inspection->isReadonlyClass()) {
+            return [];
+        }
+
+        return [
+            RuleViolation::create(
+                $inspection->className(),
+                $inspection->filePath(),
+                $this->name(),
+                'Value object classes should be declared readonly to enforce immutability.'
+            ),
+        ];
+    }
+
+    private function shouldEvaluate(ClassInspection $inspection): bool
+    {
+        $path = $inspection->filePath()->toString();
+
+        foreach (self::TARGET_DIRECTORIES as $needle) {
+            if (str_contains($path, $needle)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
+
diff --git a/src/Framework/Quality/CodeQuality/Rules/RequireStringableImplementationRule.php b/src/Framework/Quality/CodeQuality/Rules/RequireStringableImplementationRule.php
new file mode 100644
index 00000000..8aff858f
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/Rules/RequireStringableImplementationRule.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\Rules;
+
+use App\Framework\Quality\CodeQuality\CodeQualityRule;
+use App\Framework\Quality\CodeQuality\Results\RuleViolation;
+use App\Framework\Quality\CodeQuality\ValueObjects\ClassInspection;
+use Stringable;
+
+/**
+ * Ensures classes declaring __toString implement the Stringable interface explicitly.
+ */
+final readonly class RequireStringableImplementationRule implements CodeQualityRule
+{
+    public function name(): string
+    {
+        return 'StringableImplementation';
+    }
+
+    public function check(ClassInspection $inspection): array
+    {
+        if (! $inspection->hasMethod('__toString')) {
+            return [];
+        }
+
+        if ($inspection->implementsInterface(Stringable::class)) {
+            return [];
+        }
+
+        $line = $inspection->getMethodLine('__toString');
+
+        return [
+            RuleViolation::create(
+                $inspection->className(),
+                $inspection->filePath(),
+                $this->name(),
+                'Classes defining __toString() must implement Stringable explicitly.',
+                $line
+            ),
+        ];
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/TokenizerClassInspector.php b/src/Framework/Quality/CodeQuality/TokenizerClassInspector.php
new file mode 100644
index 00000000..8ba6bb20
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/TokenizerClassInspector.php
@@ -0,0 +1,527 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use App\Framework\Quality\CodeQuality\ValueObjects\SourceClassMetadata;
+use App\Framework\Tokenizer\PhpTokenizer;
+use App\Framework\Tokenizer\ValueObjects\Token;
+use App\Framework\Tokenizer\ValueObjects\TokenCollection;
+use RuntimeException;
+
+/**
+ * Extracts class metadata using the framework tokenizer.
+ */
+final class TokenizerClassInspector
+{
+    private const array NAME_TOKEN_IDS = [
+        T_STRING,
+        T_NAME_QUALIFIED,
+        T_NAME_FULLY_QUALIFIED,
+        T_NS_SEPARATOR,
+    ];
+
+    public function __construct(
+        private readonly PhpTokenizer $tokenizer = new PhpTokenizer()
+    ) {
+    }
+
+    /**
+     * @return array{classes: array<string, SourceClassMetadata>, errors: list<string>}
+     */
+    public function inspect(FilePath $filePath): array
+    {
+        $code = @file_get_contents($filePath->toString());
+
+        if ($code === false) {
+            return [
+                'classes' => [],
+                'errors' => ["Failed to read {$filePath->toString()}"],
+            ];
+        }
+
+        try {
+            $tokens = $this->tokenizer->tokenizeForDiscovery($code);
+        } catch (RuntimeException $exception) {
+            return [
+                'classes' => [],
+                'errors' => [
+                    sprintf(
+                        'Tokenizer failed on %s: %s',
+                        $filePath->toString(),
+                        $exception->getMessage()
+                    ),
+                ],
+            ];
+        }
+
+        return $this->extractMetadata($tokens, $filePath);
+    }
+
+    /**
+     * @return array{classes: array<string, SourceClassMetadata>, errors: list<string>}
+     */
+    private function extractMetadata(TokenCollection $tokens, FilePath $filePath): array
+    {
+        $metadata = [];
+        $errors = [];
+        $tokenArray = $tokens->toArray();
+        $tokenCount = count($tokenArray);
+
+        for ($index = 0; $index < $tokenCount; $index++) {
+            $token = $tokenArray[$index];
+
+            if (! $token->is([T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM])) {
+                continue;
+            }
+
+            $classNameToken = $this->findNextIdentifier($tokenArray, $index);
+
+            if ($classNameToken === null) {
+                $errors[] = sprintf(
+                    'Unable to determine class name in %s on line %d',
+                    $filePath->toString(),
+                    $token->line
+                );
+                continue;
+            }
+
+            $fqn = $this->buildFullyQualifiedName(
+                $token->context->currentNamespace,
+                $classNameToken->value
+            );
+
+            $classModifiers = $this->collectClassModifiers($tokenArray, $index);
+            $extends = $this->collectExtends($tokenArray, $index, $tokenCount);
+            $implements = $this->collectImplements($tokenArray, $index, $tokenCount);
+            $properties = $this->collectProperties($tokenArray, $index);
+            [$methodLines, $methodReturns, $methodNames] = $this->collectMethodDetails($tokenArray, $index);
+
+            $metadata[$fqn] = new SourceClassMetadata(
+                ClassName::create($fqn),
+                $implements,
+                $methodLines,
+                $methodNames,
+                $classModifiers['isFinal'],
+                $classModifiers['isReadonly'],
+                $classModifiers['isAbstract'],
+                $extends,
+                $properties,
+                $methodReturns
+            );
+        }
+
+        return [
+            'classes' => $metadata,
+            'errors' => $errors,
+        ];
+    }
+
+    private function buildFullyQualifiedName(?string $namespace, string $shortName): string
+    {
+        $namespace = $namespace !== null ? trim($namespace, '\\') : '';
+        $shortName = trim($shortName, '\\');
+
+        if ($namespace === '') {
+            return $shortName;
+        }
+
+        return $namespace . '\\' . $shortName;
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     */
+    private function findNextIdentifier(array $tokens, int $startIndex): ?Token
+    {
+        $tokenCount = count($tokens);
+
+        for ($i = $startIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if ($token->id === T_STRING) {
+                return $token;
+            }
+
+            if ($token->value === '{' || $token->value === ';') {
+                break;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     * @return array{isFinal: bool, isReadonly: bool, isAbstract: bool}
+     */
+    private function collectClassModifiers(array $tokens, int $classIndex): array
+    {
+        $isFinal = false;
+        $isReadonly = false;
+        $isAbstract = false;
+
+        for ($i = $classIndex - 1; $i >= 0; $i--) {
+            $token = $tokens[$i];
+
+            if ($token->id === T_WHITESPACE || $token->id === T_COMMENT || $token->id === T_DOC_COMMENT) {
+                continue;
+            }
+
+            if ($token->id === T_FINAL) {
+                $isFinal = true;
+                continue;
+            }
+
+            if ($token->id === T_READONLY) {
+                $isReadonly = true;
+                continue;
+            }
+
+            if ($token->id === T_ABSTRACT) {
+                $isAbstract = true;
+                continue;
+            }
+
+            break;
+        }
+
+        return [
+            'isFinal' => $isFinal,
+            'isReadonly' => $isReadonly,
+            'isAbstract' => $isAbstract,
+        ];
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     */
+    private function collectExtends(array $tokens, int $classIndex, int $tokenCount): ?string
+    {
+        for ($i = $classIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if ($token->id === T_EXTENDS) {
+                return $this->collectQualifiedName($tokens, $i + 1, $tokenCount);
+            }
+
+            if ($token->value === '{') {
+                break;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     * @return array<int, string>
+     */
+    private function collectImplements(array $tokens, int $classIndex, int $tokenCount): array
+    {
+        $interfaces = [];
+
+        for ($i = $classIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if ($token->id === T_IMPLEMENTS) {
+                $position = $i + 1;
+
+                while ($position < $tokenCount) {
+                    $name = $this->collectQualifiedName($tokens, $position, $tokenCount, $endIndex);
+                    if ($name !== null) {
+                        $interfaces[] = $name;
+                        $position = $endIndex;
+                        continue;
+                    }
+
+                    if ($tokens[$position]->value === '{') {
+                        break 2;
+                    }
+
+                    $position++;
+                }
+            }
+
+            if ($token->value === '{') {
+                break;
+            }
+        }
+
+        return $interfaces;
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     * @param int $startIndex
+     * @param int $tokenCount
+     * @param int|null $endIndex
+     */
+    private function collectQualifiedName(array $tokens, int $startIndex, int $tokenCount, ?int &$endIndex = null): ?string
+    {
+        $parts = [];
+        $endIndex = $startIndex;
+
+        for ($i = $startIndex; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if (in_array($token->id, self::NAME_TOKEN_IDS, true)) {
+                $parts[] = $token->value;
+                $endIndex = $i + 1;
+                continue;
+            }
+
+            if ($token->id === T_WHITESPACE) {
+                $endIndex = $i + 1;
+                continue;
+            }
+
+            if ($token->value === ',' || $token->value === '{') {
+                break;
+            }
+
+            break;
+        }
+
+        if ($parts === []) {
+            return null;
+        }
+
+        return ltrim(implode('', $parts), '\\');
+    }
+
+    /**
+     * @param array<int, Token> $tokens
+     * @return array<string, int|null>
+     */
+    private function collectProperties(array $tokens, int $classIndex): array
+    {
+        $properties = [];
+        $tokenCount = count($tokens);
+        $depth = 0;
+        $inBody = false;
+
+        for ($i = $classIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if (! $inBody) {
+                if ($token->value === '{') {
+                    $inBody = true;
+                    $depth = 1;
+                }
+
+                continue;
+            }
+
+            if ($token->value === '{') {
+                $depth++;
+            } elseif ($token->value === '}') {
+                $depth--;
+                if ($depth === 0) {
+                    break;
+                }
+            }
+
+            if ($depth !== 1) {
+                continue;
+            }
+
+            if ($token->id === T_VARIABLE && ! $token->context->isInFunction) {
+                $name = ltrim($token->value, '$');
+                $key = strtolower($name);
+                $properties[$key] = [
+                    'name' => $name,
+                    'readonly' => $this->propertyHasReadonlyModifier($tokens, $i),
+                ];
+            }
+        }
+
+        return $properties;
+    }
+
+    /**
+     * @return array{array<string, int|null>, array<string, list<string>>}
+     */
+    private function collectMethodDetails(array $tokens, int $classIndex): array
+    {
+        $methodLines = [];
+        $methodReturns = [];
+        $methodNames = [];
+        $tokenCount = count($tokens);
+        $depth = 0;
+        $inBody = false;
+
+        for ($i = $classIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if (! $inBody) {
+                if ($token->value === '{') {
+                    $inBody = true;
+                    $depth = 1;
+                }
+
+                continue;
+            }
+
+            if ($token->value === '{') {
+                $depth++;
+            } elseif ($token->value === '}') {
+                $depth--;
+                if ($depth === 0) {
+                    break;
+                }
+            }
+
+            if ($depth !== 1 || $token->id !== T_FUNCTION) {
+                continue;
+            }
+
+            $methodNameToken = $this->findNextIdentifier($tokens, $i);
+
+            if ($methodNameToken === null) {
+                continue;
+            }
+
+            $methodKey = strtolower($methodNameToken->value);
+            $methodLines[$methodKey] = $token->line;
+            $methodNames[$methodKey] = $methodNameToken->value;
+
+            [$endIndex, $returns] = $this->collectReturnsForMethod($tokens, $i);
+
+            if ($returns !== []) {
+                $methodReturns[$methodKey] = $returns;
+            }
+
+            if ($endIndex !== null) {
+                $i = $endIndex;
+            }
+        }
+
+        return [$methodLines, $methodReturns, $methodNames];
+    }
+
+    /**
+     * @return array{int|null, list<string>}
+     */
+    private function collectReturnsForMethod(array $tokens, int $functionIndex): array
+    {
+        $tokenCount = count($tokens);
+        $braceIndex = $this->findMethodBodyStart($tokens, $functionIndex, $tokenCount);
+
+        if ($braceIndex === null) {
+            return [null, []];
+        }
+
+        $returns = [];
+        $depth = 1;
+
+        for ($i = $braceIndex + 1; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if ($token->value === '{') {
+                $depth++;
+                continue;
+            }
+
+            if ($token->value === '}') {
+                $depth--;
+                if ($depth === 0) {
+                    return [$i, array_values(array_unique($returns))];
+                }
+
+                continue;
+            }
+
+            if ($token->id === T_RETURN) {
+                $property = $this->parseReturnThisProperty($tokens, $i, $tokenCount);
+
+                if ($property !== null) {
+                    $returns[] = $property;
+                }
+            }
+        }
+
+        return [null, array_values(array_unique($returns))];
+    }
+
+    private function findMethodBodyStart(array $tokens, int $functionIndex, int $tokenCount): ?int
+    {
+        for ($i = $functionIndex; $i < $tokenCount; $i++) {
+            $token = $tokens[$i];
+
+            if ($token->value === '{') {
+                return $i;
+            }
+
+            if ($token->value === ';') {
+                return null;
+            }
+        }
+
+        return null;
+    }
+
+    private function parseReturnThisProperty(array $tokens, int $returnIndex, int $tokenCount): ?string
+    {
+        $i = $returnIndex + 1;
+
+        while ($i < $tokenCount && $tokens[$i]->id === T_WHITESPACE) {
+            $i++;
+        }
+
+        if ($i >= $tokenCount || $tokens[$i]->id !== T_VARIABLE || $tokens[$i]->value !== '$this') {
+            return null;
+        }
+
+        $i++;
+        while ($i < $tokenCount && $tokens[$i]->id === T_WHITESPACE) {
+            $i++;
+        }
+
+        if ($i >= $tokenCount || $tokens[$i]->value !== '->') {
+            return null;
+        }
+
+        $i++;
+        while ($i < $tokenCount && $tokens[$i]->id === T_WHITESPACE) {
+            $i++;
+        }
+
+        if ($i >= $tokenCount || $tokens[$i]->id !== T_STRING) {
+            return null;
+        }
+
+        $property = $tokens[$i]->value;
+
+        $i++;
+        while ($i < $tokenCount && $tokens[$i]->id === T_WHITESPACE) {
+            $i++;
+        }
+
+        if ($i < $tokenCount && $tokens[$i]->value === ';') {
+            return $property;
+        }
+
+        return null;
+    }
+
+    private function propertyHasReadonlyModifier(array $tokens, int $variableIndex): bool
+    {
+        for ($i = $variableIndex - 1; $i >= 0; $i--) {
+            $token = $tokens[$i];
+
+            if ($token->id === T_READONLY) {
+                return true;
+            }
+
+            if ($token->value === ';' || $token->value === '{' || $token->id === T_FUNCTION) {
+                break;
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/ValueObjects/ClassInspection.php b/src/Framework/Quality/CodeQuality/ValueObjects/ClassInspection.php
new file mode 100644
index 00000000..7f80f864
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/ValueObjects/ClassInspection.php
@@ -0,0 +1,164 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\ValueObjects;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use App\Framework\Reflection\ClassInfo;
+use ReflectionClass;
+
+/**
+ * Context passed to rules when inspecting a class.
+ *
+ * Provides a lightweight view over the inspected class based on static source
+ * metadata. When available, reflection data is attached as well, but rules
+ * should prefer the helper methods (hasMethod/implementsInterface) so they
+ * continue working when reflection is skipped.
+ */
+final readonly class ClassInspection
+{
+    public function __construct(
+        private ClassName $className,
+        private FilePath $filePath,
+        private SourceClassMetadata $metadata,
+        private ?ClassInfo $classInfo = null
+    ) {
+    }
+
+    public function className(): ClassName
+    {
+        return $this->className;
+    }
+
+    public function filePath(): FilePath
+    {
+        return $this->filePath;
+    }
+
+    public function metadata(): SourceClassMetadata
+    {
+        return $this->metadata;
+    }
+
+    public function isFinal(): bool
+    {
+        if ($this->classInfo !== null) {
+            return $this->classInfo->isFinal();
+        }
+
+        return $this->metadata->isFinal();
+    }
+
+    public function isReadonlyClass(): bool
+    {
+        if ($this->classInfo !== null) {
+            $native = $this->classInfo->getNativeClass();
+
+            if (method_exists($native, 'isReadOnly') && $native->isReadOnly()) {
+                return true;
+            }
+        }
+
+        return $this->metadata->isReadonlyClass();
+    }
+
+    public function isAbstract(): bool
+    {
+        if ($this->classInfo !== null) {
+            return $this->classInfo->isAbstract();
+        }
+
+        return $this->metadata->isAbstract();
+    }
+
+    public function parentClassName(): ?string
+    {
+        if ($this->classInfo !== null) {
+            $parent = $this->classInfo->getNativeClass()->getParentClass();
+
+            return $parent?->getName();
+        }
+
+        return $this->metadata->parentClass();
+    }
+
+    public function reflection(): ?ClassInfo
+    {
+        return $this->classInfo;
+    }
+
+    public function hasMethod(string $methodName): bool
+    {
+        if ($this->classInfo !== null && $this->classInfo->hasMethod($methodName)) {
+            return true;
+        }
+
+        return $this->metadata->hasMethod($methodName);
+    }
+
+    public function getMethodLine(string $methodName): ?int
+    {
+        if ($this->classInfo !== null && $this->classInfo->hasMethod($methodName)) {
+            return $this->classInfo
+                ->getMethod($methodName)
+                ->getNativeMethod()
+                ->getStartLine() ?: null;
+        }
+
+        return $this->metadata->methodLine($methodName);
+    }
+
+    public function implementsInterface(string $interfaceName): bool
+    {
+        if ($this->classInfo !== null && $this->classInfo->implementsInterface($interfaceName)) {
+            return true;
+        }
+
+        return $this->metadata->implementsInterface($interfaceName);
+    }
+
+    public function methodReturnProperties(): array
+    {
+        return $this->metadata->methodReturnProperties();
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function methodReturns(string $methodName): array
+    {
+        return $this->metadata->methodReturns($methodName);
+    }
+
+    public function originalMethodName(string $methodName): string
+    {
+        return $this->metadata->originalMethodName($methodName) ?? $methodName;
+    }
+
+    public function isPropertyReadonly(string $propertyName): bool
+    {
+        if ($this->isReadonlyClass()) {
+            return true;
+        }
+
+        $metadataReadonly = $this->metadata->isPropertyReadonly($propertyName);
+        if ($metadataReadonly !== null) {
+            return $metadataReadonly;
+        }
+
+        if ($this->classInfo !== null) {
+            $native = $this->classInfo->getNativeClass();
+            if ($native->hasProperty($propertyName)) {
+                $property = $native->getProperty($propertyName);
+
+                if (method_exists($property, 'isReadOnly') && $property->isReadOnly()) {
+                    return true;
+                }
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/src/Framework/Quality/CodeQuality/ValueObjects/SourceClassMetadata.php b/src/Framework/Quality/CodeQuality/ValueObjects/SourceClassMetadata.php
new file mode 100644
index 00000000..fe4d1225
--- /dev/null
+++ b/src/Framework/Quality/CodeQuality/ValueObjects/SourceClassMetadata.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Quality\CodeQuality\ValueObjects;
+
+use App\Framework\Core\ValueObjects\ClassName;
+
+/**
+ * Static information about a class gathered from token inspection only.
+ */
+final readonly class SourceClassMetadata
+{
+    /**
+     * @param array<int, string> $implementedInterfaces
+     * @param array<string, int|null> $methodLines Map of lowercase method name => start line
+     * @param array<string, string> $methodNames Map of lowercase method name => original name
+     * @param array<string, array{name: string, readonly: bool}> $properties
+     * @param array<string, list<string>> $methodReturnProperties
+     */
+    public function __construct(
+        private ClassName $className,
+        private array $implementedInterfaces,
+        private array $methodLines,
+        private array $methodNames,
+        private bool $isFinal,
+        private bool $isReadonlyClass,
+        private bool $isAbstract,
+        private ?string $parentClass,
+        private array $properties,
+        private array $methodReturnProperties
+    ) {
+    }
+
+    public function className(): ClassName
+    {
+        return $this->className;
+    }
+
+    public function implementedInterfaces(): array
+    {
+        return $this->implementedInterfaces;
+    }
+
+    public function isFinal(): bool
+    {
+        return $this->isFinal;
+    }
+
+    public function isReadonlyClass(): bool
+    {
+        return $this->isReadonlyClass;
+    }
+
+    public function isAbstract(): bool
+    {
+        return $this->isAbstract;
+    }
+
+    public function parentClass(): ?string
+    {
+        return $this->parentClass;
+    }
+
+    public function implementsInterface(string $interface): bool
+    {
+        $normalized = $this->normalizeInterfaceName($interface);
+
+        foreach ($this->implementedInterfaces as $implemented) {
+            if ($this->normalizeInterfaceName($implemented) === $normalized) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    private function normalizeInterfaceName(string $interface): string
+    {
+        $trimmed = ltrim($interface, '\\');
+
+        return strtolower($trimmed);
+    }
+
+    public function methodLine(string $method): ?int
+    {
+        return $this->methodLines[strtolower($method)] ?? null;
+    }
+
+    public function hasMethod(string $method): bool
+    {
+        return array_key_exists(strtolower($method), $this->methodLines);
+    }
+
+    public function isPropertyReadonly(string $property): ?bool
+    {
+        $key = strtolower($property);
+
+        return $this->properties[$key]['readonly'] ?? null;
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function methodReturns(string $method): array
+    {
+        return $this->methodReturnProperties[strtolower($method)] ?? [];
+    }
+
+    /**
+     * @return array<string, list<string>>
+     */
+    public function methodReturnProperties(): array
+    {
+        return $this->methodReturnProperties;
+    }
+
+    /**
+     * @return array<string, array{name: string, readonly: bool}>
+     */
+    public function properties(): array
+    {
+        return $this->properties;
+    }
+
+    public function originalMethodName(string $method): ?string
+    {
+        return $this->methodNames[strtolower($method)] ?? null;
+    }
+}
diff --git a/src/Framework/QueryBus/QueryHandlerMapper.php b/src/Framework/QueryBus/QueryHandlerMapper.php
index f973ef2e..bc8794f0 100644
--- a/src/Framework/QueryBus/QueryHandlerMapper.php
+++ b/src/Framework/QueryBus/QueryHandlerMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\QueryBus;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 /**
  * Mapper für das QueryHandler-Attribut
diff --git a/src/Framework/Queue/Exceptions/AllStepsCompletedException.php b/src/Framework/Queue/Exceptions/AllStepsCompletedException.php
index 11890a2f..e72fb35b 100644
--- a/src/Framework/Queue/Exceptions/AllStepsCompletedException.php
+++ b/src/Framework/Queue/Exceptions/AllStepsCompletedException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Exception thrown when attempting to complete or update steps after all steps are completed
@@ -14,17 +13,9 @@ final class AllStepsCompletedException extends QueueException
 {
     public static function forJob(string $jobId, int $totalSteps): self
     {
-        $context = ExceptionContext::forOperation('step.complete', 'StepProgressTracker')
-            ->withData([
-                'job_id' => $jobId,
-                'total_steps' => $totalSteps,
-                'current_step_index' => $totalSteps,
-            ]);
-
-        return self::create(
-            QueueErrorCode::INVALID_STATE,
+        return new self(
             "All {$totalSteps} steps have already been completed for job '{$jobId}'",
-            $context
+            (int) QueueErrorCode::INVALID_STATE->value
         );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/ChainNotFoundException.php b/src/Framework/Queue/Exceptions/ChainNotFoundException.php
index f8600539..4f3740d8 100644
--- a/src/Framework/Queue/Exceptions/ChainNotFoundException.php
+++ b/src/Framework/Queue/Exceptions/ChainNotFoundException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Exception thrown when a job chain cannot be found
@@ -14,31 +13,17 @@ final class ChainNotFoundException extends QueueException
 {
     public static function byId(string $chainId): self
     {
-        $context = ExceptionContext::forOperation('chain.lookup', 'JobChainManager')
-            ->withData([
-                'chain_id' => $chainId,
-                'search_type' => 'by_id',
-            ]);
-
-        return self::create(
-            QueueErrorCode::CHAIN_NOT_FOUND,
+        return new self(
             "Chain with ID '{$chainId}' not found",
-            $context
+            (int) QueueErrorCode::CHAIN_NOT_FOUND->value
         );
     }
 
     public static function byName(string $name): self
     {
-        $context = ExceptionContext::forOperation('chain.lookup', 'JobChainManager')
-            ->withData([
-                'chain_name' => $name,
-                'search_type' => 'by_name',
-            ]);
-
-        return self::create(
-            QueueErrorCode::CHAIN_NOT_FOUND,
+        return new self(
             "Chain with name '{$name}' not found",
-            $context
+            (int) QueueErrorCode::CHAIN_NOT_FOUND->value
         );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/CircularDependencyException.php b/src/Framework/Queue/Exceptions/CircularDependencyException.php
index 87722877..20f8945d 100644
--- a/src/Framework/Queue/Exceptions/CircularDependencyException.php
+++ b/src/Framework/Queue/Exceptions/CircularDependencyException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Exception thrown when circular dependencies are detected in job chains
@@ -14,16 +13,9 @@ final class CircularDependencyException extends QueueException
 {
     public static function inChain(string $chainId, array $circularDependencies = []): self
     {
-        $context = ExceptionContext::forOperation('chain.validate', 'JobChainExecutionCoordinator')
-            ->withData([
-                'chain_id' => $chainId,
-                'circular_dependencies' => $circularDependencies,
-            ]);
-
-        return self::create(
-            QueueErrorCode::CIRCULAR_DEPENDENCY,
+        return new self(
             "Chain '{$chainId}' has circular dependencies",
-            $context
+            (int) QueueErrorCode::CIRCULAR_DEPENDENCY->value
         );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/InvalidChainStateException.php b/src/Framework/Queue/Exceptions/InvalidChainStateException.php
index 78a28df2..5d4e7d50 100644
--- a/src/Framework/Queue/Exceptions/InvalidChainStateException.php
+++ b/src/Framework/Queue/Exceptions/InvalidChainStateException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Exception thrown when a job chain is in an invalid state for the requested operation
@@ -14,47 +13,25 @@ final class InvalidChainStateException extends QueueException
 {
     public static function notPending(string $chainId, string $currentStatus): self
     {
-        $context = ExceptionContext::forOperation('chain.start', 'JobChainManager')
-            ->withData([
-                'chain_id' => $chainId,
-                'current_status' => $currentStatus,
-                'required_status' => 'pending',
-            ]);
-
-        return self::create(
-            QueueErrorCode::INVALID_STATE,
+        return new self(
             "Chain '{$chainId}' is not in pending status (current: {$currentStatus})",
-            $context
+            (int) QueueErrorCode::INVALID_STATE->value
         );
     }
 
     public static function alreadyCompleted(string $chainId): self
     {
-        $context = ExceptionContext::forOperation('chain.modify', 'JobChainManager')
-            ->withData([
-                'chain_id' => $chainId,
-                'current_status' => 'completed',
-            ]);
-
-        return self::create(
-            QueueErrorCode::INVALID_STATE,
+        return new self(
             "Chain '{$chainId}' is already completed and cannot be modified",
-            $context
+            (int) QueueErrorCode::INVALID_STATE->value
         );
     }
 
     public static function alreadyFailed(string $chainId): self
     {
-        $context = ExceptionContext::forOperation('chain.modify', 'JobChainManager')
-            ->withData([
-                'chain_id' => $chainId,
-                'current_status' => 'failed',
-            ]);
-
-        return self::create(
-            QueueErrorCode::INVALID_STATE,
+        return new self(
             "Chain '{$chainId}' has failed and cannot be modified",
-            $context
+            (int) QueueErrorCode::INVALID_STATE->value
         );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/InvalidDeadLetterQueueNameException.php b/src/Framework/Queue/Exceptions/InvalidDeadLetterQueueNameException.php
index 24bf179a..6866a4b2 100644
--- a/src/Framework/Queue/Exceptions/InvalidDeadLetterQueueNameException.php
+++ b/src/Framework/Queue/Exceptions/InvalidDeadLetterQueueNameException.php
@@ -11,36 +11,25 @@ final class InvalidDeadLetterQueueNameException extends FrameworkException
 {
     public static function tooShort(string $name, int $minLength): self
     {
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Dead letter queue name '{$name}' is too short. Minimum length is {$minLength} characters."
-        )->withData([
-            'name' => $name,
-            'actual_length' => strlen($name),
-            'min_length' => $minLength,
-        ]);
+        return new self(
+            "Dead letter queue name '{$name}' is too short. Minimum length is {$minLength} characters.",
+            (int) ValidationErrorCode::BUSINESS_RULE_VIOLATION->value
+        );
     }
 
     public static function tooLong(string $name, int $maxLength): self
     {
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Dead letter queue name '{$name}' is too long. Maximum length is {$maxLength} characters."
-        )->withData([
-            'name' => $name,
-            'actual_length' => strlen($name),
-            'max_length' => $maxLength,
-        ]);
+        return new self(
+            "Dead letter queue name '{$name}' is too long. Maximum length is {$maxLength} characters.",
+            (int) ValidationErrorCode::BUSINESS_RULE_VIOLATION->value
+        );
     }
 
     public static function invalidFormat(string $name, string $pattern): self
     {
-        return self::create(
-            ValidationErrorCode::BUSINESS_RULE_VIOLATION,
-            "Dead letter queue name '{$name}' contains invalid characters. Only alphanumeric characters, underscores, hyphens, and dots are allowed."
-        )->withData([
-            'name' => $name,
-            'valid_pattern' => $pattern,
-        ]);
+        return new self(
+            "Dead letter queue name '{$name}' contains invalid characters. Only alphanumeric characters, underscores, hyphens, and dots are allowed.",
+            (int) ValidationErrorCode::BUSINESS_RULE_VIOLATION->value
+        );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/JobNotFoundException.php b/src/Framework/Queue/Exceptions/JobNotFoundException.php
index 94061733..a5426aa5 100644
--- a/src/Framework/Queue/Exceptions/JobNotFoundException.php
+++ b/src/Framework/Queue/Exceptions/JobNotFoundException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Queue\ValueObjects\JobId;
 
 /**
@@ -15,32 +14,17 @@ final class JobNotFoundException extends QueueException
 {
     public static function byId(JobId $jobId): self
     {
-        $context = ExceptionContext::forOperation('job.lookup', 'JobPersistenceLayer')
-            ->withData([
-                'job_id' => $jobId->toString(),
-                'search_type' => 'by_id',
-            ]);
-
-        return self::create(
-            QueueErrorCode::JOB_NOT_FOUND,
+        return new self(
             "Job with ID '{$jobId->toString()}' not found",
-            $context
+            (int) QueueErrorCode::JOB_NOT_FOUND->value
         );
     }
 
     public static function inQueue(JobId $jobId, string $queueName): self
     {
-        $context = ExceptionContext::forOperation('job.lookup', 'Queue')
-            ->withData([
-                'job_id' => $jobId->toString(),
-                'queue_name' => $queueName,
-                'search_type' => 'in_queue',
-            ]);
-
-        return self::create(
-            QueueErrorCode::JOB_NOT_FOUND,
+        return new self(
             "Job '{$jobId->toString()}' not found in queue '{$queueName}'",
-            $context
+            (int) QueueErrorCode::JOB_NOT_FOUND->value
         );
     }
 }
diff --git a/src/Framework/Queue/Exceptions/RedisExtensionNotLoadedException.php b/src/Framework/Queue/Exceptions/RedisExtensionNotLoadedException.php
index 707e1a66..91946c38 100644
--- a/src/Framework/Queue/Exceptions/RedisExtensionNotLoadedException.php
+++ b/src/Framework/Queue/Exceptions/RedisExtensionNotLoadedException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\Queue\Exceptions;
 
 use App\Framework\Exception\Core\QueueErrorCode;
-use App\Framework\Exception\ExceptionContext;
 
 /**
  * Exception thrown when Redis PHP extension is not loaded
@@ -16,17 +15,9 @@ final class RedisExtensionNotLoadedException extends QueueException
 {
     public static function notLoaded(): self
     {
-        $context = ExceptionContext::forOperation('queue.init', 'QueueInitializer')
-            ->withData([
-                'required_extension' => 'redis',
-                'loaded_extensions' => get_loaded_extensions(),
-                'fallback_available' => 'FileQueue',
-            ]);
-
-        return self::fromContext(
+        return new self(
             'Redis PHP extension is not loaded',
-            $context,
-            QueueErrorCode::WORKER_UNAVAILABLE
+            (int) QueueErrorCode::WORKER_UNAVAILABLE->value
         );
     }
 }
diff --git a/src/Framework/Redis/InvalidRedisTtlException.php b/src/Framework/Redis/InvalidRedisTtlException.php
index a9e0eccc..bbae8012 100644
--- a/src/Framework/Redis/InvalidRedisTtlException.php
+++ b/src/Framework/Redis/InvalidRedisTtlException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Redis;
 
-use App\Framework\Exception\ErrorCode;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -17,13 +16,7 @@ final class InvalidRedisTtlException extends FrameworkException
      */
     public static function negative(int $seconds): self
     {
-        return self::create(
-            ErrorCode::VAL_INVALID_INPUT,
-            "Redis TTL cannot be negative: {$seconds} seconds"
-        )->withData([
-            'ttl_seconds' => $seconds,
-            'reason' => 'negative_value',
-        ]);
+        return new self("Redis TTL cannot be negative: {$seconds} seconds");
     }
 
     /**
@@ -31,14 +24,7 @@ final class InvalidRedisTtlException extends FrameworkException
      */
     public static function zero(): self
     {
-        return self::create(
-            ErrorCode::VAL_INVALID_INPUT,
-            'Redis TTL cannot be zero. Use delete() to remove keys immediately.'
-        )->withData([
-            'ttl_seconds' => 0,
-            'reason' => 'zero_value',
-            'suggested_action' => 'Use RedisConnection::delete() instead',
-        ]);
+        return new self('Redis TTL cannot be zero. Use delete() to remove keys immediately.');
     }
 
     /**
@@ -46,13 +32,6 @@ final class InvalidRedisTtlException extends FrameworkException
      */
     public static function alreadyExpired(int $seconds): self
     {
-        return self::create(
-            ErrorCode::VAL_INVALID_INPUT,
-            "Redis TTL refers to a time in the past: {$seconds} seconds ago"
-        )->withData([
-            'ttl_seconds' => $seconds,
-            'reason' => 'past_timestamp',
-            'suggested_action' => 'Provide a future timestamp',
-        ]);
+        return new self("Redis TTL refers to a time in the past: {$seconds} seconds ago. Provide a future timestamp.");
     }
 }
diff --git a/src/Framework/Redis/RedisConnectionException.php b/src/Framework/Redis/RedisConnectionException.php
index cc8c37ad..99cfd967 100644
--- a/src/Framework/Redis/RedisConnectionException.php
+++ b/src/Framework/Redis/RedisConnectionException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Redis;
 
-use App\Framework\Exception\Core\CacheErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -13,11 +11,8 @@ use App\Framework\Exception\FrameworkException;
  */
 final class RedisConnectionException extends FrameworkException
 {
-    public function __construct(string $message, int $code = 0, ?\Throwable $previous = null, ?int $retryAfter = null)
+    public function __construct(string $message, int $code = 0, ?\Throwable $previous = null)
     {
-        $context = ExceptionContext::forOperation('Redis Connection');
-        $errorCode = CacheErrorCode::CONNECTION_FAILED;
-
-        parent::__construct($message, $context, $code, $previous, $errorCode, $retryAfter);
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/Reflection/Async/AsyncReflectionProcessor.php b/src/Framework/Reflection/Async/AsyncReflectionProcessor.php
deleted file mode 100644
index aa8bafac..00000000
--- a/src/Framework/Reflection/Async/AsyncReflectionProcessor.php
+++ /dev/null
@@ -1,108 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Async;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\DateTime\Clock;
-use App\Framework\Reflection\ReflectionProvider;
-
-/**
- * Asynchronous reflection processor for non-blocking operations
- */
-final class AsyncReflectionProcessor
-{
-    /**
-     * @var array<string, array<string, mixed>>
-     */
-    private array $pendingOperations = [];
-
-    public function __construct(
-        private readonly ReflectionProvider $reflectionProvider,
-        private readonly Clock $clock
-    ) {
-    }
-
-    /**
-     * Queue class reflection for async processing
-     */
-    public function queueClassReflection(ClassName $className): string
-    {
-        $operationId = uniqid('reflection_', true);
-
-        $this->pendingOperations[$operationId] = [
-            'type' => 'class',
-            'className' => $className,
-            'status' => 'pending',
-            'queued_at' => $this->clock->time()->toFloat(),
-        ];
-
-        return $operationId;
-    }
-
-    /**
-     * Process pending operations in background
-     */
-    public function processPendingOperations(): void
-    {
-        foreach ($this->pendingOperations as $operationId => &$operation) {
-            if ($operation['status'] === 'pending') {
-                try {
-                    $operation['status'] = 'processing';
-                    $operation['started_at'] = $this->clock->time()->toFloat();
-
-                    match ($operation['type']) {
-                        'class' => $this->processClassReflection($operation),
-                        default => throw new \InvalidArgumentException("Unknown operation type: {$operation['type']}")
-                    };
-
-                    $operation['status'] = 'completed';
-                    $operation['completed_at'] = $this->clock->time()->toFloat();
-                } catch (\Throwable $e) {
-                    $operation['status'] = 'failed';
-                    $operation['error'] = $e->getMessage();
-                    $operation['failed_at'] = $this->clock->time()->toFloat();
-                }
-            }
-        }
-    }
-
-    /**
-     * @param array<string, mixed> $operation
-     */
-    private function processClassReflection(array &$operation): void
-    {
-        $className = ClassName::create($operation['className']);
-
-        // Pre-load commonly needed reflection data
-        $class = $this->reflectionProvider->getClass($className);
-        $methods = $this->reflectionProvider->getMethods($className);
-        $attributes = $this->reflectionProvider->getAttributes($className);
-
-        $operation['result'] = [
-            'class' => $class,
-            'methods' => $methods,
-            'attributes' => $attributes,
-        ];
-    }
-
-    /**
-     * @return array<string, mixed>|null
-     */
-    public function getOperationStatus(string $operationId): ?array
-    {
-        return $this->pendingOperations[$operationId] ?? null;
-    }
-
-    /**
-     * @return array<string, array<string, mixed>>
-     */
-    public function getCompletedOperations(): array
-    {
-        return array_filter(
-            $this->pendingOperations,
-            static fn (array $op) => $op['status'] === 'completed'
-        );
-    }
-}
diff --git a/src/Framework/Reflection/BatchOperations/README.md b/src/Framework/Reflection/BatchOperations/README.md
deleted file mode 100644
index 4bc7fb74..00000000
--- a/src/Framework/Reflection/BatchOperations/README.md
+++ /dev/null
@@ -1,159 +0,0 @@
-# Reflection Batch Operations
-
-The Reflection Batch Operations provide methods for performing reflection operations on multiple classes or methods in batch, which can be more efficient than performing individual operations.
-
-## Basic Usage
-
-```php
-use App\Framework\Reflection\BatchOperations\ReflectionBatchProcessor;
-use App\Framework\Reflection\CachedReflectionProvider;
-
-// Create a batch processor
-$provider = new CachedReflectionProvider();
-$batchProcessor = new ReflectionBatchProcessor($provider);
-
-// Get attributes for multiple classes
-$attributes = $batchProcessor->getAttributesForClasses([
-    MyClass1::class,
-    MyClass2::class,
-    MyClass3::class
-], RouteAttribute::class);
-
-// Get methods with a specific attribute
-$methods = $batchProcessor->getMethodsWithAttribute([
-    Controller1::class,
-    Controller2::class,
-    Controller3::class
-], RouteAttribute::class);
-
-// Check instantiability of multiple classes
-$instantiable = $batchProcessor->checkInstantiability([
-    Service1::class,
-    Service2::class,
-    AbstractService::class
-]);
-
-// Check interface implementation
-$implementsInterface = $batchProcessor->checkInterfaceImplementation([
-    Repository1::class,
-    Repository2::class,
-    Repository3::class
-], RepositoryInterface::class);
-```
-
-## Advanced Usage
-
-### Working with Properties and Methods
-
-```php
-// Get properties for multiple classes
-$properties = $batchProcessor->getPropertiesForClasses([
-    Entity1::class,
-    Entity2::class
-]);
-
-// Get methods for multiple classes (with optional filter)
-$publicMethods = $batchProcessor->getMethodsForClasses([
-    Service1::class,
-    Service2::class
-], \ReflectionMethod::IS_PUBLIC);
-
-// Get parameters for multiple methods
-$parameters = $batchProcessor->getMethodParametersForMethods([
-    Controller1::class => ['index', 'show', 'update'],
-    Controller2::class => 'index', // Single method as string
-    Controller3::class => ['store', 'destroy']
-]);
-
-// Get attributes for multiple methods
-$methodAttributes = $batchProcessor->getMethodAttributesForMethods([
-    Controller1::class => ['index', 'show'],
-    Controller2::class => ['index', 'store']
-], RouteAttribute::class);
-```
-
-### Creating Instances
-
-```php
-// Create instances of multiple classes
-$instances = $batchProcessor->createInstances([
-    Service1::class => [],  // No constructor arguments
-    Service2::class => ['arg1', 'arg2'],  // With constructor arguments
-    Service3::class => [new Dependency()]  // With object dependencies
-]);
-
-// Process the instances
-foreach ($instances as $className => $instance) {
-    if ($instance !== null) {
-        // Use the instance
-        $instance->doSomething();
-    } else {
-        // Handle instantiation failure
-        echo "Failed to instantiate {$className}";
-    }
-}
-```
-
-### Filtering Classes
-
-```php
-// Filter classes by attribute
-$controllersWithRoute = $batchProcessor->filterClassesByAttribute([
-    Controller1::class,
-    Controller2::class,
-    Service1::class,
-    Service2::class
-], RouteAttribute::class);
-
-// Filter classes by interface
-$repositories = $batchProcessor->filterClassesByInterface([
-    Repository1::class,
-    Service1::class,
-    Repository2::class
-], RepositoryInterface::class);
-
-// Filter classes that don't implement an interface
-$nonRepositories = $batchProcessor->filterClassesByInterface([
-    Repository1::class,
-    Service1::class,
-    Repository2::class
-], RepositoryInterface::class, false);
-```
-
-### Working with Enums (PHP 8.1+)
-
-```php
-// Get enum cases for multiple enum classes
-$enumCases = $batchProcessor->getEnumCasesForClasses([
-    StatusEnum::class,
-    ColorEnum::class,
-    NonEnumClass::class  // Will be skipped
-]);
-
-// Filter enum classes
-$enums = $batchProcessor->filterEnumClasses([
-    StatusEnum::class,
-    Service1::class,
-    ColorEnum::class
-]);
-
-// Filter non-enum classes
-$nonEnums = $batchProcessor->filterEnumClasses([
-    StatusEnum::class,
-    Service1::class,
-    ColorEnum::class
-], false);
-```
-
-## Benefits
-
-- **Performance**: Batch operations can be more efficient than performing individual operations, especially when working with many classes or methods.
-- **Convenience**: The batch processor provides a simple API for common batch operations.
-- **Flexibility**: Methods accept various input formats and handle edge cases gracefully.
-- **PHP 8.x Support**: Full support for PHP 8.0 attributes and PHP 8.1 enums.
-
-## Implementation Details
-
-The batch processor delegates to the underlying `ReflectionProvider` for the actual reflection operations, but it handles the iteration and result collection for you. This makes it easier to work with collections of classes or methods.
-
-Most methods return associative arrays where the keys are class names or method names, making it easy to access the results for specific classes or methods.
diff --git a/src/Framework/Reflection/BatchOperations/ReflectionBatchProcessor.php b/src/Framework/Reflection/BatchOperations/ReflectionBatchProcessor.php
deleted file mode 100644
index d1ba1d72..00000000
--- a/src/Framework/Reflection/BatchOperations/ReflectionBatchProcessor.php
+++ /dev/null
@@ -1,348 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\BatchOperations;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
-
-/**
- * Batch processor for efficient reflection operations
- *
- * This class provides methods for performing reflection operations on multiple
- * classes or methods in batch, which can be more efficient than performing
- * individual operations.
- */
-final readonly class ReflectionBatchProcessor
-{
-    /**
-     * @param ReflectionProvider $reflectionProvider The reflection provider to use
-     */
-    public function __construct(
-        private ReflectionProvider $reflectionProvider
-    ) {
-    }
-
-    /**
-     * Get attributes for multiple classes in batch
-     * @param array<string> $classNames
-     * @return array<string, \App\Framework\Reflection\Collections\AttributeCollection>
-     */
-    public function getAttributesForClasses(array $classNames, ?string $attributeClass = null): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = $this->reflectionProvider
-                ->getAttributes($classNameObj, $attributeClass);
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get methods with specific attribute across multiple classes
-     * @param array<string> $classNames
-     * @return array<string, \App\Framework\Reflection\Collections\MethodCollection>
-     */
-    public function getMethodsWithAttribute(array $classNames, string $attributeClass): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $methods = $this->reflectionProvider->getMethods($classNameObj);
-
-            $methodsWithAttribute = $methods->getWithAttribute($attributeClass);
-            if (! $methodsWithAttribute->isEmpty()) {
-                $results[$className] = $methodsWithAttribute;
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Check multiple classes for instantiability
-     * @param array<string> $classNames
-     * @return array<string, bool>
-     */
-    public function checkInstantiability(array $classNames): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = $this->reflectionProvider->isInstantiable($classNameObj);
-        }
-
-        return $results;
-    }
-
-    /**
-     * Bulk check interface implementation
-     * @param array<string> $classNames
-     * @return array<string, bool>
-     */
-    public function checkInterfaceImplementation(array $classNames, string $interfaceName): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = $this->reflectionProvider
-                ->implementsInterface($classNameObj, $interfaceName);
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get properties for multiple classes in batch
-     *
-     * @param array<string> $classNames The class names to get properties for
-     * @return array<string, \App\Framework\Reflection\Collections\PropertyCollection>
-     */
-    public function getPropertiesForClasses(array $classNames): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = $this->reflectionProvider->getProperties($classNameObj);
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get methods for multiple classes in batch
-     *
-     * @param array<string> $classNames The class names to get methods for
-     * @param int|null $filter Optional filter for methods (e.g., \ReflectionMethod::IS_PUBLIC)
-     * @return array<string, \App\Framework\Reflection\Collections\MethodCollection>
-     */
-    public function getMethodsForClasses(array $classNames, ?int $filter = null): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = $this->reflectionProvider->getMethods($classNameObj, $filter);
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get parameters for multiple methods across classes
-     *
-     * @param array<string, string|array<string>> $methodMap Map of class names to method names
-     *                                                      (string for single method or array for multiple methods)
-     * @return array<string, array<string, \App\Framework\Reflection\Collections\ParameterCollection>>
-     */
-    public function getMethodParametersForMethods(array $methodMap): array
-    {
-        $results = [];
-
-        foreach ($methodMap as $className => $methodNames) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = [];
-
-            // Handle both single method name and array of method names
-            $methods = is_array($methodNames) ? $methodNames : [$methodNames];
-
-            foreach ($methods as $methodName) {
-                $results[$className][$methodName] = $this->reflectionProvider
-                    ->getMethodParameters($classNameObj, $methodName);
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get attributes for multiple methods across classes
-     *
-     * @param array<string, string|array<string>> $methodMap Map of class names to method names
-     *                                                      (string for single method or array for multiple methods)
-     * @param string|null $attributeClass Optional attribute class to filter by
-     * @return array<string, array<string, \App\Framework\Reflection\Collections\AttributeCollection>>
-     */
-    public function getMethodAttributesForMethods(array $methodMap, ?string $attributeClass = null): array
-    {
-        $results = [];
-
-        foreach ($methodMap as $className => $methodNames) {
-            $classNameObj = ClassName::create($className);
-            $results[$className] = [];
-
-            // Handle both single method name and array of method names
-            $methods = is_array($methodNames) ? $methodNames : [$methodNames];
-
-            foreach ($methods as $methodName) {
-                $results[$className][$methodName] = $this->reflectionProvider
-                    ->getMethodAttributes($classNameObj, $methodName, $attributeClass);
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Create instances of multiple classes in batch
-     *
-     * @param array<string, array<mixed>> $constructorArgs Map of class names to constructor arguments
-     * @return array<string, object|null> Map of class names to instances (null for classes that couldn't be instantiated)
-     */
-    public function createInstances(array $constructorArgs): array
-    {
-        $results = [];
-
-        foreach ($constructorArgs as $className => $args) {
-            $classNameObj = ClassName::create($className);
-
-            try {
-                // Check if class is instantiable first
-                if (! $this->reflectionProvider->isInstantiable($classNameObj)) {
-                    $results[$className] = null;
-
-                    continue;
-                }
-
-                // Get the class and create a new instance
-                $class = $this->reflectionProvider->getClass($classNameObj);
-                $results[$className] = $class->newInstance(...$args);
-            } catch (\Throwable $e) {
-                // If instantiation fails, store null
-                $results[$className] = null;
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Filter classes by the presence of a specific attribute
-     *
-     * @param array<string> $classNames The class names to filter
-     * @param string $attributeClass The attribute class to filter by
-     * @param bool $hasAttribute Whether to include classes that have the attribute (true) or don't have it (false)
-     * @return array<string> Filtered class names
-     */
-    public function filterClassesByAttribute(array $classNames, string $attributeClass, bool $hasAttribute = true): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $hasAttr = $this->reflectionProvider->hasAttribute($classNameObj, $attributeClass);
-
-            if ($hasAttr === $hasAttribute) {
-                $results[] = $className;
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Filter classes by the implementation of a specific interface
-     *
-     * @param array<string> $classNames The class names to filter
-     * @param string $interfaceName The interface name to filter by
-     * @param bool $implementsInterface Whether to include classes that implement the interface (true) or don't implement it (false)
-     * @return array<string> Filtered class names
-     */
-    public function filterClassesByInterface(array $classNames, string $interfaceName, bool $implementsInterface = true): array
-    {
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $implements = $this->reflectionProvider->implementsInterface($classNameObj, $interfaceName);
-
-            if ($implements === $implementsInterface) {
-                $results[] = $className;
-            }
-        }
-
-        return $results;
-    }
-
-    /**
-     * Get enum cases for multiple enum classes (PHP 8.1+)
-     *
-     * @param array<string> $classNames The enum class names to get cases for
-     * @return array<string, array<string, object>> Map of enum class names to their cases (case name => case value)
-     */
-    public function getEnumCasesForClasses(array $classNames): array
-    {
-        // Only available in PHP 8.1+
-        if (PHP_VERSION_ID < 80100) {
-            return array_fill_keys($classNames, []);
-        }
-
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $class = $this->reflectionProvider->getClass($classNameObj);
-
-            // Skip non-enum classes
-            if (! method_exists($class->getNativeClass(), 'isEnum') || ! $class->getNativeClass()->isEnum()) {
-                $results[$className] = [];
-
-                continue;
-            }
-
-            // Get enum cases
-            $cases = [];
-            $reflectionCases = $class->getNativeClass()->getCases();
-
-            foreach ($reflectionCases as $case) {
-                $caseName = $case->getName();
-                /** @var class-string $classNameString */
-                $classNameString = $className;
-                $cases[$caseName] = $classNameString::$caseName;
-            }
-
-            $results[$className] = $cases;
-        }
-
-        return $results;
-    }
-
-    /**
-     * Filter classes by whether they are enums (PHP 8.1+)
-     *
-     * @param array<string> $classNames The class names to filter
-     * @param bool $isEnum Whether to include classes that are enums (true) or aren't enums (false)
-     * @return array<string> Filtered class names
-     */
-    public function filterEnumClasses(array $classNames, bool $isEnum = true): array
-    {
-        // Only available in PHP 8.1+
-        if (PHP_VERSION_ID < 80100) {
-            return $isEnum ? [] : $classNames;
-        }
-
-        $results = [];
-
-        foreach ($classNames as $className) {
-            $classNameObj = ClassName::create($className);
-            $class = $this->reflectionProvider->getClass($classNameObj);
-
-            $classIsEnum = method_exists($class->getNativeClass(), 'isEnum') &&
-                           $class->getNativeClass()->isEnum();
-
-            if ($classIsEnum === $isEnum) {
-                $results[] = $className;
-            }
-        }
-
-        return $results;
-    }
-}
diff --git a/src/Framework/Reflection/Builder/README.md b/src/Framework/Reflection/Builder/README.md
deleted file mode 100644
index 31da1f4c..00000000
--- a/src/Framework/Reflection/Builder/README.md
+++ /dev/null
@@ -1,135 +0,0 @@
-# Reflection Builder
-
-The Reflection Builder provides a fluent API for reflection operations, making it easier to chain operations and improve code readability.
-
-## Basic Usage
-
-```php
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
-
-// Get information about a class
-$class = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->getClass();
-
-// Get information about a method
-$method = ReflectionBuilderFactory::forMethod(MyClass::class, 'myMethod')
-    ->getMethod();
-
-// Get class attributes
-$attributes = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->getClassAttributes();
-
-// Check if a class has a specific attribute
-$hasAttribute = ReflectionBuilderFactory::forClassWithAttribute(MyClass::class, MyAttribute::class)
-    ->hasAttribute();
-
-// Get method parameters
-$parameters = ReflectionBuilderFactory::forMethod(MyClass::class, 'myMethod')
-    ->getMethodParameters();
-
-// Create a new instance of a class
-$instance = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->newInstance('arg1', 'arg2');
-```
-
-## Advanced Usage
-
-### Filtering Methods
-
-```php
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
-
-// Get only public methods
-$publicMethods = ReflectionBuilderFactory::forClassWithFilteredMethods(
-    MyClass::class, 
-    \ReflectionMethod::IS_PUBLIC
-)->getMethods();
-
-// Get only methods with a specific attribute
-$methods = ReflectionBuilderFactory::forClassWithAttribute(
-    MyClass::class, 
-    MyAttribute::class
-)->getMethods();
-```
-
-### Working with Attributes
-
-```php
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
-
-// Get all attributes of a class
-$attributes = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->getClassAttributes();
-
-// Get all attributes of a method
-$methodAttributes = ReflectionBuilderFactory::forMethod(MyClass::class, 'myMethod')
-    ->getMethodAttributes();
-
-// Get attributes of a specific type
-$routeAttributes = ReflectionBuilderFactory::forClassWithAttribute(
-    MyClass::class, 
-    RouteAttribute::class
-)->getClassAttributes();
-
-// Check if a method has a specific attribute
-$hasAttribute = ReflectionBuilderFactory::forMethodWithAttribute(
-    MyClass::class, 
-    'myMethod', 
-    RouteAttribute::class
-)->hasAttribute();
-```
-
-### Custom Reflection Provider
-
-```php
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
-use App\Framework\Reflection\CachedReflectionProvider;
-
-// Create a custom reflection provider
-$provider = new CachedReflectionProvider(
-    null, // Use default cache
-    null, // Use default factory
-    'development' // Use development environment
-);
-
-// Use the custom provider
-$class = ReflectionBuilderFactory::forClass(MyClass::class, $provider)
-    ->getClass();
-```
-
-### Manual Builder Creation
-
-```php
-use App\Framework\Reflection\Builder\ReflectionBuilder;
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
-use App\Framework\Core\ValueObjects\ClassName;
-
-// Create a builder manually
-$builder = ReflectionBuilderFactory::create();
-
-// Configure the builder
-$builder->forClass(MyClass::class)
-    ->method('myMethod')
-    ->withAttribute(RouteAttribute::class);
-
-// Use the builder
-$method = $builder->getMethod();
-$attributes = $builder->getMethodAttributes();
-```
-
-## Benefits
-
-- **Fluent Interface**: Chain method calls for better readability
-- **Type Safety**: Strong typing with PHP 8.x features
-- **Simplified API**: Common operations are simplified
-- **Reusable**: Configure once, use multiple times
-- **Extensible**: Easy to extend with new operations
-
-## Implementation Details
-
-The Reflection Builder is implemented using two main classes:
-
-- `ReflectionBuilder`: The main builder class that provides the fluent API
-- `ReflectionBuilderFactory`: A factory for creating pre-configured builders
-
-The builder delegates to the underlying `ReflectionProvider` for the actual reflection operations, providing a more user-friendly API on top of it.
diff --git a/src/Framework/Reflection/Builder/ReflectionBuilder.php b/src/Framework/Reflection/Builder/ReflectionBuilder.php
deleted file mode 100644
index 95825f02..00000000
--- a/src/Framework/Reflection/Builder/ReflectionBuilder.php
+++ /dev/null
@@ -1,294 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Builder;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\Collections\PropertyCollection;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
-
-/**
- * Fluent builder for reflection operations
- *
- * This class provides a fluent API for reflection operations, making it easier
- * to chain operations and improve code readability.
- */
-final class ReflectionBuilder
-{
-    private ClassName $className;
-
-    private ?string $methodName = null;
-
-    private ?string $attributeClass = null;
-
-    private int $attributeFlags = 0;
-
-    private ?int $methodFilter = null;
-
-    /**
-     * @param ReflectionProvider $reflectionProvider The reflection provider to use
-     */
-    public function __construct(
-        private readonly ReflectionProvider $reflectionProvider
-    ) {
-    }
-
-    /**
-     * Set the class to reflect
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @return self
-     */
-    public function forClass(string|ClassName $className): self
-    {
-        $this->className = $className instanceof ClassName
-            ? $className
-            : ClassName::create($className);
-
-        return $this;
-    }
-
-    /**
-     * Set the method to reflect
-     *
-     * @param string $methodName The method name to reflect
-     * @return self
-     */
-    public function method(string $methodName): self
-    {
-        $this->methodName = $methodName;
-
-        return $this;
-    }
-
-    /**
-     * Filter by attribute class
-     *
-     * @param string $attributeClass The attribute class to filter by
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @return self
-     */
-    public function withAttribute(string $attributeClass, int $flags = 0): self
-    {
-        $this->attributeClass = $attributeClass;
-        $this->attributeFlags = $flags;
-
-        return $this;
-    }
-
-    /**
-     * Filter methods by visibility
-     *
-     * @param int $filter The filter to apply (e.g., \ReflectionMethod::IS_PUBLIC)
-     * @return self
-     */
-    public function filterMethods(int $filter): self
-    {
-        $this->methodFilter = $filter;
-
-        return $this;
-    }
-
-    /**
-     * Get the reflected class
-     *
-     * @return WrappedReflectionClass The reflected class
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function getClass(): WrappedReflectionClass
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->getClass($this->className);
-    }
-
-    /**
-     * Get the reflected method
-     *
-     * @return WrappedReflectionMethod The reflected method
-     * @throws \InvalidArgumentException If no class or method has been set
-     */
-    public function getMethod(): WrappedReflectionMethod
-    {
-        $this->ensureClassIsSet();
-        $this->ensureMethodIsSet();
-
-        return $this->reflectionProvider->getMethod($this->className, $this->methodName);
-    }
-
-    /**
-     * Get the class attributes
-     *
-     * @return AttributeCollection The class attributes
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function getClassAttributes(): AttributeCollection
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->getAttributes(
-            $this->className,
-            $this->attributeClass
-        );
-    }
-
-    /**
-     * Get the method attributes
-     *
-     * @return AttributeCollection The method attributes
-     * @throws \InvalidArgumentException If no class or method has been set
-     */
-    public function getMethodAttributes(): AttributeCollection
-    {
-        $this->ensureClassIsSet();
-        $this->ensureMethodIsSet();
-
-        return $this->reflectionProvider->getMethodAttributes(
-            $this->className,
-            $this->methodName,
-            $this->attributeClass
-        );
-    }
-
-    /**
-     * Get the method parameters
-     *
-     * @return ParameterCollection The method parameters
-     * @throws \InvalidArgumentException If no class or method has been set
-     */
-    public function getMethodParameters(): ParameterCollection
-    {
-        $this->ensureClassIsSet();
-        $this->ensureMethodIsSet();
-
-        return $this->reflectionProvider->getMethodParameters(
-            $this->className,
-            $this->methodName
-        );
-    }
-
-    /**
-     * Get the class methods
-     *
-     * @return MethodCollection The class methods
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function getMethods(): MethodCollection
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->getMethods(
-            $this->className,
-            $this->methodFilter
-        );
-    }
-
-    /**
-     * Get the class properties
-     *
-     * @return PropertyCollection The class properties
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function getProperties(): PropertyCollection
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->getProperties($this->className);
-    }
-
-    /**
-     * Check if the class has a specific attribute
-     *
-     * @param string|null $attributeClass The attribute class to check for (overrides any previously set attribute)
-     * @return bool True if the class has the attribute, false otherwise
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function hasAttribute(?string $attributeClass = null): bool
-    {
-        $this->ensureClassIsSet();
-
-        $attrClass = $attributeClass ?? $this->attributeClass;
-
-        if ($attrClass === null) {
-            throw new \InvalidArgumentException(
-                'No attribute class specified. Use withAttribute() or provide an attribute class.'
-            );
-        }
-
-        return $this->reflectionProvider->hasAttribute($this->className, $attrClass);
-    }
-
-    /**
-     * Check if the class is instantiable
-     *
-     * @return bool True if the class is instantiable, false otherwise
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function isInstantiable(): bool
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->isInstantiable($this->className);
-    }
-
-    /**
-     * Check if the class implements a specific interface
-     *
-     * @param string $interfaceName The interface name to check for
-     * @return bool True if the class implements the interface, false otherwise
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    public function implementsInterface(string $interfaceName): bool
-    {
-        $this->ensureClassIsSet();
-
-        return $this->reflectionProvider->implementsInterface($this->className, $interfaceName);
-    }
-
-    /**
-     * Create a new instance of the class
-     *
-     * @param mixed ...$args Constructor arguments
-     * @return object The new instance
-     * @throws \InvalidArgumentException If no class has been set
-     * @throws \RuntimeException If the class is not instantiable
-     */
-    public function newInstance(mixed ...$args): object
-    {
-        return $this->getClass()->newInstance(...$args);
-    }
-
-    /**
-     * Ensure that a class has been set
-     *
-     * @throws \InvalidArgumentException If no class has been set
-     */
-    private function ensureClassIsSet(): void
-    {
-        if (! isset($this->className)) {
-            throw new \InvalidArgumentException(
-                'No class has been set. Use forClass() to set a class.'
-            );
-        }
-    }
-
-    /**
-     * Ensure that a method has been set
-     *
-     * @throws \InvalidArgumentException If no method has been set
-     */
-    private function ensureMethodIsSet(): void
-    {
-        if ($this->methodName === null) {
-            throw new \InvalidArgumentException(
-                'No method has been set. Use method() to set a method.'
-            );
-        }
-    }
-}
diff --git a/src/Framework/Reflection/Builder/ReflectionBuilderFactory.php b/src/Framework/Reflection/Builder/ReflectionBuilderFactory.php
deleted file mode 100644
index 323f037a..00000000
--- a/src/Framework/Reflection/Builder/ReflectionBuilderFactory.php
+++ /dev/null
@@ -1,125 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Builder;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
-
-/**
- * Factory for creating ReflectionBuilder instances
- *
- * This class provides static methods for creating ReflectionBuilder instances
- * for specific classes or methods, making it easier to use the builder pattern.
- */
-final class ReflectionBuilderFactory
-{
-    /**
-     * Create a new ReflectionBuilder for a class
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function forClass(string|ClassName $className, ?ReflectionProvider $provider = null): ReflectionBuilder
-    {
-        $builder = self::create($provider);
-
-        return $builder->forClass($className);
-    }
-
-    /**
-     * Create a new ReflectionBuilder for a method
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @param string $methodName The method name to reflect
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function forMethod(
-        string|ClassName $className,
-        string $methodName,
-        ?ReflectionProvider $provider = null
-    ): ReflectionBuilder {
-        $builder = self::create($provider);
-
-        return $builder->forClass($className)->method($methodName);
-    }
-
-    /**
-     * Create a new ReflectionBuilder for a class with a specific attribute
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @param string $attributeClass The attribute class to filter by
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function forClassWithAttribute(
-        string|ClassName $className,
-        string $attributeClass,
-        int $flags = 0,
-        ?ReflectionProvider $provider = null
-    ): ReflectionBuilder {
-        $builder = self::create($provider);
-
-        return $builder->forClass($className)->withAttribute($attributeClass, $flags);
-    }
-
-    /**
-     * Create a new ReflectionBuilder for a method with a specific attribute
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @param string $methodName The method name to reflect
-     * @param string $attributeClass The attribute class to filter by
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function forMethodWithAttribute(
-        string|ClassName $className,
-        string $methodName,
-        string $attributeClass,
-        int $flags = 0,
-        ?ReflectionProvider $provider = null
-    ): ReflectionBuilder {
-        $builder = self::create($provider);
-
-        return $builder->forClass($className)
-            ->method($methodName)
-            ->withAttribute($attributeClass, $flags);
-    }
-
-    /**
-     * Create a new ReflectionBuilder with filtered methods
-     *
-     * @param string|ClassName $className The class name to reflect
-     * @param int $filter The filter to apply (e.g., \ReflectionMethod::IS_PUBLIC)
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function forClassWithFilteredMethods(
-        string|ClassName $className,
-        int $filter,
-        ?ReflectionProvider $provider = null
-    ): ReflectionBuilder {
-        $builder = self::create($provider);
-
-        return $builder->forClass($className)->filterMethods($filter);
-    }
-
-    /**
-     * Create a new ReflectionBuilder
-     *
-     * @param ReflectionProvider|null $provider Optional custom reflection provider
-     * @return ReflectionBuilder The reflection builder
-     */
-    public static function create(?ReflectionProvider $provider = null): ReflectionBuilder
-    {
-        $reflectionProvider = $provider ?? new CachedReflectionProvider();
-
-        return new ReflectionBuilder($reflectionProvider);
-    }
-}
diff --git a/src/Framework/Reflection/ClassInfo.php b/src/Framework/Reflection/ClassInfo.php
new file mode 100644
index 00000000..233ad774
--- /dev/null
+++ b/src/Framework/Reflection/ClassInfo.php
@@ -0,0 +1,194 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Reflection\Collections\AttributeCollection;
+use App\Framework\Reflection\Collections\MethodCollection;
+use App\Framework\Reflection\Collections\PropertyCollection;
+use ReflectionClass;
+use ReflectionProperty;
+
+/**
+ * Value object representing reflection information about a class
+ */
+final readonly class ClassInfo
+{
+    public function __construct(
+        private ClassName $className,
+        private ReflectionClass $reflectionClass
+    ) {
+    }
+
+    /**
+     * Get the class name
+     */
+    public function getClassName(): ClassName
+    {
+        return $this->className;
+    }
+
+    /**
+     * Get the fully qualified class name
+     */
+    public function getName(): string
+    {
+        return $this->className->getFullyQualified();
+    }
+
+    /**
+     * Get the short class name (without namespace)
+     */
+    public function getShortName(): string
+    {
+        return $this->reflectionClass->getShortName();
+    }
+
+    /**
+     * Get all methods of the class
+     *
+     * @param int|null $filter Optional filter (e.g., ReflectionMethod::IS_PUBLIC)
+     * @return MethodCollection Collection of methods
+     */
+    public function getMethods(?int $filter = null): MethodCollection
+    {
+        $nativeMethods = $this->reflectionClass->getMethods($filter);
+        $methods = [];
+
+        foreach ($nativeMethods as $nativeMethod) {
+            $methods[] = new MethodInfo($nativeMethod);
+        }
+
+        return new MethodCollection(...$methods);
+    }
+
+    /**
+     * Get all attributes of the class
+     *
+     * @param string|null $attributeClass Optional attribute class to filter by
+     * @return AttributeCollection Collection of attributes
+     */
+    public function getAttributes(?string $attributeClass = null): AttributeCollection
+    {
+        $nativeAttributes = $this->reflectionClass->getAttributes($attributeClass);
+        $attributes = [];
+
+        foreach ($nativeAttributes as $nativeAttribute) {
+            $attributes[] = new WrappedReflectionAttribute($nativeAttribute);
+        }
+
+        return new AttributeCollection(...$attributes);
+    }
+
+    /**
+     * Get all properties of the class
+     *
+     * @return PropertyCollection Collection of properties
+     */
+    public function getProperties(): PropertyCollection
+    {
+        $nativeProperties = $this->reflectionClass->getProperties();
+        $properties = [];
+
+        foreach ($nativeProperties as $nativeProperty) {
+            $properties[] = $nativeProperty;
+        }
+
+        return new PropertyCollection(...$properties);
+    }
+
+    /**
+     * Check if the class is instantiable
+     */
+    public function isInstantiable(): bool
+    {
+        return $this->reflectionClass->isInstantiable();
+    }
+
+    /**
+     * Check if the class implements an interface
+     *
+     * @param string $interfaceName The interface name to check for
+     * @return bool True if the class implements the interface, false otherwise
+     */
+    public function implementsInterface(string $interfaceName): bool
+    {
+        return $this->reflectionClass->implementsInterface($interfaceName);
+    }
+
+    /**
+     * Check if the class has a specific attribute
+     *
+     * @param string $attributeClass The attribute class name to check for
+     * @return bool True if the class has the attribute, false otherwise
+     */
+    public function hasAttribute(string $attributeClass): bool
+    {
+        return ! $this->getAttributes($attributeClass)->isEmpty();
+    }
+
+    /**
+     * Get a specific method by name
+     *
+     * @param string $methodName The method name
+     * @return MethodInfo The method information
+     * @throws \ReflectionException If the method does not exist
+     */
+    public function getMethod(string $methodName): MethodInfo
+    {
+        $nativeMethod = $this->reflectionClass->getMethod($methodName);
+
+        return new MethodInfo($nativeMethod);
+    }
+
+    /**
+     * Check if the class has a specific method
+     *
+     * @param string $methodName The method name to check for
+     * @return bool True if the class has the method, false otherwise
+     */
+    public function hasMethod(string $methodName): bool
+    {
+        return $this->reflectionClass->hasMethod($methodName);
+    }
+
+    /**
+     * Get the native ReflectionClass instance
+     *
+     * @return ReflectionClass<object> The native ReflectionClass
+     */
+    public function getNativeClass(): ReflectionClass
+    {
+        return $this->reflectionClass;
+    }
+
+    /**
+     * Create a new instance of the class
+     *
+     * @param mixed ...$args Constructor arguments
+     * @return object The new instance
+     */
+    public function newInstance(mixed ...$args): object
+    {
+        return $this->reflectionClass->newInstance(...$args);
+    }
+
+    /**
+     * Check if the class is abstract
+     */
+    public function isAbstract(): bool
+    {
+        return $this->reflectionClass->isAbstract();
+    }
+
+    /**
+     * Check if the class is final
+     */
+    public function isFinal(): bool
+    {
+        return $this->reflectionClass->isFinal();
+    }
+}
+
diff --git a/src/Framework/Reflection/Collections/AttributeCollection.php b/src/Framework/Reflection/Collections/AttributeCollection.php
new file mode 100644
index 00000000..e2021656
--- /dev/null
+++ b/src/Framework/Reflection/Collections/AttributeCollection.php
@@ -0,0 +1,119 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection\Collections;
+
+use App\Framework\Reflection\WrappedReflectionAttribute;
+use ArrayIterator;
+use Countable;
+use IteratorAggregate;
+
+/**
+ * @implements IteratorAggregate<int, WrappedReflectionAttribute>
+ */
+final readonly class AttributeCollection implements IteratorAggregate, Countable
+{
+    /** @var WrappedReflectionAttribute[] */
+    private array $attributes;
+
+    public function __construct(WrappedReflectionAttribute ...$attributes)
+    {
+        $this->attributes = $attributes;
+    }
+
+    /**
+     * @return ArrayIterator<int, WrappedReflectionAttribute>
+     */
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator(array_values($this->attributes));
+    }
+
+    public function count(): int
+    {
+        return count($this->attributes);
+    }
+
+    public function isEmpty(): bool
+    {
+        return empty($this->attributes);
+    }
+
+    /**
+     * @return array<WrappedReflectionAttribute>
+     */
+    public function toArray(): array
+    {
+        return $this->attributes;
+    }
+
+    /**
+     * Get attribute instances
+     *
+     * @return array<object|null>
+     */
+    public function getInstances(): array
+    {
+        $instances = [];
+
+        foreach ($this->attributes as $attribute) {
+            try {
+                $instances[] = $attribute->newInstance();
+            } catch (\Throwable) {
+                $instances[] = null;
+            }
+        }
+
+        return $instances;
+    }
+
+    /**
+     * Get first attribute instance
+     */
+    public function getFirstInstance(): ?object
+    {
+        $instances = $this->getInstances();
+
+        return $instances[0] ?? null;
+    }
+
+    /**
+     * Get attributes by type
+     *
+     * @param string $attributeClass The attribute class name to filter by
+     * @return AttributeCollection Collection of matching attributes
+     */
+    public function getByType(string $attributeClass): AttributeCollection
+    {
+        $filtered = [];
+
+        foreach ($this->attributes as $attribute) {
+            if ($attribute->getName() === $attributeClass) {
+                $filtered[] = $attribute;
+            }
+        }
+
+        return new AttributeCollection(...$filtered);
+    }
+
+    /**
+     * Check if collection has a specific attribute type
+     *
+     * @param string $attributeClass The attribute class name to check for
+     * @return bool True if the collection has the attribute type, false otherwise
+     */
+    public function hasType(string $attributeClass): bool
+    {
+        return ! $this->getByType($attributeClass)->isEmpty();
+    }
+
+    /**
+     * Get first attribute
+     */
+    public function first(): ?WrappedReflectionAttribute
+    {
+        return $this->attributes[0] ?? null;
+    }
+}
+
diff --git a/src/Framework/Reflection/Collections/MethodCollection.php b/src/Framework/Reflection/Collections/MethodCollection.php
index 78950dc2..d2523df9 100644
--- a/src/Framework/Reflection/Collections/MethodCollection.php
+++ b/src/Framework/Reflection/Collections/MethodCollection.php
@@ -4,26 +4,26 @@ declare(strict_types=1);
 
 namespace App\Framework\Reflection\Collections;
 
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\Reflection\MethodInfo;
 use ArrayIterator;
 use Countable;
 use IteratorAggregate;
 
 /**
- * @implements IteratorAggregate<int, WrappedReflectionMethod>
+ * @implements IteratorAggregate<int, MethodInfo>
  */
 final readonly class MethodCollection implements IteratorAggregate, Countable
 {
-    /** @var WrappedReflectionMethod[] */
+    /** @var MethodInfo[] */
     private array $methods;
 
-    public function __construct(WrappedReflectionMethod ...$methods)
+    public function __construct(MethodInfo ...$methods)
     {
         $this->methods = $methods;
     }
 
     /**
-     * @return ArrayIterator<int, WrappedReflectionMethod>
+     * @return ArrayIterator<int, MethodInfo>
      */
     public function getIterator(): ArrayIterator
     {
@@ -41,14 +41,17 @@ final readonly class MethodCollection implements IteratorAggregate, Countable
     }
 
     /**
-     * @return array<WrappedReflectionMethod>
+     * @return array<MethodInfo>
      */
     public function toArray(): array
     {
         return $this->methods;
     }
 
-    public function getByName(string $name): ?WrappedReflectionMethod
+    /**
+     * Get method by name
+     */
+    public function getByName(string $name): ?MethodInfo
     {
         foreach ($this->methods as $method) {
             if ($method->getName() === $name) {
@@ -59,59 +62,43 @@ final readonly class MethodCollection implements IteratorAggregate, Countable
         return null;
     }
 
-    public function hasMethod(string $name): bool
-    {
-        return $this->getByName($name) !== null;
-    }
-
-    public function getWithAttribute(string $attributeClass): self
+    /**
+     * Get methods with a specific attribute
+     *
+     * @param string $attributeClass The attribute class name to filter by
+     * @return MethodCollection Collection of methods with the attribute
+     */
+    public function getWithAttribute(string $attributeClass): MethodCollection
     {
         $filtered = [];
+
         foreach ($this->methods as $method) {
             if ($method->hasAttribute($attributeClass)) {
                 $filtered[] = $method;
             }
         }
 
-        return new self(...$filtered);
+        return new MethodCollection(...$filtered);
     }
 
     /**
-     * @return array<string>
+     * Filter methods by name pattern
+     *
+     * @param string $pattern The pattern to match (supports * wildcard)
+     * @return MethodCollection Collection of matching methods
      */
-    public function getNames(): array
+    public function filterByName(string $pattern): MethodCollection
     {
-        return array_map(fn (WrappedReflectionMethod $method) => $method->getName(), $this->methods);
-    }
+        $filtered = [];
+        $regex = '/^' . str_replace('*', '.*', preg_quote($pattern, '/')) . '$/';
 
-    public function filter(callable $callback): self
-    {
-        $filtered = array_filter($this->methods, $callback);
-
-        return new self(...array_values($filtered));
-    }
-
-    /**
-     * @return array<mixed>
-     */
-    public function map(callable $callback): array
-    {
-        return array_map($callback, $this->methods);
-    }
-
-    public function first(): ?WrappedReflectionMethod
-    {
-        return $this->methods[0] ?? null;
-    }
-
-    public function findFirst(callable $callback): ?WrappedReflectionMethod
-    {
         foreach ($this->methods as $method) {
-            if ($callback($method)) {
-                return $method;
+            if (preg_match($regex, $method->getName())) {
+                $filtered[] = $method;
             }
         }
 
-        return null;
+        return new MethodCollection(...$filtered);
     }
 }
+
diff --git a/src/Framework/Reflection/Collections/ParameterCollection.php b/src/Framework/Reflection/Collections/ParameterCollection.php
new file mode 100644
index 00000000..30f2f308
--- /dev/null
+++ b/src/Framework/Reflection/Collections/ParameterCollection.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection\Collections;
+
+use App\Framework\Reflection\ParameterInfo;
+use ArrayIterator;
+use Countable;
+use IteratorAggregate;
+
+/**
+ * @implements IteratorAggregate<int, ParameterInfo>
+ */
+final readonly class ParameterCollection implements IteratorAggregate, Countable
+{
+    /** @var ParameterInfo[] */
+    private array $parameters;
+
+    public function __construct(ParameterInfo ...$parameters)
+    {
+        $this->parameters = $parameters;
+    }
+
+    /**
+     * @return ArrayIterator<int, ParameterInfo>
+     */
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator(array_values($this->parameters));
+    }
+
+    public function count(): int
+    {
+        return count($this->parameters);
+    }
+
+    public function isEmpty(): bool
+    {
+        return empty($this->parameters);
+    }
+
+    /**
+     * @return array<ParameterInfo>
+     */
+    public function toArray(): array
+    {
+        return $this->parameters;
+    }
+
+    /**
+     * Get parameter by name
+     */
+    public function getByName(string $name): ?ParameterInfo
+    {
+        foreach ($this->parameters as $parameter) {
+            if ($parameter->getName() === $name) {
+                return $parameter;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get parameter by position
+     */
+    public function getByPosition(int $position): ?ParameterInfo
+    {
+        foreach ($this->parameters as $parameter) {
+            if ($parameter->getPosition() === $position) {
+                return $parameter;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get first parameter
+     */
+    public function first(): ?ParameterInfo
+    {
+        return $this->parameters[0] ?? null;
+    }
+
+    /**
+     * Get last parameter
+     */
+    public function last(): ?ParameterInfo
+    {
+        $count = count($this->parameters);
+
+        return $count > 0 ? $this->parameters[$count - 1] : null;
+    }
+}
+
diff --git a/src/Framework/Reflection/Collections/PropertyCollection.php b/src/Framework/Reflection/Collections/PropertyCollection.php
index ac4dfc6c..2efc9c1c 100644
--- a/src/Framework/Reflection/Collections/PropertyCollection.php
+++ b/src/Framework/Reflection/Collections/PropertyCollection.php
@@ -48,6 +48,9 @@ final readonly class PropertyCollection implements IteratorAggregate, Countable
         return $this->properties;
     }
 
+    /**
+     * Get property by name
+     */
     public function getByName(string $name): ?ReflectionProperty
     {
         foreach ($this->properties as $property) {
@@ -59,91 +62,24 @@ final readonly class PropertyCollection implements IteratorAggregate, Countable
         return null;
     }
 
-    public function hasProperty(string $name): bool
-    {
-        return $this->getByName($name) !== null;
-    }
-
-    public function getPublic(): self
-    {
-        $filtered = [];
-        foreach ($this->properties as $property) {
-            if ($property->isPublic()) {
-                $filtered[] = $property;
-            }
-        }
-
-        return new self(...$filtered);
-    }
-
-    public function getPrivate(): self
-    {
-        $filtered = [];
-        foreach ($this->properties as $property) {
-            if ($property->isPrivate()) {
-                $filtered[] = $property;
-            }
-        }
-
-        return new self(...$filtered);
-    }
-
-    public function getProtected(): self
-    {
-        $filtered = [];
-        foreach ($this->properties as $property) {
-            if ($property->isProtected()) {
-                $filtered[] = $property;
-            }
-        }
-
-        return new self(...$filtered);
-    }
-
-    public function getStatic(): self
-    {
-        $filtered = [];
-        foreach ($this->properties as $property) {
-            if ($property->isStatic()) {
-                $filtered[] = $property;
-            }
-        }
-
-        return new self(...$filtered);
-    }
-
-    public function getReadonly(): self
-    {
-        $filtered = [];
-        foreach ($this->properties as $property) {
-            if ($property->isReadOnly()) {
-                $filtered[] = $property;
-            }
-        }
-
-        return new self(...$filtered);
-    }
-
     /**
-     * @return array<string>
+     * Get properties with a specific attribute
+     *
+     * @param string $attributeClass The attribute class name to filter by
+     * @return PropertyCollection Collection of properties with the attribute
      */
-    public function getNames(): array
+    public function getWithAttribute(string $attributeClass): PropertyCollection
     {
-        return array_map(fn (ReflectionProperty $prop) => $prop->getName(), $this->properties);
-    }
+        $filtered = [];
 
-    public function filter(callable $callback): self
-    {
-        $filtered = array_filter($this->properties, $callback);
+        foreach ($this->properties as $property) {
+            $attributes = $property->getAttributes($attributeClass);
+            if (! empty($attributes)) {
+                $filtered[] = $property;
+            }
+        }
 
-        return new self(...array_values($filtered));
-    }
-
-    /**
-     * @return array<mixed>
-     */
-    public function map(callable $callback): array
-    {
-        return array_map($callback, $this->properties);
+        return new PropertyCollection(...$filtered);
     }
 }
+
diff --git a/src/Framework/Reflection/LazyReflectionProxy.php b/src/Framework/Reflection/LazyReflectionProxy.php
deleted file mode 100644
index 9151fca3..00000000
--- a/src/Framework/Reflection/LazyReflectionProxy.php
+++ /dev/null
@@ -1,460 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\MetadataCacheManager;
-use ReflectionClass;
-
-/**
- * Lazy-loading proxy for ReflectionClass instances
- *
- * Only creates the actual ReflectionClass when methods requiring it are called.
- * Uses metadata cache for faster access to commonly used reflection data.
- */
-final class LazyReflectionProxy
-{
-    /**
-     * The actual ReflectionClass instance, loaded on demand
-     *
-     * @var ReflectionClass<object>|null
-     */
-    private ?ReflectionClass $reflectionClass = null;
-
-    /**
-     * Cached metadata about the class
-     *
-     * @var array<string, mixed>|null
-     */
-    private ?array $metadata = null;
-
-    /**
-     * @param ClassName $className The class name to reflect
-     * @param MetadataCacheManager $metadataCache The metadata cache manager
-     */
-    public function __construct(
-        private readonly ClassName $className,
-        private readonly MetadataCacheManager $metadataCache
-    ) {
-    }
-
-    /**
-     * Check if class is instantiable without loading ReflectionClass
-     */
-    public function isInstantiable(): bool
-    {
-        // Try metadata cache first
-        $cached = $this->metadataCache->getMetadataProperty($this->className, 'instantiable');
-        if ($cached !== null) {
-            return $cached;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->isInstantiable();
-    }
-
-    /**
-     * Check if class implements interface without loading ReflectionClass
-     */
-    public function implementsInterface(string $interfaceName): bool
-    {
-        // Try metadata cache first
-        $interfaces = $this->metadataCache->getMetadataProperty($this->className, 'interfaces', []);
-        if (! empty($interfaces)) {
-            return in_array($interfaceName, $interfaces, true);
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->implementsInterface($interfaceName);
-    }
-
-    /**
-     * Get class short name without loading ReflectionClass
-     */
-    public function getShortName(): string
-    {
-        // Try metadata cache first
-        $shortName = $this->metadataCache->getMetadataProperty($this->className, 'short_name');
-        if ($shortName !== null) {
-            return $shortName;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->getShortName();
-    }
-
-    /**
-     * Check if class is abstract without loading ReflectionClass
-     */
-    public function isAbstract(): bool
-    {
-        // Try metadata cache first
-        $isAbstract = $this->metadataCache->getMetadataProperty($this->className, 'abstract');
-        if ($isAbstract !== null) {
-            return $isAbstract;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->isAbstract();
-    }
-
-    /**
-     * Check if class is final without loading ReflectionClass
-     */
-    public function isFinal(): bool
-    {
-        // Try metadata cache first
-        $isFinal = $this->metadataCache->getMetadataProperty($this->className, 'final');
-        if ($isFinal !== null) {
-            return $isFinal;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->isFinal();
-    }
-
-    /**
-     * Get parent class name without loading ReflectionClass if possible
-     *
-     * Attempts to retrieve the parent class name from metadata cache first.
-     * Falls back to using ReflectionClass if the information is not cached.
-     *
-     * @return string|null The fully qualified parent class name, or null if the class has no parent
-     */
-    public function getParentClass(): string|null
-    {
-        // Try metadata cache first
-        $parentClass = $this->metadataCache->getMetadataProperty($this->className, 'parent_class');
-        if ($parentClass !== null) {
-            return $parentClass;
-        }
-
-        // Fallback to ReflectionClass
-        $parent = $this->getReflectionClass()->getParentClass();
-
-        return $parent ? $parent->getName() : null;
-    }
-
-    /**
-     * Get method count without loading full method reflection
-     */
-    public function getMethodCount(): int
-    {
-        // Try metadata cache first
-        $methodCount = $this->metadataCache->getMetadataProperty($this->className, 'method_count');
-        if ($methodCount !== null) {
-            return $methodCount;
-        }
-
-        // Fallback to ReflectionClass
-        return count($this->getReflectionClass()->getMethods());
-    }
-
-    /**
-     * Get property count without loading full property reflection
-     */
-    public function getPropertyCount(): int
-    {
-        // Try metadata cache first
-        $propertyCount = $this->metadataCache->getMetadataProperty($this->className, 'property_count');
-        if ($propertyCount !== null) {
-            return $propertyCount;
-        }
-
-        // Fallback to ReflectionClass
-        return count($this->getReflectionClass()->getProperties());
-    }
-
-    /**
-     * Get namespace without loading ReflectionClass
-     */
-    public function getNamespaceName(): string
-    {
-        // Try metadata cache first
-        $namespace = $this->metadataCache->getMetadataProperty($this->className, 'namespace');
-        if ($namespace !== null) {
-            return $namespace;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->getNamespaceName();
-    }
-
-    /**
-     * Get the actual ReflectionClass instance
-     *
-     * This method creates the ReflectionClass instance if it hasn't been created yet.
-     * It also stores metadata about the class in the cache for future use.
-     * This is the core method that triggers lazy loading of the reflection data.
-     *
-     * @return ReflectionClass<object> The ReflectionClass instance for the class
-     */
-    public function getReflectionClass(): ReflectionClass
-    {
-        if ($this->reflectionClass === null) {
-            /** @var class-string $className */
-            $className = $this->className->getFullyQualified();
-            $this->reflectionClass = new ReflectionClass($className);
-
-            // Store metadata for future use
-            $this->storeMetadata();
-        }
-
-        return $this->reflectionClass;
-    }
-
-    /**
-     * Get class name
-     */
-    public function getName(): string
-    {
-        return $this->className->getFullyQualified();
-    }
-
-    /**
-     * Check if ReflectionClass has been loaded
-     *
-     * @return bool True if the ReflectionClass has been loaded, false otherwise
-     */
-    public function isLoaded(): bool
-    {
-        return $this->reflectionClass !== null;
-    }
-
-    /**
-     * Check if the class is an enum
-     *
-     * Attempts to determine if the class is an enum without loading the full ReflectionClass.
-     * Falls back to using ReflectionClass if the information is not cached.
-     *
-     * @return bool True if the class is an enum, false otherwise
-     */
-    public function isEnum(): bool
-    {
-        // Try metadata cache first
-        $isEnum = $this->metadataCache->getMetadataProperty($this->className, 'is_enum');
-        if ($isEnum !== null) {
-            return $isEnum;
-        }
-
-        // Fallback to ReflectionClass
-        return $this->getReflectionClass()->isEnum();
-    }
-
-    /**
-     * Get enum cases for an enum class
-     *
-     * Returns the enum cases if the class is an enum.
-     * For non-enum classes, returns an empty array.
-     *
-     * @return array<string, object> Array of enum cases with case names as keys
-     */
-    public function getEnumCases(): array
-    {
-        // If not an enum, return empty array
-        if (! $this->isEnum()) {
-            return [];
-        }
-
-        // Try metadata cache first
-        $cases = $this->metadataCache->getMetadataProperty($this->className, 'enum_cases');
-        if ($cases !== null) {
-            return $cases;
-        }
-
-        // Fallback to ReflectionClass
-        $reflectionCases = $this->getReflectionClass()->getCases();
-        $cases = [];
-
-        foreach ($reflectionCases as $case) {
-            $caseName = $case->getName();
-            /** @var class-string $className */
-            $className = $this->className->getFullyQualified();
-            $cases[$caseName] = $className::$caseName;
-        }
-
-        return $cases;
-    }
-
-    /**
-     * Check if the class has a specific attribute
-     *
-     * Attempts to determine if the class has a specific attribute without loading
-     * the full ReflectionClass. Falls back to using ReflectionClass if the information
-     * is not cached.
-     *
-     * @param string $attributeName The fully qualified attribute class name
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @return bool True if the class has the attribute, false otherwise
-     */
-    public function hasAttribute(string $attributeName, int $flags = 0): bool
-    {
-        // Try metadata cache first
-        $attributes = $this->metadataCache->getMetadataProperty($this->className, 'attributes');
-        if ($attributes !== null) {
-            // Simple check if we're not using IS_INSTANCEOF flag
-            if ($flags === 0) {
-                return isset($attributes[$attributeName]);
-            }
-
-            // More complex check for IS_INSTANCEOF
-            if ($flags & 2) { // ReflectionAttribute::IS_INSTANCEOF = 2
-                foreach (array_keys($attributes) as $attrClass) {
-                    if (is_a($attrClass, $attributeName, true)) {
-                        return true;
-                    }
-                }
-
-                return false;
-            }
-        }
-
-        // Fallback to ReflectionClass
-        return count($this->getReflectionClass()->getAttributes($attributeName, $flags)) > 0;
-    }
-
-    /**
-     * Get attributes of the class
-     *
-     * Returns the attributes of the class.
-     *
-     * @param string|null $attributeName Optional attribute class name to filter by
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @return array<\ReflectionAttribute<object>> Array of ReflectionAttribute objects
-     */
-    public function getAttributes(?string $attributeName = null, int $flags = 0): array
-    {
-        // Try metadata cache first for the existence check
-        if ($attributeName !== null) {
-            $hasAttribute = $this->hasAttribute($attributeName, $flags);
-            if (! $hasAttribute) {
-                return [];
-            }
-        }
-
-        // Fallback to ReflectionClass for the actual attributes
-        return $this->getReflectionClass()->getAttributes($attributeName, $flags);
-    }
-
-    /**
-     * Get attribute instances of the class (PHP 8.0+)
-     *
-     * Returns the instantiated attribute objects of the class. For PHP versions below 8.0,
-     * returns an empty array.
-     *
-     * @param string|null $attributeName Optional attribute class name to filter by
-     * @param int $flags Optional flags for attribute lookup (ReflectionAttribute::IS_INSTANCEOF)
-     * @return array<object> Array of instantiated attribute objects
-     */
-    public function getAttributeInstances(?string $attributeName = null, int $flags = 0): array
-    {
-        $attributes = $this->getAttributes($attributeName, $flags);
-        $instances = [];
-
-        foreach ($attributes as $attribute) {
-            try {
-                $instances[] = $attribute->newInstance();
-            } catch (\Throwable $e) {
-                // Skip attributes that can't be instantiated
-                continue;
-            }
-        }
-
-        return $instances;
-    }
-
-    /**
-     * Get memory usage statistics for this proxy
-     *
-     * Provides information about the memory usage of this proxy, including:
-     * - The class name being reflected
-     * - Whether the ReflectionClass has been loaded
-     * - Whether metadata is cached
-     * - An estimated memory usage in bytes
-     *
-     * @return array{
-     *     class_name: string,
-     *     reflection_loaded: bool,
-     *     has_cached_metadata: bool,
-     *     estimated_memory_bytes: int
-     * } Memory usage statistics
-     */
-    public function getMemoryStats(): array
-    {
-        return [
-            'class_name' => $this->className->getFullyQualified(),
-            'reflection_loaded' => $this->reflectionClass !== null,
-            'has_cached_metadata' => $this->metadataCache->hasMetadata($this->className),
-            'estimated_memory_bytes' => $this->reflectionClass !== null ? 8192 : 512, // Rough estimate
-        ];
-    }
-
-    /**
-     * Store metadata in cache after loading ReflectionClass
-     *
-     * This method extracts and stores metadata about the class in the cache,
-     * including information about attributes and enum cases (PHP 8.0+ and 8.1+).
-     */
-    private function storeMetadata(): void
-    {
-        if ($this->reflectionClass === null || $this->metadataCache->hasMetadata($this->className)) {
-            return;
-        }
-
-        // Extract basic metadata
-        $metadata = [
-            'short_name' => $this->reflectionClass->getShortName(),
-            'namespace' => $this->reflectionClass->getNamespaceName(),
-            'parent_class' => ($parent = $this->reflectionClass->getParentClass()) ? $parent->getName() : null,
-            'instantiable' => $this->reflectionClass->isInstantiable(),
-            'abstract' => $this->reflectionClass->isAbstract(),
-            'final' => $this->reflectionClass->isFinal(),
-            'method_count' => count($this->reflectionClass->getMethods()),
-            'property_count' => count($this->reflectionClass->getProperties()),
-        ];
-
-        // Extract interfaces
-        $interfaces = $this->reflectionClass->getInterfaceNames();
-        $metadata['interfaces'] = $interfaces;
-
-        // Extract attribute information
-        $attributes = [];
-        $reflectionAttributes = $this->reflectionClass->getAttributes();
-
-        foreach ($reflectionAttributes as $attribute) {
-            $attributeName = $attribute->getName();
-
-            try {
-                $attributes[$attributeName] = $attribute->getArguments();
-            } catch (\Throwable $e) {
-                // Skip attributes that can't be processed
-                continue;
-            }
-        }
-
-        $metadata['attributes'] = $attributes;
-
-        // Extract enum information
-        $metadata['is_enum'] = $this->reflectionClass->isEnum();
-
-        // If it's an enum, extract cases
-        if ($metadata['is_enum']) {
-            $cases = [];
-            $reflectionCases = $this->reflectionClass->getCases();
-
-            foreach ($reflectionCases as $case) {
-                $caseName = $case->getName();
-                /** @var class-string $className */
-                $className = $this->className->getFullyQualified();
-                $cases[$caseName] = $className::$caseName;
-            }
-
-            $metadata['enum_cases'] = $cases;
-        }
-
-        // Store the metadata
-        $this->metadataCache->storeMetadata($this->className, $metadata);
-    }
-}
diff --git a/src/Framework/Reflection/MethodInfo.php b/src/Framework/Reflection/MethodInfo.php
new file mode 100644
index 00000000..0cddbba1
--- /dev/null
+++ b/src/Framework/Reflection/MethodInfo.php
@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection;
+
+use App\Framework\Reflection\Collections\AttributeCollection;
+use App\Framework\Reflection\Collections\ParameterCollection;
+use ReflectionMethod;
+use ReflectionParameter;
+
+/**
+ * Value object representing reflection information about a method
+ */
+final readonly class MethodInfo
+{
+    public function __construct(
+        private ReflectionMethod $reflectionMethod
+    ) {
+    }
+
+    /**
+     * Get the method name
+     */
+    public function getName(): string
+    {
+        return $this->reflectionMethod->getName();
+    }
+
+    /**
+     * Get all parameters of the method
+     *
+     * @return ParameterCollection Collection of parameters
+     */
+    public function getParameters(): ParameterCollection
+    {
+        $nativeParameters = $this->reflectionMethod->getParameters();
+        $parameters = [];
+
+        foreach ($nativeParameters as $position => $nativeParameter) {
+            $parameters[] = new ParameterInfo($nativeParameter, $position);
+        }
+
+        return new ParameterCollection(...$parameters);
+    }
+
+    /**
+     * Get all attributes of the method
+     *
+     * @param string|null $attributeClass Optional attribute class to filter by
+     * @return AttributeCollection Collection of attributes
+     */
+    public function getAttributes(?string $attributeClass = null): AttributeCollection
+    {
+        $nativeAttributes = $this->reflectionMethod->getAttributes($attributeClass);
+        $attributes = [];
+
+        foreach ($nativeAttributes as $nativeAttribute) {
+            $attributes[] = new WrappedReflectionAttribute($nativeAttribute);
+        }
+
+        return new AttributeCollection(...$attributes);
+    }
+
+    /**
+     * Check if the method has a specific attribute
+     *
+     * @param string $attributeClass The attribute class name to check for
+     * @return bool True if the method has the attribute, false otherwise
+     */
+    public function hasAttribute(string $attributeClass): bool
+    {
+        return ! $this->getAttributes($attributeClass)->isEmpty();
+    }
+
+    /**
+     * Get the native ReflectionMethod instance
+     *
+     * @return ReflectionMethod The native ReflectionMethod
+     */
+    public function getNativeMethod(): ReflectionMethod
+    {
+        return $this->reflectionMethod;
+    }
+
+    /**
+     * Check if the method is public
+     */
+    public function isPublic(): bool
+    {
+        return $this->reflectionMethod->isPublic();
+    }
+
+    /**
+     * Check if the method is protected
+     */
+    public function isProtected(): bool
+    {
+        return $this->reflectionMethod->isProtected();
+    }
+
+    /**
+     * Check if the method is private
+     */
+    public function isPrivate(): bool
+    {
+        return $this->reflectionMethod->isPrivate();
+    }
+
+    /**
+     * Check if the method is static
+     */
+    public function isStatic(): bool
+    {
+        return $this->reflectionMethod->isStatic();
+    }
+
+    /**
+     * Invoke the method on an object instance
+     *
+     * @param object|null $object The object instance (null for static methods)
+     * @param mixed ...$args Method arguments
+     * @return mixed The method return value
+     */
+    public function invoke(?object $object, mixed ...$args): mixed
+    {
+        return $this->reflectionMethod->invoke($object, ...$args);
+    }
+}
+
diff --git a/src/Framework/Reflection/Monitoring/ReflectionMetrics.php b/src/Framework/Reflection/Monitoring/ReflectionMetrics.php
deleted file mode 100644
index 224f99c5..00000000
--- a/src/Framework/Reflection/Monitoring/ReflectionMetrics.php
+++ /dev/null
@@ -1,98 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Monitoring;
-
-/**
- * Metrics collector for reflection operations
- */
-final class ReflectionMetrics
-{
-    /**
-     * @var array<string, int>
-     */
-    private array $cachehits = [];
-
-    /**
-     * @var array<string, int>
-     */
-    private array $cacheMisses = [];
-
-    /**
-     * @var array<string, array<float>>
-     */
-    private array $operationTimes = [];
-
-    private int $totalOperations = 0;
-
-    public function recordCacheHit(string $operation, string $key): void
-    {
-        $this->cachehits[$operation] ??= 0;
-        $this->cachehits[$operation]++;
-        $this->totalOperations++;
-    }
-
-    public function recordCacheMiss(string $operation, string $key): void
-    {
-        $this->cacheMisses[$operation] ??= 0;
-        $this->cacheMisses[$operation]++;
-        $this->totalOperations++;
-    }
-
-    public function recordOperationTime(string $operation, float $timeInMs): void
-    {
-        $this->operationTimes[$operation] ??= [];
-        $this->operationTimes[$operation][] = $timeInMs;
-    }
-
-    public function getCacheHitRate(): float
-    {
-        $totalHits = array_sum($this->cachehits);
-
-        return $this->totalOperations > 0
-            ? $totalHits / $this->totalOperations
-            : 0.0;
-    }
-
-    public function getAverageOperationTime(string $operation): float
-    {
-        if (! isset($this->operationTimes[$operation]) || empty($this->operationTimes[$operation])) {
-            return 0.0;
-        }
-
-        $times = $this->operationTimes[$operation];
-
-        return array_sum($times) / count($times);
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    public function getMetricsSummary(): array
-    {
-        return [
-            'total_operations' => $this->totalOperations,
-            'cache_hit_rate' => $this->getCacheHitRate(),
-            'cache_hits' => $this->cachehits,
-            'cache_misses' => $this->cacheMisses,
-            'operation_times' => array_map(
-                fn (array $times) => [
-                    'avg' => array_sum($times) / count($times),
-                    'min' => empty($times) ? 0.0 : min($times),
-                    'max' => empty($times) ? 0.0 : max($times),
-                    'count' => count($times),
-                ],
-                $this->operationTimes
-            ),
-        ];
-    }
-
-    public function reset(): void
-    {
-        $this->cachehits = [];
-        $this->cacheMisses = [];
-        $this->operationTimes = [];
-        $this->totalOperations = 0;
-    }
-}
diff --git a/src/Framework/Reflection/ParameterInfo.php b/src/Framework/Reflection/ParameterInfo.php
new file mode 100644
index 00000000..387dc3f1
--- /dev/null
+++ b/src/Framework/Reflection/ParameterInfo.php
@@ -0,0 +1,128 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection;
+
+use ReflectionParameter;
+use ReflectionType;
+
+/**
+ * Value object representing reflection information about a method parameter
+ */
+final readonly class ParameterInfo
+{
+    public function __construct(
+        private ReflectionParameter $reflectionParameter,
+        private int $position
+    ) {
+    }
+
+    /**
+     * Get the parameter name
+     */
+    public function getName(): string
+    {
+        return $this->reflectionParameter->getName();
+    }
+
+    /**
+     * Get the parameter position
+     */
+    public function getPosition(): int
+    {
+        return $this->position;
+    }
+
+    /**
+     * Get the parameter type
+     */
+    public function getType(): ?ReflectionType
+    {
+        return $this->reflectionParameter->getType();
+    }
+
+    /**
+     * Get the parameter type name (if available)
+     */
+    public function getTypeName(): ?string
+    {
+        $type = $this->getType();
+
+        return $type ? $type->getName() : null;
+    }
+
+    /**
+     * Check if the parameter type is a builtin type
+     */
+    public function isBuiltin(): bool
+    {
+        $type = $this->getType();
+
+        return $type !== null && $type->isBuiltin();
+    }
+
+    /**
+     * Check if the parameter is optional
+     */
+    public function isOptional(): bool
+    {
+        return $this->reflectionParameter->isOptional();
+    }
+
+    /**
+     * Check if the parameter has a default value
+     */
+    public function hasDefaultValue(): bool
+    {
+        return $this->reflectionParameter->isDefaultValueAvailable();
+    }
+
+    /**
+     * Get the parameter default value
+     */
+    public function getDefaultValue(): mixed
+    {
+        if (! $this->hasDefaultValue()) {
+            return null;
+        }
+
+        return $this->reflectionParameter->getDefaultValue();
+    }
+
+    /**
+     * Check if the parameter allows null
+     */
+    public function allowsNull(): bool
+    {
+        return $this->reflectionParameter->allowsNull();
+    }
+
+    /**
+     * Check if the parameter is variadic
+     */
+    public function isVariadic(): bool
+    {
+        return $this->reflectionParameter->isVariadic();
+    }
+
+    /**
+     * Get parameter attributes
+     *
+     * @param string|null $attributeClass Optional attribute class to filter by
+     * @return array<\ReflectionAttribute<object>> Array of parameter attributes
+     */
+    public function getAttributes(?string $attributeClass = null): array
+    {
+        return $this->reflectionParameter->getAttributes($attributeClass);
+    }
+
+    /**
+     * Get the native ReflectionParameter instance
+     */
+    public function getNativeParameter(): ReflectionParameter
+    {
+        return $this->reflectionParameter;
+    }
+}
+
diff --git a/src/Framework/Reflection/README.md b/src/Framework/Reflection/README.md
index 11183d81..cb1f4a1e 100644
--- a/src/Framework/Reflection/README.md
+++ b/src/Framework/Reflection/README.md
@@ -1,201 +1,203 @@
 # Reflection Module
 
-The Reflection module provides a powerful, efficient, and developer-friendly API for PHP reflection operations. It enhances PHP's native reflection capabilities with caching, lazy loading, batch operations, and a fluent interface.
+A minimal, focused reflection service for the framework that provides a clean API without complex caching overhead.
 
-## Features
+## Overview
 
-- **Caching**: Dramatically improves performance for repeated reflection operations
-- **Lazy Loading**: Only loads reflection data when needed, reducing memory usage
-- **Batch Operations**: Efficiently process multiple classes or methods at once
-- **Fluent API**: Intuitive builder pattern for reflection operations
-- **Interface Segregation**: Focused interfaces for specific reflection needs
-- **PHP 8.x Support**: Full support for attributes (PHP 8.0+) and enums (PHP 8.1+)
-- **Memory Optimization**: Advanced memory management to prevent leaks and reduce footprint
+The Reflection module provides a simple wrapper around PHP's native Reflection API with a minimal, focused interface. It's designed to be:
 
-## Basic Usage
+- **Simple**: Direct use of native PHP reflection without complex caching layers
+- **Fast**: Native reflection is already fast; caching is optional and minimal
+- **Focused**: Only the methods actually used by the framework are exposed
+- **Type-safe**: Uses Value Objects (`ClassName`, `ClassInfo`, `MethodInfo`, etc.)
+
+## Architecture
+
+### Core Components
+
+- **`ReflectionService`**: Main interface for reflection operations
+- **`SimpleReflectionService`**: Implementation using native PHP reflection
+- **`ClassInfo`**: Value object wrapping `ReflectionClass`
+- **`MethodInfo`**: Value object wrapping `ReflectionMethod`
+- **`ParameterInfo`**: Value object wrapping `ReflectionParameter`
+- **Collections**: Type-safe collections for methods, parameters, attributes, and properties
+
+### Design Principles
+
+1. **No Inheritance**: All classes are `final` and use composition
+2. **Immutable**: Value objects are `readonly`
+3. **Minimal API**: Only expose methods that are actually used
+4. **Direct Access**: Native reflection objects are accessible when needed
+5. **Simple Caching**: Optional request-scope array cache (no LRU, no persistence)
+
+## Usage
+
+### Basic Reflection
 
 ```php
+use App\Framework\Reflection\ReflectionService;
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\CachedReflectionProvider;
 
-// Create a reflection provider
-$reflection = new CachedReflectionProvider();
+$reflectionService = new SimpleReflectionService();
 
-// Get information about a class
-$class = $reflection->getClass(ClassName::create(MyClass::class));
+// Reflect a class
+$classInfo = $reflectionService->reflectClass(ClassName::create(MyClass::class));
 
-// Check if a class has an attribute
-$hasAttribute = $reflection->hasAttribute(
-    ClassName::create(MyClass::class), 
-    MyAttribute::class
-);
+// Get methods
+$methods = $classInfo->getMethods();
+foreach ($methods as $method) {
+    echo $method->getName();
+}
 
-// Get method parameters
-$parameters = $reflection->getMethodParameters(
-    ClassName::create(MyClass::class), 
+// Reflect a method
+$methodInfo = $reflectionService->reflectMethod(
+    ClassName::create(MyClass::class),
     'myMethod'
 );
 
-// Create a new instance
-if ($reflection->isInstantiable(ClassName::create(MyClass::class))) {
-    $instance = $class->newInstance('arg1', 'arg2');
+// Get parameters
+$parameters = $methodInfo->getParameters();
+foreach ($parameters as $parameter) {
+    echo $parameter->getName() . ': ' . $parameter->getTypeName();
 }
 ```
 
-## Advanced Usage
-
-### Fluent API with ReflectionBuilder
+### Convenience Methods
 
 ```php
-use App\Framework\Reflection\Builder\ReflectionBuilderFactory;
+// Check if class is instantiable
+$isInstantiable = $reflectionService->isInstantiable(ClassName::create(MyClass::class));
 
-// Get information about a class
-$class = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->getClass();
+// Check if class implements interface
+$implements = $reflectionService->implementsInterface(
+    ClassName::create(MyClass::class),
+    MyInterface::class
+);
 
-// Get information about a method
-$method = ReflectionBuilderFactory::forMethod(MyClass::class, 'myMethod')
-    ->getMethod();
-
-// Check if a class has a specific attribute
-$hasAttribute = ReflectionBuilderFactory::forClassWithAttribute(
-    MyClass::class, 
+// Check if class has attribute
+$hasAttribute = $reflectionService->hasAttribute(
+    ClassName::create(MyClass::class),
     MyAttribute::class
-)->hasAttribute();
+);
 
-// Create a new instance
-$instance = ReflectionBuilderFactory::forClass(MyClass::class)
-    ->newInstance('arg1', 'arg2');
+// Get method parameters directly
+$parameters = $reflectionService->getMethodParameters(
+    ClassName::create(MyClass::class),
+    'myMethod'
+);
 ```
 
-### Batch Operations
+### Working with Attributes
 
 ```php
-use App\Framework\Reflection\BatchOperations\ReflectionBatchProcessor;
-use App\Framework\Reflection\CachedReflectionProvider;
-
-// Create a batch processor
-$provider = new CachedReflectionProvider();
-$batchProcessor = new ReflectionBatchProcessor($provider);
-
-// Get attributes for multiple classes
-$attributes = $batchProcessor->getAttributesForClasses([
-    MyClass1::class,
-    MyClass2::class,
-    MyClass3::class
-], RouteAttribute::class);
-
-// Get methods with a specific attribute
-$methods = $batchProcessor->getMethodsWithAttribute([
-    Controller1::class,
-    Controller2::class,
-    Controller3::class
-], RouteAttribute::class);
-```
-
-### Working with Enums
-
-```php
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\CachedReflectionProvider;
-
-$reflection = new CachedReflectionProvider();
-$enumClass = ClassName::create(StatusEnum::class);
-
-// Check if a class is an enum
-if ($reflection->isEnum($enumClass)) {
-    // Get all enum cases
-    $cases = $reflection->getEnumCases($enumClass);
-    
-    // Check if enum has a specific case
-    if ($reflection->hasEnumCase($enumClass, 'ACTIVE')) {
-        // Get the enum case
-        $case = $reflection->getEnumCase($enumClass, 'ACTIVE');
-    }
-    
-    // Check if enum is backed
-    if ($reflection->isBackedEnum($enumClass)) {
-        // Get backing type
-        $type = $reflection->getEnumBackingType($enumClass);
-        
-        // Get backing value for a case
-        $value = $reflection->getEnumCaseBackingValue($enumClass, 'ACTIVE');
-    }
+// Get class attributes
+$attributes = $classInfo->getAttributes();
+foreach ($attributes as $attribute) {
+    echo $attribute->getName();
+    $instance = $attribute->newInstance();
 }
+
+// Filter by attribute type
+$specificAttributes = $classInfo->getAttributes(MyAttribute::class);
+
+// Check if has attribute
+$hasAttribute = $classInfo->hasAttribute(MyAttribute::class);
 ```
 
-### Specialized Interfaces
+### Accessing Native Reflection
 
-The module provides specialized interfaces for specific reflection needs:
+When you need full access to native PHP reflection objects:
 
 ```php
-use App\Framework\Reflection\Contracts\ClassReflector;
-use App\Framework\Reflection\Contracts\MethodReflector;
-use App\Framework\Reflection\Contracts\AttributeReflector;
-use App\Framework\Reflection\CachedReflectionProvider;
+$classInfo = $reflectionService->reflectClass(ClassName::create(MyClass::class));
+$nativeClass = $classInfo->getNativeClass(); // ReflectionClass
 
-class MyService {
-    public function __construct(
-        // Only depend on what you need
-        private ClassReflector $classReflector,
-        private MethodReflector $methodReflector,
-        private AttributeReflector $attributeReflector
-    ) {}
-    
-    // Or use the complete implementation for all capabilities
-    public function withComplete(CachedReflectionProvider $reflection) {
-        // ...
-    }
-}
+$methodInfo = $reflectionService->reflectMethod(
+    ClassName::create(MyClass::class),
+    'myMethod'
+);
+$nativeMethod = $methodInfo->getNativeMethod(); // ReflectionMethod
+
+$parameterInfo = $methodInfo->getParameters()->first();
+$nativeParameter = $parameterInfo->getNativeParameter(); // ReflectionParameter
 ```
 
-## Performance Considerations
+## Migration from ReflectionLegacy
 
-The Reflection module is optimized for performance, but reflection operations can still be expensive. Consider these best practices:
+The new Reflection module runs in parallel with `ReflectionLegacy`. Migration is done service-by-service:
 
-- **Cache Warming**: Pre-warm the cache for frequently used classes
-- **Lazy Loading**: Use lazy loading for classes that might not be needed
-- **Batch Operations**: Use batch operations for processing multiple classes
-- **Memory Management**: Call `flush()` to clear the cache when done with a large batch
-- **Environment Configuration**: Use development mode during development for better debugging
+### Before (ReflectionLegacy)
+```php
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
-See [EVALUATION.md](EVALUATION.md) for detailed performance analysis and recommendations.
+$reflection = $this->reflectionProvider->getClass($className);
+$methods = $reflection->getMethods();
+```
 
-## When to Use
+### After (Reflection)
+```php
+use App\Framework\Reflection\ReflectionService;
 
-The Reflection module is ideal for:
+$classInfo = $this->reflectionService->reflectClass($className);
+$methods = $classInfo->getMethods();
+```
 
-- Framework-level features that need to analyze many classes
-- Applications that need efficient, repeated reflection operations
-- Code that benefits from a more developer-friendly reflection API
-- Projects that need advanced features like batch operations or lazy loading
+## Performance
 
-For simpler use cases, consider using PHP's native reflection API directly.
+Native PHP reflection is fast for single operations (microseconds to low milliseconds per class). The module uses:
+
+- **Simple Request-Scope Cache**: Optional array cache to avoid repeated `ReflectionClass` instantiation within the same request
+- **No Persistent Caching**: No cross-request caching (unlike ReflectionLegacy)
+- **Direct API Access**: No wrapper overhead for most operations
+
+Performance characteristics:
+- **First Access**: Same as native PHP reflection (~0.1-1ms per class)
+- **Cached Access**: Slightly faster (~0.05-0.5ms per class)
+- **Memory**: Minimal overhead (simple array cache)
+
+## Comparison with ReflectionLegacy
+
+| Feature | Reflection | ReflectionLegacy |
+|---------|-----------|-----------------|
+| API Size | Minimal (~7 methods) | Large (~30+ methods) |
+| Caching | Request-scope only | Persistent + LRU |
+| Complexity | Low | High |
+| Lines of Code | ~600-900 | ~2500+ |
+| Use Case | Production framework | Production framework |
+
+Both modules can run in parallel during migration.
 
 ## Module Structure
 
-- **Core Components**:
-  - `ReflectionProvider`: Main interface combining all reflection capabilities
-  - `CachedReflectionProvider`: Complete implementation with caching
+```
+src/Framework/Reflection/
+├── ReflectionService.php          # Main interface
+├── SimpleReflectionService.php     # Implementation
+├── ClassInfo.php                  # Class value object
+├── MethodInfo.php                 # Method value object
+├── ParameterInfo.php              # Parameter value object
+├── WrappedReflectionAttribute.php # Attribute wrapper
+├── Collections/                   # Type-safe collections
+│   ├── ParameterCollection.php
+│   ├── MethodCollection.php
+│   ├── AttributeCollection.php
+│   └── PropertyCollection.php
+└── README.md                       # This file
+```
 
-- **Specialized Interfaces**:
-  - `ClassReflector`: Class-level reflection operations
-  - `MethodReflector`: Method-level reflection operations
-  - `PropertyReflector`: Property-level reflection operations
-  - `ParameterReflector`: Parameter-level reflection operations
-  - `AttributeReflector`: Attribute-related reflection operations
-  - `EnumReflector`: Enum-related reflection operations (PHP 8.1+)
-  - `InstantiationReflector`: Instantiation-related reflection operations
-  - `CacheManager`: Cache management operations
+## Integration
 
-- **Performance Optimizations**:
-  - `LazyReflectionProxy`: Lazy-loading proxy for ReflectionClass
-  - `ReflectionBatchProcessor`: Batch operations for multiple classes
-  - `ReflectionBuilder`: Fluent API for reflection operations
-  - `ReflectionCache`: Coordinated caching for reflection data
+The Reflection module is registered in the DI container:
 
-## Further Documentation
+```php
+// In DefaultContainer
+$this->instance(ReflectionService::class, new SimpleReflectionService());
+```
 
-- [EVALUATION.md](EVALUATION.md): Detailed analysis of the module's value and overhead
-- [Builder/README.md](Builder/README.md): Documentation for the ReflectionBuilder
-- [BatchOperations/README.md](BatchOperations/README.md): Documentation for batch operations
+Services using reflection:
+- `ParameterResolver`: Method parameter resolution
+- `MethodInvoker`: Method invocation with DI
+- `ParameterProcessor`: Route parameter processing
+- `ControllerRequestFactory`: Request object creation
+- `MiddlewareDependencyResolver`: Middleware dependency analysis
+- `MiddlewareManager`: Middleware stack management
diff --git a/src/Framework/Reflection/ReflectionService.php b/src/Framework/Reflection/ReflectionService.php
new file mode 100644
index 00000000..478daf37
--- /dev/null
+++ b/src/Framework/Reflection/ReflectionService.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\Reflection\Collections\ParameterCollection;
+
+/**
+ * Minimal reflection service interface
+ *
+ * Provides a simple, focused API for reflection operations without complex caching.
+ * Uses native PHP reflection API directly for optimal simplicity and performance.
+ */
+interface ReflectionService
+{
+    /**
+     * Reflect a class and return ClassInfo
+     *
+     * @param ClassName $className The class name to reflect
+     * @return ClassInfo Information about the class
+     */
+    public function reflectClass(ClassName $className): ClassInfo;
+
+    /**
+     * Reflect a method and return MethodInfo
+     *
+     * @param ClassName $className The class name containing the method
+     * @param string $methodName The method name to reflect
+     * @return MethodInfo Information about the method
+     */
+    public function reflectMethod(ClassName $className, string $methodName): MethodInfo;
+
+    /**
+     * Get method parameters (convenience method)
+     *
+     * This is a commonly used operation, provided as a convenience method.
+     *
+     * @param ClassName $className The class name containing the method
+     * @param string $methodName The method name to get parameters for
+     * @return ParameterCollection Collection of method parameters
+     */
+    public function getMethodParameters(ClassName $className, string $methodName): ParameterCollection;
+
+    /**
+     * Check if a class has a specific attribute (convenience method)
+     *
+     * @param ClassName $className The class name to check
+     * @param string $attributeClass The attribute class name to check for
+     * @return bool True if the class has the attribute, false otherwise
+     */
+    public function hasAttribute(ClassName $className, string $attributeClass): bool;
+
+    /**
+     * Check if a class is instantiable (convenience method)
+     *
+     * @param ClassName $className The class name to check
+     * @return bool True if the class is instantiable, false otherwise
+     */
+    public function isInstantiable(ClassName $className): bool;
+
+    /**
+     * Check if a class implements an interface (convenience method)
+     *
+     * @param ClassName $className The class name to check
+     * @param string $interfaceName The interface name to check for
+     * @return bool True if the class implements the interface, false otherwise
+     */
+    public function implementsInterface(ClassName $className, string $interfaceName): bool;
+}
+
diff --git a/src/Framework/Reflection/SimpleReflectionService.php b/src/Framework/Reflection/SimpleReflectionService.php
new file mode 100644
index 00000000..bfa1d730
--- /dev/null
+++ b/src/Framework/Reflection/SimpleReflectionService.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Reflection;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\DI\Attributes\DefaultImplementation;
+use App\Framework\Reflection\Collections\ParameterCollection;
+use ReflectionClass;
+use ReflectionMethod;
+
+/**
+ * Simple reflection service implementation
+ *
+ * Uses native PHP reflection API directly without complex caching.
+ * Provides a clean, minimal API for reflection operations.
+ */
+#[DefaultImplementation(ReflectionService::class)]
+final class SimpleReflectionService implements ReflectionService
+{
+    /**
+     * Optional: Simple request-scope cache to avoid repeated ReflectionClass instantiation
+     * in the same request. This is a simple array without LRU or limits.
+     *
+     * @var array<string, ReflectionClass<object>>
+     */
+    private array $classCache;
+
+    public function __construct()
+    {
+        $this->classCache = [];
+    }
+
+    /**
+     * Reflect a class and return ClassInfo
+     */
+    public function reflectClass(ClassName $className): ClassInfo
+    {
+        $key = $className->getFullyQualified();
+
+        // Use simple request-scope cache if available
+        if (! isset($this->classCache[$key])) {
+            /** @var class-string $key */
+            $this->classCache[$key] = new ReflectionClass($key);
+        }
+
+        return new ClassInfo($className, $this->classCache[$key]);
+    }
+
+    /**
+     * Reflect a method and return MethodInfo
+     */
+    public function reflectMethod(ClassName $className, string $methodName): MethodInfo
+    {
+        $classInfo = $this->reflectClass($className);
+        $nativeMethod = $classInfo->getNativeClass()->getMethod($methodName);
+
+        return new MethodInfo($nativeMethod);
+    }
+
+    /**
+     * Get method parameters (convenience method)
+     */
+    public function getMethodParameters(ClassName $className, string $methodName): ParameterCollection
+    {
+        return $this->reflectMethod($className, $methodName)->getParameters();
+    }
+
+    /**
+     * Check if a class has a specific attribute (convenience method)
+     */
+    public function hasAttribute(ClassName $className, string $attributeClass): bool
+    {
+        return $this->reflectClass($className)->hasAttribute($attributeClass);
+    }
+
+    /**
+     * Check if a class is instantiable (convenience method)
+     */
+    public function isInstantiable(ClassName $className): bool
+    {
+        return $this->reflectClass($className)->isInstantiable();
+    }
+
+    /**
+     * Check if a class implements an interface (convenience method)
+     */
+    public function implementsInterface(ClassName $className, string $interfaceName): bool
+    {
+        return $this->reflectClass($className)->implementsInterface($interfaceName);
+    }
+}
+
diff --git a/src/Framework/Reflection/Strategies/CacheWarmupStrategy.php b/src/Framework/Reflection/Strategies/CacheWarmupStrategy.php
deleted file mode 100644
index f50a22eb..00000000
--- a/src/Framework/Reflection/Strategies/CacheWarmupStrategy.php
+++ /dev/null
@@ -1,66 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Strategies;
-
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionCache;
-
-/**
- * Strategy for warming up reflection caches
- */
-final readonly class CacheWarmupStrategy
-{
-    public function __construct(
-        private ReflectionCache $cache
-    ) {
-    }
-
-    /**
-     * Warm up cache with commonly used framework classes
-     */
-    public function warmupFrameworkClasses(): self
-    {
-        $frameworkClasses = [
-            'App\Framework\Http\HttpRequest',
-            'App\Framework\Http\HttpResponse',
-            'App\Framework\Router\Route',
-            'App\Framework\DI\Container',
-            'App\Framework\Cache\Cache',
-        ];
-
-        foreach ($frameworkClasses as $className) {
-            if (! empty($className) && ClassName::create($className)->exists()) {
-                $this->cache->classCache->getClass(ClassName::create($className));
-            }
-        }
-
-        return $this;
-    }
-
-    /**
-     * Warm up cache with application-specific classes
-     * @param array<string> $classNames
-     */
-    public function warmupApplicationClasses(array $classNames): self
-    {
-        foreach ($classNames as $className) {
-            if (! empty($className) && ClassName::create($className)->exists()) {
-                $this->cache->classCache->getClass(ClassName::create($className));
-            }
-        }
-
-        return $this;
-    }
-
-    /**
-     * Warm up cache for classes with specific attributes
-     */
-    public function warmupAttributeClasses(string $attributeClass): self
-    {
-        // This would require scanning all loaded classes
-        // Implementation depends on specific requirements
-        return $this;
-    }
-}
diff --git a/src/Framework/Reflection/Strategies/MemoryAwareCacheStrategy.php b/src/Framework/Reflection/Strategies/MemoryAwareCacheStrategy.php
deleted file mode 100644
index 3f8fdcbb..00000000
--- a/src/Framework/Reflection/Strategies/MemoryAwareCacheStrategy.php
+++ /dev/null
@@ -1,75 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Framework\Reflection\Strategies;
-
-use App\Framework\DateTime\Clock;
-
-/**
- * Memory-aware cache strategy with LRU eviction
- */
-final class MemoryAwareCacheStrategy
-{
-    /**
-     * @var array<string, int>
-     */
-    private array $accessTimes = [];
-
-    private int $maxMemoryUsage;
-
-    private int $maxEntries;
-
-    public function __construct(
-        private readonly Clock $clock,
-        int $maxMemoryUsage = 10 * 1024 * 1024, // 10MB
-        int $maxEntries = 1000
-    ) {
-        $this->maxMemoryUsage = $maxMemoryUsage;
-        $this->maxEntries = $maxEntries;
-    }
-
-    /**
-     * @param array<string, mixed> $cache
-     */
-    public function shouldEvict(array $cache, string $key): bool
-    {
-        // Track access time
-        $this->accessTimes[$key] = $this->clock->time()->toTimestamp();
-
-        // Check memory usage
-        $memoryUsage = strlen(serialize($cache));
-        if ($memoryUsage > $this->maxMemoryUsage) {
-            return true;
-        }
-
-        // Check entry count
-        if (count($cache) > $this->maxEntries) {
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * @return array<int, string>
-     */
-    public function getLeastRecentlyUsedKeys(int $count): array
-    {
-        asort($this->accessTimes);
-
-        return array_slice(array_keys($this->accessTimes), 0, $count);
-    }
-
-    /**
-     * @param array<string, mixed> $cache
-     */
-    public function evictLeastRecentlyUsed(array &$cache, int $count): void
-    {
-        $keysToEvict = $this->getLeastRecentlyUsedKeys($count);
-
-        foreach ($keysToEvict as $key) {
-            unset($cache[$key], $this->accessTimes[$key]);
-        }
-    }
-}
diff --git a/src/Framework/Reflection/WrappedReflectionAttribute.php b/src/Framework/Reflection/WrappedReflectionAttribute.php
index 3a420808..b5a3d2c4 100644
--- a/src/Framework/Reflection/WrappedReflectionAttribute.php
+++ b/src/Framework/Reflection/WrappedReflectionAttribute.php
@@ -4,69 +4,90 @@ declare(strict_types=1);
 
 namespace App\Framework\Reflection;
 
-use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\AttributeCache;
-use Attribute;
+use ReflectionAttribute;
 
+/**
+ * Simple wrapper around ReflectionAttribute
+ */
 final readonly class WrappedReflectionAttribute
 {
     public function __construct(
-        private ClassName $className,
-        private ?string $methodName,
-        private string $attributeClass,
-        private int $index,
-        private AttributeCache $cache
+        private ReflectionAttribute $reflectionAttribute
     ) {
     }
 
+    /**
+     * Get the attribute name
+     */
     public function getName(): string
     {
-        // BUGFIX: Get the attribute name directly from the native attributes array using the correct index
-        $nativeAttributes = $this->methodName
-            ? $this->cache->getNativeMethodAttributes($this->className, $this->methodName, null)
-            : $this->cache->getNativeClassAttributes($this->className, null);
-
-        return isset($nativeAttributes[$this->index]) ? $nativeAttributes[$this->index]->getName() : '';
-    }
-
-    public function getShortName(): string
-    {
-        return $this->cache->getAttributeShortName($this->className, $this->methodName, $this->attributeClass, $this->index);
-    }
-
-    public function getTarget(): int
-    {
-        return $this->cache->getAttributeTarget($this->className, $this->methodName, $this->attributeClass, $this->index);
-    }
-
-    public function isRepeated(): bool
-    {
-        return $this->cache->isAttributeRepeated($this->className, $this->methodName, $this->attributeClass, $this->index);
+        return $this->reflectionAttribute->getName();
     }
 
     /**
+     * Get the attribute short name (without namespace)
+     */
+    public function getShortName(): string
+    {
+        $name = $this->getName();
+        $parts = explode('\\', $name);
+
+        return end($parts);
+    }
+
+    /**
+     * Get the attribute target flags
+     */
+    public function getTarget(): int
+    {
+        return $this->reflectionAttribute->getTarget();
+    }
+
+    /**
+     * Check if the attribute is repeated
+     */
+    public function isRepeated(): bool
+    {
+        return $this->reflectionAttribute->isRepeated();
+    }
+
+    /**
+     * Get the attribute arguments
+     *
      * @return array<mixed>
      */
     public function getArguments(): array
     {
-        return $this->cache->getAttributeArguments($this->className, $this->methodName, $this->attributeClass, $this->index);
+        return $this->reflectionAttribute->getArguments();
     }
 
-    public function newInstance(): ?object
+    /**
+     * Create a new instance of the attribute
+     */
+    public function newInstance(): object
     {
-        return $this->cache->getAttributeInstance($this->className, $this->methodName, $this->attributeClass, $this->index);
+        return $this->reflectionAttribute->newInstance();
     }
 
+    /**
+     * Check if the attribute has arguments
+     */
     public function hasArguments(): bool
     {
         return ! empty($this->getArguments());
     }
 
+    /**
+     * Get the number of arguments
+     */
     public function getArgumentCount(): int
     {
         return count($this->getArguments());
     }
 
+    /**
+     * Get an argument by index
+     */
     public function getArgument(int $index): mixed
     {
         $args = $this->getArguments();
@@ -74,98 +95,20 @@ final readonly class WrappedReflectionAttribute
         return $args[$index] ?? null;
     }
 
+    /**
+     * Get the first argument
+     */
     public function getFirstArgument(): mixed
     {
         return $this->getArgument(0);
     }
 
     /**
-     * Check if attribute targets class
+     * Get the native ReflectionAttribute instance
      */
-    public function targetsClass(): bool
+    public function getNativeAttribute(): ReflectionAttribute
     {
-        return ($this->getTarget() & Attribute::TARGET_CLASS) !== 0;
-    }
-
-    /**
-     * Check if attribute targets method
-     */
-    public function targetsMethod(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_METHOD) !== 0;
-    }
-
-    /**
-     * Check if attribute targets property
-     */
-    public function targetsProperty(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_PROPERTY) !== 0;
-    }
-
-    /**
-     * Check if attribute targets parameter
-     */
-    public function targetsParameter(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_PARAMETER) !== 0;
-    }
-
-    /**
-     * Check if attribute targets function
-     */
-    public function targetsFunction(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_FUNCTION) !== 0;
-    }
-
-    /**
-     * Check if attribute targets constant
-     */
-    public function targetsConstant(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_CLASS_CONSTANT) !== 0;
-    }
-
-    /**
-     * Check if attribute targets all
-     */
-    public function targetsAll(): bool
-    {
-        return ($this->getTarget() & Attribute::TARGET_ALL) !== 0;
-    }
-
-    /**
-     * Get instance with type checking
-     */
-    public function getInstanceOf(string $expectedClass): ?object
-    {
-        $instance = $this->newInstance();
-
-        return $instance instanceof $expectedClass ? $instance : null;
-    }
-
-    /**
-     * Check if instance is of specific type
-     */
-    public function isInstanceOf(string $className): bool
-    {
-        return $this->getName() === $className || is_subclass_of($this->getName(), $className);
-    }
-
-    /**
-     * Convert to array for debugging
-     * @return array<string, mixed>
-     */
-    public function toArray(): array
-    {
-        return [
-            'name' => $this->getName(),
-            'shortName' => $this->getShortName(),
-            'target' => $this->getTarget(),
-            'isRepeated' => $this->isRepeated(),
-            'arguments' => $this->getArguments(),
-            'argumentCount' => $this->getArgumentCount(),
-        ];
+        return $this->reflectionAttribute;
     }
 }
+
diff --git a/src/Framework/ReflectionLegacy/Cache/AttributeCache.php b/src/Framework/ReflectionLegacy/Cache/AttributeCache.php
index ef1394b1..e2dffeb3 100644
--- a/src/Framework/ReflectionLegacy/Cache/AttributeCache.php
+++ b/src/Framework/ReflectionLegacy/Cache/AttributeCache.php
@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Cache;
+namespace App\Framework\ReflectionLegacy\Cache;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\WrappedReflectionAttribute;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\WrappedReflectionAttribute;
 
-final class AttributeCache implements \App\Framework\Reflection\Contracts\ReflectionCache
+final class AttributeCache implements \App\Framework\ReflectionLegacy\Contracts\ReflectionCache
 {
     /**
      * @var array<string, mixed>
diff --git a/src/Framework/Reflection/Cache/ClassCache.php b/src/Framework/ReflectionLegacy/Cache/ClassCache.php
similarity index 96%
rename from src/Framework/Reflection/Cache/ClassCache.php
rename to src/Framework/ReflectionLegacy/Cache/ClassCache.php
index 6255e4ad..92456846 100644
--- a/src/Framework/Reflection/Cache/ClassCache.php
+++ b/src/Framework/ReflectionLegacy/Cache/ClassCache.php
@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Cache;
+namespace App\Framework\ReflectionLegacy\Cache;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\PropertyCollection;
-use App\Framework\Reflection\Contracts\ReflectionCache;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\MethodCollection;
+use App\Framework\ReflectionLegacy\Collections\PropertyCollection;
+use App\Framework\ReflectionLegacy\Contracts\ReflectionCache;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 use ReflectionClass;
 
 final class ClassCache implements ReflectionCache
@@ -164,7 +164,7 @@ final class ClassCache implements ReflectionCache
         return $this->propertyCache[$key] ??= $this->getNativeClass($className)->hasMethod($methodName);
     }
 
-    public function getMethod(ClassName $className, string $methodName): \App\Framework\Reflection\WrappedReflectionMethod
+    public function getMethod(ClassName $className, string $methodName): \App\Framework\ReflectionLegacy\WrappedReflectionMethod
     {
         return $this->methodCache->getMethod($className, $methodName);
     }
diff --git a/src/Framework/Reflection/Cache/MetadataCacheManager.php b/src/Framework/ReflectionLegacy/Cache/MetadataCacheManager.php
similarity index 99%
rename from src/Framework/Reflection/Cache/MetadataCacheManager.php
rename to src/Framework/ReflectionLegacy/Cache/MetadataCacheManager.php
index fec0f500..e8e596c4 100644
--- a/src/Framework/Reflection/Cache/MetadataCacheManager.php
+++ b/src/Framework/ReflectionLegacy/Cache/MetadataCacheManager.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Cache;
+namespace App\Framework\ReflectionLegacy\Cache;
 
 use App\Framework\Cache\Cache;
 use App\Framework\Cache\CacheItem;
@@ -17,7 +17,7 @@ use ReflectionClass;
  *
  * Uses Framework's Cache system for cross-request persistence
  */
-final class MetadataCacheManager implements \App\Framework\Reflection\Contracts\ReflectionCache
+final class MetadataCacheManager implements \App\Framework\ReflectionLegacy\Contracts\ReflectionCache
 {
     private const int CACHE_VERSION = 2;
     private const int MAX_CACHE_AGE = 86400; // 24 hours
diff --git a/src/Framework/Reflection/Cache/MethodCache.php b/src/Framework/ReflectionLegacy/Cache/MethodCache.php
similarity index 89%
rename from src/Framework/Reflection/Cache/MethodCache.php
rename to src/Framework/ReflectionLegacy/Cache/MethodCache.php
index 82cad460..da46081c 100644
--- a/src/Framework/Reflection/Cache/MethodCache.php
+++ b/src/Framework/ReflectionLegacy/Cache/MethodCache.php
@@ -2,17 +2,17 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Cache;
+namespace App\Framework\ReflectionLegacy\Cache;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\MethodCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 use ReflectionMethod;
 
-final class MethodCache implements \App\Framework\Reflection\Contracts\ReflectionCache
+final class MethodCache implements \App\Framework\ReflectionLegacy\Contracts\ReflectionCache
 {
     private const MAX_CACHE_SIZE = 1000; // Limit cache size
     private const MEMORY_CHECK_INTERVAL = 50; // Check memory every 50 operations
@@ -104,16 +104,20 @@ final class MethodCache implements \App\Framework\Reflection\Contracts\Reflectio
                 $class = new \ReflectionClass($classNameString);
                 $this->methodCache[$key] = $class->getMethods($filter);
             } catch (\ReflectionException $e) {
-                // Provide context about which class failed to reflect
-                $errorMessage = sprintf(
-                    'Failed to reflect class "%s" in MethodCache::getNativeMethods(): %s',
-                    $classNameString,
-                    $e->getMessage()
-                );
-                error_log($errorMessage);
+                // Don't log here - let the caller (e.g. VisitorCoordinator) handle error aggregation
+                // This allows DiscoveryWarningAggregator to properly collect warnings for missing classes
+                // from incomplete modules instead of logging individual errors
                 
                 // Re-throw with more context
-                throw new \ReflectionException($errorMessage, $e->getCode(), $e);
+                throw new \ReflectionException(
+                    sprintf(
+                        'Failed to reflect class "%s" in MethodCache::getNativeMethods(): %s',
+                        $classNameString,
+                        $e->getMessage()
+                    ),
+                    $e->getCode(),
+                    $e
+                );
             }
         }
 
diff --git a/src/Framework/Reflection/Cache/ParameterCache.php b/src/Framework/ReflectionLegacy/Cache/ParameterCache.php
similarity index 97%
rename from src/Framework/Reflection/Cache/ParameterCache.php
rename to src/Framework/ReflectionLegacy/Cache/ParameterCache.php
index f0eae713..c06be65d 100644
--- a/src/Framework/Reflection/Cache/ParameterCache.php
+++ b/src/Framework/ReflectionLegacy/Cache/ParameterCache.php
@@ -2,16 +2,16 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Cache;
+namespace App\Framework\ReflectionLegacy\Cache;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\WrappedReflectionParameter;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\WrappedReflectionParameter;
 use InvalidArgumentException;
 
-final class ParameterCache implements \App\Framework\Reflection\Contracts\ReflectionCache
+final class ParameterCache implements \App\Framework\ReflectionLegacy\Contracts\ReflectionCache
 {
     /**
      * @var array<string, mixed>
diff --git a/src/Framework/Reflection/CachedReflectionProvider.php b/src/Framework/ReflectionLegacy/CachedReflectionProvider.php
similarity index 97%
rename from src/Framework/Reflection/CachedReflectionProvider.php
rename to src/Framework/ReflectionLegacy/CachedReflectionProvider.php
index bf888811..965305e0 100644
--- a/src/Framework/Reflection/CachedReflectionProvider.php
+++ b/src/Framework/ReflectionLegacy/CachedReflectionProvider.php
@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\Collections\PropertyCollection;
-use App\Framework\Reflection\Factory\ReflectionCacheFactory;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\MethodCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\Collections\PropertyCollection;
+use App\Framework\ReflectionLegacy\Factory\ReflectionCacheFactory;
 use ReflectionClass;
 use ReflectionMethod;
 use ReflectionParameter;
diff --git a/src/Framework/ReflectionLegacy/Collections/AttributeCollection.php b/src/Framework/ReflectionLegacy/Collections/AttributeCollection.php
index 46ef27c8..86021d04 100644
--- a/src/Framework/ReflectionLegacy/Collections/AttributeCollection.php
+++ b/src/Framework/ReflectionLegacy/Collections/AttributeCollection.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Collections;
+namespace App\Framework\ReflectionLegacy\Collections;
 
-use App\Framework\Reflection\WrappedReflectionAttribute;
+use App\Framework\ReflectionLegacy\WrappedReflectionAttribute;
 use ArrayIterator;
 use Countable;
 use IteratorAggregate;
diff --git a/src/Framework/ReflectionLegacy/Collections/MethodCollection.php b/src/Framework/ReflectionLegacy/Collections/MethodCollection.php
new file mode 100644
index 00000000..a7470c4d
--- /dev/null
+++ b/src/Framework/ReflectionLegacy/Collections/MethodCollection.php
@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ReflectionLegacy\Collections;
+
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
+use ArrayIterator;
+use Countable;
+use IteratorAggregate;
+
+/**
+ * @implements IteratorAggregate<int, WrappedReflectionMethod>
+ */
+final readonly class MethodCollection implements IteratorAggregate, Countable
+{
+    /** @var WrappedReflectionMethod[] */
+    private array $methods;
+
+    public function __construct(WrappedReflectionMethod ...$methods)
+    {
+        $this->methods = $methods;
+    }
+
+    /**
+     * @return ArrayIterator<int, WrappedReflectionMethod>
+     */
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator(array_values($this->methods));
+    }
+
+    public function count(): int
+    {
+        return count($this->methods);
+    }
+
+    public function isEmpty(): bool
+    {
+        return empty($this->methods);
+    }
+
+    /**
+     * @return array<WrappedReflectionMethod>
+     */
+    public function toArray(): array
+    {
+        return $this->methods;
+    }
+
+    public function getByName(string $name): ?WrappedReflectionMethod
+    {
+        foreach ($this->methods as $method) {
+            if ($method->getName() === $name) {
+                return $method;
+            }
+        }
+
+        return null;
+    }
+
+    public function hasMethod(string $name): bool
+    {
+        return $this->getByName($name) !== null;
+    }
+
+    public function getWithAttribute(string $attributeClass): self
+    {
+        $filtered = [];
+        foreach ($this->methods as $method) {
+            if ($method->hasAttribute($attributeClass)) {
+                $filtered[] = $method;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    /**
+     * @return array<string>
+     */
+    public function getNames(): array
+    {
+        return array_map(fn (WrappedReflectionMethod $method) => $method->getName(), $this->methods);
+    }
+
+    public function filter(callable $callback): self
+    {
+        $filtered = array_filter($this->methods, $callback);
+
+        return new self(...array_values($filtered));
+    }
+
+    /**
+     * @return array<mixed>
+     */
+    public function map(callable $callback): array
+    {
+        return array_map($callback, $this->methods);
+    }
+
+    public function first(): ?WrappedReflectionMethod
+    {
+        return $this->methods[0] ?? null;
+    }
+
+    public function findFirst(callable $callback): ?WrappedReflectionMethod
+    {
+        foreach ($this->methods as $method) {
+            if ($callback($method)) {
+                return $method;
+            }
+        }
+
+        return null;
+    }
+}
diff --git a/src/Framework/ReflectionLegacy/Collections/ParameterCollection.php b/src/Framework/ReflectionLegacy/Collections/ParameterCollection.php
index 902619fe..52629046 100644
--- a/src/Framework/ReflectionLegacy/Collections/ParameterCollection.php
+++ b/src/Framework/ReflectionLegacy/Collections/ParameterCollection.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Collections;
+namespace App\Framework\ReflectionLegacy\Collections;
 
-use App\Framework\Reflection\WrappedReflectionParameter;
+use App\Framework\ReflectionLegacy\WrappedReflectionParameter;
 use ArrayIterator;
 use Countable;
 use IteratorAggregate;
diff --git a/src/Framework/ReflectionLegacy/Collections/PropertyCollection.php b/src/Framework/ReflectionLegacy/Collections/PropertyCollection.php
new file mode 100644
index 00000000..3105bf3b
--- /dev/null
+++ b/src/Framework/ReflectionLegacy/Collections/PropertyCollection.php
@@ -0,0 +1,149 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ReflectionLegacy\Collections;
+
+use ArrayIterator;
+use Countable;
+use IteratorAggregate;
+use ReflectionProperty;
+
+/**
+ * @implements IteratorAggregate<int, ReflectionProperty>
+ */
+final readonly class PropertyCollection implements IteratorAggregate, Countable
+{
+    /** @var ReflectionProperty[] */
+    private array $properties;
+
+    public function __construct(ReflectionProperty ...$properties)
+    {
+        $this->properties = $properties;
+    }
+
+    /**
+     * @return ArrayIterator<int, ReflectionProperty>
+     */
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator(array_values($this->properties));
+    }
+
+    public function count(): int
+    {
+        return count($this->properties);
+    }
+
+    public function isEmpty(): bool
+    {
+        return empty($this->properties);
+    }
+
+    /**
+     * @return array<ReflectionProperty>
+     */
+    public function toArray(): array
+    {
+        return $this->properties;
+    }
+
+    public function getByName(string $name): ?ReflectionProperty
+    {
+        foreach ($this->properties as $property) {
+            if ($property->getName() === $name) {
+                return $property;
+            }
+        }
+
+        return null;
+    }
+
+    public function hasProperty(string $name): bool
+    {
+        return $this->getByName($name) !== null;
+    }
+
+    public function getPublic(): self
+    {
+        $filtered = [];
+        foreach ($this->properties as $property) {
+            if ($property->isPublic()) {
+                $filtered[] = $property;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    public function getPrivate(): self
+    {
+        $filtered = [];
+        foreach ($this->properties as $property) {
+            if ($property->isPrivate()) {
+                $filtered[] = $property;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    public function getProtected(): self
+    {
+        $filtered = [];
+        foreach ($this->properties as $property) {
+            if ($property->isProtected()) {
+                $filtered[] = $property;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    public function getStatic(): self
+    {
+        $filtered = [];
+        foreach ($this->properties as $property) {
+            if ($property->isStatic()) {
+                $filtered[] = $property;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    public function getReadonly(): self
+    {
+        $filtered = [];
+        foreach ($this->properties as $property) {
+            if ($property->isReadOnly()) {
+                $filtered[] = $property;
+            }
+        }
+
+        return new self(...$filtered);
+    }
+
+    /**
+     * @return array<string>
+     */
+    public function getNames(): array
+    {
+        return array_map(fn (ReflectionProperty $prop) => $prop->getName(), $this->properties);
+    }
+
+    public function filter(callable $callback): self
+    {
+        $filtered = array_filter($this->properties, $callback);
+
+        return new self(...array_values($filtered));
+    }
+
+    /**
+     * @return array<mixed>
+     */
+    public function map(callable $callback): array
+    {
+        return array_map($callback, $this->properties);
+    }
+}
diff --git a/src/Framework/Reflection/Contracts/AttributeReflector.php b/src/Framework/ReflectionLegacy/Contracts/AttributeReflector.php
similarity index 95%
rename from src/Framework/Reflection/Contracts/AttributeReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/AttributeReflector.php
index 09b5d663..a08cb6b4 100644
--- a/src/Framework/Reflection/Contracts/AttributeReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/AttributeReflector.php
@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
 
 /**
  * Interface for attribute-related reflection operations
diff --git a/src/Framework/Reflection/Contracts/CacheManager.php b/src/Framework/ReflectionLegacy/Contracts/CacheManager.php
similarity index 86%
rename from src/Framework/Reflection/Contracts/CacheManager.php
rename to src/Framework/ReflectionLegacy/Contracts/CacheManager.php
index 0604d2e0..9b4fb376 100644
--- a/src/Framework/Reflection/Contracts/CacheManager.php
+++ b/src/Framework/ReflectionLegacy/Contracts/CacheManager.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
diff --git a/src/Framework/Reflection/Contracts/ClassReflector.php b/src/Framework/ReflectionLegacy/Contracts/ClassReflector.php
similarity index 74%
rename from src/Framework/Reflection/Contracts/ClassReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/ClassReflector.php
index 0b5713d5..1f41f411 100644
--- a/src/Framework/Reflection/Contracts/ClassReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/ClassReflector.php
@@ -2,13 +2,13 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\PropertyCollection;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\MethodCollection;
+use App\Framework\ReflectionLegacy\Collections\PropertyCollection;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 use ReflectionClass;
 
 /**
diff --git a/src/Framework/Reflection/Contracts/EnumReflector.php b/src/Framework/ReflectionLegacy/Contracts/EnumReflector.php
similarity index 98%
rename from src/Framework/Reflection/Contracts/EnumReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/EnumReflector.php
index ae2788e9..52a8a805 100644
--- a/src/Framework/Reflection/Contracts/EnumReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/EnumReflector.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
 
diff --git a/src/Framework/Reflection/Contracts/InstantiationReflector.php b/src/Framework/ReflectionLegacy/Contracts/InstantiationReflector.php
similarity index 98%
rename from src/Framework/Reflection/Contracts/InstantiationReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/InstantiationReflector.php
index 395cec43..dea5ca71 100644
--- a/src/Framework/Reflection/Contracts/InstantiationReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/InstantiationReflector.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
 
diff --git a/src/Framework/Reflection/Contracts/MethodReflector.php b/src/Framework/ReflectionLegacy/Contracts/MethodReflector.php
similarity index 75%
rename from src/Framework/Reflection/Contracts/MethodReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/MethodReflector.php
index 50a9ff15..996b40d0 100644
--- a/src/Framework/Reflection/Contracts/MethodReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/MethodReflector.php
@@ -2,12 +2,12 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 use ReflectionMethod;
 
 /**
diff --git a/src/Framework/Reflection/Contracts/ParameterReflector.php b/src/Framework/ReflectionLegacy/Contracts/ParameterReflector.php
similarity index 97%
rename from src/Framework/Reflection/Contracts/ParameterReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/ParameterReflector.php
index 1e593ffe..1b4faea6 100644
--- a/src/Framework/Reflection/Contracts/ParameterReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/ParameterReflector.php
@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
 
 /**
  * Interface for parameter-related reflection operations
diff --git a/src/Framework/Reflection/Contracts/PropertyReflector.php b/src/Framework/ReflectionLegacy/Contracts/PropertyReflector.php
similarity index 95%
rename from src/Framework/Reflection/Contracts/PropertyReflector.php
rename to src/Framework/ReflectionLegacy/Contracts/PropertyReflector.php
index a40fd1ef..81542adc 100644
--- a/src/Framework/Reflection/Contracts/PropertyReflector.php
+++ b/src/Framework/ReflectionLegacy/Contracts/PropertyReflector.php
@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Collections\PropertyCollection;
+use App\Framework\ReflectionLegacy\Collections\PropertyCollection;
 
 /**
  * Interface for property-related reflection operations
diff --git a/src/Framework/Reflection/Contracts/ReflectionCache.php b/src/Framework/ReflectionLegacy/Contracts/ReflectionCache.php
similarity index 90%
rename from src/Framework/Reflection/Contracts/ReflectionCache.php
rename to src/Framework/ReflectionLegacy/Contracts/ReflectionCache.php
index c839b1e0..cfbceeb9 100644
--- a/src/Framework/Reflection/Contracts/ReflectionCache.php
+++ b/src/Framework/ReflectionLegacy/Contracts/ReflectionCache.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Contracts;
+namespace App\Framework\ReflectionLegacy\Contracts;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
diff --git a/src/Framework/Reflection/EVALUATION.md b/src/Framework/ReflectionLegacy/EVALUATION.md
similarity index 78%
rename from src/Framework/Reflection/EVALUATION.md
rename to src/Framework/ReflectionLegacy/EVALUATION.md
index 412c83d0..9e04b5ac 100644
--- a/src/Framework/Reflection/EVALUATION.md
+++ b/src/Framework/ReflectionLegacy/EVALUATION.md
@@ -22,16 +22,19 @@ Memory usage is primarily affected by:
 
 Performance characteristics of the module:
 
-- **Initial Reflection**: Slow (1-10ms per class)
-- **Cached Reflection**: Very fast (<0.1ms per operation)
-- **Batch Operations**: More efficient than individual operations (3-5x faster)
-- **Lazy Loading**: Significantly reduces initial overhead
+- **Initial Reflection**: Native PHP reflection is typically fast (microseconds to low milliseconds per class)
+- **Cached Reflection**: Very fast (<0.1ms per operation) for repeated access
+- **Memory Caching**: In-memory cache with LRU eviction prevents memory bloat
+
+**Note**: The actual performance benefit of caching depends on how frequently reflection operations are repeated. For one-off reflection operations, native PHP reflection is sufficient. The caching becomes valuable when:
+- The same classes are reflected multiple times during a request
+- Multiple requests benefit from metadata cache persistence
+- Framework bootstrap processes many classes
 
 Performance bottlenecks:
-1. Initial reflection of classes
-2. Large batch operations without proper pagination
+1. Initial reflection of classes (first access)
+2. Memory pressure causing cache eviction
 3. Excessive cache invalidation
-4. Memory pressure causing garbage collection
 
 ## Use Cases with Significant Value
 
@@ -47,7 +50,6 @@ The Reflection module provides significant value in these scenarios:
 ### 2. Dynamic Code Generation
 
 - **Proxy Generation**: Creating dynamic proxies for services
-- **Lazy Loading**: Implementing lazy loading for heavy objects
 - **Serialization**: Generating optimized serializers/deserializers
 
 ### 3. Plugin Systems
@@ -177,11 +179,13 @@ The specialized interfaces (ClassReflector, MethodReflector, etc.) allow you to
 
 ## Performance Benchmarks
 
+**Important**: These benchmarks are estimates and actual performance depends on many factors including class complexity, PHP version, and system resources.
+
 | Operation | First Run | Cached Run | Notes |
 |-----------|-----------|------------|-------|
-| Reflect Single Class | 5ms | 0.1ms | 50x improvement with cache |
-| Reflect 100 Classes | 500ms | 10ms | Batch operations help |
-| Get Method Parameters | 2ms | 0.05ms | 40x improvement with cache |
-| Process Attributes | 3ms | 0.08ms | Attribute instantiation adds overhead |
-| Create Instance | 1ms | 0.2ms | Less benefit from caching |
-| Full Framework Bootstrap | 800ms | 200ms | 75% reduction with proper caching |
+| Reflect Single Class | ~0.1-1ms | ~0.01ms | Significant improvement with cache for repeated access |
+| Get Method Parameters | ~0.05-0.5ms | ~0.01ms | Most benefit seen with repeated method parameter access |
+| Process Attributes | ~0.1-0.5ms | ~0.01ms | Attribute instantiation adds overhead |
+| Full Framework Bootstrap | Varies | Reduced | Depends on number of classes and cache hit rate |
+
+**Reality Check**: For typical request handling with 10-50 reflection calls, the total time difference between cached and uncached is typically <5ms, which is often negligible. The caching becomes more valuable during framework bootstrap when many classes are processed.
diff --git a/src/Framework/ReflectionLegacy/Factory/ReflectionCacheFactory.php b/src/Framework/ReflectionLegacy/Factory/ReflectionCacheFactory.php
index dcaf7b99..83a5aa7c 100644
--- a/src/Framework/ReflectionLegacy/Factory/ReflectionCacheFactory.php
+++ b/src/Framework/ReflectionLegacy/Factory/ReflectionCacheFactory.php
@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Factory;
+namespace App\Framework\ReflectionLegacy\Factory;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\AttributeCache;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Cache\MetadataCacheManager;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Cache\ParameterCache;
-use App\Framework\Reflection\ReflectionCache;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Cache\MetadataCacheManager;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\ReflectionCache;
 
 /**
  * Factory for creating and coordinating reflection caches with optimization
diff --git a/src/Framework/ReflectionLegacy/README.md b/src/Framework/ReflectionLegacy/README.md
new file mode 100644
index 00000000..213afea8
--- /dev/null
+++ b/src/Framework/ReflectionLegacy/README.md
@@ -0,0 +1,166 @@
+# ReflectionLegacy Module
+
+The ReflectionLegacy module provides a powerful, efficient, and developer-friendly API for PHP reflection operations. It enhances PHP's native reflection capabilities with caching and a clean interface.
+
+## Features
+
+- **Caching**: Dramatically improves performance for repeated reflection operations
+- **Interface Segregation**: Focused interfaces for specific reflection needs
+- **PHP 8.x Support**: Full support for attributes (PHP 8.0+) and enums (PHP 8.1+)
+- **Memory Optimization**: Advanced memory management to prevent leaks and reduce footprint
+- **Metadata Cache**: Optional persistent cache for class metadata across requests
+
+## Basic Usage
+
+```php
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+
+// Create a reflection provider
+$reflection = new CachedReflectionProvider();
+
+// Get information about a class
+$class = $reflection->getClass(ClassName::create(MyClass::class));
+
+// Check if a class has an attribute
+$hasAttribute = $reflection->hasAttribute(
+    ClassName::create(MyClass::class), 
+    MyAttribute::class
+);
+
+// Get method parameters
+$parameters = $reflection->getMethodParameters(
+    ClassName::create(MyClass::class), 
+    'myMethod'
+);
+
+// Create a new instance
+if ($reflection->isInstantiable(ClassName::create(MyClass::class))) {
+    $instance = $class->newInstance('arg1', 'arg2');
+}
+```
+
+## Advanced Usage
+
+### Processing Multiple Classes
+
+For processing multiple classes, simply iterate over them:
+
+```php
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+
+$reflection = new CachedReflectionProvider();
+
+// Get attributes for multiple classes
+$classes = [MyClass1::class, MyClass2::class, MyClass3::class];
+$attributes = [];
+
+foreach ($classes as $className) {
+    $classNameObj = ClassName::create($className);
+    $attributes[$className] = $reflection->getAttributes($classNameObj, RouteAttribute::class);
+}
+```
+
+### Working with Enums
+
+```php
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+
+$reflection = new CachedReflectionProvider();
+$enumClass = ClassName::create(StatusEnum::class);
+
+// Check if a class is an enum
+if ($reflection->isEnum($enumClass)) {
+    // Get all enum cases
+    $cases = $reflection->getEnumCases($enumClass);
+    
+    // Check if enum has a specific case
+    if ($reflection->hasEnumCase($enumClass, 'ACTIVE')) {
+        // Get the enum case
+        $case = $reflection->getEnumCase($enumClass, 'ACTIVE');
+    }
+    
+    // Check if enum is backed
+    if ($reflection->isBackedEnum($enumClass)) {
+        // Get backing type
+        $type = $reflection->getEnumBackingType($enumClass);
+        
+        // Get backing value for a case
+        $value = $reflection->getEnumCaseBackingValue($enumClass, 'ACTIVE');
+    }
+}
+```
+
+### Specialized Interfaces
+
+The module provides specialized interfaces for specific reflection needs:
+
+```php
+use App\Framework\ReflectionLegacy\Contracts\ClassReflector;
+use App\Framework\ReflectionLegacy\Contracts\MethodReflector;
+use App\Framework\ReflectionLegacy\Contracts\AttributeReflector;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+
+class MyService {
+    public function __construct(
+        // Only depend on what you need
+        private ClassReflector $classReflector,
+        private MethodReflector $methodReflector,
+        private AttributeReflector $attributeReflector
+    ) {}
+    
+    // Or use the complete implementation for all capabilities
+    public function withComplete(CachedReflectionProvider $reflection) {
+        // ...
+    }
+}
+```
+
+## Performance Considerations
+
+The ReflectionLegacy module is optimized for performance through in-memory caching. The caching mechanism automatically handles frequently accessed classes:
+
+- **Automatic Caching**: Frequently accessed classes are automatically cached
+- **Memory Management**: The cache uses LRU eviction to manage memory usage
+- **Metadata Cache**: Optional persistent metadata cache for cross-request persistence
+- **Memory Management**: Call `flush()` to clear the cache when done with a large batch
+
+See [EVALUATION.md](EVALUATION.md) for detailed performance analysis and recommendations.
+
+## When to Use
+
+The ReflectionLegacy module is ideal for:
+
+- Framework-level features that need to analyze many classes repeatedly
+- Applications that need efficient, repeated reflection operations
+- Code that benefits from automatic caching of reflection data
+- Projects that need a clean, type-safe reflection API
+
+For simpler use cases with occasional reflection needs, consider using PHP's native reflection API directly.
+
+## Module Structure
+
+- **Core Components**:
+  - `ReflectionProvider`: Main interface combining all reflection capabilities
+  - `CachedReflectionProvider`: Complete implementation with caching
+
+- **Specialized Interfaces**:
+  - `ClassReflector`: Class-level reflection operations
+  - `MethodReflector`: Method-level reflection operations
+  - `PropertyReflector`: Property-level reflection operations
+  - `ParameterReflector`: Parameter-level reflection operations
+  - `AttributeReflector`: Attribute-related reflection operations
+  - `EnumReflector`: Enum-related reflection operations (PHP 8.1+)
+  - `InstantiationReflector`: Instantiation-related reflection operations
+  - `CacheManager`: Cache management operations
+
+- **Performance Optimizations**:
+  - `ReflectionCache`: Coordinated caching for reflection data with LRU eviction
+  - `MetadataCacheManager`: Optional persistent metadata cache for cross-request persistence
+
+## Further Documentation
+
+- [EVALUATION.md](EVALUATION.md): Detailed analysis of the module's value and overhead
+- [SUMMARY.md](SUMMARY.md): Summary of module improvements and architecture decisions
diff --git a/src/Framework/Reflection/ReflectionCache.php b/src/Framework/ReflectionLegacy/ReflectionCache.php
similarity index 93%
rename from src/Framework/Reflection/ReflectionCache.php
rename to src/Framework/ReflectionLegacy/ReflectionCache.php
index bddda937..50b26fbd 100644
--- a/src/Framework/Reflection/ReflectionCache.php
+++ b/src/Framework/ReflectionLegacy/ReflectionCache.php
@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Core\ValueObjects\Statistics;
-use App\Framework\Reflection\Cache\AttributeCache;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Cache\MetadataCacheManager;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Cache\MetadataCacheManager;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
 
 /**
  * Facade for coordinating specialized reflection caches
diff --git a/src/Framework/ReflectionLegacy/ReflectionProvider.php b/src/Framework/ReflectionLegacy/ReflectionProvider.php
index b2134fa6..7514e565 100644
--- a/src/Framework/ReflectionLegacy/ReflectionProvider.php
+++ b/src/Framework/ReflectionLegacy/ReflectionProvider.php
@@ -2,16 +2,16 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
-use App\Framework\Reflection\Contracts\AttributeReflector;
-use App\Framework\Reflection\Contracts\CacheManager;
-use App\Framework\Reflection\Contracts\ClassReflector;
-use App\Framework\Reflection\Contracts\EnumReflector;
-use App\Framework\Reflection\Contracts\InstantiationReflector;
-use App\Framework\Reflection\Contracts\MethodReflector;
-use App\Framework\Reflection\Contracts\ParameterReflector;
-use App\Framework\Reflection\Contracts\PropertyReflector;
+use App\Framework\ReflectionLegacy\Contracts\AttributeReflector;
+use App\Framework\ReflectionLegacy\Contracts\CacheManager;
+use App\Framework\ReflectionLegacy\Contracts\ClassReflector;
+use App\Framework\ReflectionLegacy\Contracts\EnumReflector;
+use App\Framework\ReflectionLegacy\Contracts\InstantiationReflector;
+use App\Framework\ReflectionLegacy\Contracts\MethodReflector;
+use App\Framework\ReflectionLegacy\Contracts\ParameterReflector;
+use App\Framework\ReflectionLegacy\Contracts\PropertyReflector;
 
 /**
  * Main reflection provider interface combining all reflection capabilities
diff --git a/src/Framework/Reflection/SUMMARY.md b/src/Framework/ReflectionLegacy/SUMMARY.md
similarity index 100%
rename from src/Framework/Reflection/SUMMARY.md
rename to src/Framework/ReflectionLegacy/SUMMARY.md
diff --git a/src/Framework/Reflection/Support/AttributeHandler.php b/src/Framework/ReflectionLegacy/Support/AttributeHandler.php
similarity index 90%
rename from src/Framework/Reflection/Support/AttributeHandler.php
rename to src/Framework/ReflectionLegacy/Support/AttributeHandler.php
index 72653639..9b32e9ee 100644
--- a/src/Framework/Reflection/Support/AttributeHandler.php
+++ b/src/Framework/ReflectionLegacy/Support/AttributeHandler.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection\Support;
+namespace App\Framework\ReflectionLegacy\Support;
 
-use App\Framework\Reflection\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
 
 /**
  * Utility class for common attribute handling operations
diff --git a/src/Framework/ReflectionLegacy/WrappedReflectionAttribute.php b/src/Framework/ReflectionLegacy/WrappedReflectionAttribute.php
new file mode 100644
index 00000000..ff8fe82c
--- /dev/null
+++ b/src/Framework/ReflectionLegacy/WrappedReflectionAttribute.php
@@ -0,0 +1,171 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\ReflectionLegacy;
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use Attribute;
+
+final readonly class WrappedReflectionAttribute
+{
+    public function __construct(
+        private ClassName $className,
+        private ?string $methodName,
+        private string $attributeClass,
+        private int $index,
+        private AttributeCache $cache
+    ) {
+    }
+
+    public function getName(): string
+    {
+        // BUGFIX: Get the attribute name directly from the native attributes array using the correct index
+        $nativeAttributes = $this->methodName
+            ? $this->cache->getNativeMethodAttributes($this->className, $this->methodName, null)
+            : $this->cache->getNativeClassAttributes($this->className, null);
+
+        return isset($nativeAttributes[$this->index]) ? $nativeAttributes[$this->index]->getName() : '';
+    }
+
+    public function getShortName(): string
+    {
+        return $this->cache->getAttributeShortName($this->className, $this->methodName, $this->attributeClass, $this->index);
+    }
+
+    public function getTarget(): int
+    {
+        return $this->cache->getAttributeTarget($this->className, $this->methodName, $this->attributeClass, $this->index);
+    }
+
+    public function isRepeated(): bool
+    {
+        return $this->cache->isAttributeRepeated($this->className, $this->methodName, $this->attributeClass, $this->index);
+    }
+
+    /**
+     * @return array<mixed>
+     */
+    public function getArguments(): array
+    {
+        return $this->cache->getAttributeArguments($this->className, $this->methodName, $this->attributeClass, $this->index);
+    }
+
+    public function newInstance(): ?object
+    {
+        return $this->cache->getAttributeInstance($this->className, $this->methodName, $this->attributeClass, $this->index);
+    }
+
+    public function hasArguments(): bool
+    {
+        return ! empty($this->getArguments());
+    }
+
+    public function getArgumentCount(): int
+    {
+        return count($this->getArguments());
+    }
+
+    public function getArgument(int $index): mixed
+    {
+        $args = $this->getArguments();
+
+        return $args[$index] ?? null;
+    }
+
+    public function getFirstArgument(): mixed
+    {
+        return $this->getArgument(0);
+    }
+
+    /**
+     * Check if attribute targets class
+     */
+    public function targetsClass(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_CLASS) !== 0;
+    }
+
+    /**
+     * Check if attribute targets method
+     */
+    public function targetsMethod(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_METHOD) !== 0;
+    }
+
+    /**
+     * Check if attribute targets property
+     */
+    public function targetsProperty(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_PROPERTY) !== 0;
+    }
+
+    /**
+     * Check if attribute targets parameter
+     */
+    public function targetsParameter(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_PARAMETER) !== 0;
+    }
+
+    /**
+     * Check if attribute targets function
+     */
+    public function targetsFunction(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_FUNCTION) !== 0;
+    }
+
+    /**
+     * Check if attribute targets constant
+     */
+    public function targetsConstant(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_CLASS_CONSTANT) !== 0;
+    }
+
+    /**
+     * Check if attribute targets all
+     */
+    public function targetsAll(): bool
+    {
+        return ($this->getTarget() & Attribute::TARGET_ALL) !== 0;
+    }
+
+    /**
+     * Get instance with type checking
+     */
+    public function getInstanceOf(string $expectedClass): ?object
+    {
+        $instance = $this->newInstance();
+
+        return $instance instanceof $expectedClass ? $instance : null;
+    }
+
+    /**
+     * Check if instance is of specific type
+     */
+    public function isInstanceOf(string $className): bool
+    {
+        return $this->getName() === $className || is_subclass_of($this->getName(), $className);
+    }
+
+    /**
+     * Convert to array for debugging
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->getName(),
+            'shortName' => $this->getShortName(),
+            'target' => $this->getTarget(),
+            'isRepeated' => $this->isRepeated(),
+            'arguments' => $this->getArguments(),
+            'argumentCount' => $this->getArgumentCount(),
+        ];
+    }
+}
diff --git a/src/Framework/ReflectionLegacy/WrappedReflectionClass.php b/src/Framework/ReflectionLegacy/WrappedReflectionClass.php
index 985b2e35..ec4c58d2 100644
--- a/src/Framework/ReflectionLegacy/WrappedReflectionClass.php
+++ b/src/Framework/ReflectionLegacy/WrappedReflectionClass.php
@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\MethodCollection;
-use App\Framework\Reflection\Collections\PropertyCollection;
-use App\Framework\Reflection\Support\AttributeHandler;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\MethodCollection;
+use App\Framework\ReflectionLegacy\Collections\PropertyCollection;
+use App\Framework\ReflectionLegacy\Support\AttributeHandler;
 use ReflectionClass;
 
 final readonly class WrappedReflectionClass
diff --git a/src/Framework/ReflectionLegacy/WrappedReflectionMethod.php b/src/Framework/ReflectionLegacy/WrappedReflectionMethod.php
index e14bef25..3437cc34 100644
--- a/src/Framework/ReflectionLegacy/WrappedReflectionMethod.php
+++ b/src/Framework/ReflectionLegacy/WrappedReflectionMethod.php
@@ -2,13 +2,13 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Collections\AttributeCollection;
-use App\Framework\Reflection\Collections\ParameterCollection;
-use App\Framework\Reflection\Support\AttributeHandler;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Collections\ParameterCollection;
+use App\Framework\ReflectionLegacy\Support\AttributeHandler;
 
 final readonly class WrappedReflectionMethod
 {
diff --git a/src/Framework/Reflection/WrappedReflectionParameter.php b/src/Framework/ReflectionLegacy/WrappedReflectionParameter.php
similarity index 94%
rename from src/Framework/Reflection/WrappedReflectionParameter.php
rename to src/Framework/ReflectionLegacy/WrappedReflectionParameter.php
index 56be3fa4..e6dce3e5 100644
--- a/src/Framework/Reflection/WrappedReflectionParameter.php
+++ b/src/Framework/ReflectionLegacy/WrappedReflectionParameter.php
@@ -2,11 +2,11 @@
 
 declare(strict_types=1);
 
-namespace App\Framework\Reflection;
+namespace App\Framework\ReflectionLegacy;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\ParameterCache;
-use App\Framework\Reflection\Collections\AttributeCollection;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\Collections\AttributeCollection;
 use ReflectionType;
 
 final readonly class WrappedReflectionParameter
diff --git a/src/Framework/Router/AdminRoutes.php b/src/Framework/Router/AdminRoutes.php
index 7591e660..7415ce29 100644
--- a/src/Framework/Router/AdminRoutes.php
+++ b/src/Framework/Router/AdminRoutes.php
@@ -30,13 +30,38 @@ enum AdminRoutes: string implements RouteNameInterface
     case DEV_WAF_TEST = 'admin.dev.waf-test';
 
     // System
+    case SYSTEM_DASHBOARD = 'admin.system.dashboard';
     case SYSTEM_PERFORMANCE = 'admin.system.performance';
     case SYSTEM_HEALTH = 'admin.system.health';
     case SYSTEM_PHPINFO = 'admin.system.phpinfo';
     case SYSTEM_ENVIRONMENT = 'admin.system.environment';
 
+    // Notifications
+    case NOTIFICATIONS = 'admin.notifications';
+
+    // Machine Learning
     case ML_DASHBOARD = 'admin.ml.dashboard';
 
+    // Database
+    case DATABASE_BROWSER = 'admin.database.browser';
+    case DATABASE_TABLE = 'admin.database.table';
+
+    // Infrastructure
+    case INFRASTRUCTURE_LOGS = 'admin.infrastructure.logs';
+    case INFRASTRUCTURE_DOCKER = 'admin.infrastructure.docker';
+
+    // Development
+    case DEV_STYLEGUIDE = 'admin.dev.styleguide';
+
+    // Content
+    case CONTENT_IMAGE_SLOTS_LEGACY = 'admin.imageslots';
+
+    // Jobs
+    case JOBS_DASHBOARD = 'admin.jobs.dashboard';
+
+    // Deployment
+    case DEPLOYMENT_DASHBOARD = 'admin.deployment.dashboard';
+
     public function getCategory(): RouteCategory
     {
         return RouteCategory::ADMIN;
diff --git a/src/Framework/Router/ControllerRequestFactory.php b/src/Framework/Router/ControllerRequestFactory.php
index 3c5e330b..c2592dcc 100644
--- a/src/Framework/Router/ControllerRequestFactory.php
+++ b/src/Framework/Router/ControllerRequestFactory.php
@@ -7,8 +7,8 @@ namespace App\Framework\Router;
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Http\RequestBody;
-use App\Framework\Reflection\ReflectionProvider;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\Reflection\ClassInfo;
+use App\Framework\Reflection\ReflectionService;
 use App\Framework\Validation\Exceptions\ValidationException;
 use App\Framework\Validation\Validator;
 
@@ -17,22 +17,20 @@ final readonly class ControllerRequestFactory
     public function __construct(
         private DefaultContainer       $container,
         private PropertyValueConverter $propertyValueConverter,
-        private ReflectionProvider     $reflectionProvider
+        private ReflectionService      $reflectionService
     ) {
     }
 
     /**
      * Erstellt und validiert eine ControllerRequest-Instanz
      */
-    public function createAndValidate(WrappedReflectionClass $requestClass, RequestBody $data): object
+    public function createAndValidate(ClassInfo $requestClass, RequestBody $data): object
     {
-        // Native ReflectionClass für Instanziierung holen
-        $className = ClassName::create($requestClass->getName());
-
-        $class = $this->reflectionProvider->getClass($className);
+        // ClassName für Instanziierung holen
+        $className = $requestClass->getClassName();
 
         // Erst die Instanz erstellen
-        $instance = $class->newInstance();
+        $instance = $requestClass->newInstance();
 
         $properties = $requestClass->getProperties();
 
diff --git a/src/Framework/Router/Exception/RouteNotFound.php b/src/Framework/Router/Exception/RouteNotFound.php
index 8e452ec2..e6101767 100644
--- a/src/Framework/Router/Exception/RouteNotFound.php
+++ b/src/Framework/Router/Exception/RouteNotFound.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Router\Exception;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 use App\Framework\Http\Exception\HttpException;
 use App\Framework\Http\Status;
@@ -20,20 +19,11 @@ class RouteNotFound extends FrameworkException implements HttpException
 
     protected string $route;
 
-    /**
-     * @param array<string, mixed> $context
-     */
-    public function __construct(string $route, ?Throwable $previous = null, int $code = 0, array $context = [])
+    public function __construct(string $route, int $code = 0, ?\Throwable $previous = null)
     {
         $this->route = $route;
         $message = "Route not found: {$route}";
 
-        $exceptionContext = new ExceptionContext(
-            operation: 'route_resolution',
-            component: 'router',
-            data: array_merge(['route' => $route], $context)
-        );
-
-        parent::__construct($message, $exceptionContext, $code, $previous);
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/Router/Exceptions/ParameterResolutionException.php b/src/Framework/Router/Exceptions/ParameterResolutionException.php
index 59dbe02b..370ddf03 100644
--- a/src/Framework/Router/Exceptions/ParameterResolutionException.php
+++ b/src/Framework/Router/Exceptions/ParameterResolutionException.php
@@ -4,27 +4,12 @@ declare(strict_types=1);
 
 namespace App\Framework\Router\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class ParameterResolutionException extends FrameworkException
 {
-    /**
-     * @param string $message
-     * @param int $code
-     * @param \Throwable $previous
-     */
     public function __construct(string $message, int $code = 0, ?\Throwable $previous = null)
     {
-        parent::__construct(
-            message: $message,
-            context: ExceptionContext::forOperation('parameter_resolution', 'Router')
-                ->withData([
-                    'error_type' => 'parameter_resolution_failed',
-                    'previous_error' => $previous?->getMessage(),
-                ]),
-            code: $code,
-            previous: $previous
-        );
+        parent::__construct($message, $code, $previous);
     }
 }
diff --git a/src/Framework/Router/Exceptions/UnknownResultException.php b/src/Framework/Router/Exceptions/UnknownResultException.php
index de24f08d..29857309 100644
--- a/src/Framework/Router/Exceptions/UnknownResultException.php
+++ b/src/Framework/Router/Exceptions/UnknownResultException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Router\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class UnknownResultException extends FrameworkException
@@ -15,11 +14,9 @@ final class UnknownResultException extends FrameworkException
         ?\Throwable $previous = null
     ) {
         parent::__construct(
-            message: 'Unbekanntes Ergebnisobjekt: ' . $resultClass,
-            context: ExceptionContext::forOperation('result_processing', 'Router')
-                ->withData(['resultClass' => $resultClass]),
-            code: $code,
-            previous: $previous
+            'Unbekanntes Ergebnisobjekt: ' . $resultClass,
+            $code,
+            $previous
         );
     }
 }
diff --git a/src/Framework/Router/ParameterProcessor.php b/src/Framework/Router/ParameterProcessor.php
index 5c738a09..256c1d4f 100644
--- a/src/Framework/Router/ParameterProcessor.php
+++ b/src/Framework/Router/ParameterProcessor.php
@@ -9,7 +9,8 @@ use App\Framework\DI\DefaultContainer;
 use App\Framework\Http\ControllerRequest;
 use App\Framework\Http\Request;
 use App\Framework\Logging\DefaultLogger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\Logging\ValueObjects\LogContext;
+use App\Framework\Reflection\ReflectionService;
 use App\Framework\Router\Exceptions\ParameterResolutionException;
 use App\Framework\Router\ValueObjects\MethodParameter;
 use App\Framework\Router\ValueObjects\ParameterCollection;
@@ -24,7 +25,7 @@ final readonly class ParameterProcessor
         private DefaultContainer         $container,
         private ControllerRequestFactory $controllerRequestFactory,
         private DefaultLogger            $logger,
-        private ReflectionProvider       $reflectionProvider,
+        private ReflectionService        $reflectionService,
         private TypeCasterRegistry       $typeCasterRegistry
     ) {
     }
@@ -93,11 +94,11 @@ final readonly class ParameterProcessor
             try {
                 $parameters[] = $this->resolveTypedParameter($parameter, $queryParams);
             } catch (\Throwable $e) {
-                $this->logger?->error("Parameter preparation failed", [
+                $this->logger->error("Parameter preparation failed", LogContext::withData([
                     'parameter' => $parameter->name,
                     'type' => $parameter->type,
                     'error' => $e->getMessage(),
-                ]);
+                ]));
 
                 throw $e;
             }
@@ -190,7 +191,7 @@ final readonly class ParameterProcessor
     private function isControllerRequestType(string $type): bool
     {
         try {
-            return $this->reflectionProvider->implementsInterface(
+            return $this->reflectionService->implementsInterface(
                 ClassName::create($type),
                 ControllerRequest::class
             );
@@ -208,9 +209,9 @@ final readonly class ParameterProcessor
             $request = $this->container->get(Request::class);
             $parsedBody = $request->parsedBody;
 
-            $reflectionClass = $this->reflectionProvider->getClass(ClassName::create($type));
+            $classInfo = $this->reflectionService->reflectClass(ClassName::create($type));
             $controllerRequest = $this->controllerRequestFactory->createAndValidate(
-                $reflectionClass,
+                $classInfo,
                 $parsedBody
             );
 
diff --git a/src/Framework/Router/ValueObjects/MethodParameter.php b/src/Framework/Router/ValueObjects/MethodParameter.php
index 1d53b569..e67506ab 100644
--- a/src/Framework/Router/ValueObjects/MethodParameter.php
+++ b/src/Framework/Router/ValueObjects/MethodParameter.php
@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Framework\Router\ValueObjects;
 
-use App\Framework\Reflection\WrappedReflectionParameter;
+use App\Framework\ReflectionLegacy\WrappedReflectionParameter;
 
 /**
  * Type-safe representation of a method parameter
diff --git a/src/Framework/Sockets/Exceptions/SocketBindException.php b/src/Framework/Sockets/Exceptions/SocketBindException.php
new file mode 100644
index 00000000..4b3df519
--- /dev/null
+++ b/src/Framework/Sockets/Exceptions/SocketBindException.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+/**
+ * Exception thrown when socket binding fails
+ */
+final class SocketBindException extends SocketException
+{
+    public static function create(SocketAddress $address, ?int $errorCode = null): self
+    {
+        $code = $errorCode ?? socket_last_error();
+        $error = socket_strerror($code);
+
+        return new self(
+            "Failed to bind socket to {$address}: {$error} (code: {$code})",
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/Exceptions/SocketConnectException.php b/src/Framework/Sockets/Exceptions/SocketConnectException.php
new file mode 100644
index 00000000..b32d0b02
--- /dev/null
+++ b/src/Framework/Sockets/Exceptions/SocketConnectException.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+/**
+ * Exception thrown when socket connection fails
+ */
+final class SocketConnectException extends SocketException
+{
+    public static function create(SocketAddress $address, ?int $errorCode = null): self
+    {
+        $code = $errorCode ?? socket_last_error();
+        $error = socket_strerror($code);
+
+        return new self(
+            "Failed to connect to {$address}: {$error} (code: {$code})",
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/Exceptions/SocketException.php b/src/Framework/Sockets/Exceptions/SocketException.php
new file mode 100644
index 00000000..6f4d2f81
--- /dev/null
+++ b/src/Framework/Sockets/Exceptions/SocketException.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+use App\Framework\Exception\FrameworkException;
+
+/**
+ * Base exception for Socket-related errors
+ */
+class SocketException extends FrameworkException
+{
+    public static function extensionNotAvailable(): self
+    {
+        return new self(
+            'Sockets extension is not available',
+            (int) SystemErrorCode::DEPENDENCY_MISSING->value
+        );
+    }
+
+    public static function operationFailed(string $operation, ?string $reason = null): self
+    {
+        $message = "Socket operation '{$operation}' failed";
+        if ($reason !== null) {
+            $message .= ": {$reason}";
+        }
+
+        return new self(
+            $message,
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function fromSocketError(?int $errorCode = null, ?string $operation = null): self
+    {
+        $code = $errorCode ?? socket_last_error();
+        $error = socket_strerror($code);
+        $operation = $operation ?? 'socket operation';
+
+        return new self(
+            "{$operation} failed: {$error} (code: {$code})",
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/Exceptions/SocketListenException.php b/src/Framework/Sockets/Exceptions/SocketListenException.php
new file mode 100644
index 00000000..c058751b
--- /dev/null
+++ b/src/Framework/Sockets/Exceptions/SocketListenException.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+
+/**
+ * Exception thrown when socket listen fails
+ */
+final class SocketListenException extends SocketException
+{
+    public static function create(int $backlog, ?int $errorCode = null): self
+    {
+        $code = $errorCode ?? socket_last_error();
+        $error = socket_strerror($code);
+
+        return new self(
+            "Failed to listen on socket with backlog {$backlog}: {$error} (code: {$code})",
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/Exceptions/SocketReadException.php b/src/Framework/Sockets/Exceptions/SocketReadException.php
new file mode 100644
index 00000000..808a6520
--- /dev/null
+++ b/src/Framework/Sockets/Exceptions/SocketReadException.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Exceptions;
+
+use App\Framework\Exception\Core\SystemErrorCode;
+
+/**
+ * Exception thrown when socket read fails
+ */
+final class SocketReadException extends SocketException
+{
+    public static function create(int $length, ?int $errorCode = null): self
+    {
+        $code = $errorCode ?? socket_last_error();
+        $error = socket_strerror($code);
+
+        return new self(
+            "Failed to read {$length} bytes from socket: {$error} (code: {$code})",
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+
+    public static function connectionClosed(): self
+    {
+        return new self(
+            'Socket connection closed',
+            (int) SystemErrorCode::INITIALIZATION_FAILED->value
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/Integration/AsyncSocketServer.php b/src/Framework/Sockets/Integration/AsyncSocketServer.php
new file mode 100644
index 00000000..2d0dfdec
--- /dev/null
+++ b/src/Framework/Sockets/Integration/AsyncSocketServer.php
@@ -0,0 +1,154 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Integration;
+
+use App\Framework\Async\FiberManager;
+use App\Framework\Sockets\SocketConnection;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+use Fiber;
+
+/**
+ * Async Socket Server
+ *
+ * Non-blocking socket server using Fibers.
+ * Enables parallel connection handling with cooperative multitasking.
+ */
+final readonly class AsyncSocketServer
+{
+    public function __construct(
+        private SocketService $socketService,
+        private FiberManager $fiberManager
+    ) {
+    }
+
+    /**
+     * Start async socket server
+     *
+     * @param SocketResource $socket Server socket
+     * @param SocketAddress $address Address to bind to
+     * @param callable $connectionHandler Handler for each connection
+     * @return Fiber Fiber running the server
+     */
+    public function startAsync(
+        SocketResource $socket,
+        SocketAddress $address,
+        callable $connectionHandler
+    ): Fiber {
+        return $this->fiberManager->async(function () use ($socket, $address, $connectionHandler) {
+            // Bind and listen
+            $this->socketService->bind($socket, $address);
+            $this->socketService->listen($socket, 100);
+            $this->socketService->setNonBlocking($socket);
+
+            $running = true;
+            $connections = [];
+
+            while ($running) {
+                // Accept new connections
+                $connection = $this->socketService->accept($socket);
+                if ($connection !== null) {
+                    // Handle connection in separate fiber
+                    $fiber = $this->fiberManager->async(function () use ($connection, $connectionHandler) {
+                        try {
+                            ($connectionHandler)($connection);
+                        } catch (\Throwable $e) {
+                            error_log("Async socket connection handler error: {$e->getMessage()}");
+                        } finally {
+                            $connection->close();
+                        }
+                    });
+
+                    $connections[$connection->getConnectionId()] = $fiber;
+                }
+
+                // Cleanup completed connections
+                foreach ($connections as $connectionId => $fiber) {
+                    if ($fiber->isTerminated()) {
+                        unset($connections[$connectionId]);
+                    }
+                }
+
+                // Yield to allow other fibers to run
+                Fiber::suspend();
+            }
+
+            // Wait for all connections to complete
+            foreach ($connections as $fiber) {
+                if (!$fiber->isTerminated()) {
+                    try {
+                        $fiber->getReturn();
+                    } catch (\Throwable $e) {
+                        // Ignore errors
+                    }
+                }
+            }
+        });
+    }
+
+    /**
+     * Handle connection asynchronously
+     *
+     * @param SocketConnection $connection Connection to handle
+     * @param callable $handler Handler function
+     * @return Fiber Fiber handling the connection
+     */
+    public function handleConnectionAsync(SocketConnection $connection, callable $handler): Fiber
+    {
+        return $this->fiberManager->async(function () use ($connection, $handler) {
+            try {
+                ($handler)($connection);
+            } catch (\Throwable $e) {
+                error_log("Async connection handler error: {$e->getMessage()}");
+                throw $e;
+            } finally {
+                $connection->close();
+            }
+        });
+    }
+
+    /**
+     * Read from socket asynchronously
+     *
+     * @param SocketConnection $connection Connection to read from
+     * @param int $length Bytes to read
+     * @return Fiber Fiber that will yield the data
+     */
+    public function readAsync(SocketConnection $connection, int $length): Fiber
+    {
+        return $this->fiberManager->async(function () use ($connection, $length) {
+            $socket = $connection->getSocket();
+            $this->socketService->setNonBlocking($socket);
+
+            while (true) {
+                $data = $this->socketService->read($socket, $length);
+
+                if ($data !== null) {
+                    return $data;
+                }
+
+                // No data available, yield and try again
+                Fiber::suspend();
+            }
+        });
+    }
+
+    /**
+     * Write to socket asynchronously
+     *
+     * @param SocketConnection $connection Connection to write to
+     * @param string $data Data to write
+     * @return Fiber Fiber that will yield bytes written
+     */
+    public function writeAsync(SocketConnection $connection, string $data): Fiber
+    {
+        return $this->fiberManager->async(function () use ($connection, $data) {
+            $socket = $connection->getSocket();
+            return $this->socketService->write($socket, $data);
+        });
+    }
+}
+
diff --git a/src/Framework/Sockets/Integration/PcntlSocketServer.php b/src/Framework/Sockets/Integration/PcntlSocketServer.php
new file mode 100644
index 00000000..7a03dd27
--- /dev/null
+++ b/src/Framework/Sockets/Integration/PcntlSocketServer.php
@@ -0,0 +1,249 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\Integration;
+
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Pcntl\ValueObjects\Signal;
+use App\Framework\Sockets\SocketConnection;
+use App\Framework\Sockets\SocketService;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+/**
+ * PCNTL Socket Server
+ *
+ * Socket server running in forked worker processes.
+ * Provides load balancing and graceful shutdown.
+ */
+final class PcntlSocketServer
+{
+    /** @var array<int, array{pid: int, socket: SocketResource, started: float}> */
+    private array $workers = [];
+
+    private bool $running = false;
+
+    /** @var callable|null Connection handler function */
+    private $connectionHandler = null;
+
+    private SocketResource $mainSocket;
+
+    public function __construct(
+        private readonly SocketService $socketService,
+        private readonly PcntlService $pcntlService,
+        private readonly int $maxWorkers = 4,
+        private readonly int $maxRestartsPerWorker = 10
+    ) {
+    }
+
+    /**
+     * Set connection handler function
+     */
+    public function setConnectionHandler(callable $handler): void
+    {
+        $this->connectionHandler = $handler;
+    }
+
+    /**
+     * Start socket server with worker processes
+     */
+    public function start(SocketResource $socket, SocketAddress $address, int $workerCount): void
+    {
+        if ($this->running) {
+            return;
+        }
+
+        if ($this->connectionHandler === null) {
+            throw new \RuntimeException('Connection handler not set. Call setConnectionHandler() first.');
+        }
+
+        $workerCount = min($workerCount, $this->maxWorkers);
+        $this->mainSocket = $socket;
+
+        // Bind and listen
+        $this->socketService->bind($socket, $address);
+        $this->socketService->listen($socket, 100);
+
+        $this->running = true;
+
+        // Register signal handlers for graceful shutdown
+        $this->setupSignalHandlers();
+
+        // Fork worker processes
+        for ($i = 0; $i < $workerCount; $i++) {
+            $this->startWorker();
+        }
+
+        // Parent process: monitor workers
+        $this->monitorWorkers();
+    }
+
+    /**
+     * Stop all worker processes
+     */
+    public function stop(): void
+    {
+        if (!$this->running) {
+            return;
+        }
+
+        $this->running = false;
+
+        // Send SIGTERM to all workers
+        foreach ($this->workers as $worker) {
+            try {
+                $this->pcntlService->sendSignal($worker['pid'], Signal::SIGTERM);
+            } catch (\Throwable $e) {
+                error_log("Error stopping worker {$worker['pid']}: {$e->getMessage()}");
+            }
+        }
+
+        // Wait for all workers to terminate
+        $this->waitForAllWorkers();
+    }
+
+    /**
+     * Start a single worker process
+     */
+    private function startWorker(): void
+    {
+        $forkResult = $this->pcntlService->fork();
+
+        if ($forkResult->isError()) {
+            throw new \RuntimeException('Failed to fork worker process');
+        }
+
+        if ($forkResult->isChild()) {
+            // Child process: handle connections
+            $this->runWorker();
+            exit(0);
+        }
+
+        // Parent process: track worker
+        $childPid = $forkResult->getChildPid();
+
+        $this->workers[$childPid->toInt()] = [
+            'pid' => $childPid->toInt(),
+            'socket' => $this->mainSocket,
+            'started' => microtime(true),
+        ];
+    }
+
+    /**
+     * Run worker in child process
+     */
+    private function runWorker(): void
+    {
+        while ($this->running) {
+            // Accept connection (non-blocking)
+            $connection = $this->socketService->accept($this->mainSocket);
+
+            if ($connection !== null) {
+                // Handle connection
+                try {
+                    ($this->connectionHandler)($connection);
+                } catch (\Throwable $e) {
+                    error_log("Worker connection handler error: {$e->getMessage()}");
+                    $connection->close();
+                }
+            }
+
+            // Small sleep to prevent CPU spinning
+            usleep(10000); // 10ms
+        }
+    }
+
+    /**
+     * Monitor worker processes
+     */
+    private function monitorWorkers(): void
+    {
+        while ($this->running) {
+            // Check for terminated workers
+            $status = $this->pcntlService->waitNonBlocking();
+            if ($status !== null) {
+                $pid = $status->getProcessId()->toInt();
+                $this->handleWorkerTerminated($pid, $status);
+            }
+
+            // Dispatch signals
+            $this->pcntlService->dispatchSignals();
+
+            // Maintain worker count
+            $this->maintainWorkerCount();
+
+            // Small sleep
+            usleep(100000); // 100ms
+        }
+    }
+
+    /**
+     * Handle worker termination
+     */
+    private function handleWorkerTerminated(int $pid, \App\Framework\Pcntl\ValueObjects\ProcessStatus $status): void
+    {
+        if (!isset($this->workers[$pid])) {
+            return;
+        }
+
+        unset($this->workers[$pid]);
+
+        if (!$this->running) {
+            return;
+        }
+
+        // Restart worker if pool is still running
+        if ($this->running) {
+            $this->startWorker();
+        }
+    }
+
+    /**
+     * Maintain worker count
+     */
+    private function maintainWorkerCount(): void
+    {
+        $currentCount = count($this->workers);
+        $targetCount = $this->maxWorkers;
+
+        if ($currentCount < $targetCount && $this->running) {
+            for ($i = $currentCount; $i < $targetCount; $i++) {
+                $this->startWorker();
+            }
+        }
+    }
+
+    /**
+     * Setup signal handlers
+     */
+    private function setupSignalHandlers(): void
+    {
+        $this->pcntlService->registerSignal(Signal::SIGTERM, function () {
+            $this->stop();
+        });
+
+        $this->pcntlService->registerSignal(Signal::SIGINT, function () {
+            $this->stop();
+        });
+    }
+
+    /**
+     * Wait for all workers to terminate
+     */
+    private function waitForAllWorkers(): void
+    {
+        while (!empty($this->workers)) {
+            try {
+                $status = $this->pcntlService->wait();
+                $pid = $status->getProcessId()->toInt();
+                if (isset($this->workers[$pid])) {
+                    unset($this->workers[$pid]);
+                }
+            } catch (\Throwable $e) {
+                break;
+            }
+        }
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketClient.php b/src/Framework/Sockets/SocketClient.php
new file mode 100644
index 00000000..fa5b39e0
--- /dev/null
+++ b/src/Framework/Sockets/SocketClient.php
@@ -0,0 +1,181 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\Exceptions\SocketConnectException;
+use App\Framework\Sockets\Exceptions\SocketException;
+use App\Framework\Sockets\Exceptions\SocketReadException;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+/**
+ * Socket Client Service
+ *
+ * Provides client socket operations: connect, read, write, close.
+ */
+final readonly class SocketClient
+{
+    /**
+     * Connect socket to address
+     */
+    public function connect(SocketResource $socket, SocketAddress $address): void
+    {
+        $resource = $socket->getResource();
+
+        if ($address->isUnixSocket()) {
+            $path = $address->getUnixPath();
+            if ($path === null) {
+                throw new \InvalidArgumentException('Unix socket path is required');
+            }
+
+            $result = @socket_connect($resource, $path);
+        } else {
+            $host = $address->getHost();
+            $port = $address->getPort();
+            if ($host === null || $port === null) {
+                throw new \InvalidArgumentException('Host and port are required for network sockets');
+            }
+
+            $result = @socket_connect($resource, $host, $port);
+        }
+
+        if ($result === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            // EINPROGRESS is OK for non-blocking sockets
+            if ($errorCode !== SOCKET_EINPROGRESS) {
+                throw SocketConnectException::create($address, $errorCode);
+            }
+        }
+    }
+
+    /**
+     * Read data from socket
+     *
+     * @param SocketResource $socket Socket to read from
+     * @param int $length Maximum bytes to read
+     * @return string|null Data read, null if no data available (non-blocking), empty string if connection closed
+     */
+    public function read(SocketResource $socket, int $length): ?string
+    {
+        $resource = $socket->getResource();
+        $data = @socket_read($resource, $length, PHP_BINARY_READ);
+
+        if ($data === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            // EAGAIN/EWOULDBLOCK means no data available (non-blocking)
+            if ($errorCode === SOCKET_EAGAIN || $errorCode === SOCKET_EWOULDBLOCK) {
+                return null;
+            }
+
+            // Connection closed
+            if ($errorCode === 0 || $errorCode === SOCKET_ECONNRESET) {
+                throw SocketReadException::connectionClosed();
+            }
+
+            throw SocketReadException::create($length, $errorCode);
+        }
+
+        // Empty string means connection closed
+        if ($data === '') {
+            throw SocketReadException::connectionClosed();
+        }
+
+        return $data;
+    }
+
+    /**
+     * Write data to socket
+     *
+     * @param SocketResource $socket Socket to write to
+     * @param string $data Data to write
+     * @return int Number of bytes written
+     */
+    public function write(SocketResource $socket, string $data): int
+    {
+        $resource = $socket->getResource();
+        $length = strlen($data);
+        $written = @socket_write($resource, $data, $length);
+
+        if ($written === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            throw SocketException::fromSocketError($errorCode, 'socket_write');
+        }
+
+        return $written;
+    }
+
+    /**
+     * Send data to socket (alias for write)
+     */
+    public function send(SocketResource $socket, string $data, int $flags = 0): int
+    {
+        $resource = $socket->getResource();
+        $length = strlen($data);
+        $sent = @socket_send($resource, $data, $length, $flags);
+
+        if ($sent === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            throw SocketException::fromSocketError($errorCode, 'socket_send');
+        }
+
+        return $sent;
+    }
+
+    /**
+     * Receive data from socket
+     *
+     * @param SocketResource $socket Socket to receive from
+     * @param int $length Maximum bytes to receive
+     * @param int $flags Flags for socket_recv
+     * @return string|null Data received, null if no data available (non-blocking)
+     */
+    public function receive(SocketResource $socket, int $length, int $flags = 0): ?string
+    {
+        $resource = $socket->getResource();
+        $data = '';
+        $received = @socket_recv($resource, $data, $length, $flags);
+
+        if ($received === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            // EAGAIN/EWOULDBLOCK means no data available (non-blocking)
+            if ($errorCode === SOCKET_EAGAIN || $errorCode === SOCKET_EWOULDBLOCK) {
+                return null;
+            }
+
+            // Connection closed
+            if ($errorCode === 0 || $errorCode === SOCKET_ECONNRESET) {
+                throw SocketReadException::connectionClosed();
+            }
+
+            throw SocketReadException::create($length, $errorCode);
+        }
+
+        // 0 bytes means connection closed
+        if ($received === 0) {
+            throw SocketReadException::connectionClosed();
+        }
+
+        return $data;
+    }
+
+    /**
+     * Close socket
+     */
+    public function close(SocketResource $socket): void
+    {
+        $socket->close();
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketConnection.php b/src/Framework/Sockets/SocketConnection.php
new file mode 100644
index 00000000..810d4e8e
--- /dev/null
+++ b/src/Framework/Sockets/SocketConnection.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+/**
+ * Socket Connection Wrapper
+ *
+ * Represents a connection to a socket (client or accepted server connection).
+ */
+final readonly class SocketConnection
+{
+    public function __construct(
+        private SocketResource $socket,
+        private SocketAddress $address,
+        private string $connectionId
+    ) {
+    }
+
+    public static function create(SocketResource $socket, SocketAddress $address): self
+    {
+        return new self(
+            $socket,
+            $address,
+            connectionId: uniqid('socket_', true)
+        );
+    }
+
+    public function getSocket(): SocketResource
+    {
+        return $this->socket;
+    }
+
+    public function getAddress(): SocketAddress
+    {
+        return $this->address;
+    }
+
+    public function getConnectionId(): string
+    {
+        return $this->connectionId;
+    }
+
+    public function isClosed(): bool
+    {
+        return $this->socket->isClosed();
+    }
+
+    public function close(): void
+    {
+        $this->socket->close();
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->connectionId === $other->connectionId;
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketConnectionPool.php b/src/Framework/Sockets/SocketConnectionPool.php
new file mode 100644
index 00000000..1457f3a4
--- /dev/null
+++ b/src/Framework/Sockets/SocketConnectionPool.php
@@ -0,0 +1,188 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+
+/**
+ * Socket Connection Pool
+ *
+ * Manages socket connections with lifecycle management,
+ * connection reuse, and dead connection cleanup.
+ */
+final class SocketConnectionPool
+{
+    /** @var array<string, SocketConnection> Connections indexed by connection ID */
+    private array $connections = [];
+
+    /** @var array<string, SocketAddress> Address to connection ID mapping */
+    private array $addressMap = [];
+
+    private int $maxConnections = 1000;
+
+    public function __construct(
+        private readonly int $maxConnectionsPerAddress = 5,
+        private readonly int $connectionTimeoutSeconds = 300
+    ) {
+    }
+
+    /**
+     * Add connection to pool
+     */
+    public function add(SocketConnection $connection): void
+    {
+        if (count($this->connections) >= $this->maxConnections) {
+            throw new \RuntimeException("Maximum connection limit ({$this->maxConnections}) reached");
+        }
+
+        $address = $connection->getAddress();
+        $addressKey = $address->toString();
+
+        // Check per-address connection limit
+        $addressConnections = $this->getConnectionsByAddress($address);
+        if (count($addressConnections) >= $this->maxConnectionsPerAddress) {
+            throw new \RuntimeException("Maximum connections per address limit ({$this->maxConnectionsPerAddress}) reached for {$addressKey}");
+        }
+
+        $connectionId = $connection->getConnectionId();
+        $this->connections[$connectionId] = $connection;
+        $this->addressMap[$addressKey][] = $connectionId;
+    }
+
+    /**
+     * Remove connection from pool
+     */
+    public function remove(SocketConnection $connection): void
+    {
+        $connectionId = $connection->getConnectionId();
+        $address = $connection->getAddress();
+        $addressKey = $address->toString();
+
+        if (isset($this->connections[$connectionId])) {
+            unset($this->connections[$connectionId]);
+        }
+
+        if (isset($this->addressMap[$addressKey])) {
+            $this->addressMap[$addressKey] = array_filter(
+                $this->addressMap[$addressKey],
+                fn($id) => $id !== $connectionId
+            );
+
+            if (empty($this->addressMap[$addressKey])) {
+                unset($this->addressMap[$addressKey]);
+            }
+        }
+
+        $connection->close();
+    }
+
+    /**
+     * Get connection by ID
+     */
+    public function get(string $connectionId): ?SocketConnection
+    {
+        return $this->connections[$connectionId] ?? null;
+    }
+
+    /**
+     * Get connections by address
+     *
+     * @return array<SocketConnection>
+     */
+    public function getConnectionsByAddress(SocketAddress $address): array
+    {
+        $addressKey = $address->toString();
+        $connectionIds = $this->addressMap[$addressKey] ?? [];
+
+        $connections = [];
+        foreach ($connectionIds as $connectionId) {
+            if (isset($this->connections[$connectionId])) {
+                $connections[] = $this->connections[$connectionId];
+            }
+        }
+
+        return $connections;
+    }
+
+    /**
+     * Get first available connection for address
+     */
+    public function getConnectionForAddress(SocketAddress $address): ?SocketConnection
+    {
+        $connections = $this->getConnectionsByAddress($address);
+
+        foreach ($connections as $connection) {
+            if (!$connection->isClosed()) {
+                return $connection;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Cleanup dead connections
+     *
+     * @return int Number of connections removed
+     */
+    public function cleanupDeadConnections(): int
+    {
+        $removed = 0;
+        $toRemove = [];
+
+        foreach ($this->connections as $connection) {
+            if ($connection->isClosed()) {
+                $toRemove[] = $connection;
+            }
+        }
+
+        foreach ($toRemove as $connection) {
+            $this->remove($connection);
+            $removed++;
+        }
+
+        return $removed;
+    }
+
+    /**
+     * Get all connections
+     *
+     * @return array<SocketConnection>
+     */
+    public function getAllConnections(): array
+    {
+        return array_values($this->connections);
+    }
+
+    /**
+     * Get connection count
+     */
+    public function getConnectionCount(): int
+    {
+        return count($this->connections);
+    }
+
+    /**
+     * Clear all connections
+     */
+    public function clear(): void
+    {
+        foreach ($this->connections as $connection) {
+            $connection->close();
+        }
+
+        $this->connections = [];
+        $this->addressMap = [];
+    }
+
+    /**
+     * Set maximum connections
+     */
+    public function setMaxConnections(int $max): void
+    {
+        $this->maxConnections = $max;
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketFactory.php b/src/Framework/Sockets/SocketFactory.php
new file mode 100644
index 00000000..67832549
--- /dev/null
+++ b/src/Framework/Sockets/SocketFactory.php
@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\Exceptions\SocketException;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+use App\Framework\Sockets\ValueObjects\SocketType;
+
+/**
+ * Socket Factory Service
+ *
+ * Provides type-safe socket creation with automatic option setup.
+ */
+final readonly class SocketFactory
+{
+    /**
+     * Create TCP socket
+     */
+    public function createTcp(SocketAddress $address): SocketResource
+    {
+        return $this->createServer(SocketType::TCP, $address->getProtocol());
+    }
+
+    /**
+     * Create UDP socket
+     */
+    public function createUdp(SocketAddress $address): SocketResource
+    {
+        return $this->createServer(SocketType::UDP, $address->getProtocol());
+    }
+
+    /**
+     * Create Unix Domain Socket
+     */
+    public function createUnix(SocketAddress $address): SocketResource
+    {
+        if (!$address->isUnixSocket()) {
+            throw new \InvalidArgumentException('Address must be a Unix socket path');
+        }
+
+        return $this->createServer(SocketType::TCP, SocketProtocol::UNIX);
+    }
+
+    /**
+     * Create server socket
+     */
+    public function createServer(SocketType $type, SocketProtocol $protocol): SocketResource
+    {
+        if (!extension_loaded('sockets')) {
+            throw SocketException::extensionNotAvailable();
+        }
+
+        $socket = @socket_create($protocol->getValue(), $type->getValue(), $this->getProtocolNumber($type));
+
+        if ($socket === false) {
+            throw SocketException::fromSocketError(null, 'socket_create');
+        }
+
+        // Set common server options
+        $this->setServerOptions($socket);
+
+        return SocketResource::fromResource($socket, $type, $protocol);
+    }
+
+    /**
+     * Create client socket
+     */
+    public function createClient(SocketType $type, SocketProtocol $protocol): SocketResource
+    {
+        if (!extension_loaded('sockets')) {
+            throw SocketException::extensionNotAvailable();
+        }
+
+        $socket = @socket_create($protocol->getValue(), $type->getValue(), $this->getProtocolNumber($type));
+
+        if ($socket === false) {
+            throw SocketException::fromSocketError(null, 'socket_create');
+        }
+
+        // Set common client options
+        $this->setClientOptions($socket, $type);
+
+        return SocketResource::fromResource($socket, $type, $protocol);
+    }
+
+    /**
+     * Set common server socket options
+     */
+    private function setServerOptions($socket): void
+    {
+        // Enable address reuse
+        @socket_set_option($socket, SOL_SOCKET, SO_REUSEADDR, 1);
+
+        // Enable port reuse if available (Linux)
+        if (defined('SO_REUSEPORT')) {
+            @socket_set_option($socket, SOL_SOCKET, SO_REUSEPORT, 1);
+        }
+    }
+
+    /**
+     * Set common client socket options
+     */
+    private function setClientOptions($socket, SocketType $type): void
+    {
+        // TCP_NODELAY for TCP sockets
+        if ($type === SocketType::TCP && defined('TCP_NODELAY')) {
+            @socket_set_option($socket, SOL_TCP, TCP_NODELAY, 1);
+        }
+    }
+
+    /**
+     * Get protocol number for socket type
+     */
+    private function getProtocolNumber(SocketType $type): int
+    {
+        return match ($type) {
+            SocketType::TCP => SOL_TCP,
+            SocketType::UDP => SOL_UDP,
+            default => 0,
+        };
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketServer.php b/src/Framework/Sockets/SocketServer.php
new file mode 100644
index 00000000..032b8af3
--- /dev/null
+++ b/src/Framework/Sockets/SocketServer.php
@@ -0,0 +1,167 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\Exceptions\SocketBindException;
+use App\Framework\Sockets\Exceptions\SocketListenException;
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+
+/**
+ * Socket Server Service
+ *
+ * Provides server socket operations: bind, listen, accept, select.
+ */
+final readonly class SocketServer
+{
+    /**
+     * Bind socket to address
+     */
+    public function bind(SocketResource $socket, SocketAddress $address): void
+    {
+        $resource = $socket->getResource();
+
+        if ($address->isUnixSocket()) {
+            $path = $address->getUnixPath();
+            if ($path === null) {
+                throw new \InvalidArgumentException('Unix socket path is required');
+            }
+
+            // Remove existing socket file if it exists
+            if (file_exists($path)) {
+                @unlink($path);
+            }
+
+            $result = @socket_bind($resource, $path);
+        } else {
+            $host = $address->getHost();
+            $port = $address->getPort();
+            if ($host === null || $port === null) {
+                throw new \InvalidArgumentException('Host and port are required for network sockets');
+            }
+
+            $result = @socket_bind($resource, $host, $port);
+        }
+
+        if ($result === false) {
+            throw SocketBindException::create($address);
+        }
+    }
+
+    /**
+     * Listen on socket
+     */
+    public function listen(SocketResource $socket, int $backlog = 10): void
+    {
+        $resource = $socket->getResource();
+        $result = @socket_listen($resource, $backlog);
+
+        if ($result === false) {
+            throw SocketListenException::create($backlog);
+        }
+    }
+
+    /**
+     * Accept connection on socket
+     *
+     * @return SocketConnection|null Connection if accepted, null if no connection available (non-blocking)
+     */
+    public function accept(SocketResource $socket): ?SocketConnection
+    {
+        $resource = $socket->getResource();
+        $clientSocket = @socket_accept($resource);
+
+        if ($clientSocket === false) {
+            $errorCode = socket_last_error($resource);
+            socket_clear_error($resource);
+
+            // EAGAIN/EWOULDBLOCK means no connection available (non-blocking)
+            if ($errorCode === SOCKET_EAGAIN || $errorCode === SOCKET_EWOULDBLOCK) {
+                return null;
+            }
+
+            // Other errors are real problems
+            throw \App\Framework\Sockets\Exceptions\SocketException::fromSocketError($errorCode, 'socket_accept');
+        }
+
+        // Get peer address
+        $peerAddress = null;
+        $peerPort = null;
+        @socket_getpeername($clientSocket, $peerAddress, $peerPort);
+
+        // Create address from peer info
+        $address = $peerAddress !== null && $peerPort !== null
+            ? SocketAddress::ipv4($peerAddress, $peerPort)
+            : SocketAddress::ipv4('0.0.0.0', 0);
+
+        // Create connection wrapper
+        $clientResource = SocketResource::fromResource(
+            $clientSocket,
+            $socket->getType(),
+            $socket->getProtocol()
+        );
+
+        return SocketConnection::create($clientResource, $address);
+    }
+
+    /**
+     * Select sockets for reading/writing
+     *
+     * Note: socket_select modifies arrays in-place, so we need to work with references
+     *
+     * @param array<SocketResource> $read Sockets to check for reading (will be modified)
+     * @param array<SocketResource> $write Sockets to check for writing (will be modified)
+     * @param array<SocketResource> $except Sockets to check for exceptions (will be modified)
+     * @param int $timeoutSeconds Timeout in seconds (0 = non-blocking, -1 = blocking)
+     * @return int Number of sockets ready
+     */
+    public function select(
+        array &$read,
+        array &$write,
+        array &$except,
+        int $timeoutSeconds = 0
+    ): int {
+        $readResources = array_map(fn($r) => $r->getResource(), $read);
+        $writeResources = array_map(fn($r) => $r->getResource(), $write);
+        $exceptResources = array_map(fn($r) => $r->getResource(), $except);
+
+        $timeout = $timeoutSeconds > 0 ? ['sec' => $timeoutSeconds, 'usec' => 0] : 0;
+        if ($timeoutSeconds < 0) {
+            $timeout = null; // Blocking
+        }
+
+        $result = @socket_select($readResources, $writeResources, $exceptResources, $timeout);
+
+        if ($result === false) {
+            throw \App\Framework\Sockets\Exceptions\SocketException::fromSocketError(null, 'socket_select');
+        }
+
+        // Update arrays with ready sockets (socket_select modifies arrays in-place)
+        $read = array_filter($read, fn($r) => in_array($r->getResource(), $readResources, true));
+        $write = array_filter($write, fn($r) => in_array($r->getResource(), $writeResources, true));
+        $except = array_filter($except, fn($r) => in_array($r->getResource(), $exceptResources, true));
+
+        return $result;
+    }
+
+    /**
+     * Set socket to non-blocking mode
+     */
+    public function setNonBlocking(SocketResource $socket): void
+    {
+        $resource = $socket->getResource();
+        @socket_set_nonblock($resource);
+    }
+
+    /**
+     * Set socket to blocking mode
+     */
+    public function setBlocking(SocketResource $socket): void
+    {
+        $resource = $socket->getResource();
+        @socket_set_block($resource);
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketService.php b/src/Framework/Sockets/SocketService.php
new file mode 100644
index 00000000..9b81fb31
--- /dev/null
+++ b/src/Framework/Sockets/SocketService.php
@@ -0,0 +1,260 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\Sockets\ValueObjects\SocketAddress;
+use App\Framework\Sockets\ValueObjects\SocketProtocol;
+use App\Framework\Sockets\ValueObjects\SocketResource;
+use App\Framework\Sockets\ValueObjects\SocketType;
+
+/**
+ * Socket Service
+ *
+ * Main facade for all socket operations.
+ * Provides unified access to socket creation, server/client operations, and connection management.
+ */
+final readonly class SocketService
+{
+    public function __construct(
+        private SocketFactory $factory,
+        private SocketServer $server,
+        private SocketClient $client,
+        private SocketConnectionPool $connectionPool
+    ) {
+    }
+
+    // ========== Socket Creation ==========
+
+    /**
+     * Create TCP socket
+     */
+    public function createTcp(SocketAddress $address): SocketResource
+    {
+        return $this->factory->createTcp($address);
+    }
+
+    /**
+     * Create UDP socket
+     */
+    public function createUdp(SocketAddress $address): SocketResource
+    {
+        return $this->factory->createUdp($address);
+    }
+
+    /**
+     * Create Unix Domain Socket
+     */
+    public function createUnix(SocketAddress $address): SocketResource
+    {
+        return $this->factory->createUnix($address);
+    }
+
+    /**
+     * Create server socket
+     */
+    public function createServer(SocketType $type, SocketProtocol $protocol): SocketResource
+    {
+        return $this->factory->createServer($type, $protocol);
+    }
+
+    /**
+     * Create client socket
+     */
+    public function createClient(SocketType $type, SocketProtocol $protocol): SocketResource
+    {
+        return $this->factory->createClient($type, $protocol);
+    }
+
+    // ========== Server Operations ==========
+
+    /**
+     * Bind socket to address
+     */
+    public function bind(SocketResource $socket, SocketAddress $address): void
+    {
+        $this->server->bind($socket, $address);
+    }
+
+    /**
+     * Listen on socket
+     */
+    public function listen(SocketResource $socket, int $backlog = 10): void
+    {
+        $this->server->listen($socket, $backlog);
+    }
+
+    /**
+     * Accept connection on socket
+     */
+    public function accept(SocketResource $socket): ?SocketConnection
+    {
+        return $this->server->accept($socket);
+    }
+
+    /**
+     * Select sockets for reading/writing
+     */
+    public function select(
+        array $read,
+        array $write,
+        array $except,
+        int $timeoutSeconds = 0
+    ): int {
+        return $this->server->select($read, $write, $except, $timeoutSeconds);
+    }
+
+    /**
+     * Set socket to non-blocking mode
+     */
+    public function setNonBlocking(SocketResource $socket): void
+    {
+        $this->server->setNonBlocking($socket);
+    }
+
+    /**
+     * Set socket to blocking mode
+     */
+    public function setBlocking(SocketResource $socket): void
+    {
+        $this->server->setBlocking($socket);
+    }
+
+    // ========== Client Operations ==========
+
+    /**
+     * Connect socket to address
+     */
+    public function connect(SocketResource $socket, SocketAddress $address): void
+    {
+        $this->client->connect($socket, $address);
+    }
+
+    /**
+     * Read data from socket
+     */
+    public function read(SocketResource $socket, int $length): ?string
+    {
+        return $this->client->read($socket, $length);
+    }
+
+    /**
+     * Write data to socket
+     */
+    public function write(SocketResource $socket, string $data): int
+    {
+        return $this->client->write($socket, $data);
+    }
+
+    /**
+     * Send data to socket
+     */
+    public function send(SocketResource $socket, string $data, int $flags = 0): int
+    {
+        return $this->client->send($socket, $data, $flags);
+    }
+
+    /**
+     * Receive data from socket
+     */
+    public function receive(SocketResource $socket, int $length, int $flags = 0): ?string
+    {
+        return $this->client->receive($socket, $length, $flags);
+    }
+
+    /**
+     * Close socket
+     */
+    public function close(SocketResource $socket): void
+    {
+        $this->client->close($socket);
+    }
+
+    // ========== Connection Pool ==========
+
+    /**
+     * Add connection to pool
+     */
+    public function addConnection(SocketConnection $connection): void
+    {
+        $this->connectionPool->add($connection);
+    }
+
+    /**
+     * Remove connection from pool
+     */
+    public function removeConnection(SocketConnection $connection): void
+    {
+        $this->connectionPool->remove($connection);
+    }
+
+    /**
+     * Get connection by ID
+     */
+    public function getConnection(string $connectionId): ?SocketConnection
+    {
+        return $this->connectionPool->get($connectionId);
+    }
+
+    /**
+     * Get connections by address
+     *
+     * @return array<SocketConnection>
+     */
+    public function getConnectionsByAddress(SocketAddress $address): array
+    {
+        return $this->connectionPool->getConnectionsByAddress($address);
+    }
+
+    /**
+     * Get connection for address
+     */
+    public function getConnectionForAddress(SocketAddress $address): ?SocketConnection
+    {
+        return $this->connectionPool->getConnectionForAddress($address);
+    }
+
+    /**
+     * Cleanup dead connections
+     */
+    public function cleanupDeadConnections(): int
+    {
+        return $this->connectionPool->cleanupDeadConnections();
+    }
+
+    // ========== Direct Access ==========
+
+    /**
+     * Get socket factory
+     */
+    public function getFactory(): SocketFactory
+    {
+        return $this->factory;
+    }
+
+    /**
+     * Get socket server
+     */
+    public function getServer(): SocketServer
+    {
+        return $this->server;
+    }
+
+    /**
+     * Get socket client
+     */
+    public function getClient(): SocketClient
+    {
+        return $this->client;
+    }
+
+    /**
+     * Get connection pool
+     */
+    public function getConnectionPool(): SocketConnectionPool
+    {
+        return $this->connectionPool;
+    }
+}
+
diff --git a/src/Framework/Sockets/SocketsInitializer.php b/src/Framework/Sockets/SocketsInitializer.php
new file mode 100644
index 00000000..3e4852bf
--- /dev/null
+++ b/src/Framework/Sockets/SocketsInitializer.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets;
+
+use App\Framework\DI\Initializer;
+
+/**
+ * Initializer for Sockets Module
+ *
+ * Registers socket services in the DI container.
+ */
+final readonly class SocketsInitializer
+{
+    #[Initializer]
+    public function socketFactory(): SocketFactory
+    {
+        return new SocketFactory();
+    }
+
+    #[Initializer]
+    public function socketServer(): SocketServer
+    {
+        return new SocketServer();
+    }
+
+    #[Initializer]
+    public function socketClient(): SocketClient
+    {
+        return new SocketClient();
+    }
+
+    #[Initializer]
+    public function socketConnectionPool(): SocketConnectionPool
+    {
+        return new SocketConnectionPool();
+    }
+
+    #[Initializer]
+    public function socketService(
+        SocketFactory $factory,
+        SocketServer $server,
+        SocketClient $client,
+        SocketConnectionPool $connectionPool
+    ): SocketService {
+        return new SocketService(
+            $factory,
+            $server,
+            $client,
+            $connectionPool
+        );
+    }
+}
+
diff --git a/src/Framework/Sockets/ValueObjects/SocketAddress.php b/src/Framework/Sockets/ValueObjects/SocketAddress.php
new file mode 100644
index 00000000..1d6b1f9d
--- /dev/null
+++ b/src/Framework/Sockets/ValueObjects/SocketAddress.php
@@ -0,0 +1,173 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\ValueObjects;
+
+use App\Framework\Core\ValueObjects\Port;
+use InvalidArgumentException;
+
+/**
+ * Socket Address Value Object
+ *
+ * Represents a socket address (IP:Port for network sockets or path for Unix sockets).
+ * Supports IPv4, IPv6, and Unix Domain Sockets.
+ */
+final readonly class SocketAddress
+{
+    private function __construct(
+        private ?string $host,
+        private ?int $port,
+        private ?string $unixPath,
+        private SocketProtocol $protocol
+    ) {
+        if ($this->protocol === SocketProtocol::UNIX) {
+            if ($this->unixPath === null || $this->unixPath === '') {
+                throw new InvalidArgumentException('Unix socket path cannot be empty');
+            }
+            if ($this->host !== null || $this->port !== null) {
+                throw new InvalidArgumentException('Unix socket cannot have host/port');
+            }
+        } else {
+            if ($this->host === null || $this->host === '') {
+                throw new InvalidArgumentException('Network socket host cannot be empty');
+            }
+            if ($this->port === null || !Port::isValidPort($this->port)) {
+                throw new InvalidArgumentException("Invalid port: {$this->port}");
+            }
+            if ($this->unixPath !== null) {
+                throw new InvalidArgumentException('Network socket cannot have Unix path');
+            }
+        }
+    }
+
+    /**
+     * Create IPv4 address
+     */
+    public static function ipv4(string $host, int $port): self
+    {
+        return new self(
+            host: $host,
+            port: $port,
+            unixPath: null,
+            protocol: SocketProtocol::IPv4
+        );
+    }
+
+    /**
+     * Create IPv6 address
+     */
+    public static function ipv6(string $host, int $port): self
+    {
+        return new self(
+            host: $host,
+            port: $port,
+            unixPath: null,
+            protocol: SocketProtocol::IPv6
+        );
+    }
+
+    /**
+     * Create Unix Domain Socket address
+     */
+    public static function unix(string $path): self
+    {
+        return new self(
+            host: null,
+            port: null,
+            unixPath: $path,
+            protocol: SocketProtocol::UNIX
+        );
+    }
+
+    /**
+     * Create from string (e.g., "127.0.0.1:8080" or "/tmp/socket.sock")
+     */
+    public static function fromString(string $address): self
+    {
+        // Unix socket path
+        if (str_starts_with($address, '/')) {
+            return self::unix($address);
+        }
+
+        // Try to parse as host:port
+        if (str_contains($address, ':')) {
+            $parts = explode(':', $address, 2);
+            $host = $parts[0];
+            $port = (int) $parts[1];
+
+            // Detect IPv6
+            if (str_contains($host, '[') && str_contains($host, ']')) {
+                // IPv6 with brackets: [::1]:8080
+                $host = trim($host, '[]');
+                return self::ipv6($host, $port);
+            }
+
+            // Try to detect IPv6 by format
+            if (filter_var($host, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) !== false) {
+                return self::ipv6($host, $port);
+            }
+
+            return self::ipv4($host, $port);
+        }
+
+        throw new InvalidArgumentException("Invalid socket address format: {$address}");
+    }
+
+    public function getHost(): ?string
+    {
+        return $this->host;
+    }
+
+    public function getPort(): ?int
+    {
+        return $this->port;
+    }
+
+    public function getUnixPath(): ?string
+    {
+        return $this->unixPath;
+    }
+
+    public function getProtocol(): SocketProtocol
+    {
+        return $this->protocol;
+    }
+
+    public function isUnixSocket(): bool
+    {
+        return $this->protocol === SocketProtocol::UNIX;
+    }
+
+    public function isNetworkSocket(): bool
+    {
+        return !$this->isUnixSocket();
+    }
+
+    public function toString(): string
+    {
+        if ($this->isUnixSocket()) {
+            return $this->unixPath ?? '';
+        }
+
+        if ($this->protocol === SocketProtocol::IPv6) {
+            return "[{$this->host}]:{$this->port}";
+        }
+
+        return "{$this->host}:{$this->port}";
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->host === $other->host
+            && $this->port === $other->port
+            && $this->unixPath === $other->unixPath
+            && $this->protocol === $other->protocol;
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+
diff --git a/src/Framework/Sockets/ValueObjects/SocketOption.php b/src/Framework/Sockets/ValueObjects/SocketOption.php
new file mode 100644
index 00000000..00888c5b
--- /dev/null
+++ b/src/Framework/Sockets/ValueObjects/SocketOption.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\ValueObjects;
+
+/**
+ * Socket Option Enum
+ *
+ * Represents socket options that can be set/get
+ */
+enum SocketOption: int
+{
+    case SO_REUSEADDR = 2;
+    case SO_REUSEPORT = 15;
+    case SO_KEEPALIVE = 9;
+    case SO_LINGER = 13;
+    case SO_RCVBUF = 8;
+    case SO_SNDBUF = 7;
+    case SO_RCVTIMEO = 20;
+    case SO_SNDTIMEO = 21;
+    case TCP_NODELAY = 1;
+    case TCP_KEEPIDLE = 4;
+    case TCP_KEEPINTVL = 5;
+    case TCP_KEEPCNT = 6;
+
+    public function getName(): string
+    {
+        return match ($this) {
+            self::SO_REUSEADDR => 'SO_REUSEADDR',
+            self::SO_REUSEPORT => 'SO_REUSEPORT',
+            self::SO_KEEPALIVE => 'SO_KEEPALIVE',
+            self::SO_LINGER => 'SO_LINGER',
+            self::SO_RCVBUF => 'SO_RCVBUF',
+            self::SO_SNDBUF => 'SO_SNDBUF',
+            self::SO_RCVTIMEO => 'SO_RCVTIMEO',
+            self::SO_SNDTIMEO => 'SO_SNDTIMEO',
+            self::TCP_NODELAY => 'TCP_NODELAY',
+            self::TCP_KEEPIDLE => 'TCP_KEEPIDLE',
+            self::TCP_KEEPINTVL => 'TCP_KEEPINTVL',
+            self::TCP_KEEPCNT => 'TCP_KEEPCNT',
+        };
+    }
+
+    public function getLevel(): int
+    {
+        return match ($this) {
+            self::TCP_NODELAY,
+            self::TCP_KEEPIDLE,
+            self::TCP_KEEPINTVL,
+            self::TCP_KEEPCNT => SOL_TCP,
+            default => SOL_SOCKET,
+        };
+    }
+
+    public function getValue(): int
+    {
+        return match ($this) {
+            self::SO_REUSEADDR => SO_REUSEADDR,
+            self::SO_REUSEPORT => SO_REUSEPORT,
+            self::SO_KEEPALIVE => SO_KEEPALIVE,
+            self::SO_LINGER => SO_LINGER,
+            self::SO_RCVBUF => SO_RCVBUF,
+            self::SO_SNDBUF => SO_SNDBUF,
+            self::SO_RCVTIMEO => SO_RCVTIMEO,
+            self::SO_SNDTIMEO => SO_SNDTIMEO,
+            self::TCP_NODELAY => TCP_NODELAY,
+            self::TCP_KEEPIDLE => TCP_KEEPIDLE,
+            self::TCP_KEEPINTVL => TCP_KEEPINTVL,
+            self::TCP_KEEPCNT => TCP_KEEPCNT,
+        };
+    }
+
+    public function __toString(): string
+    {
+        return $this->getName();
+    }
+}
+
diff --git a/src/Framework/Sockets/ValueObjects/SocketProtocol.php b/src/Framework/Sockets/ValueObjects/SocketProtocol.php
new file mode 100644
index 00000000..11b01e7d
--- /dev/null
+++ b/src/Framework/Sockets/ValueObjects/SocketProtocol.php
@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\ValueObjects;
+
+/**
+ * Socket Protocol Family Enum
+ *
+ * Represents the protocol family (IPv4, IPv6, Unix Domain)
+ */
+enum SocketProtocol: int
+{
+    case IPv4 = 2;   // AF_INET
+    case IPv6 = 10;  // AF_INET6
+    case UNIX = 1;   // AF_UNIX
+
+    public function getName(): string
+    {
+        return match ($this) {
+            self::IPv4 => 'IPv4',
+            self::IPv6 => 'IPv6',
+            self::UNIX => 'Unix Domain',
+        };
+    }
+
+    public function getValue(): int
+    {
+        return match ($this) {
+            self::IPv4 => AF_INET,
+            self::IPv6 => AF_INET6,
+            self::UNIX => AF_UNIX,
+        };
+    }
+
+    public function isNetwork(): bool
+    {
+        return match ($this) {
+            self::IPv4, self::IPv6 => true,
+            self::UNIX => false,
+        };
+    }
+
+    public function isUnix(): bool
+    {
+        return $this === self::UNIX;
+    }
+
+    public function __toString(): string
+    {
+        return $this->getName();
+    }
+}
+
diff --git a/src/Framework/Sockets/ValueObjects/SocketResource.php b/src/Framework/Sockets/ValueObjects/SocketResource.php
new file mode 100644
index 00000000..968349ca
--- /dev/null
+++ b/src/Framework/Sockets/ValueObjects/SocketResource.php
@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Socket Resource Value Object
+ *
+ * Type-safe wrapper for socket resources.
+ * Provides automatic cleanup and validation.
+ */
+final class SocketResource
+{
+    private bool $closed = false;
+
+    private function __construct(
+        private $resource,
+        private SocketType $type,
+        private SocketProtocol $protocol
+    ) {
+        if (!is_resource($this->resource) && !$this->resource instanceof \Socket) {
+            throw new InvalidArgumentException('Socket resource must be a valid resource or Socket object');
+        }
+    }
+
+    /**
+     * Create from socket resource
+     */
+    public static function fromResource($resource, SocketType $type, SocketProtocol $protocol): self
+    {
+        return new self($resource, $type, $protocol);
+    }
+
+    /**
+     * Get the underlying socket resource
+     */
+    public function getResource()
+    {
+        if ($this->closed) {
+            throw new \RuntimeException('Socket resource has been closed');
+        }
+
+        return $this->resource;
+    }
+
+    public function getType(): SocketType
+    {
+        return $this->type;
+    }
+
+    public function getProtocol(): SocketProtocol
+    {
+        return $this->protocol;
+    }
+
+    /**
+     * Check if socket is closed
+     */
+    public function isClosed(): bool
+    {
+        return $this->closed;
+    }
+
+    /**
+     * Close the socket
+     */
+    public function close(): void
+    {
+        if ($this->closed) {
+            return;
+        }
+
+        if (is_resource($this->resource)) {
+            socket_close($this->resource);
+        } elseif ($this->resource instanceof \Socket) {
+            socket_close($this->resource);
+        }
+
+        $this->closed = true;
+    }
+
+    /**
+     * Automatic cleanup on destruction
+     */
+    public function __destruct()
+    {
+        $this->close();
+    }
+
+    /**
+     * Prevent cloning
+     */
+    private function __clone()
+    {
+    }
+}
+
diff --git a/src/Framework/Sockets/ValueObjects/SocketType.php b/src/Framework/Sockets/ValueObjects/SocketType.php
new file mode 100644
index 00000000..16ebbc98
--- /dev/null
+++ b/src/Framework/Sockets/ValueObjects/SocketType.php
@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Sockets\ValueObjects;
+
+/**
+ * Socket Type Enum
+ *
+ * Represents the type of socket (TCP, UDP, etc.)
+ */
+enum SocketType: int
+{
+    case TCP = 1;      // SOCK_STREAM
+    case UDP = 2;      // SOCK_DGRAM
+    case RAW = 3;      // SOCK_RAW
+    case RDM = 4;      // SOCK_RDM
+    case SEQPACKET = 5; // SOCK_SEQPACKET
+
+    public function getName(): string
+    {
+        return match ($this) {
+            self::TCP => 'TCP',
+            self::UDP => 'UDP',
+            self::RAW => 'RAW',
+            self::RDM => 'RDM',
+            self::SEQPACKET => 'SEQPACKET',
+        };
+    }
+
+    public function getValue(): int
+    {
+        return match ($this) {
+            self::TCP => SOCK_STREAM,
+            self::UDP => SOCK_DGRAM,
+            self::RAW => SOCK_RAW,
+            self::RDM => SOCK_RDM,
+            self::SEQPACKET => SOCK_SEQPACKET,
+        };
+    }
+
+    public function isReliable(): bool
+    {
+        return match ($this) {
+            self::TCP, self::SEQPACKET => true,
+            default => false,
+        };
+    }
+
+    public function isConnectionless(): bool
+    {
+        return $this === self::UDP;
+    }
+
+    public function __toString(): string
+    {
+        return $this->getName();
+    }
+}
+
diff --git a/src/Framework/Ssh/Adapters/ProcessSftpClient.php b/src/Framework/Ssh/Adapters/ProcessSftpClient.php
new file mode 100644
index 00000000..c559092a
--- /dev/null
+++ b/src/Framework/Ssh/Adapters/ProcessSftpClient.php
@@ -0,0 +1,288 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Adapters;
+
+use App\Framework\Core\ValueObjects\Byte;
+use App\Framework\Filesystem\ValueObjects\FilePath;
+use App\Framework\Process\Process;
+use App\Framework\Process\ProcessResult;
+use App\Framework\Ssh\Contracts\SftpClient;
+use App\Framework\Ssh\Exceptions\SftpClientException;
+use App\Framework\Ssh\Exceptions\SftpTransferException;
+use App\Framework\Ssh\Support\SshCommandBuilder;
+use App\Framework\Ssh\Support\SshProcessCommand;
+use App\Framework\Ssh\ValueObjects\SftpDirectoryEntry;
+use App\Framework\Ssh\ValueObjects\SftpPath;
+use App\Framework\Ssh\ValueObjects\SftpTransferDirection;
+use App\Framework\Ssh\ValueObjects\SftpTransferRequest;
+use App\Framework\Ssh\ValueObjects\SshCommand;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+use DateTimeImmutable;
+use DateTimeZone;
+
+final readonly class ProcessSftpClient implements SftpClient
+{
+    public function __construct(
+        private Process $process,
+        private SshCommandBuilder $commandBuilder,
+        private ProcessSshClient $sshClient
+    ) {
+    }
+
+    public function transfer(SftpTransferRequest $request, SshConnectionConfig $config): void
+    {
+        if ($request->isUpload()) {
+            $this->handleUpload($request, $config);
+
+            return;
+        }
+
+        $this->handleDownload($request, $config);
+    }
+
+    public function readFile(SshConnectionConfig $config, SftpPath $remotePath): string
+    {
+        $command = new SshCommand(sprintf('cat -- %s', $this->escapeRemoteArgument($remotePath->toString())));
+
+        return $this->sshClient
+            ->execute($command, $config)
+            ->stdout();
+    }
+
+    public function writeFile(SshConnectionConfig $config, SftpPath $remotePath, string $contents): void
+    {
+        $temporaryPath = tempnam(sys_get_temp_dir(), 'sftp-upload-');
+
+        if ($temporaryPath === false) {
+            throw SftpTransferException::withContext(
+                'Unable to create temporary file for SFTP write.',
+                ['remote_path' => $remotePath->toString()]
+            );
+        }
+
+        try {
+            if (file_put_contents($temporaryPath, $contents) === false) {
+                throw SftpTransferException::withContext(
+                    'Failed to write contents to temporary upload file.',
+                    ['remote_path' => $remotePath->toString()]
+                );
+            }
+
+            $transfer = new SftpTransferRequest(
+                direction: SftpTransferDirection::UPLOAD,
+                localPath: FilePath::create($temporaryPath),
+                remotePath: $remotePath,
+                overwrite: true,
+                createDirectories: true
+            );
+
+            $this->transfer($transfer, $config);
+        } finally {
+            @unlink($temporaryPath);
+        }
+    }
+
+    public function listDirectory(SshConnectionConfig $config, SftpPath $remotePath): array
+    {
+        $format = '%y|%s|%T@|%u|%g|%m|%p\n';
+        $command = new SshCommand(sprintf(
+            'find %s -maxdepth 1 -mindepth 1 -printf %s',
+            $this->escapeRemoteArgument($remotePath->toString()),
+            $this->escapeRemoteArgument($format)
+        ));
+
+        $result = $this->sshClient->execute($command, $config);
+        $lines = preg_split('/\r?\n/', trim($result->stdout())) ?: [];
+        $entries = [];
+
+        foreach ($lines as $line) {
+            $line = trim($line);
+
+            if ($line === '') {
+                continue;
+            }
+
+            $parts = explode('|', $line, 7);
+            if (count($parts) !== 7) {
+                continue;
+            }
+
+            [$type, $size, $mtime, $owner, $group, $permissions, $path] = $parts;
+
+            try {
+                $entries[] = new SftpDirectoryEntry(
+                    path: new SftpPath($path),
+                    isDirectory: $type === 'd',
+                    size: Byte::fromBytes((int) $size),
+                    modifiedAt: (new DateTimeImmutable('@' . (int) round((float) $mtime)))->setTimezone(new DateTimeZone('UTC')),
+                    owner: $owner,
+                    group: $group,
+                    permissions: intval($permissions, 8)
+                );
+            } catch (\InvalidArgumentException) {
+                continue;
+            }
+        }
+
+        return $entries;
+    }
+
+    public function deleteFile(SshConnectionConfig $config, SftpPath $remotePath): void
+    {
+        $command = new SshCommand(sprintf(
+            'rm -f -- %s',
+            $this->escapeRemoteArgument($remotePath->toString())
+        ));
+
+        $this->sshClient->execute($command, $config);
+    }
+
+    public function ensureDirectory(SshConnectionConfig $config, SftpPath $remotePath): void
+    {
+        $command = new SshCommand(sprintf(
+            'mkdir -p -- %s',
+            $this->escapeRemoteArgument($remotePath->toString())
+        ));
+
+        $this->sshClient->execute($command, $config);
+    }
+
+    private function handleUpload(SftpTransferRequest $request, SshConnectionConfig $config): void
+    {
+        $localPath = $request->localPath;
+
+        if (! $localPath->isFile()) {
+            throw SftpClientException::invalidLocalPath($localPath->toString());
+        }
+
+        if (! $request->overwrite && $this->remoteFileExists($config, $request->remotePath)) {
+            throw SftpClientException::remotePathExists($request->remotePath->toString());
+        }
+
+        if ($request->createDirectories) {
+            $directory = $this->directoryOf($request->remotePath);
+            if ($directory !== null && $directory->toString() !== '/') {
+                $this->ensureDirectory($config, $directory);
+            }
+        }
+
+        $prepared = $this->commandBuilder->buildScpCommand(
+            $config,
+            $localPath->toString(),
+            $this->commandBuilder->formatRemoteTarget($config, $request->remotePath)
+        );
+
+        $this->executeTransfer($prepared, $config);
+    }
+
+    private function handleDownload(SftpTransferRequest $request, SshConnectionConfig $config): void
+    {
+        $localPath = $request->localPath;
+
+        if ($localPath->isFile() && ! $request->overwrite) {
+            throw SftpClientException::localPathExists($localPath->toString());
+        }
+
+        if (! $this->remoteFileExists($config, $request->remotePath)) {
+            throw SftpTransferException::withContext(
+                'Remote file does not exist.',
+                ['remote_path' => $request->remotePath->toString()]
+            );
+        }
+
+        if ($request->createDirectories) {
+            $this->ensureLocalDirectory($localPath);
+        }
+
+        $prepared = $this->commandBuilder->buildScpCommand(
+            $config,
+            $this->commandBuilder->formatRemoteTarget($config, $request->remotePath),
+            $localPath->toString()
+        );
+
+        $this->executeTransfer($prepared, $config);
+    }
+
+    private function executeTransfer(SshProcessCommand $prepared, SshConnectionConfig $config): void
+    {
+        $prepared->applyEnvironment();
+
+        try {
+            $result = $this->process->run(
+                command: $prepared->command(),
+                timeout: $config->operationTimeout
+            );
+        } finally {
+            $prepared->cleanup();
+        }
+
+        if (! $result->isSuccess()) {
+            $this->throwTransferFailure($result);
+        }
+    }
+
+    private function throwTransferFailure(ProcessResult $result): void
+    {
+        throw SftpTransferException::withContext(
+            'SFTP transfer failed.',
+            [
+                'exit_code' => $result->exitCode->value,
+                'stdout' => $result->stdout,
+                'stderr' => $result->stderr,
+                'runtime_ms' => $result->runtime->toMilliseconds(),
+            ]
+        );
+    }
+
+    private function escapeRemoteArgument(string $value): string
+    {
+        return "'" . str_replace("'", "'\"'\"'", $value) . "'";
+    }
+
+    private function remoteFileExists(SshConnectionConfig $config, SftpPath $remotePath): bool
+    {
+        $command = new SshCommand(sprintf(
+            'if [ -e %1$s ]; then echo 1; else echo 0; fi',
+            $this->escapeRemoteArgument($remotePath->toString())
+        ));
+
+        $stdout = trim($this->sshClient->execute($command, $config)->stdout());
+
+        return $stdout === '1';
+    }
+
+    private function directoryOf(SftpPath $path): ?SftpPath
+    {
+        $directory = dirname($path->toString());
+
+        if ($directory === '.' || $directory === '') {
+            return null;
+        }
+
+        return new SftpPath($directory);
+    }
+
+    private function ensureLocalDirectory(FilePath $target): void
+    {
+        $directory = $target->getDirectory()->toString();
+
+        if ($directory === '') {
+            return;
+        }
+
+        if (is_dir($directory)) {
+            return;
+        }
+
+        if (! @mkdir($directory, 0770, true) && ! is_dir($directory)) {
+            throw SftpClientException::unableToCreateLocalDirectory($directory);
+        }
+    }
+
+    public function capabilities(): array
+    {
+        // TODO: Implement capabilities() method.
+    }
+}
diff --git a/src/Framework/Ssh/Adapters/ProcessSshClient.php b/src/Framework/Ssh/Adapters/ProcessSshClient.php
new file mode 100644
index 00000000..32f8946f
--- /dev/null
+++ b/src/Framework/Ssh/Adapters/ProcessSshClient.php
@@ -0,0 +1,227 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Adapters;
+
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\DateTime\Clock;
+use App\Framework\Process\Process;
+use App\Framework\Process\ProcessResult;
+use App\Framework\Process\ValueObjects\Command;
+use App\Framework\Ssh\Contracts\SshClient;
+use App\Framework\Ssh\Exceptions\SshClientException;
+use App\Framework\Ssh\Exceptions\SshCommandFailedException;
+use App\Framework\Ssh\Support\SshCommandBuilder;
+use App\Framework\Ssh\Support\SshProcessCommand;
+use App\Framework\Ssh\ValueObjects\SshAuthenticationType;
+use App\Framework\Ssh\ValueObjects\SshCommand;
+use App\Framework\Ssh\ValueObjects\SshCommandResult;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+use App\Framework\Ssh\ValueObjects\SshEnvironmentVariable;
+use App\Framework\Ssh\ValueObjects\SshHostKeyFingerprint;
+
+final readonly class ProcessSshClient implements SshClient
+{
+    public function __construct(
+        private Process $process,
+        private SshCommandBuilder $commandBuilder,
+        private Clock $clock
+    ) {
+    }
+
+    public function execute(SshCommand $command, SshConnectionConfig $config): SshCommandResult
+    {
+        $this->assertExpectedHostKey($config);
+
+        $remoteCommand = $this->buildRemoteCommand($command);
+        $prepared = $this->commandBuilder->buildSshCommand(
+            $config,
+            $remoteCommand,
+            $command->allocatePty()
+        );
+
+        return $this->runCommand($prepared, $config->operationTimeout, $command);
+    }
+
+    public function verifyConnection(SshConnectionConfig $config): void
+    {
+        $command = new SshCommand('true');
+        $this->execute($command, $config);
+    }
+
+    public function fetchHostKeyFingerprint(SshConnectionConfig $config): SshHostKeyFingerprint
+    {
+        if (! $this->process->commandExists('ssh-keyscan')) {
+            throw SshClientException::missingBinary('ssh-keyscan');
+        }
+
+        $args = [
+            'ssh-keyscan',
+            '-p',
+            (string) $config->port->toInt(),
+        ];
+
+        if ($config->connectionTimeout !== null) {
+            $args[] = '-T';
+            $args[] = (string) max(1, (int) ceil($config->connectionTimeout->toSeconds()));
+        }
+
+        $args[] = $config->host->toString();
+
+        $result = $this->process->run(
+            command: Command::fromArray($args),
+            timeout: $config->connectionTimeout
+        );
+
+        if (! $result->isSuccess() || trim($result->stdout) === '') {
+            throw SshClientException::hostKeyLookupFailed($config->host->toString(), $result->stderr);
+        }
+
+        return $this->selectFingerprintFromOutput($result->stdout, $config->host->toString());
+    }
+
+    public function supportsAuthentication(SshAuthenticationType $type): bool
+    {
+        return match ($type) {
+            SshAuthenticationType::PASSWORD,
+            SshAuthenticationType::PRIVATE_KEY,
+            SshAuthenticationType::PRIVATE_KEY_WITH_PASSPHRASE,
+            SshAuthenticationType::SSH_AGENT => true,
+            default => false,
+        };
+    }
+
+    public function capabilities(): array
+    {
+        return [
+            'ssh' => $this->process->commandExists('ssh'),
+            'scp' => $this->process->commandExists('scp'),
+            'sshpass' => $this->process->commandExists('sshpass'),
+            'ssh-keyscan' => $this->process->commandExists('ssh-keyscan'),
+        ];
+    }
+
+    /**
+     * @param SshCommand $originalCommand
+     */
+    private function runCommand(
+        SshProcessCommand $prepared,
+        ?Duration $timeout,
+        SshCommand $originalCommand
+    ): SshCommandResult {
+        $prepared->applyEnvironment();
+
+        $startedAt = $this->clock->now();
+
+        try {
+            $processResult = $this->process->run(
+                command: $prepared->command(),
+                timeout: $timeout
+            );
+        } finally {
+            $prepared->cleanup();
+        }
+
+        $finishedAt = $this->clock->now();
+
+        if (! $processResult->isSuccess()) {
+            $this->throwCommandFailure($processResult, $originalCommand);
+        }
+
+        return new SshCommandResult(
+            stdout: $processResult->stdout,
+            stderr: $processResult->stderr,
+            exitCode: $processResult->exitCode->value,
+            duration: $processResult->runtime,
+            startedAt: $startedAt,
+            finishedAt: $finishedAt
+        );
+    }
+
+    private function throwCommandFailure(ProcessResult $result, SshCommand $command): void
+    {
+        $message = sprintf(
+            'SSH command failed with exit code %d.',
+            $result->exitCode->value
+        );
+
+        throw SshCommandFailedException::withContext($message, [
+            'command' => $command->statement(),
+            'exit_code' => $result->exitCode->value,
+            'stdout' => $result->stdout,
+            'stderr' => $result->stderr,
+            'runtime_ms' => $result->runtime->toMilliseconds(),
+        ]);
+    }
+
+    private function buildRemoteCommand(SshCommand $command): string
+    {
+        $parts = array_map(
+            fn (SshEnvironmentVariable $env) => sprintf('%s=%s', $env->key(), $this->escapeRemoteArgument($env->value())),
+            $command->environment()
+        );
+
+        $parts[] = $command->statement();
+
+        return implode(' ', $parts);
+    }
+
+    private function escapeRemoteArgument(string $value): string
+    {
+        return "'" . str_replace("'", "'\"'\"'", $value) . "'";
+    }
+
+    private function assertExpectedHostKey(SshConnectionConfig $config): void
+    {
+        if ($config->expectedHostKey === null) {
+            return;
+        }
+
+        $actual = $this->fetchHostKeyFingerprint($config);
+
+        if ($actual->toString() !== $config->expectedHostKey->toString()) {
+            throw SshClientException::hostKeyMismatch(
+                $config->expectedHostKey->toString(),
+                $actual->toString()
+            );
+        }
+    }
+
+    private function selectFingerprintFromOutput(string $output, string $host): SshHostKeyFingerprint
+    {
+        $lines = preg_split('/\r?\n/', trim($output)) ?: [];
+        $fingerprints = [];
+
+        foreach ($lines as $line) {
+            $line = trim($line);
+
+            if ($line === '' || str_starts_with($line, '#')) {
+                continue;
+            }
+
+            $parts = preg_split('/\s+/', $line);
+            if ($parts === false || count($parts) < 3) {
+                continue;
+            }
+
+            $keyData = base64_decode($parts[2], true);
+            if ($keyData === false) {
+                continue;
+            }
+
+            $fingerprint = 'sha256:' . rtrim(base64_encode(hash('sha256', $keyData, true)), '=');
+            $fingerprints[$parts[1]] = new SshHostKeyFingerprint($fingerprint);
+        }
+
+        if (isset($fingerprints['ssh-ed25519'])) {
+            return $fingerprints['ssh-ed25519'];
+        }
+
+        if ($fingerprints !== []) {
+            return array_values($fingerprints)[0];
+        }
+
+        throw SshClientException::hostKeyLookupFailed($host, 'ssh-keyscan provided no parsable keys');
+    }
+}
diff --git a/src/Framework/Ssh/Contracts/SftpClient.php b/src/Framework/Ssh/Contracts/SftpClient.php
new file mode 100644
index 00000000..20cbfd99
--- /dev/null
+++ b/src/Framework/Ssh/Contracts/SftpClient.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Contracts;
+
+use App\Framework\Ssh\ValueObjects\SftpDirectoryEntry;
+use App\Framework\Ssh\ValueObjects\SftpPath;
+use App\Framework\Ssh\ValueObjects\SftpTransferRequest;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+
+/**
+ * Contract for performing SFTP file operations.
+ */
+interface SftpClient
+{
+    /**
+     * Executes an upload or download request, depending on the direction.
+     */
+    public function transfer(SftpTransferRequest $request, SshConnectionConfig $config): void;
+
+    /**
+     * Reads the entire remote file content.
+     */
+    public function readFile(SshConnectionConfig $config, SftpPath $remotePath): string;
+
+    /**
+     * Writes the given payload to the remote path (overwrites existing files).
+     */
+    public function writeFile(SshConnectionConfig $config, SftpPath $remotePath, string $contents): void;
+
+    /**
+     * Lists directory entries at the given path.
+     *
+     * @return list<SftpDirectoryEntry>
+     */
+    public function listDirectory(SshConnectionConfig $config, SftpPath $remotePath): array;
+
+    /**
+     * Removes a remote file.
+     */
+    public function deleteFile(SshConnectionConfig $config, SftpPath $remotePath): void;
+
+    /**
+     * Ensures a remote directory exists (creates it recursively if missing).
+     */
+    public function ensureDirectory(SshConnectionConfig $config, SftpPath $remotePath): void;
+
+    /**
+     * Returns non-sensitive capability metadata.
+     *
+     * @return array<string, mixed>
+     */
+    public function capabilities(): array;
+}
diff --git a/src/Framework/Ssh/Contracts/SshClient.php b/src/Framework/Ssh/Contracts/SshClient.php
new file mode 100644
index 00000000..7251f861
--- /dev/null
+++ b/src/Framework/Ssh/Contracts/SshClient.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Contracts;
+
+use App\Framework\Ssh\ValueObjects\SshAuthenticationType;
+use App\Framework\Ssh\ValueObjects\SshCommand;
+use App\Framework\Ssh\ValueObjects\SshCommandResult;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+use App\Framework\Ssh\ValueObjects\SshHostKeyFingerprint;
+
+/**
+ * Contract for executing remote commands via SSH.
+ */
+interface SshClient
+{
+    /**
+     * Executes the given command and returns the captured result.
+     */
+    public function execute(SshCommand $command, SshConnectionConfig $config): SshCommandResult;
+
+    /**
+     * Performs a connection health check (authentication + optional host verification).
+     */
+    public function verifyConnection(SshConnectionConfig $config): void;
+
+    /**
+     * Retrieves the server's host key fingerprint for trust-on-first-use scenarios.
+     */
+    public function fetchHostKeyFingerprint(SshConnectionConfig $config): SshHostKeyFingerprint;
+
+    /**
+     * Indicates whether the client supports the given authentication type.
+     */
+    public function supportsAuthentication(SshAuthenticationType $type): bool;
+
+    /**
+     * Returns non-sensitive capability metadata (e.g. supported ciphers).
+     *
+     * @return array<string, mixed>
+     */
+    public function capabilities(): array;
+}
diff --git a/src/Framework/Ssh/Exceptions/SftpClientException.php b/src/Framework/Ssh/Exceptions/SftpClientException.php
new file mode 100644
index 00000000..5a86a97f
--- /dev/null
+++ b/src/Framework/Ssh/Exceptions/SftpClientException.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+
+/**
+ * Generic SFTP client exception.
+ */
+final class SftpClientException extends FrameworkException
+{
+    public static function invalidLocalPath(string $path): self
+    {
+        return new self(sprintf("Local path '%s' is not accessible for SFTP transfer.", $path));
+    }
+
+    public static function localPathExists(string $path): self
+    {
+        return new self(sprintf("Local file '%s' already exists and overwrite is disabled.", $path));
+    }
+
+    public static function remotePathExists(string $path): self
+    {
+        return new self(sprintf("Remote path '%s' already exists and overwrite is disabled.", $path));
+    }
+
+    public static function unableToCreateLocalDirectory(string $path): self
+    {
+        return new self(sprintf("Unable to create local directory '%s' for SFTP download.", $path));
+    }
+}
diff --git a/src/Framework/Ssh/Exceptions/SftpTransferException.php b/src/Framework/Ssh/Exceptions/SftpTransferException.php
new file mode 100644
index 00000000..e6230619
--- /dev/null
+++ b/src/Framework/Ssh/Exceptions/SftpTransferException.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+
+/**
+ * Raised when an SFTP file transfer fails.
+ */
+final class SftpTransferException extends FrameworkException
+{
+    /**
+     * @param array<string, mixed> $context
+     */
+    public function __construct(
+        string $message,
+        public readonly array $context = []
+    ) {
+        parent::__construct($message);
+    }
+
+    public static function withContext(string $message, array $context): self
+    {
+        return new self($message, $context);
+    }
+}
diff --git a/src/Framework/Ssh/Exceptions/SshClientException.php b/src/Framework/Ssh/Exceptions/SshClientException.php
new file mode 100644
index 00000000..68f6bdce
--- /dev/null
+++ b/src/Framework/Ssh/Exceptions/SshClientException.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+use App\Framework\Ssh\ValueObjects\SshAuthenticationType;
+
+/**
+ * Base exception for SSH client configuration and runtime faults.
+ */
+final class SshClientException extends FrameworkException
+{
+    public static function missingBinary(string $binary): self
+    {
+        return new self(sprintf("Required SSH binary '%s' is not available on the system PATH.", $binary));
+    }
+
+    public static function unsupportedAuthentication(SshAuthenticationType $type): self
+    {
+        return new self(sprintf(
+            "SSH authentication method '%s' is not supported by the current adapter.",
+            $type->value
+        ));
+    }
+
+    public static function hostKeyMismatch(string $expected, string $actual): self
+    {
+        return new self(sprintf(
+            "SSH host key fingerprint mismatch. Expected '%s' but received '%s'.",
+            $expected,
+            $actual
+        ));
+    }
+
+    public static function hostKeyLookupFailed(string $host, string $details): self
+    {
+        return new self(sprintf(
+            "Unable to determine SSH host key for '%s'. Details: %s",
+            $host,
+            trim($details) !== '' ? $details : 'no additional output'
+        ));
+    }
+
+    public static function invalidRemoteCommand(string $reason): self
+    {
+        return new self(sprintf('Remote command could not be constructed: %s', $reason));
+    }
+}
diff --git a/src/Framework/Ssh/Exceptions/SshCommandFailedException.php b/src/Framework/Ssh/Exceptions/SshCommandFailedException.php
new file mode 100644
index 00000000..60e7247f
--- /dev/null
+++ b/src/Framework/Ssh/Exceptions/SshCommandFailedException.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+
+/**
+ * Raised when a remote SSH command returns a non-zero exit status.
+ */
+final class SshCommandFailedException extends FrameworkException
+{
+    /**
+     * @param array<string, mixed> $context
+     */
+    public function __construct(
+        string $message,
+        public readonly array $context = []
+    ) {
+        parent::__construct($message);
+    }
+
+    public static function withContext(
+        string $message,
+        array $context
+    ): self {
+        return new self($message, $context);
+    }
+}
diff --git a/src/Framework/Ssh/Exceptions/SshRateLimitExceededException.php b/src/Framework/Ssh/Exceptions/SshRateLimitExceededException.php
new file mode 100644
index 00000000..f2b8441a
--- /dev/null
+++ b/src/Framework/Ssh/Exceptions/SshRateLimitExceededException.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Exceptions;
+
+use App\Framework\Exception\FrameworkException;
+use App\Framework\RateLimit\RateLimitResult;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+
+/**
+ * Exception thrown when SSH operations exceed configured rate limits.
+ */
+final class SshRateLimitExceededException extends FrameworkException
+{
+    /**
+     * @param array<string, mixed> $context
+     */
+    public function __construct(
+        string $message,
+        public readonly array $context = [],
+        ?\Throwable $previous = null
+    ) {
+        parent::__construct($message, 0, $previous);
+    }
+
+    public static function fromResult(
+        SshConnectionConfig $config,
+        RateLimitResult $result
+    ): self {
+        $host = $config->host->toString();
+        $user = $config->username->toString();
+
+        $message = sprintf(
+            'SSH rate limit exceeded for %s@%s (%d/%d requests).',
+            $user,
+            $host,
+            $result->getCurrent(),
+            $result->getLimit()
+        );
+
+        return new self($message, [
+            'host' => $host,
+            'username' => $user,
+            'limit' => $result->getLimit(),
+            'current' => $result->getCurrent(),
+            'retry_after' => $result->getRetryAfter(),
+        ]);
+    }
+}
diff --git a/src/Framework/Ssh/SftpTransferExecutor.php b/src/Framework/Ssh/SftpTransferExecutor.php
new file mode 100644
index 00000000..62b80a63
--- /dev/null
+++ b/src/Framework/Ssh/SftpTransferExecutor.php
@@ -0,0 +1,175 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh;
+
+use App\Framework\Audit\AuditLogger;
+use App\Framework\Audit\ValueObjects\AuditEntry;
+use App\Framework\DateTime\Clock;
+use App\Framework\RateLimit\RateLimiter;
+use App\Framework\RateLimit\RateLimitResult;
+use App\Framework\Retry\RetryManager;
+use App\Framework\Retry\RetryResult;
+use App\Framework\Ssh\Contracts\SftpClient;
+use App\Framework\Ssh\Exceptions\SshRateLimitExceededException;
+use App\Framework\Ssh\ValueObjects\SftpOperationRequest;
+use App\Framework\Ssh\ValueObjects\SshRateLimitPolicy;
+
+/**
+ * Coordinates SFTP transfers with retry, rate limiting, and auditing.
+ */
+final readonly class SftpTransferExecutor
+{
+    public function __construct(
+        private SftpClient $sftpClient,
+        private RetryManager $retryManager,
+        private RateLimiter $rateLimiter,
+        private AuditLogger $auditLogger,
+        private Clock $clock
+    ) {
+    }
+
+    public function transfer(SftpOperationRequest $request): void
+    {
+        $rateLimitResult = $request->rateLimitPolicy !== null
+            ? $this->enforceRateLimit($request->rateLimitPolicy, $request)
+            : null;
+
+        $retryManager = $this->buildRetryManager($request);
+        $retryResult = $retryManager->execute(function () use ($request) {
+            $this->sftpClient->transfer($request->transfer, $request->connection);
+
+            return true;
+        });
+
+        if (! $retryResult->wasSuccessful()) {
+            $this->logFailure($request, $retryResult);
+
+            $exception = $retryResult->lastException ?? new \RuntimeException('SFTP transfer failed without exception context.');
+
+            throw $exception;
+        }
+
+        $this->logSuccess($request, $retryResult, $rateLimitResult);
+    }
+
+    private function enforceRateLimit(
+        SshRateLimitPolicy $policy,
+        SftpOperationRequest $request
+    ): RateLimitResult {
+        $result = $this->rateLimiter->checkLimit(
+            $policy->rateLimitKey($request->connection),
+            $policy->limit(),
+            $policy->windowSeconds()
+        );
+
+        if (! $result->isAllowed()) {
+            throw SshRateLimitExceededException::fromResult($request->connection, $result);
+        }
+
+        return $result;
+    }
+
+    private function buildRetryManager(SftpOperationRequest $request): RetryManager
+    {
+        $retryManager = $request->retryStrategy !== null
+            ? $this->retryManager->withStrategy($request->retryStrategy)
+            : $this->retryManager;
+
+        $context = [
+            'component' => 'sftp.transfer',
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+            'direction' => $request->transfer->direction->value,
+            'remote_path' => $request->transfer->remotePath->toString(),
+        ];
+
+        return $retryManager->withContext($context);
+    }
+
+    private function logSuccess(
+        SftpOperationRequest $request,
+        RetryResult $retryResult,
+        ?RateLimitResult $rateLimit
+    ): void {
+        $auditContext = $request->auditContext;
+
+        if ($auditContext === null) {
+            return;
+        }
+
+        $transfer = $request->transfer;
+
+        $metadata = [
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+            'direction' => $transfer->direction->value,
+            'local_path' => $transfer->localPath->toString(),
+            'remote_path' => $transfer->remotePath->toString(),
+            'attempts' => $retryResult->getAttemptCount(),
+            'total_duration_ms' => (int) $retryResult->getTotalDuration()->toMilliseconds(),
+            'overwrite' => $transfer->overwrite,
+            'create_directories' => $transfer->createDirectories,
+        ];
+
+        if ($rateLimit !== null) {
+            $metadata['rate_limit'] = [
+                'limit' => $rateLimit->getLimit(),
+                'current' => $rateLimit->getCurrent(),
+                'remaining' => $rateLimit->getRemainingRequests(),
+            ];
+        }
+
+        $entry = AuditEntry::create(
+            clock: $this->clock,
+            action: $auditContext->action,
+            entityType: $auditContext->entityType,
+            entityId: $auditContext->entityId,
+            userId: $auditContext->userId,
+            ipAddress: $auditContext->ipAddress,
+            userAgent: $auditContext->userAgent,
+            metadata: array_merge($auditContext->metadata, $metadata)
+        );
+
+        $this->auditLogger->log($entry);
+    }
+
+    private function logFailure(SftpOperationRequest $request, RetryResult $retryResult): void
+    {
+        $auditContext = $request->auditContext;
+
+        if ($auditContext === null) {
+            return;
+        }
+
+        $transfer = $request->transfer;
+
+        $metadata = [
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+            'direction' => $transfer->direction->value,
+            'local_path' => $transfer->localPath->toString(),
+            'remote_path' => $transfer->remotePath->toString(),
+            'attempts' => $retryResult->getAttemptCount(),
+            'history' => $retryResult->attemptHistory,
+        ];
+
+        $entry = AuditEntry::failed(
+            clock: $this->clock,
+            action: $auditContext->action,
+            entityType: $auditContext->entityType,
+            entityId: $auditContext->entityId,
+            errorMessage: $retryResult->lastException?->getMessage() ?? 'SFTP transfer failed.',
+            userId: $auditContext->userId,
+            ipAddress: $auditContext->ipAddress,
+            userAgent: $auditContext->userAgent,
+            metadata: array_merge($auditContext->metadata, $metadata)
+        );
+
+        $this->auditLogger->log($entry);
+    }
+}
diff --git a/src/Framework/Ssh/SshCommandExecutor.php b/src/Framework/Ssh/SshCommandExecutor.php
new file mode 100644
index 00000000..b1d334d1
--- /dev/null
+++ b/src/Framework/Ssh/SshCommandExecutor.php
@@ -0,0 +1,171 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh;
+
+use App\Framework\Audit\AuditLogger;
+use App\Framework\Audit\ValueObjects\AuditEntry;
+use App\Framework\DateTime\Clock;
+use App\Framework\RateLimit\RateLimiter;
+use App\Framework\RateLimit\RateLimitResult;
+use App\Framework\Ssh\Contracts\SshClient;
+use App\Framework\Ssh\Exceptions\SshRateLimitExceededException;
+use App\Framework\Ssh\ValueObjects\SshCommandRequest;
+use App\Framework\Ssh\ValueObjects\SshCommandResult;
+use App\Framework\Ssh\ValueObjects\SshRateLimitPolicy;
+use App\Framework\Retry\RetryManager;
+use App\Framework\Retry\RetryResult;
+
+/**
+ * Coordinates SSH command execution with retry, rate limiting, and auditing hooks.
+ */
+final readonly class SshCommandExecutor
+{
+    public function __construct(
+        private SshClient $sshClient,
+        private RetryManager $retryManager,
+        private RateLimiter $rateLimiter,
+        private AuditLogger $auditLogger,
+        private Clock $clock
+    ) {
+    }
+
+    public function execute(SshCommandRequest $request): SshCommandResult
+    {
+        $rateLimitPolicy = $request->rateLimitPolicy;
+        $rateLimitResult = $rateLimitPolicy !== null
+            ? $this->enforceRateLimit($rateLimitPolicy, $request)
+            : null;
+
+        $retryManager = $this->buildRetryManager($request);
+        $retryResult = $retryManager->execute(function () use ($request) {
+            return $this->sshClient->execute($request->command, $request->connection);
+        });
+
+        if (! $retryResult->wasSuccessful()) {
+            $this->logFailure($request, $retryResult);
+
+            $exception = $retryResult->lastException ?? new \RuntimeException('SSH command failed without exception context.');
+
+            throw $exception;
+        }
+
+        /** @var SshCommandResult $commandResult */
+        $commandResult = $retryResult->getResult();
+
+        $this->logSuccess($request, $commandResult, $retryResult, $rateLimitResult);
+
+        return $commandResult;
+    }
+
+    private function enforceRateLimit(
+        SshRateLimitPolicy $policy,
+        SshCommandRequest $request
+    ): RateLimitResult {
+        $result = $this->rateLimiter->checkLimit(
+            $policy->rateLimitKey($request->connection),
+            $policy->limit(),
+            $policy->windowSeconds()
+        );
+
+        if (! $result->isAllowed()) {
+            throw SshRateLimitExceededException::fromResult($request->connection, $result);
+        }
+
+        return $result;
+    }
+
+    private function buildRetryManager(SshCommandRequest $request): RetryManager
+    {
+        $retryManager = $request->retryStrategy !== null
+            ? $this->retryManager->withStrategy($request->retryStrategy)
+            : $this->retryManager;
+
+        $context = [
+            'component' => 'ssh.command',
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+        ];
+
+        return $retryManager->withContext($context);
+    }
+
+    private function logSuccess(
+        SshCommandRequest $request,
+        SshCommandResult $result,
+        RetryResult $retryResult,
+        ?RateLimitResult $rateLimit
+    ): void {
+        $auditContext = $request->auditContext;
+
+        if ($auditContext === null) {
+            return;
+        }
+
+        $metadata = [
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+            'command' => $request->command->statement(),
+            'exit_code' => $result->exitCode(),
+            'attempts' => $retryResult->getAttemptCount(),
+            'command_duration_ms' => (int) $result->duration()->toMilliseconds(),
+            'total_duration_ms' => (int) $retryResult->getTotalDuration()->toMilliseconds(),
+        ];
+
+        if ($rateLimit !== null) {
+            $metadata['rate_limit'] = [
+                'limit' => $rateLimit->getLimit(),
+                'current' => $rateLimit->getCurrent(),
+                'remaining' => $rateLimit->getRemainingRequests(),
+            ];
+        }
+
+        $entry = AuditEntry::create(
+            clock: $this->clock,
+            action: $auditContext->action,
+            entityType: $auditContext->entityType,
+            entityId: $auditContext->entityId,
+            userId: $auditContext->userId,
+            ipAddress: $auditContext->ipAddress,
+            userAgent: $auditContext->userAgent,
+            metadata: array_merge($auditContext->metadata, $metadata)
+        );
+
+        $this->auditLogger->log($entry);
+    }
+
+    private function logFailure(SshCommandRequest $request, RetryResult $retryResult): void
+    {
+        $auditContext = $request->auditContext;
+
+        if ($auditContext === null) {
+            return;
+        }
+
+        $metadata = [
+            'host' => $request->connection->host->toString(),
+            'port' => $request->connection->port->toInt(),
+            'username' => $request->connection->username->toString(),
+            'command' => $request->command->statement(),
+            'attempts' => $retryResult->getAttemptCount(),
+            'history' => $retryResult->attemptHistory,
+        ];
+
+        $entry = AuditEntry::failed(
+            clock: $this->clock,
+            action: $auditContext->action,
+            entityType: $auditContext->entityType,
+            entityId: $auditContext->entityId,
+            errorMessage: $retryResult->lastException?->getMessage() ?? 'SSH command execution failed.',
+            userId: $auditContext->userId,
+            ipAddress: $auditContext->ipAddress,
+            userAgent: $auditContext->userAgent,
+            metadata: array_merge($auditContext->metadata, $metadata)
+        );
+
+        $this->auditLogger->log($entry);
+    }
+}
diff --git a/src/Framework/Ssh/SshInitializer.php b/src/Framework/Ssh/SshInitializer.php
new file mode 100644
index 00000000..58c096f3
--- /dev/null
+++ b/src/Framework/Ssh/SshInitializer.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh;
+
+use App\Framework\DateTime\Clock;
+use App\Framework\DI\Container;
+use App\Framework\DI\Initializer;
+use App\Framework\Process\Process;
+use App\Framework\Ssh\Adapters\ProcessSftpClient;
+use App\Framework\Ssh\Adapters\ProcessSshClient;
+use App\Framework\Ssh\Contracts\SftpClient;
+use App\Framework\Ssh\Contracts\SshClient;
+use App\Framework\Ssh\Support\SshCommandBuilder;
+
+final readonly class SshInitializer
+{
+    #[Initializer]
+    public function initialize(Container $container): void
+    {
+        $container->singleton(SshCommandBuilder::class, static function (Container $container): SshCommandBuilder {
+            return new SshCommandBuilder($container->get(Process::class));
+        });
+
+        $container->singleton(ProcessSshClient::class, static function (Container $container): ProcessSshClient {
+            return new ProcessSshClient(
+                process: $container->get(Process::class),
+                commandBuilder: $container->get(SshCommandBuilder::class),
+                clock: $container->get(Clock::class)
+            );
+        });
+
+        $container->bind(SshClient::class, static fn (Container $container): SshClient => $container->get(ProcessSshClient::class));
+
+        $container->singleton(ProcessSftpClient::class, static function (Container $container): ProcessSftpClient {
+            return new ProcessSftpClient(
+                process: $container->get(Process::class),
+                commandBuilder: $container->get(SshCommandBuilder::class),
+                sshClient: $container->get(ProcessSshClient::class)
+            );
+        });
+
+        $container->bind(SftpClient::class, static fn (Container $container): SftpClient => $container->get(ProcessSftpClient::class));
+    }
+}
diff --git a/src/Framework/Ssh/Support/SshAuthenticationContext.php b/src/Framework/Ssh/Support/SshAuthenticationContext.php
new file mode 100644
index 00000000..a5a3b284
--- /dev/null
+++ b/src/Framework/Ssh/Support/SshAuthenticationContext.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Support;
+
+/**
+ * Internal DTO describing authentication adjustments for ssh/scp commands.
+ *
+ * @internal
+ * @psalm-internal App\Framework\Ssh
+ *
+ * @param list<string> $prefixParts
+ * @param list<string> $rawFlags
+ * @param list<string> $sshOptions
+ * @param array<string, string> $environment
+ * @param list<string> $temporaryFiles
+ */
+final readonly class SshAuthenticationContext
+{
+    public function __construct(
+        public array $prefixParts,
+        public array $rawFlags,
+        public array $sshOptions,
+        public array $environment,
+        public array $temporaryFiles,
+        public bool $batchModeEnabled
+    ) {
+    }
+}
diff --git a/src/Framework/Ssh/Support/SshCommandBuilder.php b/src/Framework/Ssh/Support/SshCommandBuilder.php
new file mode 100644
index 00000000..91a3567f
--- /dev/null
+++ b/src/Framework/Ssh/Support/SshCommandBuilder.php
@@ -0,0 +1,319 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Support;
+
+use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\Process\Process;
+use App\Framework\Process\ValueObjects\Command;
+use App\Framework\Ssh\Exceptions\SshClientException;
+use App\Framework\Ssh\ValueObjects\AgentAuthentication;
+use App\Framework\Ssh\ValueObjects\PasswordAuthentication;
+use App\Framework\Ssh\ValueObjects\PrivateKeyAuthentication;
+use App\Framework\Ssh\ValueObjects\SftpPath;
+use App\Framework\Ssh\ValueObjects\SshAuthenticationMethod;
+use App\Framework\Ssh\ValueObjects\SshAuthenticationType;
+use App\Framework\Ssh\ValueObjects\SshConnectionConfig;
+
+/**
+ * Builds process commands for `ssh` and `scp` invocations.
+ */
+final class SshCommandBuilder
+{
+    private const string SSH_BINARY = 'ssh';
+
+    private const string SCP_BINARY = 'scp';
+
+    private const string SSHPASS_BINARY = 'sshpass';
+
+    public function __construct(
+        private readonly Process $process
+    ) {
+    }
+
+    public function buildSshCommand(
+        SshConnectionConfig $config,
+        ?string $remoteCommand,
+        bool $allocatePty
+    ): SshProcessCommand {
+        $this->ensureBinary(self::SSH_BINARY);
+
+        $auth = $this->buildAuthenticationContext($config->authentication);
+
+        $parts = array_merge(
+            $auth->prefixParts,
+            array_merge(
+                ['ssh'],
+                $this->buildSshFlags($config, $auth->batchModeEnabled, $allocatePty),
+                $auth->rawFlags,
+                $this->buildSshOptionFlags($config, $auth),
+                [$this->formatUserAndHost($config)]
+            )
+        );
+
+        if ($remoteCommand !== null && trim($remoteCommand) !== '') {
+            $parts[] = $remoteCommand;
+        }
+
+        return new SshProcessCommand(
+            Command::fromArray($parts),
+            $auth->environment,
+            $auth->temporaryFiles
+        );
+    }
+
+    public function buildScpCommand(
+        SshConnectionConfig $config,
+        string $source,
+        string $destination
+    ): SshProcessCommand {
+        $this->ensureBinary(self::SCP_BINARY);
+
+        $auth = $this->buildAuthenticationContext($config->authentication);
+
+        $parts = array_merge(
+            $auth->prefixParts,
+            array_merge(
+                ['scp'],
+                $this->buildScpFlags($config, $auth->batchModeEnabled),
+                $auth->rawFlags,
+                $this->buildSshOptionFlags($config, $auth),
+                [$source, $destination]
+            )
+        );
+
+        return new SshProcessCommand(
+            Command::fromArray($parts),
+            $auth->environment,
+            $auth->temporaryFiles
+        );
+    }
+
+    /**
+     * Formats a remote target for SCP transfers.
+     */
+    public function formatRemoteTarget(SshConnectionConfig $config, SftpPath $remotePath): string
+    {
+        return sprintf(
+            '%s:%s',
+            $this->formatUserAndHost($config),
+            $this->escapeRemotePath($remotePath->toString())
+        );
+    }
+
+    private function ensureBinary(string $binary): void
+    {
+        if (! $this->process->commandExists($binary)) {
+            throw SshClientException::missingBinary($binary);
+        }
+    }
+
+    private function buildAuthenticationContext(SshAuthenticationMethod $authentication): SshAuthenticationContext
+    {
+        $prefix = [];
+        $rawFlags = [];
+        $sshOptions = [];
+        $environment = [];
+        $temporaryFiles = [];
+        $batchMode = true;
+
+        $type = $authentication->type();
+
+        if ($type === SshAuthenticationType::PASSWORD) {
+            $this->ensureBinary(self::SSHPASS_BINARY);
+            \assert($authentication instanceof PasswordAuthentication);
+
+            $environment['SSHPASS'] = $authentication->password()->reveal();
+            $prefix = [self::SSHPASS_BINARY, '-e'];
+            $batchMode = false;
+        } elseif (
+            $type === SshAuthenticationType::PRIVATE_KEY
+            || $type === SshAuthenticationType::PRIVATE_KEY_WITH_PASSPHRASE
+        ) {
+            \assert($authentication instanceof PrivateKeyAuthentication);
+
+            $keyPath = $authentication->keyPath();
+            if ($keyPath === null) {
+                $keyPath = $this->createTemporaryKeyFile($authentication);
+                $temporaryFiles[] = $keyPath;
+            }
+
+            $rawFlags[] = '-i';
+            $rawFlags[] = $keyPath;
+
+            if ($authentication->passphrase() !== null) {
+                $this->ensureBinary(self::SSHPASS_BINARY);
+                $environment['SSHPASS'] = $authentication->passphrase()->reveal();
+                $prefix = [self::SSHPASS_BINARY, '-e', '-P', 'passphrase'];
+                $batchMode = false;
+            }
+        } elseif ($type === SshAuthenticationType::SSH_AGENT) {
+            \assert($authentication instanceof AgentAuthentication);
+
+            if ($authentication->socketPath() !== null) {
+                $environment['SSH_AUTH_SOCK'] = $authentication->socketPath();
+            }
+
+            if ($authentication->allowsForwarding()) {
+                $sshOptions[] = 'ForwardAgent=yes';
+            }
+        } else {
+            throw SshClientException::unsupportedAuthentication($type);
+        }
+
+        return new SshAuthenticationContext(
+            prefixParts: $prefix,
+            rawFlags: $rawFlags,
+            sshOptions: $sshOptions,
+            environment: $environment,
+            temporaryFiles: $temporaryFiles,
+            batchModeEnabled: $batchMode
+        );
+    }
+
+    /**
+     * @return list<string>
+     */
+    private function buildSshFlags(
+        SshConnectionConfig $config,
+        bool $batchMode,
+        bool $allocatePty
+    ): array {
+        $flags = [];
+
+        if ($allocatePty) {
+            $flags[] = '-tt';
+        }
+
+        if ($config->compressionEnabled) {
+            $flags[] = '-C';
+        }
+
+        $flags[] = '-p';
+        $flags[] = (string) $config->port->toInt();
+
+        $flags[] = '-o';
+        $flags[] = sprintf('BatchMode=%s', $batchMode ? 'yes' : 'no');
+
+        return $flags;
+    }
+
+    /**
+     * @return list<string>
+     */
+    private function buildScpFlags(SshConnectionConfig $config, bool $batchMode): array
+    {
+        $flags = [];
+
+        if ($config->compressionEnabled) {
+            $flags[] = '-C';
+        }
+
+        $flags[] = '-P';
+        $flags[] = (string) $config->port->toInt();
+
+        if ($batchMode) {
+            $flags[] = '-B';
+        }
+
+        return $flags;
+    }
+
+    /**
+     * @return list<string>
+     */
+    private function buildSshOptionFlags(SshConnectionConfig $config, SshAuthenticationContext $context): array
+    {
+        $options = [];
+
+        foreach ($context->sshOptions as $option) {
+            $options[] = '-o';
+            $options[] = $option;
+        }
+
+        $options[] = '-o';
+        $options[] = sprintf('TCPKeepAlive=%s', $config->keepAliveEnabled ? 'yes' : 'no');
+
+        if ($config->strictHostKeyChecking) {
+            $options[] = '-o';
+            $options[] = 'StrictHostKeyChecking=yes';
+        } else {
+            $options[] = '-o';
+            $options[] = 'StrictHostKeyChecking=no';
+            $options[] = '-o';
+            $options[] = 'UserKnownHostsFile=/dev/null';
+        }
+
+        if ($config->knownHostsPath() !== null) {
+            $options[] = '-o';
+            $options[] = sprintf('UserKnownHostsFile=%s', $config->knownHostsPath());
+        }
+
+        if ($config->connectionTimeout instanceof Duration) {
+            $options[] = '-o';
+            $options[] = sprintf('ConnectTimeout=%d', $this->durationToSeconds($config->connectionTimeout));
+        }
+
+        if ($config->operationTimeout instanceof Duration) {
+            $interval = max(1, $this->durationToSeconds($config->operationTimeout));
+            $options[] = '-o';
+            $options[] = sprintf('ServerAliveInterval=%d', $interval);
+            $options[] = '-o';
+            $options[] = 'ServerAliveCountMax=1';
+        }
+
+        return $options;
+    }
+
+    private function formatUserAndHost(SshConnectionConfig $config): string
+    {
+        return sprintf(
+            '%s@%s',
+            $config->username->toString(),
+            $config->host->toString()
+        );
+    }
+
+    /**
+     * Converts duration to seconds (minimum 1).
+     */
+    private function durationToSeconds(Duration $duration): int
+    {
+        return max(1, (int) ceil($duration->toSeconds()));
+    }
+
+    private function escapeRemotePath(string $path): string
+    {
+        $replacements = [
+            '\\' => '\\\\',
+            ' ' => '\\ ',
+            "\t" => '\\t',
+            "\n" => '\\n',
+            "\r" => '\\r',
+            "'" => "\\'",
+            '"' => '\\"',
+            '$' => '\\$',
+            '`' => '\\`',
+        ];
+
+        return strtr($path, $replacements);
+    }
+
+    private function createTemporaryKeyFile(PrivateKeyAuthentication $authentication): string
+    {
+        $path = tempnam(sys_get_temp_dir(), 'ssh-key-');
+
+        if ($path === false) {
+            throw SshClientException::invalidRemoteCommand('Unable to create temporary file for private key material.');
+        }
+
+        if (file_put_contents($path, $authentication->privateKey()->reveal()) === false) {
+            throw SshClientException::invalidRemoteCommand('Failed to write private key material to temporary file.');
+        }
+
+        @chmod($path, 0600);
+
+        return $path;
+    }
+}
diff --git a/src/Framework/Ssh/Support/SshProcessCommand.php b/src/Framework/Ssh/Support/SshProcessCommand.php
new file mode 100644
index 00000000..a9c880bc
--- /dev/null
+++ b/src/Framework/Ssh/Support/SshProcessCommand.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\Support;
+
+use App\Framework\Process\ValueObjects\Command;
+
+/**
+ * Encapsulates a prepared process command along with transient resources (env vars, temp files).
+ */
+final class SshProcessCommand
+{
+    private array $previousEnv = [];
+
+    private bool $environmentApplied = false;
+
+    /**
+     * @param array<string, string> $environment
+     * @param list<string> $temporaryFiles
+     */
+    public function __construct(
+        private readonly Command $command,
+        private readonly array $environment = [],
+        private readonly array $temporaryFiles = []
+    ) {
+    }
+
+    public function command(): Command
+    {
+        return $this->command;
+    }
+
+    /**
+     * Applies environment variables prior to process execution.
+     */
+    public function applyEnvironment(): void
+    {
+        if ($this->environmentApplied) {
+            return;
+        }
+
+        foreach ($this->environment as $key => $value) {
+            $current = getenv($key);
+            $this->previousEnv[$key] = $current === false ? null : $current;
+            putenv(sprintf('%s=%s', $key, $value));
+        }
+
+        $this->environmentApplied = true;
+    }
+
+    /**
+     * Restores environment variables and removes temporary files.
+     */
+    public function cleanup(): void
+    {
+        foreach ($this->environment as $key => $_) {
+            if (array_key_exists($key, $this->previousEnv)) {
+                $previous = $this->previousEnv[$key];
+                if ($previous === null) {
+                    putenv($key);
+                } else {
+                    putenv(sprintf('%s=%s', $key, $previous));
+                }
+            } else {
+                putenv($key);
+            }
+        }
+
+        foreach ($this->temporaryFiles as $temporaryFile) {
+            if ($temporaryFile !== '' && is_file($temporaryFile)) {
+                @unlink($temporaryFile);
+            }
+        }
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/AgentAuthentication.php b/src/Framework/Ssh/ValueObjects/AgentAuthentication.php
new file mode 100644
index 00000000..717b31c1
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/AgentAuthentication.php
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * SSH authentication via ssh-agent (forwarded or local).
+ */
+final readonly class AgentAuthentication implements SshAuthenticationMethod
+{
+    private ?string $socketPath;
+
+    public function __construct(
+        ?string $socketPath = null,
+        private bool $allowForwarding = false
+    ) {
+        if ($socketPath !== null) {
+            $trimmed = trim($socketPath);
+            if ($trimmed === '') {
+                throw new InvalidArgumentException('SSH agent socket path must not be empty.');
+            }
+
+            $this->socketPath = $trimmed;
+        } else {
+            $this->socketPath = null;
+        }
+    }
+
+    public function socketPath(): ?string
+    {
+        return $this->socketPath;
+    }
+
+    public function allowsForwarding(): bool
+    {
+        return $this->allowForwarding;
+    }
+
+    public function type(): SshAuthenticationType
+    {
+        return SshAuthenticationType::SSH_AGENT;
+    }
+
+    public function describe(): array
+    {
+        return [
+            'method' => $this->type()->value,
+            'socket_path' => $this->socketPath,
+            'allow_forwarding' => $this->allowForwarding,
+        ];
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/PasswordAuthentication.php b/src/Framework/Ssh/ValueObjects/PasswordAuthentication.php
new file mode 100644
index 00000000..90da24f9
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/PasswordAuthentication.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Vault\ValueObjects\SecretValue;
+
+/**
+ * SSH password-based authentication.
+ */
+final readonly class PasswordAuthentication implements SshAuthenticationMethod
+{
+    public function __construct(
+        private SecretValue $password
+    ) {
+        if ($this->password->isEmpty()) {
+            throw new \InvalidArgumentException('SSH password must not be empty.');
+        }
+    }
+
+    public function password(): SecretValue
+    {
+        return $this->password;
+    }
+
+    public function type(): SshAuthenticationType
+    {
+        return SshAuthenticationType::PASSWORD;
+    }
+
+    public function describe(): array
+    {
+        return [
+            'method' => $this->type()->value,
+            'secret_length' => $this->password->length(),
+        ];
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/PrivateKeyAuthentication.php b/src/Framework/Ssh/ValueObjects/PrivateKeyAuthentication.php
new file mode 100644
index 00000000..bc63eae9
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/PrivateKeyAuthentication.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Vault\ValueObjects\SecretValue;
+use InvalidArgumentException;
+
+/**
+ * SSH private key authentication (optionally protected by passphrase).
+ */
+final readonly class PrivateKeyAuthentication implements SshAuthenticationMethod
+{
+    private ?string $keyPath;
+
+    public function __construct(
+        private SecretValue $privateKey,
+        private ?SecretValue $passphrase = null,
+        ?string $keyPath = null,
+        private ?string $comment = null
+    ) {
+        if ($this->privateKey->isEmpty()) {
+            throw new InvalidArgumentException('Private key must not be empty.');
+        }
+
+        if ($keyPath !== null) {
+            $trimmedPath = trim($keyPath);
+            if ($trimmedPath === '') {
+                throw new InvalidArgumentException('Key path must not be empty when provided.');
+            }
+
+            $this->keyPath = $trimmedPath;
+        } else {
+            $this->keyPath = null;
+        }
+    }
+
+    public function privateKey(): SecretValue
+    {
+        return $this->privateKey;
+    }
+
+    public function passphrase(): ?SecretValue
+    {
+        return $this->passphrase;
+    }
+
+    public function keyPath(): ?string
+    {
+        return $this->keyPath;
+    }
+
+    public function comment(): ?string
+    {
+        return $this->comment;
+    }
+
+    public function type(): SshAuthenticationType
+    {
+        return $this->passphrase === null
+            ? SshAuthenticationType::PRIVATE_KEY
+            : SshAuthenticationType::PRIVATE_KEY_WITH_PASSPHRASE;
+    }
+
+    public function describe(): array
+    {
+        return [
+            'method' => $this->type()->value,
+            'has_passphrase' => $this->passphrase !== null,
+            'key_path' => $this->keyPath,
+            'comment' => $this->comment,
+        ];
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SftpDirectoryEntry.php b/src/Framework/Ssh/ValueObjects/SftpDirectoryEntry.php
new file mode 100644
index 00000000..3ac256bb
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SftpDirectoryEntry.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Core\ValueObjects\Byte;
+use DateTimeImmutable;
+
+/**
+ * Represents a remote file or directory entry in SFTP listings.
+ */
+final readonly class SftpDirectoryEntry
+{
+    public function __construct(
+        public SftpPath $path,
+        public bool $isDirectory,
+        public ?Byte $size = null,
+        public ?DateTimeImmutable $modifiedAt = null,
+        public ?string $owner = null,
+        public ?string $group = null,
+        public ?int $permissions = null
+    ) {
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SftpOperationRequest.php b/src/Framework/Ssh/ValueObjects/SftpOperationRequest.php
new file mode 100644
index 00000000..f2edc419
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SftpOperationRequest.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Retry\RetryStrategy;
+
+/**
+ * Represents a typed SFTP operation with optional retry, rate limit and audit context.
+ */
+final readonly class SftpOperationRequest
+{
+    public function __construct(
+        public SshConnectionConfig $connection,
+        public SftpTransferRequest $transfer,
+        public ?SshRateLimitPolicy $rateLimitPolicy = null,
+        public ?RetryStrategy $retryStrategy = null,
+        public ?SshAuditContext $auditContext = null
+    ) {
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SftpPath.php b/src/Framework/Ssh/ValueObjects/SftpPath.php
new file mode 100644
index 00000000..07e0f5e8
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SftpPath.php
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a path on the remote SFTP server.
+ */
+final readonly class SftpPath
+{
+    private string $value;
+
+    public function __construct(string $path)
+    {
+        $normalized = trim($path);
+
+        if ($normalized === '') {
+            throw new InvalidArgumentException('SFTP path must not be empty.');
+        }
+
+        if (! str_starts_with($normalized, '/')) {
+            throw new InvalidArgumentException("SFTP path '{$normalized}' must be absolute.");
+        }
+
+        if (str_contains($normalized, "\0")) {
+            throw new InvalidArgumentException('SFTP path must not contain null bytes.');
+        }
+
+        $this->value = $normalized;
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SftpTransferDirection.php b/src/Framework/Ssh/ValueObjects/SftpTransferDirection.php
new file mode 100644
index 00000000..a49ac841
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SftpTransferDirection.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+/**
+ * Indicates transfer direction for SFTP operations.
+ */
+enum SftpTransferDirection: string
+{
+    case UPLOAD = 'upload';
+    case DOWNLOAD = 'download';
+}
diff --git a/src/Framework/Ssh/ValueObjects/SftpTransferRequest.php b/src/Framework/Ssh/ValueObjects/SftpTransferRequest.php
new file mode 100644
index 00000000..47c288e7
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SftpTransferRequest.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Filesystem\ValueObjects\FilePath;
+
+/**
+ * Represents a file transfer request via SFTP.
+ */
+final readonly class SftpTransferRequest
+{
+    public function __construct(
+        public SftpTransferDirection $direction,
+        public FilePath $localPath,
+        public SftpPath $remotePath,
+        public bool $overwrite = false,
+        public bool $createDirectories = true
+    ) {
+    }
+
+    public function isUpload(): bool
+    {
+        return $this->direction === SftpTransferDirection::UPLOAD;
+    }
+
+    public function isDownload(): bool
+    {
+        return $this->direction === SftpTransferDirection::DOWNLOAD;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshAuditContext.php b/src/Framework/Ssh/ValueObjects/SshAuditContext.php
new file mode 100644
index 00000000..cff20d4e
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshAuditContext.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Audit\ValueObjects\AuditableAction;
+use App\Framework\Http\IpAddress;
+use App\Framework\UserAgent\UserAgent;
+
+/**
+ * Captures contextual information for auditing SSH operations.
+ */
+final readonly class SshAuditContext
+{
+    /**
+     * @param array<string, mixed> $metadata
+     */
+    public function __construct(
+        public AuditableAction $action,
+        public string $entityType,
+        public ?string $entityId = null,
+        public ?string $userId = null,
+        public ?IpAddress $ipAddress = null,
+        public ?UserAgent $userAgent = null,
+        public array $metadata = []
+    ) {
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshAuthenticationMethod.php b/src/Framework/Ssh/ValueObjects/SshAuthenticationMethod.php
new file mode 100644
index 00000000..19973fd6
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshAuthenticationMethod.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+/**
+ * Marker interface for SSH authentication strategies.
+ */
+interface SshAuthenticationMethod
+{
+    public function type(): SshAuthenticationType;
+
+    /**
+     * Returns non-sensitive metadata describing the authentication method.
+     *
+     * @return array<string, mixed>
+     */
+    public function describe(): array;
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshAuthenticationType.php b/src/Framework/Ssh/ValueObjects/SshAuthenticationType.php
new file mode 100644
index 00000000..f1adb61a
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshAuthenticationType.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+/**
+ * Supported SSH authentication mechanisms.
+ */
+enum SshAuthenticationType: string
+{
+    case PASSWORD = 'password';
+    case PRIVATE_KEY = 'private_key';
+    case PRIVATE_KEY_WITH_PASSPHRASE = 'private_key_with_passphrase';
+    case SSH_AGENT = 'ssh_agent';
+    case HOST_BASED = 'host_based';
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshCommand.php b/src/Framework/Ssh/ValueObjects/SshCommand.php
new file mode 100644
index 00000000..03c026de
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshCommand.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a remote command to be executed over SSH.
+ */
+final readonly class SshCommand
+{
+    private string $statement;
+
+    /**
+     * @var list<SshEnvironmentVariable>
+     */
+    private array $environment;
+
+    public function __construct(
+        string $statement,
+        private bool $allocatePty = false,
+        SshEnvironmentVariable ...$environment
+    ) {
+        $trimmed = trim($statement);
+
+        if ($trimmed === '') {
+            throw new InvalidArgumentException('SSH command must not be empty.');
+        }
+
+        if (str_contains($trimmed, "\0")) {
+            throw new InvalidArgumentException('SSH command must not contain null bytes.');
+        }
+
+        $this->statement = $trimmed;
+        $this->environment = $environment;
+    }
+
+    public function statement(): string
+    {
+        return $this->statement;
+    }
+
+    /**
+     * @return list<SshEnvironmentVariable>
+     */
+    public function environment(): array
+    {
+        return $this->environment;
+    }
+
+    public function allocatePty(): bool
+    {
+        return $this->allocatePty;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshCommandRequest.php b/src/Framework/Ssh/ValueObjects/SshCommandRequest.php
new file mode 100644
index 00000000..1da86e6e
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshCommandRequest.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Retry\RetryStrategy;
+
+/**
+ * Represents a typed request for executing an SSH command.
+ */
+final readonly class SshCommandRequest
+{
+    public function __construct(
+        public SshConnectionConfig $connection,
+        public SshCommand $command,
+        public ?SshRateLimitPolicy $rateLimitPolicy = null,
+        public ?RetryStrategy $retryStrategy = null,
+        public ?SshAuditContext $auditContext = null
+    ) {
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshCommandResult.php b/src/Framework/Ssh/ValueObjects/SshCommandResult.php
new file mode 100644
index 00000000..defed4d7
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshCommandResult.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Core\ValueObjects\Duration;
+use DateTimeImmutable;
+use InvalidArgumentException;
+
+/**
+ * Result of a remote SSH command execution.
+ */
+final readonly class SshCommandResult
+{
+    public function __construct(
+        private string $stdout,
+        private string $stderr,
+        private int $exitCode,
+        private Duration $duration,
+        private ?DateTimeImmutable $startedAt = null,
+        private ?DateTimeImmutable $finishedAt = null
+    ) {
+        if ($exitCode < 0 || $exitCode > 255) {
+            throw new InvalidArgumentException("SSH exit code must be between 0 and 255, got {$exitCode}.");
+        }
+    }
+
+    public function stdout(): string
+    {
+        return $this->stdout;
+    }
+
+    public function stderr(): string
+    {
+        return $this->stderr;
+    }
+
+    public function exitCode(): int
+    {
+        return $this->exitCode;
+    }
+
+    public function duration(): Duration
+    {
+        return $this->duration;
+    }
+
+    public function startedAt(): ?DateTimeImmutable
+    {
+        return $this->startedAt;
+    }
+
+    public function finishedAt(): ?DateTimeImmutable
+    {
+        return $this->finishedAt;
+    }
+
+    public function wasSuccessful(): bool
+    {
+        return $this->exitCode === 0;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshConnectionConfig.php b/src/Framework/Ssh/ValueObjects/SshConnectionConfig.php
new file mode 100644
index 00000000..965b5200
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshConnectionConfig.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use App\Framework\Core\ValueObjects\Duration;
+use InvalidArgumentException;
+
+/**
+ * Aggregates all connection parameters for interacting with a remote SSH server.
+ */
+final readonly class SshConnectionConfig
+{
+    private ?string $knownHostsPath;
+
+    public function __construct(
+        public SshHost $host,
+        public SshPort $port,
+        public SshUsername $username,
+        public SshAuthenticationMethod $authentication,
+        public bool $strictHostKeyChecking = true,
+        public ?SshHostKeyFingerprint $expectedHostKey = null,
+        public ?Duration $connectionTimeout = null,
+        public ?Duration $operationTimeout = null,
+        public bool $compressionEnabled = false,
+        public bool $keepAliveEnabled = true,
+        ?string $knownHostsPath = null
+    ) {
+        if ($connectionTimeout !== null && $connectionTimeout->isZero()) {
+            throw new InvalidArgumentException('Connection timeout must be greater than zero.');
+        }
+
+        if ($operationTimeout !== null && $operationTimeout->isZero()) {
+            throw new InvalidArgumentException('Operation timeout must be greater than zero.');
+        }
+
+        if ($knownHostsPath !== null) {
+            $trimmed = trim($knownHostsPath);
+
+            if ($trimmed === '') {
+                throw new InvalidArgumentException('Known hosts path must not be empty when provided.');
+            }
+
+            $this->knownHostsPath = $trimmed;
+        } else {
+            $this->knownHostsPath = null;
+        }
+    }
+
+    public static function forHost(
+        string $host,
+        string $username,
+        SshAuthenticationMethod $authentication,
+        ?int $port = null
+    ): self {
+        return new self(
+            host: new SshHost($host),
+            port: $port !== null ? new SshPort($port) : SshPort::default(),
+            username: new SshUsername($username),
+            authentication: $authentication
+        );
+    }
+
+    public function knownHostsPath(): ?string
+    {
+        return $this->knownHostsPath;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshEnvironmentVariable.php b/src/Framework/Ssh/ValueObjects/SshEnvironmentVariable.php
new file mode 100644
index 00000000..7dcaf2e7
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshEnvironmentVariable.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a single environment variable for remote command execution.
+ */
+final readonly class SshEnvironmentVariable
+{
+    private string $key;
+
+    private string $value;
+
+    public function __construct(string $key, string $value)
+    {
+        $normalizedKey = trim($key);
+
+        if ($normalizedKey === '') {
+            throw new InvalidArgumentException('Environment variable name must not be empty.');
+        }
+
+        if (! preg_match('/^[A-Z_][A-Z0-9_]*$/', $normalizedKey)) {
+            throw new InvalidArgumentException("Invalid environment variable name '{$normalizedKey}'.");
+        }
+
+        $this->key = $normalizedKey;
+        $this->value = $value;
+    }
+
+    public function key(): string
+    {
+        return $this->key;
+    }
+
+    public function value(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshHost.php b/src/Framework/Ssh/ValueObjects/SshHost.php
new file mode 100644
index 00000000..286d7cd6
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshHost.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents the target host for an SSH connection.
+ */
+final readonly class SshHost
+{
+    private string $value;
+
+    public function __construct(string $host)
+    {
+        $sanitized = trim($host);
+
+        if ($sanitized === '') {
+            throw new InvalidArgumentException('SSH host must not be empty.');
+        }
+
+        if (! self::isValidHost($sanitized)) {
+            throw new InvalidArgumentException("Invalid SSH host '{$sanitized}'.");
+        }
+
+        $this->value = $sanitized;
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    private static function isValidHost(string $host): bool
+    {
+        if (filter_var($host, FILTER_VALIDATE_IP) !== false) {
+            return true;
+        }
+
+        return (bool) preg_match('/^(?=.{1,253}$)(?!-)(?:[a-z0-9-]{0,62}[a-z0-9]\.)+[a-z]{2,}$/i', $host)
+            || $host === 'localhost';
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshHostKeyFingerprint.php b/src/Framework/Ssh/ValueObjects/SshHostKeyFingerprint.php
new file mode 100644
index 00000000..99381e43
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshHostKeyFingerprint.php
@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents the expected host key fingerprint used for verification.
+ */
+final readonly class SshHostKeyFingerprint
+{
+    private string $value;
+
+    public function __construct(string $fingerprint)
+    {
+        $sanitized = strtolower(trim($fingerprint));
+
+        if ($sanitized === '') {
+            throw new InvalidArgumentException('SSH host key fingerprint must not be empty.');
+        }
+
+        if (! self::isValidFingerprint($sanitized)) {
+            throw new InvalidArgumentException("Invalid SSH host key fingerprint '{$sanitized}'.");
+        }
+
+        $this->value = $sanitized;
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    private static function isValidFingerprint(string $fingerprint): bool
+    {
+        if (preg_match('/^([0-9a-f]{2}:){15}[0-9a-f]{2}$/', $fingerprint)) {
+            return true; // SHA-1 style
+        }
+
+        if (preg_match('/^([0-9a-f]{2}:){31}[0-9a-f]{2}$/', $fingerprint)) {
+            return true; // SHA-256 hex representation
+        }
+
+        if (str_starts_with($fingerprint, 'sha256:')) {
+            $encoded = substr($fingerprint, 7);
+
+            return $encoded !== '' && base64_decode($encoded, true) !== false;
+        }
+
+        return false;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshPort.php b/src/Framework/Ssh/ValueObjects/SshPort.php
new file mode 100644
index 00000000..913e237e
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshPort.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a TCP port used for SSH connections.
+ */
+final readonly class SshPort
+{
+    private const int DEFAULT_PORT = 22;
+
+    private int $value;
+
+    public function __construct(int $port)
+    {
+        if ($port < 1 || $port > 65535) {
+            throw new InvalidArgumentException("SSH port must be between 1 and 65535, got {$port}.");
+        }
+
+        $this->value = $port;
+    }
+
+    public static function default(): self
+    {
+        return new self(self::DEFAULT_PORT);
+    }
+
+    public function toInt(): int
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshRateLimitPolicy.php b/src/Framework/Ssh/ValueObjects/SshRateLimitPolicy.php
new file mode 100644
index 00000000..d3d6de3d
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshRateLimitPolicy.php
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Defines rate limiting behaviour for SSH operations.
+ */
+final readonly class SshRateLimitPolicy
+{
+    public function __construct(
+        private int $limit,
+        private float $windowSeconds,
+        private ?string $customKey = null
+    ) {
+        if ($limit < 1) {
+            throw new InvalidArgumentException('Rate limit must be at least 1.');
+        }
+
+        if ($windowSeconds <= 0) {
+            throw new InvalidArgumentException('Rate limit window must be greater than zero.');
+        }
+    }
+
+    public function limit(): int
+    {
+        return $this->limit;
+    }
+
+    public function windowSeconds(): float
+    {
+        return $this->windowSeconds;
+    }
+
+    public function rateLimitKey(SshConnectionConfig $config): string
+    {
+        if ($this->customKey !== null) {
+            return $this->customKey;
+        }
+
+        return sprintf(
+            'ssh:%s@%s:%d',
+            $config->username->toString(),
+            $config->host->toString(),
+            $config->port->toInt()
+        );
+    }
+}
diff --git a/src/Framework/Ssh/ValueObjects/SshUsername.php b/src/Framework/Ssh/ValueObjects/SshUsername.php
new file mode 100644
index 00000000..5e0cfdd4
--- /dev/null
+++ b/src/Framework/Ssh/ValueObjects/SshUsername.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Ssh\ValueObjects;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a remote user name for SSH authentication.
+ */
+final readonly class SshUsername
+{
+    private string $value;
+
+    public function __construct(string $username)
+    {
+        $sanitized = trim($username);
+
+        if ($sanitized === '') {
+            throw new InvalidArgumentException('SSH username must not be empty.');
+        }
+
+        if (strlen($sanitized) > 64) {
+            throw new InvalidArgumentException('SSH username must not exceed 64 characters.');
+        }
+
+        $this->value = $sanitized;
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/StaticSite/StaticSiteMapper.php b/src/Framework/StaticSite/StaticSiteMapper.php
index 0817c4e9..39efb846 100644
--- a/src/Framework/StaticSite/StaticSiteMapper.php
+++ b/src/Framework/StaticSite/StaticSiteMapper.php
@@ -7,8 +7,8 @@ namespace App\Framework\StaticSite;
 use App\Framework\Attributes\Route;
 use App\Framework\Attributes\StaticPage;
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 final readonly class StaticSiteMapper implements AttributeMapper
 {
diff --git a/src/Framework/Storage/Exceptions/BucketNotFoundException.php b/src/Framework/Storage/Exceptions/BucketNotFoundException.php
index 0280fe5a..6005415f 100644
--- a/src/Framework/Storage/Exceptions/BucketNotFoundException.php
+++ b/src/Framework/Storage/Exceptions/BucketNotFoundException.php
@@ -4,27 +4,19 @@ declare(strict_types=1);
 
 namespace App\Framework\Storage\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception thrown when a bucket is not found
  */
 final class BucketNotFoundException extends StorageException
 {
     public function __construct(
-        string $bucket,
+        private readonly string $bucket,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('storage.bucket', 'ObjectStorage')
-            ->withData(['bucket' => $bucket]);
-
         parent::__construct(
-            message: "Bucket not found: {$bucket}",
-            context: $context,
-            errorCode: ErrorCode::NOT_FOUND,
-            previous: $previous,
-            code: 404
+            "Bucket not found: {$bucket}",
+            404,
+            $previous
         );
     }
 
@@ -35,7 +27,7 @@ final class BucketNotFoundException extends StorageException
 
     public function getBucket(): string
     {
-        return $this->getContext()->getData()['bucket'] ?? '';
+        return $this->bucket;
     }
 }
 
diff --git a/src/Framework/Storage/Exceptions/ObjectNotFoundException.php b/src/Framework/Storage/Exceptions/ObjectNotFoundException.php
index af57b81e..951b6af8 100644
--- a/src/Framework/Storage/Exceptions/ObjectNotFoundException.php
+++ b/src/Framework/Storage/Exceptions/ObjectNotFoundException.php
@@ -4,31 +4,20 @@ declare(strict_types=1);
 
 namespace App\Framework\Storage\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception thrown when an object is not found in storage
  */
 final class ObjectNotFoundException extends StorageException
 {
     public function __construct(
-        string $bucket,
-        string $key,
+        private readonly string $bucket,
+        private readonly string $key,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('storage.get', 'ObjectStorage')
-            ->withData([
-                'bucket' => $bucket,
-                'key' => $key,
-            ]);
-
         parent::__construct(
-            message: "Object not found: {$bucket}/{$key}",
-            context: $context,
-            errorCode: ErrorCode::NOT_FOUND,
-            previous: $previous,
-            code: 404
+            "Object not found: {$bucket}/{$key}",
+            404,
+            $previous
         );
     }
 
@@ -39,12 +28,12 @@ final class ObjectNotFoundException extends StorageException
 
     public function getBucket(): string
     {
-        return $this->getContext()->getData()['bucket'] ?? '';
+        return $this->bucket;
     }
 
     public function getKey(): string
     {
-        return $this->getContext()->getData()['key'] ?? '';
+        return $this->key;
     }
 }
 
diff --git a/src/Framework/Storage/Exceptions/StorageConnectionException.php b/src/Framework/Storage/Exceptions/StorageConnectionException.php
index 6b9b2593..926faf5e 100644
--- a/src/Framework/Storage/Exceptions/StorageConnectionException.php
+++ b/src/Framework/Storage/Exceptions/StorageConnectionException.php
@@ -4,36 +4,25 @@ declare(strict_types=1);
 
 namespace App\Framework\Storage\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception thrown when storage connection fails
  */
 final class StorageConnectionException extends StorageException
 {
     public function __construct(
-        string $endpoint,
+        private readonly string $endpoint,
         string $reason = '',
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('storage.connect', 'Storage')
-            ->withData([
-                'endpoint' => $endpoint,
-                'reason' => $reason,
-            ]);
-
         $message = "Failed to connect to storage endpoint: {$endpoint}";
         if ($reason !== '') {
             $message .= " ({$reason})";
         }
 
         parent::__construct(
-            message: $message,
-            context: $context,
-            errorCode: ErrorCode::CONNECTION_FAILED,
-            previous: $previous,
-            code: 503
+            $message,
+            503,
+            $previous
         );
     }
 
@@ -44,7 +33,7 @@ final class StorageConnectionException extends StorageException
 
     public function getEndpoint(): string
     {
-        return $this->getContext()->getData()['endpoint'] ?? '';
+        return $this->endpoint;
     }
 }
 
diff --git a/src/Framework/Storage/Exceptions/StorageException.php b/src/Framework/Storage/Exceptions/StorageException.php
index 26a940eb..720a1456 100644
--- a/src/Framework/Storage/Exceptions/StorageException.php
+++ b/src/Framework/Storage/Exceptions/StorageException.php
@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Storage\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\ExceptionMetadata;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -16,34 +13,15 @@ use App\Framework\Exception\FrameworkException;
  */
 class StorageException extends FrameworkException
 {
-    public function __construct(
-        string $message,
-        ExceptionContext $context,
-        ?ErrorCode $errorCode = null,
-        ?\Throwable $previous = null,
-        int $code = 0,
-        ?ExceptionMetadata $metadata = null
-    ) {
-        parent::__construct($message, $context, $code, $previous, $errorCode, $metadata);
-    }
-
     /**
      * Create exception for bucket/key not found
      */
     public static function notFound(string $bucket, string $key, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('storage.get', 'Storage')
-            ->withData([
-                'bucket' => $bucket,
-                'key' => $key,
-            ]);
-
         return new self(
-            message: "Object not found: {$bucket}/{$key}",
-            context: $context,
-            errorCode: ErrorCode::NOT_FOUND,
-            previous: $previous,
-            code: 404
+            "Object not found: {$bucket}/{$key}",
+            404,
+            $previous
         );
     }
 
@@ -52,15 +30,10 @@ class StorageException extends FrameworkException
      */
     public static function connectionFailed(string $endpoint, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('storage.connect', 'Storage')
-            ->withData(['endpoint' => $endpoint]);
-
         return new self(
-            message: "Failed to connect to storage endpoint: {$endpoint}",
-            context: $context,
-            errorCode: ErrorCode::CONNECTION_FAILED,
-            previous: $previous,
-            code: 503
+            "Failed to connect to storage endpoint: {$endpoint}",
+            503,
+            $previous
         );
     }
 
@@ -69,18 +42,10 @@ class StorageException extends FrameworkException
      */
     public static function operationFailed(string $operation, string $bucket, string $key, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation("storage.{$operation}", 'Storage')
-            ->withData([
-                'bucket' => $bucket,
-                'key' => $key,
-            ]);
-
         return new self(
-            message: "Storage operation failed: {$operation} on {$bucket}/{$key}",
-            context: $context,
-            errorCode: ErrorCode::OPERATION_FAILED,
-            previous: $previous,
-            code: 500
+            "Storage operation failed: {$operation} on {$bucket}/{$key}",
+            500,
+            $previous
         );
     }
 }
diff --git a/src/Framework/Storage/Exceptions/StorageOperationException.php b/src/Framework/Storage/Exceptions/StorageOperationException.php
index 21b7d880..ce6cefc1 100644
--- a/src/Framework/Storage/Exceptions/StorageOperationException.php
+++ b/src/Framework/Storage/Exceptions/StorageOperationException.php
@@ -4,39 +4,27 @@ declare(strict_types=1);
 
 namespace App\Framework\Storage\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
-
 /**
  * Exception thrown when a storage operation fails
  */
 final class StorageOperationException extends StorageException
 {
     public function __construct(
-        string $operation,
-        string $bucket,
-        string $key,
+        private readonly string $operation,
+        private readonly string $bucket,
+        private readonly string $key,
         string $reason = '',
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation("storage.{$operation}", 'Storage')
-            ->withData([
-                'bucket' => $bucket,
-                'key' => $key,
-                'reason' => $reason,
-            ]);
-
         $message = "Storage operation '{$operation}' failed for {$bucket}/{$key}";
         if ($reason !== '') {
             $message .= ": {$reason}";
         }
 
         parent::__construct(
-            message: $message,
-            context: $context,
-            errorCode: ErrorCode::OPERATION_FAILED,
-            previous: $previous,
-            code: 500
+            $message,
+            500,
+            $previous
         );
     }
 
@@ -47,17 +35,17 @@ final class StorageOperationException extends StorageException
 
     public function getOperation(): string
     {
-        return $this->getContext()->getOperation();
+        return $this->operation;
     }
 
     public function getBucket(): string
     {
-        return $this->getContext()->getData()['bucket'] ?? '';
+        return $this->bucket;
     }
 
     public function getKey(): string
     {
-        return $this->getContext()->getData()['key'] ?? '';
+        return $this->key;
     }
 }
 
diff --git a/src/Framework/String/ValueObjects/AlphanumericString.php b/src/Framework/String/ValueObjects/AlphanumericString.php
new file mode 100644
index 00000000..df3f1e6a
--- /dev/null
+++ b/src/Framework/String/ValueObjects/AlphanumericString.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Alphanumeric string - guaranteed to contain only letters and numbers
+ *
+ * @example
+ * ```php
+ * $username = AlphanumericString::fromString('user123');
+ * echo $username->value; // "user123"
+ * ```
+ */
+final readonly class AlphanumericString
+{
+    public function __construct(
+        public string $value
+    ) {
+        TypedString::fromString($value)
+            ->validate()
+            ->alphanumeric('String must be alphanumeric')
+            ->notEmpty('String must not be empty')
+            ->orThrow();
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Convert to TypedString for additional operations
+     */
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/HexadecimalString.php b/src/Framework/String/ValueObjects/HexadecimalString.php
new file mode 100644
index 00000000..772f7448
--- /dev/null
+++ b/src/Framework/String/ValueObjects/HexadecimalString.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Hexadecimal string - guaranteed to be valid hex
+ *
+ * @example
+ * ```php
+ * $hash = HexadecimalString::fromString('deadbeef');
+ * $binary = $hash->toBinary();
+ * $int = $hash->toInt(); // 3735928559
+ * ```
+ */
+final readonly class HexadecimalString
+{
+    public function __construct(
+        public string $value
+    ) {
+        TypedString::fromString($value)
+            ->validate()
+            ->hexadecimal('String must be valid hexadecimal')
+            ->notEmpty('String must not be empty')
+            ->orThrow();
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Convert hexadecimal to binary
+     */
+    public function toBinary(): string
+    {
+        $binary = hex2bin($this->value);
+
+        if ($binary === false) {
+            throw new \RuntimeException('Failed to convert hexadecimal to binary');
+        }
+
+        return $binary;
+    }
+
+    /**
+     * Convert hexadecimal to integer
+     */
+    public function toInt(): int
+    {
+        return hexdec($this->value);
+    }
+
+    /**
+     * Convert to TypedString for additional operations
+     */
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/NumericString.php b/src/Framework/String/ValueObjects/NumericString.php
new file mode 100644
index 00000000..789ef976
--- /dev/null
+++ b/src/Framework/String/ValueObjects/NumericString.php
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Numeric string - guaranteed to contain only digits
+ *
+ * @example
+ * ```php
+ * $orderId = NumericString::fromString('12345');
+ * $orderNumber = $orderId->toInt(); // 12345
+ * ```
+ */
+final readonly class NumericString
+{
+    public function __construct(
+        public string $value
+    ) {
+        TypedString::fromString($value)
+            ->validate()
+            ->digits('String must contain only digits')
+            ->notEmpty('String must not be empty')
+            ->orThrow();
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Convert to integer
+     */
+    public function toInt(): int
+    {
+        return (int) $this->value;
+    }
+
+    /**
+     * Convert to float
+     */
+    public function toFloat(): float
+    {
+        return (float) $this->value;
+    }
+
+    /**
+     * Convert to TypedString for additional operations
+     */
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/PosixAlphaString.php b/src/Framework/String/ValueObjects/PosixAlphaString.php
new file mode 100644
index 00000000..c30b43b5
--- /dev/null
+++ b/src/Framework/String/ValueObjects/PosixAlphaString.php
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Alphabetic-only string using POSIX [:alpha:] class
+ *
+ * Locale-aware validation - supports international letters:
+ * - German: ü, ä, ö, ß
+ * - French: é, è, ê, à, ç
+ * - Spanish: ñ, á, í, ó, ú
+ *
+ * @example User names with international characters
+ * ```php
+ * setlocale(LC_CTYPE, 'de_DE.UTF-8');
+ * $name = PosixAlphaString::fromString('Müller'); // Valid
+ * ```
+ *
+ * @example Validation
+ * ```php
+ * PosixAlphaString::fromString('John123'); // Throws - contains digits
+ * PosixAlphaString::fromString('John-Doe'); // Throws - contains hyphen
+ * ```
+ */
+final readonly class PosixAlphaString
+{
+    public function __construct(
+        public string $value
+    ) {
+        PosixString::fromString($value)
+            ->isAlpha() ?: throw new \InvalidArgumentException(
+                'String must contain only POSIX alphabetic characters'
+            );
+
+        if (empty($value)) {
+            throw new \InvalidArgumentException('String must not be empty');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function toPosixString(): PosixString
+    {
+        return PosixString::fromString($this->value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/PosixString.php b/src/Framework/String/ValueObjects/PosixString.php
new file mode 100644
index 00000000..ca7a68d7
--- /dev/null
+++ b/src/Framework/String/ValueObjects/PosixString.php
@@ -0,0 +1,271 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * POSIX Character Class Validation
+ *
+ * Wraps POSIX character classes for precise, locale-aware string validation.
+ * POSIX character classes are more powerful than ctype_* functions because they:
+ * - Support international/Unicode characters through locale
+ * - Work directly in regex patterns for complex validation
+ * - Provide character classes not available in ctype (punct, word, graph)
+ *
+ * Available POSIX Character Classes:
+ * - [:alnum:]  - Alphanumeric characters (letters + digits)
+ * - [:alpha:]  - Alphabetic characters only
+ * - [:ascii:]  - ASCII characters (0-127)
+ * - [:blank:]  - Space and tab only
+ * - [:cntrl:]  - Control characters
+ * - [:digit:]  - Decimal digits (0-9)
+ * - [:graph:]  - Visible characters (excluding space)
+ * - [:lower:]  - Lowercase letters (locale-aware)
+ * - [:print:]  - Printable characters (including space)
+ * - [:punct:]  - Punctuation characters
+ * - [:space:]  - Whitespace characters (space, tab, newline, etc.)
+ * - [:upper:]  - Uppercase letters (locale-aware)
+ * - [:xdigit:] - Hexadecimal digits (0-9, A-F, a-f)
+ * - [:word:]   - Word characters (alphanumeric + underscore)
+ *
+ * @example Locale-aware validation
+ * ```php
+ * setlocale(LC_CTYPE, 'de_DE.UTF-8');
+ * $str = PosixString::fromString('Müller'); // German name
+ * $str->isAlpha(); // true - supports ü, ä, ö
+ * ```
+ *
+ * @example Complex validation
+ * ```php
+ * $username = PosixString::fromString('user_123');
+ * $username->isWord(); // true - alphanumeric + underscore
+ * ```
+ */
+final readonly class PosixString
+{
+    public function __construct(
+        public string $value
+    ) {}
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    // ========================================
+    // POSIX Character Class Validations
+    // ========================================
+
+    /**
+     * Check if string contains only alphanumeric characters
+     * Combines [:alpha:] and [:digit:]
+     * Locale-aware for international letters
+     */
+    public function isAlnum(): bool
+    {
+        return $this->matchesPosixClass('alnum');
+    }
+
+    /**
+     * Check if string contains only alphabetic characters
+     * Locale-aware - supports international letters (é, ü, ñ, etc.)
+     */
+    public function isAlpha(): bool
+    {
+        return $this->matchesPosixClass('alpha');
+    }
+
+    /**
+     * Check if string contains only ASCII characters (0-127)
+     * Excludes extended ASCII and Unicode
+     */
+    public function isAscii(): bool
+    {
+        return $this->matchesPosixClass('ascii');
+    }
+
+    /**
+     * Check if string contains only blank characters (space and tab)
+     * More restrictive than isSpace() - excludes newlines
+     */
+    public function isBlank(): bool
+    {
+        return $this->matchesPosixClass('blank');
+    }
+
+    /**
+     * Check if string contains only control characters
+     * Includes ASCII 0-31 and 127
+     */
+    public function isCntrl(): bool
+    {
+        return $this->matchesPosixClass('cntrl');
+    }
+
+    /**
+     * Check if string contains only decimal digits (0-9)
+     */
+    public function isDigit(): bool
+    {
+        return $this->matchesPosixClass('digit');
+    }
+
+    /**
+     * Check if string contains only visible (graphical) characters
+     * Excludes space but includes all other printable characters
+     */
+    public function isGraph(): bool
+    {
+        return $this->matchesPosixClass('graph');
+    }
+
+    /**
+     * Check if string contains only lowercase letters
+     * Locale-aware - supports international lowercase (é, ü, ñ, etc.)
+     */
+    public function isLower(): bool
+    {
+        return $this->matchesPosixClass('lower');
+    }
+
+    /**
+     * Check if string contains only printable characters
+     * Includes space and all visible characters
+     */
+    public function isPrint(): bool
+    {
+        return $this->matchesPosixClass('print');
+    }
+
+    /**
+     * Check if string contains only punctuation characters
+     * Includes: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
+     */
+    public function isPunct(): bool
+    {
+        return $this->matchesPosixClass('punct');
+    }
+
+    /**
+     * Check if string contains only whitespace characters
+     * Includes: space, tab, newline, carriage return, form feed, vertical tab
+     */
+    public function isSpace(): bool
+    {
+        return $this->matchesPosixClass('space');
+    }
+
+    /**
+     * Check if string contains only uppercase letters
+     * Locale-aware - supports international uppercase (É, Ü, Ñ, etc.)
+     */
+    public function isUpper(): bool
+    {
+        return $this->matchesPosixClass('upper');
+    }
+
+    /**
+     * Check if string contains only hexadecimal digits
+     * Includes: 0-9, A-F, a-f
+     */
+    public function isXdigit(): bool
+    {
+        return $this->matchesPosixClass('xdigit');
+    }
+
+    /**
+     * Check if string contains only word characters
+     * Includes: alphanumeric + underscore (_)
+     * Perfect for validating identifiers, usernames, etc.
+     */
+    public function isWord(): bool
+    {
+        return $this->matchesPosixClass('word');
+    }
+
+    // ========================================
+    // Helper Methods
+    // ========================================
+
+    /**
+     * Check if entire string matches POSIX character class
+     */
+    private function matchesPosixClass(string $class): bool
+    {
+        if (empty($this->value)) {
+            return false;
+        }
+
+        return preg_match('/^[[:' . $class . ':]]+$/', $this->value) === 1;
+    }
+
+    /**
+     * Check if string contains at least one character from POSIX class
+     * Useful for "contains" checks vs "is only" checks
+     */
+    public function containsPosixClass(string $class): bool
+    {
+        return preg_match('/[[:' . $class . ':]]/', $this->value) === 1;
+    }
+
+    /**
+     * Count characters matching POSIX character class
+     */
+    public function countPosixClass(string $class): int
+    {
+        preg_match_all('/[[:' . $class . ':]]/', $this->value, $matches);
+        return count($matches[0]);
+    }
+
+    /**
+     * Remove all characters NOT matching POSIX character class
+     * Returns new PosixString with only matching characters
+     */
+    public function filterByPosixClass(string $class): self
+    {
+        $filtered = preg_replace('/[^[:' . $class . ':]]/', '', $this->value);
+        return new self($filtered ?? '');
+    }
+
+    // ========================================
+    // Conversion Methods
+    // ========================================
+
+    /**
+     * Convert to TypedString for fluent validation
+     */
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    // ========================================
+    // Comparison Methods
+    // ========================================
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function isEmpty(): bool
+    {
+        return $this->value === '';
+    }
+
+    public function isNotEmpty(): bool
+    {
+        return $this->value !== '';
+    }
+}
diff --git a/src/Framework/String/ValueObjects/PosixWordString.php b/src/Framework/String/ValueObjects/PosixWordString.php
new file mode 100644
index 00000000..cd72ae64
--- /dev/null
+++ b/src/Framework/String/ValueObjects/PosixWordString.php
@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Word characters string using POSIX [:word:] class
+ *
+ * POSIX [:word:] = alphanumeric + underscore
+ * Perfect for identifiers, usernames, slugs
+ *
+ * Valid Examples:
+ * - Identifiers: user_id, product_name, MAX_VALUE
+ * - Usernames: john_doe, user123, admin_user
+ * - Slugs: my_blog_post, product_category_1
+ *
+ * @example Usernames
+ * ```php
+ * $username = PosixWordString::fromString('john_doe123');
+ * // Valid: alphanumeric + underscore
+ * ```
+ *
+ * @example PHP Identifiers
+ * ```php
+ * $identifier = PosixWordString::fromString('MAX_TIMEOUT_SECONDS');
+ * // Valid: PHP constant naming
+ * ```
+ *
+ * @example Validation
+ * ```php
+ * PosixWordString::fromString('user-name'); // Throws - contains hyphen
+ * PosixWordString::fromString('user name'); // Throws - contains space
+ * PosixWordString::fromString('user@email'); // Throws - contains @
+ * ```
+ */
+final readonly class PosixWordString
+{
+    public function __construct(
+        public string $value
+    ) {
+        PosixString::fromString($value)
+            ->isWord() ?: throw new \InvalidArgumentException(
+                'String must contain only POSIX word characters (alphanumeric + underscore)'
+            );
+
+        if (empty($value)) {
+            throw new \InvalidArgumentException('String must not be empty');
+        }
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function toPosixString(): PosixString
+    {
+        return PosixString::fromString($this->value);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/PrintableString.php b/src/Framework/String/ValueObjects/PrintableString.php
new file mode 100644
index 00000000..69cf5910
--- /dev/null
+++ b/src/Framework/String/ValueObjects/PrintableString.php
@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Printable string - guaranteed to contain only printable characters
+ *
+ * Printable characters include all visible characters and whitespace,
+ * but exclude control characters.
+ *
+ * @example
+ * ```php
+ * $text = PrintableString::fromString('Hello World!');
+ * echo $text->value; // "Hello World!"
+ * ```
+ */
+final readonly class PrintableString
+{
+    public function __construct(
+        public string $value
+    ) {
+        TypedString::fromString($value)
+            ->validate()
+            ->printable('String must contain only printable characters')
+            ->notEmpty('String must not be empty')
+            ->orThrow();
+    }
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Convert to TypedString for additional operations
+     */
+    public function toTypedString(): TypedString
+    {
+        return TypedString::fromString($this->value);
+    }
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/TypedString.php b/src/Framework/String/ValueObjects/TypedString.php
new file mode 100644
index 00000000..6f7d54fe
--- /dev/null
+++ b/src/Framework/String/ValueObjects/TypedString.php
@@ -0,0 +1,300 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Type-safe string validation wrapper
+ *
+ * Provides type-safe alternatives to ctype_* functions with
+ * fluent validation chains and framework-compliant patterns.
+ *
+ * @example
+ * ```php
+ * // Basic validation
+ * $input = TypedString::fromString($_POST['username']);
+ * if ($input->isAlphanumeric()) {
+ *     // Valid username
+ * }
+ *
+ * // Fluent validation
+ * TypedString::fromString($_POST['username'])
+ *     ->validate()
+ *     ->alphanumeric()
+ *     ->lengthBetween(3, 20)
+ *     ->orThrow('Invalid username format');
+ * ```
+ */
+final readonly class TypedString
+{
+    private function __construct(
+        public string $value
+    ) {}
+
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    // ===== Character Type Checks =====
+
+    /**
+     * Check if all characters are alphanumeric (letters and digits)
+     */
+    public function isAlphanumeric(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_alnum($this->value);
+    }
+
+    /**
+     * Check if all characters are alphabetic (letters only)
+     */
+    public function isAlphabetic(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_alpha($this->value);
+    }
+
+    /**
+     * Check if all characters are digits (0-9)
+     */
+    public function isDigits(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_digit($this->value);
+    }
+
+    /**
+     * Check if all characters are lowercase letters
+     */
+    public function isLowercase(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_lower($this->value);
+    }
+
+    /**
+     * Check if all characters are uppercase letters
+     */
+    public function isUppercase(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_upper($this->value);
+    }
+
+    /**
+     * Check if all characters are whitespace
+     */
+    public function isWhitespace(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_space($this->value);
+    }
+
+    /**
+     * Check if all characters are printable
+     * (includes whitespace but excludes control characters)
+     */
+    public function isPrintable(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_print($this->value);
+    }
+
+    /**
+     * Check if all characters are control characters
+     */
+    public function isControlCharacters(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_cntrl($this->value);
+    }
+
+    /**
+     * Check if all characters are hexadecimal digits (0-9, a-f, A-F)
+     */
+    public function isHexadecimal(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_xdigit($this->value);
+    }
+
+    /**
+     * Check if all characters are punctuation
+     */
+    public function isPunctuation(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_punct($this->value);
+    }
+
+    /**
+     * Check if all characters are visible (non-whitespace printable)
+     */
+    public function isVisible(): bool
+    {
+        if ($this->isEmpty()) {
+            return false;
+        }
+
+        return ctype_graph($this->value);
+    }
+
+    // ===== Length Checks =====
+
+    /**
+     * Check if string is empty
+     */
+    public function isEmpty(): bool
+    {
+        return $this->value === '';
+    }
+
+    /**
+     * Check if string is not empty
+     */
+    public function isNotEmpty(): bool
+    {
+        return $this->value !== '';
+    }
+
+    /**
+     * Get string length
+     */
+    public function length(): int
+    {
+        return strlen($this->value);
+    }
+
+    /**
+     * Check if string has at least the specified length
+     */
+    public function hasMinLength(int $min): bool
+    {
+        return strlen($this->value) >= $min;
+    }
+
+    /**
+     * Check if string has at most the specified length
+     */
+    public function hasMaxLength(int $max): bool
+    {
+        return strlen($this->value) <= $max;
+    }
+
+    /**
+     * Check if string length is within the specified range
+     */
+    public function hasLengthBetween(int $min, int $max): bool
+    {
+        $length = strlen($this->value);
+        return $length >= $min && $length <= $max;
+    }
+
+    /**
+     * Check if string has exact length
+     */
+    public function hasExactLength(int $length): bool
+    {
+        return strlen($this->value) === $length;
+    }
+
+    // ===== Pattern Matching =====
+
+    /**
+     * Check if string matches the given regular expression pattern
+     */
+    public function matches(string $pattern): bool
+    {
+        return preg_match($pattern, $this->value) === 1;
+    }
+
+    /**
+     * Check if string starts with the given prefix
+     */
+    public function startsWith(string $prefix): bool
+    {
+        return str_starts_with($this->value, $prefix);
+    }
+
+    /**
+     * Check if string ends with the given suffix
+     */
+    public function endsWith(string $suffix): bool
+    {
+        return str_ends_with($this->value, $suffix);
+    }
+
+    /**
+     * Check if string contains the given substring
+     */
+    public function contains(string $needle): bool
+    {
+        return str_contains($this->value, $needle);
+    }
+
+    // ===== Fluent Validation =====
+
+    /**
+     * Start a fluent validation chain
+     */
+    public function validate(): TypedStringValidator
+    {
+        return new TypedStringValidator($this);
+    }
+
+    // ===== Conversion & Comparison =====
+
+    public function __toString(): string
+    {
+        return $this->value;
+    }
+
+    /**
+     * Check equality with another TypedString
+     */
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    /**
+     * Get the raw string value
+     */
+    public function toString(): string
+    {
+        return $this->value;
+    }
+}
diff --git a/src/Framework/String/ValueObjects/TypedStringValidator.php b/src/Framework/String/ValueObjects/TypedStringValidator.php
new file mode 100644
index 00000000..0ccaf65b
--- /dev/null
+++ b/src/Framework/String/ValueObjects/TypedStringValidator.php
@@ -0,0 +1,483 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\String\ValueObjects;
+
+/**
+ * Fluent validation interface for TypedString
+ *
+ * Enables complex validation chains with readable syntax:
+ * ```php
+ * TypedString::fromString($value)
+ *     ->validate()
+ *     ->alphanumeric()
+ *     ->minLength(3)
+ *     ->maxLength(20)
+ *     ->orThrow('Invalid format');
+ * ```
+ */
+final class TypedStringValidator
+{
+    /** @var array<array{check: callable, error: string}> */
+    private array $rules = [];
+
+    /** @var array<string> */
+    private array $errors = [];
+
+    public function __construct(
+        private readonly TypedString $typedString
+    ) {}
+
+    // ===== Type Validators =====
+
+    /**
+     * Validate that all characters are alphanumeric
+     */
+    public function alphanumeric(string $error = 'Must be alphanumeric'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isAlphanumeric(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are alphabetic
+     */
+    public function alphabetic(string $error = 'Must be alphabetic'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isAlphabetic(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are digits
+     */
+    public function digits(string $error = 'Must contain only digits'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isDigits(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are hexadecimal
+     */
+    public function hexadecimal(string $error = 'Must be hexadecimal'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isHexadecimal(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are lowercase
+     */
+    public function lowercase(string $error = 'Must be lowercase'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isLowercase(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are uppercase
+     */
+    public function uppercase(string $error = 'Must be uppercase'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isUppercase(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are printable
+     */
+    public function printable(string $error = 'Must be printable'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isPrintable(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that all characters are visible (non-whitespace)
+     */
+    public function visible(string $error = 'Must contain visible characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isVisible(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string does not contain whitespace
+     */
+    public function noWhitespace(string $error = 'Must not contain whitespace'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => !$ts->isWhitespace() && !$ts->contains(' '),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string does not contain control characters
+     */
+    public function noControlCharacters(string $error = 'Must not contain control characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => !$ts->isControlCharacters(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    // ===== Length Validators =====
+
+    /**
+     * Validate that string is not empty
+     */
+    public function notEmpty(string $error = 'Must not be empty'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->isNotEmpty(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate minimum length
+     */
+    public function minLength(int $min, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->hasMinLength($min),
+            'error' => $error ?? "Must be at least {$min} characters"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate maximum length
+     */
+    public function maxLength(int $max, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->hasMaxLength($max),
+            'error' => $error ?? "Must be at most {$max} characters"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate length range
+     */
+    public function lengthBetween(int $min, int $max, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->hasLengthBetween($min, $max),
+            'error' => $error ?? "Must be between {$min} and {$max} characters"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate exact length
+     */
+    public function exactLength(int $length, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->hasExactLength($length),
+            'error' => $error ?? "Must be exactly {$length} characters"
+        ];
+        return $this;
+    }
+
+    // ===== Pattern Validators =====
+
+    /**
+     * Validate against regular expression pattern
+     */
+    public function matches(string $pattern, string $error = 'Invalid format'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->matches($pattern),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string starts with prefix
+     */
+    public function startsWith(string $prefix, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->startsWith($prefix),
+            'error' => $error ?? "Must start with '{$prefix}'"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string ends with suffix
+     */
+    public function endsWith(string $suffix, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->endsWith($suffix),
+            'error' => $error ?? "Must end with '{$suffix}'"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string contains substring
+     */
+    public function contains(string $needle, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $ts->contains($needle),
+            'error' => $error ?? "Must contain '{$needle}'"
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate that string does not contain substring
+     */
+    public function doesNotContain(string $needle, ?string $error = null): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => !$ts->contains($needle),
+            'error' => $error ?? "Must not contain '{$needle}'"
+        ];
+        return $this;
+    }
+
+    // ===== POSIX Validators =====
+
+    /**
+     * Validate POSIX alphanumeric (locale-aware)
+     * Supports international characters (ü, é, ñ, etc.)
+     */
+    public function posixAlnum(string $error = 'Must contain only POSIX alphanumeric characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isAlnum(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX alphabetic (locale-aware)
+     * Supports international letters
+     */
+    public function posixAlpha(string $error = 'Must contain only POSIX alphabetic characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isAlpha(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX punctuation characters
+     * Includes: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
+     */
+    public function posixPunct(string $error = 'Must contain only POSIX punctuation'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isPunct(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX word characters (alphanumeric + underscore)
+     * Perfect for identifiers, usernames, slugs
+     */
+    public function posixWord(string $error = 'Must contain only POSIX word characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isWord(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX lowercase (locale-aware)
+     */
+    public function posixLower(string $error = 'Must be POSIX lowercase'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isLower(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX uppercase (locale-aware)
+     */
+    public function posixUpper(string $error = 'Must be POSIX uppercase'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isUpper(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX printable characters
+     */
+    public function posixPrint(string $error = 'Must contain only POSIX printable characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isPrint(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    /**
+     * Validate POSIX graphical characters (visible, excluding space)
+     */
+    public function posixGraph(string $error = 'Must contain only POSIX graphical characters'): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => PosixString::fromString($ts->value)->isGraph(),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    // ===== Custom Validators =====
+
+    /**
+     * Add custom validation rule
+     */
+    public function custom(callable $check, string $error): self
+    {
+        $this->rules[] = [
+            'check' => fn(TypedString $ts) => $check($ts),
+            'error' => $error
+        ];
+        return $this;
+    }
+
+    // ===== Validation Execution =====
+
+    /**
+     * Check if all validation rules pass
+     */
+    public function passes(): bool
+    {
+        $this->errors = [];
+
+        foreach ($this->rules as $rule) {
+            if (!$rule['check']($this->typedString)) {
+                $this->errors[] = $rule['error'];
+            }
+        }
+
+        return empty($this->errors);
+    }
+
+    /**
+     * Check if any validation rule fails
+     */
+    public function fails(): bool
+    {
+        return !$this->passes();
+    }
+
+    /**
+     * Get all validation errors
+     *
+     * @return array<string>
+     */
+    public function getErrors(): array
+    {
+        if (empty($this->errors)) {
+            $this->passes(); // Run validation if not yet executed
+        }
+
+        return $this->errors;
+    }
+
+    /**
+     * Get the first validation error
+     */
+    public function getFirstError(): ?string
+    {
+        $errors = $this->getErrors();
+        return $errors[0] ?? null;
+    }
+
+    /**
+     * Throw exception if validation fails
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function orThrow(?string $message = null): TypedString
+    {
+        if ($this->fails()) {
+            $error = $message ?? $this->getFirstError() ?? 'Validation failed';
+            throw new \InvalidArgumentException($error);
+        }
+
+        return $this->typedString;
+    }
+
+    /**
+     * Return null if validation fails
+     */
+    public function orNull(): ?TypedString
+    {
+        return $this->passes() ? $this->typedString : null;
+    }
+
+    /**
+     * Return default value if validation fails
+     */
+    public function orDefault(string $default): TypedString
+    {
+        return $this->passes()
+            ? $this->typedString
+            : TypedString::fromString($default);
+    }
+
+    /**
+     * Get the TypedString being validated
+     */
+    public function getTypedString(): TypedString
+    {
+        return $this->typedString;
+    }
+}
diff --git a/src/Framework/SyntaxHighlighter/FileHighlighter.php b/src/Framework/SyntaxHighlighter/FileHighlighter.php
index 06999e36..23f08c6f 100644
--- a/src/Framework/SyntaxHighlighter/FileHighlighter.php
+++ b/src/Framework/SyntaxHighlighter/FileHighlighter.php
@@ -10,57 +10,46 @@ final readonly class FileHighlighter
 {
     public function __invoke(string $filename, int $startLine, int $range, ?int $errorLine = null): string
     {
-        $file = new SplFileObject($filename);
+        try {
+            $file = new SplFileObject($filename);
 
-        // Zu Zeile 9 springen (Index basiert auf 0, daher Zeile 10 = 9)
-        $file->seek($startLine);
+            // Zu Zeile 9 springen (Index basiert auf 0, daher Zeile 10 = 9)
+            $file->seek($startLine);
 
-        $lines = [];
-        for ($i = 0; $i < $range && ! $file->eof(); $i++) {
-            $lines[] = $file->current();
-            $file->next();
+            $lines = [];
+            for ($i = 0; $i < $range && ! $file->eof(); $i++) {
+                $lines[] = $file->current();
+                $file->next();
+            }
+
+            $code = implode('', $lines);
+            
+            if (empty(trim($code))) {
+                return '';
+            }
+
+            $highlighter = new SyntaxHighlighter();
+
+            // CSS-Output zurücksetzen für jeden neuen Aufruf
+            $highlighter->resetCssOutput();
+
+            // Use default theme (PHPStorm Darcula colors) - no need for custom theme
+            $formatter = $highlighter->getFormatter('html');
+
+            // Optionen für Syntax-Highlighting
+            $options = [
+                'filename' => basename($filename), // Dateiname für Window-Bar
+                'includeCss' => true, // CSS immer mit ausgeben für Error-Templates
+            ];
+            if ($errorLine !== null) {
+                // highlightLines erwartet die tatsächliche Zeilennummer (nicht 0-basiert)
+                $options['highlightLines'] = [$errorLine];
+            }
+
+            return $highlighter->highlightFileSegment($code, $startLine, $options);
+        } catch (\Throwable $e) {
+            // Bei Fehler einfach leeren String zurückgeben, damit die Fehlerseite trotzdem angezeigt wird
+            return '';
         }
-
-        $code = implode('', $lines);
-
-        $highlighter = new SyntaxHighlighter();
-
-        // PHPStorm-authentisches Darcula Theme
-        $darkTheme = [
-            'keyword' => '#cc7832',        // Orange für Keywords (class, function, public, etc.)
-            'variable' => '#9876aa',       // Lila für Variablen ($var)
-            'string' => '#6a8759',         // Grün für Strings
-            'identifier' => '#a9b7c6',     // Helles Grau für normale Identifier
-            'number' => '#6897bb',         // Blau für Zahlen
-            'comment' => '#808080',        // Grau für normale Kommentare
-            'doc-comment' => '#629755',    // Grüner für DocBlocks
-            'php-tag' => '#cc7832',        // Orange für PHP-Tags
-            'operator' => '#a9b7c6',       // Helles Grau für Operatoren
-            'constant' => '#9876aa',       // Lila für Konstanten
-            'method-call' => '#6897bb',    // Blau für Funktionen/Methoden
-            'property' => '#9876aa',       // Lila für Properties
-            'class-name' => '#a9b7c6',     // Weiß/Grau für Klassennamen
-            'background' => '#2b2b2b',     // PHPStorm Darcula Hintergrund
-            'border' => '#555555',         // Border
-            'line-number' => '#606366',    // Zeilennummern
-        ];
-
-        // CSS-Output zurücksetzen für jeden neuen Aufruf
-        $highlighter->resetCssOutput();
-
-        $formatter = $highlighter->getFormatter('html');
-        $formatter->setTheme($darkTheme);
-
-        // Optionen für Syntax-Highlighting
-        $options = [
-            'filename' => basename($filename), // Dateiname für Window-Bar
-            'includeCss' => true, // CSS immer mit ausgeben für Error-Templates
-        ];
-        if ($errorLine !== null) {
-            // highlightLines erwartet die tatsächliche Zeilennummer (nicht 0-basiert)
-            $options['highlightLines'] = [$errorLine];
-        }
-
-        return $highlighter->highlightFileSegment($code, $startLine, $options);
     }
 }
diff --git a/src/Framework/SyntaxHighlighter/Formatters/ConsoleFormatter.php b/src/Framework/SyntaxHighlighter/Formatters/ConsoleFormatter.php
index f4b45fb5..77e24c60 100644
--- a/src/Framework/SyntaxHighlighter/Formatters/ConsoleFormatter.php
+++ b/src/Framework/SyntaxHighlighter/Formatters/ConsoleFormatter.php
@@ -18,7 +18,7 @@ final class ConsoleFormatter implements FormatterInterface
      */
     public function format(TokenCollection|array $tokens, array $options = []): string
     {
-        // Handle both old array format and new TokenCollection
+        // Handle both the old array format and new TokenCollection
         if (is_array($tokens)) {
             return $this->formatLegacy($tokens, $options);
         }
diff --git a/src/Framework/SyntaxHighlighter/Formatters/HtmlFormatter.php b/src/Framework/SyntaxHighlighter/Formatters/HtmlFormatter.php
index a9a64fe1..d0bbbf2f 100644
--- a/src/Framework/SyntaxHighlighter/Formatters/HtmlFormatter.php
+++ b/src/Framework/SyntaxHighlighter/Formatters/HtmlFormatter.php
@@ -22,74 +22,83 @@ final class HtmlFormatter implements FormatterInterface
      */
     public function format(TokenCollection|array $tokens, array $options = []): string
     {
-        // Handle both old array format and new TokenCollection
-        if (is_array($tokens)) {
-            // Legacy support for old Token format
-            return $this->formatLegacy($tokens, $options);
-        }
+        try {
+            // Handle both old array format and new TokenCollection
+            if (is_array($tokens)) {
+                // Legacy support for old Token format
+                return $this->formatLegacy($tokens, $options);
+            }
 
-        $includeCss = $options['includeCss'] ?? false;
-        $lineNumbers = $options['lineNumbers'] ?? true;
-        $lineOffset = $options['lineOffset'] ?? 0;
-        $highlightLines = $options['highlightLines'] ?? [];
-        $wrapInPre = $options['wrapInPre'] ?? true;
+            $includeCss = $options['includeCss'] ?? false;
+            $lineNumbers = $options['lineNumbers'] ?? true;
+            $lineOffset = $options['lineOffset'] ?? 0;
+            $highlightLines = $options['highlightLines'] ?? [];
+            $wrapInPre = $options['wrapInPre'] ?? true;
 
-        $html = '';
+            $html = '';
 
-        // Include CSS if requested and not already output
-        if ($includeCss && ! self::$cssOutput) {
-            $html .= $this->getCss($options);
-            self::$cssOutput = true;
-        }
+            // Include CSS if requested and not already output
+            if ($includeCss && ! self::$cssOutput) {
+                $html .= $this->getCss($options);
+                self::$cssOutput = true;
+            }
 
-        // Start wrapper
-        if ($wrapInPre) {
-            $html .= '<pre class="syntax-highlight"><code>';
-        }
+            // Start wrapper
+            if ($wrapInPre) {
+                $html .= '<pre class="syntax-highlight"><code>';
+            }
 
-        // Group tokens by line for line number display
-        $tokensByLine = $tokens->groupByLine();
+            // Group tokens by line for line number display
+            $tokensByLine = $tokens->groupByLine();
 
-        // Fill in missing lines (empty lines between code)
-        if (!empty($tokensByLine)) {
-            $minLine = min(array_keys($tokensByLine));
-            $maxLine = max(array_keys($tokensByLine));
+            // Fill in missing lines (empty lines between code)
+            if (!empty($tokensByLine)) {
+                $minLine = min(array_keys($tokensByLine));
+                $maxLine = max(array_keys($tokensByLine));
 
-            for ($line = $minLine; $line <= $maxLine; $line++) {
-                if (!isset($tokensByLine[$line])) {
-                    $tokensByLine[$line] = []; // Empty line
+                for ($line = $minLine; $line <= $maxLine; $line++) {
+                    if (!isset($tokensByLine[$line])) {
+                        $tokensByLine[$line] = []; // Empty line
+                    }
                 }
-            }
-            ksort($tokensByLine); // Sort by line number
-        }
-
-        foreach ($tokensByLine as $lineNum => $lineTokens) {
-            $displayLineNum = $lineNum + $lineOffset;
-            $isHighlighted = in_array($displayLineNum, $highlightLines, true);
-
-            // Add line wrapper
-            $lineClass = $isHighlighted ? 'line highlighted' : 'line';
-            $html .= sprintf('<div class="%s">', $lineClass);
-
-            // Add line number
-            if ($lineNumbers) {
-                $html .= sprintf('<span class="line-number">%d</span>', $displayLineNum);
+                ksort($tokensByLine); // Sort by line number
             }
 
-            // Add tokens
-            $html .= '<span class="code">';
-            foreach ($lineTokens as $token) {
-                $html .= $this->formatSingle($token, $options);
+            foreach ($tokensByLine as $lineNum => $lineTokens) {
+                $displayLineNum = $lineNum + $lineOffset;
+                $isHighlighted = in_array($displayLineNum, $highlightLines, true);
+
+                // Sort tokens by position within the line to ensure correct order
+                usort($lineTokens, fn(Token $a, Token $b) => $a->position <=> $b->position);
+
+                // Add line wrapper
+                $lineClass = $isHighlighted ? 'line highlighted' : 'line';
+                $html .= sprintf('<div class="%s">', $lineClass);
+
+                // Add line number
+                if ($lineNumbers) {
+                    $html .= sprintf('<span class="line-number">%d</span>', $displayLineNum);
+                }
+
+                // Add tokens
+                $html .= '<span class="code">';
+                foreach ($lineTokens as $token) {
+                    $html .= $this->formatSingle($token, $options);
+                }
+                $html .= '</span></div>';
             }
-            $html .= '</span></div>';
-        }
 
-        // End wrapper
-        if ($wrapInPre) {
-            $html .= '</code></pre>';
-        }
+            // End wrapper
+            if ($wrapInPre) {
+                $html .= '</code></pre>';
+            }
 
-        return $html;
+            return $html;
+        } catch (\Throwable $e) {
+            // If formatting fails, return empty string to prevent breaking the error page
+            // In development, you might want to log this error
+            return '';
+        }
     }
 
     /**
@@ -99,7 +108,15 @@ final class HtmlFormatter implements FormatterInterface
     {
         // Handle whitespace tokens
         if ($token->type === TokenType::WHITESPACE) {
-            // Remove newlines from whitespace - we handle line breaks via <div class="line">
+            // Check if token contains only newlines (after splitWhitespaceAtNewlines in groupByLine)
+            // These should be skipped since line breaks are handled via <div class="line">
+            $onlyNewlines = preg_match('/^[\r\n]+$/', $token->value);
+            if ($onlyNewlines) {
+                return ''; // Skip newline-only tokens
+            }
+
+            // Remove newlines from whitespace that contains both newlines and spaces
+            // This handles tokens that weren't properly split (shouldn't happen, but safety check)
             $whitespace = str_replace(["\r\n", "\n", "\r"], '', $token->value);
 
             // If empty after removing newlines, skip it
@@ -107,6 +124,10 @@ final class HtmlFormatter implements FormatterInterface
                 return '';
             }
 
+            // Konvertiere Tabs zu Spaces für konsistente Darstellung (4 Spaces pro Tab)
+            // Dies verhindert, dass Tabs als einzelne Leerzeichen dargestellt werden
+            $whitespace = str_replace("\t", '    ', $whitespace);
+
             // Wrap in span to ensure white-space: pre CSS is applied
             // Without the span, HTML collapses multiple spaces to one
             $escapedValue = htmlspecialchars($whitespace, ENT_QUOTES | ENT_HTML5, 'UTF-8');
@@ -116,7 +137,56 @@ final class HtmlFormatter implements FormatterInterface
         $cssClass = $token->type->getCssClass();
         $escapedValue = htmlspecialchars($token->value, ENT_QUOTES | ENT_HTML5, 'UTF-8');
 
-        return sprintf('<span class="%s">%s</span>', $cssClass, $escapedValue);
+        // Add tooltip data attributes if metadata is available
+        $dataAttributes = '';
+        if ($token->metadata !== null && ($options['enableTooltips'] ?? true)) {
+            try {
+                $tooltipText = $token->metadata->getTooltipText();
+                $displayName = $token->metadata->getDisplayName();
+                
+                // Only add tooltip if we have at least display name or tooltip text
+                if ($tooltipText !== '' || $displayName !== '') {
+                    $dataAttributes = $this->buildTooltipAttributes($token->metadata);
+                }
+            } catch (\Throwable $e) {
+                // Silently fail - tooltips are optional
+                $dataAttributes = '';
+            }
+        }
+
+        return sprintf('<span class="%s"%s>%s</span>', $cssClass, $dataAttributes, $escapedValue);
+    }
+
+    /**
+     * Build data attributes for tooltips
+     */
+    private function buildTooltipAttributes(TokenMetadata $metadata): string
+    {
+        $attributes = [];
+
+        $displayName = $metadata->getDisplayName();
+        if ($displayName !== '') {
+            $attributes[] = sprintf('data-tooltip-title="%s"', htmlspecialchars($displayName, ENT_QUOTES | ENT_HTML5, 'UTF-8'));
+        }
+
+        $tooltipText = $metadata->getTooltipText();
+        if ($tooltipText !== '') {
+            $attributes[] = sprintf('data-tooltip="%s"', htmlspecialchars($tooltipText, ENT_QUOTES | ENT_HTML5, 'UTF-8'));
+        }
+
+        // Always add data-tooltip attribute if we have at least a display name or tooltip text
+        // This ensures the CSS selector matches
+        if (empty($attributes)) {
+            return '';
+        }
+
+        // Add additional metadata as JSON for JavaScript consumption
+        $jsonData = $metadata->toArray();
+        if (!empty($jsonData)) {
+            $attributes[] = sprintf('data-token-metadata="%s"', htmlspecialchars(json_encode($jsonData), ENT_QUOTES | ENT_HTML5, 'UTF-8'));
+        }
+
+        return ' ' . implode(' ', $attributes);
     }
 
     /**
@@ -206,8 +276,8 @@ final class HtmlFormatter implements FormatterInterface
         return <<<'CSS'
 <style>
 .syntax-highlight {
-    background: #2d2d2d;
-    color: #f8f8f2;
+    background: #282c34;
+    color: #abb2bf;
     padding: 1em;
     border-radius: 4px;
     overflow-x: auto;
@@ -226,7 +296,7 @@ final class HtmlFormatter implements FormatterInterface
 }
 
 .syntax-highlight .line-number {
-    color: #666;
+    color: #5c6370;
     padding-right: 1em;
     user-select: none;
     min-width: 3em;
@@ -235,43 +305,147 @@ final class HtmlFormatter implements FormatterInterface
 
 .syntax-highlight .code {
     flex: 1;
-    white-space: pre;
+    white-space: pre-wrap;
+    tab-size: 4;
+    -moz-tab-size: 4;
+    font-family: 'Fira Code', 'Consolas', 'Monaco', monospace;
 }
 
-/* Whitespace tokens must preserve spaces */
+/* Whitespace tokens must preserve spaces and tabs */
 .token-whitespace {
-    white-space: pre;
+    white-space: pre-wrap !important;
+    tab-size: 4;
+    -moz-tab-size: 4;
+    display: inline;
 }
 
-/* Token colors */
-.token-keyword { color: #ff79c6; font-weight: bold; }
-.token-class-name { color: #8be9fd; }
-.token-interface-name { color: #8be9fd; }
-.token-trait-name { color: #8be9fd; }
-.token-enum-name { color: #8be9fd; }
-.token-namespace-name { color: #50fa7b; }
-.token-function-name { color: #f1fa8c; }
-.token-method-name { color: #f1fa8c; }
-.token-property-name { color: #bd93f9; }
-.token-constant-name { color: #ff5555; }
-.token-variable { color: #f8f8f2; }
-.token-parameter { color: #ffb86c; }
-.token-string-literal { color: #50fa7b; }
-.token-number-literal { color: #bd93f9; }
-.token-boolean-literal { color: #bd93f9; }
-.token-null-literal { color: #bd93f9; }
-.token-comment { color: #6272a4; font-style: italic; }
-.token-doc-comment { color: #6272a4; font-style: italic; }
-.token-doc-tag { color: #ff79c6; font-style: italic; }
-.token-doc-type { color: #8be9fd; font-style: italic; }
-.token-doc-variable { color: #ffb86c; font-style: italic; }
-.token-operator { color: #ff79c6; }
-.token-punctuation { color: #f8f8f2; }
-.token-attribute { color: #ff79c6; }
-.token-attribute-name { color: #f1fa8c; }
-.token-type-hint { color: #8be9fd; }
-.token-php-tag { color: #ff79c6; }
-.token-error { color: #ff5555; background: rgba(255, 85, 85, 0.1); }
+/* Token colors - One Dark Pro / VS Code inspired */
+/* Keywords - Control Flow (Magenta/Purple) */
+.token-keyword-control-flow { color: #c678dd; font-weight: bold; }
+/* Keywords - Modifiers (Magenta/Purple) */
+.token-keyword-modifier { color: #c678dd; font-weight: bold; }
+/* Keywords - Type (Cyan/Light Blue) */
+.token-keyword-type { color: #56b6c2; font-weight: bold; }
+/* Keywords - Namespace (Magenta/Purple) */
+.token-keyword-namespace { color: #c678dd; font-weight: bold; }
+/* Keywords - Other (Magenta/Purple) */
+.token-keyword-other { color: #c678dd; font-weight: bold; }
+/* Fallback for generic keyword */
+.token-keyword { color: #c678dd; font-weight: bold; }
+
+/* Class names (Cyan/Light Blue) */
+.token-class-name { color: #56b6c2; }
+.token-interface-name { color: #56b6c2; }
+.token-trait-name { color: #56b6c2; }
+.token-enum-name { color: #56b6c2; }
+.token-namespace-name { color: #56b6c2; }
+
+/* Function and Method names (Yellow/Orange) */
+.token-function-name { color: #e5c07b; }
+.token-method-name { color: #e5c07b; }
+.token-constructor-name { color: #e5c07b; }
+.token-static-method-name { color: #e5c07b; }
+.token-instance-method-name { color: #e5c07b; }
+
+/* Properties (Yellow/Orange, same as methods) */
+.token-property-name { color: #e5c07b; }
+.token-static-property-name { color: #e5c07b; }
+.token-instance-property-name { color: #e5c07b; }
+
+/* Constants (Yellow/Orange) */
+.token-constant-name { color: #e5c07b; }
+
+/* Variables (Light Grey/White) */
+.token-variable { color: #abb2bf; }
+.token-parameter { color: #abb2bf; }
+
+/* Literals */
+.token-string-literal { color: #98c379; }
+.token-number-literal { color: #d19a66; }
+.token-boolean-literal { color: #c678dd; }
+.token-null-literal { color: #c678dd; }
+
+/* Comments (Muted Green/Grey) */
+.token-comment { color: #5c6370; font-style: italic; }
+.token-doc-comment { color: #5c6370; font-style: italic; }
+.token-doc-tag { color: #c678dd; font-style: italic; }
+.token-doc-type { color: #56b6c2; font-style: italic; }
+.token-doc-variable { color: #abb2bf; font-style: italic; }
+
+/* Operators and syntax (Light Grey/White) */
+.token-operator { color: #abb2bf; }
+.token-punctuation { color: #abb2bf; }
+.token-bracket { color: #abb2bf; }
+.token-parenthesis { color: #abb2bf; }
+.token-brace { color: #abb2bf; }
+.token-semicolon { color: #abb2bf; }
+
+/* Attributes */
+.token-attribute { color: #c678dd; }
+.token-attribute-name { color: #e5c07b; }
+
+/* Type hints (Cyan/Light Blue) */
+.token-type-hint { color: #56b6c2; }
+.token-return-type { color: #56b6c2; }
+.token-union-type { color: #56b6c2; }
+.token-intersection-type { color: #56b6c2; }
+
+/* PHP tags */
+.token-php-tag { color: #c678dd; }
+
+/* Error */
+.token-error { color: #e06c75; background: rgba(224, 108, 117, 0.1); }
+
+/* Tooltip support */
+[data-tooltip] {
+    position: relative;
+    cursor: help;
+    border-bottom: 1px dotted #5c6370;
+}
+
+[data-tooltip]:hover::after {
+    content: attr(data-tooltip);
+    position: absolute;
+    bottom: calc(100% + 8px);
+    left: 50%;
+    transform: translateX(-50%);
+    background: #1e1e1e;
+    color: #abb2bf;
+    padding: 0.6em 0.8em;
+    border-radius: 4px;
+    white-space: pre-line;
+    font-size: 12px;
+    line-height: 1.5;
+    z-index: 10000;
+    min-width: 200px;
+    max-width: 400px;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.6);
+    border: 1px solid #3c3c3c;
+    pointer-events: none;
+    display: block;
+    opacity: 1;
+}
+
+/* Show title + tooltip text if title is available */
+[data-tooltip][data-tooltip-title]:hover::after {
+    content: attr(data-tooltip-title) "\A \A" attr(data-tooltip);
+}
+
+/* Arrow pointing down */
+[data-tooltip]:hover::before {
+    content: '';
+    position: absolute;
+    bottom: calc(100% + 2px);
+    left: 50%;
+    transform: translateX(-50%);
+    width: 0;
+    height: 0;
+    border-left: 6px solid transparent;
+    border-right: 6px solid transparent;
+    border-top: 6px solid #3c3c3c;
+    z-index: 10001;
+    display: block;
+}
 </style>
 CSS;
     }
@@ -322,29 +496,90 @@ CSS;
 
 .syntax-highlight .code {
     flex: 1;
-    white-space: pre;
+    white-space: pre-wrap;
+    tab-size: 4;
+    -moz-tab-size: 4;
+    font-family: 'Fira Code', 'Consolas', 'Monaco', monospace;
 }
 
-/* Whitespace tokens must preserve spaces */
+/* Whitespace tokens must preserve spaces and tabs */
 .token-whitespace {
-    white-space: pre;
+    white-space: pre-wrap !important;
+    tab-size: 4;
+    -moz-tab-size: 4;
+    display: inline;
 }
 
-/* Light theme token colors */
+/* Light theme token colors - PHPStorm Light inspired */
+/* Keywords */
+.token-keyword-control-flow { color: #a626a4; font-weight: bold; }
+.token-keyword-modifier { color: #a626a4; font-weight: bold; }
+.token-keyword-type { color: #0184bc; font-weight: bold; }
+.token-keyword-namespace { color: #a626a4; font-weight: bold; }
+.token-keyword-other { color: #a626a4; font-weight: bold; }
 .token-keyword { color: #a626a4; font-weight: bold; }
+
+/* Class names */
 .token-class-name { color: #c18401; }
+.token-interface-name { color: #c18401; }
+.token-trait-name { color: #c18401; }
+.token-enum-name { color: #c18401; }
+.token-namespace-name { color: #c18401; }
+
+/* Function and Method names */
 .token-function-name { color: #4078f2; }
 .token-method-name { color: #4078f2; }
+.token-constructor-name { color: #4078f2; }
+.token-static-method-name { color: #4078f2; }
+.token-instance-method-name { color: #4078f2; }
+
+/* Properties */
 .token-property-name { color: #986801; }
+.token-static-property-name { color: #986801; }
+.token-instance-property-name { color: #986801; }
+
+/* Constants */
 .token-constant-name { color: #986801; }
+
+/* Variables */
 .token-variable { color: #383a42; }
 .token-parameter { color: #e45649; }
+
+/* Literals */
 .token-string-literal { color: #50a14f; }
 .token-number-literal { color: #986801; }
+.token-boolean-literal { color: #986801; }
+.token-null-literal { color: #986801; }
+
+/* Comments */
 .token-comment { color: #a0a1a7; font-style: italic; }
+.token-doc-comment { color: #a0a1a7; font-style: italic; }
+.token-doc-tag { color: #a626a4; font-style: italic; }
+.token-doc-type { color: #0184bc; font-style: italic; }
+.token-doc-variable { color: #e45649; font-style: italic; }
+
+/* Operators */
 .token-operator { color: #a626a4; }
+.token-punctuation { color: #383a42; }
+.token-bracket { color: #383a42; }
+.token-parenthesis { color: #383a42; }
+.token-brace { color: #383a42; }
+.token-semicolon { color: #383a42; }
+
+/* Attributes */
 .token-attribute { color: #a626a4; }
+.token-attribute-name { color: #4078f2; }
+
+/* Type hints */
 .token-type-hint { color: #c18401; }
+.token-return-type { color: #c18401; }
+.token-union-type { color: #c18401; }
+.token-intersection-type { color: #c18401; }
+
+/* PHP tags */
+.token-php-tag { color: #a626a4; }
+
+/* Error */
 .token-error { color: #e45649; background: rgba(228, 86, 73, 0.1); }
 </style>
 CSS;
@@ -383,12 +618,17 @@ CSS;
         $css .= "    min-width: 3em;\n";
         $css .= "    text-align: right;\n";
         $css .= "}\n";
-        $css .= ".syntax-highlight .code { flex: 1; white-space: pre; }\n";
-        $css .= ".token-whitespace { white-space: pre; }\n\n";
+        $css .= ".syntax-highlight .code { flex: 1; white-space: pre-wrap; tab-size: 4; -moz-tab-size: 4; font-family: 'Fira Code', 'Consolas', 'Monaco', monospace; }\n";
+        $css .= ".token-whitespace { white-space: pre-wrap !important; tab-size: 4; -moz-tab-size: 4; display: inline; }\n\n";
 
         // Map theme keys to CSS token classes
         $tokenMapping = [
             'keyword' => 'token-keyword',
+            'keyword-control-flow' => 'token-keyword-control-flow',
+            'keyword-modifier' => 'token-keyword-modifier',
+            'keyword-type' => 'token-keyword-type',
+            'keyword-namespace' => 'token-keyword-namespace',
+            'keyword-other' => 'token-keyword-other',
             'variable' => 'token-variable',
             'string' => 'token-string-literal',
             'number' => 'token-number-literal',
@@ -398,8 +638,16 @@ CSS;
             'operator' => 'token-operator',
             'constant' => 'token-constant-name',
             'method-call' => 'token-method-name',
+            'function-name' => 'token-function-name',
+            'method-name' => 'token-method-name',
+            'constructor-name' => 'token-constructor-name',
+            'static-method-name' => 'token-static-method-name',
+            'instance-method-name' => 'token-instance-method-name',
             'property' => 'token-property-name',
+            'static-property-name' => 'token-static-property-name',
+            'instance-property-name' => 'token-instance-property-name',
             'class-name' => 'token-class-name',
+            'type-hint' => 'token-type-hint',
         ];
 
         // Generate token-specific styles
diff --git a/src/Framework/Tokenizer/MetadataCollector.php b/src/Framework/Tokenizer/MetadataCollector.php
new file mode 100644
index 00000000..b622486f
--- /dev/null
+++ b/src/Framework/Tokenizer/MetadataCollector.php
@@ -0,0 +1,272 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Tokenizer;
+
+use App\Framework\Tokenizer\ValueObjects\TokenMetadata;
+use PhpToken;
+
+/**
+ * Collects metadata for tokens to enable tooltips and enhanced context
+ */
+final readonly class MetadataCollector
+{
+    /**
+     * List of PHP built-in functions
+     */
+    private const array BUILT_IN_FUNCTIONS = [
+        // String functions
+        'strlen', 'substr', 'str_replace', 'strpos', 'strtolower', 'strtoupper',
+        'trim', 'ltrim', 'rtrim', 'explode', 'implode', 'preg_match', 'preg_replace',
+        // Array functions
+        'array_map', 'array_filter', 'array_reduce', 'array_merge', 'array_keys',
+        'array_values', 'in_array', 'array_search', 'count', 'sizeof',
+        // File functions
+        'file_get_contents', 'file_put_contents', 'fopen', 'fclose', 'fread', 'fwrite',
+        'file_exists', 'is_file', 'is_dir', 'mkdir', 'rmdir', 'unlink',
+        // Date functions
+        'date', 'time', 'strtotime', 'mktime',
+        // Math functions
+        'abs', 'ceil', 'floor', 'round', 'min', 'max', 'rand', 'mt_rand',
+        // Type functions
+        'is_string', 'is_int', 'is_array', 'is_object', 'is_bool', 'is_null',
+        'gettype', 'settype', 'var_dump', 'print_r',
+        // JSON functions
+        'json_encode', 'json_decode', 'json_validate',
+        // Other common functions
+        'echo', 'print', 'var_dump', 'print_r', 'die', 'exit', 'isset', 'empty',
+        'unset', 'include', 'require', 'include_once', 'require_once',
+    ];
+
+    /**
+     * Collect metadata for a token based on context
+     */
+    public function collectMetadata(
+        PhpToken $token,
+        array $allTokens,
+        int $index,
+        string $currentNamespace = '',
+        string $currentClass = ''
+    ): ?TokenMetadata {
+        // Only collect metadata for identifiers (classes, functions, methods)
+        if (! $token->is(T_STRING)) {
+            return null;
+        }
+
+        $tokenText = $token->text;
+        
+        // Safely get previous and next tokens
+        $prevToken = null;
+        if ($index > 0 && isset($allTokens[$index - 1]) && $allTokens[$index - 1] instanceof \PhpToken) {
+            $prevToken = $allTokens[$index - 1];
+        }
+        
+        $nextToken = null;
+        if ($index < count($allTokens) - 1 && isset($allTokens[$index + 1]) && $allTokens[$index + 1] instanceof \PhpToken) {
+            $nextToken = $allTokens[$index + 1];
+        }
+
+        // Check if it's a built-in function
+        $isBuiltIn = $this->isBuiltInFunction($tokenText);
+
+        // After class/interface/trait/enum keyword
+        if ($prevToken && $prevToken->is([T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM])) {
+            return TokenMetadata::forClass(
+                className: $tokenText,
+                namespace: $currentNamespace ?: null,
+                filePath: null, // Will be set later if available
+                lineNumber: $token->line
+            );
+        }
+
+        // After function keyword
+        if ($prevToken && $prevToken->is(T_FUNCTION)) {
+            // Determine if it's a method or function
+            $isMethod = ! empty($currentClass);
+            
+            return TokenMetadata::forFunction(
+                functionName: $tokenText,
+                className: $isMethod ? $currentClass : null,
+                namespace: $currentNamespace ?: null,
+                isBuiltIn: $isBuiltIn && ! $isMethod,
+                filePath: null,
+                lineNumber: $token->line
+            );
+        }
+
+        // Function/method call (followed by parenthesis)
+        // Check if next token is a parenthesis
+        $nextTokenText = '';
+        if ($nextToken instanceof \PhpToken) {
+            $nextTokenText = $nextToken->text ?? '';
+        }
+        if ($nextToken && $nextTokenText === '(') {
+            // Check if it's a method call (after -> or ::)
+            $isMethodCall = $prevToken && $prevToken->is([T_OBJECT_OPERATOR, T_NULLSAFE_OBJECT_OPERATOR, T_DOUBLE_COLON]);
+            
+            if ($isMethodCall) {
+                if ($prevToken->is(T_DOUBLE_COLON)) {
+                    // Static method call
+                    $className = $this->extractClassNameFromContext($allTokens, $index);
+                    return TokenMetadata::forFunction(
+                        functionName: $tokenText,
+                        className: $className,
+                        namespace: $currentNamespace ?: null,
+                        isBuiltIn: false, // Static methods are user-defined
+                        filePath: null,
+                        lineNumber: $token->line
+                    );
+                } else {
+                    // Instance method call (after -> or ?->)
+                    // Try to extract class name from context if possible
+                    $className = $this->extractClassNameFromContext($allTokens, $index);
+                    return TokenMetadata::forFunction(
+                        functionName: $tokenText,
+                        className: $className ?: $currentClass ?: null,
+                        namespace: $currentNamespace ?: null,
+                        isBuiltIn: false, // Instance methods are user-defined
+                        filePath: null,
+                        lineNumber: $token->line
+                    );
+                }
+            }
+
+            // Regular function call (not a method)
+            return TokenMetadata::forFunction(
+                functionName: $tokenText,
+                className: null,
+                namespace: $currentNamespace ?: null,
+                isBuiltIn: $isBuiltIn,
+                filePath: null,
+                lineNumber: $token->line
+            );
+        }
+
+        // Class name in type hint or after new
+        if ($prevToken && $prevToken->is([T_NEW, T_EXTENDS, T_IMPLEMENTS])) {
+            return TokenMetadata::forClass(
+                className: $tokenText,
+                namespace: $currentNamespace ?: null,
+                filePath: null,
+                lineNumber: $token->line
+            );
+        }
+
+        // Also check for class names (PascalCase) that might be used as type hints
+        // This catches class names that aren't immediately after keywords
+        if (preg_match('/^[A-Z][a-zA-Z0-9]*$/', $tokenText)) {
+            // Could be a class name - but only return metadata if we're in a type context
+            // For now, we'll skip this to avoid false positives
+        }
+
+        return null;
+    }
+
+    /**
+     * Check if a function name is a PHP built-in function
+     */
+    private function isBuiltInFunction(string $functionName): bool
+    {
+        return in_array(strtolower($functionName), self::BUILT_IN_FUNCTIONS, true) ||
+               function_exists($functionName);
+    }
+
+    /**
+     * Extract class name from context (for static method calls)
+     */
+    private function extractClassNameFromContext(array $allTokens, int $index): ?string
+    {
+        // Look backwards for the class name before ::
+        for ($i = $index - 2; $i >= 0; $i--) {
+            if (!isset($allTokens[$i]) || !($allTokens[$i] instanceof \PhpToken)) {
+                break;
+            }
+            $token = $allTokens[$i];
+            if ($token->is(T_STRING) || $token->is(T_NAME_QUALIFIED)) {
+                return property_exists($token, 'text') ? $token->text : (string)$token;
+            }
+            if ($token->is([T_OBJECT_OPERATOR, T_DOUBLE_COLON, T_WHITESPACE])) {
+                continue;
+            }
+            break;
+        }
+
+        return null;
+    }
+
+    /**
+     * Extract namespace from tokens
+     */
+    public function extractNamespace(array $allTokens): string
+    {
+        try {
+            foreach ($allTokens as $index => $token) {
+                if (!($token instanceof \PhpToken)) {
+                    continue;
+                }
+                
+                if ($token->is(T_NAMESPACE)) {
+                    // Look for the namespace name after the namespace keyword
+                    $namespaceParts = [];
+                    for ($i = $index + 1; $i < count($allTokens); $i++) {
+                        if (!isset($allTokens[$i])) {
+                            break;
+                        }
+                        $nextToken = $allTokens[$i];
+                        if (!($nextToken instanceof \PhpToken)) {
+                            break;
+                        }
+                        if ($nextToken->is(T_STRING) || $nextToken->is(T_NAME_QUALIFIED)) {
+                            $namespaceParts[] = $nextToken->text;
+                        } elseif ($nextToken->is(T_NS_SEPARATOR)) {
+                            // Continue
+                        } elseif ($nextToken->is([T_WHITESPACE, T_SEMICOLON])) {
+                            if ($nextToken->is(T_SEMICOLON)) {
+                                break;
+                            }
+                        } else {
+                            break;
+                        }
+                    }
+                    if (! empty($namespaceParts)) {
+                        return implode('\\', $namespaceParts);
+                    }
+                }
+            }
+        } catch (\Throwable $e) {
+            // Silently fail - namespace extraction is optional
+        }
+
+        return '';
+    }
+
+    /**
+     * Extract current class name from tokens
+     */
+    public function extractCurrentClass(array $allTokens, int $currentIndex): string
+    {
+        $classDepth = 0;
+        $foundClass = false;
+
+        for ($i = 0; $i < $currentIndex; $i++) {
+            $token = $allTokens[$i];
+            
+            if ($token->is([T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM])) {
+                $foundClass = true;
+                $classDepth++;
+                
+                // Look for the class name
+                for ($j = $i + 1; $j < min($i + 5, $currentIndex); $j++) {
+                    $nextToken = $allTokens[$j];
+                    if ($nextToken->is(T_STRING)) {
+                        return $nextToken->text;
+                    }
+                }
+            }
+        }
+
+        return '';
+    }
+}
+
diff --git a/src/Framework/Tokenizer/PhpTokenizer.php b/src/Framework/Tokenizer/PhpTokenizer.php
index 91f39898..48f03ebb 100644
--- a/src/Framework/Tokenizer/PhpTokenizer.php
+++ b/src/Framework/Tokenizer/PhpTokenizer.php
@@ -19,7 +19,8 @@ final readonly class PhpTokenizer implements TokenizerInterface
 {
     public function __construct(
         private TokenClassifier $classifier = new TokenClassifier(),
-        private TokenContextAnalyzer $contextAnalyzer = new TokenContextAnalyzer()
+        private TokenContextAnalyzer $contextAnalyzer = new TokenContextAnalyzer(),
+        private MetadataCollector $metadataCollector = new MetadataCollector()
     ) {
     }
 
@@ -38,6 +39,10 @@ final readonly class PhpTokenizer implements TokenizerInterface
         // Build token collection with context
         $tokens = [];
         $context = new TokenContext();
+        
+        // Extract namespace and class name for metadata collection
+        $namespace = $this->metadataCollector->extractNamespace($phpTokens);
+        $currentClass = '';
 
         foreach ($phpTokens as $index => $phpToken) {
             // Skip artificial PHP tag if we added it
@@ -47,9 +52,20 @@ final readonly class PhpTokenizer implements TokenizerInterface
 
             // Update context
             $context = $this->contextAnalyzer->analyzeContext($phpToken, $phpTokens, $index, $context);
+            
+            // Update current class name if we found a class definition
+            if ($phpToken->is([T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM])) {
+                // Look ahead for class name
+                for ($j = $index + 1; $j < min($index + 5, count($phpTokens)); $j++) {
+                    if ($phpTokens[$j]->is(T_STRING)) {
+                        $currentClass = $phpTokens[$j]->text;
+                        break;
+                    }
+                }
+            }
 
-            // Create token with full context
-            $token = $this->createToken($phpToken, $context, $phpTokens, $index);
+            // Create token with full context and metadata
+            $token = $this->createToken($phpToken, $context, $phpTokens, $index, $namespace, $currentClass);
             $tokens[] = $token;
         }
 
@@ -241,18 +257,39 @@ final readonly class PhpTokenizer implements TokenizerInterface
         PhpToken $phpToken,
         TokenContext $context,
         array $allTokens,
-        int $index
+        int $index,
+        string $namespace = '',
+        string $currentClass = ''
     ): Token {
         // Determine the token type with contextual classification
         $type = $this->classifier->classify($phpToken, $allTokens, $index, $context);
 
+        // Collect metadata for identifiers (with error handling to prevent tokenization failures)
+        $metadata = null;
+        try {
+            // Only collect metadata for T_STRING tokens (identifiers)
+            if ($phpToken->is(T_STRING)) {
+                $metadata = $this->metadataCollector->collectMetadata(
+                    $phpToken,
+                    $allTokens,
+                    $index,
+                    $namespace,
+                    $currentClass
+                );
+            }
+        } catch (\Throwable $e) {
+            // Silently fail metadata collection - tokenization should still work
+            // Metadata is optional and shouldn't break the highlighting
+        }
+
         return new Token(
             type: $type,
             value: $phpToken->text,
             line: $phpToken->line,
             position: $phpToken->pos,
             id: $phpToken->id,
-            context: $context->clone()
+            context: $context->clone(),
+            metadata: $metadata
         );
     }
 
diff --git a/src/Framework/Tokenizer/TokenClassifier.php b/src/Framework/Tokenizer/TokenClassifier.php
index 1eb8e6c0..b4031422 100644
--- a/src/Framework/Tokenizer/TokenClassifier.php
+++ b/src/Framework/Tokenizer/TokenClassifier.php
@@ -38,19 +38,12 @@ final readonly class TokenClassifier
      */
     private function getBasicTokenType(PhpToken $token): TokenType
     {
+        // Classify keywords by category
+        if ($token->id >= T_ABSTRACT && $token->id <= T_YIELD_FROM) {
+            return $this->classifyKeyword($token);
+        }
+
         return match($token->id) {
-            // Keywords
-            T_ABSTRACT, T_AS, T_BREAK, T_CALLABLE, T_CASE, T_CATCH, T_CLASS,
-            T_CLONE, T_CONST, T_CONTINUE, T_DECLARE, T_DEFAULT, T_DO, T_ECHO,
-            T_ELSE, T_ELSEIF, T_EMPTY, T_ENDDECLARE, T_ENDFOR, T_ENDFOREACH,
-            T_ENDIF, T_ENDSWITCH, T_ENDWHILE, T_ENUM, T_EVAL, T_EXIT, T_EXTENDS,
-            T_FINAL, T_FINALLY, T_FN, T_FOR, T_FOREACH, T_FUNCTION, T_GLOBAL,
-            T_GOTO, T_IF, T_IMPLEMENTS, T_INCLUDE, T_INCLUDE_ONCE, T_INSTANCEOF,
-            T_INSTEADOF, T_INTERFACE, T_ISSET, T_LIST, T_MATCH, T_NAMESPACE,
-            T_NEW, T_PRINT, T_PRIVATE, T_PROTECTED, T_PUBLIC, T_READONLY,
-            T_REQUIRE, T_REQUIRE_ONCE, T_RETURN, T_STATIC, T_SWITCH, T_THROW,
-            T_TRAIT, T_TRY, T_UNSET, T_USE, T_VAR, T_WHILE, T_YIELD,
-            T_YIELD_FROM => TokenType::KEYWORD,
 
             // Variables
             T_VARIABLE => TokenType::VARIABLE,
@@ -92,6 +85,41 @@ final readonly class TokenClassifier
         };
     }
 
+    /**
+     * Classify keyword tokens into specific categories
+     */
+    private function classifyKeyword(PhpToken $token): TokenType
+    {
+        return match($token->id) {
+            // Control Flow Keywords
+            T_IF, T_ELSE, T_ELSEIF, T_ENDIF, T_FOR, T_ENDFOR, T_FOREACH, T_ENDFOREACH,
+            T_WHILE, T_ENDWHILE, T_DO, T_SWITCH, T_ENDSWITCH, T_CASE, T_DEFAULT,
+            T_BREAK, T_CONTINUE, T_RETURN, T_GOTO, T_YIELD, T_YIELD_FROM,
+            T_MATCH => TokenType::KEYWORD_CONTROL_FLOW,
+
+            // Modifier Keywords
+            T_PUBLIC, T_PRIVATE, T_PROTECTED, T_STATIC, T_FINAL, T_ABSTRACT,
+            T_READONLY, T_VAR => TokenType::KEYWORD_MODIFIER,
+
+            // Type Keywords (handled in classifyString for T_STRING)
+            T_CALLABLE => TokenType::KEYWORD_TYPE,
+
+            // Namespace Keywords
+            T_NAMESPACE, T_USE, T_AS => TokenType::KEYWORD_NAMESPACE,
+
+            // Other Keywords
+            T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM, T_FUNCTION, T_FN, T_CONST,
+            T_NEW, T_CLONE, T_INSTANCEOF, T_EXTENDS, T_IMPLEMENTS, T_INSTEADOF,
+            T_TRY, T_CATCH, T_FINALLY, T_THROW, T_ECHO, T_PRINT, T_EVAL,
+            T_INCLUDE, T_INCLUDE_ONCE, T_REQUIRE, T_REQUIRE_ONCE,
+            T_EMPTY, T_ISSET, T_UNSET, T_GLOBAL, T_DECLARE, T_ENDDECLARE,
+            T_LIST => TokenType::KEYWORD_OTHER,
+
+            // Default fallback
+            default => TokenType::KEYWORD
+        };
+    }
+
     /**
      * Classify single character tokens
      */
@@ -152,21 +180,31 @@ final readonly class TokenClassifier
 
         // After function keyword
         if ($prevToken && $prevToken->is(T_FUNCTION)) {
-            return $context->isInClass ? TokenType::METHOD_NAME : TokenType::FUNCTION_NAME;
+            if ($context->isInClass) {
+                // Check if it's a constructor
+                if (strtolower($token->text) === '__construct') {
+                    return TokenType::CONSTRUCTOR_NAME;
+                }
+                return TokenType::METHOD_NAME;
+            }
+            return TokenType::FUNCTION_NAME;
         }
 
-        // After :: (static method/constant)
+        // After :: (static method/constant/property)
         if ($prevToken && $prevToken->is(T_DOUBLE_COLON)) {
-            return $nextToken && $nextToken->text === '('
-                ? TokenType::METHOD_NAME
-                : TokenType::CONSTANT_NAME;
+            if ($nextToken && $nextToken->text === '(') {
+                return TokenType::STATIC_METHOD_NAME;
+            }
+            // Check if it's a property (static property)
+            return TokenType::STATIC_PROPERTY_NAME;
         }
 
         // After -> (object method/property)
         if ($prevToken && $prevToken->is([T_OBJECT_OPERATOR, T_NULLSAFE_OBJECT_OPERATOR])) {
-            return $nextToken && $nextToken->text === '('
-                ? TokenType::METHOD_NAME
-                : TokenType::PROPERTY_NAME;
+            if ($nextToken && $nextToken->text === '(') {
+                return TokenType::INSTANCE_METHOD_NAME;
+            }
+            return TokenType::INSTANCE_PROPERTY_NAME;
         }
 
         // In attribute context
@@ -176,9 +214,14 @@ final readonly class TokenClassifier
 
         // Function/method call (followed by parenthesis)
         if ($nextToken && $nextToken->text === '(') {
-            // Check if it's after 'new' (constructor)
+            // Check if it's after 'new' (constructor call)
             if ($prevToken && $prevToken->is(T_NEW)) {
-                return TokenType::CLASS_NAME;
+                return TokenType::CONSTRUCTOR_NAME;
+            }
+
+            // Check if it's a constructor method name
+            if (strtolower($token->text) === '__construct') {
+                return TokenType::CONSTRUCTOR_NAME;
             }
 
             return $context->isInClass ? TokenType::METHOD_NAME : TokenType::FUNCTION_NAME;
@@ -191,6 +234,10 @@ final readonly class TokenClassifier
 
         // Type hints (in function parameters or return types)
         if ($this->isTypeHintContext($allTokens, $index)) {
+            // Check if it's a built-in type keyword
+            if ($this->isTypeKeyword($token->text)) {
+                return TokenType::KEYWORD_TYPE;
+            }
             return TokenType::TYPE_HINT;
         }
 
@@ -199,6 +246,16 @@ final readonly class TokenClassifier
             return TokenType::CLASS_NAME;
         }
 
+        // Check for type keywords (int, string, bool, etc.)
+        if ($this->isTypeKeyword($token->text)) {
+            return TokenType::KEYWORD_TYPE;
+        }
+
+        // Check for namespace keywords (these are T_STRING in some contexts)
+        if ($this->isNamespaceKeyword($token->text)) {
+            return TokenType::KEYWORD_NAMESPACE;
+        }
+
         // Default to keyword if it's a known keyword
         if ($this->isKeyword($token->text)) {
             return TokenType::KEYWORD;
@@ -207,6 +264,30 @@ final readonly class TokenClassifier
         return TokenType::DEFAULT;
     }
 
+    /**
+     * Check if a string is a type keyword
+     */
+    private function isTypeKeyword(string $text): bool
+    {
+        static $typeKeywords = [
+            'int', 'float', 'string', 'bool', 'array', 'object',
+            'mixed', 'void', 'never', 'callable', 'iterable', 'resource',
+            'self', 'parent', 'static',
+        ];
+
+        return in_array(strtolower($text), $typeKeywords, true);
+    }
+
+    /**
+     * Check if a string is a namespace-related keyword
+     */
+    private function isNamespaceKeyword(string $text): bool
+    {
+        static $namespaceKeywords = ['namespace', 'use', 'as'];
+
+        return in_array(strtolower($text), $namespaceKeywords, true);
+    }
+
     /**
      * Check if we're in a type hint context
      */
diff --git a/src/Framework/Tokenizer/ValueObjects/Token.php b/src/Framework/Tokenizer/ValueObjects/Token.php
index 136a82ab..081b494f 100644
--- a/src/Framework/Tokenizer/ValueObjects/Token.php
+++ b/src/Framework/Tokenizer/ValueObjects/Token.php
@@ -15,7 +15,8 @@ final readonly class Token
         public int $line,
         public int $position,
         public int $id,
-        public TokenContext $context
+        public TokenContext $context,
+        public ?TokenMetadata $metadata = null
     ) {
     }
 
@@ -67,7 +68,14 @@ final readonly class Token
      */
     public function isKeyword(): bool
     {
-        return $this->type === TokenType::KEYWORD;
+        return in_array($this->type, [
+            TokenType::KEYWORD,
+            TokenType::KEYWORD_CONTROL_FLOW,
+            TokenType::KEYWORD_MODIFIER,
+            TokenType::KEYWORD_TYPE,
+            TokenType::KEYWORD_NAMESPACE,
+            TokenType::KEYWORD_OTHER,
+        ], true);
     }
 
     /**
@@ -77,9 +85,17 @@ final readonly class Token
     {
         return in_array($this->type, [
             TokenType::CLASS_NAME,
+            TokenType::INTERFACE_NAME,
+            TokenType::TRAIT_NAME,
+            TokenType::ENUM_NAME,
             TokenType::FUNCTION_NAME,
             TokenType::METHOD_NAME,
+            TokenType::CONSTRUCTOR_NAME,
+            TokenType::STATIC_METHOD_NAME,
+            TokenType::INSTANCE_METHOD_NAME,
             TokenType::PROPERTY_NAME,
+            TokenType::STATIC_PROPERTY_NAME,
+            TokenType::INSTANCE_PROPERTY_NAME,
             TokenType::CONSTANT_NAME,
         ], true);
     }
diff --git a/src/Framework/Tokenizer/ValueObjects/TokenCollection.php b/src/Framework/Tokenizer/ValueObjects/TokenCollection.php
index e49250d9..07a8cbd8 100644
--- a/src/Framework/Tokenizer/ValueObjects/TokenCollection.php
+++ b/src/Framework/Tokenizer/ValueObjects/TokenCollection.php
@@ -11,15 +11,32 @@ use Traversable;
 
 /**
  * Collection of tokens with utility methods
+ * Tokens are internally organized by line for efficient access and correct whitespace handling
  */
 final readonly class TokenCollection implements IteratorAggregate, Countable
 {
     /**
-     * @param array<Token> $tokens
+     * Tokens organized by line number
+     * @var array<int, array<Token>>
+     */
+    private array $tokensByLine;
+
+    /**
+     * Flat array of all tokens (for iterator and compatibility)
+     * @var array<Token>
+     */
+    private array $tokens;
+
+    /**
+     * @param array<Token>|array<int, array<Token>> $tokens Flat array or already grouped by line
      */
     public function __construct(
-        private array $tokens = []
+        array $tokens = []
     ) {
+        // Normalize tokens: split whitespace, organize by line, sort by position
+        $normalized = $this->normalizeTokens($tokens);
+        $this->tokensByLine = $normalized;
+        $this->tokens = $this->flattenTokensByLine($normalized);
     }
 
     /**
@@ -184,26 +201,8 @@ final readonly class TokenCollection implements IteratorAggregate, Countable
      */
     public function groupByLine(): array
     {
-        $groups = [];
-        foreach ($this->tokens as $token) {
-            // Split whitespace tokens that span multiple lines
-            if ($token->type === TokenType::WHITESPACE && str_contains($token->value, "\n")) {
-                $splitTokens = $this->splitWhitespaceAtNewlines($token);
-                foreach ($splitTokens as $splitToken) {
-                    if (! isset($groups[$splitToken->line])) {
-                        $groups[$splitToken->line] = [];
-                    }
-                    $groups[$splitToken->line][] = $splitToken;
-                }
-            } else {
-                if (! isset($groups[$token->line])) {
-                    $groups[$token->line] = [];
-                }
-                $groups[$token->line][] = $token;
-            }
-        }
-
-        return $groups;
+        // Tokens are already organized by line internally
+        return $this->tokensByLine;
     }
 
     /**
@@ -224,8 +223,11 @@ final readonly class TokenCollection implements IteratorAggregate, Countable
         $result = [];
 
         // Calculate starting line: token.line is where it ENDS
-        $startLine = $token->line - substr_count($token->value, "\n");
+        // Count newlines in the token value to determine where it starts
+        $newlineCount = substr_count($token->value, "\n");
+        $startLine = $token->line - $newlineCount;
         $currentLine = $startLine;
+        $currentPosition = $token->position;
 
         for ($i = 0; $i < count($parts); $i++) {
             $part = $parts[$i];
@@ -240,26 +242,35 @@ final readonly class TokenCollection implements IteratorAggregate, Countable
 
             if ($isNewline) {
                 // Newline belongs to current line (ends it)
+                // We create the token but it will be skipped in formatSingle()
                 $result[] = new Token(
                     type: TokenType::WHITESPACE,
                     value: $part,
                     line: $currentLine,
-                    position: $token->position,
+                    position: $currentPosition,
                     id: $token->id,
-                    context: $token->context
+                    context: $token->context,
+                    metadata: $token->metadata
                 );
+                $currentPosition += strlen($part);
+                // CRITICAL: Move to next line BEFORE processing whitespace that follows
+                // This ensures whitespace after newline belongs to the NEXT line
                 $currentLine++;
             } else {
-                // Non-newline whitespace: assign to current line
-                // (which is the line AFTER the newline if we just processed one)
+                // Non-newline whitespace (spaces/tabs)
+                // IMPORTANT: At this point, $currentLine has already been incremented
+                // if we processed a newline, so this whitespace belongs to the NEXT line
+                // (the line it indents)
                 $result[] = new Token(
                     type: TokenType::WHITESPACE,
                     value: $part,
                     line: $currentLine,
-                    position: $token->position,
+                    position: $currentPosition,
                     id: $token->id,
-                    context: $token->context
+                    context: $token->context,
+                    metadata: $token->metadata
                 );
+                $currentPosition += strlen($part);
             }
         }
 
@@ -313,4 +324,129 @@ final readonly class TokenCollection implements IteratorAggregate, Countable
     {
         return implode('', $this->getValues());
     }
+
+    /**
+     * Normalize tokens: split whitespace, organize by line, sort by position
+     * 
+     * @param array<Token>|array<int, array<Token>> $tokens
+     * @return array<int, array<Token>>
+     */
+    private function normalizeTokens(array $tokens): array
+    {
+        // Check if already grouped by line
+        if (!empty($tokens) && is_array(reset($tokens)) && is_int(key($tokens))) {
+            // Already grouped, flatten first then normalize
+            $flatTokens = [];
+            foreach ($tokens as $lineTokens) {
+                foreach ($lineTokens as $token) {
+                    $flatTokens[] = $token;
+                }
+            }
+            $tokens = $flatTokens;
+        }
+
+        // First pass: collect all tokens by line, splitting whitespace tokens
+        $allTokensByLine = [];
+        foreach ($tokens as $token) {
+            // Split whitespace tokens that span multiple lines
+            if ($token->type === TokenType::WHITESPACE && str_contains($token->value, "\n")) {
+                $splitTokens = $this->splitWhitespaceAtNewlines($token);
+                foreach ($splitTokens as $splitToken) {
+                    // Skip newline-only tokens (they will be handled by line structure)
+                    if (preg_match('/^[\r\n]+$/', $splitToken->value)) {
+                        continue;
+                    }
+                    
+                    if (! isset($allTokensByLine[$splitToken->line])) {
+                        $allTokensByLine[$splitToken->line] = [];
+                    }
+                    $allTokensByLine[$splitToken->line][] = $splitToken;
+                }
+            } else {
+                if (! isset($allTokensByLine[$token->line])) {
+                    $allTokensByLine[$token->line] = [];
+                }
+                $allTokensByLine[$token->line][] = $token;
+            }
+        }
+        
+        // Second pass: sort tokens by position within each line
+        foreach ($allTokensByLine as $lineNum => $lineTokens) {
+            usort($lineTokens, fn(Token $a, Token $b) => $a->position <=> $b->position);
+            $allTokensByLine[$lineNum] = $lineTokens;
+        }
+        
+        // Third pass: move trailing whitespace-only tokens to next line
+        // This handles cases where whitespace at end of line is actually indentation for next line
+        // We iterate in reverse to avoid modifying lines we haven't processed yet
+        $lines = array_keys($allTokensByLine);
+        rsort($lines); // Process from end to start
+        
+        foreach ($lines as $lineNum) {
+            $lineTokens = $allTokensByLine[$lineNum];
+            if (empty($lineTokens)) {
+                continue;
+            }
+            
+            // Get last token (already sorted by position)
+            $lastToken = end($lineTokens);
+            
+            // Only move trailing whitespace if:
+            // 1. Last token is whitespace-only (spaces/tabs, no newlines)
+            // 2. Next line exists and has tokens
+            // 3. This whitespace appears AFTER all other tokens on this line
+            if ($lastToken && 
+                $lastToken->type === TokenType::WHITESPACE && 
+                !str_contains($lastToken->value, "\n") &&
+                preg_match('/^[\s\t]+$/', $lastToken->value)) {
+                
+                $nextLine = $lineNum + 1;
+                if (isset($allTokensByLine[$nextLine]) && !empty($allTokensByLine[$nextLine])) {
+                    // Remove trailing whitespace from current line
+                    array_pop($allTokensByLine[$lineNum]);
+                    
+                    // Calculate position for moved token: should be at the start of next line
+                    // Find the minimum position in the next line, then use that minus 1
+                    $nextLineTokens = $allTokensByLine[$nextLine];
+                    $positions = array_map(fn(Token $t) => $t->position, $nextLineTokens);
+                    $minPosition = min($positions);
+                    $newPosition = max(0, $minPosition - 1);
+                    
+                    // Create a new token with updated line number and position
+                    $movedToken = new Token(
+                        type: $lastToken->type,
+                        value: $lastToken->value,
+                        line: $nextLine,
+                        position: $newPosition,
+                        id: $lastToken->id,
+                        context: $lastToken->context,
+                        metadata: $lastToken->metadata
+                    );
+                    
+                    // Add to next line and re-sort
+                    $allTokensByLine[$nextLine][] = $movedToken;
+                    usort($allTokensByLine[$nextLine], fn(Token $a, Token $b) => $a->position <=> $b->position);
+                }
+            }
+        }
+
+        return $allTokensByLine;
+    }
+
+    /**
+     * Flatten tokens by line into a single array
+     * 
+     * @param array<int, array<Token>> $tokensByLine
+     * @return array<Token>
+     */
+    private function flattenTokensByLine(array $tokensByLine): array
+    {
+        $flatTokens = [];
+        foreach ($tokensByLine as $lineTokens) {
+            foreach ($lineTokens as $token) {
+                $flatTokens[] = $token;
+            }
+        }
+        return $flatTokens;
+    }
 }
diff --git a/src/Framework/Tokenizer/ValueObjects/TokenMetadata.php b/src/Framework/Tokenizer/ValueObjects/TokenMetadata.php
new file mode 100644
index 00000000..0b4b4aa0
--- /dev/null
+++ b/src/Framework/Tokenizer/ValueObjects/TokenMetadata.php
@@ -0,0 +1,214 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Tokenizer\ValueObjects;
+
+/**
+ * Metadata for tokens to enable tooltips and enhanced context
+ */
+final readonly class TokenMetadata
+{
+    public function __construct(
+        public ?string $className = null,
+        public ?string $namespace = null,
+        public ?string $functionName = null,
+        public ?string $functionSignature = null,
+        public ?array $parameters = null,
+        public ?string $returnType = null,
+        public ?string $docComment = null,
+        public bool $isBuiltIn = false,
+        public ?string $filePath = null,
+        public ?int $lineNumber = null,
+    ) {
+    }
+
+    /**
+     * Create empty metadata
+     */
+    public static function empty(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Create metadata for a class
+     */
+    public static function forClass(
+        string $className,
+        ?string $namespace = null,
+        ?string $docComment = null,
+        ?string $filePath = null,
+        ?int $lineNumber = null
+    ): self {
+        return new self(
+            className: $className,
+            namespace: $namespace,
+            docComment: $docComment,
+            filePath: $filePath,
+            lineNumber: $lineNumber
+        );
+    }
+
+    /**
+     * Create metadata for a function/method
+     */
+    public static function forFunction(
+        string $functionName,
+        ?string $className = null,
+        ?string $namespace = null,
+        ?string $signature = null,
+        ?array $parameters = null,
+        ?string $returnType = null,
+        ?string $docComment = null,
+        bool $isBuiltIn = false,
+        ?string $filePath = null,
+        ?int $lineNumber = null
+    ): self {
+        return new self(
+            className: $className,
+            namespace: $namespace,
+            functionName: $functionName,
+            functionSignature: $signature,
+            parameters: $parameters,
+            returnType: $returnType,
+            docComment: $docComment,
+            isBuiltIn: $isBuiltIn,
+            filePath: $filePath,
+            lineNumber: $lineNumber
+        );
+    }
+
+    /**
+     * Merge with another metadata object (non-null values take precedence)
+     */
+    public function merge(self $other): self
+    {
+        return new self(
+            className: $other->className ?? $this->className,
+            namespace: $other->namespace ?? $this->namespace,
+            functionName: $other->functionName ?? $this->functionName,
+            functionSignature: $other->functionSignature ?? $this->functionSignature,
+            parameters: $other->parameters ?? $this->parameters,
+            returnType: $other->returnType ?? $this->returnType,
+            docComment: $other->docComment ?? $this->docComment,
+            isBuiltIn: $other->isBuiltIn || $this->isBuiltIn,
+            filePath: $other->filePath ?? $this->filePath,
+            lineNumber: $other->lineNumber ?? $this->lineNumber,
+        );
+    }
+
+    /**
+     * Get full class name with namespace
+     */
+    public function getFullClassName(): ?string
+    {
+        if ($this->className === null) {
+            return null;
+        }
+
+        if ($this->namespace === null || $this->namespace === '') {
+            return $this->className;
+        }
+
+        return $this->namespace . '\\' . $this->className;
+    }
+
+    /**
+     * Get display name for tooltip
+     */
+    public function getDisplayName(): string
+    {
+        if ($this->functionName !== null) {
+            if ($this->className !== null) {
+                return $this->className . '::' . $this->functionName . '()';
+            }
+            return $this->functionName . '()';
+        }
+
+        if ($this->className !== null) {
+            return $this->getFullClassName() ?? $this->className;
+        }
+
+        return '';
+    }
+
+    /**
+     * Get tooltip text
+     */
+    public function getTooltipText(): string
+    {
+        $parts = [];
+
+        if ($this->functionName !== null) {
+            // Always show function name
+            $parts[] = $this->getDisplayName();
+            
+            if ($this->functionSignature !== null && $this->functionSignature !== $this->getDisplayName()) {
+                $parts[] = $this->functionSignature;
+            }
+
+            if ($this->returnType !== null) {
+                $parts[] = "→ {$this->returnType}";
+            }
+            
+            if ($this->parameters !== null && !empty($this->parameters)) {
+                $paramList = implode(', ', array_map(fn($p) => is_string($p) ? $p : get_debug_type($p), $this->parameters));
+                if (!empty($paramList)) {
+                    $parts[] = "Parameters: {$paramList}";
+                }
+            }
+        } elseif ($this->className !== null) {
+            $fullName = $this->getFullClassName() ?? $this->className;
+            $parts[] = $fullName;
+            
+            if ($this->namespace !== null && $this->namespace !== '') {
+                $parts[] = "Namespace: {$this->namespace}";
+            }
+        }
+
+        if ($this->docComment !== null) {
+            // Extract first line of doc comment
+            $docLines = explode("\n", trim($this->docComment));
+            $firstLine = trim($docLines[0], " \t\n\r\0\x0B*/");
+            if (!empty($firstLine) && !str_starts_with(strtolower($firstLine), '@')) {
+                $parts[] = $firstLine;
+            }
+        }
+
+        if ($this->isBuiltIn) {
+            $parts[] = '[PHP Built-in]';
+        }
+
+        $result = implode("\n", $parts);
+        
+        // Ensure we always return something if we have metadata
+        if (empty($result) && ($this->functionName !== null || $this->className !== null)) {
+            return $this->getDisplayName();
+        }
+        
+        return $result;
+    }
+
+    /**
+     * Convert to array for JSON serialization
+     */
+    public function toArray(): array
+    {
+        return [
+            'className' => $this->className,
+            'namespace' => $this->namespace,
+            'functionName' => $this->functionName,
+            'functionSignature' => $this->functionSignature,
+            'parameters' => $this->parameters,
+            'returnType' => $this->returnType,
+            'docComment' => $this->docComment,
+            'isBuiltIn' => $this->isBuiltIn,
+            'filePath' => $this->filePath,
+            'lineNumber' => $this->lineNumber,
+            'displayName' => $this->getDisplayName(),
+            'tooltipText' => $this->getTooltipText(),
+        ];
+    }
+}
+
diff --git a/src/Framework/Tokenizer/ValueObjects/TokenType.php b/src/Framework/Tokenizer/ValueObjects/TokenType.php
index b38ab4b7..83fba809 100644
--- a/src/Framework/Tokenizer/ValueObjects/TokenType.php
+++ b/src/Framework/Tokenizer/ValueObjects/TokenType.php
@@ -11,6 +11,11 @@ enum TokenType: string
 {
     // Structural
     case KEYWORD = 'keyword';
+    case KEYWORD_CONTROL_FLOW = 'keyword_control_flow';
+    case KEYWORD_MODIFIER = 'keyword_modifier';
+    case KEYWORD_TYPE = 'keyword_type';
+    case KEYWORD_NAMESPACE = 'keyword_namespace';
+    case KEYWORD_OTHER = 'keyword_other';
     case CLASS_NAME = 'class_name';
     case INTERFACE_NAME = 'interface_name';
     case TRAIT_NAME = 'trait_name';
@@ -20,6 +25,11 @@ enum TokenType: string
     // Identifiers
     case FUNCTION_NAME = 'function_name';
     case METHOD_NAME = 'method_name';
+    case CONSTRUCTOR_NAME = 'constructor_name';
+    case STATIC_METHOD_NAME = 'static_method_name';
+    case STATIC_PROPERTY_NAME = 'static_property_name';
+    case INSTANCE_METHOD_NAME = 'instance_method_name';
+    case INSTANCE_PROPERTY_NAME = 'instance_property_name';
     case PROPERTY_NAME = 'property_name';
     case CONSTANT_NAME = 'constant_name';
     case VARIABLE = 'variable';
@@ -79,22 +89,65 @@ enum TokenType: string
     public function getTerminalColor(): string
     {
         return match($this) {
-            self::KEYWORD => "\033[35m",           // Magenta
+            // Keywords
+            self::KEYWORD,
+            self::KEYWORD_CONTROL_FLOW,
+            self::KEYWORD_MODIFIER,
+            self::KEYWORD_NAMESPACE,
+            self::KEYWORD_OTHER => "\033[33m",     // Yellow/Orange
+            self::KEYWORD_TYPE => "\033[36m",      // Cyan
+            // Class names
             self::CLASS_NAME,
             self::INTERFACE_NAME,
             self::TRAIT_NAME,
-            self::ENUM_NAME => "\033[36m",         // Cyan
+            self::ENUM_NAME,
+            self::NAMESPACE_NAME => "\033[36m",    // Cyan
+            // Functions and methods
             self::FUNCTION_NAME,
-            self::METHOD_NAME => "\033[33m",       // Yellow
+            self::METHOD_NAME,
+            self::CONSTRUCTOR_NAME,
+            self::STATIC_METHOD_NAME,
+            self::INSTANCE_METHOD_NAME => "\033[33m", // Yellow
+            // Properties
+            self::PROPERTY_NAME,
+            self::STATIC_PROPERTY_NAME,
+            self::INSTANCE_PROPERTY_NAME => "\033[33m", // Yellow
+            // Constants
+            self::CONSTANT_NAME => "\033[33m",     // Yellow
+            // Variables
             self::VARIABLE,
-            self::PARAMETER => "\033[37m",         // White
+            self::PARAMETER => "\033[35m",         // Magenta/Purple
+            // Literals
             self::STRING_LITERAL => "\033[32m",    // Green
-            self::NUMBER_LITERAL => "\033[34m",    // Blue
+            self::NUMBER_LITERAL,
+            self::BOOLEAN_LITERAL,
+            self::NULL_LITERAL => "\033[34m",      // Blue
+            // Comments
             self::COMMENT,
-            self::DOC_COMMENT => "\033[90m",       // Gray
+            self::DOC_COMMENT,
+            self::DOC_TAG,
+            self::DOC_TYPE,
+            self::DOC_VARIABLE,
+            self::DOC_TEXT => "\033[90m",          // Gray
+            // Operators and syntax
+            self::OPERATOR,
+            self::PUNCTUATION,
+            self::BRACKET,
+            self::PARENTHESIS,
+            self::BRACE,
+            self::SEMICOLON => "\033[37m",        // White/Light Gray
+            // Attributes
             self::ATTRIBUTE,
             self::ATTRIBUTE_NAME => "\033[95m",    // Light Magenta
-            self::OPERATOR => "\033[31m",          // Red
+            // Type hints
+            self::TYPE_HINT,
+            self::RETURN_TYPE,
+            self::UNION_TYPE,
+            self::INTERSECTION_TYPE => "\033[36m", // Cyan
+            // PHP tags
+            self::PHP_TAG => "\033[33m",           // Yellow/Orange
+            // Error
+            self::ERROR => "\033[31m",             // Red
             default => "\033[0m"                   // Reset
         };
     }
diff --git a/src/Framework/Validation/Exceptions/ValidationException.php b/src/Framework/Validation/Exceptions/ValidationException.php
index 650098f5..3e3e31a9 100644
--- a/src/Framework/Validation/Exceptions/ValidationException.php
+++ b/src/Framework/Validation/Exceptions/ValidationException.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\Validation\Exceptions;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 use App\Framework\Validation\ValidationResult;
 
@@ -20,12 +18,10 @@ final class ValidationException extends FrameworkException
     /**
      * @param ValidationResult $validationResult Das Validierungsergebnis mit allen Fehlern
      * @param string|null $field Optionaler einzelner Feldname für Rückwärtskompatibilität
-     * @param ErrorCode|null $errorCode Spezifischer ErrorCode, sonst automatisch bestimmt
      */
     public function __construct(
         ValidationResult $validationResult,
-        ?string $field = null,
-        ?ErrorCode $errorCode = null
+        ?string $field = null
     ) {
         $this->validationResult = $validationResult;
 
@@ -44,23 +40,9 @@ final class ValidationException extends FrameworkException
         // Erstelle eine aussagekräftige Fehlernachricht aus allen Fehlern
         $message = $this->createErrorMessage();
 
-        // Erstelle Exception-Kontext mit Validation-spezifischen Daten
-        $context = ExceptionContext::forOperation('validation.validate', 'Validator')
-            ->withData([
-                'failed_fields' => array_keys($validationResult->getAll()),
-                'error_count' => count($validationResult->getAllErrorMessages()),
-                'primary_field' => $this->field,
-                'validation_errors' => $validationResult->getAll(),
-            ]);
-
-        // Bestimme ErrorCode basierend auf der Art der Validation Errors
-        $finalErrorCode = $errorCode ?? $this->determineErrorCode($validationResult);
-
         parent::__construct(
             message: $message,
-            context: $context,
-            code: 400, // Bad Request für Validation Errors
-            errorCode: $finalErrorCode
+            code: 400 // Bad Request für Validation Errors
         );
     }
 
@@ -145,46 +127,6 @@ final class ValidationException extends FrameworkException
         return $this->field;
     }
 
-    /**
-     * Bestimmt den passenden ErrorCode basierend auf den Validation Errors
-     */
-    private function determineErrorCode(ValidationResult $validationResult): ErrorCode
-    {
-        $allErrors = $validationResult->getAll();
-
-        // Wenn mehrere Felder betroffen sind
-        if (count($allErrors) > 1) {
-            return ErrorCode::VAL_BUSINESS_RULE_VIOLATION;
-        }
-
-        // Analysiere die erste Fehlermeldung um den Typ zu bestimmen
-        $firstErrors = reset($allErrors);
-        if (empty($firstErrors)) {
-            return ErrorCode::VAL_BUSINESS_RULE_VIOLATION;
-        }
-
-        $firstError = $firstErrors[0];
-
-        // Einfache Heuristik basierend auf Fehlermeldungen
-        if (str_contains(strtolower($firstError), 'required') || str_contains(strtolower($firstError), 'missing')) {
-            return ErrorCode::VAL_REQUIRED_FIELD_MISSING;
-        }
-
-        if (str_contains(strtolower($firstError), 'format') || str_contains(strtolower($firstError), 'invalid')) {
-            return ErrorCode::VAL_INVALID_FORMAT;
-        }
-
-        if (str_contains(strtolower($firstError), 'range') || str_contains(strtolower($firstError), 'length')) {
-            return ErrorCode::VAL_OUT_OF_RANGE;
-        }
-
-        if (str_contains(strtolower($firstError), 'duplicate') || str_contains(strtolower($firstError), 'exists')) {
-            return ErrorCode::VAL_DUPLICATE_VALUE;
-        }
-
-        return ErrorCode::VAL_BUSINESS_RULE_VIOLATION;
-    }
-
     // === Factory Methods ===
 
     /**
@@ -210,7 +152,7 @@ final class ValidationException extends FrameworkException
         $validationResult = new ValidationResult();
         $validationResult->addErrors($fieldName, ["Field '$fieldName' is required"]);
 
-        return new self($validationResult, $fieldName, ErrorCode::VAL_REQUIRED_FIELD_MISSING);
+        return new self($validationResult, $fieldName);
     }
 
     /**
@@ -221,7 +163,7 @@ final class ValidationException extends FrameworkException
         $validationResult = new ValidationResult();
         $validationResult->addErrors($fieldName, ["Field '$fieldName' must be in format: $expectedFormat"]);
 
-        return new self($validationResult, $fieldName, ErrorCode::VAL_INVALID_FORMAT);
+        return new self($validationResult, $fieldName);
     }
 
     /**
@@ -242,7 +184,7 @@ final class ValidationException extends FrameworkException
 
         $validationResult->addErrors($fieldName, [$rangeMessage]);
 
-        return new self($validationResult, $fieldName, ErrorCode::VAL_OUT_OF_RANGE);
+        return new self($validationResult, $fieldName);
     }
 
     /**
@@ -253,7 +195,7 @@ final class ValidationException extends FrameworkException
         $validationResult = new ValidationResult();
         $validationResult->addErrors($fieldName, ["Field '$fieldName' value '$value' already exists"]);
 
-        return new self($validationResult, $fieldName, ErrorCode::VAL_DUPLICATE_VALUE);
+        return new self($validationResult, $fieldName);
     }
 
     /**
@@ -271,6 +213,6 @@ final class ValidationException extends FrameworkException
             $validationResult->addErrors('general', ["Business rule violation: $rule"]);
         }
 
-        return new self($validationResult, null, ErrorCode::VAL_BUSINESS_RULE_VIOLATION);
+        return new self($validationResult, null);
     }
 }
diff --git a/src/Framework/Validation/Validator.php b/src/Framework/Validation/Validator.php
index b5e264b9..5a776169 100644
--- a/src/Framework/Validation/Validator.php
+++ b/src/Framework/Validation/Validator.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace App\Framework\Validation;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 
 final readonly class Validator
 {
diff --git a/src/Framework/View/Components/AdminSidebar.php b/src/Framework/View/Components/AdminSidebar.php
index 30e837a1..acc15f7c 100644
--- a/src/Framework/View/Components/AdminSidebar.php
+++ b/src/Framework/View/Components/AdminSidebar.php
@@ -4,6 +4,9 @@ declare(strict_types=1);
 
 namespace App\Framework\View\Components;
 
+use App\Application\Admin\ValueObjects\NavigationMenu;
+use App\Application\Admin\ValueObjects\NavigationSection;
+use App\Application\Admin\ValueObjects\NavigationItem;
 use App\Framework\View\Attributes\ComponentName;
 use App\Framework\View\Contracts\StaticComponent;
 use App\Framework\View\Dom\ElementNode;
@@ -16,6 +19,7 @@ final readonly class AdminSidebar implements StaticComponent
     private string $title;
     private string $logoUrl;
     private string $currentPath;
+    private ?NavigationMenu $navigationMenu;
 
     public function __construct(
         string $content = '',
@@ -24,7 +28,10 @@ final readonly class AdminSidebar implements StaticComponent
         // Extract attributes with defaults
         $this->title = $attributes['title'] ?? 'Admin Panel';
         $this->logoUrl = $attributes['logo-url'] ?? '/admin';
-        $this->currentPath = $attributes['current-path'] ?? '/admin';
+        $this->currentPath = $attributes['current-path'] ?? $attributes['currentPath'] ?? '/admin';
+        
+        // Parse navigation menu from attributes
+        $this->navigationMenu = $this->parseNavigationMenu($attributes);
     }
 
     public function getRootNode(): Node
@@ -42,6 +49,15 @@ final readonly class AdminSidebar implements StaticComponent
     }
 
     private function buildSidebarContent(): string
+    {
+        $header = $this->buildHeader();
+        $navigation = $this->buildNavigation();
+        $footer = $this->buildFooter();
+
+        return $header . $navigation . $footer;
+    }
+
+    private function buildHeader(): string
     {
         return <<<HTML
             <div class="admin-sidebar__header">
@@ -49,10 +65,128 @@ final readonly class AdminSidebar implements StaticComponent
                     <span class="admin-sidebar__title">{$this->title}</span>
                 </a>
             </div>
+        HTML;
+    }
 
+    private function buildNavigation(): string
+    {
+        if ($this->navigationMenu !== null) {
+            return $this->buildDynamicNavigation();
+        }
+
+        return $this->buildFallbackNavigation();
+    }
+
+    private function buildDynamicNavigation(): string
+    {
+        $html = '<nav class="admin-nav" aria-label="Primary">';
+
+        foreach ($this->navigationMenu->sections as $section) {
+            $html .= $this->renderSection($section);
+        }
+
+        $html .= '</nav>';
+
+        return $html;
+    }
+
+    private function renderSection(NavigationSection $section): string
+    {
+        $html = '<div class="admin-nav__section">';
+
+        if ($section->name !== '') {
+            $html .= '<h2 class="admin-nav__section-title">' . htmlspecialchars($section->name) . '</h2>';
+        }
+
+        $html .= '<ul class="admin-nav__list" role="list">';
+
+        foreach ($section->items as $item) {
+            $html .= $this->renderItem($item);
+        }
+
+        $html .= '</ul></div>';
+
+        return $html;
+    }
+
+    private function renderItem(NavigationItem $item): string
+    {
+        $activeState = $item->isActive($this->currentPath)
+            ? 'aria-current="page"'
+            : '';
+
+        $iconHtml = $this->renderIcon($item->icon);
+
+        return <<<HTML
+            <li class="admin-nav__item">
+                <a href="{$this->escape($item->url)}" class="admin-nav__link" {$activeState}>
+                    {$iconHtml}
+                    <span>{$this->escape($item->name)}</span>
+                </a>
+            </li>
+        HTML;
+    }
+
+    private function renderIcon(?string $icon): string
+    {
+        if ($icon === null || $icon === '') {
+            return '';
+        }
+
+        // Try to match icon name to SVG or use emoji fallback
+        $svgIcon = $this->getSvgIcon($icon);
+        
+        if ($svgIcon !== null) {
+            return '<svg class="admin-nav__icon" fill="none" stroke="currentColor" viewBox="0 0 24 24" aria-hidden="true">' . $svgIcon . '</svg>';
+        }
+
+        // Fallback to emoji or text
+        $emojiIcon = $this->getEmojiIcon($icon);
+        return '<span class="admin-nav__icon">' . $emojiIcon . '</span>';
+    }
+
+    private function getSvgIcon(string $iconName): ?string
+    {
+        // Common icon mappings
+        $icons = [
+            'dashboard' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"/>',
+            'server' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01"/>',
+            'database' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 7v10c0 2.21 3.582 4 8 4s8-1.79 8-4V7M4 7c0 2.21 3.582 4 8 4s8-1.79 8-4M4 7c0-2.21 3.582-4 8-4s8 1.79 8 4m0 5c0 2.21-3.582 4-8 4s-8-1.79-8-4"/>',
+            'photo' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z"/>',
+            'chart-bar' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>',
+            'code' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"/>',
+            'bell' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9"/>',
+            'brain' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z"/>',
+            'file' => '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>',
+        ];
+
+        return $icons[strtolower($iconName)] ?? null;
+    }
+
+    private function getEmojiIcon(string $iconName): string
+    {
+        $emoji = [
+            'dashboard' => '📊',
+            'server' => '🖥️',
+            'database' => '💾',
+            'photo' => '🖼️',
+            'chart-bar' => '📈',
+            'code' => '💻',
+            'bell' => '🔔',
+            'brain' => '🧠',
+            'file' => '📄',
+        ];
+
+        return $emoji[strtolower($iconName)] ?? '📄';
+    }
+
+    private function buildFallbackNavigation(): string
+    {
+        // Fallback to old hardcoded navigation for backward compatibility
+        return <<<HTML
             <nav class="admin-nav">
                 <div class="admin-nav__section">
-                    <h3 class="admin-nav__section-title">Dashboard</h3>
+                    <h2 class="admin-nav__section-title">Dashboard</h2>
                     <ul class="admin-nav__list" role="list">
                         <li class="admin-nav__item">
                             <a href="/admin" class="admin-nav__link" {$this->getActiveState('/admin')}>
@@ -62,50 +196,13 @@ final readonly class AdminSidebar implements StaticComponent
                         </li>
                     </ul>
                 </div>
-
-                <div class="admin-nav__section">
-                    <h3 class="admin-nav__section-title">System</h3>
-                    <ul class="admin-nav__list" role="list">
-                        <li class="admin-nav__item">
-                            <a href="/admin/infrastructure/cache" class="admin-nav__link" {$this->getActiveState('/admin/infrastructure/cache')}>
-                                <span class="admin-nav__icon">💾</span>
-                                <span>Cache</span>
-                            </a>
-                        </li>
-                        <li class="admin-nav__item">
-                            <a href="/admin/infrastructure/logs" class="admin-nav__link" {$this->getActiveState('/admin/infrastructure/logs')}>
-                                <span class="admin-nav__icon">📝</span>
-                                <span>Logs</span>
-                            </a>
-                        </li>
-                        <li class="admin-nav__item">
-                            <a href="/admin/infrastructure/migrations" class="admin-nav__link" {$this->getActiveState('/admin/infrastructure/migrations')}>
-                                <span class="admin-nav__icon">🔄</span>
-                                <span>Migrations</span>
-                            </a>
-                        </li>
-                    </ul>
-                </div>
-
-                <div class="admin-nav__section">
-                    <h3 class="admin-nav__section-title">Content</h3>
-                    <ul class="admin-nav__list" role="list">
-                        <li class="admin-nav__item">
-                            <a href="/admin/images" class="admin-nav__link" {$this->getActiveState('/admin/images')}>
-                                <span class="admin-nav__icon">🖼️</span>
-                                <span>Images</span>
-                            </a>
-                        </li>
-                        <li class="admin-nav__item">
-                            <a href="/admin/users" class="admin-nav__link" {$this->getActiveState('/admin/users')}>
-                                <span class="admin-nav__icon">👥</span>
-                                <span>Users</span>
-                            </a>
-                        </li>
-                    </ul>
-                </div>
             </nav>
+        HTML;
+    }
 
+    private function buildFooter(): string
+    {
+        return <<<HTML
             <div class="admin-sidebar__footer">
                 <div class="admin-sidebar__user">
                     <div class="admin-sidebar__avatar" style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); width: 32px; height: 32px; border-radius: 50%; display: flex; align-items: center; justify-content: center; color: white; font-weight: 600; font-size: 0.875rem;">A</div>
@@ -122,4 +219,51 @@ final readonly class AdminSidebar implements StaticComponent
     {
         return $path === $this->currentPath ? 'aria-current="page"' : '';
     }
+
+    /**
+     * Parse navigation menu from attributes
+     */
+    private function parseNavigationMenu(array $attributes): ?NavigationMenu
+    {
+        // Try different attribute names
+        $menuData = $attributes['navigation-menu'] 
+            ?? $attributes['navigation_menu'] 
+            ?? $attributes['navigationMenu'] 
+            ?? null;
+
+        if ($menuData === null) {
+            return null;
+        }
+
+        // Handle array directly
+        if (is_array($menuData)) {
+            try {
+                return NavigationMenu::fromArray($menuData);
+            } catch (\Exception) {
+                return null;
+            }
+        }
+
+        // Handle JSON string
+        if (is_string($menuData)) {
+            $decoded = json_decode($menuData, true);
+            if (is_array($decoded)) {
+                try {
+                    return NavigationMenu::fromArray($decoded);
+                } catch (\Exception) {
+                    return null;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Escape HTML special characters
+     */
+    private function escape(string $string): string
+    {
+        return htmlspecialchars($string, ENT_QUOTES, 'UTF-8');
+    }
 }
diff --git a/src/Framework/View/Dom/Transformer/XComponentTransformer.php b/src/Framework/View/Dom/Transformer/XComponentTransformer.php
index 3e1bc7ff..190ccc87 100644
--- a/src/Framework/View/Dom/Transformer/XComponentTransformer.php
+++ b/src/Framework/View/Dom/Transformer/XComponentTransformer.php
@@ -261,15 +261,32 @@ final class XComponentTransformer implements NodeVisitor, AstTransformer
 
     /**
      * Extract attributes as strings (for StaticComponents)
+     * Also handles JSON strings for complex data types
      *
-     * @return array<string, string>
+     * @return array<string, string|array|mixed>
      */
     private function extractAttributesForStaticComponent(ElementNode $element): array
     {
         $attributes = [];
 
         foreach ($element->getAttributes() as $attr) {
-            $attributes[$attr->name] = $attr->value;
+            $value = $attr->value;
+            
+            // Try to parse JSON strings (for arrays/objects passed as attributes)
+            // This allows templates to pass complex data like: navigation-menu='{"sections":[...]}'
+            if (is_string($value) && (str_starts_with($value, '[') || str_starts_with($value, '{'))) {
+                try {
+                    $decoded = json_decode($value, true, 512, JSON_THROW_ON_ERROR);
+                    if (is_array($decoded)) {
+                        $attributes[$attr->name] = $decoded;
+                        continue;
+                    }
+                } catch (\JsonException) {
+                    // Not valid JSON, use as string
+                }
+            }
+            
+            $attributes[$attr->name] = $value;
         }
 
         return $attributes;
diff --git a/src/Framework/View/Exception/TemplateNotFound.php b/src/Framework/View/Exception/TemplateNotFound.php
index 177e9d64..54bd4309 100644
--- a/src/Framework/View/Exception/TemplateNotFound.php
+++ b/src/Framework/View/Exception/TemplateNotFound.php
@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\View\Exception;
 
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -16,18 +14,9 @@ final class TemplateNotFound extends FrameworkException
 {
     public static function forTemplate(string $template, ?string $searchPath = null, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_loading', 'TemplateLoader')
-            ->withData([
-                'template' => $template,
-                'search_path' => $searchPath,
-                'timestamp' => microtime(true),
-            ]);
-
-        return self::fromContext(
-            "Das Template '$template' konnte nicht geladen werden.",
-            $context,
-            ErrorCode::TPL_TEMPLATE_NOT_FOUND,
-            $previous
+        return new self(
+            template: $template,
+            previous: $previous
         );
     }
 
@@ -37,13 +26,9 @@ final class TemplateNotFound extends FrameworkException
      */
     public function __construct(string $template, ?\Throwable $previous = null, int $code = 0, array $context = [])
     {
-        $exceptionContext = ExceptionContext::forOperation('template_loading', 'TemplateLoader')
-            ->withData(['template' => $template] + $context);
-
         parent::__construct(
             message: "Das Template '$template' konnte nicht geladen werden.",
-            context: $exceptionContext,
-            errorCode: ErrorCode::TPL_TEMPLATE_NOT_FOUND,
+            code: $code,
             previous: $previous
         );
     }
diff --git a/src/Framework/View/Exceptions/TemplateCacheException.php b/src/Framework/View/Exceptions/TemplateCacheException.php
index 8b0d73de..fe3a686c 100644
--- a/src/Framework/View/Exceptions/TemplateCacheException.php
+++ b/src/Framework/View/Exceptions/TemplateCacheException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\View\Exceptions;
 
 use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,78 +14,36 @@ final class TemplateCacheException extends FrameworkException
 {
     public static function cacheWriteFailed(string $cacheKey, string $cachePath, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_cache_write', 'CacheManager')
-            ->withData([
-                'cache_key' => $cacheKey,
-                'cache_path' => $cachePath,
-                'operation' => 'write',
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'fallback_to_uncached',
-                'cache_type' => 'template',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template cache write failed for key '$cacheKey'.",
-            $context,
-            ErrorCode::TPL_CACHE_FAILED,
+            (int) ErrorCode::TPL_CACHE_FAILED->value,
             $previous
         );
     }
 
     public static function cacheReadFailed(string $cacheKey, string $cachePath, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_cache_read', 'CacheManager')
-            ->withData([
-                'cache_key' => $cacheKey,
-                'cache_path' => $cachePath,
-                'operation' => 'read',
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'regenerate_cache',
-                'cache_type' => 'template',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template cache read failed for key '$cacheKey'.",
-            $context,
-            ErrorCode::TPL_CACHE_FAILED,
+            (int) ErrorCode::TPL_CACHE_FAILED->value,
             $previous
         );
     }
 
     public static function cacheInvalidationFailed(string $cacheKey, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_cache_invalidation', 'CacheManager')
-            ->withData([
-                'cache_key' => $cacheKey,
-                'operation' => 'invalidate',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template cache invalidation failed for key '$cacheKey'.",
-            $context,
-            ErrorCode::TPL_CACHE_FAILED,
+            (int) ErrorCode::TPL_CACHE_FAILED->value,
             $previous
         );
     }
 
     public static function invalidCacheFormat(string $cacheKey, string $expectedFormat, string $actualFormat, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_cache_validation', 'CacheManager')
-            ->withData([
-                'cache_key' => $cacheKey,
-                'expected_format' => $expectedFormat,
-                'actual_format' => $actualFormat,
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'regenerate_cache',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Invalid template cache format for key '$cacheKey'. Expected '$expectedFormat', got '$actualFormat'.",
-            $context,
-            ErrorCode::TPL_CACHE_FAILED,
+            (int) ErrorCode::TPL_CACHE_FAILED->value,
             $previous
         );
     }
diff --git a/src/Framework/View/Exceptions/TemplateNotFoundException.php b/src/Framework/View/Exceptions/TemplateNotFoundException.php
index e334777b..14659712 100644
--- a/src/Framework/View/Exceptions/TemplateNotFoundException.php
+++ b/src/Framework/View/Exceptions/TemplateNotFoundException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\View\Exceptions;
 
 use App\Framework\Exception\Core\TemplateErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,41 +14,20 @@ final class TemplateNotFoundException extends FrameworkException
 {
     public static function forTemplate(string $template, ?string $searchPath = null, ?array $searchPaths = null, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_resolution', 'TemplateEngine')
-            ->withData([
-                'template' => $template,
-                'search_path' => $searchPath,
-                'search_paths' => $searchPaths ?? [],
-                'timestamp' => microtime(true),
-            ])
-            ->withMetadata([
-                'suggestions' => self::generateSuggestions($template, $searchPaths ?? []),
-                'template_type' => self::detectTemplateType($template),
-            ]);
-
         $pathInfo = $searchPath ? " (searched in: $searchPath)" : '';
 
-        return self::fromContext(
+        return new self(
             "Template \"$template\" nicht gefunden $pathInfo.",
-            $context,
-            TemplateErrorCode::TEMPLATE_NOT_FOUND,
+            (int) TemplateErrorCode::TEMPLATE_NOT_FOUND->value,
             $previous
         );
     }
 
     public static function withFallback(string $template, string $fallbackTemplate, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_fallback', 'TemplateEngine')
-            ->withData([
-                'template' => $template,
-                'fallback_template' => $fallbackTemplate,
-                'recovery_strategy' => 'fallback_template',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template \"$template\" und Fallback \"$fallbackTemplate\" nicht gefunden.",
-            $context,
-            TemplateErrorCode::TEMPLATE_NOT_FOUND,
+            (int) TemplateErrorCode::TEMPLATE_NOT_FOUND->value,
             $previous
         );
     }
@@ -59,21 +37,13 @@ final class TemplateNotFoundException extends FrameworkException
      * @deprecated Use forTemplate() factory method instead
      */
     public function __construct(
-        string $template,
-        string $file,
+        string $message,
         int $code = 0,
         ?\Throwable $previous = null
     ) {
-        $context = ExceptionContext::forOperation('template_render', 'view_engine')
-            ->withData([
-                'template' => $template,
-                'file' => $file,
-            ]);
-
         parent::__construct(
-            message: "Template \"$template\" nicht gefunden ($file).",
-            context: $context,
-            errorCode: TemplateErrorCode::TEMPLATE_NOT_FOUND,
+            message: $message,
+            code: $code,
             previous: $previous
         );
     }
diff --git a/src/Framework/View/Exceptions/TemplateProcessorException.php b/src/Framework/View/Exceptions/TemplateProcessorException.php
index 00f50e41..caab4e21 100644
--- a/src/Framework/View/Exceptions/TemplateProcessorException.php
+++ b/src/Framework/View/Exceptions/TemplateProcessorException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\View\Exceptions;
 
 use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,117 +14,54 @@ final class TemplateProcessorException extends FrameworkException
 {
     public static function processorFailed(string $processorClass, string $template, string $operation, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_processing', $processorClass)
-            ->withData([
-                'processor' => $processorClass,
-                'template' => $template,
-                'operation' => $operation,
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'skip_processor_or_fallback',
-                'processor_type' => self::getProcessorType($processorClass),
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template processor '$processorClass' failed for template '$template' during '$operation'.",
-            $context,
-            ErrorCode::TPL_PROCESSOR_FAILED,
+            (int) ErrorCode::TPL_PROCESSOR_FAILED->value,
             $previous
         );
     }
 
     public static function assetNotFound(string $assetPath, string $manifestPath, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('asset_injection', 'AssetInjector')
-            ->withData([
-                'asset_path' => $assetPath,
-                'manifest_path' => $manifestPath,
-                'error_type' => 'asset_not_found',
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'use_development_fallback_or_skip',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Asset '$assetPath' not found in manifest '$manifestPath'.",
-            $context,
-            ErrorCode::TPL_ASSET_NOT_FOUND,
+            (int) ErrorCode::TPL_ASSET_NOT_FOUND->value,
             $previous
         );
     }
 
     public static function manifestNotFound(string $manifestPath, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('manifest_loading', 'AssetInjector')
-            ->withData([
-                'manifest_path' => $manifestPath,
-                'error_type' => 'manifest_not_found',
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'use_development_mode_or_disable_assets',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Vite manifest not found: $manifestPath",
-            $context,
-            ErrorCode::TPL_ASSET_NOT_FOUND,
+            (int) ErrorCode::TPL_ASSET_NOT_FOUND->value,
             $previous
         );
     }
 
     public static function contentLoadingFailed(string $path, string $reason, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('content_loading', 'TemplateContentLoader')
-            ->withData([
-                'path' => $path,
-                'reason' => $reason,
-                'file_exists' => file_exists($path),
-                'is_readable' => is_readable($path),
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'check_permissions_or_fallback',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template content loading failed for '$path': $reason",
-            $context,
-            ErrorCode::TPL_CONTENT_LOADING_FAILED,
+            (int) ErrorCode::TPL_CONTENT_LOADING_FAILED->value,
             $previous
         );
     }
 
     public static function invalidProcessorConfiguration(string $processorClass, string $issue, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('processor_configuration', 'TemplateEngine')
-            ->withData([
-                'processor' => $processorClass,
-                'configuration_issue' => $issue,
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Invalid processor configuration for '$processorClass': $issue",
-            $context,
-            ErrorCode::TPL_PROCESSOR_FAILED,
+            (int) ErrorCode::TPL_PROCESSOR_FAILED->value,
             $previous
         );
     }
 
     public static function processorChainFailed(array $processorChain, string $failedProcessor, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('processor_chain', 'TemplateEngine')
-            ->withData([
-                'processor_chain' => $processorChain,
-                'failed_processor' => $failedProcessor,
-                'chain_position' => array_search($failedProcessor, $processorChain),
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'skip_failed_processor_and_continue',
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template processor chain failed at '$failedProcessor'.",
-            $context,
-            ErrorCode::TPL_PROCESSOR_FAILED,
+            (int) ErrorCode::TPL_PROCESSOR_FAILED->value,
             $previous
         );
     }
diff --git a/src/Framework/View/Exceptions/TemplateRenderingException.php b/src/Framework/View/Exceptions/TemplateRenderingException.php
index f826c8a3..772067be 100644
--- a/src/Framework/View/Exceptions/TemplateRenderingException.php
+++ b/src/Framework/View/Exceptions/TemplateRenderingException.php
@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace App\Framework\View\Exceptions;
 
 use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 /**
@@ -15,96 +14,47 @@ final class TemplateRenderingException extends FrameworkException
 {
     public static function renderingFailed(string $template, string $stage, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_rendering', 'TemplateProcessor')
-            ->withData([
-                'template' => $template,
-                'stage' => $stage,
-                'error_type' => 'rendering_failed',
-            ])
-            ->withMetadata([
-                'recovery_strategy' => 'fallback_template_or_error_page',
-                'stage_description' => self::getStageDescription($stage),
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template rendering failed for '$template' at stage '$stage'.",
-            $context,
-            ErrorCode::TPL_RENDERING_FAILED,
+            (int) ErrorCode::TPL_RENDERING_FAILED->value,
             $previous
         );
     }
 
     public static function invalidRendererOutput(string $template, string $expectedType, string $actualType, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_output_validation', 'TemplateProcessor')
-            ->withData([
-                'template' => $template,
-                'expected_type' => $expectedType,
-                'actual_type' => $actualType,
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template renderer must return '$expectedType', got '$actualType' for template '$template'.",
-            $context,
-            ErrorCode::TPL_RENDERING_FAILED,
+            (int) ErrorCode::TPL_RENDERING_FAILED->value,
             $previous
         );
     }
 
     public static function variableNotFound(string $template, string $variable, array $availableVariables = [], ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_variable_resolution', 'TemplateProcessor')
-            ->withData([
-                'template' => $template,
-                'missing_variable' => $variable,
-                'available_variables' => array_keys($availableVariables),
-            ])
-            ->withMetadata([
-                'suggestions' => self::findSimilarVariables($variable, array_keys($availableVariables)),
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template variable '$variable' not found in template '$template'.",
-            $context,
-            ErrorCode::TPL_VARIABLE_NOT_FOUND,
+            (int) ErrorCode::TPL_VARIABLE_NOT_FOUND->value,
             $previous
         );
     }
 
     public static function syntaxError(string $template, string $error, int $line = 0, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_parsing', 'TemplateProcessor')
-            ->withData([
-                'template' => $template,
-                'syntax_error' => $error,
-                'line' => $line,
-            ])
-            ->withMetadata([
-                'error_category' => 'syntax',
-            ]);
-
         $lineInfo = $line > 0 ? " at line $line" : '';
 
-        return self::fromContext(
+        return new self(
             "Template syntax error in '$template'$lineInfo: $error",
-            $context,
-            ErrorCode::TPL_SYNTAX_ERROR,
+            (int) ErrorCode::TPL_SYNTAX_ERROR->value,
             $previous
         );
     }
 
     public static function compilationFailed(string $template, string $compiler, ?\Throwable $previous = null): self
     {
-        $context = ExceptionContext::forOperation('template_compilation', $compiler)
-            ->withData([
-                'template' => $template,
-                'compiler' => $compiler,
-            ]);
-
-        return self::fromContext(
+        return new self(
             "Template compilation failed for '$template' using compiler '$compiler'.",
-            $context,
-            ErrorCode::TPL_COMPILATION_FAILED,
+            (int) ErrorCode::TPL_COMPILATION_FAILED->value,
             $previous
         );
     }
diff --git a/src/Framework/View/Loading/TemplatePathResolver.php b/src/Framework/View/Loading/TemplatePathResolver.php
index d60af607..27d551ac 100644
--- a/src/Framework/View/Loading/TemplatePathResolver.php
+++ b/src/Framework/View/Loading/TemplatePathResolver.php
@@ -21,6 +21,6 @@ final readonly class TemplatePathResolver
             }
         }
 
-        throw new TemplateNotFoundException($template, $controllerClass ?? '');
+        throw TemplateNotFoundException::forTemplate($template);
     }
 }
diff --git a/src/Framework/View/Processors/Exceptions/ViteManifestNotFoundException.php b/src/Framework/View/Processors/Exceptions/ViteManifestNotFoundException.php
index fae0a595..65faa7cc 100644
--- a/src/Framework/View/Processors/Exceptions/ViteManifestNotFoundException.php
+++ b/src/Framework/View/Processors/Exceptions/ViteManifestNotFoundException.php
@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace App\Framework\View\Processors\Exceptions;
 
-use App\Framework\Exception\ExceptionContext;
 use App\Framework\Exception\FrameworkException;
 
 final class ViteManifestNotFoundException extends FrameworkException
@@ -16,8 +15,6 @@ final class ViteManifestNotFoundException extends FrameworkException
     ) {
         parent::__construct(
             message: "Vite manifest not found: $manifestPath",
-            context: ExceptionContext::forOperation('vite_manifest_load', 'View')
-                ->withData(['manifestPath' => $manifestPath]),
             code: $code,
             previous: $previous
         );
diff --git a/src/Framework/View/Processors/PhpVariableProcessor.php b/src/Framework/View/Processors/PhpVariableProcessor.php
index 841968e9..c45ae76b 100644
--- a/src/Framework/View/Processors/PhpVariableProcessor.php
+++ b/src/Framework/View/Processors/PhpVariableProcessor.php
@@ -26,6 +26,9 @@ final class PhpVariableProcessor implements StringProcessor
         // Array-Funktionen
         'count', 'implode', 'array_keys', 'array_values',
 
+        // JSON-Funktionen (für Component-Attribute)
+        'json_encode',
+
         // Custom Template-Funktionen
         'format_date', 'format_currency', 'format_filesize',
 
@@ -325,8 +328,8 @@ final class PhpVariableProcessor implements StringProcessor
                 continue;
             }
 
-            // Variablen: $name
-            if (preg_match('/^\$([a-zA-Z_][a-zA-Z0-9_]*)$/', $part, $matches)) {
+            // Variablen: $name oder name (ohne $)
+            if (preg_match('/^\$?([a-zA-Z_][a-zA-Z0-9_]*)$/', $part, $matches)) {
                 $varName = $matches[1];
                 if (array_key_exists($varName, $data)) {
                     $args[] = $data[$varName];
diff --git a/src/Framework/View/Table/Generators/DatabaseMetadataTableGenerator.php b/src/Framework/View/Table/Generators/DatabaseMetadataTableGenerator.php
new file mode 100644
index 00000000..bd96c47b
--- /dev/null
+++ b/src/Framework/View/Table/Generators/DatabaseMetadataTableGenerator.php
@@ -0,0 +1,251 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\View\Table\Generators;
+
+use App\Framework\Database\Browser\ValueObjects\ColumnMetadata;
+use App\Framework\Database\Browser\ValueObjects\ForeignKeyMetadata;
+use App\Framework\Database\Browser\ValueObjects\IndexMetadata;
+use App\Framework\View\Table\CellFormatter;
+use App\Framework\View\Table\Table;
+use App\Framework\View\Table\TableColumn;
+use App\Framework\View\Table\TableGenerator;
+use App\Framework\View\Table\TableOptions;
+use App\Framework\View\Table\TableRow;
+
+final readonly class DatabaseMetadataTableGenerator implements TableGenerator
+{
+    /**
+     * Generate table for columns
+     */
+    public function generateColumns(array $columns): Table
+    {
+        $tableColumns = [
+            TableColumn::text('name', 'Column', 'column-name'),
+            TableColumn::text('type', 'Type', 'column-type'),
+            new TableColumn(
+                key: 'nullable',
+                header: 'Nullable',
+                cssClass: 'column-nullable',
+                formatter: $this->createBooleanFormatter()
+            ),
+            TableColumn::text('default', 'Default', 'column-default'),
+            new TableColumn(
+                key: 'key',
+                header: 'Key',
+                cssClass: 'column-key',
+                formatter: $this->createKeyFormatter()
+            ),
+            TableColumn::text('extra', 'Extra', 'column-extra'),
+        ];
+
+        $rows = [];
+        foreach ($columns as $column) {
+            if ($column instanceof ColumnMetadata) {
+                $rowData = [
+                    'name' => $column->name,
+                    'type' => $column->type,
+                    'nullable' => $column->nullable,
+                    'default' => $column->default,
+                    'key' => $column->key,
+                    'extra' => $column->extra,
+                ];
+            } elseif (is_array($column)) {
+                $rowData = $column;
+            } else {
+                continue;
+            }
+
+            $rows[] = TableRow::fromData($rowData, $tableColumns, 'column-row');
+        }
+
+        $options = new TableOptions(
+            striped: true,
+            bordered: true,
+            hover: true,
+            responsive: true,
+            emptyMessage: 'No columns found'
+        );
+
+        return new Table(
+            columns: $tableColumns,
+            rows: $rows,
+            cssClass: 'admin-table column-table',
+            options: $options,
+            id: 'columnsTable'
+        );
+    }
+
+    /**
+     * Generate table for indexes
+     */
+    public function generateIndexes(array $indexes): Table
+    {
+        $tableColumns = [
+            TableColumn::text('name', 'Index Name', 'index-name'),
+            TableColumn::text('columns', 'Columns', 'index-columns'),
+            new TableColumn(
+                key: 'unique',
+                header: 'Unique',
+                cssClass: 'index-unique',
+                formatter: $this->createBooleanFormatter()
+            ),
+            TableColumn::text('type', 'Type', 'index-type'),
+        ];
+
+        $rows = [];
+        foreach ($indexes as $index) {
+            if ($index instanceof IndexMetadata) {
+                $rowData = [
+                    'name' => $index->name,
+                    'columns' => implode(', ', $index->columns),
+                    'unique' => $index->unique,
+                    'type' => $index->type,
+                ];
+            } elseif (is_array($index)) {
+                $rowData = $index;
+            } else {
+                continue;
+            }
+
+            $rows[] = TableRow::fromData($rowData, $tableColumns, 'index-row');
+        }
+
+        $options = new TableOptions(
+            striped: true,
+            bordered: true,
+            hover: true,
+            responsive: true,
+            emptyMessage: 'No indexes found'
+        );
+
+        return new Table(
+            columns: $tableColumns,
+            rows: $rows,
+            cssClass: 'admin-table index-table',
+            options: $options,
+            id: 'indexesTable'
+        );
+    }
+
+    /**
+     * Generate table for foreign keys
+     */
+    public function generateForeignKeys(array $foreignKeys): Table
+    {
+        $tableColumns = [
+            TableColumn::text('name', 'Constraint', 'fk-name'),
+            TableColumn::text('column', 'Column', 'fk-column'),
+            TableColumn::text('referenced_table', 'Referenced Table', 'fk-referenced-table'),
+            TableColumn::text('referenced_column', 'Referenced Column', 'fk-referenced-column'),
+        ];
+
+        $rows = [];
+        foreach ($foreignKeys as $fk) {
+            if ($fk instanceof ForeignKeyMetadata) {
+                $rowData = [
+                    'name' => $fk->name,
+                    'column' => $fk->column,
+                    'referenced_table' => $fk->referencedTable,
+                    'referenced_column' => $fk->referencedColumn,
+                ];
+            } elseif (is_array($fk)) {
+                $rowData = $fk;
+            } else {
+                continue;
+            }
+
+            $rows[] = TableRow::fromData($rowData, $tableColumns, 'fk-row');
+        }
+
+        $options = new TableOptions(
+            striped: true,
+            bordered: true,
+            hover: true,
+            responsive: true,
+            emptyMessage: 'No foreign keys found'
+        );
+
+        return new Table(
+            columns: $tableColumns,
+            rows: $rows,
+            cssClass: 'admin-table foreign-key-table',
+            options: $options,
+            id: 'foreignKeysTable'
+        );
+    }
+
+    public function generate(object|array $data, ?TableOptions $options = null): Table
+    {
+        // Default: try to generate columns table
+        if (is_array($data) && !empty($data)) {
+            $firstItem = reset($data);
+            if ($firstItem instanceof ColumnMetadata) {
+                return $this->generateColumns($data);
+            }
+            if ($firstItem instanceof IndexMetadata) {
+                return $this->generateIndexes($data);
+            }
+            if ($firstItem instanceof ForeignKeyMetadata) {
+                return $this->generateForeignKeys($data);
+            }
+        }
+
+        throw new \InvalidArgumentException('DatabaseMetadataTableGenerator: Unsupported data type');
+    }
+
+    public function supports(object|array $data): bool
+    {
+        if (!is_array($data) || empty($data)) {
+            return false;
+        }
+
+        $firstItem = reset($data);
+        return $firstItem instanceof ColumnMetadata
+            || $firstItem instanceof IndexMetadata
+            || $firstItem instanceof ForeignKeyMetadata;
+    }
+
+    private function createBooleanFormatter(): CellFormatter
+    {
+        return new class () implements CellFormatter {
+            public function format(mixed $value): string
+            {
+                $bool = (bool) $value;
+                if ($bool) {
+                    return '<span class="badge badge--success">Yes</span>';
+                }
+
+                return '<span class="badge badge--secondary">No</span>';
+            }
+        };
+    }
+
+    private function createKeyFormatter(): CellFormatter
+    {
+        return new class () implements CellFormatter {
+            public function format(mixed $value): string
+            {
+                if ($value === null || $value === '') {
+                    return '<em class="text-muted">-</em>';
+                }
+
+                $key = strtoupper((string) $value);
+                $badgeClass = match ($key) {
+                    'PRI' => 'badge--primary',
+                    'UNI' => 'badge--info',
+                    'MUL' => 'badge--warning',
+                    default => 'badge--secondary'
+                };
+
+                return sprintf(
+                    '<span class="badge %s">%s</span>',
+                    $badgeClass,
+                    htmlspecialchars($key, ENT_QUOTES)
+                );
+            }
+        };
+    }
+}
+
diff --git a/src/Framework/View/Table/Generators/DatabaseTableGenerator.php b/src/Framework/View/Table/Generators/DatabaseTableGenerator.php
new file mode 100644
index 00000000..8cb7df58
--- /dev/null
+++ b/src/Framework/View/Table/Generators/DatabaseTableGenerator.php
@@ -0,0 +1,129 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\View\Table\Generators;
+
+use App\Framework\Database\Browser\ValueObjects\TableMetadata;
+use App\Framework\View\Table\CellFormatter;
+use App\Framework\View\Table\Table;
+use App\Framework\View\Table\TableColumn;
+use App\Framework\View\Table\TableGenerator;
+use App\Framework\View\Table\TableOptions;
+use App\Framework\View\Table\TableRow;
+
+final readonly class DatabaseTableGenerator implements TableGenerator
+{
+    public function generate(object|array $data, ?TableOptions $options = null): Table
+    {
+        if (!is_array($data)) {
+            throw new \InvalidArgumentException('DatabaseTableGenerator expects array of TableMetadata');
+        }
+
+        $columns = [
+            TableColumn::text('name', 'Table Name', 'table-name'),
+            new TableColumn(
+                key: 'row_count',
+                header: 'Rows',
+                cssClass: 'table-rows',
+                formatter: $this->createNumberFormatter()
+            ),
+            new TableColumn(
+                key: 'size_mb',
+                header: 'Size (MB)',
+                cssClass: 'table-size',
+                formatter: $this->createSizeFormatter()
+            ),
+            TableColumn::text('engine', 'Engine', 'table-engine'),
+            TableColumn::text('collation', 'Collation', 'table-collation'),
+        ];
+
+        $rows = [];
+        foreach ($data as $table) {
+            if ($table instanceof TableMetadata) {
+                $rowData = [
+                    'name' => $table->name,
+                    'row_count' => $table->rowCount,
+                    'size_mb' => $table->sizeMb,
+                    'engine' => $table->engine,
+                    'collation' => $table->collation,
+                ];
+            } elseif (is_array($table)) {
+                $rowData = $table;
+            } else {
+                continue;
+            }
+
+            $rows[] = TableRow::fromData($rowData, $columns, 'table-row');
+        }
+
+        $tableOptions = $options ?? new TableOptions(
+            striped: true,
+            bordered: true,
+            hover: true,
+            responsive: true,
+            emptyMessage: 'No tables found'
+        );
+
+        return new Table(
+            columns: $columns,
+            rows: $rows,
+            cssClass: 'admin-table database-table',
+            options: $tableOptions,
+            id: 'databaseTablesTable'
+        );
+    }
+
+    public function supports(object|array $data): bool
+    {
+        if (!is_array($data) || empty($data)) {
+            return false;
+        }
+
+        $firstItem = reset($data);
+        if ($firstItem instanceof TableMetadata) {
+            return true;
+        }
+
+        if (is_array($firstItem)) {
+            // Check if it has table structure
+            return isset($firstItem['name']) || isset($firstItem['table_name']);
+        }
+
+        return false;
+    }
+
+    private function createNumberFormatter(): CellFormatter
+    {
+        return new class () implements CellFormatter {
+            public function format(mixed $value): string
+            {
+                if ($value === null) {
+                    return '<em class="text-muted">N/A</em>';
+                }
+
+                return number_format((int) $value, 0, '.', ',');
+            }
+        };
+    }
+
+    private function createSizeFormatter(): CellFormatter
+    {
+        return new class () implements CellFormatter {
+            public function format(mixed $value): string
+            {
+                if ($value === null) {
+                    return '<em class="text-muted">N/A</em>';
+                }
+
+                $size = (float) $value;
+                if ($size < 0.01) {
+                    return '< 0.01';
+                }
+
+                return number_format($size, 2);
+            }
+        };
+    }
+}
+
diff --git a/src/Framework/View/TemplateMapper.php b/src/Framework/View/TemplateMapper.php
index 66c856e1..5eb24500 100644
--- a/src/Framework/View/TemplateMapper.php
+++ b/src/Framework/View/TemplateMapper.php
@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace App\Framework\View;
 
 use App\Framework\Core\AttributeMapper;
-use App\Framework\Reflection\WrappedReflectionClass;
-use App\Framework\Reflection\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
 
 final class TemplateMapper implements AttributeMapper
 {
diff --git a/src/Framework/View/templates/livecomponent-docker-containers.view.php b/src/Framework/View/templates/livecomponent-docker-containers.view.php
new file mode 100644
index 00000000..2ef0cc35
--- /dev/null
+++ b/src/Framework/View/templates/livecomponent-docker-containers.view.php
@@ -0,0 +1,194 @@
+<div class="docker-containers-component">
+    <!-- Docker Status -->
+    <div class="admin-card" if="{{$isRunning}}">
+        <div class="admin-card__header">
+            <h3 class="admin-card__title">Docker Status</h3>
+        </div>
+        <div class="admin-card__content">
+            <div class="admin-stat-list">
+                <div class="admin-stat-list__item">
+                    <span class="admin-stat-list__label">Version</span>
+                    <span class="admin-stat-list__value">{{$dockerVersion}}</span>
+                </div>
+                <div class="admin-stat-list__item">
+                    <span class="admin-stat-list__label">Status</span>
+                    <span class="admin-badge admin-badge--success">Running</span>
+                </div>
+                <div class="admin-stat-list__item">
+                    <span class="admin-stat-list__label">Total Containers</span>
+                    <span class="admin-stat-list__value">{{$totalContainers}}</span>
+                </div>
+                <div class="admin-stat-list__item">
+                    <span class="admin-stat-list__label">Running</span>
+                    <span class="admin-stat-list__value">{{$runningContainers}}</span>
+                </div>
+                <div class="admin-stat-list__item">
+                    <span class="admin-stat-list__label">Stopped</span>
+                    <span class="admin-stat-list__value">{{$stoppedContainers}}</span>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <div class="admin-card" if="{{!$isRunning}}">
+        <div class="admin-card__content">
+            <div class="alert alert-error">
+                <strong>Docker is not running</strong>
+                <p>Docker daemon is not accessible. Please check if Docker is installed and running.</p>
+            </div>
+        </div>
+    </div>
+
+    <!-- Containers Table -->
+    <div class="admin-card" style="margin-top: var(--space-lg);">
+        <div class="admin-card__header">
+            <h3 class="admin-card__title">Containers</h3>
+        </div>
+        <div class="admin-card__content">
+            <table class="admin-table" id="docker-containers-table">
+                <thead>
+                    <tr>
+                        <th>Name</th>
+                        <th>Image</th>
+                        <th>Status</th>
+                        <th>CPU</th>
+                        <th>Memory</th>
+                        <th>Actions</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <tr foreach="$containers as $container">
+                        <td>{{$container['name']}}</td>
+                        <td>{{$container['image']}}</td>
+                        <td>
+                            <span class="admin-badge admin-badge--success" if="{{$container['is_running']}}">Running</span>
+                            <span class="admin-badge admin-badge--secondary" if="{{!$container['is_running']}}">Stopped</span>
+                        </td>
+                        <td>
+                            <span if="{{$container['stats']}}">{{$container['stats']['cpu_percent']}}%</span>
+                            <span if="{{!$container['stats']}}">-</span>
+                        </td>
+                        <td>
+                            <span if="{{$container['stats']}}">{{$container['stats']['memory_usage']}} / {{$container['stats']['memory_limit']}}</span>
+                            <span if="{{!$container['stats']}}">-</span>
+                        </td>
+                        <td>
+                            <div class="btn-group">
+                                <button class="btn btn-sm btn-secondary" onclick="stopContainer('{{$container['id']}}')" if="{{$container['is_running']}}">Stop</button>
+                                <button class="btn btn-sm btn-secondary" onclick="restartContainer('{{$container['id']}}')" if="{{$container['is_running']}}">Restart</button>
+                                <button class="btn btn-sm btn-primary" onclick="startContainer('{{$container['id']}}')" if="{{!$container['is_running']}}">Start</button>
+                                <button class="btn btn-sm btn-secondary" onclick="showLogs('{{$container['id']}}')">Logs</button>
+                            </div>
+                        </td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </div>
+
+    <div class="component-footer">
+        <span class="component-footer__text">Last updated: {{$lastUpdated}}</span>
+        <span class="component-footer__badge">Updates every 5s</span>
+    </div>
+</div>
+
+<script>
+function startContainer(containerId) {
+    fetch(`/admin/infrastructure/docker/api/containers/${containerId}/start`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        }
+    })
+    .then(response => response.json())
+    .then(data => {
+        if (data.success) {
+            window.location.reload();
+        } else {
+            alert('Failed to start container: ' + (data.message || 'Unknown error'));
+        }
+    })
+    .catch(error => {
+        alert('Error: ' + error.message);
+    });
+}
+
+function stopContainer(containerId) {
+    if (!confirm('Are you sure you want to stop this container?')) {
+        return;
+    }
+    
+    fetch(`/admin/infrastructure/docker/api/containers/${containerId}/stop`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        }
+    })
+    .then(response => response.json())
+    .then(data => {
+        if (data.success) {
+            window.location.reload();
+        } else {
+            alert('Failed to stop container: ' + (data.message || 'Unknown error'));
+        }
+    })
+    .catch(error => {
+        alert('Error: ' + error.message);
+    });
+}
+
+function restartContainer(containerId) {
+    if (!confirm('Are you sure you want to restart this container?')) {
+        return;
+    }
+    
+    fetch(`/admin/infrastructure/docker/api/containers/${containerId}/restart`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        }
+    })
+    .then(response => response.json())
+    .then(data => {
+        if (data.success) {
+            window.location.reload();
+        } else {
+            alert('Failed to restart container: ' + (data.message || 'Unknown error'));
+        }
+    })
+    .catch(error => {
+        alert('Error: ' + error.message);
+    });
+}
+
+function showLogs(containerId) {
+    window.open(`/admin/infrastructure/docker/api/containers/${containerId}/logs`, '_blank');
+}
+</script>
+
+<style>
+.docker-containers-component {
+    padding: 0;
+}
+
+.component-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.75rem 1rem;
+    background: #f8f9fa;
+    border-radius: 6px;
+    font-size: 0.75rem;
+    color: #666;
+    margin-top: var(--space-md);
+}
+
+.component-footer__badge {
+    background: #007bff;
+    color: white;
+    padding: 0.25rem 0.5rem;
+    border-radius: 12px;
+    font-size: 0.7rem;
+}
+</style>
+
diff --git a/src/Framework/View/templates/livecomponent-health-status.view.php b/src/Framework/View/templates/livecomponent-health-status.view.php
new file mode 100644
index 00000000..472e7e4a
--- /dev/null
+++ b/src/Framework/View/templates/livecomponent-health-status.view.php
@@ -0,0 +1,95 @@
+<div class="health-status-component">
+    <!-- Overall Status -->
+    <div class="admin-card">
+        <div class="admin-card__header">
+            <h3 class="admin-card__title">System Overview</h3>
+        </div>
+        <div class="admin-card__content">
+            <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: var(--space-md); margin-bottom: var(--space-lg);">
+                <div class="metric-card">
+                    <div class="metric-card__value" style="color: var(--success);">
+                        {{$overallStatus}}
+                    </div>
+                    <div class="metric-card__label">Overall Status</div>
+                </div>
+                <div class="metric-card">
+                    <div class="metric-card__value">{{$totalChecks}}</div>
+                    <div class="metric-card__label">Total Checks</div>
+                </div>
+                <div class="metric-card">
+                    <div class="metric-card__value" style="color: var(--success);">{{$healthyChecks}}</div>
+                    <div class="metric-card__label">Healthy</div>
+                </div>
+                <div class="metric-card">
+                    <div class="metric-card__value" style="color: var(--warning);">{{$warningChecks}}</div>
+                    <div class="metric-card__label">Warnings</div>
+                </div>
+                <div class="metric-card">
+                    <div class="metric-card__value" style="color: var(--error);">{{$failedChecks}}</div>
+                    <div class="metric-card__label">Failed</div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Health Check Details -->
+    <div class="admin-card" style="margin-top: var(--space-lg);">
+        <div class="admin-card__header">
+            <h3 class="admin-card__title">Health Check Details</h3>
+        </div>
+        <table-data source="{{$healthCheckTable}}" container-class="admin-card" />
+    </div>
+
+    <div class="component-footer">
+        <span class="component-footer__text">Last updated: {{$lastUpdated}}</span>
+        <span class="component-footer__badge">Updates every 5s</span>
+    </div>
+</div>
+
+<style>
+.health-status-component {
+    padding: 0;
+}
+
+.metric-card {
+    text-align: center;
+    padding: var(--space-md);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md);
+    background: var(--bg-alt);
+}
+
+.metric-card__value {
+    font-size: 2rem;
+    font-weight: 700;
+    margin-bottom: var(--space-sm);
+}
+
+.metric-card__label {
+    font-size: 0.875rem;
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.component-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.75rem 1rem;
+    background: #f8f9fa;
+    border-radius: 6px;
+    font-size: 0.75rem;
+    color: #666;
+    margin-top: var(--space-md);
+}
+
+.component-footer__badge {
+    background: #007bff;
+    color: white;
+    padding: 0.25rem 0.5rem;
+    border-radius: 12px;
+    font-size: 0.7rem;
+}
+</style>
+
diff --git a/src/Framework/View/templates/livecomponent-notification.view.php b/src/Framework/View/templates/livecomponent-notification.view.php
new file mode 100644
index 00000000..c8782e1d
--- /dev/null
+++ b/src/Framework/View/templates/livecomponent-notification.view.php
@@ -0,0 +1,22 @@
+<div
+    data-live-component="{{componentId}}"
+    data-state='{{stateJson}}'
+    class="livecomponent-notification {{type_class}} {{position_class}}"
+    style="display: {{is_visible ? 'block' : 'none'}};"
+    role="alert"
+    aria-live="polite"
+>
+    <div class="notification-content">
+        <if condition="icon">
+            <span class="notification-icon">{{icon}}</span>
+        </if>
+        <span class="notification-message">{{message}}</span>
+        <if condition="has_action">
+            <a href="{{action_url}}" class="notification-action" data-live-action="handleAction" data-param-action-url="{{action_url}}">
+                {{action_text}}
+            </a>
+        </if>
+        <button class="notification-close" data-live-action="hide" aria-label="Close">×</button>
+    </div>
+</div>
+
diff --git a/src/Framework/View/templates/livecomponent-performance-metrics.view.php b/src/Framework/View/templates/livecomponent-performance-metrics.view.php
new file mode 100644
index 00000000..92e0fad6
--- /dev/null
+++ b/src/Framework/View/templates/livecomponent-performance-metrics.view.php
@@ -0,0 +1,169 @@
+<div class="performance-metrics-component">
+    <div class="stats-grid">
+        <!-- Memory Card -->
+        <div class="stat-card stat-card--primary">
+            <div class="stat-card__icon">💾</div>
+            <div class="stat-card__content">
+                <div class="stat-card__value">{{$currentMemory}}</div>
+                <div class="stat-card__label">Current Memory</div>
+                <div class="stat-card__subvalue">{{$peakMemory}} peak</div>
+            </div>
+            <div class="stat-card__progress">
+                <div class="progress-bar">
+                    <div class="progress-fill" style="width: {{$memoryUsagePercentage}}%"></div>
+                </div>
+                <div class="stat-card__percentage">{{$memoryUsagePercentage}}%</div>
+            </div>
+        </div>
+
+        <!-- System Card -->
+        <div class="stat-card">
+            <div class="stat-card__icon">⚙️</div>
+            <div class="stat-card__content">
+                <div class="stat-card__value">{{$executionTime}}</div>
+                <div class="stat-card__label">Execution Time</div>
+                <div class="stat-card__subvalue">{{$includedFiles}} files loaded</div>
+            </div>
+        </div>
+
+        <!-- Load Average Card -->
+        <div class="stat-card" if="{{!empty($loadAverage)}}">
+            <div class="stat-card__icon">📊</div>
+            <div class="stat-card__content">
+                <div class="stat-card__value">
+                    {{$loadAverage[0]}} / {{$loadAverage[1]}} / {{$loadAverage[2]}}
+                </div>
+                <div class="stat-card__label">Load Average (1m / 5m / 15m)</div>
+            </div>
+        </div>
+
+        <!-- OPCache Card -->
+        <div class="stat-card stat-card--info" if="{{$opcacheEnabled}}">
+            <div class="stat-card__icon">🚀</div>
+            <div class="stat-card__content">
+                <div class="stat-card__value" if="{{$opcacheMemoryUsage}}">{{$opcacheMemoryUsage}}</div>
+                <div class="stat-card__label">OPCache Memory</div>
+                <div class="stat-card__subvalue" if="{{$opcacheCacheHits}}">{{$opcacheCacheHits}} hits</div>
+                <div class="stat-card__subvalue" if="{{$opcacheMissRate}}">Miss: {{$opcacheMissRate}}</div>
+            </div>
+        </div>
+    </div>
+
+    <div class="component-footer">
+        <span class="component-footer__text">Last updated: {{$lastUpdated}}</span>
+        <span class="component-footer__badge">Updates every 3s</span>
+    </div>
+</div>
+
+<style>
+.performance-metrics-component {
+    padding: 0;
+}
+
+.stats-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+    gap: 1rem;
+    margin-bottom: 1rem;
+}
+
+.stat-card {
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+    padding: 1rem;
+    background: #f8f9fa;
+    border-radius: 8px;
+    border: 1px solid #e0e0e0;
+    transition: all 0.2s;
+}
+
+.stat-card:hover {
+    box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+    transform: translateY(-2px);
+}
+
+.stat-card--primary {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+    border: none;
+}
+
+.stat-card--info {
+    background: linear-gradient(135deg, #a8edea 0%, #fed6e3 100%);
+    border: none;
+}
+
+.stat-card__icon {
+    font-size: 2rem;
+    opacity: 0.9;
+}
+
+.stat-card__content {
+    flex: 1;
+}
+
+.stat-card__value {
+    font-size: 1.25rem;
+    font-weight: bold;
+    line-height: 1.2;
+}
+
+.stat-card__label {
+    font-size: 0.75rem;
+    opacity: 0.8;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    margin-top: 0.25rem;
+}
+
+.stat-card__subvalue {
+    font-size: 0.85rem;
+    opacity: 0.7;
+    margin-top: 0.25rem;
+}
+
+.stat-card__progress {
+    margin-top: 0.5rem;
+}
+
+.progress-bar {
+    height: 6px;
+    background: rgba(255, 255, 255, 0.3);
+    border-radius: 3px;
+    overflow: hidden;
+    margin-bottom: 0.25rem;
+}
+
+.progress-fill {
+    height: 100%;
+    background: rgba(255, 255, 255, 0.9);
+    transition: width 0.3s ease;
+}
+
+.stat-card__percentage {
+    font-size: 0.7rem;
+    opacity: 0.8;
+    text-align: right;
+}
+
+.component-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.75rem 1rem;
+    background: #f8f9fa;
+    border-radius: 6px;
+    font-size: 0.75rem;
+    color: #666;
+}
+
+.component-footer__badge {
+    background: #007bff;
+    color: white;
+    padding: 0.25rem 0.5rem;
+    border-radius: 12px;
+    font-size: 0.7rem;
+}
+</style>
+
diff --git a/src/Framework/Vite/Exceptions/ViteManifestException.php b/src/Framework/Vite/Exceptions/ViteManifestException.php
index e3ded944..0a19460f 100644
--- a/src/Framework/Vite/Exceptions/ViteManifestException.php
+++ b/src/Framework/Vite/Exceptions/ViteManifestException.php
@@ -14,44 +14,33 @@ final class ViteManifestException extends FrameworkException
 {
     public static function fileNotFound(string $path): self
     {
-        return self::create(
-            ErrorCode::CONFIG_FILE_NOT_FOUND,
-            "Vite manifest file not found: {$path}"
-        )->withData([
-            'manifest_path' => $path,
-            'suggestion' => 'Run "npm run build" to generate the manifest file'
-        ]);
+        return new self(
+            "Vite manifest file not found: {$path}",
+            (int) ErrorCode::CONFIG_FILE_NOT_FOUND->value
+        );
     }
 
     public static function cannotRead(string $path): self
     {
-        return self::create(
-            ErrorCode::CONFIG_FILE_INVALID,
-            "Cannot read Vite manifest file: {$path}"
-        )->withData([
-            'manifest_path' => $path
-        ]);
+        return new self(
+            "Cannot read Vite manifest file: {$path}",
+            (int) ErrorCode::CONFIG_FILE_INVALID->value
+        );
     }
 
     public static function invalidJson(string $path, string $error): self
     {
-        return self::create(
-            ErrorCode::CONFIG_FILE_INVALID,
-            "Invalid JSON in Vite manifest file: {$path}"
-        )->withData([
-            'manifest_path' => $path,
-            'json_error' => $error
-        ]);
+        return new self(
+            "Invalid JSON in Vite manifest file: {$path}",
+            (int) ErrorCode::CONFIG_FILE_INVALID->value
+        );
     }
 
     public static function entryNotFound(string $entryName): self
     {
-        return self::create(
-            ErrorCode::ENTITY_NOT_FOUND,
-            "Vite entry point not found in manifest: {$entryName}"
-        )->withData([
-            'entry_name' => $entryName,
-            'suggestion' => 'Check that the entry point is defined in vite.config.js'
-        ]);
+        return new self(
+            "Vite entry point not found in manifest: {$entryName}",
+            (int) ErrorCode::ENTITY_NOT_FOUND->value
+        );
     }
 }
diff --git a/storage/cache/0c96ac1a57b063550dff9e96c6ad11c2.lock b/storage/cache/0c96ac1a57b063550dff9e96c6ad11c2.lock
new file mode 100644
index 00000000..e69de29b
diff --git a/storage/cache/5e7426f884af5ff2e38a71a018a93b72.lock b/storage/cache/5e7426f884af5ff2e38a71a018a93b72.lock
new file mode 100644
index 00000000..e69de29b
diff --git a/test-hot-reload.html b/test-hot-reload.html
deleted file mode 100644
index 946b5a8d..00000000
--- a/test-hot-reload.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Hot Reload Test</title>
-    <link rel="stylesheet" href="test-hot-reload.css">
-</head>
-<body>
-    <h1>Hot Reload Test</h1>
-    <div id="status">Initializing...</div>
-    <div id="log"></div>
-    
-    <script src="test-hot-reload.js"></script>
-</body>
-</html>
\ No newline at end of file
diff --git a/tests/Framework/ApiGateway/ApiGatewayTest.php b/tests/Framework/ApiGateway/ApiGatewayTest.php
index 83e09089..8b02b1ae 100644
--- a/tests/Framework/ApiGateway/ApiGatewayTest.php
+++ b/tests/Framework/ApiGateway/ApiGatewayTest.php
@@ -10,12 +10,12 @@ use App\Framework\ApiGateway\ValueObjects\ApiEndpoint;
 use App\Framework\Core\ValueObjects\Duration;
 use App\Framework\Http\Headers;
 use App\Framework\Http\Method as HttpMethod;
-use App\Framework\Http\Url\Url;
+use App\Framework\Http\Url\WhatwgUrl;
 use App\Framework\HttpClient\AuthConfig;
 use App\Framework\HttpClient\ClientRequest;
 use App\Framework\HttpClient\ClientResponse;
 use App\Framework\HttpClient\HttpClient;
-use App\Framework\HttpClient\Status;
+use App\Framework\Http\Status;
 use App\Framework\Retry\RetryStrategy;
 
 describe('ApiGateway', function () {
@@ -51,7 +51,7 @@ describe('ApiGateway', function () {
         $mockCache = new class implements \App\Framework\Cache\Cache {
             public function get(\App\Framework\Cache\CacheIdentifier ...$identifiers): \App\Framework\Cache\CacheResult
             {
-                return new \App\Framework\Cache\CacheResult(hits: [], misses: $identifiers);
+                return \App\Framework\Cache\CacheResult::empty();
             }
             public function set(\App\Framework\Cache\CacheItem ...$items): bool { return true; }
             public function has(\App\Framework\Cache\CacheIdentifier ...$identifiers): array { return []; }
@@ -89,39 +89,14 @@ describe('ApiGateway', function () {
 
         $this->metrics = new \App\Framework\ApiGateway\Metrics\ApiMetrics();
 
-        $this->operationTracker = new class implements \App\Framework\Performance\OperationTracker {
-            public function startOperation(
-                string $operationId,
-                \App\Framework\Performance\PerformanceCategory $category,
-                array $contextData = []
-            ): \App\Framework\Performance\PerformanceSnapshot {
-                return new \App\Framework\Performance\PerformanceSnapshot(
-                    operationId: $operationId,
-                    category: $category,
-                    startTime: microtime(true),
-                    duration: \App\Framework\Core\ValueObjects\Duration::fromMilliseconds(10),
-                    memoryUsed: 1024,
-                    peakMemory: 2048,
-                    contextData: $contextData
-                );
-            }
+        $memoryMonitor = new \App\Framework\Performance\MemoryMonitor();
 
-            public function completeOperation(string $operationId): ?\App\Framework\Performance\PerformanceSnapshot {
-                return new \App\Framework\Performance\PerformanceSnapshot(
-                    operationId: $operationId,
-                    category: \App\Framework\Performance\PerformanceCategory::HTTP,
-                    startTime: microtime(true) - 0.01,
-                    duration: \App\Framework\Core\ValueObjects\Duration::fromMilliseconds(10),
-                    memoryUsed: 1024,
-                    peakMemory: 2048,
-                    contextData: []
-                );
-            }
-
-            public function failOperation(string $operationId, \Throwable $exception): ?\App\Framework\Performance\PerformanceSnapshot {
-                return null;
-            }
-        };
+        $this->operationTracker = new \App\Framework\Performance\OperationTracker(
+            clock: $mockClock,
+            memoryMonitor: $memoryMonitor,
+            logger: null,
+            eventDispatcher: null
+        );
 
         $this->apiGateway = new ApiGateway(
             $this->httpClient,
@@ -136,7 +111,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -174,14 +149,14 @@ describe('ApiGateway', function () {
 
             expect($response->status)->toBe(Status::OK);
             expect($this->capturedRequest->options->auth)->not->toBeNull();
-            expect($this->capturedRequest->options->auth->type)->toBe('basic');
+            expect($this->capturedRequest->options->auth->type->value)->toBe('basic');
         });
 
         it('applies custom header authentication when ApiRequest uses AuthConfig::custom()', function () {
             $request = new class implements ApiRequest, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -221,14 +196,14 @@ describe('ApiGateway', function () {
 
             expect($response->status)->toBe(Status::OK);
             expect($this->capturedRequest->options->auth)->not->toBeNull();
-            expect($this->capturedRequest->options->auth->type)->toBe('custom');
+            expect($this->capturedRequest->options->auth->type->value)->toBe('custom');
         });
 
         it('does not apply authentication when ApiRequest does not implement HasAuth', function () {
             $request = new class implements ApiRequest {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -270,7 +245,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest, HasPayload, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -329,7 +304,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -376,7 +351,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -414,7 +389,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -445,14 +420,14 @@ describe('ApiGateway', function () {
 
             $response = $this->apiGateway->send($request);
             expect($response->status)->toBe(Status::OK);
-            expect($this->capturedRequest->method)->toBe('GET');
+            expect($this->capturedRequest->method->value)->toBe('GET');
         });
 
         it('supports POST requests with payload', function () {
             $request = new class implements ApiRequest, HasPayload {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -488,7 +463,7 @@ describe('ApiGateway', function () {
 
             $response = $this->apiGateway->send($request);
             expect($response->status)->toBe(Status::OK);
-            expect($this->capturedRequest->method)->toBe('POST');
+            expect($this->capturedRequest->method->value)->toBe('POST');
             $bodyData = json_decode($this->capturedRequest->body, true);
             expect($bodyData)->toBe(['data' => 'test']);
         });
@@ -497,7 +472,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test/123'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test/123'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -533,14 +508,14 @@ describe('ApiGateway', function () {
 
             $response = $this->apiGateway->send($request);
             expect($response->status)->toBe(Status::OK);
-            expect($this->capturedRequest->method)->toBe('DELETE');
+            expect($this->capturedRequest->method->value)->toBe('DELETE');
         });
 
         it('supports PATCH requests with payload', function () {
             $request = new class implements ApiRequest, HasPayload, HasAuth {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test/123'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test/123'));
                 }
 
                 public function getMethod(): HttpMethod
@@ -581,7 +556,7 @@ describe('ApiGateway', function () {
 
             $response = $this->apiGateway->send($request);
             expect($response->status)->toBe(Status::OK);
-            expect($this->capturedRequest->method)->toBe('PATCH');
+            expect($this->capturedRequest->method->value)->toBe('PATCH');
             $bodyData = json_decode($this->capturedRequest->body, true);
             expect($bodyData)->toBe(['name' => 'Updated']);
         });
@@ -592,7 +567,7 @@ describe('ApiGateway', function () {
             $request = new class implements ApiRequest {
                 public function getEndpoint(): ApiEndpoint
                 {
-                    return ApiEndpoint::fromUrl(Url::parse('https://api.example.com/test'));
+                    return ApiEndpoint::fromUrl(WhatwgUrl::parse('https://api.example.com/test'));
                 }
 
                 public function getMethod(): HttpMethod
diff --git a/tests/Framework/Console/ConsoleApplicationIntegrationTest.php b/tests/Framework/Console/ConsoleApplicationIntegrationTest.php
index d5d01390..3f3a9e90 100644
--- a/tests/Framework/Console/ConsoleApplicationIntegrationTest.php
+++ b/tests/Framework/Console/ConsoleApplicationIntegrationTest.php
@@ -20,8 +20,8 @@ use App\Framework\DI\Container;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\InitializerProcessor;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 use App\Framework\Serializer\Php\PhpSerializerConfig;
 
diff --git a/tests/Framework/Console/ConsoleDiscoveryEnd2EndTest.php b/tests/Framework/Console/ConsoleDiscoveryEnd2EndTest.php
index 94af3ad9..7fedf50e 100644
--- a/tests/Framework/Console/ConsoleDiscoveryEnd2EndTest.php
+++ b/tests/Framework/Console/ConsoleDiscoveryEnd2EndTest.php
@@ -21,8 +21,8 @@ use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\Cache\DiscoveryCacheIdentifiers;
 use App\Framework\Discovery\DiscoveryServiceBootstrapper;
 use App\Framework\Discovery\InitializerProcessor;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 use App\Framework\Serializer\Php\PhpSerializerConfig;
 
diff --git a/tests/Framework/Core/DynamicRoutingTest.php b/tests/Framework/Core/DynamicRoutingTest.php
index a43c6250..ecd0fea3 100644
--- a/tests/Framework/Core/DynamicRoutingTest.php
+++ b/tests/Framework/Core/DynamicRoutingTest.php
@@ -48,7 +48,7 @@ describe('Dynamic Routing Parameter Extraction', function () {
         // UnifiedRouteVisitor benötigt ClassName und FilePath Value Objects
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $this->discoveryVisitor->visitClass($className, $filePath, $reflection);
 
@@ -99,7 +99,7 @@ describe('Dynamic Routing Parameter Extraction', function () {
         // UnifiedRouteVisitor benötigt ClassName und FilePath Value Objects
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $this->discoveryVisitor->visitClass($className, $filePath, $reflection);
 
@@ -150,7 +150,7 @@ describe('Dynamic Routing Parameter Extraction', function () {
         // UnifiedRouteVisitor benötigt ClassName und FilePath Value Objects
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $this->discoveryVisitor->visitClass($className, $filePath, $reflection);
 
@@ -210,7 +210,7 @@ describe('Dynamic Routing Parameter Extraction', function () {
         // UnifiedRouteVisitor benötigt ClassName und FilePath Value Objects
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $this->discoveryVisitor->visitClass($className, $filePath, $reflection);
 
@@ -257,7 +257,7 @@ describe('Dynamic Routing Parameter Extraction', function () {
         // UnifiedRouteVisitor benötigt ClassName und FilePath Value Objects
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $this->discoveryVisitor->visitClass($className, $filePath, $reflection);
 
@@ -301,7 +301,7 @@ describe('Dynamic Route Parameter Processing Debug', function () {
         $discoveryVisitor->onScanStart();
         $className = \App\Framework\Core\ValueObjects\ClassName::fromString(TestDynamicController::class);
         $filePath = \App\Framework\Filesystem\FilePath::create('test-file.php');
-        $reflection = new \App\Framework\Reflection\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
+        $reflection = new \App\Framework\ReflectionLegacy\WrappedReflectionClass(new \ReflectionClass(TestDynamicController::class));
 
         $discoveryVisitor->visitClass($className, $filePath, $reflection);
 
diff --git a/tests/Framework/DI/ContainerCompilerTest.php b/tests/Framework/DI/ContainerCompilerTest.php
index 8fb31fc2..0db50149 100644
--- a/tests/Framework/DI/ContainerCompilerTest.php
+++ b/tests/Framework/DI/ContainerCompilerTest.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 use App\Framework\DI\ContainerCompiler;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\DI\DependencyResolver;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 beforeEach(function () {
     $this->tempDir = sys_get_temp_dir() . '/container-compiler-test-' . uniqid();
diff --git a/tests/Framework/Discovery/MemoryLeakTest.php b/tests/Framework/Discovery/MemoryLeakTest.php
index 5576f2e8..0c604e8f 100644
--- a/tests/Framework/Discovery/MemoryLeakTest.php
+++ b/tests/Framework/Discovery/MemoryLeakTest.php
@@ -10,8 +10,8 @@ use App\Framework\Core\PathProvider;
 use App\Framework\DateTime\SystemClock;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\DiscoveryServiceBootstrapper;
-use App\Framework\Reflection\CachedReflectionProvider;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use PHPUnit\Framework\TestCase;
 
 /**
diff --git a/tests/Framework/Discovery/SimpleMemoryTest.php b/tests/Framework/Discovery/SimpleMemoryTest.php
index dc9493d3..4cb9a6ac 100644
--- a/tests/Framework/Discovery/SimpleMemoryTest.php
+++ b/tests/Framework/Discovery/SimpleMemoryTest.php
@@ -92,7 +92,7 @@ final class SimpleMemoryTest extends TestCase
         $clock = new SystemClock();
 
         // Create reflection provider without dependencies
-        $reflectionProvider = new \App\Framework\Reflection\CachedReflectionProvider();
+        $reflectionProvider = new \App\Framework\ReflectionLegacy\CachedReflectionProvider();
 
         $config = new \App\Framework\Discovery\ValueObjects\DiscoveryConfiguration(
             paths: ['/var/www/html/src'],
diff --git a/tests/Framework/Discovery/UnifiedDiscoveryServiceTest.php b/tests/Framework/Discovery/UnifiedDiscoveryServiceTest.php
index c3e74ca6..4545ea8f 100644
--- a/tests/Framework/Discovery/UnifiedDiscoveryServiceTest.php
+++ b/tests/Framework/Discovery/UnifiedDiscoveryServiceTest.php
@@ -12,7 +12,7 @@ use App\Framework\DateTime\SystemClock;
 use App\Framework\Discovery\Results\DiscoveryRegistry;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Discovery\ValueObjects\DiscoveryConfiguration;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 use App\Framework\Serializer\Php\PhpSerializerConfig;
 
diff --git a/tests/Framework/Http/MiddlewareDependencyResolverIntegrationTest.php b/tests/Framework/Http/MiddlewareDependencyResolverIntegrationTest.php
index d95f7b92..a8747049 100644
--- a/tests/Framework/Http/MiddlewareDependencyResolverIntegrationTest.php
+++ b/tests/Framework/Http/MiddlewareDependencyResolverIntegrationTest.php
@@ -6,7 +6,7 @@ namespace Tests\Framework\Http;
 
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Http\MiddlewareDependencyResolver;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use PHPUnit\Framework\TestCase;
 
 /**
diff --git a/tests/Framework/Http/MiddlewareDependencyResolverTest.php b/tests/Framework/Http/MiddlewareDependencyResolverTest.php
index e3e7cad8..51772c22 100644
--- a/tests/Framework/Http/MiddlewareDependencyResolverTest.php
+++ b/tests/Framework/Http/MiddlewareDependencyResolverTest.php
@@ -12,7 +12,7 @@ use App\Framework\Http\MiddlewareDependencyResolver;
 use App\Framework\Http\Next;
 use App\Framework\Http\RequestStateManager;
 use App\Framework\Logging\Logger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use PHPUnit\Framework\TestCase;
 
 final class MiddlewareDependencyResolverTest extends TestCase
diff --git a/tests/Framework/MagicLinks/MagicLinksValueObjectsTest.php b/tests/Framework/MagicLinks/MagicLinksValueObjectsTest.php
new file mode 100644
index 00000000..ac4287f4
--- /dev/null
+++ b/tests/Framework/MagicLinks/MagicLinksValueObjectsTest.php
@@ -0,0 +1,417 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\MagicLinks\ValueObjects\{
+    TokenAction,
+    MagicLinkToken,
+    TokenConfig,
+    ActionResult,
+    MagicLinkData
+};
+
+describe('TokenAction', function () {
+    it('creates valid token action', function () {
+        $action = new TokenAction('email_verification');
+
+        expect($action->value)->toBe('email_verification');
+    });
+
+    it('validates action format', function () {
+        new TokenAction('invalid-action'); // Hyphens not allowed
+    })->throws(InvalidArgumentException::class, 'must contain only lowercase letters and underscores');
+
+    it('rejects empty action', function () {
+        new TokenAction('');
+    })->throws(InvalidArgumentException::class, 'cannot be empty');
+
+    it('compares actions correctly', function () {
+        $action1 = new TokenAction('email_verification');
+        $action2 = new TokenAction('email_verification');
+        $action3 = new TokenAction('password_reset');
+
+        expect($action1->equals($action2))->toBeTrue();
+        expect($action1->equals($action3))->toBeFalse();
+    });
+});
+
+describe('MagicLinkToken', function () {
+    it('creates valid token', function () {
+        $token = new MagicLinkToken('abcdef0123456789'); // 16 chars
+
+        expect($token->value)->toBe('abcdef0123456789');
+    });
+
+    it('rejects short tokens', function () {
+        new MagicLinkToken('short'); // Less than 16 chars
+    })->throws(InvalidArgumentException::class, 'must be at least 16 characters');
+
+    it('generates cryptographically secure tokens', function () {
+        $token1 = MagicLinkToken::generate();
+        $token2 = MagicLinkToken::generate();
+
+        expect($token1->value)->not->toBe($token2->value);
+        expect(strlen($token1->value))->toBe(64); // 32 bytes * 2 (hex)
+    });
+
+    it('compares tokens with constant time', function () {
+        $token1 = new MagicLinkToken('abcdef0123456789');
+        $token2 = new MagicLinkToken('abcdef0123456789');
+        $token3 = new MagicLinkToken('different0123456');
+
+        expect($token1->equals($token2))->toBeTrue();
+        expect($token1->equals($token3))->toBeFalse();
+    });
+
+    it('generates tokens with custom length', function () {
+        $token = MagicLinkToken::generate(16); // 16 bytes
+
+        expect(strlen($token->value))->toBe(32); // 16 bytes * 2 (hex)
+    });
+});
+
+describe('TokenConfig', function () {
+    it('creates default config', function () {
+        $config = new TokenConfig();
+
+        expect($config->ttlSeconds)->toBe(3600);
+        expect($config->oneTimeUse)->toBeFalse();
+        expect($config->maxUses)->toBeNull();
+        expect($config->ipRestriction)->toBeFalse();
+    });
+
+    it('creates custom config', function () {
+        $config = new TokenConfig(
+            ttlSeconds: 7200,
+            oneTimeUse: true,
+            maxUses: null,
+            ipRestriction: true
+        );
+
+        expect($config->ttlSeconds)->toBe(7200);
+        expect($config->oneTimeUse)->toBeTrue();
+        expect($config->ipRestriction)->toBeTrue();
+    });
+
+    it('validates positive ttl', function () {
+        new TokenConfig(ttlSeconds: 0);
+    })->throws(InvalidArgumentException::class, 'TTL must be positive');
+
+    it('validates positive max uses', function () {
+        new TokenConfig(maxUses: 0);
+    })->throws(InvalidArgumentException::class, 'Max uses must be positive');
+
+    it('validates one-time-use consistency', function () {
+        new TokenConfig(oneTimeUse: true, maxUses: 5);
+    })->throws(InvalidArgumentException::class, 'One-time-use tokens cannot have maxUses');
+
+    it('creates email verification config', function () {
+        $config = TokenConfig::forEmailVerification();
+
+        expect($config->ttlSeconds)->toBe(86400); // 24 hours
+        expect($config->oneTimeUse)->toBeTrue();
+    });
+
+    it('creates password reset config', function () {
+        $config = TokenConfig::forPasswordReset();
+
+        expect($config->ttlSeconds)->toBe(3600); // 1 hour
+        expect($config->oneTimeUse)->toBeTrue();
+        expect($config->ipRestriction)->toBeTrue();
+    });
+
+    it('creates document access config', function () {
+        $config = TokenConfig::forDocumentAccess(3);
+
+        expect($config->ttlSeconds)->toBe(3600);
+        expect($config->maxUses)->toBe(3);
+    });
+});
+
+describe('ActionResult', function () {
+    it('creates successful result', function () {
+        $result = new ActionResult(
+            success: true,
+            message: 'Email verified',
+            data: ['user_id' => 123]
+        );
+
+        expect($result->isSuccess())->toBeTrue();
+        expect($result->message)->toBe('Email verified');
+        expect($result->data)->toBe(['user_id' => 123]);
+    });
+
+    it('creates failure result', function () {
+        $result = new ActionResult(
+            success: false,
+            message: 'Verification failed',
+            errors: ['Token expired']
+        );
+
+        expect($result->isSuccess())->toBeFalse();
+        expect($result->hasErrors())->toBeTrue();
+        expect($result->errors)->toBe(['Token expired']);
+    });
+
+    it('detects redirect presence', function () {
+        $result1 = new ActionResult(
+            success: true,
+            message: 'Success',
+            redirectUrl: '/dashboard'
+        );
+
+        $result2 = new ActionResult(
+            success: true,
+            message: 'Success'
+        );
+
+        expect($result1->hasRedirect())->toBeTrue();
+        expect($result2->hasRedirect())->toBeFalse();
+    });
+
+    it('creates success via factory method', function () {
+        $result = ActionResult::success(
+            message: 'Operation completed',
+            data: ['id' => 456],
+            redirectUrl: '/success'
+        );
+
+        expect($result->isSuccess())->toBeTrue();
+        expect($result->message)->toBe('Operation completed');
+        expect($result->data)->toBe(['id' => 456]);
+        expect($result->redirectUrl)->toBe('/success');
+    });
+
+    it('creates failure via factory method', function () {
+        $result = ActionResult::failure(
+            message: 'Operation failed',
+            errors: ['Invalid input', 'Permission denied']
+        );
+
+        expect($result->isSuccess())->toBeFalse();
+        expect($result->errors)->toHaveCount(2);
+    });
+});
+
+describe('MagicLinkData', function () {
+    it('creates valid magic link data', function () {
+        $now = new DateTimeImmutable();
+        $expiresAt = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('email_verification'),
+            payload: ['user_id' => 1, 'email' => 'test@example.com'],
+            expiresAt: $expiresAt,
+            createdAt: $now
+        );
+
+        expect($data->id)->toBe('test-123');
+        expect($data->action->value)->toBe('email_verification');
+        expect($data->payload)->toBe(['user_id' => 1, 'email' => 'test@example.com']);
+    });
+
+    it('detects expired tokens', function () {
+        $now = new DateTimeImmutable();
+        $past = $now->modify('-1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $past,
+            createdAt: $now->modify('-2 hours')
+        );
+
+        expect($data->isExpired())->toBeTrue();
+        expect($data->isValid())->toBeFalse();
+    });
+
+    it('validates non-expired tokens', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now
+        );
+
+        expect($data->isExpired())->toBeFalse();
+        expect($data->isValid())->toBeTrue();
+    });
+
+    it('invalidates one-time-use tokens after use', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now,
+            oneTimeUse: true,
+            isUsed: true
+        );
+
+        expect($data->isValid())->toBeFalse();
+    });
+
+    it('tracks use count correctly', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now,
+            useCount: 2,
+            maxUses: 5
+        );
+
+        expect($data->hasRemainingUses())->toBeTrue();
+        expect($data->isValid())->toBeTrue();
+    });
+
+    it('invalidates tokens exceeding max uses', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now,
+            useCount: 5,
+            maxUses: 5
+        );
+
+        expect($data->hasRemainingUses())->toBeFalse();
+        expect($data->isValid())->toBeFalse();
+    });
+
+    it('calculates remaining time correctly', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+3600 seconds');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now
+        );
+
+        $remaining = $data->getSecondsUntilExpiry();
+        expect($remaining)->toBeGreaterThan(3590);
+        expect($remaining)->toBeLessThanOrEqual(3600);
+    });
+
+    it('returns zero for expired token remaining time', function () {
+        $now = new DateTimeImmutable();
+        $past = $now->modify('-1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $past,
+            createdAt: $now->modify('-2 hours')
+        );
+
+        expect($data->getSecondsUntilExpiry())->toBe(0);
+    });
+
+    it('marks token as used immutably', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now,
+            oneTimeUse: true
+        );
+
+        $usedData = $data->withUsed(new DateTimeImmutable());
+
+        expect($data->isUsed)->toBeFalse(); // Original unchanged
+        expect($usedData->isUsed)->toBeTrue();
+        expect($usedData->useCount)->toBe(1);
+    });
+
+    it('increments use count immutably', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('test'),
+            payload: [],
+            expiresAt: $future,
+            createdAt: $now,
+            useCount: 2
+        );
+
+        $incremented = $data->withIncrementedUseCount();
+
+        expect($data->useCount)->toBe(2); // Original unchanged
+        expect($incremented->useCount)->toBe(3);
+    });
+
+    it('serializes to array correctly', function () {
+        $now = new DateTimeImmutable();
+        $future = $now->modify('+1 hour');
+
+        $data = new MagicLinkData(
+            id: 'test-123',
+            action: new TokenAction('email_verification'),
+            payload: ['user_id' => 1],
+            expiresAt: $future,
+            createdAt: $now,
+            oneTimeUse: true,
+            createdByIp: '127.0.0.1',
+            userAgent: 'Mozilla/5.0'
+        );
+
+        $array = $data->toArray();
+
+        expect($array)->toHaveKey('id');
+        expect($array)->toHaveKey('action');
+        expect($array)->toHaveKey('payload');
+        expect($array)->toHaveKey('is_valid');
+        expect($array['action'])->toBe('email_verification');
+        expect($array['payload'])->toBe(['user_id' => 1]);
+    });
+
+    it('deserializes from array correctly', function () {
+        $array = [
+            'id' => 'test-123',
+            'action' => 'password_reset',
+            'payload' => ['user_id' => 456],
+            'expires_at' => '2025-12-31 23:59:59',
+            'created_at' => '2025-12-31 12:00:00',
+            'one_time_use' => true,
+            'created_by_ip' => '192.168.1.1',
+            'user_agent' => 'Test Agent',
+            'is_used' => false,
+            'use_count' => 0
+        ];
+
+        $data = MagicLinkData::fromArray($array);
+
+        expect($data->id)->toBe('test-123');
+        expect($data->action->value)->toBe('password_reset');
+        expect($data->payload)->toBe(['user_id' => 456]);
+        expect($data->oneTimeUse)->toBeTrue();
+        expect($data->createdByIp)->toBe('192.168.1.1');
+    });
+});
diff --git a/tests/Framework/Mfa/MfaServiceTest.php b/tests/Framework/Mfa/MfaServiceTest.php
new file mode 100644
index 00000000..ca5a54fa
--- /dev/null
+++ b/tests/Framework/Mfa/MfaServiceTest.php
@@ -0,0 +1,338 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\Mfa\MfaService;
+use App\Framework\Mfa\MfaSecretFactory;
+use App\Framework\Mfa\Providers\TotpProvider;
+use App\Framework\Mfa\ValueObjects\MfaChallenge;
+use App\Framework\Mfa\ValueObjects\MfaCode;
+use App\Framework\Mfa\ValueObjects\MfaMethod;
+use App\Framework\Mfa\ValueObjects\MfaSecret;
+use App\Framework\Random\SecureRandomGenerator;
+
+beforeEach(function () {
+    $this->randomGenerator = new SecureRandomGenerator();
+    $this->secretFactory = new MfaSecretFactory($this->randomGenerator);
+    $this->totpProvider = new TotpProvider(timeStep: 30, digits: 6, windowSize: 1);
+    $this->mfaService = new MfaService($this->totpProvider);
+});
+
+describe('MfaSecretFactory', function () {
+    it('generates valid base32 secret', function () {
+        $secret = $this->secretFactory->generate();
+
+        expect($secret)->toBeInstanceOf(MfaSecret::class);
+        expect($secret->value)->toMatch('/^[A-Z2-7]+$/');
+        expect(strlen($secret->value))->toBeGreaterThanOrEqual(32);
+    });
+
+    it('generates secret with custom length', function () {
+        $secret = $this->secretFactory->generateWithLength(32);
+
+        // 32 bytes = 51-52 base32 characters (due to padding)
+        expect(strlen($secret->value))->toBeGreaterThanOrEqual(51);
+    });
+
+    it('throws exception for insufficient byte length', function () {
+        $this->secretFactory->generateWithLength(10);
+    })->throws(InvalidArgumentException::class, 'at least 16 bytes');
+});
+
+describe('MfaSecret', function () {
+    it('validates base32 format', function () {
+        $validSecret = 'JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP'; // Valid base32 (32+ chars)
+        $secret = MfaSecret::fromString($validSecret);
+
+        expect($secret->value)->toBe($validSecret);
+    });
+
+    it('throws exception for invalid base32 characters', function () {
+        MfaSecret::fromString('INVALID189'); // 1, 8, 9 not valid in base32
+    })->throws(InvalidArgumentException::class, 'base32 encoded');
+
+    it('throws exception for too short secret', function () {
+        MfaSecret::fromString('JBSWY3DP'); // Only 8 characters
+    })->throws(InvalidArgumentException::class, 'at least 32 characters');
+
+    it('generates QR code URI', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $uri = $secret->toQrCodeUri('MyApp', 'user@example.com');
+
+        expect($uri)->toStartWith('otpauth://totp/');
+        expect($uri)->toContain('MyApp:user%40example.com'); // URL-encoded email
+        expect($uri)->toContain('secret=JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        expect($uri)->toContain('issuer=MyApp');
+    });
+
+    it('masks secret for safe logging', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $masked = $secret->getMasked();
+
+        expect($masked)->toBe('JBSW****3PXP');
+        expect($masked)->not->toContain('EHPK3PXPJBSWY3DPEHPK');
+    });
+});
+
+describe('MfaChallenge', function () {
+    it('creates valid challenge', function () {
+        $challenge = MfaChallenge::create(
+            challengeId: 'test-123',
+            method: MfaMethod::TOTP,
+            validitySeconds: 300,
+            maxAttempts: 3
+        );
+
+        expect($challenge->challengeId)->toBe('test-123');
+        expect($challenge->method)->toBe(MfaMethod::TOTP);
+        expect($challenge->attempts)->toBe(0);
+        expect($challenge->maxAttempts)->toBe(3);
+        expect($challenge->isValid())->toBeTrue();
+    });
+
+    it('detects expiration', function () {
+        $now = new DateTimeImmutable();
+        $created = $now->modify('-10 seconds');
+        $expired = $now->modify('-5 seconds'); // Expired 5 seconds ago
+
+        $challenge = new MfaChallenge(
+            challengeId: 'test-123',
+            method: MfaMethod::TOTP,
+            createdAt: $created,
+            expiresAt: $expired,
+            attempts: 0,
+            maxAttempts: 3
+        );
+
+        expect($challenge->isExpired())->toBeTrue();
+        expect($challenge->isValid())->toBeFalse();
+    });
+
+    it('tracks attempts correctly', function () {
+        $challenge = MfaChallenge::create('test-123', MfaMethod::TOTP, maxAttempts: 3);
+
+        expect($challenge->attempts)->toBe(0);
+        expect($challenge->hasAttemptsRemaining())->toBeTrue();
+        expect($challenge->getRemainingAttempts())->toBe(3);
+
+        $challenge = $challenge->withIncrementedAttempts();
+        expect($challenge->attempts)->toBe(1);
+        expect($challenge->getRemainingAttempts())->toBe(2);
+
+        $challenge = $challenge->withIncrementedAttempts();
+        $challenge = $challenge->withIncrementedAttempts();
+        expect($challenge->attempts)->toBe(3);
+        expect($challenge->hasAttemptsRemaining())->toBeFalse();
+        expect($challenge->isValid())->toBeFalse();
+    });
+
+    it('exports to array correctly', function () {
+        $challenge = MfaChallenge::create('test-123', MfaMethod::TOTP, validitySeconds: 300);
+        $array = $challenge->toArray();
+
+        expect($array)->toHaveKey('challenge_id');
+        expect($array)->toHaveKey('method');
+        expect($array)->toHaveKey('method_display');
+        expect($array)->toHaveKey('remaining_attempts');
+        expect($array)->toHaveKey('seconds_until_expiry');
+        expect($array)->toHaveKey('is_valid');
+
+        expect($array['challenge_id'])->toBe('test-123');
+        expect($array['method'])->toBe('totp');
+        expect($array['is_valid'])->toBeTrue();
+    });
+});
+
+describe('TotpProvider', function () {
+    it('generates challenge for TOTP', function () {
+        $challenge = $this->totpProvider->generateChallenge();
+
+        expect($challenge)->toBeInstanceOf(MfaChallenge::class);
+        expect($challenge->method)->toBe(MfaMethod::TOTP);
+        expect($challenge->isValid())->toBeTrue();
+    });
+
+    it('verifies valid TOTP code', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $challenge = $this->totpProvider->generateChallenge();
+
+        // Generate code for current time window
+        $currentTime = time();
+        $timeStep = (int) floor($currentTime / 30);
+
+        // We'll use the provider's internal logic to generate a valid code
+        // In real usage, the authenticator app would generate this
+        $reflector = new ReflectionClass($this->totpProvider);
+        $method = $reflector->getMethod('generateCodeForTimeStep');
+        $method->setAccessible(true);
+        $expectedCode = $method->invoke($this->totpProvider, $secret, $timeStep);
+
+        $code = MfaCode::fromString(str_pad((string) $expectedCode, 6, '0', STR_PAD_LEFT));
+
+        $result = $this->totpProvider->verify($challenge, $code, ['secret' => $secret]);
+
+        expect($result)->toBeTrue();
+    });
+
+    it('rejects invalid TOTP code', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $challenge = $this->totpProvider->generateChallenge();
+        $wrongCode = MfaCode::fromString('000000');
+
+        $result = $this->totpProvider->verify($challenge, $wrongCode, ['secret' => $secret]);
+
+        expect($result)->toBeFalse();
+    });
+
+    it('accepts code within time window', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $challenge = $this->totpProvider->generateChallenge();
+
+        $currentTime = time();
+        $previousTimeStep = (int) floor($currentTime / 30) - 1; // One window before
+
+        $reflector = new ReflectionClass($this->totpProvider);
+        $method = $reflector->getMethod('generateCodeForTimeStep');
+        $method->setAccessible(true);
+        $expectedCode = $method->invoke($this->totpProvider, $secret, $previousTimeStep);
+
+        $code = MfaCode::fromString(str_pad((string) $expectedCode, 6, '0', STR_PAD_LEFT));
+
+        // Should accept code from previous window (windowSize = 1)
+        $result = $this->totpProvider->verify($challenge, $code, ['secret' => $secret]);
+
+        expect($result)->toBeTrue();
+    });
+
+    it('throws exception when secret is missing', function () {
+        $challenge = $this->totpProvider->generateChallenge();
+        $code = MfaCode::fromString('123456');
+
+        $this->totpProvider->verify($challenge, $code, []);
+    })->throws(InvalidArgumentException::class, 'requires secret');
+
+    it('indicates TOTP does not require server-side code generation', function () {
+        expect($this->totpProvider->requiresCodeGeneration())->toBeFalse();
+    });
+
+    it('returns correct code validity period', function () {
+        expect($this->totpProvider->getCodeValiditySeconds())->toBe(30);
+    });
+});
+
+describe('MfaService', function () {
+    it('generates challenge via service', function () {
+        $challenge = $this->mfaService->generateChallenge(MfaMethod::TOTP);
+
+        expect($challenge)->toBeInstanceOf(MfaChallenge::class);
+        expect($challenge->method)->toBe(MfaMethod::TOTP);
+    });
+
+    it('verifies code via service', function () {
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $challenge = $this->mfaService->generateChallenge(MfaMethod::TOTP);
+
+        $currentTime = time();
+        $timeStep = (int) floor($currentTime / 30);
+
+        $reflector = new ReflectionClass($this->totpProvider);
+        $method = $reflector->getMethod('generateCodeForTimeStep');
+        $method->setAccessible(true);
+        $expectedCode = $method->invoke($this->totpProvider, $secret, $timeStep);
+
+        $code = MfaCode::fromString(str_pad((string) $expectedCode, 6, '0', STR_PAD_LEFT));
+
+        $result = $this->mfaService->verify($challenge, $code, ['secret' => $secret]);
+
+        expect($result)->toBeTrue();
+    });
+
+    it('rejects verification for expired challenge', function () {
+        $now = new DateTimeImmutable();
+        $created = $now->modify('-10 seconds');
+        $expired = $now->modify('-5 seconds'); // Expired 5 seconds ago
+
+        $challenge = new MfaChallenge(
+            challengeId: 'test-123',
+            method: MfaMethod::TOTP,
+            createdAt: $created,
+            expiresAt: $expired,
+            attempts: 0,
+            maxAttempts: 3
+        );
+
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+        $code = MfaCode::fromString('123456');
+
+        $result = $this->mfaService->verify($challenge, $code, ['secret' => $secret]);
+
+        expect($result)->toBeFalse();
+    });
+
+    it('checks if method is supported', function () {
+        expect($this->mfaService->supportsMethod(MfaMethod::TOTP))->toBeTrue();
+        expect($this->mfaService->supportsMethod(MfaMethod::SMS))->toBeFalse();
+    });
+
+    it('returns supported methods', function () {
+        $methods = $this->mfaService->getSupportedMethods();
+
+        expect($methods)->toHaveCount(1);
+        expect($methods[0])->toBe(MfaMethod::TOTP);
+    });
+
+    it('throws exception for unsupported method', function () {
+        $this->mfaService->generateChallenge(MfaMethod::SMS);
+    })->throws(App\Framework\Mfa\Exceptions\MfaException::class, 'No MFA provider registered');
+});
+
+describe('TOTP RFC 6238 Compliance', function () {
+    it('generates 6-digit codes by default', function () {
+        $provider = new TotpProvider();
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+
+        $reflector = new ReflectionClass($provider);
+        $method = $reflector->getMethod('generateCodeForTimeStep');
+        $method->setAccessible(true);
+
+        $code = $method->invoke($provider, $secret, 12345);
+        $codeStr = str_pad((string) $code, 6, '0', STR_PAD_LEFT);
+
+        expect(strlen($codeStr))->toBe(6);
+        expect($codeStr)->toMatch('/^\d{6}$/');
+    });
+
+    it('supports 8-digit codes', function () {
+        $provider = new TotpProvider(digits: 8);
+        $secret = MfaSecret::fromString('JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP');
+
+        $reflector = new ReflectionClass($provider);
+        $method = $reflector->getMethod('generateCodeForTimeStep');
+        $method->setAccessible(true);
+
+        $code = $method->invoke($provider, $secret, 12345);
+        $codeStr = str_pad((string) $code, 8, '0', STR_PAD_LEFT);
+
+        expect(strlen($codeStr))->toBe(8);
+    });
+
+    it('uses 30-second time step by default', function () {
+        $provider = new TotpProvider();
+
+        expect($provider->getCodeValiditySeconds())->toBe(30);
+    });
+
+    it('validates constructor parameters', function () {
+        expect(fn() => new TotpProvider(timeStep: 0))
+            ->toThrow(InvalidArgumentException::class, 'at least 1 second');
+
+        expect(fn() => new TotpProvider(digits: 5))
+            ->toThrow(InvalidArgumentException::class, 'between 6 and 8');
+
+        expect(fn() => new TotpProvider(digits: 9))
+            ->toThrow(InvalidArgumentException::class, 'between 6 and 8');
+
+        expect(fn() => new TotpProvider(windowSize: -1))
+            ->toThrow(InvalidArgumentException::class, 'cannot be negative');
+    });
+});
diff --git a/tests/Framework/MultiPurposeAttributeTest.php b/tests/Framework/MultiPurposeAttributeTest.php
index c4f01b94..4b569e70 100644
--- a/tests/Framework/MultiPurposeAttributeTest.php
+++ b/tests/Framework/MultiPurposeAttributeTest.php
@@ -6,8 +6,8 @@ use App\Framework\Console\ConsoleCommand;
 use App\Framework\Core\ParameterTypeValidator;
 use App\Framework\Examples\MultiPurposeAction;
 use App\Framework\Mcp\McpTool;
-use App\Framework\Reflection\WrappedReflectionMethod;
-use App\Framework\Reflection\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\WrappedReflectionMethod;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
 use App\Framework\Core\ValueObjects\ClassName;
 
 test('multi-purpose method has multiple attributes', function () {
diff --git a/tests/Framework/Reflection/Cache/ClassCacheMemoryLeakTest.php b/tests/Framework/Reflection/Cache/ClassCacheMemoryLeakTest.php
index a7ef6e1c..b1d4c504 100644
--- a/tests/Framework/Reflection/Cache/ClassCacheMemoryLeakTest.php
+++ b/tests/Framework/Reflection/Cache/ClassCacheMemoryLeakTest.php
@@ -5,10 +5,10 @@ declare(strict_types=1);
 namespace Tests\Framework\Reflection\Cache;
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\Cache\AttributeCache;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
 use PHPUnit\Framework\TestCase;
 use stdClass;
 
diff --git a/tests/Framework/Reflection/ReflectionMemoryLeakAnalysisTest.php b/tests/Framework/Reflection/ReflectionMemoryLeakAnalysisTest.php
index c0c81bec..023ab869 100644
--- a/tests/Framework/Reflection/ReflectionMemoryLeakAnalysisTest.php
+++ b/tests/Framework/Reflection/ReflectionMemoryLeakAnalysisTest.php
@@ -6,12 +6,12 @@ namespace Tests\Framework\Reflection;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Filesystem\InMemoryStorage;
-use App\Framework\Reflection\Cache\AttributeCache;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Cache\MetadataCacheManager;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Cache\ParameterCache;
-use App\Framework\Reflection\ReflectionCache;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Cache\MetadataCacheManager;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\ReflectionCache;
 use PHPUnit\Framework\TestCase;
 use stdClass;
 use Tests\Framework\Reflection\Support\MemoryLeakDetector;
diff --git a/tests/Framework/Reflection/ReflectionMemoryLeakTest.php b/tests/Framework/Reflection/ReflectionMemoryLeakTest.php
index bf0bd3de..5958f1c6 100644
--- a/tests/Framework/Reflection/ReflectionMemoryLeakTest.php
+++ b/tests/Framework/Reflection/ReflectionMemoryLeakTest.php
@@ -6,12 +6,12 @@ namespace Tests\Framework\Reflection;
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Filesystem\InMemoryStorage;
-use App\Framework\Reflection\Cache\AttributeCache;
-use App\Framework\Reflection\Cache\ClassCache;
-use App\Framework\Reflection\Cache\MetadataCacheManager;
-use App\Framework\Reflection\Cache\MethodCache;
-use App\Framework\Reflection\Cache\ParameterCache;
-use App\Framework\Reflection\ReflectionCache;
+use App\Framework\ReflectionLegacy\Cache\AttributeCache;
+use App\Framework\ReflectionLegacy\Cache\ClassCache;
+use App\Framework\ReflectionLegacy\Cache\MetadataCacheManager;
+use App\Framework\ReflectionLegacy\Cache\MethodCache;
+use App\Framework\ReflectionLegacy\Cache\ParameterCache;
+use App\Framework\ReflectionLegacy\ReflectionCache;
 use PHPUnit\Framework\TestCase;
 use stdClass;
 
diff --git a/tests/Framework/Router/ParameterProcessorDebugTest.php b/tests/Framework/Router/ParameterProcessorDebugTest.php
index 4095c554..4d492994 100644
--- a/tests/Framework/Router/ParameterProcessorDebugTest.php
+++ b/tests/Framework/Router/ParameterProcessorDebugTest.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Http\ControllerRequestFactory;
 use App\Framework\Logging\DefaultLogger;
-use App\Framework\Reflection\ReflectionProvider;
+use App\Framework\ReflectionLegacy\ReflectionProvider;
 use App\Framework\Router\ParameterProcessor;
 
 describe('ParameterProcessor Debug', function () {
diff --git a/tests/Framework/Validation/ValidatorTest.php b/tests/Framework/Validation/ValidatorTest.php
index b30b1178..81f03c48 100644
--- a/tests/Framework/Validation/ValidatorTest.php
+++ b/tests/Framework/Validation/ValidatorTest.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Validation\GroupAware;
 use App\Framework\Validation\Rules\Email;
 use App\Framework\Validation\Rules\Required;
diff --git a/tests/Integration/ExceptionAuditIntegrationTest.php b/tests/Integration/ExceptionAuditIntegrationTest.php
new file mode 100644
index 00000000..070332f5
--- /dev/null
+++ b/tests/Integration/ExceptionAuditIntegrationTest.php
@@ -0,0 +1,253 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\Audit\AuditLogger;
+use App\Framework\Audit\InMemoryAuditLogger;
+use App\Framework\Audit\ValueObjects\AuditEntry;
+use App\Framework\DateTime\Clock;
+use App\Framework\ExceptionHandling\Audit\ExceptionAuditLogger;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+use App\Framework\ExceptionHandling\ErrorKernel;
+use App\Framework\ExceptionHandling\Factory\ExceptionFactory;
+use App\Framework\ExceptionHandling\Reporter\Reporter;
+use App\Framework\ExceptionHandling\Scope\ErrorScope;
+use App\Framework\ExceptionHandling\Renderers\ErrorRendererFactory;
+
+describe('Exception Audit Integration', function () {
+    beforeEach(function () {
+        $this->auditLogger = new InMemoryAuditLogger();
+        $this->clock = new class implements Clock {
+            private DateTimeImmutable $now;
+
+            public function __construct()
+            {
+                $this->now = new DateTimeImmutable('2024-01-01 12:00:00');
+            }
+
+            public function now(): DateTimeImmutable
+            {
+                return $this->now;
+            }
+
+            public function fromTimestamp(\App\Framework\Core\ValueObjects\Timestamp $timestamp): DateTimeImmutable
+            {
+                return DateTimeImmutable::createFromFormat('U', (string) $timestamp->value);
+            }
+
+            public function fromString(string $dateTime, ?string $format = null): DateTimeImmutable
+            {
+                return DateTimeImmutable::createFromFormat($format ?? 'Y-m-d H:i:s', $dateTime);
+            }
+
+            public function today(): DateTimeImmutable
+            {
+                return $this->now;
+            }
+
+            public function yesterday(): DateTimeImmutable
+            {
+                return $this->now->modify('-1 day');
+            }
+
+            public function tomorrow(): DateTimeImmutable
+            {
+                return $this->now->modify('+1 day');
+            }
+
+            public function time(): \App\Framework\Core\ValueObjects\Timestamp
+            {
+                return new \App\Framework\Core\ValueObjects\Timestamp($this->now->getTimestamp());
+            }
+        };
+        $this->contextProvider = new ExceptionContextProvider();
+        $this->exceptionAuditLogger = new ExceptionAuditLogger(
+            $this->auditLogger,
+            $this->clock,
+            $this->contextProvider
+        );
+        $this->errorScope = new ErrorScope();
+        $this->factory = new ExceptionFactory($this->contextProvider, $this->errorScope);
+    });
+
+    it('automatically logs auditable exceptions through ErrorKernel', function () {
+        $reporter = new class implements Reporter {
+            public function report(\Throwable $exception): void
+            {
+                // Mock reporter
+            }
+        };
+
+        $rendererFactory = new ErrorRendererFactory(false);
+        $errorKernel = new ErrorKernel(
+            rendererFactory: $rendererFactory,
+            reporter: $reporter,
+            contextProvider: $this->contextProvider,
+            auditLogger: $this->exceptionAuditLogger
+        );
+
+        // Create auditable exception
+        $exception = $this->factory->createAuditable(
+            RuntimeException::class,
+            'User creation failed',
+            'user.create',
+            'UserService',
+            ['user_id' => '123']
+        );
+
+        // Handle exception through ErrorKernel
+        $errorKernel->handle($exception);
+
+        // Check that audit entry was created
+        $entries = getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(1);
+
+        $entry = $entries[0];
+        expect($entry->success)->toBeFalse();
+        expect($entry->errorMessage)->toBe('User creation failed');
+        expect($entry->entityType)->toBe('userservice');
+    });
+
+    it('does not log non-auditable exceptions through ErrorKernel', function () {
+        $reporter = new class implements Reporter {
+            public function report(\Throwable $exception): void
+            {
+                // Mock reporter
+            }
+        };
+
+        $rendererFactory = new ErrorRendererFactory(false);
+        $errorKernel = new ErrorKernel(
+            rendererFactory: $rendererFactory,
+            reporter: $reporter,
+            contextProvider: $this->contextProvider,
+            auditLogger: $this->exceptionAuditLogger
+        );
+
+        // Create non-auditable exception
+        $exception = $this->factory->createNonAuditable(
+            RuntimeException::class,
+            'Validation error'
+        );
+
+        // Handle exception through ErrorKernel
+        $errorKernel->handle($exception);
+
+        // Check that no audit entry was created
+        $entries = getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(0);
+    });
+
+    it('logs exception with audit level through factory', function () {
+        $reporter = new class implements Reporter {
+            public function report(\Throwable $exception): void
+            {
+                // Mock reporter
+            }
+        };
+
+        $rendererFactory = new ErrorRendererFactory(false);
+        $errorKernel = new ErrorKernel(
+            rendererFactory: $rendererFactory,
+            reporter: $reporter,
+            contextProvider: $this->contextProvider,
+            auditLogger: $this->exceptionAuditLogger
+        );
+
+        // Create exception with audit level
+        $exception = $this->factory->withAuditLevel(
+            RuntimeException::class,
+            'Warning: Resource limit reached',
+            'WARNING'
+        );
+
+        // Handle exception
+        $errorKernel->handle($exception);
+
+        // Check that audit entry was created with level
+        $entries = getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(1);
+
+        $entry = $entries[0];
+        $context = $this->contextProvider->get($exception);
+        expect($context)->not->toBeNull();
+        expect($context->auditLevel)->toBe('WARNING');
+    });
+
+    it('preserves all context information in audit entry', function () {
+        $reporter = new class implements Reporter {
+            public function report(\Throwable $exception): void
+            {
+                // Mock reporter
+            }
+        };
+
+        $rendererFactory = new ErrorRendererFactory(false);
+        $errorKernel = new ErrorKernel(
+            rendererFactory: $rendererFactory,
+            reporter: $reporter,
+            contextProvider: $this->contextProvider,
+            auditLogger: $this->exceptionAuditLogger
+        );
+
+        // Create exception with full context (using Value Objects)
+        $context = ExceptionContextData::forOperation('payment.process', 'PaymentGateway')
+            ->addData(['order_id' => 'order-123', 'amount' => 5000])
+            ->withUserId('user-456')
+            ->withRequestId('req-789') // String for backward compatibility (RequestId needs secret)
+            ->withSessionId(\App\Framework\Http\Session\SessionId::fromString('session-abc'))
+            ->withClientIp(\App\Framework\Http\IpAddress::from('192.168.1.100'))
+            ->withUserAgent(\App\Framework\UserAgent\UserAgent::fromString('Mozilla/5.0'))
+            ->withTags('payment', 'external_api', 'critical')
+            ->withAuditable(true);
+
+        $exception = $this->factory->create(
+            RuntimeException::class,
+            'Payment processing failed',
+            $context
+        );
+
+        // Handle exception
+        $errorKernel->handle($exception);
+
+        // Check audit entry
+        $entries = getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(1);
+
+        $entry = $entries[0];
+        expect($entry->userId)->toBe('user-456');
+        expect($entry->entityId)->toBe('order-123');
+        expect($entry->ipAddress)->not->toBeNull();
+        expect((string) $entry->ipAddress)->toBe('192.168.1.100');
+        expect($entry->userAgent)->not->toBeNull();
+        expect($entry->userAgent->value)->toBe('Mozilla/5.0');
+        expect($entry->metadata)->toHaveKey('request_id');
+        expect($entry->metadata['request_id'])->toBe('req-789');
+        expect($entry->metadata)->toHaveKey('session_id');
+        expect($entry->metadata['session_id'])->toBe('session-abc');
+        expect($entry->metadata)->toHaveKey('tags');
+        expect($entry->metadata['tags'])->toContain('payment', 'external_api', 'critical');
+    });
+});
+
+/**
+ * Helper to get all audit entries from InMemoryAuditLogger
+ *
+ * @return array<AuditEntry>
+ */
+function getAllAuditEntries(AuditLogger $logger): array
+{
+    if ($logger instanceof InMemoryAuditLogger) {
+        // Use reflection to access private entries property
+        $reflection = new ReflectionClass($logger);
+        $property = $reflection->getProperty('entries');
+        $property->setAccessible(true);
+        return array_values($property->getValue($logger));
+    }
+
+    // For other implementations, query all entries
+    $query = new \App\Framework\Audit\ValueObjects\AuditQuery();
+    return $logger->query($query);
+}
+
diff --git a/tests/Unit/ErrorHandling/ErrorHandlerAggregatorIntegrationTest.php b/tests/Unit/ErrorHandling/ErrorHandlerAggregatorIntegrationTest.php
deleted file mode 100644
index ea8f03f9..00000000
--- a/tests/Unit/ErrorHandling/ErrorHandlerAggregatorIntegrationTest.php
+++ /dev/null
@@ -1,340 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\ErrorHandling;
-
-use App\Framework\Cache\Cache;
-use App\Framework\Cache\CacheIdentifier;
-use App\Framework\Cache\CacheItem;
-use App\Framework\Cache\CacheKey;
-use App\Framework\Cache\CacheResult;
-use App\Framework\Core\ValueObjects\Duration;
-use App\Framework\Core\ValueObjects\Timestamp;
-use App\Framework\DateTime\Clock;
-use App\Framework\ErrorAggregation\ErrorAggregator;
-use App\Framework\ErrorAggregation\ErrorEvent;
-use App\Framework\ErrorAggregation\Storage\InMemoryErrorStorage;
-use App\Framework\Exception\Core\CacheErrorCode;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\Core\ErrorSeverity;
-use App\Framework\Exception\Core\SystemErrorCode;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SystemContext;
-use App\Framework\Queue\InMemoryQueue;
-
-// Helper function für Mock-Objekte
-function createTestCache(): Cache
-{
-    return new class implements Cache {
-        private array $data = [];
-
-        public function get(CacheIdentifier ...$identifiers): CacheResult
-        {
-            $items = [];
-
-            foreach ($identifiers as $identifier) {
-                if (isset($this->data[$identifier->toString()])) {
-                    $items[] = $this->data[$identifier->toString()];
-                } else {
-                    $items[] = CacheItem::miss($identifier instanceof CacheKey ? $identifier : CacheKey::fromString($identifier->toString()));
-                }
-            }
-
-            return CacheResult::fromItems(...$items);
-        }
-
-        public function set(CacheItem ...$items): bool
-        {
-            foreach ($items as $item) {
-                $this->data[$item->key->toString()] = $item;
-            }
-            return true;
-        }
-
-        public function has(CacheIdentifier ...$identifiers): array
-        {
-            $result = [];
-            foreach ($identifiers as $identifier) {
-                $key = (string) $identifier;
-                $result[$key] = isset($this->data[$key]);
-            }
-            return $result;
-        }
-
-        public function forget(CacheIdentifier ...$identifiers): bool
-        {
-            foreach ($identifiers as $identifier) {
-                $key = (string) $identifier;
-                unset($this->data[$key]);
-            }
-            return true;
-        }
-
-        public function clear(): bool
-        {
-            $this->data = [];
-            return true;
-        }
-
-        public function remember(CacheKey $key, callable $callback, ?Duration $ttl = null): CacheItem
-        {
-            $keyStr = $key->toString();
-
-            if (isset($this->data[$keyStr])) {
-                return $this->data[$keyStr];
-            }
-
-            $value = $callback();
-            $item = CacheItem::forSetting($key, $value, $ttl);
-            $this->data[$keyStr] = $item;
-
-            return $item;
-        }
-    };
-}
-
-function createTestClock(): Clock
-{
-    return new class implements Clock {
-        public function now(): \DateTimeImmutable
-        {
-            return new \DateTimeImmutable();
-        }
-
-        public function fromTimestamp(Timestamp $timestamp): \DateTimeImmutable
-        {
-            return $timestamp->toDateTime();
-        }
-
-        public function fromString(string $dateTime, ?string $format = null): \DateTimeImmutable
-        {
-            return new \DateTimeImmutable($dateTime);
-        }
-
-        public function today(): \DateTimeImmutable
-        {
-            return new \DateTimeImmutable('today');
-        }
-
-        public function yesterday(): \DateTimeImmutable
-        {
-            return new \DateTimeImmutable('yesterday');
-        }
-
-        public function tomorrow(): \DateTimeImmutable
-        {
-            return new \DateTimeImmutable('tomorrow');
-        }
-
-        public function time(): Timestamp
-        {
-            return Timestamp::now();
-        }
-    };
-}
-
-describe('ErrorHandler ErrorAggregator Integration', function () {
-    it('processes ErrorHandlerContext through ErrorAggregator', function () {
-        // Setup ErrorAggregator
-        $storage = new InMemoryErrorStorage();
-        $cache = createTestCache();
-        $clock = createTestClock();
-        $alertQueue = new InMemoryQueue();
-
-        $errorAggregator = new ErrorAggregator(
-            storage: $storage,
-            cache: $cache,
-            clock: $clock,
-            alertQueue: $alertQueue
-        );
-
-        // Create ErrorHandlerContext (simulates what ErrorHandler does)
-        $exception = FrameworkException::create(
-            DatabaseErrorCode::QUERY_FAILED,
-            'Test database query failed'
-        );
-
-        $exceptionContext = ExceptionContext::empty()
-            ->withOperation('test_operation', 'TestComponent')
-            ->withData([
-                'test_key' => 'test_value',
-                'original_exception' => $exception,  // Store exception for message extraction
-                'exception_message' => $exception->getMessage()
-            ]);
-
-        $requestContext = RequestContext::fromGlobals();
-        $systemContext = SystemContext::current();
-
-        $errorHandlerContext = ErrorHandlerContext::create(
-            $exceptionContext,
-            $requestContext,
-            $systemContext,
-            ['http_status' => 500]
-        );
-
-        // Process through ErrorAggregator (simulates ErrorHandler calling it)
-        $errorAggregator->processError($errorHandlerContext);
-
-        // Verify error was stored
-        $recentEvents = $errorAggregator->getRecentEvents(10);
-        expect($recentEvents)->toHaveCount(1);
-
-        $event = $recentEvents[0];
-        expect($event->errorMessage)->toBe('Test database query failed');
-        expect($event->severity)->toBe(ErrorSeverity::ERROR);
-        expect($event->component)->toBe('TestComponent');
-        expect($event->operation)->toBe('test_operation');
-
-        // Verify pattern was created
-        $activePatterns = $errorAggregator->getActivePatterns(10);
-        expect($activePatterns)->toHaveCount(1);
-
-        $pattern = $activePatterns[0];
-        expect($pattern->occurrenceCount)->toBe(1);
-        expect($pattern->severity)->toBe(ErrorSeverity::ERROR);
-        expect($pattern->component)->toBe('TestComponent');
-    });
-
-    it('creates error patterns from multiple identical errors', function () {
-        $storage = new InMemoryErrorStorage();
-        $cache = createTestCache();
-        $clock = createTestClock();
-        $alertQueue = new InMemoryQueue();
-
-        $errorAggregator = new ErrorAggregator(
-            storage: $storage,
-            cache: $cache,
-            clock: $clock,
-            alertQueue: $alertQueue
-        );
-
-        // Process same error 3 times
-        for ($i = 0; $i < 3; $i++) {
-            $exception = FrameworkException::create(
-                DatabaseErrorCode::QUERY_FAILED,
-                'Repeated database error'
-            );
-
-            $exceptionContext = ExceptionContext::empty()
-                ->withOperation('query_execution', 'DatabaseManager')
-                ->withData([
-                    'query' => 'SELECT * FROM users',
-                    'original_exception' => $exception,
-                    'exception_message' => $exception->getMessage()
-                ]);
-
-            $requestContext = RequestContext::fromGlobals();
-            $systemContext = SystemContext::current();
-
-            $errorHandlerContext = ErrorHandlerContext::create(
-                $exceptionContext,
-                $requestContext,
-                $systemContext,
-                ['http_status' => 500]
-            );
-
-            $errorAggregator->processError($errorHandlerContext);
-        }
-
-        // Verify all 3 events were stored
-        $recentEvents = $errorAggregator->getRecentEvents(10);
-        expect($recentEvents)->toHaveCount(3);
-
-        // Verify single pattern with 3 occurrences (same fingerprint)
-        $activePatterns = $errorAggregator->getActivePatterns(10);
-        expect($activePatterns)->toHaveCount(1);
-
-        $pattern = $activePatterns[0];
-        expect($pattern->occurrenceCount)->toBe(3);
-        expect($pattern->component)->toBe('DatabaseManager');
-        expect($pattern->operation)->toBe('query_execution');
-    });
-
-    it('handles ErrorAggregator being null (optional dependency)', function () {
-        $errorAggregator = null;
-
-        // Simulate the nullable call pattern used in ErrorHandler
-        $exception = FrameworkException::create(
-            DatabaseErrorCode::QUERY_FAILED,
-            'Test error'
-        );
-
-        $exceptionContext = ExceptionContext::empty();
-        $requestContext = RequestContext::fromGlobals();
-        $systemContext = SystemContext::current();
-
-        $errorHandlerContext = ErrorHandlerContext::create(
-            $exceptionContext,
-            $requestContext,
-            $systemContext,
-            []
-        );
-
-        // This should not throw an error
-        $errorAggregator?->processError($errorHandlerContext);
-
-        // If we get here, the null-safe operator worked correctly
-        expect(true)->toBeTrue();
-    });
-
-    it('processes errors with different severities correctly', function () {
-        $storage = new InMemoryErrorStorage();
-        $cache = createTestCache();
-        $clock = createTestClock();
-        $alertQueue = new InMemoryQueue();
-
-        $errorAggregator = new ErrorAggregator(
-            storage: $storage,
-            cache: $cache,
-            clock: $clock,
-            alertQueue: $alertQueue
-        );
-
-        // Process errors with different severities
-        $errorCodes = [
-            SystemErrorCode::RESOURCE_EXHAUSTED,  // CRITICAL
-            DatabaseErrorCode::QUERY_FAILED,      // ERROR
-            CacheErrorCode::READ_FAILED,          // WARNING
-        ];
-
-        foreach ($errorCodes as $errorCode) {
-            $exception = FrameworkException::create($errorCode, 'Test message');
-
-            $exceptionContext = ExceptionContext::empty()
-                ->withOperation('test_op', 'TestComponent')
-                ->withData([
-                    'original_exception' => $exception,
-                    'exception_message' => $exception->getMessage()
-                ]);
-
-            $requestContext = RequestContext::fromGlobals();
-            $systemContext = SystemContext::current();
-
-            $errorHandlerContext = ErrorHandlerContext::create(
-                $exceptionContext,
-                $requestContext,
-                $systemContext,
-                []
-            );
-
-            $errorAggregator->processError($errorHandlerContext);
-        }
-
-        // Verify all events were stored
-        $recentEvents = $errorAggregator->getRecentEvents(10);
-        expect($recentEvents)->toHaveCount(3);
-
-        // Verify patterns reflect correct severities
-        $activePatterns = $errorAggregator->getActivePatterns(10);
-        expect($activePatterns)->toHaveCount(3);
-
-        $severities = array_map(fn($p) => $p->severity, $activePatterns);
-        expect($severities)->toContain(ErrorSeverity::CRITICAL);
-        expect($severities)->toContain(ErrorSeverity::ERROR);
-        expect($severities)->toContain(ErrorSeverity::WARNING);
-    });
-});
diff --git a/tests/Unit/ErrorHandling/ErrorHandlerFullPipelineTest.php b/tests/Unit/ErrorHandling/ErrorHandlerFullPipelineTest.php
deleted file mode 100644
index 4a60587b..00000000
--- a/tests/Unit/ErrorHandling/ErrorHandlerFullPipelineTest.php
+++ /dev/null
@@ -1,298 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Framework\Cache\Cache;
-use App\Framework\Cache\CacheIdentifier;
-use App\Framework\Cache\CacheKey;
-use App\Framework\Cache\CacheItem;
-use App\Framework\Cache\CacheResult;
-use App\Framework\Core\ValueObjects\Duration;
-use App\Framework\DateTime\SystemClock;
-use App\Framework\ErrorAggregation\ErrorAggregator;
-use App\Framework\ErrorAggregation\ErrorAggregatorInterface;
-use App\Framework\ErrorAggregation\Storage\InMemoryErrorStorage;
-use App\Framework\ErrorHandling\ErrorHandler;
-use App\Framework\ErrorHandling\ErrorHandlerManager;
-use App\Framework\ErrorHandling\ErrorHandlerRegistry;
-use App\Framework\ErrorReporting\ErrorReporter;
-use App\Framework\ErrorReporting\ErrorReporterInterface;
-use App\Framework\ErrorReporting\Storage\InMemoryErrorReportStorage;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\Core\ErrorSeverity;
-use App\Framework\Exception\Core\SystemErrorCode;
-use App\Framework\Exception\DatabaseException;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Http\RequestIdGenerator;
-use App\Framework\Http\ResponseEmitter;
-use App\Framework\DI\DefaultContainer;
-use App\Framework\Queue\InMemoryQueue;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\LogLevel;
-use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Logging\InMemoryLogger;
-
-describe('ErrorHandler Full Pipeline Integration', function () {
-    beforeEach(function () {
-        // Create all dependencies
-        $this->container = new DefaultContainer();
-
-        // Create and bind InMemoryLogger for testing
-        $this->logger = new InMemoryLogger();
-        $this->container->bind(Logger::class, fn() => $this->logger);
-        $this->emitter = new ResponseEmitter();
-        $this->requestIdGenerator = new RequestIdGenerator();
-
-        // Error Aggregation setup
-        $this->errorStorage = new InMemoryErrorStorage();
-        $this->cache = new class implements Cache {
-            private array $data = [];
-
-            public function get(CacheIdentifier ...$identifiers): CacheResult
-            {
-                $items = [];
-                foreach ($identifiers as $identifier) {
-                    $keyStr = $identifier->toString();
-                    if (isset($this->data[$keyStr])) {
-                        $items[] = $this->data[$keyStr];
-                    } else {
-                        $items[] = CacheItem::miss($identifier instanceof CacheKey ? $identifier : CacheKey::fromString($keyStr));
-                    }
-                }
-
-                return CacheResult::fromItems(...$items);
-            }
-
-            public function set(CacheItem ...$items): bool
-            {
-                foreach ($items as $item) {
-                    $this->data[$item->key->toString()] = $item;
-                }
-
-                return true;
-            }
-
-            public function has(CacheIdentifier ...$identifiers): array
-            {
-                $result = [];
-                foreach ($identifiers as $identifier) {
-                    $result[] = isset($this->data[$identifier->toString()]);
-                }
-
-                return $result;
-            }
-
-            public function forget(CacheIdentifier ...$identifiers): bool
-            {
-                foreach ($identifiers as $identifier) {
-                    unset($this->data[$identifier->toString()]);
-                }
-
-                return true;
-            }
-
-            public function clear(): bool
-            {
-                $this->data = [];
-
-                return true;
-            }
-
-            public function remember(CacheKey $key, callable $callback, ?Duration $ttl = null): CacheItem
-            {
-                $keyStr = $key->toString();
-                if (isset($this->data[$keyStr])) {
-                    return $this->data[$keyStr];
-                }
-
-                $value = $callback();
-                $item = $ttl ? CacheItem::forSet($key, $value, $ttl) : CacheItem::miss($key);
-                $this->data[$keyStr] = $item;
-
-                return $item;
-            }
-        };
-        $this->clock = new SystemClock();
-        $this->alertQueue = new InMemoryQueue();
-
-        $this->errorAggregator = new ErrorAggregator(
-            storage: $this->errorStorage,
-            cache: $this->cache,
-            clock: $this->clock,
-            alertQueue: $this->alertQueue,
-            logger: $this->logger,
-            batchSize: 100,
-            maxRetentionDays: 90
-        );
-
-        // Error Reporting setup
-        $this->errorReportStorage = new InMemoryErrorReportStorage();
-        $this->reportQueue = new InMemoryQueue();
-
-        $this->errorReporter = new ErrorReporter(
-            storage: $this->errorReportStorage,
-            clock: $this->clock,
-            logger: $this->logger,
-            queue: $this->reportQueue,
-            asyncProcessing: false,  // Synchronous for testing
-            processors: [],
-            filters: []
-        );
-
-        // Create ErrorHandlerManager
-        $registry = new ErrorHandlerRegistry();
-        $this->handlerManager = new ErrorHandlerManager($registry);
-
-        // Create ErrorHandler with full pipeline
-        $this->errorHandler = new ErrorHandler(
-            emitter: $this->emitter,
-            container: $this->container,
-            requestIdGenerator: $this->requestIdGenerator,
-            errorAggregator: $this->errorAggregator,
-            errorReporter: $this->errorReporter,
-            handlerManager: $this->handlerManager,
-            logger: $this->logger,
-            isDebugMode: true,
-            securityHandler: null
-        );
-    });
-
-    it('processes errors through complete pipeline: ErrorHandler → ErrorAggregator → ErrorReporter', function () {
-        // Create a test exception
-        $exception = FrameworkException::create(
-            DatabaseErrorCode::QUERY_FAILED,
-            'Test database error'
-        );
-
-        // Create HTTP response (triggers processing through all systems)
-        $response = $this->errorHandler->createHttpResponse($exception);
-
-        // Verify ErrorAggregator processed the error
-        $events = $this->errorStorage->getRecentEvents(10);
-        expect($events)->toHaveCount(1);
-        expect($events[0]->errorMessage)->toBe('Test database error');
-        expect($events[0]->severity)->toBe(ErrorSeverity::ERROR);
-
-        // Verify ErrorReporter created a report
-        $reports = $this->errorReportStorage->findRecent(10);
-        expect($reports)->toHaveCount(1);
-        expect($reports[0]->exception)->toBe('App\Framework\Exception\FrameworkException');
-        expect($reports[0]->message)->toContain('Test database error');
-        expect($reports[0]->level)->toBe('error');
-    });
-
-    it('creates error patterns and error reports simultaneously', function () {
-        // Create multiple identical errors
-        $exception1 = FrameworkException::create(
-            SystemErrorCode::RESOURCE_EXHAUSTED,
-            'Memory limit exceeded'
-        );
-        $exception2 = FrameworkException::create(
-            SystemErrorCode::RESOURCE_EXHAUSTED,
-            'Memory limit exceeded'
-        );
-        $exception3 = FrameworkException::create(
-            SystemErrorCode::RESOURCE_EXHAUSTED,
-            'Memory limit exceeded'
-        );
-
-        // Process all exceptions
-        $this->errorHandler->createHttpResponse($exception1);
-        $this->errorHandler->createHttpResponse($exception2);
-        $this->errorHandler->createHttpResponse($exception3);
-
-        // Verify ErrorAggregator created patterns
-        $patterns = $this->errorStorage->getActivePatterns(10);
-        expect($patterns)->toHaveCount(1);
-        expect($patterns[0]->occurrenceCount)->toBe(3);
-        expect($patterns[0]->severity)->toBe(ErrorSeverity::CRITICAL);
-
-        // Verify ErrorReporter created individual reports
-        $reports = $this->errorReportStorage->findRecent(10);
-        expect($reports)->toHaveCount(3);
-        foreach ($reports as $report) {
-            expect($report->message)->toContain('Memory limit exceeded');
-        }
-    });
-
-    it('handles different error types through pipeline', function () {
-        // Database error using migrated DatabaseException
-        $dbException = DatabaseException::queryFailed(
-            sql: 'SELECT * FROM users WHERE id = ?',
-            error: 'Table users does not exist'
-        );
-
-        // System error
-        $sysException = FrameworkException::create(
-            SystemErrorCode::RESOURCE_EXHAUSTED,
-            'CPU limit exceeded'
-        );
-
-        // Process both
-        $this->errorHandler->createHttpResponse($dbException);
-        $this->errorHandler->createHttpResponse($sysException);
-
-        // Verify ErrorAggregator
-        $events = $this->errorStorage->getRecentEvents(10);
-        expect($events)->toHaveCount(2);
-        $severities = array_map(fn($e) => $e->severity, $events);
-        expect($severities)->toContain(ErrorSeverity::ERROR);      // Database
-        expect($severities)->toContain(ErrorSeverity::CRITICAL);   // System
-
-        // Verify ErrorReporter
-        $reports = $this->errorReportStorage->findRecent(10);
-        expect($reports)->toHaveCount(2);
-    });
-
-    it('propagates error context through entire pipeline', function () {
-        $exception = FrameworkException::create(
-            DatabaseErrorCode::QUERY_FAILED,
-            'Complex query failed'
-        )->withData([
-            'query' => 'SELECT * FROM large_table WHERE id IN (...)',
-            'execution_time' => 5.2
-        ]);
-
-        // Process exception
-        $this->errorHandler->createHttpResponse($exception);
-
-        // Verify ErrorAggregator has context
-        $events = $this->errorStorage->getRecentEvents(10);
-        expect($events[0]->context)->toBeArray();
-        expect($events[0]->context)->toHaveKey('query');
-        expect($events[0]->context)->toHaveKey('execution_time');
-
-        // Verify ErrorReporter has full context
-        $reports = $this->errorReportStorage->findRecent(10);
-        expect($reports[0]->context)->toBeArray();
-        expect($reports[0]->context)->toHaveKey('exception');
-    });
-
-    it('uses interfaces for dependency injection', function () {
-        // Verify ErrorHandler accepts interfaces
-        expect($this->errorHandler)
-            ->toBeInstanceOf(ErrorHandler::class);
-
-        // Verify dependencies are interface-based (via reflection)
-        $reflection = new \ReflectionClass(ErrorHandler::class);
-        $constructor = $reflection->getConstructor();
-
-        $aggregatorParam = null;
-        $reporterParam = null;
-
-        foreach ($constructor->getParameters() as $param) {
-            if ($param->getName() === 'errorAggregator') {
-                $aggregatorParam = $param;
-            }
-            if ($param->getName() === 'errorReporter') {
-                $reporterParam = $param;
-            }
-        }
-
-        // Verify parameters use interfaces
-        expect($aggregatorParam->getType()->getName())
-            ->toBe(ErrorAggregatorInterface::class);
-        expect($reporterParam->getType()->getName())
-            ->toBe(ErrorReporterInterface::class);
-    });
-});
diff --git a/tests/Unit/Framework/DI/ParameterResolverTest.php b/tests/Unit/Framework/DI/ParameterResolverTest.php
index e88150f7..25f0628c 100644
--- a/tests/Unit/Framework/DI/ParameterResolverTest.php
+++ b/tests/Unit/Framework/DI/ParameterResolverTest.php
@@ -13,7 +13,8 @@ use App\Framework\Logging\HasChannel;
 use App\Framework\Logging\LogChannel;
 use App\Framework\Logging\Logger;
 use App\Framework\Logging\SupportsChannels;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\Reflection\ReflectionService;
+use App\Framework\Reflection\SimpleReflectionService;
 use App\Framework\Config\Env as EnvAttribute;
 use App\Framework\Config\EnvKey;
 use App\Framework\Config\Environment;
@@ -116,8 +117,8 @@ final class ServiceWithEnvAttribute
 
 beforeEach(function () {
     $this->container = $this->createMock(Container::class);
-    $this->reflectionProvider = new CachedReflectionProvider();
-    $this->resolver = new ParameterResolver($this->container, $this->reflectionProvider);
+    $this->reflectionService = new SimpleReflectionService();
+    $this->resolver = new ParameterResolver($this->container, $this->reflectionService);
 });
 
 describe('ParameterResolver', function () {
diff --git a/tests/Unit/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheckTest.php b/tests/Unit/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheckTest.php
index 0966f59c..d1fd1a63 100644
--- a/tests/Unit/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheckTest.php
+++ b/tests/Unit/Framework/Deployment/Ssl/HealthChecks/SslCertificateHealthCheckTest.php
@@ -160,12 +160,12 @@ describe('SslCertificateHealthCheck', function () {
     });
 
     it('has correct name and category', function () {
-        expect($this->healthCheck->getName())->toBe('SSL Certificate');
+        expect($this->healthCheck->name)->toBe('SSL Certificate');
         expect($this->healthCheck->getCategory())->toBe(HealthCheckCategory::SECURITY);
     });
 
     it('has reasonable timeout', function () {
-        $timeout = $this->healthCheck->getTimeout();
+        $timeout = $this->healthCheck->timeout;
 
         expect($timeout)->toBeInt();
         expect($timeout)->toBeGreaterThan(0);
diff --git a/tests/Unit/Framework/ErrorHandling/ErrorHandlerManagerTest.php b/tests/Unit/Framework/ErrorHandling/ErrorHandlerManagerTest.php
deleted file mode 100644
index 20dcd66d..00000000
--- a/tests/Unit/Framework/ErrorHandling/ErrorHandlerManagerTest.php
+++ /dev/null
@@ -1,320 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Framework\ErrorHandling;
-
-use App\Framework\ErrorHandling\ErrorHandlerManager;
-use App\Framework\ErrorHandling\ErrorHandlerRegistry;
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerInterface;
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\ErrorHandling\Handlers\HandlerResult;
-use App\Framework\Logging\Logger;
-
-describe('ErrorHandlerManager', function () {
-    beforeEach(function () {
-        $this->registry = new ErrorHandlerRegistry();
-        $this->manager = new ErrorHandlerManager($this->registry);
-    });
-
-    it('executes handlers in priority order', function () {
-        $executionOrder = [];
-
-        $highPriorityHandler = new class ($executionOrder) implements ErrorHandlerInterface {
-            public function __construct(private array &$executionOrder) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->executionOrder[] = 'high';
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'High priority handler'
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'high_priority';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::HIGH;
-            }
-        };
-
-        $lowPriorityHandler = new class ($executionOrder) implements ErrorHandlerInterface {
-            public function __construct(private array &$executionOrder) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->executionOrder[] = 'low';
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Low priority handler'
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'low_priority';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::LOW;
-            }
-        };
-
-        $this->manager = $this->manager->register($lowPriorityHandler, $highPriorityHandler);
-
-        $exception = new \Exception('Test');
-        $this->manager->handle($exception);
-
-        expect($executionOrder)->toBe(['high', 'low']);
-    });
-
-    it('stops propagation when handler marks as final', function () {
-        $called = [];
-
-        $finalHandler = new class ($called) implements ErrorHandlerInterface {
-            public function __construct(private array &$called) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->called[] = 'final';
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Final handler',
-                    isFinal: true
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'final_handler';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::HIGH;
-            }
-        };
-
-        $afterHandler = new class ($called) implements ErrorHandlerInterface {
-            public function __construct(private array &$called) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->called[] = 'after';
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'After handler'
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'after_handler';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::LOW;
-            }
-        };
-
-        $this->manager = $this->manager->register($finalHandler, $afterHandler);
-
-        $exception = new \Exception('Test');
-        $result = $this->manager->handle($exception);
-
-        expect($called)->toBe(['final']);
-        expect($result->handled)->toBeTrue();
-    });
-
-    it('skips handlers that cannot handle exception', function () {
-        $specificHandler = new class implements ErrorHandlerInterface {
-            public function canHandle(\Throwable $exception): bool
-            {
-                return $exception instanceof \InvalidArgumentException;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Specific handler'
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'specific';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::HIGH;
-            }
-        };
-
-        $this->manager = $this->manager->register($specificHandler);
-
-        $exception = new \RuntimeException('Test');
-        $result = $this->manager->handle($exception);
-
-        expect($result->handled)->toBeFalse();
-        expect($result->results)->toBeEmpty();
-    });
-
-    it('continues chain even if handler throws exception', function () {
-        $called = [];
-
-        $failingHandler = new class ($called) implements ErrorHandlerInterface {
-            public function __construct(private array &$called) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->called[] = 'failing';
-                throw new \RuntimeException('Handler failed');
-            }
-
-            public function getName(): string
-            {
-                return 'failing';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::HIGH;
-            }
-        };
-
-        $workingHandler = new class ($called) implements ErrorHandlerInterface {
-            public function __construct(private array &$called) {}
-
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                $this->called[] = 'working';
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Working handler'
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'working';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::LOW;
-            }
-        };
-
-        $this->manager = $this->manager->register($failingHandler, $workingHandler);
-
-        $exception = new \Exception('Test');
-        $result = $this->manager->handle($exception);
-
-        expect($called)->toBe(['failing', 'working']);
-        expect($result->handled)->toBeTrue();
-    });
-
-    it('aggregates results from multiple handlers', function () {
-        $handler1 = new class implements ErrorHandlerInterface {
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Handler 1',
-                    data: ['from' => 'handler1']
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'handler1';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::HIGH;
-            }
-        };
-
-        $handler2 = new class implements ErrorHandlerInterface {
-            public function canHandle(\Throwable $exception): bool
-            {
-                return true;
-            }
-
-            public function handle(\Throwable $exception): HandlerResult
-            {
-                return HandlerResult::create(
-                    handled: true,
-                    message: 'Handler 2',
-                    data: ['from' => 'handler2']
-                );
-            }
-
-            public function getName(): string
-            {
-                return 'handler2';
-            }
-
-            public function getPriority(): ErrorHandlerPriority
-            {
-                return ErrorHandlerPriority::LOW;
-            }
-        };
-
-        $this->manager = $this->manager->register($handler1, $handler2);
-
-        $exception = new \Exception('Test');
-        $result = $this->manager->handle($exception);
-
-        expect($result->results)->toHaveCount(2);
-        expect($result->getMessages())->toBe(['Handler 1', 'Handler 2']);
-
-        $combinedData = $result->getCombinedData();
-        expect($combinedData)->toHaveKey('from');
-    });
-});
diff --git a/tests/Unit/Framework/ErrorHandling/Handlers/DatabaseErrorHandlerTest.php b/tests/Unit/Framework/ErrorHandling/Handlers/DatabaseErrorHandlerTest.php
deleted file mode 100644
index 8aeb53c9..00000000
--- a/tests/Unit/Framework/ErrorHandling/Handlers/DatabaseErrorHandlerTest.php
+++ /dev/null
@@ -1,63 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Framework\ErrorHandling\Handlers;
-
-use App\Framework\Database\Exception\DatabaseException;
-use App\Framework\ErrorHandling\Handlers\DatabaseErrorHandler;
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\Logging\Logger;
-
-describe('DatabaseErrorHandler', function () {
-    beforeEach(function () {
-        $this->logger = $this->createMock(Logger::class);
-        $this->handler = new DatabaseErrorHandler($this->logger);
-    });
-
-    it('handles DatabaseException', function () {
-        $exception = DatabaseException::fromContext(
-            'Connection failed',
-            \App\Framework\Exception\ExceptionContext::empty()
-        );
-
-        expect($this->handler->canHandle($exception))->toBeTrue();
-
-        $this->logger
-            ->expects($this->once())
-            ->method('error')
-            ->with('Database error occurred', $this->anything());
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->statusCode)->toBe(500);
-        expect($result->data['error_type'])->toBe('database');
-        expect($result->data['retry_after'])->toBe(60);
-    });
-
-    it('handles PDOException', function () {
-        $exception = new \PDOException('SQLSTATE[HY000] [2002] Connection refused');
-
-        expect($this->handler->canHandle($exception))->toBeTrue();
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->statusCode)->toBe(500);
-    });
-
-    it('does not handle non-database exceptions', function () {
-        $exception = new \RuntimeException('Some error');
-
-        expect($this->handler->canHandle($exception))->toBeFalse();
-    });
-
-    it('has HIGH priority', function () {
-        expect($this->handler->getPriority())->toBe(ErrorHandlerPriority::HIGH);
-    });
-
-    it('has correct name', function () {
-        expect($this->handler->getName())->toBe('database_error_handler');
-    });
-});
diff --git a/tests/Unit/Framework/ErrorHandling/Handlers/FallbackErrorHandlerTest.php b/tests/Unit/Framework/ErrorHandling/Handlers/FallbackErrorHandlerTest.php
deleted file mode 100644
index e0da88c3..00000000
--- a/tests/Unit/Framework/ErrorHandling/Handlers/FallbackErrorHandlerTest.php
+++ /dev/null
@@ -1,69 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Framework\ErrorHandling\Handlers;
-
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\ErrorHandling\Handlers\FallbackErrorHandler;
-use App\Framework\Logging\Logger;
-
-describe('FallbackErrorHandler', function () {
-    beforeEach(function () {
-        $this->logger = $this->createMock(Logger::class);
-        $this->handler = new FallbackErrorHandler($this->logger);
-    });
-
-    it('handles any exception', function () {
-        $exception = new \RuntimeException('Any error');
-
-        expect($this->handler->canHandle($exception))->toBeTrue();
-    });
-
-    it('logs exception with full context', function () {
-        $exception = new \RuntimeException('Test error');
-
-        $this->logger
-            ->expects($this->once())
-            ->method('error')
-            ->with('Unhandled exception', $this->callback(function ($context) use ($exception) {
-                return $context instanceof \App\Framework\Logging\ValueObjects\LogContext
-                    && $context->structured['exception_class'] === \RuntimeException::class
-                    && $context->structured['message'] === 'Test error'
-                    && isset($context->structured['file'])
-                    && isset($context->structured['line'])
-                    && isset($context->structured['trace']);
-            }));
-
-        $this->handler->handle($exception);
-    });
-
-    it('returns generic error message', function () {
-        $exception = new \RuntimeException('Detailed error');
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->message)->toBe('An unexpected error occurred');
-        expect($result->isFinal)->toBeTrue();
-        expect($result->statusCode)->toBe(500);
-        expect($result->data['error_type'])->toBe('unhandled');
-        expect($result->data['exception_class'])->toBe(\RuntimeException::class);
-    });
-
-    it('marks result as final', function () {
-        $exception = new \RuntimeException('Test');
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->isFinal)->toBeTrue();
-    });
-
-    it('has LOWEST priority', function () {
-        expect($this->handler->getPriority())->toBe(ErrorHandlerPriority::LOWEST);
-    });
-
-    it('has correct name', function () {
-        expect($this->handler->getName())->toBe('fallback_error_handler');
-    });
-});
diff --git a/tests/Unit/Framework/ErrorHandling/Handlers/HttpErrorHandlerTest.php b/tests/Unit/Framework/ErrorHandling/Handlers/HttpErrorHandlerTest.php
deleted file mode 100644
index 1041001c..00000000
--- a/tests/Unit/Framework/ErrorHandling/Handlers/HttpErrorHandlerTest.php
+++ /dev/null
@@ -1,61 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Framework\ErrorHandling\Handlers;
-
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\ErrorHandling\Handlers\HttpErrorHandler;
-use App\Framework\Http\Exception\HttpException;
-use App\Framework\Http\Status;
-
-describe('HttpErrorHandler', function () {
-    beforeEach(function () {
-        $this->handler = new HttpErrorHandler();
-    });
-
-    it('handles HttpException', function () {
-        $exception = new HttpException(
-            'Not Found',
-            Status::NOT_FOUND,
-            headers: ['X-Custom' => 'value']
-        );
-
-        expect($this->handler->canHandle($exception))->toBeTrue();
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->message)->toBe('Not Found');
-        expect($result->statusCode)->toBe(404);
-        expect($result->data['error_type'])->toBe('http');
-        expect($result->data['headers'])->toBe(['X-Custom' => 'value']);
-    });
-
-    it('handles HttpException with no headers', function () {
-        $exception = new HttpException(
-            'Bad Request',
-            Status::BAD_REQUEST
-        );
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->statusCode)->toBe(400);
-        expect($result->data['headers'])->toBe([]);
-    });
-
-    it('does not handle non-HttpException', function () {
-        $exception = new \RuntimeException('Some error');
-
-        expect($this->handler->canHandle($exception))->toBeFalse();
-    });
-
-    it('has NORMAL priority', function () {
-        expect($this->handler->getPriority())->toBe(ErrorHandlerPriority::NORMAL);
-    });
-
-    it('has correct name', function () {
-        expect($this->handler->getName())->toBe('http_error_handler');
-    });
-});
diff --git a/tests/Unit/Framework/ErrorHandling/Handlers/ValidationErrorHandlerTest.php b/tests/Unit/Framework/ErrorHandling/Handlers/ValidationErrorHandlerTest.php
deleted file mode 100644
index 07037435..00000000
--- a/tests/Unit/Framework/ErrorHandling/Handlers/ValidationErrorHandlerTest.php
+++ /dev/null
@@ -1,47 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Framework\ErrorHandling\Handlers;
-
-use App\Framework\ErrorHandling\Handlers\ErrorHandlerPriority;
-use App\Framework\ErrorHandling\Handlers\ValidationErrorHandler;
-use App\Framework\Validation\Exceptions\ValidationException;
-
-describe('ValidationErrorHandler', function () {
-    beforeEach(function () {
-        $this->handler = new ValidationErrorHandler();
-    });
-
-    it('handles ValidationException', function () {
-        $validationResult = new \App\Framework\Validation\ValidationResult();
-        $validationResult->addErrors('email', ['Email is required', 'Email format is invalid']);
-        $validationResult->addErrors('password', ['Password must be at least 8 characters']);
-
-        $exception = new ValidationException($validationResult);
-
-        expect($this->handler->canHandle($exception))->toBeTrue();
-
-        $result = $this->handler->handle($exception);
-
-        expect($result->handled)->toBeTrue();
-        expect($result->statusCode)->toBe(422);
-        expect($result->data)->toHaveKey('errors');
-        expect($result->data['errors'])->toBe($validationResult->getAll());
-        expect($result->data['error_type'])->toBe('validation');
-    });
-
-    it('does not handle non-ValidationException', function () {
-        $exception = new \RuntimeException('Some error');
-
-        expect($this->handler->canHandle($exception))->toBeFalse();
-    });
-
-    it('has CRITICAL priority', function () {
-        expect($this->handler->getPriority())->toBe(ErrorHandlerPriority::CRITICAL);
-    });
-
-    it('has correct name', function () {
-        expect($this->handler->getName())->toBe('validation_error_handler');
-    });
-});
diff --git a/tests/Unit/Framework/ExceptionHandling/Audit/ExceptionAuditLoggerTest.php b/tests/Unit/Framework/ExceptionHandling/Audit/ExceptionAuditLoggerTest.php
new file mode 100644
index 00000000..d9e4e163
--- /dev/null
+++ b/tests/Unit/Framework/ExceptionHandling/Audit/ExceptionAuditLoggerTest.php
@@ -0,0 +1,301 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\Audit\AuditLogger;
+use App\Framework\Audit\InMemoryAuditLogger;
+use App\Framework\Audit\ValueObjects\AuditEntry;
+use App\Framework\Audit\ValueObjects\AuditableAction;
+use App\Framework\DateTime\Clock;
+use App\Framework\ExceptionHandling\Audit\ExceptionAuditLogger;
+use App\Framework\ExceptionHandling\Context\ExceptionContextData;
+use App\Framework\ExceptionHandling\Context\ExceptionContextProvider;
+
+describe('ExceptionAuditLogger', function () {
+    beforeEach(function () {
+        $this->auditLogger = new InMemoryAuditLogger();
+        $this->clock = new class implements Clock {
+            private DateTimeImmutable $now;
+
+            public function __construct()
+            {
+                $this->now = new DateTimeImmutable('2024-01-01 12:00:00');
+            }
+
+            public function now(): DateTimeImmutable
+            {
+                return $this->now;
+            }
+
+            public function fromTimestamp(\App\Framework\Core\ValueObjects\Timestamp $timestamp): DateTimeImmutable
+            {
+                return DateTimeImmutable::createFromTimestamp($timestamp->value);
+            }
+
+            public function fromString(string $dateTime, ?string $format = null): DateTimeImmutable
+            {
+                return DateTimeImmutable::createFromFormat($format ?? 'Y-m-d H:i:s', $dateTime);
+            }
+
+            public function today(): DateTimeImmutable
+            {
+                return $this->now;
+            }
+
+            public function yesterday(): DateTimeImmutable
+            {
+                return $this->now->modify('-1 day');
+            }
+
+            public function tomorrow(): DateTimeImmutable
+            {
+                return $this->now->modify('+1 day');
+            }
+
+            public function time(): \App\Framework\Core\ValueObjects\Timestamp
+            {
+                return new \App\Framework\Core\ValueObjects\Timestamp($this->now->getTimestamp());
+            }
+        };
+        $this->contextProvider = new ExceptionContextProvider();
+        $this->exceptionAuditLogger = new ExceptionAuditLogger(
+            $this->auditLogger,
+            $this->clock,
+            $this->contextProvider
+        );
+    });
+
+    it('logs auditable exception as audit entry', function () {
+        $exception = new RuntimeException('User not found');
+        $context = ExceptionContextData::forOperation('user.lookup', 'UserRepository')
+            ->addData(['user_id' => '123'])
+            ->withUserId('user-456')
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        // Check that audit entry was created
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(1);
+
+        $entry = $entries[0];
+        expect($entry->success)->toBeFalse();
+        expect($entry->errorMessage)->toBe('User not found');
+        expect($entry->userId)->toBe('user-456');
+        expect($entry->entityType)->toBe('userrepository');
+        expect($entry->action)->toBeInstanceOf(AuditableAction::class);
+    });
+
+    it('does not log non-auditable exception', function () {
+        $exception = new RuntimeException('Validation error');
+        $context = ExceptionContextData::forOperation('validation.check')
+            ->withAuditable(false);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        // Check that no audit entry was created
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(0);
+    });
+
+    it('logs exception without context as auditable by default', function () {
+        $exception = new RuntimeException('Generic error');
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        // Check that audit entry was created (default: auditable)
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        expect($entries)->toHaveCount(1);
+    });
+
+    it('includes context data in audit entry metadata', function () {
+        $exception = new RuntimeException('Operation failed');
+        $context = ExceptionContextData::forOperation('order.process', 'OrderService')
+            ->addData(['order_id' => 'order-789', 'amount' => 1000])
+            ->withUserId('user-123')
+            ->withRequestId('req-456')
+            ->withTags('payment', 'external_api');
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        $entry = $entries[0];
+
+        expect($entry->metadata)->toHaveKey('operation');
+        expect($entry->metadata['operation'])->toBe('order.process');
+        expect($entry->metadata)->toHaveKey('component');
+        expect($entry->metadata['component'])->toBe('OrderService');
+        expect($entry->metadata)->toHaveKey('context_data');
+        expect($entry->metadata['context_data']['order_id'])->toBe('order-789');
+        expect($entry->metadata)->toHaveKey('tags');
+        expect($entry->metadata['tags'])->toBe(['payment', 'external_api']);
+    });
+
+    it('determines audit action from operation name', function () {
+        $testCases = [
+            ['operation' => 'user.create', 'expected' => AuditableAction::CREATE],
+            ['operation' => 'order.update', 'expected' => AuditableAction::UPDATE],
+            ['operation' => 'product.delete', 'expected' => AuditableAction::DELETE],
+            ['operation' => 'data.read', 'expected' => AuditableAction::READ],
+        ];
+
+        foreach ($testCases as $testCase) {
+            $exception = new RuntimeException('Test');
+            $context = ExceptionContextData::forOperation($testCase['operation'])
+                ->withAuditable(true);
+
+            $this->contextProvider->attach($exception, $context);
+            $this->exceptionAuditLogger->logIfAuditable($exception);
+
+            $entries = $this->getAllAuditEntries($this->auditLogger);
+            $entry = end($entries);
+
+            expect($entry->action)->toBe($testCase['expected']);
+        }
+    });
+
+    it('extracts entity ID from context data', function () {
+        $exception = new RuntimeException('Entity not found');
+        $context = ExceptionContextData::forOperation('entity.get')
+            ->addData(['entity_id' => 'entity-123'])
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        $entry = $entries[0];
+
+        expect($entry->entityId)->toBe('entity-123');
+    });
+
+    it('handles IP address and user agent from context with Value Objects', function () {
+        $exception = new RuntimeException('Security violation');
+        $context = ExceptionContextData::forOperation('security.check')
+            ->withClientIp(\App\Framework\Http\IpAddress::from('192.168.1.1'))
+            ->withUserAgent(\App\Framework\UserAgent\UserAgent::fromString('Mozilla/5.0'))
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        $entry = $entries[0];
+
+        expect($entry->ipAddress)->not->toBeNull();
+        expect((string) $entry->ipAddress)->toBe('192.168.1.1');
+        expect($entry->userAgent)->not->toBeNull();
+        expect($entry->userAgent->value)->toBe('Mozilla/5.0');
+    });
+
+    it('handles IP address and user agent from context with strings (backward compatibility)', function () {
+        $exception = new RuntimeException('Security violation');
+        $context = ExceptionContextData::forOperation('security.check')
+            ->withClientIp('192.168.1.1')
+            ->withUserAgent('Mozilla/5.0')
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        $entry = $entries[0];
+
+        expect($entry->ipAddress)->not->toBeNull();
+        expect((string) $entry->ipAddress)->toBe('192.168.1.1');
+        expect($entry->userAgent)->not->toBeNull();
+        expect($entry->userAgent->value)->toBe('Mozilla/5.0');
+    });
+
+    it('does not throw when audit logging fails', function () {
+        $failingAuditLogger = new class implements AuditLogger {
+            public function log(AuditEntry $entry): void
+            {
+                throw new RuntimeException('Audit logging failed');
+            }
+
+            public function find(\App\Framework\Audit\ValueObjects\AuditId $id): ?AuditEntry
+            {
+                return null;
+            }
+
+            public function query(\App\Framework\Audit\ValueObjects\AuditQuery $query): array
+            {
+                return [];
+            }
+
+            public function count(\App\Framework\Audit\ValueObjects\AuditQuery $query): int
+            {
+                return 0;
+            }
+
+            public function purgeOlderThan(DateTimeImmutable $date): int
+            {
+                return 0;
+            }
+        };
+
+        $logger = new ExceptionAuditLogger(
+            $failingAuditLogger,
+            $this->clock,
+            $this->contextProvider
+        );
+
+        $exception = new RuntimeException('Test error');
+        $context = ExceptionContextData::forOperation('test')
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        // Should not throw
+        expect(fn() => $logger->logIfAuditable($exception))->not->toThrow();
+    });
+
+    it('includes previous exception in metadata', function () {
+        $previous = new InvalidArgumentException('Invalid input');
+        $exception = new RuntimeException('Operation failed', 0, $previous);
+        $context = ExceptionContextData::forOperation('operation.execute')
+            ->withAuditable(true);
+
+        $this->contextProvider->attach($exception, $context);
+
+        $this->exceptionAuditLogger->logIfAuditable($exception);
+
+        $entries = $this->getAllAuditEntries($this->auditLogger);
+        $entry = $entries[0];
+
+        expect($entry->metadata)->toHaveKey('previous_exception');
+        expect($entry->metadata['previous_exception']['class'])->toBe(InvalidArgumentException::class);
+        expect($entry->metadata['previous_exception']['message'])->toBe('Invalid input');
+    });
+});
+
+/**
+ * Helper to get all audit entries from InMemoryAuditLogger
+ *
+ * @return array<AuditEntry>
+ */
+function getAllAuditEntries(AuditLogger $logger): array
+{
+    if ($logger instanceof InMemoryAuditLogger) {
+        // Use reflection to access private entries property
+        $reflection = new ReflectionClass($logger);
+        $property = $reflection->getProperty('entries');
+        $property->setAccessible(true);
+        return array_values($property->getValue($logger));
+    }
+
+    // For other implementations, query all entries
+    $query = new \App\Framework\Audit\ValueObjects\AuditQuery();
+    return $logger->query($query);
+}
+
diff --git a/tests/Unit/Framework/ExceptionHandling/ExceptionContextIntegrationTest.php b/tests/Unit/Framework/ExceptionHandling/ExceptionContextIntegrationTest.php
index e97c5c9d..716c09fc 100644
--- a/tests/Unit/Framework/ExceptionHandling/ExceptionContextIntegrationTest.php
+++ b/tests/Unit/Framework/ExceptionHandling/ExceptionContextIntegrationTest.php
@@ -174,6 +174,36 @@ describe('Exception Context Integration', function () {
         expect($context2->data['query'])->toBe('SELECT * FROM users');
     });
 
+    it('serializes Value Objects to strings in toArray()', function () {
+        $context = ExceptionContextData::forOperation('test.operation')
+            ->withClientIp(\App\Framework\Http\IpAddress::from('192.168.1.1'))
+            ->withUserAgent(\App\Framework\UserAgent\UserAgent::fromString('Mozilla/5.0'))
+            ->withSessionId(\App\Framework\Http\Session\SessionId::fromString('session-12345678901234567890123456789012'))
+            ->withRequestId('req-123');
+
+        $array = $context->toArray();
+
+        expect($array['client_ip'])->toBe('192.168.1.1');
+        expect($array['user_agent'])->toBe('Mozilla/5.0');
+        expect($array['session_id'])->toBe('session-12345678901234567890123456789012');
+        expect($array['request_id'])->toBe('req-123');
+    });
+
+    it('serializes strings to strings in toArray() (backward compatibility)', function () {
+        $context = ExceptionContextData::forOperation('test.operation')
+            ->withClientIp('192.168.1.1')
+            ->withUserAgent('Mozilla/5.0')
+            ->withSessionId('session-123')
+            ->withRequestId('req-123');
+
+        $array = $context->toArray();
+
+        expect($array['client_ip'])->toBe('192.168.1.1');
+        expect($array['user_agent'])->toBe('Mozilla/5.0');
+        expect($array['session_id'])->toBe('session-123');
+        expect($array['request_id'])->toBe('req-123');
+    });
+
     it('handles nested error scopes correctly', function () {
         // Outer scope
         $outerScope = ErrorScopeContext::http(
diff --git a/tests/Unit/Framework/String/ValueObjects/PosixAlphaStringTest.php b/tests/Unit/Framework/String/ValueObjects/PosixAlphaStringTest.php
new file mode 100644
index 00000000..b5558461
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/PosixAlphaStringTest.php
@@ -0,0 +1,209 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\PosixAlphaString;
+use App\Framework\String\ValueObjects\TypedString;
+use App\Framework\String\ValueObjects\PosixString;
+
+describe('PosixAlphaString', function () {
+    describe('Validation', function () {
+        it('accepts valid alphabetic strings', function () {
+            $alpha1 = PosixAlphaString::fromString('abcdefghijklmnopqrstuvwxyz');
+            $alpha2 = PosixAlphaString::fromString('ABCDEFGHIJKLMNOPQRSTUVWXYZ');
+            $alpha3 = PosixAlphaString::fromString('HelloWorld');
+
+            expect($alpha1->value)->toBe('abcdefghijklmnopqrstuvwxyz');
+            expect($alpha2->value)->toBe('ABCDEFGHIJKLMNOPQRSTUVWXYZ');
+            expect($alpha3->value)->toBe('HelloWorld');
+        });
+
+        it('rejects strings with digits', function () {
+            PosixAlphaString::fromString('abc123');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+
+        it('rejects strings with punctuation', function () {
+            PosixAlphaString::fromString('hello!world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+
+        it('rejects strings with whitespace', function () {
+            PosixAlphaString::fromString('hello world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+
+        it('rejects strings with hyphens', function () {
+            PosixAlphaString::fromString('hello-world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+
+        it('rejects strings with underscores', function () {
+            PosixAlphaString::fromString('hello_world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+
+        it('rejects empty strings', function () {
+            PosixAlphaString::fromString('');
+        })->throws(\InvalidArgumentException::class, 'String must not be empty');
+
+        it('rejects strings with special characters', function () {
+            PosixAlphaString::fromString('hello@world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX alphabetic characters');
+    });
+
+    describe('International Character Support', function () {
+        it('validates German characters with locale', function () {
+            // Note: Requires locale to be set
+            // setlocale(LC_CTYPE, 'de_DE.UTF-8');
+
+            $german1 = PosixAlphaString::fromString('Müller');
+            $german2 = PosixAlphaString::fromString('Schön');
+            $german3 = PosixAlphaString::fromString('Größe');
+
+            expect($german1->value)->toBe('Müller');
+            expect($german2->value)->toBe('Schön');
+            expect($german3->value)->toBe('Größe');
+        })->skip('Requires locale configuration');
+
+        it('validates French characters with locale', function () {
+            // Note: Requires locale to be set
+            // setlocale(LC_CTYPE, 'fr_FR.UTF-8');
+
+            $french1 = PosixAlphaString::fromString('Dupré');
+            $french2 = PosixAlphaString::fromString('Château');
+            $french3 = PosixAlphaString::fromString('Garçon');
+
+            expect($french1->value)->toBe('Dupré');
+            expect($french2->value)->toBe('Château');
+            expect($french3->value)->toBe('Garçon');
+        })->skip('Requires locale configuration');
+
+        it('validates Spanish characters with locale', function () {
+            // Note: Requires locale to be set
+            // setlocale(LC_CTYPE, 'es_ES.UTF-8');
+
+            $spanish1 = PosixAlphaString::fromString('Señor');
+            $spanish2 = PosixAlphaString::fromString('Niño');
+            $spanish3 = PosixAlphaString::fromString('José');
+
+            expect($spanish1->value)->toBe('Señor');
+            expect($spanish2->value)->toBe('Niño');
+            expect($spanish3->value)->toBe('José');
+        })->skip('Requires locale configuration');
+    });
+
+    describe('Conversion Methods', function () {
+        it('converts to TypedString', function () {
+            $alpha = PosixAlphaString::fromString('Hello');
+            $typed = $alpha->toTypedString();
+
+            expect($typed)->toBeInstanceOf(TypedString::class);
+            expect($typed->value)->toBe('Hello');
+            expect($typed->isAlphabetic())->toBeTrue();
+        });
+
+        it('converts to PosixString', function () {
+            $alpha = PosixAlphaString::fromString('World');
+            $posix = $alpha->toPosixString();
+
+            expect($posix)->toBeInstanceOf(PosixString::class);
+            expect($posix->value)->toBe('World');
+            expect($posix->isAlpha())->toBeTrue();
+        });
+
+        it('converts to string', function () {
+            $alpha = PosixAlphaString::fromString('Test');
+
+            expect($alpha->toString())->toBe('Test');
+            expect((string) $alpha)->toBe('Test');
+        });
+    });
+
+    describe('Comparison Methods', function () {
+        it('checks equality', function () {
+            $alpha1 = PosixAlphaString::fromString('Hello');
+            $alpha2 = PosixAlphaString::fromString('Hello');
+            $alpha3 = PosixAlphaString::fromString('World');
+
+            expect($alpha1->equals($alpha2))->toBeTrue();
+            expect($alpha1->equals($alpha3))->toBeFalse();
+        });
+
+        it('compares case-sensitive', function () {
+            $lower = PosixAlphaString::fromString('hello');
+            $upper = PosixAlphaString::fromString('HELLO');
+
+            expect($lower->equals($upper))->toBeFalse();
+        });
+    });
+
+    describe('Real World Use Cases', function () {
+        it('validates first names', function () {
+            $firstName1 = PosixAlphaString::fromString('John');
+            $firstName2 = PosixAlphaString::fromString('Mary');
+            $firstName3 = PosixAlphaString::fromString('Alexander');
+
+            expect($firstName1->value)->toBe('John');
+            expect($firstName2->value)->toBe('Mary');
+            expect($firstName3->value)->toBe('Alexander');
+        });
+
+        it('validates last names', function () {
+            $lastName1 = PosixAlphaString::fromString('Smith');
+            $lastName2 = PosixAlphaString::fromString('Johnson');
+            $lastName3 = PosixAlphaString::fromString('Williams');
+
+            expect($lastName1->value)->toBe('Smith');
+            expect($lastName2->value)->toBe('Johnson');
+            expect($lastName3->value)->toBe('Williams');
+        });
+
+        it('rejects names with numbers', function () {
+            PosixAlphaString::fromString('John123');
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects compound names with hyphens', function () {
+            // Note: Real-world compound names like "Jean-Pierre" would need
+            // a different validation strategy or preprocessing
+            PosixAlphaString::fromString('Jean-Pierre');
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects names with titles', function () {
+            PosixAlphaString::fromString('Dr. Smith');
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('Single Character Strings', function () {
+        it('accepts single letter', function () {
+            $a = PosixAlphaString::fromString('A');
+            $z = PosixAlphaString::fromString('z');
+
+            expect($a->value)->toBe('A');
+            expect($z->value)->toBe('z');
+        });
+
+        it('rejects single digit', function () {
+            PosixAlphaString::fromString('5');
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects single special character', function () {
+            PosixAlphaString::fromString('!');
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('Edge Cases', function () {
+        it('handles very long alphabetic strings', function () {
+            $longString = str_repeat('abcdefghijklmnopqrstuvwxyz', 100);
+            $alpha = PosixAlphaString::fromString($longString);
+
+            expect($alpha->value)->toBe($longString);
+            expect(strlen($alpha->value))->toBe(2600);
+        });
+
+        it('handles mixed case correctly', function () {
+            $mixed = PosixAlphaString::fromString('AbCdEfGhIjKlMnOpQrStUvWxYz');
+
+            expect($mixed->value)->toBe('AbCdEfGhIjKlMnOpQrStUvWxYz');
+        });
+
+        it('rejects numeric-looking strings', function () {
+            PosixAlphaString::fromString('one23');
+        })->throws(\InvalidArgumentException::class);
+    });
+});
diff --git a/tests/Unit/Framework/String/ValueObjects/PosixStringTest.php b/tests/Unit/Framework/String/ValueObjects/PosixStringTest.php
new file mode 100644
index 00000000..38cbe678
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/PosixStringTest.php
@@ -0,0 +1,278 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\PosixString;
+
+describe('PosixString', function () {
+    describe('Factory Method', function () {
+        it('creates from string', function () {
+            $str = PosixString::fromString('test123');
+
+            expect($str->value)->toBe('test123');
+        });
+    });
+
+    describe('POSIX Character Class Validators', function () {
+        it('validates alnum (alphanumeric)', function () {
+            $valid = PosixString::fromString('abc123XYZ');
+            $invalid = PosixString::fromString('abc-123');
+
+            expect($valid->isAlnum())->toBeTrue();
+            expect($invalid->isAlnum())->toBeFalse();
+        });
+
+        it('validates alpha (alphabetic)', function () {
+            $valid = PosixString::fromString('abcXYZ');
+            $invalid = PosixString::fromString('abc123');
+
+            expect($valid->isAlpha())->toBeTrue();
+            expect($invalid->isAlpha())->toBeFalse();
+        });
+
+        it('validates alpha with international characters (locale-aware)', function () {
+            // Note: Locale must be set for international character support
+            // setlocale(LC_CTYPE, 'de_DE.UTF-8');
+
+            $german = PosixString::fromString('Müller');
+            $french = PosixString::fromString('Dupré');
+            $spanish = PosixString::fromString('Señor');
+
+            // These work if locale is set
+            // expect($german->isAlpha())->toBeTrue();
+            // expect($french->isAlpha())->toBeTrue();
+            // expect($spanish->isAlpha())->toBeTrue();
+        })->skip('Requires locale configuration');
+
+        it('validates ascii', function () {
+            $valid = PosixString::fromString('Hello World!');
+            $invalid = PosixString::fromString('Hëllö Wörld!');
+
+            expect($valid->isAscii())->toBeTrue();
+            expect($invalid->isAscii())->toBeFalse();
+        });
+
+        it('validates blank (space and tab only)', function () {
+            $valid = PosixString::fromString("  \t  ");
+            $invalid = PosixString::fromString("  \n  ");
+
+            expect($valid->isBlank())->toBeTrue();
+            expect($invalid->isBlank())->toBeFalse();
+        });
+
+        it('validates cntrl (control characters)', function () {
+            $valid = PosixString::fromString("\x00\x01\x02");
+            $invalid = PosixString::fromString("abc");
+
+            expect($valid->isCntrl())->toBeTrue();
+            expect($invalid->isCntrl())->toBeFalse();
+        });
+
+        it('validates digit', function () {
+            $valid = PosixString::fromString('123456');
+            $invalid = PosixString::fromString('123abc');
+
+            expect($valid->isDigit())->toBeTrue();
+            expect($invalid->isDigit())->toBeFalse();
+        });
+
+        it('validates graph (visible characters, excluding space)', function () {
+            $valid = PosixString::fromString('Hello!');
+            $invalid = PosixString::fromString('Hello World');
+
+            expect($valid->isGraph())->toBeTrue();
+            expect($invalid->isGraph())->toBeFalse();
+        });
+
+        it('validates lower (lowercase)', function () {
+            $valid = PosixString::fromString('hello');
+            $invalid = PosixString::fromString('Hello');
+
+            expect($valid->isLower())->toBeTrue();
+            expect($invalid->isLower())->toBeFalse();
+        });
+
+        it('validates print (printable, including space)', function () {
+            $valid = PosixString::fromString('Hello World!');
+            $invalid = PosixString::fromString("Hello\x00World");
+
+            expect($valid->isPrint())->toBeTrue();
+            expect($invalid->isPrint())->toBeFalse();
+        });
+
+        it('validates punct (punctuation)', function () {
+            $valid = PosixString::fromString('!@#$%^&*()');
+            $invalid = PosixString::fromString('abc!@#');
+
+            expect($valid->isPunct())->toBeTrue();
+            expect($invalid->isPunct())->toBeFalse();
+        });
+
+        it('validates space (whitespace)', function () {
+            $valid = PosixString::fromString("  \t\n\r");
+            $invalid = PosixString::fromString('abc');
+
+            expect($valid->isSpace())->toBeTrue();
+            expect($invalid->isSpace())->toBeFalse();
+        });
+
+        it('validates upper (uppercase)', function () {
+            $valid = PosixString::fromString('HELLO');
+            $invalid = PosixString::fromString('Hello');
+
+            expect($valid->isUpper())->toBeTrue();
+            expect($invalid->isUpper())->toBeFalse();
+        });
+
+        it('validates xdigit (hexadecimal)', function () {
+            $valid = PosixString::fromString('0123456789abcdefABCDEF');
+            $invalid = PosixString::fromString('0123xyz');
+
+            expect($valid->isXdigit())->toBeTrue();
+            expect($invalid->isXdigit())->toBeFalse();
+        });
+
+        it('validates word (alphanumeric + underscore)', function () {
+            $valid = PosixString::fromString('user_name123');
+            $invalid = PosixString::fromString('user-name');
+
+            expect($valid->isWord())->toBeTrue();
+            expect($invalid->isWord())->toBeFalse();
+        });
+    });
+
+    describe('Helper Methods', function () {
+        it('checks if string contains POSIX class characters', function () {
+            $str = PosixString::fromString('hello123world');
+
+            expect($str->containsPosixClass('alpha'))->toBeTrue();
+            expect($str->containsPosixClass('digit'))->toBeTrue();
+            expect($str->containsPosixClass('punct'))->toBeFalse();
+        });
+
+        it('counts POSIX class characters', function () {
+            $str = PosixString::fromString('abc123xyz789');
+
+            expect($str->countPosixClass('alpha'))->toBe(6);
+            expect($str->countPosixClass('digit'))->toBe(6);
+            expect($str->countPosixClass('punct'))->toBe(0);
+        });
+
+        it('filters by POSIX class', function () {
+            $str = PosixString::fromString('abc123xyz');
+
+            $alphaOnly = $str->filterByPosixClass('alpha');
+            $digitOnly = $str->filterByPosixClass('digit');
+
+            expect($alphaOnly->value)->toBe('abcxyz');
+            expect($digitOnly->value)->toBe('123');
+        });
+    });
+
+    describe('Conversion Methods', function () {
+        it('converts to TypedString', function () {
+            $posix = PosixString::fromString('test');
+            $typed = $posix->toTypedString();
+
+            expect($typed->value)->toBe('test');
+            expect($typed->isAlphabetic())->toBeTrue();
+        });
+
+        it('converts to string', function () {
+            $str = PosixString::fromString('hello');
+
+            expect($str->toString())->toBe('hello');
+            expect((string) $str)->toBe('hello');
+        });
+    });
+
+    describe('Comparison Methods', function () {
+        it('checks equality', function () {
+            $str1 = PosixString::fromString('test');
+            $str2 = PosixString::fromString('test');
+            $str3 = PosixString::fromString('other');
+
+            expect($str1->equals($str2))->toBeTrue();
+            expect($str1->equals($str3))->toBeFalse();
+        });
+
+        it('checks if empty', function () {
+            $empty = PosixString::fromString('');
+            $notEmpty = PosixString::fromString('test');
+
+            expect($empty->isEmpty())->toBeTrue();
+            expect($notEmpty->isEmpty())->toBeFalse();
+        });
+
+        it('checks if not empty', function () {
+            $empty = PosixString::fromString('');
+            $notEmpty = PosixString::fromString('test');
+
+            expect($empty->isNotEmpty())->toBeFalse();
+            expect($notEmpty->isNotEmpty())->toBeTrue();
+        });
+    });
+
+    describe('Edge Cases', function () {
+        it('handles empty string validation', function () {
+            $empty = PosixString::fromString('');
+
+            expect($empty->isAlpha())->toBeFalse();
+            expect($empty->isAlnum())->toBeFalse();
+            expect($empty->isDigit())->toBeFalse();
+        });
+
+        it('handles single character validation', function () {
+            $alpha = PosixString::fromString('a');
+            $digit = PosixString::fromString('5');
+            $punct = PosixString::fromString('!');
+
+            expect($alpha->isAlpha())->toBeTrue();
+            expect($digit->isDigit())->toBeTrue();
+            expect($punct->isPunct())->toBeTrue();
+        });
+
+        it('handles mixed character sets', function () {
+            $mixed = PosixString::fromString('abc123!@#');
+
+            expect($mixed->isAlnum())->toBeFalse(); // Contains punctuation
+            expect($mixed->containsPosixClass('alpha'))->toBeTrue();
+            expect($mixed->containsPosixClass('digit'))->toBeTrue();
+            expect($mixed->containsPosixClass('punct'))->toBeTrue();
+        });
+    });
+
+    describe('Real World Use Cases', function () {
+        it('validates usernames', function () {
+            $validUsername = PosixString::fromString('john_doe_123');
+            $invalidUsername = PosixString::fromString('john-doe@example');
+
+            expect($validUsername->isWord())->toBeTrue();
+            expect($invalidUsername->isWord())->toBeFalse();
+        });
+
+        it('validates identifiers', function () {
+            $validId = PosixString::fromString('MAX_TIMEOUT_VALUE');
+            $invalidId = PosixString::fromString('max-timeout-value');
+
+            expect($validId->isWord())->toBeTrue();
+            expect($invalidId->isWord())->toBeFalse();
+        });
+
+        it('validates hexadecimal color codes', function () {
+            $validColor = PosixString::fromString('FF5733');
+            $invalidColor = PosixString::fromString('GG5733');
+
+            expect($validColor->isXdigit())->toBeTrue();
+            expect($invalidColor->isXdigit())->toBeFalse();
+        });
+
+        it('validates numeric strings', function () {
+            $validNum = PosixString::fromString('123456');
+            $invalidNum = PosixString::fromString('12.34');
+
+            expect($validNum->isDigit())->toBeTrue();
+            expect($invalidNum->isDigit())->toBeFalse();
+        });
+    });
+});
diff --git a/tests/Unit/Framework/String/ValueObjects/PosixWordStringTest.php b/tests/Unit/Framework/String/ValueObjects/PosixWordStringTest.php
new file mode 100644
index 00000000..52164825
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/PosixWordStringTest.php
@@ -0,0 +1,296 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\PosixWordString;
+use App\Framework\String\ValueObjects\TypedString;
+use App\Framework\String\ValueObjects\PosixString;
+
+describe('PosixWordString', function () {
+    describe('Validation', function () {
+        it('accepts valid word strings', function () {
+            $word1 = PosixWordString::fromString('hello');
+            $word2 = PosixWordString::fromString('Hello123');
+            $word3 = PosixWordString::fromString('user_name');
+            $word4 = PosixWordString::fromString('MAX_VALUE');
+            $word5 = PosixWordString::fromString('_private');
+
+            expect($word1->value)->toBe('hello');
+            expect($word2->value)->toBe('Hello123');
+            expect($word3->value)->toBe('user_name');
+            expect($word4->value)->toBe('MAX_VALUE');
+            expect($word5->value)->toBe('_private');
+        });
+
+        it('rejects strings with hyphens', function () {
+            PosixWordString::fromString('user-name');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects strings with spaces', function () {
+            PosixWordString::fromString('hello world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects strings with special characters', function () {
+            PosixWordString::fromString('hello@world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects strings with punctuation', function () {
+            PosixWordString::fromString('hello.world');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects strings with operators', function () {
+            PosixWordString::fromString('a+b');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects empty strings', function () {
+            PosixWordString::fromString('');
+        })->throws(\InvalidArgumentException::class, 'String must not be empty');
+
+        it('rejects strings with parentheses', function () {
+            PosixWordString::fromString('function()');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+
+        it('rejects strings with brackets', function () {
+            PosixWordString::fromString('array[0]');
+        })->throws(\InvalidArgumentException::class, 'String must contain only POSIX word characters');
+    });
+
+    describe('Conversion Methods', function () {
+        it('converts to TypedString', function () {
+            $word = PosixWordString::fromString('user_id');
+            $typed = $word->toTypedString();
+
+            expect($typed)->toBeInstanceOf(TypedString::class);
+            expect($typed->value)->toBe('user_id');
+            expect($typed->isAlphanumeric())->toBeFalse(); // Contains underscore
+        });
+
+        it('converts to PosixString', function () {
+            $word = PosixWordString::fromString('MAX_VALUE');
+            $posix = $word->toPosixString();
+
+            expect($posix)->toBeInstanceOf(PosixString::class);
+            expect($posix->value)->toBe('MAX_VALUE');
+            expect($posix->isWord())->toBeTrue();
+        });
+
+        it('converts to string', function () {
+            $word = PosixWordString::fromString('username');
+
+            expect($word->toString())->toBe('username');
+            expect((string) $word)->toBe('username');
+        });
+    });
+
+    describe('Comparison Methods', function () {
+        it('checks equality', function () {
+            $word1 = PosixWordString::fromString('user_id');
+            $word2 = PosixWordString::fromString('user_id');
+            $word3 = PosixWordString::fromString('user_name');
+
+            expect($word1->equals($word2))->toBeTrue();
+            expect($word1->equals($word3))->toBeFalse();
+        });
+
+        it('compares case-sensitive', function () {
+            $lower = PosixWordString::fromString('username');
+            $upper = PosixWordString::fromString('USERNAME');
+
+            expect($lower->equals($upper))->toBeFalse();
+        });
+    });
+
+    describe('Real World Use Cases', function () {
+        describe('PHP Identifiers', function () {
+            it('validates variable names', function () {
+                $var1 = PosixWordString::fromString('userName');
+                $var2 = PosixWordString::fromString('user_id');
+                $var3 = PosixWordString::fromString('_privateVar');
+
+                expect($var1->value)->toBe('userName');
+                expect($var2->value)->toBe('user_id');
+                expect($var3->value)->toBe('_privateVar');
+            });
+
+            it('validates constant names', function () {
+                $const1 = PosixWordString::fromString('MAX_SIZE');
+                $const2 = PosixWordString::fromString('API_KEY');
+                $const3 = PosixWordString::fromString('DEFAULT_TIMEOUT');
+
+                expect($const1->value)->toBe('MAX_SIZE');
+                expect($const2->value)->toBe('API_KEY');
+                expect($const3->value)->toBe('DEFAULT_TIMEOUT');
+            });
+
+            it('validates function names', function () {
+                $func1 = PosixWordString::fromString('calculateTotal');
+                $func2 = PosixWordString::fromString('get_user_by_id');
+                $func3 = PosixWordString::fromString('__construct');
+
+                expect($func1->value)->toBe('calculateTotal');
+                expect($func2->value)->toBe('get_user_by_id');
+                expect($func3->value)->toBe('__construct');
+            });
+
+            it('rejects invalid PHP identifiers', function () {
+                PosixWordString::fromString('my-function');
+            })->throws(\InvalidArgumentException::class);
+        });
+
+        describe('Database Column Names', function () {
+            it('validates snake_case column names', function () {
+                $col1 = PosixWordString::fromString('user_id');
+                $col2 = PosixWordString::fromString('created_at');
+                $col3 = PosixWordString::fromString('email_verified_at');
+
+                expect($col1->value)->toBe('user_id');
+                expect($col2->value)->toBe('created_at');
+                expect($col3->value)->toBe('email_verified_at');
+            });
+
+            it('rejects kebab-case column names', function () {
+                PosixWordString::fromString('user-id');
+            })->throws(\InvalidArgumentException::class);
+        });
+
+        describe('Usernames', function () {
+            it('validates valid usernames', function () {
+                $user1 = PosixWordString::fromString('john_doe');
+                $user2 = PosixWordString::fromString('user123');
+                $user3 = PosixWordString::fromString('admin_user');
+
+                expect($user1->value)->toBe('john_doe');
+                expect($user2->value)->toBe('user123');
+                expect($user3->value)->toBe('admin_user');
+            });
+
+            it('rejects usernames with special characters', function () {
+                PosixWordString::fromString('john@doe');
+            })->throws(\InvalidArgumentException::class);
+
+            it('rejects usernames with hyphens', function () {
+                PosixWordString::fromString('john-doe');
+            })->throws(\InvalidArgumentException::class);
+
+            it('rejects usernames with spaces', function () {
+                PosixWordString::fromString('john doe');
+            })->throws(\InvalidArgumentException::class);
+        });
+
+        describe('URL Slugs (with underscore)', function () {
+            it('validates underscore slugs', function () {
+                $slug1 = PosixWordString::fromString('my_blog_post');
+                $slug2 = PosixWordString::fromString('product_category_1');
+                $slug3 = PosixWordString::fromString('about_us');
+
+                expect($slug1->value)->toBe('my_blog_post');
+                expect($slug2->value)->toBe('product_category_1');
+                expect($slug3->value)->toBe('about_us');
+            });
+
+            it('rejects hyphenated slugs', function () {
+                // Note: Hyphenated slugs need different validation
+                PosixWordString::fromString('my-blog-post');
+            })->throws(\InvalidArgumentException::class);
+        });
+    });
+
+    describe('Single Character Strings', function () {
+        it('accepts single letter', function () {
+            $a = PosixWordString::fromString('a');
+            $Z = PosixWordString::fromString('Z');
+
+            expect($a->value)->toBe('a');
+            expect($Z->value)->toBe('Z');
+        });
+
+        it('accepts single digit', function () {
+            $five = PosixWordString::fromString('5');
+
+            expect($five->value)->toBe('5');
+        });
+
+        it('accepts single underscore', function () {
+            $underscore = PosixWordString::fromString('_');
+
+            expect($underscore->value)->toBe('_');
+        });
+
+        it('rejects single special character', function () {
+            PosixWordString::fromString('!');
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects single hyphen', function () {
+            PosixWordString::fromString('-');
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('Edge Cases', function () {
+        it('handles very long word strings', function () {
+            $longString = str_repeat('abc123_', 100);
+            $word = PosixWordString::fromString($longString);
+
+            expect($word->value)->toBe($longString);
+            expect(strlen($word->value))->toBe(700);
+        });
+
+        it('handles mixed case correctly', function () {
+            $mixed = PosixWordString::fromString('CamelCase_With_Underscore123');
+
+            expect($mixed->value)->toBe('CamelCase_With_Underscore123');
+        });
+
+        it('accepts strings starting with underscore', function () {
+            $leading = PosixWordString::fromString('_privateMethod');
+
+            expect($leading->value)->toBe('_privateMethod');
+        });
+
+        it('accepts strings starting with digit', function () {
+            // Note: Valid for word class, but not valid PHP identifiers
+            $digit = PosixWordString::fromString('123abc');
+
+            expect($digit->value)->toBe('123abc');
+        });
+
+        it('accepts strings with only digits', function () {
+            $digits = PosixWordString::fromString('123456');
+
+            expect($digits->value)->toBe('123456');
+        });
+
+        it('accepts strings with only underscores', function () {
+            $underscores = PosixWordString::fromString('___');
+
+            expect($underscores->value)->toBe('___');
+        });
+    });
+
+    describe('Boundary Cases', function () {
+        it('handles maximum practical length', function () {
+            // 255 characters - typical database VARCHAR limit
+            $longIdentifier = str_repeat('a', 255);
+            $word = PosixWordString::fromString($longIdentifier);
+
+            expect(strlen($word->value))->toBe(255);
+        });
+
+        it('handles alphanumeric only', function () {
+            $alnum = PosixWordString::fromString('abc123XYZ789');
+
+            expect($alnum->value)->toBe('abc123XYZ789');
+        });
+
+        it('handles underscores only', function () {
+            $underscores = PosixWordString::fromString('_____');
+
+            expect($underscores->value)->toBe('_____');
+        });
+
+        it('handles mixed content', function () {
+            $mixed = PosixWordString::fromString('a1_B2_c3_D4');
+
+            expect($mixed->value)->toBe('a1_B2_c3_D4');
+        });
+    });
+});
diff --git a/tests/Unit/Framework/String/ValueObjects/SpecializedStringVOsTest.php b/tests/Unit/Framework/String/ValueObjects/SpecializedStringVOsTest.php
new file mode 100644
index 00000000..5e55463d
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/SpecializedStringVOsTest.php
@@ -0,0 +1,170 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\{
+    AlphanumericString,
+    NumericString,
+    HexadecimalString,
+    PrintableString
+};
+
+describe('AlphanumericString', function () {
+    it('creates from valid alphanumeric string', function () {
+        $str = AlphanumericString::fromString('abc123');
+
+        expect($str->value)->toBe('abc123');
+    });
+
+    it('rejects non-alphanumeric strings', function () {
+        AlphanumericString::fromString('abc-123');
+    })->throws(InvalidArgumentException::class, 'alphanumeric');
+
+    it('rejects empty strings', function () {
+        AlphanumericString::fromString('');
+    })->throws(InvalidArgumentException::class);
+
+    it('converts to TypedString', function () {
+        $str = AlphanumericString::fromString('test123');
+        $typed = $str->toTypedString();
+
+        expect($typed->value)->toBe('test123');
+        expect($typed->isAlphanumeric())->toBeTrue();
+    });
+
+    it('checks equality', function () {
+        $str1 = AlphanumericString::fromString('abc123');
+        $str2 = AlphanumericString::fromString('abc123');
+        $str3 = AlphanumericString::fromString('xyz789');
+
+        expect($str1->equals($str2))->toBeTrue();
+        expect($str1->equals($str3))->toBeFalse();
+    });
+
+    it('converts to string', function () {
+        $str = AlphanumericString::fromString('test123');
+
+        expect((string) $str)->toBe('test123');
+    });
+});
+
+describe('NumericString', function () {
+    it('creates from valid numeric string', function () {
+        $str = NumericString::fromString('12345');
+
+        expect($str->value)->toBe('12345');
+    });
+
+    it('rejects non-numeric strings', function () {
+        NumericString::fromString('12.34');
+    })->throws(InvalidArgumentException::class, 'digits');
+
+    it('rejects alphanumeric strings', function () {
+        NumericString::fromString('123abc');
+    })->throws(InvalidArgumentException::class);
+
+    it('rejects empty strings', function () {
+        NumericString::fromString('');
+    })->throws(InvalidArgumentException::class);
+
+    it('converts to integer', function () {
+        $str = NumericString::fromString('12345');
+
+        expect($str->toInt())->toBe(12345);
+    });
+
+    it('converts to float', function () {
+        $str = NumericString::fromString('12345');
+
+        expect($str->toFloat())->toBe(12345.0);
+    });
+
+    it('handles large numbers', function () {
+        $str = NumericString::fromString('999999999');
+
+        expect($str->toInt())->toBe(999999999);
+    });
+});
+
+describe('HexadecimalString', function () {
+    it('creates from valid hexadecimal string', function () {
+        $str = HexadecimalString::fromString('deadbeef');
+
+        expect($str->value)->toBe('deadbeef');
+    });
+
+    it('accepts uppercase hexadecimal', function () {
+        $str = HexadecimalString::fromString('DEADBEEF');
+
+        expect($str->value)->toBe('DEADBEEF');
+    });
+
+    it('accepts mixed case hexadecimal', function () {
+        $str = HexadecimalString::fromString('DeAdBeEf');
+
+        expect($str->value)->toBe('DeAdBeEf');
+    });
+
+    it('rejects non-hexadecimal strings', function () {
+        HexadecimalString::fromString('ghijk');
+    })->throws(InvalidArgumentException::class, 'hexadecimal');
+
+    it('rejects empty strings', function () {
+        HexadecimalString::fromString('');
+    })->throws(InvalidArgumentException::class);
+
+    it('converts to binary', function () {
+        $str = HexadecimalString::fromString('48656c6c6f'); // "Hello"
+        $binary = $str->toBinary();
+
+        expect($binary)->toBe('Hello');
+    });
+
+    it('converts to integer', function () {
+        $str = HexadecimalString::fromString('ff');
+
+        expect($str->toInt())->toBe(255);
+    });
+
+    it('handles long hexadecimal strings', function () {
+        $str = HexadecimalString::fromString('0123456789abcdef');
+
+        expect($str->toInt())->toBe(81985529216486895);
+    });
+});
+
+describe('PrintableString', function () {
+    it('creates from valid printable string', function () {
+        $str = PrintableString::fromString('Hello World!');
+
+        expect($str->value)->toBe('Hello World!');
+    });
+
+    it('accepts strings with whitespace', function () {
+        $str = PrintableString::fromString("Hello\nWorld\tTest");
+
+        expect($str->value)->toContain('Hello');
+    });
+
+    it('rejects strings with control characters', function () {
+        PrintableString::fromString("Hello\x00World");
+    })->throws(InvalidArgumentException::class, 'printable');
+
+    it('rejects empty strings', function () {
+        PrintableString::fromString('');
+    })->throws(InvalidArgumentException::class);
+
+    it('accepts special characters', function () {
+        $str = PrintableString::fromString('!@#$%^&*()_+-=[]{}|;:,.<>?');
+
+        expect($str->value)->toContain('!@#$');
+    });
+
+    it('converts to TypedString', function () {
+        $str = PrintableString::fromString('Test String');
+        $typed = $str->toTypedString();
+
+        expect($typed->value)->toBe('Test String');
+        expect($typed->isPrintable())->toBeTrue();
+    });
+});
diff --git a/tests/Unit/Framework/String/ValueObjects/TypedStringTest.php b/tests/Unit/Framework/String/ValueObjects/TypedStringTest.php
new file mode 100644
index 00000000..842caed0
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/TypedStringTest.php
@@ -0,0 +1,170 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\TypedString;
+
+describe('TypedString - Character Type Checks', function () {
+    it('validates alphanumeric strings', function () {
+        expect(TypedString::fromString('abc123')->isAlphanumeric())->toBeTrue();
+        expect(TypedString::fromString('ABC123')->isAlphanumeric())->toBeTrue();
+        expect(TypedString::fromString('abc-123')->isAlphanumeric())->toBeFalse();
+        expect(TypedString::fromString('')->isAlphanumeric())->toBeFalse();
+    });
+
+    it('validates alphabetic strings', function () {
+        expect(TypedString::fromString('abcABC')->isAlphabetic())->toBeTrue();
+        expect(TypedString::fromString('abc123')->isAlphabetic())->toBeFalse();
+        expect(TypedString::fromString('')->isAlphabetic())->toBeFalse();
+    });
+
+    it('validates digit strings', function () {
+        expect(TypedString::fromString('123456')->isDigits())->toBeTrue();
+        expect(TypedString::fromString('12.34')->isDigits())->toBeFalse();
+        expect(TypedString::fromString('abc')->isDigits())->toBeFalse();
+        expect(TypedString::fromString('')->isDigits())->toBeFalse();
+    });
+
+    it('validates lowercase strings', function () {
+        expect(TypedString::fromString('abc')->isLowercase())->toBeTrue();
+        expect(TypedString::fromString('Abc')->isLowercase())->toBeFalse();
+        expect(TypedString::fromString('')->isLowercase())->toBeFalse();
+    });
+
+    it('validates uppercase strings', function () {
+        expect(TypedString::fromString('ABC')->isUppercase())->toBeTrue();
+        expect(TypedString::fromString('Abc')->isUppercase())->toBeFalse();
+        expect(TypedString::fromString('')->isUppercase())->toBeFalse();
+    });
+
+    it('validates hexadecimal strings', function () {
+        expect(TypedString::fromString('deadbeef')->isHexadecimal())->toBeTrue();
+        expect(TypedString::fromString('DEADBEEF')->isHexadecimal())->toBeTrue();
+        expect(TypedString::fromString('0123456789abcdef')->isHexadecimal())->toBeTrue();
+        expect(TypedString::fromString('ghijk')->isHexadecimal())->toBeFalse();
+        expect(TypedString::fromString('')->isHexadecimal())->toBeFalse();
+    });
+
+    it('validates whitespace strings', function () {
+        expect(TypedString::fromString(' ')->isWhitespace())->toBeTrue();
+        expect(TypedString::fromString("\t\n")->isWhitespace())->toBeTrue();
+        expect(TypedString::fromString('abc')->isWhitespace())->toBeFalse();
+        expect(TypedString::fromString('')->isWhitespace())->toBeFalse();
+    });
+
+    it('validates printable strings', function () {
+        expect(TypedString::fromString('Hello World')->isPrintable())->toBeTrue();
+        expect(TypedString::fromString("Hello\x00World")->isPrintable())->toBeFalse();
+        expect(TypedString::fromString('')->isPrintable())->toBeFalse();
+    });
+
+    it('validates visible strings', function () {
+        expect(TypedString::fromString('abc123')->isVisible())->toBeTrue();
+        expect(TypedString::fromString('abc 123')->isVisible())->toBeFalse();
+        expect(TypedString::fromString('')->isVisible())->toBeFalse();
+    });
+});
+
+describe('TypedString - Length Checks', function () {
+    it('checks if string is empty', function () {
+        expect(TypedString::fromString('')->isEmpty())->toBeTrue();
+        expect(TypedString::fromString('abc')->isEmpty())->toBeFalse();
+    });
+
+    it('checks if string is not empty', function () {
+        expect(TypedString::fromString('abc')->isNotEmpty())->toBeTrue();
+        expect(TypedString::fromString('')->isNotEmpty())->toBeFalse();
+    });
+
+    it('returns string length', function () {
+        expect(TypedString::fromString('abc')->length())->toBe(3);
+        expect(TypedString::fromString('')->length())->toBe(0);
+        expect(TypedString::fromString('hello world')->length())->toBe(11);
+    });
+
+    it('checks minimum length', function () {
+        $str = TypedString::fromString('hello');
+
+        expect($str->hasMinLength(3))->toBeTrue();
+        expect($str->hasMinLength(5))->toBeTrue();
+        expect($str->hasMinLength(6))->toBeFalse();
+    });
+
+    it('checks maximum length', function () {
+        $str = TypedString::fromString('hello');
+
+        expect($str->hasMaxLength(10))->toBeTrue();
+        expect($str->hasMaxLength(5))->toBeTrue();
+        expect($str->hasMaxLength(4))->toBeFalse();
+    });
+
+    it('checks length range', function () {
+        $str = TypedString::fromString('hello');
+
+        expect($str->hasLengthBetween(3, 10))->toBeTrue();
+        expect($str->hasLengthBetween(5, 5))->toBeTrue();
+        expect($str->hasLengthBetween(6, 10))->toBeFalse();
+        expect($str->hasLengthBetween(1, 4))->toBeFalse();
+    });
+
+    it('checks exact length', function () {
+        $str = TypedString::fromString('hello');
+
+        expect($str->hasExactLength(5))->toBeTrue();
+        expect($str->hasExactLength(4))->toBeFalse();
+        expect($str->hasExactLength(6))->toBeFalse();
+    });
+});
+
+describe('TypedString - Pattern Matching', function () {
+    it('matches regular expressions', function () {
+        $str = TypedString::fromString('hello123');
+
+        expect($str->matches('/^hello/'))->toBeTrue();
+        expect($str->matches('/\d+$/'))->toBeTrue();
+        expect($str->matches('/^goodbye/'))->toBeFalse();
+    });
+
+    it('checks if starts with prefix', function () {
+        $str = TypedString::fromString('hello world');
+
+        expect($str->startsWith('hello'))->toBeTrue();
+        expect($str->startsWith('h'))->toBeTrue();
+        expect($str->startsWith('world'))->toBeFalse();
+    });
+
+    it('checks if ends with suffix', function () {
+        $str = TypedString::fromString('hello world');
+
+        expect($str->endsWith('world'))->toBeTrue();
+        expect($str->endsWith('d'))->toBeTrue();
+        expect($str->endsWith('hello'))->toBeFalse();
+    });
+
+    it('checks if contains substring', function () {
+        $str = TypedString::fromString('hello world');
+
+        expect($str->contains('hello'))->toBeTrue();
+        expect($str->contains('world'))->toBeTrue();
+        expect($str->contains('lo wo'))->toBeTrue();
+        expect($str->contains('goodbye'))->toBeFalse();
+    });
+});
+
+describe('TypedString - Comparison & Conversion', function () {
+    it('checks equality', function () {
+        $str1 = TypedString::fromString('hello');
+        $str2 = TypedString::fromString('hello');
+        $str3 = TypedString::fromString('world');
+
+        expect($str1->equals($str2))->toBeTrue();
+        expect($str1->equals($str3))->toBeFalse();
+    });
+
+    it('converts to string', function () {
+        $str = TypedString::fromString('hello');
+
+        expect($str->toString())->toBe('hello');
+        expect((string) $str)->toBe('hello');
+    });
+});
diff --git a/tests/Unit/Framework/String/ValueObjects/TypedStringValidatorTest.php b/tests/Unit/Framework/String/ValueObjects/TypedStringValidatorTest.php
new file mode 100644
index 00000000..a23ec812
--- /dev/null
+++ b/tests/Unit/Framework/String/ValueObjects/TypedStringValidatorTest.php
@@ -0,0 +1,440 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Framework\String\ValueObjects\TypedString;
+
+describe('TypedStringValidator - Fluent API', function () {
+    it('validates alphanumeric with fluent interface', function () {
+        $result = TypedString::fromString('abc123')
+            ->validate()
+            ->alphanumeric()
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+        expect($result->value)->toBe('abc123');
+    });
+
+    it('rejects non-alphanumeric strings', function () {
+        $result = TypedString::fromString('abc-123')
+            ->validate()
+            ->alphanumeric()
+            ->orNull();
+
+        expect($result)->toBeNull();
+    });
+
+    it('validates length constraints', function () {
+        $result = TypedString::fromString('hello')
+            ->validate()
+            ->minLength(3)
+            ->maxLength(10)
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+    });
+
+    it('rejects strings below minimum length', function () {
+        $result = TypedString::fromString('ab')
+            ->validate()
+            ->minLength(5)
+            ->orNull();
+
+        expect($result)->toBeNull();
+    });
+
+    it('rejects strings above maximum length', function () {
+        $result = TypedString::fromString('hello world')
+            ->validate()
+            ->maxLength(5)
+            ->orNull();
+
+        expect($result)->toBeNull();
+    });
+});
+
+describe('TypedStringValidator - Complex Chains', function () {
+    it('validates complex username format', function () {
+        $username = TypedString::fromString('user123')
+            ->validate()
+            ->alphanumeric()
+            ->minLength(3)
+            ->maxLength(20)
+            ->orThrow('Invalid username');
+
+        expect($username->value)->toBe('user123');
+    });
+
+    it('validates password with custom rules', function () {
+        $password = TypedString::fromString('Pass123!')
+            ->validate()
+            ->minLength(8)
+            ->custom(
+                fn($ts) => preg_match('/[A-Z]/', $ts->value) === 1,
+                'Must contain uppercase letter'
+            )
+            ->custom(
+                fn($ts) => preg_match('/[0-9]/', $ts->value) === 1,
+                'Must contain digit'
+            )
+            ->orThrow();
+
+        expect($password->value)->toBe('Pass123!');
+    });
+
+    it('throws on invalid password', function () {
+        TypedString::fromString('weak')
+            ->validate()
+            ->minLength(8)
+            ->orThrow('Password too weak');
+    })->throws(InvalidArgumentException::class, 'Password too weak');
+});
+
+describe('TypedStringValidator - Error Handling', function () {
+    it('collects multiple validation errors', function () {
+        $validator = TypedString::fromString('ab')
+            ->validate()
+            ->alphanumeric()
+            ->minLength(5);
+
+        expect($validator->fails())->toBeTrue();
+
+        $errors = $validator->getErrors();
+        expect($errors)->toHaveCount(1);
+        expect($errors[0])->toContain('at least 5 characters');
+    });
+
+    it('returns first error message', function () {
+        $validator = TypedString::fromString('ab')
+            ->validate()
+            ->minLength(5)
+            ->maxLength(3);
+
+        $firstError = $validator->getFirstError();
+        expect($firstError)->toContain('at least 5 characters');
+    });
+
+    it('returns custom error messages', function () {
+        $validator = TypedString::fromString('abc-123')
+            ->validate()
+            ->alphanumeric('Username must be alphanumeric');
+
+        expect($validator->fails())->toBeTrue();
+        expect($validator->getFirstError())->toBe('Username must be alphanumeric');
+    });
+});
+
+describe('TypedStringValidator - Pattern Validators', function () {
+    it('validates regex patterns', function () {
+        $email = TypedString::fromString('test@example.com')
+            ->validate()
+            ->matches('/^[\w\.\-]+@[\w\.\-]+\.\w+$/', 'Invalid email format')
+            ->orThrow();
+
+        expect($email->value)->toBe('test@example.com');
+    });
+
+    it('validates start with prefix', function () {
+        $result = TypedString::fromString('user_123')
+            ->validate()
+            ->startsWith('user_')
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+    });
+
+    it('validates end with suffix', function () {
+        $result = TypedString::fromString('file.txt')
+            ->validate()
+            ->endsWith('.txt')
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+    });
+
+    it('validates contains substring', function () {
+        $result = TypedString::fromString('hello_world')
+            ->validate()
+            ->contains('_')
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+    });
+
+    it('validates does not contain substring', function () {
+        $result = TypedString::fromString('helloworld')
+            ->validate()
+            ->doesNotContain(' ')
+            ->orNull();
+
+        expect($result)->not->toBeNull();
+    });
+});
+
+describe('TypedStringValidator - Termination Methods', function () {
+    it('throws exception on validation failure', function () {
+        TypedString::fromString('invalid')
+            ->validate()
+            ->digits()
+            ->orThrow('Must be numeric');
+    })->throws(InvalidArgumentException::class, 'Must be numeric');
+
+    it('returns null on validation failure', function () {
+        $result = TypedString::fromString('invalid')
+            ->validate()
+            ->digits()
+            ->orNull();
+
+        expect($result)->toBeNull();
+    });
+
+    it('returns default value on validation failure', function () {
+        $result = TypedString::fromString('invalid')
+            ->validate()
+            ->digits()
+            ->orDefault('123');
+
+        expect($result->value)->toBe('123');
+    });
+
+    it('passes validation and returns original value', function () {
+        $result = TypedString::fromString('valid123')
+            ->validate()
+            ->alphanumeric()
+            ->orDefault('fallback');
+
+        expect($result->value)->toBe('valid123');
+    });
+});
+
+describe('TypedStringValidator - POSIX Validators', function () {
+    describe('posixAlnum', function () {
+        it('validates alphanumeric POSIX strings', function () {
+            $result = TypedString::fromString('abc123XYZ')
+                ->validate()
+                ->posixAlnum()
+                ->orThrow();
+
+            expect($result->value)->toBe('abc123XYZ');
+        });
+
+        it('rejects strings with non-alphanumeric characters', function () {
+            TypedString::fromString('abc-123')
+                ->validate()
+                ->posixAlnum()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('works in validation chain', function () {
+            $result = TypedString::fromString('test123')
+                ->validate()
+                ->notEmpty()
+                ->posixAlnum()
+                ->minLength(5)
+                ->orThrow();
+
+            expect($result->value)->toBe('test123');
+        });
+    });
+
+    describe('posixAlpha', function () {
+        it('validates alphabetic POSIX strings', function () {
+            $result = TypedString::fromString('abcXYZ')
+                ->validate()
+                ->posixAlpha()
+                ->orThrow();
+
+            expect($result->value)->toBe('abcXYZ');
+        });
+
+        it('rejects strings with digits', function () {
+            TypedString::fromString('abc123')
+                ->validate()
+                ->posixAlpha()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects strings with special characters', function () {
+            TypedString::fromString('hello-world')
+                ->validate()
+                ->posixAlpha()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('posixPunct', function () {
+        it('validates punctuation POSIX strings', function () {
+            $result = TypedString::fromString('!@#$%^&*()')
+                ->validate()
+                ->posixPunct()
+                ->orThrow();
+
+            expect($result->value)->toBe('!@#$%^&*()');
+        });
+
+        it('rejects strings with alphanumeric characters', function () {
+            TypedString::fromString('abc!@#')
+                ->validate()
+                ->posixPunct()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('posixWord', function () {
+        it('validates word POSIX strings (alphanumeric + underscore)', function () {
+            $result = TypedString::fromString('user_name_123')
+                ->validate()
+                ->posixWord()
+                ->orThrow();
+
+            expect($result->value)->toBe('user_name_123');
+        });
+
+        it('rejects strings with hyphens', function () {
+            TypedString::fromString('user-name')
+                ->validate()
+                ->posixWord()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('validates PHP identifiers', function () {
+            $result = TypedString::fromString('_privateVar')
+                ->validate()
+                ->posixWord()
+                ->orThrow();
+
+            expect($result->value)->toBe('_privateVar');
+        });
+    });
+
+    describe('posixLower', function () {
+        it('validates lowercase POSIX strings', function () {
+            $result = TypedString::fromString('hello')
+                ->validate()
+                ->posixLower()
+                ->orThrow();
+
+            expect($result->value)->toBe('hello');
+        });
+
+        it('rejects strings with uppercase characters', function () {
+            TypedString::fromString('Hello')
+                ->validate()
+                ->posixLower()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('rejects strings with digits', function () {
+            TypedString::fromString('hello123')
+                ->validate()
+                ->posixLower()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('posixUpper', function () {
+        it('validates uppercase POSIX strings', function () {
+            $result = TypedString::fromString('HELLO')
+                ->validate()
+                ->posixUpper()
+                ->orThrow();
+
+            expect($result->value)->toBe('HELLO');
+        });
+
+        it('rejects strings with lowercase characters', function () {
+            TypedString::fromString('Hello')
+                ->validate()
+                ->posixUpper()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('validates constant naming', function () {
+            $result = TypedString::fromString('MAX_VALUE')
+                ->validate()
+                ->posixUpper()
+                ->orThrow();
+
+            expect($result->value)->toBe('MAX_VALUE');
+        });
+    });
+
+    describe('posixPrint', function () {
+        it('validates printable POSIX strings (includes space)', function () {
+            $result = TypedString::fromString('Hello World!')
+                ->validate()
+                ->posixPrint()
+                ->orThrow();
+
+            expect($result->value)->toBe('Hello World!');
+        });
+
+        it('rejects strings with control characters', function () {
+            TypedString::fromString("Hello\x00World")
+                ->validate()
+                ->posixPrint()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+    });
+
+    describe('posixGraph', function () {
+        it('validates visible POSIX strings (excludes space)', function () {
+            $result = TypedString::fromString('Hello!')
+                ->validate()
+                ->posixGraph()
+                ->orThrow();
+
+            expect($result->value)->toBe('Hello!');
+        });
+
+        it('rejects strings with spaces', function () {
+            TypedString::fromString('Hello World')
+                ->validate()
+                ->posixGraph()
+                ->orThrow();
+        })->throws(\InvalidArgumentException::class);
+
+        it('validates URLs without spaces', function () {
+            $result = TypedString::fromString('https://example.com')
+                ->validate()
+                ->posixGraph()
+                ->orThrow();
+
+            expect($result->value)->toBe('https://example.com');
+        });
+    });
+
+    describe('Complex POSIX Validation Chains', function () {
+        it('combines POSIX validators with length checks', function () {
+            $result = TypedString::fromString('user123')
+                ->validate()
+                ->posixAlnum()
+                ->minLength(5)
+                ->maxLength(20)
+                ->orThrow();
+
+            expect($result->value)->toBe('user123');
+        });
+
+        it('combines POSIX with pattern matching', function () {
+            $result = TypedString::fromString('test_value')
+                ->validate()
+                ->posixWord()
+                ->matches('/^[a-z_]+$/')
+                ->orThrow();
+
+            expect($result->value)->toBe('test_value');
+        });
+
+        it('uses POSIX validators in complex validation scenarios', function () {
+            $result = TypedString::fromString('AdminUser')
+                ->validate()
+                ->notEmpty()
+                ->posixAlpha()
+                ->minLength(5)
+                ->orDefault('Guest');
+
+            expect($result->value)->toBe('AdminUser');
+        });
+    });
+});
diff --git a/tests/debug/debug-visitclass.php b/tests/debug/debug-visitclass.php
index 3f4e8f3d..c70fb721 100644
--- a/tests/debug/debug-visitclass.php
+++ b/tests/debug/debug-visitclass.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../../vendor/autoload.php';
 
 use App\Framework\Core\ValueObjects\ClassName;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 echo "=== Debug VisitClass Method ===" . PHP_EOL;
 
diff --git a/tests/debug/test-all-initializers.php b/tests/debug/test-all-initializers.php
index 1a8d1a75..6808a3ed 100644
--- a/tests/debug/test-all-initializers.php
+++ b/tests/debug/test-all-initializers.php
@@ -14,7 +14,7 @@ use App\Framework\DI\InitializerMapper;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Discovery\ValueObjects\DiscoveryConfiguration;
 use App\Framework\Filesystem\FileSystemService;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 
 echo "=== Testing ALL Initializer Discovery ===\n\n";
diff --git a/tests/debug/test-auth-capture.php b/tests/debug/test-auth-capture.php
new file mode 100644
index 00000000..0d0d3e95
--- /dev/null
+++ b/tests/debug/test-auth-capture.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__ . '/../../vendor/autoload.php';
+
+use App\Framework\HttpClient\AuthConfig;
+use App\Framework\HttpClient\AuthType;
+use App\Framework\HttpClient\ClientOptions;
+
+// Test 1: Create AuthConfig directly
+echo "Test 1: Direct AuthConfig creation\n";
+$auth = AuthConfig::basic('testuser', 'testpass');
+var_dump($auth);
+echo "Auth type: " . ($auth->type->value ?? 'NULL') . "\n";
+echo "Auth type is null: " . (is_null($auth->type) ? 'YES' : 'NO') . "\n\n";
+
+// Test 2: Create ClientOptions with auth
+echo "Test 2: ClientOptions with auth\n";
+$options = new ClientOptions(
+    timeout: 10,
+    auth: $auth
+);
+var_dump($options->auth);
+echo "Options auth type: " . ($options->auth->type->value ?? 'NULL') . "\n";
+echo "Options auth type is null: " . (is_null($options->auth->type) ? 'YES' : 'NO') . "\n\n";
+
+// Test 3: ClientOptions with() method
+echo "Test 3: ClientOptions with() method\n";
+$baseOptions = new ClientOptions(timeout: 10);
+$newOptions = $baseOptions->with(['auth' => $auth]);
+var_dump($newOptions->auth);
+echo "New options auth type: " . ($newOptions->auth->type->value ?? 'NULL') . "\n";
+echo "New options auth type is null: " . (is_null($newOptions->auth->type) ? 'YES' : 'NO') . "\n\n";
+
+// Test 4: Check if readonly classes preserve properties
+echo "Test 4: Readonly class property preservation\n";
+$options1 = new ClientOptions(timeout: 10, auth: $auth);
+$options2 = $options1; // Assignment
+echo "Are they the same object? " . (($options1 === $options2) ? 'YES' : 'NO') . "\n";
+echo "Options1 auth type: " . ($options1->auth->type->value ?? 'NULL') . "\n";
+echo "Options2 auth type: " . ($options2->auth->type->value ?? 'NULL') . "\n";
diff --git a/tests/debug/test-context-filtering.php b/tests/debug/test-context-filtering.php
index 1cba76c3..1f288143 100644
--- a/tests/debug/test-context-filtering.php
+++ b/tests/debug/test-context-filtering.php
@@ -20,7 +20,7 @@ use App\Framework\DI\InitializerMapper;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Discovery\ValueObjects\DiscoveryConfiguration;
 use App\Framework\Filesystem\FileSystemService;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 
 echo "=== Testing Context Filtering in Web Context ===\n\n";
diff --git a/tests/debug/test-dataprovider-minimal.php b/tests/debug/test-dataprovider-minimal.php
index b0e6ba25..50635e6b 100644
--- a/tests/debug/test-dataprovider-minimal.php
+++ b/tests/debug/test-dataprovider-minimal.php
@@ -21,7 +21,7 @@ use App\Framework\Discovery\Results\InterfaceRegistry;
 use App\Framework\Discovery\ValueObjects\DiscoveredAttribute;
 use App\Framework\LiveComponents\DataProviderResolver;
 use App\Framework\LiveComponents\ValueObjects\ComponentId;
-use App\Framework\Reflection\WrappedReflectionClass;
+use App\Framework\ReflectionLegacy\WrappedReflectionClass;
 
 echo "\nMinimal DataProvider Resolution Test\n";
 echo str_repeat('=', 70) . "\n\n";
diff --git a/tests/debug/test-debug-initializer.php b/tests/debug/test-debug-initializer.php
index 00499641..386d2b4a 100644
--- a/tests/debug/test-debug-initializer.php
+++ b/tests/debug/test-debug-initializer.php
@@ -13,7 +13,7 @@ use App\Framework\DI\InitializerMapper;
 use App\Framework\Discovery\UnifiedDiscoveryService;
 use App\Framework\Discovery\ValueObjects\DiscoveryConfiguration;
 use App\Framework\Filesystem\FileSystemService;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 use Tests\Debug\DebugInitializer;
 
diff --git a/tests/debug/test-dependency-analysis.php b/tests/debug/test-dependency-analysis.php
index c33d56de..fce2637d 100644
--- a/tests/debug/test-dependency-analysis.php
+++ b/tests/debug/test-dependency-analysis.php
@@ -6,7 +6,7 @@ require_once __DIR__ . '/../../vendor/autoload.php';
 
 use App\Framework\Core\ValueObjects\ClassName;
 use App\Framework\Discovery\Analysis\DependencyAnalyzer;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 echo "=== Testing Dependency Graph Analysis System ===\n\n";
 
diff --git a/tests/debug/test-dependency-graph-api.php b/tests/debug/test-dependency-graph-api.php
index 0648829a..bc2a2b62 100644
--- a/tests/debug/test-dependency-graph-api.php
+++ b/tests/debug/test-dependency-graph-api.php
@@ -5,7 +5,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../../vendor/autoload.php';
 
 use App\Framework\DI\InitializerDependencyGraph;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 
 echo "=== Testing InitializerDependencyGraph API ===\n\n";
 
diff --git a/tests/debug/test-enhanced-error-page.php b/tests/debug/test-enhanced-error-page.php
deleted file mode 100644
index 43e21f58..00000000
--- a/tests/debug/test-enhanced-error-page.php
+++ /dev/null
@@ -1,87 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\ErrorHandling\DummyTemplateRenderer;
-use App\Framework\ErrorHandling\View\ErrorTemplateRenderer;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SystemContext;
-use App\Framework\Http\RequestId;
-use App\Framework\UserAgent\UserAgent;
-
-// Erstelle eine Test-Exception
-$testException = new \RuntimeException('Test error for enhanced debug page', 500);
-
-// Erstelle ErrorHandlerContext mit Test-Daten
-$exceptionContext = ExceptionContext::empty()
-    ->withOperation('test_operation', 'TestComponent')
-    ->withData([
-        'exception_message' => $testException->getMessage(),
-        'exception_file' => $testException->getFile(),
-        'exception_line' => $testException->getLine(),
-        'original_exception' => $testException,
-    ]);
-
-$requestContext = RequestContext::create(
-    clientIp: '127.0.0.1',
-    userAgent: UserAgent::fromString('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'),
-    requestMethod: 'GET',
-    requestUri: '/test-error',
-    hostIp: '127.0.0.1',
-    hostname: 'localhost',
-    protocol: 'HTTP/1.1',
-    port: '80',
-    requestId: new RequestId()
-);
-
-$systemContext = new SystemContext(
-    memoryUsage: '25 MB',
-    executionTime: 0.25, // 250ms
-    phpVersion: PHP_VERSION,
-    frameworkVersion: '1.0.0-dev',
-    environment: ['test_system_data' => 'value']
-);
-
-$metadata = [
-    'exception_class' => get_class($testException),
-    'error_level' => 'ERROR',
-    'http_status' => 500,
-];
-
-$errorHandlerContext = ErrorHandlerContext::create(
-    $exceptionContext,
-    $requestContext,
-    $systemContext,
-    $metadata
-);
-
-// Erstelle Template Renderer
-$templateRenderer = new DummyTemplateRenderer();
-
-// Erstelle Error Template Renderer
-$errorRenderer = new ErrorTemplateRenderer($templateRenderer);
-
-// Rendere die Enhanced Debug Page
-try {
-    $html = $errorRenderer->renderFromHandlerContext($errorHandlerContext, true);
-
-    // Speichere in temporäre Datei zum Betrachten im Browser
-    $outputFile = __DIR__ . '/../tmp/enhanced-error-page-test.html';
-    file_put_contents($outputFile, $html);
-
-    echo "✅ Enhanced Error Page erfolgreich gerendert!\n";
-    echo "📁 Gespeichert in: {$outputFile}\n";
-    echo "🌐 Öffne die Datei im Browser, um das Ergebnis zu sehen.\n";
-    echo "\nHTML Länge: " . strlen($html) . " Zeichen\n";
-
-} catch (\Throwable $e) {
-    echo "❌ Fehler beim Rendern der Enhanced Error Page:\n";
-    echo "Fehler: " . $e->getMessage() . "\n";
-    echo "Datei: " . $e->getFile() . "\n";
-    echo "Zeile: " . $e->getLine() . "\n";
-    echo "\nStack Trace:\n" . $e->getTraceAsString() . "\n";
-}
diff --git a/tests/debug/test-error-aggregator-debug-2.php b/tests/debug/test-error-aggregator-debug-2.php
deleted file mode 100644
index 8a1f1bc7..00000000
--- a/tests/debug/test-error-aggregator-debug-2.php
+++ /dev/null
@@ -1,61 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\ErrorAggregation\ErrorEvent;
-use App\Framework\DateTime\Clock;
-use App\Framework\Core\ValueObjects\Timestamp;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SystemContext;
-use App\Framework\Exception\ErrorHandlerContext;
-
-// Create test clock
-$clock = new class implements Clock {
-    public function now(): \DateTimeImmutable { return new \DateTimeImmutable(); }
-    public function fromTimestamp(Timestamp $timestamp): \DateTimeImmutable { return $timestamp->toDateTime(); }
-    public function fromString(string $dateTime, ?string $format = null): \DateTimeImmutable { return new \DateTimeImmutable($dateTime); }
-    public function today(): \DateTimeImmutable { return new \DateTimeImmutable('today'); }
-    public function yesterday(): \DateTimeImmutable { return new \DateTimeImmutable('yesterday'); }
-    public function tomorrow(): \DateTimeImmutable { return new \DateTimeImmutable('tomorrow'); }
-    public function time(): Timestamp { return Timestamp::now(); }
-};
-
-echo "Creating exception and context...\n";
-$exception = FrameworkException::create(
-    DatabaseErrorCode::QUERY_FAILED,
-    'Test database query failed'
-);
-
-$exceptionContext = ExceptionContext::empty()
-    ->withOperation('test_operation', 'TestComponent')
-    ->withData(['test_key' => 'test_value']);
-
-$requestContext = RequestContext::fromGlobals();
-$systemContext = SystemContext::current();
-
-$errorHandlerContext = ErrorHandlerContext::create(
-    $exceptionContext,
-    $requestContext,
-    $systemContext,
-    ['http_status' => 500]
-);
-
-echo "Creating ErrorEvent directly...\n";
-try {
-    $errorEvent = ErrorEvent::fromErrorHandlerContext($errorHandlerContext, $clock);
-    echo "SUCCESS: ErrorEvent created\n";
-    echo "  ID: " . $errorEvent->id->toString() . "\n";
-    echo "  Service: " . $errorEvent->service . "\n";
-    echo "  Component: " . $errorEvent->component . "\n";
-    echo "  Operation: " . $errorEvent->operation . "\n";
-    echo "  Error Message: " . $errorEvent->errorMessage . "\n";
-} catch (\Throwable $e) {
-    echo "ERROR creating ErrorEvent: " . $e->getMessage() . "\n";
-    echo "Exception class: " . get_class($e) . "\n";
-    echo "Stack trace:\n" . $e->getTraceAsString() . "\n";
-}
diff --git a/tests/debug/test-error-aggregator-debug.php b/tests/debug/test-error-aggregator-debug.php
deleted file mode 100644
index f1df2a24..00000000
--- a/tests/debug/test-error-aggregator-debug.php
+++ /dev/null
@@ -1,163 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\ErrorAggregation\ErrorAggregator;
-use App\Framework\ErrorAggregation\Storage\InMemoryErrorStorage;
-use App\Framework\Queue\InMemoryQueue;
-use App\Framework\Cache\Cache;
-use App\Framework\Cache\CacheIdentifier;
-use App\Framework\Cache\CacheItem;
-use App\Framework\Cache\CacheKey;
-use App\Framework\Cache\CacheResult;
-use App\Framework\Core\ValueObjects\Duration;
-use App\Framework\DateTime\Clock;
-use App\Framework\Core\ValueObjects\Timestamp;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SystemContext;
-use App\Framework\Exception\ErrorHandlerContext;
-
-// Create test cache
-$cache = new class implements Cache {
-    private array $data = [];
-
-    public function get(CacheIdentifier ...$identifiers): CacheResult
-    {
-        $hits = [];
-        $misses = [];
-        foreach ($identifiers as $identifier) {
-            $key = $identifier->toString();
-            if (isset($this->data[$key])) {
-                $value = $this->data[$key];
-                $hits[$key] = $value instanceof CacheItem ? $value->value : $value;
-            } else {
-                $misses[] = $key;
-            }
-        }
-        return new CacheResult($hits, $misses);
-    }
-
-    public function set(CacheItem ...$items): bool
-    {
-        foreach ($items as $item) {
-            $this->data[$item->key->toString()] = $item;
-        }
-        return true;
-    }
-
-    public function has(CacheIdentifier ...$identifiers): array
-    {
-        $result = [];
-        foreach ($identifiers as $identifier) {
-            $key = (string) $identifier;
-            $result[$key] = isset($this->data[$key]);
-        }
-        return $result;
-    }
-
-    public function forget(CacheIdentifier ...$identifiers): bool
-    {
-        foreach ($identifiers as $identifier) {
-            $key = (string) $identifier;
-            unset($this->data[$key]);
-        }
-        return true;
-    }
-
-    public function clear(): bool
-    {
-        $this->data = [];
-        return true;
-    }
-
-    public function remember(CacheKey $key, callable $callback, ?Duration $ttl = null): CacheItem
-    {
-        $keyStr = $key->toString();
-        if (isset($this->data[$keyStr])) {
-            return $this->data[$keyStr];
-        }
-        $value = $callback();
-        $item = CacheItem::forSetting($key, $value, $ttl);
-        $this->data[$keyStr] = $item;
-        return $item;
-    }
-};
-
-// Create test clock
-$clock = new class implements Clock {
-    public function now(): \DateTimeImmutable { return new \DateTimeImmutable(); }
-    public function fromTimestamp(Timestamp $timestamp): \DateTimeImmutable { return $timestamp->toDateTime(); }
-    public function fromString(string $dateTime, ?string $format = null): \DateTimeImmutable { return new \DateTimeImmutable($dateTime); }
-    public function today(): \DateTimeImmutable { return new \DateTimeImmutable('today'); }
-    public function yesterday(): \DateTimeImmutable { return new \DateTimeImmutable('yesterday'); }
-    public function tomorrow(): \DateTimeImmutable { return new \DateTimeImmutable('tomorrow'); }
-    public function time(): Timestamp { return Timestamp::now(); }
-};
-
-echo "Creating ErrorAggregator...\n";
-$storage = new InMemoryErrorStorage();
-$alertQueue = new InMemoryQueue();
-
-$errorAggregator = new ErrorAggregator(
-    storage: $storage,
-    cache: $cache,
-    clock: $clock,
-    alertQueue: $alertQueue
-);
-
-echo "Creating exception and context...\n";
-$exception = FrameworkException::create(
-    DatabaseErrorCode::QUERY_FAILED,
-    'Test database query failed'
-);
-
-$exceptionContext = ExceptionContext::empty()
-    ->withOperation('test_operation', 'TestComponent')
-    ->withData(['test_key' => 'test_value']);
-
-$requestContext = RequestContext::fromGlobals();
-$systemContext = SystemContext::current();
-
-$errorHandlerContext = ErrorHandlerContext::create(
-    $exceptionContext,
-    $requestContext,
-    $systemContext,
-    ['http_status' => 500]
-);
-
-echo "Processing error...\n";
-try {
-    $errorAggregator->processError($errorHandlerContext);
-    echo "SUCCESS: Error processed without exception\n";
-} catch (\Throwable $e) {
-    echo "ERROR processing error: " . $e->getMessage() . "\n";
-    echo "Stack trace:\n" . $e->getTraceAsString() . "\n";
-}
-
-echo "\nGetting recent events...\n";
-$recentEvents = $errorAggregator->getRecentEvents(10);
-echo "Recent events count: " . count($recentEvents) . "\n";
-
-echo "\nGetting active patterns...\n";
-$activePatterns = $errorAggregator->getActivePatterns(10);
-echo "Active patterns count: " . count($activePatterns) . "\n";
-
-if (count($recentEvents) > 0) {
-    echo "\nFirst event details:\n";
-    $event = $recentEvents[0];
-    echo "  Error message: " . $event->errorMessage . "\n";
-    echo "  Component: " . $event->component . "\n";
-    echo "  Operation: " . $event->operation . "\n";
-}
-
-if (count($activePatterns) > 0) {
-    echo "\nFirst pattern details:\n";
-    $pattern = $activePatterns[0];
-    echo "  Component: " . $pattern->component . "\n";
-    echo "  Occurrence count: " . $pattern->occurrenceCount . "\n";
-}
diff --git a/tests/debug/test-error-context-system.php b/tests/debug/test-error-context-system.php
deleted file mode 100644
index 527da378..00000000
--- a/tests/debug/test-error-context-system.php
+++ /dev/null
@@ -1,177 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\ErrorHandling\ErrorLogger;
-use App\Framework\Exception\ErrorCode;
-use App\Framework\Exception\ErrorHandlerContext;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\RequestContext;
-use App\Framework\Exception\SystemContext;
-
-echo "=== Testing Advanced Error Context System ===\n\n";
-
-echo "1. Testing Basic FrameworkException with ErrorCode:\n";
-
-try {
-    $exception = FrameworkException::create(
-        ErrorCode::DB_CONNECTION_FAILED,
-        "Connection to database failed"
-    )->withData([
-        'host' => 'localhost',
-        'port' => 3306,
-        'database' => 'test_db',
-    ])->withOperation('database.connect', 'DatabaseManager');
-
-    throw $exception;
-} catch (FrameworkException $e) {
-    echo "   ✅ Exception created with ErrorCode\n";
-    echo "      • Message: {$e->getMessage()}\n";
-    echo "      • Error Code: {$e->getErrorCode()?->value}\n";
-    echo "      • Category: {$e->getErrorCode()?->getCategory()}\n";
-    echo "      • Recoverable: " . ($e->isRecoverable() ? 'Yes' : 'No') . "\n";
-    echo "      • Retry After: " . ($e->getRetryAfter() ?? 'None') . " seconds\n";
-    echo "      • Recovery Hint: {$e->getRecoveryHint()}\n";
-    echo "      • Operation: {$e->getContext()->operation}\n";
-    echo "      • Component: {$e->getContext()->component}\n\n";
-}
-
-echo "2. Testing ExceptionContext fluent interface:\n";
-
-try {
-    $context = ExceptionContext::forOperation('user.create', 'UserService')
-        ->withData([
-            'user_id' => 'user_123',
-            'email' => 'test@example.com',
-        ])
-        ->withDebug([
-            'validation_errors' => ['email_already_exists'],
-            'retry_count' => 1,
-        ])
-        ->withMetadata([
-            'security_event' => false,
-            'business_critical' => true,
-        ]);
-
-    echo "   ✅ ExceptionContext created with fluent interface\n";
-    echo "      • Operation: {$context->operation}\n";
-    echo "      • Component: {$context->component}\n";
-    echo "      • Data keys: " . implode(', ', array_keys($context->data)) . "\n";
-    echo "      • Debug keys: " . implode(', ', array_keys($context->debug)) . "\n";
-    echo "      • Metadata keys: " . implode(', ', array_keys($context->metadata)) . "\n\n";
-} catch (\Throwable $e) {
-    echo "   ❌ Error: {$e->getMessage()}\n\n";
-}
-
-echo "3. Testing ErrorHandlerContext creation:\n";
-
-try {
-    $exceptionContext = ExceptionContext::forOperation('payment.process', 'PaymentService')
-        ->withData([
-            'amount' => 99.99,
-            'currency' => 'EUR',
-            'customer_id' => 'cust_123',
-        ])
-        ->withMetadata([
-            'security_event' => true,
-            'security_level' => 'WARN',
-            'security_description' => 'Suspicious payment attempt',
-        ]);
-
-    $requestContext = RequestContext::fromGlobals();
-    $systemContext = SystemContext::current();
-
-    $errorContext = ErrorHandlerContext::create(
-        $exceptionContext,
-        $requestContext,
-        $systemContext,
-        ['transaction_id' => 'tx_456']
-    );
-
-    echo "   ✅ ErrorHandlerContext created\n";
-    echo "      • Request method: " . ($errorContext->request->requestMethod ?? 'CLI') . "\n";
-    echo "      • Client IP: " . ($errorContext->request->clientIp ?? 'localhost') . "\n";
-    echo "      • Memory usage: {$errorContext->system->memoryUsage}\n";
-    echo "      • PHP version: {$errorContext->system->phpVersion}\n";
-    echo "      • Security event: " . ($errorContext->exception->metadata['security_event'] ? 'Yes' : 'No') . "\n\n";
-
-    // Test security event format
-    echo "   📊 Security Event Format:\n";
-    $securityEvent = $errorContext->toSecurityEventFormat('test-app');
-    foreach ($securityEvent as $key => $value) {
-        if (is_string($value) || is_numeric($value)) {
-            echo "      • {$key}: {$value}\n";
-        }
-    }
-    echo "\n";
-
-} catch (\Throwable $e) {
-    echo "   ❌ Error: {$e->getMessage()}\n\n";
-}
-
-echo "4. Testing Error Logging:\n";
-
-try {
-    // Create an exception with security context
-    $exception = FrameworkException::create(
-        ErrorCode::SEC_UNAUTHORIZED_ACCESS,
-        "Unauthorized access attempt detected"
-    )->withData([
-        'endpoint' => '/admin/dashboard',
-        'user_agent' => 'curl/7.68.0',
-        'ip_address' => '192.168.1.100',
-    ])->withMetadata([
-        'security_event' => true,
-        'security_level' => 'ERROR',
-        'security_description' => 'Unauthorized admin access attempt',
-    ]);
-
-    $errorContext = ErrorHandlerContext::fromException($exception, [
-        'alert_sent' => true,
-        'blocked' => true,
-    ]);
-
-    $errorLogger = new ErrorLogger();
-
-    echo "   ✅ Created security exception and error context\n";
-    echo "      • Exception type: " . get_class($exception) . "\n";
-    echo "      • Error code: {$exception->getErrorCode()?->value}\n";
-    echo "      • Security event: " . ($errorContext->exception->metadata['security_event'] ? 'Yes' : 'No') . "\n";
-
-    // Test logging data format
-    $loggingData = $errorContext->forLogging();
-    echo "      • Logging data keys: " . implode(', ', array_keys($loggingData)) . "\n\n";
-
-} catch (\Throwable $e) {
-    echo "   ❌ Error: {$e->getMessage()}\n\n";
-}
-
-echo "5. Testing ErrorCode system:\n";
-
-try {
-    $errorCodes = [
-        ErrorCode::DB_CONNECTION_FAILED,
-        ErrorCode::AUTH_TOKEN_EXPIRED,
-        ErrorCode::SEC_XSS_ATTEMPT,
-        ErrorCode::VAL_BUSINESS_RULE_VIOLATION,
-        ErrorCode::HTTP_RATE_LIMIT_EXCEEDED,
-    ];
-
-    echo "   📋 ErrorCode Analysis:\n";
-    foreach ($errorCodes as $code) {
-        echo "      • {$code->value}:\n";
-        echo "        - Category: {$code->getCategory()}\n";
-        echo "        - Description: {$code->getDescription()}\n";
-        echo "        - Recoverable: " . ($code->isRecoverable() ? 'Yes' : 'No') . "\n";
-        echo "        - Retry after: " . ($code->getRetryAfterSeconds() ?? 'None') . " seconds\n";
-        echo "        - Recovery hint: {$code->getRecoveryHint()}\n\n";
-    }
-
-} catch (\Throwable $e) {
-    echo "   ❌ Error: {$e->getMessage()}\n\n";
-}
-
-echo "=== Advanced Error Context System Test Completed ===\n";
diff --git a/tests/debug/test-error-handler-enhancements.php b/tests/debug/test-error-handler-enhancements.php
deleted file mode 100644
index 9049a6aa..00000000
--- a/tests/debug/test-error-handler-enhancements.php
+++ /dev/null
@@ -1,73 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\Queue\Exceptions\JobNotFoundException;
-use App\Framework\Queue\ValueObjects\JobId;
-use App\Framework\ErrorHandling\ErrorHandler;
-use App\Framework\DI\DefaultContainer;
-use App\Framework\Http\ResponseEmitter;
-use App\Framework\Http\RequestIdGenerator;
-
-echo "=== Testing ErrorHandler Enhancements ===\n\n";
-
-// Create minimal container for ErrorHandler
-$container = new DefaultContainer();
-$emitter = new ResponseEmitter();
-$requestIdGenerator = new RequestIdGenerator();
-
-$errorHandler = new ErrorHandler(
-    $emitter,
-    $container,
-    $requestIdGenerator,
-    null,
-    true // Debug mode to see recovery hints
-);
-
-// Test 1: Create a JobNotFoundException (uses QUEUE007 error code)
-echo "Test 1: JobNotFoundException with ErrorCode integration\n";
-echo str_repeat('-', 60) . "\n";
-
-try {
-    $jobId = JobId::fromString('test-job-123');
-    throw JobNotFoundException::byId($jobId);
-} catch (JobNotFoundException $e) {
-    echo "Exception: " . get_class($e) . "\n";
-    echo "Message: " . $e->getMessage() . "\n";
-    echo "Error Code: " . $e->getErrorCode()->getValue() . "\n";
-    echo "Category: " . $e->getErrorCode()->getCategory() . "\n";
-    echo "Severity: " . $e->getErrorCode()->getSeverity()->value . "\n";
-    echo "Is Recoverable: " . ($e->getErrorCode()->isRecoverable() ? 'Yes' : 'No') . "\n";
-    echo "Recovery Hint: " . $e->getErrorCode()->getRecoveryHint() . "\n";
-
-    // Test ErrorHandler metadata creation
-    echo "\nTesting ErrorHandler metadata generation...\n";
-    $response = $errorHandler->createHttpResponse($e);
-
-    echo "HTTP Status Code would be: " . $response->status->value . "\n";
-    echo "Response created successfully!\n";
-}
-
-echo "\n" . str_repeat('=', 60) . "\n\n";
-
-// Test 2: Test with different error code that has Retry-After
-echo "Test 2: Testing with error code that has Retry-After\n";
-echo str_repeat('-', 60) . "\n";
-
-use App\Framework\Queue\Exceptions\ChainNotFoundException;
-
-try {
-    throw ChainNotFoundException::byId('chain-123');
-} catch (ChainNotFoundException $e) {
-    echo "Exception: " . get_class($e) . "\n";
-    echo "Error Code: " . $e->getErrorCode()->getValue() . "\n";
-    echo "Retry After: " . ($e->getErrorCode()->getRetryAfterSeconds() ?? 'null') . " seconds\n";
-
-    $response = $errorHandler->createHttpResponse($e);
-    echo "HTTP Status Code: " . $response->status->value . "\n";
-    echo "Response headers would include Retry-After if applicable\n";
-}
-
-echo "\n✅ All ErrorHandler enhancement tests completed!\n";
diff --git a/tests/debug/test-error-handling-module.php b/tests/debug/test-error-handling-module.php
deleted file mode 100644
index bd02ceb7..00000000
--- a/tests/debug/test-error-handling-module.php
+++ /dev/null
@@ -1,194 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-/**
- * Test Script for ErrorHandling Module
- *
- * Tests the current error handling system with various exception types
- * to verify handler registration, priority execution, and response generation.
- */
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\ErrorHandling\Handlers\{
-    ValidationErrorHandler,
-    DatabaseErrorHandler,
-    HttpErrorHandler,
-    FallbackErrorHandler
-};
-use App\Framework\ErrorHandling\{ErrorHandlerManager, ErrorHandlerRegistry};
-use App\Framework\Validation\Exceptions\ValidationException;
-use App\Framework\Validation\ValidationResult;
-use App\Framework\Database\Exception\DatabaseException;
-use App\Framework\Http\Exception\HttpException;
-use App\Framework\Http\Status;
-use App\Framework\Exception\ExceptionContext;
-use App\Framework\Logging\Logger;
-use App\Framework\Logging\ValueObjects\LogContext;
-use App\Framework\Logging\LogLevel;
-
-echo "=== ErrorHandling Module Test ===\n\n";
-
-// Setup Logger (mock for testing)
-$logger = new class implements Logger {
-    public function debug(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::debug] {$message}\n";
-    }
-
-    public function info(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::info] {$message}\n";
-    }
-
-    public function notice(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::notice] {$message}\n";
-    }
-
-    public function warning(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::warning] {$message}\n";
-    }
-
-    public function error(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::error] {$message}\n";
-        if ($context && $context->structured) {
-            echo "   Context: " . print_r($context->structured, true) . "\n";
-        }
-    }
-
-    public function critical(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::critical] {$message}\n";
-    }
-
-    public function alert(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::alert] {$message}\n";
-    }
-
-    public function emergency(string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::emergency] {$message}\n";
-    }
-
-    public function log(LogLevel $level, string $message, ?LogContext $context = null): void {
-        echo "📝 [Logger::{$level->value}] {$message}\n";
-    }
-};
-
-// Setup ErrorHandlerManager
-$registry = new ErrorHandlerRegistry();
-$manager = new ErrorHandlerManager($registry);
-
-// Register handlers in priority order
-echo "Registering handlers...\n";
-$manager->register(new ValidationErrorHandler());
-$manager->register(new DatabaseErrorHandler($logger));
-$manager->register(new HttpErrorHandler());
-$manager->register(new FallbackErrorHandler($logger));
-echo "✅ All handlers registered\n\n";
-
-// Test 1: ValidationException
-echo "--- Test 1: ValidationException ---\n";
-try {
-    $validationResult = new ValidationResult();
-    $validationResult->addErrors('email', ['Email is required', 'Email format is invalid']);
-    $validationResult->addErrors('password', ['Password must be at least 8 characters']);
-
-    $exception = new ValidationException($validationResult);
-
-    $result = $manager->handleException($exception);
-
-    echo "✅ Handled: " . ($result->handled ? 'Yes' : 'No') . "\n";
-    echo "   Message: {$result->message}\n";
-    echo "   Status Code: {$result->statusCode}\n";
-    echo "   Error Type: {$result->data['error_type']}\n";
-    echo "   Errors: " . print_r($result->data['errors'], true) . "\n";
-} catch (\Throwable $e) {
-    echo "❌ Error: {$e->getMessage()}\n";
-}
-echo "\n";
-
-// Test 2: DatabaseException
-echo "--- Test 2: DatabaseException ---\n";
-try {
-    $exception = DatabaseException::fromContext(
-        'Connection failed: Too many connections',
-        ExceptionContext::empty()
-    );
-
-    $result = $manager->handleException($exception);
-
-    echo "✅ Handled: " . ($result->handled ? 'Yes' : 'No') . "\n";
-    echo "   Message: {$result->message}\n";
-    echo "   Status Code: {$result->statusCode}\n";
-    echo "   Error Type: {$result->data['error_type']}\n";
-    echo "   Retry After: {$result->data['retry_after']} seconds\n";
-} catch (\Throwable $e) {
-    echo "❌ Error: {$e->getMessage()}\n";
-}
-echo "\n";
-
-// Test 3: HttpException
-echo "--- Test 3: HttpException (404 Not Found) ---\n";
-try {
-    $exception = new HttpException(
-        'Resource not found',
-        Status::NOT_FOUND,
-        headers: ['X-Resource-Type' => 'User']
-    );
-
-    $result = $manager->handleException($exception);
-
-    echo "✅ Handled: " . ($result->handled ? 'Yes' : 'No') . "\n";
-    echo "   Message: {$result->message}\n";
-    echo "   Status Code: {$result->statusCode}\n";
-    echo "   Error Type: {$result->data['error_type']}\n";
-    echo "   Headers: " . print_r($result->data['headers'], true) . "\n";
-} catch (\Throwable $e) {
-    echo "❌ Error: {$e->getMessage()}\n";
-}
-echo "\n";
-
-// Test 4: Generic RuntimeException (Fallback)
-echo "--- Test 4: Generic RuntimeException (Fallback Handler) ---\n";
-try {
-    $exception = new \RuntimeException('Something unexpected happened');
-
-    $result = $manager->handleException($exception);
-
-    echo "✅ Handled: " . ($result->handled ? 'Yes' : 'No') . "\n";
-    echo "   Message: {$result->message}\n";
-    echo "   Status Code: {$result->statusCode}\n";
-    echo "   Error Type: {$result->data['error_type']}\n";
-    echo "   Exception Class: {$result->data['exception_class']}\n";
-    echo "   Is Final: " . ($result->isFinal ? 'Yes' : 'No') . "\n";
-} catch (\Throwable $e) {
-    echo "❌ Error: {$e->getMessage()}\n";
-}
-echo "\n";
-
-// Test 5: PDOException (Database Handler)
-echo "--- Test 5: PDOException ---\n";
-try {
-    $exception = new \PDOException('SQLSTATE[HY000] [2002] Connection refused');
-
-    $result = $manager->handleException($exception);
-
-    echo "✅ Handled: " . ($result->handled ? 'Yes' : 'No') . "\n";
-    echo "   Message: {$result->message}\n";
-    echo "   Status Code: {$result->statusCode}\n";
-    echo "   Error Type: {$result->data['error_type']}\n";
-} catch (\Throwable $e) {
-    echo "❌ Error: {$e->getMessage()}\n";
-}
-echo "\n";
-
-// Test 6: Handler Priority Order
-echo "--- Test 6: Handler Priority Verification ---\n";
-$handlers = $manager->getHandlers();
-echo "Registered handlers in priority order:\n";
-foreach ($handlers as $index => $handler) {
-    $priority = $handler->getPriority();
-    $name = $handler->getName();
-    echo "   " . ($index + 1) . ". {$name} (Priority: {$priority->value})\n";
-}
-echo "\n";
-
-echo "=== All Tests Completed ===\n";
diff --git a/tests/debug/test-error-pipeline-debug.php b/tests/debug/test-error-pipeline-debug.php
deleted file mode 100644
index b481f05d..00000000
--- a/tests/debug/test-error-pipeline-debug.php
+++ /dev/null
@@ -1,202 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\Cache\Cache;
-use App\Framework\Cache\CacheIdentifier;
-use App\Framework\Cache\CacheKey;
-use App\Framework\Cache\CacheItem;
-use App\Framework\Cache\CacheResult;
-use App\Framework\Core\ValueObjects\Duration;
-use App\Framework\DateTime\SystemClock;
-use App\Framework\ErrorAggregation\ErrorAggregator;
-use App\Framework\ErrorAggregation\Storage\InMemoryErrorStorage;
-use App\Framework\ErrorHandling\ErrorHandler;
-use App\Framework\ErrorReporting\ErrorReporter;
-use App\Framework\ErrorReporting\Storage\InMemoryErrorReportStorage;
-use App\Framework\Exception\Core\DatabaseErrorCode;
-use App\Framework\Exception\FrameworkException;
-use App\Framework\Http\RequestIdGenerator;
-use App\Framework\Http\ResponseEmitter;
-use App\Framework\DI\DefaultContainer;
-use App\Framework\Queue\InMemoryQueue;
-
-// Create all dependencies
-$container = new DefaultContainer();
-$emitter = new ResponseEmitter();
-$requestIdGenerator = new RequestIdGenerator();
-
-// Error Aggregation setup
-$errorStorage = new InMemoryErrorStorage();
-$cache = new class implements Cache {
-    private array $data = [];
-
-    public function get(CacheIdentifier ...$identifiers): CacheResult
-    {
-        $items = [];
-        foreach ($identifiers as $identifier) {
-            $keyStr = $identifier->toString();
-            if (isset($this->data[$keyStr])) {
-                $items[] = $this->data[$identifier->toString()];
-            } else {
-                $items[] = CacheItem::miss($identifier instanceof CacheKey ? $identifier : CacheKey::fromString($identifier->toString()));
-            }
-        }
-
-        return count($items) === 1
-            ? CacheResult::single($items[0])
-            : CacheResult::multiple($items);
-    }
-
-    public function set(CacheItem ...$items): bool
-    {
-        foreach ($items as $item) {
-            $this->data[$item->key->toString()] = $item;
-        }
-        return true;
-    }
-
-    public function has(CacheIdentifier ...$identifiers): array
-    {
-        $result = [];
-        foreach ($identifiers as $identifier) {
-            $result[] = isset($this->data[$identifier->toString()]);
-        }
-        return $result;
-    }
-
-    public function forget(CacheIdentifier ...$identifiers): bool
-    {
-        foreach ($identifiers as $identifier) {
-            unset($this->data[$identifier->toString()]);
-        }
-        return true;
-    }
-
-    public function clear(): bool
-    {
-        $this->data = [];
-        return true;
-    }
-
-    public function remember(CacheKey $key, callable $callback, ?Duration $ttl = null): CacheItem
-    {
-        $keyStr = $key->toString();
-        if (isset($this->data[$keyStr])) {
-            return $this->data[$keyStr];
-        }
-
-        $value = $callback();
-        $item = $ttl ? CacheItem::forSetting($key, $value, $ttl) : CacheItem::miss($key);
-        $this->data[$keyStr] = $item;
-        return $item;
-    }
-};
-$clock = new SystemClock();
-$alertQueue = new InMemoryQueue();
-
-$errorAggregator = new ErrorAggregator(
-    storage: $errorStorage,
-    cache: $cache,
-    clock: $clock,
-    alertQueue: $alertQueue,
-    logger: null,
-    batchSize: 100,
-    maxRetentionDays: 90
-);
-
-// Error Reporting setup
-$errorReportStorage = new InMemoryErrorReportStorage();
-$reportQueue = new InMemoryQueue();
-
-$errorReporter = new ErrorReporter(
-    storage: $errorReportStorage,
-    clock: $clock,
-    logger: null,
-    queue: $reportQueue,
-    asyncProcessing: false,
-    processors: [],
-    filters: []
-);
-
-// Create ErrorHandler
-$errorHandler = new ErrorHandler(
-    emitter: $emitter,
-    container: $container,
-    requestIdGenerator: $requestIdGenerator,
-    errorAggregator: $errorAggregator,
-    errorReporter: $errorReporter,
-    logger: null,
-    isDebugMode: true,
-    securityHandler: null
-);
-
-echo "=== Testing Error Pipeline ===\n\n";
-
-// Create test exception
-$exception = FrameworkException::create(
-    DatabaseErrorCode::QUERY_FAILED,
-    'Test database error'
-);
-
-echo "1. Creating ErrorHandlerContext manually...\n";
-$errorHandlerContext = (new \ReflectionClass($errorHandler))->getMethod('createErrorHandlerContext')->invoke($errorHandler, $exception, null);
-echo "   Context created successfully\n";
-echo "   ExceptionContext: operation={$errorHandlerContext->exception->operation}, component={$errorHandlerContext->exception->component}\n";
-
-echo "\n2. Testing ErrorEvent::fromErrorHandlerContext...\n";
-try {
-    $errorEvent = \App\Framework\ErrorAggregation\ErrorEvent::fromErrorHandlerContext($errorHandlerContext, $clock);
-    echo "   ErrorEvent created successfully\n";
-    echo "   Event ID: {$errorEvent->id}\n";
-    echo "   Event message: {$errorEvent->errorMessage}\n";
-} catch (\Throwable $e) {
-    echo "   EXCEPTION in fromErrorHandlerContext: " . $e->getMessage() . "\n";
-    echo "   AT: " . $e->getFile() . ":" . $e->getLine() . "\n";
-    echo "   TRACE:\n";
-    foreach ($e->getTrace() as $frame) {
-        $file = $frame['file'] ?? 'unknown';
-        $line = $frame['line'] ?? 0;
-        $function = $frame['function'] ?? 'unknown';
-        echo "      $file:$line - $function()\n";
-    }
-    exit(1);
-}
-
-echo "\n3. Testing ErrorAggregator.processError directly...\n";
-try {
-    $errorAggregator->processError($errorHandlerContext);
-    echo "   processError completed successfully\n";
-} catch (\Throwable $e) {
-    echo "   EXCEPTION in processError: " . $e->getMessage() . "\n";
-    echo "   AT: " . $e->getFile() . ":" . $e->getLine() . "\n";
-    throw $e;
-}
-
-echo "\n3. Creating HTTP response from exception...\n";
-$response = $errorHandler->createHttpResponse($exception);
-
-echo "\n4. Checking ErrorAggregator storage...\n";
-$events = $errorStorage->getRecentEvents(10);
-echo "   Events stored: " . count($events) . "\n";
-if (count($events) > 0) {
-    echo "   First event message: " . $events[0]->message . "\n";
-    echo "   First event severity: " . $events[0]->severity->value . "\n";
-} else {
-    echo "   No events stored!\n";
-}
-
-echo "\n3. Checking ErrorReporter storage...\n";
-$reports = $errorReportStorage->findRecent(10);
-echo "   Reports stored: " . count($reports) . "\n";
-if (count($reports) > 0) {
-    echo "   First report message: " . $reports[0]->message . "\n";
-    echo "   First report exception: " . $reports[0]->exception . "\n";
-    echo "   First report level: " . $reports[0]->level . "\n";
-} else {
-    echo "   No reports stored!\n";
-}
-
-echo "\n=== Test Complete ===\n";
diff --git a/tests/debug/test-error-reporting-config.php b/tests/debug/test-error-reporting-config.php
deleted file mode 100644
index afa1d719..00000000
--- a/tests/debug/test-error-reporting-config.php
+++ /dev/null
@@ -1,135 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-/**
- * Test script for ErrorReportingConfig integration
- *
- * Verifies that ErrorReportingConfig correctly loads from environment
- * and applies environment-specific defaults.
- */
-
-require_once __DIR__ . '/../../vendor/autoload.php';
-
-use App\Framework\Config\Environment;
-use App\Framework\Config\EnvironmentType;
-use App\Framework\ErrorReporting\ErrorReportingConfig;
-
-echo "=== Testing ErrorReportingConfig Integration ===\n\n";
-
-// Test 1: Development Environment
-echo "Test 1: Development Environment Configuration\n";
-echo "=============================================\n";
-
-$devEnv = new Environment(['APP_ENV' => 'development']);
-$devConfig = ErrorReportingConfig::fromEnvironment($devEnv);
-
-echo "✓ Config loaded from environment\n";
-echo "  - enabled: " . ($devConfig->enabled ? 'true' : 'false') . "\n";
-echo "  - asyncProcessing: " . ($devConfig->asyncProcessing ? 'true' : 'false') . " (expected: false for dev)\n";
-echo "  - filterLevels: " . (empty($devConfig->filterLevels) ? 'ALL' : implode(', ', $devConfig->filterLevels)) . "\n";
-echo "  - maxStackTraceDepth: {$devConfig->maxStackTraceDepth} (expected: 30)\n";
-echo "  - sanitizeSensitiveData: " . ($devConfig->sanitizeSensitiveData ? 'true' : 'false') . " (expected: false)\n";
-echo "  - maxReportsPerMinute: {$devConfig->maxReportsPerMinute} (expected: 1000)\n\n";
-
-// Test 2: Production Environment
-echo "Test 2: Production Environment Configuration\n";
-echo "===========================================\n";
-
-$prodEnv = new Environment(['APP_ENV' => 'production']);
-$prodConfig = ErrorReportingConfig::fromEnvironment($prodEnv);
-
-echo "✓ Config loaded from environment\n";
-echo "  - enabled: " . ($prodConfig->enabled ? 'true' : 'false') . "\n";
-echo "  - asyncProcessing: " . ($prodConfig->asyncProcessing ? 'true' : 'false') . " (expected: true)\n";
-echo "  - filterLevels: " . (empty($prodConfig->filterLevels) ? 'ALL' : implode(', ', $prodConfig->filterLevels)) . " (expected: error, critical, alert, emergency)\n";
-echo "  - maxStackTraceDepth: {$prodConfig->maxStackTraceDepth} (expected: 15)\n";
-echo "  - sanitizeSensitiveData: " . ($prodConfig->sanitizeSensitiveData ? 'true' : 'false') . " (expected: true)\n";
-echo "  - maxReportsPerMinute: {$prodConfig->maxReportsPerMinute} (expected: 30)\n\n";
-
-// Test 3: Staging Environment
-echo "Test 3: Staging Environment Configuration\n";
-echo "========================================\n";
-
-$stagingEnv = new Environment(['APP_ENV' => 'staging']);
-$stagingConfig = ErrorReportingConfig::fromEnvironment($stagingEnv);
-
-echo "✓ Config loaded from environment\n";
-echo "  - enabled: " . ($stagingConfig->enabled ? 'true' : 'false') . "\n";
-echo "  - asyncProcessing: " . ($stagingConfig->asyncProcessing ? 'true' : 'false') . " (expected: true)\n";
-echo "  - filterLevels: " . (empty($stagingConfig->filterLevels) ? 'ALL' : implode(', ', $stagingConfig->filterLevels)) . " (expected: warning and above)\n";
-echo "  - maxStackTraceDepth: {$stagingConfig->maxStackTraceDepth} (expected: 20)\n";
-echo "  - analyticsRetentionDays: {$stagingConfig->analyticsRetentionDays} (expected: 14)\n\n";
-
-// Test 4: Environment Variable Overrides
-echo "Test 4: Environment Variable Overrides\n";
-echo "=====================================\n";
-
-$overrideEnv = new Environment([
-    'APP_ENV' => 'production',
-    'ERROR_REPORTING_ENABLED' => 'false',
-    'ERROR_REPORTING_ASYNC' => 'false',
-    'ERROR_REPORTING_FILTER_LEVELS' => 'critical,emergency',
-    'ERROR_REPORTING_MAX_STACK_DEPTH' => '5',
-    'ERROR_REPORTING_SAMPLING_RATE' => '50'
-]);
-
-$overrideConfig = ErrorReportingConfig::fromEnvironment($overrideEnv);
-
-echo "✓ Config with environment overrides\n";
-echo "  - enabled: " . ($overrideConfig->enabled ? 'true' : 'false') . " (override: false)\n";
-echo "  - asyncProcessing: " . ($overrideConfig->asyncProcessing ? 'true' : 'false') . " (override: false)\n";
-echo "  - filterLevels: " . implode(', ', $overrideConfig->filterLevels) . " (override: critical, emergency)\n";
-echo "  - maxStackTraceDepth: {$overrideConfig->maxStackTraceDepth} (override: 5)\n";
-echo "  - samplingRate: {$overrideConfig->samplingRate} (override: 50)\n\n";
-
-// Test 5: Helper Methods
-echo "Test 5: Helper Methods\n";
-echo "====================\n";
-
-$testConfig = ErrorReportingConfig::fromEnvironment($prodEnv);
-
-// shouldReportLevel
-$shouldReportError = $testConfig->shouldReportLevel('error');
-$shouldReportDebug = $testConfig->shouldReportLevel('debug');
-
-echo "✓ shouldReportLevel()\n";
-echo "  - 'error' level: " . ($shouldReportError ? 'REPORT' : 'SKIP') . " (expected: REPORT)\n";
-echo "  - 'debug' level: " . ($shouldReportDebug ? 'REPORT' : 'SKIP') . " (expected: SKIP in production)\n\n";
-
-// shouldReportException
-$normalException = new \RuntimeException('Test error');
-$shouldReport = $testConfig->shouldReportException($normalException);
-
-echo "✓ shouldReportException()\n";
-echo "  - RuntimeException: " . ($shouldReport ? 'REPORT' : 'SKIP') . " (expected: REPORT)\n\n";
-
-// shouldSample
-$samples = 0;
-for ($i = 0; $i < 100; $i++) {
-    if ($testConfig->shouldSample()) {
-        $samples++;
-    }
-}
-
-echo "✓ shouldSample()\n";
-echo "  - Sampling rate: {$testConfig->samplingRate}%\n";
-echo "  - Samples in 100 attempts: {$samples} (expected: ~{$testConfig->samplingRate})\n\n";
-
-// Test 6: Direct Environment Type
-echo "Test 6: Direct Environment Type Configuration\n";
-echo "============================================\n";
-
-$directConfig = ErrorReportingConfig::forEnvironment(EnvironmentType::DEV, $devEnv);
-
-echo "✓ Config created directly with EnvironmentType::DEV\n";
-echo "  - asyncProcessing: " . ($directConfig->asyncProcessing ? 'true' : 'false') . " (expected: false)\n";
-echo "  - maxReportsPerMinute: {$directConfig->maxReportsPerMinute} (expected: 1000)\n\n";
-
-// Validation
-echo "=== Validation Results ===\n";
-echo "✓ All environment configurations loaded successfully\n";
-echo "✓ Environment-specific defaults applied correctly\n";
-echo "✓ Environment variable overrides work as expected\n";
-echo "✓ Helper methods function correctly\n";
-echo "✓ ErrorReportingConfig integration: PASSED\n";
diff --git a/tests/debug/test-event-system.php b/tests/debug/test-event-system.php
index dfaa1f11..14592ee4 100644
--- a/tests/debug/test-event-system.php
+++ b/tests/debug/test-event-system.php
@@ -24,7 +24,7 @@ use App\Framework\Logging\DefaultLogger;
 use App\Framework\Logging\Handlers\ConsoleHandler;
 use App\Framework\Logging\LogLevel;
 use App\Framework\Performance\MemoryMonitor;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 
 echo "🎯 Testing Discovery Event System\n";
@@ -52,7 +52,7 @@ try {
     // Register optional services in container
     $container->singleton(\App\Framework\Logging\Logger::class, $logger);
     $container->singleton(\App\Framework\Performance\MemoryMonitor::class, $memoryMonitor);
-    $container->singleton(\App\Framework\Reflection\ReflectionProvider::class, $reflectionProvider);
+    $container->singleton(\App\Framework\ReflectionLegacy\ReflectionProvider::class, $reflectionProvider);
     $container->singleton(\App\Framework\Filesystem\FileSystemService::class, $fileSystemService);
     $container->singleton(\App\Framework\Core\Events\EventDispatcher::class, $eventDispatcher);
 
diff --git a/tests/debug/test-initializer-execution.php b/tests/debug/test-initializer-execution.php
index 5f5b215a..eedfe0f4 100644
--- a/tests/debug/test-initializer-execution.php
+++ b/tests/debug/test-initializer-execution.php
@@ -11,7 +11,7 @@ use App\Framework\Core\PathProvider;
 use App\Framework\DateTime\SystemClock;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\DiscoveryServiceBootstrapper;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 
 echo "=== Testing Initializer Execution ===\n\n";
@@ -37,7 +37,7 @@ try {
     $container->instance(\App\Framework\Serializer\Serializer::class, $serializer);
     $container->instance(\App\Framework\Cache\Cache::class, $cache);
     $container->instance(\App\Framework\DateTime\Clock::class, $clock);
-    $container->instance(\App\Framework\Reflection\ReflectionProvider::class, new CachedReflectionProvider());
+    $container->instance(\App\Framework\ReflectionLegacy\ReflectionProvider::class, new CachedReflectionProvider());
 
     echo "Current execution context: " . ExecutionContext::detect()->getType()->value . "\n\n";
 
diff --git a/tests/debug/test-memory-management.php b/tests/debug/test-memory-management.php
index dbb4cb65..072fc02a 100644
--- a/tests/debug/test-memory-management.php
+++ b/tests/debug/test-memory-management.php
@@ -25,7 +25,7 @@ use App\Framework\Logging\DefaultLogger;
 use App\Framework\Logging\Handlers\ConsoleHandler;
 use App\Framework\Logging\LogLevel;
 use App\Framework\Performance\MemoryMonitor;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 
 echo "🧠 Testing Memory Management System for Discovery Module\n";
@@ -50,7 +50,7 @@ try {
     // Register optional services in container
     $container->singleton(\App\Framework\Logging\Logger::class, $logger);
     $container->singleton(\App\Framework\Performance\MemoryMonitor::class, $memoryMonitor);
-    $container->singleton(\App\Framework\Reflection\ReflectionProvider::class, $reflectionProvider);
+    $container->singleton(\App\Framework\ReflectionLegacy\ReflectionProvider::class, $reflectionProvider);
     $container->singleton(\App\Framework\Filesystem\FileSystemService::class, $fileSystemService);
 
     echo "✅ Dependencies initialized\n";
diff --git a/tests/debug/test-new-di-system.php b/tests/debug/test-new-di-system.php
index 75c52b61..a8e851fd 100644
--- a/tests/debug/test-new-di-system.php
+++ b/tests/debug/test-new-di-system.php
@@ -22,7 +22,7 @@ use App\Framework\Logging\DefaultLogger;
 use App\Framework\Logging\Handlers\ConsoleHandler;
 use App\Framework\Logging\LogLevel;
 use App\Framework\Performance\MemoryMonitor;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Php\PhpSerializer;
 
 echo "🔍 Testing New DI System for Discovery Module\n";
@@ -47,7 +47,7 @@ try {
     // Register optional services in container
     $container->singleton(\App\Framework\Logging\Logger::class, $logger);
     $container->singleton(\App\Framework\Performance\MemoryMonitor::class, $memoryMonitor);
-    $container->singleton(\App\Framework\Reflection\ReflectionProvider::class, $reflectionProvider);
+    $container->singleton(\App\Framework\ReflectionLegacy\ReflectionProvider::class, $reflectionProvider);
     $container->singleton(\App\Framework\Filesystem\FileSystemService::class, $fileSystemService);
 
     echo "✅ Dependencies initialized\n";
diff --git a/tests/debug/test-reflection-performance.php b/tests/debug/test-reflection-performance.php
new file mode 100644
index 00000000..2d0d3cf4
--- /dev/null
+++ b/tests/debug/test-reflection-performance.php
@@ -0,0 +1,123 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Performance Test: Native PHP Reflection vs Cached Reflection
+ * 
+ * This test measures the actual performance difference between
+ * native PHP reflection and the cached reflection provider.
+ */
+
+require_once __DIR__ . '/../../vendor/autoload.php';
+
+use App\Framework\Core\ValueObjects\ClassName;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
+use ReflectionClass;
+use ReflectionMethod;
+
+// Test class
+class TestClass {
+    public function __construct(
+        private string $param1,
+        private int $param2,
+        private ?object $param3 = null
+    ) {}
+    
+    public function testMethod(string $arg1, int $arg2): void {}
+}
+
+$iterations = 1000;
+$className = TestClass::class;
+
+echo "=== Reflection Performance Test ===\n\n";
+echo "Testing $iterations iterations for class: $className\n\n";
+
+// Test 1: Native ReflectionClass
+$start = microtime(true);
+for ($i = 0; $i < $iterations; $i++) {
+    $reflection = new ReflectionClass($className);
+    $methods = $reflection->getMethods();
+    $constructor = $reflection->getConstructor();
+    if ($constructor) {
+        $params = $constructor->getParameters();
+    }
+}
+$nativeTime = microtime(true) - $start;
+$nativeTimeMs = ($nativeTime * 1000);
+$nativeTimePerOp = ($nativeTimeMs / $iterations);
+
+echo "1. Native ReflectionClass:\n";
+echo "   Total: " . round($nativeTimeMs, 2) . " ms\n";
+echo "   Per operation: " . round($nativeTimePerOp, 4) . " ms\n";
+echo "   Per operation: " . round($nativeTimePerOp * 1000, 2) . " microseconds\n\n";
+
+// Test 2: Native ReflectionMethod (most common operation)
+$start = microtime(true);
+for ($i = 0; $i < $iterations; $i++) {
+    $reflection = new ReflectionMethod($className, 'testMethod');
+    $params = $reflection->getParameters();
+    foreach ($params as $param) {
+        $type = $param->getType();
+        $name = $param->getName();
+        $hasDefault = $param->isDefaultValueAvailable();
+    }
+}
+$nativeMethodTime = microtime(true) - $start;
+$nativeMethodTimeMs = ($nativeMethodTime * 1000);
+$nativeMethodTimePerOp = ($nativeMethodTimeMs / $iterations);
+
+echo "2. Native ReflectionMethod (getParameters):\n";
+echo "   Total: " . round($nativeMethodTimeMs, 2) . " ms\n";
+echo "   Per operation: " . round($nativeMethodTimePerOp, 4) . " ms\n";
+echo "   Per operation: " . round($nativeMethodTimePerOp * 1000, 2) . " microseconds\n\n";
+
+// Test 3: Cached ReflectionProvider (first run - no cache)
+$provider = new CachedReflectionProvider();
+$classNameObj = ClassName::create($className);
+
+$start = microtime(true);
+for ($i = 0; $i < $iterations; $i++) {
+    $class = $provider->getClass($classNameObj);
+    $methods = $provider->getMethods($classNameObj);
+    $params = $provider->getMethodParameters($classNameObj, '__construct');
+}
+$cachedFirstTime = microtime(true) - $start;
+$cachedFirstTimeMs = ($cachedFirstTime * 1000);
+$cachedFirstTimePerOp = ($cachedFirstTimeMs / $iterations);
+
+echo "3. Cached ReflectionProvider (first run - no cache):\n";
+echo "   Total: " . round($cachedFirstTimeMs, 2) . " ms\n";
+echo "   Per operation: " . round($cachedFirstTimePerOp, 4) . " ms\n";
+echo "   Per operation: " . round($cachedFirstTimePerOp * 1000, 2) . " microseconds\n\n";
+
+// Test 4: Cached ReflectionProvider (cached - second run)
+$start = microtime(true);
+for ($i = 0; $i < $iterations; $i++) {
+    $class = $provider->getClass($classNameObj);
+    $methods = $provider->getMethods($classNameObj);
+    $params = $provider->getMethodParameters($classNameObj, '__construct');
+}
+$cachedSecondTime = microtime(true) - $start;
+$cachedSecondTimeMs = ($cachedSecondTime * 1000);
+$cachedSecondTimePerOp = ($cachedSecondTimeMs / $iterations);
+
+echo "4. Cached ReflectionProvider (cached - second run):\n";
+echo "   Total: " . round($cachedSecondTimeMs, 2) . " ms\n";
+echo "   Per operation: " . round($cachedSecondTimePerOp, 4) . " ms\n";
+echo "   Per operation: " . round($cachedSecondTimePerOp * 1000, 2) . " microseconds\n\n";
+
+// Comparison
+echo "=== Comparison ===\n";
+$speedup = $nativeTimePerOp / $cachedSecondTimePerOp;
+echo "Speedup (cached vs native): " . round($speedup, 2) . "x\n";
+echo "Overhead (cached first vs native): " . round(($cachedFirstTimePerOp / $nativeTimePerOp - 1) * 100, 1) . "%\n\n";
+
+// Reality check: How many reflection calls per request?
+echo "=== Reality Check ===\n";
+echo "Typical request might call getMethodParameters() 10-50 times\n";
+echo "Native: " . round($nativeMethodTimePerOp * 50, 2) . " ms for 50 calls\n";
+echo "Cached: " . round($cachedSecondTimePerOp * 50, 2) . " ms for 50 calls\n";
+echo "Difference: " . round(($nativeMethodTimePerOp - $cachedSecondTimePerOp) * 50, 2) . " ms\n";
+echo "Is this significant? " . (($nativeMethodTimePerOp - $cachedSecondTimePerOp) * 50 > 1 ? "YES (>1ms)" : "NO (<1ms)") . "\n";
+
diff --git a/tests/debug/test-security-audit-tools.php b/tests/debug/test-security-audit-tools.php
index fc2f84e9..b508528d 100644
--- a/tests/debug/test-security-audit-tools.php
+++ b/tests/debug/test-security-audit-tools.php
@@ -11,7 +11,7 @@ use App\Framework\Filesystem\FileScanner;
 use App\Framework\Mcp\Tools\SecurityAuditTools;
 use App\Framework\Mcp\Tools\SecurityConfigurationTools;
 use App\Framework\Mcp\Tools\SecurityMonitoringTools;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Router\CompiledRoutes;
 
 echo "=== Testing Security Audit MCP Tools ===\n\n";
diff --git a/tests/debug/test-service-usage.php b/tests/debug/test-service-usage.php
index ba89646f..11f7729e 100644
--- a/tests/debug/test-service-usage.php
+++ b/tests/debug/test-service-usage.php
@@ -10,7 +10,7 @@ use App\Framework\Core\PathProvider;
 use App\Framework\DateTime\SystemClock;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\DiscoveryServiceBootstrapper;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 
 echo "=== Testing Initializer-Created Services ===\n\n";
@@ -33,7 +33,7 @@ try {
     $container->instance(\App\Framework\Serializer\Serializer::class, $serializer);
     $container->instance(\App\Framework\Cache\Cache::class, $cache);
     $container->instance(\App\Framework\DateTime\Clock::class, $clock);
-    $container->instance(\App\Framework\Reflection\ReflectionProvider::class, new CachedReflectionProvider());
+    $container->instance(\App\Framework\ReflectionLegacy\ReflectionProvider::class, new CachedReflectionProvider());
 
     // Bootstrap the system (this runs all initializers)
     $bootstrapper = new DiscoveryServiceBootstrapper($container, $clock);
diff --git a/tests/debug/test-web-initializers.php b/tests/debug/test-web-initializers.php
index 7135522a..4fbcf90f 100644
--- a/tests/debug/test-web-initializers.php
+++ b/tests/debug/test-web-initializers.php
@@ -17,7 +17,7 @@ use App\Framework\Core\PathProvider;
 use App\Framework\DateTime\SystemClock;
 use App\Framework\DI\DefaultContainer;
 use App\Framework\Discovery\DiscoveryServiceBootstrapper;
-use App\Framework\Reflection\CachedReflectionProvider;
+use App\Framework\ReflectionLegacy\CachedReflectionProvider;
 use App\Framework\Serializer\Json\JsonSerializer;
 
 echo "=== Testing Web Context Initializer Execution ===\n\n";
@@ -43,7 +43,7 @@ try {
     $container->instance(\App\Framework\Serializer\Serializer::class, $serializer);
     $container->instance(\App\Framework\Cache\Cache::class, $cache);
     $container->instance(\App\Framework\DateTime\Clock::class, $clock);
-    $container->instance(\App\Framework\Reflection\ReflectionProvider::class, new CachedReflectionProvider());
+    $container->instance(\App\Framework\ReflectionLegacy\ReflectionProvider::class, new CachedReflectionProvider());
 
     // Create bootstrapper
     $bootstrapper = new DiscoveryServiceBootstrapper($container, $clock);
diff --git a/tests/debug/test_token_classification.php b/tests/debug/test_token_classification.php
new file mode 100644
index 00000000..c79f9254
--- /dev/null
+++ b/tests/debug/test_token_classification.php
@@ -0,0 +1,912 @@
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__ . '/../../vendor/autoload.php';
+
+use App\Framework\Tokenizer\PhpTokenizer;
+use App\Framework\Tokenizer\ValueObjects\Token;
+use App\Framework\Tokenizer\ValueObjects\TokenType;
+
+/**
+ * Test script for token classification
+ * Tests various PHP structures and compares expected vs actual token types
+ */
+
+final class TokenClassificationTest
+{
+    private PhpTokenizer $tokenizer;
+
+    public function __construct()
+    {
+        $this->tokenizer = new PhpTokenizer();
+    }
+
+    /**
+     * Run all test cases
+     */
+    public function runAll(): void
+    {
+        $testCases = $this->getTestCases();
+        $total = count($testCases);
+        $passed = 0;
+        $failed = 0;
+
+        echo "=== Token Classification Test Suite ===\n\n";
+        echo "Running {$total} test cases...\n\n";
+
+        foreach ($testCases as $index => $testCase) {
+            echo str_repeat('=', 80) . "\n";
+            echo "Test Case " . ($index + 1) . ": {$testCase['name']}\n";
+            echo str_repeat('=', 80) . "\n\n";
+
+            $result = $this->runTestCase($testCase);
+
+            if ($result['passed']) {
+                $passed++;
+                echo "✅ PASSED\n\n";
+            } else {
+                $failed++;
+                echo "❌ FAILED\n\n";
+            }
+        }
+
+        echo str_repeat('=', 80) . "\n";
+        echo "Summary: {$passed}/{$total} passed, {$failed}/{$total} failed\n";
+    }
+
+    /**
+     * Run a single test case
+     */
+    private function runTestCase(array $testCase): array
+    {
+        $code = $testCase['code'];
+        $expected = $testCase['expected'];
+        $expectedMetadata = $testCase['expectedMetadata'] ?? null;
+
+        echo "Code:\n";
+        $codeLines = explode("\n", $code);
+        foreach ($codeLines as $i => $line) {
+            echo sprintf("  %2d: %s\n", $i + 1, $line);
+        }
+        echo "\n";
+
+        // Tokenize the code
+        $tokens = $this->tokenizer->tokenize($code);
+
+        // Build actual token map
+        $actual = $this->buildTokenMap($tokens);
+
+        // Compare expected vs actual
+        $differences = $this->compareTokens($expected, $actual);
+
+        // Check metadata if expected
+        $metadataDifferences = [];
+        if ($expectedMetadata !== null) {
+            $metadataDifferences = $this->compareMetadata($tokens, $expectedMetadata);
+        }
+
+        // Display expected tokens
+        echo "Expected Tokens:\n";
+        foreach ($expected as $lineNum => $lineTokens) {
+            foreach ($lineTokens as $tokenValue => $expectedType) {
+                echo sprintf("  Line %d: '%s' → %s\n", $lineNum, $tokenValue, $expectedType);
+            }
+        }
+        echo "\n";
+
+        // Display actual tokens
+        echo "Actual Tokens:\n";
+        foreach ($actual as $lineNum => $lineTokens) {
+            foreach ($lineTokens as $tokenValue => $actualType) {
+                echo sprintf("  Line %d: '%s' → %s\n", $lineNum, $tokenValue, $actualType->value);
+            }
+        }
+        echo "\n";
+
+        // Display differences
+        if (empty($differences) && empty($metadataDifferences)) {
+            echo "Differences: None - All tokens and metadata match!\n";
+            return ['passed' => true, 'differences' => []];
+        }
+
+        echo "Differences:\n";
+        foreach ($differences as $diff) {
+            if ($diff['match']) {
+                echo sprintf("  ✅ Line %d: '%s' → %s (correct)\n", 
+                    $diff['line'], 
+                    $diff['token'], 
+                    $diff['expected']
+                );
+            } else {
+                echo sprintf("  ❌ Line %d: '%s' → Expected %s, got %s\n", 
+                    $diff['line'], 
+                    $diff['token'], 
+                    $diff['expected'],
+                    $diff['actual']
+                );
+            }
+        }
+
+        // Display metadata differences
+        if (!empty($metadataDifferences)) {
+            echo "\nMetadata Differences:\n";
+            foreach ($metadataDifferences as $diff) {
+                if ($diff['match']) {
+                    echo sprintf("  ✅ Line %d: '%s' → %s (correct)\n", 
+                        $diff['line'], 
+                        $diff['token'], 
+                        $diff['expected']
+                    );
+                } else {
+                    echo sprintf("  ❌ Line %d: '%s' → Expected %s, got %s\n", 
+                        $diff['line'], 
+                        $diff['token'], 
+                        $diff['expected'],
+                        $diff['actual']
+                    );
+                }
+            }
+        }
+
+        $allDifferences = array_merge($differences, $metadataDifferences);
+        return [
+            'passed' => empty(array_filter($allDifferences, fn($d) => !$d['match'])),
+            'differences' => $allDifferences
+        ];
+    }
+
+    /**
+     * Build token map from TokenCollection
+     */
+    private function buildTokenMap($tokens): array
+    {
+        $map = [];
+        
+        foreach ($tokens as $token) {
+            $line = $token->line;
+            $value = trim($token->value);
+            
+            // Skip whitespace-only tokens and PHP tags
+            if ($token->type === TokenType::WHITESPACE || 
+                $token->type === TokenType::PHP_TAG ||
+                empty($value)) {
+                continue;
+            }
+
+            if (!isset($map[$line])) {
+                $map[$line] = [];
+            }
+
+            // Use token value as key, token type as value
+            $map[$line][$value] = $token->type;
+        }
+
+        return $map;
+    }
+
+    /**
+     * Compare metadata for tokens
+     */
+    private function compareMetadata($tokens, array $expectedMetadata): array
+    {
+        $differences = [];
+        
+        // Build token lookup by line and value
+        $tokenLookup = [];
+        foreach ($tokens as $token) {
+            $line = $token->line;
+            $value = trim($token->value);
+            
+            if (empty($value) || $token->type === TokenType::WHITESPACE || $token->type === TokenType::PHP_TAG) {
+                continue;
+            }
+
+            if (!isset($tokenLookup[$line])) {
+                $tokenLookup[$line] = [];
+            }
+            
+            $tokenLookup[$line][$value] = $token;
+        }
+
+        // Compare expected metadata
+        foreach ($expectedMetadata as $lineNum => $lineMetadata) {
+            foreach ($lineMetadata as $tokenValue => $expectedMeta) {
+                $token = $tokenLookup[$lineNum][$tokenValue] ?? null;
+                
+                if ($token === null) {
+                    $differences[] = [
+                        'line' => $lineNum,
+                        'token' => $tokenValue,
+                        'expected' => json_encode($expectedMeta),
+                        'actual' => 'TOKEN_NOT_FOUND',
+                        'match' => false
+                    ];
+                    continue;
+                }
+
+                $actualMeta = $token->metadata;
+                
+                // Check each expected metadata property
+                foreach ($expectedMeta as $property => $expectedValue) {
+                    $actualValue = $actualMeta?->$property ?? null;
+                    
+                    if ($property === 'isBuiltIn') {
+                        $actualValue = $actualMeta?->isBuiltIn ?? false;
+                    }
+                    
+                    $match = $actualValue === $expectedValue;
+                    
+                    if (!$match) {
+                        $differences[] = [
+                            'line' => $lineNum,
+                            'token' => $tokenValue,
+                            'expected' => "{$property}: " . ($expectedValue === true ? 'true' : ($expectedValue === false ? 'false' : $expectedValue)),
+                            'actual' => "{$property}: " . ($actualValue === true ? 'true' : ($actualValue === false ? 'false' : ($actualValue ?? 'null'))),
+                            'match' => false
+                        ];
+                    }
+                }
+            }
+        }
+
+        return $differences;
+    }
+
+    /**
+     * Compare expected and actual tokens
+     */
+    private function compareTokens(array $expected, array $actual): array
+    {
+        $differences = [];
+        $allLines = array_unique(array_merge(array_keys($expected), array_keys($actual)));
+
+        foreach ($allLines as $lineNum) {
+            $expectedTokens = $expected[$lineNum] ?? [];
+            $actualTokens = $actual[$lineNum] ?? [];
+
+            // Check all expected tokens
+            foreach ($expectedTokens as $tokenValue => $expectedTypeName) {
+                $expectedType = TokenType::tryFrom($expectedTypeName);
+                $actualType = $actualTokens[$tokenValue] ?? null;
+
+                $differences[] = [
+                    'line' => $lineNum,
+                    'token' => $tokenValue,
+                    'expected' => $expectedTypeName,
+                    'actual' => $actualType?->value ?? 'NOT_FOUND',
+                    'match' => $actualType === $expectedType
+                ];
+            }
+
+            // Check for unexpected tokens (optional - could be verbose)
+            foreach ($actualTokens as $tokenValue => $actualType) {
+                if (!isset($expectedTokens[$tokenValue])) {
+                    // This token wasn't expected - could log as info
+                }
+            }
+        }
+
+        return $differences;
+    }
+
+    /**
+     * Get all test cases
+     */
+    private function getTestCases(): array
+    {
+        return array_merge(
+            // Test Cases for Classes
+            $this->getClassTestCases(),
+            // Test Cases for Enums
+            $this->getEnumTestCases(),
+            // Test Cases for Attributes
+            $this->getAttributeTestCases(),
+            // Test Cases for Methods and Properties
+            $this->getMethodPropertyTestCases(),
+            // Test Cases for Metadata
+            $this->getMetadataTestCases()
+        );
+    }
+
+    /**
+     * Get test cases for classes
+     */
+    private function getClassTestCases(): array
+    {
+        return [
+            [
+                'name' => 'Simple Class',
+                'code' => '<?php class MyClass {}',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Final Class',
+                'code' => '<?php final class MyClass {}',
+                'expected' => [
+                    1 => [
+                        'final' => 'keyword_modifier',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Abstract Class',
+                'code' => '<?php abstract class MyClass {}',
+                'expected' => [
+                    1 => [
+                        'abstract' => 'keyword_modifier',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Readonly Class',
+                'code' => '<?php readonly class MyClass {}',
+                'expected' => [
+                    1 => [
+                        'readonly' => 'keyword_modifier',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Class with Extends',
+                'code' => '<?php class Child extends Parent {}',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'Child' => 'class_name',
+                        'extends' => 'keyword_other',
+                        'Parent' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Class with Implements',
+                'code' => '<?php class MyClass implements MyInterface {}',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                        'implements' => 'keyword_other',
+                        'MyInterface' => 'interface_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Class with Multiple Modifiers',
+                'code' => '<?php final readonly class MyClass {}',
+                'expected' => [
+                    1 => [
+                        'final' => 'keyword_modifier',
+                        'readonly' => 'keyword_modifier',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Class with Extends and Implements',
+                'code' => '<?php class Child extends Parent implements MyInterface {}',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'Child' => 'class_name',
+                        'extends' => 'keyword_other',
+                        'Parent' => 'class_name',
+                        'implements' => 'keyword_other',
+                        'MyInterface' => 'interface_name',
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * Get test cases for enums
+     */
+    private function getEnumTestCases(): array
+    {
+        return [
+            [
+                'name' => 'Pure Enum',
+                'code' => '<?php enum Status {}',
+                'expected' => [
+                    1 => [
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Backed Enum (String)',
+                'code' => '<?php enum Status: string {}',
+                'expected' => [
+                    1 => [
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                        ':' => 'operator',
+                        'string' => 'keyword_type',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Backed Enum (Int)',
+                'code' => '<?php enum Status: int {}',
+                'expected' => [
+                    1 => [
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                        ':' => 'operator',
+                        'int' => 'keyword_type',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Enum with Implements',
+                'code' => '<?php enum Status implements MyInterface {}',
+                'expected' => [
+                    1 => [
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                        'implements' => 'keyword_other',
+                        'MyInterface' => 'interface_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Final Enum',
+                'code' => '<?php final enum Status {}',
+                'expected' => [
+                    1 => [
+                        'final' => 'keyword_modifier',
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Backed Enum with Implements',
+                'code' => '<?php enum Status: string implements MyInterface {}',
+                'expected' => [
+                    1 => [
+                        'enum' => 'keyword_other',
+                        'Status' => 'enum_name',
+                        ':' => 'operator',
+                        'string' => 'keyword_type',
+                        'implements' => 'keyword_other',
+                        'MyInterface' => 'interface_name',
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * Get test cases for attributes
+     */
+    private function getAttributeTestCases(): array
+    {
+        return [
+            [
+                'name' => 'Simple Attribute',
+                'code' => '<?php #[Route] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Attribute with Parameter',
+                'code' => '<?php #[Route(\'/api\')] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        '(' => 'parenthesis',
+                        '\'/api\'' => 'string_literal',
+                        ')' => 'parenthesis',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Attribute with Named Parameters',
+                'code' => '<?php #[Route(path: \'/api\', method: \'GET\')] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        '(' => 'parenthesis',
+                        'path' => 'attribute_name',
+                        ':' => 'operator',
+                        '\'/api\'' => 'string_literal',
+                        ',' => 'punctuation',
+                        'method' => 'attribute_name',
+                        ':' => 'operator',
+                        '\'GET\'' => 'string_literal',
+                        ')' => 'parenthesis',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Multiple Attributes',
+                'code' => '<?php #[Route, Auth] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        ',' => 'punctuation',
+                        'Auth' => 'attribute_name',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Attribute with Multiple Parameters',
+                'code' => '<?php #[Route(\'/api\', \'POST\')] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        '(' => 'parenthesis',
+                        '\'/api\'' => 'string_literal',
+                        ',' => 'punctuation',
+                        '\'POST\'' => 'string_literal',
+                        ')' => 'parenthesis',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Attribute with Class Parameter',
+                'code' => '<?php #[Route(MyClass::class)] class MyClass {}',
+                'expected' => [
+                    1 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        '(' => 'parenthesis',
+                        'MyClass' => 'class_name',
+                        '::' => 'operator',
+                        'class' => 'keyword_other',
+                        ')' => 'parenthesis',
+                        ']' => 'bracket',
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Attribute on Method',
+                'code' => '<?php class MyClass { #[Route] public function test() {} }',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                        '{' => 'brace',
+                    ],
+                    2 => [
+                        '#' => 'attribute',
+                        '[' => 'bracket',
+                        'Route' => 'attribute_name',
+                        ']' => 'bracket',
+                        'public' => 'keyword_modifier',
+                        'function' => 'keyword_other',
+                        'test' => 'method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * Get test cases for methods and properties
+     */
+    private function getMethodPropertyTestCases(): array
+    {
+        return [
+            [
+                'name' => 'Static Method Call',
+                'code' => '<?php MyClass::staticMethod();',
+                'expected' => [
+                    1 => [
+                        'MyClass' => 'class_name',
+                        '::' => 'operator',
+                        'staticMethod' => 'static_method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Instance Method Call',
+                'code' => '<?php $obj->instanceMethod();',
+                'expected' => [
+                    1 => [
+                        '$obj' => 'variable',
+                        '->' => 'operator',
+                        'instanceMethod' => 'instance_method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Property Access',
+                'code' => '<?php $obj->property;',
+                'expected' => [
+                    1 => [
+                        '$obj' => 'variable',
+                        '->' => 'operator',
+                        'property' => 'instance_property_name',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Static Property Access',
+                'code' => '<?php MyClass::$staticProperty;',
+                'expected' => [
+                    1 => [
+                        'MyClass' => 'class_name',
+                        '::' => 'operator',
+                        '$staticProperty' => 'variable',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Constructor Call',
+                'code' => '<?php new MyClass();',
+                'expected' => [
+                    1 => [
+                        'new' => 'keyword_other',
+                        'MyClass' => 'constructor_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Method Definition',
+                'code' => '<?php public function myMethod() {}',
+                'expected' => [
+                    1 => [
+                        'public' => 'keyword_modifier',
+                        'function' => 'keyword_other',
+                        'myMethod' => 'function_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Method Definition in Class',
+                'code' => '<?php class MyClass { public function myMethod() {} }',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                        '{' => 'brace',
+                    ],
+                    2 => [
+                        'public' => 'keyword_modifier',
+                        'function' => 'keyword_other',
+                        'myMethod' => 'method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Constructor Definition',
+                'code' => '<?php class MyClass { public function __construct() {} }',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                        '{' => 'brace',
+                    ],
+                    2 => [
+                        'public' => 'keyword_modifier',
+                        'function' => 'keyword_other',
+                        '__construct' => 'constructor_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Static Method Definition',
+                'code' => '<?php class MyClass { public static function staticMethod() {} }',
+                'expected' => [
+                    1 => [
+                        'class' => 'keyword_other',
+                        'MyClass' => 'class_name',
+                        '{' => 'brace',
+                    ],
+                    2 => [
+                        'public' => 'keyword_modifier',
+                        'static' => 'keyword_modifier',
+                        'function' => 'keyword_other',
+                        'staticMethod' => 'method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Nullsafe Operator Method Call',
+                'code' => '<?php $obj?->method();',
+                'expected' => [
+                    1 => [
+                        '$obj' => 'variable',
+                        '?->' => 'operator',
+                        'method' => 'instance_method_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * Get test cases for metadata
+     */
+    private function getMetadataTestCases(): array
+    {
+        return [
+            [
+                'name' => 'Built-in Function Call',
+                'code' => '<?php count($array);',
+                'expected' => [
+                    1 => [
+                        'count' => 'function_name',
+                        '$array' => 'variable',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'count' => [
+                            'functionName' => 'count',
+                            'isBuiltIn' => true,
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Built-in Function strlen',
+                'code' => '<?php strlen($str);',
+                'expected' => [
+                    1 => [
+                        'strlen' => 'function_name',
+                        '$str' => 'variable',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'strlen' => [
+                            'functionName' => 'strlen',
+                            'isBuiltIn' => true,
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Built-in Function array_map',
+                'code' => '<?php array_map($callback, $array);',
+                'expected' => [
+                    1 => [
+                        'array_map' => 'function_name',
+                        '$callback' => 'variable',
+                        '$array' => 'variable',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'array_map' => [
+                            'functionName' => 'array_map',
+                            'isBuiltIn' => true,
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'name' => 'User Function Call',
+                'code' => '<?php myFunction();',
+                'expected' => [
+                    1 => [
+                        'myFunction' => 'function_name',
+                        '(' => 'parenthesis',
+                        ')' => 'parenthesis',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'myFunction' => [
+                            'functionName' => 'myFunction',
+                            'isBuiltIn' => false,
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Static Method Call with Metadata',
+                'code' => '<?php MyClass::staticMethod();',
+                'expected' => [
+                    1 => [
+                        'MyClass' => 'class_name',
+                        '::' => 'operator',
+                        'staticMethod' => 'static_method_name',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'MyClass' => [
+                            'className' => 'MyClass',
+                        ],
+                        'staticMethod' => [
+                            'functionName' => 'staticMethod',
+                            'className' => 'MyClass',
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'name' => 'Instance Method Call with Metadata',
+                'code' => '<?php $obj->instanceMethod();',
+                'expected' => [
+                    1 => [
+                        '$obj' => 'variable',
+                        '->' => 'operator',
+                        'instanceMethod' => 'instance_method_name',
+                    ],
+                ],
+                'expectedMetadata' => [
+                    1 => [
+                        'instanceMethod' => [
+                            'functionName' => 'instanceMethod',
+                        ],
+                    ],
+                ],
+            ],
+        ];
+    }
+}
+
+// Run tests if executed directly
+if (php_sapi_name() === 'cli') {
+    $test = new TokenClassificationTest();
+    $test->runAll();
+}
+
diff --git a/tests/integration/ExceptionHandlingIntegrationTest.php b/tests/integration/ExceptionHandlingIntegrationTest.php
index 786e3cc6..ac679081 100644
--- a/tests/integration/ExceptionHandlingIntegrationTest.php
+++ b/tests/integration/ExceptionHandlingIntegrationTest.php
@@ -20,6 +20,17 @@ use RuntimeException;
  */
 
 describe('ErrorKernel HTTP Response Generation', function () {
+    beforeEach(function () {
+        // Mock $_SERVER for API detection
+        $_SERVER['HTTP_ACCEPT'] = 'application/json';
+        $_SERVER['REQUEST_URI'] = '/api/test';
+    });
+
+    afterEach(function () {
+        // Cleanup
+        unset($_SERVER['HTTP_ACCEPT'], $_SERVER['REQUEST_URI']);
+    });
+
     it('creates JSON API error response without context', function () {
         $errorKernel = new ErrorKernel();
         $exception = new RuntimeException('Test API error', 500);
@@ -27,7 +38,7 @@ describe('ErrorKernel HTTP Response Generation', function () {
         $response = $errorKernel->createHttpResponse($exception, null, isDebugMode: false);
 
         expect($response->status)->toBe(Status::INTERNAL_SERVER_ERROR);
-        expect($response->headers['Content-Type'])->toBe('application/json');
+        expect($response->headers->getFirst('Content-Type'))->toBe('application/json');
 
         $body = json_decode($response->body, true);
         expect($body['error']['message'])->toBe('An error occurred while processing your request.');
@@ -64,7 +75,7 @@ describe('ErrorKernel HTTP Response Generation', function () {
             occurredAt: new \DateTimeImmutable(),
             metadata: ['user_email' => 'test@example.com']
         );
-        $contextProvider->set($exception, $contextData);
+        $contextProvider->attach($exception, $contextData);
 
         $response = $errorKernel->createHttpResponse($exception, $contextProvider, isDebugMode: true);
 
@@ -94,7 +105,7 @@ describe('ResponseErrorRenderer', function () {
 
         $response = $renderer->createResponse($exception, null);
 
-        expect($response->headers['Content-Type'])->toBe('application/json');
+        expect($response->headers->getFirst('Content-Type'))->toBe('application/json');
     });
 
     it('creates HTML response for non-API requests', function () {
@@ -107,7 +118,7 @@ describe('ResponseErrorRenderer', function () {
 
         $response = $renderer->createResponse($exception, null);
 
-        expect($response->headers['Content-Type'])->toBe('text/html; charset=utf-8');
+        expect($response->headers->getFirst('Content-Type'))->toBe('text/html; charset=utf-8');
         expect($response->body)->toContain('<!DOCTYPE html>');
         expect($response->body)->toContain('An error occurred while processing your request.');
     });
@@ -126,7 +137,7 @@ describe('ResponseErrorRenderer', function () {
             requestId: 'req-67890',
             occurredAt: new \DateTimeImmutable()
         );
-        $contextProvider->set($exception, $contextData);
+        $contextProvider->attach($exception, $contextData);
 
         $response = $renderer->createResponse($exception, $contextProvider);
 
@@ -168,7 +179,7 @@ describe('ExceptionContextProvider WeakMap functionality', function () {
             occurredAt: new \DateTimeImmutable()
         );
 
-        $contextProvider->set($exception, $contextData);
+        $contextProvider->attach($exception, $contextData);
         $retrieved = $contextProvider->get($exception);
 
         expect($retrieved)->not->toBeNull();
@@ -197,7 +208,7 @@ describe('ExceptionContextProvider WeakMap functionality', function () {
             occurredAt: new \DateTimeImmutable()
         );
 
-        $contextProvider->set($exception, $contextData);
+        $contextProvider->attach($exception, $contextData);
 
         // Verify context exists
         expect($contextProvider->get($exception))->not->toBeNull();
@@ -223,16 +234,16 @@ describe('Context enrichment with boundary metadata', function () {
             requestId: 'req-abc',
             occurredAt: new \DateTimeImmutable()
         );
-        $contextProvider->set($exception, $initialContext);
+        $contextProvider->attach($exception, $initialContext);
 
         // ErrorBoundary enriches with boundary metadata
         $existingContext = $contextProvider->get($exception);
-        $enrichedContext = $existingContext->withMetadata([
+        $enrichedContext = $existingContext->addMetadata([
             'error_boundary' => 'user_boundary',
             'boundary_failure' => true,
             'fallback_executed' => true
         ]);
-        $contextProvider->set($exception, $enrichedContext);
+        $contextProvider->attach($exception, $enrichedContext);
 
         // Retrieve and verify enriched context
         $finalContext = $contextProvider->get($exception);
@@ -251,17 +262,17 @@ describe('Context enrichment with boundary metadata', function () {
             requestId: 'req-http-123',
             occurredAt: new \DateTimeImmutable()
         );
-        $contextProvider->set($exception, $initialContext);
+        $contextProvider->attach($exception, $initialContext);
 
         // Enrich with HTTP-specific fields
         $existingContext = $contextProvider->get($exception);
-        $enrichedContext = $existingContext->withMetadata([
+        $enrichedContext = $existingContext->addMetadata([
             'client_ip' => '192.168.1.100',
             'user_agent' => 'Mozilla/5.0',
             'http_method' => 'POST',
             'request_uri' => '/api/users'
         ]);
-        $contextProvider->set($exception, $enrichedContext);
+        $contextProvider->attach($exception, $enrichedContext);
 
         // Verify both original and enriched data
         $finalContext = $contextProvider->get($exception);
@@ -273,6 +284,17 @@ describe('Context enrichment with boundary metadata', function () {
 });
 
 describe('End-to-end integration scenario', function () {
+    beforeEach(function () {
+        // Mock $_SERVER for API detection
+        $_SERVER['HTTP_ACCEPT'] = 'application/json';
+        $_SERVER['REQUEST_URI'] = '/api/test';
+    });
+
+    afterEach(function () {
+        // Cleanup
+        unset($_SERVER['HTTP_ACCEPT'], $_SERVER['REQUEST_URI']);
+    });
+
     it('demonstrates full exception handling flow with context enrichment', function () {
         // Setup
         $errorKernel = new ErrorKernel();
@@ -289,24 +311,24 @@ describe('End-to-end integration scenario', function () {
             occurredAt: new \DateTimeImmutable(),
             metadata: ['user_email' => 'test@example.com']
         );
-        $contextProvider->set($exception, $serviceContext);
+        $contextProvider->attach($exception, $serviceContext);
 
         // 3. ErrorBoundary catches and enriches with boundary metadata
-        $boundaryContext = $contextProvider->get($exception)->withMetadata([
+        $boundaryContext = $contextProvider->get($exception)->addMetadata([
             'error_boundary' => 'user_registration_boundary',
             'boundary_failure' => true,
             'fallback_executed' => false
         ]);
-        $contextProvider->set($exception, $boundaryContext);
+        $contextProvider->attach($exception, $boundaryContext);
 
         // 4. HTTP layer enriches with request metadata
-        $httpContext = $contextProvider->get($exception)->withMetadata([
+        $httpContext = $contextProvider->get($exception)->addMetadata([
             'client_ip' => '203.0.113.42',
             'user_agent' => 'Mozilla/5.0 (Windows NT 10.0)',
             'http_method' => 'POST',
             'request_uri' => '/api/users/register'
         ]);
-        $contextProvider->set($exception, $httpContext);
+        $contextProvider->attach($exception, $httpContext);
 
         // 5. ErrorKernel generates HTTP response
         $response = $errorKernel->createHttpResponse($exception, $contextProvider, isDebugMode: true);
@@ -323,6 +345,6 @@ describe('End-to-end integration scenario', function () {
         // Metadata can be accessed programmatically via $contextProvider->get($exception)->metadata
 
         expect($response->status)->toBe(Status::INTERNAL_SERVER_ERROR);
-        expect($response->headers['Content-Type'])->toBe('application/json');
+        expect($response->headers->getFirst('Content-Type'))->toBe('application/json');
     });
 });
diff --git a/worker.php b/worker.php
index 0c9fe272..5d27e8eb 100644
--- a/worker.php
+++ b/worker.php
@@ -11,6 +11,8 @@ use App\Framework\DateTime\SystemHighResolutionClock;
 use App\Framework\Performance\MemoryMonitor;
 use App\Framework\Queue\Queue;
 use App\Framework\Worker\Worker;
+use App\Framework\Pcntl\PcntlService;
+use App\Framework\Pcntl\ValueObjects\Signal;
 
 require __DIR__ . '/vendor/autoload.php';
 require __DIR__ . '/src/Framework/Debug/helpers.php';
@@ -33,13 +35,26 @@ $worker = new Worker(
     $container->get(ConsoleOutput::class),
 );
 
-pcntl_signal(SIGTERM, function () use ($worker) {
-    $worker->stop();
-});
-
-pcntl_signal(SIGINT, function () use ($worker) {
-    $worker->stop();
-});
+// Setup signal handlers using PCNTL service if available
+try {
+    $pcntlService = $container->get(PcntlService::class);
+    $pcntlService->registerSignal(Signal::SIGTERM, function () use ($worker) {
+        $worker->stop();
+    });
+    $pcntlService->registerSignal(Signal::SIGINT, function () use ($worker) {
+        $worker->stop();
+    });
+} catch (\Throwable $e) {
+    // Fallback to direct pcntl_signal if PCNTL service not available
+    if (function_exists('pcntl_signal')) {
+        pcntl_signal(SIGTERM, function () use ($worker) {
+            $worker->stop();
+        });
+        pcntl_signal(SIGINT, function () use ($worker) {
+            $worker->stop();
+        });
+    }
+}
 
 $worker->start();