Giới thiệu dự án

Ngành công nghiệp chế biến cà phê Việt Nam giữ vị thế xuất khẩu hàng đầu thế giới nhưng đang đối mặt với bài toán tối ưu hóa chi phí sản xuất và kiểm soát chất lượng nghiêm ngặt. Theo số liệu khảo sát thực tế tại các xưởng sản xuất, chi phí nguyên liệu đầu vào chiếm đến 50% tổng chi phí vận hành. Tuy nhiên, việc giám sát các công đoạn trọng yếu như kiểm định nguyên liệu, rang, sàng lọc, trộn, ủ và đóng gói phần lớn vẫn phụ thuộc vào ghi chép thủ công hoặc các phần mềm rời rạc, dẫn đến tỷ lệ hao hụt nguyên liệu cao và khó khăn trong truy xuất nguồn gốc.

Đề tài "Phân tích và thiết kế hệ thống Quản lý nhà máy sản xuất cà phê" (thực hiện tại Viện Công nghệ Thông tin và Điện, Điện tử – Trường Đại học Giao thông Vận tải TP.HCM) giải quyết trực tiếp các điểm nghẽn (pain points) trong vận hành công nghiệp: thiếu hụt công cụ giám sát thông số kỹ thuật thời gian thực, độ trễ cảnh báo tồn kho, sai số trong tính toán độ hao hụt nguyên liệu và quản lý nhân sự - thiết bị phân tán.

+-------------------------------------------------------------------------------+
|                      HỆ THỐNG QUẢN LÝ NHÀ MÁY CÀ PHÊ                          |
+-------------------------------------------------------------------------------+
|  [Kho & Nguyên liệu] --> [Quy trình Sản xuất] --> [Bảo trì & Thiết bị]        |
|  - Kiểm tra đầu vào      - Rang (Nhiệt/Thời gian) - Lịch bảo dưỡng định kỳ    |
|  - Cảnh báo tồn kho      - Sàng lọc & Hao hụt     - Kiểm định kỹ thuật        |
|  - Xuất/Nhập FIFO        - Trộn, Ủ & Đóng gói     - Đề xuất cải tiến          |
|-------------------------------------------------------------------------------|
|  [Đơn hàng & Vận chuyển]                       [Nhân sự & Chấm công]          |
|  - B2B/B2C Checkout & Thanh toán               - Chấm công vân tay/thẻ từ     |
|  - Quản lý Đối tác Logistics                   - Hồ sơ, Đào tạo, KPI          |
+-------------------------------------------------------------------------------+

Mục tiêu dự án

  1. Chuẩn hóa và số hóa toàn diện 18 Use Case cốt lõi từ tiếp nhận nguyên liệu, điều phối sản xuất đến phân phối sản phẩm.
  2. Tự động hóa giám sát chu trình sản xuất khép kín gồm 4 công đoạn chính: Rang (Roasting), Sàng lọc (Screening), Trộn & Ủ (Blending & Aging), Đóng gói (Packaging).
  3. Thiết lập giải thuật tự động tính toán tỷ lệ hao hụt qua sàng lọc để đánh giá chất lượng nhà cung cấp nguyên liệu.
  4. Tích hợp quản trị kho hàng theo thời gian thực (Real-time Inventory Management) với cơ chế cảnh báo ngưỡng an toàn.
  5. Hợp nhất các phân hệ phụ trợ: Quản lý thiết bị/bảo trì, Quản lý đơn hàng/vận chuyển và Chấm công/nhân sự trên một kiến trúc duy nhất.

Phạm vi và giới hạn hệ thống

  • Phạm vi (Scope): Bao phủ toàn bộ quy trình nội bộ của nhà máy sản xuất quy mô vừa (30-100 nhân công), bao gồm phân quyền cho 5 nhóm tác nhân chính: Quản lý nhà máy, Nhân viên kiểm định (QC), Kỹ thuật viên bảo trì, Thủ kho, và Khách hàng/Đối tác logistics.
  • Giới hạn (Limitations): Hệ thống dừng lại ở mức mô hình hóa phân tích - thiết kế kiến trúc chi tiết, đặc tả luồng dữ liệu (Data Flow), thiết kế giao diện UI/UX và xây dựng module xử lý logic nghiệp vụ trọng tâm; chưa tích hợp trực tiếp phần cứng PLC/SCADA tại tầng điều khiển tự động hóa cấp máy.

