データ目録
リポジトリの data/ にある7ファイルが一次データです。行数は参考値で、正は各ファイルとアプリ生成後の JSON です。
276ニュース記事
472選手(名寄せ後)
601代表ロースター行
103試合動画
| ファイル | 行数 | 更新 | 供給先 |
|---|---|---|---|
baseball-news.csv | 276 | 2026-11-21 | news-digest / timeline |
uaap-players.csv | 470 | 2026-11-21 | player-database |
lbp-players.csv | 150 | 2026-11-21 | player-database |
national-team-players-colleges.csv | 108 | 2026-11-21 | player-database |
national-team-rosters.csv | 601 | 2026-11-21 | player-database / timeline |
baseball-game-videos.md | 103 | 2026-11-21 | video-guide / timeline |
baseball-game-video-summaries.md | 52 | 2026-11-21 | video-guide |
出典ドメインはニュース276件で34件。列の意味と注意点は データ辞書 にまとめています。
このプロジェクトについて
リポジトリは データ層 と アプリ層 に分かれます。アプリは元データを直接読まず、ビルドスクリプトが切り出した JSON だけを読みます。この境界があるため、データの更新とアプリの配信を別々に進められます。
| 層 | 実体 | 品質ゲート |
|---|---|---|
| データ | data/ の CSV 5本と Markdown 2本 | validate.py --strict。元データは収集担当の明示依頼なしに編集しない |
| アプリ | apps/<name>/index.html と生成 JSON | spec.md の受け入れ基準と TEST-REPORT.md。照合は spot_check.py |
| ドキュメント | docs/ の静的 HTML | check_docs.py でリンク・アンカー・ナビ・機微情報を検査 |
データの流れ
- 収集報道・公式資料を横断探索し、出典URLつきで data/ に蓄積する。
- 検証UTF-8・必須列・URL・日付・出典ドメインを validate.py で検査する。
- 生成各アプリの build-data.py が data/ から JSON を切り出す。docs の件数 JSON も同じタイミングで更新する。
- 配信アプリもこのドキュメントも Cloudflare Pages で公開する。
出典が最優先
データ行は出典URLを必ず持ちます。アプリ上でも行ごとに出典リンクを添え、判断語彙(「確認済」など)の羅列は画面に出しません。
どこから読むか
目的別の入口です。初めての場合は、このページ → 担当AI → 運用手順の順に読むと全体像がつかめます。
アプリ
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) |