Àyẹ̀wòsàn (a blend of two Yoruba words Àyẹ̀wò (Examination) and Ìwòsàn (Healing) is a robust, Laboratory Information Management System (LIMS) built with Laravel. It is designed to bridge the gap between clinical testing and patient recovery by automating the complex workflows of modern medical laboratories.
# Àyewòsàn Laboratory Management Application
A full-featured, robust, Laboratory Information Management System (LIMS) built with Laravel. It is designed to bridge the gap between clinical testing and patient recovery by automating the complex workflows of modern medical laboratories.It provides patient management, billing, lab test cataloging, lab results workflows, referral commission tracking, and payments handling for small-to-medium diagnostic laboratories.
## Àyewòsàn
Àyewòsàn is a made-up word from the Yoruba language. It is a blend of two Yoruba words Àyẹ̀wò (Examination) and Ìwòsàn (Healing). is a robust, Laboratory Information Management System (LIMS) built with Laravel. It is designed to bridge the gap between clinical testing and patient recovery by automating the complex workflows of modern medical laboratories.
## Key Features
- Patient management (create, edit, search, demographics)
- Billing system with multi-test bills, discounts, and deferred amount calculations
- Lab tests organized by category and group, with production cost and patient price
- Lab test results workflow (Pending → Recorded → Delivered)
- Referral system with commission calculation and referral transactions
- Payment transactions supporting multiple payment methods per bill
- Role-based access control (5 roles) with granular permissions (Spatie)
- Laravel Nova admin UI for data management
## Technical Stack
- PHP 8.x
- Laravel 9+
- Laravel Nova
- MySQL / MariaDB
- Composer
- Spatie Laravel-Permission
## High-level Repository Layout
- `app/` — application code (Models, Nova resources, Observers, Traits)
- `app/Nova/` — Nova resources (Patient, Bills, LabTests, LabTestsResults, PatientTransactions, ReferralTransactions, User, etc.)
- `database/migrations/` — migration files (27 total)
- `database/seeders/` — seeders (`RolesAndPermissionsSeeder`, `UsersSeeder`, `DemoDataSeeder`)
- `resources/` — static assets and views
- `routes/` — `web.php`, `api.php`
## Database Overvie …