文档 & 代码地图专家¶

# TypeScriptプロジェクト構造を分析（ts-morphライブラリを使用するカスタムスクリプトを実行）
npx tsx scripts/codemaps/generate.ts

# 依存関係グラフを生成
npx madge --image graph.svg src/

# JSDocコメントを抽出
npx jsdoc2md src/**/*.ts

a) すべてのワークスペース/パッケージを特定
b) ディレクトリ構造をマップ
c) エントリポイントを見つける（apps/*、packages/*、services/*）
d) フレームワークパターンを検出（Next.js、Node.jsなど）

各モジュールについて:
- エクスポートを抽出（公開API）
- インポートをマップ（依存関係）
- ルートを特定（APIルート、ページ）
- データベースモデルを見つける（Supabase、Prisma）
- キュー/ワーカーモジュールを配置

構造:
docs/CODEMAPS/
├── INDEX.md              # すべてのエリアの概要
├── frontend.md           # フロントエンド構造
├── backend.md            # バックエンド/API構造
├── database.md           # データベーススキーマ
├── integrations.md       # 外部サービス
└── workers.md            # バックグラウンドジョブ

# [エリア] コードマップ

**最終更新:** YYYY-MM-DD
**エントリポイント:** メインファイルのリスト

## アーキテクチャ

[コンポーネント関係のASCII図]

## 主要モジュール

| モジュール | 目的 | エクスポート | 依存関係 |
|--------|---------|---------|--------------|
| ... | ... | ... | ... |

## データフロー

[このエリアを通るデータの流れの説明]

## 外部依存関係

- package-name - 目的、バージョン
- ...

## 関連エリア

このエリアと相互作用する他のコードマップへのリンク

- JSDoc/TSDocコメントを読む
- package.jsonからREADMEセクションを抽出
- .env.exampleから環境変数を解析
- APIエンドポイント定義を収集

更新するファイル:
- README.md - プロジェクト概要、セットアップ手順
- docs/GUIDES/*.md - 機能ガイド、チュートリアル
- package.json - 説明、スクリプトドキュメント
- APIドキュメント - エンドポイント仕様

- 言及されているすべてのファイルが存在することを確認
- すべてのリンクが機能することをチェック
- 例が実行可能であることを確保
- コードスニペットがコンパイルされることを検証

# フロントエンドアーキテクチャ

**最終更新:** YYYY-MM-DD
**フレームワーク:** Next.js 15.1.4（App Router）
**エントリポイント:** website/src/app/layout.tsx

## 構造

website/src/
├── app/                # Next.js App Router
│   ├── api/           # APIルート
│   ├── markets/       # Marketsページ
│   ├── bot/           # Bot相互作用
│   └── creator-dashboard/
├── components/        # Reactコンポーネント
├── hooks/             # カスタムフック
└── lib/               # ユーティリティ

## 主要コンポーネント

| コンポーネント | 目的 | 場所 |
|-----------|---------|----------|
| HeaderWallet | ウォレット接続 | components/HeaderWallet.tsx |
| MarketsClient | Markets一覧 | app/markets/MarketsClient.js |
| SemanticSearchBar | 検索UI | components/SemanticSearchBar.js |

## データフロー

ユーザー → Marketsページ → APIルート → Supabase → Redis（オプション） → レスポンス

## 外部依存関係

- Next.js 15.1.4 - フレームワーク
- React 19.0.0 - UIライブラリ
- Privy - 認証
- Tailwind CSS 3.4.1 - スタイリング

# バックエンドアーキテクチャ

**最終更新:** YYYY-MM-DD
**ランタイム:** Next.js APIルート
**エントリポイント:** website/src/app/api/

## APIルート

| ルート | メソッド | 目的 |
|-------|--------|---------|
| /api/markets | GET | すべてのマーケットを一覧表示 |
| /api/markets/search | GET | セマンティック検索 |
| /api/market/[slug] | GET | 単一マーケット |
| /api/market-price | GET | リアルタイム価格 |

## データフロー

APIルート → Supabaseクエリ → Redis（キャッシュ） → レスポンス

## 外部サービス

- Supabase - PostgreSQLデータベース
- Redis Stack - ベクトル検索
- OpenAI - 埋め込み

# 外部統合

**最終更新:** YYYY-MM-DD

## 認証（Privy）
- ウォレット接続（Solana、Ethereum）
- メール認証
- セッション管理

## データベース（Supabase）
- PostgreSQLテーブル
- リアルタイムサブスクリプション
- 行レベルセキュリティ

## 検索（Redis + OpenAI）
- ベクトル埋め込み（text-embedding-ada-002）
- セマンティック検索（KNN）
- 部分文字列検索へのフォールバック

## ブロックチェーン（Solana）
- ウォレット統合
- トランザクション処理
- Meteora CP-AMM SDK

# プロジェクト名

簡単な説明

## セットアップ

\`\`\`bash
# インストール
npm install

# 環境変数
cp .env.example .env.local
# 入力: OPENAI_API_KEY、REDIS_URLなど

# 開発
npm run dev

# ビルド
npm run build
\`\`\`

## アーキテクチャ

詳細なアーキテクチャについてはdocs/CODEMAPS/INDEX.mdを参照してください。

### 主要ディレクトリ

- `src/app` - Next.js App RouterのページとAPIルート
- `src/components` - 再利用可能なReactコンポーネント
- `src/lib` - ユーティリティライブラリとクライアント

## 機能

- [機能1] - 説明
- [機能2] - 説明

## ドキュメント

- セットアップガイド
- APIリファレンス
- アーキテクチャ

## 貢献

[CONTRIBUTING.md](https://atomgit.com/GitHub_Trending/ev/ECC/blob/main/CONTRIBUTING.md)を参照してください

/**
 * リポジトリ構造からコードマップを生成
 * 使用方法: tsx scripts/codemaps/generate.ts
 */

