Eda.ai

Eda.aiとは

Eda.aiは、ブランチ機能（checkout、merge）を通じて、柔軟で視覚的なAIチャットを実現するアプリケーションです。

Gitのようなブランチ構造により、会話の分岐や統合を直感的に操作でき、複数の会話の流れを視覚的に管理することができます。

活用方法

• 多角的な意思決定のサポート
• 用途別に適切なアウトプットの作成(経営層用、エンジニア用、)
• 小説のシナリオ検証
• 会話途中で、あまり本題とは関係ないが聞きたいことを聞きたいとき

ローカルでのセットアップ

1. 依存関係のインストール

pnpm install

2. Lefthookの有効化

pnpm prepare

3. 環境変数の設定

.env.exampleを.envにコピーして使用してください。

cp .env.example .env

4. ローカルデータベースの起動

dockerを使用します。

docker compose up -d

5. データベースマイグレーション

pnpm exec prisma migrate dev

6. 開発サーバーの起動

pnpm dev

開発ガイドライン

コミット時に以下のチェックが自動で実行されます（Lefthookによる自動化）。

• Biome check: フォーマットとリントの確認
• Typecheck: 型エラーの確認

エラーが出た場合の対処

• Biome checkでエラーが出た場合は、以下のコマンドを実行してから再度コミットしてください：

pnpm format

• Typecheckでエラーが出た場合は、型エラーを修正してから再度コミットしてください。

ドキュメント

本プロジェクトの各種仕様・設計に関する詳細は、docs/ ディレクトリ以下のドキュメントをご参照ください。

開発・運用ガイド

• コマンドリファレンス (commands.md) - ローカル開発やビルド、DB操作で使用できるコマンドの一覧

アーキテクチャ・データ構造

• データベース設計 (database.md) - Eda.aiのER図、各テーブルの役割、自己参照（ブランチ・メッセージ）の解説
• APIドキュメント (APIDOC.md) - サーバー連携（tRPCやServer Actions）のエンドポイントやデータインターフェース仕様

画面・UI・デザイン

• 画面遷移設計 (page-transition.md) - アプリケーション全体の画面フローとルーティング構造
• デザインシステム (design/design_system.md) - UIコンポーネントの設計方針と共通化のルール
• カラーパレット (design/color-palette.md) - アプリケーションで使用されるテーマカラーや配色の定義

技術選定・意思決定 (ADR)

• 制作背景(decision/production_background.md) - 制作背景の説明
• バックエンド設計 (decision/backend_design.md) - バックエンドアーキテクチャの選定理由や全体構成
• 技術選定 (decision/technology_selection.md) - プロジェクトで採用した主要技術（Next.js, Prisma, Better Authなど）の選定基準と理由