API: Phoenix railing proxy, API key auth for /api/v1/*, schema export, docs, migrations, tests

- Phoenix API Railing: proxy to PHOENIX_RAILING_URL, tenant me routes
- Tenant-auth: X-API-Key support for /api/v1/* (api_keys table)
- Migration 026: api_keys table; 025 sovereign stack marketplace
- GET /graphql/schema, GET /graphql-playground, api/docs OpenAPI
- Integration tests: phoenix-railing.test.ts
- docs/api/API_VERSIONING: /api/v1/ railing alignment
- docs/phoenix/PORTAL_RAILING_WIRING

Made-with: Cursor

api/FINAL_SETUP_INSTRUCTIONS.md

@@ -0,0 +1,79 @@
+# Final Setup - Run This Now
+
+## ✅ Everything is Ready!
+
+All code is implemented. You just need to run **ONE command** to complete setup.
+
+## 🚀 Run This Command
+
+```bash
+cd /home/intlc/projects/Sankofa/api
+./ONE_COMMAND_SETUP.sh
+```
+
+**That's it!** This single script will:
+1. ✅ Configure `.env` file
+2. ✅ Create `sankofa` database
+3. ✅ Set PostgreSQL password
+4. ✅ Run all migrations
+5. ✅ Seed all 9 services
+6. ✅ Verify everything worked
+
+## What to Expect
+
+When you run the script:
+- You'll be prompted for your **sudo password** (for database setup)
+- The script will automatically do everything else
+- At the end, you'll see: `✅ SETUP COMPLETE!`
+
+## If Sudo Requires Password
+
+The script needs sudo to:
+- Create the database
+- Set the PostgreSQL password
+
+Just enter your sudo password when prompted.
+
+## Alternative: Manual Database Setup
+
+If you prefer to set up the database manually first:
+
+```bash
+# 1. Set up database (one command)
+sudo -u postgres psql << 'EOSQL'
+CREATE DATABASE sankofa;
+ALTER USER postgres PASSWORD 'dev_sankofa_2024_secure';
+\q
+EOSQL
+
+# 2. Then run the automated setup
+cd /home/intlc/projects/Sankofa/api
+./RUN_ME.sh
+```
+
+## After Setup
+
+Once complete, you'll have:
+- ✅ Phoenix Cloud Services publisher
+- ✅ 9 Sovereign Stack services registered
+- ✅ All services with versions and pricing
+- ✅ Services queryable via GraphQL
+- ✅ Services visible in marketplace
+
+## 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!
+```
+
+---
+
+**Ready?** Just run: `./ONE_COMMAND_SETUP.sh` 🎉