33d50fb91e
Co-authored-by: Cursor <cursoragent@cursor.com>
10 KiB
Phoenix Operating Model Documentation
Sankofa Phoenix Cloud Services — Enterprise-Grade Operating Model for Sovereign Governments
This directory contains comprehensive documentation for the Phoenix operating model, designed for international and multi-national sovereign governments.
Overview
Phoenix (Sankofa Cloud Services) is a competing cloud services offering purpose-built to service international and multi-national Sovereign Governments and their contractors. Phoenix competes directly with Azure, AWS, and other cloud service providers while offering superior capabilities for sovereign deployments.
The operating model separates commercial governance, technical tenancy, and content/devops control into five orthogonal control planes while enabling clean interoperability across distributed, multi-region deployments.
Core Documentation
1. Operating Model
Comprehensive operating model documentation covering all five control planes, entity models, key rules, and integration patterns.
Sections:
- Executive Summary
- Five Control Planes (Commercial, Tenancy, Subscription, Environment, Content & DevOps)
- Entity Models and Schemas
- Hierarchical Access Model (RBAC)
- Key Rules and Constraints
- Multi-Region and Multi-National Capabilities
- Decentralized Architecture
- Integration with Existing Infrastructure
- Use Cases for Sovereign Governments
- Glossary
Use Cases:
- Architecture decks
- Product specifications
- Implementation guides
- Technical reference
2. Architecture Diagrams
Visual representations of the Phoenix operating model with 15 mermaid diagrams.
Diagrams:
- Control Plane Overview
- Entity Relationship Diagram
- Multi-Region Landing Zone Architecture
- Decentralized Control Planes
- Content Hierarchy
- Access Model (RBAC)
- Promotion Flow
- Integration Architecture
- Sovereign Environment Isolation
- Multi-National Tenant Structure
- Landing Zone Patterns
- Competitive Architecture Comparison
- Data Flow
- Sequence Diagrams
- Multi-Region Topology
Use Cases:
- Architecture presentations
- Technical documentation
- Client proposals
- Training materials
3. Cloud Provider Mapping
Mapping Phoenix to Azure/AWS with competitive analysis and migration considerations.
Sections:
- Mapping to Azure (entity mapping, architecture comparison)
- Mapping to AWS (entity mapping, architecture comparison)
- Hybrid Deployments (sovereign + public cloud)
- Multi-Region Landing Zones (comparison)
- Decentralized Architecture (vs centralized)
- Feature Comparison Matrix
- Migration Considerations (complexity, strategies, timelines)
Use Cases:
- Competitive analysis
- Migration planning
- Architecture comparison
- Sales and marketing
4. MVP Control Plane
Minimum Viable Product specification for Phoenix operating model implementation.
Sections:
- MVP Scope Definition
- MVP for Each Control Plane
- Multi-Region MVP Requirements
- Decentralized Architecture MVP
- Sovereign Government MVP Requirements
- Required APIs and Services
- Data Model Extensions
- Implementation Priorities
- Dependencies Between Features
- Risk Assessment
- Integration with Existing Infrastructure
- Success Criteria
Use Cases:
- Implementation planning
- Development roadmap
- MVP definition
- Technical specification
5. Multi-Region Landing Zones
Comprehensive guide for multi-region landing zones for sovereign governments.
Sections:
- Landing Zone Architecture
- Multi-Region Deployment Patterns
- Sovereign Cloud Per Region/Nation
- Cross-Region Connectivity
- Regional Data Residency
- Multi-National Coordination
- Federated Identity
- Network Connectivity
- Regional Compliance
- Use Cases
- Landing Zone Templates
- Deployment Automation
- Integration with Existing Infrastructure
- Best Practices
- Troubleshooting
Use Cases:
- Landing zone design
- Multi-region deployment
- Sovereign cloud deployment
- Implementation guide
6. Migration Guide
Step-by-step migration guides for moving to Phoenix operating model.
Sections:
- Migration from Existing Phoenix Model
- Migration from Azure
- Migration from AWS
- Migration Planning
- Risk Mitigation
- Post-Migration
Use Cases:
- Migration planning
- Migration execution
- Migration validation
- Migration support
7. Product Specification
Client-facing product specification for sovereign governments.
Sections:
- Executive Summary
- Competitive Value Proposition
- Operating Model Overview
- Decentralized Architecture
- Multi-Region Landing Zones
- Sovereign Government Use Cases
- Compliance and Security Features
- Landing Zone Patterns
- Pricing and Packaging
- Migration Path
- Understanding All Capabilities
Use Cases:
- Client proposals
- Sales presentations
- Enterprise offerings
- Business development
Supporting Documentation
Structural Config Locations
Reference guide for Phoenix structural configuration locations, deployments, and topology.
Business Communications
Phoenix business communications infrastructure including AS4 gateway, workflow automation, and financial messaging.
Codespaces IDE Setup
Development environment setup for Phoenix using GitHub Codespaces.
Enhancement Documentation
API Specification
Complete API specification for all five control planes, including GraphQL schemas, REST endpoints, authentication, authorization, and integration patterns.
Implementation Examples
Practical code examples and implementation patterns, including entity creation, Infrastructure as Code (Terraform, Pulumi), CI/CD pipelines, multi-region deployments, and integration examples.
Operational Runbooks
Operational procedures, troubleshooting guides, incident response procedures, maintenance procedures, monitoring and alerting, and backup and recovery.
Case Studies
Real-world deployment examples and success stories for sovereign governments, including multi-national defense contractors, international healthcare agencies, cross-border financial regulators, and air-gapped government systems.
FAQ
Frequently asked questions covering general concepts, entity model, multi-region, identity and access, billing, content & DevOps, migration, compliance, technical questions, best practices, and troubleshooting.
Quick Start
For Architects
- Start with Operating Model for comprehensive understanding
- Review Architecture Diagrams for visual understanding
- Review Cloud Provider Mapping for competitive context
For Implementers
- Start with MVP Control Plane for implementation scope
- Review Operating Model for entity models and APIs
- Review Multi-Region Landing Zones for deployment patterns
For Business/Sales
- Start with Product Specification for client-facing content
- Review Cloud Provider Mapping for competitive advantages
- Review Use Cases for scenarios
For Migrations
- Start with Migration Guide for migration planning
- Review Cloud Provider Mapping for entity mapping
- Review Operating Model for target model understanding
Key Concepts
Five Control Planes
- Commercial Plane — Who pays (Client/Billing Profile)
- Tenancy Plane — Who owns domains & identity (Tenant)
- Subscription Plane — What is provisioned (Subscription)
- Environment Plane — Where workloads run (Environment)
- Content & DevOps Plane — What is built, governed, and deployed (Enterprise → Portfolio → Product → Application → Component)
Key Principles
- Separation of Concerns: Each plane operates independently
- ID-Based References: Planes reference each other through IDs
- Enterprise Scale: Support for large multi-tenant deployments
- Sovereign First: Built for sovereign governments
- Multi-Region Native: Designed for international/multi-national deployments
- Decentralized Architecture: Supports distributed sovereignty
Related Documentation
Architecture
- Architecture Index - Complete architecture documentation index
- Data Model - GraphQL schema and data model
- Well-Architected Framework - Well-Architected Framework
Tenant Management
- Tenant Management - Multi-tenant operations guide
- Billing Guide - Billing and cost management
- Identity Setup - Keycloak configuration
Note: The existing tenant/billing documentation uses a tenant-based model. See Migration Guide for migration to the new operating model with Client/Tenant/Subscription separation.
Document Status
| Document | Status | Version | Last Updated |
|---|---|---|---|
| Operating Model | ✅ Complete | 1.0 | 2025-01-09 |
| Architecture Diagrams | ✅ Complete | 1.0 | 2025-01-09 |
| Cloud Provider Mapping | ✅ Complete | 1.0 | 2025-01-09 |
| MVP Control Plane | ✅ Complete | 1.0 | 2025-01-09 |
| Multi-Region Landing Zones | ✅ Complete | 1.0 | 2025-01-09 |
| Migration Guide | ✅ Complete | 1.0 | 2025-01-09 |
| Product Specification | ✅ Complete | 1.0 | 2025-01-09 |
Last Updated: 2025-01-09
Status: Complete Documentation Suite