glanzlicht / MACHWEIS

Mach’s. Beleg’s. Rechne es ab. MACHWEIS ist eine Local-First-Flutter-App für schnelle, kontrollierbare Leistungsnachweise im Handwerk. Die Oberfläche läuft auf iOS, Android und im Web und ist vollständig deutschsprachig.

Verified secure showcase

180 Files 605 KB Public size 26 Redacted Dart · PHP · SQL · Markdown · XML · PLIST

Project overview

MACHWEIS is a verified code showcase with 180 visible project entries across 8 top-level modules. The primary detected language is Dart; protected files remain visible in the structure while their contents stay private.

README

MACHWEIS

Mach’s. Beleg’s. Rechne es ab.

Produktansicht

MACHWEIS Dashboard auf Laptop und Smartphone

MACHWEIS ist eine Local-First-Flutter-App für schnelle, kontrollierbare Leistungsnachweise im Handwerk. Die Oberfläche läuft auf iOS, Android und im Web und ist vollständig deutschsprachig.

Aktueller Funktionsumfang

lokale Firmen-, Kunden-, Auftrags- und Mitarbeiterdaten (SQLite auf Android/iOS, Browser-Speicher im Web)
mobile Stammdaten-Synchronisation für Kunden, Baustellen, Aufträge, Mitarbeiterprofile und Auftragszuweisungen über die serverseitigen Push-/Pull-Endpunkte
atomare lokale Änderungen mit Outbox, Cursor, Retry, sichtbaren Konflikten und einer ausdrücklichen Importentscheidung bei der ersten Verbindung
unveränderliche Berichtsversionen mit sichtbarem Prüfverlauf
persistente Offline-Synchronisationswarteschlange mit Retry-Strategie
lokale Fotodokumentation per Kamera, Galerie oder Web-Dateiauswahl
gebrandete PDF-Leistungsnachweise mit Unterschrift, Fotodokumentation und vorbereitetem Teilen per E-Mail
prüfpflichtiger KI-Assistent für Baustellennotizen mit OpenAI, Google Gemini oder eigenem Proxy
Rollen: Inhaber, Büro, Bauleiter und Monteur
strukturierte Arbeitszeit mit Leistungsdatum, Pause und Nettozeit
mehrere Leistungs- und Materialpositionen
Zusatzaufträge mit Kundenbestätigung
Vollständigkeitsprüfung vor Unterschrift
digitale Kundenunterschrift und unveränderlicher Abschluss
CSV-Export und vorbereitete PDF-Renderer-Schnittstelle
responsive Smartphone- und Webnavigation
aktuelle App-Version und Build-Nummer dauerhaft am unteren Rand der Navigation

Lokale Entwicklung

flutter pub get
flutter analyze
flutter test
flutter run -d chrome

Produktkontext und technische Leitplanken stehen in [docs/PRODUCT_BRIEF.md](docs/PRODUCT_BRIEF.md). Architektur und Serververtrag der KI-Unterstützung beschreibt [docs/AI_INTEGRATION.md](docs/AI_INTEGRATION.md).

Die Stammdaten-Synchronisation ist ausschließlich für iOS und Android aktiviert. Sie verwendet das Access-Token der mobilen Anmeldung und erneuert es bei Bedarf über die bestehende Authentifizierung. Im Web bleibt die Synchronisation bewusst deaktiviert.

Backend-Grundgerüst

Das separate PHP-8.4-REST-Grundgerüst liegt in [backend/](backend/README.md). Es enthält in diesem Stand ausschließlich Infrastruktur und den Health-Endpunkt; Login, Fachlogik und KI sind noch nicht enthalten.

backend/migrations/003_master_data.sqlSQL

CREATE TABLE IF NOT EXISTS customers (id CHAR(36) PRIMARY KEY, tenant_id CHAR(36) NOT NULL, name VARCHAR(200) NOT NULL, contact VARCHAR(200) NOT NULL DEFAULT '', email VARCHAR(320) NOT NULL DEFAULT '', phone VARCHAR(80) NOT NULL DEFAULT '', address TEXT NOT NULL, row_version INT NOT NULL DEFAULT 1, created_at DATETIME NOT NULL, updated_at DATETIME NOT NULL, deleted_at DATETIME NULL, INDEX customers_tenant_name (tenant_id, name), CONSTRAINT customers_tenant_fk FOREIGN KEY (tenant_id) REFERENCES tenants(id));

CREATE TABLE IF NOT EXISTS sites (id CHAR(36) PRIMARY KEY, tenant_id CHAR(36) NOT NULL, customer_id CHAR(36) NOT NULL, name VARCHAR(200) NOT NULL, address TEXT NOT NULL, row_version INT NOT NULL DEFAULT 1, created_at DATETIME NOT NULL, updated_at DATETIME NOT NULL, deleted_at DATETIME NULL, INDEX sites_tenant_customer (tenant_id, customer_id), CONSTRAINT sites_tenant_fk FOREIGN KEY (tenant_id) REFERENCES tenants(id), CONSTRAINT sites_customer_fk FOREIGN KEY (customer_id) REFERENCES customers(id));

CREATE TABLE IF NOT EXISTS jobs (id CHAR(36) PRIMARY KEY, tenant_id CHAR(36) NOT NULL, customer_id CHAR(36) NOT NULL, site_id CHAR(36) NULL, number VARCHAR(100) NOT NULL, title VARCHAR(200) NOT NULL, description TEXT NOT NULL, status VARCHAR(30) NOT NULL DEFAULT 'open', row_version INT NOT NULL DEFAULT 1, created_at DATETIME NOT NULL, updated_at DATETIME NOT NULL, deleted_at DATETIME NULL, UNIQUE KEY jobs_tenant_number (tenant_id, number), INDEX jobs_tenant_customer (tenant_id, customer_id), CONSTRAINT jobs_tenant_fk FOREIGN KEY (tenant_id) REFERENCES tenants(id), CONSTRAINT jobs_customer_fk FOREIGN KEY (customer_id) REFERENCES customers(id), CONSTRAINT jobs_site_fk FOREIGN KEY (site_id) REFERENCES sites(id));

CREATE TABLE IF NOT EXISTS job_assignments (id CHAR(36) PRIMARY KEY, tenant_id CHAR(36) NOT NULL, job_id CHAR(36) NOT NULL, employee_id CHAR(36) NOT NULL, assigned_from DATETIME NULL, assigned_until DATETIME NULL, row_version INT NOT NULL DEFAULT 1, created_at DATETIME NOT NULL, updated_at DATETIME NOT NULL, deleted_at DATETIME NULL, UNIQUE KEY assignments_job_employee (job_id, employee_id), CONSTRAINT assignments_tenant_fk FOREIGN KEY (tenant_id) REFERENCES tenants(id), CONSTRAINT assignments_job_fk FOREIGN KEY (job_id) REFERENCES jobs(id));

Architecture

High-level modules detected from the verified public snapshot. Protected implementation details are intentionally omitted.

backendmodule

libmodule

iosmodule

testmodule

androidmodule

docsmodule

webmodule

assetsmodule

Technology stack

DartPHPLOCKPBXPROJSQLMarkdownFlutter / Dart

Dart66.7%

PHP14.5%

LOCK4.0%

PBXPROJ3.8%

SQL3.1%

Markdown1.3%

XML0.9%

YAML0.9%