Philippine Baseball Platform Docs
メニュー

リファレンス

用語、データ区分、スクリプト、環境変数の役割、ファイル構成、URL をまとめます。詳しい説明は各ページへリンクしています。

最終更新 2026-11-22秘密情報の値は載せません

用語集

用語意味
UAAPUniversity Athletic Association of the Philippines。フィリピンの大学体育連盟で、男子大学野球の主要大会を運営する。
LBPLiga Baseball Philippines。フィリピンの国内野球リーグ。
代表フィリピン男子シニア代表。IBAF / WBSC 系の国際大会に出場する。
名寄せ複数のデータ源で表記が揺れる同一選手を、1つの選手としてまとめる処理。
出典ドメイン出典URLのホスト名。収集先の評価や重複排除に使う。
冪等同じ入力で再実行しても、同じ結果になること。build-data.py の要件。
RETAIN / REVIEW / DROP巡回先ドメインの評価区分。RETAIN だけを resources.txt に同期する。
単一HTML各アプリがビルド不要の index.html 1枚で動く構成。
distCloudflare Pages に配信する配布ディレクトリ。apps/<name>/deploy/dist/。
spec.mdアプリの目的・データ定義・受け入れ基準を書いた設計の真実源。
TEST-REPORT.mdtester が検証結果と修正依頼先を記録するファイル。

データ区分・ラベル

ニュースの分野(8値)

値対象
代表男子シニア代表、国際大会、代表候補
UAAPUAAP 男子大学野球
リトルリーグリトルリーグ、少年野球
LBPLiga Baseball Philippines
国内大会国内の大会・リーグ戦
国際大会国際大会の運営・結果
連盟動向連盟の組織・方針・運営
高校高校野球

ポジション

P(投手)、IF(内野手)、OF(外野手)、C(捕手)が軸です。P, OF や IF/P、3B, P のような複合表記があり、区切りは , と / の両方を使います。主ポジションが必要な場合は先頭要素を使います。

映像の4分類(フル試合 / ハイライト / ニュース / 場面)は データ辞書の試合動画 を参照してください。

確認区分・根拠区分

確認区分はデータごとに語彙が異なります。以下は主な例です。

区分意味
試合報道試合記事で出場・プレーが確認できる
公式名簿大会・チームの公式名簿に掲載されている
連盟公表歴連盟などが公表した経歴に基づく
未確認出場・経歴がまだ確認できていない
大会前名簿掲載大会前の名簿には載っているが、実際の出場は未確認
試合記事でプレー確認試合記事で実際のプレーが確認できる
チーム所属記事チーム所属の記事で確認できる
二次資料(大会エントリー)大会エントリーなどの二次資料に基づく

スクリプト一覧

スクリプト目的使用例
phb-validate-baseball-data/scripts/validate.pyデータの必須列・URL・日付・出典ドメイン検証python3 .../validate.py --strict
apps/<name>/data/build-data.pyアプリ用 JSON の生成cd apps/<name>/data && python3 build-data.py
phb-app-test/scripts/spot_check.py元データとアプリ JSON のスポット照合python3 .../spot_check.py --app <name>
phb-app-develop/scripts/self_check.py起動・HTTP 200・構文・停止の一括確認python3 .../self_check.py --app <name>
phb-app-pages-deploy/scripts/assemble_dist.pydist の許可リスト組立と構成検査python3 .../assemble_dist.py
phb-app-pages-deploy/scripts/deploy_pages.pyCloudflare Pages の配信と検証python3 .../deploy_pages.py --verify-only
phb-app-pages-deploy/scripts/build_og.pyOGP 画像の生成python3 .../build_og.py
phb-app-pages-deploy/scripts/check_og_counts.pymeta と画像の件数一致検査python3 .../check_og_counts.py
phb-collect-game-videos/scripts/check_video.py動画の存在・タイトル・長さの機械取得python3 .../check_video.py --url <URL>
phb-docs/scripts/check_docs.pydocs のリンク・アンカー・ナビ・機微情報の検査python3 .../check_docs.py
phb-docs/scripts/refresh_docs_stats.py公開docsの件数 JSON を生成python3 .../refresh_docs_stats.py --date YYYY-MM-DD
phb-github-actions/scripts/check_workflows.pyworkflow の deprecated Node runtime 検査python3 .../check_workflows.py --check-remote

