Odds PoC
概要
Odds PoC は Jester のコンテンツ管理機能を提供するアプリケーション（バックエンド API）です。 レース情報・記事・ブログ・過去ブログ・カテゴリ・メディア・NGワードの登録・編集・削除といった 日常的な管理操作を担い、AI による生成処理の起点にもなります。
管理画面（user-web）からこの API を呼び出して操作します。
提供する機能
レース情報管理
AI 記事・ブログ生成の入力データとなるレース情報（オートレース・競輪・競馬）を管理します。
| 操作 | 説明 |
|---|---|
| 登録 | 競技種別を指定し、レース結果の JSON ファイルをアップロードして登録する |
| AI予想の登録 | レース前の出走表と AI予想印の JSON ファイルを、既存のレースへ紐づける |
| 一覧表示 | 競技種別ごとにレースの一覧を確認する（紐づく最新記事のステータスも表示） |
| 詳細表示 | 特定のレースの詳細を確認する |
| 更新 | レース名・レース結果を変更する |
| 削除 | 不要なレース情報を削除する |
競技種別はレースIDで自動判別される
レースIDは競技をまたいで一意のため、詳細取得・更新・削除では競技種別の指定が不要です。 一覧取得のときだけ、どの競技を表示するか指定します。
記事管理
レース結果10秒サマリー記事を管理します。手動入力と AI 自動生成の両方に対応しています。
| 操作 | 説明 |
|---|---|
| 手動作成 | タイトルと本文を直接入力して記事を作成する |
| AI生成リクエスト | レースとタイトルを指定して AI に記事を生成させる |
| 再生成リクエスト | 生成に失敗した記事を、追加指示を添えて作り直す |
| 一覧表示 | 記事の一覧を確認する（レース・ステータスでの絞り込みに対応） |
| 詳細表示 | 特定の記事の内容を確認する |
| 更新 | 記事の内容や公開期間などを変更する |
| 削除 | 不要な記事を削除する |
過去ブログ管理
移行対象の過去ブログ記事を管理します。
| 操作 | 説明 |
|---|---|
| 取り込み | スクレイピング済みの過去ブログ記事を登録する（登録時に検索用のベクトルも作成する） |
| 一覧表示 | 過去ブログの一覧を確認する（レースでの絞り込みに対応） |
| 詳細表示 | 特定の過去ブログの内容を確認する |
| カテゴリの更新 | 大分類（カテゴリ）を変更する。ベクトルも作り直される |
| AIリライトリクエスト | 過去ブログを指定して AI にリライトさせる |
ブログ管理
AI が生成したブログ記事を管理します。
| 操作 | 説明 |
|---|---|
| AI生成リクエスト（リライト） | 過去ブログを指定して AI にリライトさせる |
| AI生成リクエスト（書き下ろし） | レースを指定して、レース回顧または予想を AI に書かせる |
| 手動作成 | タイトルと本文を直接入力してブログを作成する |
| 一覧表示 | ブログの一覧を確認する（レース・競技種別・カテゴリ・出自・ステータス・タイトルでの絞り込みに対応） |
| 詳細表示 | 特定のブログの内容を確認する |
| 更新 | ブログの内容・タイトル・カテゴリを変更する |
| 削除 | 不要なブログを削除する |
| サムネイル生成リクエスト | レース動画からサムネイル画像を作らせる |
| 関連情報の生成 | 内容の近いブログへのリンクを記事下部に差し込む |
カテゴリ管理
ブログを分類するカテゴリ（大分類）を管理します。
| 操作 | 説明 |
|---|---|
| 作成 | 新しいカテゴリを追加する |
| 一覧表示 | 登録済みカテゴリの一覧を確認する |
| 詳細表示 | 特定のカテゴリの詳細を確認する |
| 更新 | カテゴリ名を変更する |
| 削除 | 不要なカテゴリを削除する |
カテゴリ名が記事デザインを決める
ブログの HTML を組み立てる際、カテゴリ名で記事テンプレート（予想記事 / レース結果記事 / 汎用）を 切り替えます。カテゴリ名の変更は見た目に影響します。
メディア管理
画像・動画を管理します。AI が生成したサムネイル画像もここで管理されます。
| 操作 | 説明 |
|---|---|
| アップロード | 新しいメディアファイルを登録する |
| 一覧表示 | 登録済みメディアの一覧を確認する（種類での絞り込みに対応） |
| 詳細表示 | 特定のメディアの詳細を確認する |
| 更新 | メディアのファイルや情報を変更する |
| 削除 | 不要なメディアを削除する |
NGワード管理
生成テキストの検査に使用する NGワードを管理します。
| 操作 | 説明 |
|---|---|
| 登録 | 禁止ワードを追加する |
| 一覧表示 | 登録済み NGワードの一覧を確認する |
| 詳細表示 | 特定の NGワードの詳細を確認する |
| 更新 | NGワードの内容を変更する |
| 削除 | 不要な NGワードを削除する |
ヘルスチェック
| 操作 | 説明 |
|---|---|
| 疎通確認 | API が応答することを確認する |
| DB 込みの疎通確認 | データベースへの接続まで含めて確認する |
共通ルール
削除について
削除操作を行ってもデータは即座に完全に消えるわけではなく、削除済みとしてマークされます。 これにより、誤って削除した場合でも履歴としてデータが残ります。
ただし、生成途中で失敗して本文が空のまま残るブログは例外で、完全に削除されます。 一覧に残ると再生成の妨げになるためです。
一覧表示について
一覧表示では、表示件数を絞ったり、ページを切り替えて確認できます。 既定では更新日時の新しい順に並びます（レース一覧のみ、レース日の新しい順）。
非同期処理について
AI 生成（記事・ブログ・サムネイル）のリクエストは受け付けた時点ですぐに応答を返し、 実際の生成はバックグラウンドで実行されます。 完了はステータスの変化（「生成中」→「下書き」）で確認します。
関連情報の生成だけは同期処理で、その場で更新後のブログが返ります。