〜とりあえず触って、もう動いた話〜
PocketBase、名前は聞いたことあるけど
「結局なにが楽なの？」
「Firebaseと何が違うの？」
と思っている人向けの、超軽いHands-Onです。
今回は思想も設計論も抜き。
とりあえず触って、動いたところまで。
PocketBaseって何？
一言でいうと、
認証つきDB＋API＋管理画面が、最初から全部あるやつ
です。
Firebaseみたいに
「まずプロジェクト作って…
ルール書いて…
SDK入れて…
あ、認証は別？」
みたいなことは起きません。
起動した瞬間から、全部ある。
起動
PocketBaseは単体バイナリ。
公式サイトではこう謡っています。
Open Source backend in 1 file
./pocketbase serveこれだけで、
- 管理画面
- REST API
- 認証
- DB
全部立ち上がります。
ブラウザで管理画面を開くと、もう触れる。
このスピード感、たまりませんw
コレクションを作る
今回は最小構成。
Members コレクション
会員、というより「識別用」。
- code : text（必須）
- 他は何もいらない
名前？住所？電話番号？
今回はいりません。
VisitLog コレクション
来店ログ。
- member : relation（Members / single）
- visitedAt : date（必須）
これだけ。
2コレクションで終了。
API Rules（今回は深く考えない）
Hands-Onなので割り切ります。
- List / View / Create / Update / Delete
- すべて
@request.auth.id != ""
つまり、
ログインしてる人だけ触れる
これだけ。
難しいことは後回し。
APIはもう生えている
何も定義していませんが、もうAPIは使えます。
/api/collections/Members/records/api/collections/VisitLog/records
Firebaseでいう「Functions書かないと…」は不要。
超シンプルなHTMLから叩く
今回はSDKすら使いません。
fetchで直叩き。
ログイン
POST /api/collections/users/auth-with-password会員を検索（なければ作る）
GET /Members?filter=code="ABC123"
POST /Members来店ログを追加
POST /VisitLogこれだけで、
- 会員を見つける
- なければ作る
- 来店ログを積む
が成立します。
フォームもレポートも不要。
画面はこんな感じ
以下は「会員コードで検索→なければ作成→来店ログ追加」の中身だけ。他の処理は割愛。
// Members: codeで検索→なければ作成
async function getOrCreateMemberByCode(code) {
code = String(code || "").trim();
if (!code) throw new Error("会員コードが空です");
// 1) 検索（code完全一致）
const q = new URLSearchParams({
filter: `code="${code.replace(/"/g, '\\"')}"`
});
const list = await pbFetch(`/api/collections/Members/records?${q.toString()}`, {
method: "GET",
});
if (list?.items?.length) {
const m = list.items[0];
log("member found", m.id, m.code);
return m;
}
// 2) 無ければ作成
const created = await pbFetch(`/api/collections/Members/records`, {
method: "POST",
body: JSON.stringify({ code })
});
log("member created", created.id, created.code);
return created;
}※ 認証処理（ログイン〜トークン取得）は省略。
※ pbFetch は Authorization ヘッダ付きの薄い fetch ラッパー。
- 会員コード入力
- 前回来店日の表示
- 今日の来店を1クリックで記録
「え、これだけ？」
はい、それだけです。
触ってみた感想
正直なところ、
- Firebaseより静か
- Supabaseより軽い
- 自分で考える余地が多い
という印象。
良くも悪くも、
APIで好きにやれ
という思想が前に出ています。
今回はここまで
今回は、
- 設計論
- 正規化
- 本格的な権限設計
そういう話は一切していません。
ただ、
起動して
コレクション作って
API叩いたら
もう動いた
この感覚だけ持ち帰ってもらえれば十分。
PocketBaseは
「重い話を始める前に、まず触れる」
タイプのツールです。
まとめ
- PocketBaseは「Mini Firebase」的に使える
- 初期セットアップが異常に軽い
- コレクション作るだけでAPIが生える
- Hands-Onはノー天気なくらいがちょうどいい
深い話は、また別の記事で。