Phân tích và thiết kế giải pháp

Phân tích hiện trạng

Tiêu chí đánh giá Quản lý truyền thống (Sổ sách/Excel) Phần mềm ERP ngoại nhập (SAP/Odoo Enterprise) Hệ thống Quản lý Nhà máy Cà phê chuyên biệt
Chi phí đầu tư Thấp ban đầu, chi phí ẩn cao Rất cao (hàng chục nghìn USD) Tối ưu hóa, phù hợp nhà máy nội địa
Độ khớp nghiệp vụ Kém, phụ thuộc con người Cần tùy biến phức tạp và tốn kém Khớp 100% quy trình rang, ủ, sàng lọc cà phê
Kiểm soát hao hụt Định kỳ cuối tháng, trễ dữ liệu Phức tạp trong cấu hình định mức Tự động tính toán theo từng mẻ (batch)
Bảo trì máy rang Bị động khi xảy ra sự cố Có module nhưng khó tích hợp cảm biến Theo dõi thông số chu kỳ và cảnh báo sớm

Hệ thống áp dụng phương pháp phân loại yêu cầu MoSCoW:

  • Must have (Bắt buộc): Xác thực người dùng (UC-01), Kiểm tra nguyên liệu (UC-02), Giám sát quy trình sản xuất (UC-03 to UC-07), Quản lý nhập/xuất/tồn kho (UC-11, UC-12, UC-13).
  • Should have (Nên có): Quản lý bảo trì và kiểm định thiết bị rang (UC-08, UC-09), Đặt hàng và tích hợp cổng thanh toán (UC-15, UC-16), Chấm công nhân sự (UC-17).
  • Could have (Có thể có): Quản lý đối tác vận chuyển đa kênh (UC-14), Đề xuất cải tiến kỹ thuật máy móc (UC-10).
  • Won't have (Chưa ưu tiên): Tự động điều khiển van nhiệt độ máy rang qua giao thức Modbus/OPC-UA (chuyển sang giai đoạn sau).

Thiết kế hệ thống

Kiến trúc hệ thống được xây dựng theo mô hình 3 lớp (3-Tier Architecture) hiện đại, đảm bảo tính phân tách giữa giao diện, logic nghiệp vụ và tầng dữ liệu:

[ Client Layer: React.js 18.3 Web App / Mobile Responsive ]
                          │  HTTPS / RESTful APIs / JWT
[ Application Layer: Node.js 20.x Express / Spring Boot 3.2 ]
  ├── Auth & RBAC Service (Role-Based Access Control)
  ├── Production Pipeline Engine (Roasting, Blending, Aging)
  ├── Inventory & Quality Control Logic
  └── Equipment Maintenance Scheduler
                          │  ORM / Connection Pool
[ Database Layer: PostgreSQL 16.2 Enterprise ]

Thiết kế cơ sở dữ liệu quan hệ (PostgreSQL Schema)

-- Bảng quản lý nguyên liệu đầu vào và kiểm định chất lượng
CREATE TABLE raw_materials (
    material_id VARCHAR(20) PRIMARY KEY,
    supplier_id VARCHAR(20) NOT NULL,
    origin VARCHAR(100) NOT NULL,
    moisture_pct NUMERIC(4,2) CHECK (moisture_pct BETWEEN 8.0 AND 16.0),
    initial_weight_kg NUMERIC(10,2) NOT NULL,
    qc_status VARCHAR(20) DEFAULT 'PENDING' CHECK (qc_status IN ('PENDING', 'QUALIFIED', 'REJECTED')),
    received_date TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);

-- Bảng quản lý mẻ sản xuất và thông số rang (Roasting Batch)
CREATE TABLE production_batches (
    batch_id VARCHAR(30) PRIMARY KEY,
    material_id VARCHAR(20) REFERENCES raw_materials(material_id),
    roast_profile_id VARCHAR(20) NOT NULL,
    target_temp_celsius NUMERIC(5,2) NOT NULL,
    roast_duration_seconds INT NOT NULL,
    input_weight_kg NUMERIC(10,2) NOT NULL,
    output_weight_kg NUMERIC(10,2),
    loss_rate_pct NUMERIC(4,2),
    stage VARCHAR(30) DEFAULT 'ROASTING',
    operator_id VARCHAR(20) NOT NULL,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);

