🌐
Web App
HTTPS + IndexedDB cache. Luôn ưu tiên server, có thể giữ draft/note nhẹ khi mất mạng.
V12.1 · Hybrid Cloud + Desktop
Một hệ thống, hai cách mở — dữ liệu phải là một
Web và bản cài trên máy dùng cùng API, cùng quyền và cùng cloud database. Desktop chỉ giữ cache/offline queue; khi có mạng, mọi thay đổi đi qua Sync Engine rồi mới trở thành dữ liệu chính thức trên server.
Đang online
☁️
Cloud Core
PostgreSQL + Storage + Realtime + Auth. Đây là nguồn sự thật duy nhất cho toàn bộ tổ chức.
💻
Desktop App
Cùng frontend, đóng gói bằng Tauri. SQLite cache + file cache + Outbox để làm việc khi offline.
Trạng thái đồng bộ thiết bị
Những chỉ số này phải có trên cả web và desktop để người dùng luôn biết dữ liệu đã lên cloud chưa.
Kết nốiOnline
Thay đổi chờ0
Lần sync cuốiVừa xong
Offline pack284 MB2 khóa đã tải
App version9.0.0Đã cập nhật
Ma trận đồng bộ toàn bộ tính năng
Không phải chức năng nào cũng nên cho “offline rồi tự ghi đè”; các phần nhạy cảm cần policy khác nhau.
| Tính năng | Web online | Desktop online | Desktop offline | Khi có mạng lại | Quy tắc xung đột |
|---|---|---|---|---|---|
| Tài khoản / vai trò / quyền | Đầy đủ | Đầy đủ | Dùng quyền đã cache | Refresh token + quyền mới | Server luôn thắng; role bị thu hồi phải khóa local ngay khi sync. |
| Lịch lớp / giáo viên / dạy thay | Tạo & xác nhận | Tạo & xác nhận | Chỉ lưu nháp | Server chạy conflict check rồi mới publish | Hard conflict không auto-merge |
| Điểm danh | Realtime | Realtime | Được nhập | Sync từng học viên | Merge theo record học viên; nếu 2 GV sửa cùng một người thì hiện conflict. |
| Đăng thông báo / note lớp | Đăng ngay | Đăng ngay | Queue | Đăng theo thứ tự Outbox | Post mới là append-only; edit dùng version. |
| Tạo bài tập / test | Đầy đủ | Đầy đủ | Draft được | Upload file → kiểm tra → publish | Không publish offline nếu có deadline/lịch cần kiểm tra. |
| Làm test online | Autosave | Autosave | Nếu test đã tải | Gửi attempt + answers | Final submit bất biến theo attempt ID; không để answer key nhạy cảm trong cache. |
| Nộp bài file / PDF / Word / Excel | Upload | Upload | Queue file | Resumable upload + checksum | Chỉ hiện “Đã nộp” sau server ACK; trước đó là “Chờ đồng bộ”. |
| Bài luyện nói / audio | Upload | Record + upload | Record local | Resume upload khi online | Giữ file local tới khi server xác nhận hash + storage object. |
| Chấm điểm / feedback | Đầy đủ | Đầy đủ | Draft feedback | Optimistic-lock publish | Nếu bài đã được GV khác chấm, bắt buộc chọn bản nào giữ. |
| Sổ tay / từ vựng / ngữ pháp | Đầy đủ | Đầy đủ | Đầy đủ | Delta sync từng item | Item UUID riêng; sửa khác trường thì merge, cùng trường thì hỏi người dùng. |
| Chat / comment / reaction | Realtime | Realtime | Queue gửi | Send theo client_message_id | Idempotent; không gửi trùng khi retry. |
| Tài liệu đã tải về | Browser cache | File cache | Xem offline | Kiểm tra version/hash | File mới tạo version mới; không ghi đè file đang mở. |
| Khóa học hết hạn / archive | Server | Server | Read-only cache | Nhận trạng thái mới | Server authoritative; local tự khóa khi nhận trạng thái ended/archived. |
Demo Outbox — thao tác khi mất mạng
Thử tắt mạng rồi tạo các thay đổi. Khi online lại, Sync Engine đẩy từng mutation và kiểm tra quyền/xung đột.
Tạo thay đổi
Nhật ký Sync Engine
Luồng dữ liệu chuẩn
Frontend web và desktop tuyệt đối không tự coi local database là nguồn chính.
Web / Desktop UITạo mutation có UUID
→
Sync Engine + APIAuth · idempotency · conflict check · permissions
→
Cloud PostgreSQLCommit + change event + storage metadata
Chiều ngược lại: Realtime/Broadcast hoặc delta-pull theo sync cursor cập nhật Web IndexedDB và Desktop SQLite.
Offline Pack
Người dùng chọn khóa cần mang theo. Không tải toàn bộ dữ liệu doanh nghiệp về máy.
IELTS Speaking B1 · Offline Pack
Lịch 30 ngày · slide/PDF · audio · note đã ghim · bài tập mở · test cho phép offline. Không tải private admin data hay answer key nhạy cảm.
Ước tính 142 MB
Smart Conflict Resolution
Sync tốt không chỉ “retry”; phải giúp người dùng hiểu bản nào mới hơn và tránh ghi đè im lặng.
ConflictLịch dạy
Desktop draft khác với lịch Cloud mới.
Desktop: Group B · 18:30–19:30 · tạo 16:20 offline.
Cloud: Cô Hà đã được gán IELTS B1 · 18:00–19:30 · cập nhật 16:27.
Không có nút “ghi đè Cloud” vì đây là hard schedule conflict.
Prefetch thông minhWi‑Fi
Tải trước thứ học viên sắp cần.
Ưu tiên tài liệu của 3 buổi tới + assignment đang mở + audio đã ghim; không tải toàn bộ kho tài nguyên.
Giảm dung lượng, nhưng người học vẫn có đủ nội dung cho 7 ngày tiếp theo.
8 quy tắc tôi đề nghị khóa cứng trong sản phẩm
1. Cloud là source of truthSQLite/IndexedDB chỉ cache, không phải database thứ hai.
2. Mọi mutation có client_mutation_idRetry bao nhiêu lần cũng không tạo bài/nộp file trùng.
3. Lịch xung đột phải kiểm tra serverOffline chỉ draft; không tự xác nhận teacher slot.
4. File dùng checksum + resumable uploadMất mạng giữa 90% không phải upload lại từ đầu.
5. Hiển thị trạng thái thật“Đã lưu trên máy” khác “Đã đồng bộ lên cloud”.
6. Logout phải purge cache theo userTránh người sau mở máy đọc dữ liệu lớp trước.
7. Private data mặc định không offlineAdmin secrets, private teacher notes và dữ liệu nhạy cảm chỉ cache khi thật cần.
8. App update tách khỏi data syncDesktop auto-update code; Sync Engine cập nhật dữ liệu. Hai việc không được lẫn nhau.