# 🚀 Quick Start: Sovereign Stack Marketplace

## One-Command Setup

```bash
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

```bash
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

```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. 🎉