Design baseline · 28 SEP 2026 · 01 / 23
Thiết kế để mở rộng.
logiSA 2.0 · Architecture & Development Cookbook
Đang triển khai: UC-01. Check Cont/Seal — một user story của OPS. UC-02–05 là kế hoạch mở rộng.
Process Definition định nghĩa quy trình logistics end-to-end. Workflow con do một Role sở hữu và gồm nhiều Task. Runtime giữ state; executor chạy việc cụ thể.
Khám phá kiến trúc ↗ Đọc contractTHE CORE IDEAProcess Definition
Process Definition
↳ Workflow
↳ Task graph
Cont/Seal hiện là vertical slice chuyên biệt; chưa chạy trên Process/Workflow runtime tổng quát.
Quyết định nền tảng đã chốt
| Khái niệm | Trách nhiệm |
|---|---|
| Role | Đại diện trách nhiệm logistics, policy và capability được phép. Một Role sở hữu một Workflow; không gắn vendor/model cố định vào Role. |
| Process Orchestrator | Phân loại intent, correlate Business Case/Process Instance và chọn Workflow con cần start/resume. Một message không mặc định là một Task hay Workflow mới. |
| Task | Đơn vị việc nằm trong Workflow; task graph có thể tuần tự, rẽ nhánh, song song, join hoặc chờ. |
| Workflow | Quy trình con có đúng một Role owner và nhiều Task. Khi đổi Role, handoff sang Workflow khác trong cùng Process Definition. |
| Skill / Tool | Skill tái sử dụng nghiệp vụ; tool là adapter thực thi. AI chỉ cần ở bước thích hợp; một skill có thể hoàn toàn deterministic. |
| Shared Core | Shipment, khách hàng, workflow state, event history, identity và evidence dùng chung. Memory hỗ trợ quyết định, không ghi đè dữ liệu đã xác minh. |
Phân biệt thiết kế và runtime: API/database draft cũ còn cần căn chỉnh; hierarchy chuẩn là Process Definition → Workflow → Task. Runtime hiện có một legacy OPS image task và một CUSTOMER_SERVICE send task trong cùng legacy instance cho UC-01; bảng hiện trạng và phần còn thiếu ở Delivery & migration.
Lộ trình đọc
01 · Hiểu hệ thống
Ranh giới, owner, luồng xử lý và deployment.
02 · Chốt dữ liệuERD, constraints, transaction và versioning.
03 · Viết code theo hợp đồngEnvelope, schema, API, lỗi và tương thích.
04 · Kiểm chứng nghiệp vụHappy path, ngoại lệ và acceptance criteria.
Phạm vi sản phẩm
Zalo trước; adapter WeChat, Sheet, Customs được mở rộng cùng contract. UI gồm Workflows, Role, Tasks/Executions, Review và Integrations. Mỗi tenant sở hữu cấu hình và dữ liệu riêng. Trang tài liệu này public và chỉ chứa ví dụ giả lập.