init commit

api/plan.md

@@ -0,0 +1,22 @@
+# 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