ClinicOps Nexus is a full-stack clinic operations platform built with Laravel + Next.js. It centralizes patient lifecycle, scheduling, surgeries, payments, clinic settings, and KPI analytics in a multilingual interface.
- Unifies clinical operations in one workflow-oriented dashboard
- Provides a modern frontend + token-secured REST API architecture
- Supports multilingual user experiences (French, English, Arabic)
- Includes backend automated tests and production build validation
.
|-- clinic-backend/ # Laravel 11 API
|-- clinic-frontend/ # Next.js 15 web app
`-- docs/ # Repository-level documentation
- Frontend: Next.js App Router + TypeScript + Zustand + Radix UI
- Backend: Laravel 11 + Sanctum + Eloquent + Policies/Gates
- Data: MySQL in development/production, SQLite for test suite
- Auth: Username/password login with Sanctum token flow
See docs/ARCHITECTURE.md for detailed flow.
- Authentication and profile management
- Patient management (search/filter/create/update/delete/restore)
- Doctor management
- Appointment management with conflict detection and slot lookup
- Surgery management with schedule validation
- Payment tracking + webhook stub integration
- Dashboard analytics (revenue, patients, appointments, surgeries)
- Contact form intake and admin message handling
- Clinic settings persistence
cd clinic-backend
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serveBackend API: http://localhost:8000/api
cd clinic-frontend
pnpm install
cp .env.example .env.local
pnpm devFrontend app: http://localhost:3000
- Username:
admin - Password:
password123
Validated during cleanup:
- Backend tests:
vendor/bin/phpunit-> passing (36 tests, 140 assertions) - Frontend lint:
pnpm lint-> passing (warnings only) - Frontend production build:
pnpm build-> passing
- High-level endpoint map:
docs/API_OVERVIEW.md - OpenAPI spec:
clinic-backend/docs/openapi.yaml
This repository now includes:
CONTRIBUTING.mdCODE_OF_CONDUCT.mdSECURITY.mdCHANGELOG.mdLICENSE