-- Bảng quản lý ngưỡng tồn kho và cảnh báo
CREATE TABLE inventory_stocks (
    product_id VARCHAR(20) PRIMARY KEY,
    product_name VARCHAR(150) NOT NULL,
    current_quantity INT NOT NULL CHECK (current_quantity >= 0),
    min_safety_threshold INT NOT NULL DEFAULT 100,
    unit VARCHAR(20) NOT NULL,
    last_updated TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);

Thiết kế API Endpoints chuẩn RESTful

Phương thức Endpoint URI Mô tả chức năng Mã trạng thái HTTP
POST /api/v1/auth/login Xác thực người dùng, cấp Token JWT 200 OK, 401 Unauthorized
POST /api/v1/materials/inspect Ghi nhận kết quả kiểm tra chất lượng nguyên liệu 201 Created, 400 Bad Request
POST /api/v1/production/roast/start Thiết lập thông số và kích hoạt mẻ rang 200 OK, 422 Unprocessable
POST /api/v1/production/screen/evaluate Tính độ hao hụt và cập nhật điểm nhà cung cấp 200 OK, 400 Bad Request
GET /api/v1/inventory/alerts Lấy danh sách nguyên vật liệu chạm ngưỡng an toàn 200 OK
POST /api/v1/maintenance/tickets Ghi nhận sự cố và lên lịch bảo trì thiết bị 201 Created, 403 Forbidden

Methodology

Dự án áp dụng mô hình phát triển phần mềm Agile/Scrum với các chu kỳ lặp Sprint 2 tuần, kéo dài tổng cộng 8 tuần:

  • Milestone 1 (Tuần 1-2): Khảo sát thực địa nhà máy, lập biểu mẫu phỏng vấn quy trình sản xuất cà phê, xác định 18 Use Case.
  • Milestone 2 (Tuần 3-4): Xây dựng sơ đồ Use Case tổng quát/chi tiết, thiết kế sơ đồ tuần tự (Sequence Diagrams) cho 5 phân hệ chính.
  • Milestone 3 (Tuần 5-6): Thiết kế cấu trúc cơ sở dữ liệu quan hệ, thiết kế giao diện UI (Dashboard, QC, Kỹ thuật, Kho).
  • Milestone 4 (Tuần 7-8): Hiện thực hóa module tính toán hao hụt, tích hợp API, kiểm thử đơn vị và nghiệm thu đồ án.

Implementation và kết quả

Development process

Trọng tâm kỹ thuật của hệ thống là thuật toán xử lý dữ liệu tại công đoạn Sàng lọc (Screening - UC-05) nhằm tự động trích xuất tỷ lệ hao hụt nguyên liệu và định lượng chất lượng nhà cung ứng:

interface BatchScreeningInput {
  batchId: string;
  supplierId: string;
  initialWeightKg: number;
  qualifiedWeightKg: number;
  defectiveWeightKg: number;
  measuredMoisturePct: number;
}

interface ScreeningEvaluationResult {
  lossRatePct: number;
  defectRatePct: number;
  isQualified: boolean;
  supplierQualityScore: number;
  recommendedAction: 'ACCEPT' | 'REJECT' | 'WARNING';
}

/**
 * Thuật toán tính toán độ hao hụt và đánh giá xếp hạng nguồn hàng
 * Độ phức tạp thời gian: O(1)
 */
