Initial commit

docs/volume-xi/README.md

@@ -0,0 +1,75 @@
+# DBIS Volume XI Documentation
+
+This directory contains documentation for DBIS Expansion Volume XI: Supra-Constitutional Charter, Multiversal Monetary Theory, Temporal Liquidity Portals, Holographic Economics, and Omni-Sovereign Settlement Matrix.
+
+## Modules
+
+### 1. Supra-Constitutional DBIS Charter (SCDC)
+- **Location**: `src/core/governance/scdc/`
+- **Services**: `scdc-charter.service.ts`, `scdc-authority.service.ts`, `scdc-temporal-integrity.service.ts`, `scdc-ai-mandate.service.ts`
+- **API Routes**: `/api/v1/scdc`
+- **Documentation**: [scdc.md](./scdc.md)
+
+### 2. Global Multiversal Monetary Theory (GMMT)
+- **Location**: `src/core/monetary/gmmt/`
+- **Services**: `gmmt-units.service.ts`, `gmmt-valuation.service.ts`, `gmmt-conversion.service.ts`, `gmmt-stability.service.ts`
+- **API Routes**: `/api/v1/gmmt`
+- **Documentation**: [gmmt.md](./gmmt.md)
+
+### 3. Temporal Liquidity Portals (TLP)
+- **Location**: `src/core/treasury/tlp/`
+- **Services**: `tlp-portal.service.ts`, `tlp-liquidity.service.ts`, `tlp-paradox-detection.service.ts`, `tlp-buffer.service.ts`
+- **API Routes**: `/api/v1/tlp`
+- **Documentation**: [tlp.md](./tlp.md)
+
+### 4. Unified Holographic Economic Model (UHEM)
+- **Location**: `src/core/economics/uhem/`
+- **Services**: `uhem-encoding.service.ts`, `uhem-projection.service.ts`, `uhem-correction.service.ts`, `uhem-analytics.service.ts`
+- **API Routes**: `/api/v1/uhem`
+- **Documentation**: [uhem.md](./uhem.md)
+
+### 5. Omni-Sovereign Settlement Matrix (OSSM)
+- **Location**: `src/core/settlement/ossm/`
+- **Services**: `ossm-matrix.service.ts`, `ossm-settlement.service.ts`, `ossm-merge.service.ts`, `ossm-coordination.service.ts`
+- **API Routes**: `/api/v1/ossm`
+- **Documentation**: [ossm.md](./ossm.md)
+
+### 6. Multiverse-Consistent FX/SSU Stability Framework
+- **Location**: `src/core/fx/multiverse-stability/`
+- **Services**: `multiverse-stability.service.ts`, `multiverse-fx.service.ts`, `multiverse-ssu.service.ts`, `multiverse-divergence.service.ts`
+- **API Routes**: `/api/v1/multiverse-stability`
+- **Documentation**: [multiverse-stability.md](./multiverse-stability.md)
+
+### 7. Quantum-Temporal Arbitration Engine (QTAE)
+- **Location**: `src/core/governance/qtae/`
+- **Services**: `qtae-detection.service.ts`, `qtae-resolution.service.ts`, `qtae-affirmation.service.ts`, `qtae-notification.service.ts`
+- **API Routes**: `/api/v1/qtae`
+- **Documentation**: [qtae.md](./qtae.md)
+
+## Database Schema
+
+All Volume XI models are defined in `prisma/schema.prisma`. Key models include:
+
+- **SCDC**: `SupraConstitutionalCharter`, `CharterArticle`, `TemporalIntegrityCheck`, `AIAutonomousAction`
+- **GMMT**: `RealityLayer`, `MultiversalMonetaryUnit`, `MonetaryUnitConversion`, `ValuationCalculation`
+- **TLP**: `TemporalLiquidityPortal`, `FutureLiquidityReserve`, `ParadoxDetection`, `TemporalBuffer`
+- **UHEM**: `HolographicEconomicState`, `EconomicProjection`, `DeviationCorrection`, `HolographicMapping`
+- **OSSM**: `OmniSovereignMatrix`, `MatrixDimension`, `SettlementCoordinate`, `RealityLayerState`
+- **Stability**: `MultiverseStabilityIndex`, `RealityDivergence`, `StabilityCalculation`
+- **QTAE**: `QuantumTemporalArbitration`, `ContradictionEvent`, `ConsistencyRollback`, `ArbitrationDecision`
+
+## Integration
+
+Volume XI modules integrate with existing DBIS volumes:
+
+- **Volume VIII (GQL)**: Quantum ledger for QMU and quantum reality layers
+- **Volume IX (MRLI)**: Multi-reality ledger interfaces for OSSM
+- **Volume IX (ISP)**: Temporal settlement engine for TLP
+- **Volume III (SSU)**: SSU for multiversal stability
+- **Volume V (DIAS)**: Arbitration framework for QTAE
+- **Volume V (SARE)**: AI systems for autonomous enforcement
+
+## API Documentation
+
+Full API documentation is available via Swagger UI at `/api-docs` when the server is running.
+