SHINJU DATE

「SHINJU DATE」はななしいんくに所属するタレントがYouTubeで配信や投稿した動画を検索できるウェブサービスです。ななしいんくが定める二次創作ガイドラインに従ってななしいんくとは直接の関係がない営利を目的としていない団体であるHaneru Developersによって開発と運営が行われています。

プロジェクト構成

このプロジェクトは、複数のアプリケーションと共有パッケージで構成される monorepo です。

アプリケーション (apps/)

• web - 公開ウェブサイト (https://shinju.date) のフロントエンド
• admin - コンテンツ管理用の管理画面
• batch - 定期実行されるバッチ処理 (Nitro)
• insights - データ分析や用語集生成などを行う Python ベースの API

共有パッケージ (packages/)

• ui - 共有UIコンポーネント (Button, Input, Dialog, Cardなど)
• tailwind-config - 共有Tailwind CSSテーマ設定（カラーパレット、フォントなど）
• database - データベース接続と型定義
• msw-handlers - 開発・テスト用 MSW モックハンドラ
• youtube-api-client - YouTube API クライアント
• logger - 共有ログ機能
• constants - 共通定数
• helpers - 汎用ユーティリティ関数
• health-checkers - ヘルスチェック機能
• retryable-fetch - リトライ機能付き fetch
• temporal-fns - 日時操作ユーティリティ
• youtube-scraper - YouTube データスクレイピング

技術スタック

• フロントエンド: Next.js (App Router), TypeScript, Tailwind CSS
• バックエンド: Nitro (Batch), Next.js API Routes (Web/Admin), FastAPI (Python/Insights)
• データベース: Supabase (PostgreSQL)
• キャッシュ: Upstash Redis
• パッケージマネージャー: pnpm
• モノレポ管理: Turbo
• コード品質: Biome (JavaScript/TypeScript), Ruff (Python)

開発を始める

プロジェクトの開発環境をセットアップするには、docs/setup-guide.md に従ってください。

このガイドには、前提条件、依存関係のインストール、Supabase・Redisのローカル設定、開発サーバーの起動方法などが含まれています。

より詳細な貢献方法については、CONTRIBUTING.md を参照してください。

ドキュメント

• CONTRIBUTING.md - 開発・貢献ガイド
• AGENTS.md - AI エージェント活用ガイド
• docs/ - プロジェクト固有のドキュメント
  • Setup Guide - セットアップガイド（最初に読むべきドキュメント）
  • Coding Guidelines - コーディング規約
  • Testing Guide - テストガイド
  • MSW Guide - MSW モック統合ガイド
  • Hybrid Recommendation System - ハイブリッドオススメシステム
  • Supabase Implementation - Supabase実装詳細

ローカル開発環境

GitHub Codespaces / Dev Containers

このプロジェクトは GitHub Codespaces および Dev Containers に対応しています。

Codespaces で開始

1. GitHubリポジトリページで「Code」→「Codespaces」→「Create codespace on main」をクリック
2. 自動的に以下が実行されます：
   • 依存関係のインストール（pnpm install）
   • Docker Compose経由でSupabase・Redisサービスが起動
   • パッケージのビルド

Supabase ローカル環境

ローカル開発では Docker Compose で管理される Supabase サービスを使用します。必要に応じて起動時に環境変数を上書きできます。

# そのまま起動（既定の開発用値が compose.yml に含まれています）
docker compose up -d

# サービスの状態確認
docker compose ps

# 任意の値に差し替えて起動する例
SUPABASE_ANON_KEY=... \
SUPABASE_SERVICE_ROLE_KEY=... \
SUPABASE_JWT_SECRET=... \
SUPABASE_POSTGRES_PASSWORD=... \
docker compose up -d

# データのインポート
pnpm db:import

# サービスの停止
docker compose down

詳細は セットアップガイド を参照してください。

コマンド

# 全アプリケーションの開発サーバー起動
pnpm run dev

# ビルド
pnpm run build

# テスト実行
pnpm run test

# コード品質チェック
pnpm run check --fix

ライセンス

MIT