Thomas Peterson
ebaf509a2f
Stack & Setup
- Dockerisierte Dev-Umgebung (PHP 8.4-FPM, Nginx, MariaDB 11.4)
- Symfony 7.4 + API Platform 4.3, Doctrine ORM, LexikJWT, Messenger
- Vue 3 + TS (Vite), Vue Router, Pinia, Axios
Kern-Domäne & Auth
- Entitäten: User, PlatformPlan, Reseller, Company, Domain, Location,
Employee, ContactLink (UUIDv7)
- JWT-Login (/api/login), Rollen-Hierarchie, /api/me
- Mandantentrennung via API-Platform-Query-Extension (Lesen) +
TenantStampProcessor (Schreiben)
Öffentliche Profile (SSR)
- Profil-Landingpage, vCard-Download, QR-Code im Marken-Look
- Stabiler NFC/QR-Kurz-Link /t/{code} -> Redirect aufs aktuelle Profil
- Firmenspezifisches Branding (Farben/Logo) auf der Profilseite
Verwaltungsoberfläche (SPA)
- Brand-Look (dunkle Sidebar), rollenbasierte Navigation
- Dashboard, Reseller (+Provisioning), Firmen, Mitarbeiter, Standorte,
Domains, Design/Branding mit Live-Vorschau
Konzept & Doku: docs/KONZEPT.md (inkl. Wallet/Sync §12), README.md
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
103 lines
3.6 KiB
Markdown
103 lines
3.6 KiB
Markdown
# vcard4reseller
|
|
|
|
White-Label-Plattform für digitale Visitenkarten (Reseller → Firmenkunde → Mitarbeiter).
|
|
Konzept & Datenmodell: siehe [`docs/KONZEPT.md`](docs/KONZEPT.md).
|
|
|
|
## Stack
|
|
|
|
- **Backend:** Symfony 7.4 + API Platform 4.3, Doctrine ORM, LexikJWT, Messenger
|
|
- **Frontend:** Vue 3 + TypeScript (Vite), Vue Router, Pinia, Axios
|
|
- **DB:** MariaDB 11.4
|
|
- **Dev-Umgebung:** Docker (PHP-FPM, Nginx, MariaDB)
|
|
|
|
## Verzeichnisse
|
|
|
|
```
|
|
backend/ Symfony-API (JSON/JSON-LD)
|
|
frontend/ Vue-3-SPA (Dashboards)
|
|
docker/ Dockerfile (PHP) + Nginx-Config
|
|
docs/ Konzept & Datenmodell
|
|
```
|
|
|
|
## Schnellstart
|
|
|
|
Voraussetzung: Docker + Node 25.
|
|
|
|
```bash
|
|
# 1) Backend-Stack starten (PHP, Nginx, MariaDB)
|
|
export UID=$(id -u) GID=$(id -g)
|
|
docker compose up -d php nginx mariadb
|
|
|
|
# 2) JWT-Schlüssel erzeugen (einmalig)
|
|
docker compose exec php php bin/console lexik:jwt:generate-keypair --skip-if-exists
|
|
|
|
# 3) Frontend (Dev-Server mit API-Proxy auf :8080)
|
|
cd frontend && npm install && npm run dev
|
|
```
|
|
|
|
- API: http://localhost:8080/api
|
|
- Frontend: http://localhost:5173
|
|
- MariaDB: localhost:3306 (DB `vcard4reseller`, User `app` / `app`)
|
|
|
|
### Nützliche Befehle
|
|
|
|
```bash
|
|
# Symfony-Console im Container
|
|
docker compose exec php php bin/console <cmd>
|
|
|
|
# Migration erstellen / ausführen
|
|
docker compose exec php php bin/console doctrine:migrations:diff
|
|
docker compose exec php php bin/console doctrine:migrations:migrate
|
|
```
|
|
|
|
## Status
|
|
|
|
**Phase 0 (Setup) + Phase 1 (Kern-Domäne & Auth) abgeschlossen.**
|
|
|
|
Phase 1 umfasst: Entitäten (User, PlatformPlan, Reseller, Company, Domain,
|
|
Location, Employee, ContactLink), JWT-Login (`POST /api/login`),
|
|
Rollen-Hierarchie und automatische Mandantentrennung über eine
|
|
API-Platform-Query-Extension (`src/Doctrine/TenantExtension.php`).
|
|
|
|
Demo-Daten via `docker compose exec php php bin/console app:seed`:
|
|
|
|
| Rolle | E-Mail | Passwort |
|
|
|-------|--------|----------|
|
|
| Plattform-Admin | admin@vcard4reseller.de | admin |
|
|
| Reseller-Admin | reseller@demo.de | reseller |
|
|
| Firmen-Admin | firma@muster.de | firma |
|
|
|
|
**Phase 2 (öffentliche Profile) läuft.** Bereits umgesetzt: serverseitig
|
|
gerenderte Profilseite, vCard-Download und QR-Code im Marken-Look von
|
|
vcard4reseller.de (Design-Tokens in `backend/public/assets/brand.css`,
|
|
Referenz in `docs/design-reference/`).
|
|
|
|
Öffentliche Endpunkte (kein Login):
|
|
|
|
- `GET /p/{firma}/{mitarbeiter}` — Profil-Landingpage (Twig/SSR)
|
|
- `GET /p/{firma}/{mitarbeiter}/vcard.vcf` — vCard-Download
|
|
- `GET /p/{firma}/{mitarbeiter}/qr.png` — QR-Code (codiert die stabile Kurz-URL)
|
|
- `GET /t/{code}` — stabiler NFC/QR-Kurz-Link → Redirect aufs aktuelle Profil
|
|
|
|
Beispiel (nach `app:seed`): http://localhost:8080/p/muster/erika-mustermann
|
|
|
|
**Verwaltungsoberfläche (Vue-SPA) läuft.** Echtes Login gegen `/api/login`,
|
|
rollenbasierte App-Shell (dunkle Sidebar + Topbar im Brand-Look) und live an
|
|
die API gebundene Screens:
|
|
|
|
- **Dashboard** — Kennzahlen (rollenabhängig: Reseller/Firmen/Mitarbeiter/…)
|
|
- **Reseller** — Übersicht + Anlegen inkl. Admin-Zugang (nur Plattform-Admin)
|
|
- **Firmen** — Liste + Anlegen/Löschen (Reseller)
|
|
- **Mitarbeiter** — Tabelle, Suche, Anlegen/Bearbeiten/Löschen, Link zur öffentlichen Profilseite
|
|
- **Standorte**, **Domains** — Liste + Anlegen (Domains mit A-Record-Hinweis)
|
|
- **Design** — firmenspezifisches Branding (Primärfarbe/Logo) mit Live-Vorschau
|
|
- **Einstellungen** — Platzhalter
|
|
|
|
`/api/me` liefert der SPA Rollen + Mandantenkontext.
|
|
|
|
Start: `cd frontend && npm run dev` → http://localhost:5173 (Login z. B.
|
|
reseller@demo.de / reseller).
|
|
|
|
Nächster Schritt: Wallet-Pässe (Konzept §12, Google zuerst), E-Mail-Signaturen,
|
|
Druckdaten. Siehe `docs/KONZEPT.md` §9.
|