proxmox/docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md

Submodule Relationship Map

Last Updated: 2026-01-22
Status: 🟢 Active Master Reference
Purpose: Document all submodules and their relationships

---

Submodule Overview

Total Submodules: 15
Total Submodules in arromis-monorepo: 5
Total Submodules (including nested): 20

---

Root-Level Submodules

Core Infrastructure

Submodule	Path	Repository	Purpose	Dependencies
mcp-proxmox	mcp-proxmox/	https://github.com/gilby125/mcp-proxmox.git	Proxmox MCP Server	None
ProxmoxVE	ProxmoxVE/	https://github.com/community-scripts/ProxmoxVE.git	Proxmox helper scripts	None
smom-dbis-138-proxmox	smom-dbis-138-proxmox/	git@github.com:Order-of-Hospitallers/smom-dbis-138.git	Deployment automation	ProxmoxVE

Blockchain & DeFi

Submodule	Path	Repository	Purpose	Dependencies
smom-dbis-138	smom-dbis-138/	git@github.com:Order-of-Hospitallers/smom-dbis-138.git	Blockchain network	None
explorer-monorepo	explorer-monorepo/	./explorer-monorepo	Blockchain explorer	smom-dbis-138
metamask-integration	metamask-integration/	git@github.com:Defi-Oracle-Meta-Blockchain/metamask-integration.git	MetaMask integration	smom-dbis-138
OMNIS	OMNIS/	https://github.com/Defi-Oracle-Tooling/OMNIS.git	OMNIS platform	None

Business Systems

Submodule	Path	Repository	Purpose	Dependencies
dbis_core	dbis_core/	git@github.com:Order-of-Hospitallers/dbis_core.git	DBIS Core banking	PostgreSQL, Redis
the-order	the-order/	git@github.com:Order-of-Hospitallers/the-order-monorepo.git	Order management	dbis_core (optional)
miracles_in_motion	miracles_in_motion/	https://github.com/Order-of-Hospitallers/miracles_in_motion.git	MIM4U platform	None
metaverseDubai	metaverseDubai/	https://github.com/Order-of-Hospitallers/metaverseDubai.git	Metaverse project	None

Documentation & Tools

Submodule	Path	Repository	Purpose	Dependencies
gru-docs	gru-docs/	https://github.com/Defi-Oracle-Tooling/GRU-Official-Docs-Monetary-Policies.git	GRU documentation	None

ARROMIS Organization

Submodule	Path	Repository	Purpose	Dependencies
arromis-monorepo	arromis-monorepo/	https://github.com/ARROMIS/arromis-monorepo.git	ARROMIS monorepo	Contains 5 submodules
omada-api	omada-api/	https://github.com/ARROMIS/omada-api.git	Omada API client	⚠️ Workspace package (may not be proper submodule)

PR Workspace

Submodule	Path	Repository	Purpose	Dependencies
pr-workspace/app-ethereum	pr-workspace/app-ethereum/	https://github.com/defiQUG/app-ethereum.git	Ethereum app	None
pr-workspace/chains	pr-workspace/chains/	https://github.com/defiQUG/chains.git	Chain data	None

---

Nested Submodules (arromis-monorepo)

Submodule	Path	Repository	Purpose
arromis-documentation	arromis-monorepo/arromis-documentation/	https://github.com/ARROMIS/arromis-documentation.git	Documentation
arromis-coordination-hub	arromis-monorepo/arromis-coordination-hub/	https://github.com/ARROMIS/arromis-coordination-hub.git	Coordination hub
sovereign-body-registry	arromis-monorepo/sovereign-body-registry/	https://github.com/ARROMIS/sovereign-body-registry.git	Registry service
deployment-orchestrator	arromis-monorepo/deployment-orchestrator/	https://github.com/ARROMIS/deployment-orchestrator.git	Deployment automation
integration-templates	arromis-monorepo/integration-templates/	https://github.com/ARROMIS/integration-templates.git	Integration templates

---

Submodule Relationships

Dependency Graph

proxmox (root)
├── mcp-proxmox (standalone)
├── ProxmoxVE (standalone)
├── smom-dbis-138-proxmox (depends on: ProxmoxVE)
├── smom-dbis-138 (standalone)
│   ├── explorer-monorepo (depends on: smom-dbis-138)
│   └── metamask-integration (depends on: smom-dbis-138)
├── dbis_core (standalone)
│   └── the-order (optional dependency: dbis_core)
├── OMNIS (standalone)
├── miracles_in_motion (standalone)
├── metaverseDubai (standalone)
├── gru-docs (standalone)
├── arromis-monorepo (standalone)
│   ├── arromis-documentation
│   ├── arromis-coordination-hub
│   ├── sovereign-body-registry
│   ├── deployment-orchestrator
│   └── integration-templates
├── omada-api (⚠️ workspace package, may not be proper submodule)
└── pr-workspace/
    ├── app-ethereum (standalone)
    └── chains (standalone)

---

Submodule Issues & Notes

Issues

1. explorer-monorepo

   • Issue: Uses local path (./explorer-monorepo) instead of remote URL
   • Impact: May cause issues when cloning fresh
   • Recommendation: Update to remote repository URL if available

2. omada-api

   • Issue: Marked as workspace package but tracked as submodule
   • Impact: May not be proper submodule
   • Recommendation: Verify if repository exists, otherwise convert to workspace package

Notes

• arromis-monorepo: Contains 5 nested submodules (migrated from root ARROMIS/ directory)
• pr-workspace: Contains 2 submodules for PR workspace functionality
• Total nested depth: 2 levels (root → arromis-monorepo → submodules)

---

Submodule Update Procedures

Update All Submodules

git submodule update --init --recursive
git submodule update --remote

Update Specific Submodule

cd <submodule-path>
git pull origin main
cd ..
git add <submodule-path>
git commit -m "Update <submodule-name>"

Update Nested Submodules (arromis-monorepo)

cd arromis-monorepo
git submodule update --init --recursive
git submodule update --remote
cd ..
git add arromis-monorepo
git commit -m "Update arromis-monorepo submodules"

---

Version Compatibility

Current Versions

• All submodules pinned to specific commits
• Check .gitmodules for current commit references
• Use git submodule status to see current versions

Compatibility Matrix

• smom-dbis-138 ↔ explorer-monorepo: Compatible
• smom-dbis-138 ↔ metamask-integration: Compatible
• dbis_core ↔ the-order: Optional dependency

---

Related Documents

• .gitmodules - Git submodule configuration (repo root)
• PROJECT_STRUCTURE.md - Project and directory structure
• COMPREHENSIVE_PROJECT_REVIEW.md - Project review

---

Last Updated: 2026-01-22
Maintainer: System Administrator
Update Frequency: On submodule additions/removals
Current Status: ✅ Up to date - 15 root submodules + 5 nested documented