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.