106 lines
2.4 KiB
Markdown
106 lines
2.4 KiB
Markdown
|
# 🚀 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. 🎉
|