Tổng quan kiến trúc
Các thành phần của ShopNexus và cách chúng nối với nhau, từ app Android tới các kho dữ liệu sau server.
ShopNexus gồm một app Android native và một server Go. Server là một modular monolith: một binary duy nhất, chia thành các module, mỗi module giữ bảng của riêng nó và đưa ra một service cho module khác gọi. Server phục vụ HTTP API ở cổng 8080 và endpoint cho Restate gọi ở cổng 9080.
flowchart LR app[App Android] -->|HTTP API, live stream| server[Server Go<br/>các module] app -->|xác minh số điện thoại| firebase[Firebase] app -->|tải ảnh lên| rustfs[(RustFS)] server --> pg[(Postgres<br/>ParadeDB)] server <-->|durable flow, event| restate[Restate] server --> rustfs server -->|kiểm tra token đăng nhập| firebase server --> push[FCM push] server --> llm[Nhà cung cấp LLM]
Postgres 18 bản ParadeDB chứa mọi bảng và cả index full-text mà tìm kiếm dùng. Restate chạy vài use case buộc phải chạy xong dù server có sập giữa chừng, và chuyển event từ module này sang các module khác. RustFS lưu ảnh qua S3 API: app tải ảnh thẳng lên bằng URL presigned, rồi server xử lý từng ảnh thành bản đã thu nhỏ, công khai.
App xác minh số điện thoại qua Firebase rồi gửi cho server token mà Firebase trả về. Server gửi push qua Firebase Cloud Messaging, và hỏi một mô hình ngôn ngữ (qua API tương thích OpenAI) xem câu tìm kiếm của người dùng nghĩa là gì.
Khi Restate ngừng chạy, các thao tác đọc, refresh phiên đăng nhập và mọi use case không phải durable flow vẫn chạy bình thường; event nằm chờ trong bảng.