isaaccladandCursor
656f402e8f
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>
2.3 KiB
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
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 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.