Internes Business OS · TIXANO / OPSUMA

Architektur & Backend-Fundament

Die native Android-App wird außerhalb dieses Projekts gebaut. Hier liegt das Fundament: das Backend als einzige verbindliche Datenquelle und die vollständige Spezifikation, nach der die App entsteht.

Dokumente

  • Architektur

    docs/01-architektur.md

    Tech-Stack, Schichtenmodell, Realtime, Offline-Queue, Konfliktstrategie, Fehler- und Ladezustände, Logging, Security, Performance.

  • Ordnerstruktur

    docs/02-ordnerstruktur.md

    Vollständiger Verzeichnisbaum für app/, features/, components/, lib/, stores/, types/, hooks/, utils/ samt Namenskonventionen.

  • Navigation & Deep Links

    docs/03-navigation.md

    Bottom-Tabs, Stacks je Bereich, Auth-Gate, Quick-Create und die Deep-Link-Tabelle für jede Push-Benachrichtigung.

  • Auth & Workspaces

    docs/04-auth-workspaces.md

    Login, Logout, Passwort vergessen, Session-Wiederherstellung, Einladungen und Ablauf, Rollen, Workspace-Switcher.

  • Design-System

    docs/05-design-system.md

    Tokens für Farben, Abstände, Typografie, Hell/Dunkel/System, Score-Darstellung, Barrierefreiheit.

  • Backend-Vertrag

    docs/06-backend-vertrag.md

    Alle Tabellen, Zugriffsregeln, Funktionen, Rechte und Realtime-Kanäle — plus die offenen Punkte, die noch fehlen.

  • Phasen & Abnahme

    docs/07-phasen-abnahme.md

    Die sechs Phasen und die 18 Abnahmekriterien als prüfbare Liste, dazu Feature Flags und Demo-Modus.

  • Sicherheitstests

    docs/08-rls-testbericht.md

    41 durchgeführte Zugriffs- und Einladungstests mit Erwartung, Ergebnis und Nachweis — alle bestanden.

  • Abnahme Phase 1

    docs/09-abnahme-phase-1.md

    Prüfung gegen alle Härtungsanforderungen, Rollen- und Rechtematrix, Stand der Abnahmekriterien, offene Punkte.

  • CRM-Fundament

    docs/10-crm-phase2.md

    Firmen, Kontakte, Leads, Pipelines, Stages, Timeline, Score, Dubletten — Tabellen, Regeln, Funktionen und empfohlene Abfragen.

  • CRM-Sicherheitstests

    docs/11-crm-testbericht.md

    43 Tests zu Bereichsgrenzen, Rechten, Zuweisung, Timeline, Löschschutz und Dubletten — alle bestanden.

  • Abnahme Phase 2

    docs/12-abnahme-phase2.md

    Prüfung gegen alle 30 Anforderungen des CRM-Fundaments, Abnahmekriterien und offene Backend-Punkte.

  • Aufgaben & Teamkalender

    docs/13-phase3-tasks-calendar.md

    Aufgaben, Verantwortlichkeiten, Kommentare, Erwähnungen, Termine samt Sichtbarkeit, Benachrichtigungen, Erinnerungen und Echtzeit.

  • Sicherheitstests Phase 3

    docs/14-phase3-testbericht.md

    57 Tests zu Bereichsgrenzen, Rechten, Terminsichtbarkeit, Benachrichtigungen, Geräten und Erinnerungen — alle bestanden.

  • Abnahme Phase 3

    docs/15-abnahme-phase3.md

    Prüfung gegen alle 56 Anforderungen, Abnahmekriterien, Praxisbeispiel und die verbleibenden offenen Punkte.

  • SCOUT — KI-Recherche

    docs/16-phase4-scout.md

    Suchaufträge, Läufe, Kandidaten, Bewertung mit Begründung und Quellen, Übernahme ins CRM, Budget, Zeitplan und Echtzeit.

  • Sicherheitstests SCOUT

    docs/17-phase4-scout-testbericht.md

    54 Tests zu Rechten, Bereichsgrenzen, Quellenpflicht, Dubletten, Budget, Wiederholungen und Aufbewahrung — alle bestanden.

  • Abnahme Phase 4

    docs/18-abnahme-phase4.md

    Prüfung gegen alle SCOUT-Anforderungen, Abnahmekriterien und die vier verbleibenden offenen Punkte.

Backend Phase 1 — steht

organizations
Firma
profiles
Mitarbeiterdaten
workspaces
Marken bzw. Bereiche
organization_members
Zugehörigkeit zur Firma samt Rolle
workspace_members
Zugriff je Bereich samt eigener Rolle
roles / permissions
Rollen und Rechte als Daten, nicht als Code
role_permissions
Welche Rolle darf was
invitations
Einladungen mit Ablauf, einmalig einlösbar
companies / contacts
Firmen und Ansprechpartner je Bereich
leads
Verkaufschancen mit Zuständigkeit, Stufe, Bewertung
pipelines / pipeline_stages
Vertriebsstufen frei konfigurierbar
lead_activities
Unveränderliche Verlaufshistorie je Lead
lead_sources
Herkunft und Belege einzelner Angaben
tasks / task_assignees
Aufgaben mit Hauptverantwortung und Mitarbeitenden
task_comments / comment_mentions
Kommentare und Erwähnungen
task_activities
Unveränderlicher Verlauf je Aufgabe
calendar_events / event_attendees
Teamtermine mit Sichtbarkeit und Teilnehmern
notifications
Benachrichtigungen je Mitarbeiter
push_tokens / notification_deliveries
Geräte und Warteschlange für Push
search_missions / search_runs
Suchaufträge der KI-Recherche und ihre Läufe
search_candidates
Gefundene Kandidaten mit Bewertung und Begründung
data_update_proposals
Änderungsvorschläge statt stillem Überschreiben
scoring_profiles / scout_settings
Bewertungsgewichte und Budget je Bereich
ai_usage_ledger / ai_pricing_config
Verbrauch und Preise der KI-Nutzung
ai_feedback
Rückmeldung zu Leads mit Begründung

Zugriffsregeln greifen auf jeder Tabelle: Jeder sieht ausschließlich die Bereiche, in denen er Mitglied ist, und kann seine eigene Rolle nicht anheben. Rollen und Rechte liegen getrennt vom Profil und werden geladen, nicht programmiert. Anmeldung per E-Mail und Passwort ist aktiv, Einladungen laufen ab und sind nur einmal einlösbar. 41 Sicherheitstests sind bestanden. Keine Beispieldaten, keine fest verdrahteten Namen.