export function evaluateCoffeeScreening(input: BatchScreeningInput): ScreeningEvaluationResult {
  const { initialWeightKg, qualifiedWeightKg, defectiveWeightKg, measuredMoisturePct } = input;
  
  if (initialWeightKg <= 0) {
    throw new Error("Khối lượng đầu vào phải lớn hơn 0");
  }

  // Tỷ lệ hao hụt trọng lượng qua công đoạn
  const lossRatePct = Number((((initialWeightKg - (qualifiedWeightKg + defectiveWeightKg)) / initialWeightKg) * 100).toFixed(2));
  
  // Tỷ lệ hạt khuyết tật/hỏng
  const defectRatePct = Number(((defectiveWeightKg / initialWeightKg) * 100).toFixed(2));

  // Tiêu chuẩn ngành: Độ ẩm <= 12.5%, Tạp chất/hạt hỏng <= 3.0%, Hao hụt tự nhiên <= 2.5%
  const isQualified = measuredMoisturePct <= 12.5 && defectRatePct <= 3.0 && lossRatePct <= 2.5;

  // Thuật toán chấm điểm nguồn cung (Thang điểm 100)
  let supplierQualityScore = 100 - (defectRatePct * 8.0 + lossRatePct * 5.0 + Math.max(0, measuredMoisturePct - 12.5) * 10.0);
  supplierQualityScore = Math.max(0, Math.min(100, Number(supplierQualityScore.toFixed(1))));

  let recommendedAction: 'ACCEPT' | 'REJECT' | 'WARNING' = 'ACCEPT';
  if (supplierQualityScore < 60 || !isQualified) {
    recommendedAction = 'REJECT';
  } else if (supplierQualityScore < 80) {
    recommendedAction = 'WARNING';
  }

  return {
    lossRatePct,
    defectRatePct,
    isQualified,
    supplierQualityScore,
    recommendedAction
  };
}

Testing và validation

Quá trình kiểm thử được triển khai toàn diện qua 3 cấp độ: Unit Testing (Jest), Integration Testing (Supertest), và User Acceptance Testing (UAT).

Hạng mục kiểm thử Số kịch bản (Test Cases) Tỷ lệ Pass (%) Độ bao phủ Code Coverage Thời gian phản hồi trung bình
Authentication & RBAC (UC-01) 15 100% 94.2% 45ms
Quy trình Rang & Sàng lọc (UC-04, UC-05) 28 96.4% 91.0% 110ms
Quản lý Tồn kho & Cảnh báo (UC-11, UC-12) 22 100% 88.5% 75ms
Đặt hàng & Thanh toán (UC-15, UC-16) 18 94.4% 86.8% 320ms (Bao gồm cổng Sandbox)
Kiểm định & Bảo trì Thiết bị (UC-08, 09) 14 100% 89.4% 60ms

Kết quả đạt được

  • Hoàn thành 100% yêu cầu chức năng: Phân tích, đặc tả và thiết kế hoàn chỉnh 18 Use Case, 18 Activity Diagrams và 5 Sequence Diagrams chuẩn UML 2.5.
  • Tối ưu hóa thời gian xử lý dữ liệu: Giảm thời gian tổng hợp báo cáo sản xuất từ 3 ngày (thủ công) xuống dưới 5 giây thông qua cơ sở dữ liệu quan hệ được tối ưu hóa chỉ mục (B-Tree Indexing).
  • Cải thiện độ chính xác quản lý tồn kho: Loại bỏ 99% sai lệch số liệu tồn kho giữa bộ phận kinh doanh và kho vật lý nhờ cơ chế cập nhật tự động sau mỗi lần xuất kho sản xuất hoặc bán hàng.

Đổi mới và đóng góp

  1. Khép kín vòng đời sản xuất từ nguồn nguyên liệu đến bảo trì máy: Khác với các hệ thống quản lý bán hàng thông thường, đồ án tập trung sâu vào các chỉ số vật lý/kỹ thuật chuyên biệt của ngành cà phê: tỷ lệ độ ẩm, nhiệt độ rang, thời gian ủ và tỷ lệ phối trộn hạt (Blend Ratio).
  2. Thuật toán tự động liên kết độ hao hụt với đánh giá nhà cung cấp: Giúp ban quản lý nhận diện ngay các lô nguyên liệu kém chất lượng, giảm lãng phí chi phí thu mua từ 12% đến 15%.
  3. Mô hình bảo trì dự phòng cho thiết bị rang công nghiệp: Đưa quy trình kiểm định chất lượng máy móc (UC-09) và yêu cầu cải tiến (UC-10) trực tiếp vào luồng vận hành, giảm thiểu nguy cơ dừng dây chuyền đột ngột (Downtime).
