Skip to content

About

日程調整サービス[DaySynth]

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

887 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DaySynth

DaySynth は、学生団体、サークル、バンド練習、小規模チーム向けの予定調整アプリです。ログイン不要で候補日を共有し、参加者の空き時間を集めて、複数の予定をまとめて確定できます。スマホ中心の操作性を重視し、ICS 出力や Google Calendar 連携にも対応しています。

サービス概要

DaySynth は「短時間で集まれる候補を決める」ことに特化した、再利用しやすい OSS の予定調整基盤です。イベント作成から回答収集、確定、カレンダー連携までを一連の流れで扱えます。

解決する課題

  • 参加者全員の予定を手作業で照合する負担を減らします。
  • ログイン必須の重い導線を避け、招待リンクだけで調整を始められます。
  • 複数の確定予定を扱えるため、練習日と予備日などをまとめて管理できます。
  • ICS と Google Calendar の連携で、確定後の反映漏れを減らします。

主な機能

  • ログイン不要の公開回答フロー
  • 期間から候補日を自動生成するイベント作成
  • カレンダー上での手動選択による候補調整
  • 空き時間の可視化
  • 複数予定の確定とカレンダー連携
  • ICS ダウンロードと Google Calendar 連携
  • Google ログイン時の履歴同期、お気に入り、アカウントページ
  • 予定テンプレートの管理と回答の自動反映

技術スタック

  • Next.js App Router
  • TypeScript
  • React 19
  • Supabase
  • Supabase RLS
  • NextAuth
  • Tailwind CSS / daisyUI
  • Jest
  • Playwright

デモURL

スクリーンショット

以下は公開ページの主要ビジュアルです。

DaySynth light hero

DaySynth dark hero

LP以外の主要画面は、改修時にデスクトップ/モバイルの比較画像を docs/screenshots/uiux-refresh/ へ一時出力します。このディレクトリはGit管理対象外です。表示確認後、共有が必要な画像はPRコメントへ掲載してください。

イベントフローの比較画像を取得する場合は、開発サーバーを起動したうえで次を実行します。

CAPTURE_UIUX_SCREENSHOTS=true npm run test:e2e:chrome:public

セットアップ手順

前提条件

  • Node.js 22 以上
  • npm 10 系
  • Docker
  • Supabase CLI

1. リポジトリを取得

git clone <repository-url>
cd multi-schedule-app

2. 依存関係をインストール

npm ci

3. 環境変数を用意

cp .env.example .env.local

Supabase のローカル環境を起動して、表示された値を .env.local に反映します。

4. Supabase ローカル環境を起動

npx supabase start

5. 開発サーバーを起動

npm run dev

環境変数

.env.example に最小構成を置いています。主な変数は次のとおりです。

変数 用途
SUPABASE_URL Supabase API の URL
SUPABASE_ANON_KEY クライアント公開用キー
SUPABASE_SERVICE_ROLE_KEY サーバー側で使う管理キー
SUPABASE_DB_URL ローカルまたは接続先 DB URL
SUPABASE_DB_PASSWORD Supabase ローカル DB のパスワード
NEXTAUTH_SECRET NextAuth の署名用シークレット
NEXTAUTH_URL アプリのベース URL
MCP_CLIENTS MCPの事前登録クライアント設定(未設定なら無効)
NEXT_PUBLIC_GOOGLE_ANALYTICS GA4 の測定 ID(開発環境では送信しない)
GOOGLE_CLIENT_ID Google ログイン用クライアント ID
GOOGLE_CLIENT_SECRET Google ログイン用クライアントシークレット

MCP接続

MCPクライアントから本人の予定・回答を操作できます。既存のGoogleログインと認証テーブルを利用するため、追加のマイグレーションは不要です。導入にはHTTPSのNEXTAUTH_URL、既存のNEXTAUTH_SECRET、事前登録クライアントのMCP_CLIENTS設定が必要です。設定形式、公開ツール、同期時の扱いはDaySynthのMCP接続を参照してください。

ChatGPTではOAuthの事前定義クライアント設定、Gemini WebではCustom appsのAdvanced featuresからクライアントの認証情報を設定します。各製品が指定する戻り先を登録し、利用条件は上記ドキュメントの接続手順を確認してください。

