Vendoo – Feature-Dokumentation

Lokaler Multi-Plattform Listing-Generator mit AI, Lagerverwaltung und Publishing-System.
Stand: 2026-07-07 | Version 1.0.0

Verbindlicher Tech Stack

Backend: Node.js + Express als ESM
Frontend: Vanilla HTML/CSS/JavaScript ohne Framework und ohne Build-Schritt
Datenbank: SQLite über better-sqlite3 im WAL-Modus
AI: Anthropic Claude, OpenAI, OpenRouter und Ollama
Bildverarbeitung: sharp
Rich Text: Quill
QR-Codes: QRious
E-Mail: Nodemailer
Auth: Scrypt, Sessions, Magic Links, Rollen admin und editor, CSRF
Browser-Erweiterung: Chrome Manifest v3

Verbindliche Projektstruktur

server.mjs: Express-Server und API-Routen
lib/db.mjs: Datenbankzugriff und MIGRATIONS-Array
lib/*.mjs: Auth, AI, Bilder, Gebühren, Kategorien, Mailer und Plattform-APIs
platforms/*.mjs: plattformspezifische Prompt- und Parsing-Logik
public/index.html: Single-Page-Oberfläche
public/app.js: gesamte Frontend-Logik
public/style.css: Styling und Dark Mode
extension/: Chrome-Erweiterung
db/schema.sql: Datenbankschema
uploads/: lokale Produktfotos, nicht versioniert

Entwicklungsregeln

Neue DB-Spalten werden als neue Migration im MIGRATIONS-Array von lib/db.mjs ergänzt.
Migrationen verwenden das bestehende try/catch ALTER TABLE-Muster.
Neue DB-Funktionen werden aus lib/db.mjs exportiert und in server.mjs importiert.
Neue API-Routen werden in server.mjs angelegt.
Sidebar-Navigation verwendet data-tab.
Tab-Inhalte sind <section class="tab-content">.
Topbar-Titel werden über die TAB_TITLES-Map gesteuert.
Dark Mode verwendet ausschließlich CSS Custom Properties unter [data-theme="dark"].
Die UI ist deutschsprachig.
SKUs werden im Format VD-XXXX erzeugt.
Schreibende Requests benötigen Session, Rollenprüfung und CSRF-Token.

Funktionsbereiche

AI-Listing-Generator
Foto-Management und Bildeditor
Listing-Verwaltung und Historie
Vorlagen-System
Publishing-System einschließlich Smart Copy, Etsy, eBay und Warteschlange
Lagerverwaltung
SKU-System
Gebührenrechner
Kategorie-System
Etiketten- und Datenblattdruck
Authentifizierung und Benutzerverwaltung
SMTP und E-Mail
Systeminformationen, Backup und Restore
Chrome-Erweiterung für Vinted
Einstellungen und Provider-Konfiguration
Responsive UI, Dark Mode, Toasts und Quill
Windows-Installer mit Install, Start, Update, Repair, Uninstall und Status

Datenbereiche

Zentrale Tabellen:

listings
templates
publish_log
ebay_queue
scheduled_publish
settings
users
sessions
auth_tokens
rate_limits
audit_log
login_history

Online- und Docker-Zielbild

Vendoo soll zusätzlich zur lokalen Windows-Installation später als Docker-Anwendung betrieben werden können. Für öffentliche Nutzer ist ein von privaten NAS-Daten getrennter Server/VPS vorgesehen. Der NAS-Betrieb ist nur für private Nutzung oder einen streng geschlossenen Testkreis vorgesehen.

Zwingende Grundlagen:

konfigurierbare Pfade für Datenbank, Uploads und Backups
PUBLIC_BASE_URL
Reverse-Proxy-Unterstützung und begrenztes trust proxy
HTTPS und sichere Cookies
Health- und Readiness-Endpunkte
Secrets-Unterstützung
nicht privilegierter Container
konsistente SQLite-Backups
gehärtete Upload-Verarbeitung
dynamische OAuth-Callbacks
spätere Organisations- und Mandantentrennung vor öffentlichem Mehrkundenbetrieb

Die ausführliche ursprüngliche Feature-Dokumentation bleibt die fachliche Referenz und soll zusammen mit dem lokalen Quellprojekt vollständig importiert werden.

3.6 KiB Raw Permalink Blame History Unescape Escape