+-------------------------------------------------------------------------------+
|                      BẢNG SO SÁNH GIẢI PHÁP KỸ THUẬT                          |
+------------------------------------+------------------+-----------------------+
| Tính năng                          | Đồ án Nghiên cứu | Phần mềm ERP Phổ thông|
+------------------------------------+------------------+-----------------------+
| Theo dõi thông số nhiệt độ/mẻ rang | Có (Chi tiết)    | Không (Cần viết thêm) |
| Tính độ hao hụt hạt sau sàng lọc   | Tự động          | Nhập thủ công         |
| Giám sát thời gian phối trộn & ủ   | Tích hợp sẵn     | Phải tùy biến Module  |
| Chi phí triển khai & bảo trì       | Rất thấp         | Rất cao               |
+------------------------------------+------------------+-----------------------+

Ứng dụng thực tế và triển khai

Kịch bản vận hành thực tế (Real-World Use Case)

Khi lô hàng cà phê nhân xô 5.000 kg nhập kho từ Đắk Lắk:

  1. Nhân viên kho và QC sử dụng màn hình Kiểm tra nguyên liệu (UC-02) ghi nhận độ ẩm 11.8% (Đạt tiêu chuẩn).
  2. Quản lý phân xưởng tạo lệnh sản xuất, hệ thống điều phối 1.000 kg vào máy rang số 01. Module Rang (UC-04) lưu giữ profile nhiệt 215°C trong 14 phút.
  3. Chuyển sang công đoạn Sàng lọc (UC-05): Hệ thống ghi nhận sản lượng đạt 820 kg hạt rang thành phẩm, 15 kg hạt vỡ, tính toán độ hao hụt tự nhiên là 16.5% (do bay hơi nước và vỏ trấu) – đưa ra cảnh báo "Bình thường".
  4. Sau khi hoàn thành Trộn - Ủ (UC-06) và Đóng gói (UC-07), số lượng thành phẩm tự động cộng vào bảng Tồn kho (UC-11) và sẵn sàng cho module Xuất lẻ/Bán sỉ (UC-15, UC-16).

Hướng dẫn triển khai hệ thống (Deployment Architecture)

version: '3.8'
services:
  coffee-db:
    image: postgres:16.2-alpine
    container_name: coffee_factory_db
    environment:
      POSTGRES_DB: coffee_factory_management
      POSTGRES_USER: factory_admin
      POSTGRES_PASSWORD: SecureFactoryPassword2024!
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  coffee-backend:
    build: ./backend
    container_name: coffee_factory_api
    environment:
      DATABASE_URL: postgres://factory_admin:SecureFactoryPassword2024!@coffee-db:5432/coffee_factory_management
      JWT_SECRET: ProductionSecretKeyForCoffeeFactory2024
      PORT: 5000
    ports:
      - "5000:5000"
    depends_on:
      - coffee-db

volumes:
  pgdata:

Hạn chế và hướng phát triển

Hạn chế hiện tại

  • Thu thập dữ liệu IoT: Hiện tại thông số nhiệt độ máy rang và trọng lượng cân sàng lọc vẫn dựa trên giao diện nhập liệu của công nhân trực máy, chưa gắn trực tiếp cảm biến IoT (Internet of Things) để stream dữ liệu thời gian thực.
  • Dự báo nhu cầu nguyên liệu: Chưa tích hợp mô hình máy học (Machine Learning) để dự báo biến động giá và nhu cầu tiêu thụ hạt cà phê theo mùa vụ.

Hướng phát triển tương lai

  1. Tích hợp module IoT Gateway sử dụng vi điều khiển ESP32 hoặc giao thức MQTT để thu thập tự động thông số nhiệt độ/áp suất từ buồng rang công nghiệp.
  2. Ứng dụng mô hình AI Time-Series (ARIMA/LSTM) nhằm dự đoán nhu cầu nguyên liệu và lập lịch bảo trì thiết bị phòng ngừa (Predictive Maintenance).
  3. Mở rộng ứng dụng di động (Mobile App) trên nền tảng Flutter cho khách hàng theo dõi đơn hàng và tài xế cập nhật trạng thái vận chuyển thời gian thực.

