ログイン不要・URLひとつで完結する日程調整サービス
デモ: https://matenaiyo.vercel.app
「調整さん」の核であるログイン不要・URL共有だけで使える手軽さはそのままに、UI/UXと技術基盤をモダン化した日程調整ツールです。
- カレンダーUIで候補日選択 — カレンダーをタップして候補日を複数選択し、各日に時刻を設定(プリセット追加・自由入力・終日指定に対応)
- ○△×で出欠回答 — 名前 + 各候補日への回答 + ひとことコメント
- リアルタイム集計 — 誰かが回答すると開いている画面が自動で更新される(Supabase Realtime を購読、未設定時は約5秒間隔のポーリングにフォールバック)
- 日程確定 → カレンダー連携 — 幹事が日程を確定すると
.icsダウンロードと Google カレンダー追加リンクを表示 - 候補日程の追加・削除 — 幹事管理ページ(
/e/[slug]/admin)で、集計を見ながら候補日程を後から追加・削除できる(削除するとその候補への回答も消え、候補は最低1件残る) - OGP画像自動生成 — トップページは静的OGP画像、イベントページ(
/e/[slug])はnext/ogでイベント名・回答件数を反映した画像を動的生成 - ダークモード対応
- 回答の再編集 — 参加者ごとの編集トークンをlocalStorageに保持し、同じ端末から自分の回答を編集可能
- 期限切れイベントの自動削除 — 最終更新から一定期間で削除対象になり、事前に削除予告を表示(Vercel Cronで実行)
| レイヤ | 選定 |
|---|---|
| フレームワーク | Next.js 16 (App Router) + React 19 + TypeScript |
| UI | Tailwind CSS v4 + shadcn/ui(カレンダーは react-day-picker) |
| DB + リアルタイム | Supabase(Postgres + Realtime) |
| ORM | Drizzle ORM |
| バリデーション | Zod |
| レート制限 | Upstash Redis(@upstash/ratelimit) |
| ホスティング | Vercel(next/og、Vercel Cronによる自動削除込み) |
| Lint / 型検査 | Biome + tsc |
| テスト | Vitest(ユニット) / Playwright(E2E) |
詳細な設計は DESIGN.md を参照してください。
pnpm installDocker ComposeでPostgresを起動します(ポート 54322)。
docker compose up -d.env.example をコピーして .env を作成します。ローカル開発では DATABASE_URL 以外は未設定でも動作します(Realtimeはポーリングにフォールバック、レート制限は無効)。
cp .env.example .env| 変数 | 用途 | 未設定時の挙動 |
|---|---|---|
DATABASE_URL |
Postgres接続文字列 | 必須 |
NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY |
集計ページのRealtime購読 | 両方揃わない場合は約5秒間隔のポーリングにフォールバック |
UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN |
作成・回答系ActionのIPベースレート制限 | 未設定ならレート制限は無効(ローカル/CI向け) |
CRON_SECRET |
/api/cron/cleanup の認証(Vercel Cronが自動付与) |
未設定だとエンドポイントは500を返し、誤削除を防ぐ安全側に倒す |
NEXT_PUBLIC_GA_ID |
Google Analytics 4の測定ID | 未設定ならスクリプトを読み込まない |
pnpm db:migrateスキーマ変更時は以下でマイグレーションファイルを生成します。
pnpm db:generatepnpm devhttp://localhost:3000 で確認できます。
| コマンド | 内容 |
|---|---|
pnpm dev |
開発サーバーを起動 |
pnpm build |
本番ビルド |
pnpm start |
本番ビルドの起動 |
pnpm check |
Biomeによるlint/format検査 + tsc --noEmitによる型検査 |
pnpm check:fix |
上記の自動修正版 |
pnpm test |
Vitestによるユニットテスト |
pnpm test:e2e |
Playwrightによるe2eテスト |
pnpm db:generate |
Drizzleのマイグレーションファイル生成 |
pnpm db:migrate |
マイグレーションの適用 |
.github/workflows/ci.yml にて、pnpm check → pnpm test → pnpm build → pnpm db:migrate → pnpm test:e2e をPostgresサービスコンテナ上で実行しています。
Supabase Free プランはアクティビティがない状態が7日間続くと、データベースが自動的に一時停止されます。本番環境の停止を防ぐため、.github/workflows/supabase-keepalive.yml で週2回(月曜・木曜の12:00 JST)自動的にデータベースアクセスを実行しています。
psql で直接 Postgres 接続(pooler 経由)し、keepalive テーブルの確保(CREATE TABLE IF NOT EXISTS)、30日以上前のレコード削除、レコード1件の INSERT を1ステップで実行します。本プロジェクトは Data API (PostgREST) を無効にしているため REST API 経由は使わず、直接接続の DB アクティビティで keepalive します。万一これがアクティビティとしてカウントされない場合も、停止の約1週間前に Supabase から警告メールが届くため検知できます。
以下の環境変数を GitHub リポジトリの Settings > Secrets and variables > Repository secrets に設定してください。
| シークレット | 説明 |
|---|---|
DATABASE_URL |
Supabase のコネクションプーラ(shared pooler)経由の Postgres 接続文字列。GitHub Actions ランナーが IPv4 のみのため、IPv6 オンリーの直接接続ホストではなく pooler を使う(Vercel に設定済みの値と同じでよい) |
GitHub Actions の UI から Supabase Keepalive ワークフローの Run workflow ボタンで手動実行できます。
- public リポジトリの scheduled workflow の自動無効化: GitHub は public リポジトリで60日間コミットがないと、schedule トリガーのワークフローを自動無効化します。本番環境で重要な場合は定期的にコミットを行うか、ワークフローが無効化されていないか定期的に確認してください