import { Project } from 'ts-morph'
import * as fs from 'fs'
import * as path from 'path'

async function generateCodemaps() {
  const project = new Project({
    tsConfigFilePath: 'tsconfig.json',
  })

  // 1. すべてのソースファイルを発見
  const sourceFiles = project.getSourceFiles('src/**/*.{ts,tsx}')

  // 2. インポート/エクスポートグラフを構築
  const graph = buildDependencyGraph(sourceFiles)

  // 3. エントリポイントを検出（ページ、APIルート）
  const entrypoints = findEntrypoints(sourceFiles)

  // 4. コードマップを生成
  await generateFrontendMap(graph, entrypoints)
  await generateBackendMap(graph, entrypoints)
  await generateIntegrationsMap(graph)

  // 5. インデックスを生成
  await generateIndex()
}

function buildDependencyGraph(files: SourceFile[]) {
  // ファイル間のインポート/エクスポートをマップ
  // グラフ構造を返す
}

function findEntrypoints(files: SourceFile[]) {
  // ページ、APIルート、エントリファイルを特定
  // エントリポイントのリストを返す
}

/**
 * コードからドキュメントを更新
 * 使用方法: tsx scripts/docs/update.ts
 */

import * as fs from 'fs'
import { execSync } from 'child_process'

async function updateDocs() {
  // 1. コードマップを読む
  const codemaps = readCodemaps()

  // 2. JSDoc/TSDocを抽出
  const apiDocs = extractJSDoc('src/**/*.ts')

  // 3. README.mdを更新
  await updateReadme(codemaps, apiDocs)

  // 4. ガイドを更新
  await updateGuides(codemaps)

  // 5. APIリファレンスを生成
  await generateAPIReference(apiDocs)
}

function extractJSDoc(pattern: string) {
  // jsdoc-to-markdownまたは類似を使用
  // ソースからドキュメントを抽出
}

## ドキュメント: コードマップとドキュメントの更新

### 概要
現在のコードベース状態を反映するためにコードマップとドキュメントを再生成しました。

### 変更
- 現在のコード構造からdocs/CODEMAPS/*を更新
- 最新のセットアップ手順でREADME.mdを更新
- 現在のAPIエンドポイントでdocs/GUIDES/*を更新
- コードマップにX個の新しいモジュールを追加
- Y個の古いドキュメントセクションを削除

### 生成されたファイル
- docs/CODEMAPS/INDEX.md
- docs/CODEMAPS/frontend.md
- docs/CODEMAPS/backend.md
- docs/CODEMAPS/integrations.md

### 検証
- [x] ドキュメント内のすべてのリンクが機能
- [x] コード例が最新
- [x] アーキテクチャ図が現実と一致
- [x] 古い参照なし

### 影響
 低 - ドキュメントのみ、コード変更なし

完全なアーキテクチャ概要についてはdocs/CODEMAPS/INDEX.mdを参照してください。