用語集
| 用語 | 意味 |
|---|---|
| UAAP | University Athletic Association of the Philippines。フィリピンの大学体育連盟で、男子大学野球の主要大会を運営する。 |
| LBP | Liga Baseball Philippines。フィリピンの国内野球リーグ。 |
| 代表 | フィリピン男子シニア代表。IBAF / WBSC 系の国際大会に出場する。 |
| 名寄せ | 複数のデータ源で表記が揺れる同一選手を、1つの選手としてまとめる処理。 |
| 出典ドメイン | 出典URLのホスト名。収集先の評価や重複排除に使う。 |
| 冪等 | 同じ入力で再実行しても、同じ結果になること。build-data.py の要件。 |
| RETAIN / REVIEW / DROP | 巡回先ドメインの評価区分。RETAIN だけを resources.txt に同期する。 |
| 単一HTML | 各アプリがビルド不要の index.html 1枚で動く構成。 |
| dist | Cloudflare Pages に配信する配布ディレクトリ。apps/<name>/deploy/dist/。 |
| spec.md | アプリの目的・データ定義・受け入れ基準を書いた設計の真実源。 |
| TEST-REPORT.md | tester が検証結果と修正依頼先を記録するファイル。 |
データ区分・ラベル
ニュースの分野(8値)
| 値 | 対象 |
|---|---|
代表 | 男子シニア代表、国際大会、代表候補 |
UAAP | UAAP 男子大学野球 |
リトルリーグ | リトルリーグ、少年野球 |
LBP | Liga 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.py | dist の許可リスト組立と構成検査 | python3 .../assemble_dist.py |
phb-app-pages-deploy/scripts/deploy_pages.py | Cloudflare Pages の配信と検証 | python3 .../deploy_pages.py --verify-only |
phb-app-pages-deploy/scripts/build_og.py | OGP 画像の生成 | python3 .../build_og.py |
phb-app-pages-deploy/scripts/check_og_counts.py | meta と画像の件数一致検査 | python3 .../check_og_counts.py |
phb-collect-game-videos/scripts/check_video.py | 動画の存在・タイトル・長さの機械取得 | python3 .../check_video.py --url <URL> |
phb-docs/scripts/check_docs.py | docs のリンク・アンカー・ナビ・機微情報の検査 | 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.py | workflow の 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 へ push | collect |
値を書かない
トークン、アカウントID、秘密鍵、Cookie、セッションIDは、docs・ログ・コミットメッセージのいずれにも書きません。コマンド例は環境変数の参照だけにします。
ファイル・ディレクトリ
| パス | 役割 | 生成物か |
|---|---|---|
README.md | GitHub の入口。詳細は docs へリンク | いいえ |
AGENTS.md | プロジェクト指示(ビルド・テスト・規約・禁止領域) | いいえ |
docs/ | このドキュメントサイト。Cloudflare Pages の公開元 | いいえ(直接編集) |
docs/stats.js | stats.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 を直接編集する。生成スクリプトは置かない。