パスの ... は各スキルの scripts/ までの省略です。正確なパスはリポジトリを参照してください。

環境変数・Secrets

値は GitHub の Secrets で管理し、このドキュメントには書きません。名前・設定・ブランチ保護は .github/CI.md を参照してください。

役割用途使う場所
エージェント実行用キー収集・配信の OpenCode 実行collect / deploy
収集・評価用トークン出典ドメインの評価collect
配信用トークンCloudflare Pages への配信deploy
アカウント識別子Cloudflare アカウントの指定collect / deploy
push 用トークン収集結果を main へ pushcollect
値を書かない

トークン、アカウントID、秘密鍵、Cookie、セッションIDは、docs・ログ・コミットメッセージのいずれにも書きません。コマンド例は環境変数の参照だけにします。

ファイル・ディレクトリ

パス役割生成物か
README.mdGitHub の入口。詳細は docs へリンクいいえ
AGENTS.mdプロジェクト指示(ビルド・テスト・規約・禁止領域)いいえ
docs/このドキュメントサイト。Cloudflare Pages の公開元いいえ(直接編集)
docs/stats.jsstats.json を読んで件数を差し替えるいいえ
docs/data/stats.json公開docsの件数。collect 後に再生成はい(refresh_docs_stats.py)
data/収集データの一次置き場いいえ(収集担当が更新)
apps/<name>/index.htmlアプリ本体いいえ
apps/<name>/data/アプリ用 JSONはい(build-data.py)
apps/<name>/deploy/dist/Cloudflare Pages の配布物はい(assemble_dist.py)
reports/実行・評価・テスト結果。git 管理外はい
scratch/一時ファイル。git 管理外はい
.opencode/agents/担当エージェント定義いいえ
.opencode/rules/プロジェクト共通ルール(GitHub Actions の runtime 等)いいえ
.opencode/skills/手順・参照資料・スクリプトいいえ
.github/workflows/collect / deploy の CIいいえ

URL一覧

対象URL
このドキュメントphilippine-baseball-tech-docs.pages.dev/
ポータルphilippine-baseball-portal.pages.dev
選手名鑑philippine-baseball-player-database.pages.dev
試合動画ガイドphilippine-baseball-video-guide.pages.dev
ニュース一覧philippine-baseball-news-digest.pages.dev
年表philippine-baseball-timeline.pages.dev
リポジトリprs-watch/philippine-baseball-platform(公開範囲はリポジトリ設定に依存)

docs の更新ルール

  • 数字は参考値。 件数には「YYYY-MM-DD 時点」と添え、正は data/ と生成 JSON とする。
  • 更新日を変える。 ページを編集したら、pagehead の最終更新を更新する。
  • ナビを揃える。 ページを追加したら、全ページの左ナビとモバイルナビに追加する。
  • 相対パス。 内部リンクは data.html のような相対パスにする。/... の絶対パスは使わない。
  • 機微情報を書かない。 秘密情報、個人情報、生ログ、権限の具体値、内部メモを載せない。
  • 件数は自動反映。 docs/data/stats.json を stats.js が読み、data-count の数字を差し替える。collect 後に refresh_docs_stats.py が JSON を更新し、データが変わらない週は updated を据え置く。
  • 検査する。 公開前に check_docs.py を通し、リンク・アンカー・ナビ・秘密情報パターンを確認する。
  • 配信する。 docs/** の push で .github/workflows/docs.yml が Cloudflare Pages に配信する。
  • ビルドしない。 docs は静的な HTML を直接編集する。生成スクリプトは置かない。