Transferborsa
B2B-Auftragsbörse für Taxi- und Transferunternehmen und Reisebüros (Start: Tirol ↔ Flughafen München).
Architektur, Datenmodell und Phasenplan: docs/ARCHITEKTUR.md
Stand
Phase 2: Registrierung von Taxiunternehmen und Reisebüros, Anmeldung, Mitarbeiter mit Rollen und
Einladungen, Unternehmensprofile, Nachweis-Upload, Verifizierung je Geschäftsfunktion durch
Plattformadmins, Sperren/Einschränken von Konten, Audit-Protokoll.
Phase 3: Auftragsbörse unter /boerse mit Filtern, Festpreis-Übernahme und Preisangeboten, Vergabe
ohne Doppelannahme, Buchungen mit bestätigtem Preis und Verlauf, Fahrzeuge und freie Fahrten unter
/flotte, Rückfahrt-Matching (Umweg und Wartezeit geschätzt, noch ohne Routingdienst).
Reisebüros können Aufträge einstellen und Angebote annehmen. Das eigene Reisebüro-Dashboard, gezielte
Angebotsanfragen und PDF-Bestätigungen (Phase 4) fehlen noch.
Pilotbetrieb: App und Landing Page auf Deutsch und Englisch (Umschalter oben rechts, Adminbereich nur
Deutsch), Passwort zurücksetzen per E-Mail, E-Mail-Benachrichtigungen (neuer Auftrag, Angebot, Vergabe,
Storno, Beanstandung, Abschluss), Begrenzung von Anmelde-, Registrierungs- und Reset-Versuchen, Entwürfe
für Impressum, Datenschutzerklärung und Nutzungsbedingungen (vor dem Start rechtlich prüfen lassen und
die Platzhalter in eckigen Klammern ausfüllen).
Die Startseite (/) ist die öffentliche Landing Page, angemeldete Nutzer landen in der Übersicht.
Lokal starten
Voraussetzungen: Node.js 20+, PostgreSQL 14+.
npm install
cp .env.example .env # DATABASE_URL anpassen
npx prisma migrate dev # Datenbank anlegen
[email protected] ADMIN_PASSWORD='mind-12-zeichen' SEED_DEMO=1 npm run db:seed
npm run dev # http://localhost:3000
SEED_DEMO=1 legt zusätzlich [email protected] und [email protected] (Passwort demo-passwort-123) an.
Beispieldaten für die Börse (nur lokal): npm run db:demo legt fünf als „Demo“ benannte, ohne Prüfung
freigeschaltete Unternehmen mit Aufträgen, Angeboten, Buchungen und freien Fahrten an (ersetzt vorhandene
Demo-Unternehmen). Anmeldung z. B. mit [email protected] oder [email protected], Passwort demo-passwort-123.
Vercel
Das Projekt ist für Vercel vorbereitet (vercel-build, postinstall: prisma generate).
- Nur Landing Page: Repository auf vercel.com/new importieren und ohne Umgebungsvariablen deployen.
Die Startseite braucht keine Datenbank. Anmeldung und Registrierung funktionieren dann noch nicht.
- Ganze App: Eine PostgreSQL-Datenbank anlegen (z. B. Neon über den Vercel Marketplace, Region EU)
und
DATABASE_URL setzen. vercel-build führt dann vor dem Build prisma migrate deploy aus.
Den Plattformadmin einmalig mit npm run db:seed gegen diese Datenbank anlegen.
- E-Mails: Ein Konto bei Resend anlegen, die eigene Domain dort verifizieren und
RESEND_API_KEY sowie EMAIL_FROM (z. B. Transferborsa <[email protected]>) setzen. Ohne Schlüssel
werden E-Mails nicht verschickt, sondern nur ins Server-Log geschrieben.
- Links in E-Mails:
APP_URL auf die öffentliche Adresse setzen (z. B. https://taxiroute.at).
Ohne APP_URL wird die Produktions-Domain von Vercel verwendet.
Tests
Die Tests laufen gegen eine eigene Datenbank (.env.test, Standard taxiroute_test), deren Tabellen
vor jedem Test geleert werden.
createdb taxiroute_test
npm test
Prüfablauf (Beförderungsfunktion)
- Unternehmen lädt unter Nachweise Taxi-/Mietwagenkonzession und Versicherungsnachweis hoch.
- Unter Unternehmen wird die Prüfung der Funktion „Beförderungsunternehmen“ beantragt.
- Admin akzeptiert unter Administration die Dokumente und gibt die Funktion frei.
