42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
# gerbil-manager-web
|
|
|
|
Frontend des Rennmaus-Managers — React + TypeScript + Vite, mobile-first (Smartphone und Laptop).
|
|
|
|
## Entwicklung
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Erwartet die laufende GerbilManagerWebAPI unter `http://localhost:5179`
|
|
(Profil `http` in `GerbilManagerWebAPI/Properties/launchSettings.json`).
|
|
|
|
## Konfiguration
|
|
|
|
| Variable | Standard | Beschreibung |
|
|
|---|---|---|
|
|
| `VITE_API_BASE_URL` | `http://localhost:5179` | Basis-URL der GerbilManagerWebAPI |
|
|
|
|
## Konventionen
|
|
|
|
- **Alle für Benutzer sichtbaren Texte sind Deutsch** und liegen zentral in
|
|
`src/strings/de.ts` — keine Texte direkt in Komponenten hartkodieren.
|
|
- API-Zugriffe laufen über `src/api/client.ts`.
|
|
- Routen werden in `src/App.tsx` registriert, Seiten liegen in `src/pages/`.
|
|
- **Mutationen** (`useMutation` aus `src/hooks/useApi.ts`): `run()` wirft NIE,
|
|
sondern liefert ein `MutationOutcome<T>` — `{ ok: true, value }` oder
|
|
`{ ok: false, error, cause }`. Aufrufer MÜSSEN verzweigen:
|
|
`const r = await m.run(x); if (r.ok) navigate(r.value.id)`. `m.error` treibt
|
|
die Inline-Anzeige; für Spezialfälle (z. B. HTTP 409) `r.cause` prüfen
|
|
(`r.cause instanceof ApiError && r.cause.status === 409`). So sind unbehandelte
|
|
Promise-Rejections an Aufrufstellen ausgeschlossen (siehe auch
|
|
`src/dev/unhandledRejectionGuard.ts`).
|
|
|
|
## Build
|
|
|
|
```bash
|
|
npm run build
|
|
npm run preview
|
|
```
|