A point-of-sale and shop management system built for a real small business in Tamil Nadu: a xerox, binding, stationery and tailoring shop (CSK, Kinathukadavu). It handles billing at the counter, stock, tailoring orders, receipts and earnings, in English and Tamil.
| Part | Stack |
|---|---|
frontend/ |
React 19 + TypeScript, Vite, Tailwind CSS v4, Radix (shadcn-style components), React Router, TanStack Query, i18next |
backend/ |
Spring Boot 3.5, Java 21, Maven, Spring Security (bearer tokens), JPA, Flyway, OpenPDF, Apache POI |
| Database | MySQL 8.4 on the shop PC |
- Start here:
docs/SETUP.md— install, run, deploy (Vercel + Cloudflare Tunnel), backups. - Project rules:
CLAUDE.md· Plan & data model:docs/PLAN.md· Requirements:docs/REQUIREMENTS.md· Progress:docs/PROGRESS.md - Approved design:
docs/design/
Quick start (after MySQL and application-local.yml are set up, see SETUP):
cd backend && mvn spring-boot:run # API on http://localhost:8080
cd frontend && npm install && npm run dev # app on http://localhost:5173