srs-api/README.md
Aswin Biju 6851d66b38 feat: SRS backend: orders intake, results pipeline, user management
Fastify + TypeScript + SQLite backend for a single Kerala lottery agency.
2026-11-03 10:09:46 +05:30

26 lines
938 B
Markdown

# srs-api
Backend for SRS: the order parser, the WhatsApp conversation flow, and the API for the Flutter PWA.
One Node/TypeScript service (Fastify) with a SQLite database. It runs on the server under pm2, behind Caddy.
```
Flutter PWA ──HTTPS──▶ Caddy ──/api/*──▶ ┐
├─▶ srs-api (127.0.0.1:8080) ──▶ SQLite file
Hermes plugin ──localhost + secret──────▶ ┘ │
└─▶ WhatsApp bridge (127.0.0.1:3000): replies, 3 PM summary
```
## Run it on your computer
Needs Node 22 or newer.
```bash
npm install
cp .env.example .env
npm run migrate # creates ./data/srs.db
npm run user create # a short wizard: choose Admin or User
npm run user list # show every account
npm run dev # http://127.0.0.1:8080
npm test
npm run typecheck
```