myBusiness — Developer Documentation

Schichten

1. Page.Appearing → EventToCommandBehavior feuert LoadCommand
2. CustomersViewModel.LoadAsync() → DataService.CheckPrerequisites()
3. CheckPrerequisites() prüft: Connectivity.NetworkAccess != None + IsLoggedIn + CompanyId != null
4. DataService.GetCustomersAsync() → LoadCollectionAsync("customers", MapCustomer)
5. FirebaseRestService.GetCollectionAsync(companyId, "customers")
6. FirebaseAuthService.GetValidTokenAsync() → Token aus Preferences oder Refresh
7. HTTP GET → https://firestore.googleapis.com/v1/projects/mytime-7c3cd/databases/(default)/documents/companies/{uid}/customers
8. Response: FirestoreListResponse { documents: [...] }
9. Jedes Dokument → MapCustomer(doc, companyId) → LocalCustomer
10. ViewModel: Customers = new ObservableCollection<LocalCustomer>(list) → UI aktualisiert

Base URL

https://firestore.googleapis.com/v1/projects/mytime-7c3cd/databases/(default)/documents

Collection (Liste)

{BaseUrl}/companies/{companyId}/{collection}
// z.B.: .../documents/companies/abc123uid/customers

Dokument (Einzeln)

{BaseUrl}/companies/{companyId}/{collection}/{docId}
// z.B.: .../documents/companies/abc123uid/customers/k1a2b3c4

Alle Collections

Aufgabe

Verwaltet Login, Token-Lifecycle und CompanyId. Alles in Preferences gespeichert.

Properties

Token-Flow

GetValidTokenAsync()
  → TokenExpiry in Preferences > UtcNow + 5min?
    → ja: return IdToken aus Preferences
    → nein: RefreshTokenAsync()
      → POST securetoken.googleapis.com/v1/token
      → neues IdToken + RefreshToken → Preferences
      → return neues IdToken

Methoden

Aufgabe

Low-level HTTP-Wrapper für Firestore REST API. Kein Business-Logic. Alle Methoden brauchen ein valides Token (→ wird intern per GetValidTokenAsync() geholt).

Methoden

Fehlerverhalten

Bei HTTP-Fehler: loggt Warning + Response-Body, gibt leere Liste / null / false zurück. Keine Exception nach oben.

Aufgabe

Zentrale Datenschicht. Einzige Abhängigkeit der ViewModels für Datenzugriff. Enthält alle Firestore-Mapper.

CheckPrerequisites()

Alle List-ViewModels rufen CheckPrerequisites() als erstes auf. Bei Fehler → Toast + früher Return.

Typed Getters (Collections)

Typed Single-Item Getters

Für jede Collection: GetXxxAsync(string id) → liefert einzelnes Objekt oder null.

Beispiel: GetCustomerAsync(id), GetProjectAsync(id), ...

CRUD

Thin wrapper um DataService für Firmeneinstellungen. Wird von Detail-VMs (Invoice, Quote) und SettingsViewModel genutzt.

public Task<LocalCompanySettings> GetAsync()
    => _data.GetSettingsAsync();

public Task<bool> SaveAsync(LocalCompanySettings settings)
    => _data.SaveSettingsAsync(settings);

Wenn noch keine Settings in Firestore: GetSettingsAsync() gibt Fallback-Defaults zurück (TaxRate=20, Currency=EUR, etc.).

Generiert PDFs mit Syncfusion.PDF. Abhängigkeiten: SettingsService (Firmeninfos) + DataService (Kundendaten für Anschrift).

Gibt string? filePath zurück → wird via Share.RequestAsync() geteilt.

Alle C#-Klassen, die Firestore-Daten repräsentieren. Kein SQLite mehr nötig — die Attribute bleiben aber kompatibel für spätere Offline-Erweiterung.

Basis-Klasse LocalBase

