managarten/services/mana-api-gateway-go/CLAUDE.md
Till JS 819568c3df feat(infra): consolidate 21 Matrix bots into Go binary + add Go API gateway
Replace 21 separate NestJS Matrix bot processes (~2.1 GB RAM, ~4.2 GB Docker images)
with a single Go binary using plugin architecture (8.6 MB binary, ~30 MB RAM).

New services:
- services/mana-matrix-bot/ — Go Matrix bot with 21 plugins (mautrix-go, Redis sessions)
- services/mana-api-gateway-go/ — Go API gateway (rate limiting, API keys, credit billing)

Deleted:
- 21 services/matrix-*-bot/ directories
- packages/bot-services/ and packages/matrix-bot-common/
- Legacy deploy scripts and CI build jobs

Updated:
- docker-compose.macmini.yml: new Go services, legacy bots removed
- CI/CD: change detection + build jobs for Go services
- Root package.json: new dev:matrix, build:matrix, test:matrix scripts

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

53 lines
1.5 KiB
Markdown

# mana-api-gateway (Go)
Go replacement for the NestJS API Gateway. Handles API key management, rate limiting, credit billing, and service proxying.
## Architecture
- **Language:** Go 1.25
- **Database:** PostgreSQL (pgx v5)
- **Cache/RateLimit:** Redis (sliding window)
- **Port:** 3030
## Endpoints
### Public API (X-API-Key auth)
- `POST /v1/search` — Web search (1 credit)
- `POST /v1/extract` — Content extraction (1 credit)
- `POST /v1/stt/transcribe` — Speech-to-text (10 credits/min)
- `POST /v1/tts/synthesize` — Text-to-speech (1 credit/1000 chars)
### Management API (JWT auth)
- `POST /api-keys` — Create API key
- `GET /api-keys` — List user's keys
- `DELETE /api-keys/{id}` — Delete key
- `GET /api-keys/{id}/usage` — Daily usage stats
### System
- `GET /health` — Health check (DB + Redis)
- `GET /metrics` — Prometheus metrics
## Pricing Tiers
| Tier | Rate Limit | Monthly Credits | Price |
|------|-----------|-----------------|-------|
| Free | 10 req/min | 100 | €0 |
| Pro | 100 req/min | 5,000 | €19/mo |
| Enterprise | 1,000 req/min | 50,000 | €99/mo |
## Commands
```bash
go run ./cmd/server # Dev
go build ./cmd/server # Build
go test ./... # Test
```
## Environment Variables
- `PORT` — Server port (3030)
- `DATABASE_URL` — PostgreSQL connection
- `REDIS_HOST`, `REDIS_PORT`, `REDIS_PASSWORD`
- `SEARCH_SERVICE_URL`, `STT_SERVICE_URL`, `TTS_SERVICE_URL`
- `MANA_CORE_AUTH_URL` — JWT validation
- `ADMIN_USER_IDS` — Comma-separated admin user IDs