database.md

テーブル定義

Cloudflare D1 (SQLite)。スキーマは packages/db/src/schema.ts (Drizzle)、マイグレーションは packages/db/migrations/。

日時の列は TEXT で、既定値は CURRENT_TIMESTAMP。認証のテーブルは better-auth が使う。

users

ユーザー。

列	型	制約	内容
id	TEXT	PK
name	TEXT	NOT NULL、既定 ''	表示名
email	TEXT	NOT NULL、UNIQUE
email_verified	INTEGER (boolean)	NOT NULL、既定 0
image	TEXT
created_at	TEXT	NOT NULL
updated_at	TEXT	NOT NULL

sessions

ログインセッション。

列	型	制約	内容
id	TEXT	PK
user_id	TEXT	NOT NULL、FK → users.id (削除時に連鎖削除)
token	TEXT	NOT NULL、UNIQUE
expires_at	TEXT	NOT NULL
ip_address	TEXT
user_agent	TEXT
created_at	TEXT	NOT NULL
updated_at	TEXT	NOT NULL

インデックス: sessions_user_id_idx (user_id)

accounts

認証方式ごとのアカウント情報。パスワードのハッシュや、将来の OAuth のトークンを持つ。

列	型	制約	内容
id	TEXT	PK
user_id	TEXT	NOT NULL、FK → users.id (削除時に連鎖削除)
account_id	TEXT	NOT NULL	認証方式側のアカウント ID
provider_id	TEXT	NOT NULL	認証方式 (メール/パスワードなど)
password	TEXT		パスワードのハッシュ
access_token	TEXT
refresh_token	TEXT
id_token	TEXT
access_token_expires_at	TEXT
refresh_token_expires_at	TEXT
scope	TEXT
created_at	TEXT	NOT NULL
updated_at	TEXT	NOT NULL

インデックス: accounts_user_id_idx (user_id)

verifications

確認用のトークン。

列	型	制約	内容
id	TEXT	PK
identifier	TEXT	NOT NULL
value	TEXT	NOT NULL
expires_at	TEXT	NOT NULL
created_at	TEXT
updated_at	TEXT

インデックス: verifications_identifier_idx (identifier)

tasks

タスク。仕様は Web アプリ仕様、リマインドは ワーカー仕様 を参照。

列	型	制約	内容
id	TEXT	PK	UUID
user_id	TEXT	NOT NULL、FK → users.id	所有者
title	TEXT	NOT NULL	1〜200 文字 (アプリ側で検証)
status	TEXT	NOT NULL、既定 'todo'	ボードの列。todo / doing / done
position	REAL	NOT NULL、既定 0	列の中の順番。小さいほど上。新しいタスクは min(未着手の position) - 1、2 枚の間に入れたときは中間の値
description	TEXT	NOT NULL、既定 ''	本文 (Markdown)
description_version	INTEGER	NOT NULL、既定 0	本文の版。保存のたびに 1 増える。古い版からの保存を断るために使う
due_at	TEXT		締め切り (UTC の ISO 8601)
completed_at	TEXT		完了日時。status が done のときだけ入る
remind_before_minutes	INTEGER		締め切りの何分前にリマインドするか。NULL はリマインドなし
reminder_queued_at	TEXT		リマインドをキューに積んだ日時。NULL なら未処理。締め切りかリマインドの設定を変えると NULL に戻る
created_at	TEXT	NOT NULL

インデックス: tasks_due_at_idx (due_at, completed_at, reminder_queued_at)。リマインドの検索用。

attachments

タスクの添付ファイルのメタデータ。ファイルの中身は R2 にある。

列	型	制約	内容
id	TEXT	PK	UUID
task_id	TEXT	NOT NULL、FK → tasks.id (削除時に連鎖削除)
user_id	TEXT	NOT NULL、FK → users.id	所有者
filename	TEXT	NOT NULL	元のファイル名
content_type	TEXT	NOT NULL
size	INTEGER	NOT NULL	バイト数
r2_key	TEXT	NOT NULL	R2 のキー
created_at	TEXT	NOT NULL

インデックス: attachments_task_id_idx (task_id)

task_members

タスクの共有相手。所有者は tasks.user_id で表すので、ここには入らない。

列	型	制約	内容
task_id	TEXT	PK (複合)、FK → tasks.id (削除時に連鎖削除)
user_id	TEXT	PK (複合)、FK → users.id (削除時に連鎖削除)	共有された人
created_at	TEXT	NOT NULL	共有した日時

インデックス: task_members_user_id_idx (user_id)

task_invites

アカウントがないメールアドレスへの共有 (招待)。そのアドレスでアカウントができると、task_members に移して削除する。

列	型	制約	内容
task_id	TEXT	PK (複合)、FK → tasks.id (削除時に連鎖削除)
email	TEXT	PK (複合)	小文字にそろえたメールアドレス
created_at	TEXT	NOT NULL	共有した日時

インデックス: task_invites_email_idx (email)

マイグレーション

• スキーマを変えたら pnpm db:generate で SQL を生成する。
• 名前は内容が分かるものにする (例: 0002_add_better_auth_tables)。
• 適用済みのマイグレーションの名前やファイルは変更しない。
• ローカルへの適用: pnpm db:migrate:local、本番: pnpm db:migrate:remote。

ローカルのデータを見る

just sql "select * from tasks"

just が使えない場合は、apps/web で pnpm exec wrangler d1 execute kanban-db --local --persist-to .wrangler/state-drizzle-baseline --command "..." を実行する。