schuettgo/docs/MVP.md

SchüttGo - MVP (Minimum Viable Product)

Release 1.0 - Kernfunktionen

Ziel

Ein funktionsfähiges System für einen kleinen Schüttgutbetrieb mit 1 Waage.

Zeitrahmen

• Entwicklung: 4-6 Wochen
• Testing: 1 Woche
• Pilotphase: 2 Wochen

---

MVP Features

1. Authentifizierung & Benutzer

• Login/Logout
• Passwort vergessen
• Benutzerrollen: Admin, Waagenbediener, Büro
• Benutzer anlegen/bearbeiten

2. Stammdaten

2.1 Kunden

• Kunde anlegen (Firma, Ansprechpartner, Adresse)
• Kunde bearbeiten
• Kunde suchen/filtern
• Kundenpreise hinterlegen

2.2 Materialien

• Material anlegen (Name, Einheit, Standardpreis)
• Materialkategorien (Kies, Sand, Schotter, etc.)
• Material bearbeiten

2.3 Fahrzeuge

• Fahrzeug anlegen (Kennzeichen, Typ, Tara)
• Fahrzeug einem Kunden zuordnen
• Tara aktualisieren

3. Wiegung (Kernmodul)

3.1 Einfahrt

• Fahrzeug auswählen (Kennzeichen-Suche)
• Kunde automatisch ermitteln
• Material auswählen
• Bruttogewicht erfassen
• Wiegung speichern

3.2 Ausfahrt

• Offene Wiegung laden
• Leergewicht (Tara) erfassen
• Nettogewicht berechnen
• Lieferschein erstellen
• Optional: Lieferschein drucken

4. Lieferschein

• Automatische Nummer
• Alle Wiegungsdaten
• PDF-Generierung
• Druckfunktion
• E-Mail-Versand (optional)

5. Einfache Rechnung

• Rechnung aus Lieferschein(en)
• Kundenpreise anwenden
• PDF-Generierung
• Rechnungsliste

6. Dashboard

• Heute: Anzahl Wiegungen, Gesamtmenge
• Offene Wiegungen (Einfahrt ohne Ausfahrt)
• Letzte 10 Wiegungen
• Schnellzugriff auf neue Wiegung

---

Nicht im MVP

❌ Waagen-Hardware-Integration (manuelle Eingabe im MVP) ❌ DATEV-Export ❌ Lagerbestandsführung ❌ Fuhrparkverwaltung ❌ GPS-Tracking ❌ Kundenportal ❌ Erweiterte Berichte

---

Technischer Scope

Frontend

• Vue 3 + FluxKit UI
• TailwindCSS
• Responsive (Desktop + Tablet)

Backend

• Deno + Oak
• PostgreSQL
• JWT Auth

Deployment

• Docker
• Nginx Reverse Proxy
• SSL (Let's Encrypt)

---

Datenmodell (MVP)

users
├── id, email, password_hash, role, name

customers
├── id, name, address, contact_name, contact_email, contact_phone

materials
├── id, name, category, unit, default_price

vehicles
├── id, license_plate, type, tara_weight, customer_id

weighings
├── id, vehicle_id, customer_id, material_id
├── gross_weight, tare_weight, net_weight
├── entry_time, exit_time, status
├── delivery_note_id

delivery_notes
├── id, number, weighing_id, customer_id
├── created_at, printed_at, emailed_at

invoices
├── id, number, customer_id
├── total_amount, status, created_at

invoice_items
├── id, invoice_id, delivery_note_id
├── quantity, unit_price, amount

---

Success Criteria

1. ✅ Kompletter Wiegezyklus (Ein-/Ausfahrt) funktioniert
2. ✅ Lieferschein wird korrekt erstellt
3. ✅ Rechnung kann generiert werden
4. ✅ System läuft stabil für 1 Benutzer
5. ✅ Response-Zeit < 1 Sekunde

---

Erstellt: 2026-02-19