From 25d806267714b55e6c309b082473374364525f13 Mon Sep 17 00:00:00 2001
From: lda <lda@ldlda.com>
Date: Fri, 11 Sep 2026 05:39:43 +0700
Subject: [PATCH] this

---
 .env.example                   | 10 +++++++++-
 .gitignore                     |  3 +++
 scripts/prepare_sqlx_sqlite.sh |  3 ++-
 3 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/.env.example b/.env.example
index 00ab460..ee4cd88 100644
--- a/.env.example
+++ b/.env.example
@@ -1 +1,9 @@
-SQLX_OFFLINE=true
+# Live mode (local dev): query! macros validate every query against the real
+# schema on each build, so the .sqlx cache is only needed for DB-less builds.
+# Run scripts/prepare_sqlx_sqlite.sh once first — it creates and migrates the DB.
+# Use an absolute path so builds work from any working directory.
+DATABASE_URL=sqlite:///absolute/path/to/wakey-prepare.sqlite3
+
+# Offline mode (CI / packaging): force the committed .sqlx cache.
+# Takes precedence over DATABASE_URL when set.
+#SQLX_OFFLINE=true
diff --git a/.gitignore b/.gitignore
index f56763f..24aba88 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,3 +20,6 @@ target/
 .env
 
 .codex
+
+# sqlx prepare DB (created by scripts/prepare_sqlx_sqlite.sh)
+wakey-prepare.sqlite3*
diff --git a/scripts/prepare_sqlx_sqlite.sh b/scripts/prepare_sqlx_sqlite.sh
index 0286db0..732baf1 100755
--- a/scripts/prepare_sqlx_sqlite.sh
+++ b/scripts/prepare_sqlx_sqlite.sh
@@ -2,7 +2,7 @@
 set -eu
 
 ROOT="$(CDPATH='' cd -- "$(dirname -- "$0")/.." && pwd)"
-DB="${SQLX_PREPARE_DB:-/tmp/wakey-sqlx-prepare.sqlite3}"
+DB="${SQLX_PREPARE_DB:-$ROOT/wakey-prepare.sqlite3}"
 DATABASE_URL="sqlite://$DB"
 
 if ! cargo sqlx --version >/dev/null 2>&1; then
@@ -23,3 +23,4 @@ cp .sqlx/*.json wakey-control-plane/.sqlx/
 
 echo "SQLx metadata prepared in $ROOT/.sqlx"
 echo "SQLx package metadata mirrored in $ROOT/wakey-control-plane/.sqlx"
+echo "Prepare DB (referenced by .env for live compile-time checking): $DB"