Quản lý Kho

flowchart LR
    Core[Core Module
SP, Users, Company] --> Inventory[Inventory Module
Quản lý Kho]
    Inventory --> DMS[DMS Module
Đơn hàng → Xuất kho]
    Inventory --> Materials[Materials Module
NVL → Sản xuất nhẹ]
    Inventory --> Reports[Reports Module
Báo cáo nhập xuất]

    DMS -.->|Tồn kho điểm bán
(sync 2 chiều)| Inventory
    Materials -.->|Thành phẩm
nhập lại kho| Inventory

    style Inventory fill:#d4a73a,stroke:#b8860b,stroke-width:3px,color:#1a1814
    style Core fill:#e8e4d8,stroke:#7a7468,stroke-width:2px,color:#1a1814
    style DMS fill:#e8e4d8,stroke:#7a7468,stroke-width:2px,color:#1a1814
    style Materials fill:#e8e4d8,stroke:#7a7468,stroke-width:2px,color:#1a1814
    style Reports fill:#e8e4d8,stroke:#7a7468,stroke-width:2px,color:#1a1814
    

erDiagram
    Warehouse ||--o{ WarehouseZone : "contains"
    WarehouseZone ||--o{ WarehouseSlot : "contains"
    Warehouse ||--o{ StockItem : "tracks stock in"
    WarehouseSlot ||--o{ StockItem : "stores"
    Product ||--o{ StockItem : "tracked for"
    Batch ||--o{ StockItem : "belongs to"
    StockMovement ||--o{ StockMovementItem : "contains"
    Product ||--o{ StockMovementItem : "moved"
    Batch ||--o{ StockMovementItem : "from/to"
    WarehouseSlot ||--o{ StockMovementItem : "placed in"
    Stocktake ||--o{ StocktakeItem : "contains"
    Product ||--o{ StocktakeItem : "counted"
    Batch ||--o{ StocktakeItem : "verified"
    WarehouseSlot ||--o{ StocktakeItem : "located"

    Warehouse {
        uuid id "PK"
        text name "Tên kho"
        text code "Mã kho"
        text address "Địa chỉ"
        text status "active/inactive"
    }
    WarehouseZone {
        uuid id "PK"
        uuid warehouse_id "FK"
        text name "Tên khu (A,B,C...)"
        text zone_type "Loại hàng"
        text description "Mô tả"
    }
    WarehouseSlot {
        uuid id "PK"
        uuid zone_id "FK"
        text code "Mã slot A-01"
        text slot_type "Loại slot"
        integer max_capacity "SL tối đa"
    }
    Batch {
        uuid id "PK"
        uuid company_id "FK"
        text batch_code "Mã lô TGR-260601"
        date manufacture_date "Ngày SX"
        date expiry_date "Hạn sử dụng"
        uuid supplier_id "FK NCC"
        text notes "Ghi chú"
    }
    StockItem {
        uuid id "PK"
        uuid warehouse_id "FK"
        uuid slot_id "FK"
        uuid product_id "FK"
        uuid batch_id "FK"
        decimal quantity "SL hiện tại"
        decimal reserved_qty "SL đã giữ"
        timestamp last_updated "Cập nhật"
    }
    StockMovement {
        uuid id "PK"
        text movement_number "Mã phiếu"
        enum movement_type "Loại nhập/xuất"
        enum status "Trạng thái"
        uuid created_by "FK User"
        uuid approved_by "FK User"
        text reference "Tham chiếu (mã đơn DMS)"
        text notes "Ghi chú"
        timestamp movement_date "Ngày nhập/xuất"
    }
    StockMovementItem {
        uuid id "PK"
        uuid movement_id "FK"
        uuid product_id "FK"
        uuid batch_id "FK"
        uuid slot_id "FK"
        decimal quantity "SL"
        text notes "Ghi chú"
    }
    Stocktake {
        uuid id "PK"
        text stocktake_number "Mã kiểm kê"
        enum status "Trạng thái"
        uuid warehouse_id "FK"
        uuid created_by "FK"
        uuid approved_by "FK"
        date stocktake_date "Ngày kiểm kê"
        text notes "Ghi chú"
    }
    StocktakeItem {
        uuid id "PK"
        uuid stocktake_id "FK"
        uuid product_id "FK"
        uuid batch_id "FK"
        uuid slot_id "FK"
        decimal system_qty "SL sổ sách"
        decimal actual_qty "SL thực tế"
        decimal diff_qty "Chênh lệch"
        text diff_reason "Lý do"
    }
    

flowchart TD
    DMS[DMS: Đơn hàng được duyệt] --> Event[publish: dms.order.approved]
    Event --> CreateMovement[Inventory: Tự tạo phiếu xuất
Loại: out_order]
    CreateMovement --> FIFO[FIFO: Chọn batch nhập sớm nhất
còn hàng + chưa hết hạn]
    FIFO --> Reserve[Giữ hàng: reserved_qty tăng]
    Reserve --> WaitKho[NV Kho nhận thông báo
Phiếu xuất chờ xác nhận]

    WaitKho --> Confirm{NV Kho xác nhận}
    Confirm -->|Đúng SL| Pick[Hàng lấy từ Slot
Cập nhật phiếu]
    Confirm -->|Sai SL| Adjust[Điều chỉnh SL
Ghi lý do]

    Pick --> Complete[Xuất xong
quantity giảm, reserved_qty giảm]
    Adjust --> Complete

    Complete --> Publish[publish: inventory.movement.created]
    Publish --> DMSUpdate[DMS: Cập nhật trạng thái đơn
→ Đang giao]

    style DMS fill:#5eead4,stroke:#0f766e,color:#1a1814
    style Complete fill:#6ee7b7,stroke:#059669
    style Publish fill:#d4a73a,stroke:#b8860b,color:#1a1814
    

flowchart LR
    subgraph XuatNVL["Bước 1: Xuất NVL"]
        X1[Tạo phiếu xuất
out_production] --> X2[Chọn NVL + SL
Zone NVL]
        X2 --> X3[Xác nhận
Tồn NVL giảm]
    end

    subgraph SX["Bước 2: Sản xuất"]
        S1[Đóng gói / Gia công] --> S2[50 combo
Bia + Nước]
    end

    subgraph NhapTP["Bước 3: Nhập thành phẩm"]
        N1[Tạo phiếu nhập
in_production] --> N2[SP thành phẩm + Batch mới]
        N2 --> N3[Xác nhận
Tồn thành phẩm tăng]
    end

    XuatNVL --> SX --> NhapTP

    style XuatNVL fill:#fbbf24,stroke:#b45309,color:#1a1814
    style SX fill:#e8e4d8,stroke:#7a7468,color:#1a1814
    style NhapTP fill:#6ee7b7,stroke:#059669,color:#1a1814
    

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

    section MVP (Phase 1)
    Kho + Zone + Slot CRUD        :m1, 03, 1w
    Nhập kho (NCC, trả, SX)      :m2, 03, 2w
    Xuất kho (DMS auto, SX, khác) :m3, 04, 2w
    Batch tracking + FIFO         :m4, 04, 1w
    Tồn kho real-time             :m5, 05, 1w
    Kiểm kê + Điều chỉnh          :m6, 05, 1w
    Liên kết DMS (2 chiều)        :m7, 05, 1w

    section Nâng cao (Phase 2)
    Barcode scan                  :p1, 12, 1w
    Bàn giao ca                   :p2, 12, 1w
    Daily stock-in report         :p3, 13, 1w
    Xuất ưu tiên sắp hết hạn      :p4, 13, 1w
    Dashboard kho                 :p5, 14, 1w

    section Đầy đủ (Phase 3)
    Multi-warehouse               :f1, 22, 2w
    Batch traceability full       :f2, 23, 1w
    AI dự báo nhập hàng           :f3, 24, 1w
    Tích hợp ERP kế toán          :f4, 24, 1w