update AGENTS.md and README.md

This commit is contained in:
2026-01-31 15:51:36 +01:00
parent 52446a994a
commit 4958982cf7
2 changed files with 21 additions and 7 deletions

View File

@@ -17,7 +17,8 @@ Dieses Dokument hilft AI-Assistenten (Amp, Copilot, etc.) das Projekt zu versteh
| Routing | Hash-basierter Client-Side Router (`js/router.js`) |
| i18n | Custom System (`js/i18n.js`), JSON-Dateien in `/locales/` |
| Theming | CSS Variables, Dark/Light Mode |
| Backend | Geplant: Directus |
| Backend | Directus (`api.dgray.io`) |
| Auth | UUID-basiert, anonym (`js/services/auth.js`) |
## Häufige Befehle
@@ -39,10 +40,15 @@ js/
├── app.js # Entry, lädt i18n, dann Shell
├── router.js # Hash-Router mit :params
├── i18n.js # t('key'), subscribe(), updateDOM()
├── services/
│ ├── directus.js # Directus API Client
│ ├── auth.js # UUID-basierte Authentifizierung
│ └── currency.js # XMR/Fiat Umrechnung
└── components/
├── app-shell.js # Layout, registriert Routes
├── app-header.js # Header (Theme-Toggle, Lang-Dropdown)
├── app-footer.js # Footer
├── auth-modal.js # Login/Register Modal
└── pages/ # Seiten als Web Components
css/
@@ -62,10 +68,16 @@ locales/
## Konventionen
### JavaScript
- **Keine Semikolons** am Zeilenende (außer in for-loops, CSS)
- **Englische Kommentare** im Code
- ES Modules mit `import/export`
### Web Components
- Custom Elements mit `class extends HTMLElement`
- Styles als `<style>` im `document.head` oder inline
- i18n: `render()` Methode, Subscribe auf Sprachwechsel
- Auth-Subscriber nur in `connectedCallback()`, nicht in `setupEventListeners()`
### CSS
- **Keine festen Farben** - immer `var(--color-*)` nutzen
@@ -91,7 +103,7 @@ locales/
1. Suchseite (`page-search.js`) mit Filtern ausbauen
2. Anzeige-Detailseite (`page-listing.js`) gestalten
3. Anzeige-Erstellen-Formular (`page-create.js`) fertigstellen
4. Directus Backend aufsetzen
4. Profil-Seite (`page-profile.js`) erstellen
## Farbpalette