Chuyển đến nội dung chính

Cách hoạt động

Các ứng dụng có đồng bộ hóa thời gian thực giữ một cơ sở dữ liệu cục bộ trên thiết bị. Đọc là tức thời (cục bộ), ghi xếp hàng cục bộ, và mọi thứ đồng bộ hóa với máy chủ ở chế độ nền.
User writes -> Local database -> Upload queue -> Server -> Postgres
                                                            |
User reads  <- Local database <- Sync replication <---------+
Kết quả: đọc tức thời, không có spinner tải, và một ứng dụng hoạt động trên các kết nối yếu hoặc offline.

AI thiết lập những gì

Yêu cầu AI xây dựng một ứng dụng thời gian thực. Nó tái sử dụng một cơ sở dữ liệu hoạt động phù hợp nếu tồn tại; nếu không, nó tạo một cơ sở dữ liệu, bật dịch vụ đồng bộ hóa, và xây dựng một ứng dụng hai phần:
  • UI - ứng dụng khách với cơ sở dữ liệu cục bộ, truy vấn trực tiếp, và bộ kết nối đồng bộ hóa
  • Process - điểm cuối token, tuyến đường tải đồng bộ hóa, và trình chạy di chuyển
Thông tin xác thực được lưu trữ trong vault. AI kết nối các biến môi trường cơ sở dữ liệu vào thành phần quy trình bằng công cụ db. Trước khi ứng dụng được coi là sẵn sàng, cơ sở dữ liệu phải hiển thị sync: ready. Nếu đồng bộ hóa không sẵn sàng, ứng dụng có thể hiển thị nhưng dữ liệu thời gian thực trên nhiều thiết bị sẽ không hoạt động.

Quy tắc thực hành

  • Ghi cục bộ trước. Để đồng bộ hóa tải lên ở chế độ nền.
  • Hiển thị trạng thái trống, không phải spinner tải, khi dữ liệu cục bộ tồn tại.
  • Giữ trạng thái hiển thị cho người dùng trong các bảng được đồng bộ hóa để nó tồn tại qua làm mới và sử dụng offline.
  • Nhóm các ghi cục bộ liên quan với nhau để UI cập nhật dưới dạng một bước.
  • Xác minh tình trạng đồng bộ hóa trước khi gọi một ứng dụng thời gian thực hoàn tất.

Vỏ ứng dụng offline

Các mẫu UI có thể bao gồm một vỏ ứng dụng offline để ứng dụng có thể mở lại sau lần truy cập đầu tiên mà không cần mạng. Vỏ ứng dụng là HTML, JS, CSS, và biểu tượng tĩnh.
  • Vỏ offline làm cho ứng dụng mở mà không cần mạng
  • Đồng bộ hóa giữ dữ liệu ứng dụng có thể sử dụng được khi offline
Cùng nhau: ứng dụng mở mà không cần mạng, hiển thị dữ liệu được đồng bộ hóa mới nhất, xếp hàng các ghi mới, và đồng bộ hóa khi kết nối quay lại.

Khi nào sử dụng đồng bộ hóa thời gian thực

Phù hợpQuá mức
Ứng dụng quản lý tác vụ và ghi chúTrang tiếp thị tĩnh
Công cụ cộng tácGửi biểu mẫu một lần
Ứng dụng trường với kết nối yếuTrang brochure chỉ đọc
Bất cứ điều gì nên cảm thấy tức thìỨng dụng không có giá trị offline

Biến nền tảng

Kazzle tự động tiêm một bộ nhỏ các biến môi trường vào mọi quy trình ứng dụng. Chúng riêng biệt với bí mật vault của bạn.
BiếnNó là gì
PORTCổng mà quy trình của bạn nên lắng nghe
HOSTTên máy chủ để liên kết (thường là 0.0.0.0)
KAZZLE_API_URLURL cơ sở được sử dụng bởi trình trợ giúp thời gian chạy Kazzle
KAZZLE_APP_COMPONENT_<NAME>_URLURL thời gian chạy của một thành phần anh chị em

URL anh chị em

Khi một ứng dụng có nhiều thành phần (ví dụ: UI web và quy trình server), Kazzle có thể tiêm URL cho các thành phần anh chị em:
# In the "web" part:
KAZZLE_APP_COMPONENT_SERVER_URL=http://localhost:3001

# In the "server" part:
KAZZLE_APP_COMPONENT_WEB_URL=http://localhost:3000
Khi một anh chị em đã được triển khai, giá trị được tiêm chỉ vào thành phần được triển khai đó. Nếu không, nó chỉ vào địa chỉ phát triển hiện tại cho anh chị em đó.