Home

KinetiRx Wiki

KinetiRx (Pharma Care Pro) is a self-hosted pharmacy & small-clinic management system — point-of-sale billing, medicine inventory, patient records, OPD scheduling, a due-khata (credit ledger), daily cash-drawer reconciliation, expense tracking, AI-powered invoice OCR, and role-based staff accounts, all backed by a Postgres database you own.

Start with the repository README for a quick overview and the fastest path to running the app. This wiki goes deeper on architecture, deployment, contributing, and the API.

Pages

• Architecture — component breakdown (backend/frontend/deploy), data flow, JWT + role-based auth model, how the Gemini AI OCR integration works.
• API Reference — the full REST API contract (also available at backend/API.md in the repo).
• Deployment — Docker Compose and CasaOS install in depth: troubleshooting, Postgres backup/restore, upgrading.
• Development Guide — local dev setup for backend and frontend, code structure conventions, testing status.
• MCP Server — status and intended use of the mcp-server/ component (currently a scaffold, not yet functional — see that page for details).

Tech stack at a glance

Layer	Stack
Backend	Go + Gin, PostgreSQL, JWT auth, bcrypt
Frontend	React 19 + Vite + TypeScript + Tailwind CSS v4
AI	Google Gemini (gemini-3.7-flash), optional — offline fallback when unconfigured
Deployment	Docker Compose, CasaOS App Store manifest

Project links

• Repository: https://github.com/Raktim94/KinetiRx
• Issues: https://github.com/Raktim94/KinetiRx/issues