dbis_core/docs/atlas/README.md

# DBIS Architecture Atlas

The DBIS Architecture Atlas contains high-level architectural reference materials, including rail maps, integration frameworks, and system diagrams. These documents provide the conceptual and architectural foundation for understanding how DBIS systems integrate and operate at a macro level.

## Purpose

The Atlas supplements the implementation-focused documentation found in:
- **Volumes** (`docs/volume-*/`) - Detailed implementation guides for specific DBIS modules
- **Special Sub-Volumes** (`docs/special-sub-volumes/`) - Implementation guides for specialized systems

The Atlas focuses on:
- Architectural diagrams and rail maps
- Integration frameworks and patterns
- High-level system interactions
- Cross-system value flows
- Identity and settlement architectures

## Whitepapers

### [GRU Institutional Whitepaper](../whitepapers/gru-institutional-whitepaper.md)

The official GRU Institutional Whitepaper establishing the complete regulatory, monetary, legal, and settlement framework for supranational adoption. This document defines:

- Full regulatory classifications (SR-1, SR-2, SR-3, M0, M1)
- Legal foundation (SMIA, DRGC, IMCP)
- Supranational issuance governance pathway
- GAS → Ω-Layer settlement architecture
- Transparency & disclosure framework
- International adoption model (3-phase)
- Risk, oversight & supervision requirements

**Related Documentation**: See [Supplement A: GRU Monetary System & Bond Architecture](./supplement-a-gru-monetary-bonds.md) for detailed bond architecture, and [GRU Regulatory Framework](../whitepapers/gru-regulatory-framework.md) for detailed regulatory classifications.

## Supplements

### [Supplement A: GRU Monetary System & Bond Architecture](./supplement-a-gru-monetary-bonds.md)

Details the GRU (Global Reserve Unit) monetary system and bond architecture, including:
- GRU monetary hierarchy (M00, M0, M1) with unit definitions
- XAU-anchored valuation rule for metal-backed consistency
- GRU topology map and integration with DBIS Prime Ledger
- GRU–CBDC–Commodity settlement pipeline
- Perpetual bond instruments (Li99PpOsB10, Li99PpAvB10) with 10-year buy-back mechanism
- GRU Bond Engine system architecture
- Atomic transaction cycle map (7→10→9.55→∞)
- GRU bond execution and DBIS settlement flow
- Multiversal consistency anchoring via Ω-Layer

**Related Implementation**: See [Special Sub-Volumes: GRU Integration](../special-sub-volumes/) for service implementations, APIs, and database schemas.

### [Supplement B: MetaverseDubai Economic Rail Map & DBIS Metaverse Integration Framework](./supplement-b-metaverse-dubai.md)

Details the DBIS → MetaverseDubai integration architecture, including:
- Digital Sovereign Economic Zone (D-SEZ) model
- Economic rail maps and value-flow diagrams
- Identity architecture (ILIE L3/L4)
- Metaverse settlement pipeline
- GPU edge compute support (6G fabric)
- Asset tokenization model
- Cross-metaverse interoperability
- Multiverse consistency checks

**Related Implementation**: See [Sub-Volume C: Metaverse Integration](../special-sub-volumes/sub-volume-c-metaverse.md) for service implementations, APIs, and database schemas.

## Structure

Each supplement in the Atlas is a standalone architectural reference document that:
- Provides high-level system diagrams
- Explains integration patterns and frameworks
- Documents value flows and settlement rails
- References related implementation documentation

## Relationship to Implementation Documentation

The Atlas supplements work in conjunction with implementation documentation:

```
Atlas Supplement (Architecture) → Sub-Volume/Volume (Implementation)
```

For example:
- **Supplement B** (Atlas) describes the MetaverseDubai rail map and integration framework
- **Sub-Volume C** (Implementation) provides the actual services, APIs, and database schemas

Use the Atlas to understand **how systems connect and flow**, and use the implementation documentation to understand **how to build and use** those systems.