FieldFlow

erDiagram
    Company ||--o{ User : "1:N"
    Company ||--o{ Product : "1:N"
    Company ||--o{ Outlet : "1:N"
    Company ||--o{ Route : "1:N"
    User ||--o{ Route : "assigned"
    Route ||--o{ RouteOutlet : "1:N"
    Outlet ||--o{ RouteOutlet : "1:N"
    User ||--o{ Visit : "1:N"
    Outlet ||--o{ Visit : "1:N"
    Route ||--o{ Visit : "1:N"
    Visit ||--o{ Inventory : "1:N"
    Visit ||--o{ VisitPhoto : "1:N"
    Visit ||--o{ Order : "1:N"
    Order ||--o{ OrderItem : "1:N"
    Product ||--o{ Inventory : "1:N"
    Product ||--o{ OrderItem : "1:N"

    Company {
        uuid id PK
        text name
        text address
        text industry
        text logo_url
        text plan
        timestamp created_at
    }
    User {
        uuid id PK
        uuid company_id FK
        text full_name
        text phone
        text email
        enum role
        boolean is_active
    }
    Product {
        uuid id PK
        uuid company_id FK
        text sku
        text name
        text unit
        decimal unit_price
        text category
        boolean is_active
    }
    Outlet {
        uuid id PK
        uuid company_id FK
        text name
        text address
        decimal lat
        decimal lng
        enum outlet_type
        text contact_phone
        enum status
        boolean approved
    }
    Route {
        uuid id PK
        uuid company_id FK
        text name
        uuid user_id FK
        int_array day_of_week
        boolean is_active
    }
    Visit {
        uuid id PK
        uuid user_id FK
        uuid outlet_id FK
        uuid route_id FK
        timestamp checkin_time
        decimal checkin_lat
        decimal checkin_lng
        timestamp checkout_time
        boolean is_forced
        text force_reason
        text notes
        int duration_minutes
    }
    Order {
        uuid id PK
        uuid visit_id FK
        uuid user_id FK
        uuid outlet_id FK
        text order_number
        decimal total_amount
        enum status
        text notes
        uuid approved_by FK
    }
    OrderItem {
        uuid id PK
        uuid order_id FK
        uuid product_id FK
        decimal quantity
        decimal unit_price
        decimal total_price
    }
    Inventory {
        uuid id PK
        uuid visit_id FK
        uuid product_id FK
        decimal quantity
        text unit
    }
    VisitPhoto {
        uuid id PK
        uuid visit_id FK
        text photo_url
        text caption
        timestamp taken_at
    }
    

graph TB
    subgraph VPS["VPS — 1 Doanh nghiệp"]
        subgraph Caddy["Caddy Reverse Proxy"]
            direction LR
            HTTPS["Auto HTTPS
Let's Encrypt"]
            STATIC["Static File Server
Vue SPA"]
            PROXY["Reverse Proxy
/api/* → :3000"]
        end
        subgraph PM2["PM2 Process Manager"]
            subgraph API["Fastify API Server :3000"]
                subgraph CORE["Core Layer"]
                    AUTH["Auth"]
                    USERS["Users"]
                    COMP["Companies"]
                    PRODS["Products"]
                    STORE["Storage"]
                    NOTIF["Notifications"]
                end
                subgraph BUS["Module Registry + Event Bus"]
                    direction LR
                end
                subgraph MODS["Business Modules"]
                    DMS["DMS
Phân phối"]
                    INV["Inventory
Tồn kho"]
                    MAT["Materials
Nguyên vật liệu"]
                    ATT["Attendance
Chấm công"]
                end
                CORE --> BUS
                BUS --> MODS
            end
        end
        subgraph DOCK["Docker Compose"]
            PG["PostgreSQL 16
Shared DB, module-owned tables"]
        end
    end
    Caddy --> PM2
    API --> PG
    

graph LR
    subgraph PG["PostgreSQL 16"]
        subgraph CORE["Core Schema"]
            CO["companies"]
            US["users"]
            PR["products"]
            NO["notifications"]
        end
        subgraph DMS["DMS Module"]
            OU["outlets"]
            RO["routes"]
            ROO["route_outlets"]
            VI["visits"]
            PH["photos"]
            SO["sales_orders"]
            OI["order_items"]
            GL["gps_logs"]
        end
        subgraph INV["Inventory Module"]
            WH["warehouses"]
            SI["stock_items"]
            SM["stock_movements"]
        end
        subgraph MAT["Materials Module"]
            RM["material_details"]
            SU["suppliers"]
            PO["purchase_orders"]
            POI["purchase_order_items"]
            BOM["bill_of_materials"]
        end
        subgraph ATT["Attendance Module"]
            TE["time_entries"]
            SC["schedules"]
            SH["shifts"]
            GF["geofences"]
        end
    end
    

graph TB
    subgraph VPS["VPS Ubuntu/Debian"]
        subgraph CADDY["Caddy — port 80/443"]
            HTTPS["Auto HTTPS
Let's Encrypt"]
            STATIC2["Vue SPA static files"]
            APIPROXY["Reverse proxy
/api/* → localhost:3000"]
            UPLOADS["File uploads
/var/www/fieldflow/uploads"]
        end
        subgraph PM2RUN["PM2"]
            API2["fieldflow-api
Node.js cluster mode
:3000"]
        end
        subgraph DOCKER["Docker Compose"]
            PG2["PostgreSQL 16
port 5432 internal"]
        end
        CODE["/opt/fieldflow/ — git repo"]
        WEBFILES["/var/www/fieldflow/web/ — built SPA"]
        UPFILE["/var/www/fieldflow/uploads/ — uploaded files"]
    end
    CADDY --> PM2RUN
    API2 --> PG2