Quản lý Phân phối

erDiagram
    Territory ||--o{ Outlet : "contains"
    Territory ||--o{ Route : "contains"
    Territory }o--|| User : "supervised by"
    Route ||--o{ RouteOutlet : "has"
    Outlet ||--o{ RouteOutlet : "in"
    Route }o--|| User : "assigned to"
    Outlet ||--o{ Visit : "visited in"
    Visit ||--o{ VisitInventory : "records"
    Visit ||--o{ VisitPhoto : "captures"
    Visit ||--o{ SalesOrder : "creates"
    SalesOrder ||--o{ OrderItem : "contains"
    User ||--o{ GPSLog : "tracked"
    User ||--o{ Visit : "performs"
    Product ||--o{ VisitInventory : "tracked in"
    Product ||--o{ OrderItem : "sold in"

    Territory {
        uuid id "PK ✱"
        text name "Tên địa bàn ✱"
        uuid supervisor_id "FK User ✱"
        text status "active/inactive ✱"
        text description "Mô tả"
        json district_codes "Mã quận/huyện"
        json boundary_geojson "Ranh giới bản đồ (Phase 2)"
    }

    Outlet {
        uuid id "PK ✱"
        text name "Tên cửa hàng ✱"
        text address "Địa chỉ ✱"
        decimal lat "Vĩ độ GPS ✱"
        decimal lng "Kinh độ GPS ✱"
        uuid territory_id "FK Territory ✱"
        text outlet_type "Loại hình ✱"
        text status "active/paused/closed ✱"
        text contact_name "Tên người liên hệ"
        text contact_phone "SĐT"
        boolean approved "Đã duyệt"
        uuid created_by "FK User"
        json photos "Ảnh (Phase 2)"
        timestamp last_visit_at "Lần ghé cuối (Phase 2)"
        decimal avg_monthly_revenue "Doanh số TB (Phase 2)"
    }

    Route {
        uuid id "PK ✱"
        text name "Tên tuyến ✱"
        uuid territory_id "FK Territory ✱"
        uuid user_id "FK User (Sales Rep) ✱"
        json day_of_week "Ngày chạy [1,3,5] ✱"
        boolean is_active "Đang chạy ✱"
        text description "Mô tả"
        json optimized_order "Tự động tối ưu (Phase 2)"
        integer estimated_duration "Thời gian ước tính (Phase 2)"
    }

    RouteOutlet {
        uuid route_id "FK Route ✱"
        uuid outlet_id "FK Outlet ✱"
        integer sort_order "Thứ tự ✱"
    }

    Visit {
        uuid id "PK ✱"
        uuid user_id "FK User ✱"
        uuid outlet_id "FK Outlet ✱"
        uuid route_id "FK Route ✱"
        timestamp checkin_time "Thời gian check-in ✱"
        decimal checkin_lat "Vĩ độ check-in ✱"
        decimal checkin_lng "Kinh độ check-in ✱"
        timestamp checkout_time "Thời gian check-out"
        decimal checkout_lat "Vĩ độ check-out"
        decimal checkout_lng "Kinh độ check-out"
        boolean is_forced "Force check-in"
        text force_reason "Lý do force"
        text notes "Ghi chú"
        integer duration_minutes "Thời lượng"
        decimal visit_score "Đánh giá (Phase 2)"
        text customer_feedback "Phản hồi (Phase 2)"
    }

    VisitInventory {
        uuid visit_id "FK Visit ✱"
        uuid product_id "FK Product ✱"
        decimal quantity "Số lượng ✱"
        text unit "Đơn vị: thùng"
    }

    VisitPhoto {
        uuid visit_id "FK Visit ✱"
        text photo_url "Đường dẫn hình ✱"
        text photo_type "Loại ảnh ✱"
        text caption "Chú thích"
    }

    SalesOrder {
        uuid id "PK ✱"
        text order_number "Mã đơn ✱"
        text order_type "sale/return ✱"
        uuid user_id "FK User ✱"
        uuid outlet_id "FK Outlet ✱"
        uuid visit_id "FK Visit ✱"
        text status "Trạng thái ✱"
        decimal total_amount "Tổng tiền ✱"
        text notes "Ghi chú"
        uuid approved_by "FK User"
        timestamp approved_at "Thời gian duyệt"
        text delivery_notes "Ghi chú giao"
        text delivery_proof_url "Bằng chứng giao (Phase 2)"
        text payment_status "Trạng thái TT (Phase 2)"
        text return_reason "Lý do trả (Phase 2)"
    }

    OrderItem {
        uuid order_id "FK SalesOrder ✱"
        uuid product_id "FK Product ✱"
        decimal quantity "Số lượng ✱"
        decimal unit_price "Giá tại thời điểm ✱"
        decimal total_price "Thành tiền ✱"
    }

    GPSLog {
        uuid user_id "FK User ✱"
        decimal lat "Vĩ độ ✱"
        decimal lng "Kinh độ ✱"
        decimal accuracy "Độ chính xác (m) ✱"
        timestamp recorded_at "Thời gian ghi ✱"
    }
    

flowchart TD
    Start[NV mở app] --> ViewRoute[Xem tuyến hôm nay
Danh sách 8 điểm bán theo thứ tự]
    ViewRoute --> SelectOutlet[Chọn điểm bán đầu tiên
Tạp hóa Minh An]
    SelectOutlet --> CheckIn{Check-in GPS}

    CheckIn -->|Trong 200m| CheckInOK[✅ Check-in OK
Tiếp tục nghiệp vụ]
    CheckIn -->|Ngoài 200m| ForceCheckIn[⚠️ Cảnh báo
Cho phép force check-in]
    ForceCheckIn --> EnterReason[Nhập lý do
"Chợ đông, không ra đường"]
    EnterReason --> CheckInOK

    CheckInOK --> Tasks{Tại điểm bán
4 nghiệp vụ (thứ tự bất kỳ)}

    Tasks --> Inventory[📦 NHẬP TỒN KHO
Danh sách SP → Nhập SL
Highlight SP hết hàng]
    Tasks --> Photos[📸 CHỤP HÌNH
Trưng bày, kệ hàng
Tối đa 5 hình]
    Tasks --> CreateOrder[🛒 TẠO ĐƠN HÀNG
Chọn SP + SL
Tự tính tiền → Gửi]
    Tasks --> Notes[📝 GHI CHÚ
Text tự do
"Chủ nói hết bia"]

    Inventory --> CheckOut
    Photos --> CheckOut
    CreateOrder --> CheckOut
    Notes --> CheckOut

    CheckOut[Nhấn Check-out] --> CalcDuration[Tính thời gian
12 phút]
    CalcDuration --> NextOutlet[Chuyển điểm tiếp
Lặp lại từ Check-in]

    NextOutlet --> MorePoints{Còn điểm nào?}
    MorePoints -->|Có| SelectOutlet
    MorePoints -->|Không| DaySummary[Tổng kết ngày
8 điểm, 5 đơn, 2.5 triệu]

    style CheckInOK fill:#6ee7b7,stroke:#059669
    style ForceCheckIn fill:#fbbf24,stroke:#b45309
    style DaySummary fill:#d4a73a,stroke:#b8860b,color:#1a1814
    

gantt
    title Lộ trình Module DMS
    dateFormat WW
    axisFormat Tuần %U

    section MVP (Phase 1)
    Quản lý địa bàn              :m1, 01, 2w
    Quản lý điểm bán             :m2, 01, 2w
    Duyệt điểm bán mới           :m3, 01, 1w
    Quản lý tuyến                :m4, 02, 2w
    Check-in/out GPS             :m5, 02, 2w
    Force check-in               :m6, 02, 1w
    Nhập tồn kho                 :m7, 03, 2w
    Cảnh báo hết hàng            :m8, 03, 1w
    Chụp hình                    :m9, 03, 1w
    Tạo đơn hàng                 :m10, 04, 2w
    Tạo đơn trả hàng             :m11, 04, 1w
    Duyệt đơn                    :m12, 04, 2w
    Dashboard tổng quan         :m13, 05, 2w
    GPS tracking                 :m14, 05, 2w
    Báo cáo doanh số             :m15, 06, 2w

    section Nâng cao (Phase 2)
    Offline mode                 :p1, 15, 3w
    Tối ưu tuyến tự động         :p2, 16, 2w
    So sánh tồn kho              :p3, 17, 1w
    Quét mã vạch                 :p4, 17, 1w
    Gợi ý đặt hàng              :p5, 18, 2w
    Xem tuyến trên bản đồ        :p6, 19, 1w
    Phân hạng khách hàng        :p7, 20, 2w

    section Đầy đủ (Phase 3)
    Tích hợp khuyến mãi          :f1, 28, 2w
    AI gợi ý tối ưu tuyến        :f2, 29, 2w
    Phân tích hình ảnh          :f3, 30, 3w
    Tích hợp công nợ            :f4, 33, 2w
    Geo-analytics               :f5, 34, 2w