55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
# Dev-Setup & Live-Verifikation
|
|
|
|
## Voraussetzungen
|
|
- Node ≥ 20, pnpm 10
|
|
- Eine laufende MariaDB/MySQL (lokal reicht)
|
|
|
|
## 1. Dependencies
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
## 2. .env konfigurieren
|
|
`.env` im Repo-Root (aus `.env.example` kopieren) und die DB-Zugangsdaten setzen.
|
|
**Wichtig:** eine DEDIZIERTE Test-DB nutzen, NICHT die echte QBox-DB:
|
|
|
|
```dotenv
|
|
DB_HOST=127.0.0.1
|
|
DB_PORT=3306
|
|
DB_USER=root
|
|
DB_PASSWORD=DEIN_MARIADB_PASSWORT
|
|
DB_NAME=d4rk_mdt_dev # isolierte Test-DB — wird automatisch angelegt
|
|
|
|
VITE_DEV_AUTH_BYPASS=true # Browser-Login im Dev umgehen (Mock-Officer)
|
|
```
|
|
|
|
## 3. Test-DB anlegen + seeden
|
|
```bash
|
|
pnpm db:setup:dev
|
|
```
|
|
Das Script (idempotent, non-destruktiv):
|
|
1. legt die DB `d4rk_mdt_dev` an (falls nicht vorhanden),
|
|
2. erstellt QBox-Stand-in-Tabellen `players` / `player_vehicles`,
|
|
3. spielt die `mdt_*`-Migrationen ein,
|
|
4. seedet 3 Test-Bürger, 3 Fahrzeuge, 3 Strafen.
|
|
|
|
Erwartete Ausgabe endet mit: `[setup-dev] Seed abgeschlossen ✅`
|
|
|
|
## 4. Starten
|
|
```bash
|
|
pnpm dev # api :3000 + web :5173 (Turborepo, parallel)
|
|
```
|
|
Browser: http://localhost:5190
|
|
|
|
## 5. Verifizieren (Testdaten)
|
|
- **Personen** → Suche `Max` oder `Erika` → Detail öffnen (Job, Lizenzen, Notizen speichern, Fahndung togglen)
|
|
- **Fahrzeuge** → Kennzeichen `COP 007` oder `MAX 001` → „Als gestohlen markieren"
|
|
|
|
## Gegen die echte QBox-DB (später, produktiv)
|
|
`DB_NAME` auf die echte QBox-DB zeigen und **nur** die Migrationen einspielen
|
|
(erzeugt ausschließlich `mdt_*`-Tabellen, fasst QBox-Tabellen nie an):
|
|
```bash
|
|
pnpm db:migrate
|
|
```
|
|
`pnpm db:setup:dev` dort NICHT ausführen (das legt QBox-Stand-in-Tabellen + Testdaten an).
|