proxmox/docs/02-architecture/BRAND_RELATIONSHIP.md

# Sankofa Phoenix - Brand and Product Relationship

**Last Updated:** 2026-01-20
**Status:** Active Documentation

---

## Brand/Product Analogy

### Corporate Structure Analogy

The relationship between Sankofa and Phoenix follows a similar structure to major tech companies:

| Component | Example Companies | Sankofa Equivalent |
|-----------|-------------------|-------------------|
| **Company/Brand** | Microsoft, Google, Amazon | **Sankofa** |
| **Cloud Platform** | Azure, GCP, AWS | **Phoenix** |
| **Complete Product** | Microsoft Azure, Google Cloud Platform, Amazon Web Services | **Sankofa Phoenix** |

---

## Detailed Breakdown

### 1. Sankofa (Company/Brand)
- **Role:** Parent company and brand identity
- **Examples:** Microsoft, Google, Amazon, IBM, Oracle
- **Website:** `sankofa.nexus` (like Microsoft.com, Google.com, Amazon.com)
- **Purpose:** Corporate website, brand presence, company information
- **Deployment:** VMID 7801, IP: 192.168.11.51:3000

### 2. Phoenix (Cloud Platform)
- **Role:** Cloud infrastructure platform product
- **Examples:** Azure, Google Cloud Platform (GCP), Amazon Web Services (AWS)
- **Portal:** `phoenix.sankofa.nexus` (like portal.azure.com, console.cloud.google.com, console.aws.amazon.com)
- **Purpose:** Cloud infrastructure management, service provisioning, platform operations
- **Deployment:** VMID 7800, IP: 192.168.11.50:4000

### 3. Sankofa Phoenix (Complete Product)
- **Role:** Full product name combining company and platform
- **Examples:** Microsoft Azure, Google Cloud Platform, Amazon Web Services
- **Purpose:** The complete cloud platform offering
- **Components:**
  - Sankofa Portal (company website)
  - Phoenix API (cloud platform portal)
  - Supporting services (Keycloak, PostgreSQL)

---

## Service Mappings

### Sankofa Portal (`sankofa.nexus`)
**Like:** Microsoft.com, Google.com, Amazon.com  
**Purpose:** Company website, corporate branding, general information  
**Technology:** Next.js 14, React, TypeScript

### Phoenix API (`phoenix.sankofa.nexus`)
**Like:** Azure Portal, Google Cloud Console, AWS Management Console  
**Purpose:** Cloud platform management, infrastructure provisioning, service management  
**Technology:** GraphQL API (Apollo Server), Fastify, PostgreSQL

---

## Additional Services

### SolaceScanScout
- **Type:** Blockchain Explorer
- **Technology:** Blockscout-based
- **Purpose:** Block explorer for ChainID 138
- **Status:** Separate service (not part of Sankofa Phoenix deployment)
- **Similar to:** Etherscan, BscScan, PolygonScan

---

## Infrastructure Components

### Supporting Services

1. **Keycloak** (VMID 7802)
   - Identity and Access Management
   - Sovereign identity solution (NO Azure dependencies)
   - Provides authentication for both Sankofa Portal and Phoenix API

2. **PostgreSQL** (VMID 7803)
   - Database service
   - Stores data for Keycloak, Phoenix API, and application data

---

## Deployment Architecture

```
Internet
   ↓
NPMplus (Reverse Proxy + SSL)
   ↓
   ├─→ sankofa.nexus → Sankofa Portal (Company Website)
   │                     └─→ Like: Microsoft.com
   │
   ├─→ phoenix.sankofa.nexus → Phoenix API (Cloud Platform)
   │                            └─→ Like: Azure Portal
   │
   └─→ SolaceScanScout (Separate - Blockchain Explorer)
   
Backend Services:
   ├─→ Keycloak (Authentication)
   └─→ PostgreSQL (Database)
```

---

## Brand Philosophy

**Sankofa Phoenix** embodies the principle of **Remember → Retrieve → Restore → Rise**:

- **Remember:** Where we came from (ancestral wisdom)
- **Retrieve:** What was essential (sovereign identity)
- **Restore:** Identity and sovereignty (independent infrastructure)
- **Rise:** Forward with purpose (world-class cloud platform)

---

## Summary

- **Sankofa** = The company (like Microsoft)
- **Phoenix** = The cloud platform (like Azure)
- **Sankofa Phoenix** = The complete product (like Microsoft Azure)
- **Sankofa Portal** = Company website (like Microsoft.com)
- **Phoenix Portal** = Cloud management console (like Azure Portal)

**Sankofa Phoenix** is a sovereign cloud platform that combines corporate identity (Sankofa) with cloud infrastructure capabilities (Phoenix), providing a complete alternative to major cloud providers while maintaining sovereign identity and independence.

---

**Last Updated:** 2026-01-20