Wieland/Handwerksfreund_App
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init

Browse Source
This commit is contained in:
MarcWieland
2026-07-26 23:58:12 +02:00
commit 411ede36ef
596 changed files with 39941 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/database_schema.md
+124
View File
@@ -0,0 +1,124 @@
# Handwerksfreund - Datenstruktur & Domänenmodell
Dieses Dokument beschreibt die grundlegende Datenstruktur für das Projekt **Handwerksfreund**. Es dient als Diskussionsgrundlage für die Datenbankmodellierung in Supabase/PostgreSQL.
---
## 1. Entitäten-Übersicht
```mermaid
erDiagram
KUNDE ||--o{ VERBAUTES_TEIL : "besitzt"
KUNDE ||--o{ AUFTRAG : "beauftragt"
AUFTRAG ||--o{ VERBAUTES_TEIL : "installiert im Rahmen von"
AUFTRAG ||--o{ AUFTRAGS_ANHANG : "enthält n Dokumente/Baupläne"
KUNDE ||--o{ TERMIN_EINTRAG : "bezieht sich auf"
AUFTRAG ||--o{ TERMIN_EINTRAG : "eingeplant als"
```
---
## 2. Detaillierte Felddefinitionen
### 2.1 Kunde (`customers`)
Stammdaten der Kunden inklusive Geokoordinaten für die Kartendarstellung und Vor-Ort-Notizen.
| Feld | Datentyp | Pflichtfeld | Beschreibung / Beispiel |
| :--- | :--- | :---: | :--- |
| `id` | UUID | Ja | Eindeutige ID (Primärschlüssel) |
| `customer_number` | Text | Ja | Eindeutige Kundennummer (z.B. `K-10025`) |
| `name` | Text | Ja | Vollständiger Name / Firmenname (z.B. `Max Mustermann`) |
| `street` | Text | Ja | Straße & Hausnummer (z.B. `Musterweg 12`) |
| `zip_code` | Text | Ja | Postleitzahl (z.B. `12345`) |
| `city` | Text | Ja | Stadt (z.B. `Musterstadt`) |
| `latitude` | Float (Double) | Ja | Geografische Breite für Karten-Pin |
| `longitude` | Float (Double) | Ja | Geografische Länge für Karten-Pin |
| `distance_km` | Float (Double) | Nein | Berechnete Entfernung zum Techniker-Standort |
| `phone` | Text | Nein | Telefonnummer (z.B. `0171 1234567`) |
| `email` | Text | Nein | E-Mail-Adresse (z.B. `max.mustermann@email.de`) |
| `notes` | Text | Nein | Vor-Ort-Hinweise (z.B. `Schlüsselbox an der Garage`) |
| `first_contact_date` | Datum | Nein | Erstkontakt-Datum (z.B. `10.03.2022`) |
| `open_orders_count` | Ganzzahl | Nein | Anzahl offener Aufträge (berechnet oder gecached) |
| `last_order_date` | Datum | Nein | Datum des letzten ausgeführten Auftrags |
| `created_at` | Zeitstempel | Ja | Erstellungszeitpunkt des Datensatzes |
---
### 2.2 Verbaute Teile / Gerätekartei (`installed_parts`)
Alle beim Kunden installierten Geräte, Heizungsanlagen, Thermostate, Filter und Ersatzteile mit Seriennummern.
| Feld | Datentyp | Pflichtfeld | Beschreibung / Beispiel |
| :--- | :--- | :---: | :--- |
| `id` | UUID | Ja | Eindeutige ID (Primärschlüssel) |
| `customer_id` | UUID | Ja | Referenz auf den Besitzer (`customers.id`) |
| `order_id` | UUID | Nein | Referenz auf den Auftrag, bei dem das Teil verbaut wurde |
| `name` | Text | Ja | Produktbezeichnung (z.B. `Buderus Logamax plus GB172-24`) |
| `category` | Text | Ja | Geräte-Kategorie (z.B. `Gas-Brennwertgerät`, `Raumthermostat`) |
| `serial_number` | Text | Nein | Eindeutige Seriennummer (z.B. `8374747383`) |
| `quantity` | Ganzzahl | Ja | Anzahl verbauter Einheiten (Standard: `1`) |
| `installed_at` | Datum | Nein | Einbaudatum |
| `created_at` | Zeitstempel | Ja | Erstellungszeitpunkt des Datensatzes |
---
### 2.3 Auftrag (`work_orders`)
Aufträge und Wartungsarbeiten, die für Kunden angelegt und ausgeführt werden.
| Feld | Datentyp | Pflichtfeld | Beschreibung / Beispiel |
| :--- | :--- | :---: | :--- |
| `id` | UUID | Ja | Eindeutige ID (Primärschlüssel) |
| `customer_id` | UUID | Ja | Referenz auf den Kunden (`customers.id`) |
| `title` | Text | Ja | Titel des Auftrags (z.B. `Wartung Heizungsanlage`) |
| `description` | Text | Nein | Beschreibung & Aufgabenstellung |
| `status` | Enum | Ja | Status: `offen`, `inBearbeitung`, `abgeschlossen`, `storniert` |
| `scheduled_date` | Datum | Nein | Geplantes Ausführungsdatum |
| `completed_at` | Zeitstempel | Nein | Zeitpunkt der Fertigstellung |
| `created_at` | Zeitstempel | Ja | Erstellungszeitpunkt |
---
### 2.4 Auftrags-Anhänge & Dokumente (`order_attachments`) 📄📍
Baupläne, CAD-Zeichnungen, Fotos vor Ort, Schaltpläne und Misc-Dateien zu einem Auftrag.
> **Speicherung in Supabase**: Die eigentliche Datei (z.B. PDF, PNG) liegt im **Supabase Storage Bucket** (`order-files`). In dieser DB-Tabelle speichern wir die Metadaten & den Storage-Pfad.
| Feld | Datentyp | Pflichtfeld | Beschreibung / Beispiel |
| :--- | :--- | :---: | :--- |
| `id` | UUID | Ja | Eindeutige ID (Primärschlüssel) |
| `order_id` | UUID | Ja | Referenz auf den Auftrag (`work_orders.id`) |
| `title` | Text | Ja | Name der Datei / Anzeige-Titel (z.B. `Bauplan EG - Sanitär.pdf`) |
| `category` | Enum / Text | Ja | Kategorie: `bauplan`, `schaltplan`, `foto_vor_ort`, `abnahmeprotokoll`, `sonstiges` |
| `file_path` | Text | Ja | Pfad im Supabase Storage Bucket (z.B. `orders/ord-123/bauplan_eg.pdf`) |
| `file_size_bytes` | Ganzzahl | Nein | Dateigröße in Bytes (z.B. `2458120` für ~2.4 MB) |
| `mime_type` | Text | Nein | Dateityp (z.B. `application/pdf`, `image/png`) |
| `uploaded_at` | Zeitstempel | Ja | Upload-Zeitpunkt |
---
### 2.5 Termin-Eintrag / Tagesplan (`schedule_items`)
Zeitleisten-Einträge für die Tages- und Wochenansicht (Aufträge, Besprechungen, Mittagspause, Feierabend).
| Feld | Datentyp | Pflichtfeld | Beschreibung / Beispiel |
| :--- | :--- | :---: | :--- |
| `id` | UUID | Ja | Eindeutige ID (Primärschlüssel) |
| `order_id` | UUID | Nein | Verknüpfung zum Auftrag (falls vorhanden) |
| `customer_id` | UUID | Nein | Verknüpfung zum Kunden (falls vorhanden) |
| `title` | Text | Ja | Titel (z.B. `Max Mustermann - Heizungswartung` oder `Mittagspause`) |
| `customer_name` | Text | Nein | Kundenname für Schnellanzeige |
| `address` | Text | Nein | Einsatzadresse |
| `task_description` | Text | Nein | Spezifische Aufgabe |
| `start_time` | Uhrzeit / Text | Ja | Startzeit (z.B. `10:30`) |
| `end_time` | Uhrzeit / Text | Ja | Endzeit (z.B. `13:00`) |
| `type` | Enum | Ja | Typ: `job`, `routine`, `lunchBreak`, `feierabend` |
| `is_completed` | Boolean | Ja | Flag: Auftrag abgeschlossen |
| `is_in_progress` | Boolean | Ja | Flag: Anfahrt gestartet / in Bearbeitung |
| `scheduled_date` | Datum | Ja | Datum des Tagesplans |
| `created_at` | Zeitstempel | Ja | Erstellungszeitpunkt |
---
## 3. Offene Fragen & Diskussionspunkte
1. **Entfernung (`distance_km`)**: Sollen wir die Distanz dynamisch via Geo-Abfrage (PostGIS) zur aktuellen Handwerker-Position berechnen lassen, oder als festes Feld im Kunden speichern?
2. **Kombination `work_orders` & `schedule_items`**: Reicht ein einziges Feld `work_orders` mit Uhrzeit, oder gefällt dir die Trennung von *Auftrag* (Fachlicher Arbeitsauftrag) und *Termin-Eintrag* (Konkreter Kalendereintrag in der Zeitleiste)?
3. **Baupläne / Anhänge**: Gefällt dir die Aufteilung mit `order_attachments`? So kann ein Techniker vor Ort in Flutter auf *"Baupläne"* tippen, bekommt eine Liste aller PDFs/Fotos des Auftrags und kann per Klick direkt neue Fotos vom Handy hochladen!
docs/schema.sql
+113
View File
@@ -0,0 +1,113 @@
-- =====================================================================
-- Handwerksfreund - PostgreSQL / Supabase Schema & Initial Data
-- =====================================================================
-- 1. Kunden-Tabelle (customers)
CREATE TABLE IF NOT EXISTS customers (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
customer_number VARCHAR(50) UNIQUE NOT NULL,
name VARCHAR(255) NOT NULL,
street VARCHAR(255) NOT NULL,
zip_code VARCHAR(20) NOT NULL,
city VARCHAR(255) NOT NULL,
latitude DOUBLE PRECISION NOT NULL,
longitude DOUBLE PRECISION NOT NULL,
distance_km DOUBLE PRECISION DEFAULT 0.0,
phone VARCHAR(50),
email VARCHAR(255),
notes TEXT,
first_contact_date DATE DEFAULT CURRENT_DATE,
open_orders_count INT DEFAULT 0,
last_order_date DATE,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- 2. Verbaute Teile / Gerätekartei (installed_parts)
CREATE TABLE IF NOT EXISTS installed_parts (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
customer_id UUID REFERENCES customers(id) ON DELETE CASCADE,
name VARCHAR(255) NOT NULL,
category VARCHAR(255) NOT NULL,
serial_number VARCHAR(255),
quantity INT DEFAULT 1,
installed_at DATE DEFAULT CURRENT_DATE,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- 3. Aufträge (work_orders)
CREATE TABLE IF NOT EXISTS work_orders (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
customer_id UUID REFERENCES customers(id) ON DELETE CASCADE,
title VARCHAR(255) NOT NULL,
description TEXT,
scheduled_date DATE DEFAULT CURRENT_DATE,
status VARCHAR(50) DEFAULT 'offen', -- offen, inBearbeitung, abgeschlossen, storniert
completed_at TIMESTAMP WITH TIME ZONE,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- 4. Auftrags-Anhänge & Baupläne (order_attachments)
CREATE TABLE IF NOT EXISTS order_attachments (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
order_id UUID REFERENCES work_orders(id) ON DELETE CASCADE,
title VARCHAR(255) NOT NULL,
category VARCHAR(50) DEFAULT 'sonstiges', -- bauplan, schaltplan, foto_vor_ort, abnahmeprotokoll, sonstiges
file_path TEXT NOT NULL,
file_size_bytes BIGINT,
mime_type VARCHAR(100),
uploaded_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- 5. Termin-Einträge / Zeitleiste (schedule_items)
CREATE TABLE IF NOT EXISTS schedule_items (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
order_id UUID REFERENCES work_orders(id) ON DELETE SET NULL,
customer_id UUID REFERENCES customers(id) ON DELETE SET NULL,
title VARCHAR(255) NOT NULL,
customer_name VARCHAR(255),
address VARCHAR(255),
task_description TEXT,
start_time VARCHAR(10) NOT NULL, -- z.B. "10:30"
end_time VARCHAR(10) NOT NULL, -- z.B. "13:00"
type VARCHAR(50) DEFAULT 'job', -- job, routine, lunchBreak, feierabend
is_completed BOOLEAN DEFAULT FALSE,
is_in_progress BOOLEAN DEFAULT FALSE,
scheduled_date DATE DEFAULT CURRENT_DATE,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);
-- RLS (Row Level Security) aktivieren
ALTER TABLE customers ENABLE ROW LEVEL SECURITY;
ALTER TABLE installed_parts ENABLE ROW LEVEL SECURITY;
ALTER TABLE work_orders ENABLE ROW LEVEL SECURITY;
ALTER TABLE order_attachments ENABLE ROW LEVEL SECURITY;
ALTER TABLE schedule_items ENABLE ROW LEVEL SECURITY;
-- Öffentliche Lese- & Schreib-Policies für Prototyping
CREATE POLICY "Public Customers Access" ON customers FOR ALL USING (true) WITH CHECK (true);
CREATE POLICY "Public Parts Access" ON installed_parts FOR ALL USING (true) WITH CHECK (true);
CREATE POLICY "Public Orders Access" ON work_orders FOR ALL USING (true) WITH CHECK (true);
CREATE POLICY "Public Attachments Access" ON order_attachments FOR ALL USING (true) WITH CHECK (true);
CREATE POLICY "Public Schedule Access" ON schedule_items FOR ALL USING (true) WITH CHECK (true);
-- =====================================================================
-- Seed Data (Initial-Daten aus dem Mockup)
-- =====================================================================
INSERT INTO customers (id, customer_number, name, street, zip_code, city, latitude, longitude, distance_km, phone, email, notes, first_contact_date, open_orders_count, last_order_date)
VALUES
('a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'K-10025', 'Max Mustermann', 'Musterweg 12', '12345', 'Musterstadt', 50.1135, 8.6790, 2.4, '0171 1234567', 'max.mustermann@email.de', 'Schlüsselbox an der Garage', '2022-03-10', 1, '2024-05-15'),
('b0eebc99-9c0b-4ef8-bb6d-6bb9bd380a22', 'K-10026', 'Sabine Schulze', 'Nordring 45', '12347', 'Musterstadt', 50.1265, 8.6890, 4.1, '0160 9876543', 'sabine.schulze@example.com', 'Hund im Garten, bitte vorher anrufen.', '2021-11-04', 0, '2024-04-10'),
('c0eebc99-9c0b-4ef8-bb6d-6bb9bd380a33', 'K-10027', 'Bäckerei Hoffmann GmbH', 'Hauptstraße 88', '12345', 'Musterstadt', 50.1080, 8.6650, 1.8, '069 5551234', 'info@baeckerei-hoffmann.de', 'Zufahrt über den Lieferanteneingang Rückseite.', '2020-01-15', 2, '2024-06-01')
ON CONFLICT (customer_number) DO NOTHING;
INSERT INTO installed_parts (customer_id, name, category, serial_number, quantity)
VALUES
('a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'Buderus Logamax plus GB172-24', 'Gas-Brennwertgerät', '8374747383', 1),
('a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'Bosch EasyControl CT200', 'Raumthermostat', '1234567890', 1),
('a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'Honeywell Hauswasserfilter FF06', 'Wasserfilter', '9876543210', 1);
INSERT INTO work_orders (id, customer_id, title, status, scheduled_date)
VALUES
('d0eebc99-9c0b-4ef8-bb6d-6bb9bd380a44', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'Wartung Heizungsanlage', 'abgeschlossen', '2024-05-15'),
('e0eebc99-9c0b-4ef8-bb6d-6bb9bd380a55', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11', 'Thermostat Einstellung & Kalibrierung', 'offen', '2026-08-02');