chore: consolidate local WIP (repo cleanup 20260707)

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/phoenix/README.md

@@ -0,0 +1,315 @@
+# 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](./OPERATING_MODEL.md)
+
+**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](./OPERATING_MODEL_DIAGRAMS.md)
+
+**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](./CLOUD_PROVIDER_MAPPING.md)
+
+**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](./MVP_CONTROL_PLANE.md)
+
+**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](./MULTI_REGION_LANDING_ZONES.md)
+
+**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](./MIGRATION_GUIDE.md)
+
+**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](./PRODUCT_SPEC.md)
+
+**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](./STRUCTURAL_CONFIG_LOCATIONS.md)
+
+Reference guide for Phoenix structural configuration locations, deployments, and topology.
+
+### [Business Communications](./BUSINESS_COMMUNICATIONS.md)
+
+Phoenix business communications infrastructure including AS4 gateway, workflow automation, and financial messaging.
+
+### [Codespaces IDE Setup](./CODESPACES_IDE_SETUP.md)
+
+Development environment setup for Phoenix using GitHub Codespaces.
+
+## Enhancement Documentation
+
+### [API Specification](./API_SPECIFICATION.md)
+
+Complete API specification for all five control planes, including GraphQL schemas, REST endpoints, authentication, authorization, and integration patterns.
+
+### [Implementation Examples](./IMPLEMENTATION_EXAMPLES.md)
+
+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_RUNBOOKS.md)
+
+Operational procedures, troubleshooting guides, incident response procedures, maintenance procedures, monitoring and alerting, and backup and recovery.
+
+### [Case Studies](./CASE_STUDIES.md)
+
+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](./FAQ.md)
+
+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
+
+1. Start with [Operating Model](./OPERATING_MODEL.md) for comprehensive understanding
+2. Review [Architecture Diagrams](./OPERATING_MODEL_DIAGRAMS.md) for visual understanding
+3. Review [Cloud Provider Mapping](./CLOUD_PROVIDER_MAPPING.md) for competitive context
+
+### For Implementers
+
+1. Start with [MVP Control Plane](./MVP_CONTROL_PLANE.md) for implementation scope
+2. Review [Operating Model](./OPERATING_MODEL.md) for entity models and APIs
+3. Review [Multi-Region Landing Zones](./MULTI_REGION_LANDING_ZONES.md) for deployment patterns
+
+### For Business/Sales
+
+1. Start with [Product Specification](./PRODUCT_SPEC.md) for client-facing content
+2. Review [Cloud Provider Mapping](./CLOUD_PROVIDER_MAPPING.md) for competitive advantages
+3. Review [Use Cases](./OPERATING_MODEL.md#xi-use-cases-for-sovereign-governments) for scenarios
+
+### For Migrations
+
+1. Start with [Migration Guide](./MIGRATION_GUIDE.md) for migration planning
+2. Review [Cloud Provider Mapping](./CLOUD_PROVIDER_MAPPING.md) for entity mapping
+3. Review [Operating Model](./OPERATING_MODEL.md) for target model understanding
+
+---
+
+## Key Concepts
+
+### Five Control Planes
+
+1. **Commercial Plane** — *Who pays* (Client/Billing Profile)
+2. **Tenancy Plane** — *Who owns domains & identity* (Tenant)
+3. **Subscription Plane** — *What is provisioned* (Subscription)
+4. **Environment Plane** — *Where workloads run* (Environment)
+5. **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](../ARCHITECTURE_INDEX.md)** - Complete architecture documentation index
+- **[Data Model](../architecture/data-model.md)** - GraphQL schema and data model
+- **[Well-Architected Framework](../architecture/well-architected.md)** - Well-Architected Framework
+
+### Tenant Management
+
+- **[Tenant Management](../tenants/TENANT_MANAGEMENT.md)** - Multi-tenant operations guide
+- **[Billing Guide](../tenants/BILLING_GUIDE.md)** - Billing and cost management
+- **[Identity Setup](../tenants/IDENTITY_SETUP.md)** - Keycloak configuration
+
+**Note**: The existing tenant/billing documentation uses a tenant-based model. See [Migration Guide](./MIGRATION_GUIDE.md) 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
+
+