GUNDAM Archiveについて
非商業のファン考証プロジェクト。設定を検証可能で追跡可能な構造へ組み直すことを目的とする。
なぜ作るのか
ガンダムシリーズは複数の紀元と作品にわたり、公式・非公式の資料がアニメ、設定資料集、模型説明書、コミュニティWikiへ散在してきた。機体諸元の口径は揃わず、紀元年表は分断され、技術の進化は十数作品を往復しないと追えない。GUNDAM Archiveは篇幅ではなく構造でこの問題を解く。
現在の実装
本リポジトリは現行版の静的アーカイブアプリである。Next.js 15の静的書き出し、内容はすべてcontent/以下のJSON、ビルド時にzodで検証する。3Dビューアはプロシージャル暫定アセットを用い、glTF LOD0はasset-manifest経由でページコードを変えずに接続できる。
内容とコードの分離:機体の追加はJSONファイルの追加だけで、ページコードは変更しない。
単一の真実源:src/lib/schema.tsがデータ構造とTypeScript型を同時に拘束する。
ビルド時検証:schema、外部参照、系譜の非循環、双方向関連のいずれかが失敗すれば公開を止める。
三言語ルート:/zh・/ja・/enの接頭辞、内容は言語ごとにフォールバックし、欠落を明示する。
コンテンツ更新フロー
機体の追加にページコードの変更は不要。JSONを置き、検証を実行し、再ビルドするだけ。
content/*.json の項目を追加・修正
zod でフィールド・外部参照を検証
静的書き出し、zh/ja 二言語ページを生成
CDN / GitHub Pages、ハッシュでキャッシュ更新
src/lib/schema.ts がデータ構造とTypeScript型を同時に拘束する。ビルド時にzodが各ファイルを解析し、フィールド・外部参照・系譜の循環のいずれかに問題があればビルドを止める。
src/lib/schema.tsデータ・ガバナンス
出典はS/A/B/Cの四級。数値の欠落は空欄とし、同型機で推定しない。係争項目は複数口径を併記しdisputedを付す。系譜の辺には必ず出典を要求し、事件・人物・技術項目には長い解説を必須とする。現在は一般編集を開放せず、出典付きの提案のみ受け付ける。
ロードマップ
現在の版は「動く档案の骨格」であり最終形ではない。次は実glTFアセットとバックエンドのコンテンツサービスを優先する。
M0 立柱:リポジトリ、CI、デザイントークン、Schema確定
DONEM1 単機贯通:3Dビューア、分解、量子形態、機体詳細
DONEM2 データ骨格:12機、年表、系譜、三言語枠組み
DONEM3 関連完備:人物、勢力、地図、検索、アニメーション
WIPM4 内容拡大:147機、系譜全体図、性能目標達成
NEXTM5 公開:アクセシビリティ、モバイル、SEO、監視、公測
NEXT参加方法
内容の修正には出典と頁を添えること。機体追加はdocs/CONTENT_GUIDE.mdを読み、npm run validateの通過後に提出する。コード貢献はConventional Commitsに従う。
GitHub Repositorydocs/CHRONOLOGY.md十二紀元の世紀表と読み方docs/MACHINE_COVERAGE.md機体カバレッジと収録規則docs/ARCHITECTURE.mdアーキテクチャと意思決定docs/CONTENT_GUIDE.md機体・事件・人物の追加手順docs/DATA_DICTIONARY.mdデータ辞書と単位規約docs/ASSET_PIPELINE.mdglTF / LOD / manifest 規約docs/GOVERNANCE.md出典区分・係争・著作権ルール
著作権とライセンス
コードはMIT、本プロジェクトのオリジナル文章と図表はCC BY-NC-SA 4.0で公開する。ガンダムシリーズおよび関連名称・設定の権利は創通・サンライズとバンダイナムコに帰属する。本プロジェクトは非公式ファン作品であり、公式美術素材を使用せず、商業販売も行わない。
非公式ファンプロジェクト。バンダイナムコ / 創通・サンライズとは無関係。