PHPackages                             flowrise-hms/patient - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. flowrise-hms/patient

ActiveLaravel-module[Utility &amp; Helpers](/categories/utility)

flowrise-hms/patient
====================

Patient management module for FlowRise HMS providing comprehensive patient registration, identification, demographics management, and emergency contact handling. Implements MRN auto-generation, UUID-based identifiers for interoperability, and PII encryption for data protection.

00PHP

Since Apr 17Pushed 2w agoCompare

[ Source](https://github.com/Flowrise-HMS/Patient)[ Packagist](https://packagist.org/packages/flowrise-hms/patient)[ RSS](/packages/flowrise-hms-patient/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Patient module
==============

[](#patient-module)

**In one sentence:** The Patient module is where the hospital creates and maintains **who the patient is**—legal name, demographics, contact details, official IDs (including **MRN**, Medical Record Number, and a global **UUID**), emergency contacts, and related records—so every other part of the system can point at one trusted person.

Why this module exists
----------------------

[](#why-this-module-exists)

Before anyone can document a visit, order a test, or schedule an appointment, the facility must answer: **“Which human being is this?”** That sounds obvious, but in real hospitals patients arrive with many IDs (national ID, insurance number, passport), may share similar names, and need privacy for phone and email. This module is the **single place** that registers the patient and keeps identifiers consistent.

Where Patient fits in FlowRise
------------------------------

[](#where-patient-fits-in-flowrise)

- **Depends on Core** for organization and branch context (where the patient is registered) and shared platform services.
- **Clinical, Appointment, Billing, and Insurance** features all assume a `Patient` record exists when they record encounters, bookings, charges, or policies.

 ```
flowchart LR
  Core[Core]
  Patient[Patient]
  Clinical[Clinical]
  Appointment[Appointment]
  Billing[Billing]
  Insurance[Insurance]
  Core --> Patient
  Patient --> Clinical
  Patient --> Appointment
  Patient --> Billing
  Patient --> Insurance
```

      Loading What you can do with it (everyday language)
-------------------------------------------

[](#what-you-can-do-with-it-everyday-language)

- **Register a new patient** with demographics and contact information.
- **Assign and manage identifiers** (MRN, NHIS or other insurance numbers, national ID, passport, custom IDs).
- **Maintain emergency contacts** (next of kin) for when the care team must reach someone quickly.
- **Search and open** a patient dossier from reception or clinical workflows.
- **Protect sensitive fields** (the system encrypts many personally identifiable fields at rest—think phone, email, and similar data).

Exact screens and click paths are described for staff in the [User guide: Patient management](../../docs/user-guide/patient-management.md).

How it works (simple)
---------------------

[](#how-it-works-simple)

1. Staff use the **admin web app** (Filament) to open the patient area.
2. They fill registration or edit forms; validation runs so duplicate or invalid IDs are caught early.
3. The module’s **service layer** applies business rules (for example, how an MRN is generated or validated) instead of scattering logic across random screens.
4. Data is saved to the **patients** and related tables; other modules only reference the patient by stable IDs.

What is inside this folder (high level)
---------------------------------------

[](#what-is-inside-this-folder-high-level)

PathPurpose`app/Models/``Patient`, identifiers, emergency contacts, schools, etc.`app/Classes/Services/`Registration, search, identifiers, schools—**the place business rules live**.`app/Filament/`Patient cluster, resources, forms, tables, and pages staff interact with.`app/Policies/`Fine-grained access (who may create or view a patient).`app/Events/`, `app/Observers/`Hooks when patients are created or updated (for integrations and side effects).`database/migrations/`Schema for patient-related tables.Dependencies
------------

[](#dependencies)

- **Core** (`flowrise-hms/core` in `composer.json` / `module.json` `requires`).

Rollout status for all modules: [Module status](../../docs/shared/module-status.md).

Further reading
---------------

[](#further-reading)

- **Implementation plan (technical depth):** [docs/implementation-plan.md](docs/implementation-plan.md)
- **Staff-facing patient guide:** [Patient management](../../docs/user-guide/patient-management.md)

For developers
--------------

[](#for-developers)

- **Namespace:** `Modules\Patient\...`
- **Service provider:** `Modules\Patient\Providers\PatientServiceProvider`
- **Prefer services over ad hoc `Model::create()`** in new code so rules stay consistent with existing patterns.
- **Tests:** under `tests/`; run from repo root with paths pointing at `Modules/Patient/tests` as needed.

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance63

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/58814410?v=4)[Mushe Abdul-Hakim](/maintainers/musheabdulhakim)[@MusheAbdulHakim](https://github.com/MusheAbdulHakim)

---

Top Contributors

[![MusheAbdulHakim](https://avatars.githubusercontent.com/u/58814410?v=4)](https://github.com/MusheAbdulHakim "MusheAbdulHakim (54 commits)")

### Embed Badge

![Health badge](/badges/flowrise-hms-patient/health.svg)

```
[![Health](https://phpackages.com/badges/flowrise-hms-patient/health.svg)](https://phpackages.com/packages/flowrise-hms-patient)
```

###  Alternatives

[codefog/tags-bundle

Tags bundle for Contao Open Source CMS

13100.3k13](/packages/codefog-tags-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
