Sankofa/docs/README.md

# Sankofa Phoenix Documentation

Complete documentation for the Sankofa Phoenix sovereign cloud platform.

## Quick Links

- **[Main README](../../README.md)** - Project overview and getting started
- **[Configuration Guide](../../CONFIGURATION_GUIDE.md)** - Setup and configuration
- **[Environment Variables](../../ENV_EXAMPLES.md)** - Environment variable examples

## Documentation Structure

### Architecture
- **[System Architecture](./system_architecture.md)** - Overall system architecture
- **[Ecosystem Architecture](./ecosystem-architecture.md)** - Ecosystem structure
- **[Datacenter Architecture](./datacenter_architecture.md)** - Datacenter specifications
- **[Blockchain Architecture](./blockchain_eea_architecture.md)** - Blockchain integration
- **[Data Model](./architecture/data-model.md)** - GraphQL schema and data model
- **[Tech Stack](./architecture/tech-stack.md)** - Technology stack details

### Infrastructure
- **[Infrastructure README](../infrastructure/README.md)** - Infrastructure management overview
- **[Proxmox Documentation](./proxmox/README.md)** - Complete Proxmox documentation
  - [Quick Start](./proxmox/guides/QUICK_START.md) - Get started with Proxmox
  - [Deployment Guide](./proxmox/guides/DEPLOYMENT_GUIDE.md) - Deployment procedures
  - [Configuration](./proxmox/DNS_CONFIGURATION.md) - Configuration guides
- **[Domain Migration](./infrastructure/DOMAIN_MIGRATION.md)** - Domain migration documentation

### Development
- **[Development Guide](./DEVELOPMENT.md)** - Development setup and workflow
- **[Testing Guide](./TESTING.md)** - Testing strategies and examples
- **[Deployment Guide](./DEPLOYMENT.md)** - Production deployment instructions
- **[Troubleshooting Guide](./TROUBLESHOOTING_GUIDE.md)** - Comprehensive troubleshooting guide

### Deployment & Status
- **[Deployment Requirements](./DEPLOYMENT_REQUIREMENTS.md)** - Complete deployment requirements
- **[Deployment Execution Plan](./DEPLOYMENT_EXECUTION_PLAN.md)** - Step-by-step execution guide
- **[Deployment Index](./DEPLOYMENT_INDEX.md)** - Navigation guide
- **[Infrastructure Ready](./INFRASTRUCTURE_READY.md)** - Current infrastructure status
- **[Deployment Guide](./DEPLOYMENT.md)** - Production deployment instructions

### Operations
- **[Runbooks](./runbooks/)** - Operational runbooks
  - VM Provisioning
  - Troubleshooting
  - Disaster Recovery

### Brand & Positioning
- **[Brand Documentation](./brand/)** - Brand philosophy and positioning
- **[Ecosystem Mapping](./brand/ecosystem-mapping.md)** - Ecosystem structure

### Tenants (Multi-Tenancy)
- **[Tenant Management](./tenants/TENANT_MANAGEMENT.md)** - Comprehensive tenant management guide
- **[Billing Guide](./tenants/BILLING_GUIDE.md)** - Advanced billing features (superior to Azure)
- **[Identity Setup](./tenants/IDENTITY_SETUP.md)** - Keycloak and identity provider setup
- **[Azure Migration Guide](./tenants/AZURE_MIGRATION.md)** - Guide for migrating from Azure

## Key Features

### Sovereign Infrastructure
- **NO Azure/Microsoft dependencies** - All solutions are self-hosted
- **Superior to Azure** - More flexible, granular, and better UX than Azure
- **Sovereign-owned hardware** - Complete control over infrastructure

### Multi-Tenancy
- **Keycloak-based identity** - Sovereign alternative to Azure AD
- **Fine-grained permissions** - Beyond Azure RBAC
- **Custom domains per tenant** - Better than Azure
- **Cross-tenant resource sharing** - More flexible than Azure

### Billing (Superior to Azure Cost Management)
- **Per-second granularity** - vs Azure's hourly
- **Real-time cost tracking** - Better than Azure
- **ML-based forecasting** - Predictive cost analysis
- **Blockchain-backed billing** - Immutable audit trail

### Current Status
- **[Infrastructure Ready](./INFRASTRUCTURE_READY.md)** - Current infrastructure status
- **[Deployment Guide](./DEPLOYMENT.md)** - Production deployment instructions
- **[Status Reports](./status/)** - Current status reports by category
  - [Build Status](./status/builds/) - Build and test results
  - [Deployment Status](./status/deployments/) - Deployment status reports
  - [VM Status](./status/vms/) - VM-related status and analysis
  - [Tasks](./status/tasks/) - Task tracking and remaining work
- **[Archived Reports](./archive/)** - Historical reports and audits

### SMOM-DBIS-138
- **[SMOM-DBIS-138 Index](./smom-dbis-138-INDEX.md)** - Navigation guide
- **[SMOM-DBIS-138 Quick Start](./smom-dbis-138-QUICK_START.md)** - Quick start guide
- **[SMOM-DBIS-138 Next Steps](./smom-dbis-138-next-steps.md)** - Next steps guide
- **[SMOM-DBIS-138 Project Integration](./smom-dbis-138-project-integration.md)** - Integration guide
- **[SMOM-DBIS-138 Complete Summary](./archive/status/smom-dbis-138-COMPLETE_SUMMARY.md)** - Complete summary (archived)

## Archive

Historical documentation is archived in [docs/archive/](./archive/) for reference:
- [Audit Reports](./archive/audits/) - Historical audit reports
- [Status Reports](./archive/status/) - Archived status reports
- [Build Results](./archive/builds/) - Historical build results
- [Deployment Reports](./archive/deployments/) - Historical deployment reports

## Documentation Indexes

Quick navigation to specific documentation types:
- **[Guides Index](./GUIDES_INDEX.md)** - All how-to guides and tutorials
- **[Reference Index](./REFERENCE_INDEX.md)** - API docs, specs, and reference material
- **[Architecture Index](./ARCHITECTURE_INDEX.md)** - Architecture and design documentation

## Documentation Maintenance

For documentation improvements and audits, see:
- **[Documentation Deep-Dive Analysis](./DOCUMENTATION_DEEP_DIVE_ANALYSIS.md)** - Comprehensive documentation analysis
- **[Documentation Fixes Applied](./DOCUMENTATION_FIXES_APPLIED.md)** - Recent documentation improvements
- **[Audit Summary](./AUDIT_SUMMARY.md)** - Quick audit reference