commit 383ff13574fe2f9dbffbf498c474e7d8a1aaff10
Author: Masterluke77 <163446896+Masterluke77@users.noreply.github.com>
Date:   Tue Jul 7 09:40:40 2026 +0200

    chore: initialize Vendoo repository

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0e6793c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# Vendoo
+
+Vendoo ist ein lokaler Multi-Plattform Listing-Generator mit AI, Lagerverwaltung und Publishing-System.
+
+## Status
+
+- Version: `1.0.0-baseline`
+- Hauptbranch: `main`
+- Entwicklungsbranch: `develop`
+- UI-Sprache: Deutsch
+- Repository: privat
+
+Die vollständige System- und Feature-Dokumentation befindet sich in [`FEATURES.md`](FEATURES.md).
+
+## Tech Stack
+
+- Node.js + Express als ESM
+- Vanilla HTML, CSS und JavaScript ohne Framework oder Build-Schritt
+- SQLite über `better-sqlite3`
+- CSS Custom Properties für Theming und Dark Mode
+- Session-basierte Authentifizierung mit Rollen `admin` und `editor`
+
+## Projektregeln
+
+- Neue Datenbankspalten werden als Migration im `MIGRATIONS`-Array von `lib/db.mjs` ergänzt.
+- Neue API-Routen werden in `server.mjs` angelegt.
+- Neue Datenbankfunktionen werden aus `lib/db.mjs` exportiert und in `server.mjs` importiert.
+- Frontend-Tabs verwenden `data-tab`, `<section class="tab-content">` und die `TAB_TITLES`-Map.
+- Farben werden ausschließlich über CSS-Variablen definiert; Dark Mode liegt unter `[data-theme="dark"]`.
+- SKU-Format: `VD-XXXX`.
+- Schreibende Requests benötigen Authentifizierung, Rollenprüfung und CSRF-Schutz.
+
+## Betriebsmodelle
+
+1. Lokale Windows-Installation
+2. Privater Docker-Betrieb für einen geschlossenen Benutzerkreis
+3. Öffentlicher Docker-Betrieb auf einem getrennten Server/VPS
+
+Ein direktes Freigeben des NAS oder von Port `8124` ins Internet ist nicht vorgesehen.
+
+## Sicherheit
+
+Keine `.env`-Dateien, API-Schlüssel, OAuth-Tokens, SQLite-Datenbanken, Uploads, Backups oder Logs committen. Weitere Hinweise stehen in [`SECURITY.md`](SECURITY.md).
+
+## Lizenz
+
+Privates, proprietäres Projekt. Alle Rechte vorbehalten.