Đối tượng hưởng lợi

  • Sinh viên ngành CNTT & Hệ thống thông tin: Cung cấp tài liệu mẫu chuẩn mực về đồ án phân tích thiết kế hệ thống hướng đối tượng (OOAD) sử dụng UML, từ khảo sát, viết đặc tả Use Case đến thiết kế lược đồ quan hệ.
  • Kỹ sư phần mềm & Nhà phát triển: Tham khảo mã nguồn thuật toán xử lý hao hụt sản xuất, kiến trúc cơ sở dữ liệu công nghiệp và thiết kế REST API an toàn.
  • Doanh nghiệp sản xuất cà phê vừa và nhỏ (SMEs): Tiếp cận mô hình chuyển đổi số tinh gọn với chi phí tối ưu, giúp kiểm soát 100% dòng luân chuyển nguyên liệu và giảm lãng phí vận hành.
  • Nhà nghiên cứu chuyển đổi số nông nghiệp: Dữ liệu thực chứng về số hóa quy trình chế biến nông sản sau thu hoạch tại Việt Nam.

Câu hỏi thường gặp

1. Yêu cầu phần cứng và môi trường để triển khai hệ thống là gì?

Hệ thống yêu cầu máy chủ tối thiểu: CPU 2 Cores, RAM 4GB, Ổ cứng SSD 40GB chạy hệ điều hành Linux (Ubuntu Server 22.04 LTS). Môi trường phần mềm bao gồm Docker v26.0+, Node.js v20.x hoặc JDK 17+, và cơ sở dữ liệu PostgreSQL 16+.

2. Hệ thống có khả năng mở rộng (Scalability) khi sản lượng nhà máy tăng gấp 10 lần không?

Kiến trúc phân tầng Stateless API cho phép mở rộng theo chiều ngang (Horizontal Scaling) bằng cách nhân bản container backend phía sau Load Balancer Nginx, kết hợp cơ chế Read Replica cho cơ sở dữ liệu PostgreSQL để chịu tải trên 10.000 giao dịch/phút.

3. Hệ thống có thể tích hợp với các phần mềm kế toán hoặc ERP có sẵn không?

Hệ thống cung cấp chuẩn RESTful API với định dạng trao đổi dữ liệu JSON và xác thực JWT. Các phân hệ Kế toán (Hóa đơn, Thu chi) và Kho vận có thể dễ dàng đồng bộ 2 chiều với các phần mềm như MISA, FAST hoặc SAP qua Webhooks.

4. Chi phí bảo trì và vận hành hệ thống ước tính như thế nào?

Do sử dụng hoàn toàn nền tảng mã nguồn mở (PostgreSQL, Linux, Docker, React/Node.js), doanh nghiệp không phải trả phí bản quyền phần mềm định kỳ. Chi phí duy trì hạ tầng Cloud VPS/Dedicated Server chỉ dao động từ 500.000 – 1.500.000 VNĐ/tháng.

5. Thời gian hoàn vốn (ROI) khi nhà máy áp dụng hệ thống là bao lâu?

Nhờ việc cắt giảm 15% hao hụt nguyên liệu (chiếm 50% chi phí sản xuất) và tiết kiệm 30% thời gian kiểm kê, tính toán giấy tờ của 30 nhân sự, thời gian hoàn vốn đầu tư triển khai ước tính đạt từ 6 đến 9 tháng.

Kết luận

Đồ án môn học "Phân tích và thiết kế hệ thống Quản lý nhà máy sản xuất cà phê" của nhóm sinh viên Trường Đại học Giao thông Vận tải TP.HCM đã giải quyết thành công bài toán chuyển đổi số trong một phân ngành sản xuất công nghiệp mũi nhọn. Bằng việc chuẩn hóa 18 Use Case chi tiết, thiết kế kiến trúc 3 lớp vững chắc, đề xuất thuật toán giám sát độ hao hụt nguyên liệu và tối ưu hóa quy trình bảo trì thiết bị, đề tài không chỉ đạt điểm số học thuật xuất sắc mà còn mang giá trị ứng dụng thực tiễn cao cho các xưởng chế biến nông sản tại Việt Nam. Đây là nền tảng vững chắc để tiếp tục phát triển thành giải pháp MES/ERP hoàn chỉnh kết nối IoT công nghiệp trong tương lai.