This module provides a mechanism for filtering persistent data, there are several benefits to this for instance, out of the box, this module supports metadata driven access control to patient records and their clinical data with the initial implementation being restricted access to their Visits, Encounters and Observations by Location or any other metadata data like Programs. We envision adding filtering of other patient clinical data like Orders, EncounterDiagnoses, Appointments, etc.
We also envision a scenario where another module can leverage this module's functionality to limit access by some other criteria e.g. Program or Role based access.
With that said, we hope to strip the location-based functionality out of this module leaving it as a very thin lightweight and reusable module purely for data filtering and move the functionality to the existing Location based access module.
To guarantee proper functionality of OpenMRS, it's highly recommended to install the module by stopping OpenMRS, drop the omod file in the module repository and start OpenMRS again, this also applies to uninstall it, you need to stop OpenMRS, remove the omod from the local module repository and start OpenMRS.