pulse-crm-backend/docs/ER-DIAGRAM.md

Pulse CRM - Entity Relationship Diagram

erDiagram
    ORGANIZATIONS ||--o{ USERS : has
    ORGANIZATIONS ||--o{ CONTACTS : has
    ORGANIZATIONS ||--o{ COMPANIES : has
    ORGANIZATIONS ||--o{ PIPELINES : has
    ORGANIZATIONS ||--o{ DEALS : has
    ORGANIZATIONS ||--o{ ACTIVITIES : has
    ORGANIZATIONS ||--o{ AUDIT_LOGS : has

    USERS ||--o{ CONTACTS : owns
    USERS ||--o{ COMPANIES : owns
    USERS ||--o{ DEALS : owns
    USERS ||--o{ ACTIVITIES : creates
    USERS ||--o{ REFRESH_TOKENS : has

    COMPANIES ||--o{ CONTACTS : employs
    COMPANIES ||--o{ DEALS : has

    CONTACTS ||--o{ DEALS : associated
    CONTACTS ||--o{ ACTIVITIES : has

    PIPELINES ||--o{ DEALS : contains

    DEALS ||--o{ ACTIVITIES : has

    ORGANIZATIONS {
        uuid id PK
        string name
        string slug UK
        jsonb settings
        string subscription_plan
        timestamp created_at
    }

    USERS {
        uuid id PK
        uuid org_id FK
        string email UK
        string password_hash
        string first_name
        string last_name
        string role
        boolean is_active
        timestamp last_login_at
    }

    CONTACTS {
        uuid id PK
        uuid org_id FK
        uuid company_id FK
        uuid owner_id FK
        string first_name
        string last_name
        string email
        string phone
        string status
        boolean gdpr_consent
        timestamp deleted_at
    }

    COMPANIES {
        uuid id PK
        uuid org_id FK
        uuid owner_id FK
        string name
        string industry
        string website
        string phone
        timestamp deleted_at
    }

    PIPELINES {
        uuid id PK
        uuid org_id FK
        string name
        boolean is_default
        jsonb stages
    }

    DEALS {
        uuid id PK
        uuid org_id FK
        uuid pipeline_id FK
        uuid contact_id FK
        uuid company_id FK
        uuid owner_id FK
        string title
        decimal value
        string stage_id
        string status
        date expected_close_date
    }

    ACTIVITIES {
        uuid id PK
        uuid org_id FK
        uuid user_id FK
        uuid contact_id FK
        uuid deal_id FK
        string type
        string subject
        text description
        timestamp due_date
        boolean is_completed
    }

    AUDIT_LOGS {
        uuid id PK
        uuid org_id FK
        uuid user_id FK
        string action
        string entity_type
        uuid entity_id
        jsonb changes
        inet ip_address
    }

    REFRESH_TOKENS {
        uuid id PK
        uuid user_id FK
        string token_hash
        timestamp expires_at
    }

Tabellen-Übersicht

Tabelle	Beschreibung	Relationships
organizations	Mandanten (Multi-Tenancy)	Parent für alle Daten
users	Benutzer/Team-Mitglieder	Gehört zu Organization
contacts	Personen/Leads	Gehört zu Organization, optional zu Company
companies	Firmen	Gehört zu Organization
pipelines	Sales Pipelines	Gehört zu Organization
deals	Opportunities	Gehört zu Pipeline, Contact, Company
activities	Notizen, Calls, Tasks	Gehört zu Contact oder Deal
audit_logs	DSGVO Audit Trail	Protokolliert alle Änderungen
refresh_tokens	JWT Refresh Tokens	Gehört zu User

Indizes

Alle Tabellen haben Indizes auf:

• org_id - Multi-Tenancy Queries
• Foreign Keys
• Häufig gefilterte Felder (status, email, etc.)
• deleted_at - Soft Delete Queries