# DBIS Volume VIII Documentation

This directory contains documentation for DBIS Expansion Volume VIII: Cyber-Defense Command, Planetary Settlement Grid, Sovereign Compute Mesh, CBDC Governance, and the Global Quantum Ledger.

## Modules

### 1. DBIS Cyber-Defense Command (DCDC)
- **Location**: `src/core/security/dcdc/`
- **Services**: Strategic Defense, Operational Defense, Forensics, Counter-Intrusion, Defense Layers, SGSE
- **API Routes**: `/api/v1/dcdc`
- **Documentation**: [dcdc.md](./dcdc.md)

### 2. Planetary Settlement Grid (PSG)
- **Location**: `src/core/settlement/psg/`
- **Services**: Architecture, Master Grid, Relay Hubs, Epoch Engine, State Sync
- **API Routes**: `/api/v1/psg`
- **Documentation**: [psg.md](./psg.md)

### 3. Distributed Sovereign Compute Mesh (DSCM-X)
- **Location**: `src/infrastructure/compute/dscm-x/`
- **Services**: Node Manager, Compute Distribution, Federated AI, Smart Contract Execution, Consensus
- **API Routes**: `/api/v1/dscm`
- **Documentation**: [dscm-x.md](./dscm-x.md)

### 4. CBDC Governance & Monetary Modeling
- **Location**: `src/core/cbdc/governance/`
- **Services**: Monetary Committees, Supply/Velocity Controls, Liquidity Management, Simulation Engine
- **API Routes**: `/api/v1/cbdc-governance`
- **Documentation**: [cbdc-governance.md](./cbdc-governance.md)

### 5. Global Quantum Ledger (GQL)
- **Location**: `src/core/ledger/gql/`
- **Services**: Block Engine, Quantum-Resistant Signatures, Quantum Hashing, Multi-Asset Root
- **API Routes**: `/api/v1/gql`
- **Documentation**: [gql.md](./gql.md)

### 6. Advanced FX/CBDC/SSU Simulation Engine (A-FCSS)
- **Location**: `src/core/simulation/afcss/`
- **Services**: FX/CBDC/SSU Simulator, Volatility Predictor, Circulation Dynamics, Contagion Analysis
- **API Routes**: `/api/v1/simulation`
- **Documentation**: [afcss.md](./afcss.md)

### 7. Supra-Sovereign Threat Matrix (SSTM)
- **Location**: `src/core/security/sstm/`
- **Services**: Threat Classification, Coordinated Threat Detection, Mitigation
- **API Routes**: `/api/v1/sstm`
- **Documentation**: [sstm.md](./sstm.md)

## Database Schema

All Volume VIII models are defined in `prisma/schema.prisma`. Key models include:

- **DCDC**: `DcdcDivision`, `CyberThreatIncident`, `DefenseLayerAction`, `SovereignGraphSecurityEngine`, `LedgerAnomaly`, `NodeQuarantine`
- **PSG**: `PsgSovereignNode`, `PsgMasterGrid`, `SupraSovereignRelayHub`, `SettlementEpoch`, `PsgStateBlock`
- **DSCM-X**: `DscmNode`, `ComputeTask`, `FederatedAiTask`
- **CBDC Governance**: `CbdcMonetaryCommittee`, `DbisMonetaryCouncil`, `CbdcComplianceBoard`, `CbdcSupplyControl`, `CbdcVelocityControl`, `CbdcLiquidityWindow`, `CbdcMonetarySimulation`
- **GQL**: `GqlBlock`, `QuantumStateCommitment`, `PqSignatureBlock`, `QuantumHash`
- **A-FCSS**: `AfcssSimulation`, `FxCbdcSsuImpact`, `MultiAssetContagionRisk`
- **SSTM**: `SupraSovereignThreat`, `CoordinatedThreatPattern`, `ThreatMitigation`

## Integration

Volume VIII modules integrate with existing DBIS infrastructure:

- **DCDC** extends existing AML/compliance services and integrates with quantum crypto
- **PSG** extends existing GSS architecture with geo-redundancy and epoch-based settlement
- **DSCM-X** uses smart contract services and integrates with SARE
- **CBDC Governance** extends existing CBDC service and uses GSS for dual-signature operations
- **GQL** extends existing ledger service and uses quantum crypto service
- **A-FCSS** uses FX, CBDC, SSU, and SRI services
- **SSTM** integrates with DCDC and uses SARE for predictive threat detection

## API Documentation

Full API documentation is available via Swagger UI at `/api-docs` when the server is running.