Cocot Wiki

Cocot Wiki

Cocot（没入型ASMR音声配信基盤）の横断的な知識を集めたOKF (Open Knowledge Format) 準拠のナレッジバンドル。コードを読む前にまずここを参照し、無駄な再探索を避けること。フォーマット仕様はリポジトリルートの OKF.md を参照。

各concept文書はfrontmatterのstatusで鮮度を示す（stable = 現状のコードベースを反映、draft = まだ実装されていない計画、deprecated = 過去の構成の記録）。

Architecture

• pipeline - works作成〜TUSアップロード〜transcode〜publishの全体フロー
• services - app/worker/postgres/garageの役割とcompose.yml上の関係
• auth - Firebase IDトークン検証とミドルウェアの使い分け
• database - sqlcワークフローとschema/queries/genの役割分担
• transcode - Opus変換の実装と永続ストレージ（Cocot Storage / R2）の接続設計
• transcode-sandbox - ffmpeg/ffprobeを認証情報なし・ネットワークなしの隔離コンテナへ分離した設計
• audio-post-design - 音声投稿機能の初版設計書（works/uploads/tagsデータモデルとAPI・TUS連携）
• upload-notifications - トランスコード完了/失敗のプッシュ通知設計（worker→app: Postgres LISTEN/NOTIFY、app→クライアント: SSE）

Data Model

• works-and-uploads - works/uploads/tags/work_tagsテーブルとステート遷移

Dev Environment

• mise-migration-plan - miseベースの開発環境（LSP・タスクランナー用）とDocker実行（現在の構成）
• current-setup - 旧・devcontainer構成（廃止済み、履歴）

Backend Structure

• restructuring-plan - package-per-feature構造とTDD対応の設計（現在の構成）
• known-issues - 旧構造の既知の課題（解消済み、履歴）

Testing

• e2e-smoke-testing - curlベースのE2Eスモークテスト（scripts/e2e-smoke.sh）の使い方
• known-findings - E2E検証で見つかった実バグの記録
• test-environment - 開発/テストでのDB・Garageバケット分離、gooseマイグレーション、mise tasksの設計
• opus-milestone-test-gaps - Opus変換マイルストーンのユニットテスト抜け穴埋め設計（/dig成果物）
• upload-hardening - マジックバイト検証・ffmpegフォーマット強制・audio-tmpクリーンアップの設計（/dig成果物）