Health-Digitalization-System-Smart-City/HealSync

HealSync is a modern web-based Clinic Management System (CMS) designed to digitize and streamline the daily operations of private clinics in Ethiopia # HealSync A feedback platform for private healthcare clinics. Patients share feedback on the clinic, branch, and service they received; administrators analyze satisfaction, compare branches, and manage clinics, services, and staff. > **Current status: Phase 3 — first vertical slices implemented.** > The full design documents (`docs/`) are in place. Implemented so far: > the public patient feedback flow, and the **authentication + RBAC** layer > (Better Auth `disableSignUp` + admin plugin, server-side `requireUser` / > `requirePermission` helpers, login / password-reset pages, dashboard route > guard, and admin user management). Analytics, branch/service management, > and AI insights follow in later workstreams (see `docs/ROADMAP.md`). --- ## Table of contents - Technology stack - Requirements - Installation - Environment setup - Database setup - Development - Quality checks - Contributing - Project structure - Documentation - Development philosophy ## Technology stack | Layer | Technology | | --------------- | ------------------------------------------------ | | Framework | Next.js 16 (App Router) + React 19 | | Language | TypeScript (strict mode) | | Styling | Tailwind CSS v4 + shadcn/ui + Lucide icons | | Database | PostgreSQL + Prisma 7 | | Auth | Better Auth (administrators only) | | Validation | Zod | | Forms | React Hook Form | | Data fetching | TanStack Query (client-side) + server components | | Tables | TanStack Table | | Charts | Recharts | | Testing | Vitest (unit) + Playwright (e2e) | | Quality | ESLint, Prettier | | Package manag …