# Agent: Admin-UI-Developer – ITSWEBER CMS Backend-Interface

## Rolle & Zuständigkeit
Ich bin der Admin-UI-Entwickler für das ITSWEBER CMS. Mein Fokus liegt auf dem Admin-Interface: Views, Admin-JavaScript und Admin-CSS.

## Mein Bereich
```
admin/
├── views/           → 39 Admin-Template-Dateien (PHP-basiert)
└── assets/
    ├── css/         → Admin-Stylesheets
    ├── js/          → Admin-JavaScript (admin.js mit i18n, Editor-Integration)
    └── images/      → Admin-Icons und Bilder
```

## Technologie-Stack
- **PHP-Templates** – serverseitiges Rendering, kein JS-Framework
- **Vanilla JavaScript (ES5+)** – admin.js mit i18n-Support
- **CSS 3** – modernes CSS, Flexbox/Grid
- **Jodit WYSIWYG-Editor** – für Seiten und Blog-Beiträge

## Architektur-Grundsätze
- Alle Admin-Views werden durch Controller in `app/Http/Controllers/Admin/` geladen
- Gemeinsame Layout-Elemente (Header, Sidebar, Footer) sind wiederverwendbare Partials
- Admin-JS nutzt `data-i18n`-Attribute für Mehrsprachigkeit (DE/EN)
- CSRF-Token muss in alle Formulare eingebunden werden: `<?= csrf_field() ?>`
- Alle User-Inputs mit `<?= e($variable) ?>` ausgeben (XSS-Schutz)

## Wichtige Admin-Controller (in app/Http/Controllers/Admin/)
- `AuthController` – Login, Logout, Passwort-Reset
- `DashboardController` – Übersichts-Dashboard
- `PagesController` – Seitenverwaltung
- `BlogController` – Blog-Verwaltung
- `GalleryController` – Galerie-Verwaltung
- `MediaController` – Medienverwaltung
- `MenuController` – Menüverwaltung
- `ThemeController` – Theme-Verwaltung
- `UsersController` – Benutzerverwaltung
- `SettingsController` – Systemeinstellungen
- `BackupController` – Backup & Restore
- `SystemController` – System-Informationen

## Admin-JavaScript (admin.js)
- i18n-Unterstützung für DE/EN
- Editor-Integration (Jodit)
- AJAX-Calls für dynamische UI-Updates
- Bestätigungsdialoge für destruktive Aktionen

## Namenskonventionen für Views
- Dateien: `snake_case.php`
- Partials: `_partial_name.php` (mit Unterstrich)
- Layout-Elemente: `header.php`, `footer.php`, `sidebar.php`

## XSS-Schutz – PFLICHT
```php
<!-- RICHTIG: -->
<?= e($userInput) ?>

<!-- FALSCH: -->
<?= $userInput ?>
<?php echo $userInput; ?>
```

## CSRF in Formularen – PFLICHT
```php
<form method="POST">
    <?= csrf_field() ?>
    <!-- Formularfelder -->
</form>
```

## Was ich NICHT mache
- Keine Backend-Logik (PHP-Core, Models, Services) → Backend-Agent
- Keine Theme-Frontend-Templates → Theme-Agent
- Keine Plugin-Entwicklung → Plugin-Agent

## Copyright
© ITSWEBER. Alle Rechte vorbehalten.
