Sankofa/QUICK_START_SOVEREIGN_STACK.md

🚀 Quick Start: Sovereign Stack Marketplace

One-Command Setup

cd /home/intlc/projects/Sankofa/api
./scripts/setup-sovereign-stack.sh

That's it! This will:

1. ✅ Run database migrations (adds new categories)
2. ✅ Create Phoenix publisher
3. ✅ Register all 9 Sovereign Stack services
4. ✅ Verify everything worked

What Gets Created

In Database

• Phoenix Cloud Services publisher (verified)
• 9 Services registered with:
  • Product definitions
  • Version 1.0.0
  • Pricing models
  • Complete metadata

In Codebase

• 9 Service stubs ready for implementation
• GraphQL schema updated with new categories
• Documentation for all services

Verify It Worked

cd /home/intlc/projects/Sankofa/api
pnpm verify:sovereign-stack

Expected output:

✅ Phoenix publisher found: Phoenix Cloud Services
✅ Found 9 Phoenix services
✅ All 9 expected services found!

Access Services

Via GraphQL

query {
  products(filter: { 
    category: LEDGER_SERVICES 
  }) {
    name
    slug
    description
    pricing {
      pricingType
      basePrice
    }
  }
}

Via Marketplace Portal

Navigate to: https://portal.sankofa.nexus/marketplace

Filter by: Phoenix Cloud Services or Sovereign Stack

Services Available

1. Phoenix Ledger Service - Double-entry ledger
2. Phoenix Identity Service - Identity & auth
3. Phoenix Wallet Registry - Wallet management
4. Phoenix Transaction Orchestrator - Workflow orchestration
5. Phoenix Messaging Orchestrator - Multi-provider messaging
6. Phoenix Voice Orchestrator - TTS/STT with caching
7. Phoenix Event Bus - Durable event streaming
8. Phoenix Audit Service - Immutable audit logs
9. Phoenix Observability Stack - Distributed tracing

Documentation

• Setup Guide: docs/marketplace/sovereign-stack/SETUP.md
• Service Docs: docs/marketplace/sovereign-stack/*.md
• Implementation Summary: docs/marketplace/sovereign-stack/IMPLEMENTATION_SUMMARY.md

Troubleshooting

Migration fails?

• Check .env has correct database credentials
• Ensure PostgreSQL is running

Seed fails?

• Make sure migration 025 ran first
• Check database logs

Services not showing?

• Run verification script
• Re-run seed: pnpm db:seed:sovereign-stack

---

Ready to go! Run the setup script and start using Sovereign Stack services. 🎉