public class LocalBase {
  public string Id        { get; set; }  // Firestore Document ID
  public string CompanyId { get; set; }  // = Firebase Auth UID
  public string? CreatedAt { get; set; }
  public string? UpdatedAt { get; set; }
  public SyncState SyncState { get; set; }  // für künftigen Offline-Support
}

Models Übersicht

FirestoreValue Union-Typ

Firestore REST gibt Werte in einem Union-Objekt zurück. Nur eine Property ist gesetzt:

// Firestore REST Response (JSON)
{
  "fields": {
    "name":      { "stringValue":    "Acme GmbH" },
    "taxRate":   { "doubleValue":    20.0 },
    "count":     { "integerValue":  "42" },  // ← String! nicht Number!
    "active":    { "booleanValue":  true },
    "createdAt": { "timestampValue": "2024-01-15T10:00:00Z" },
    "deleted":   { "nullValue":     "NULL_VALUE" }
  }
}

Getter-Extension-Methoden (auf Dictionary)

DocumentId Extraction

public string DocumentId => name?.Split('/').LastOrDefault() ?? "";
// name = ".../documents/companies/uid/customers/abc123"
// → DocumentId = "abc123"

Properties & Helpers

Pattern in jedem LoadAsync

[RelayCommand]
private async Task LoadAsync()
{
    if (IsBusy) return;                              // 1. double-fire guard
    var err = _data.CheckPrerequisites();
    if (err is not null) { await ShowErrorAsync(err); return; } // 2. network/auth guard
    IsBusy = true;
    try   { /* Firestore-Laden */ }
    finally { IsBusy = false; }                       // 3. immer freigeben
}

• 🔲
  Eingeloggt? Preferences prüfen: user_id und company_id müssen gesetzt sein. Nach frischem Login: SetCompanyId(userId) in LoginViewModel.
• 🔲
  Firestore-Pfad korrekt? Daten in Firestore müssen unter companies/{uid}/customers etc. liegen. Web-App und MAUI-App müssen dieselbe Struktur verwenden!
• 🔲
  Token gültig? GetValidTokenAsync() — wenn Token abgelaufen UND kein RefreshToken → gibt null zurück → alle Requests silent fail. Fix: neu einloggen.
