メインコンテンツまでスキップ

用語集

すべてを覚える必要はありません。初めて出てきた言葉を、このプロジェクトでの役割に結び付けるためのページです。

用語VideoQでの意味
API画面や外部ツールからの要求を受け、権限を確認してデータや処理結果を返す部分
HonoAPIのHTTPリクエストや共通処理を組み立てるフレームワーク
tRPC / procedureTypeScriptの型を共有するAPIの仕組み / videos.get のような1つの操作
Zod受け取った値・返す値の形を検査するライブラリ
TanStack Query画面でのデータ取得、キャッシュ、読み込みやエラー状態を管理するライブラリ
Drizzle / migrationDB定義・問い合わせのための道具 / DBの構造やデータを更新する変更履歴
repositoryDBの読み書きをまとめたコード。Gitリポジトリとは文脈が異なる
service権限確認やDB・外部サービスへの操作を組み立てる業務処理
Cloudflare WorkersHono APIが動く本番の実行基盤
Python workerapps/worker にある、文字起こしなどの非同期処理プログラム
SQS / ElasticMQジョブを受け渡すキュー / ローカルで使うSQS互換のキュー
R2 / Garage動画ファイルなどの保管先 / ローカルで使う互換ストレージ
Neon / PostgreSQL本番で使うDBサービス / その基盤となるデータベース
HyperdriveCloudflare WorkersからPostgreSQLへ接続するための仕組み
Durable Object(DO)状態を持つCloudflareの実行単位。利用制限、ジョブ回復の予約、チャット回答の実行に使用
embedding(埋め込み)文章の意味を比較できるようにした数値の配列。APIの質問とworkerの字幕で同じモデル・次元を使う
pgvectorPostgreSQLで埋め込みを保存・検索する拡張
RAG関連資料を検索してから回答を作る方式。VideoQでは動画の字幕や登録情報を参照する
LLM回答の生成に使う言語モデル
OpenRouter回答、画像確認、埋め込み、文字起こしに使うホスト型のゲートウェイ。オンプレでは社内サーバーに置き換え可能
ワークロードIDフェデレーション保存したAPIキーの代わりに、実行環境のAWS IDでOpenRouterを呼び出す仕組み
エージェント / ツール呼び出しモデルが講座情報取得・シーン検索など登録済みの操作を選び、APIが権限の範囲内で検証・実行する仕組み
構造化回答 / ChatAnswer本文と出典IDの組である segments と、サーバーが管理する動画・時刻情報の sources を持つ共通の回答形式
outbox業務データと同じDBに「あとで配送するジョブ」を記録し、配送漏れを回復できるようにする仕組み
冪等性同じ処理を再実行しても、意図しない重複などを生まない性質
lease(リース)一定時間だけ処理の実行権を確保する仕組み。処理停止後に再試行できるよう期限を持つ
SSEサーバーからブラウザへ順次データを送る通信方式。チャット回答の逐次表示に使用
MCPAIアシスタントなどの外部クライアントがツールを呼び出すためのプロトコル
OAuth / scope外部クライアントにアクセスを許可する仕組み / 許可する操作の範囲
quota(クォータ)保存容量・動画処理時間・AI回答数などの利用上限

次に読む: 動画・講座・シーンの関係、コードの場所。