UZU Docs

Appearance

アプリ開発 wiki ​

UZU は、複数のプラットフォームをサポートするモノレポとして構築された包括的なマーダーミステリーアプリケーションです。Web アプリケーション（Next.js）、モバイルアプリ（Flutter）、バックエンドサービス（Go）により、ユーザーはリアルタイム通信機能を備えたマーダーミステリーシナリオを作成、プレイ、管理できます。

開発作業での実践ガイド

実際のコーディング作業を行う際は、各セクションの開発ガイドを参照してください。開発コマンド、コーディング規約、デバッグ方法など、日常的な開発作業に必要な実践的な情報が記載されています。

🚀 クイックスタート ​

開発環境セットアップ ​

  1. 前提条件確認: Docker, Go 1.22+, Node.js 20+, Flutter 3.41+（.fvmrc 参照）
  2. 環境初期化: task init
  3. 開発サーバー起動:
    • task backend:dev (GraphQL サーバー)
    • task js:dev SERVICE=web (フロントエンド)
    • task mobile:dev (モバイル)

重要なリソース ​

📋 開発ガイド目次 ​

🛠️ 環境構築・セットアップ ​

💻 開発ガイド ​

🏗️ アーキテクチャ ​

🔄 GraphQL ​

📱 フロントエンド ​

JavaScript/Web ​

モバイル ​

ガイド ​

仕様書 ​

🖥️ バックエンド ​

基礎 ​

GraphQL ​

データベース ​

運用 ​

プロジェクト ​

🎮 UZU Code（ゲーム開発者向け） ​

クリエイター向けの SDK / CLI / Engine ドキュメントは外部公開サイト docs.code.uzu-app.com に一本化した（クイックスタート・API リファレンス・開発パターン・エンジンガイド・SafeArea 等）。社内 wiki には内部実装（アーキテクチャ・bridge・play-server）だけを置く。

🎭 マダミス.jp ​

サービス構成 ​

モノレポ構成をとっており、 uzuPJ/app 直下に各サービスが配置されています：

app/
├── backend/          # Goサービス（GraphQL、gRPC、ワーカー）
├── javascript/       # Next.jsアプリケーション
├── dart/            # Flutterモバイルアプリ
└── infra/           # Terraformインフラストラクチャ

開発チーム向け情報 ​

DB 構造確認 ​

GitHub - backend/dbdoc/README.md

GraphQL 仕様確認 ​

Apollo Studio - uzu-app-dev → 権限がない場合: 招待リンク

ログについて ​

全てのログ出力コードは一意に特定させるため、コードを付与する コードは、Go Playground から生成できる