mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-19 06:01:24 +02:00
22a73943e1
Final cleanup of references missed in previous rename commits: - Dockerfiles: PUBLIC_MANA_CORE_AUTH_URL → PUBLIC_MANA_AUTH_URL - Go modules: github.com/manacore/* → github.com/mana/* (7 go.mod files) - launchd plists: com.manacore.* → com.mana.* (14 files renamed + content) - Image assets: *_Manacore_AI_Credits* → *_Mana_AI_Credits* (11 files) - .env.example files: ManaCore brand strings → Mana - .prettierignore: stale apps/manacore/* paths → apps/mana/* - Markdown docs (CLAUDE.md, /docs/*): mana-core-auth → mana-auth, etc. Excluded from rename: .claude/, devlog/, manascore/ (historical content), client testimonials, blueprints, npm package refs (@mana-core/*). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3.2 KiB
3.2 KiB
mana-credits
Standalone credit management service for the Mana ecosystem. Extracted from mana-auth.
Tech Stack
| Layer | Technology |
|---|---|
| Runtime | Bun |
| Framework | Hono |
| Database | PostgreSQL + Drizzle ORM |
| Payments | Stripe (Payment Intents, Checkout Sessions) |
| Auth | JWT validation via JWKS from mana-auth |
Quick Start
# Start (requires PostgreSQL running)
bun run dev
# Database
bun run db:push # Push schema
bun run db:studio # Open Drizzle Studio
Port: 3061
API Endpoints
Personal Credits (JWT auth)
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/credits/balance |
Get personal balance |
| POST | /api/v1/credits/use |
Use credits (personal or guild) |
| GET | /api/v1/credits/transactions |
Transaction history |
| GET | /api/v1/credits/purchases |
Purchase history |
| GET | /api/v1/credits/packages |
Available packages |
| POST | /api/v1/credits/purchase |
Initiate Stripe purchase |
| GET | /api/v1/credits/purchase/:id |
Purchase status |
Guild Pool (JWT auth)
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/credits/guild/:id/balance |
Pool balance |
| POST | /api/v1/credits/guild/:id/fund |
Fund pool from personal |
| POST | /api/v1/credits/guild/:id/use |
Use from pool |
| GET | /api/v1/credits/guild/:id/transactions |
Pool history |
| GET | /api/v1/credits/guild/:id/members/:uid/limits |
Get limits |
| PUT | /api/v1/credits/guild/:id/members/:uid/limits |
Set limits |
Gift Codes (Mixed auth)
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/gifts/:code |
Get gift info (public) |
| POST | /api/v1/gifts |
Create gift (JWT) |
| GET | /api/v1/gifts/me/created |
My created gifts (JWT) |
| GET | /api/v1/gifts/me/received |
My received gifts (JWT) |
| POST | /api/v1/gifts/:code/redeem |
Redeem gift (JWT) |
| DELETE | /api/v1/gifts/:id |
Cancel gift (JWT) |
Internal (X-Service-Key auth)
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/internal/credits/balance/:userId |
Get user balance |
| POST | /api/v1/internal/credits/use |
Use credits for user |
| POST | /api/v1/internal/credits/refund |
Refund credits |
| POST | /api/v1/internal/credits/init |
Initialize balance |
| POST | /api/v1/internal/gifts/redeem-pending |
Auto-redeem on registration |
| POST | /api/v1/internal/guild-pool/init |
Initialize guild pool |
Webhooks
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/webhooks/stripe |
Stripe payment events |
Environment Variables
PORT=3061
DATABASE_URL=postgresql://mana:devpassword@localhost:5432/mana_credits
MANA_AUTH_URL=http://localhost:3001
MANA_SERVICE_KEY=dev-service-key
BASE_URL=http://localhost:3061
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
CORS_ORIGINS=http://localhost:5173,http://localhost:5180
Database
Own database: mana_credits
Schemas: credits.*, gifts.*
Tables: balances, transactions, packages, purchases, usage_stats, stripe_customers, gift_codes, gift_redemptions, guild_pools, guild_transactions, guild_spending_limits