開発用ログイン

ローカルでは開発用ログインを有効化できます。

ENABLE_DEV_LOGIN=true
NEXT_PUBLIC_ENABLE_DEV_LOGIN=true
DEV_LOGIN_ID=devuser
DEV_LOGIN_PASSWORD=devpass

本番環境では自動で無効化される前提です。

Supabase設定の概要

  • supabase/migrations/ にスキーマ変更を追加します。
  • ローカル検証は npx supabase start と npx supabase db reset を使います。
  • 型定義は npx supabase gen types typescript --linked > src/lib/database.types.ts で更新します。
  • クライアントから DB へ直接アクセスせず、サーバー経由で処理します。
  • RLS を前提に、公開データと認証データの境界を明確にしています。

よく使う Supabase コマンド

npx supabase stop
npx supabase status
npx supabase migration new <name>
npx supabase migration up
npx supabase db reset
npx supabase db push
npx supabase gen types typescript --linked > src/lib/database.types.ts

開発コマンド

コマンド 用途
npm run dev 開発サーバー起動
npm run build 本番ビルド
npm run start ビルド済みアプリ起動
npm run lint ESLint 実行
npm run typecheck 型チェック
npm run test Jest ウォッチ実行
npm run test:ci CI 向け Jest 実行
npm run test:unit Jest 実行
npm run test:db:data-api DB直接アクセス権限の回帰テスト
npm run test:e2e Playwright 実行
npm run test:e2e:chrome 公開フロー + 認証フローの推奨実行
npm run test:e2e:chrome:public 専用ポート3200で公開フローを実行
npm run test:e2e:auth 専用ポート3201で認証フローを実行
npm run format Prettier で整形

ブラウザE2Eテスト

MCPのブラウザE2Eテストは npm run test:e2e:mcp で別途実行します。通常の公開テストコマンドは @auth-required を除外し、認証コマンドはアカウント管理テストだけを指定するため、MCPは対象外です。 検証用DB・認証テーブルと開発用ログインを用意し、別ターミナルで開発サーバーを起動してください。 例: ENABLE_DEV_LOGIN=true NEXT_PUBLIC_ENABLE_DEV_LOGIN=true NEXTAUTH_URL=http://localhost:3201 npm run dev -- --port 3201。 テスト側にも E2E_BASE_URL=http://localhost:3201 NEXTAUTH_URL=http://localhost:3201、 開発ログインと同じ DEV_LOGIN_ID / DEV_LOGIN_PASSWORD、MCP_CLIENTS を設定して実行します。 MCP_CLIENTS はサーバーとテストの両方に同じJSONを渡してください。形式は MCP接続を参照してください。.env.local はMCPテスト側では自動的に読み込まれません。 HTTPのlocalhostを使う場合は開発モードが必要です。本番モードではHTTPSが必須です。

npm run test:e2e:chrome の認証段階では、必須環境の不備や前提テーブルの不足を失敗として扱います。 公開段階が失敗した場合、後続の認証段階は実行されません。各テスト結果(成功・失敗・スキップ)とその理由を 確認し、スキップや未実行を検証完了に含めないでください。動画は失敗時だけ保存します。 E2Eで画面幅を変更しただけでは、タッチ操作を検証したことにはなりません。

MCPのPostgreSQL回帰テスト

CIでは隔離したPostgreSQL 16を起動し、MCPの検索・予定取得を実際のSQLで検証します。ローカルで実行する場合は、Dockerで専用DBを起動します。

docker run --rm --detach --name daysynth-mcp-test \
  --publish 127.0.0.1:55438:5432 \
  --env POSTGRES_DB=mcp_test --env POSTGRES_PASSWORD=mcp-local-test postgres:16
docker exec daysynth-mcp-test pg_isready -U postgres -d mcp_test
MCP_TEST_DATABASE_URL=postgresql://postgres:mcp-local-test@127.0.0.1:55438/mcp_test \
  npm run test:unit -- --runInBand src/lib/__tests__/mcp-read-services.integration.test.ts
docker stop daysynth-mcp-test

