docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
defiQUG
187
docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md
Normal file
187
docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md
Normal file
@@ -0,0 +1,187 @@
|
||||
# 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
|
||||
```bash
|
||||
git submodule update --init --recursive
|
||||
git submodule update --remote
|
||||
```
|
||||
|
||||
### Update Specific Submodule
|
||||
```bash
|
||||
cd <submodule-path>
|
||||
git pull origin main
|
||||
cd ..
|
||||
git add <submodule-path>
|
||||
git commit -m "Update <submodule-name>"
|
||||
```
|
||||
|
||||
### Update Nested Submodules (arromis-monorepo)
|
||||
```bash
|
||||
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](../../.gitmodules)** - Git submodule configuration (repo root)
|
||||
- **[PROJECT_STRUCTURE.md](../../PROJECT_STRUCTURE.md)** - Project and directory structure
|
||||
- **[COMPREHENSIVE_PROJECT_REVIEW.md](../00-meta/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
|
||||
Reference in New Issue
Block a user