Files
Sankofa/QUICK_START_SOVEREIGN_STACK.md
defiQUG 33d50fb91e
Some checks failed
API CI / API Lint (push) Successful in 47s
API CI / API Type Check (push) Failing after 47s
API CI / API Test (push) Successful in 1m0s
API CI / API Build (push) Failing after 50s
API CI / Build Docker Image (push) Has been skipped
Build Crossplane Provider / build (push) Failing after 5m51s
CD Pipeline / Deploy to Staging (push) Failing after 29s
CI Pipeline / Lint and Type Check (push) Failing after 36s
CI Pipeline / Build (push) Has been skipped
CI Pipeline / Test Backend (push) Failing after 1m33s
CI Pipeline / Test Frontend (push) Failing after 30s
CI Pipeline / Security Scan (push) Failing after 1m16s
Crossplane Provider CI / Go Test (push) Failing after 3m23s
Crossplane Provider CI / Go Lint (push) Failing after 7m27s
Crossplane Provider CI / Go Build (push) Failing after 3m27s
Deploy to Staging / Deploy to Staging (push) Failing after 30s
Portal CI / Portal Lint (push) Failing after 21s
Portal CI / Portal Type Check (push) Failing after 21s
Portal CI / Portal Test (push) Failing after 21s
Portal CI / Portal Build (push) Failing after 22s
Test Suite / frontend-tests (push) Failing after 30s
Test Suite / api-tests (push) Failing after 49s
Test Suite / blockchain-tests (push) Failing after 30s
Type Check / type-check (map[directory:. name:root]) (push) Failing after 23s
Type Check / type-check (map[directory:api name:api]) (push) Failing after 21s
Type Check / type-check (map[directory:portal name:portal]) (push) Failing after 19s
Validate Configuration Files / validate (push) Failing after 1m52s
CD Pipeline / Deploy to Production (push) Has been skipped
chore: consolidate local WIP (repo cleanup 20260707)
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 09:41:34 -07:00

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