| .gitea/workflows | ||
| data | ||
| deploy | ||
| hermes-plugin/srs-gate | ||
| scripts | ||
| src | ||
| test/fixtures | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| ecosystem.config.cjs | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.build.json | ||
| tsconfig.json | ||
| vitest.config.ts | ||
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.
npm install
cp .env.example .env
npm run migrate # creates ./data/srs.db
npm run user create # a short wizard: choose Admin or User, then set a password
npm run user password # set a new password for an admin or a user
npm run user list # show every account
npm run shop create # add a shop (name + unique code)
npm run shop list # show every shop
npm run dev # http://127.0.0.1:8080
npm test
npm run typecheck