• 🔲
  Firestore Security Rules? Erlauben authenticated User Lesezugriff auf /companies/{uid}/**? Test im Firebase Console → Firestore → Rules.
• 🔲
  Netzwerk? Debug-Logs: GetCollection customers → 200, 0 docs = Netz OK aber Collection leer. GetCollection customers → 403 = Security Rules. GetCollection customers → 404 = Pfad falsch.
• 🔲
  Emulator? Auf iOS-Simulator: Connectivity gibt manchmal Unknown zurück. Bug #2 behebt das. Trotzdem auf Device testen.
• 🔲
  CheckPrerequisites() Fehler sichtbar? Toast-Meldung erscheint kurz bei Fehler. In Konsole nach [Warning] GetCollection suchen.
• 🔲
  Web-App: Timestamp-Crash? Fehlermeldung startedAt.startsWith is not a function → ein Datumsfeld wird als Firestore Timestamp-Objekt geliefert. Fix: normalizeDoc() in useCollection.ts konvertiert alle Timestamps. MAUI-Seite: startedAt muss als Fv.Str() gespeichert werden (nicht Fv.Ts()).
• 🔲
  Services/Tätigkeiten leer? LocalProject.ServiceIdsJson muss ein valides JSON-Array enthalten (["id1","id2"]). Leerer String oder null → alle Services werden angezeigt (Fallback). Prüfen in Firestore Console: Feld serviceIdsJson in den Projekt-Dokumenten.
• 🔲
  Diagnose-Panel verwenden! (v2.2) In den Einstellungen → Sektion "Diagnose & Verbindung" → zeigt UserId, CompanyId, Token-Ablauf, Netzwerkstatus. Button "Verbindung testen" macht einen echten Firestore-Call und zeigt den HTTP-Status. Damit sofort sehen ob Token OK ist.
• 🔲
  welcome_seen Bug (v2.1 → v2.2 fix): Vor v2.2 wurde die OnboardingSeen-Preference nach dem Login NIE gesetzt (falscher Preference-Key "welcome_seen" statt PrefKeys.OnboardingSeen). Fix: LoginViewModel setzt jetzt Preferences.Set(PrefKeys.OnboardingSeen, true) nach erfolgreichem Login.

Alle Services verwenden ILogger<T>. In DEBUG: Ausgabe via builder.Logging.AddDebug() im IDE-Output-Window sichtbar.

Wichtige Log-Zeilen

Logs anzeigen

// Visual Studio: Debug Output Window (Dropdown: "Debug")
// Rider: Run → Debug Output
// Android: adb logcat -s "myBusiness"
// iOS Simulator: Console.app → Filter "myBusiness"

1. Kunden — Offene Posten

CustomerDetailViewModel lädt beim Öffnen eines Kunden parallel Rechnungen und Angebote und filtert auf offene Statuswerte.

XAML: Tab "Offene Posten" mit Zähler-Badge zeigen, wenn OpenItemCount > 0.

2. Projekte — Kunden-Filter

ProjectsViewModel hält die vollständige Liste intern (_allProjects) und exponiert FilteredProjects gefiltert nach SelectedCustomerFilter.

// Filter setzen (XAML: Picker mit Customers-Liste)
SelectedCustomerFilter = customer;   // → Projects wird neu befüllt

// Filter zurücksetzen
ClearFilterCommand.Execute(null);

Kein extra Firestore-Request: Filter funktioniert rein in-memory auf der geladenen Liste.

3. Zeiterfassung — Tätigkeiten (Services) pro Projekt

TimeTrackingViewModel lädt alle Tätigkeiten aus dem Katalog in _allServices. Sobald der User ein Projekt auswählt, wird Services automatisch gefiltert:

// partial void wird automatisch von CommunityToolkit aufgerufen
partial void OnSelectedProjectChanged(LocalProject? value)
{
    SelectedService = null;
    var ids = JsonSerializer.Deserialize<List<string>>(value.ServiceIdsJson);
    Services = new(..._allServices.Where(s => ids.Contains(s.Id)));
}

Beim Stopp des Timers: ServiceId = SelectedService?.Id und HourlyRate = SelectedService?.DefaultHourlyRate werden im TimeEntry gespeichert.

4. Rechnungen — Zeiten importieren

InvoiceDetailViewModel lädt beim Öffnen auch Zeiteinträge, Projekte und Tätigkeiten. Sobald ein Kunde ausgewählt ist, werden importierbare Einträge berechnet.

Gruppirungs-Logik: Einträge werden nach ServiceId (Fallback: ProjectId) gruppiert. Pro Gruppe entsteht eine LineItem:

description = $"{tätigkeitsName} ({Stunden}h {Minuten}m)"
quantity    = Gesamtminuten / 60.0   // z.B. 2.5
unitPrice   = DefaultHourlyRate der Tätigkeit
unit        = "Std."

1. Tablet-Layout — Persistente Sidebar-Navigation

Ab Fensterbreite ≥ 768 dp wechselt die App automatisch von der Bottom-TabBar (Phone) zur linken Sidebar-Navigation (Tablet/Desktop).

Aktives Element hervorheben

AppShell.Navigated-Event → UpdateActiveSidebarItem(location): Sucht den passenden Border per FindByName() und setzt BackgroundColor auf Primary @12% Opacity (hell) / @18% Opacity (dunkel).

// Breite-Trigger in AppShell.xaml.cs
private void UpdateAdaptiveLayout()
{
    var isTablet = (Window?.Width ?? 0) >= 768;
    FlyoutBehavior       = isTablet ? FlyoutBehavior.Locked : FlyoutBehavior.Disabled;
    MainTabBar.IsVisible = !isTablet;
}

2. Diagnose-Panel in SettingsPage

SettingsViewModel wurde um Diagnose-Eigenschaften erweitert. Die SettingsPage zeigt jetzt eine "Diagnose & Verbindung" Sektion am Ende.

RefreshDiagnostics() wird automatisch am Ende von LoadAsync() aufgerufen.

Konstruktor: SettingsViewModel(SettingsService, FirebaseAuthService, DataService) — DataService per DI injiziert (bereits als Singleton registriert, kein MauiProgram-Update nötig).

3. Bug-Fix: welcome_seen Preference-Key

In LoginViewModel.LoginAsync(): Der bisher verwendete Hardcode-Key "welcome_seen" wurde durch PrefKeys.OnboardingSeen ersetzt. Außerdem wird nach erfolgreichem Login Preferences.Set(PrefKeys.OnboardingSeen, true) gesetzt, damit der Welcome-Screen nur einmalig erscheint.

Adaptive Navigation: Phone vs. Tablet

Shell.FlyoutBehavior-Werte

Wichtig: Phone-Navigation beim Tablet-Modus

Wenn MainTabBar.IsVisible = false gesetzt ist, sind die TabBar-Seiten (Dashboard, Kunden, Projekte, Zeit) noch immer per GoToAsync(Routes.XYZ) erreichbar. Die Sidebar-Buttons verwenden dieselben Routes-Konstanten. Die "Mehr"-Seite (MorePage) ist auf Tablet nicht zugänglich — alle Menüpunkte sind direkt in der Sidebar.

Sidebar-Items

// Border mit x:Name für aktive Hervorhebung aus Code-behind
<Border x:Name="SidebarItemDashboard" Style="{StaticResource SidebarItem}">
    <Grid ColumnDefinitions="28,*">
        <Label Text="⊞" .../>
        <Label Grid.Column="1" Text="Dashboard" Style="{StaticResource SidebarItemLabel}"/>
    </Grid>
    <Border.GestureRecognizers>
        <TapGestureRecognizer Tapped="OnSidebarDashboard"/>
    </Border.GestureRecognizers>
</Border>

Aktive Hervorhebung (Code-behind)

private static readonly Dictionary<string, string> RouteToSidebarName = new()
{
    { "dashboard", "SidebarItemDashboard" },
    { "customers", "SidebarItemCustomers"  },
    // ... alle 11 Items
};

private void UpdateActiveSidebarItem(string location)
{
    // Reset vorheriges
    if (_activeSidebarBorder is not null)
        _activeSidebarBorder.BackgroundColor = Colors.Transparent;

    foreach (var (keyword, elementName) in RouteToSidebarName)
    {
        if (!location.Contains(keyword)) continue;
        if (FindByName(elementName) is Border border)
        {
            var isDark = Application.Current?.RequestedTheme == AppTheme.Dark;
            border.BackgroundColor = isDark ? ActiveBgDark : ActiveBgLight;
            _activeSidebarBorder = border;
        }
        break;
    }
}

Statische Hilfsklasse in Helpers/FirestoreFieldBuilder.cs. Wandelt jedes Local-Model in ein Dictionary<string, FirestoreValue> für den PATCH-Request um.

Wichtige Regel: String vs. Timestamp

1. Kritischer Fix — Auth-Fehler-Propagierung

Bisher wurden Auth-Fehler (abgelaufenes Token, kein Token) still verschluckt. Beide Stellen wurden gefixt:

// FirebaseRestService.cs — vorher
if (token is null) return [];

// FirebaseRestService.cs — nachher
if (token is null)
{
    _log.LogWarning("GetCollection {Col}: kein Token — Sitzung abgelaufen", collection);
    throw new UnauthorizedAccessException("Sitzung abgelaufen. Bitte melde dich neu an.");
}

2. Dashboard — Neue KPIs & Budget-Warnungen (MAUI + Web)

DashboardViewModel wurde um folgende Properties erweitert:

public record ProjectBudgetInfo(
    string Title, string CustomerName,
    double BudgetHours, double UsedHours,
    double PercentUsed, bool IsExceeded);

Budget-Warnung wird ausgelöst wenn: UsedHours / BudgetHours >= 0.80. In der DashboardPage.xaml wird IsExceeded per DataTrigger für rote Farbgebung genutzt.

3. Projekte — Budget-Fortschritt & Zugewiesene Tätigkeiten (MAUI + Web)

ProjectDetailViewModel lädt jetzt parallel Zeiteinträge und Tätigkeiten (Services) des Projekts:

Für die Web-App wurde in ProjectsPage.tsx ein Budget-Fortschrittsbalken in der Projekt-Detailansicht ergänzt (grün → amber bei ≥80% → rot bei Überschreitung).

Projekt-Status-Filter

ProjectsViewModel erhielt einen SelectedStatusFilter (string?) mit [NotifyPropertyChangedFor(nameof(FilteredProjects))]. StatusOptions liefert die Liste der wählbaren Status-Werte. ClearAllFiltersCommand setzt beide Filter zurück.

4. Kunden — Nicht abgerechnete Zeiteinträge (MAUI + Web)

CustomerDetailViewModel berechnet "Nicht abgerechnete Zeiteinträge" für den Kunden:

Kunden-Typ-Filter

In CustomersViewModel (Web) und CustomersPage.xaml (MAUI) wurde ein Typ-Filter (Alle / Firma / Person) ergänzt.

5. Größere Dialoge / Popups (Web)

In allen Web-Dialog-Komponenten wurde die maximale Breite von sm:max-w-sm/md/lg auf sm:max-w-2xl angehoben:

MAUI: Popup-Größe wird über HeightRequest/WidthRequest auf dem RgPopupPage-Container gesteuert.

Services (Singleton)

s.AddSingleton<HttpClient>();
s.AddSingleton<FirebaseAuthService>();   // auth + token management
s.AddSingleton<FirebaseRestService>();   // HTTP wrapper
s.AddSingleton<DataService>();           // zentrale Datenschicht
s.AddSingleton<SettingsService>();        // thin wrapper für Settings
s.AddSingleton<PdfService>();             // Syncfusion PDF generation
s.AddSingleton<AppShell>();               // Shell als Singleton

ViewModels & Views (Transient)

Alle ViewModels und Views als AddTransient<T>() — neue Instanz bei jeder Navigation.

Auto-resolvierbar (kein explizites Register nötig)

ILogger<T> wird vom MAUI-Hosting-Framework automatisch bereitgestellt, sobald builder.Logging konfiguriert ist.

App.OnStart()
  └─ NavigateInitialAsync()  (200ms Delay, dann Main Thread)
       ├─ IsLoggedIn (UserId in Preferences)?
       │    → ja:  GoToAsync("//main/dashboard")
       │            → DashboardViewModel.LoadAsync() via EventToCommandBehavior
       │            → AppShell.OnHandlerChanged(): UpdateAdaptiveLayout() (Sidebar vs. TabBar)
       │
       └─ nein: PrefKeys.OnboardingSeen in Preferences?
                → ja:  GoToAsync("//login")
                → nein: GoToAsync("//onboarding")

Login (LoginViewModel.LoginAsync):
  SignInAsync() → SetCompanyId(userId) → Preferences.Set(PrefKeys.OnboardingSeen, true)
  → GoToAsync(Dashboard oder Welcome je nach OnboardingSeen)

1. Benutzerprofil (Web + MAUI)

Profil wird in Firestore unter companies/{companyId}/profile/main gespeichert. Felder: displayName, photoUrl.

Foto wird in Firebase Storage unter companies/{companyId}/profile/photo abgelegt. Download-URL wird zurück in Firestore + Preferences gecacht.

2. Avatar-Sidebar + Dropdown-Menü (Web + MAUI)

Unterer Bereich der Sidebar zeigt Avatar (Foto → Initialen → "?") + Name/E-Mail.

// MAUI — Avatar-Refresh nach Login (LoginViewModel.cs)
Preferences.Set(PrefKeys.UserEmail, Email);
if (Shell.Current is AppShell appShell)
    appShell.RefreshAvatarFromPreferences();

3. Info-Seite + App-Version

Zentrale Versionskonstanten in Constants/AppConstants.cs → AppInfo (MAUI) und shared/lib/appVersion.ts (Web).

Web: Info wird als Dialog im AppShell-Dropdown angezeigt. MAUI: eigene Views/InfoPage.xaml (Route: info).

4. Bugfix — startedAt.startsWith Timestamp-Fehler

Firestore gibt Timestamp-Felder manchmal als Objekt {seconds, nanoseconds} zurück statt als ISO-String — wenn MAUI-App geschrieben hat oder nach Chunk-Grenze. Betraf DashboardPage.tsx in Produktion.

Fix in shared/hooks/useCollection.ts: Duck-Typing-Fallback in toIsoIfTimestamp():

function toIsoIfTimestamp(v: unknown): unknown {
  if (v instanceof Timestamp) return v.toDate().toISOString();
  // Duck-type für cross-chunk Szenarien
  if (v !== null && typeof v === 'object' && 'seconds' in v && 'nanoseconds' in v) { ... }
  return v;
}

Zusätzlich: defensive typeof e.startedAt === 'string' Guards in DashboardPage.tsx.

1. TimeEntry — neue Billing-Felder

Datenmodell-Erweiterung in shared/types/models.ts (Web) und Models/LocalModels.cs (MAUI):

MAUI: DataService.cs MapTimeEntry und FirestoreFieldBuilder.cs ForTimeEntry wurden entsprechend erweitert.

2. Automatische Markierung bei Verrechnung (Web)

Zwei Stellen setzen die Billing-Felder automatisch per Firestore writeBatch:

InvoiceForm.tsx verfolgt importierte Entry-IDs in importedEntryIds-State und übergibt sie via erweiterter onSubmit(data, importedTimeEntryIds[])-Signatur. Importierbare Einträge schließen bereits verrechnete Einträge aus (!e.invoiceId && !e.activityReportId).

3. Zeitübersicht — Badge + Filter (Web + MAUI)

Web (TimeTrackingPage.tsx):

• Filter-Chips: Alle | Offen | Verrechnet — filtern completedEntries in-place
• Badge "✓ Verrechnet" (grün) auf Einträgen mit invoiceId oder activityReportId

MAUI (TimeTrackingViewModel.cs + TimeTrackingPage.xaml):

• BillingFilter ObservableProperty ("all" | "open" | "billed")
• ApplyBillingFilter() filtert _allEntries → Entries
• SetBillingFilterCommand(string) — gebunden an 3 Buttons in der View
• Badge "✓ Verrechnet" via IsNotNullOrEmptyConverter auf InvoiceId/ActivityReportId

4. B2-Fix — MAUI ProfilePage Initialen

ProfileViewModel.cs: Neues berechnetes Property AvatarInitials — gibt ersten Buchstaben von DisplayName oder UserEmail zurück:

public string AvatarInitials =>
    !string.IsNullOrEmpty(DisplayName) && DisplayName.Any(char.IsLetterOrDigit)
        ? DisplayName.First(char.IsLetterOrDigit).ToString().ToUpperInvariant()
        : !string.IsNullOrEmpty(UserEmail) && UserEmail.Any(char.IsLetterOrDigit)
            ? UserEmail.First(char.IsLetterOrDigit).ToString().ToUpperInvariant()
            : "?";

ProfilePage.xaml: Label-Binding von IsNullOrEmptyConverter auf AvatarInitials umgestellt. [NotifyPropertyChangedFor]-Attribute auf _displayName und _userEmail hinzugefügt.

P2 — Projekt-Import in Angebot & Rechnung (Web + MAUI)

Angebote und Rechnungen können Positionen direkt aus dem Projekt-Kontext importieren:

Web: QuoteForm.tsx und InvoiceForm.tsx erweitert mit aufklappbarer "Projektdaten importieren"-Sektion und zwei Tabs. QuotesPage.tsx / InvoicesPage.tsx übergeben timeEntries + services Props.

MAUI: QuoteDetailViewModel.cs + InvoiceDetailViewModel.cs — neue Properties ImportableServices, ImportableEntries, ImportTab, HasImportData. Methoden ImportServicesCommand + ImportTimeEntriesCommand. XAML: Import-Panel mit Service-Zähler und Gruppen-Import-Button. Sichtbarkeit via IsPositiveConverter (neu in Converters.cs).

// IsPositiveConverter — für ObservableCollection.Count-Binding
public class IsPositiveConverter : IValueConverter {
    public object Convert(object? value, ...) => value is int n && n > 0;
}

P3 — Kalender-Ansicht in der Zeiterfassung (Web + MAUI)

Zeiteinträge können in einer Wochenkalender-Ansicht visualisiert werden.

Route MAUI: Constants.Routes.TimeCalendar = "timeCalendar". Registriert in AppShell.xaml.cs + MauiProgram.cs. Kalender-Button 📅 in TimeTrackingPage.xaml.

Web: Toggle List/Kalender in TimeTrackingPage.tsx Header, viewMode State.

P4 — Payments v2: Soll/Haben (Web + MAUI)

Das Zahlungsmodul wurde auf ein vollständiges Doppelkontomodell (Einnahmen/Ausgaben) erweitert:

MAUI — neue/geänderte Dateien

Web — geänderte Dateien

Berichte-Logik (MAUI PaymentsViewModel.BuildReport())

// Letzte 6 Monate mit laufendem Saldo
for (int i = 5; i >= 0; i--) {
    var key  = now.AddMonths(-i).ToString("yyyy-MM");
    var inc  = payments.Where(p => p.Date.StartsWith(key)).Sum(p => p.Amount);
    var exp  = expenses.Where(e => e.Date.StartsWith(key)).Sum(e => e.Amount);
    running += inc - exp;
    rows.Add(new MonthlyReportRow(label, inc, exp, running));
}

F2 — Kunden-Steuerdaten

Kunden können jetzt UID-Nummer (USt-IdNr.) und Steuernummer hinterlegen. Diese erscheinen automatisch in der Adresszeile auf Rechnungen, Angeboten und Tätigkeitsberichten.

F3 — Firmen-Stammdaten (Kontakt, Steuer, Bank)

CompanySettings wurde um 9 Felder erweitert. Die Einstellungsseite hat drei neue Karten erhalten.

Kleinunternehmer-Logik auf PDFs

const isKlein = company.kleinunternehmer === true;
// MwSt.-Zeile zeigt "Keine MwSt. (Kleinunternehmer)" statt Betrag
// Gesamtbetrag = totalNet (nicht totalGross)
// Disclaimer: "Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer berechnet."

Geändertes PDF-Footer-Format

Footer wird dynamisch aus allen ausgefüllten Feldern zusammengestellt (· getrennt):

Musterfirma GmbH · Musterstraße 1 · 1010 Wien · office@firma.at · +43 1 234 · UID: ATU12345678

F4 — PDF Report Designer (Template-Auswahl + Akzentfarbe)

Benutzer können in den Einstellungen ein PDF-Layout und eine Akzentfarbe wählen. Das gewählte Design wird auf alle erzeugten PDFs angewendet.

Templates

Neue Felder in CompanySettings

Architektur

Modern-Banner Implementierung

// Negativer Margin zieht den Banner bis zum Seiten­rand
modernBanner: {
  marginTop:  '-30mm',
  marginLeft: '-20mm',
  marginRight:'-20mm',
  padding:    '10mm 20mm 8mm 20mm',
  backgroundColor: theme.headerBg
}

TypeScript-Hinweis: @react-pdf/renderer akzeptiert kein false in Style-Arrays. Statt condition && {style} immer condition ? {style} : undefined oder ternär verwenden.