Summary: Developer guide for the GakuNin RDM 2027 environment, including specifications, decisions, policies, guides, and status 概要: GakuNin RDM 2027 開発環境の開発者ガイド。仕様、決定、方針、ガイド、進捗を含みます
- Version / 版: 0.3 — 2026-11-10. Learned: a decision index goes stale one record at a time, so each new ADR is added to the root list in the same commit (ADR-08). / 決定の索引は一件ずつ古くなるので、新しい ADR は同じコミットでルートの一覧に加える(ADR-08)。
- Version / 版: 0.2 — 2026-11-06. Learned: a glossary term is only explained for the reader when its note and REF-01 link sit at the first prose use, counting lower-case and plural forms, so first-use notes with links were added in both halves (SPEC-06 §3). / 用語注と REF-01 へのリンクは、小文字や複数形も含めた本文の初出に置かなければ読者に届かないと分かったため、英和両方の初出にリンク付きの用語注を補った(SPEC-06 §3)。
- Version / 版: 0.1 — 2026-11-05
- Normative for:
README.md - Related: SPEC-06 Documentation Conventions · POL-01 Position
Available from milestone M2.
git clone https://github.com/.../RDM-developer-guide.git./installer/install.sh --yes- Open http://127.0.0.1:5000 in your browser
graph TD
subgraph docs[docs/]
spec[specs/]
decisions[decisions/]
policy[policy/]
reference[reference/]
guides[guides/]
status[status/]
end
subgraph manifest[manifest/]
upstreams[upstreams.*]
end
subgraph installer[installer/]
install[install.sh]
grdm_dev[grdm_dev/]
end
subgraph site[site/]
index[index.html]
end
docs --> manifest
docs --> installer
docs --> site
- Documentation index - every document, by folder
- Manifest - what the installer builds (names and pinned SHAs)
- SPEC-00 Overview - Overview / 概要
- SPEC-01 Manifest - Manifest format / マニフェスト形式
- SPEC-02 Installer CLI - Installer command / インストーラー CLI
- SPEC-03 Security Gate - Security gate (the checkpoint a build must pass before anyone may use it; see REF-01) / セキュリティゲート
- SPEC-04 Acceptance Tests - Acceptance tests / 受け入れ試験
- SPEC-05 Upstream Tracking - Upstream tracking (Upstream: the original place our copies come from; see REF-01) / アップストリーム追跡
- SPEC-06 Documentation Conventions - Documentation conventions / 文書規約
Each record explains one choice. Repository (a folder that remembers every change; see REF-01) placement comes first, then the network model, the staged security gate, the autonomy of AI agents, and the test IdP (the server where you log in; see REF-01) that stands in for a Shibboleth (the software that lets you log in once with your university account; see REF-01) login.
- POL-01 Position - Developer environment position / 開発環境の位置づけ
- ADR-01 Integration Repository Placement - Integration repository / 統合リポジトリ配置
- ADR-02 Network Model - Network model / ネットワークモデル
- ADR-03 Staged Security Gate - Staged security gate / 階段式セキュリティゲート
- ADR-04 AI Autonomy and Roles - AI autonomy and roles / AI 自律性と役割
- ADR-05 Test IdP for Shibboleth - Test IdP for Shibboleth / Shibboleth 用テスト IdP
- ADR-06 Wiki Frontend Overlay - Wiki frontend overlay / Wiki フロントエンドのオーバーレイ
- ADR-07 Native Builds of EOL Middleware - Native builds of EOL middleware / EOL ミドルウェアのネイティブビルド
- ADR-08 Per-OS Installer Entry Points - Per-OS installer entry points / OS ごとのインストーラーの入口
- REF-01 Glossary - Glossary / 用語集
- Guides index - Guides for addon development and environment setup / アドオン開発と環境セットアップのガイド
- Status - Project status and milestones / プロジェクト進捗とマイルストーン
This public repository contains only documentation, manifest, and installer code. Integration code is in the private RDM--dev2027 repository. A staged security gate is applied before code reaches production (see SPEC-03 Security Gate).
The human-readable HTML version lives at site/index.html (entry page: index.html). It is generated from docs/ by MkDocs (a tool that turns Markdown files into a website; see REF-01) through grdm-dev docs build (see SPEC-02); do not edit site/ by hand.
MIT License — See LICENSE for details.
M2 マイルストーンから利用可能。
git clone https://github.com/.../RDM-developer-guide.git./installer/install.sh --yes- ブラウザで http://127.0.0.1:5000 を開く
graph TD
subgraph docs[docs/]
spec[specs/]
decisions[decisions/]
policy[policy/]
reference[reference/]
guides[guides/]
status[status/]
end
subgraph manifest[manifest/]
upstreams[upstreams.*]
end
subgraph installer[installer/]
install[install.sh]
grdm_dev[grdm_dev/]
end
subgraph site[site/]
index[index.html]
end
docs --> manifest
docs --> installer
docs --> site
- SPEC-00 概要 - Overview / 概要
- SPEC-01 マニフェスト - Manifest format / マニフェスト形式
- SPEC-02 インストーラー CLI - Installer command / インストーラー CLI
- SPEC-03 セキュリティゲート - Security gate / セキュリティゲート(導入が必ず通る検問所。REF-01)
- SPEC-04 受け入れ試験 - Acceptance tests / 受け入れ試験
- SPEC-05 アップストリーム追跡 - Upstream tracking / アップストリーム追跡(上流=写しの元の場所。REF-01)
- SPEC-06 文書規約 - Documentation conventions / 文書規約
各記録は一つの選択を説明します。まずリポジトリ(変更を全部覚えているフォルダ。REF-01)の置き場、次にネットワークモデル、段階的なセキュリティゲート、AI エージェントの自律性、そして Shibboleth(大学のアカウントで一度ログインすれば済むようにするソフト。REF-01)ログインの代わりを務めるテスト IdP(ログインする場所のサーバ。REF-01)です。
- POL-01 開発環境の位置づけ - Developer environment position / 開発環境の位置づけ
- ADR-01 統合リポジトリ配置 - Integration repository / 統合リポジトリ配置
- ADR-02 ネットワークモデル - Network model / ネットワークモデル
- ADR-03 階段式セキュリティゲート - Staged security gate / 階段式セキュリティゲート
- ADR-04 AI 自律性と役割 - AI autonomy and roles / AI 自律性と役割
- ADR-05 Shibboleth 用テスト IdP - Test IdP for Shibboleth / Shibboleth 用テスト IdP
- ADR-06 Wiki フロントエンドのオーバーレイ - Wiki frontend overlay / Wiki フロントエンドのオーバーレイ
- ADR-07 EOL ミドルウェアのネイティブビルド - Native builds of EOL middleware / EOL ミドルウェアのネイティブビルド
- ADR-08 OS ごとのインストーラーの入口 - Per-OS installer entry points / OS ごとのインストーラーの入口
- REF-01 用語集 - Glossary / 用語集
- ガイド一覧 - Guides for addon development and environment setup / アドオン開発と環境セットアップのガイド
- 進捗 - Project status and milestones / プロジェクト進捗とマイルストーン
このパブリックリポジトリにはドキュメント、マニフェスト、インストーラーコードのみが含まれます。統合コードは非公開の RDM--dev2027 リポジトリにあります。本番環境にコードが到達する前に段階的なセキュリティゲートが適用されます(SPEC-03 セキュリティゲート 参照)。
人が読む HTML 版は site/index.html(入口ページは index.html)にあります。docs/ から MkDocs(Markdown のファイルを Web サイトに変える道具。REF-01)が grdm-dev docs build で生成します(SPEC-02)。site/ を手で編集しないでください。
MIT License — 詳細は LICENSE を参照。
| Term | English note | 日本語注 |
|---|---|---|
| repository | A folder that stores code, documents, and configuration. | コードや文書、設定を保管するフォルダ。 |
| branch | A separate version of the code that can be developed independently. | コードの独立して開発できる別のバージョン。 |
| installer | A program that prepares other programs so they can run. | 他のプログラムを実行可能にするための準備をするプログラム。 |
| manifest | A list that says exactly which version of each source repository we use. | 使用する各ソースリポジトリのバージョンを正確に示すリスト。 |
| MkDocs | A tool that turns Markdown files into a website. | Markdown のファイルを Web サイトに変える道具。 |