Skip to content

Repository files navigation

CoffeeChain

Nền tảng truy xuất nguồn gốc cà phê theo chuỗi cung ứng đa bên, minh bạch dữ liệu và dễ kiểm chứng.

Demo Video MIT License Project Status

Demo

CoffeeChain Demo

Bấm vào ảnh demo để mở video: Xem demo trên Google Drive

Tổng quan dự án

CoffeeChain số hóa toàn bộ hành trình lô cà phê từ nông trại đến bán lẻ, giúp doanh nghiệp và người tiêu dùng truy xuất nguồn gốc sản phẩm theo từng bước xử lý.
Mỗi tác nhân trong chuỗi cung ứng ghi nhận dữ liệu theo vai trò riêng, tạo thành một lịch sử xuyên suốt, có thể đối chiếu và xác minh.

Dự án giải quyết bài toán gì

  • Minh bạch nguồn gốc: theo dõi đường đi của lô hàng theo từng công đoạn.
  • Chuẩn hóa quy trình: tách vai trò rõ ràng theo trách nhiệm vận hành.
  • Kiểm chứng dữ liệu: lưu vết lịch sử và bằng chứng cho từng lô.
  • Tăng niềm tin người dùng cuối: truy xuất công khai qua mã định danh sản phẩm.
  • Tăng khả năng phối hợp đa tổ chức trong chuỗi cung ứng.

Năng lực chính của hệ thống

  • Quản lý vòng đời lô theo 5 vai trò: Farmer, Processor, Roaster, Packager, Retailer.
  • Liên kết cha-con giữa các lô trong suốt chuỗi xử lý.
  • Quản lý chuyển giao lô giữa các tổ chức.
  • Đính kèm và xác minh bằng chứng liên quan đến lô.
  • Phát hành mã truy xuất công khai cho người tiêu dùng.
  • Cung cấp API và giao diện vận hành theo từng vai trò nghiệp vụ.

Luồng nghiệp vụ end-to-end

Farmer -> Processor -> Roaster -> Packager -> Retailer -> Người tiêu dùng

  1. Farmer tạo lô thu hoạch và cập nhật thông tin canh tác.
  2. Processor tiếp nhận lô hợp lệ để tạo lô sơ chế.
  3. Roaster tạo lô rang và bổ sung bằng chứng.
  4. Packager tiếp nhận chuyển giao, đóng gói và phát hành mã truy xuất.
  5. Retailer cập nhật trạng thái thương mại (IN_STOCK, SOLD).
  6. Người tiêu dùng truy xuất hành trình sản phẩm qua mã công khai.

Công nghệ sử dụng

  • Hyperledger Fabric
  • Fabric CA
  • CouchDB
  • Spring Boot (Java 21)
  • PostgreSQL
  • IPFS
  • Next.js
  • Docker & Docker Compose

Contributing

Contributions, issues, và feature requests đều được chào đón.
Để bắt đầu, vui lòng mở Issue mô tả đề xuất hoặc bug cần xử lý trước khi gửi Pull Request.

License

Dự án được phát hành theo giấy phép MIT.

About

Coffee supply chain traceability system built on Hyperledger Fabric, implementing batch-based provenance tracking, role-based access control, and QR-based public verification

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages