managarten/services/mana-subscriptions/CLAUDE.md
Till JS 8ccf8ff818 chore: misc fixes, new services, lockfile cleanup
Assorted changes from recent sessions:
- .gitignore: add mana-sync binary, Forgejo data
- chat/web: add isSidebarMode to navigation store
- clock/web: fix alarm page markup
- contacts/mukke/presi/questions: add svelte.config.js aliases
- context/web: add missing dependency
- manacore/landing: update pricing page
- manacore/web + todo/web: update mana dashboard pages
- planta/web: fix dashboard layout
- pnpm-lock.yaml: cleanup after backend removals
- docs/APP_GAP_ANALYSIS.md: new gap analysis doc
- services/mana-analytics: add Dockerfile
- services/mana-subscriptions: new Go subscription service

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 10:27:35 +01:00

1.9 KiB

mana-subscriptions

Subscription and billing service. Extracted from mana-core-auth.

Tech Stack

Layer Technology
Runtime Bun
Framework Hono
Database PostgreSQL + Drizzle ORM
Payments Stripe (Subscriptions, Billing Portal)
Auth JWT validation via JWKS from mana-core-auth

Port: 3063

Quick Start

bun run dev         # Start with hot reload
bun run db:push     # Push schema
bun run db:seed     # Seed plans

API Endpoints

User-facing (JWT auth)

Method Path Description
GET /api/v1/subscriptions/plans List active plans
GET /api/v1/subscriptions/plans/:id Get plan details
GET /api/v1/subscriptions/current Current subscription
POST /api/v1/subscriptions/checkout Create Stripe checkout
POST /api/v1/subscriptions/portal Billing portal
POST /api/v1/subscriptions/cancel Cancel at period end
POST /api/v1/subscriptions/reactivate Reactivate canceled
GET /api/v1/subscriptions/invoices Invoice history

Internal (X-Service-Key)

Method Path Description
GET /api/v1/internal/plan-limits/:userId Get plan limits (guilds)
GET /api/v1/internal/subscription/:userId Get user subscription

Webhooks

Method Path Description
POST /api/v1/webhooks/stripe Subscription/invoice events

Database: mana_subscriptions

Tables: plans, subscriptions, invoices, stripe_customers

Environment Variables

PORT=3063
DATABASE_URL=postgresql://manacore:devpassword@localhost:5432/mana_subscriptions
MANA_CORE_AUTH_URL=http://localhost:3001
MANA_CORE_SERVICE_KEY=dev-service-key
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
BASE_URL=http://localhost:3063