pg_isreadyで接続可能になってからテストを実行してください。回帰テストは専用DB内の対象テーブルを再作成するため、開発用・本番用のDBを指定しないでください。接続先はlocalhostまたは127.0.0.1のmcp_testデータベースに限定します。MCP_TEST_DATABASE_URLを省略した通常のJest実行では、PostgreSQL回帰テストをスキップします。

Data API権限のPostgreSQL回帰テスト

npm run test:db:data-api は、空の使い捨てPostgreSQLに既存マイグレーションと権限制限マイグレーションを適用し、匿名・認証済みロールのアクセス拒否とservice_roleの回答保存・日程確定を検証します。CIでもMCPテストとは別のDBで実行します。

docker run --rm --detach --name daysynth-data-api-test \
  --publish 127.0.0.1:55439:5432 \
  --env POSTGRES_DB=data_api_security_test --env POSTGRES_PASSWORD=data-api-local-test postgres:16
docker exec daysynth-data-api-test pg_isready -U postgres -d data_api_security_test
DATA_API_TEST_DATABASE_URL=postgresql://postgres:data-api-local-test@127.0.0.1:55439/data_api_security_test \
  npm run test:db:data-api
docker stop daysynth-data-api-test

接続先はlocalhostまたは127.0.0.1のdata_api_security_testに限定し、既存テーブルがある場合は中断します。pg_isreadyで接続可能になってから実行してください。再実行時はコンテナを作り直してください。開発用・本番用DBは指定しないでください。Nodeで検証するため、過去の初期化SQLにあるpgTAP拡張の作成だけを省略します。権限制限マイグレーションは加工せず適用します。

デプロイ方法

  • Vercel へのデプロイを想定しています。
  • vercel.json で /api/cron の定期実行を設定しています。
  • 本番環境では SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY、NEXTAUTH_SECRET、NEXTAUTH_URL、Google OAuth の設定を用意してください。
  • デプロイ前に npm run build と npm run test:ci を通しておくと安心です。

ロードマップ

  • 公開フローの導線改善
  • カレンダー連携の分かりやすいガイド強化
  • 小規模コミュニティ向けの共有テンプレート拡充
  • 自己ホスト向けセットアップ手順の簡略化
  • 英語ドキュメントの拡充

コントリビューション案内

  • 変更前に関連する仕様書と既存実装を確認してください。
  • 仕様に関わる変更は、先に issue で意図を共有すると安全です。
  • GitHub Flow を採用しています。main から feature/、fix/、chore/ などの短命ブランチを切り、main 向け PR としてレビューを依頼してください。
  • リリース専用ブランチは作らず、main にマージされた変更をそのままリリース対象として扱います。
  • 変更後は npm run lint、npm run typecheck、npm run test:ci を実行してください。
  • UI 変更には必要に応じて Playwright のテストを追加してください。
  • 秘密情報、個人情報、非公開 URL はコミットしないでください。

詳細は CONTRIBUTING.md を参照してください。

Git 運用

  • 長寿命ブランチは main のみです。
  • 作業は main を最新化してから feature/<要約>、fix/<要約>、chore/<要約> などのブランチを作って進めます。
  • 変更は main 向け Pull Request で統合し、作業途中は Draft PR で早めに共有できます。
  • マージは Squash and merge を原則とし、main は常にデプロイ可能な状態を維持します。
  • 旧 develop ブランチは移行期間中の参照用として残す場合がありますが、新規作業のベースには使いません。

GitHub 側の推奨設定

  • Default branch は main に設定します。
  • main の branch protection で Pull Request 必須、直接 push 禁止、必須ステータスチェック Quality checks を有効化します。
  • マージ方法は Squash merge を有効化し、必要がなければ Merge commit と Rebase merge は無効化します。
  • 開いている PR の base branch が develop の場合は main へ付け替えます。
  • develop は移行直後に削除せず、参照用の read-only ブランチとして扱うか、移行確認後に削除を判断します。

ドキュメント

ライセンス

  • MIT License を採用しています。詳細は LICENSE を参照してください。
  • Copyright (c) 2026 @ktkms

About

日程調整サービス[DaySynth]

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Used by

Contributors

Languages