# 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](./README.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](./README.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](./README.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](./README.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](./README.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](./README.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.

