isaaccladandCursor
656f402e8f
Deploy Ladill Care / deploy (push) Successful in 38s
Split catalog CRUD onto lab.catalog.manage so technicians keep lab.manage for queue and results workflow without setting investigation prices. Co-authored-by: Cursor <cursoragent@cursor.com>
57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
# Ladill Care
|
|
|
|
Healthcare management for clinics and hospitals at **care.ladill.com** — patients,
|
|
appointments, queue, consultations, vitals, lab, prescriptions, pharmacy inventory,
|
|
encounter billing, and operational reports.
|
|
|
|
Authenticates via **Sign in with Ladill** (OIDC against `auth.ladill.com`). Every
|
|
clinical record is scoped to a platform account (`owner_ref`) and organization.
|
|
|
|
## Features
|
|
|
|
- **Patients** — registration, medical history, documents, visit timeline
|
|
- **Appointments & queue** — booking, walk-in, check-in, department queue
|
|
- **Consultations** — vitals, diagnoses, investigations, prescriptions
|
|
- **Laboratory** — sample collection, results, approval; admins manage test catalog & pricing
|
|
- **Pharmacy** — dispensing queue, drug inventory, batch stock tracking
|
|
- **Billing** — visit invoices, line items, cash/MoMo payments, and online checkout via your own Paystack / Flutterwave / Hubtel (Pro)
|
|
- **Reports** — patients, appointments, lab, finance, clinical (CSV export)
|
|
- **Admin** — branches, departments, practitioners, members, lab catalog pricing, audit log
|
|
- **Devices** — barcode wedge scanners (all plans), agent-connected vitals/lab hardware (Pro); see `docs/devices.md`
|
|
|
|
## Platform integration
|
|
|
|
| Integration | Purpose |
|
|
|-------------|---------|
|
|
| OIDC SSO | User authentication (`LADILL_SSO_*`) |
|
|
| Billing API | Wallet top-up / purchases (`BILLING_API_KEY_CARE`) |
|
|
| Identity API | Platform user lookups (`IDENTITY_API_KEY_CARE`) |
|
|
| Service events | Inbound webhooks for `user.deleted`, `user.suspended`, `organization.updated` |
|
|
|
|
Registry entry lives in the monolith `config/ladill_apps.php` (`care` slug).
|
|
|
|
## Local development
|
|
|
|
```bash
|
|
composer install
|
|
cp .env.example .env && php artisan key:generate
|
|
touch database/database.sqlite # sqlite is fine for local
|
|
php artisan migrate
|
|
npm install && npm run build # or `npm run dev`
|
|
php artisan serve
|
|
php artisan test
|
|
```
|
|
|
|
For SSO locally, point `LADILL_SSO_*` at a Passport client on your Ladill platform
|
|
dev instance, or bypass `EnsurePlatformSession` in tests (see `CareWebTest`).
|
|
|
|
## Deployment
|
|
|
|
See [DEPLOY.md](DEPLOY.md) for production cutover (`/var/www/ladill-care`, Gitea CI,
|
|
nginx vhost, platform onboarding).
|
|
|
|
## API
|
|
|
|
REST API under `/api/v1` (Sanctum + organization setup middleware). Health check:
|
|
`GET /api/health`.
|