GUNDAM / ABOUTV3.7.1 / 2026.11.16
ABOUT / 本アーカイブについて

GUNDAM Archiveについて

非商業のファン考証プロジェクト。設定を検証可能で追跡可能な構造へ組み直すことを目的とする。

VERSION 3.7.1DATA CUT 2026.11.16148 MS / 69 EVENTS
01 / THESIS

なぜ作るのか

ガンダムシリーズは複数の紀元と作品にわたり、公式・非公式の資料がアニメ、設定資料集、模型説明書、コミュニティWikiへ散在してきた。機体諸元の口径は揃わず、紀元年表は分断され、技術の進化は十数作品を往復しないと追えない。GUNDAM Archiveは篇幅ではなく構造でこの問題を解く。

02 / ARCHITECTURE

現在の実装

本リポジトリは現行版の静的アーカイブアプリである。Next.js 15の静的書き出し、内容はすべてcontent/以下のJSON、ビルド時にzodで検証する。3Dビューアはプロシージャル暫定アセットを用い、glTF LOD0はasset-manifest経由でページコードを変えずに接続できる。

L1プレゼンテーションNext.js 15 App Router · 静的書き出し · R3F実装済み
L2アプリケーションReact Server Components · ビルド時データ読込実装済み
L3サービス目標:NestJS + Zod · 現在はビルド時検証で代替計画
L4データcontent/*.json + Zod · 目標 PostgreSQL 16 + JSONB実装済み
L5アセットプロシージャルLOD-P · 目標 glTF 2.0 + KTX2 + CDN一部
L6運用npm run validate · GitHub Actions · コンテンツPRゲート実装済み
01

内容とコードの分離:機体の追加はJSONファイルの追加だけで、ページコードは変更しない。

02

単一の真実源:src/lib/schema.tsがデータ構造とTypeScript型を同時に拘束する。

03

ビルド時検証:schema、外部参照、系譜の非循環、双方向関連のいずれかが失敗すれば公開を止める。

04

三言語ルート:/zh・/ja・/enの接頭辞、内容は言語ごとにフォールバックし、欠落を明示する。

03 / PIPELINE

コンテンツ更新フロー

機体の追加にページコードの変更は不要。JSONを置き、検証を実行し、再ビルドするだけ。

01CONTENT

content/*.json の項目を追加・修正

02SCHEMA

zod でフィールド・外部参照を検証

03BUILD

静的書き出し、zh/ja 二言語ページを生成

04SHIP

CDN / GitHub Pages、ハッシュでキャッシュ更新

単一の真実源

src/lib/schema.ts がデータ構造とTypeScript型を同時に拘束する。ビルド時にzodが各ファイルを解析し、フィールド・外部参照・系譜の循環のいずれかに問題があればビルドを止める。

src/lib/schema.ts
04 / GOVERNANCE

データ・ガバナンス

出典はS/A/B/Cの四級。数値の欠落は空欄とし、同型機で推定しない。係争項目は複数口径を併記しdisputedを付す。系譜の辺には必ず出典を要求し、事件・人物・技術項目には長い解説を必須とする。現在は一般編集を開放せず、出典付きの提案のみ受け付ける。

S
公式資料公式アニメ / 設定資料 / 公式サイト
A
権威ある裏付け権威百科 / ライセンス出版物
B
コミュニティの手掛かりコミュニティWiki、手掛かりのみ
C
執筆参考個人参考、データ不採用
05 / ROADMAP

ロードマップ

現在の版は「動く档案の骨格」であり最終形ではない。次は実glTFアセットとバックエンドのコンテンツサービスを優先する。

M0

M0 立柱:リポジトリ、CI、デザイントークン、Schema確定

DONE
M1

M1 単機贯通:3Dビューア、分解、量子形態、機体詳細

DONE
M2

M2 データ骨格:12機、年表、系譜、三言語枠組み

DONE
M3

M3 関連完備:人物、勢力、地図、検索、アニメーション

WIP
M4

M4 内容拡大:147機、系譜全体図、性能目標達成

NEXT
M5

M5 公開:アクセシビリティ、モバイル、SEO、監視、公測

NEXT
06 / CONTRIBUTE

参加方法

内容の修正には出典と頁を添えること。機体追加はdocs/CONTENT_GUIDE.mdを読み、npm run validateの通過後に提出する。コード貢献はConventional Commitsに従う。

GitHub Repository
リポジトリ
  • docs/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出典区分・係争・著作権ルール
07 / LICENSE

著作権とライセンス

コードはMIT、本プロジェクトのオリジナル文章と図表はCC BY-NC-SA 4.0で公開する。ガンダムシリーズおよび関連名称・設定の権利は創通・サンライズとバンダイナムコに帰属する。本プロジェクトは非公式ファン作品であり、公式美術素材を使用せず、商業販売も行わない。

非公式ファンプロジェクト。バンダイナムコ / 創通・サンライズとは無関係。

GUNDAM ARCHIVE / V3.7.1ホーム