4.0 KiB

Raw Permalink Blame History

Schnellstart-Anleitung

Installation in 3 Schritten

Schritt 1: Voraussetzungen prüfen

Docker Desktop installiert und gestartet
Port 3000 ist verfügbar

Schritt 2: Anwendung starten

Linux/Mac:

./start.sh

Windows: Doppelklick auf start.bat

Manuell mit Docker Compose:

docker-compose up -d

Schritt 3: Anwendung öffnen

Öffnen Sie im Browser: http://localhost:3000

Erste Schritte in der Anwendung

1. Kunden anlegen

Klicken Sie auf "Customers" in der Navigation
Klicken Sie auf "+ New Customer"
Füllen Sie die Formulardaten aus:
- Company Name: z.B. "ABC Corporation"
- Street Address: z.B. "123 Main Street"
- City: z.B. "Corpus Christi"
- State: z.B. "TX"
- Zip Code: z.B. "78401"
- Account Number: Optional, z.B. "ACC-12345"
Klicken Sie auf "Save Customer"

2. Erstes Quote erstellen

Klicken Sie auf "Quotes" in der Navigation
Klicken Sie auf "+ New Quote"
Wählen Sie einen Kunden aus dem Dropdown
Die Quote-Nummer wird automatisch generiert (z.B. 2026-01-0001)
Das Datum ist vorausgefüllt, kann aber geändert werden
Klicken Sie auf "+ Add Item" um Positionen hinzuzufügen:
- Quantity: z.B. "1" oder "2" oder "TBD"
- Description: Beschreibung des Produkts/Service
- Rate: Preis pro Einheit, z.B. "100.00" oder "150.00/hr"
- Amount: Gesamtbetrag, z.B. "100.00"
- TBD: Setzen Sie das Häkchen für "To Be Determined" Items
Bei Tax-Exempt Kunden (Churches, Non-Profits):
- Aktivieren Sie "Tax Exempt"
Bei TBD Items:
- Geben Sie eine Fußnote ein, z.B. "Total excludes labor charges..."
Klicken Sie auf "Save Quote"

3. PDF generieren

In der Quote-Liste klicken Sie auf "PDF" beim gewünschten Quote
Das PDF wird automatisch heruntergeladen

Beispiel-Workflow

Kunde "Braselton Development" ist bereits angelegt (aus init.sql)
Neues Quote erstellen:
- Customer: Braselton Development
- Quote #: 2026-01-0001 (automatisch)
- Date: Heute (automatisch)
- Item 1:
  - Qty: 1
  - Description: Lenovo Yoga Laptop Setup
  - Rate: 2,890.00
  - Amount: 2,890.00
- Item 2:
  - Qty: TBD
  - Description: Labor for installation
  - Rate: 125.00/hr
  - Amount: TBD (Checkbox aktivieren)
  - TBD Note: "Labor charges will be determined based on actual time"
- Tax: 8.25% (automatisch berechnet, außer Tax Exempt ist aktiviert)
Quote speichern
PDF herunterladen → Professionelles Dokument im Corporate Design

Nützliche Befehle

Logs ansehen

docker-compose logs -f

Anwendung stoppen

docker-compose down

Anwendung neu starten

docker-compose restart

Datenbank-Backup erstellen

docker exec quote_postgres pg_dump -U quoteuser quotedb > backup_$(date +%Y%m%d).sql

Tipps & Tricks

Quote-Nummern: Werden automatisch monatlich hochgezählt
- Januar 2026: 2026-01-0001, 2026-01-0002, ...
- Februar 2026: 2026-02-0001, 2026-02-0002, ...
TBD Items: Ideal für:
- Stundenbasierte Arbeit
- Noch nicht feststehende Mengen
- Variable Kosten
Tax Exempt: Verwenden Sie diese Option für:
- Kirchen (Churches)
- Non-Profit Organisationen
- Gemeinnützige Vereine
Bearbeitung: Alle Quotes können nachträglich bearbeitet werden
- Klicken Sie einfach auf "Edit"
- Ändern Sie die Daten
- Speichern Sie erneut
PDF-Qualität: Die PDFs entsprechen exakt Ihrer HTML-Vorlage
- Professionelles Layout
- Druckfertig
- Letterformat (8.5" x 11")

Fehlerbehebung

Port 3000 bereits belegt?

Ändern Sie in docker-compose.yml:

ports:
  - "3001:3000"  # Statt 3000:3000

Dann öffnen Sie: http://localhost:3001

Datenbank-Fehler?

docker-compose down -v  # VORSICHT: Löscht alle Daten!
docker-compose up -d

Anwendung lädt nicht?

# Prüfen Sie die Logs
docker-compose logs app

# Prüfen Sie ob Container laufen
docker ps

Support

Bei weiteren Fragen schauen Sie in die ausführliche README.md Datei.

4.0 KiB Raw Permalink Blame History