Random Chat Development Workflow

このスキルは、Random_Chatプロジェクト（Flutter/Go/WebRTCチャットプラットフォーム）での開発作業をサポートします。

前提条件

作業を開始する前に、以下のドキュメントを必ず確認してください：

1. `docs/INFRASTRUCTURE.md` - システムアーキテクチャ

2. `docs/KNOWLEDGE.md` - ドメイン知識

3. `docs/ROADMAP.md` - 開発ロードマップ

4. `docs/STRUCTURE.md` - 機能実装詳細（通報、BAN、NGワード、TURN等）

5. `docs/DOING&DONE.md` - 作業ログ（作業中にこのファイルを更新する）

プロジェクト構成

```

Random_Chat/

├── frontend/ # Flutter Web (Riverpod状態管理)

│ └── lib/

│ ├── screens/ # UI画面（ホーム、タグ選択、待機、チャット）

│ ├── services/ # API、WebSocket、WebRTC、認証サービス

│ ├── providers/ # Riverpodプロバイダー

│ └── config/ # 環境設定

├── backend/ # Go APIサーバー

│ ├── cmd/server/ # エントリーポイント

│ └── internal/

│ ├── handler/ # HTTPハンドラー

│ ├── matching/ # Redisベースのマッチングキュー

│ └── signaling/ # チャット&WebRTC用WebSocketハブ

├── docker/nginx/ # Nginx設定

└── supabase/ # データベーススキーマ

```

開発フロー

ローカル開発（Docker Compose）

1. **全サービスの起動:**

```bash

docker compose up -d --build

```

2. **ログの確認:**

```bash

docker compose logs -f backend

```

3. **ヘルスチェック:**

```bash

curl http://localhost:8000/health

```

4. **Redisのクリア:**

```bash

docker compose exec redis redis-cli FLUSHALL

```

Flutter Web開発

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

```bash

cd frontend

flutter pub get

```

2. **ローカル実行（ローカルバックエンドに接続）:**

```bash

flutter run -d chrome

```

3. **本番用ビルド:**

```bash

flutter build web --release

```

Goバックエンド（Linux用クロスコンパイル）

```powershell

cd backend

docker run --rm -v "${PWD}:/app" -w /app golang:1.22-alpine sh -c "CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server ./cmd/server"

```

本番環境デプロイ

サーバー情報

Flutter Webのデプロイ

```bash

ローカルでビルド

flutter build web --release

サーバーへアップロード

scp -r frontend/build/web [email protected]:/tmp/flutter-web-update/

ssh [email protected] "sudo rm -rf /var/www/hanashitime.com/* && sudo cp -r /tmp/flutter-web-update/web/* /var/www/hanashitime.com/ && sudo chown -R www-data:www-data /var/www/hanashitime.com"

```

サーバー上でのバックエンド管理

```bash

cd /opt/random-chat

docker-compose -f docker-compose.prod.yml ps

docker-compose -f docker-compose.prod.yml logs -f backend

docker-compose -f docker-compose.prod.yml restart

```

システムアーキテクチャ

主要サービス

ユーザーフロー

1. Supabase経由で匿名認証

2. タグを選択してマッチングキューに参加（Redis sorted set）

3. バックエンドが共通タグを持つユーザーをマッチング

4. WebSocketで両ユーザーをルームに接続

5. チャットメッセージはWebSocket経由でリレー

6. オプション: WebRTC P2P経由で音声/ビデオ

安全機能

通報システム

自動BAN

```sql

UPDATE ban_settings SET report_threshold = 5; -- 閾値変更

UPDATE ban_settings SET ban_duration_hours = 24; -- 一時BAN

```

NGワード検出

Supabaseマイグレーション

Supabase SQLエディタで新しいマイグレーションを適用:

```bash

supabase/migrations/002_auto_ban.sql # 自動BANトリガー

```

管理パネル

- ダッシュボード: 統計表示（総ユーザー数、BAN済みユーザー、保留中の通報、本日の通報）

- 通報: 保留中の通報を確認、解決/却下/BAN

- BAN管理: BAN済みユーザーの表示、BAN解除、ユーザーIDによる手動BAN

- 自動BAN設定: 閾値と期間の設定

管理パスワードの変更

```sql

-- 新しいパスワードのSHA-256ハッシュを生成して更新

DELETE FROM admin_settings;

INSERT INTO admin_settings (password_hash) VALUES ('<sha256-hash>');

```

テスト方法

重要な注意事項

1. **言語**: すべてのコミュニケーションとドキュメントは日本語を使用

2. **作業ログ**: `docs/DOING&DONE.md`を作業中に必ず更新

3. **ユーザー操作**: ビルドとGit操作はユーザーが実行

4. **管理パネル**: パスワード変更UIなし - SQLで直接実行

作業開始時の手順

1. 関連するドキュメントファイル（docs/内）を読む

2. 作業内容を`docs/DOING&DONE.md`に記録

3. ローカル環境でテスト

4. 変更を確認

5. 完了時に`docs/DOING&DONE.md`を更新