FreshMesh—DXOS

Hàng tươi đúng nơi.
Giao nhận rõ trách nhiệm.

Một cửa hàng dư hàng, cửa hàng khác sắp hết. FreshMesh kết nối đề xuất, người phê duyệt, tài xế và cửa hàng nhận trong cùng một quy trình có kiểm soát.

DX-OS Open-Core · HPDI P · Apache-2.0 · Không IoT

Tổng quan tồn kho FreshMesh từ ứng dụng đang chạy
Ứng dụng thật. Dữ liệu demo giả lập, không phải số liệu doanh nghiệp.

Không chỉ chuyển hàng.
Chuyển cả trách nhiệm.

Đơn điều chuyển không dừng ở nút “đã giao”. Mỗi bước gắn với một vai trò, một trạng thái workflow và một tác động tồn kho. Cửa hàng nhận xác nhận số lượng thực tế; hàng giao thiếu được ghi lại thay vì biến mất trong báo cáo.

FreshMesh hướng tới chuỗi mini-mart nhỏ: giữ nghiệp vụ đủ gọn để triển khai, nhưng thể hiện đầy đủ bốn dịch vụ lõi phối hợp. Đề xuất nhập và giảm giá chỉ là khuyến nghị; chưa tích hợp nhà cung cấp hoặc POS.

Từ lô hàng đến lần bàn giao cuối.

Bốn vai trò. Một lịch sử có thể kiểm chứng.

  1. Đề xuấtQuản lý A-01 tạo phiếu. Tồn khả dụng được giữ chỗ; vượt tồn hoặc lô hết hạn bị từ chối.
  2. Phê duyệtChủ chuỗi xem đề xuất và workflow. Người tạo không tự duyệt. Từ chối giải phóng lượng đã giữ.
  3. Lập tuyến & xuất hàngOR-Tools sắp thứ tự điểm dừng, gán tài xế. Khi xuất hàng, tồn nguồn giảm đúng số lượng.
  4. Giao hàngTài xế được phân công ghi số thực giao và lý do chênh lệch. Không tự xác nhận thay cửa hàng.
  5. Nhận & chứng từQuản lý nơi nhận xác nhận thực nhận. Tồn đích tăng tương ứng; chứng từ có SHA-256 và phân quyền.
Hướng dẫn demo từng tài khoản ↗

Một nền tảng lõi mở.
Một không gian quy trình.

Identity / SSO

Keycloak · OIDC + PKCE S256. Danh tính, chuỗi, cửa hàng và vai trò được kiểm tra ở máy chủ.

API Gateway

Apache APISIX · Định tuyến, giới hạn tốc độ và request ID. Portal không gọi thẳng từng container.

Quản trị dữ liệu

PostgreSQL cho tồn kho và lịch sử. SeaweedFS S3 cho chứng từ, tải xuống qua API có xác thực.

Workflow

Flowable BPMN · Các human task phê duyệt, xuất hàng, giao và nhận được lưu bền vững.

Tầng 1: dịch vụ headless. Tầng 2: portal HPDI P. Tầng 3: nghiệp vụ điều chuyển và lộ trình. Ollama là tích hợp tùy chọn, không phải lõi bắt buộc và không có quyền thực thi.

Kiến trúc và ranh giới tin cậy ↗

Xem công việc diễn ra.

Ảnh Playwright được chụp sau khi dịch vụ thật xử lý yêu cầu; không dùng mock hoặc giao diện dựng sẵn.

Toàn bộ ảnh: đăng nhập, tạo phiếu, giao hàng, lõi và mobile ↗

Từ mã nguồn
đến lần giao đầu tiên.

Cần Docker Engine + Compose v2 và make. Kiểm tra source cần Python 3.12+, uv và Node.js 22+. Không cần API key AI hoặc dịch vụ SaaS đóng.

Portal: localhost:3180
Giới thiệu nội bộ: localhost:3180/about/

Trang này là giới thiệu công khai. Nút localhost chỉ hoạt động sau khi bạn chạy stack trên máy mình; đây không phải demo nghiệp vụ được host công khai.

git clone https://github.com/EngLandLee/FreshMesh-DXOS.git
cd FreshMesh-DXOS
cp .env.example .env
make up
curl --fail http://localhost:3180/api/health
make verify
make demo-check
npm ci --ignore-scripts
npx playwright install chromium
make ui-check

Tài khoản demo dùng mật khẩu demo123, chỉ trong môi trường phát triển cô lập.

Prerequisites, tài khoản, xử lý lỗi và dừng an toàn ↗

Mở để kiểm chứng.
Gọn để làm chủ.

Mã FreshMesh tự viết được phát hành Apache-2.0. Các engine tích hợp giữ giấy phép upstream riêng. Kho source, CI, lịch sử issue, bản phát hành, checksum và inventory dependency đều có thể kiểm tra.

Giới hạn: khoảng cách đường chim bay, dữ liệu giả lập, cấu hình phát triển nội bộ. Dự báo là trung bình bảy ngày; không tuyên bố đã triển khai federated learning. AI tùy chọn chưa được benchmark độ chính xác.