Philippine Baseball Platform Docs
メニュー

Philippine Baseball Platform

フィリピン男子野球(代表・UAAP・LBP)の報道と公式資料を、出典つきで集め、検証し、静的なアプリとして公開するプロジェクト。このサイトは、そのデータと仕組みを説明する技術ドキュメントです。

最終更新 2026-11-22データ更新 2026-11-21アプリ 5本

データ目録

リポジトリの data/ にある7ファイルが一次データです。行数は参考値で、正は各ファイルとアプリ生成後の JSON です。

276ニュース記事
472選手(名寄せ後)
601代表ロースター行
103試合動画
data/ のファイル一覧(2026-11-21 時点)
ファイル行数更新供給先
baseball-news.csv2762026-11-21news-digest / timeline
uaap-players.csv4702026-11-21player-database
lbp-players.csv1502026-11-21player-database
national-team-players-colleges.csv1082026-11-21player-database
national-team-rosters.csv6012026-11-21player-database / timeline
baseball-game-videos.md1032026-11-21video-guide / timeline
baseball-game-video-summaries.md522026-11-21video-guide

出典ドメインはニュース276件で34件。列の意味と注意点は データ辞書 にまとめています。

このプロジェクトについて

リポジトリは データ層 と アプリ層 に分かれます。アプリは元データを直接読まず、ビルドスクリプトが切り出した JSON だけを読みます。この境界があるため、データの更新とアプリの配信を別々に進められます。

層実体品質ゲート
データdata/ の CSV 5本と Markdown 2本validate.py --strict。元データは収集担当の明示依頼なしに編集しない
アプリapps/<name>/index.html と生成 JSONspec.md の受け入れ基準と TEST-REPORT.md。照合は spot_check.py
ドキュメントdocs/ の静的 HTMLcheck_docs.py でリンク・アンカー・ナビ・機微情報を検査

データの流れ

  1. 収集報道・公式資料を横断探索し、出典URLつきで data/ に蓄積する。
  2. 検証UTF-8・必須列・URL・日付・出典ドメインを validate.py で検査する。
  3. 生成各アプリの build-data.py が data/ から JSON を切り出す。docs の件数 JSON も同じタイミングで更新する。
  4. 配信アプリもこのドキュメントも Cloudflare Pages で公開する。
出典が最優先

データ行は出典URLを必ず持ちます。アプリ上でも行ごとに出典リンクを添え、判断語彙(「確認済」など)の羅列は画面に出しません。

どこから読むか

目的別の入口です。初めての場合は、このページ → 担当AI → 運用手順の順に読むと全体像がつかめます。

目的読むページ分かること
初めて全体を知る担当AIとスキル → 運用手順誰が何をし、どの成果物でつながるか
データを使うデータ辞書 → リファレンス列の意味、欠損、表記ゆれ、検証方法
アプリを見るアプリ一覧5本の役割、データ源、本番URL
運用する運用手順収集・検証・生成・配信のコマンドとゲート
開発する担当AIとスキル → アプリ開発designer / developer / tester の受け渡し

アプリ

5本のアプリは Cloudflare Pages で別々に公開しています。このドキュメントサイトはアプリを複製せず、役割と入口だけを示します。

アプリ役割規模公開
philippine-baseball-portalアプリ群への入口。4枚のカードで現行件数を示す4カード開く
philippine-baseball-player-database代表・UAAP・LBP の選手を名寄せした選手名鑑472選手開く
philippine-baseball-video-guide試合動画を年×大会でたどる動画ガイド103動画開く
philippine-baseball-news-digest日本語要約ニュースを分野・年・検索で絞る276記事開く
philippine-baseball-timelineニュース・代表ロースター・動画を年で束ねる年表27年開く

各アプリの目的・データ源・制約は アプリ一覧 を参照してください。

設計上の原則

原則内容
出典をつけるデータ行は出典URLを持つ。アプリの行内にも出典リンクを添える。
単一HTML各アプリはビルド不要の index.html 1枚。JSON を相対パスで fetch する。
ビルド冪等build-data.py は引数なしの再実行で同じ結果になる。異常時は中途半端に進めない。
生成物と元データを混ぜないdata/ は一次置き場、apps/<name>/data/ と docs/data/stats.json は生成物。手で直さない。
機械化境界探索・要約・分類はエージェント、検証・記録・重複排除はスクリプトが担う。
公開前提ドキュメントには秘密情報・個人情報・生ログを書かない。

更新情報

項目値
データ最終更新2026-11-21
ドキュメント最終更新2026-11-22
アプリ配信Cloudflare Pages(5プロジェクト)
ドキュメント配信Cloudflare Pages(philippine-baseball-tech-docs)