Cairn
日本語 | English
山岳部の山行計画を起点とした、プロジェクト管理・チャット・カレンダー・ファイル管理・ギャラリー・AIアシスタントを統合したコラボレーションアプリケーション。
設計資料と作業別の参照先は docs/README.md、AI エージェント向けの規約は AGENTS.md を参照。
ローカル開発環境
必要なツール: Node.js 22.x (>=22.23.4) / 24.x (>=24.22.1) / 26.x (>=26.12.1) のいずれか / pnpm 9+ / Supabase CLI / Docker（Supabase CLI が使用）
リポジトリルートで実行する。
pnpm install
supabase start # PostgreSQL / Auth / Storage / Realtime / Studio
cp apps/web/.env.local.example apps/web/.env.local # supabase start の既定キーが設定済み
# apps/web/.env.local の CALENDAR_TOKEN_ENCRYPTION_KEY に次の出力を設定する（必須。投票アプリの署名・Bot トークンの暗号化に使う）
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
supabase migration up --local --include-all # 未適用のマイグレーションだけ適用
pnpm dev # http://localhost:3128
- 初回は
/auth/signup でアカウントを作る（ローカルはメール確認不要）
- pull・ブランチ切り替え後も
supabase migration up --local --include-all で差分を適用する。.env.local の再コピーや DB の reset は不要
- メンション・DM・ファイルの通知は Inngest 経由のため、確認するときは Inngest dev server も起動する
- キーが変わったときは
supabase status で確認する。停止は supabase stop
コマンド
pnpm dev # 開発サーバー（apps/web）
pnpm build # 全パッケージビルド
pnpm typecheck # 型チェック
pnpm lint # Lint
pnpm test # テスト
pnpm format # フォーマット
DB マイグレーション
スキーマは packages/db/src/schema/ が正。変更したときだけ SQL を生成する。
pnpm --filter @cairn/db db:generate # supabase/migrations/ に出力。内容を確認してから適用
supabase migration up --local --include-all
pnpm --filter @cairn/db db:studio # Drizzle Studio
- 生成ファイル名の付け方と後方互換のルールは
packages/db/AGENTS.md
--include-all は、並行開発でマージ順とタイムスタンプ順が前後しても履歴にないマイグレーションを適用するため（CI の migrate.yml と同じ）supabase db reset --local は DB を作り直し、既存データを失う。破棄してよい環境でのみ使う
リポジトリ構成
apps/
web/ Next.js 15（Web + API Route Handlers + リモート MCP /api/mcp）
mobile/ Expo（WebView ラッパー + ネイティブチャット + Push）
desktop/ Electron（デプロイ済みの Web 版を表示）
packages/
core/ DB・フレームワーク非依存のドメインロジック（@cairn/core/billing）
db/ Drizzle ORM スキーマ・クライアント
shared/ 共有型・Zod スキーマ・FEATURE_FLAGS
config/ tsconfig・ESLint 共有設定
supabase/ Supabase CLI 設定とマイグレーション SQL
docs/ 設計資料
その他のアプリ・機能
ライセンス
Apache License 2.0
