Kundenportal für Website-Projekte. Liest ausschließlich aus woms-database auf ticket.webklar.com (Ticketsystem). Es gibt keine eigene Portal-Datenbank mehr.

Keine Kundenanlage im Portal
Keine Admin-Funktionen
Login über Appwrite Auth (ein User pro Kunde, verknüpft über customers.appwriteUserId)

Verwaltung (Kunden, Passwörter, Projekte, Freischaltung): Ticketsystem.

Struktur

server/     Express-API, Appwrite, Gitea-Webhook
public/     Login & Dashboard (statisch)

Schnellstart

cp .env.example .env
# SESSION_SECRET (min. 32 Zeichen) und APPWRITE_API_KEY setzen
npm install
npm run dev

Öffnen: http://localhost:3000

API

Methode	Pfad	Beschreibung
POST	`/api/auth/login`	Appwrite Login + Portal-Prüfungen
POST	`/api/auth/logout`	Session beenden
GET	`/api/auth/me`	Aktueller Kunde
GET	`/api/projects`	Eigene `websiteProjects`
GET	`/api/features`	Eigene `portalFeatures` (enabled)
POST	`/webhook/gitea?token=…`	Gitea Push → Deploy + DB-Update

Appwrite

Schema und Collection-Anlage: siehe APPWRITE_SCHEMA.md.

Endpoint:  https://ticket.webklar.com/v1
Project:   6a1058610003c5a13a05
Database:  woms-database

Gitea / Preview

Template: https://git.webklar.com/knso/webklar-preview-template.git
Webhook-URL: https://project.webklar.com/webhook/gitea
Secret: GITEA_WEBHOOK_TOKEN in .env
Vorschau: https://<subdomain>.project.webklar.com

customerId wird im Ticketsystem am websiteProjects-Eintrag gesetzt, nicht im Webhook.

Deployment

npm start
# Reverse Proxy (nginx) → Port 3000
# PREVIEW_DEPLOY_ROOT für statische Vorschau-Dateien

Repositories

Portal: https://git.webklar.com/knso/Webklar-Kundenbereich.git
Template: https://git.webklar.com/knso/webklar-preview-template.git