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.mdTech-Stack, Schichtenmodell, Realtime, Offline-Queue, Konfliktstrategie, Fehler- und Ladezustände, Logging, Security, Performance.
Ordnerstruktur
docs/02-ordnerstruktur.mdVollständiger Verzeichnisbaum für app/, features/, components/, lib/, stores/, types/, hooks/, utils/ samt Namenskonventionen.
Navigation & Deep Links
docs/03-navigation.mdBottom-Tabs, Stacks je Bereich, Auth-Gate, Quick-Create und die Deep-Link-Tabelle für jede Push-Benachrichtigung.
Auth & Workspaces
docs/04-auth-workspaces.mdLogin, Logout, Passwort vergessen, Session-Wiederherstellung, Einladungen und Ablauf, Rollen, Workspace-Switcher.
Design-System
docs/05-design-system.mdTokens für Farben, Abstände, Typografie, Hell/Dunkel/System, Score-Darstellung, Barrierefreiheit.
Backend-Vertrag
docs/06-backend-vertrag.mdAlle Tabellen, Zugriffsregeln, Funktionen, Rechte und Realtime-Kanäle — plus die offenen Punkte, die noch fehlen.
Phasen & Abnahme
docs/07-phasen-abnahme.mdDie sechs Phasen und die 18 Abnahmekriterien als prüfbare Liste, dazu Feature Flags und Demo-Modus.
Sicherheitstests
docs/08-rls-testbericht.md41 durchgeführte Zugriffs- und Einladungstests mit Erwartung, Ergebnis und Nachweis — alle bestanden.
Abnahme Phase 1
docs/09-abnahme-phase-1.mdPrüfung gegen alle Härtungsanforderungen, Rollen- und Rechtematrix, Stand der Abnahmekriterien, offene Punkte.
CRM-Fundament
docs/10-crm-phase2.mdFirmen, Kontakte, Leads, Pipelines, Stages, Timeline, Score, Dubletten — Tabellen, Regeln, Funktionen und empfohlene Abfragen.
CRM-Sicherheitstests
docs/11-crm-testbericht.md43 Tests zu Bereichsgrenzen, Rechten, Zuweisung, Timeline, Löschschutz und Dubletten — alle bestanden.
Abnahme Phase 2
docs/12-abnahme-phase2.mdPrüfung gegen alle 30 Anforderungen des CRM-Fundaments, Abnahmekriterien und offene Backend-Punkte.
Aufgaben & Teamkalender
docs/13-phase3-tasks-calendar.mdAufgaben, Verantwortlichkeiten, Kommentare, Erwähnungen, Termine samt Sichtbarkeit, Benachrichtigungen, Erinnerungen und Echtzeit.
Sicherheitstests Phase 3
docs/14-phase3-testbericht.md57 Tests zu Bereichsgrenzen, Rechten, Terminsichtbarkeit, Benachrichtigungen, Geräten und Erinnerungen — alle bestanden.
Abnahme Phase 3
docs/15-abnahme-phase3.mdPrüfung gegen alle 56 Anforderungen, Abnahmekriterien, Praxisbeispiel und die verbleibenden offenen Punkte.
SCOUT — KI-Recherche
docs/16-phase4-scout.mdSuchaufträge, Läufe, Kandidaten, Bewertung mit Begründung und Quellen, Übernahme ins CRM, Budget, Zeitplan und Echtzeit.
Sicherheitstests SCOUT
docs/17-phase4-scout-testbericht.md54 Tests zu Rechten, Bereichsgrenzen, Quellenpflicht, Dubletten, Budget, Wiederholungen und Aufbewahrung — alle bestanden.
Abnahme Phase 4
docs/18-abnahme-phase4.mdPrü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.