リアルタイム同期

仕組み

リアルタイム同期を備えたアプリは、デバイス上にローカルデータベースを保持します。読み取りは即座（ローカル）、書き込みはローカルでキューイングされ、すべてがバックグラウンドでサーバーに同期されます。

ユーザー書き込み -> ローカルデータベース -> アップロードキュー -> サーバー -> Postgres
                                                            |
ユーザー読み取り  <- ローカルデータベース <- 同期レプリケーション <---------+

結果：即座の読み取り、ローディングスピナーなし、悪い接続やオフラインでも動作し続けるアプリ。

AI が設定すること

AI にリアルタイムアプリを構築するよう依頼します。適切なアクティブなデータベースが存在する場合は再利用し、そうでない場合はデータベースを作成し、同期サービスを有効にして、2 部構成のアプリを構築します：

UI - ローカルデータベース、ライブクエリ、同期コネクタを備えたクライアントアプリ
Process - トークンエンドポイント、同期アップロードルート、マイグレーションランナー

認証情報はVaultに保存されます。AI は db ツールを使用してデータベース環境変数をプロセスコンポーネントに接続します。アプリが準備完了と見なされる前に、データベースは sync: ready を表示する必要があります。同期が準備完了でない場合、アプリはレンダリングされる可能性がありますが、クロスデバイスのリアルタイムデータは機能しません。

経験則

ローカルに最初に書き込みます。バックグラウンドで同期アップロードを行わせます。
ローカルデータが存在したら、ローディングスピナーではなく空の状態を表示します。
ユーザーに見える状態を同期テーブルに保持して、更新とオフライン使用に対応させます。
関連するローカル書き込みをグループ化して、UI が 1 ステップで更新されるようにします。
リアルタイムアプリを完成させる前に同期の健全性を確認します。

オフラインアプリシェル

UI テンプレートにはオフラインアプリシェルを含めることができるため、最初の訪問後にネットワークなしでアプリを再度開くことができます。アプリシェルは静的 HTML、JS、CSS、アイコンです。

オフラインシェルはネットワークなしでアプリを開きます
同期はオフライン中にアプリデータを使用可能に保ちます

合わせて：アプリはネットワークなしで開き、最新の同期データを表示し、新しい書き込みをキューイングし、接続が戻ったときに同期します。