till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-14 17:41:09 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
managarten/services/mana-subscriptions/CLAUDE.md
Till JS 22a73943e1 chore: complete ManaCore → Mana rename (docs, go modules, plists, images) 
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>
2026-04-07 12:26:10 +02:00

1.8 KiB
Raw Permalink Blame History

mana-subscriptions

Subscription and billing service. Extracted from mana-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-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://mana:devpassword@localhost:5432/mana_subscriptions
MANA_AUTH_URL=http://localhost:3001
MANA_SERVICE_KEY=dev-service-key
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
BASE_URL=http://localhost:3063