ajet-chat/api/plan.md

API Service Plan

Stack

• http-kit (HTTP server)
• reitit (routing) + Ring middleware
• next.jdbc + HoneySQL (via shared/)
• PostgreSQL everywhere (dev + prod)

Responsibilities

• Stateless REST API: all reads & writes for messages, channels, users
• Only service (besides Auth GW) with a direct PG connection
• Publishes events to NATS after DB writes
• No live connections — pure request/response
• Sits behind auth gateway (all requests pre-authenticated)

TODO

• Define reitit route table
• http-kit server setup
• Design message/channel/user API endpoints
• Ring middleware: error handling, content negotiation, request logging
• NATS publish on write (message sent, channel created, etc.)
• Database migrations